dcmi_get_board_id

函数原型

int dcmi_get_board_id(int card_id, int device_id, int *board_id)

功能说明

获取指定设备的Board ID信息。

参数说明

参数名称	输入/输出	类型	描述
card_id	输入	int	设备ID，当前实际支持的ID通过dcmi_get_card_num_list接口获取。
device_id	输入	int	芯片ID，通过dcmi_get_device_id_in_card接口获取。取值范围如下： NPU芯片：[0, device_id_max-1]。 MCU芯片：mcu_id。说明： device_id_max值为1，当device_id为0时表示NPU芯片；当device_id为1时表示MCU芯片。
board_id	输出	int *	Board ID信息。

参数名称

输入/输出

类型

描述

card_id

输入

int

设备ID，当前实际支持的ID通过dcmi_get_card_num_list接口获取。

device_id

输入

int

芯片ID，通过dcmi_get_device_id_in_card接口获取。取值范围如下：

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

MCU芯片：mcu_id。

说明：

device_id_max值为1，当device_id为0时表示NPU芯片；当device_id为1时表示MCU芯片。

board_id

输出

int *

Board ID信息。

返回值说明

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

异常处理

无。

约束说明

该接口在后续版本将会删除，推荐使用dcmi_get_device_board_id。

表 1 不同部署场景下的支持情况

产品形态	物理机场景（裸机）root用户	物理机场景（裸机）运行用户组（非root用户）	物理机+普通容器场景root用户
Atlas 900 A2 PoD 集群基础单元	Y	Y	Y
Atlas 800T A2 训练服务器	Y	Y	Y
Atlas 800I A2 推理服务器	Y	Y	Y
Atlas 200T A2 Box16 异构子框	Y	Y	Y
A200I A2 Box 异构组件	Y	Y	Y
Atlas 300I A2 推理卡	Y	Y	Y
Atlas 300T A2 训练卡	Y	Y	Y
注：Y表示支持；N表示不支持；NA表示不涉及，当前未规划此场景。

调用示例

… 
int ret = 0;
int card_id = 0;
int device_id = 0;
int board_id = 0;
ret = dcmi_get_board_id(card_id, device_id, &board_id);
…