IOT物联网-华为云

IOT物联网-设备触发告警并邮件或短信通知（联通用户专用）:验证操作

验证操作您可以使用配置设备管理服务时注册的真实设备接入平台，上报“batteryLevel”小于20的数据。您也可以使用模拟器模拟设备上报“batteryLevel”小于20的数据。期望结果：设备管理服务控制台的“告警”页面会出现一条名称为“设备电量低”的一般告警。若订阅了邮件通知，接受订阅的邮箱会收到一封通知设备电量低的邮件。若订阅了短信通知，接受订阅的手机会收到一条通知设备电量低的短信。

IOT物联网设备联动

IOT物联网-调用订阅接口时，回调地址如何获取？

调用订阅接口时，回调地址如何获取？以业务应用订阅设备数据变化通知为例，订阅和推送的流程如下：应用服务器通过调用物联网平台的订阅接口订阅设备数据变化通知（携带回调地址和通知类型），物联网平台将业务应用的回调地址和订阅的通知类型存储到订阅列表中以便向业务应用推送设备数据变化消息。设备上报数据给物联网平台。物联网平台根据订阅时设置的回调地址，将设备数据主动推送给业务应用。什么是回调地址？回调地址是指业务应用自定义的，供外部访问的restful接口地址。当物联网平台向业务应用推送消息时，实际是调用业务应用的restful接口把数据发给业务应用。回调地址的请求方式必须为POST。怎样获取回调地址？回调地址由通信方式、业务应用的访问地址和restful接口的url组成，如https://server:port/url。通信方式建议使用https协议，保证业务应用与物联网平台的通信安全。使用https协议通信时，物联网平台需要加载证书。由于业务应用所在的网络不同，业务应用的访问地址也不同。业务应用部署在公网时，业务应用的访问地址就是业务应用的公网IP:端口（或域名 :端口）。业务应用部署在局域网时，需要在业务应用配置网络穿透，生成业务应用的公网访问地址，具体配置自行从网上获取网络穿透工具的配置步骤。不同通知类型的订阅，回调地址可以相同也可以不同，根据业务需求自定义。父主题：订阅推送（联通用户专用）

IOT物联网订阅推送（联通用户专用）

IOT物联网-设备注册鉴权（联通用户专用）:业务流程

业务流程使用LWM2M/CoAP协议接入的注册鉴权流程 1. 通过调用注册接口向物联网平台发送注册请求或者在控制台上注册设备。 2~3. 物联网平台向设备分配全局唯一的预置密钥，并返回timeout。预置密钥可以在注册设备时自定义，如果没有定义，平台将自动分配预置密钥。 timeout是指超时时间，若设备在有效时间未接入物联网平台，则平台会删除该设备的注册信息。 4. 用户将预置密钥烧录到设备硬件或软固件中。 5. 设备上电后，携带设备唯一标识码nodeId（如IMEI）和预置密钥发起接入鉴权请求。 6~7. 平台验证通过后，返回成功响应，设备连接物联网平台成功。集成Agent Lite SDK的注册鉴权流程 1. 通过调用注册接口向物联网平台发送注册请求或者在控制台上注册设备。 2. 物联网平台向设备分配全局唯一的设备ID （deviceId），并返回密钥和timeout。 timeout是指超时时间，若设备在有效时间内未接入物联网平台，则平台会删除该设备的注册信息。 3~4. 设备第一次上电接入物联网平台时需要进行绑定操作，从而将设备与平台进行关联。设备携带nodeId和密钥进行平台绑定，平台返回设备ID、MQTT登录密钥、AppId、MQTT设备侧接入地址。 5~6. 绑定后设备重新登录时，携带设备ID、mqtt接入密钥、AppId、平台HTTPS地址、MQTT设备侧接入地址，完成设备的接入鉴权。具体请参见Agent Lite SDK 使用指南（C）、Agent Lite SDK 使用指南（JAVA）、Agent Lite SDK 使用指南（Android）。如果设备是网关，网关下有子设备，则当网关接入物联网平台后，用户在网关上通过调用Agent Lite的“添加非直连设备”接口，完成子设备的接入。使用原生MQTT协议接入的注册鉴权流程通过调用注册接口向物联网平台发送注册请求或者在控制台上注册设备。注册时需要填写设备的nodeId，通常使用MAC地址，Serial No或IMEI作为nodeId。物联网平台向设备分配全局唯一的设备ID （deviceId）和密钥（secret）。密钥可以在注册设备时自定义，如果没有定义，平台将自动分配密钥。用户将设备ID （deviceId）和密钥（secret）烧录到设备硬件或软固件中。设备上电后，携带设备ID （deviceId）和密钥（secret）或者携带nodeId和密钥（secret）发起接入鉴权请求。平台验证通过后，返回成功响应，设备连接物联网平台成功。

IOT物联网

IOT物联网-设备注册鉴权（联通用户专用）:概述

概述设备注册鉴权是指物联网平台对接入平台的设备进行注册鉴权。对于不同接入方式的设备，注册鉴权方式不同。接入类型注册鉴权方式使用LWM2M/CoAP协议接入的设备在设备接入物联网平台前，用户通过应用服务器调用注册设备（验证码方式）接口或通过控制台在物联网平台注册设备，并把设备的唯一标识码nodeId（如IMEI）设置为设备接入平台的验证码。在设备接入物联网平台时携带设备唯一标识，完成设备的接入鉴权。当采用DTLS/DTLS+传输层安全协议接入时，即设备为安全设备时，通过密钥进行设备和物联网平台之间的传输通道安全加密。集成Agent Lite SDK的设备在设备接入物联网平台前，用户通过应用服务器调用注册设备（验证码方式）接口或通过控制台在物联网平台注册设备，并把设备的唯一标识码nodeId（如IMEI）设置为设备接入平台的验证码，平台返回设备ID。当设备上电时，携带nodeId等进行平台绑定，并返回设备ID和密钥。当绑定后设备重新登录时，携带设备ID和密钥完成网关的接入鉴权。如果设备是网关，网关下有子设备，则当网关接入物联网平台后，在网关上通过调用Agent Lite的添加非直连设备接口，完成子设备的接入，具体请参见网关与子设备（联通用户专用）。使用原生MQTT协议接入的设备在设备接入物联网平台前，用户通过应用服务调用注册设备（密码方式）接口或通过控制台在物联网平台注册设备，获取设备ID和密钥，并把设备ID和密钥烧录到设备中。在设备接入物联网平台时携带设备ID和密钥、或者nodeId和密钥，通过一机一密的方式，完成设备的接入鉴权。

IOT物联网

IOT物联网-设备监控（联通用户专用）:概述

概述物联网平台提供查看设备详情、设备状态管理、查看报表、查看操作记录、查看审计日志、告警管理、设备消息跟踪等设备监控与运维能力，提升设备的可维护性。功能简述查看设备详情在控制台上可以查看每个设备的设备注册和接入时的基本信息。查看设备状态在控制台上可以查看设备当前状态，如在线、离线、未激活。用户也可以通过订阅方式获取设备的状态信息。查看报表控制台提供了丰富的报表功能，方便用户查看设备的使用情况，如设备在线数、API调用数等。查看操作记录可以通过控制台查看用户对设备的操作日志，操作类型包括重启模组、配置更新、软件升级等，方便用户在进行问题定位时，查看历史操作记录，以及操作的执行结果。查看审计日志用户在使用物联网平台的过程中，系统会以日志形式收集并记录用户及平台的操作及结果，当某项功能发生异常时，用户可以根据日志的记录信息定位并处理故障问题。告警管理如果用户在控制台上设置规则引擎时，定义了响应动作为上报告警，且定义了告警属性、告警级别等，则当满足触发条件时，系统就会上报告警，需要用户密切关注设备的告警并及时进行处理，确保设备的正常运行。设备消息跟踪在设备绑定、命令下发、数据上报、设备信息更新和设备监控业务场景中出现故障时，物联网平台可以通过消息跟踪功能进行快速的故障定位和原因分析。

IOT物联网

IOT物联网-设备监控（联通用户专用）:查看审计日志

查看审计日志用户在使用物联网平台的过程中，系统会以日志形式收集并记录用户及平台的操作及结果，当某项功能发生异常时，用户可以根据日志的记录信息定位并处理故障问题。物联网平台提供在控制台上根据日志类型（包括操作日志、安全日志、个人数据查询日志、业务日志）、结果、创建时间对日志进行搜索和查看，同时能够导出筛选后的日志。日志类型日志说明操作日志记录用户和系统所做的操作和结果，用于跟踪和审计。对应用的操作：如在应用详情下，进行保存配置、恢复默认配置、上传logo、查询详情等操作。对资源的操作：如导入产品模型、查看应用首页报表、查询设备详情等。安全日志记录涉及系统安全操作信息，如创建用户、登录、用户确认隐私声明等，用户了解系统安全操作相关信息，及时发现潜在的安全隐患并进行处理。个人数据查询记录用户对账户进行的操作和结果，如查询用户列表、查询企业列表等，用于跟踪和安全审计。业务日志记录涉及平台业务的操作及结果，例如创建设备、设备登录等，用于跟踪设备侧、应用侧业务相关信息，及时发现问题并处理。

IOT物联网

IOT物联网-设备监控（联通用户专用）:告警管理

告警管理如果用户在控制台上设置规则引擎时，定义了响应动作为上报告警，且定义了告警属性、告警级别等，则当满足触发条件时，系统就会上报告警，需要用户密切关注设备的告警并及时进行处理，确保设备的正常运行。例如：智能水表设备3天未上报数据，可能存在水表设备发生故障导致，平台会产生对应的告警，维护人员可通过告警信息找到对应告警的水表设备，进行快速定位维修。告警的等级划分及处理建议：致命：已造成业务中断或可能引起设备不可用的故障，需要立即处理。严重：对设备产生部分影响或对系统性能造成影响的故障，需要采取纠正措施，防止更为严重的故障发生。一般及警告：对设备或系统没有影响，系统检测到潜在或即将发生影响业务的故障，需排查潜在故障。用户在控制台上可以查看某应用下的所有设备的告警信息，也可以查看单个设备的告警信息。所有设备告警信息在“告警”界面上：单个设备告警信息在设备列表中，单击具体的设备进入到设备的详情页面，选择“告警”页签。

IOT物联网

IOT物联网-设备影子（联通用户专用）:应用场景

应用场景适合采用LWM2M协议的设备，特别是资源受限低功耗设备，长期处于休眠状态的场景。查询设备最新上报数据和设备最新在线状态：当在控制台上查询设备上报数据时，由于设备可能长时间处于离线状态或因网络不稳定掉线，而无法获取到最新数据。通过设备影子机制，设备影子中始终保持设备最新上报的数据和设备当前状态，控制台上只需要查询设备影子中存储的数据，即可获取设备最新上报的数据和设备状态。很多应用服务器频繁的查询设备在线状态，由于设备处理能力有限，频繁查询会损耗设备性能。使用设备影子机制，设备只需要主动同步状态给设备影子一次，多个应用程序请求设备影子获取设备状态，即可获取设备最新状态，从而将应用程序和设备解耦。修改设备属性值：用户通过设备配置更新功能修改设备的属性值，由于设备可能长时间处于离线状态，修改设备属性值的操作不能及时下发给设备。在这种情况下，物联网平台可以将修改设备的属性信息存储在设备影子中，待设备上线后，将修改的设备属性值同步给设备，从而完成设备属性值的修改。

IOT物联网

IOT物联网-设备影子（联通用户专用）:业务流程

业务流程修改设备属性值修改desired属性值，如果设备在线，则设备影子直接同步设备属性值到设备，否则等待设备上线或上报数据时，再同步设备属性值到设备。用户通过控制台或应用服务器修改设备属性值。消息样例如下： Method: PUT request: https://server:port/iocm/app/shadow/v1.5.0/devices/devices/{deviceId}?appId={appId} Header: app_key: ****** Authorization: Bearer ****** Content-Type: application/json Body: { "serviceDesireds": [ { "serviceId": "Temperature", "desired": { "targetTemperature": 35 } } ] } 物联网平台修改desired属性值。物联网平台返回响应消息。物联网平台判断设备上线或上报数据。物联网平台将设备属性同步到设备。设备返回响应消息。当设备上报数据时，物联网平台修改report属性值为设备上报的设备属性值。查询设备属性值设备影子保存的是设备最新的设备属性值，一旦设备属性值产生变化，设备会将设备属性值同步到设备影子。用户便可以及时获取查询结果，无需关注设备是否在线。用户通过控制台或应用服务器查询设备属性值。消息样例如下： Method: GET request: https://server:port/iocm/app/shadow/v1.5.0/devices/{deviceId} Header: app_key: ****** Authorization: Bearer ****** Content-Type: application/json 物联网平台返回desired属性值和report属性值，即期望值和上报值。消息样例如下： response: Status Code: 200 OK Content-Type: application/json Body: { "deviceId": "******", "gatewayId": "******", "nodeType": "******", "createTime": "******", "lastModifiedTime": "******", "deviceInfo": "******""services": [ { "serviceId": "******", "reportedProps": "******", "desiredProps": "******", "eventTime": "******", "serviceType": "******" }, ] }

IOT物联网

IOT物联网-设备影子（联通用户专用）:概述

概述物联网平台支持创建设备的“影子”。设备影子是一个JSON文件，用于存储设备的在线状态、设备最近一次上报的设备属性值、应用服务器期望下发的配置。每个设备有且只有一个设备影子，设备可以获取和设置设备影子以此来同步设备属性值，这个同步可以是影子同步给设备，也可以是设备同步给影子。设备影子上有desired区和report区。 desired区用于存储对设备属性的配置，即期望值。当需要修改设备的服务属性值时，可修改设备影子的desired属性值，设备在线时，desired属性值立即同步到设备。如果设备不在线，待设备上线或上报数据时，desired属性值同步到设备。 report区用于存储设备最新上报的设备属性值，即上报值。当设备上报数据时，平台刷新report属性值为设备上报的设备属性值。物联网平台仅支持对LWM2M协议的设备提供设备影子功能，对于希望通过设备影子修改的属性，在定义Profile文件时，需遵循LWM2M协议中定义的属性，且属性类型为“W”。LWM2M标准规范参见《OMA-TS-LightweightM2M-V1_0_2-20180209-A.pdf》。

IOT物联网

IOT物联网-设备影子（联通用户专用）:查询和修改设备影子

查询和修改设备影子查询设备影子方法1：应用服务器调用查询设备影子接口。方法2：登录物联网平台控制台，点击右上角“进入设备管理服务”。单击左下角，在设备列表中，单击具体的设备进入到设备的详情页面，在“设备影子”页签中，可以查看当前设备属性数据，包括“上报值”和“期望值”，如下图所示。如果当前界面中看到“上报值”与“期望值”不一致，原因可能是设备未在线，暂时存储在设备影子中，待同步给设备，期望值会存在深色底纹。如果当前界面看到的“上报值”与“期望值”一致，则表示设备最近一次上报的属性值与用户期望下发的属性值一致，期望值为白色底纹。修改设备影子方法1：应用服务器调用修改设备影子接口。方法2：登录物联网平台控制台，点击右上角“进入设备管理服务”。在设备列表中，单击具体的设备进入到设备的详情页面，在“设备影子”页签右上角选择“属性配置”，在弹出窗口中输入服务属性对应的期望值。

IOT物联网

IOT物联网-群组与标签（联通用户专用）:给群组绑定/解绑设备

给群组绑定/解绑设备当创建完群组后，可以进行设备和群组的绑定和解绑，也可以进行设备在不同群组之间的移动。登录物联网平台控制台，点击右上角“进入设备管理服务”。单击左下角，选择“群组”。选择某个群组，进入"设备"页面，单击相关按钮，进行设备绑定、设备解绑、设备移动操作，相关说明如下表所示。图标图标说明单击可绑定设备。选中设备后，单击后可将选中的设备从群组中解绑。说明：具有权限的SP帐户或者全局用户（普通用户无法进行设备解绑）进行解绑操作，如果该群组下已绑定若干设备，解绑后，该用户无权限查看该群组和其下的设备，对于该用户来说，解绑后的群组及设备会消失。选择一个设备，单击该图标可以移动选择的设备至其他群组。

IOT物联网

IOT物联网-群组与标签（联通用户专用）:管理群组

管理群组登录物联网平台控制台，点击右上角“进入设备管理服务”。单击左下角，选择“群组”。点击相关按钮，进行添加群组、解绑群组、移动群组、删除群组操作，相关说明如下表所示。图标图标说明单击可增加根群组，用户自定义群组名称、群组的描述。单击可添加子群组，需要填写群组名称和群组描述。单击后可将子群组从父级群组中解绑。单击可将子群组从现有父群组移动到选择的父群组中。单击可删除当前选择的群组，并且删除操作不可撤回。默认群组不可删除。删除分为“级联删除”和“删除当前”： “级联删除”：删除群组时，该群组下的子群组会同时删除。 “删除当前”：删除群组后，该群组下的子群组会升级为根群组。当存在多个子群组时，会产生相应数量的根群组。例如根群组A，其子群组为B和C，若删除A，则B和C都将成为独立的根群组。选择“所有群组”后在界面右边呈现，单击可导出所有群组的拓扑结构。

IOT物联网

IOT物联网-升级指导（联通用户专用）:LWM2M协议软件升级流程

LWM2M协议软件升级流程 LWM2M协议SOTA升级流程的详细说明： 1～2. 用户在设备管理服务的控制台上传软件包，并在控制台或者应用服务器上创建软件升级任务。 3. NB-IoT设备上报数据，平台感知设备上线，触发升级协商流程。 4～5. 物联网平台向设备下发查询设备软件版本的命令，查询成功后，物联网平台根据升级的目标版本判断设备是否需要升级。如果返回的软件版本信息与升级的目标版本信息相同，则升级流程结束，不做升级处理。如果返回的软件版本信息与升级的目标版本信息不同，则继续进行下一步的升级处理。 6. 物联网平台向设备订阅软件升级的状态。 7～8. 物联网平台查询终端设备所在的无线信号覆盖情况，获取小区ID、RSRP（Reference Signal Received Power，参考信号接收功率）和SINR（Signal to Interference Plus Noise Ratio，信号干扰噪声比）信息。查询成功：则根据如下方式计算可同时升级的并发数计算，并按照步骤10进行处理。如下图所示，如果设备的RSRP强度和SINR强度均落在等级“0”中，则同时可以对该小区的50个相同信号覆盖区间的设备进行同时升级。如果设备的RSRP强度和SINR强度分别落在等级“0”和“1”中，则以信号较弱的等级“1”为准，则只能同时对该小区的10个设备进行升级。如果设备的RSRP强度和SINR强度分别落在等级“1”和“2”中，则以信号较弱的等级“2”为准，则只能同时对该小区的1个设备进行升级。如果设备的RSRP强度和SINR强度不在该3个等级范围内，且均可以查询到，则按照信号最弱覆盖等级“2”处理，则只能同时对1个设备进行升级。如果用户在软件升级中发现同时进行升级的设备数较少，则可以联系当地运营商检查和优化设备所在小区的无线覆盖情况。查询失败：则按照流程9进行处理。 9. 物联网平台继续下发查询小区ID信息的命令，获取终端设备所在的小区ID信息。如果查询成功：物联网平台支持同时对该小区的10个相同情况的设备进行软件升级。如果查询失败：则升级失败。 10～12. 物联网平台通知设备有新的软件包版本，设备启动软件包的下载。软件包的下载按照分片的方式进行下载，支持断点续传功能，通过软件包分片中携带的“versionCheckCode”确定是否属于同一个软件包。下载完成后，设备知会物联网平台软件包已下载完毕。 13～14. 物联网平台向设备下发升级的命令，终端设备进行升级操作，升级完成后终端设备向物联网平台反馈升级的结果。 15. 物联网平台向控制台/应用服务器通知升级的结果。

IOT物联网软件升级

IOT物联网-升级指导（联通用户专用）:MQTT协议软件升级流程

MQTT协议软件升级流程 MQTT协议SOTA升级流程的详细说明： 1～2. 用户在设备管理服务的控制台上传软件包，并在控制台或者应用服务器上创建软件升级任务。 3. 平台感知设备是否在线，当设备在线时立即触发升级协商流程。当设备不在线时，等待设备上线订阅升级topic，平台感知设备上线，触发升级协商流程。 4~5. 平台向设备下发查询设备软件版本号的命令，查询成功后，物联网平台根据升级的目标版本判断设备是否需要升级。如果返回的软件版本信息与升级的目标版本信息相同，则升级流程结束，不做升级处理，升级任务置为成功。如果返回的软件版本信息与升级的目标版本信息不同，且该版本号支持升级，则继续进行下一步的升级处理。 6~7. 物联网平台下发下载包URL、token及包的相关信息，用户根据下载包URL和token通过HTTP协议来下载软件包，24小时后token无效。 8. 终端设备进行下载包升级操作，升级完成后终端设备向物联网平台反馈升级的结果。 9. 物联网平台向控制台/应用服务器通知升级的结果。

IOT物联网软件升级

云服务器内容精选

IOT物联网

7*24

备案

专业服务

退订

建议反馈

售前咨询热线