软固件升级调测 固件升级（联通用户专用） 软件升级（联通用户专用） 父主题： 设备侧开发

查看更多 →

创建固件升级任务 典型场景 若需要对设备进行固件版本升级，第三方应用可调用此接口为多个设备创建固件升级任务，升级前请确保目标版本包已上传到物联网平台。当前仅支持对NB-IoT设备进行固件版本升级。 接口功能 支持第三方应用在物联网平台为多个设备进行固件版本升级，当前仅支持对NB-IoT设备进行固件版本升级。

查看更多 →

设备上报软固件版本 功能介绍 设备上报软固件版本信息。 Topic 上行: $oc/devices/{device_id}/sys/events/up 参数说明 字段名 必选/可选 类型 参数描述 object_device_id 可选 String 网关设备上报时，子设备进行上

查看更多 →

第三方应用在物联网平台订阅了固件升级状态变更通知后（订阅的通知类型为fwUpgradeStateChangeNotify），当设备进行固件升级，升级任务的状态发生变化时，平台会向第三方应用推送通知消息。支持物联网平台向订阅了固件升级状态变更通知的第三方应用推送通知消息。应用在订阅平台管理数据时需要订阅接口描述中的指定回调地址，回调地址中的

查看更多 →

务。在设备固件出现安全漏洞、软件bug维护、自身功能优化、以及设备性能改良等需更新固件时，在线升级功能就尤为重要。本文档通过MQTT.fx模拟固件设备，使用华为云平台对该固件进行设备升级。 软件升级流程和固件升级流程一样，只是在设备上报版本号时对应参数字段不一样。固件升级上报版本

查看更多 →

断点续传下载 当下载大对象到本地文件时，经常出现因网络不稳定或程序崩溃导致下载失败的情况。失败后再次重新下载不仅浪费资源，而且当网络不稳定时仍然有下载失败的风险。断点续传下载接口能有效地解决此类问题引起的下载失败，其原理是将待下载的对象分成若干个分段分别下载，并实时地将每段下载结

查看更多 →

EnableCheckpoint 是否开启断点续传模式，默认为false，表示不开启。 CheckpointFile 记录上传进度的文件，只在断点续传模式下有效。当该值为空时，默认与待上传的本地文件同目录。 EnableCheckSum 是否校验待上传文件的内容，只在断点续传模式下有效。默认为false，表示不校验。

查看更多 →

TaskNum 分段下载时的最大并发数，默认为20。 EnableCheckpoint 是否开启断点续传模式，默认为false，表示不开启。 CheckpointFile 记录下载进度的文件，只在断点续传模式下有效。当该值为空时，默认与下载对象的本地文件路径同目录。 VersionId 对象的版本号。

查看更多 →

version String 升级的固件版本 status Integer 固件升级状态，1:升级中 2:升级失败 3:升级成功 progress String 固件升级进度，用数字0-100表示 cause String 固件升级失败原因 请求示例 获取固件升级进度 GET http

查看更多 →

String body 固件升级任务ID。 subOperationId 必选 String body 固件升级子任务ID。 curVersion 必选 String body 设备当前的固件版本。 targetVersion 必选 String body 设备要升级的目标固件版本。 sourceVersion

查看更多 →

创建固件升级任务 典型场景 若需要对设备进行固件版本升级，第三方应用可调用此接口为多个设备创建固件升级任务，升级前请确保目标版本包已上传到物联网平台。当前仅支持对NB-IoT设备进行固件版本升级。 接口功能 支持第三方应用在物联网平台为多个设备进行固件版本升级，当前仅支持对NB-IoT设备进行固件版本升级。

查看更多 →

操作前必读 只有“在线”状态的设备才能执行升级固件版本的操作。 当“设备列表”中，“固件版本”显示为“可升级”时，表示存在更新版本的固件，您可以选择版本进行升级。 在执行升级固件操作时，设备无法执行其他操作。 图1 升级固件版本的要求 升级固件版本 在管理控制台左侧菜单栏选择“设备管理

查看更多 →

OM维护 ”下，确认“固件升级”功能已开启。 上传固件包 选择“产品 > 升级调试 > 升级包管理 > 固件包管理”，点击“上传未签名固件包”。 根据固件包上传向导，完成固件包上传。 选择产品，点击“下一步”。 因为固件包中只包含用于固件升级的bin文件，开发中心无法从固件包直接获取产品

查看更多 →

软/固件升级是升级什么？ 软件升级指升级设备的系统软件和应用软件，固件升级指升级设备硬件的底层“驱动程序”。 升级方式均为将软/固件包上传到物联网平台，设备从物联网平台获取软/固件包实现远程升级。 父主题： 软/固件升级（联通用户专用）

查看更多 →

Function 可选 获取取消断点续传控制参数的回调函数。 说明： 该回调函数有一个参数：取消断点续传下载任务控制参数； 可以调用取消断点续传下载任务控制参数的cancel方法来暂停断点续传下载任务。 EnableCheckpoint Boolean 可选 是否开启断点续传模式，默认为false，表示不开启。

查看更多 →

Function 可选 获取取消断点续传控制参数的回调函数。 说明： 该回调函数有一个参数：取消断点续传上传任务控制参数； 可以调用取消断点续传上传任务控制参数的cancel方法来暂停断点续传上传任务。 EnableCheckpoint Boolean 可选 是否开启断点续传模式，默认为false，表示不开启。

查看更多 →

}catch (ObsException e) { // 发生异常时可再次调用断点续传上传接口进行重新上传 } 断点续传上传接口是利用分段上传特性实现的，是对分段上传的封装和加强。 断点续传上传接口不仅能在失败重传时节省资源提高效率，还因其对分段进行并发上传的机制能加快上传

查看更多 →

断点续传上传 当上传大文件时，经常出现因网络不稳定或程序崩溃导致上传失败的情况。失败后再次重新上传不仅浪费资源，而且当网络不稳定时仍然有上传失败的风险。断点续传上传接口能有效地解决此类问题引起的上传失败，其原理是将待上传的文件分成若干个分段分别上传，并实时地将每段上传结果统一记录

查看更多 →

并发上传的实现等内部细节。 enable_check_point参数：0代表不启用断点续传模式，此时断点续传上传接口退化成对分段上传的简单封装，不会产生checkpoint文件，1代表启用断点续传模式。 父主题： 上传对象

查看更多 →

enable_check_point int 必选 是否开启断点续传模式，默认为0，表示不开启。 check_point_file char * 必选 记录下载进度的文件，只在断点续传模式下有效。当该值为空时，默认与下载对象的本地文件路径同目录。 以下代码展示了如何使用断点续传下载接口下载对象到本地文件： void

查看更多 →

UploadPartSize EnableCheckpoint 是否开启断点续传模式，默认为false，表示不开启。 UploadFileRequest.EnableCheckpoint CheckpointFile 记录上传进度的文件，只在断点续传模式下有效。当该值为空时，默认与待上传的本地文件同目录。

查看更多 →