软固件包上传

概述

软件（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服务侧设置或修改存储桶配置为启用“默认加密”时，会影响升级文件的下载。

     图1 上传升级包-OBS文件
     
   • 本地文件，请拖拽或者单击“添加文件”上传软固件升级包。
     图2 上传升级包-本地文件
     

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

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

   参数名称	说明
   固件(软件)版本	固件(软件)包的版本。（设备升级完成后需要上报升级版本号，平台检查设备上报的版本号是否与此参数一致，一致为升级成功。）
   选择产品	选择对应设备的产品模型。
   支持设备源版本	支持升级的设备的源版本号。手动输入，如需输入多个，可以在输入完一个版本后，单击“回车”按键，再输入下一个。 说明： 平台目前暂不支持自动差分升级包的功能，用户可以自己本地差分后上传到平台，并对不同的差分包指定不同的支持升级的设备源版本号。在创建升级任务时可以选择多个差分包创建升级任务。在软固件升级过程中，平台将根据设备上报的源版本号，下发不同的差分包。
   软件包分片大小	终端下载软件包的每个分片的大小，单位为byte。取值范围：32~500，默认值500。只有NB协议的设备软件升级支持该功能。
   描述	软固件包的描述信息。
   推送给设备的自定义信息	平台下发升级通知时，会同时下发该自定义信息给设备端。

   

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