CANN驱动设备兼容查询-创锋一号

dcmi_get_device_compatibility

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

函数原型

int dcmi_get_device_compatibility (int card_id, int device_id, enum dcmi_device_compat *compatibility)

功能说明

查询NPU芯片驱动与固件兼容性。

参数说明

参数名称	输入/输出	类型	描述
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]。说明： device_id_max值为1，当device_id为0时表示NPU芯片；当device_id为1时表示MCU芯片。
compatibility	输出	enum dcmi_device_compat *	enum dcmi_device_compat{ DCMI_COMPAT_OK = 1, DCMI_COMPAT_NOK = 2, DCMI_COMPAT_UNKNOWN = 3 }; 输出说明如下： DCMI_COMPAT_OK (1) 表示NPU驱动和NPU固件兼容。 DCMI_COMPAT_NOK (2) 表示NPU驱动和NPU固件不兼容。 DCMI_COMPAT_UNKNOWN (3) 表示NPU驱动和NPU固件配套关系未知。说明：当安装或升级固件run包异常时，或使用NPU 23.0.RC2之前版本的固件run包时，会出现DCMI_COMPAT_UNKNOWN的情况。

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

device_id

输入

int

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

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

说明：

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

compatibility

输出

enum dcmi_device_compat *

enum dcmi_device_compat{

DCMI_COMPAT_OK = 1,

DCMI_COMPAT_NOK = 2,

DCMI_COMPAT_UNKNOWN = 3

};

输出说明如下：

DCMI_COMPAT_OK (1) 表示NPU驱动和NPU固件兼容。
DCMI_COMPAT_NOK (2) 表示NPU驱动和NPU固件不兼容。
DCMI_COMPAT_UNKNOWN (3) 表示NPU驱动和NPU固件配套关系未知。

说明：

当安装或升级固件run包异常时，或使用NPU 23.0.RC2之前版本的固件run包时，会出现DCMI_COMPAT_UNKNOWN的情况。

返回值说明

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

异常处理

无。

约束说明

调用该接口前NPU固件和NPU驱动的安装升级必须生效。

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

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

调用示例

int ret = 0; int card_id = 0; int device_id = 0; enum dcmi_device_compat compatibility = DCMI_COMPAT_UNKNOWN; ret = dcmi_get_device_compatibility (card_id, device_id, & compatibility); …

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

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业官网建设流程全解析

dcmi_get_device_compatibility

热门文章

文章分类

标签云

需要专业的网站建设服务？

企业官网建设流程全解析

dcmi_get_device_compatibility

热门文章

文章分类

标签云

相关文章

CANN/hccl通信算法配置指南

多模态AI对齐技术：从CLIP对比学习到图文检索实战

图片换背景底色怎么制作？2026年最全工具对比和实战指南

需要专业的网站建设服务？