Documentation

Testing Software and Hardware Compatibility

Function

Obtain the hardware information, architecture, driver version, firmware version, and software version information.

Restrictions

You can query the firmware version only when you run the Ascend-DMI tool as a user that belongs to user group root.

Commands for Querying Test Parameters

You can run either of the following commands to list the parameters of the compatibility test command:

ascend-dmi -c -h

ascend-dmi -c --help

Table 1 describes the parameters.

Table 1 Parameter description

Parameter

Description

Mandatory

[-c, --compatible]

Checks the compatibility of software and hardware versions.

Yes

[-p, --path]

Specifies the installation path of the CANN package to be checked.

The default path /usr/local/Ascend is used when the software package is installed by the root user. Therefore, you do not need to set this parameter. In other cases, you need to set this parameter when using the compatibility check function. For example, if the CANN package is installed in the /home/xxx/Ascend directory, run the following command:

ascend-dmi -c -p /home/xxx/Ascend

No

[-fmt, --fmt, --format]

Specifies the output format. The value can be normal or json. If this parameter is not specified, the default value normal is used.

No

The compatibility check tool checks the following software packages:

  • toolkit: development kit
  • nnrt: offline inference engine
  • nnae: deep learning engine (training/online inference)
  • tfplugin: framework plugin
  • toolbox: utility
  • npu-driver: driver
  • npu-firmware: firmware

Example

Perform a software and hardware version compatibility test.

ascend-dmi -c

The following are examples of software and hardware compatibility information returned by each type of server. If the corresponding information is returned, the tool is running properly.

  • Inference server (The Ascend 310 AI Processor is used as an example.)
    Figure 1 Software and hardware compatibility test example (inference server)
  • Training server
    Figure 2 Software and hardware compatibility test example (training server)
  • Atlas 300T training card (model 9000)
    Figure 3 Software and hardware compatibility test example (Atlas 300T training card (model 9000))

Table 2 describes the server parameters in the preceding figures.

Table 2 Parameter description

Parameter

Description

System Information

Displays the system information.

Architecture

Indicates the architecture.

Type

Indicates the standard card model/processor model.

Compatibility Check Result

Displays the compatibility check result.

Package

Indicates the package name.

Version

Indicates the version.

Status

Indicates the status.

Dependencies

Lists the dependency.