相关工具

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

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

    表1 相关工具

    功能描述

    执行命令

    参数

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

    请切换到“/usr/local/Ascend/driver/tools”路径执行命令。

    查看帮助信息：

    ./upgrade-tool --help

    --help：查看帮助信息。

    列举所有Device：

    ./upgrade-tool --mini_devices

    --mini_devices：所有设备列表。

    获取指定设备的版本：

    ./upgrade-tool --device_index <dev_id> --system_version
    • --device_index：设备编号。取值可以是【0~63】和-1，【0~63】表示对应编号的设备。-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：指定具体的组件。查询和升级单个组件时，需要指定组件名称。查询和升级所有组件时，需要输入-1。需要升级所有组件并清除用户配置数据时，请输入-9。
    • --version：组件的版本。

    热复位device：

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

    dev_id仅支持-1，表示热复位所有Device，不支持热复位单个Device。

    说明：

    执行热复位前，需要先关闭业务。

    当前仅支持使用upgrade-tool工具热复位，不支持使用npu-smi set -t reset命令热复位。

    --hot_reset：热复位Device。

    查询设备是否是物理机：

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

    说明：

    仅支持通过物理机升级固件包。

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

    获取当前设备的启动状态：

    ./upgrade-tool --device_index <dev_id> --boot_status
    --boot_status：当前设备的启动状态。
    • 0：未初始化。
    • 1：BIOS启动中。
    • 2：OS启动中。
    • 3：启动完成。
    • 16：DSMI服务进程启动完成。

    设置当前设备热复位标志：

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

    说明：

    设置当前设备热复位标志前，需要先关闭业务。

    --hot_reset_flag：当前设备的热复位标志，dev_id仅支持设置-1，设置后会导致基础功能异常，可通过重启恢复。

    设置当前固件兼容的驱动列表。

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

    --set_compat_list：给每个芯片的flash设置当前固件兼容的驱动列表。dev_id仅支持设置-1。使用该参数可能会影响兼容性检测，请谨慎使用。

    请切换到“/usr/local/Ascend/firmware/tools”路径执行命令。

    升级指定设备的固件包：

    /usr/local/Ascend/driver/tools/upgrade-tool --device_index <dev_id> --component <type> --path <firmware_path>

    --path：固件包相对路径。

    若升级全部组件，则为--path ./conf/upgrade.cfg；“upgrade.cfg”文件中包含各个组件的相对路径。

    组件和固件包的对应关系如下：

    • hboot1a (AS310B_HBOOT1_a.bin)
    • hboot1b (AS310B_HBOOT1_b.bin)
    • hlink (hilink25_fw.bin)

    若升级单个组件，例如hilink25_fw.bin，则为--path ../image/hilink25_fw.bin。

    异步升级指定设备的固件包：

    /usr/local/Ascend/driver/tools/upgrade-tool --device_index <dev_id> --component <type> --async --path <firmware_path>

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

    --async：支持异步升级，即Device侧收到Host侧发送的升级请求后，返回请求成功响应到Host侧（具体固件是否升级成功，需要通过“--status”参数去查询）。

父主题： 参考