读取ASC和原始CAN报文CSV

先分清两种CSV。signal_csv已经有时间、电压、电流等物理量列；raw_can_csv的一行还是报文ID和十六进制字节，必须用DBC把字节解成信号。文件扩展名相同不表示内容相同。

ASC/BLF连续分卷可通过execution.process_count并行读取；来源的file_merge分别选择按文件接续或按共同时间归并。字段规则、可运行配置和跨文件状态见连续记录多进程读取。原始CSV不支持这两种新增执行方式。

DBC是CAN报文的字段说明文件：例如ID 0x100的第一个字节表示Voltage、比例是1、单位V。它不提供日志的采集时刻，但可以声明报文周期，供默认有效期等功能使用；它也不替你确认测量位置和电流方向。ASC是文本报文日志，BLF是另一种二进制日志；文本入口和BLF入口都把解码后的信号送入同一个分析引擎。

本页配置位于根级sources列表，每段来源示例都是其中一项；解码后的信号由signals引用。原始CSV读取报文列，ASC读取报文行，两者输出带统一时间的信号更新。

完整最小例与列映射扩展

下载ASC最小配置、joint.asc和joint.dbc，保留配置里的data相对目录。在examples目录运行：

chronaxis run input-asc-minimal.yaml --output asc-minimal-result

该配置只绑定Voltage并计算一次积分。DBC把第一个字节按2×原值+1换算：原字节1、3、1得到3、7、3V，各持续1秒，结果为13V·s。signals不再次重复DBC比例。

原始CSV最小配置读取raw-can-example.csv，使用同一DBC和信号定义，结果也为13V·s。此样例显式设置id_base: 16，将CSV的id列按十六进制读取，文字100对应DBC的十进制256；data列是01 05等字节，不能直接当作电压。

列映射扩展配置只把接收方向从固定true改为读取direction列，并用value_map把Rx转成true、Tx转成false。strip: true使第一行的“ Rx ”先去掉两端空格再匹配；本数据都是Rx，所以积分仍为13V·s。换成未列出的文字会报映射错误，不会自动当成发送或接收。

chronaxis run input-raw-csv-minimal.yaml --output raw-csv-result
chronaxis run input-raw-csv-mapping.yaml --output raw-mapping-result

三个配置都包含来源、信号和计算的全部定义，并逐字段注释；结果目录可重复使用，文件名自动增加时间后缀。下文片段用于替换真实输入格式，不能代替这些完整任务。

完整来源字段

下表字段相对于sources[]，例如reader.decode_policy的完整路径为sources[].reader.decode_policy。以下共同字段用于sources中的source_type="can_asc"或"raw_can_csv"项：

显式文件列表按给定顺序读取；目录或通配符取匹配文件并自然排序。默认来源可混合ASC/BLF；显式can_asc只选ASC。不会自动把回退时间改成下一天。比如第二个文件时间重新从0开始，而你知道它接在100秒处，就明确设置对应offset为100s。真实不连续试验应分开运行。

ASC：常见格式直接读取

应用位置：以自己新建的分析文件为基础，在文件根级加入或替换sources，代码已包含父键。存在同名列表时按本例替换该列表，不把父键再嵌入列表项。 示例文件名是待替换的输入路径，须准备相应CSV/DBC/CAN数据；本块本身不是完整任务。

sources:               # 列出输入来源；每项规定数据位置、格式和时间解释方式
  - path: sample.asc   # 指定单个输入文件；相对路径从本配置文件所在目录计算
    dbc_by_channel:    # 为每个CAN通道指定解码用DBC文件；键是通道编号的字符串
      '1': sample.dbc  # 为这个通道指定DBC文件；路径相对当前配置文件，通道键须为字符串

下表位于sources[].reader；例如格式版本的完整路径为sources[].reader.version。

ASC的time.unit默认s，通常不填写；显式填写也必须为s。reader还可设置encoding，默认utf-8-sig，不支持UTF-16/32。遇到不符合指定格式的行就失败，不依次尝试不同解析器直到某个成功。

ASC文字通道1在配置中填写1；ID后缀x表示扩展帧，不能只看ID数值大小猜扩展标志。FD的DLC码与实际字节数不同，例如DLC 10代表16字节、15代表64字节。FD零字节数据帧也不能自动当成远程请求帧。

经典帧的标准统计尾为Length = 238000 BitCount = 123 ID = 440。三个字段的数量、顺序和非负十进制数值必须正确，尾部ID还要与主报文ID相同；例如主ID为十六进制1B8时，尾部填写十进制440。程序在同次读取中识别它，缺项、错序和ID不符仍报错。

以下非数据记录也可出现在ASC中：

错误帧保留错误帧身份，不把诊断中的ID、DLC或可能损坏的数据作为普通报文解码。其他未知事件、残缺诊断及损坏的数据行仍带文件名和物理行号报错，不静默忽略。

ASC里有两个容易混淆的“绝对/相对时间”：

没有可靠采集日期时，配置采用relative，用共同起点后的秒数分析。不要用电脑今天的日期代替日志日期。

原始CSV：明确每一列代表什么

应用位置：以自己新建的分析文件为基础，在文件根级加入或替换sources，代码已包含父键。存在同名列表时按本例替换该列表，不把父键再嵌入列表项。 示例文件名是待替换的输入路径，须准备相应CSV/DBC/CAN数据；本块本身不是完整任务。

sources:                      # 列出输入来源；每项规定数据位置、格式和时间解释方式
  - path: sample.csv          # 指定单个输入文件；相对路径从本配置文件所在目录计算
    source_type: raw_can_csv  # 选择数据格式；memory内存记录、signal_csv物理量表、can_blf/can_asc/raw_can_csv原始CAN
    dbc_by_channel:           # 为每个CAN通道指定解码用DBC文件；键是通道编号的字符串
      '1': sample.dbc         # 为这个通道指定DBC文件；路径相对当前配置文件，通道键须为字符串
    time:                     # 说明输入时间数值的类型、单位、共同起点和校准偏移
      unit: s                 # 声明输入时间数值的单位；根据文件说明填写s/ms/us/ns等受支持单位
    reader:                   # 设置当前来源的文本解析、列映射或解码行为；可用子字段取决于来源格式
      time_format: numeric    # 指定原始CSV时间文本格式；按文件的时间列格式填写
      id_base: 16             # 指定报文ID文本按几进制解释；从导出格式取得
      layout:                 # 说明原始CAN CSV如何组成每条报文
        fields:               # 逐项指定报文时间、ID、数据字节及标志来自哪列或哪个固定值
          timestamp: time     # 指定报文时间如何从CSV取得；选择column读列或fixed固定值
          frame_id: id        # 指定报文ID如何从CSV取得；选择column读列或fixed固定值
          data: data          # 指定数据字节如何从CSV取得；选择column读列或fixed固定值

reader：时间、ID和数据字节怎样读取

本节表中字段位于sources[].reader。其中layout还要再嵌套一层，不能把layout内的编码和分隔符平放在reader内。

报文里的数据字节也叫“载荷”，对应data字段。例如 01 FF 是两个字节；ID用来区分报文种类，不属于这些数据字节。

例如同一份连续记录从 23:59:59 跳到 00:00:01，时钟数字减少了接近24小时。明确设置 rollover_min_drop="43200s" 后，这种至少回退12小时的情况会按第二天处理，两个时刻实际相差2秒。未设置时会报时间回退错误；若只倒退了1秒，也不会因这个设置而被当作第二天。

最小列映射

常见表格只需对应时间、ID和数据列，不必给每列套column：

sources:                      # 列出输入来源；每项规定数据位置、格式和时间解释方式
  - source_type: raw_can_csv  # 选择数据格式；memory内存记录、signal_csv物理量表、can_blf/can_asc/raw_can_csv原始CAN
    path: data/raw.csv        # 指定单个输入文件；相对路径从本配置文件所在目录计算
    dbc_by_channel:           # 为每个CAN通道指定解码用DBC文件；键是通道编号的字符串
      '1': network.dbc        # 为这个通道指定DBC文件；路径相对当前配置文件，通道键须为字符串
    time:                     # 说明输入时间数值的类型、单位、共同起点和校准偏移
      unit: s                 # 声明输入时间数值的单位；根据文件说明填写s/ms/us/ns等受支持单位
    reader:                   # 设置当前来源的文本解析、列映射或解码行为；可用子字段取决于来源格式
      time_format: numeric    # 指定原始CSV时间文本格式；按文件的时间列格式填写
      layout:                 # 说明原始CAN CSV如何组成每条报文
        fields:               # 逐项指定报文时间、ID、数据字节及标志来自哪列或哪个固定值
          timestamp: time     # 指定报文时间如何从CSV取得；选择column读列或fixed固定值
          frame_id: id        # 指定报文ID如何从CSV取得；选择column读列或fixed固定值
          data: data          # 指定数据字节如何从CSV取得；选择column读列或fixed固定值

timestamp: time等同timestamp: {column: time}。整数字段简写如timestamp: 1表示第1列；常量必须写{fixed: 值}。唯一DBC通道自动补入；数据帧默认frame_kind=data，长度从实际字节数取得。方向省略保持未知，普通数值分析可以继续；要导出完整报文时必须提供真实方向。标准/扩展、CAN/FD标志只有在绑定与DBC足以唯一识别时才可省略。显式长度、帧种类或标志仍严格检查，不被默认值覆盖。

layout：表头、编码和分隔符

本节字段位于sources[].reader.layout。原始报文CSV的编码与分隔符写为sources[].reader.layout.encoding和sources[].reader.layout.delimiter；已解码signal_csv则直接写在reader内，两种格式的布局不同。

本版没有可配置的quotechar或引号选项。标准CSV双引号由读取器处理；不能通过配置修改引号字符。

fields：每个报文字段代表什么

字段完整路径为sources[].reader.layout.fields.<报文字段>，例如frame_id: id中frame_id是程序的报文字段，id是原CSV列名；不能把原表的id列改名为name。

下表的“读取后类型”是从列文字转换后应得到的类型。配置可直接填列名，也可用column/fixed对象；接收/发送、Rx/Tx可直接识别，特殊方向编码再用value_map。完整YAML例见本页下载配置。

省略类型列只适用于能够通过绑定与DBC取得唯一类型的分析入口。DBC标为FD仍可能对应实际经典CAN，不能仅凭DBC声明或短载荷断定；此时填写绑定的is_fd，或在原始布局中补充真实列／常量。独立原帧读取没有DBC信息时仍需提供类型；导出包含未绑定的报文，也必须具有其可靠类型信息。ASC和BLF自带的实际类型直接使用。

配置中的frame_id进制规则不改变ASC或CSV文件自己的ID格式：ASC无前缀文字可能表示十六进制，CSV仍按id_base解释。

数据帧的DLC与字节数须一致。remote必须是经典CAN，data为空，dlc_code明确给出请求长度；若另填payload_length，它为0，因为本帧没有数据字节。error必须data为空，DLC省略或为0。不能看到零字节就自动认作remote。

每个字段怎样取值：column、fixed、value_map、strip

这些字段位于一个列映射对象内部，例如sources[].reader.layout.fields.is_rx.value_map；不是直接放在layout或fields下。列名简写不需要对象，只有要配置这些额外取值规则时再展开。

value_map的键和字符串目标最长256字符，fixed字符串最长16384字符；固定整数范围为−2⁶³到2⁶⁴−1，实际ID/长度等字段还有更小的范围限制。column与fixed不要同时填写。value_map也可用于固定文字，例如fixed="Rx"再映射为true，但直接写布尔固定值更清楚。

没用到的CSV列不参与解析，声明过的必需列缺失会报错。只计算所需报文、且无需完整原帧或全部来源时间时，原始CSV先看报文ID；不匹配的行跳过载荷和帧型，也通常跳过时间。若已启用跨午夜识别，仍会读取这些行的时间，以免漏掉换日、把下一天的报文归到前一天。目标行仍检查格式、时间和长度。需要完整原帧导出或全部来源时间时，则检查所有被读取的记录。错误会指出相关记录位置，修正输入后重新运行。

怎样选信号和查看来源

信号的field必填frame_id和signal，唯一DBC通道时可省略channel，帧型可以省略，逐项见CAN信号定位。不要只靠DBC信号名称定位；不同报文可以出现同名信号。输出来源信息的范围由所选分析和导出功能决定，不会为了说明来源额外保留未请求的记录。

有些报文会根据一个选择字段，在同一段字节里轮流传不同的信号。例如本帧传温度，下帧传电压，这称为DBC复用。若声明的温度字段在当前帧没有出现，程序会产生无效更新，不能继续把上一帧温度当作当前有效值。

其他有效记录仍受valid_for限制：超过有效期到下一次有效更新之间，数据是未知的。需要输出信号或原报文时，另配两类导出；输入格式不决定输出格式。

底层读取器、逐字段参数、返回和异常见ASCSpec/ASCRead、CANCSVSpec/CANCSVRead、CANTextDecodeRead。通常使用AnalysisRunner即可，不必手工管理底层文件句柄。

无关报文的时间回退

默认reader.input_check: auto下，ASC只要求本次所需通道和报文ID的时间不回退。其他报文仍在同次读取中用于确定来源的最早/最晚观测时间，不因无关Tx帧的微秒回退中止分析，也不修改它的时间。reader.input_check: full或原帧导出需要完整顺序时，仍拒绝全来源回退。参与计算的报文和连续分卷之间的目标报文回退仍报错；程序不自动排序、钳平或清洗。

ASC头的relative表示每条记录的时间增量，读取时必须累加；这不同于分析配置time.time_type的relative时间基准。跨日期采用ASC明确日期/triggerblock，不把普通回退猜为跨日。原始CSV的时间布局和channel_origin仍按其文件声明解释。