中移物联网有限公司
OneNET 开发文档中心
OneNET 平台 NB-IOT 接入开发文档
中移物联网有限公司
OneNET 开发文档中心
版本更新信息
欢迎访问 OneNET 官方网站注册用户,获取最新文档
版本号 修订日期
修订内容
作者
说明
V0.1
2018.5
肖勇、张小波、
卓定飞、敬威
初版
中移物联网有限公司
OneNET 开发文档中心
目录
3.1.1
3.1.2
3.1.3
第一章 文档说明.................................................................................................................5
第二章 基于 OneNET 平台的 NB 设备接入及应用开发流程总体综述...........................6
2.1
NB 设备接入 OneNET 平台流程图............................................................................6
2.2 应用开发流程图.........................................................................................................7
第三章 NB 设备接入 OneNET 平台....................................................................................8
3.1 终端设备接入 OneNET 平台前的准备工作............................................................. 8
SDK 移植到 MCU................................................................................................ 9
SDK 移植到 NB 通信模组...................................................................................9
SDK 移植到 NB 芯片.........................................................................................10
3.2 终端设备接入 OneNET 平台步骤........................................................................... 11
3.2.1
OneNET 平台创建产品及设备.........................................................................12
3.2.2 终端设备软硬件初始化...................................................................................15
3.2.3 终端创建设备及资源.......................................................................................15
3.2.4 登录 OneNET 平台............................................................................................16
3.2.5 平台订阅&发现设备资源................................................................................ 17
第四章 第三方应用开发...................................................................................................18
4.1 第三方应用接入 OneNET 平台.....................................................................................18
4.1.1 第三方应用平台接入验证程序.............................................................................19
4.1.2 OneNET 平台配置第三方应用平台.......................................................................19
4.2 OneNET 平台数据推送..................................................................................................20
4.1.1 明文消息...........................................................................................................21
4.1.2 密文消息...........................................................................................................22
4.1.3 消息相关字段说明...........................................................................................22
4.1.4 加密算法详述...................................................................................................23
API 接口.................................................................................................................... 24
4.2.1 创建设备.................................................................................................................25
4.2.2 查看单个设备信息.................................................................................................26
4.2.3 删除设备.................................................................................................................27
4.2.4 读设备资源.............................................................................................................27
4.2.5 写设备资源.............................................................................................................28
4.2.6 下发命令.................................................................................................................29
4.2
中移物联网有限公司
OneNET 开发文档中心
4.2.7 获取资源列表.........................................................................................................29
4.2.8 订阅.........................................................................................................................30
4.2.9 离线命令.................................................................................................................31
4.2.10 触发器..................................................................................................................35
4.2.11 批量查询设备状态...............................................................................................40
4.2.12 批量查询设备最新数据.......................................................................................40
4.2.13 查看数据点...........................................................................................................41
第五章 接入实例...............................................................................................................46
5.1 MCU 侧工作流程说明...................................................................................................47
5.1.1 创建设备(dev)...................................................................................................47
5.1.2 向设备添加资源.....................................................................................................48
5.1.3 登录请求.................................................................................................................49
5.2 OneNET 平台侧数据收发流程说明..............................................................................50
5.2.1 数据接收.................................................................................................................50
5.2.2 指令下发.................................................................................................................51
第六章 资源下载...............................................................................................................57
6.1 数据推送 SDK 下载...................................................................................................... 57
6.2 NB-IoT API 下载............................................................................................................. 57
6.3 NB-IoT 开发板资料下载...............................................................................................57
第七章 NB-IoT 接入协议说明...........................................................................................58
7.1 基于 NB-IoT 的 LWM2M 协议......................................................................................58
7.1.1 LWM2M 协议逻辑实体与逻辑接口......................................................................59
7.1.2 LWM2M 协议栈......................................................................................................60
7.2 基于 NB-IoT 的 CoAP 协议............................................................................................ 61
7.2.1 CoAP 协议栈........................................................................................................... 61
7.2.2 块传输....................................................................................................................63
7.2.3 安全传输................................................................................................................65
第八章 常见问题...............................................................................................................66
中移物联网有限公司
OneNET 开发文档中心
第一章 文档说明
编写此开发文档是为了让开发人员采用 NB 模组的设备快速接入 OneNET 平
台,形成基于 NB 设备的物联网开发应用。
通过阅读此文档,开发人员可以了解 OneNET 平台接入的总体流程,包括
NB 设备接入 OneNET 平台步骤,基于 OneNET 平台开发上层应用。
文档适用人员:熟悉 NB 协议、设备接入侧需要具备一定功底的嵌入式开发
人员,北向 API 调用的开发人员,需要具备一定的应用软件开发能力。
注意:建议以公司名义先注册 OneNET 平台账号
中移物联网有限公司
OneNET 开发文档中心
第二章 OneNET 平台 NB 设备开发流程总体综述
基于 OneNET 平台的 NB 设备接入及应用开发流程分两个阶段进行,第一阶
段为 NB 设备接入 OneNET 平台,第二阶段为基于设备上传数据流的应用开发。
下面将用流程图的形式分别对设备接入和应用开发进行综述。
注意:流程图中的数字标号从小到大表示流程的步骤。
2.1 NB 设备接入 OneNET 平台流程图
图2-1 NB设备接入OneNET平台流程图
2.2 应用开发流程图
中移物联网有限公司
OneNET 开发文档中心
图2-2 应用开发流程图
中移物联网有限公司
OneNET 开发文档中心
第三章 NB 设备接入 OneNET 平台
终端设备与 OneNET 平台进行数据交互需经过网络运营商提供的核心网,
根据 OneNET 平台与网络运营商的关系,终端设备、核心网络、OneNET 平台以
及第三方应用四者的网络关系可归纳如图 3-1 所示。
图3-1 终端设备与服务器网络关系
图 3-1 中终端设备用户如果选择中国移动网络运营商,可以与 OneNET 平
台实现无缝对接。图 3-1 中如果终端设备用户选择电信或者联通运营商,则需要
电信和联通运营商更改对 OneNET 平台接入限制。电信目前是要求接入 OC 平台,
联通 NB 暂时未规划。
3.1 终端设备接入 OneNET 平台前的准备工作
在设备接入 OneNET 平台之前,设备侧需完成由 OneNET 平台提供的基础
通信套件 SDK 的移植工作。目前,按 SDK 集成在终端的方式可将终端分为如下
三类:
(1)“MCU+NB 通信模组”架构中,SDK 移植到 MCU 中;
(2)“MCU+NB 通信模组”架构中,SDK 移植到 NB 通信模组中;
(3)“NB 芯片”的 SOC 架构中,SDK 移植到 NB 芯片中。