Star218

Star218

cann-robotDES:sync_20260326

29b54652创建于 3月27日历史提交

接口列表

接口说明

简介

本文档详细的描述了DCMI（DaVinci Card Management Interface）接口，用户可使用这些接口进行设备管理、配置管理、芯片复位启动等操作。
DCMI（DaVinci Card Management Interface）是NPU的设备管理API接口，在驱动安装完成后，可以使用该接口查询NPU设备的信息和使用情况，便于用户了解当前NPU的状态，并提供接口用于对NPU进行固件升级、清除设备信息、配置参数和资源复位等操作。用户可以根据业务需要，调用DCMI接口完成第三方系统二次集成开发。

文档适用说明

适用于Atlas 900 A3 SuperPoD 超节点、Atlas 9000 A3 SuperPoD 集群算力系统、Atlas 800I A3 超节点、Atlas 800T A3 超节点、A200T A3 Box8 超节点服务器。
由于Atlas 800I A3 超节点与Atlas 800I A3 标准服务器使用的Ascend HDK软件相同，因此本文以Atlas 800I A3 超节点统称，不作区分。

接口部署场景说明

如果部分部署场景在本文档的相关命令或接口描述中未提及，则表明该产品不涉及此场景，当前未规划。
本文档中“不同部署场景下的支持情况”表中的Y表示支持；N表示不支持；NA表示不涉及，当前未规划此场景。

表 1 部署场景分类定义及说明

部署场景分类	子场景分类	子场景说明
物理机场景^a	物理机场景（裸机）	NPU设备直接在物理机（裸机）上使用。
	物理机+普通容器场景	将物理机的NPU设备映射进普通容器中使用。
	物理机+特权容器场景	将物理机的NPU设备映射进特权容器中使用。
虚拟机场景^b	直通虚拟机场景	将单个物理NPU设备的资源全部分配给虚拟机使用，该虚拟机独占单个NPU资源。主要涉及整机全部NPU设备直通（整卡直通）、部分NPU设备直通（部分卡直通）、单个NPU设备直通（单卡直通）等不同使用场景。
	直通虚拟机+普通容器场景	将单个物理NPU设备的资源全部分配给虚拟机，然后将NPU设备资源映射进该虚拟机创建的普通容器中使用。
	直通虚拟机+特权容器场景	将单个物理NPU设备的资源全部分配给虚拟机，然后将NPU设备资源映射进该虚拟机创建的特权容器中使用。
昇腾虚拟化实例^c（全称Ascend Virtual Instance，简称为AVI）	物理机+容器AVI场景	在物理机上通过npu-smi工具或DCMI API接口对NPU硬件资源根据用户指定的需求划分出vNPU，将创建的vNPU挂载到容器中使用。
	物理机+虚拟机AVI场景	在物理机上通过npu-smi工具或DCMI API接口对NPU硬件资源根据用户指定的需求划分出vNPU，将创建的vNPU分配给虚拟机使用。单个vNPU只能给单个虚拟机使用，但是单个虚拟机可以挂载多个vNPU。
	虚拟机+容器AVI场景	在物理机上通过npu-smi或者DCMI API接口对NPU硬件资源根据用户指定的需求划分出vNPU，通过虚拟机挂载指定的vNPU资源，然后在虚拟机内部进一步将创建的vNPU挂载到容器中使用。
	直通虚拟机+容器AVI场景	将单个物理NPU设备的资源全部分配给虚拟机后，先在虚拟机上通过npu-smi或者DCMI API接口对NPU资源根据用户指定的需求划分出vNPU，再映射到容器中使用。
a：指在物理机环境中操作NPU资源的场景，包括物理机和物理机+容器。 b：指在虚拟机环境中操作NPU资源的场景，包括直通虚拟机和直通虚拟机+容器。 c：指通过资源虚拟化技术将1个NPU切分成若干个vNPU（虚拟NPU）实例挂载到虚拟机或容器中使用，使得1个NPU同时支持多个计算调度任务。AVI通过算力资源切分的方式，实现了资源虚拟化复用并保证了资源的安全隔离，大大降低了用户使用NPU算力的门槛和成本，并且支持多租户按需进行资源申请或回收管理。

接口使用注意事项

不支持多线程并发使用DCMI接口。
建议用户在对应的执行环境上编译DCMI相关的可执行文件，否则可能会出现glibc版本前后不兼容的情况。
DSMI接口从1.0.10版本开始废弃，计划于2023年版本不再提供，请使用对应的DCMI接口进行替代。
本文涉及的容器场景除特殊说明外，均指普通容器。

芯片复位接口说明

带内复位：通过PCIe标准热复位流程复位昇腾AI处理器。使用接口： dcmi_set_device_reset（channel_type设置为1）
调用芯片复位接口前，请停掉该芯片的NPU相关业务，NPU相关业务可通过fuser软件查询，具体参考查询NPU业务进程。
调用dcmi_set_device_reset接口之后需等待3秒，才可调用dcmi_set_device_rescan接口。