接收观察与 Hex 分析#

NexuTrace 的接收侧不是单一日志窗口，而是按“人读、机器查、字节核对、总线取证”分成多个视图。调试时建议先用原始视图证明数据存在，再用协议面板解释数据含义。

文本视图#

文本视图适合看日志、AT 指令、CSV、可打印协议和调试输出。

功能	用法
自动滚动到底部	适合实时看日志；回看历史时可以关闭。
时间戳	给每行加时间前缀，适合判断响应延迟和事件先后。
RX/TX 方向	区分设备发来的数据和电脑发出的命令。
统计	显示行数和数据量，长时间记录时判断增长速度。
导出全部	保存现场日志，便于提交问题或做测试记录。
清除	开始一次新实验前清空旧数据。

乱码时先切换编码，不要急着改协议。中文日志常见 GBK/GB18030，跨平台固件更常见 UTF-8。

表格视图#

表格视图按行记录收发事件，适合高频数据和复盘：

列或操作	含义
时间	数据进入或发送提交的时间。
方向	RX 或 TX。
长度	本行数据字节数。
数据摘要	用紧凑形式显示一段数据，避免长帧撑满界面。
自动滚动	实时观察时开启；排查历史时关闭。
导出全部	比截图更适合复盘，能保留时间、方向和长度。

表格视图适合回答“这条命令发出后，设备多久响应”“是否有丢行”“RX/TX 顺序是否异常”。

Hex 分析视图#

Hex 分析视图是二进制协议排障的核心工具。它能把同一段字节按不同解释方式显示出来，帮助你确认偏移、字节序和数据类型。

功能	说明
数据源	可选择 RX 或 TX，分别分析接收和发送字节。
每行字节数	调整行宽，常用 8、16、32，按协议结构选择。
行地址与列标题进制	地址可用十六进制、十进制或八进制显示。
ASCII 列	同时查看可打印字符，适合混合文本/二进制协议。
扩展 ASCII	需要查看不可打印或扩展字符时开启。
数据检查器	选中字节后按多种数据类型解释。
小端 / 大端	多字节整数和浮点解释时必须和设备协议一致。
导出 RX / 导出 TX	分别保存接收和发送字节流。

数据可视化解释器#

Hex 检查器支持多种解释方式：

类型	用途
十六进制 8/16/32/64 位	查看寄存器、命令字、状态位、地址和标志。
无符号十进制 8/16/32/64 位	查看计数、长度、ADC 原始值、频率等非负数。
有符号十进制 8/16/32/64 位	查看温度、偏差、速度、误差等可能为负的值。
float16 / float32 / float64	查看传感器、控制量、姿态和算法输出。
二进制	查看 bit flag、状态位和掩码。
Hex II	更紧凑地区分可打印字符、零值和控制字节。
RGBA8 颜色	调试图像、灯效或颜色协议时快速确认字节顺序。

调协议时的推荐动作#

在表格或文本视图里找到一条完整数据。
切到 Hex 分析视图，选中命令号、长度和载荷字段。
切换大小端，确认数值是否符合设备实际。
记录字段偏移和数据类型。
再到数据面板建立 RX Channel。

这样能减少“通道值不对但不知道错在哪里”的时间消耗。

导出与复盘#

现场问题建议至少保留三类证据：

导出内容	适合复盘的问题
文本日志	人能读懂的状态、错误码、版本、命令回显。
表格记录	时间、方向、长度、响应延迟、是否重复或丢失。
Hex 或 CAN 表	精确字节、ID、DLC、标志位、总线状态。

不要只留截图。截图适合报告，导出文件适合定位。