- 产品介绍
- 价格说明
- 快速入门
- 开发指南
- 用户指南
- 最佳实践
- 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（联通用户专用）
- 编解码插件（联通用户专用）
- 软/固件升级（联通用户专用）
- 文档下载
- 通用参考
链接复制成功！
设备配置更新（联通用户专用）
非联通用户请查看设备接入服务。
概述
物联网平台提供设备配置更新功能，即用户可通过控制台对单个设备或批量设备的设备属性值进行修改，满足用户频繁、快捷、方便的管理设备的诉求。比如，某路灯最初设置温度属性达到A摄氏度时上报告警，用户需要修改该属性值为B摄氏度，即可修改其配置文件，然后通过控制台上传到物联网平台，以实现配置更新。
- 针对LWM2M协议设备的设备配置更新，物联网平台提供了设备影子功能，将修改设备的属性信息存储在设备影子中，待设备上线或上报数据时，将修改的设备属性值同步给设备，从而完成设备属性的修改。
- 针对原生MQTT协议接入或集成Agent Lite SDK的设备，物联网平台直接配置更新下发，修改设备的设备属性值。
说明：
物联网平台第一次给设备下发配置更新，如果当前的配置文件还没有下发给设备前，又进行了第二次的配置下发，则将两次的配置文件进行合并后再下发（如果配置项重复，则后一次会覆盖前一次）。
前提条件
设备的产品模型中已定义该设备服务属性，且该属性支持可配置，在界面上传的配置文件为JSON格式，才能完成配置更新下发。
单个设备配置更新
- 登录物联网平台控制台，点击右上角“进入设备管理服务”。
- 单击左下角
，在“产品模型”界面上，单击设备所属产品模型的“详情”按钮，“维护能力配置”中的“设备配置”设置为“支持”。
- 进入“所有设备”页面，单击设备所在行的
按钮，可对设备进行配置更新。
- 在弹出窗口中，按照下表配置参数。
参数名称
参数说明
任务名
创建设备配置下发的任务名称。
执行类型
任务的执行类型。分为“现在”、“设备在线时”、“自定义”。选择“自定义”时需要设置“执行时间。”
执行时间
执行类型选择“自定义”时生效，设置任务执行的时间。
重试策略
重试次数
当“重试策略”为“自定义”时需要设置此参数。
重试间隔（秒）
当“重试策略”为“自定义”时需要设置此参数。
配置文件
需要导入设备的配置文件，可点击下载上一次下发成功的配置文件信息进行修改后再导入。
如果在此操作前，未对设备进行过配置下发的操作，点击下载设备配置文件会提示“找不到资源”，这种情况下只能通过用户自定义的方式，手动制作配置文件，支持配置下发修改的项需要与设备支持的能力（设备对应的产品模型）保持一致，且配置文件需要为JSON格式，例如：
{ "sensitivity": "0", "dataReportInterval": "20" }
批量设备配置更新
- 登录物联网平台控制台，点击右上角“进入设备管理服务”。
- 单击左下角
，在“产品模型”界面上，单击设备所属产品模型的“详情”按钮，“维护能力配置”中的“设备配置”设置为“支持”。
- 选择“ 批量任务> 批量设备配置”，单击页面右上角的“创建”。
- 在弹出的“批量设备配置”窗口中，按照下表配置参数。
参数名称
参数说明
配置原则
任务名称
批量设备配置的任务名称。
按照实际情况填写。长度不超过50的字符串。
是否使用策略
批量设备配置执行策略是否需要配置。
请根据实际情况选择，默认勾选。
执行类型
选择批量设备配置的任务执行时间。
- 现在：任务创建完成后开始。
- 设备在线时：当物联网平台与设备互联时执行任务。
- 自定义：可以自定义选择开始和结束时间。“开始时间”和“结束时间”在“执行类型”参数设置为“自定义”时生效。
重试策略
任务失败后是否需要自动重新执行，默认为“否”。
- 否：不重新执行。
- 自定义：可自定义重试次数。
重试次数
“重试策略”参数设置为“自定义”时生效。
-
重试间隔（秒）
“重试策略”参数设置为“自定义”时生效。
-
- 单击“下一步”，进入下一步配置。按照实际情况配置参数。
- 选择需要批量配置下发的设备群组，单击“下一步”，跳转至文件上传页面。单击
，将整理好的Json格式设备配置信息文件上传。
配置文件制作方法：- 之前有成功下发的配置文件：选择“设备 > 所有设备”，在右侧的窗口中单击相同类型设备所在行的
按钮，在“配置文件”一栏，下载上一次下发成功的配置文件文件进行修改后再导入。 - 之前未对设备进行过配置下发的操作：手动制作配置文件，支持配置下发修改的项需要与产品模型里支持的能力保持一致，且配置文件需要为JSON格式，例如：
{ "sensitivity": "0", "dataReportInterval": "20" }
- 之前有成功下发的配置文件：选择“设备 > 所有设备”，在右侧的窗口中单击相同类型设备所在行的
- 单击“提交”，完成批量设备配置任务创建。
- 界面列表显示任务执行的状态和结果。如果成功率低于100%，则可以单击具体的任务名称，进入任务详情，查看执行失败的原因。
