透传格式数据业务交互示例
场景描述
根据实际业务场景来使用。如果不需要平台解析数据,仅透传数据的话,可以在设备成功接入移远通信物联网开发者中心后,通过 AT+QIOTSEND 与 AT+QIOTRD 指令来实现与开发者中心的数据交互,任何类型的数据均可采用透传模式。本章节指导用户通过AT指令进行透传格式业务收发。
涉及指令
指令名称 | 功能描述 |
---|---|
AT+QIOTCFG | 配置可选参数 |
AT+QIOTSEND | 发送透传数据至平台 |
AT+QIOTRD | 读取平台下发的透传数据 |
提示:详情请参考数据业务交互 相关命令。
操作步骤
平台侧
一、登录开发者中心
二、创建产品
创建产品详情请参考 创建产品。
设备侧
透传数据交互
开发建议:上报频率不宜过快,建议采用灵活上报的形式:
若是控制类的数据(如开关、工作模式),则可采用变化上报的方式。例如平台或者APP下发控制或者通过其他方式改状态值,设备再进行上报到平台端。
若是实时变化类的数据(如电流、温度值),则可采用定时上报。例如每隔5分钟设备定时上报一次到平台端。
示例一(发送字符串类型数据)
MCU可通过 AT+QIOTSEND=<mode>,<length>[,<data>] 指令向平台发送透传指令。
发送数据为长度12字节的字符串"ABCabc123456",QoS级别为1。
[TX]AT+QIOTSEND=1,12,"ABCabc123456"
[RX]OK
[RX]+QIOTEVT: 4,10200
提示:透传发送时,若QoS级别为1或以上,设备成功发送透传数据后将响应 OK 与 +QIOTEVT: 4,10200;若QoS级别为0,设备成功发送数据后将响应 OK 且不上报事件。
示例二(发送任意字符流类型数据)
MCU可通过 AT+QIOTSEND=<mode>,<length> 指令向平台发送透传指令。
发送长度10字节的字节流{0x00,0x01,0x02,0x03,0x04,0x05,0x06,0x07,0x08,0x09},QoS级别为2。
[TX]AT+QIOTSEND=2,9
[RX]AT+QIOTSEND=2,9
>
[TX]0x010203040506070809
[RX]OK
[RX]+QIOTEVT: 4,10200
提示:透传发送时,若QoS级别为1或以上,设备成功发送透传数据后将响应 OK 与 +QIOTEVT: 4,10200;若QoS级别为0,设备成功发送数据后将响应 OK 且不上报事件。
示例三(非缓存模式读取平台下发的透传数据)
若不配置则出厂默认为 0
:关闭缓存模式。
1、开发者中心下发透传数据
在 产品详情 详情页,单击 设备调试 页签可进行透传数据业务的交互。
2、模组向串口打印下行数据
模组收到数据后主动向MCU发送通知 +QIOTEVT: 5,10200 及该下行数据。
[RX]+QIOTEVT: 5,10200,12
ABCabc123456
示例四(缓存模式读取平台下发的透传数据)
1、打开下行数据缓存模式 MCU可通过 AT+QIOTCFG="buffer"[,<buffer_mode>] 指令配置下行数据缓存模式。
[TX]AT+QIOTCFG="buffer",1
[RX]AT+QIOTCFG="buffer",1
OK
2、开发者中心下发透传数据
在 产品详情 详情页,单击 设备调试 页签可进行透传数据业务的交互。
3、查询下行数据 模组收到数据后先缓存,最多支持缓存10条信息,且向MCU发送通知 +QIOTEVT: 5,10200 ,MCU收到通知后,则需手动发送 AT+QIOTRD=<req_length> 查询指令读取数据。
[RX]+QIOTEVT: 5,10200
[TX]AT+QIOTRD=512
[RX]AT+QIOTRD=512
+QIOTRD: 12,0,0
ABCabc123456
OK