中国移动 OneNET 平台 MQTT 协议接入完整教程【FS800DTU-A2M1 模块】一、前言本文以FS800DTU-A2M1模块为硬件平台详细介绍如何将设备接入中国移动OneNETCM IoT平台并通过 MQTT 协议上报数据。内容涵盖平台产品创建、物模型配置、设备添加、Token 计算、MQTT 参数填写以及使用串口配置工具发送 JSON 数据至 OneNET 平台的完整流程。二、OneNET 平台开发2.1 创建产品登录 OneNETCM IoT平台在左侧菜单栏进入产品开发页面可以看到已有产品列表。点击右上角「 创建产品」按钮开始创建新产品。2.2 选择智能化方式——设备接入在弹出的创建产品对话框中步骤一选择产品品类例如智慧城市 公共服务 移动对讲机步骤二选择智能化方式选择「设备接入」设备接入方式提供设备开发、设备调试、数据推送等功能快速完成产品接入物联网平台适用于原 NB-IoT 套件、MQTT 套件、Studio 老用户。2.3 填写产品信息——协议与联网方式在填写信息步骤中按照以下配置填写配置项填写值接入协议MQTT数据协议OneJson联网方式蜂窝开发方案标准方案填写完成后点击确定产品即创建成功。2.4 配置物模型产品创建完成后进入产品开发页面点击「设置物模型」按钮为产品添加属性。以下为示例物模型属性配置功能类型功能类别功能名称标识符数据类型读写类型属性自定义湿度uidustring字符串读写属性自定义hexuilqbuffer二进制读写属性自定义温度wendustring字符串读写注意标识符是后续 JSON 上报数据中params字段的 key需与上报数据严格对应。2.5 添加设备1进入设备管理点击添加设备在左侧菜单栏进入设备接入管理 → 设备管理点击右上角「 添加设备」按钮。2填写设备名称在弹出的添加设备对话框中所属产品选择刚刚创建的产品如Demo1设备名称填写设备名称如Try_Demo1填写完成后点击确定设备创建成功。2.6 记录关键信息设备创建完成后点击设备列表中该设备的详情链接进入设备详情页记录以下关键参数设备密钥keydjg1V0xwZ2tCOW10cjBaUmFlcjRzVTlPeWdoOTJNY示例值请以实际为准产品 ID99V3O942Jq示例值请以实际为准设备名称Try_Demo1重要设备密钥Key用于后续计算 MQTT 登录 Token请妥善保存。2.7 使用 OneNET Token 计算工具生成密码MQTT 登录时的密码Password需要使用官方 Token 计算工具生成参数如下参数说明示例值res资源路径products/99V3O942Jq/devices/Try_Demo1et过期时间Unix 时间戳1784961505key设备密钥djg1V0xwZ2tCOW10cjBaUmFlcjRzVTlPeWdoOTJNYmethod加密方式md5version版本2018-10-31填写完成后点击Generate生成 Token即为 MQTT 登录密码。生成的密码格式如下示例version2018-10-31resproducts%2F99V3O942Jq%2Fdevices%2FTry_Demo1et1784961505methodmd5sign7Rh%2FrWoDUce7foogE0KQ4A%3D%3D2.8 配置 MQTT 订阅与发布主题根据 OneNET 平台 OneJson 协议规范设备的 MQTT 主题格式如下上报订阅主题$sys/99V3O942Jq/Try_Demo1/thing/property/post/reply 发布主题 $sys/99V3O942Jq/Try_Demo1/thing/property/post说明$sys/{产品ID}/{设备名称}/thing/property/post为属性上报主题post/reply为平台回复确认主题。2.9 在 DTU 配置工具中填写 MQTT 参数打开SerialPort_To_Network_ConfigTools串口转网络配置工具在通道1中选择MQTT协议按以下参数填写配置项填写值服务器 IP 地址/域名mqtts.heclouds.com服务器端口号1883SSL 加密不启用ClientIDTry_Demo1设备名称用户名99V3O942Jq产品 ID密码Token 计算工具生成的密码字符串KeepAlive60会话标志位清除会话多主题模式不启用订阅主题property/post/reply发布主题thing/property/postMQTT 三元组对应关系说明MQTT - ClientID ----- OneNET 的设备名称如 Try_Demo1 MQTT - 用户名 ----- OneNET 的产品 ID如 99V3O942Jq MQTT - 密码 ----- Token 工具生成的 Token 字符串2.10 发送 JSON 数据上报属性1准备 JSON 数据格式参数填写完毕后点击「设置所有参数」将配置写入 DTU 模块。在发送区输入以下 JSON 格式的上报数据{id:123,version:1.0,params:{wendu:{value:25},uidu:{value:65}}}2发送数据并确认上报成功点击「发送」按钮在接收区可以看到平台返回的响应数据{id:123,code:200,msg:success}code: 200表示数据上报成功。2.11 在 OneNET 平台查看上报的数据登录 OneNET 平台进入对应设备的属性页面即可看到刚刚上报的属性数据已成功更新属性名当前值数据类型读写湿度65string读写温度hellostring读写hexundefinedbuffer读写三、总结本文完整演示了使用FS800DTU-A2M1模块通过 MQTT 协议接入中国移动 OneNETCM IoT平台的全过程关键步骤总结如下创建产品选择设备接入方式协议选 MQTT OneJson联网方式选蜂窝配置物模型添加所需属性如温度、湿度记录标识符identifier创建设备添加单个设备填写设备名称记录凭证保存产品 ID、设备名称、设备密钥生成 Token使用 OneNET Token 计算工具填入 res/et/key 参数后生成 MQTT 密码配置 DTU在配置工具中填写 MQTT 服务器地址、ClientID设备名、用户名产品ID、密码Token上报数据发送 OneJson 格式的 JSON 数据收到code:200确认成功验证结果登录 OneNET 平台属性页面查看上报数据参考资料OneNET 官方文档https://open.iot.10086.cn/doc/OneJson 属性上报主题格式$sys/{pid}/{device_name}/thing/property/postMQTT 接入地址mqtts.heclouds.com端口1883