
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-HostDOCA-Host 是安装在主机服务器上的软件包用于支持 NVIDIA 设备包括 BlueField 和 ConnectX。DOCA-Host 提供多种安装配置文件profile每种都针对特定用例量身定制doca-alldoca-networkingdoca-ofed有关安装配置文件及受支持主机操作系统的详细信息请参阅相应章节DOCA Profiles。BlueField-BundleBF-BundleBlueField 软件包BF-Bundle安装在 BlueField 的 Arm 核心上用于在 BlueField 网络平台上提供完整的 DOCA 体验。BlueField 设备出厂时已预装 BF-Bundle。BF-Bundle 包含DOCA SDK 库、驱动程序和工具BlueField 平台软件BlueField Arm 核心的默认操作系统Ubuntu 22.04BlueField 固件包BF-FWBundleBlueField 固件包BF-FWBundle是安装在 BlueField Arm 核心上的最小化软件包。它仅提供外部配置provisioning和软件加载所需的管理接口。BF-FWBundle 包含ATFUEFIBlueField 网卡固件BMC 固件eROT 固件BF-FWBundle不包含DOCA SDKBlueField 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 安装配置文件profileBlueField 软件包包含安装在 BlueField 平台之上的 DOCA 运行时驱动程序和库安装在 BlueField 平台上的操作系统BlueField 平台软件即固件和 UEFI 引导加载程序DOCA 通过专用的 DOCA-Host 软件包安装为搭载 NVIDIA 网络平台即 BlueField 和 ConnectX的主机提供所需的全部库和驱动程序。DOCA 包含运行时环境和开发环境其中包括用于设备管理和可编程能力的库与驱动程序既可用于主机也作为 BlueField 平台软件的一部分提供。DOCA 是 BlueField 主要硬件实体的软件基础设施安装主机端和 BlueField 镜像的安装说明均可在《DOCA Linux 安装指南》中找到。无论 DOCA 安装在主机上还是 BlueField 网络平台上都可以在/opt/mellanox/doca目录下找到各个 DOCA 组件。其中包括传统的 SDK 相关组件库、头文件等以及本文档所述的 DOCA 示例samples、应用applications、工具tools等内容。APIDOCA 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 NotesNVIDIA DOCA™ SDK 发行说明包含有关新功能、软件互操作性和已知问题的信息。原文https://networking-docs.nvidia.com/doca/archive/3-5-0/doca-release-notes页面最后更新2026 年 9 月 8 日简介DOCA 发行说明包含以下子页面变更与新功能Changes and New Features影响客户的变更已声明不支持的功能常规支持General Support本版本缺陷修复Bug Fixes in This Version已知问题Known IssuesBlueField 固件与线缆BlueField Firmware Cables安装注意事项NVIDIA® BlueField®-3 设备不支持将 MLNX_OFED 作为主机端驱动程序必须使用 DOCA-Host。以下 SKU 的 BlueField DPU 在通电时需要连接 8 针 ATX 电源线。如果未连接该电源线设备将无法完成上电流程无法正常工作。B3220 DPU —— 900-9D3B6-00CV-AA0 和 900-9D3B6-00SV-AA0B3240 DPU —— 900-9D3B6-00CN-AB0 和 900-9D3B6-00SN-AB0B3210 DPU —— 900-9D3B6-00CC-AA0 和 900-9D3B6-00SC-AA0B3210E DPU —— 900-9D3B6-00CC-EA0 和 900-9D3B6-00SC-EA0有关以下内容的信息请参阅《DOCA Linux 安装指南》在 BlueField 网络平台或 SmartNIC 上安装 DOCA SDK支持的 BlueField 平台DOCA Runtime 与 DOCA DevelSDK默认情况下使用标准 Linux 工具yum、apt安装 DOCA 配置文件profile时会同时安装doca-runtime和doca-devel此前称为doca-sdk。doca-runtime包含 DOCA 管理员在生产环境中使用的所有组件、库、驱动程序和工具doca-devel包含用于开发的所有组件、库、驱动程序和工具包括参考应用、编译器等支持的设备速率上行链路 / 适配卡驱动名称上行链路速率BlueField-3mlx5- InfiniBandSDR、FDR、EDR、HDR100、HDR、NDR200、NDR- 以太网1GbE、10GbE、25GbE、40GbE、50GbE、100GbE、200GbE、400GbEBlueField-2mlx5- InfiniBandSDR、FDR、EDR、HDR- 以太网1GbE、10GbE、25GbE、40GbE、50GbE[1]、100GbE[1]BlueFieldmlx5- InfiniBandSDR、QDR、FDR、FDR10、EDR- 以太网1GbE、10GbE、25GbE、40GbE、50GbE、100GbEConnectX-9mlx5- InfiniBandXDR、NDR、NDR200、HDR、HDR100- 以太网800GbE、400GbE、200GbE、100GbEConnectX-8mlx5- InfiniBandSDR、FDR、EDR、HDR100、HDR、NDR200、NDR、XDR- 以太网1GbE、10GbE、25GbE、40GbE、50GbE、100GbE、200GbE、400GbEConnectX-7mlx5- InfiniBandEDR、HDR100、HDR、NDR200、NDR- 以太网1GbE、10GbE、25GbE、40GbE、50GbE[1]、100GbE[1]、200GbE[2]、400GbEConnectX-6 Lxmlx5- 以太网1GbE、10GbE、25GbE、40GbE、50GbE[1]ConnectX-6 Dxmlx5- 以太网10GbE、25GbE、40GbE、50GbE[1]、100GbE[1]、200GbE[1]ConnectX-6mlx5- InfiniBandSDR、FDR、EDR、HDR- 以太网10GbE、25GbE、40GbE、50GbE[1]、100GbE[1]、200GbE[1]ConnectX-5 / ConnectX-5 Exmlx5- InfiniBandSDR、QDR、FDR、FDR10、EDR- 以太网1GbE、10GbE、25GbE、40GbE、50GbE、100GbEConnectX-4 Lxmlx5- 以太网1GbE、10GbE、25GbE、40GbE、50GbEConnectX-4mlx5- InfiniBandSDR、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 购买产品的客户可以通过以下方式联系我们电子邮件enterprisesupportnvidia.com企业支持服务https://www.nvidia.com/en-us/support/enterprise如果您购买了 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.02026 年 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>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/A5. API 变更下表详细列出了本 DOCA 版本引入的 API 变更库变更说明待定TBD待定TBD如需查看之前 DOCA 版本的 API 变更请参阅相应归档版本的发行说明。