测试项功能

软硬件兼容性工具会获取硬件信息、架构、驱动版本、固件版本以及软件版本。

使用限制

固件版本只有root属组的用户在执行软硬件版本兼容性测试的时候才可以查询。
仅支持对驱动Ascend HDK 23.0.RC2及以上版本和CANN 6.3.RC2及以上版本进行兼容性测试。

测试项参数查询

用户可任选以下指令之一查看软硬件版本兼容性测试命令的可用参数。

ascend-dmi -c -h

ascend-dmi -c --help

各参数解释如表1所示。

表1 参数说明
参数	说明	是否必填
[-c, --compatible]	使用该参数进行软硬件版本兼容性检测。若已安装驱动22.0.0或CANN 6.2.RC1及其以后的版本，执行“-c”参数时，会对驱动、固件和软件包进行兼容性检测。若驱动为22.0.0之前的版本且CANN为6.2.RC1之前的版本，执行“-c”参数时，会检测对应的驱动、固件和软件包是否安装。说明：仅支持对Atlas 训练系列产品、Atlas A2 训练系列产品、Atlas 推理系列产品的固件进行兼容性检查。不支持对Atlas 200/300/500 推理产品、Atlas 200/500 A2推理产品和Atlas 200I SoC A1产品的固件进行兼容性检查。	是
[-p, --path]	用户指定检测兼容性的CANN软件包的安装路径，若不指定，将根据默认安装路径进行测试。指定软件包安装路径的命令示例： ascend-dmi -c -p /home/xxx/Ascend	否
[-fmt, --fmt, --format]	指定输出格式，可以为normal或json。若未指定则默认为normal。	否

兼容性工具检测的软件包如下：

toolkit：开发套件
nnrt：离线推理引擎
nnae：深度学习引擎（训练/在线推理）
tfplugin：框架插件
toolbox：实用工具
npu-driver：驱动
npu-firmware：固件

使用实例

以测试软硬件版本兼容性为例。

ascend-dmi -c

以下为各类服务器返回的软硬件版本兼容性信息示例，如返回对应信息表示工具运行正常。

推理服务器
图1 软硬件版本兼容性检测示例
训练服务器
图2 软硬件版本兼容性检测示例
训练卡
图3 软硬件版本兼容性检测示例

在对npu-driver进行兼容性测试时，会按照NPU的维度进行测试。若npu-driver测试状态为INCOMPATIBLE PACKAGE，表示npu-driver与当前的npu-firmware或CANN软件包不兼容。在npu-firmware的检查状态中会上报不兼容npu-driver的具体Device ID。

上述图中各类服务器参数介绍如表2所示。

表2 显示界面参数说明
参数	说明
System Information	系统信息
Architecture	架构
Type	标卡型号/芯片型号
Compatibility Check Result	兼容性检测结果
Package	包名
Version	版本
Status	状态，会返回如下状态： OK：兼容 INCOMPATIBLE PACKAGE：不兼容 NA：未知状态，可能是获取软件版本失败导致说明：非root用户不支持固件兼容性查询，npu-firmware状态会显示为NA。
Innerversion	内部版本号
Dependencies	依赖