移植自 WPF 模块 UtilityTools.Modules.CmdTestTool,作为 ZEM 工具集业务插件运行于 VS Code。
功能说明
通用指令调试工具:自由构造 ZepGenericProtocol 帧(设备 ID / 指令 / 寄存器地址 / 序列号 + 任意类型数据字段),通过通信插件下发,并解析回包头与数据区。对应原模块核心能力:
- 自定义 DeviceID、Cmd、Addr、Seq 编包
- 多字段数据区(U8/S8/Bool、U16/S16、U32/S32、Float/Double、Buffer(hex))
- 可选整帧附加 CRC16
- 回包解析展示(头部字段 + 数据区 int16 速览)
与原模块对应
| 原 WPF |
本插件 |
ZepGenericProtocol |
src/protocol/ZepGenericProtocol.ts(InitByteWriter/AddXxx/Pack/PackWithChecksum/AnalyseData 逐行复刻) |
ZepGenericProtocolParser |
src/protocol/ZepGenericProtocolParser.ts(按索引读取各类型) |
DevelopmentBoardMessage |
src/protocol/DevelopmentBoardMessage.ts(CRC32 + 固件头解析/构造) |
CRCHelper.GetCRC16 / DataTypeCaster / ByteWriter |
crc16.ts / datatype.ts |
ISyncRWService |
改为 comm.net.* / comm.serial.*(src/comm.ts thin wrapper) |
CmdTestToolViewModel + CmdTestToolView.xaml |
media/main.js 原生 JS 复刻 |
真实逻辑 vs Mock / 桩
- 真实移植(TypeScript):
ZepGenericProtocol 编包/解析、CRC16、CRC32、大小端字节序、数据区类型读取 —— 与原 C# 完全一致,可直接用于真实设备通信。
- 通信接入:底层串口/网口 I/O 不自实现,统一通过组H 通信插件门面
comm.net.* / comm.serial.*(契约已冻结,见《通信接口契约.md》)。src/comm.ts 已实现 getComm() / sendAndReceive() 薄封装,按需微调即可。
- Mock 场景:组H 通信插件默认 Mock(网口回显 / 串口定时回包
AA 55 01 seq sum),用于无设备时验证编包链路。
使用
命令面板 → ZEM CmdTestTool: 打开指令测试工具,选通道连接,填指令头与数据字段后「发送指令」。
| |