1 引言
本文档主要介绍Lierda NB860&NB960&MB260系列模组采用LWM2M协议对接中国电信物联网开放平台(AEP&OC),本文档旨在帮助用户使用AT命令快速完成模组与AEP&OC平台的对接工作。
1.1 LwM2M协议简介
LwM2M是一套适用于物联网的协议。全称是Lightweight Machine-To-Machine,由OMA(Open Mobile Alliance)提出并定义。协议的主要实体包括LwM2M Server,LwM2M Client和LwM2M Bootstrap Server。LwM2M Server作为服务器,部署在服务提供商处,LwM2M Client作为客户端,部署在各个LwM2M设备上,此外根据需要还可以部署LwM2M Bootstrap Server,对客户端进行引导。LwM2M的基本架构如下图所示:
在这些实体之间,协议定义了4个接口,来实现各自的功能。
1、引导接口(Bootstrap)
LwM2M引导服务器向LwM2M客户端提供注册到LwM2M服务器的必要信息。
2、客户端注册接口(Client Registration)
使LwM2M客户端与LwM2M服务器互联,并告知LwM2M客户端的相关信息。
3、设备管理与服务实现接口(Device Management and Service Enablement)
LwM2M服务器向LwM2M客户端发送指令,LwM2M客户端对指令做出回应并将回应消息发送给LwM2M服务器
4、信息上报接口(Information Reporting)
该接口允许LwM2M服务器向LwM2M客户端订阅资源信息,LwM2M客户端接收订阅后按照约定的模式向服务端报告自己的资源变化情况。
LwM2M协议基于REST架构。协议的消息传递通过基于UDP的CoAP协议达成,消息的加密由DTLS负责。此外,LwM2M定义了以资源(Resource)为基本单位的模型,每个资源表示LwM2M客户端中的一项可用信息。资源都存在于对象实例中(Object Instance),即对象(Object)的实例化。协议允许使用者根据实际需要自定义对象来描述自己的产品。更详细的LwM2M协议描述请访问OMASpecworks。
1.2 对接流程概述
Lierda NB860&MB960&MB260模组与电信物联网平台对接包括两个方面的准备工作:
①平台侧—产品创建与设备注册;
②模组侧—驻网与模组侧设备创建/登录。
图1.1对接电信物联网平台流程概述
备注:为方便阅读,本文部分AT示例中省略了回车换行,用户使用时需以模组AT指令集或实际返回值为准。
2 AEP平台对接流程
2.1 平台侧操作说明
AEP平台侧需要完成产品创建和设备注册流程,用于在平台上创建产品,并声明产品下挂载的设备,该步骤需要在模组侧设备登录操作之前完成。
2.1.1 用户注册
步骤1:访问电信物联网平台。点击“注册”,进入注册页面。
步骤2:填写注册信息,完成注册&实名认证。
步骤3:在“产品与服务”中,开通物联网应用开发服务。
图2.1 注册界面
图2.2 开通物联网应用开发服务
2.1.2 产品创建
步骤1:登录电信AEP平台,进入“控制台”,点击设备接入,然后选择LwM2M协议开始设备接入,如图2.3。
图2.3 设备接入界面
步骤2:点击“产品”→“创建产品”后,填写相应的产品信息。
图2.4 创建产品
图2.5 产品信息界面
用户也可以根据需求选择不同的数据加密方式和消息格式,如图2.6所示。
图2.6 选择加密方式
步骤3:产品创建成功后,可以在产品详情里查看设备对接地址,如图2.7所示。
图2.7 设备接入地址
2.1.3 添加设备
步骤1:选择“产品”后进入到产品界面,如图2.8所示。
图2.8 产品界面
步骤2:点击“设备管理”→“添加设备”,填写设备信息。添加设备时只需要输入模组的IMEI号即可,如图2.9所示。
图2.9 明文方式
若用户选择了图2.6加密通讯方式,则还需输入IMSI号和PSK,此处PSK任意填写(十六进制数字,固定长度16位数)。如果使用加密通信,下文模组发送AT指令时需填写该参数。
图2.10 加密方式
步骤3:设备添加成功后,可以看到设备列表下已添加的设备,默认处于未激活的状态。
图2.11 设备列表
2.2 模组侧操作说明
2.2.1 模组交互介绍
图2.12 模组与AEP平台协议交互示例
2.2.2 模组交互流程
2.2.2.1 设备注册
步骤1:设置连接参数,两个参数分别为AEP平台LwM2M服务器IP地址、端口号(明文为5683,DTLS为5684)。
步骤2:发送注册请求,注册成功后,平台侧显示模组已激活。
图2.13 模组成功上线
备注:●模组订阅成功(+MLWEVTIND:3)后才能进行数据交互。
2.2.2.2 数据上报
模组成功上线后,通过AT+MLWULDATAEX指令上报数据。指令第一个参数为数据长度,第二个参数为数据内容,第三个参数为发送模式。发送成功后即可在AEP平台查看模组上报的数据。
图2.14 数据查看
备注:●设备上报数据的最长为1024字节。
●默认数据格式为十六进制字符串。
2.2.2.3 数据下发
平台下发数据。在“设备管理”→“指令下发”,填写数据&选择数据格式。发送成功后,模组会接收到下发的数据。
图2.15 平台侧下发数据
若需要模组缓存下发的内容,可设置模组为缓存模式。
备注:●模组最多缓存8条下行数据,超出缓存限度后,最早的数据将被丢弃。
●模组内部有缓存下行的数据未读取时,可以进入PSM模式。
●NNMI默认为1,修改该配置指令掉电不保存,每次复位后需重新配置。
●主动上报类应用中,设备上行数据20秒内(默认)如果没有下行数据,平台会将之后的下行数据缓存,等到下一次设备有上行数据时再一起下发。
2.2.2.4 更新平台
模组默认自动更新,无特殊情况不需要手动更新。
详细更新机制请参考文档《Lierda移芯爱旗展锐Update工作机制》
2.2.2.5 注销平台
无特殊应用时,模组可忽略此步骤。
主动上报类应用,模组休眠&断电前释放RRC即可,无需注销平台;若模组注册失败,建议先注销(去注册),然后再重新注册,详细流程可参考《Lierda NB860&MB960&MB260设备应用指导》。
3 命令示例
3.1 上电流程检查
3.2 AEP&OC平台(手动注册)
3.3 AEP&OC平台(自动注册)
3.4 注销流程
4 相关文档及术语缩写
表4-1 相关文档
表4-2 术语缩写
|