疑难排查

排查总表

问题	优先检查	进一步处理
找不到设备	驱动、线缆、设备供电、模式选择。	切换连接类型刷新列表，确认设备未被其他软件占用。
连接失败	端口占用、权限、防火墙、IP / 端口。	串口看占用，网络看本机防火墙与目标连通性。
收发乱码	发送 / 接收编码是否一致。	在 UTF-8、GBK、ASCII 等编码间切换验证。
协议无数据	是否开启协议，cmd 是否匹配，帧尾 / CRC 是否正确。	先用 Hex 看原始帧，再看 Raw Frame 是否刷新。
通道值不变	RX Frame、offset、type、载荷长度。	确认 offset + 类型字节数 未越界。
波形不刷新	Plot Channel 是否绑定数据源，协议帧是否持续解析。	先确认数据面板 value，再确认 Plot 显示开关。
控件不响应	接收 / 发送绑定方向是否选对。	RX 为只读显示，TX / GX 才能用于写回。
界面资源异常	字体、图片、语言 JSON 是否随包存在。	重新解压或使用完整发行包。

术语速查

Raw / 原始流

未经协议解析的收发字节存档，可被文本、表格和 Hex 使用。

cmd_value

协议帧命令字，用来匹配帧模板和通道映射。

RX / TX / GX

接收通道、发送通道、通用变量通道。

Frame Template

数据面板中描述某类接收帧或发送帧的模板。

Binding

把数据通道连接到仪表、开关、数码管、波形或 3D 参数的关系。

Auto

TX 帧按设定周期自动组帧发送。

tail

Plot 中当前可见的 X 轴采样窗口长度。