设备管理 IoTDM(联通用户专用)-软件升级(联通用户专用):制作软件升级版本包
制作软件升级版本包
设备升级的软件包文件由各设备厂商提供,在 物联网平台 上传设备的软件升级包前,需要制作软件升级的版本包,用于修改软件包的描述文件,如软件版本、厂商名称、设备类型、产品模型等信息。下面将详细介绍版本包的制作方法。
- 新建文件夹命名为“DM”,在DM文件夹下新建文件夹,命名为“linux”。
- 使用Notepad++文本工具新建一个文本文件,拷贝如下内容到文本中,在Notepad++工具的“编码”菜单中选择“使用UTF-8编码”,然后将文本进行存储,存储路径选择步骤1中的“linux”文件夹,文件名称命名为“UpgradeDesc”,保存类型选择“.json”。
{ "specVersion": "", "fileName": "", "packageType": "", "version": "", "deviceType": "", "manufacturerName": "", "model": "", "protocolType":"", "description":"", "versionCheckCode":"", "deviceShard":"", "platform":"", "supportSourceVersionList":[], "date":""}
- 打开创建的“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”。
否
- 在与“DM”同级目录下创建文件夹,命名为“linux”,该文件夹名称必须同步骤1中的文件夹命令保持一致,将厂商软件包(软件包格式无限制)置于该文件中。
- 选中“DM”和“linux”文件夹,使用压缩工具打包成ZIP格式的压缩包,建议命令为“xx_package.zip”。