检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
非联通用户请查看设备接入服务。 MQTTS是安全的基于TLS的加密协议，采用MQTTS协议接入平台的设备，设备与物联网平台之间的通信过程，数据都是加密的，具有一定的安全性。 MQTT主要应用于计算能力有限，且工作在低带宽、不可靠的网络的远程传感器和控制设备，适合长连接的场景，如智能路灯等。更多关于M
设备侧适配开发指导（联通用户专用） 概述 设备的OTA软件升级是基于华为定义的PCP协议进行的，设备侧需根据PCP协议定义的交互流程进行适配开发。下面我们将结合物联网平台与设备的软件升级交互流程，介绍终端设备将如何基于PCP协议构建交互过程中的请求消息和应答消息，帮助您更好的根据PCP协议进行终端侧的软件升级功能开发。
e填写为设备注册时设置的preSecret（预置密钥）。 如果通过开发中心注册设备，则pcVerifyCode填写为设备注册时设置的nodeId（设备标识）。 pstInfo 必选 ST_IOTA_DEVICE_INFO 设备信息，pstInfo结构体中的成员必须带结束符‘\0’。
SDK使用指南（联通用户专用） 非联通用户请查看设备接入服务。 Agent Tiny是部署在具备广域网能力、对功耗/存储/计算资源有苛刻限制的终端设备上的轻量级互联互通中间件，您只需调用API接口，便可实现设备快速接入到物联网平台以及数据上报和命令接收等功能，相关集成指导请参见端云互通组件开发指南。
接口返回值 返回值 描述 true 成功。 false 失败。 此返回值是调用接口的同步返回结果，返回true只是说明接口调用成功，并不说明绑定成功，绑定成功需要收到BindService发出的通知。 当前绑定流程的重试策略为：如果绑定失败，则30秒后继续进行重试，如果重试超过5次（总计尝
API 说明 创建批量任务 创建设备的批量操作任务，当前仅支持给批量设备下发缓存命令。 查询指定批量任务信息 查询某个批量任务的信息，包括任务的当前状态、子任务信息。 查询批量任务的子任务信息 查询某个批量任务中子任务的详情信息，如任务的执行状态、任务内容等。 设备组管理 API 说明
物联网平台支持创建设备的“影子”。设备影子用于存储设备最新上报的服务属性数据，以及第三方应用对服务属性的配置（服务属性为设备Profile文件中定义的service属性）。若设备处于离线或异常状态时，第三方应用无法通过命令下发的方式向设备下发配置，此时可把要下发的配置设置到设备影子，
物联网平台支持创建设备的“影子”。设备影子用于存储设备最新上报的服务属性数据，以及应用服务器对服务属性的配置（服务属性为设备Profile文件中定义的service属性）。若设备处于离线或异常状态时，应用服务器无法通过命令下发的方式向设备下发配置，此时可把要下发的配置设置到设备影子，
向设备下发控制命令，仅适用于使用MQTT协议接入的设备。 批量处理 API 说明 创建批量任务 创建设备的批量操作任务，当前仅支持给批量设备下发缓存命令。 查询指定批量任务信息 查询某个批量任务的信息，包括任务的当前状态、子任务信息。 查询批量任务的子任务信息 查询某个批量任务中子任务的详情信息，如任务的执行状态、任务内容等。
修改设备属性值：用户通过设备配置更新功能修改设备的属性值，由于设备可能长时间处于离线状态，修改设备属性值的操作不能及时下发给设备。在这种情况下，物联网平台可以将修改设备的属性信息存储在设备影子中，待设备上线后，将修改的设备属性值同步给设备，从而完成设备属性值的修改。 业务流程 修改设备属性值
用该接口传入设备序列号或者MAC地址以及设备信息来绑定到物联网平台。 在绑定前需要调用绑定配置接口设置物联网平台的IP与端口。 设备绑定是指设备第一次接入物联网平台的过程，需要开发者先在物联网平台注册直连设备，之后在设备上发起绑定操作，将设备绑定到物联网平台上。如果未在物联网平台
物联网平台支持创建设备的“影子”。设备影子用于存储设备最新上报的服务属性数据，以及第三方应用对服务属性的配置（服务属性为设备Profile文件中定义的service属性）。若设备处于离线或异常状态时，第三方应用无法通过命令下发的方式向设备下发配置，此时可把要下发的配置设置到设备影子，
回调地址是指业务应用自定义的，供外部访问的restful接口地址。当物联网平台向业务应用推送消息时，实际是调用业务应用的restful接口把数据发给业务应用。 回调地址的请求方式必须为POST。 怎样获取回调地址？ 回调地址由通信方式、业务应用的访问地址和restful接口的url组成，如h
模型中定义的属性数据上报给平台，平台解析后的数据上报给设备管理服务进行相关业务处理。 网关批量属性上报：网关设备将批量设备的数据一次性上报到平台，平台解析后的数据上报给设备管理服务进行相关业务处理。 CoAP协议接入的设备考虑到功耗和带宽的影响，当前只支持设备上报原始的二进制码流
deviceCommandId 必选 String path 要修改的命令ID，在调用创建设备命令接口后获得。 appId 可选 String query 命令所属的应用ID，当修改授权应用下的命令时才需要填写。 status 必选 String body 命令的状态，可选值：CANCELED，撤销命令。
秒钟内没有收到t/d资源（收发业务数据资源）的订阅，就会返回错误，但依赖CoAP层的重传继续注册，最长160秒后还是没有收到t/d资源的订阅，这次注册就会失败。160s基本可以保障终端设备能够注册成功，4s返回ERROR只会丢掉第一包的数据。建议设备重启并再发送AT+NMGS触发上述注册流程。
查询设备命令 接口说明 应用服务器向设备下发命令后，可调用此接口在物联网平台查询下发命令的状态及内容信息，以了解命令的执行情况，可查询指定时间段内本应用下的所有下发命令，或者指定设备的所有下发命令。 URI 请求方法 GET URI /iocm/app/cmd/v1.4.0/deviceCommands
向设备下发控制命令，仅适用于使用MQTT协议接入的设备。 批量处理 API 说明 创建批量任务 创建设备的批量操作任务，当前仅支持给批量设备下发缓存命令。 查询指定批量任务信息 查询某个批量任务的信息，包括任务的当前状态、子任务信息。 查询批量任务的子任务信息 查询某个批量任务中子任务的详情信息，如任务的执行状态、任务内容等。
} encode接口说明 encode接口的入参是JSON格式的数据，是平台下发的命令或应答。 平台的下行报文可以分为两种情况： 平台对设备上报数据的应答（对应图中的消息②） 表2 平台收到设备的上报数据后对设备的应答encode接口的入参结构定义 字段名 类型 参数描述 是否必填
获取IAM用户Token接口获取，接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见 Token认证。 Instance-Id 可选 String Header 实例ID。物理多租下各实例的唯一标识，一般华为云租户无需携带该参
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
