aclrtGetDevicesTopo

产品支持情况

产品	是否支持
Atlas A3 训练系列产品/Atlas A3 推理系列产品	√
Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件	√
Atlas 200I/500 A2 推理产品	√
Atlas 推理系列产品	√
Atlas 训练系列产品	√
Atlas 200/300/500 推理产品	√

对于Atlas 200I/500 A2 推理产品，本接口不支持在Ascend RC形态下调用。

功能说明

获取两个Device之间的网络拓扑关系。

函数原型

aclError aclrtGetDevicesTopo(uint32_t deviceId, uint32_t otherDeviceId, uint64_t *value)

参数说明

参数名	输入/输出	说明
deviceId	输入	指定Device的ID。用户调用aclrtGetDeviceCount接口获取可用的Device数量后，这个Device ID的取值范围：[0, (可用的Device数量-1)]
otherDeviceId	输入	指定Device的ID。用户调用aclrtGetDeviceCount接口获取可用的Device数量后，这个Device ID的取值范围：[0, (可用的Device数量-1)]
value	输出	两个Device之间互联的拓扑关系。 #define ACL_RT_DEVS_TOPOLOGY_HCCS 0x01ULL // 通过HCCS连接，HCCS是Huawei Cache Coherence System（华为缓存一致性系统），用于CPU/NPU之间的高速互联 #define ACL_RT_DEVS_TOPOLOGY_PIX 0x02ULL // 通过同一个PCIe Switch连接 #define ACL_RT_DEVS_TOPOLOGY_PIB 0x04ULL // 预留值 #define ACL_RT_DEVS_TOPOLOGY_PHB 0x08ULL // 通过PCIe Host Bridge连接 #define ACL_RT_DEVS_TOPOLOGY_SYS 0x10ULL // 通过SMP（Symmetric Multiprocessing）连接，NUMA节点之间通过SMP互连 #define ACL_RT_DEVS_TOPOLOGY_SIO 0x20ULL // 片内连接方式，两个DIE之间通过该方式连接 #define ACL_RT_DEVS_TOPOLOGY_HCCS_SW 0x40ULL // 通过HCCS Switch连接

参数名

输入/输出

说明

deviceId

输入

指定Device的ID。

用户调用aclrtGetDeviceCount接口获取可用的Device数量后，这个Device ID的取值范围：[0, (可用的Device数量-1)]

otherDeviceId

输入

指定Device的ID。

用户调用aclrtGetDeviceCount接口获取可用的Device数量后，这个Device ID的取值范围：[0, (可用的Device数量-1)]

value

输出

两个Device之间互联的拓扑关系。

#define ACL_RT_DEVS_TOPOLOGY_HCCS     0x01ULL  // 通过HCCS连接，HCCS是Huawei Cache Coherence System（华为缓存一致性系统），用于CPU/NPU之间的高速互联
#define ACL_RT_DEVS_TOPOLOGY_PIX      0x02ULL  // 通过同一个PCIe Switch连接
#define ACL_RT_DEVS_TOPOLOGY_PIB      0x04ULL  // 预留值
#define ACL_RT_DEVS_TOPOLOGY_PHB      0x08ULL  // 通过PCIe Host Bridge连接
#define ACL_RT_DEVS_TOPOLOGY_SYS      0x10ULL  // 通过SMP（Symmetric Multiprocessing）连接，NUMA节点之间通过SMP互连 
#define ACL_RT_DEVS_TOPOLOGY_SIO      0x20ULL  // 片内连接方式，两个DIE之间通过该方式连接
#define ACL_RT_DEVS_TOPOLOGY_HCCS_SW  0x40ULL  // 通过HCCS Switch连接

返回值说明

返回0表示成功，返回其他值表示失败，请参见aclError。

父主题： Device管理