CANN驱动DCMI用户配置重置API

📅 2026/7/12 4:40:03 👁️ 阅读次数 📝 编程学习
CANN驱动DCMI用户配置重置API

dcmi_clear_device_user_config

【免费下载链接】driver本项目是CANN提供的驱动模块,实现基础驱动和资源管理及调度等功能,使能昇腾芯片。项目地址: https://gitcode.com/cann/driver

函数原型

int dcmi_clear_device_user_config(int card_id, int device_id, const char *config_name)

功能说明

重置用户配置。

默认值请参见dcmi_set_device_user_config。

参数说明

参数名称

输入/输出

类型

描述

card_id

输入

int

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

device_id

输入

int

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

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

config_name

输入

const char *

目前支持处理的配置项名称如下,配置项名称的字符串长度最大为32。

已实现功能的配置项:mac_info。支持用户自定义名称配置。

配置项功能说明如下:

"mac_info" :用于设置MAC地址。

返回值说明

类型

描述

int

处理结果:

  • 成功:返回0。
  • 失败:返回码请参见return_codes。

异常处理

无。

约束说明

该接口设置的内容会涉及Flash擦写,由于Flash擦写次数是有限制的,所以不建议频繁调用该接口。

该接口需调入TEEOS,耗时较长,不支持在接口调用时触发休眠唤醒,如果触发休眠,有较大可能造成休眠失败。

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

产品形态

物理机场景(裸机)root用户

物理机场景(裸机)运行用户组(非root用户)

物理机+普通容器场景root用户

Atlas 900 A2 PoD 集群基础单元

Y

N

N

Atlas 800T A2 训练服务器

Y

N

N

Atlas 800I A2 推理服务器

Y

N

N

Atlas 200T A2 Box16 异构子框

Y

N

N

A200I A2 Box 异构组件

Y

N

N

Atlas 300I A2 推理卡

Y

N

N

Atlas 300T A2 训练卡

Y

N

N

注:Y表示支持;N表示不支持;NA表示不涉及,当前未规划此场景。

调用示例

… int ret = 0; int card_id = 0; int device_id = 0; const char *config_name = "mac_info"; ret = dcmi_clear_device_user_config(card_id, device_id, config_name); if (ret != 0) { //todo:记录日志 return ret; } …

【免费下载链接】driver本项目是CANN提供的驱动模块,实现基础驱动和资源管理及调度等功能,使能昇腾芯片。项目地址: https://gitcode.com/cann/driver

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考