中国电信物联网开放平台_NB-IoT 模组
对接指导书
(V1)
二〇一九年十二月
概述
读者对象
符号约定
前 言
本文档针对 NB-IoT 业务,从准备工作、自定义设备模型、编解码插件开发、设备接入
平台及消息上下行等方法流程进行了介绍。
本文档提供了 NB-IoT 业务模组接入平台的指导。
本文档主要适用于以下工程师:
开发工程师
技术支持工程师
维护工程师
在本文中可能出现下列标志,它们所代表的含义如下。
符号
说明
用于警示紧急的危险情形,若不避免,将会导致人员死亡
或严重的人身伤害。
用于警示潜在的危险情形,若不避免,可能会导致人员死
亡或严重的人身伤害。
用于警示潜在的危险情形,若不避免,可能会导致中度或
轻微的人身伤害。
用于传递设备或环境安全警示信息,若不避免,可能会导
致设备损坏、数据丢失、设备性能降低或其它不可预知的
结果。
“注意”不涉及人身伤害。
符号
说明
用于突出重要/关键信息、最佳实践和小窍门等。
“说明”不是安全警示信息,不涉及人身、设备及环境伤害
信息。
本规范由中国电信集团公司提出并归口。
本规范起草单位:中国电信物联网开放实验室
目 录
前 言................................................................................................................................................... ii
目 录....................................................................................................................................................4
1 概述..................................................................................................................................................6
1.1 功能组网介绍............................................................................................................................................................... 6
1.2 整体业务介绍............................................................................................................................................................... 6
1.3 业务测试接入流程....................................................................................................................................................... 7
2 准备工作..........................................................................................................................................8
2.1 获取测试环境账号....................................................................................................................................................... 8
2.1.1 微信公众号申请........................................................................................................................................................ 8
2.1.2 网站申请.................................................................................................................................................................. 10
2.2 创建 APP 应用............................................................................................................................................................11
2.3 NB-IoT 参数说明........................................................................................................................................................ 18
3 Profile 和插件开发....................................................................................................................... 20
3.1 Profile 和插件介绍...................................................................................................................................................... 20
3.2 Profile 和插件开发...................................................................................................................................................... 21
3.2.1 登录开发者 Portal....................................................................................................................................................21
3.2.2 在线完成 Profile 和插件开发................................................................................................................................. 21
4 设备接入平台................................................................................................................................22
4.1 注册设备..................................................................................................................................................................... 22
4.2 TUP 设备接入..............................................................................................................................................................23
4.3 LWM2M 设备接入...................................................................................................................................................... 23
4.3.1 模组支持 LWM2M 接口......................................................................................................................................... 23
4.3.2 接入端口与协议...................................................................................................................................................... 23
4.3.3 设备接入.................................................................................................................................................................. 23
5 业务数据上报和业务消息下发....................................................................................................25
5.1 业务数据上报............................................................................................................................................................. 25
5.2 向设备发送消息......................................................................................................................................................... 27
6 固件升级........................................................................................................................................30
6.1 升级原理..................................................................................................................................................................... 30
6.2 升级包制作................................................................................................................................................................. 31
6.2.1 准备升级包文件...................................................................................................................................................... 31
6.2.2 对升级包进行离线签名.......................................................................................................................................... 31
6.2.3 上传公钥及签名后的升级包.................................................................................................................................. 33
6.3 创建升级任务............................................................................................................................................................. 34
7 测试环境测试................................................................................................................................36
7.1 测试申请..................................................................................................................................................................... 36
7.2 开放实验室测试......................................................................................................................................................... 36
8 附录..................................................................................................................................................1
8.1 模组厂商基本操作指导............................................................................................................................................... 1
8.2 中国电信物联网开放平台_LWM2M 接口规范......................................................................................................... 3
1 概述
1.1 功能组网介绍
在设备侧,智能设备采用了 NB-IOT 芯片,它和中国电信物联网开放平台之间通过
CoAP 协议通讯。CoAP 报文的 payload 里是设备的应用数据。
应用 server 通过 http/https 协议和平台通讯,通过调用平台的开放 API 来控制设备,平
台把设备上报的数据推送给应用服务器。平台支持对设备数据进行协议解析,转换成
标准的 json 格式数据。
图 1-1 组网图
1.2 整体业务介绍
NB-IOT 主要包含 NB 设备、NB-IOT 网络、中国电信物联网开放平台、垂直行业应
用:
NB-IOT 设备:通过无线网络连接到中国电信物联网开放平台,采用 CoAP 协议接入,
如水表、燃气表等。
NB-IOT 网络:实现对 NB-IoT 终端的移动性管理与会话管理;为 NB-IoT 终端建立用
户面承载,传递上下行业务数据。
中国电信物联网开放平台:实现对各种 NB-IoT 设备数据的统一管理,同时向第三方应
用系统开放接口,让各种应用能快速构建自己的物联网业务。
垂直行业应用:实现对 NB 设备的业务管理,包括业务发放、业务控制和呈现等,由
第三方基于中国电信物联网开放平台开放接口进行开发。
1.3 业务测试接入流程
为客户接入测试便捷化,制定了如下的测试接入流程:
2 准备工作
2.1 获取测试环境账号
2.1.1 微信公众号申请
客户或电信政企经理登录“天翼物联产业联盟”微信公众号填写开放平台测试账号申
请。
图 2-1 查找微信公众号并进入