设备管理 IoTDM(联通用户专用)-软件升级(联通用户专用):制作软件升级版本包

时间:2023-11-01 16:20:05

制作软件升级版本包

设备升级的软件包文件由各设备厂商提供,在物联网平台上传设备的软件升级包前,需要制作软件升级的版本包,用于修改软件包的描述文件,如软件版本、厂商名称、设备类型、产品模型等信息。下面将详细介绍版本包的制作方法。

  1. 新建文件夹命名为“DM”,在DM文件夹下新建文件夹,命名为“linux”。
  2. 使用Notepad++文本工具新建一个文本文件,拷贝如下内容到文本中,在Notepad++工具的“编码”菜单中选择“使用UTF-8编码”,然后将文本进行存储,存储路径选择步骤1中的“linux”文件夹,文件名称命名为“UpgradeDesc”,保存类型选择“.json”。

    {    "specVersion": "",    "fileName": "",    "packageType": "",    "version": "",    "deviceType": "",    "manufacturerName": "",    "model": "",    "protocolType":"",    "description":"",    "versionCheckCode":"",    "deviceShard":"",    "platform":"",    "supportSourceVersionList":[],    "date":""}

  3. 打开创建的“UpgradeDesc.json”文件,修改软件升级描述文件,相关字段如下表所示。

    字段名

    字段描述

    是否必填

    specVersion

    描述文件版本号,固定值:“1.0”。

    fileName

    软件包文件名,例如:“ExamplePackage_V1.0.10.xx”。

    packageType

    软件包类型,必须设置为:“softwarePackage”。

    version

    软件包版本号长度不超过16个字节,例如:“V1.0.10”

    deviceType

    设备类型,需要与产品模型保持一致。例如:“WaterMeter”。

    manufacturerName

    制造商名称,需要与产品模型保持一致。例如:“TestUtf8ManuName”。

    model

    产品型号,需要与产品模型保持一致。例如:“TestUtf8ModelM2M”。

    protocolType

    设备接入协议类型,需要与产品模型保持一致。例如:“CoAP”。

    说明:

    设备接入的协议类型有三种:“CoAP”、“LWM2M”、“MQTT”。

    description

    对软件包的自定义描述。

    versionCheckCode

    软件升级包校验码,长度为4个字符。软件包下载时支持断点续传,根据该字段标识前后两次下载的软件包分片是否为同一个软件包。

    deviceShard

    终端下载软件包的每个分片的大小,单位为byte,如果不设置默认为500byte。大小为32~500之间。

    platform

    标识设备的操作系统,如linux。

    supportSourceVersionList

    支持用于升级此版本包的设备源版本列表。

    支持通配符配置,*代表匹配任意0~n个字符,?代表匹配单个任意字符,如果存在多个版本,请使用英文“;”隔开。

    date

    出包时间,格式为:“yyyy-MM-dd”。

  4. 在与“DM”同级目录下创建文件夹,命名为“linux”,该文件夹名称必须同步骤1中的文件夹命令保持一致,将厂商软件包(软件包格式无限制)置于该文件中。

  5. 选中“DM”和“linux”文件夹,使用压缩工具打包成ZIP格式的压缩包,建议命令为“xx_package.zip”。

    • 文件“DM”和“linux”的命名是固定的。

    • “xx_package.zip”下不能包含package这层目录。

    • 仅支持ZIP格式的压缩包,不能压缩成其他格式后,例如rar,再手动修改文件类型为zip。

support.huaweicloud.com/devg-IoT/iot_02_9983.html