检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
平台下发日志收集通知 Topic 下行: $oc/devices/{device_id}/sys/events/down 接口功能 用于平台下发日志收集通知给设备。 参数说明 字段名 必选/可选 类型 参数描述 services 可选 List<EventService> 参数解释：
网关是一个特殊的设备，除具备一般设备功能之外，还具有子设备管理、子设备消息转发的功能。SDK提供了AbstractGateway抽象类来简化网关的实现。该类提供了子设备管理功能，需要从平台获取子设备信息并保存（需要子类提供子设备持久化接口）、子设备下行消息转发功能（需要子类实现转发处理接口
在设备接入控制台左侧导航栏，选择“设备 > 所有设备”，进入设备列表页，设备列表默认显示当前实例下的所有设备。 图1 设备-设备列表 表1 设备列表功能 功能 描述 搜索设备 根据状态、设备名称、设备标识码、设备ID、所属资源空间、所属产品和节点类型搜索具体设备。 查看设备信息 可查看设备状态
可降低网络时延，提高访问速度。 规格配置 支持免费单元S0、微频单元ST、低频单元S1、中频单元S2和高频单元S3五种规格。新增规格测算功能，可根据自身业务的在线设备数和上下行TPS获取推荐的实例规格。 说明： IoTDA标准版实例的规格=实例包含的单元数量*每个单元的规格；
设备请求引导消息 接口功能 设备向发放服务请求对应设备接入实例的引导信息。 Topic 表1 上报Topic说明 Topic $oc/devices/{device_id}/sys/bootstrap/up 消息发送方 设备 消息接收方 设备发放平台 示例 设备向发放服务发送的payload为空。
withCredential(auth) // 标准版/企业版：需自行创建Region对象，基础版：请使用IoTDARegion的region对象，如"withRegion(IoTDARegion.CN_NORTH_4)"
字符串及可变长字符串的编解码插件 数组及可变长数组数据类型 数据上报和命令下发 场景说明 有一款烟感设备，具有如下特征： 具有烟雾报警功能（火灾等级）和温度上报功能。 支持远程控制命令，可远程打开报警功能。比如火灾现场温度，远程打开烟雾报警，提醒住户疏散。 支持上报命令执行结果。 产品模型定义 在烟感产品的开发空间，完成产品模型定义。
表1 topic分类 Topic类别 描述 使用场景 系统Topic 平台预先定义了各种设备和平台通信的Topic，具体Topic列表和功能说明可参考Topic定义。 消息上报、属性上报、命令下发、事件类主题。 自定义Topic 用户可以自定义Topic，设备和平台间可以基于用户自定义的Topic进行通信。
同步或异步 平台是否缓存 支持协议（设备侧） 物模型 消息下发 平台向设备直接下发消息，不依赖产品模型。提供给设备的单向通知，具有消息缓存功能，若设备不在线，则在设备上线后发送数据（支持配置，最长缓存时间24小时）。 设备无法按照产品模型中定义的格式进行指令下发时，可使用此接口下
和其他服务的关系 设备发放服务与其他服务的关系如表1所示。 表1 与其他服务的关系列表 交互功能 相关服务 位置 创建设备时，需要使用设备接入服务创建的产品 设备接入服务（IoT Device Access，IoTDA） 创建产品 创建自定义策略时需要使用函数 函数工作流服务（FunctionGraph）
设备接收引导信息 接口功能 设备接收发放服务下发的引导信息。 Topic 表1 下发Topic说明 Topic $oc/devices/{device_id}/sys/bootstrap/down 消息发送方 设备发放平台 消息接收方 设备 参数说明 表2 下发参数说明 参数 必选/可选
线侧需将应用侧获取到的设备ID逐一烧录到各个设备比较麻烦。 另一种更加高效的方案是，使用设备发放的注册组功能实现设备免注册安全极简地接入物联网平台。 本文基于设备发放注册组功能，使用证书策略，带您快速体验设备免注册安全极简接入物联网平台。 表1 方案对比 设备注册方案 基于单个注册
withCredential(auth) // 标准版/企业版：需自行创建Region对象，基础版：请使用IoTDARegion的region对象，如"withRegion(IoTDARegion.CN_NORTH_4)"
withCredential(auth) // 标准版/企业版：需自行创建Region对象，基础版：请使用IoTDARegion的region对象，如"withRegion(IoTDARegion.CN_NORTH_4)"
509证书即将过期，需要将设备证书进行更新。平台提供了密钥/指纹的重置功能，您可以调用接口重置设备指纹/重置设备密钥进行设备凭证的重置。为避免认证凭据切换过程中，用户未在平台及时重置认证凭据导致设备鉴权失败，出现业务中断，平台推出支持双指纹/双密钥的功能。如在证书认证的场景下，将新证书的指纹设置到设备
备上报到服务端的消息。 MessageDecoder 上行数据的消息解码，将TCP原始码流转换为具体JSON对象。 MessageEncoder 下行数据的消息编码，将对象数据转换为TCP原始码流。 UpLinkHandler 设备上行数据处理类。把TCP协议数据转成平台格式数据，并调用SDK接口进行上报
DA应用侧接口与SL651协议的终端设备进行交互。 使用限制 遵循的协议版本：水文监测数据通信规约SL651-2014。 支持的SL651功能码类型：链路维持报（2FH）、遥测站定时报（32H）、遥测站加报报（33H）、遥测站小时报 （34H）。 支持的传输协议类型：TCP协议。
设备命令下发 LwM2M对象资源 物联网平台向设备设备异步命令，物联网平台通过LwM2M的/19/1/0资源对象将命令打包到LwM2M write消息的payload里下发给设备。 Operation CoAP Method URI Success Failure Write PUT
设备上报日志内容 Topic 上行: $oc/devices/{device_id}/sys/events/up 接口功能 日志收集开关开启时设备使用该接口向平台上报日志内容，最大不超过1MB。 参数说明 字段名 必选/可选 类型 参数描述 services 可选 List<ServiceEvent>
平台消息下发 功能介绍 设备无法按照产品模型中定义的格式进行指令下发时，可使用此接口下发自定义格式的数据给设备。在此之上也可以使用平台封装的标准格式，即在应用侧API的下发设备消息中payload_format填写为“standard”，或者在设备详情页的云端下发-消息下发中下发时选择“按系统格式”。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
