MN316 OpenCPU丨连接CTWing介绍

本文从使用流程、接口介绍、Demo使用方法、结果展示和注意事项五个方面介绍MN316模组在OpenCPU模式下如何实现接入电信平台进行数据交互的功能。

一、MN316接入CTWing平台流程

二、接口介绍

CTWing功能主要包含以下接口，可在cm_CTWing.h中查看

1、cm_ctw_create，创建设备实例，在此接口中配置服务器地址和端口号，不支持域名。

图1创建设备实例

2、cm_ctw_delete，删除设备实例，用以释放资源。

图2删除设备实例

3、cm_ctw_cfg，配置信息，可以配置重传次数、重传间隔以及是否开启接收包过滤，可以在cm_ctw_cfg_t中查看详细说明。

图3配置注册信息

4、cm_ctw_open，向平台发起注册请求，可配置保活时间。

图4发起注册请求

5、cm_ctw_close，注销登录。

图5注销登录

6、cm_ctw_update，更新注册时间，将按照cm_ctw_open中配置的保活时间更新。

图6更新注册时间

7、cm_ctw_send，标准发送，模组将采用CON模式向平台发送数据，不携带空口回传标识，接收到下行包后立即释放RRC。

图7发送数据-标准模式

8、cm_ctw_send_ex，自定义发送，模组可自定义发送模式和RAI功能，配置方式可在cm_ctw_coap_ack_type_e和cm_ctw_rai_type_e结构体中查看。

图8发送数据-自定义模式

9、cm_ctw_fota_query_state，查询fota状态，可在cm_ctw_fota_state_t中查看升级状态说明。

图9查询fota状态

10、cm_ctw_get_reg_state，查询设备注册状态，可在cm_ctw_reg_state_e中查看注册状态说明。

图10查询设备注册状态

三、Demo使用方法

接入CTWing平台的demo文件在：SDK目录\examples\CTWing路径下，可通过串口输入命令CMD:CTWing:N进入相应测试步骤。

图11demo测试

1. 创建连接

串口输入CMD:CTWing:0，模组创建实例。

图12创建设备实例

1. 注册至平台

串口输入CMD:CTWing:1，模组将向平台发起注册，保活时间为86400s。

图13注册到CTWing平台

1. 标准模式发送数据

串口输入CMD:CTWing:2，模组将采用CON模式向平台发送数据，不携带空口回传标识，接收到下行包后立即释放RRC。

图14发送数据-标准模式

1. 自定义模式发送数据

串口输入CMD:CTWing:3，模组以不需要服务器回复ack、发送后立即释放RRC连接的方式发送数据。

图15发送数据-自定义模式

1. 更新注册

串口输入CMD:CTWing:4，模组将更新注册。

图16更新注册

1. 注销设备

串口输入CMD:CTWing:5，模组将在平台注销登录。

图17注销设备

1. 删除设备

串口输入CMD:CTWing:6，模组将删除设备实例。

图18删除设备

1. 查询FOTA状态

串口输入CMD:CTWing:7查询当前fota状态，查询结果说明可在cm_CTWing.h文件中查看。

图19查询fota状态

四、结果展示

1、向MN316串口依次发送CM:CTWing:0、CM:CTWing:1，模组回复+CTWEVT:1表示注册成功、+CTWEVT:7表示订阅成功，平台显示设备在线。（+CTWEVT:相关说明可在cm_ctw_evt_type_e查看）。

图20注册到CTWing平台

3、串口发送CM:CTWing:2，平台收到Demo中默认数据“foo foo foo foo”，并返回ack。

图21发送数据到平台

4、串口发送CM:CTWing:3，平台收到Demo中默认数据“bar bar bar bar”，平台返回空口回传序列号，未返回ack，发送完成后立即释放RRC。

图22发送数据到平台

5、串口发送CM:CTWing:5，注销登录，平台显示设备离线。

图23注销登录

五、注意事项

1、服务器ip地址不支持域名格式。

2、CTWing平台与OneNET平台互斥，使用CTWing时需保证OneNET实例已删除。