1.1. DOCA 框架（DOCA Framework）

本页概述 NVIDIA DOCA 框架，包括其架构、安装包和软件组件等详细信息。

原文：https://networking-docs.nvidia.com/doca/archive/3-5-0/doca-framework
页面最后更新：2026 年 9 月 8 日

简介

DOCA 框架提供了一套完整的软件套件，包含驱动程序、库、工具和底层软件，用于与硬件设备以及随 BlueField 预装的默认操作系统进行交互。

DOCA 框架并非单一的安装包，而是 DOCA 相关软件组件的集合，通过两个主要软件包进行分发：DOCA-Host 和 BlueField-Bundle。

该框架由两大部分组成：

组成部分说明
DOCA SDK使开发者能够在 NVIDIA® BlueField® 网络平台上快速构建应用和服务，充分利用行业标准 API 以及 NVIDIA BlueField DPU 和 SuperNIC 的强大能力。
DOCA SDK 文档见相应章节。
BlueField 平台软件提供 BlueField 设备启动和配置所必需的基础组件，包括引导加载程序（bootloader）、固件，以及官方基于 Ubuntu 的参考 Linux 发行版。其中包含 ATF/UEFI、BMC 固件和 BlueField 网卡固件。
BlueField 平台软件文档见相应章节。

DOCA 软件包

为了确保在主机和设备上获得最佳的 DOCA 安装效果，DOCA 提供了以下各小节介绍的安装包。

DOCA-Host

DOCA-Host 是安装在主机服务器上的软件包，用于支持 NVIDIA 设备，包括 BlueField 和 ConnectX。

DOCA-Host 提供多种安装配置文件（profile），每种都针对特定用例量身定制：

  • doca-all
  • doca-networking
  • doca-ofed

有关安装配置文件及受支持主机操作系统的详细信息，请参阅相应章节（DOCA Profiles）。

BlueField-Bundle（BF-Bundle）

BlueField 软件包（BF-Bundle）安装在 BlueField 的 Arm 核心上，用于在 BlueField 网络平台上提供完整的 DOCA 体验。BlueField 设备出厂时已预装 BF-Bundle。

BF-Bundle 包含：

  • DOCA SDK 库、驱动程序和工具
  • BlueField 平台软件
  • BlueField Arm 核心的默认操作系统（Ubuntu 22.04）

BlueField 固件包（BF-FWBundle）

BlueField 固件包（BF-FWBundle）是安装在 BlueField Arm 核心上的最小化软件包。它仅提供外部配置（provisioning）和软件加载所需的管理接口。

BF-FWBundle 包含：

  • ATF
  • UEFI
  • BlueField 网卡固件
  • BMC 固件
  • eROT 固件

BF-FWBundle 不包含：

  • DOCA SDK
  • BlueField Arm 核心的操作系统

BlueField 设备

BlueField 用户手册提供了有关安装、支持的接口、规格参数和故障排除的详细说明。

2.1. DOCA 概述（DOCA Overview）

本页概述 NVIDIA DOCA 文档的结构。它将引导您了解 DOCA 开发者专区门户，其中包含有关 NVIDIA DOCA 工具包的全部信息，为您提供开发 NVIDIA® BlueField® 加速应用以及主机端驱动程序所需的一切内容。

原文：https://networking-docs.nvidia.com/doca/archive/3-5-0/doca-overview
页面最后更新：2026 年 9 月 1 日

简介

NVIDIA DOCA™ 框架使开发者能够借助行业标准 API，在 BlueField 网络平台之上快速创建和管理应用与服务。借助 DOCA，开发者可以利用 NVIDIA BlueField 数据处理器（DPU）和 SuperNIC 的强大能力，实现突破性的网络、安全和存储性能。在主机上安装 DOCA 即可获得管理 NVIDIA® BlueField® 和 NVIDIA® ConnectX® 设备所需的所有驱动程序和工具。

DOCA 框架包含面向主机的 DOCA-Host 软件包，以及面向 BlueField Arm 的 BlueField 软件包：

  • BlueField 软件包（BF-Bundle）：安装在 BlueField Arm 核心上的软件包
  • DOCA-Host：安装在主机服务器上的软件包，包含不同的 DOCA 安装配置文件（profile）

BlueField 软件包包含：

  • 安装在 BlueField 平台之上的 DOCA 运行时驱动程序和库
  • 安装在 BlueField 平台上的操作系统
  • BlueField 平台软件（即固件和 UEFI 引导加载程序）

DOCA 通过专用的 DOCA-Host 软件包安装，为搭载 NVIDIA 网络平台（即 BlueField 和 ConnectX）的主机提供所需的全部库和驱动程序。

搭载 NVIDIA BlueField 的服务器与 BlueField DPU 卡

DOCA 包含运行时环境和开发环境，其中包括用于设备管理和可编程能力的库与驱动程序，既可用于主机，也作为 BlueField 平台软件的一部分提供。

NVIDIA DOCA 软件栈：DOCA 服务、DOCA 库、DOCA 驱动，运行于 NVIDIA BlueField / ConnectX 之上

DOCA 是 BlueField 主要硬件实体的软件基础设施：

NVIDIA BlueField DPU 架构：Arm 子系统、加速器、可编程加速管线、数据路径加速器（DPA）等

安装

主机端和 BlueField 镜像的安装说明均可在《DOCA Linux 安装指南》中找到。

无论 DOCA 安装在主机上还是 BlueField 网络平台上，都可以在 /opt/mellanox/doca 目录下找到各个 DOCA 组件。其中包括传统的 SDK 相关组件（库、头文件等），以及本文档所述的 DOCA 示例（samples）、应用（applications）、工具（tools）等内容。

API

DOCA SDK 围绕各个 DOCA 库构建，这些库旨在充分发挥 BlueField 的能力。在**编程指南（Programming Guide）**章节中，可以找到每个 DOCA 库的详细说明，包括其设计目标和 API。这些指南记录了 DOCA 的 API，旨在帮助开发基于 DOCA 的程序。

**API 参考（API References）**章节收录了由 Doxygen 生成的 DOCA 官方 API 文档。

编程指南

DOCA 编程指南提供了 DOCA 库及其 API 的完整全貌。每份指南都包含简介、架构、API 概览以及其他特定于该库的信息。

每个库的编程指南都包含用于完成基本 DOCA 任务的代码片段。建议在阅读相关 DOCA 库编程指南的同时参考这些示例，以学习其 API。这些示例提供了某一 DOCA 库单个功能的实现示范。

如需更详细地参考使用多个 DOCA 库的完整 DOCA 程序，请参阅**参考应用（Reference Applications）**章节。

应用

应用（Applications）是比示例（samples）更高层次的参考代码，展示了如何构建完整的 DOCA 程序。除了提供源代码和编译定义外，这些应用还以编译好的二进制形式随附发布。这样用户可以直接开箱即用地体验 DOCA 程序，无需经历面向开发者的编译过程。

许多 DOCA 应用结合了多个 DOCA 库的功能，并针对用户关注的常见场景提供了实现示例，例如根据进出流量进行应用识别、使用硬件正则表达式（RegEx）加速扫描文件等等。

有关 DOCA 应用的更多信息，请参阅 **DOCA 参考应用（DOCA Reference Applications）**章节。

工具

部分 DOCA 库随附了面向运行时和开发的辅助工具。这些工具通常是库自身 API 的扩展，用于弥合库所期望的输入格式与用户实际可用输入之间的差距。

有关 DOCA 工具的更多信息，请参阅 **DOCA 工具（DOCA Tools）**章节。

服务

DOCA 服务（Services）是容器化的 DOCA 程序，针对特定用例提供端到端的解决方案。DOCA 服务通过 NVIDIA 容器目录（NGC）提供，可以轻松地从中直接部署到 BlueField，某些服务也可以部署到主机。

有关向 BlueField 平台进行容器化部署的更多信息，请参阅《DOCA 容器部署指南》。

有关 DOCA 服务的更多信息，请参阅 **DOCA 服务（DOCA Services）**章节。

2.2. DOCA 发行说明（DOCA Release Notes）

NVIDIA DOCA™ SDK 发行说明包含有关新功能、软件互操作性和已知问题的信息。

原文：https://networking-docs.nvidia.com/doca/archive/3-5-0/doca-release-notes
页面最后更新：2026 年 9 月 8 日

简介

DOCA 发行说明包含以下子页面：

安装注意事项

NVIDIA® BlueField®-3 设备不支持将 MLNX_OFED 作为主机端驱动程序，必须使用 DOCA-Host。

以下 SKU 的 BlueField DPU 在通电时需要连接 8 针 ATX 电源线。如果未连接该电源线，设备将无法完成上电流程，无法正常工作。

  • B3220 DPU —— 900-9D3B6-00CV-AA0 和 900-9D3B6-00SV-AA0
  • B3240 DPU —— 900-9D3B6-00CN-AB0 和 900-9D3B6-00SN-AB0
  • B3210 DPU —— 900-9D3B6-00CC-AA0 和 900-9D3B6-00SC-AA0
  • B3210E DPU —— 900-9D3B6-00CC-EA0 和 900-9D3B6-00SC-EA0

有关以下内容的信息，请参阅《DOCA Linux 安装指南》：

  • 在 BlueField 网络平台或 SmartNIC 上安装 DOCA SDK
  • 支持的 BlueField 平台

DOCA Runtime 与 DOCA Devel（SDK）

默认情况下，使用标准 Linux 工具（yum、apt）安装 DOCA 配置文件（profile）时，会同时安装 doca-runtime 和 doca-devel（此前称为 doca-sdk）。

  • doca-runtime 包含 DOCA 管理员在生产环境中使用的所有组件、库、驱动程序和工具
  • doca-devel 包含用于开发的所有组件、库、驱动程序和工具，包括参考应用、编译器等

支持的设备速率

上行链路 / 适配卡驱动名称上行链路速率
BlueField-3mlx5- InfiniBand：SDR、FDR、EDR、HDR100、HDR、NDR200、NDR
- 以太网：1GbE、10GbE、25GbE、40GbE、50GbE、100GbE、200GbE、400GbE
BlueField-2mlx5- InfiniBand：SDR、FDR、EDR、HDR
- 以太网：1GbE、10GbE、25GbE、40GbE、50GbE[1]、100GbE[1]
BlueFieldmlx5- InfiniBand：SDR、QDR、FDR、FDR10、EDR
- 以太网：1GbE、10GbE、25GbE、40GbE、50GbE、100GbE
ConnectX-9mlx5- InfiniBand：XDR、NDR、NDR200、HDR、HDR100
- 以太网：800GbE、400GbE、200GbE、100GbE
ConnectX-8mlx5- InfiniBand：SDR、FDR、EDR、HDR100、HDR、NDR200、NDR、XDR
- 以太网：1GbE、10GbE、25GbE、40GbE、50GbE、100GbE、200GbE、400GbE
ConnectX-7mlx5- InfiniBand：EDR、HDR100、HDR、NDR200、NDR
- 以太网：1GbE、10GbE、25GbE、40GbE、50GbE[1]、100GbE[1]、200GbE[2]、400GbE
ConnectX-6 Lxmlx5- 以太网：1GbE、10GbE、25GbE、40GbE、50GbE[1]
ConnectX-6 Dxmlx5- 以太网：10GbE、25GbE、40GbE、50GbE[1]、100GbE[1]、200GbE[1]
ConnectX-6mlx5- InfiniBand：SDR、FDR、EDR、HDR
- 以太网：10GbE、25GbE、40GbE、50GbE[1]、100GbE[1]、200GbE[1]
ConnectX-5 / ConnectX-5 Exmlx5- InfiniBand：SDR、QDR、FDR、FDR10、EDR
- 以太网：1GbE、10GbE、25GbE、40GbE、50GbE、100GbE
ConnectX-4 Lxmlx5- 以太网：1GbE、10GbE、25GbE、40GbE、50GbE
ConnectX-4mlx5- InfiniBand：SDR、QDR、FDR、FDR10、EDR
- 以太网：1GbE、10GbE、25GbE、40GbE、50GbE、56GbE[3]、100GbE

[1] 在强制（Force）模式和自动协商（Auto-Negotiation）模式下均支持 NRZ 和 PAM4 两种调制模式的速率。

[2] 仅支持 PAM4 模式的速率。

[3] 56GbE 是 NVIDIA 专有的链路速率，可在 NVIDIA 适配卡连接 NVIDIA SX10XX 系列交换机时实现，也可在两块 NVIDIA 适配卡互连时实现。

技术支持

直接从 NVIDIA 购买产品的客户可以通过以下方式联系我们：

如果您购买了 NVIDIA M-1 全球支持服务，请参阅合同了解技术支持详情。

通过 NVIDIA 授权经销商购买产品的客户，应首先向经销商寻求帮助。

2.2.1 变更与新功能（Changes and New Features）

如果您在 Spectrum-X 参考架构中使用 BlueField FW Bundle / DOCA-Host，请参阅 NVIDIA Spectrum-X 验证解决方案栈（Validated Solution Stack）页面，了解已批准的产品发布版本列表。

原文：https://networking-docs.nvidia.com/doca/archive/3-5-0/changes-and-new-features
页面最后更新：2026 年 9 月 2 日

1. DOCA 框架新功能与更新

即将发生的设备支持变更： DOCA 3.6.0（2026 年 10 月）将是最后一个支持 ConnectX-4 Lx 和 ConnectX-5 设备的 DOCA 版本。作为长期支持（LTS）版本，DOCA 3.6.0 将在三年内持续获得缺陷修复和针对 CVE 的安全更新。从计划于 2027 年 1 月发布的 DOCA 4.0 开始，这些设备将不再受支持。

  • DOCA Argus
  • 现在无需主机端工具/代理即可提供关键的 GPU 指标。
  • 现在支持为不同容器提供不同的“运行时清单（runtime manifest）”。
  • 可以使用 Vector 可观测性工具发送数据。
  • DOCA Bridge
  • 移除了 DOCA 对 DPDK 的依赖（适用于不需要 DPDK 的客户）。
  • DOCA Ethernet
  • 新增 DOCA Ethernet 报文头数据拆分（header data-split）支持。
  • 新增 DOCA Ethernet 对数据内联（inline）到 WQE 的支持，提升性能。
  • DOCA 管理服务（DMS） [待确认*]
  • 新增面向 DMS 的 DOCA Core API，用于查询 native_port_num。*
  • 新增 doca_mgmt API 支持，可通过 libdms 和 CLI 解析 vhca_id。*
  • 更新 DMS 配置（provisioning）流程，改用原生 DMS API 替代 gNOI。*
  • OVS-DOCA
  • OVS-DOCA 现在支持 IPv6 连接跟踪（CT）。
  • 新增 OVS-DOCA API，可在 DOCA-CT 老化（aging）流程中禁用重置逻辑。
  • 新增 OVS-DOCA 对 B3220SH 存储控制器的支持。
  • OVS-DOCA 数据路径支持 DOCA Ethernet。
  • 新增 OVS-DOCA API，支持为 PMD 线程配置浮动 CPU（floating CPU）行为。
  • DOCA Telemetry（遥测）
  • DOCA Telemetry 库现在公开 RTT 计数器（硬件拥塞控制计数器）。
  • DOCA VERBs
  • DOCA VERBs 新增 DOCA Multi-Rail API，用于支持 VR [2:1] 场景的网卡韧性（NIC resiliency），以及面向非 NVIDIA 通信库的负载均衡（LB）。

2. DOCA-Host 与 DOCA 驱动新功能与更新

NVIDIA® BlueField®-3 网络平台必须使用 DOCA-Host 作为主机端驱动程序。MLNX_OFED 不支持 BlueField-3 设备。

  • 自适应重传（Adaptive-ReTransmission）相关 Q 计数器——自适应重传相关的 Q 计数器现在向所有功能类型（function type）公开，不再仅限于物理功能（PF）。这使得任何功能都可以查看和监控这些计数器，从而获得更好的可视性和诊断能力。
  • 快速注册内存区域（FRMR）池取代 MR 缓存——用新的通用快速注册内存区域（FRMR）池功能取代了原有的 MR 缓存机制，为内存注册过程中的资源创建提供了更好的驱动优化控制和可视性。用户可以通过 iproute2 中的用户态 RDMA 工具控制这些池，包括池的大小和老化时间（aging time）。

3. BlueField-3 固件变更与新功能

  • PCIe 带内 SPDM 认证（Attestation）——新增相关能力，允许主机通过 PCIe 带内通道访问 PSC 并执行 SPDM 认证。

4. BlueField-2 固件变更与新功能

无（N/A）

5. API 变更

下表详细列出了本 DOCA 版本引入的 API 变更：

库变更说明
待定（TBD）待定（TBD）

如需查看之前 DOCA 版本的 API 变更，请参阅相应归档版本的发行说明。

Logo
openEuler 社区

openEuler 是由开放原子开源基金会孵化的全场景开源操作系统项目，面向数字基础设施四大核心场景（服务器、云计算、边缘计算、嵌入式），全面支持 ARM、x86、RISC-V、loongArch、PowerPC、SW-64 等多样性计算架构

更多推荐

【无人机】四旋翼无人机的几何跟踪控制研究（Matlab代码实现）

四旋翼无人机的轨迹跟踪控制长期依赖欧拉角等局部坐标表示，但这类方法在剧烈机动或大角度姿态变化时会遭遇奇异性和万向节锁死问题。几何跟踪控制通过在SO(3)和SE(3)李群上直接设计控制律，从根本上规避了坐标奇异，并提供了几乎全局的稳定性保证。本文系统梳理了几何跟踪控制的理论基础、核心方法学进展与当前研究前沿。首先阐述四旋翼在SE(3)上的全局动力学建模及其微分平坦特性，分析欧拉角方法的固有局限。进而

avatar openEuler 社区

【无人机】四旋翼无人机的几何跟踪控制研究（Matlab代码实现）

四旋翼无人机的轨迹跟踪控制长期依赖欧拉角等局部坐标表示，但这类方法在剧烈机动或大角度姿态变化时会遭遇奇异性和万向节锁死问题。几何跟踪控制通过在SO(3)和SE(3)李群上直接设计控制律，从根本上规避了坐标奇异，并提供了几乎全局的稳定性保证。本文系统梳理了几何跟踪控制的理论基础、核心方法学进展与当前研究前沿。首先阐述四旋翼在SE(3)上的全局动力学建模及其微分平坦特性，分析欧拉角方法的固有局限。进而

avatar openEuler 社区

【无人机】四旋翼无人机的几何跟踪控制研究（Matlab代码实现）

四旋翼无人机的轨迹跟踪控制长期依赖欧拉角等局部坐标表示，但这类方法在剧烈机动或大角度姿态变化时会遭遇奇异性和万向节锁死问题。几何跟踪控制通过在SO(3)和SE(3)李群上直接设计控制律，从根本上规避了坐标奇异，并提供了几乎全局的稳定性保证。本文系统梳理了几何跟踪控制的理论基础、核心方法学进展与当前研究前沿。首先阐述四旋翼在SE(3)上的全局动力学建模及其微分平坦特性，分析欧拉角方法的固有局限。进而

avatar openEuler 社区