简介

ascend-dmi工具主要为Atlas产品的标卡、板卡及模组类产品提供带宽测试、算力测试、功耗测试等功能。工具的功能介绍如表1所示。本系统通过调用底层DCMI（设备控制管理接口）以及AscendCL（Ascend Computing Language，昇腾计算语言）相关接口完成相关检测功能，对于系统级别的信息查询通过调用系统提供的通用库来实现，用户使用工具时通过配置参数来实现不同的测试功能。

表1 工具功能介绍
功能名称	功能介绍
带宽测试	测试总线带宽、内存带宽和时延。
算力测试	测试整卡或芯片中AI Core的算力值和满算力下的实时功率。
功耗测试	检测整卡或芯片的功耗信息。
设备实时状态查询	检测设备在运行过程中的状态信息。
故障诊断	分别对软件类和硬件类进行诊断，并输出诊断结果，各检查类包含的项目如下：软件类：driver兼容性和驱动健康诊断，CANN各层软件的兼容性，CANN与驱动的兼容性。硬件类：设备健康状态，网络健康状态，本地带宽，算力。
软硬件版本兼容性测试	获取硬件信息、架构、驱动版本、固件版本以及软件版本，并检测软硬件间的兼容性。
驱动固件版本兼容性测试	获取当前环境驱动版本和各个昇腾AI处理器的固件版本，并检测驱动固件版本间的兼容性诊断结果。
设备拓扑检测	查询单机内多卡间的拓扑结构。

上述功能在使用过程中如果报错，在对应日志中会产生错误码，错误码查询链接如下：aclError和DCMI API返回码。
上述功能在使用过程中，建议用户在进程完成后再执行下一步操作，不建议在执行过程中终止进程。

父主题： ascend-dmi工具使用