设备开发简介
用户完成物模型定义后,需要按接入协议要求将设备接入到平台。本文档主要介绍如何使用开发平台进行设备开发。
设备开发也可支持用户管理Topic,可自由定义。
设备开发支持云端解析功能,当使用MQTT自定义透传协议时,希望在云端解析成物模型JSON格式,则可以开启云端解析。
Topic管理
物模型Topic
物模型Topic是平台为使用数据协议为物模型的产品时自动生成的Topic。
![](https://qcloudimg.tencent-cloud.cn/image/document/b0af5e9d272e6fa0e3b7a58f2636ab10.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/b0af5e9d272e6fa0e3b7a58f2636ab10.png)
系统级Topic
系统级Topic是平台为每个产品自动生成的Topic,通常为系统标准功能如OTA。
![](https://qcloudimg.tencent-cloud.cn/image/document/391c794d9ef6b2c8848f3a659cd0e291.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/391c794d9ef6b2c8848f3a659cd0e291.png)
自定义Topic
自定义Topic是平台为用户提供的自定义Topic的管理功能,通常应用于用户需要自由定义设备与平台之间的报文传输格式以及Topic名称。
1. 进入“设备开发”,选择“Topic列表”,点击“自定义Topic”。
2. 系统默认为用户创建的产品生成了3个自定义Topic,若用户需要定义新的Topic,则点击“添加自定义Topic”按钮。
![](https://qcloudimg.tencent-cloud.cn/image/document/f9a03651a7ba282cb4fefdd8e71efe01.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/f9a03651a7ba282cb4fefdd8e71efe01.png)
3. 在下图界面上输入Topic名称,设置该Topic的权限,点击“确定”即可创建Topic。
![](https://qcloudimg.tencent-cloud.cn/image/document/acc9e5a2d65898b2823ae2a2bd0cdaab.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/acc9e5a2d65898b2823ae2a2bd0cdaab.png)
操作权限包括“发布”、“订阅”、以及“订阅和发布”。
发布:指该Topic设备端只能发布,无权限订阅,发布权限的Topic一般是设备端将数据发送到平台。设备如果订阅了只有“发布”权限的Topic,会订阅失败,云端诊断日志也会提示“Subscribe no 权限(待完善)”。
订阅:指该Topic设备端可订阅,物联网平台将通过该Topic下发消息至设备。
发布和订阅:指该Topic同时具备发布与订阅权限。
设备开发
用户创建完产品并定义完产品的物模型后,可单击设备开发,可通过平台提供的多语言SDK或已对接腾讯云物联网开发平台的模组、DTU、边缘网关接入平台。目前提供三种开发方式。
基于模组开发:满足 MCU 以串口通信方式,并通过模组与云端通信的场景。
基于 SDK 开发:满足直接集成 C SDK 的接入场景。
基于 OS 开发:满足基于物联网操作系统集成 C SDK 的接入场景。
![](https://qcloudimg.tencent-cloud.cn/image/document/2fca3a24e9b03421df351aa508a0a0fa.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/2fca3a24e9b03421df351aa508a0a0fa.png)
基于模组开发
1. 如果您的设备需要通过通信模组连接开发平台,则单击基于模组开发。
2. 系统显示模组选择窗口,您需要根据您的业务需求选择合适的通信模组。包括模组品牌与模组通信类型,选择合适的模组后可单击确定。
![](https://qcloudimg.tencent-cloud.cn/image/document/f4827936dc0662f7fdf487e12228943b.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/f4827936dc0662f7fdf487e12228943b.png)
3. 选择模组后,可单击重新选择更换模组,也可以单击查看详情了解模组的详细参数,还可以单击采购咨询去模组公司采购。
![](https://qcloudimg.tencent-cloud.cn/image/document/67d4fe3b33d23f3531787596a0330e89.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/67d4fe3b33d23f3531787596a0330e89.png)
4. 嵌入式开发。
通过模组对接的设备,如果定义了数据模板,则平台提供了 MCU SDK 代码自动生成的功能,MCU SDK 代码用于加快 MCU 如何对接通信模组。
单击 MCU SDK 代码,开发平台会生成一个压缩文件,您下载后即可遵循开发指引将设备对接到开发平台。
如何基于下载的 MCU SDK 代码进行 MCU 开发,详情请参见 设备开发指南 相关文档。
![](https://qcloudimg.tencent-cloud.cn/image/document/8b19b8c20d7a0a90ee521185bb2e74d1.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/8b19b8c20d7a0a90ee521185bb2e74d1.png)
5. 下载 AT 指令协议。
单击 AT 指令协议 可了解腾讯云 IoT AT 指令协议。
基于 OS 开发
1. 如果您的设备所运行的物联网操作系统为 SDK 已经对接支持的 OS 类型,可以单击基于 OS 开发 查看基于对应物联网操作系统接入平台的开发指南。
2. 嵌入式开发。
数据模板配置文件生成:如果已创建所定义产品的数据模板及事件,您可根据指南文档了解如何将数据模板生成模板代码、如何基于生成的数据模板配置文件以及数据模板示例进行业务逻辑开发。
OS 代码下载:提供腾讯物联网终端操作系统 TencentOS tiny 和 RT-Thread 的下载路径。
开发指引:提供基于不同物联网操作系统接入腾讯云物联网开发平台的开发指南。
![](https://qcloudimg.tencent-cloud.cn/image/document/2ecdd2626f3131d2a7cbfbd2256c848a.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/2ecdd2626f3131d2a7cbfbd2256c848a.png)