检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
IoT Device SDK使用指南（Go社区版） Go语言版的SDK提供了跟平台基础的通信能力，由开源社区提供，如果使用有问题请在github上提issue。 父主题： 使用IoT Device SDK接入
timeout Integer 参数说明：设备接入的有效时间，单位：秒，默认值：0 若设备在有效时间内未接入物联网平台并激活，则平台会删除该设备的注册信息。若设置为“0”，则表示平台不会删除该设备的注册信息（建议填写为“0”）。 注意：该参数只对直连设备生效。 表5 TagV5DTO 参数
rap/down 消息发送方 设备发放平台 消息接收方 设备 参数说明 表2 下发参数说明 参数 必选/可选 类型 描述 address 必选 String 对应设备接入实例的接入地址。 initConfig 必选 String 客户在创建设备，或者创建注册组时自定义的初始化Json字符串。
确认设备订阅下行topic是否正确（需订阅成功后才可调用接口，不订阅，设备收不到平台消息），详细请参考平台命令下发接口文档。 若设备有收到平台下发的消息，确认设备上行topic及消息体是否正确，且必须在收到平台消息20s内（消息接口不限定20s），通过上行topic向平台发送，否则接口报错（request_id为下行消息中携带）。
下发广播消息 功能介绍 应用服务器可调用此接口向订阅了指定Topic的所有在线设备发布广播消息。应用将广播消息下发给平台后，平台会先返回应用响应结果，再将消息广播给设备。 注意： 此接口只适用于使用MQTT协议接入的设备。 调用方法 请参见如何调用API。 URI POST /v
设备上报配置结果响应。创建远程配置任务时，可以配置超时时间（1-30天，不配置默认30天）。在超时时间内，平台每24小时向设备下发一次配置，直到设备上报配置响应。如果设备在超时时间内一直没有上报配置响应，则平台显示该设备配置任务超时失败。 Topic 上行: $oc/devices/{device_id}/sys/events/up
使用自定义Topic管理室内空调 场景说明 自定义Topic功能用于MQTT协议设备接入物联网平台的场景，支持设备消息上报、平台消息下发的Topic进行自定义。根据Topic不同，应用侧可实现不同的业务逻辑处理，也适用于应用侧和设备侧之间，设备无法按照产品模型中定义的属性上报或命令下发的场景。
批量任务状态变更通知 功能介绍 应用服务器在调用物联网平台创建规则触发条件（Resource:batchtask，Event:update）、创建规则动作、修改规则触发条件接口配置并激活规则后，当批量任务状态变更时，物联网平台会向应用服务器推送通知消息。 URI POST /由应
通过调用注册接口向物联网平台发送注册请求或者在控制台上注册设备。 注册时需要填写设备标识码，通常使用MAC地址，Serial No或IMEI作为nodeId。 物联网平台向设备分配全局唯一的设备ID （deviceId）和密钥（secret）。 密钥可以在注册设备时自定义，如果没有定义，平台将自动分配密钥。
l.zip，导入后如下所示。 图2 模型定义-HJ212 在IoTDA平台注册设备 IoTDA平台通过设备ID标识设备。在HJ212场景中，使用HJ212消息中的MN字段作为设备ID，使终端设备与IoTDA平台的设备相对应。PW字段作为密钥和确认密钥。 建议设备标识码与设备ID相同。
ApplicationDTO 参数 参数类型 描述 app_id String 资源空间ID，唯一标识一个资源空间，由物联网平台在创建资源空间时分配。资源空间对应的是物联网平台原有的应用，在物联网平台的含义与应用一致，只是变更了名称。 app_name String 资源空间名称。 create_time
响应Body参数 参数 参数类型 描述 app_id String 资源空间ID，唯一标识一个资源空间，由物联网平台在创建资源空间时分配。资源空间对应的是物联网平台原有的应用，在物联网平台的含义与应用一致，只是变更了名称。 app_name String 资源空间名称。 create_time
必选 类型 位置 说明 tunnel_access_token 是 String Header 参数说明: 设备接入隧道Token。创建设备隧道时，平台通过mqtt topic下发。 取值范围: 长度1-256。 tunnel_id 是 String Path 参数说明: 隧道ID，用于唯一标识一个隧道。
必选 类型 位置 说明 tunnel_access_token 是 String Header 参数说明: 设备接入隧道Token。创建设备隧道时，平台通过mqtt topic下发。 取值范围: 长度1-256。 tunnel_id 是 String Path 参数说明: 隧道ID，用于唯一标识一个隧道。
String 参数说明：产品ID，资源空间下唯一。用于资源空间下唯一标识一个产品。如果携带此参数，平台将产品ID设置为该参数值；如果不携带此参数，产品ID在物联网平台创建产品后由平台分配获得。 取值范围：长度不超过36，只允许字母、数字、下划线（_）、连接符（-）的组合。 name
面，查看连接参数。详情可见使用Mqtt.fx调测。 图4 设备-设备详情 图5 设备-设备详情-MQTT连接参数 使用MQTT.fx连接云平台。打开MQTT.fx软件，配置上述策略绑定的设备的鉴权参数，然后单击“Apply”保存，单击“Connect”进行连接鉴权。 订阅允许的t
重置设备密钥 功能介绍 应用服务器可调用此接口重置设备密钥，携带指定密钥时平台将设备密钥重置为指定的密钥，不携带密钥时平台将自动生成一个新的随机密钥返回。 调用方法 请参见如何调用API。 URI POST /v5/iot/{project_id}/devices/{device_id}/action
应用； 设备已集成物联网平台官方SDK(IoT Device SDK C v1.1.1及以后版本），请参考（IoT Device SDK（C）使用指南）； 设备已在线。 使用限制 远程连接基于SSH技术实现，物联网平台仅为设备建立SSH服务通道，远程控制台具体支持的管理能力，需您自己在设备端开发。
参数说明：项目ID app_id 是 String 参数说明：资源空间ID，唯一标识一个资源空间，由物联网平台在创建资源空间时分配。资源空间对应的是物联网平台原有的应用，在物联网平台的含义与应用一致，只是变更了名称。 取值范围：长度不超过36，只允许字母、数字、下划线（_）、连接符（-）的组合。
设备上报获取文件下载URL请求 功能介绍 设备上报获取文件下载URL信息请求到平台。 Topic 上行: $oc/devices/{device_id}/sys/events/up 参数说明 字段名 必选/可选 类型 参数描述 object_device_id 可选 String
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
