Tools

The following describes how to run the tools described in Table A-3.

1. Log in to the host server as the running user (HwHiAiUser by default) specified during runfile installation.
2. Go to the tool directory, for example, /usr/local/Ascend/driver/tools. The command format is: cd /usr/local/Ascend/driver/tools.
3. 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.