检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
请通过模组日志检查设备侧。 在设备接入服务上传固件包时需要填写的支持设备源版本是什么？ 图1 OTA升级-上传固件样例 源版本就是设备当前版本是源版本中的一个，才允许升级。设备的当前版本号可以在控制台的“设备 > 所有设备 > 查看”中获取。 在软/固件升级任务中，业务处理是否会中断？ 会中断
代码开发 准备工作 开发环境要求：已经安装JDK（版本1.8.以上）和maven。 已下载泛协议SDK和样例。 项目结构说明 项目结构说明 图1 项目结构图 表1 类相关说明 类名称 描述 Main 主启动类。 BridgeService 网桥初始化：初始化同IoT平台的连接，设置平台下行数据监听
平台向设备下发查询设备软件版本号的命令，查询成功后，物联网平台根据升级的目标版本判断设备是否需要升级 。（第5步超时时间3分钟） 如果返回的软件版本信息与升级的目标版本信息相同，则升级流程结束，不做升级处理，升级任务置为成功。 如果返回的软件版本信息与升级的目标版本信息不同，且该
平台通知网关子设备删除 功能介绍 平台将该网关删除的子设备信息通知给网关设备。网关与子设备关系，请查看网关与子设备。 Topic 下行: $oc/devices/{device_id}/sys/events/down 参数说明 字段名 必选/可选 类型 参数描述 object_device_id
marker 否 String 参数说明：上一次分页查询结果中最后一条记录的ID，在上一次分页查询时由物联网平台返回获得。分页查询时物联网平台是按marker也就是记录ID降序查询的，越新的数据记录ID也会越大。若填写marker，则本次只查询记录ID小于marker的数据记录。若不填写
的交互，转换为IoTDA产品中定义的属性、命令等，用户可通过IoTDA应用侧接口与HJ212协议的终端设备进行交互。 使用限制 遵循的协议版本：HJ 212-2017，国家地表水自动监测系统通信协议技术要求（修改升级版）。 支持的消息类型：心跳包（9015）、上传测量数据（2061）。
设备的交互，转换为IoTDA产品中定义的属性、命令等，用户可通过IoTDA应用侧接口与JT808协议的终端设备进行交互。 约束 遵循的协议版本为JT/T 808-2019。 支持的消息类型为终端管理、位置类、电子围栏、实时音视频、历史视频、文本信息等。 支持的传输协议为TCP协议。
字段名 必选/可选 类型 参数描述 version 可选 Long 参数解释： 子设备信息版本。网关设备收到的最近一次的子设备新增或删除通知时的子设备版本信息。平台会根据此版本信息将此版本后新增或者删除的子设备信息通知给网关设备。 示例 Topic: $oc/devices/{d
创建升级任务时，可以选择多个升级包（最多10个），选择的升级包必须满足支持的源版本没有重复。如果某个升级包没有指定支持源版本，则默认该升级包支持所有源版本设备升级。 任务创建成功后可以在任务列表中查询到该任务，单击详情可以查看当前任务详情。在任务详情页面可以批量停止（一次最多100个设备）或
IoTDA提供了多个维度的监控运维能力，包括设备消息跟踪，查看报表，告警管理以及设备异常检测，方便用户实时掌握所有接入IoTDA的设备信息。 设备消息跟踪：在设备鉴权，命令下发，数据上报，平台数据转发等业务场景发生故障时，可以通过消息跟踪进行快速定位和原因分析。 查看报表：IoTDA为用户提供了丰富的报
软/固件升级业务热点咨询问题如下，更多咨询问题请访问查看更多。 目标版本可以比当前版本低吗？ 软/固件包及其版本号如何获取？ 在软/固件升级任务中，业务处理是否会中断？ 常见的软/固件升级错误有哪些？ 相关API接口 创建批量任务 查询批量任务列表 查询批量任务 父主题： OTA升级
product_id 可选 String 参数解释： 产品ID。 fw_version 可选 String 参数解释： 固件版本。 sw_version 可选 String 参数解释： 软件版本。 status 可选 String 参数解释： 设备在线状态。 取值范围： ONLINE：设备在线。 OFFLINE：设备离线。
+ param); //初始化gson。 版本为com.google.code.gson：gson:2.8.6 Gson gson = new Gson(); //初始化httpClient，版本为org.apache.httpcomponents:httpclient:4
查询产品 功能介绍 应用服务器可调用此接口查询已在物联网平台的创建的指定产品模型详细信息，包括产品模型的服务、属性、命令等。 调用方法 请参见如何调用API。 URI GET /v5/iot/{project_id}/products/{product_id} 表1 路径参数 参数
查询设备消息 功能介绍 应用服务器可调用此接口查询平台下发给设备的消息，平台为每个设备默认最多保存20条消息，超过20条后， 后续的消息会替换下发最早的消息。 调用方法 请参见如何调用API。 URI GET /v5/iot/{project_id}/devices/{device_id}/messages
起始标识，固定为0XFFFE。 版本号 BYTE 高四位预留；低四位表示协议版本号，当前为1。 消息码 BYTE 标识物联网平台与设备之间的请求消息类型，应答消息的消息码和请求消息相同。消息码的定义为： 0-18：预留消息码，暂未使用。 19：查询设备版本。 20：下载新版本软件包通知。 21：请求下载升级包。
参数说明：升级包版本号。 取值范围：长度不超过256，只允许字母、数字、下划线（_）、连接符（-）、英文点（.）的组合。 support_source_versions Array of strings 参数说明：支持用于升级此版本包的设备源版本号列表。最多支持20个源版本号。 取值范
STRING 字符串 查询设备版本号 从设备的软件升级流程（本流程只描述物联网平台与设备基于PCP协议交互的流程）可以看到，首先物联网平台向设备下发查询版本号信息，设备进行应答。 物联网平台发送消息 根据PCP消息结构的定义可以得出，物联网平台向设备下发查询版本号时，各消息字段的填写如下：
查询设备隧道 功能介绍 用户可通过该接口查询某项目中的某个设备隧道，查看该设备隧道的信息与连接情况。应用服务器可调用此接口向平台查询设备隧道建立情况。 该API接口在基础版不支持。 具体应用可见“设备远程登录”功能，请参见设备远程登录。 调用方法 请参见如何调用API。 URI GET
网关批量设备属性上报 功能介绍 用于批量设备上报属性数据给平台。网关设备可以用此接口同时上报多个子设备的属性数据。网关与子设备关系，请查看网关与子设备。 属性上报和消息上报的区别，请查看消息通信说明。 网关批量设备属性上报，单批次最多可上报100个子设备的属性数据。如果子设备数量超过100个，建议分不同批次进行上报。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
