OneNET物联网平台 平台介绍 入门手册 设备开发指南 应用开发指南
API
API使用 API列表 SDK MQTT LwM2M EDP Modbus TCP
消息队列MQ(公测) HTTP推送
扩展服务 常见问题 发布公告

LwM2M接入说明

测试接入流程分为平台域和设备域,用于帮助您进行首次接入体验,以便对平台的功能以及接入协议有大致的了解。

测试流程图: 基于NB模组/SDK方式接入流程: pic

接入步骤

Step1 创建产品,选择接入协议 首先您需要在平台创建一个NB-IoT的产品,在设备接入协议选择时选择LWM2M协议(因NB-IOT设备需通过NB基站接入平台,创建产品时联网方式请选择“NB-IoT”),具体创建步骤可查看产品创建

如果您还没有OneNET账号,可以用户注册

创建产品后,记录该产品的用户ID

Step2 创建设备,记录设备ID等信息 创建设备有两种方式: 第一种 可以通过页面点击添加设备,输入设备名称和鉴权信息(即IMEI、IMSI),具体平台的资源模型可详情请查看资源模型,并记录下该设备编号.

第二种 可以通过调用创建设备API 实现设备的创建,输入设备的设备名、接入协议、鉴权信息以及MasterKey等信息,即可在平台上创建设备。

Step3 移植SDK或搭载NB模组,建立UDP连接

结合NB-IOT设备的实际接入方式,目前来看主要有两种:

第一种,NB-IOT设备搭载了已经实现接入OneNET平台的NB模组,设备通过NB模组和NB基站以及核心网等网元连接,实现和OneNET平台进行交互,完成同bootstrap服务器建立UDP连接。

具体方式为设备上电后通过发送AT指令给模组,同时携带endpoint name参数(也即鉴权信息IMEI、IMSI等信息)实现设备和平台之间的UDP连接。连接建立成功后,bootstrap服务器会返回的LWM2M接入服务器地址和端口;

已经实现接入OneNET平台的NB模组部分展示见下表:

厂商名称 产品类型 产品型号
广和通 模组 N700-CN
移远 模组 BC95
骐俊物联 模组 ML5330
SIMCom 模组 SIM7000C-N
新华三 模组 IM2209
中兴微电子 芯片 RoseFinch7100
高通 芯片 MDM9206
MTK 芯片 MT2625
华为海思 芯片 Boudica120
华为海思 芯片 Boudica150

第二种,NB-IOT设备搭载的NB模组未实现接入OneNET平台,该情况建议有两种方式:第一种方式开展NB模组接入OneNET的适配工作(若有意向接入OneNET平台,请点击此处);另外一种方式需要用户下载NB-IOT的SDK,开展相应的开发工作自行移植至设备的MCU中。

若SDK已成功移植至MCU后,可在MCU中配置好bootstrap服务器地址、端口号,以及endpoint name参数(也即鉴权信息IMEI、IMSI等信息)信息后,通过SDK实现和bootstrap服务器的UDP连接。连接建立成功后,bootstrap服务器会返回的LWM2M接入服务器地址和端口。

bootstrap服务器域名为:nbiotbt.heclouds.com端口号为:5683

Step4 建立设备与平台间的协议连接

在Step3中完成设备获取LWM2M接入服务器的地址后,设备会自动完成和平台间的协议连接。

若已经连接成功,在设备信息中会看到一个在线标记: pic

Step5 设备资源列表查看

在Step4中完成设备上线后,通过点击最右边的“资源列表”按钮可以进入该设备的资源列表中进行信息查看。设备上线后会上传一个资源列表到平台中,平台可以对这些资源做读、写、执行、订阅等操作。

在资源列表中可以看到设备下的对象名称、实例个数和属性个数。 pic

Step6 设备属性查看,资源数据操作

在Step5中看到设备资源列表后,点击某个具体的对象名称后可以看到具体的对象实例以及该对象实例下的属性值等信息。在该页面上可以实现对具体某个属性的读、写、执行以及查看详情等权限,完成对设备某个具体属性的实际操作。 pic

Step7 结合实际场景开展NB-IOT应用 通过Step1-6上述操作,可以实现对具体NB-IOT设备的连接、资源列表查看、对象属性的读、写、执行等实际操作等,满足在NB环境下整个NB-IOT应用的开展。

常见问题

Q1:终端无法和OneNET建立连接

A: 请先确认终端是否正常附着到NB网络中,若网络附着正常,再检查终端连接报文和鉴权码是否正常,若两者皆正常工作,可通过4001-100-866转3咨询平台技术人员。

Q2:SDK初始化模组失败

A: SDK在启动的时候会首先对当前模组的工作模式进行配置,使其能够附着进NB网络中,配置的方式是通过一系列AT指令,需要注意的是模组处理每条AT指令都需要一定的时间,因此建议AT指令间可以延迟几秒,否则会造成初始化过程失败。

Q3:无法连接到平台,返回 4.03

A: 4.03 Forbidden 是鉴权失败,通常是因为 imei 和 imsi 不对。平台通过设备的 endpoint name 鉴权,endpoint name 的格式是 imei;imsi中间为分号。

Q4: 设备在OneNET 门户页面上为什么是离线状态

A: 设备的在线状态只跟lifetime 是否过期有关,lifetime 设备连接(Register) 的一个参数,单位为秒,不指定则默认为 86400,lifetime 到期后,平台就会把设备踢下线,此时设备无法上报数据,只能重新连接(Register)。设备可以在lifetime未过期时通过发送 Register Update 报文延长 lifetime。

Q5: 读/写/执行返回 TIME_OUT

A: TIME_OUT 是因为平台没有在超时时间内(25秒)收到设备的响应,有几种可能:

1) 网络连接session被核心网回收,NB-IOT 设备通过核心网连接到平台,如果设备在一段时间内(各地情况不一,通常为几分钟)没有上行和下行的活动,核心网会回收连接,此时平台下发的消息无法到达设备

2) 网络问题,NB-IOT 的网络不稳定,尽管CoAP 有重传机制,仍然有可能在25秒内无法完成平台到设备的请求响应的全过程。

Q6:执行接口(Execute)无法下发二进制数据

A: LwM2M 协议中,Execute 操作的参数为字符串,不支持二进制,要下发二进制,可以使用 Write 操作,请参照 API 文档写资源接口。

Q7:连续上传数据,每5分钟才有一条数据保存到平台

A: CoAP 协议通过 message id 和 token 来过滤重复消息,对于上报(Notify)的包,因为每次token相同,如果message id 也不变,会被当作重复消息被过滤。重复消息过滤的时间窗口是 247 秒,即第一条消息被处理后,247秒内的重复消息都会被过滤。

Q8:上传的 Integer/ Float/字符串数据显示为 [10, 100, 123] 这种格式 A: 没有使用 IPSO 定义的标准资源模型。对于非 IPSO 模型的 Object ID 和 Resource ID, 平台无法判断资源的数据类型,只能按照二进制处理。

Q9:平台是否支持 DTLS加密传输

A: 当前支持基于公钥的DTLS加密(使用 coaps 和 5684端口连接),后续会支持基于 PSK 和 X.509 证书的DTLS加密。

results matching ""

    No results matching ""