---
title: 简介
description: "Ascend DMI（Ascend Device Management Interface）工具通过调用底层DCMI（设备控制管理接口）以及AscendCL（Ascend Computing Language，昇腾计算语言）相关接口完成相关检测功能，对于系统级别的信息查询通过调用系统提供的通用库来实现。Ascend DMI提供以下功能：Atlas硬件产品的兼容性检查、带宽测试、算力测试、功耗测试、诊断压测等。详细功能介绍如表1所示。"
url: https://www.hiascend.com/document/detail/zh/mindcluster/latest/toolbox/toolboxug/toolboxug_0010.html
sourcePath: /source/zh/mindcluster/2610/toolbox/toolboxug/toolboxug_0010.html
indexId: 0b443220ae48616eafed951e1ae1e350385548aa29c2f729deb6e46b9513812d65
---
# 简介

Ascend DMI（Ascend Device Management Interface）工具通过调用底层DCMI（设备控制管理接口）以及AscendCL（Ascend Computing Language，昇腾计算语言）相关接口完成相关检测功能，对于系统级别的信息查询通过调用系统提供的通用库来实现。Ascend DMI提供以下功能：Atlas硬件产品的兼容性检查、带宽测试、算力测试、功耗测试、诊断压测等。详细功能介绍如表1所示。


**表1 工具功能介绍**

| 功能名称 | 功能介绍 | 是否影响NPU训练或推理 |
| --- | --- | --- |
| 查看帮助信息 | 查看Ascend DMI工具帮助信息。 | 否 |
| 查看版本信息 | 查看Ascend DMI工具版本信息。 | 否 |
| 带宽测试 | 测试总线带宽、内存带宽和总耗时。 | 是 |
| 超节点P2P带宽测试 | 测试超节点内节点间的HCCS链路传输速率和总耗时。 | 是 |
| 算力测试 | 测试整卡、芯片或整机中AI Core的算力值和满算力下的实时功率。 | 是 |
| 功耗测试 | 检测整卡的功耗信息。 | 是 |
| 设备实时状态查询 | 检测设备在运行过程中的状态信息。 | 否 |
| 故障诊断 | 分别对软件类和硬件类进行诊断或压测，并输出诊断或压测结果，各检查类包含的项目如下： 故障诊断包含以下项目： 软件类：CANN与驱动的兼容性诊断，驱动健康诊断。 硬件类：芯片诊断，网络健康诊断，带宽诊断，算力诊断，片上内存诊断，眼图诊断，AICORE诊断，NIC诊断，PRBS码流诊断。 压测包含以下项目： 硬件类：片上内存压测，片上内存高危地址压测，AICORE压测，P2P压测，功耗压测，AICPU压测，DSA压测。 | 片上内存压测、片上内存诊断、片上内存高危地址压测、AICORE压测、AICORE诊断、带宽诊断、算力诊断、功耗压测、PRBS码流诊断、AICPU压测、NIC诊断、P2P压测、DSA压测会影响NPU训练或推理作业，其他场景下不会影响NPU训练或推理作业。 |
| 眼图测试 | 查询当前信号质量。 | 否 |
| 码流测试 | 码流测试是通过对NPU芯片的RoCE网口收发PRBS码流，检查硬件链路的通信信号质量。 | 是 |
| 时延测试 | 测试CPU、NPU相关链路的时延。 | 是 |
| NPU环境恢复 | NPU环境恢复即通过PCIe标准热复位流程复位昇腾AI处理器。 | 是 |
| 软硬件版本兼容性测试 | 获取硬件信息、架构、驱动版本、固件版本以及软件版本，并检测软硬件间的兼容性。 | 否 |


- 上述功能在使用过程中如果报错，在对应日志中会产生错误码，错误码查询链接如下：《CANN Runtime运行时API》的“数据类型及其操作接口>aclError(https://www.hiascend.com/document/detail/zh/CANNCommunityEdition/910/API/runtimeapi/aclcppdevg_03_1345.html)”章节和  DCMI API返回码(https://support.huawei.com/enterprise/zh/ascend-computing/ascend-hdk-pid-252764743?category=developer-documents&subcategory=api-reference)
。
- 上述功能在使用过程中，建议用户在进程完成后再执行下一步操作，不建议在执行过程中终止进程。