Tools
The following describes how to run the tools described in Table A-3.
- Log in to the host server as the running user (HwHiAiUser by default) specified during runfile installation.
- Go to the tool directory, for example, /usr/local/Ascend/driver/tools. The command format is: cd /usr/local/Ascend/driver/tools.
- Run the commands in Table A-3 to call the tools. The following uses the default installation path of the driver as an example.Table A-3 Related tools
Name
Path
Function
Command
upgrade-tool
/usr/local/Ascend/driver/tools
Queries the firmware version and update firmware.
NOTE:Run the following commands in the /usr/local/Ascend/firmware/tools directory.
cd /usr/local/Ascend/firmware/tools
dev_id = –1 indicates all devices.
- Lists all devices:
/usr/local/Ascend/driver/tools/upgrade-tool --mini_devices
- Obtains the version of a specified device:
/usr/local/Ascend/driver/tools/upgrade-tool --device_index <dev_id> --system_version
- Obtains the component information about a specified device:
/usr/local/Ascend/driver/tools/upgrade-tool --device_index <dev_id> --components
- Queries the version of a device component:
/usr/local/Ascend/driver/tools/upgrade-tool --device_index <dev_id> --component <type> --version
- Queries the device status:
/usr/local/Ascend/driver/tools/upgrade-tool --device_index <dev_id> --status
- Performs hot reset on the device:
/usr/local/Ascend/driver/tools/upgrade-tool --device_index <dev_id> --hot_reset
dev_id = –1 indicates that all devices are hot reset. Hot reset of a single device is not allowed.
NOTE:- Before performing a hot reset, stop the services.
- In the current version, only the ARM architecture supports hot reset.
- Checks if a device is a physical device:
/usr/local/Ascend/driver/tools/upgrade-tool --device_index <dev_id> --phymachflag
NOTE:In the current version, only the firmware of a physical device can be upgraded.
- Updates the firmware of a device:
/usr/local/Ascend/driver/tools/upgrade-tool --device_index <dev_id> --component <type> --path <firmware_path>
where,- --mini_devices: list of all devices
- --device_index: device ID. The value can be 0–7 or –1. The value 0–7 indicate device IDs. The value -1 indicates all devices.
- --system_version: system version.
- --components: lists of all valid components.
- --component: component name. When upgrading a single component, you need to specify the component name. Currently, AI CPU can only be upgraded separately. To upgrade all components, enter -1. To upgrade all components and reset the password, enter 9.
- --version: obtains the component version.
- --status: obtains the device status.
- --path: relative path of the firmware package. To upgrade all components, set this option to --path ./conf/upgrade.cfg. To upgrade a single component, for example, nve.bin, set this option to --path ../image/nve.bin.
- --hot_reset: hot resets the devices.
- --phymachflag: queries if a device is a physical device. If the device is not a physical device, the firmware of the device cannot be upgraded.
- --async: supports asynchronous upgrade. That is, after an upgrade request from the host is received, the device returns a success response to the host. To query the upgrade result, use the --status option.
- --help: views the help information
hccn_tool
/usr/local/Ascend/driver/tools
Cluster network tool, which can be executed only by user root.
For details, see Ascend 910 HCCN Tool API Reference.
- Lists all devices: