用协议模板接入非标设备
没有内置驱动的设备(电表、电子秤、打印机、扫码枪、自制板卡)按协议手册拼帧接入:内置 17 个模板可直接套用,字节拼帧编辑器所见即所发,外部设备绑定模板即插即采。
你将完成
读完本篇你将完成:
- 看懂协议模板的结构:参数 + 方法(请求帧 / 响应解析);
- 在字节拼帧编辑器里按手册拼出一条正确的帧,并用帧预览核对;
- 配好应答帧定位与字段提取;
- 建一台外部设备绑定模板,实测出数据。
开始之前
- 手头有设备的通信协议手册(帧格式、校验算法、示例报文);
- 已了解配置采集点位的基本概念。
什么时候用协议模板#
114 类内置驱动覆盖了主流 PLC 与标准协议。但电表(DL/T645)、电子秤、标签打印机、扫码枪、自研 485 板卡这类设备,各家帧格式不一,不值得写进驱动。协议模板把它们变成「配置」而不是「代码」:
- 一个模板 = 一份协议描述:模板参数(设备地址等实例化时才定的值)+ 若干方法(读数据、写参数、主动上报);
- 每个方法两步走:请求帧装配(按手册顺序拼字节)与响应解析(从应答里定位帧、提字段);
- 模板发布后被外部设备引用:同一型号多台设备共用一个模板,各填各的地址。
内置模板先找一遍
外部设备 → 协议模板 列表内置 17 个模板:DL/T645-2007 电表、Modbus RTU / TCP、三菱 MC 3E、欧姆龙 HOST Link、梅特勒电子秤、SCPI 仪器、NMEA GPS、ESC/POS / TSPL / ZPL 打印机、GRBL 雕刻、CAN 通用、扫码枪等。多数非标设备能从最近的模板复制后小改。
- 1新建模板
- 217 个内置模板覆盖电表、电子秤、打印机、扫码枪、GPS 等;内置模板只读,可「复制为我的模板」后修改
复制一个内置模板#
内置模板只读。点卡片上的 查看 进编辑器读一遍,或直接点 复制为我的模板 得到可改副本。下面以内置的 DL/T645-2007 电表 为例走一遍。
认识编辑器布局#
编辑器全屏三块:左栏是方法列表(查询、主动上报、错误码表)与模板参数;中间是当前方法的方法栏(code、轮询、应答超时、重试)与步骤条;底部常驻帧预览。
在「请求帧装配」里拼帧#
切到 请求帧 步骤。字段自上而下顺序拼接为一条完整报文,添加字段 从 11 种类型里选:
| 字段类型 | 用途 | 关键属性 |
|---|---|---|
| 常量 | 协议固定字节 | value(hex / 文本,支持 {{参数}} 占位) |
| 参数 | 实例化时才定的值 | 引用模板参数,format(bcd-4 / hex2 / ascii…) |
| 文本块 / 二进制块 | 固定字符串 / 字节串 | 编码(ascii / utf-8 / gbk…) |
| 长度域 | 自动计算数据区长度 | 从 / 到 哪个字段,format |
| 滚动序号 | 每次递增的序号 | format、初值 |
| 时间戳 | bcd 时间 / unix 秒 | 格式 |
| 填充 | 前导、对齐 | value × N 字节 |
| 转义规则 | 帧内字节转义 | 界定字节 |
| 校验段 | CRC / 累加和 / XOR | 算法、覆盖区间、端序 |
| 帧尾 | 结束符 | value |
DL/T645 的读数据请求帧共 9 段 20 字节(前导 FE×4 → 起始 68 → 6 字节 BCD 地址 → 68 → 控制码 11 → 长度 04 → 数据标识 → 累加和 CS → 结束 16):
编辑器里每段一行,偏移、字节数实时可见:
- 1「请求帧装配」面板:9 个字段 · 共 20 字节,自上而下顺序拼接为一条完整报文
- 2校验段:选好算法与覆盖区间,发送时引擎自动计算填入
校验不用手算
校验段选好算法(CRC16/MODBUS 低前 / 高前、CCITT、XMODEM、SUM8、XOR8、LRC、CRC32 等)与覆盖区间,引擎发送时自动计算填入。
用帧预览核对#
底部帧预览「所见即所发」:填好示例参数,每个字节的十六进制值与 ASCII 对照显示,颜色按字段类型区分,改任何字段立刻重算——把预览与手册示例逐字节比对,一致就拼对了。复制 HEX 可直接拿去用其它工具发。
- 1帧预览
- 2复制 HEX
手册里有示例报文时更省事:点 反向解析,粘贴样例帧,系统自动反推字段序列生成装配表。
配「响应解析」#
设备应答怎么认?切到 响应解析 步骤,四节配置:
- 帧定位:应答帧从哪开始到哪结束——策略选「帧头 + 长度域 / 定长 / 分隔符 / 整包 (UDP)」,填帧头 hex、长度域偏移等;
- 校验与判定:应答校验算法(可带 csOffset)、ack / nack 匹配值、异常码位(Modbus 0x80);
- 同信道分类器:应答与主动上报混在一个通道时按前缀分流(如 GRBL 的
ok与ALARM:); - 字段提取:从应答帧里取数据字段,每行一个——key、显示名、offset、类型(u8…f64、bcd、bit)、长度、字节序(AB / BA / ABCD / BADC / CDAB / DCBA)、scale、单位。
- 1帧定位
- 2字段提取
响应帧示例验证
「响应帧示例」框里粘贴手册的应答样例帧,提取规则会实时高亮映射到字节上,offset 填错一眼看出。
试发验证#
试发验证 步骤填真实通道(串口 / TCP)与参数实测:发出去、收回来、字段解析成功才算通过。通过后 保存 并 发布版本,模板进入可引用状态。
建外部设备绑定模板#
模板只是协议描述,采集还要落到设备。外部设备 页点 接入设备:
- 1第一步先选协议模板:点开弹窗按分类 / 品牌挑
- 2连通测试
四步填完:选择协议模板 → 通道配置(TCP 填主机 / 端口;串口填串口名 / 波特率 / 数据位 / 校验位 / 停止位,RS485 共享串口按需开启;心跳周期默认按模板)→ 模板参数(如 DL/T645 的 12 位表号地址)→ 设备信息(设备名,身份路径 extdev/名称)。底部 连通测试 先验证链路,再 保存。
预期结果
设备列表出现新设备,状态「运行中」;详情页 手动调用 可以随时触发方法读一次,解析字段进入实时数据,与普通点位一样用于画面与告警。
常见问题#
内置模板改不了#
内置模板只读。点卡片 复制为我的模板,在副本上改;导出 JSON 也可以在别处导入。
试发收不到应答#
先核对串口参数或 IP / 端口;再用调试工具的串口 / TCP 客户端发同一帧看设备是否应答,区分「帧不对」与「链路不通」。
字段值不对但帧收到了#
多半是字节序或 scale:数值错得离谱查字节序(ABCD / CDAB 互换试),数值差固定倍数查 scale 与单位换算。
下一步#
这篇文档对你有帮助吗?