下载
中文
注册

相关工具

upgrade-tool工具不支持容器场景,部署容器时,禁止将upgrade-tool工具映射到容器内。

  1. 登录Host侧的服务器
  2. 切换到软件包所在安装路径,根据以下表格中的命令调用工具,如下以Driver采用默认安装路径为例进行说明。
    表1 相关工具

    功能描述

    执行命令

    参数

    upgrade-tool工具可以查看固件版本、升级单个或多个固件等,只允许root用户执行。

    请切换到“/var/davinci/driver”路径执行命令。

    查看帮助信息:

    ./upgrade-tool --help

    --help:查看帮助信息。

    列举所有Device:

    ./upgrade-tool --mini_devices

    --mini_devices:所有设备列表。

    启动固件主备同步:

    ./upgrade-tool --sync

    --sync:启动固件主备同步。

    须知:

    在使能主备分区功能的系统中,若主备分区中安装的驱动版本不一致,执行此命令后会导致其中一个分区出现固件与驱动不兼容的现象,严重时会导致此分区无法正常使用。

    获取指定设备的版本:

    ./upgrade-tool --device_index <dev_id> --system_version

    • --device_index:设备编号。取值只能是0和-1,0表示对应编号的设备。-1表示所有设备。
    • --system_version:系统版本。

    获取指定设备的组件信息:

    ./upgrade-tool --device_index <dev_id> --components

    --components:列举所有有效的组件。

    查询设备状态:

    ./upgrade-tool --device_index <dev_id> --status

    --status:设备状态。支持的设备状态具体包含:
    • idle:空闲。
    • upgrading:正在升级。
    • not support:不支持。
    • failed:失败。
    • waitting_restart:等待重启。
    • waitting_sync:等待固件同步。
    • synchronizing:正在同步。
    • wrong status:错误状态。

    查询某个设备中某一个组件对应的版本:

    ./upgrade-tool --device_index <dev_id> --component <type> --version

    • --component:指定具体的组件。查询和升级单个组件时,需要指定组件名称(hboot1a、hboot1b、hboot2、ddr、hsm、hlink、Sys_Base_Config、atf、Usr_Base_Config)。查询和升级所有组件时,需要输入-1。
    • --version:组件的版本。

    异步升级指定设备的固件包(暂不支持):

    ./upgrade-tool --device_index <dev_id> --component <type> --async --path <firmware_path>

    --async必须紧跟在component <type>后面

    --async:支持异步升级,即device侧收到host侧发送的升级请求后,返回请求成功响应到host侧(具体固件是否升级成功,需要通过“--status”参数去查询)。暂不支持。

    查看所有分区的固件版本:

    ./upgrade-tool --device_index <dev_id> --component <type> --all --version

    --all --version:查看所有分区(Flash分区、主备分区)的固件版本。

    查询算力功率等级(暂不支持):

    ./upgrade-tool --device_index <dev_id> --component <type> --level

    --level:查询算力功率等级,暂不支持。

    • 指定组件的flash区域进行升级:

      ./upgrade-tool --device_index <dev_id> --component <type> --path <firmware_path>

    • 指定组件的主备区域进行升级:

      ./upgrade-tool --device_index <dev_id> --component <type> --media --mmc --<main/backup> --path <firmware_path>

    • --path:指定组件对应的路径。若升级单个组件,例如AS310B_HBOOT1_a.bin,以Ascend-hdk-310b-npu-firmware-soc_x.x.x.x.X.run包解压到“/opt/tmp”目录下为例:则为--path /opt/tmp/firmware/image/AS310B_HBOOT1_a.bin
    • --media --mmc:指定组件的主备区域进行升级。flash和主备区域组件介绍详细请参见组件分区介绍

      需确保所有组件升级后版本一致。

    指定组件的recover区主备区域进行升级:

    ./upgrade-tool --device_index <dev_id> --component <type> --media --mmc --recover --<main/backup> --path <firmware_path>

    --recover:指定组件的recover区主备区域进行升级,用于系统恢复。

    查询设备是否是物理机:

    ./upgrade-tool --device_index <dev_id> --phymachflag

    --phymachflag:查询设备是否是物理机。如果不是物理机,不允许升级设备的固件包。