自定义打流

测试项功能

自定义打流是将一键式打流中的各步骤独立出来，用户可灵活控制打流的TX、RX方向开关和指定打流的具体lane。

测试项名称	支持的打流方式	使用方法
自定义打流	CDR环回打流、光模块外接光纤回路器（自环器）打流、NPU直连打流	自定义打流是将一键式打流中的各步骤独立出来，用户可灵活控制打流的TX、RX方向开关和指定打流的具体lane。
一键式打流	CDR环回打流、光模块外接光纤回路器（自环器）打流	执行一键式打流命令，Ascend DMI工具将自动完成发送及接收指定device所有lane的码流，一段时间后关闭码流并查询结果。

测试原理

自定义打流支持以下3种打流方式。

NPU外部环回场景：
- CDR环回打流：请参见测试原理。
- 光模块外接光纤回路器（自环器）打流：请参见测试原理。
NPU直连打流：NPU A的Serdes端口开启TX方向打流后，数据流通过被测链路到达NPU B的Serdes端口，NPU B的RX方向按照码型比对，统计接收到的数据误码情况，可检查两个NPU之间链路的信号质量。
图1 NPU直连打流示意图
- 外部环回场景：需要确保先开启TX方向，再开启RX方向。
- NPU直连场景：测试A发B收时，需要确保先开启TX_A方向，再开启TX_B方向；测试B发A收时，需要确保先开启TX_B方向，再开启RX_A方向，否则结果会出现满误码。
- 同一个Device的不同lane在打流期间的操作需要一致，否则NPU和CDR重新自适应会影响打流结果；比如lane 0打流期间再开关其他lane，可能会导致lane 0满误码。

测试前准备

打流会中断训练或推理业务，打流前请确保无业务运行。
如果使用外接光纤回路器或者两个NPU直连的场景，打流前无需额外配置；如果使用CDR环回，请确保光模块在位然后配置CDR环回。CDR配置环回方法请参考《Atlas A2 中心推理和训练硬件 25.0.RC1 HCCN Tool 接口参考》的“配置功能>配置和查询CDR相关信息”章节。

测试项特定参数查询

用户可任选以下指令之一查看码流测试命令的可用参数。

ascend-dmi --prbs-check -h

ascend-dmi --prbs-check --help

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

在打流前，必须先执行--clear命令清除当前Device寄存器保留的历史信息。

表1 参数说明
参数	说明	是否必填
[-pc, --pc, --prbs-check]	使用该参数进行PRBS码流测试。	是
[--prbs-mode]	是否切换打流状态。 --取值为EN（Enable）：开启。 --取值为DS（Disable）：关闭。取值支持大小写。指定--prbs-mode为EN或DS时，信号发送端和信号接收端两个方向均会生效，无论是否指定--generator-lanes,--checker-lanes参数。指定--prbs-mode为EN时，支持指定--generator-lanes、--checker-lanes。指定--prbs-mode为DS时，停止打流。不支持指定--generator-lanes、--checker-lanes。本参数不支持与--show参数或--clear参数同时指定。	是
[--generator-lanes]	指定发送端的lane。可同时指定1个或多个lane，多个之间用逗号分开。指定多个lane时必须连续指定，如0,1,2。不支持非连续指定，如0,1,3。若不指定，则默认测试所有lanes。本参数不支持与--show参数或--clear参数同时指定。可取值为0、1、2、3。	否
[--checker-lanes]	指定接收端的lane。可同时指定1个或多个lane，多个之间用逗号分开。指定多个lane时必须连续指定，如0,1,2。不支持非连续指定，如0,1,3。若不指定，则默认测试所有lanes。本参数不支持与--show参数或--clear参数同时指定。可取值为0、1、2、3。	否
[-show, --show, --show-diagnostic-info]	展示码流测试的结果。本参数不支持与以下参数同时指定：--clear、--prbs-mode、--generator-lanes、--checker-lanes。展示信息后当前码流测试的结果即会被清空。	否
[-clear, --clear, --clear-diagnostic-info]	清空码流测试的结果信息。本参数不支持与以下参数同时指定：--show、--prbs-mode、--generator-lanes、--checker-lanes。支持除以上参数外的其余参数同时指定。	否

使用实例

执行自定义打流时，请按照图2进行操作。

图2 码流测试流程图

以使用默认值进行码流测试为例。
```
ascend-dmi -pc --clear  -q    
ascend-dmi -pc --prbs-mode EN -q
```
命令含义：在所有device上开启码流测试，发送端为4条lane、码型为PRBS31；接收端为4条lane、码型为PRBS31。

图3 使用默认值进行码流测试

以在Device8上开启码流测试为例，发送端为lane0和lane1；接收端为4条lane。

[***@***]# ascend-dmi -pc --clear --device 8 -q
Operation succeeded.
[***@***]# ascend-dmi -pc --prbs-mode EN -q --device 8 --generator-lanes 0,1
Operation succeeded.
[***@***]# ascend-dmi --pc --show -d 8 -q
Device 8:
-----------------------------------------------------------------------------------------------
Lane      Check Enable    Pattern    Error-Bits     Bit-Error Rate(BER)    ALOS      Period(ms)
----------------------------------------------------------------------------------------------------
0         1               PRBS31     206            0.0000000032%          0         120193
1         1               PRBS31     385            0.0000000060%          0         120187
2         1               PRBS31     67092480       0.0010508065%          0         120186
3         1               PRBS31     67092480       0.0010507844%          0         120189
-----------------------------------------------------------------------------------------------

关闭打流示例。
ascend-dmi -pc --prbs-mode DS -d 8,9 -q

此命令会关闭device 8和9上，4条lane上，TX和RX方向上的打流。

清空打流结果示例。
ascend-dmi -pc --clear-diagnostic-info -d 8,9 -q

此命令会清空device 8和9上记录的误码数据。

在以上示例中，各回显参数的说明如表2 回显参数说明所示：

表2 回显参数说明
参数	说明
Lane	对应RoCE链路的lane id。
Check Enable	接收端的check状态。 0：关闭 1：开启
Pattern	RX方向check的码型。
Error-Bits	误码数，上限为67092480（满误码）。
Bit-Error Rate(BER)	误码率，误码数÷总传输bit数×100%。当误码率小于0.001%为信号质量正常。
ALOS	正常打流时需要为0，为1通常表示信号幅度过低；未打流时无意义无需关注。
Period	距离上一次操作控制打流/读取check结果的时间。
以下几种情况可能导致满误码（误码数为67092480）：未使用--clear清空寄存器即进行码流测试。发送方向和接收方向指定的码型不一致。开关顺序问题：先开启了RX，后开启TX。打流流程会自动关闭NPU和CDR自适应，多次执行打流命令时会反复开关自适应，当自适应开关动作未完成时，偶现误码数为67092480。 CDR环回场景下，未配置CDR环回，详细配置步骤请参见《Atlas A2 中心推理和训练硬件 25.0.RC1 HCCN Tool 接口参考》的“配置功能>配置和查询CDR相关信息”章节。

后续操作

为避免对正在运行的训练或推理业务造成影响，请在完成码流测试后，关闭该测试项。
若使用CDR环回打流，请在完成打流后解除CDR环回，否则业务无法正常运行。解除CDR环回请参见《Atlas A2 中心推理和训练硬件 25.0.RC1 HCCN Tool 接口参考》的“配置功能>配置和查询CDR相关信息”章节。

父主题： 码流测试