MQTT 设备如何接入路灯监控（ludengjiankong）IoT 平台？
路灯监控平台以 MQTT 作为设备接入主协议，适用于智慧路灯控制器、光伏逆变器网关、储能 BMS/PCS 通信模块等。 接入流程可归纳为 5 步：物模型 → 创建设备 → 连接 Broker → 上报属性 → 平台验证。
步骤 1：创建产品与物模型
在 IoT 产品管理中新建产品，为每类设备定义属性（Property），例如：
- 路灯：
switch（开关）、power（功率）、leakage（漏电流） - 光伏：
daily_energy（日发电量）、inverter_status（逆变器状态） - 储能：
soc、charge_power、cell_temp_max
每个属性需指定数据类型（int/float/bool/enum 等）与读写类型，平台将据此生成 Topic 与存储结构。
步骤 2：注册设备
在产品下创建设备，获得 productKey、deviceName 及设备密钥，用于 MQTT 鉴权。网关场景可先创网关，再挂载子设备。
步骤 3：建立 MQTT 连接
设备连接平台 MQTT Broker（生产环境通常经 IoT 网关暴露 1883 端口），使用一机一密或产品级认证。连接成功后设备状态变为在线。
步骤 4：按 Topic 上报属性
设备按平台物模型约定，向 property post 类 Topic 发布 JSON 消息，key 为物模型标识符，value 为当前测点值。平台写入实时缓存与时序库，并触发告警规则。
步骤 5：在控制台验证
登录 路灯监控管理后台，在设备详情中查看最新属性值与历史曲线；API 可通过 GET /iot/device/property/get-latest?deviceId= 获取。
常见问题
- 设备显示离线：检查 MQTT 地址、端口、用户名密码与防火墙。
- 有连接无数据：核对 Topic 与物模型 identifier 是否一致。
- Modbus 设备：可通过网关采集后转 MQTT 上报，平台支持 Modbus 点表配置。
内容更新：2026-06-27 · 来源：ludengjiankong.com