dcmi_get_topo_info_by_device_id接口原型

函数原型

int dcmi_get_topo_info_by_device_id (int card_id1, int device_id1, int card_id2, int device_id2, int * topo_type)

功能说明

查询指定两个Device之间的拓扑关系。

参数说明

参数名称	输入/输出	类型	描述
card_id1/card_id2	输入	int	指定NPU管理单元的ID，当前实际支持的ID通过dcmi_get_card_list接口获取。
device_id1/device_id2	输入	int	指定设备编号，通过dcmi_get_device_id_in_card接口获取。
topo_type	输出	int *	输出Device之间拓扑关系的数值，对应关系如下： typedef enum { DCMI_TOPO_TYPE_SELF = 0,/芯片本身/ DCMI_TOPO_TYPE_SYS,/通过PCIe连接且穿过NUMA nodes，nodes之间通过SMP连接，如：QPI、UPI/ DCMI_TOPO_TYPE_PHB,/通过PCIe连接且穿过同一个CPU的PCIe host bridge/ DCMI_TOPO_TYPE_HCCS,/通过HCCS链接/ DCMI_TOPO_TYPE_PXB,/通过PCIe连接穿过多个PCIe switch/ DCMI_TOPO_TYPE_PIX,/通过PCIe连接穿过一个PCIe switch/ DCMI_TOPO_TYPE_BUTT = 6,/未知关系/ DCMI_TOPO_TYOE_MAX, };

参数名称

输入/输出

类型

描述

card_id1/card_id2

输入

int

指定NPU管理单元的ID，当前实际支持的ID通过dcmi_get_card_list接口获取。

device_id1/device_id2

输入

int

指定设备编号，通过dcmi_get_device_id_in_card接口获取。

topo_type

输出

int *

输出Device之间拓扑关系的数值，对应关系如下：

typedef enum {

DCMI_TOPO_TYPE_SELF = 0,/*芯片本身*/

DCMI_TOPO_TYPE_SYS,/*通过PCIe连接且穿过NUMA nodes，nodes之间通过SMP连接，如：QPI、UPI*/

DCMI_TOPO_TYPE_PHB,/*通过PCIe连接且穿过同一个CPU的PCIe host bridge*/

DCMI_TOPO_TYPE_HCCS,/*通过HCCS链接*/

DCMI_TOPO_TYPE_PXB,/*通过PCIe连接穿过多个PCIe switch*/

DCMI_TOPO_TYPE_PIX,/*通过PCIe连接穿过一个PCIe switch*/

DCMI_TOPO_TYPE_BUTT = 6,/*未知关系*/

DCMI_TOPO_TYOE_MAX,

};

返回值

类型	描述
int	处理结果：成功：返回0。失败：返回码请参见返回码。

异常处理

无。

约束说明

表1 部署场景
Linux物理机		Linux物理机容器
root用户	运行用户组（非root用户）	root用户
N	N	N

调用示例

…
int ret = 0;
int card_id1 = 0;
int card_id2 = 1;
int device_id1 = 0;
int device_id2 = 1;
int result;
ret = dcmi_get_topo_info_by_device_id(card_id1, device_id1, card_id2, device_id2, &result); 
…