- 产品介绍
- 价格说明
- 快速入门
- 开发指南
- 用户指南
- 最佳实践
- API参考
-
SDK参考
- SDK介绍（联通用户专用）
- 应用侧JAVA SDK API参考（联通用户专用）
- 应用侧Python SDK API参考（联通用户专用）
- 设备侧Agent Lite API参考(C)（联通用户专用）
- 设备侧Agent Lite API参考(Android)（联通用户专用）
- 设备侧Agent Lite API参考(Java)（联通用户专用）
-
常见问题
- 热门问题（联通用户专用）
-
方案咨询（联通用户专用）
- 开发中心、设备接入和设备管理的差异是什么？
- IAM子用户或子项目是否可以开通物联网平台服务？
- 物联网平台支持在华为云的哪些区域开通？
- 如何成为华为IoT生态合作伙伴？
- 物联网平台支持哪些接入方式和协议？
- 华为是否提供模组/硬件终端/应用软件等？
- 设备接入模拟器HubSimulator是否能在设备管理使用？
- 设备接入服务如何获取设备数据？
- 物联网平台的应用和设备可以无限创建吗？
- 物联网平台支持批量注册设备吗？
- 物联网平台对应用和设备有消息流控吗？
- 开发中心单个应用允许接入设备数是多少？
- 数据在物联网平台的保存时间是多久？
- 物联网平台支持的DTLS加密算法有哪些？
- 物联网平台支持二进制大小端模式切换吗？
- 什么是NB-IoT？
- 物联网平台支持的硬件架构和使用的相关组件有哪些？
-
设备集成（联通用户专用）
- 如何获取设备和应用对接地址？
- 如何下载LiteOS IDE/IoT Studio?
- 物联网平台允许一个IMEI号注册多个设备吗？
- 如何设置设备名称？
- IoT设备如何激活？
- 物联网平台如何切换设备的在线/离线状态？
- 通过网关接入的子设备，平台如何识别是哪一个设备？
- deviceId、nodeId和IMEI有什么对应关系？
- Agent Lite和Agent Tiny有什么区别？
- 使用Agent Lite接入的网关设备gwbindinfo.json文件丢失如何处理？
- 运行Agent Lite Java Demo报UnsatisfiedLinkError错误怎么处理？
- 设备如何发送文件至物联网平台？
- 开发中心模拟设备如何上报负数？
- 开发中心支持哪几种省电模式？
- 开发中心支持数据转发吗？
- 开发中心没有设备分组和批量添加设备，怎么办？
- 如何检测NB网络信号？
- NB模组附着网络失败如何处理？
- NB模组绑定设备失败怎么办？
- NB模组无法正常上报数据怎么办？
- NB设备上报数据为字符串时如何转换为二进制编码？
- NB设备接入时，出现513错误？
- 为什么执行AT+CUFN=1会返回error？
- 平台向NB-IoT设备缓存下发命令，为什么设备一直收到同一条控制命令？
- AT+CGDCONT=1, CTNB是什么？
- NB-IoT设备如何选择PSM、DRX、eDRX模式？
- 应用集成（联通用户专用）
-
订阅推送（联通用户专用）
- 调用订阅接口时，回调地址如何获取？
- 应用服务器如何收到命令状态变化的通知？
- 如何获取证书？
- 回调地址可以使用域名吗？
- 订阅后消息推送失败，例如提示503如何处理？
- 应用服务器收到数据，但是平台显示推送失败？
- 应用服务器只有内网地址，能否订阅成功？
- 调用订阅接口时，提示回调地址不合法？
- 物联网平台只支持HTTPS的回调地址吗？
- 回调地址可以修改吗？
- 推送证书失效怎么处理？
- 调用删除单个订阅接口时，subscriptionId如何获取？
- 设备数据变化通知和批量设备数据变化通知的区别是什么？
- 应用服务器如何获取物联网平台推送消息时使用的地址？
- 物联网平台订阅推送是否具有重推机制？
- 为什么设备上报一条数据后应用服务器会收到多条推送？
- 在同一个应用下，平台可以将不同设备上报的数据，推送到两个服务器吗？
- NB-IoT设备已订阅消息确认和命令响应通知，为何应用服务器收不到推送消息？
- 数据上报（联通用户专用）
- 命令下发（联通用户专用）
- 产品模型/Profile（联通用户专用）
- 编解码插件（联通用户专用）
- 软/固件升级（联通用户专用）
- 文档下载
- 通用参考
链接复制成功！
网关与子设备（联通用户专用）
非联通用户请查看设备接入服务。
概述
物联网平台支持设备直连，也支持设备挂载在网关上，作为网关的子设备，由网关直连。
针对未实现TCP/IP协议栈的设备，由于无法直接同物联网平台通信，它需要通过网关进行数据转发，如下图所示。
接入流程
Agent Lite SDK提供相关的接口，开发者调用这些接口网关实现与物联网平台的对接。不同语言的SDK的接口名称不一样，每个接口功能请参见Agent Lite SDK 使用指南（C）、Agent Lite SDK 使用指南（JAVA）、Agent Lite SDK 使用指南（Android）。
1、网关调用Agent Lite SDK 的初始化接口，初始化Agent Lite资源。
2、在物联网平台的控制台上上传网关的产品模型，并注册网关。
3、网关第一次接入物联网平台时需要进行绑定操作，从而将网关与平台进行关联。需先修改配置文件里的设备固有信息（verifyCode和其他必要的设备信息），然后调用绑定接口设置绑定配置，并绑定网关。
4、网关绑定成功后，需要进行登录操作。网关先调用SDK接口配置所需的登录信息，然后调用登录接口进行网关登录。
5、在物联网平台的控制台上上传子设备的产品模型。
6、在网关登录成功后，网关调用添加非直连设备接口，填写设备相关信息（与产品模型定义一致），添加子设备到物联网平台（同时网关侧完成和子设备之间的对接，并上电）。添加成功后，在物联网平台上就能查看添加的子设备（如何查看？）。
用户也可以通过控制台添加子设备，如何添加？
7、子设备添加完后，一般情况下在物联网平台上显示是“离线”状态。所以在子设备添加成功后，或者在子设备上报数据前，网关要调用“设备状态更新”接口进行设备状态更新。
说明：
子设备的状态表示子设备接入网关的状态，由网关上报到物联网平台进行状态的刷新；如果网关不能正常上报子设备的状态信息到物联网平台，则展示的子设备状态不会刷新。例如：某子设备通过网关接入到物联网平台，子设备状态为在线状态，如果此时网关与物联网平台断开连接，则网关不能上报子设备的状态到物联网平台，该子设备的状态会一直显示在线。
8、网关调用“设备服务数据上报”接口上报网关和子设备的数据，接口里的参数填写网关和子设备的相关设备信息。
9、网关调用“设备命令接收”接口，接收并处理应用服务器或物联网平台下发的命令。
10、应用服务器调用删除子设备接口，给网关下发删除子设备命令，网关调用SDK上的“设备删除”接口删除在物联网平台上的子设备信息。并向平台返回删除结果。
网关如何接入物联网平台？
通过在网关上集成Agent Lite SDK, 设备将数据上报给网关，通过网关转发到华为物联网平台，网关接入物联网平台的开发指南请参见设备通过网关接入平台。
物联网平台上如何添加子设备？
方式1
当网关接入物联网平台后，在网关上通过调用Agent Lite的添加非直连设备接口，完成子设备接入到物联网平台。
方式2
登录物联网平台控制台，点击右上角“进入设备管理服务”。单击左下角
，进入“设备 > 所有设备”页面，在设备列表中，单击具体的网关进入到网关的详情页面，进入“设置”页签。启用“添加设备模式（NWI）”。
说明：
只有在网关的产品模型中定义了“DISCOVERY”的命令，才会在控制台上显示该功能。
该功能用于在物联网平台上添加网关下接入的子设备的场景。子设备通过Z-wave、ZigBee协议接入网关的情况下，需要物联网平台向网关下发开启发现子设备的命令，然后网关与子设备进行匹配和添加。点击“启用”按钮，物联网平台向网关下发发现子设备的命令，如果在一段时间内（一般为180秒，具体请以网关的能力为准）没有发现子设备，网关会自动关闭发现子设备的开关；如果在打开发现子设备的时间窗内，发现并添加了一个子设备后，网关也会自动关闭发现子设备功能。如果需要添加多个子设备，可以在物联网平台上再次向网关下发打开发现子设备的命令。
查看子设备
- 登录物联网平台控制台，点击右上角“进入设备管理服务”。
- 单击左下角
，进入“设备 > 所有设备”页面，在设备列表中，单击具体的网关进入到网关的详情页面，选择“子设备”页签。 - “子设备”页签呈现通过该网关方式接入到物联网平台的设备，可以查看子设备的状态、设备ID、设备类型等信息。
说明：
子设备的状态表示子设备接入网关的状态，由网关上报到物联网平台进行状态的刷新；如果网关不能正常上报子设备的状态信息到物联网平台，则展示的子设备状态不会刷新。例如：某子设备通过网关接入到物联网平台，子设备状态为在线状态，如果此时网关与物联网平台断开连接，则网关不能上报子设备的状态到物联网平台，该子设备的状态会一直显示在线。
- 在子设备页签中，单击具体的子设备，可以查看子设备的设备详情、历史上报数据、查看操作记录。
