日志与文件命名

建立日志

1. 停止工程，在“主页 → 日志”打开配置，也可从总线配置的日志项进入。
2. 添加 Logger，填写名称，打开记录开关。
3. 选择记录来源：CAN / LIN 总线、UART 或 MeLiBu。也可点击 Trace 或 UART Trace 窗口的“日志”进入配置。
4. CAN/LIN 日志选择 ASC 或 BLF，UART 使用 .ulog，MeLiBu 使用 .mlog，三种来源独立选择。
5. 选择输出文件夹，设置文件命名规则，检查预览并确定。
6. 启动工程，在控制台检查该 Logger 的实际输出路径。停止工程时完成剩余写入并关闭文件。

新 Logger 默认启用。可建立多个 Logger，分别记录 CAN/LIN、UART 和 MeLiBu；总线来源记录 CAN/LIN 流量，不是单独选择某一个 CAN ID。显示筛选不能代替日志源配置。

Logger 示例：启用 CAN / LIN 总线 ASC 记录，文件名组合工程名、Logger 名称和本地时间。

命名规则

通过“字段代码”插入字段，也可直接输入：

字段	内容	示例
{LocalTime}	本次日志开始时的电脑本地时间	2026-10-05_16-30-00
{LoggerName}	Logger 名称	Logger 1
{ProjectName}	工程名称	CAN_Test

例如 {ProjectName}_{LoggerName}_{LocalTime} 可生成 CAN_Test_Logger 1_2026-10-05_16-30-00.asc。扩展名由记录格式决定，不必手动填写。

规则不包含 {LocalTime} 时，软件仍会在文件名末尾追加开始时间 YYYYMMDDHHmmss。空规则以及 <>:"/\|?* 等非法文件名字符不能保存。只使用表中的字段；其他字段没有替换定义。

同名文件已存在时，会分配 _1、_2 等后缀，保留旧文件。建议明确选择文件夹，以控制台报告的实际输出路径为准。

每个 Logger 独立配置文件夹。需要将 ASC、BLF 放在一起时，把两个 Logger 的文件夹设为同一路径。

记录与界面的区别

操作	效果
暂停 Trace、鼠标翻看历史	暂停显示跟随，采集和日志继续
Trace 的 ID/方向筛选	只改变显示内容
清空 Trace	清除显示缓存，不删除已写日志
保存 Trace CSV	导出当前显示数据，不等于完整总线记录
停止工程	停止测量、回放并关闭日志

CAN/LIN 和 MeLiBu Logger 在后端独立队列写盘，不受窗口关闭、显示暂停、筛选或显示条数限制。UART Logger 从 UART 数据流记录，不受 UART Trace 的显示通道筛选影响，但仍受电脑和软件实际处理能力限制。

格式和时间

ASC 便于文本检查，BLF 更适合较大的总线记录，UART .ulog 按行记录主机交付时间（从日志开始计秒）、通道、方向、字节数和十六进制数据。文件名的 {LocalTime} 仅用于命名，不能用它判断帧的发送周期。

日志创建或写入失败会显示在控制台。看到工程启动不代表每个 Logger 都成功，开始测试前检查路径和错误信息。

MeLiBu .mlog 使用类似 ASC 的文本布局，简短文件头之后每条记录一行。记录时间（秒）、方向、事件、ID、字节数和十六进制数据，并保留 CRC/ACK、传输状态、时间基准、会话、序号、原始字节及截断/丢帧标志。未知时间写为 -，不替换成主机时间；不写入 JSON 或 MBDF 信号对象。时间基准见行内 timebase，不同基准或会话的时间不直接相减。日志结束时排空队列并关闭文件。目前不能从 ASC/BLF 历史入口加载 .mlog 或 .ulog。

UART .ulog 示例（时间为主机交付时间，不是硬件帧时间）：

date 2026-11-02T08:00:00.000Z
base hex timestamps relative
0.001234 UART Rx d 3 11 22 33
0.002345 Uart2CAN Tx d 2 AA 55

旧工程的 UART/MeLiBu .log 配置在打开时迁移为 .ulog/.mlog；已有日志文件保持原样。