相关工具

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：查询设备是否是物理机。如果不是物理机，不允许升级设备的固件包。

父主题： 附录