Tools

The execution method of the tools in Table A-3 is as follows:

1. Log in to the host server as the running user (HwHiAiUser by default) specified during software package installation.
2. Go to the tool path, for example, /usr/local/Ascend/driver/tools. Run the cd /usr/local/Ascend/driver/tools command.
3. Run the commands in Table A-3 to invoke 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	Views firmware versions and upgrades one or more pieces of 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 Hot resets a device: /usr/local/Ascend/driver/tools/upgrade-tool --device_index <dev_id> --hot_reset dev_id = –1 indicates that all devices are hot reset. Host 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 whether 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 package of a device: /usr/local/Ascend/driver/tools/upgrade-tool --device_index <dev_id> --component <type> --path <firmware_path> The parameters involved in the above command are as follows: --mini_devices: list of all devices. --device_index: device ID. A value ranges from 0 to 7 or -1. The value ranging from 0 to 7 indicates the device with the corresponding ID. The value -1 indicates all devices. --system_version: system version. --component: component name. When upgrading a single component, you need to specify the component name. Currently, AICPU can only be upgraded separately. The value -1 indicates updating all components, and 9 indicates updating all components and resetting the password. --component: component name. When updating a single component, you need to specify the component name. The value -1 indicates updating all components, while the value 9 updating all components and resetting the password. --version: component version. --status: device status. --path: indicates the 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 devices. --phymachflag: checks whether a device is a physical device. If the device is not a physical device, the firmware of the device cannot be upgraded. --async: performs asynchronous upgrade. That is, after receiving an upgrade request from the host, the device returns a success response to the host. To query the update result, use the --status option. --help: help information.
   hccn_tool	/usr/local/Ascend/driver/tools	Cluster network tool, which can be executed only by user root.	For details, see the Ascend 910 HCCN Tool API Reference.