Lierda NB861&MB261&MB961中国电信物联网平台应用指导

yutao

　　1  引言

　　1.1  文档目的

　　本文描述了Lierda NB861&MB261&MB961模组(以下简称“模组”)注册接入电信CTWing&OC平台(以下简称“平台”)，指导用户通过使用相关AT指令操作流程完成应用的开发，本文介绍中国电信制定的电信标准AT指令(以下简称“电信标准AT指令”)和海思AT指令，注册接入电信CTWing&OC平台流程。

　　2  平台侧操作说明

　　AEP平台侧需要完成产品创建和设备注册流程，用于在平台上创建产品，并声明产品下挂载的设备，该步骤需要在模组侧设备登录操作之前完成。

　　2.1  用户注册

       步骤1：访问电信物联网平台。点击“注册”，进入注册页面。
       步骤2：填写注册信息，完成注册&实名认证。
       步骤3：在“产品与服务”中，开通物联网应用开发服务。

图2.1 注册界面

图2.2 开通物联网应用开发服务

　　2.2  产品创建

　　步骤1：登录电信AEP平台，进入“控制台”，点击设备接入，然后选择LwM2M协议开始设备接入，如图2.3。

图2.3 设备接入界面

　　步骤2：点击“产品”→“创建产品”后，填写相应的产品信息。

图2.4 创建产品

图2.5 产品信息界面

　　用户也可以根据需求选择不同的数据加密方式和消息格式，如图2.6所示。

图2.6 选择加密方式

　　步骤3：产品创建成功后，可以在产品详情里查看设备对接地址，如图2.7所示。

图2.7 设备接入地址

　　2.3 添加设备

　　步骤1：选择“产品”后进入到产品界面，如图2.8所示。

图2.8 产品界面

　　步骤2：点击“设备管理”→“添加设备”，填写设备信息。添加设备时只需要输入模组的IMEI号即可，如图2.9所示。

图2.9 明文方式

　　若用户选择了图2.6加密通讯方式，则还需输入IMSI号和PSK，此处PSK任意填写(十六进制数字，固定长度16位数)。如果使用加密通信，下文模组发送AT指令时需填写该参数。

图2.10 加密方式

       步骤3：设备添加成功后，可以看到设备列表下已添加的设备，默认处于未激活的状态。

图2.11 设备列表

　　3  模块接入平台指导

　　3.1  海思AT指令接入平台

　　本章节介绍模组与电信CTWing平台对接所涉及到的海思AT命令交互流程，从而了解模组与电信CTWing平台端的总体交互过程。

　　3.1.1  设备注册

　　设备登录的步骤如下：

　　AT+CGATT?　　//查询基站(PS域)附着状态
　　+CGATT:1
　　OK

　　AT+CEREG?　　//查询核心网注册状态
　　+CEREG:0,1
　　OK

　　AT+CGPADDR　　//查询设备分配的IP地址
　　+CGPADDR:5,11.84.219.7
　　OK

　　AT+NCDP=221.229.214.202,5683　　//设置平台IP和端口
　　OK

　　AT+NNMI=1　　//设置新消息推送模式
　　OK

　　//若产品使用了DTLS加密，则需要输入PSK信息，否则无需此步骤
　　AT+NSETPSK=860295060229528,1234567890ABCDEF1234567890ABCDEF
　　OK

　　AT+MLWSREGIND=0　　//注册到平台
　　OK
　　+MLWEVTIND:0
　　+MLWEVTIND:3

　　AT+NMSTATUS?　　//查询设备在平台的注册状态
　　+NMSTATUS:MO_DATA_ENABLED
　　OK

       设备注册成功后，可以在平台端看到设备在线。

　　3.1.2  设备发送业务数据到平台

　　模组在平台注册成功后，即可通过AT指令发送数据到平台。

　　AT+NMGS=10,01020304050607abcdef
　　OK

　　AT+MLWULDATA=7,11223344556677
　　OK

　　发送成功后，可以在平台上查看设备上报的信息。

图3.1 上报数据日志

　　如果要带RAI( Release Assistance Indication)标识发送CON信息，按下面格式发送：

　　AT+MLWULDATAEX=5,1122334455,0x0100
　　OK
　　+MLWULDATASTATUS:4

　　发送成功后，可以在平台上查看设备上报的信息：

图3.2 上报数据日志

　　3.1.3  平台侧下发数据

　　当设备在线时，可以通过“设备管理”—>“指令下发”填写所需要下发的数据。

图3.3 下发指令

　　模组侧收到平台下发的数据：

　　+NNMI:14,01232312354365769832abcdef0a　　//平台下发指令

　　3.1.4  设备注销

　　设备(模组)端向平台发送注销请求。

　　AT+MLWSREGIND=1
　　OK
　　+MLWEVTIND:1　　//注销成功

　　3.2  电信标准AT指令接入平台

　　电信标准AT指令由中国电信制定，方便用户接入电信平台。

　　本章节主要介绍模组与电信CTWing平台对接所涉及到的电信标准AT命令交互流程，从而使客户了解模组与电信CTWing平台端的总体交互过程。

　　3.2.1  设备注册

　　初始化接入CTWing平台相关参数并登录，登录成功后，平台侧可以看到对应设备处于已激活且在线状态。

　　AT+CTM2MINIT="221.229.214.202",5683,86400,0,0　　//配置IP地址
　　OK

　　//若产品使用了DTLS加密，则需要输入PSK信息，否则无需此步骤
　　AT+CTM2MINIT="221.229.214.202",5684,86400,0,1,"860295060229528","1234567890ABCDEF1234567890ABCDEF"
　　OK

　　AT+CTM2MREG　　//登录平台
　　OK
　　+CTM2M:reg,0　　//注册LWM2M成功
　　+CTM2Mbsrv,0　　//平台订阅Object19成功

图3.4 设备激活成功

　　注：实时下发类应用（模组运行在DRX状态），平台注册成功后需增加并且执行AT+CTM2MUPDATE=0指令，以实现平台侧数据实时下发功能。
　　AT+CTM2MUPDATE=0，平台有数据会立即下发。
　　AT+CTM2MUPDATE=1，平台有数据会缓存，当设备端有上行消息时，平台会将缓存的数据下发。

　　3.2.2  设备发送业务数据到平台

　　发送数据，发送成功后可以在平台侧查看到发送的数据。

　　AT+CTM2MSEND=0A1202031D025D0AAAAA021245635D　　//发送的数据为HEX格式
　　+CTM2MSEND:25438
　　OK
　　+CTM2M:send,0,25438

　　AT+CTM2MSEND=6c6965726461　　//发送字符串”lierda”的HEX格式
　　+CTM2MSEND:25439
　　OK
　　+CTM2M:send,0,25439

图3.5 上报数据日志

　　3.2.3  平台下发业务数据到设备

　　CTWing平台下发数据到设备，可以选择十六进制或者字符串。

图3.6 平台下发数据

　　模组侧接收的消息：
　　+CTM2MRECV:6c6965726461313233343536
　　+CTM2MRECV:6c6965726461313233343536

图3.7 下发数据日志

　　注：如果CTWing平台创建设备时选择的是PSM模式不是DRX模式，平台下发指令会有20秒的时间限制。即平台下行数据需要上行数据发送后的20s内进行下发，如果超过20s再发送下行数据，则平台就会将该数据缓存处理，直到设备再次发送上行数据时，平台才进行统一下发。

　　3.2.4  设备注销

　　设备（模组）端向平台发送注销请求。

　　AT+CTM2MDEREG
　　OK
　　+CTM2M:dereg,0

图3.8 设备状态，离线状态

　　3.2.5  RAI快速释放

　　设备在交互完成后如果需要快速释放RAI进入休眠，可通过设置如下指令完成操作。

　　AT*NBIOTRAI=1　　//设置开启RAI功能
　　AT*RAIREQ　　//设置RAI快速释放

　　4  完整流程示例

　　考虑用户的使用和示例的易读性，以下示例流程删除了指令回复中的回车换行，模组返回内容需以实际为准。

　　4.1  上电检查流程

　　AT　　//判断模组是否上电开机成功
　　AT+CPIN?　　//查询是否读到卡
　　AT+CEREG?　　//判断PS域附着状态，第二个参数为1或5表示附着正常
　　AT+CGPADDR　　//查询核心网是否已分配IP

　　4.2  海思AT指令示例流程

　　模组对接CTWing平台完整的AT指令流程列举如下：

　　注：OC平台与CTWing平台对接流程与AT指令操作相似，OC平台侧操作不在此做赘述，可参考AT指令手册，仅变更NCDP配置相应的IP地址即可。

　　4.2.1  模组侧手动注册流程

　　AT+MREGSWT?　　//查询注册模式
　　+MREGSWT:0　　//手动注册模式
　　OK

　　AT+NSECSWT?　　//查询是否加密连接
　　+NSECSWT:0　　//非加密连接模式
　　OK

　　AT+NCDP=221.229.214.202,5683　　//设置云平台和IP端口
　　OK

　　AT+MLWSREGIND=0　　//模组请求注册平台
　　OK
　　+MLWEVTIND:0　　//注册成功
　　+MLWEVTIND:3　　//订阅成功

　　AT+NMSTATUS?　　//查询云平台注册状态
　　+NMSTATUS:MO_DATA_ENABLED
　　OK

　　Lierda NB861&MB261&MB961与CTWing平台对接完成后，若进入休眠状态，将其唤醒后再次向平台上报数据则会报错，无法进行数据上报。用户需要重新手动注册后才能实现正常数据交互，或者参考4.2.2章节使用自动注册电信平台的模式进行数据交互。

　　4.2.2  模组侧自动注册流程

　　AT+MREGSWT?　　//查询注册模式
　　+MREGSWT:0　　//手动注册模式
　　OK

　　AT+MREGSWT=1　　//切换到自动注册模式
　　OK

　　AT+NSECSWT=0　　//设置为非加密连接方式
　　OK

　　AT+NCDP=221.229.214.202,5683　　//设置云平台和IP端口
　　OK

　　AT+NRB　　//模组重启
　　REBOOTING
　　OK
　　REBOOT_CAUSE_APPLICATION,0x0000,0x0
　　Lierda

　　+MLWEVTIND:0　　 //注册成功
　　+MLWEVTIND:3　　//订阅成功

　　AT+NMSTATUS?　　//查询云平台注册状态
　　+NMSTATUS:MO_DATA_ENABLED
　　OK

　　4.2.3  数据交互流程

　　AT+NMGS=10,01020304050607abcdef　　//发送数据到平台
　　OK

　　AT+MLWULDATA=7,11223344556677　　//NON消息发送数据到平台
　　OK

　　AT+MLWULDATAEX=5,1122334455,0x0100　　//CON消息发送数据到平台
　　OK
　　+MLWULDATASTATUS:4　　//发送成功，上报URC
　　+NNMI:14,01232312354365769832abcdef0a               //平台下发指令

　　4.2.4  模组侧注销流程

　　AT+MLWSREGIND=1　　//模组请求注销
　　OK
　　+MLWEVTIND:1　　//注销成功

　　4.3  电信标准AT指令示例流程

　　模组对接CTWing平台完整的AT指令流程列举如下：

　　注：备注
　　OC平台与CTWing平台对接流程与AT指令操作相似，OC平台侧操作不在此做赘述，可参考AT指令手册，仅变更CTM2MINIT配置相应的IP地址即可。

　　4.3.1  模组侧手动注册流程

　　AT+NSECSWT?　　//查询是否加密连接
　　+NSECSWT:0　　//非加密连接模式
　　OK

　　AT+CTM2MINIT="221.229.214.202",5683,86400,0,0　　//配置IP创建连接
　　OK

　　AT+CTM2MREG　　//登录
　　OK
　　+CTM2M:reg,0
　　+CTM2Mbsrv,0

　　4.3.2  自动注册流程（PM3模式）

　　AT+CGATT?　　//查询基站的连接状态
　　+CGATT:1                                       
　　OK

　　AT+NPSMR=1　　//设置进出休眠模式提示
　　OK

　　AT+CTM2MINIT="221.229.214.202",5683,86400,0,0　　//配置IP创建连接
　　OK

　　AT+CTM2MREGSWT=1　　//设置自动注册模式
　　OK

　　AT+CTM2MREGSWT?　　//查询注册模式，返回1为自动注册模式
　　+CTM2MREGSWT: 1
　　OK

　　AT+NSECSWT?　　//查询是否加密连接
　　+NSECSWT:0　　//非加密连接模式
　　OK

　　AT+CPSMS=1　　//设置最低功耗进入PM3模式
　　OK

　　AT+UNBCFG="MMODE",1,2
　　OK

　　AT+CSCLK=2
　　OK

　　AT&W　　//保存设置
　　OK

　　+NPSMR:1　　//进入PM3模式

　　AT　　//唤醒模组后自动注册
　　+NPSMR:0
　　+CTM2M:reg,0
　　+CTM2Mbsrv,0

　　4.3.3  自动注册流程（非低功耗模式）

　　AT+CGATT?　　//查询基站的连接状态
　　+CGATT:1                                       
　　OK

　　AT+CTM2MINIT="221.229.214.202",5683,86400,0,0　　//配置IP创建连接
　　OK

　　AT+CTM2MREGSWT=1　　//设置自动注册模式
　　OK

　　AT+CTM2MREGSWT?　　//查询注册模式，返回1为自动注册模式
　　+CTM2MREGSWT: 1
　　OK

　　AT+NSECSWT=0　　//设置为非加密连接方式
　　OK

　　AT+NRB　　//复位
　　REBOOTING
　　OK
　　REBOOT_CAUSE_APPLICATION,0x0000,0x0
　　Lierda

　　+CTM2M:reg,0　　//模组复位后自动注册
　　+CTM2Mbsrv,0

　　4.3.4  数据交互流程

　　AT+CTM2MSEND=0A1202031D025D0AAAAA021245635D　　//发送数据到平台(默认CON消息)
　　+CTM2MSEND:3222                                       
　　OK
　　+CTM2M:send,0,3222

　　AT+CTM2MSEND=0A1202031D025D0AAAAA021245635D,0　　//CON消息发送数据到平台
　　+CTM2MSEND:3223
　　OK
　　+CTM2M:send,0,3223

　　AT+CTM2MSEND=0A1202031D025D0AAAAA021245635D,1　　//NON消息发送数据到平台
　　+CTM2MSEND:3224
　　OK
　　+CTM2M:send,0,3224

　　+CTM2MRECV:12345678　　//模组收到平台下发数据

　　注：Lierda NB861&MB261&MB961与CTWing平台对接完成后，若进入休眠状态，将其唤醒后再次向平台上报数据则会报错，无法上报，需重新注册后才能实现正常数据交互。现可通过AT指令设置自动注册模式，在唤醒模组后模组会自动注册平台，用户检查电信平台重新注册成功后即可与平台进行数据通信。

　　4.3.5  模组侧注销流程

　　AT+CTM2MDEREG                                          
　　OK
　　+CTM2M:dereg,0

　　5  相关文档

　　以下相关文档提供了文档的名称，版本请以最新发布的为准。