地质灾害监测接入
简介
地质灾害监测协议（geo）是联犀平台对接地质灾害监测设备的接入协议，支持两种接入方式：HTTP 数据上报（第三方平台主动推送）或 MQTT 直连。两种方式均以「设备密钥」鉴权。
应用场景
- 地质灾害监测：位移、雨量、土壤含水率等监测点数据上报
- 双通道接入：HTTP 上报（第三方平台推送）或 MQTT 直连（设备自主上报）
前置条件
- 协议容器已部署：
protocol-geological-hazard容器运行正常 - 设备可达：HTTP 上报地址（9216 端口）或 MQTT Broker（1883）可访问
设备接入
设备详情「设备接入」Tab 展示两种接入方式（设备密钥自动填入）：
下图为配置页服务正常启动时的完整接入配置示意（含 HTTP 上报地址、
deviceId/apikey/data字段说明与 MQTT 直连参数）。
配置页暂不可用时的说明
若「设备接入」Tab 提示「配置页暂不可用：协议 geo 暂无可用的配置页服务实例（服务未启动或未提供配置页）」，说明协议网关的配置页服务未启动。此时暂时无法在页面中直接查看 HTTP/MQTT 接入参数，接入参数以下文表格与示意图为准；待配置页服务启动后，页面将自动展示与示意图一致的接入配置。
接入方式一：HTTP 数据上报
| 字段 | 值 |
|---|---|
| 上报地址 | http://{host}:9216/api/devices/datapoints |
| 请求方式 | POST |
deviceId | {productID}&{deviceName}（联犀标准式） |
apikey | 设备密钥（自动填入） |
data | 监测点原始数据（JSON 字符串） |
接入方式二：MQTT 直连
| 参数 | 值 |
|---|---|
| Broker | mqtt://{host}:1883 |
| ClientID | {productID}&{deviceName}（联犀标准式） |
| Username | 不校验（可留空） |
| Password | 设备密钥明文（自动填入） |
Topic 清单
| 方向 | Topic | 说明 |
|---|---|---|
| 上行 | $dr/# | 实时数据上报 |
| 上行 | $dp/# | 数据点上报 |
| 下行 | $creq/{deviceID}/cmd | 命令下发（deviceID=productID&deviceName） |
| 下行 | /ota/device/upgrade/{productKey}/{deviceName} | OTA 固件升级 |
技术方案
接入架构
监测设备 ──HTTP POST /api/devices/datapoints──> protocol-geo 容器(9216) ──> 联犀平台
监测设备 ──MQTT($dr/#、$dp/#)──> protocol-geo 容器 ──> 联犀平台- HTTP 上报：
deviceId用GetClientIDInfo解析，apikey作为设备密钥（首次上报创建设备、后续鉴权） - MQTT 直连：ClientID 用联犀标准式解析，Password 与设备密钥明文比对（非 HMAC）
- 一型一密动态注册（regnwl）基于产品密钥 HMAC，与连接认证无关
注意事项
- HTTP 上报与 MQTT 直连二选一即可（或同时）
- 设备密钥是核心鉴权信息，配置页自动填入
- 首次 HTTP 上报会自动创建设备（deviceId + apikey）
更新日志
2026/8/31 22:31
查看所有更新日志
2fc1c-于70dbb-于4ab8f-于
