电信物联网开放平台-nb-iot模组对接指导书

前

目前 目 概 功能组网介 整体业务介 业务测试接入流 准备工 获取测试环境账 申 申 Profile和插件开 登录开发者 完成Profile和插件开 设备接入平 设 LWM2M设备接 模组支持LWM2M接 接入端口与协 设备接 业务数据上报和业务消息下 业务数据上 向设备发送消 固件升 升级原 升级包制 准备升级包文 对升级包进行离线签 上传公钥及签名后的升级 创建升级任 测试环境测 测试申 开放测 附 模组厂商基本操作指 中国电信物联网开放平台_LWM2M接口规

1serverhttp/https协议和平台通讯，通过调用平台的开放API来控制设备，平标准的json格式数据。图1-1NB-IOT主要包含NB设备、NB-IOT网络、中国电信物联网开放平台、垂直行业应NB-IOT设备：通过无线网络连接到中国电信物联网开放平台，采用CoAP协议接入，准备工申客户或电信政企经理登录“天翼物联” 2.1.2申客户或者电信政企经理登录“天翼物联”（ 图2-8SP典型的NB-IoT应用的参数设置可参考如下设置：关联API包：基础API包和公用事业(NB-IoT)API包再保存，即1条设备历史数据只能在平台上保存7天（以默认值为例。 CA：用于消息推送场景，需要上传应用服务器的CA。如果订阅的回调地址是HTTPs地址，就需要上传。文件限制为不超过1M的PEM格式文件；中国电信物联网开放平台预制了7个CA机构颁发的，如果对接的第 书在这7个之中，则不需要上传到平台，否则需要在IoT中进行上传。7个 别为CAbaltimore、digicert、entrust、geotrust、globalsign、thawte、verisign。说明当第应用通过HTTP对接中国电信物联网开放，不需要上传CA 是需要把接收消息IP地址（即回调IP地址）发给平台支撑人员，将IP添加到白NB-IoTNB-IoT设置下的省电模式，应与受理的APN对应的模式保持一致。平台根据设置的省电模式选择为PSM模式：当命令为缓存下发时，平台将收到的下发命令缓存，等设下发命令立即下发，如果此时，设备处于PSM态，设备将不能收到下发命令，设备处eDRX模式：当命令为缓存下发时，平台将收到的下发命令缓存，按顺序将缓存令全部下发；当命令为立即下发时，平台将收到的下发命令立即下发，说明PofiProfile设备的Profile文件是用来描述一款设备是什么、能做什么以及如何控制该设备的文件。一个Profile文件的内容主要包括两部分，一部分是设备的基础属性信息，如行数据。每款设备都需要一个Profile文件。NB-IoT设备和中国电信物联网开放平台之间采用COAP协议通讯，COAP消息的数据码插件。一款设备对应一个编插件。Profile登录开发登录开发者Portal。如果初始已经修改，请用修改后的登录。开发者PortalProfile和插件开开发者Portal使用指导地址： 如果只是测试模组与平台的对接功能，建议直接按照指导开发profile和插件（注意：请务必自行定义厂商ID和设备型号），并直接使用中给的样例码流，在设备时使用真实设备的IMEI作为设备标识和使用真实设备上流。设备接入所有设备需要先在平台进行，才允许连接到平台，平台支持通过北向API接口进行，也支持通过平台的portal界面进行。通过设备，平台会为每个设备分配一个唯一的标识deviceId和PSK（如果北向API接口中携带了PSK参数，那平台就使用北向接口中的PSK，不再自动分配APP应用操作这个设备时都通过deviceId来指定设备。PSK参数详细参考后面设备DTLS安全接入。使用开发者portal设备时，已完成了设备和设置设备信息两个步骤。verifyCode和nodeId需要填写为设备唯一标识。高通设备的唯一标识为urn:imeixxxx，xxxx为imei号；海思设备的唯一标识为imei号；其他种类的设备唯一标识请联系模组厂商确认。设备标识码需与章节4.3.3中的endpointname一致。timeout建议填写为0。TUP为TUP设备。NB-IOT5684端口，5684端口走DTLS+CoAP协议通道接入，NB-IOT设备端接入时提供必要的数据凭证，并支持标准DTLS协议。5684（即走DTLS加密通建议将设备出厂前的PSK秘钥预置到中国电信物联网开放平台中，PSK秘钥的数据类型为String型，长度范围为8-32位。LWM2M时，此设备为LWM2M场景。模组支持LWM2M模组在对接中国电信物联网开放平台前，需要按照LWM2M的标准协议附录中的《中国电信物联网开放平台_LWM2M接口规范.doc》规范完成开发。接入端口与协DTLS安全接入的方式：TLS_PSK_WITH_AES_128_CCM_8,asdefinedin[RFC6655]TLS_PSK_WITH_AES_128_CBC_SHA256asdefinedinRFC5487]PSKidentity填endpointname，参见章节4.3.3设备接的参数可能有:ep={EndpointClientmode}&{ObjectLinks},为兼容旧协议，除ep外其余均为可选。lwm2m参数{endpointname}：必选，即为的endpointname；endpointname按或格式为imei号；高通模组的格式为urn:imei:xxxx，海思模组为imei号；章节4.1中的设备标识码需与endpointname一致。}Option1：Uri-Path（11）：rd，说明：括号里面的为Option编号Option2：Content-Format（12）：application/link-formatOption3：Uri-Query（15）：{binding}Option4：Uri-Query（15）：{lifetime}响应码：2.01响应码：4.00BadRequest4.03业务数据上报和业务消息19/0/0平台将会根据设备的厂商ID和设备型号查找对应的编插件（编插件信息参见章节3），在后会将数据通知到北向应用。ObserveAsynchronousOption2：Content-Format（12），即为ObserveAcceptOption中设置的数据格式，该对象为BinaryApplicationData备备数据上报通知频并使用中提供的码流，详见3.2.2完成Profile和插件开发，此处不再复述。Option1：Content-Format（12），即为ObserveAcceptOptionAPP编APP编插下行消查找对应的 插步骤3组装成COAP报步骤4.输出：json上报通当设备时，在我的设备列表中选择对应的设备，点击右方倒数第3个按钮（命令portal->我的设备->点击对应的设备->历史命令页面，查看命当设备回一个ACK（2.04Changed）命令应答时，命令的状态由“已发送”状态变为图5-6命令执行成功说明固件升303Firmware408Cell5Firmware01Package5Firmware025Firmware035Firmware05Update1、升级包时会触发COAP协议的的blocktransfer，模组需要支持。准备升级包文对升级包进行离线签 1SPPortal。步骤2离线签名工具。步骤3在路径找到压缩包“signtool.zip”，右键菜单中选择“Extracttosigntool\”5 步骤6对升级包进行数字签名。 76中生成的名为 上传公钥及签名后的升级1上传升级包之前需要上传对应的公钥信息，公钥来源为章节6.2.2生成的public.pem文件。登陆SPPortal，选择应用管理，点击进入对应的应用下，在2测试环境附包括上行数据发送和下行数据）：查询IMEI，IMEI即为设备标IMEIxxxxIMEI。如果查询不到可IMEI，IMEI且只能设置一次。IMEI