--- title: 眼图测试 description: "Ascend DMI支持眼图测试，用户使用该功能对网络进行测试，查询当前信号质量。" url: https://www.hiascend.com/document/detail/zh/mindcluster/latest/toolbox/toolboxug/toolboxug_0021.html sourcePath: /source/zh/mindcluster/2610/toolbox/toolboxug/toolboxug_0021.html indexId: f03cbf6832274a92346b5f16981915c76547b9d613c4ca2dfdd5f71492b5da2f65 --- # 眼图测试 Ascend DMI支持眼图测试，用户使用该功能对网络进行测试，查询当前信号质量。 本功能主要用于查询信号质量的具体数据。判断当前端口信号质量是否正常，请执行SignalQuality诊断。详细说明请参考眼图诊断章节。 #### 测试项功能 查询NPU上的PCIe、HCCS、RoCE和UB通信端口的信号质量。 #### 测试项特定参数查询 用户可任选以下指令之一查看信号质量查询命令的可用参数。 ascend-dmi --sq -h ascend-dmi --sq --help 各参数解释如表1所示，表格内仅展示测试项特定参数，其余公共参数请参见公共参数说明。 **表1 参数说明** | 参数 | 说明 | 是否必填 | | --- | --- | --- | | [\-sq, \-\-sq, \-\-signal\-quality] | 查询NPU上的PCIe、HCCS、RoCE和UB通信端口；CPU上的HCCS通信端口的信号质量。 | 是 | | [\-d, \-\-device] | 指定查询NPU或CPU的Device ID。指定多个芯片时，使用英文逗号进行分隔。不指定该参数时，默认查询该设备上所有的NPU/CPU。 若当前设备为 Atlas A2 训练系列产品 、 Atlas 800I A2 推理产品 、A200I A2 Box 异构组件，指定HCCS类型时，需要指定两张device；若使用Atlas 200T A2 Box16/Atlas 200I A2 Box16 异构子框指定HCCS类型时，前8P或后8P至少指定两张device。 若当前设备为Atlas 300I Duo 推理卡，当type参数指定了pcie，该参数不能指定从芯片。 | 否 | | [\-t, \-\-type] | 指定通信端口的类型。当前支持PCIe、HCCS、RoCE和UB类型，指定多个通信端口的类型时，使用英文逗号进行分隔。 Atlas 800T A2 训练服务器、Atlas 900 A2 PoD 集群基础单元、Atlas 900 A2 PoDc 集群基础单元、Atlas 200T A2 Box16/Atlas 200I A2 Box16 异构子框、Atlas 800I A2 推理服务器、A200I A2 Box 异构组件、A200T A3 Box8 超节点服务器默认查询PCIe和RoCE的信号质量。 Atlas 800I A3 超节点服务器、Atlas 9000 A3 SuperPoD 集群算力系统、Atlas 900 A3 SuperPoD 超节点默认查询RoCE的信号质量。 Atlas 300I Duo 推理卡服务器场景下，主芯片仅支持PCIe和HCCS，从芯片仅支持HCCS。默认查询PCIe的信号质量。 Atlas 800I A2 推理服务器（32GB PCIe款）不支持查询HCCS的信号质量。 Atlas 300I A2 推理卡仅支持查询PCIe的信号质量。 Atlas 350 标卡仅支持PCIe和UB。 Atlas 850 系列硬件产品仅支持RoCE和UB。 Atlas 950 SuperPoD 超节点仅支持UB。 取值说明如下： pcie：PCIe链路是NPU到CPU之间进行通信的链路，PCIe信号质量是指NPU侧连接PCIe链路的macro口四眼图的数值。 hccs：HCCS链路是多张NPU之间互联的链路。HCCS信号质量是指NPU侧连接HCCS链路的macro口的信噪比和半眼高的数值。 roce：RoCE链路是NPU侧对外进行集群通信的链路。RoCE信号质量是指NPU侧连接RoCE链路的macro口的信噪比和半眼高的数值。 ub：UB链路是NPU侧与其他设备进行集群通信的链路。UB信号质量是指NPU侧连接UB链路的macro口的信噪比的数值。 | 否 | | [\-m, \-\-module] | 支持查询CPU、NPU眼图。不指定该参数时，默认查询NPU眼图。该参数暂仅支持在 Atlas A3 训练系列产品 、 Atlas A3 推理系列产品 中使用。 取值说明如下： cpu：查询CPU连接的HCCS链路的信号质量。 npu：查询NPU连接的PCIe、HCCS、RoCE和UB链路的信号质量。 | 否 | | [\-r, \-\-result] | 指定全眼图信息采集结果的保存路径，如：/test。指定的路径需符合安全要求，且不支持包含通配符“\*”。 若用户指定结果保存路径，则在指定路径创建ascend\_check文件夹；若不指定路径，则保存在“/var/log/ascend\_check”的默认路径下。 基于安全考虑，为防止结果保存目录权限被修改，用户可将结果保存目录ascend\_check的权限设置为700。 | 否 | #### 使用示例 使用示例中命令的回显在推理服务器与训练服务器上类似，截图取自训练服务器。 - 以查看Device 0和Device 1的PCIe、HCCS和RoCE信号质量为例。 ascend-dmi --sq -t hccs,pcie,roce -d 0,1 若返回如图1所示信息，表示工具运行正常。 图1 设备信号质量检测示例（PCIe、HCCS和RoCE） - 以查看Device 1和Device 3的UB信号质量为例。 ascend-dmi --sq -t ub -d 1,3 若返回如图2所示信息，表示工具运行正常。 图2 设备信号质量检测示例（UB） - 以指定输出格式为json为例。 ascend-dmi --signal-quality -t roce -d 0 --fmt json 若返回如图3所示信息，表示工具运行正常。 图3 设备信号质量检测json输出示例 以图1和图2为例，上述回显参数介绍如下表所示： **表2 HCCS信号质量回显参数说明** | 参数 | 说明 | | --- | --- | | type | 指定通信端口的类型。 | | device | NPU的逻辑ID。 | | M\*（macro port） | 表示macro端口，例如M0、M1分别表示macro的0号、1号端口。 | | L\*（LANE） | 表示HCCS链路中的第几条lane，例如L0、L1分别表示第0条和第1条lane。 | | S（SNR） | 表示lane的信噪比。 | | H（HEH） | 表示lane的半眼高。 | | B/T/L/R | 分别表示四眼图bottom、top、left和right四个位置的值。 | | 数据说明： 在HCCS信号质量回显中，当SNR≥400000且HEH≥350，即表示当前LANE信号质量正常。 若SNR和HEH数值不在以上范围内，即表示HCCS信号质量异常。请检查macro连接口是否发生松动，链路是否有脏污。 若SNR和HEH的数值为0，说明测试的HCCS链路中指定的Device之间未建链。 使用Atlas 300I Duo 推理卡查询NPU的HCCS信号质量；或使用Atlas 900 A3 SuperPoD 超节点、Atlas 800I A3 超节点服务器、Atlas 9000 A3 SuperPoD 集群算力系统查询CPU的HCCS信号质量回显时，只会展示type、device、M\*（macro port）、L\*（LANE）、B/T/L/R回显参数，且B/T/L/R中B（bottom）≤\-30、T(top)≥30、L(left)≤\-5、R(right)≥5。 | 数据说明： 在HCCS信号质量回显中，当SNR≥400000且HEH≥350，即表示当前LANE信号质量正常。 若SNR和HEH数值不在以上范围内，即表示HCCS信号质量异常。请检查macro连接口是否发生松动，链路是否有脏污。 若SNR和HEH的数值为0，说明测试的HCCS链路中指定的Device之间未建链。 使用Atlas 300I Duo 推理卡查询NPU的HCCS信号质量；或使用Atlas 900 A3 SuperPoD 超节点、Atlas 800I A3 超节点服务器、Atlas 9000 A3 SuperPoD 集群算力系统查询CPU的HCCS信号质量回显时，只会展示type、device、M\*（macro port）、L\*（LANE）、B/T/L/R回显参数，且B/T/L/R中B（bottom）≤\-30、T(top)≥30、L(left)≤\-5、R(right)≥5。 | **表3 PCIe信号质量回显参数说明** | 参数 | 说明 | | --- | --- | | type | 指定通信端口的类型。 | | device | 表示NPU的逻辑ID。 | | M\*（macro port） | 表示macro端口，例如M9、M10分别表示macro的9号、10号端口。 | | L\*（LANE） | 表示PCIe链路中的第几条lane，例如L0、L1分别表示第0条和第1条lane。 | | B/T/L/R | 分别表示四眼图bottom、top、left和right四个位置的值。Atlas 350 标卡不支持该参数。 | | S（SNR） | 表示lane的信噪比。仅Atlas 350 标卡支持该参数。 | | 数据说明： 在PCIe信号质量回显中，当四眼图B(bottom)≤\-17、T(top)≥17、L(left)≤\-3、R(right)≥3（须同时满足），即表示当前LANE信号质量正常。 若四眼图数值不在以上范围内，即表示PCIe信号质量异常。请检查macro连接口是否发生松动，链路是否有脏污。 在Atlas 300I Duo 推理卡场景下，B/T/L/R的范围为B(bottom)≤\-30、T(top)≥30、L(left)≤\-5、R(right)≥5。 在Atlas 350 标卡场景下，当SNR≥300000时，表示当前LANE信号质量正常。 | 数据说明： 在PCIe信号质量回显中，当四眼图B(bottom)≤\-17、T(top)≥17、L(left)≤\-3、R(right)≥3（须同时满足），即表示当前LANE信号质量正常。 若四眼图数值不在以上范围内，即表示PCIe信号质量异常。请检查macro连接口是否发生松动，链路是否有脏污。 在Atlas 300I Duo 推理卡场景下，B/T/L/R的范围为B(bottom)≤\-30、T(top)≥30、L(left)≤\-5、R(right)≥5。 在Atlas 350 标卡场景下，当SNR≥300000时，表示当前LANE信号质量正常。 | **表4 RoCE信号质量回显参数说明** | 参数 | 说明 | | --- | --- | | type | 指定通信端口的类型。 | | device | 表示NPU的逻辑ID。 | | M\*（macro port） | 表示macro端口，例如M0分别表示macro端口0。 | | S（SNR） | 表示lane的信噪比。 | | H（HEH） | 表示lane的半眼高。Atlas 850 系列硬件产品不支持该参数。 | | L\*（LANE） | 表示RoCE链路中的第几条lane，例如L0、L1分别表示第0条和第1条lane。 | | 数据说明： 在RoCE信号质量回显中： 环境为100G光模块时，SNR≥260000且HEH≥350，表示当前LANE信号质量正常。 环境为200G光模块时，SNR≥400000且HEH≥350，表示当前LANE信号质量正常。 若SNR和HEH数值不在以上范围内，即表示RoCE信号质量异常。请检查macro连接口是否发生松动，链路是否有脏污。 若SNR和HEH的数值为0，说明测试的RoCE链路中指定的Device之间未建链。 在Atlas 850 系列硬件产品场景下，当SNR≥300000时，表示当前LANE信号质量正常。 | 数据说明： 在RoCE信号质量回显中： 环境为100G光模块时，SNR≥260000且HEH≥350，表示当前LANE信号质量正常。 环境为200G光模块时，SNR≥400000且HEH≥350，表示当前LANE信号质量正常。 若SNR和HEH数值不在以上范围内，即表示RoCE信号质量异常。请检查macro连接口是否发生松动，链路是否有脏污。 若SNR和HEH的数值为0，说明测试的RoCE链路中指定的Device之间未建链。 在Atlas 850 系列硬件产品场景下，当SNR≥300000时，表示当前LANE信号质量正常。 | **表5 UB信号质量回显参数说明** | 参数 | 说明 | | --- | --- | | type | 指定通信端口的类型。 | | device | NPU的逻辑ID。 | | M\*（macro port） | 表示macro端口，例如M1、M3分别表示macro的1号、3号端口。 | | L\*（LANE） | 表示UB链路中的第几条lane，例如L0、L1分别表示第0条和第1条lane。 | | S（SNR） | 表示lane的信噪比。 | | 数据说明： 在UB信号质量回显中，当SNR≥300000时，表示当前LANE信号质量正常。 若SNR不在以上范围内，即表示UB信号质量异常。请检查macro连接口是否发生松动，链路是否有脏污。 若SNR数值为0，说明测试的UB链路中指定的Device之间未建链。 | 数据说明： 在UB信号质量回显中，当SNR≥300000时，表示当前LANE信号质量正常。 若SNR不在以上范围内，即表示UB信号质量异常。请检查macro连接口是否发生松动，链路是否有脏污。 若SNR数值为0，说明测试的UB链路中指定的Device之间未建链。 | SNR和HEH数值为0时的回显示例 ``` [root@***** ~ ]# ascend -dmi --sq -t roce type: roce Prompt message: M*: macro port, L*: lane, S: SNR, H: HEH 100G Optical Normal range: S(SNR) >= 260000 and H(HEH) >= 350 200G Optical Normal range: S(SNR) >= 400000 and H(HEH) >= 350 ---------------------------------------------------------------------------------------------- device signal-to-noise ratio ---------------------------------------------------------------------------------------------- 0 M0: L0: S:0 H:0 L1: S:0 H:0 L2: S:0 H:0 L3: S:0 H:0 ---------------------------------------------------------------------------------------------- 1 M0: L0: S:0 H:0 L1: S:0 H:0 L2: S:0 H:0 L3: S:0 H:0 ---------------------------------------------------------------------------------------------- 2 M0: L0: S:0 H:0 L1: S:0 H:0 L2: S:0 H:0 L3: S:0 H:0 ---------------------------------------------------------------------------------------------- 3 M0: L0: S:0 H:0 L1: S:0 H:0 L2: S:0 H:0 L3: S:0 H:0 ---------------------------------------------------------------------------------------------- 4 M0: L0: S:0 H:0 L1: S:0 H:0 L2: S:0 H:0 L3: S:0 H:0 ---------------------------------------------------------------------------------------------- 5 M0: L0: S:0 H:0 L1: S:0 H:0 L2: S:0 H:0 L3: S:0 H:0 ---------------------------------------------------------------------------------------------- 6 M0: L0: S:0 H:0 L1: S:0 H:0 L2: S:0 H:0 L3: S:0 H:0 ---------------------------------------------------------------------------------------------- 7 M0: L0: S:0 H:0 L1: S:0 H:0 L2: S:0 H:0 L3: S:0 H:0 ---------------------------------------------------------------------------------------------- ``` - 以查看Device 0的PCIe信号质量，指定全眼图结果保存路径为例。 ascend-dmi -sq -t pcie -d 0 -r /home/ 若返回如图4所示信息，表示工具运行正常。 图4 设备信号质量检测全眼图测试示例 全眼图落盘为csv格式文件，请将文件中的数据生成散点图，观察采样点分布情况。正常情况显示如图5，异常情况显示如图6。 图5 信号质量正常的全眼图数据 图6 信号质量异常的全眼图数据