driver

🔥Latest News

• [2026/06] 增加昇腾A5芯片（UB形态）支持；

• [2026/03] 增加昇腾A5芯片（PCIE形态）支持

• [2025/12] driver项目首次上线；

🚀概述

Driver 仓的代码是 CANN（Compute Architecture for Neural Networks）的驱动模块，提供基础驱动和资源管理及调度等功能，使能昇腾芯片。当前开源仓内主要包含了如图所示三部分内容：DCMI 层（DaVinci Card Management Interface，达芬奇卡管理接口层）、HAL 层（Hardware Abstraction Layer，硬件抽象层）和 SDK-driver 层（Driver Software Development Kit，驱动软件开发套件层）。

Driver 在 CANN 软件栈的位置参考昇腾社区的描述。

📖模块介绍

• RoCE（RDMA over Converged Ethernet）：昇腾 AI 处理器平台中的RoCE模块，用于减少延迟和提高数据传输效率。
• SVM (Shared Virtual Memory) ：昇腾 AI 处理器平台中的内存管理模块，用于高效管理设备侧内存。

⚡️快速入门

若您希望快速体验driver的调用和开发过程，请访问如下文档获取简易教程。

• QUICKSTART：端到端快速上手指南，包括搭建环境、编译部署、源码开发、调试、贡献等过程。
• 参考用例：介绍设备管理等模块基础用例。

🔍FAQ

• FAQ：汇总了源码编译、安装部署等问题(持续)。

📝目录结构

关键目录结构如下：

├── build.sh                                       # 项目工程编译脚本
├── cmake                                          # 工程编译目录
├── CMakeLists.txt                                 # 项目工程CMakeLists入口
├── CONTRIBUTING.md                                # 社区贡献指导
├── docs                                           # 说明文档
├── examples                                       # 接口使用样例
├── pkg_inc                                        # 本仓对外提供的头文件
├── LICENSES                                       # 本仓涉及协议目录
├── OAT.xml                                        # 配置脚本，代码仓工具使用，用于检查License是否规范
├── README.md
├── scripts                                        # 本仓脚本目录
│   ├── package                                    # 构建打包相关脚本
│   ├── ut                                         # UT生成cpp覆盖率脚本
├── SECURITY.md                                    # 项目安全声明文件
├── Third_Party_Open_Source_Software_Notice        # 本仓引用的第三方开源软件声明
├── src                                            # Driver包源码
│   ├── ascend_hal                                 # HAL层源码文件夹
│   │   ├── bbox                                   # 黑匣子（Black Box，系统临终遗言）
│   │   ├── buff                                   # 进程间共享内存管理
│   │   ├── build                                  # ascend_hal动态库编译脚本
│   │   ├── comm                                   # Communication 主机侧<->设备侧通信层
│   │   ├── dmc                                    # DMC（Device Maintenance Components）设备维护组件
│   │   │   ├── device_monitor                     # DSMI消息通路
│   │   │   ├── dsmi                               # DSMI（Device System Management Interface）设备系统管理接口
│   │   │   ├── logdrv                             # Log日志
│   │   │   ├── prof                               # Profiling性能采集
|   |   |   ├── prof_sample                        # Profiling Host侧采集注册
│   │   │   └── verify_tool                        # 设备侧镜像校验工具
│   │   ├── dms                                    # DMS（Device Management System）设备管理系统
│   │   ├── dpa                                    # DPA（Device Public Adapter）设备公共适配层
│   │   ├── esched                                 # 事件调度（Event Schedule）
│   │   ├── hdc                                    # 主机-设备通信（Host-Device Communication）
│   │   ├── inc                                    # HAL层内部公共头文件目录
│   │   ├── mmpa                                   # MMAP（Medium Multiple Platform Adaptive）基础系统接口库
│   │   ├── msnpureport                            # 设备侧维测信息导出工具
│   │   ├── pbl                                    # PBL（Public Base Lib）基础公共库
│   │   │   ├── uda                                # UDA（Unified Device Access）统一设备接入
│   │   │   ├── urd                                # URD（User Request Distribute）用户请求转发
│   │   │   ├── commlib                            # 公共函数库
│   │   │   ├── queryfeature                       # 用于兼容性适配的软件特性查询
|   |   |   └── ubmm                               # UB Memory Adapter
│   │   ├── queue                                  # 消息队列信息管理
│   │   ├── roce                                   # RoCE（RDMA over Converged Ethernet）
│   │   ├── svm                                    # 共享虚拟内存（Shared Virtual Memory）
│   │   └── trs                                    # 任务资源调度（Task Resource Schedule）
│   ├── custom                                     # 定制化特性源码库
│   │   ├── cmake                                  # CMake编译配置目录
│   │   ├── dev_prod                               # 设备定制管理目录
│   │   ├── include                                # 公共头文件导出目录
│   │   ├── lqdrv                                  # 灵渠PCIe故障检测
│   │   ├── ndr                                    # NPU RDMA直通特性
│   │   ├── network                                # DCMI网络接口实现
│   │   └── ops_debug                              # 算子诊断目录
│   └── sdk_driver                                 # SDK层源码文件夹
│       ├── buff                                   # 进程间共享内存管理
│       ├── comm                                   # Communication 主机侧<->设备侧通信层
│       ├── dmc                                    # DMC（Device Maintenance Components）设备维护组件
│       ├── dms                                    # DMS（Device Management System）设备管理系统
│       ├── dpa                                    # DPA（Device Public Adapter）设备公共适配层
│       ├── dvpp                                   # DVPP（Digital Vision Pre-Processing）数字视觉预处理模块
│       ├── esched                                 # 事件调度（Event Schedule）
│       ├── fms                                    # FMS（Fault Management System）故障管理系统
│       ├── hdc                                    # 主机-设备通信（Host-Device Communication）
│       ├── inc                                    # SDK层内部公共头文件目录
│       ├── kernel_adapt                           # SDK驱动代码与内核源码适配层
│       ├── pbl                                    # PBL（Public Base Lib）基础公共库
│       ├── platform                               # 芯片资源（中断、预留内存等）存储库
│       ├── queue                                  # 消息队列信息管理
|       ├── seclib                                 # 公共安全函数库（Secure Library）
│       ├── svm                                    # 共享虚拟内存（Shared Virtual Memory）
│       ├── ts_agent                               # TS（Task Schedule）代理驱动源码
│       ├── trsdrv                                 # TRS（Task Resource Schedule）软件sqcq通信、mailbox消息特性
│       │   ├── trs                                # 任务资源调度（Task Resource Schedule）
│       │   └── trsbase                            # 任务资源调度（Task Resource Schedule）基础层
│       ├── vascend                                # 昇腾算力切分特性
│       ├── vmng                                   # 设备虚拟化管理（Virtual Machine Manager）
│       ├── vnic                                   # VNIC（Virtual Network Interface Card）虚拟网卡
│       └── vpc                                    # VPC（Virtual Physical Communication）物理机与虚拟机通信
└── test                                           # UT用例文件目录

相关信息

• 贡献指南
• 安全声明
• 许可证

   CANN Open Software License Agreement Version 2.0

   GNU GENERAL PUBLIC LICENSE Version 2