dcmi_get_device_pcie_info_v2接口原型

函数原型

int dcmi_get_device_pcie_info_v2(int card_id, int device_id, struct dcmi_pcie_info_all *pcie_info)

功能说明

获取指定设备的PCIe信息，包括PCIe domain域信息。

参数说明

参数名称	输入/输出	类型	描述
card_id	输入	int	指定NPU管理单元的ID，当前实际支持的ID通过dcmi_get_card_list接口获取。
device_id	输入	int	指定设备编号，通过dcmi_get_device_id_in_card接口获取。取值范围如下： NPU芯片：[0, device_id_max-1]。
pcie_info	输出	struct dcmi_pcie_info_all *	PCIe信息 struct dcmi_pcie_info_all { unsigned int venderid; //厂商id unsigned int subvenderid; //厂商子id unsigned int deviceid; //设备id unsigned int subdeviceid; //设备子id int domain; //pcie domain unsigned int bdf_busid; //BDF（Bus，Device，Function）中的总线ID unsigned int bdf_deviceid; //BDF（Bus，Device，Function）中的设备ID unsigned int bdf_funcid; //BDF（Bus，Device，Function）中的功能ID unsigned char reserve[32]; };

参数名称

输入/输出

类型

描述

card_id

输入

int

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

device_id

输入

int

指定设备编号，通过dcmi_get_device_id_in_card接口获取。取值范围如下：

NPU芯片：[0, device_id_max-1]。

pcie_info

输出

struct dcmi_pcie_info_all *

PCIe信息

struct dcmi_pcie_info_all {

unsigned int venderid; //厂商id

unsigned int subvenderid; //厂商子id

unsigned int deviceid; //设备id

unsigned int subdeviceid; //设备子id

int domain; //pcie domain

unsigned int bdf_busid; //BDF（Bus，Device，Function）中的总线ID

unsigned int bdf_deviceid; //BDF（Bus，Device，Function）中的设备ID

unsigned int bdf_funcid; //BDF（Bus，Device，Function）中的功能ID

unsigned char reserve[32];

};

返回值

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

异常处理

无。

约束说明

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

调用示例

…  
int ret;
int card_id = 0;
int device_id = 0;
struct dcmi_pcie_info_all pcie_info = {0};
ret = dcmi_get_device_pcie_info_v2(card_id, device_id, &pcie_info);
…