设备拓扑检测是查询单机内多卡间的拓扑结构。

用户可任选以下指令之一查看设备拓扑检测命令的可用参数。

ascend-dmi --topo -h

ascend-dmi --topo --help

各参数解释如表1所示。

表1 参数说明
参数	说明	是否必填
[-topo, --topo, --topology]	查看单机内多卡间的拓扑结构。支持-topo，但建议使用--topo或--topology。	是
[-fmt, --fmt, --format]	指定输出格式，可以为normal或json。若未指定则默认为normal。	否

使用实例中命令的回显在推理服务器与训练服务器上类似，截图取自推理服务器。

以查看拓扑结构为例。
ascend-dmi --topo

若返回如图1所示信息，表示工具运行正常，图中参数请参见表2。

图1 设备拓扑检测示例
以指定输出格式为json为例。
ascend-dmi --topo --fmt json

若返回如图2所示信息，表示工具运行正常，图中参数请参见表2。
图2 设备拓扑检测json输出示例

表2 显示界面参数说明
参数	说明
NPUx	服务器安装的NPU，x为NPU的ID。
SYS	在不同的NUMA node下面，且2个node之间使用的是SMP类协议的芯片（HCCS直连的芯片无法获取和该拓扑信息不相关）
NODE	通过PCIe连接且经过不同的CPU，且CPU在同一个NUMA node。
PHB	通过PCIe连接在同一个CPU上的，且需要经过CPU。
PXB	通过PCIe连接在同一个CPU上的，不需要经过CPU，且穿过多个PCIe switch。
PIX	通过PCIe连接在同一个CPU上的，不需要经过CPU，且穿过1个PCIe switch。
CPU Affinity	一个NUMA node下的Device和CPU具有亲和性。

以图1中的CPU Affinity为例，0-3表示CPU0到CPU3，8-11表示CPU8到CPU11，NPU和以上八个CPU都具有亲和性。