02 mqttx 对接 onenet 设备 属性 上报 完整测试本篇讲解中国移动OneNET平台标准物模型设备属性上报流程采用MQTT协议通信使用MQTTX工具模拟设备端完成报文收发测试掌握上报主题规范、报文格式与平台交互逻辑。1. 设备属性上报本次演示普通直连设备上报不涉及子设备层级设备主动向平台上传自身运行状态、传感数据等属性信息。1.1 通信主题规范主题采用平台固定模板格式pid为产品IDdevice-name为设备名称按需替换实际参数即可。上行上报请求Topic$sys/{pid}/{device-name}/thing/property/post示例实际主题$sys/p1Fj0crQJo/device_2412/thing/property/post平台应答响应Topic设备订阅该主题接收平台上报结果回执$sys/{pid}/{device-name}/thing/property/post/reply示例实际主题$sys/p1Fj0crQJo/device_2412/thing/property/post/reply1.2 OneJSON标准报文格式平台统一使用JSON格式交互字段含义固定上报数据必须严格遵循格式封装。设备上行上报报文{id:123,version:1.0,params:{temperature:{value:25}}}字段说明字段释义id消息唯一编号自定义自增数值用于匹配应答报文version协议版本固定填写1.0params属性参数集合可同时上报多个属性temperature物模型定义的属性标识符与平台配置一致value属性实际上报数值平台下行响应报文上报完成后平台原路返回应答以此判断上报是否生效{id:123,code:200,msg:success}字段说明字段释义id对应上报消息编号一一匹配code状态码200代表上报成功msg结果描述信息2. 整体测试流程测试借助MQTTX客户端模拟设备完成连接、订阅主题、发布上报报文、查看平台数据全流程验证。2.1 平台前置配置上报属性前必须先在OneNET产品后台添加对应物模型属性否则平台无法解析上报数据。根据业务需求创建温度、开关、湿度等属性属性标识、数据类型要和上报报文内参数保持统一。2.2 MQTTX客户端操作填写OneNET MQTT接入地址、端口、设备认证信息建立设备与平台连接订阅属性响应主题等待平台回执消息按照标准JSON格式编辑上报报文发布至设备上报主题客户端面板可实时查看下发报文、平台返回应答内容。2.3 平台数据校验报文下发无误后刷新设备详情页面能够看到temperature属性数值同步更新为上报的25代表属性上报链路通信正常数据成功存入平台。3. 常见问题小结属性上报失败核对报文内属性标识、数据类型和平台物模型配置是否一致收不到平台响应检查是否正确订阅reply响应主题MQTT连接状态是否正常状态码非200排查设备接入秘钥、主题地址、JSON格式语法错误。