用协议模板接入非标设备

没有内置驱动的设备(电表、电子秤、打印机、扫码枪、自制板卡)按协议手册拼帧接入:内置 17 个模板可直接套用,字节拼帧编辑器所见即所发,外部设备绑定模板即插即采。

  • 专家
  • 动手约 25 分钟
  • 阅读 4 分钟
  • 更新于 2026-11-09

你将完成

读完本篇你将完成:

  • 看懂协议模板的结构:参数 + 方法(请求帧 / 响应解析);
  • 在字节拼帧编辑器里按手册拼出一条正确的帧,并用帧预览核对;
  • 配好应答帧定位与字段提取;
  • 建一台外部设备绑定模板,实测出数据。

开始之前

  • 手头有设备的通信协议手册(帧格式、校验算法、示例报文);
  • 已了解配置采集点位的基本概念。

什么时候用协议模板#

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. 1新建模板
  2. 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):

一条 DL/T645-2007 读数据请求帧的组成请求帧由前导 FE×4、起始符 68、6 字节 BCD 地址域、起始符 68、控制码、长度、4 字节数据标识、累加和校验、结束符 16 组成,共 20 字节;参数段在实例化设备时填入,校验段由引擎自动计算。DL/T645-2007 读数据请求帧20 字节 · 自左向右顺序发出(以内置模板为例)发往设备FE FE FE FE前导 4B68起始00 00 00 00 00 01地址域 6B68起始11控制码04长度00 01 00 00数据标识 4BCS校验16结束参数段:设备不同才变的字节,编辑器里选「参数」类型常量段:协议固定字节,直接写死校验段:引擎按覆盖区间自动计算,不用手填校验 CS = 从第一个 68 到数据标识末尾逐字节累加和的低 8 位,示例帧中为 E7。地址域 12 位 BCD 表号按「低位在前」倒序书写;数据标识 00 01 00 00 即正向有功总电能。
图 1 DL/T645-2007 读数据请求帧的组成:参数段随设备变,校验段引擎自动算

编辑器里每段一行,偏移、字节数实时可见:

请求帧装配:9 个字段 · 共 20 字节,校验段标出覆盖区间
  1. 1「请求帧装配」面板:9 个字段 · 共 20 字节,自上而下顺序拼接为一条完整报文
  2. 2校验段:选好算法与覆盖区间,发送时引擎自动计算填入

校验不用手算

校验段选好算法(CRC16/MODBUS 低前 / 高前、CCITT、XMODEM、SUM8、XOR8、LRC、CRC32 等)与覆盖区间,引擎发送时自动计算填入。

用帧预览核对#

底部帧预览「所见即所发」:填好示例参数,每个字节的十六进制值与 ASCII 对照显示,颜色按字段类型区分,改任何字段立刻重算——把预览与手册示例逐字节比对,一致就拼对了。复制 HEX 可直接拿去用其它工具发。

帧预览:20 字节逐个显示,图例标注各字段类型与占比
  1. 1帧预览
  2. 2复制 HEX

手册里有示例报文时更省事:点 反向解析,粘贴样例帧,系统自动反推字段序列生成装配表。

配「响应解析」#

设备应答怎么认?切到 响应解析 步骤,四节配置:

  1. 帧定位:应答帧从哪开始到哪结束——策略选「帧头 + 长度域 / 定长 / 分隔符 / 整包 (UDP)」,填帧头 hex、长度域偏移等;
  2. 校验与判定:应答校验算法(可带 csOffset)、ack / nack 匹配值、异常码位(Modbus 0x80);
  3. 同信道分类器:应答与主动上报混在一个通道时按前缀分流(如 GRBL 的 ok 与 ALARM:);
  4. 字段提取:从应答帧里取数据字段,每行一个——key、显示名、offset、类型(u8…f64、bcd、bit)、长度、字节序(AB / BA / ABCD / BADC / CDAB / DCBA)、scale、单位。
响应解析:① 帧定位 → ② 校验与判定 → ③ 分流 → ④ 字段提取
  1. 1帧定位
  2. 2字段提取

响应帧示例验证

「响应帧示例」框里粘贴手册的应答样例帧,提取规则会实时高亮映射到字节上,offset 填错一眼看出。

试发验证#

试发验证 步骤填真实通道(串口 / TCP)与参数实测:发出去、收回来、字段解析成功才算通过。通过后 保存 并 发布版本,模板进入可引用状态。

建外部设备绑定模板#

模板只是协议描述,采集还要落到设备。外部设备 页点 接入设备:

接入外部设备:选模板 → 配通道 → 填参数 → 连通测试
  1. 1第一步先选协议模板:点开弹窗按分类 / 品牌挑
  2. 2连通测试

四步填完:选择协议模板 → 通道配置(TCP 填主机 / 端口;串口填串口名 / 波特率 / 数据位 / 校验位 / 停止位,RS485 共享串口按需开启;心跳周期默认按模板)→ 模板参数(如 DL/T645 的 12 位表号地址)→ 设备信息(设备名,身份路径 extdev/名称)。底部 连通测试 先验证链路,再 保存。

预期结果

设备列表出现新设备,状态「运行中」;详情页 手动调用 可以随时触发方法读一次,解析字段进入实时数据,与普通点位一样用于画面与告警。

常见问题#

内置模板改不了#

内置模板只读。点卡片 复制为我的模板,在副本上改;导出 JSON 也可以在别处导入。

试发收不到应答#

先核对串口参数或 IP / 端口;再用调试工具的串口 / TCP 客户端发同一帧看设备是否应答,区分「帧不对」与「链路不通」。

字段值不对但帧收到了#

多半是字节序或 scale:数值错得离谱查字节序(ABCD / CDAB 互换试),数值差固定倍数查 scale 与单位换算。

下一步#

这篇文档对你有帮助吗?