
1. 注册与创建云端产品实例要实现底层硬件如下位机MCU与云端的数据交互第一步需要在OneNET平台建立对应的“云端映射”即完成产品的创建与基础架构的配置。1.1 平台接入与开发者准备在中国移动OneNET开放平台完成账号注册。由于目前国内物联网平台的规范化管理建议注册后同步完成开发者实名认证。1.2 创建产品定义硬件的通信属性进入控制台页面在“设备接入与管理”模块创建产品。产品名称建议使用规范的工程化命名。例如可以命名为“多源信息感知终端”或“智能边缘计算网关”这样能凸显项目的工程实践背景。行业分类根据设备的实际应用场景选择例如“工业物联”或“仪器仪表”。节点类型直连设备如果你的主控MCU如搭配ESP8266 WIFI模块或4G Cat.1模块直接与服务器建立TCP长连接选择此项。网关设备如果你的系统包含多个子节点设备需要通过一个集中式的主控网关统一汇聚并上报数据则选择此项。接入协议核心选择“MQTT”。MQTT协议凭借其轻量级、低带宽消耗的发布/订阅Pub/Sub机制非常适合硬件资源受限且网络环境复杂的嵌入式系统。数据格式通常推荐选择“JSON”或平台标准的“OneJSON”。这意味着在后续的固件开发中需要在单片机中移植如cJSON库将采集到的传感器数据封装为标准的键值对Key-Value格式再进行Topic发布。2. 定义物模型与数据流在产品开发页面中根据实际的硬件传感器需求添加自定义功能。例如设置温度、湿度等数据流节点注意数据类型的匹配如int32或float。3. 增加设备在 OneNET 平台的标准架构中“产品”和“设备”是父子层级关系集合与节点的关系类似于类和对象的概念产品Product是一组具有相同功能特性的设备集合。这一层级主要用于统一配置通信规范。在创建产品时我们预先定义了这批硬件的接入协议MQTT、数据格式以及“物模型”即设备包含的属性、事件和服务。设备Device是挂载在具体产品下的独立物理节点。每个设备自动继承所在产品的通信规范同时平台会为其分配全局唯一的设备名称DeviceName和专属鉴权密钥DeviceKey4.获取MQTT连接核心参数4.1 服务器地址与端口mqtts.heclouds.com,1883端口号1883非加密端口或 8883TLS加密端口4.2 提取MQTT三要素 (ClientID, Username, Password)MQTT三要素的获取及底层实现流程可以参考LwIP开源网络协议栈的标准MQTT实现逻辑。连接验证所需的信息ClientID设备的名称Username产品IDPassword (Token)需要使用平台提供的算法生成。ClientID:用户名4.3 Token的计算规则Token的生成依赖于鉴权参数。具体计算工具可在OneNET官方文档中心搜索“Token生成工具”获取。组装参数示例res: products/你的产品ID/devices/你的设备名 如 products/Qbym8DbMJ2/devices/OTA001et: 1672735919过期时间戳需注意时效性保持和文档一致就行key: 产品或设备对应的 AccessKey将以上参数填入生成工具即可得到用于MQTT连接的最终密码Password。获取完成后将其写入下位机的连接初始化结构体中即可发起连接。Token生成工具获取 建议前往 OneNET 控制台 - 帮助文档 - API参考 - 鉴权机制 中下载官方提供的 Token 生成工具。