概述
onenet平台操作
登录onenet后,进入控制台
选择NB-IoT物联网套件
新建产品
产品名字、类别根据自己情况填,协议选择LWM2M
产品新建成功
点击产品名字,进入产品详情
给产品添加设备
填入设备信息
打开自动发现资源
Object、Instance、Resource
onenet采用了《IPSO-Smart-Objects-1.0.pdf》中规定的Object、Instance、Resource来定义控制对象,因此有必要先把他们的概念说清楚。
- Object(对象):表示某类传感器类型。
- Instance(实例):同一类传感器的数量。
- Resource(属性或资源):传感器某些特性描述。
举个例子来说,房间里的温度传感器、湿度传感器、灯、空调就是Object;如果要接入的灯只有一个,那么Instance就为1,如果要接入的灯有两个,那么Instance就为2;灯有开/关、亮度、颜色等属性,他们就是Resource。
打开手册《IPSO-Smart-Objects-1.0.pdf》看,也的确是这个样子的,比如Object有:
基本每种物联网设备,手册中都有定义,都有对应的Object ID。拿灯来说,他的Object ID=3311,他的Resource有:
Resource有开关状态、亮度、颜色等,每种Resource都有Resource ID、是否可读写、取值范围等。
最后再给个图:
模组端操作
1、查询模组IP地址,确定模组网络没问题
发送指令
AT+CGPADDR=1
接收到模组的IP地址说明正常,如果模组没有IP,则需要排查卡和网络问题。
+CGPADDR: 1,100.97.92.190
OK
2、创建Instance(实例)
假如我们要接入多个灯,那么要为每个灯都创建Instance,每个灯和它的Instance ID一一对应。这里就是为接入设备创建Instance,并且获取到它的Instance ID。
发送指令
AT+MIPLCREATE
接收到模组响应
+MIPLCREATE: 0
OK
响应解释为:
+MIPLCREATE: <ref>
<ref> 整型。 OneNET 通信套件的实例ID; 范围: 0-65535。
3、添加Object(对象)
指令为:
AT+MIPLADDOBJ=<ref>,<objId>,<insCount>,<insBitmap>,<attrCount>,<actCount>
<ref> 整型。 OneNET通信套件的实例ID; 范围:0-65535。
<objId> 整型。 LwM2M对象ID。若对象ID不存在,则返回错误。
<insCount> 整型。 实例个数。
<insBitmap> 带双引号的字符串类型。 实例位图。 例如,若 <insCount> 值为4 、<insBitmap>="1101",则表示实例ID 0、 2、 3 将被注册,而实例ID 1 不会被注册。
<attrCount> 整型。 属性个数,表示可读和/或可写资源的个数。
<actCount> 整型。 动作个数,表示可执行的资源个数。
这里就以前面的灯为例,Object ID=3311。创建2个Instance,但是只注册Instance ID=0的Instance。因此发送指令
AT+MIPLADDOBJ=0,3311,2,"01",4,2
接收到模组响应
OK
4、向OneNET发送注册请求
指令为:
AT+MIPLOPEN=<ref>,<lifetime>
<ref> 整型。 OneNET 通信套件的实例 ID;范围: 0-65535。
<lifetime> 整型。用于设置设备的使用期限, 实际使用期限为<lifetime>×0.9。 单位:秒。
0 3600 秒
15-268435455
发送指令为:
AT+MIPLOPEN=0,86400
接收到模组响应
OK
+MIPLEVENT: 0,1
+MIPLEVENT: 0,2
+MIPLEVENT: 0,4
+MIPLEVENT: 0,6
+MIPLOBSERVE: 0,119350,1,3311,0,-1
响应解释为:
+MIPLEVENT: <ref>,<evtid>[,<extend>[,<ackid>]]
<ref> 整型。 OneNET 通信套件的实例 ID;范围: 0-65535。
<evtid> 整型。 事件标识符:
1 EVENT_BOOTSTRAP_START
2 EVENT_BOOTSTRAP_SUCCESS
3 EVENT_BOOTSTRAP_FAILED
4 EVENT_CONNECT_SUCCESS
5 EVENT_CONNECT_FAILED
6 EVENT_REG_SUCCESS
+MIPLOBSERVE: <ref>,<msgId>,<flag>,<objId>,<insId>,<resId>
<ref> 整型。 OneNET 通信套件的实例 ID;范围: 0-65535。
<msgId> 整型。 数据包消息 ID。
<flag> 整型。 表示是否订阅
0 取消订阅
1 订阅
<objId> 整型。 从 OneNET 或者应用服务器处接收到的 LwM2M 对象 ID。
<insId> 整型。 从 OneNET 或者应用服务器处接收到的实例 ID。 -1 表示订阅或者取消订阅指定 LwM2M 对象下所有实例下的所有资源。
<resId> 整型。 从 OneNET 或者应用服务器处接收到的资源 ID。 -1 表示订阅或者取消订阅指定实例下的所有资源。
因此解释为:
+MIPLEVENT: 0,1 //开始连接到 Bootstrap 服务器。
+MIPLEVENT: 0,2 //成功连接到 Bootstrap 服务器。
+MIPLEVENT: 0,4 //成功连接到 OneNET 平台。
+MIPLEVENT: 0,6 //成功注册到 OneNET 平台。此时,刷新OneNET可看到设备显示绿色在线状态。
+MIPLOBSERVE: 0,119350,1,3311,0,-1 //接收到订阅请求(3311/0)。
接收到了+MIPLEVENT: 0,6 就表示成功注册到 OneNET 平台。此时,刷新OneNET可看到设备显示绿色在线状态。
5、响应订阅请求
在收到+MIPLOBSERVE: 0,119350,1,3311,0,-1后,10秒内必须响应订阅请求,否则平台会断开。
指令为:
AT+MIPLOBSERVERSP=<ref>,<msgId>,<result>
<ref> 整型。 OneNET 通信套件的实例 ID;范围: 0-65535。
<msgId> 整型。 消息ID;出自 URC +MIPLDISCOVER。
<result> 整型。 订阅结果,以下为结果码:
结果码 CoAP响应码 描述
1 2.05 内容,表示正确结果
11 4.00 无效请求
12 4.01 未授权
13 4.04 未找到
14 4.05 方式不允许
15 4.06 未接受
因此发送指令为:
AT+MIPLOBSERVERSP=0,119350,1
接收到模组响应
OK
+MIPLDISCOVER: 0,53815,3311
响应解释为:
+MIPLDISCOVER: <ref>,<msgId>,<objId> //通知模组响应发现资源请求
<ref> 整型。 OneNET 通信套件的实例 ID;范围: 0-65535。
<msgId> 整型。 数据包消息 ID。
<objId> 整型。从 OneNET 平台接收到的 LwM2M 对象 ID。
6、响应发现资源请求
在收到+MIPLDISCOVER: 0,53815,3311后,10秒内必须响应发现资源请求,否则平台会断开。
指令为:
AT+MIPLDISCOVERRSP=<ref>,<msgId>,<result>,<length>,<valuestring>
<ref> 整型。 OneNET 通信套件的实例 ID;范围: 0-65535。
<msgId> 整型。 消息ID;出自 URC +MIPLDISCOVER。
<result> 整型。 发现资源操作结果,以下为结果码:
结果码 CoAP响应码 描述
1 2.05 内容,表示正确结果
11 4.00 无效请求
12 4.01 未授权
13 4.04 未找到
14 4.05 方式不允许
15 4.06 未接受
<length> 整型。 参数<valuestring>的长度。单位: 字节。
<valuestring> 带双引号的字符串类型。 包含对象的属性,每个属性之间用分号隔开,例如:"1101;1102;1103",属性个数不应超过AT+MIPLADDOBJ 命令的<attrCount>和<actCount>参数值总和。
因此发送指令为:
AT+MIPLDISCOVERRSP=0,53815,1,19,"5850;5851;5706;5805"
接收到模组响应
OK
7、读取操作
现在已经连接到onenet,并且已经上报了对象的资源,接下来测试一下平台的读取操作。读取操作是由平台发起的,在平台上发起操作后,模组联网后就会收到请求,然后会主动上报URC,与模组连接的单片机收到模组吐出的URC后,再使用AT指令,把数据发送给模组,模组再把数据发送给平台。
接收到平台下发读取操作,模组上报的URC为:
+MIPLREAD: <ref>,<msgId>,<objId>,<insId>,<resId>
<ref> 整型。 OneNET 通信套件的实例 ID;范围: 0-65535。
<msgId> 整型。 数据包消息 ID。
<objId> 整型。 从 OneNET 或者应用服务器处接收到的 LwM2M 对象 ID。
<insId> 整型。 从 OneNET 或者应用服务器处接收到的实例 ID。 -1 表示读取指定 LwM2M对象下的所有资源。
<resId> 整型。 从 OneNET 或者应用服务器处接收到的资源 ID, -1 表示读取指定实例下的所有资源。
单片机发数据给模组的指令为:
AT+MIPLREADRSP=<ref>,<msgId>,<result>[,<objId>,<insId>,<resId>,<valueType>,<len>,<value>,<index>,<flag>]
<ref> 整型。 OneNET 通信套件的实例 ID;范围: 0-65535。
<msgId> 整型。 消息 ID; 出自 URC +MIPLREAD。
<result> 整型。 读取结果,以下为结果码:
结果码 CoAP响应码 描述
1 2.05 内容,表示正确结果
11 4.00 无效请求
12 4.01 未授权
13 4.04 未找到
14 4.05 方式不允许
15 4.06 未接受
<objId> 整型。 LwM2M 对象 ID; 出自 URC +MIPLREAD。
<insId> 整型。 实例 ID,出自 URC +MIPLREAD。
<resId> 整型。 资源 ID; 出自 URC +MIPLREAD。
<valueType> 整型。 <value>值的类型。
1 字符串类型
2 十六进制类型
3 整型
4 浮点型
5 布尔型(Boolean)
<len> 整型。 <value>值的长度;单位: 字节。
当<valueType>=1 时,该参数值为字符串类型<value>的长度,范围: 0-1024。
当<valueType>=2 时,该参数值为十六进制字符串类型<value>的长度,范围:0-512。
当<valueType>=3 时,该参数值可能为 2、 4 或者 8。
当<valueType>=4 时,该参数值为 4。
当<valueType>=5 时,该参数值为 1。
<value> 数据。
当<valueType>=1 时,该参数值为带双引号的字符串类型格式,最大 1024 字节。
当<valueType>=2 时,该参数值为十六进制字符串格式,最大 512 字节。
当<valueType>=3 时,该参数值为整型格式。
当<valueType>=4 时,该参数值为浮点型格式。
当<valueType>=5 时,该参数值为布尔型格式。
<index> 整型。 消息序号。若读取请求响应包含多条消息,则需发送多次 AT 命令以完成响应。例如, 若读取请求响应包含 N 条消息,则参数<index>需从 N-1 到 0 依次递减, AT 命令按照<index>取值从大到小的顺序执行。 <index>=0 表示数据中最后一条消息。
<flag> 整型。 消息指示; 范围: 0-2。
0 表示<value>中最后一条消息
1 表示<value>中第一条消息
2 表示<value>中中间的消息
当前版本仅支持<flag>=0。
首先在平台上发起,读Resource ID=5851资源的请求:
如果模组没有处于PSM,而是处于联网状态的话,就会收到平台下发的请求,然后上报URC:
+MIPLREAD: 0,6902,3311,0,5851
这个时候根据前面的指令格式,发送数据:(要在10s内回复)
AT+MIPLREADRSP=0,6902,1,3311,0,5851,3,2,75,0,0
就可以看到已经把数据发送到平台上了:
如果点击读资源后,看到平台一直在等待,最后超时,而且模组也没有上报URC,就说明模组当前处于跟基站断开的状态。
可以发送一下更新请求,这样模组就会恢复与基站的连接,同时就能收到平台下发的请求了。指令为:
AT+MIPLUPDATE=<ref>,<lifetime>,<withObjectFlag>
<ref> 整型。 OneNET 通信套件的实例 ID;范围: 0-65535。
<lifetime> 整型。 更新后的设备使用期限值(实际使用期限为<lifetime>×0.9)。 单位:秒。
0 3600 秒
15-268435455
<withObjectFlag> 整型。 是否更新对象列表。
0 不更新
1 更新
因此发送指令为:
AT+MIPLUPDATE=0,86400,1
指令响应为:
OK
+MIPLEVENT: 0,11
发送之后,再在平台上点击读资源,模组就能立马上报URC了。
7、写入操作
模组收到平台的写操作,上报的URC为:
+MIPLWRITE: <ref>,<msgId>,<objId>,<insId>,<resId>,<valueType>,<len>,<value>,<flag>,<index>
<ref> 整型。 OneNET 通信套件的实例 ID;范围: 0-65535。
<msgId> 整型。 数据包消息 ID。
<objId> 整型。 从 OneNET 或者应用服务器处接收到的 LwM2M 对象 ID。
<insId> 整型。 从 OneNET 或者应用服务器处接收到的实例 ID。
<resId> 整型。 从 OneNET 或者应用服务器处接收到的资源 ID。
<valueType> 整型。 <value>值的类型(当前仅显示十六进制类型。
1 字符串类型
2 十六进制类型
3 整型
4 浮点型
5 布尔型(Boolean)
<len> 整型。 <value>值的长度;单位: 字节。
<value> 字符串类型。数据。从 OneNET 或者应用服务器处接收到的数据,仅在 Direct push模式下有效。
<flag> 整型。 消息指示;范围: 0-2。
0 表示<value>中最后一条消息
1 表示<value>中第一条消息
2 表示<value>中中间的消息
该版本仅支持<flag>=0。
<index> 整型。 写入请求的索引号。若写入请求包含多条消息,则 URC 会被分成多个部分进行上报。例如, 若写入请求包含 N 条消息,则参数<index>需从 N-1 到 0 依次递减, URC 按照<index>取值从大到小的顺序进行上报。 <index>=0 表示这是写入请求中最后一条消息。
模组响应写入操作的指令为:
AT+MIPLWRITERSP=<ref>,<msgId>,<result>
<ref> 整型。 OneNET 通信套件的实例 ID;范围: 0-65535。
<msgId> 整型。 消息 ID; 出自 URC +MIPLWRITE。
<result> 整型。 写入结果,以下为结果码:
结果码 CoAP响应码 描述
2 2.04 Changed,表示正确结果
11 4.00 无效请求
12 4.01 未授权
13 4.04 未找到
14 4.05 方式不允许
首先在平台上发起,写Resource ID=5706资源的请求,写入内容为“hello”:
模组收到平台操作后,上报URC:
+MIPLWRITE: 0,33178,3311,0,5706,2,5,68656C6C6F,0,0
这个时候根据前面的指令格式,响应平台:(要在10s内回复,否则平台会超时)
AT+MIPLWRITERSP=0,33178,2
平台收到回复后,会提示操作成功。
从模组上报的URC,我们可以得到平台下发了5个字符“68656C6C6F”,是十六进制格式的,内容刚好是“hello”。
当然也可以以字符串的形式上报,操作如下:
AT+MIPLCONFIG=1,1 //设置 Buffer Access 模式,接收文本字符串类型数据
OK
AT+MIPLUPDATE=0,86400,1
OK
+MIPLEVENT: 0,11
+MIPLWRITE: 0,4012,3311,0,5706,2,5,0,0 //仅显示所接收数据的长度,然后发送 AT+MIPLRD 命令读取数据。
AT+MIPLWRITERSP=0,4012,2
OK
AT+MIPLRD=5 //从缓存中读取数据
+MIPLRD: 5,0 //已读取数据长度为 5 字节, 未读取数据长度为 0 字节
hello //所读取的文本字符串类型数据
OK
8、执行操作
模组收到平台的执行操作,上报的URC为:
+MIPLEXECUTE: <ref>,<msgId>,<objId>,<insId>,<resId>[,<len>,<arguments>]
<ref> 整型。 OneNET 通信套件的实例 ID;范围: 0-65535。
<msgId> 整型。 数据包消息 ID。
<objId> 整型。 从 OneNET 或者应用服务器处接收到的 LwM2M 对象 ID。
<insId> 整型。 从 OneNET 或者应用服务器处接收到的实例 ID。
<resId> 整型。 从 OneNET 或者应用服务器处接收到的资源 ID。
<len> 整型。 参数<arguments>的长度;单位:字节。
<arguments> 字符串类型。 执行操作中的<arguments>。
模组响应写入操作的指令为:
AT+MIPLEXECUTERSP=<ref>,<msgId>,<result>
<ref> 整型。 OneNET 通信套件的实例 ID;范围: 0-65535。
<msgId> 整型。 消息 ID; 出自 URC +MIPLEXECUTE。
<result> 整型。 执行结果,以下为结果码:
结果码 CoAP响应码 描述
2 2.04 Changed,表示正确结果
11 4.00 无效请求
12 4.01 未授权
13 4.04 未找到
14 4.05 方式不允许
操作过程如上:
//UE 已成功注册到 OneNET 平台。
//应用服务器已经向 UE 发送执行请求,其中包含 Argument: reset。
+MIPLEXECUTE: 0,36476,3303,0,5605,5,"reset" //接收到执行请求。
AT+MIPLEXECUTERSP=0,36476,2 //响应执行请求, 其结果码为 2。
OK
9、模组主动上报数据操作
指令格式为:
AT+MIPLNOTIFY=<ref>,<msgId>,<objId>,<insId>,<resId>,<valueType>,<len>,<value>,<index>,<flag>[,<ackid>]
<ref> 整型。 OneNET 通信套件的实例 ID;范围: 0-65535。
<msgId> 整型。 消息 ID;出自 URC +MIPLOBSERVE。
<objId> 整型。 LwM2M 对象 ID。
<insId> 整型。 实例 ID;出自 URC +MIPLOBSERVE。
<resId> 整型。 资源 ID;出自 URC +MIPLOBSERVE。
<valueType> 整型。 <value>值的类型。
1 字符串类型
2 十六进制类型
3 整型
4 浮点型
5 布尔型(Boolean)
<len> 整型。 <value>值的长度;单位:字节。
当<valueType>=1 时,该参数值为字符串类型<value>的长度,范围: 0-1024。
当<valueType>=2 时,该参数值为十六进制字符串类型<value>的长度,范围:0-512。
当<valueType>=3 时,该参数值可能为 2、 4 或者 8。
当<valueType>=4 时,该参数值为 4。
当<valueType>=5 时,该参数值为 1。
<value> 数据。
当<valueType>=1 时,该参数值为带双引号的字符串类型格式。
当<valueType>=2 时,该参数值为十六进制字符串格式。
当<valueType>=3 时,该参数值为整型格式。
当<valueType>=4 时,该参数值为浮点型格式。
当<valueType>=5 是,该参数值为布尔型格式。
<index> 整型。 消息序号。若待上报数据包含多条消息,则需要发送多次 AT 命令以完成上报。例如,若待上报数据包含 N 条消息,则参数<index>需从 N-1 到 0 依次递减, AT 命令按照<index>取值从大到小的顺序执行。 <index>=0 表示数据中最后一条消息。
<flag> 整型。 指示消息,范围: 0-2。
0 表示<value>中最后一条消息
1 表示<value>中第一条消息
2 表示<value>中中间消息
该版本仅支持<flag>=0。
<ackid> 整型。范围: 0-65535。
0 上报的数据为不需要确认的消息
1-65535 上报的数据为需要确认的消息
因此指令为:
AT+MIPLNOTIFY=0,119350,3311,0,5851,3,2,25,0,0
OK
10、注销请求
指令格式为:
AT+MIPLCLOSE=<ref>
<ref> 整型。 OneNET 通信套件的实例 ID;范围: 0-65535
AT+MIPLCLOSE=0
OK
+MIPLEVENT: 0,15
此时在平台上可以看到设备已离线。
11、删除对象
指令格式为:
AT+MIPLDELOBJ=<ref>,<objId>
<ref> 整型。 OneNET 通信套件的实例 ID;范围: 0-65535。
<objId> 整型。 LwM2M 对象 ID。 若对象 ID 不存在,则返回错误。
AT+MIPLDELETE=0
OK
STM32代码示例
待续
最后
以上就是寂寞季节为你收集整理的BC26通过LWM2M协议连接ONENET,AT流程,STM32代码onenet平台操作Object、Instance、Resource模组端操作STM32代码示例的全部内容,希望文章能够帮你解决BC26通过LWM2M协议连接ONENET,AT流程,STM32代码onenet平台操作Object、Instance、Resource模组端操作STM32代码示例所遇到的程序开发问题。
如果觉得靠谱客网站的内容还不错,欢迎将靠谱客网站推荐给程序员好友。
发表评论 取消回复