logo资料库

OneNET平台NB-IOT接入开发文档.docx

第1页 / 共66页
第2页 / 共66页
第3页 / 共66页
第4页 / 共66页
第5页 / 共66页
第6页 / 共66页
第7页 / 共66页
第8页 / 共66页
资料共66页,剩余部分请下载后查看
第一章文档说明
第二章OneNET平台NB设备开发流程总体综述
2.1NB设备接入OneNET平台流程图
2.2应用开发流程图
第三章NB设备接入OneNET平台
3.1终端设备接入OneNET平台前的准备工作
3.1.1SDK移植到MCU
3.1.2SDK移植到NB通信模组
3.1.3SDK移植到NB芯片
3.2终端设备接入OneNET平台步骤
3.2.1OneNET平台创建产品及设备
3.2.1.1 注册用户账号
3.2.1.2创建产品和设备
3.2.2终端设备软硬件初始化
3.2.3终端创建设备及资源
3.2.4登录OneNET平台
3.2.5平台订阅&发现设备资源
第四章第三方应用开发
4.1第三方应用接入OneNET平台
4.1.1第三方应用平台接入验证程序
4.1.2 OneNET平台配置第三方应用平台
4.2 OneNET平台数据推送
4.1.1明文消息
4.1.2密文消息
4.1.3消息相关字段说明
4.1.4加密算法详述
4.2API接口
4.2.1创建设备
4.2.2查看单个设备信息
4.2.3删除设备
4.2.4读设备资源
4.2.5写设备资源
4.2.6下发命令
4.2.7获取资源列表
4.2.8订阅
4.2.9离线命令
4.2.9.1读数据/Read
4.2.9.2写数据/Write
4.2.9.3执行/Execute
4.2.9.4查看指定设备离线命令列表
4.2.9.5查看指定离线命令详情
4.2.9.6取消离线命令
4.2.10 触发器
4.2.10.1新增
4.2.10.2更新
4.2.10.3查看
4.2.10.4删除触发器
4.2.11批量查询设备状态
4.2.12批量查询设备最新数据
4.2.13查看数据点
4.2.14 查看数据点--示例一:
4.2.15 查看数据点--示例二:
4.2.16 查看数据点--示例三:
第五章接入实例
5.1 MCU侧工作流程说明
5.1.1创建设备(dev)
5.1.2向设备添加资源
5.1.3登录请求
5.2 OneNET平台侧数据收发流程说明
5.2.1数据接收
5.2.2指令下发
5.2.2.1 Read操作流程
5.2.2.2 Write操作流程
5.2.2.3 Execute操作流程
第六章资源下载
6.1 数据推送SDK下载
6.2 NB-IoT API下载
6.3 NB-IoT 开发板资料下载
第七章NB-IoT接入协议说明
7.1 基于NB-IoT的LWM2M协议
7.1.1 LWM2M协议逻辑实体与逻辑接口
7.1.2 LWM2M协议栈
7.1.2.1 LWM2M Objects
7.1.2.2 LWM2M Protocol
7.2基于NB-IoT的CoAP协议
7.2.1 CoAP协议栈
7.2.1.1 CoAP 资源请求/响应模型
7.2.1.2 CoAP 消息报文定义
7.2.2 块传输
7.2.2.1 新增option说明
7.2.2.2 新增response code说明
新增加的2个response codes如表7-3所示:
7.2.3 安全传输
第八章常见问题
中移物联网有限公司 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 芯片中。
分享到:
收藏