快速开始
本文将带你从零安装 HJ212 模拟发送程序，并成功发出第一条标准报文。
环境要求
- 从源码运行：Node.js
18及以上，npm9及以上 - 直接使用安装包：无需安装 Node.js
- 操作系统：Windows / macOS / Linux
- 一台已启动、可接收 HJ212 TCP 报文的服务端（本机或局域网）
💡 提示
本地联调常用地址是 127.0.0.1，端口 9014。请先确认接收端已监听该端口，否则「连接测试」会失败。
安装
方式一：直接下载安装包（推荐普通用户）
GitHub Releases 提供预编译的桌面应用，无需安装 Node.js，下载即用：
📦 预编译安装包 v1.0.0
方式二：从源码运行（推荐开发使用）
git clone https://github.com/Fusuccess/hj212_sender.git
cd hj212_sender
npm install
npm run dev
npm run dev 会同时启动前端页面与 Electron 窗口。
首次打开需阅读声明，并在输入框中准确输入「我已知晓」后才能进入主界面。
方式三：自行打包安装包
在对应操作系统上执行打包命令，产物输出到 release/ 目录：
# 当前平台
npm run build
# 指定平台（建议在对应系统上执行）
npm run build:mac
npm run build:win
npm run build:linux| 平台 | 产物 |
|---|---|
| macOS | .dmg（x64 / arm64） |
| Windows | NSIS 安装包（x64） |
| Linux | AppImage（x64） |
macOS 本地打包默认跳过开发者证书签名。需要正式签名时使用：
MAC_SIGN=1 npm run build:mac发出第一条报文
以「水环境类监测设备」发送一条小时数据为例：
- 左侧导航选择 水环境类监测设备模拟。
- 在「连接配置」中填写：
- 目标地址：
127.0.0.1 - 端口：
9014 - MN：接收平台已登记的设备编号（必填）
- PW：访问密码，默认
123456 - ST：默认
32（地表水体环境污染源）
- 目标地址：
- 点击 连接测试，确认 TCP 可达。
- 发送模式保持 因子组帧，报文周期选择 小时数据（CN=2061）。
- 在右侧因子表中勾选要上报的监测项。不填「自定义值」时，程序会按因子精度随机生成数值。
- 点击 预览报文，在发送日志中确认帧内容。
- 点击 发送，等待日志出现 ACK。
成功时，日志中的应答通常类似：
##0037QN=...;ST=91;CN=9014;PW=123456;MN=你的MN;Flag=8;CP=&&&&⚠️ 注意
发送前必须填写 MN。连接测试只验证 TCP 端口是否开放，不代表平台已接受该 MN。
若只需检查报文格式，可以只点「预览报文」，不必真正发送。
发送大气类数据
左侧切换到 大气环境类监测设备模拟。默认 ST 为 31（大气环境污染源）。报文周期中的「分钟数据」对应 CN=2051，小时、日数据与水环境相同。
解析一条报文
- 左侧选择 报文解析。
- 粘贴完整帧（以
##开头）或仅粘贴数据段。 - 点击 解析，查看帧头、CRC、因子中文名称与数据标记。
解析页支持旧版因子编码（如 011、B01、S02），会同时给出对应的标准编码。
下一步
恭喜你完成了快速开始。接下来可以：