---
title: 眼图诊断
description: "对信号质量进行诊断，并输出诊断结果。"
url: https://www.hiascend.com/document/detail/zh/mindcluster/latest/toolbox/toolboxug/toolboxug_0159.html
sourcePath: /source/zh/mindcluster/2610/toolbox/toolboxug/toolboxug_0159.html
indexId: e667c72bc1f341fb9335f8b165b2d938fb60ef71238de48cec1f4cb6864381f865
---
# 眼图诊断

#### 测试项功能

对信号质量进行诊断，并输出诊断结果。


**表1 诊断项说明**

| 诊断项名称 | 参考耗时 | 是否影响NPU训练或推理 | 使用场景 |
| --- | --- | --- | --- |
| signalQuality | 10s~2min | 否 | 训练或推理任务时，设备出现PCIe、HCCS、RoCE或UB链路故障。 |


#### 测试项特定参数查询

各参数解释如表2所示，表格内仅展示测试项特定参数，其余公共参数请参见公共参数说明。


**表2 参数说明**

| 参数 | 说明 | 是否必填 |
| --- | --- | --- |
| [\-i, \-\-items] | 指定具体的诊断检查项： signalQuality：对PCIe、HCCS、RoCE和UB的信号质量进行诊断。 | 是 |
| [\-lt, \-\-lt, \-\-link\-type] | 指定眼图诊断的链路类型。取值说明如下： hccs：指定HCCS链路眼图诊断，支持Atlas 300I Duo 推理卡、 Atlas A2 训练系列产品 、Atlas 800I A2 推理服务器、A200I A2 Box 异构组件、 Atlas A3 推理系列产品 、 Atlas A3 训练系列产品 ；不支持Atlas 800I A2 推理服务器（32GB PCIe款）。 pcie：指定PCIe链路眼图诊断，支持Atlas 300I Duo 推理卡、 Atlas A2 训练系列产品 、Atlas 800I A2 推理服务器、A200I A2 Box 异构组件、A200T A3 Box8 超节点服务器、Atlas 350 标卡。在使用Atlas 300I Duo 推理卡只指定从芯片时，将不会诊断PCIe链路的信号质量。 roce：指定RoCE链路眼图诊断，支持 Atlas A2 训练系列产品 、Atlas 800I A2 推理服务器、A200I A2 Box 异构组件、 Atlas A3 推理系列产品 、 Atlas A3 训练系列产品 、Atlas 850 系列硬件产品。 ub：指定UB链路眼图诊断，支持昇腾950PR&950DT系列产品。 | 否 |


#### 使用示例

ascend-dmi -dg -i signalQuality --link-type hccs,pcie

```
[***@***]# ascend-dmi -dg -i signalQuality --link-type hccs,pcie
Summary:
    Arch: aarch64
    Mode: ******
    Time: 20250529-19:24:32
 
Hardware:
    signalQuality:
        PASS
```


#### 故障检查项说明


**表3 故障检查项说明**

| 回显状态 | 含义 |
| --- | --- |
| PASS | 检测通过，信号质量正常。 |
| SKIP | 当前设备不支持眼图诊断。 使用link\-type参数时指定了当前设备不支持的链路类型。 |
| IMPORTANT\_WARN | 重要警告。 PCIe、HCCS、RoCE和UB（其中的一项或多项）信号质量有异常，请联系华为工程师处理。 |
| FAIL | 眼图检测执行失败。 |
| 说明： 在SignalQuality诊断中，对于昇腾950PR&950DT系列产品，若SNR的数值为0，说明测试的链路中指定的Device之间未建链；对于其他产品形态，若SNR和HEH的数值为0，说明测试的链路中指定的Device之间未建链。 | 说明： 在SignalQuality诊断中，对于昇腾950PR&950DT系列产品，若SNR的数值为0，说明测试的链路中指定的Device之间未建链；对于其他产品形态，若SNR和HEH的数值为0，说明测试的链路中指定的Device之间未建链。 |