波形、仪表与 3D 观察#

当协议值已经能稳定解析出来，下一步就是把这些值变成容易判断的画面。NexuTrace 的可视化重点是联调判断：趋势是否正确、阈值是否越界、开关是否真的写到设备、姿态或机构动作是否跟数据一致。

通道绑定怎么想#

数据来源	适合绑定到	常见用途
RX Channel	曲线、仪表、LED、数码显示、3D 节点	查看设备上报值，例如电压、电流、温度、角度、转速。
TX Channel	输入框、滑块、开关、按钮	生成要发给设备的控制值。
GX Variable	曲线、公式、控件、状态显示	存放工程换算值、中间结果或跨控件共享状态。

控件并不是越多越好。建议每个调试页围绕一个问题组织：例如“电机闭环”“BMS 状态”“传感器标定”“CAN 网关压力测试”。这样现场排障时不会被无关数据淹没。

常用控件#

控件	适合显示或控制
Gauge / Ruler	转速、角度、压力、速度等连续值。
Battery / Temperature	电量、电压、温度和热状态。
LED	故障位、使能位、在线状态、限位开关。
Toggle Switch	设备使能、模式切换、继电器开关。
Digit Display	需要醒目显示的数值，例如母线电压或错误码。
Value Input	目标值、阈值、增益、占空比等可写参数。
Label / Image	分组说明、设备示意图或状态背景。

控件设置重点#

设置	用途
标题	让面板上的控件一眼可读，建议和通道业务名一致。
单位	给仪表、数值和曲线补充工程单位，例如 V、A、rpm、degC。
最小 / 最大刻度	仪表、标尺、滑动输入的范围。范围过大时变化不明显，范围过小时容易误判越界。
横向 / 纵向	标尺、音量等控件可按布局选择方向。
绑定通道	决定控件读 RX/GX，还是写 TX/GX。

输入类控件要格外小心。建议先绑定到 GX 变量观察，再确认公式和 TX 帧正确后写入真实 TX 通道。

波形观察#

波形视图适合看趋势、延迟、抖动和多通道关系。你可以把 RX/TX/GX 通道加入 Plot Channels，然后在波形窗口里调整显示方式。

设置	建议
Y 轴自动 / 手动	初次观察用自动；要截图对比或看小幅波动时改手动范围。
X 实时 / 自动 / 手动	实时适合在线观察；手动适合回看某段数据。
标记与测量	用来比较两个点的时间差和值差，适合确认响应延迟。
采样降密度	长时间记录时减少绘制压力，让趋势仍然流畅可读。
导入 / 保存 / 清空	保存关键曲线用于报告或复盘，清空后重新开始一次实验。

标记样式包括圆、方、菱形、上/下/左/右三角、十字、加号和星形。多通道截图时，可以用不同标记和颜色区分曲线，避免只靠线条颜色判断。

波形适合看的问题#

问题	看法
控制响应延迟	同时显示 TX 目标值和 RX 实际值，用测量工具看 dT。
抖动	固定 Y 轴范围，观察小幅波动，不要让自动缩放掩盖变化。
饱和或限幅	观察值是否长期贴近上限或下限。
传感器异常	多通道对比，查单通道突变、掉零或阶跃。
CAN 总线拥堵影响	结合状态栏 bus load 和关键通道曲线看延迟。

做波形截图前，建议固定 Y 轴范围并隐藏无关曲线。这样不同实验之间更容易对比。

3D 观察#

3D 视图适合把角度、位移、姿态、阀门开度、机械臂关节等值放到模型上看。你可以把场景配置放在 config/cfg_model，加载后把通道绑定到模型节点的旋转、位移或显示状态。

建模和绑定时建议遵循这几条：

模型节点名尽量和设备含义一致，例如 joint_1、wheel_left、valve_main。
先只绑定一两个关键通道，确认方向、零点和量纲正确后再扩展。
角度值要明确单位是度还是弧度，必要时用公式先换算。
3D 只做判断辅助，协议原始值仍应保留在通道和波形里。

自动循环输出#

部分绑定输出支持自动循环，例如向上循环、向下循环和上下来回。它适合做演示、扫值和压力测试。

参数	含义
模式	向上循环、向下循环或上下来回。
步长	每次变化多少。
周期	多久变化一次。
最小 / 最大	限定输出范围。
启动	开始让绑定值自动变化。

自动循环会改变通道值，TX 帧如果绑定了该通道，就可能持续向设备发送变化后的控制量。正式设备上使用前请先在安全条件下验证。

一个实用面板的搭建顺序#

用原始视图确认设备稳定收发。
在数据面板建立 RX/TX/GX 通道。
把关键 RX 值加入波形，确认趋势正确。
为状态位添加 LED，为关键数值添加仪表或数码显示。
为可写参数添加输入框、滑块或开关，并绑定到 TX 通道。
需要演示机构或姿态时再加载 3D 模型。
保存数据配置和窗口配置，下次直接复用。

这样搭出来的页面既能给工程师排障，也能给测试、硬件和客户现场说明问题。