产品 电信nb接口调用_NB-IoT 平台对接常见问题（中国电信）

为什么建议NB-IoT客户接入电信平台？

尤其是在NB海量设备高并发场景，电信平台与电信NB网络进行有机协同，能够有效缓解拥塞，保障业务成功，充分发挥NB网络的特性和价值。

特别是对于路灯、家电等需要下行控制的应用场景，如果客户终端直接连自有应用，那么当客户应用需要下发数据给终端时，由于NB-IoT终端分配的是私网地址，需要经过NAT地址转换为公网地址实现访问，在无交互情况下私有地址会话信息90s会被释放，因此客户应用将会找不到终端，进而下发失败。如果使用中国电信平台，由于电信平台与终端在一个专属网内，可以保持较长时间的会话，从而有效避免NAT地址老化的问题，实现反向控制。

物联网开放平台是否会保留应用数据，侵犯数据隐私？

除非客户同意并授权，否则物联网开放平台不会保存或解析客户的任何应用层数据。物联网开放平台目前对数据处理有两种模式：

数据完全透传：客户在profile编写时可以将整个应用层数据放在一个字段里面打包，物联网开放平台不进行任何解包的操作，直接将数据传递给客户平台，数据完全透传。

解析数据并提供服务：企业客户根据自身需要，在profile编写时对于希望物联网开放平台解析并提供数据服务的内容编写独立字段，平台解析profile中相应字段内容，并提供对应的数据分析服务。建议客户可将网络相关信息进行编写提供，用于后期故障快速排查和定位，为客户提供更好的服务。

接入电信平台是否就不接客户自有应用了？

不是。接入电信平台后，电信平台北向仍然和客户自有应用对接。对于透传客户，平台完全透传数据，通过平台的目的是为了给客户提供更好的NB网络服务性能体验；对于非透传客户，平台可以给客户自有应用提供API接口，调用平台的分析、触发器等能力。

客户接入平台的流程有哪些步骤？

1)在天翼物联产业联盟微信公众号填写账号申请，得到测试环境账号；

2)在天翼物联产业联盟网站下载相关开发指南，开发对应的profile和编解码插件，电信人员会全程提供技术支撑；期间客户可以根据需求在测试环境随时修改和编辑profile和插件。

3)将profile和编解码插件在测试环境上传，并发起测试申请，电信人员进行测试验证服务，并反馈测试报告。

4)客户通过客户经理向物联网公司支撑经理发起中国电信物联网开放平台接入申请，物联网公司会在一个工作日内为客户开通正式平台帐号，并通过邮件发放生产环境平台账号给客户，正式对接完成。

详细流程可参考《中国电信物联网开放平台接入指导手册》。

平台是否只支持CoAP协议，不支持UDP协议接入？

CoAP协议的传输层就是UDP协议(比如MQTT对应的传输层协议是TCP)，不存在不支持UDP协议的问题。2.如果在UDP上层采用的是各应用私有的应用层协议，平台很难统一处理，也就无法提供与NB-IoT网络配合的各种服务。

NB-IoT作为一种低功耗、大连接的网络技术，建议使用轻量级、低功耗的CoAP协议。

物联网开放平台同时也支持LWM2M、MQTT、Zigbee、Zwave、onvif、JT808、Hilink、DLMS、NGTP、HTTPs等协议。

#### 高通芯片的模组是否可接入物联网开放平台？

高通芯片可以实现和开放平台的对接。目前采用高通芯片，已经完成对接的模组有中兴物联ME3612/3612-G、中兴ZM8300、芯讯通SIM7000C/7000C-N、龙尚科技A9500等。

#### 电信平台如何保障客户数据的安全？

双节点异地灾备，为电信开放平台提供双重保障。

基础设施安全解决方案：

1) 操作系统数据库安全加固

根据CIS基准的安全加固

行业最佳安全工具扫描漏洞加固，如Nessus

2) 入侵检测工具

事后入侵检测工具，支持痕迹加测，后门检测，内核Rookit检测，应用层异常检测，BOOT层检测等

实时入侵检测工具(待落地)优点：基础环境可信，攻击过程记录

3) 安全补丁管理

定期发布安全补丁

紧急补丁发布，风险级别由CVSS(常见漏洞评分系统)评估，电信将根据不同的风险级别采取不同的响应策略。

4) 系统软件完整性保护

使用CA证书(提供基于HSM硬件的高安全性)对发布的软件包签名，在系统安装前校验签名，保证软件未植入木马、后门，确保软件安全性。

安全隔离：开放平台与客户终端在专网互通，与互联网完全隔离，有效降低客户终端面向互联网的安全风险。同时对于不同客户的数据进行隔离，保障每个客户数据安全。

全局调度能力：开放平台与物联网网络进行密切的数据交互，能够全面了解每个区域的网络和业务情况，便于集中统一的进行数据下发调度，避免客户平台因为对网络了解的局限性，导致数据下发失败的情况。

#### 在哪里下载相关文档？

请在中国电信天翼联盟网站，联盟服务，下载专区

#### 先看哪个文档？

请首先参考《中国电信物联网开放平台_NB-IoT业务对接指导书》，其中包括了接入总体流程和相关操作步骤和参考资料说明。

#### 在SP门户上新建应用时，需要注意哪些事项？

1) 所属行业，必须选择“公用事业 NB-IOT”

2) 关联api包，必须选择“公用事业 NB-IOT”和“基础API包”

3) 应用能力，必须选择“规则引擎”

4) 其他参数可默认或不选择

5) CA证书，可后续使用到北向通知时再上传

6) 生成的APPID和密码信息请截图保存以备后续调用北向API时使用

#### 如何查看设备上报的数据？

进入企业门户设备管理菜单，点击需要查看的设备，选择“数据”标签进行查看

#### 如何查看已下发命令的信息和发送状态？

进入企业门户设备管理菜单，点击需要查看的设备，选择“历史命令”标签进行查看。

#### CA证书在哪里上传？

进入企业门户应用菜单，点击某个应用，可进行CA证书上传

#### Profile文件在哪里上传？

进入企业门户设备管理菜单，选择模型后导入模型

#### 开发者门户是否支持插件导入功能？

支持，上传的插件包不需要进行签名

#### 开发者门户插件在线编辑功能是否支持浮点数？

不支持设置浮点数类型，可通过以下方式实现：

1)数据类型设置为sring类型，应用自行解读转换；

2)设置为整数和小数部分两个参数，应用自行拼接。

#### 如何查看联调日志？

在开发者门户“我的设备”点击设备详情，选择“设备日志”标签进行查看

#### profile文件和编解码插件的定义和关联？

1) Profile文件定义了设备信息的存储结构，包括设备基本信息(设备名称、类型、支持的协议等)和设备服务(包括上报数据格式、命令参数和响应消息格式等)。

2) 编解码插件，主要功能是完成NB设备的码流信息和json文件格式(根据profile定义的)之间的相互转换。

3) 编解码插件中的相关参数名称必须和profile中定义的完全一致。

#### 客户、应用、设备、profile文件和编解码插件的对应关系是什么样的？

1) 一个客户可以建立多个应用；

2) 一个设备类型对应一个profile文件；

3) 一个profile文件对应且只对应一个编解码插件。编解码插件中的参数名称必须和对应profile文件定义的完全一致。

4) 一个应用可以管理多种类型的多个设备，可以对应多个Profile文件。但是这些profile文件，必须可以通过manufacturerId、manufacturerName和Model三个参数标识唯一性；

#### Profile编写需要注意哪些问题？

1) 所有参数值不能有中文和特殊字符

2) 协议类型参数固定为：“CoAP”

3) Serviceid和Servicetype两个参数的值需保持一致

4) 模板中属性名称不能修改

5) 文件名不能有中文

6) 上传之前，不能存储在中文路径下

7) 打包格式一定要按照模板要求的目录结构

8) 上传之前，建议使用json校验工具进行语法校验

Profile文件上传失败可能是哪些原因？

1) Profile文件的目录结构不符合要求

2) 上传之前，存储在中文路径下

编解码插件如何上传？

目前有两种方式进行上传

1) 通过开发者门户自助上传，上传的插件包不需要签名

2) 发送给电信服务人员通过后台进行上传，需要提供签名过的插件包和公钥文件

上传之前，可使用编解码插件自检工具进行校验

编解码插件上传失败可能是哪些原因？

1) 对应的profile文件尚未上传

2) 编解码插件中的manufactureid和manufacturename与profile中的定义不一致

3) 编解码插件的目录结构不符合要求

平台北向API调用失败的原因有哪些？

1) 电信物联网开放平台开放接口采用双向认证机制，应用平台未导入平台提供的CA证书，导致认证不通过

2) API参数错误，如APPID和密码错误，目标地址端口错误等

3) 设备注册接口中的Verifycode和nodeid不一致，应该统一填写为设备的IMEI号

订阅通知消息设置的回调地址需要注意什么问题？

电信物联网开放平台支持的应用回调地址默认要求为Https，如果回调地址采用http方式，需要联系电信服务人员在电信物联网开放平台上预先配置。

回调地址格式要求：

1) 必须有端口号，且端口号之后必须具备资源路径，不能有空格。

2) 如果是https地址，如https://server:port/callbackUri，其中server可以是域名或IP地址

3) 如果http地址，如http://server:port/callbackUri，其中server必须为固定IP地址

应用收不到订阅的通知消息可能有哪些原因？

1) 电信物联网开放平台支持的应用回调地址默认要求为Https，应用未上传其服务器CA证书或证书错误，导致认证不通过

2) 应用提供的回调地址格式不正确(缺少端口号或资源路径等)或不能正常访问

3) 如果回调地址采用http方式，需在电信物联网开放平台上预先配置，否则该订阅地址无效。

平台北向API是否支持批量操作？

1) 设备注册接口不支持批量注册，如需批量注册可以通过企业门户进行操作

2) 命令下发接口可支持对批量设备的操作

设备与平台对接，需要配置哪些参数?有哪些操作步骤？

备注：下列指令仅适用于云程、移远、利尔达模组，其他厂商模组可参考对应厂商提供的模组指令集，选择相应的指令完成对应操作。

实现终端入网，需要在SSCOM中通过一系列AT指令来控制NB模组。

SSCOM中的各项设置说明如下：

1) 串口号：选择与NB模组进行通信的实际物理com口，并确保打开串口。

2) 波特率：选择9600。NB模组内置的华为NB芯片仅支持波特率9600。

3) 发送AT指令时确保勾选“发送新行”，不勾选“DTR”和“RTS”。

4) 其他参数保持默认。

终端入网的详细步骤如下所示：

Step 1：终端上电，执行“AT+NRB”复位终端。如果返回OK，表示终端正常运行。

Step 2：执行“AT+CFUN=0”关闭功能开关。如果执行成功，返回OK。

Step 3：执行“AT+NTSETID=1,设备ID”设置设备ID。设备ID为NB模组的IMEI号，如果执行成功，返回OK。

Step 4：执行“AT+NCDP=IP, PORT”设置需要对接IoT平台的地址180.101.147.115，端口为5683。如果执行成功，返回OK。

Step 5：执行“AT+CFUN=1”开启功能开关。如果执行成功，返回OK。

Step 6：执行“AT+NBAND=频段”设置频段。如果执行成功，返回OK。频段信息可以咨询NB模组厂商。

Step 7：执行AT+CGDCONT=1,"IP","APN"设置核心网APN。如果执行成功，返回 OK。APN可设置为"CTNB"(默认PSM模式)或 "psm0.eDRX0.ctnb"(默认DRX模式)。

Step 8：执行“AT+CGATT=1”进行终端入网。如果执行成功，返回OK。

Step 9：执行“AT+CGPADDR”查询终端是否获取到核心网分配的IP地址，如果获取到IP地址，表示终端入网成功。

Step 10：执行“AT+NNMI=1”设置下行数据通知功能，如果执行成功，返回OK。

平台支持哪些设备省电模式？

1) PSM模式：power saving mode，省电模式。适用于对下行业务时延无要求，对于下行业务消息，可等待设备发送上行数据进入连接态后再发送的业务场景，可进一步节省终端功耗。如智能水表、智能家电。

2) DRX模式：discontinuous reception，不连续接收模式。适用于对下行业务时延要求高，可认为设备一直在线，消息能够立即下发的业务场景。如路灯。

模组有哪些常用的AT指令？

备注：下列指令仅适用于云程移远、利尔达、模组，其他模组请联系模组厂商获取AT指令说明

1) 错误原因查询：AT+CMEE=1，模组会打印出明确的错误码

2) 关机：AT+CFUN=0

3) 查询IMEI: AT+CGSN=1

4) 添加IMEI: AT+NTSETID=1,需要添加的IMEI号

5) 添加IP: AT+NCDP=180.101.147.115,5683

6) 开机：AT+CFUN=1

7) 设置核心网APN:AT+CGDCONT=1,"IP","APN"

8) 入网：AT+CGATT=1

9) 获取核心网分配给终端的IP地址：AT+CGPADDR

10) 发送数据：AT+NMGS=2,数据的16进制码流

11) 接收下行数据：AT+NQMGR

12) 读取数据：AT+NMGR

设备无法在平台上从离线变为在线状态的原因有哪些？

1) 设备未注册，平台返回513错误码

2) 设备信息未修改，平台返回513错误码

3) 设置的平台地址或端口错误，目前平台只支持5683端口

4) Profile中的协议类型不是“CoAP” ，平台返回5.00错误码

5) 设备入网失败，请联系当地电信客户经理协调解决

6) 设备和模组适配问题，请联系模组厂商协助解决

北向接口调用模拟工具如何使用？

1) 本地安装JDK1.8及以上java环境，解压IoT_OceanConnect_North_GUI_APPDemo.zip(简称GUI Demo)压缩包，打开application文件夹，直接双击运行Demo.jar文件。

2) 根据邮件内容填写对应配置项后，单击“Login”按钮登录。

3) 在“Module Choose”下拉框中，“Solution”选择“NB-IoT”，“Module”选择“DeviceManager”。

4) 在“Register Direct Device”下拉框中，按照以下要求填写各参数信息：

Node ID：设备唯一标识。此处填写NB模组的IMEI号。(15位数，一般以86开头，贴于模组标签上)

Verify Code(O)：与Node ID保持一致。

Time out(O)：填写0即可。

参数填写完成后，单击“Register”按钮注册设备至IoT平台。注册成功后会返回deviceId，deviceId是IoT平台对于设备的唯一标识，请保存。

说明：此步骤相当于调用IoT平台开放的“注册直连设备”接口。

5) 在“Modify Device Info”下拉框中，按照profile中的信息填写各参数后，单击“Modify”按钮设置已注册的设备信息，并保存至IoT平台。

Device ID：注册直连设备时返回的deviceId。

Manufacturer Id：与profile文件中的manufacturerId保持一致，请填写“eSDK“。

Manufacturer Name：与profile文件中的manufacturerName保持一致，请填写“eSDK_Huawei“。

Device Type：与profile文件中的deviceType保持一致，请填写“MultiSensor“。

Model：与profile文件中的model保持一致，请填写“v01“。

Protocol Type：与profile文件中的protocolType保持一致，请填写“CoAP“。

说明：

此步骤相当于调用IoT平台开放的“修改设备信息”接口，具体接口信息可参考接口文档。

修改设备信息成功后，可以在IoT平台的SP Portal中查看已注册成功的设备，此时设备处于“离线”状态。

哪些地方需要使用CA证书？

1) 中国电信物联网开放平台北向接口调用双向认证，应用调用接口时需要使用开放平台提供的CA证书

2) 订阅消息推送到应用平台回调地址，采用https时，需要使用应用平台提供的CA证书

物联网开放平台的CA证书如何获取？

请在中国电信天翼联盟下载专区获取中国电信物联网开放平台应用服务器证书(ca)-北向接口调用认证.ZIP

应用平台提供的CA证书有何要求？

请在中国电信天翼联盟下载专区获取《中国电信物联网开放平台-回调地址证书制作说明》，参考该文档进行证书制作，或者可以从第三方购买符合要求的证书。上传到平台的证书格式要求是.pem格式。

当前页面是本站的「Google AMP」版。查看和发表评论请点击：完整版 »