Trace、时间戳与信号图

CAN、LIN 和 MeLiBu 帧显示在同一个 Trace 中，用“总线”筛选单独查看某一种；只看 MeLiBu 时不显示 E2E 列。Trace 的“日志”打开总线 Logger；工程启用 MeLiBu 时打开 Logger 列表。

Trace 列

列	含义
TIME	相对时间或电脑接收事件时的绝对时间
总线	CAN 或 LIN
事件	TX 发送、RX 接收、LIN REQUEST 帧头请求等
ID / 名称	帧 ID，加载数据库后可显示报文名称
类型	CAN/CAN FD 等帧属性，或 LIN 经典/增强校验方式
LEN / 数据	实际长度与字节内容；REQUEST 可显示期望长度和空数据
DIFF	相邻事件的时间差，单位毫秒
计数	事件显示模式下同一标识的累计次数
状态	可用的帧状态信息

LIN 的“经典/增强”描述校验方式，与主/从角色无关。底层协议可能写作 cls，界面对应“经典”。成功的 LIN 帧头请求保留在 Trace；控制命令 ACK/BEL 和版本应答到控制台检查。

CAN 总线错误和发送失败在 Trace 显示为红色 CAN Error，数据栏显示原因，状态栏显示 TEC/REC；发送超时和 Bus-off 还会标注发送暂停。错误事件与同 ID 的正常数据帧分开；事件模式会更新同一错误行的时间、间隔与计数，“错误”方向筛选可单独查看。展开详情可查看 MCU 时间和原始寄存器。USB 忙时固件会合并错误快照，因此计数代表上报事件数，不是硬件全部重试次数。

Trace 演示数据。LIN REQUEST 已发出帧头，数据栏为空；图中时间间隔不代表硬件测量结果。

LIN 事务超时、发送失败以及监听到的同步、PID 奇偶校验、校验和、无响应等异常显示为红色 LIN Error。空数据或未知 ID 的异常也保留，成功发出的 REQUEST 帧头不会被错误行覆盖。详情保留原始字节；异常数据不解码为应用信号。LIN 错误不停止工程，也不写入控制台。更新 MCU 固件后，主节点事务错误包含 ID 和 MCU 检测时间；旧的 !3 只有电脑到达时间。周期调度连续失败沿用首次上报策略，计数不代表全部物理错误次数。

滚动和事件显示

滚动显示逐条保留近期报文，默认自动跟随最新数据。鼠标滚动查看历史时会暂停显示更新；点击继续恢复实时显示。暂停期间仍采集和记录，不能据此认为停止了发送。

事件显示按 CAN 的标准/扩展属性及 ID，或 LIN 的 ID 合并行。同一标识的新帧更新该行的时间、事件、数据、计数等字段，仅新标识新增行。TX/RX 共用同一标识的行，因此需要完整发送接收顺序时切回滚动显示。

滚动显示 DIFF 是当前筛选列表中相邻帧的间隔；事件显示 DIFF 是同一标识前后两次的间隔。它们的比较对象不同。实时显示缓存上限 5000 条；完整长时间记录使用 Logger。

Trace 工具栏的文件夹按钮可打开 ASC/BLF 日志。软件建立时间索引，每页读取 1000 条；用上一页、下一页或输入相对日志起点的秒数定位最近报文。历史页与实时缓存分开，关闭历史页即可返回实时 Trace；浏览日志期间测量和记录仍可继续。日志追加后重新打开文件可更新索引。历史页显示文件中可解析的 CAN/LIN 数据帧；ASC 注释和 BLF 标记不作为报文行。

BLF 末尾被截断时，Trace、信号图和回放保留此前已完整读取的帧，并在控制台提示“文件末尾不完整”。非法头部、超限对象和解压错误仍会使读取失败。

详情中的“原始报文”只显示总线名称和十六进制数据字节，例如 CAN 02 10 03 00 00 00 00 00，不附加 ID、DLC 等标签或 SLCAN/SLLIN 编码。空数据显示“—”；LIN 错误的“捕获字节”单独保留实际接收内容。

拖动表头列之间的分隔线调整列宽，双击恢复默认列宽。过长内容在本列内显示省略号，悬停查看完整内容，不会溢出覆盖相邻列；总列宽超过可视区域时可横向滚动。

拖动详情左侧分隔线调整侧栏宽度，双击恢复 300 像素。侧栏宽度会被记住；窗口缩小时自动限宽，恢复大窗口后恢复原宽度。分隔线获得焦点后可用左右方向键调整。

时间基准

时间按钮切换相对/绝对显示：

• 相对时间以本轮第一条相应时钟来源的帧为零，单位秒，显示六位小数。有 MCU 元数据时使用 MCU 的微秒时钟。
• 绝对显示使用帧携带的时间；缺少设备时间时使用电脑本地到达时间。独立离线会话显示日志相对时间，不是日历时间。
• 当前协议支持 CAN RX 的 MCU 时间、CAN/LIN TX 的完成时间及 LIN 从节点采集时间，前提是设备固件实际输出对应元数据。
• 缺少 MCU 元数据的设备帧使用电脑到达时间。独立离线会话使用日志相对时间，倍率不改变时间间隔；多个回放分别从零开始，按到达顺序显示时可能不单调。在线会话中手动播放的离线回放使用电脑到达时间，Logger 也按到达时间记录。

MCU 时钟和电脑时钟分别建立零点，不能混合计算精确周期；软件不会对不同来源的时钟计算 DIFF。界面显示微秒位数不表示所有来源都具备微秒精度。判断周期偏差应使用同一来源、同一标识的连续帧，并与外部总线仪器对比。

筛选、搜索与导出

工具栏的“过滤”按钮打开左侧过滤栏：选择总线和方向（TX、RX 或错误），可只看 E2E 错误。“阻止过滤”隐藏所列 ID，“通过过滤”只显示所列 ID；在输入框按十六进制填写后回车，多项用逗号或空格分隔，例如 555, 108，勾选框控制该组是否生效。也可在 Trace 行上右键，或把行拖到过滤栏的阻止或通过列表，添加该行或已选中各行的 ID；拖动时过滤栏自动展开。过滤栏收起时，有生效的过滤条件则“过滤”按钮显示为蓝色。搜索框可搜索显示内容，有匹配时用上下按钮定位。

数据格式可选 Hex、Bin、Dec、ASCII。详情按钮展开选中帧及数据库信号。“导出”保存当前行的 CSV；这份 CSV 是显示结果，不等于 ASC/BLF 原始记录。清空和重新启动工程会重置本轮 Trace 内容。

信号过滤与触发

工具栏的信号过滤和信号触发图标分别配置一个条件：选择数据库报文、信号、物理值或原始值及比较运算。支持 ==、!=、>、>=、<、<=，原始值支持十进制或十六进制整数。

过滤只影响显示，不影响日志。触发检查聚合前的每一帧，命中后冻结 Trace 到该帧；动作可选择暂停显示或停止测量。暂停期间仍采集和记录。继续显示不会重新布防；使用重新布防图标或重新启动测量。每次布防只触发一次，条件随工程保存。

触发在上位机收到报文后执行，存在 USB 和软件处理延迟，不是 MCU 硬件触发。

信号图

加载 CAN DBC 或 LIN LDF，在“视图 → 信号曲线”添加需要观察的信号。软件按数据库解释物理值，图中可选择时间窗口、暂停和清空。无数据库或信号定义不匹配时，先修正数据库和帧 ID，再检查曲线。

分栏模式中，每个可见信号各占一栏，左侧有同色 Y 轴和竖排信号名。各栏按最长刻度文字共用一个轴宽，最多占绘图区宽度的 35%，超出的文字以省略号结尾。空间足够时，离散信号显示数据库中的完整状态名称，枚举表之外的值仍显示数值。每栏至少 64px 高，放不下时绘图区纵向滚动，图例和底部时间轴保持固定。

打开 ASC/BLF 时，整段高密度数据先显示保留极值的预览；缩放到较短区间，会按日志索引重新读取当前视图的原始采样。悬停图例行可查看报文名和当前曲线的采样时间范围。精确读值和最近帧吸附需要原始采样；M/Δ 区间的最小值、最大值单独读取，压缩区间也保留准确极值。

点击“叠加”将多条信号放到同一张图中，每条信号仍使用独立 Y 轴。点击图例选中信号，轴按钮可切换只显示选中轴或显示全部轴；宽度不足时以 +N 表示省略的轴。点击“分栏”恢复一信号一栏。布局切换保留当前视图与选中信号。

点击 M 会重置 Measure 和 Difference，随后在曲线区点击或拖动设置蓝色参考光标。设置 M 后，点击 Δ，再点击或拖动设置 Difference 黑线（深色主题使用浅色）。原始采样可用时，两条光标都会吸附到所选信号最近的报文采样点，等距离时取较早一帧；图中用同色空心方块标出对应采样点。开启时间联动时 M 与 Trace 选择同步，移动 Δ 保持 M 和 Trace 位置。关闭时间联动后，两条光标仍可在图内使用。

时间线贯穿所有可见分栏，包括没有采样的信号。鼠标接近光标线或正在设置、拖动光标时，显示水平调整大小指针；两条光标可随时从任意分栏独立拖动，无需重新选择 M/Δ 按钮，设置 Δ 时也能调整 M。所选信号在当前视图没有采样时，吸附到其他可见且时钟相同的信号帧，空信号仍显示 -。预览、加载中或视图没有采样时仍可移动时间线，原始采样可用后再次拖动恢复吸附；移动光标不会自动缩放视图。两条线重合时先拖开 Δ，再调整 M。

两条光标显示时，点击 M 清除两者并重新设置 M；点击 Δ 隐藏两者。隐藏后再次点击 Δ，按当前时间视野恢复两条光标并吸附到可见采样，不跳回旧视图。当前视野没有采样时，仍显示光标，值显示为 -。左下角和曲线读数框显示选中信号、值、时间 t1 和 Δt = Difference − Measure；Δ 位于 M 之前时 Δt 为负。

M/Δ 按钮分别表示对应光标的开启状态：只有 M 时仅 M 亮起，两者开启时同时亮起，隐藏或清除后同时熄灭；正在设置的光标按钮也会亮起。

分栏与叠加共用光标位置。清除光标、继续显示或切换工程/日志会清除它们，启动新一轮实时测量会清除实时光标；光标和临时量程不写入工程。实时跟随时，轴宽按 8px 调整并只增不减；看全、切换信号或打开日志后重新计算，缩小窗口时仍受宽度上限约束。

紧凑图例每行显示信号名、当前值和单位。两条光标显示时，下方显示 M/Δ 的物理值、Δy，以及区间最小值和最大值；悬停汇总可查看完整状态名称。点击颜色块更改颜色；隐藏/显示、设置、删除按钮在悬停、选中或键盘聚焦时显示，右键行也可打开设置。隐藏信号会移除整栏，其余栏重新均分高度；隐藏后仍接收数据，搜索和 CSV 仍包含该信号。点击信号设置选择阶梯、连线或点；选择手动量程并填写最小值、最大值后点击确定。最小值必须小于最大值；非法输入标红且不能保存。布局、颜色、隐藏、绘制方式和手动量程随工程保存。

在绘图区滚轮缩放时间、拖动平移；在某根 Y 轴上滚轮缩放量程、拖动上下平移，双击该轴清除临时量程。在绘图区按住 Ctrl 拖动，或点击框选按钮后拖动，可同时放大时间与各可见信号的 Y 量程；窄于 6px 或低于 6px 的框只缩放另一个方向，Esc 取消。后退恢复上一视图，最多保留 20 步，连续滚轮合并为一步。看全恢复全部时间并清除临时量程与后退记录。这些临时操作不会修改工程；手动量程保留，关闭工程后临时量程不保留。

点击搜索按钮，可按信号物理值查找等于、大于、小于、上穿、下穿、最小值和最大值。历史日志搜索扫描原始记录，找到的时间会联动 Trace；实时搜索仅覆盖当前保留的曲线采样。

Trace 与信号图时间联动

两个窗口工具栏的链条按钮默认开启。滚动模式下单击 Trace 报文或用上下方向键切换行，信号图的蓝色测量游标同步定位；单击曲线或拖动蓝色游标时先吸附到最近的信号采样，再让 Trace 定位到同一时钟来源中最近的报文，等距离时选择较早一帧。

定位会暂停显示跟随，采集和记录继续。信号图保持原时间跨度，必要时平移到目标位置；普通拖动仍平移视图，拖动 M/Δ 线则移动光标。点击继续显示会清除共享游标并恢复该窗口实时跟随。

目标报文被筛选隐藏时不选择替代行。曲线采样点超出 Trace 的 5000 条实时缓存、但记录器已将该点写入 ASC/BLF 时，Trace 自动打开对应日志并定位，信号图仍保持实时曲线；从历史 Trace 选行也可将游标带回实时曲线。没有对应日志的区间不自动定位，关闭历史 Trace 可返回实时缓存。事件聚合模式和混合时钟信号不参与实时联动。各窗口可独立关闭链条按钮；清空 Trace、切换工程或重新测量会重置实时共享游标。

在 Trace 或信号图打开 ASC/BLF 后，另一个窗口会自动显示同一日志。历史 Trace 选中报文或输入时间定位时，信号图游标跳到对应的文件相对时间；单击或拖动信号图游标时，历史 Trace 定位到最近的数据帧。日志时间与实时设备时间分开；从任一窗口返回实时视图，会关闭两边的历史日志。

标记、参考帧与区间值

在滚动 Trace 选中一帧后，点击“添加标记”填写名称、颜色和备注。标记显示在 Trace 行和同一时间源的信号曲线上；点击标记可回到对应时间，Trace 标记栏支持前后导航、编辑和删除。历史日志也可添加标记并跨页定位。最多保留 100 个标记；开始新测量、清空 Trace 或切换工程时清除实时标记，关闭日志时清除该日志的标记。标记当前不会写回 ASC/BLF。

点击“设为参考帧”后，详情栏比较当前选中帧与参考帧的时间差、变化字节，以及同一报文的信号值差。参考帧可定位或清除，切换测量或日志后重置。不同时间源的帧不计算时间差。

信号图只使用 M/Δ 测量区间，两条光标显示时，每条曲线显示区间最小值和最大值，CSV 导出包含两端的区间采样；只有 M 或光标隐藏时，导出当前可见时间范围。历史区间统计独立读取，不改变当前视图的精确采样。点击 CSV 时按导出范围读取原始数据；任一信号在该范围内超过 20,000 个采样时不导出压缩预览，需缩短 M/Δ 区间或可见范围。没有样本或保持值的区间不显示统计。

控制台

控制台显示接口打开、工程状态、日志路径、版本应答与错误。其时间是电脑日志时间。排查问题时，保留启动到停止的完整记录，不只截取最后一条错误。

总线统计

在「视图 → 分析 → 统计」打开。CAN/LIN 卡片显示负载（最近一秒、平均、峰值）、帧率、帧数和错误。ID 表显示数据库名称、方向、计数、帧率、DLC 及最小/平均/最大周期（ms）。点击列标题排序，拖动列间分隔线调整宽度。窄窗口中卡片上下排列，表格内部可横向滚动。

统计每秒刷新，独立于 Trace 缓存和显示筛选。启动测量清零，停止后保留结果；测量中可用清零按钮重置统计，保留通道设置。离线模式单独显示回放帧数和 ID 周期，不计算物理总线负载；在线回放按设备回报计数。最多跟踪 4096 个 ID，达到上限仍累计总数。

周期优先使用 MCU 时间；缺少时使用电脑到达时间并加 ~。时钟切换不计入周期。经典 CAN 负载包含 CRC-15 和实际填充位；CAN FD 缺少 ESI 和速率切换采样点信息，负载标记 ~。LIN 按标称位数计算，请求帧头与对应响应合并为一次事务；监听确认的无响应帧头计入 34 位。其他失败或无效帧不计入负载。

CAN 错误数旁的 ≥ 表示设备上报事件的下限，不是硬件全部重试次数。TEC/REC 和控制器状态来自最近错误快照，未知显示「—」；REC 为寄存器的 7 位计数，接收被动错误标志也参与状态判断。当前不会定期查询控制器状态。