HJ212Master
插件用途
HJ 212 污染物在线监控数据接收和变量映射驱动
选择入口
进入“开发配置 → 采集配置”，创建设备并在“采集插件”中选择“HJ212Master”。
支持的通道和数据类型
| 通道类型 | 配置前检查 |
|---|---|
| UDP | 确认本地绑定地址、端口和防火墙规则，并核对报文来源。 |
| TCP 客户端 | 确认设备 IP、端口和网关到设备的网络可达性。 |
| 串口 | 确认串口未被其它程序占用，并与设备保持一致的波特率、数据位、停止位和校验位。 |
可选数据类型： Boolean、Byte、Int16、UInt16、Int32、UInt32、Int64、UInt64、Float、Double、String、Decimal
地址规则
- 变量地址按 HJ 212 报文头匹配，格式为
ST=<系统编码>;MN=<设备唯一标识>;CN=<命令编码>。 ST对应报文中的系统编码，MN对应设备唯一标识，CN对应命令编码。- 三个字段应填写现场设备实际上报值，格式示例为
ST=<现场ST>;MN=<现场MN>;CN=<现场CN>。 - 匹配成功后，变量值接收该报文的
CP数据区。需要提取单个污染物字段时，再使用读取表达式处理CP内容。 - 地址字段名不区分大小写，建议统一使用大写
ST、MN、CN；字段之间使用英文分号。 - 该插件只接收设备主动上报，不支持主动读取或变量写入。
设备调试
进入“开发配置 → 采集配置”，选择当前设备后点击“更多功能”并打开“调试”。
专用调试页
协议调试页使用接收监视，展示 HJ 212 主动上报进入变量映射后的状态。
| 功能 | 作用 |
|---|---|
| 最后活动时间 | 查看最近一条合法 HJ 212 报文的接收时间。 |
| 变量表格 | 查看匹配变量的来源地址、当前 CP 值、在线状态、采集时间和最近错误。 |
| 消息统计 | 查看调试队列、丢弃和截断数量。 |
| 消息日志 | 观察当前会话收到的 HJ 212 报文。 |
验证重点
- 从一条真实测试报文中记录
ST、MN和CN，按本页格式创建一个变量。 - 让同一设备重新发送该命令报文，确认接收监视出现新记录。
- 核对变量当前值为报文
CP数据区，采集时间同步更新且最近错误为空。 - 改用不同
MN或CN的测试报文，确认它不会错误更新当前变量。 - 需要单个污染物数值时，配置读取表达式后再核对提取结果和数据类型。
排障差异
- 接收监视没有新报文：确认设备正在主动上报，并检查通道、帧边界和 HJ 212 报文校验。
- 有报文但变量不更新：逐项核对
ST、MN、CN与收到报文完全一致，尤其不要保留示例占位值。 - 变量显示完整 CP 而不是单个污染物值：这是当前映射方式；使用读取表达式提取目标字段。
- 多台设备数据进入同一变量：变量地址必须包含能够区分来源的
MN，并按命令补充CN。 - 串口设备无响应：确认串口未被占用，并核对波特率、数据位、停止位和校验位。