相关工具
upgrade-tool工具不支持容器场景，部署容器时，禁止将upgrade-tool工具映射到容器内。
- 登录Host侧的服务器。
- 切换到软件包所在安装路径，根据以下表格中的命令调用工具，如下以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
说明：芯片复位成功后，请至少等待20s再执行当前操作。
--set_compat_list：给每个芯片的flash设置当前固件兼容的驱动列表。使用该参数可能会影响兼容性检测，请谨慎使用。
请切换到“/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”参数去查询）。