logo资料库

中国电信物联网开放平台_NB-IoT业务 对接指导书.doc

第1页 / 共56页
第2页 / 共56页
第3页 / 共56页
第4页 / 共56页
第5页 / 共56页
第6页 / 共56页
第7页 / 共56页
第8页 / 共56页
资料共56页,剩余部分请下载后查看
前 言
目 录
1 概述
1.1 功能组网介绍
1.2 整体业务介绍
1.3 业务测试接入流程
2 准备工作
2.1 获取测试环境账号
2.1.1 微信公众号申请
2.1.2 网站申请
2.2 创建APP应用
2.3 NB-IoT参数设置
3 开发Profile
3.1 Profile介绍
3.2 登录开发者Portal
3.3 开发Profile
4 开发编解码插件并安装
4.1 编解码插件介绍
4.2 开发者Portal在线插件开发
4.2.1 登录开发者Portal
4.2.2 在线完成插件开发
4.3 离线开发编解码插件
4.3.1 开发编解码插件
4.3.2 编解码插件质检
4.3.3 对插件包进行离线签名
4.3.4 上传公钥及签名后的插件包
5 应用接入平台
5.1 登陆应用
5.2 订阅
5.3 注册设备
5.3.1 有应用服务器设备注册
5.3.2 无应用服务器设备注册
5.4 修改设备信息
6 设备接入平台
6.1 设备接入
6.2 设备上线
6.2.1 真实设备
6.2.2 模拟设备
7 业务数据上报
8 命令下发
8.1 命令下发处理流程
8.2 命令下发机制
8.2.1 命令立即下发
8.2.2 命令缓存下发
9 固件升级
9.1 固件升级包制作并上传
9.1.1 准备固件升级包文件
9.1.2 对固件包进行离线签名
9.1.3 上传公钥及签名后的固件升级包
9.2 固件升级
9.3 NA订阅固件升级状态和结果
9.3.1 北向NA订阅接口
9.3.2 北向NA订阅通知
10 设备影子
10.1 添加profile
10.2 查看设备属性
10.3 更新设备属性
11 设备安全接入
11.1 PSK的预置
11.2 PSK的在线更新
12 更多功能
13 测试环境测试
13.1 测试申请
13.2 开放实验室测试
14 生产环境接入
14.1 账号申请
14.2 生产环境接入
15 参考文档
15.1 《
15.2 《
15.3 《
15.4 《
中国电信物联网开放平台_NB-IoT 业务 对接指导书 (V2) 二〇二二年六月
前 言 概述 本文档针对 NB-IoT 业务,从准备工作、自定义设备模型、编解码插件开发、应用接入 平台、设备接入平台及消息上下行等方法流程进行了介绍。 本文档提供了 NB-IoT 业务设备接入平台的指导。 读者对象 本文档主要适用于以下工程师:  开发工程师  技术支持工程师  维护工程师 修订记录 版本号 V2 变更说明  在开发者 Portal 线上开发的编解码插件,在下载后, 已经完成签名。  在开发者 Portal 线上开发的编解码插件,支持对命令 执行结果消息的处理。  IoT 平台提供了半透传编解码插件模板。 V1 首次发布 符号约定 在本文中可能出现下列标志,它们所代表的含义如下。 符号 说明
符号 说明 用于警示紧急的危险情形,若不避免,将会导致人员死亡 或严重的人身伤害。 用于警示潜在的危险情形,若不避免,可能会导致人员死 亡或严重的人身伤害。 用于警示潜在的危险情形,若不避免,可能会导致中度或 轻微的人身伤害。 用于传递设备或环境安全警示信息,若不避免,可能会导 致设备损坏、数据丢失、设备性能降低或其它不可预知的 结果。 “注意”不涉及人身伤害。 用于突出重要/关键信息、最佳实践和小窍门等。 “说明”不是安全警示信息,不涉及人身、设备及环境伤害 信息。 本规范由中国电信集团公司提出并归口。 本规范起草单位:中国电信物联网开放实验室
目 录 前 言...................................................................................................................................................ii 目 录...................................................................................................................................................1 1 概述................................................................................................................................................1 1.1 功能组网介绍...............................................................................................................................................................1 1.2 整体业务介绍...............................................................................................................................................................1 1.3 业务测试接入流程.......................................................................................................................................................2 2 准备工作........................................................................................................................................4 2.1 获取测试环境账号.......................................................................................................................................................4 2.1.1 微信公众号申请........................................................................................................................................................4 2.1.2 网站申请....................................................................................................................................................................6 2.2 创建 APP 应用............................................................................................................................................................. 7 2.3 NB-IoT 参数设置..........................................................................................................................................................8 3 开发 Profile..............................................................................................................................11 3.1 Profile 介绍..................................................................................................................................................................11 3.2 登录开发者 Portal...................................................................................................................................................... 11 3.3 开发 Profile .................................................................................................................................................................11 4 开发编解码插件并安装.............................................................................................................14 4.1 编解码插件介绍.........................................................................................................................................................14 4.2 开发者 Portal 在线插件开发..................................................................................................................................... 14 4.2.1 登录开发者 Portal................................................................................................................................................... 14 4.2.2 在线完成插件开发..................................................................................................................................................14 4.3 离线开发编解码插件.................................................................................................................................................17 4.3.1 开发编解码插件......................................................................................................................................................17 4.3.2 编解码插件质检......................................................................................................................................................17 4.3.3 对插件包进行离线签名..........................................................................................................................................17 4.3.4 上传公钥及签名后的插件包..................................................................................................................................19
5 应用接入平台.............................................................................................................................20 5.1 登陆应用.....................................................................................................................................................................20 5.2 订阅.............................................................................................................................................................................20 5.3 注册设备.....................................................................................................................................................................20 5.3.1 有应用服务器设备注册..........................................................................................................................................20 5.3.2 无应用服务器设备注册..........................................................................................................................................21 5.4 修改设备信息.............................................................................................................................................................21 6 设备接入平台.............................................................................................................................23 6.1 设备接入.....................................................................................................................................................................23 6.2 设备上线.....................................................................................................................................................................24 6.2.1 真实设备..................................................................................................................................................................24 6.2.2 模拟设备..................................................................................................................................................................24 7 业务数据上报.............................................................................................................................26 8 命令下发........................................................................................................................................1 8.1 命令下发处理流程.......................................................................................................................................................1 8.2 命令下发机制...............................................................................................................................................................2 8.2.1 命令立即下发............................................................................................................................................................3 8.3 命令缓存下发...............................................................................................................................................................5 9 固件升级........................................................................................................................................7 9.1 固件升级包制作并上传...............................................................................................................................................7 9.1.1 准备固件升级包文件................................................................................................................................................7 9.1.2 对固件包进行离线签名............................................................................................................................................7 9.1.3 上传公钥及签名后的固件升级包............................................................................................................................7 9.2 固件升级.......................................................................................................................................................................8 9.3 NA 订阅固件升级状态和结果...................................................................................................................................11 9.3.1 北向 NA 订阅接口..................................................................................................................................................11 9.3.2 北向 NA 订阅通知..................................................................................................................................................12 10 设备影子..................................................................................................................................14 10.1 添加 profile ...............................................................................................................................................................14 10.2 查看设备属性...........................................................................................................................................................16 10.3 更新设备属性...........................................................................................................................................................17 11 设备安全接入..........................................................................................................................18 11.1 PSK 的预置............................................................................................................................................................... 18 11.2 PSK 的在线更新....................................................................................................................................................... 18
12 更多功能..................................................................................................................................20 13 测试环境测试..........................................................................................................................21 13.1 测试申请...................................................................................................................................................................21 13.2 开放实验室测试.......................................................................................................................................................21 14 生产环境接入..........................................................................................................................22 14.1 账号申请...................................................................................................................................................................22 14.2 生产环境接入...........................................................................................................................................................22
1 概述 1.1 功能组网介绍 在设备侧,智能设备采用了 NB-IOT 芯片,它和中国电信物联网开放平台之间通过 CoAP 协议通讯。CoAP 报文的 payload 里是设备的应用数据。 应用 server 通过 http/https 协议和平台通讯,通过调用平台的开放 API 来控制设备,平 台把设备上报的数据推送给应用服务器。平台支持对设备数据进行协议解析,转换成 标准的 json 格式数据。 图 1-1 组网图 1.2 整体业务介绍 NB-IOT 主要包含 NB-IoT 设备、NB-IOT 网络、中国电信物联网开放平台、垂直行业 应用: NB-IOT 设备:通过无线网络连接到中国电信物联网开放平台,采用 CoAP 协议接入, 如水表、燃气表等。
NB-IOT 网络:实现对 NB-IoT 终端的移动性管理与会话管理;为 NB-IoT 终端建立用 户面承载,传递上下行业务数据。 中国电信物联网开放平台:实现对各种 NB-IoT 设备数据的统一管理,同时向第三方应 用系统开放接口,让各种应用能快速构建自己的物联网业务。 垂直行业应用:实现对 NB 设备的业务管理,包括业务发放、业务控制和呈现等,由 第三方基于中国电信物联网开放平台开放接口进行开发。 1.3 业务测试接入流程 为客户接入测试便捷化,制定了如下的测试接入流程:
分享到:
收藏