更新时间:2024-06-11 GMT+08:00

软固件包上传

概述

软件(Software)一般分为系统软件和应用软件,系统软件实现设备最基本的功能,比如编译工具、系统文件管理等;应用软件可以根据设备的特点,提供不同的功能,比如采集数据、数据分析处理等。软件升级又称为SOTA(SoftWare Over The Air),是指用户可以通过OTA的方式支持对LwM2M协议和MQTT协议的设备进行软件升级。

  • 基于LwM2M协议的产品模型,软件升级遵循的协议为PCP协议(PCP协议介绍),设备侧需要遵循PCP协议进行软件升级的适配开发,适配方法请参考设备侧适配开发指导
  • 基于MQTT协议的产品模型,不校验软件升级协议类型。

固件(Firmware)一般是指设备硬件的底层“驱动程序”,承担着一个系统最基础最底层工作的软件,比如计算机主板上的基本输入/输出系统BIOS(Basic Input/output System)。固件升级又称为FOTA(Firmware Over The Air),华为云用户可以通过OTA的方式对支持LwM2M协议和MQTT协议的设备进行固件升级。

操作步骤

华为物联网平台进行软固件升级,需要在console平台添加升级包。平台支持升级包关联OBS服务桶中对象和本地文件上传升级包两种方式。

  • 升级包关联OBS服务桶中对象,升级包大小限制最大为1G,由于升级文件保存在OBS服务中,会产生额外的存储和下载费用。

    OBS计费项由存储费用、请求费用、流量费用、数据恢复费用和数据处理费用组成。计费模式分为按需计费和包年包月。具体费用请参考OBS计费说明

    例如:在华北-北京四区域下,用户一个月需要升级1万设备,升级包的大小为100M,如果按需计费,则需要存储费用¥0.139,流量费用¥512,请求次数费用¥0.01,总计¥512.15。

    如果包年包月,则需要存储费用¥1.00,流量费用¥505.00(1TB 公网流出流量包1个月价格),请求次数费用¥0.01,总计¥506.01。

  • 本地文件上传升级包的方式,不收取费用,但是升级包大小限制最大为20M。
  • 升级包只支持.bin、.dav、.tar、.gz、.zip、.gzip、.apk、.tar.gz、.tar.xz、.pack、.exe、.bat、.img格式的文件。
  1. 访问设备接入服务,单击“管理控制台 ”进入设备接入控制台。
  2. 选择设备 > 软固件升级
  3. 上传固件升级包时,选择“固件列表”页签,单击“上传固件”,上传软件升级包时,选择“软件列表”页签,单击“上传软件”。
  4. 在上传升级包界面,选择上传方式OBS文件或者本地文件

    • OBS文件,使用前请单击“访问授权”弹出授权窗口后单击“同意授权”。授权后请选择升级文件所在的桶。如果暂时还没有创建桶,可以单击“创建桶”跳转到OBS页面创建桶。如果没有上传升级文件到对应的桶,可以单击“前往OBS上传对象”跳转到OBS对应桶页面上传升级文件。勾选需要的OBS对象后单击按钮“下一步”。

      如果设备接入服务未访问授权密钥管理服务(KMS),请单击“加密服务授权”处的“访问授权”进行授权访问,否则在OBS服务侧设置或修改存储桶配置为启用“默认加密”时,会影响升级文件的下载。

    • 本地文件,请拖拽或者单击“添加文件”上传软固件升级包。

  5. 选择OBS对象或上传本地文件后,在升级包列表里面按照如下信息填写参数后,单击“确定”上传软件包。

    在上传软固件包时,需要填写如下信息:

    参数名称

    说明

    固件(软件)版本

    固件(软件)包的版本。(设备升级完成后需要上报升级版本号,平台检查设备上报的版本号是否与此参数一致,一致为升级成功。)

    选择产品

    选择对应设备的产品模型

    支持设备源版本

    支持升级的设备的源版本号。手动输入,如需输入多个,可以在输入完一个版本后,单击“回车”按键,再输入下一个。

    说明:

    平台目前暂不支持自动差分升级包的功能,用户可以自己本地差分后上传到平台,并对不同的差分包指定不同的支持升级的设备源版本号。在创建升级任务时可以选择多个差分包创建升级任务。在软固件升级过程中,平台将根据设备上报的源版本号,下发不同的差分包。

    软件包分片大小

    终端下载软件包的每个分片的大小,单位为byte。取值范围:32~500,默认值500。只有NB协议的设备软件升级支持该功能。

    描述

    软固件包的描述信息。

    推送给设备的自定义信息

    平台下发升级通知时,会同时下发该自定义信息给设备端。

    • 平台已经下线上传签名软固件包功能,之前已经上传的签名软固件包能正常升级使用。为了保障您能够正常使用软固件升级功能,请直接上传需要下发给设备的升级文件。
    • 只有MQTT协议设备支持使用OBS文件作为软固件升级包,且需要在设备侧适配新的event_type
    • 升级包如果不指定支持设备源版本,则软固件升级时将对所有选择的设备进行升级。