Einrichten von SMPTE 2110 in der Unreal Engine
Diese Seite enthält alle wichtigen Informationen, die Sie für die Einrichtung und Bereitstellung von SMPTE 2110 in der Unreal Engine mit Nvidia Rivermax benötigen. Dieser Leitfaden richtet sich an Anwender, die SMPTE-2110-Funktionalität mit hoher Bandbreite benötigen, insbesondere in der Rundfunk- und Filmbranche.
Voraussetzungen
Folgende Hardware- und Lizenzanforderungen gelten für die Integration von SMPTE 2110 mit NVidia Rivermax:
Hardware
Rivermax ist ein von NVIDIA entwickeltes SDK, das mit Mellanox-Connect-X-Netzwerkkarten kompatibel ist.
Obwohl es andere 2110-Produzenten gibt, erfordern die SMPTE-2110-Funktionen von Unreal Engine 5.4 (zum Zeitpunkt der Veröffentlichung) speziell NVIDIA Rivermax.
Unterstützte Netzwerkkarten
Für die Ansteuerung einer LED-Wand ist Bluefield für PTP-Genauigkeit (Precision Time Protocol) erforderlich. Die folgende Liste beschreibt die derzeit von der Unreal Engine unterstützten Netzwerkkarten (NICs):
| Netzwerkkarte (NIC) | Information |
|---|---|
Connect-X 6 BlueField-2 | Wir empfehlen diese Familie unterstützter Netzwerkkarten, da sie PTP-Genauigkeit (Precision Time Protocol) auf Windows-Systemen bietet. PTP ist erforderlich, wenn eine LED-Wand angesteuert wird. |
Connect-X 6 | Diese NIC-Familie wird unterstützt, ist jedoch eingeschränkt, da sie keine PTP-Genauigkeit auf Windows-Systemen bietet. |
Connect-X 5 | Diese NIC-Familie wird vom Rivermax SDK unterstützt, wir empfehlen sie jedoch nicht für neue Installationen. |
Mehr Details finden Sie auf der NVIDIA-Website (Sie benötigen ein NVIDIA-Konto, um die Website anzusehen).
GPUDirect-Funktionen sind professionellen GPUs ab der 4000er-Klasse vorbehalten und erfordern eine Ampere-Architektur oder eine zukünftige Architekturgeneration (zum Beispiel RTX 6000 Ada, RTX 5000 Ada, RTX 4500 Ada oder RTX 4000 Ada). Eine vollständige Liste der GPUs, die GPUDirect unterstützen, finden Sie auf der NVIDIA-Website.
Darüber hinaus benötigen Sie ein Motherboard, das eine Resizable-Bar-Option unterstützt, was möglicherweise ein BIOS-Firmware-Update erfordert.
Software
Für die Verwendung von Rivermax mit der Unreal Engine empfehlen wir Ihnen, dem Bereitstellungsleitfaden auf der NVIDIA Rivermax-Website, Windows DPU Deployment (Version 2.51), zu folgen.
Bluefield-2-Karten werden ab August 2025 schrittweise aus dem Verkehr gezogen und erreichen bald das Ende ihrer Lebensdauer.
Bluefield-3-Karten arbeiten mit Rivermax Version 1.41.11 und 1.60.6 (ab UE 5.5 und 5.6). Sie erfordern jedoch eine andere Version der DPU-Bereitstellungs-Scripts, und neue Firmware wird automatisch zusammen mit den DPU-Scripts mithilfe einer BFB-Datei (Bluefield Bootstream) installiert.
Bluefield 2
| Unreal Engine-Version | Rivermax SDK-Version | WinOF-2-Version | DPU-Version | Firmware-Version |
|---|---|---|---|---|
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 |
5.6 | 1.60.6 | 24.10.50010 | 2.51 | 24.43.1014 |
Bluefield 3
| Unreal Engine-Version | Rivermax SDK-Version | WinOF-2-Version | DPU-Scripts-Version |
|---|---|---|---|
5.5 | 1.41.11 | 25.4.50020 | 3.0.0 |
5.6 | 1.60.6 | 25.4.50020 | 3.0.0 |
Rivermax SDK-Installationspfad
Der standardmäßige Installationspfad für das Rivermax SDK ist „C:\Program Files\Mellanox\Rivermax\lib“.
In der Unreal Engine 5.4 und höher können Sie zusätzlich zum Standardpfad den Installationspfad für das Rivermax SDK über die Umgebungsvariable $RIVERMAX_PATH festlegen.
Ab der Unreal Engine 5.6 müssen Sie einen expliziten Pfad zu Ihrer Version des Rivermax SDK angeben.
| Unreal Engine-Version | Unterstützte Rivermax-Version | Umgebungsvariable |
|---|---|---|
Unreal Engine 5.4 | 1.41.11 | RIVERMAX_PATH |
Unreal Engine 5.5 | 1.41.11 | RIVERMAX_PATH |
Unreal Engine 5.6 | 1.60.6 | RIVERMAX_PATH_1_60_6 |
Lizenz
Für die Nutzung des NVIDIA Rivermax SDK mit der Unreal Engine benötigen Sie eine Lizenz. Wenden Sie sich an NVIDIA, um eine Lizenz zu erhalten.
Standardmäßig erwartet das System die Lizenz neben der Rivermax DLL. Mit der Umgebungsvariable $RIVERMAX_LICENSE_PATH können Sie einen anderen Speicherort (z. B. ein Netzlaufwerk) für die Lizenz angeben.
Bereitstellungsschritte
Wenn Sie Ihre Rivermax-Bereitstellung einrichten, nutzen Sie bitte die offizielle NVIDIA-Dokumentation, die Ihrer DPU und dem Rivermax SDK beigefügt ist.
Optional: GPUDirect-Einrichtung
Stellen Sie beim Einrichten von GPUDirect sicher, dass sich die GPU und die DPU (Mellanox Karte) im selben Stammkomplex befinden. Ist das nicht der Fall, können die SMPTE 2110-Pakete verloren gehen, insbesondere wenn mehrere Input-Streams verwendet werden.
Aktivieren Sie die Resizable-Bar-Option in Ihrem BIOS.
Für eine optimale Leistung sollten Sie die Netzwerkkarte und die GPU im selben Root-Komplex platzieren.
Überprüfen Sie den verfügbaren BAR1-Speicher.
Überprüfen Sie die Aktivierung in der NVIDIA-Systemsteuerung.
Erstellen Sie eine neue Umgebungsvariable, um CUDA mit Rivermax zu verwenden.
RIVERMAX_ENABLE_CUDASetzen Sie den Wert auf 1.
Während der Initialisierung prüft das System auf ein kompatibles GPUDirect-Gerät und initialisiert die Bibliothek mit dieser Unterstützung. Falls nicht verfügbar, wird automatisch auf den Systemspeicherpfad zurückgegriffen.