昇腾社区首页
中文
注册

软件包规格

本章以边缘管理系统软件包名称om-sdk.tar.gz为例,介绍如何构建自定义软件包。

OM SDK支持用户按照相应的规格,为进行过二次开发的软件构建安装包;同时OM SDK为自身安装包和其他自定义固件提供了通用的升级通道,支持开发者按照本章节指导构建通用升级包。OM SDK构建的软件包会包含以下文件信息。
表1 文件信息

文件名称

文件说明

om-sdk.tar.gz

软件包名称。用户可以自定义升级包名称,但是格式必须为tar.gz。

vercfg.xml

软件包完整性校验文件。

version.xml

版本信息配置文件。

vercfg.xml.cms

对应文件的签名文件及吊销列表。

vercfg.xml.crl

version.xml.cms

version.xml.crl

om-sdk.tar.gz.cms

om-sdk.tar.gz.crl

用户需要自行准备相关文件且文件名称需要与表2中文件名称保持一致。

表2 边缘管理系统软件包中文件

文件名称

文件说明

bin

边缘管理系统软件运行与使用的必要文件

config

lib

scripts

software

tools

install.sh

边缘管理系统安装脚本

uninstall.sh

边缘管理系统卸载脚本

upgrade.sh

边缘管理系统升级脚本

version.xml

版本信息配置文件

关键文件说明

  • vercfg.xml文件示例如下。
    <?xml version="1.0" encoding="utf-8"?>
    <Package>
        <File>
            <FilePath>version.xml</FilePath>
            <SHAValue>a28ed14f3bf81b7274ce090efd28dd2bf5313fd8e48809e4cdef27186d6ba654</SHAValue>
        </File>
        <File>
            <FilePath>om-sdk.tar.gz</FilePath>
            <SHAValue>5a51030d5e7aead7e4c47408f9af11b4ff59bde0fc801b1290977b0e28322a04</SHAValue>
        </File>
    </Package>
    表3 参数说明

    参数名称

    说明

    FilePath

    表示升级包中文件名,需要带文件格式后缀,取值为version.xml和sdk-upgrade.tar.gz。

    SHAValue

    表示FilePath字段对应文件的sha256值,可通过sha256sum命令获取。

  • version.xml文件示例如下:
    <?xml version="1.0" encoding="utf-8"?>
    <FirmwarePackage version="V1">
    <!--Upgrade packages description-->
        <Package>
            <FileName>omsdk.zip</FileName>
            <OutterName>MindXOM</OutterName>
           <Version>SDK-omsdk 1.0</Version>             
            <FileType>Firmware</FileType>
           <Module>SDK-omsdk</Module>                 
            <Vendor>Huawei Technologies Co., Ltd</Vendor>
            <MaxUpgradeTime>3600</MaxUpgradeTime>
            <!--UpgradeTimeout:unit second-->
            <ActiveMode>ResetOS</ActiveMode>
            <MaxActivetime>600</MaxActivetime>
            <SupportModel>Atlas 200I A2</SupportModel>
            <ProcessorArchitecture>ARM</ProcessorArchitecture>
            <UpgradeAgent>OM</UpgradeAgent>
        </Package>
    </FirmwarePackage>
    表4 参数说明

    参数名称

    说明

    Version

    软件包版本,可在构建软件包时进行配置

    Module

    软件包的固件类型,可在构建软件包时进行配置

    Vendor

    厂商信息,可在构建软件包时进行配置

    FileName

    软件包名称,可在构建软件包时进行配置

    OutterName

    边缘管理系统软件正常运行的必要配置,不可配置与修改

    FileType

    MaxUpgradeTime

    ActiveMode

    MaxActivetime

    SupportModel

    ProcessorArchitecture

    UpgradeAgent