Einrichten von SMPTE 2110

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.

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):

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

Bluefield 3

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.

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

Die folgenden Bereitstellungsschritte basieren auf der offiziellen NVIDIA Dokumentation.

NIC-Optionen

Connect-X 6

Die Connect-X-6-Bereitstellung erfordert die Installation des WinOF2-Treibers und des Nvidia-Firmware-Tools, bevor Sie zum nächsten Schritt übergehen:

1. Installieren Sie den Mellanox MLNX WinOF2-Treiber für Ihr Betriebssystem.

   • MLNX_OFED für Windows – WinOF-2

2. Installieren Sie das Nvidia-Firmware-Werkzeug, um die Firmware der Netzwerkkarte zu aktualisieren.

   • NVIDIA Firmware-Werkzeuge (MFT)

3. Starten Sie Ihr System neu.

Connect-X 6 BlueField-2

Wie die Connect-X 6-Netzwerkkarten erfordern auch BlueField-2-NICs die Installation des WinOF2-Treibers und des Nvidia-Firmware-Tools. Außerdem werden Putty, Python und das Bereitstellungspaket benötigt, das Sie auf dem DPU des NICs installieren werden.

1. Installieren Sie Putty

   • Das Bereitstellungsscript verwendet Plink und benötigt Putty.

2. Installieren Sie Python 3.10.1

   • Fügen Sie Python zu PATH hinzu.

3. Installieren Sie den Mellanox MLNX WinOF-2 Treiber.

   • MLNX_OFED für Windows – WinOF-2

4. Installieren Sie das Firmware-Tool von Nvidia.

   • NVIDIA Firmware-Werkzeuge (MFT)

   • Die MFT-Version ist in den WinOF-2-Veröffentlichungshinweisenauf der WinOF-2 Download-Seite angegeben.

5. Starten Sie Ihr System neu.

6. Stellen Sie sicher, dass der Management-Port der BlueField-2-Karte mit einem Internetzugang verkabelt ist. Dieser wird während der Implementierung benötigt.

7. Laden Sie das Paket Rivermax BlueField-2 (DPU) herunter.

   • Durchsuchen Sie die Seite Rivermax – Erste Schritte und melden Sie sich an.

   • Gehen Sie zur Sektion Archivieren.

   • Suchen Sie die empfohlene Rivermax SDK-Version.

   • Laden Sie DPU.zip herunter.

   • Extrahieren Sie die Datei nach C:\DPU.

8. Laden Sie das BlueField-2 BFB-Image herunter. Den Download-Link finden Sie im Implementierungsleitfaden von Nvidia.

   • Laden Sie das BFB-Image herunter und speichern Sie es unter C:\DPU\BFB.

     Diese Pfade sind fest in den Bereitstellungsskripten codiert.

9. Richten Sie die während der Bereitstellung verwendete Konfigurationsdatei ein.

   • Die Datei befindet sich unter C:\DPU\configuration_file.txt

   • Sie müssen die PTP-IP-Option konfigurieren, wenn Sie PTP verwenden möchten.

10. Starten Sie die DPU-Bereitstellung.

    • Führen Sie die folgende Datei über eine Administrator-Befehlszeile aus: C:\DPU\DPU_Install.bat

      

11. Fahren Sie den Computer herunter und schalten Sie ihn dann wieder ein. Führen Sie keinen einfachen Neustart durch.

12. Konfigurieren Sie Ihre DPU.

    • Führen Sie die folgende Datei über eine Administrator-Befehlszeile aus: C:\DPU\configure_dpu_setting.bat

      

Mellanox Firmware-Aktualisierung

1. Aktualisieren Sie die Mellanox-Firmware auf die neueste Version.

   • Öffnen Sie ein Eingabeaufforderungsfenster mit Administratorrechten

     • Führen Sie mlxfwmanager.exe -u --online aus

     

     Wenn Sie keine Administratorrechte besitzen, erhalten Sie diese Fehlermeldung:

     

2. Wenn die Firmware ein Update benötigte, schalten Sie Ihren Computer nach Abschluss aus und starten Sie ihn dann neu.

PTP-Einrichtung für BF2-Karten

Sie müssen sich über SSH mit dem Management-Port der BF2-Karte verbinden. Stellen Sie sicher, dass Sie Benutzername und Passwort haben, die während der Installation der BF2 verwendet wurden.

• Damit PTP funktioniert, muss Ihr Kabel mit der p0-Schnittstelle verbunden sein, die dem mittleren QSFP der Karte entspricht.

• Die erwartete Domäne für das BF2 PTP-Setup ist 127.

• Geben Sie in einem Befehlszeilenfenster Folgendes ein:

Kommandozeile

putty -ssh root@Your_BlueField_2_Managment_IP 22 -pw Your_BlueField-2_Password

• Richten Sie einen DOCA-Container ein:

  • Geben Sie im Befehlszeilenfenster den Befehl ein: ./create_container.sh

  • Führen Sie Folgendes aus, um die Funktionalität zu validieren: tail -f /var/log/doca/firefly/ptp4l.log | grep -E 'ptp|phc'

  • Wenn PTP gefunden wird, ähnelt der Output der folgenden Abbildung und zeigt die Uhr-ID des verwendeten GrandMaster an. Wenn PTP nicht gefunden wird, zeigt die Ausgabe eine Meldung an, dass die lokale Uhr verwendet wird.

    

  • Sie können firefly_monitor.sh auch von der Startseite des Stamm-Verzeichnisses aus ausführen und prüfen, ob PTP an den erwarteten GM gebunden ist:

    

    Der Output von firefly_monitor.sh.

Rivermax-Einrichtung

1. Aktivieren Sie die Unterstützung für dynamische RTP-Header im Mellanox-Treiber:

   1. Ermitteln Sie das zu konfigurierende Gerät, indem Sie folgenden Befehl mit Administratorrechten über eine Befehlszeile ausführen: mlxconfig.exe query

   2. Suchen Sie in den Outputs nach der Zeile: Gerät: (MST_DEVICE)

      

   3. Führen Sie mit Administratorrechten über eine Befehlszeile den folgenden Befehl aus, um die dynamische Header-Unterstützung für dieses Gerät zu aktivieren: mlxconfig.exe -d (MST_DEVICE) set FLEX_PARSER_PROFILE_ENABLE=4 PROG_PARSE_GRAPH=1

      

      Ausführen eines Befehls zur Aktivierung der dynamischen Header-Unterstützung für Ihr Gerät.

2. Fahren Sie das System herunter und starten Sie es neu.

3. Richten Sie die Rivermax Lizenz ein:

   • Standardmäßig sucht Rivermax im Installationsverzeichnis nach einer Lizenzdatei.

     • Beispiel C:\Programm Files\Mellanox\Rivermax\lib\Rivermax.lic

   • Sie können das Installationsverzeichnis mithilfe einer Umgebungsvariable ändern, die auf Ihre Lizenzdatei verweist.

     • RIVERMAX_LICENSE_PATH

Optional: GPUDirect-Einrichtung

1. Aktivieren Sie die Resizable-Bar-Option in Ihrem BIOS.

2. Für eine optimale Leistung sollten Sie die Netzwerkkarte und die GPU im selben Root-Komplex platzieren.

3. Überprüfen Sie den verfügbaren BAR1-Speicher.

   • Überprüfen Sie die Aktivierung in der NVIDIA-Systemsteuerung.

4. Erstellen Sie eine neue Umgebungsvariable, um CUDA mit Rivermax zu verwenden.

   • RIVERMAX_ENABLE_CUDA

   • Setzen Sie den Wert auf 1.

5. 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.