CANN驱动虚拟设备创建API

dcmi_create_vdevice【免费下载链接】driver本项目是CANN提供的驱动模块实现基础驱动和资源管理及调度等功能使能昇腾芯片。项目地址: https://gitcode.com/cann/driver函数原型int dcmi_create_vdevice(int card_id, int device_id, struct dcmi_create_vdev_res_stru*vdev, struct dcmi_create_vdev_out *out)功能说明创建指定NPU单元的vNPU设备。参数说明参数名称输入/输出类型描述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]。说明device_id_max值为1当device_id为0时表示NPU芯片当device_id为1时表示MCU芯片。vdev输入struct dcmi_create_vdev_res_stru*输入创建虚拟设备信息。struct dcmi_create_vdev_res_stru {unsigned int vdev_id;unsigned int vfg_id;char template_name[32];unsigned char reserved[64];};说明vdev_id表示指定虚拟设备对应的虚拟设备ID默认自动分配默认值为0xFFFFFFFF。vfg_id表示指定虚拟设备所属的虚拟分组ID默认自动分配默认值为0xFFFFFFFF。vfg_id为预留参数。template_name表示昇腾虚拟化实例AVI模板名称。可通过npu-smi info -t template-info -i命令查询其详细信息。其中xxxB4可通过npu-smi info命令Name字段信息获取。回显中xxxB4产品有如下昇腾虚拟化实例AVI模板vir10_3c_32gvir05_1c_16greserved表示预留参数。out输出struct dcmi_create_vdev_out *输出创建的虚拟设备信息。当前只支持vdev_id。struct dcmi_create_vdev_out {unsigned int vdev_id;unsigned int pcie_bus;unsigned int pcie_device;unsigned int pcie_func;unsigned int vfg_id;unsigned char reserved[DCMI_VDEV_FOR_RESERVE];};说明vdev_id表示指定虚拟设备对应的虚拟设备ID默认自动分配默认值为0xFFFFFFFF。vfg_id表示指定虚拟设备所属的虚拟分组ID默认自动分配默认值为0xFFFFFFFF。pcie_bus、pcie_device、pcie_func、vfg_id为预留参数。返回值说明类型描述int处理结果成功返回0。失败返回码请参见return_codes。异常处理无。约束说明表 1不同部署场景下的支持情况产品形态物理机场景裸机root用户物理机场景裸机运行用户组非root用户物理机普通容器场景root用户Atlas 900 A2 PoD 集群基础单元NANANAAtlas 800T A2 训练服务器NANANAAtlas 800I A2 推理服务器YNNAtlas 200T A2 Box16 异构子框NANANAA200I A2 Box 异构组件NANANAAtlas 300I A2 推理卡NANANAAtlas 300T A2 训练卡NANANA注Y表示支持N表示不支持NA表示不涉及当前未规划此场景。调用示例int card_id 0; int device_id 0; struct dcmi_create_vdev_out out {0}; int ret; struct dcmi_create_vdev_res_stru vdev {0}; vdev.vdev_id 0xFFFFFFFF; strncpy_s(vdev.template_name, sizeof(vdev.template_name), vir10_3c_32g, strlen(vir10_3c_32g)); ret dcmi_create_vdevice(card_id, device_id, vdev, out); if (ret ! 0) { //todo return ret; }【免费下载链接】driver本项目是CANN提供的驱动模块实现基础驱动和资源管理及调度等功能使能昇腾芯片。项目地址: https://gitcode.com/cann/driver创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考