在虚幻引擎中设置SMPTE 2110
本页包含使用NVIDIA Rivermax在虚幻引擎中设置和部署SMPTE 2110所需的全部信息。 本指南适用于需要高带宽SMPTE 2110功能的用户，包括广播和电影行业。
先决条件
以下是使用NVidia Rivermax集成SMPTE 2110所需的硬件和许可要求：
硬件
Rivermax是由NVIDIA开发的SDK，可与Mellanox Connect-X 网卡配合使用。
虽然存在其他2110解决方案，但虚幻引擎5.4的SMPTE 2110功能（截至本文发布时）明确要求使用NVIDIA Rivermax。
支持的网卡
驱动LED墙需要Bluefield来保证PTP（精确时间协议）精度。 下表介绍了虚幻引擎当前支持的网卡（NIC）：
| 网卡（NIC） | 信息 |
|---|---|
Connect-X 6 BlueField-2 | 我们推荐这一系列受支持的NIC，因其在Windows系统上具备PTP（精确时间协议）精度。 如果要驱动LED墙，则需要PTP。 |
Connect-X 6 | 该系列NIC虽受支持，但存在局限性，因其在Windows系统中不具备PTP（精确时间协议）精度。 |
Connect-X 5 | 该系列NIC虽受Rivermax SDK支持，但我们不建议在新安装中采用。 |
如需详细了解，请访问NVIDIA网站（需要拥有NVIDIA账户才能访问该网站）。
GPUDirect功能仅限于4000系列及以上的专业GPU，且需要采用安培（Ampere）架构或未来架构世代（例如RTX 6000 Ada、RTX 5000 Ada、RTX 4500 Ada或RTX 4000 Ada）。 如需获取支持GPUDirect的GPU完整列表，请访问NVIDIA网站。
此外，你需要一块支持可调整大小栏选项的主板，这可能需要更新BIOS固件。
软件
要在虚幻引擎中使用Rivermax，建议你遵循NVIDIA Rivermax网站上的部署指南《Windows DPU部署指南》（2.51版）。
自2025年8月起，Bluefield-2卡将逐步被淘汰，并且很快就会达到使用寿命的极限。
Bluefield 3卡可与Rivermax 1.41.11和1.60.6版本配合使用（从虚幻引擎5.5和5.6开始）。 但是，它们需要不同版本的DPU部署脚本，并且新固件会使用 Bluefield Bootstream (BFB) 文件与DPU脚本一起自动安装。
Bluefield 2
| 虚幻引擎版本 | Rivermax SDK版本 | WinOF-2版本 | DPU版本 | BlueField-2固件版本 |
|---|---|---|---|---|
5.3 | 1.20.10 | 3.10.52010 | 2.21 | 24.35.1012 |
5.4 | 1.41.11 | 24.1.50000 | 2.51 | 24.40.1000 |
5.5 | 1.41.11 | 24.1.50000 | 2.51 | 24.40.1000 |
Bluefield 3
| 虚幻引擎版本 | Rivermax SDK版本 | WinOF-2版本 | DPU脚本版本 |
|---|---|---|---|
5.5 | 1.41.11 | 25.4.50020 | 3.0.0 |
Rivermax SDK安装路径
Rivermax SDK的默认安装路径为"C:\Program Files\Mellanox\Rivermax\lib"。
在虚幻引擎5.4及更高版本中，除使用默认路径外，你还可以使用环境变量$RIVERMAX_PATH指定Rivermax SDK的安装路径。
许可证
搭配使用NVIDIA Rivermax SDK和虚幻引擎时，需要许可证。 请联系NVIDIA获取许可证。
默认情况下，系统会在Rivermax DLL所在目录中查找许可证。 你可以使用环境变量$RIVERMAX_LICENSE_PATH指定其他位置来查找许可证（如网络驱动器）。
部署步骤
以下部署步骤依据NVIDIA官方文档制定。
NIC选项
Connect-X 6
要部署Connect-X 6，你需要先安装WinOF2驱动程序和Nvidia的固件工具，然后才能进入下一步：
为你的操作系统安装Mellanox MLNX WinOF2驱动程序。
安装Nvidia的固件工具以更新网络接口卡（NIC）的固件。
重启系统。
Connect-X 6 BlueField-2
与Connect-X 6网卡一样，BlueField-2网络接口卡也要求安装WinOF2驱动程序和Nvidia固件工具。 此外还需要Putty、Python以及将被安装到网络接口卡DPU上的部署包。
安装Putty
部署脚本会用到Plink且需要Putty。
安装Python 3.10.1
将Python添加到PATH。
安装Mellanox MLNX WinOF-2的驱动程序。
安装Nvidia的固件工具。
WinOF-2下载页面的WinOF-2版本说明中会给出MFT的版本。
重启系统。
请确保BlueField-2网卡的管理端口已连接到互联网。 部署过程中需要联网。
下载Rivermax BlueField-2 (DPU)软件包。
浏览并登录Rivermax入门指南。
转到存档（Archive）小节。
找到推荐的Rivermax SDK版本。
下载
DPU.zip。将其提取到
C:\DPU。
下载BlueField-2 BFB镜像。 Nvidia的部署指南会提供下载链接。
下载BFB镜像并将其放置到
C:\DPU\BFB位置。这些路径在部署脚本中是硬编码的。
设置部署期间使用的配置文件。
文件的位置为
C:\DPU\configuration_file.txt如需使用PTP，则必须配置PTP IP选项。
启动DPU部署。
从管理员命令行运行以下文件：
C:\DPU\DPU_Install.bat
关闭电脑，然后再开机。 不可仅仅重启。
配置你的DPU。
从管理员命令行运行以下文件：
C:\DPU\configure_dpu_setting.bat
Mellanox固件升级
将Mellanox的固件升级到最新版本。
以管理员权限打开命令提示符窗口
运行
mlxfwmanager.exe -u --online
若无管理员权限，你将收到以下错误：
如果固件需要更新，请在更新完成后关闭计算机，然后重新开机。
BF2网卡的PTP设置
你需要通过SSH连接到BF2网卡的管理端口。 请确保拥有部署BF2时所用的用户名和密码。
要使PTP生效，你需要将网线连接到对应卡中间的QSFP的p0接口。
BF2 PTP设置的预期域为127。
使用命令行窗口输入以下命令：
命令行
putty -ssh root@Your_BlueField_2_Managment_IP 22 -pw Your_BlueField-2_Password设置DOCA容器：
在命令行窗口中输入以下命令：
./create_container.sh要验证其功能，请运行：
tail -f /var/log/doca/firefly/ptp4l.log | grep -E 'ptp|phc'如果找到PTP，输出将类似于下图，并显示其当前所用的GrandMaster时钟ID。 如果未找到PTP，输出将显示一条消息，说明它正在使用本地时钟。
你还可以从根目录运行
firefly_monitor.sh，并查看PTP是否被锁定到预期的GM：firefly_monitor.sh的输出。
Rivermax设置
在Mellanox驱动程序中启用对动态RTP头文件的支持：
要找到要配置的设备，请以管理员权限从命令行运行以下命令：
mlxconfig.exe query在输出中寻找以下行：
Device: (MST_DEVICE)以管理员权限使用命令行，运行以下命令以为此设备启用动态头文件支持：
mlxconfig.exe -d (MST_DEVICE) set FLEX_PARSER_PROFILE_ENABLE=4 PROG_PARSE_GRAPH=1运行命令以为你的设备启用动态头文件支持。
关闭系统，然后再开机。
设置Rivermax许可：
默认情况下，Rivermax会在其安装目录中查找许可文件。
例如
C:\Program Files\Mellanox\Rivermax\lib\Rivermax.lic
你可以用指向许可文件的环境变量来更改安装目录。
RIVERMAX_LICENSE_PATH
可选：GPUDirect设置
在BIOS中启用可调整大小栏选项。
为实现最佳性能，应将网卡与GPU置于同一个根复合体上。
验证BAR1可用内存。
使用Nvidia控制面板（Nvidia Control Panel）- 系统（System）信息验证是否已启用该功能。
创建将CUDA和Rivermax结合使用的新环境变量。
RIVERMAX_ENABLE_CUDA将其值设置为1。
在初始化过程中，如果系统检测到兼容的GPUDirect设备，将初始化支持该功能的库。 如果未检测到，则回退至系统内存路径。