昇腾社区首页
中文
注册
开发者
下载

aclrtGetDevicesTopo

产品支持情况

产品

是否支持

Atlas A3 训练系列产品/Atlas A3 推理系列产品

Atlas A2 训练系列产品/Atlas A2 推理系列产品

Atlas 200I/500 A2 推理产品

Atlas 推理系列产品

Atlas 训练系列产品

须知:本接口不支持在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之间互联的拓扑关系。

  • ACL_RT_DEVS_TOPOLOGY_HCCS:通过HCCS连接。HCCS是Huawei Cache Coherence System(华为缓存一致性系统),用于CPU/NPU之间的高速互联。
  • ACL_RT_DEVS_TOPOLOGY_PIX:通过同一个PCIe Switch连接。
  • ACL_RT_DEVS_TOPOLOGY_PHB:通过PCIe Host Bridge连接。
  • ACL_RT_DEVS_TOPOLOGY_SYS:通过SMP(Symmetric Multiprocessing)连接,NUMA节点之间通过SMP互连。
  • ACL_RT_DEVS_TOPOLOGY_SIO:片内连接方式,两个DIE之间通过该方式连接。
  • ACL_RT_DEVS_TOPOLOGY_HCCS_SW:通过HCCS Switch连接。
  • ACL_RT_DEVS_TOPOLOGY_PIB:预留值,暂不支持。

宏定义如下:

#define ACL_RT_DEVS_TOPOLOGY_HCCS     0x01ULL
#define ACL_RT_DEVS_TOPOLOGY_PIX      0x02ULL
#define ACL_RT_DEVS_TOPOLOGY_PHB      0x08ULL
#define ACL_RT_DEVS_TOPOLOGY_SYS      0x10ULL
#define ACL_RT_DEVS_TOPOLOGY_SIO      0x20ULL
#define ACL_RT_DEVS_TOPOLOGY_HCCS_SW  0x40ULL
#define ACL_RT_DEVS_TOPOLOGY_PIB      0x04ULL

返回值说明

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