dcmi_get_user_config接口原型

函数原型

int dcmi_get_user_config(int card_id, int device_id, const char *config_name, unsigned int buf_size, unsigned char *buf)

功能说明

获取用户配置。

参数说明

参数名称	输入/输出	类型	描述
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]。
config_name	输入	const char *	目前支持处理的配置项名称如下，配置项名称的字符串长度最大为32。支持用户自定义名称配置。已实现功能的配置项：ddr_ecc_enable、cpu_num_cfg。配置项功能说明如下： "ddr_ecc_enable"：用于使能或禁用ECC。 "cpu_num_cfg"：用于系统cpu配比设置。
buf_size	输入	unsigned int	buf长度，最大长度为1K byte。该参数的配置，请参见dcmi_set_device_user_config接口原型。
buf	输出	unsigned char *	buf指针，指向配置项内容。具体配置项内容的含义，请参见dcmi_set_device_user_config接口原型。

返回值说明

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

异常处理

无。

约束说明

在Atlas 200I A2 加速模块产品中，该接口需调入TEEOS，耗时较长，不支持在接口调用时触发休眠唤醒，如果触发休眠，有较大可能造成休眠失败。

表1 不同部署场景下的支持情况
物理机场景（裸机）		物理机+普通容器场景
root用户	运行用户组（非root用户）	root用户
Y	Y	Y
注：Y表示支持；N表示不支持；NA表示不涉及，当前未规划此场景。

调用示例

… 
#define BUF_SIZE 16
int ret = 0;
int card_id = 0;
int device_id = 0;
const char *config_name = "cpu_num_cfg";
unsigned char buf[BUF_SIZE] = {0};
ret=dcmi_get_user_config(card_id, device_id, config_name, BUF_SIZE, buf);
if (ret != 0) {
    //todo:记录日志
    return ret;
}
…

父主题： 配置管理接口