Cómo configurar SMPTE 2110 en Unreal Engine

Esta página contiene todo lo que debes saber para configurar e implementar SMPTE 2110 en Unreal Engine con NVIDIA Rivermax. Esta guía está dirigida a usuarios que requieren la función SMPTE 2110 de gran ancho de banda, incluidos los sectores de la radiodifusión y el cine.

Requisitos previos

A continuación, se indican los requisitos de hardware y de licencia para integrar SMPTE 2110 con NVIDIA Rivermax:

Hardware

Rivermax es un SDK desarrollado por NVIDIA que funciona con tarjeta de red Mellanox Connect-X.

Aunque hay otros productores de 2110, las funciones del SMPTE 2110 de Unreal Engine 5.4 (en el momento de esta publicación) requieren específicamente NVIDIA Rivermax.

Tarjetas de red compatibles

Controlar una pared de LED requiere la precisión de Bluefield para el PTP (protocolo de tiempo de precisión). La siguiente lista describe las tarjetas de red (NIC) actualmente compatibles con Unreal Engine:

Tarjeta de red (NIC)	Información
Connect-X 6 BlueField-2	Recomendamos esta familia de NIC compatibles, ya que cuentan con precisión PTP (protocolo de tiempo de precisión) en sistemas Windows. Se requiere PTP si se controla una pared de LED.
Connect-X 6	Esta familia de NIC es compatible, pero está limitada porque no cuenta con precisión PTP en sistemas Windows.
Connect-X 5	Esta familia de NIC es compatible con el SDK de Rivermax, pero no la recomendamos para instalaciones nuevas.

Para obtener una vista más detallada, consulta el sitio web de NVIDIA. (Necesitas una cuenta de NVIDIA para ver el sitio).

Las capacidades de GPUDirect están restringidas a GPU profesionales a partir de la clase 4000 y requieren arquitectura Ampere o una generación de arquitectura futura (por ejemplo, RTX 6000 Ada, RTX 5000 Ada, RTX 4500 Ada o RTX 4000 Ada). Para obtener una lista completa de las GPU compatibles con GPUDirect, consulta el sitio web de NVIDIA.

Además, necesitarás una placa base que admita la opción de barra redimensionable, lo que puede requerir una actualización del firmware de la BIOS.

Software

Para utilizar Rivermax con Unreal Engine, te recomendamos que sigas la guía de implementación que se encuentra en el sitio web de NVIDIA Rivermax, implementación de DPU de Windows (versión 2.51).

Las tarjetas Bluefield-2 se están retirando gradualmente desde agosto de 2025 y pronto llegarán al final de su vida útil.

Las tarjetas Bluefield 3 funcionan con las versiones 1.41.11 y 1.60.6 de Rivermax (a partir de UE 5.5 y 5.6). Sin embargo, requieren una versión diferente de las secuencias de comandos de implementación de DPU, y el nuevo firmware se instala automáticamente con las secuencias de comandos de DPU utilizando un archivo Bluefield Bootstream (BFB).

Bluefield 2

Versión de Unreal Engine	Versión del SDK de Rivermax	Versión de WinOF-2	Versión de DPU	Versión del firmware de 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

Versión de Unreal Engine	Versión del SDK de Rivermax	Versión de WinOF-2	Versión de secuencia de comandos de DPU
5.5	1.41.11	25.4.50020	3.0.0

Ruta de instalación del SDK de Rivermax

La ruta de instalación predeterminada para el SDK de RIvermax es ‘C:\Program Files\Mellanox\Rivermax\lib’.

En Unreal Engine 5.4 y versiones posteriores, además de utilizar la ruta predeterminada, puedes especificar la ruta de instalación del SDK de Rivermax mediante la variable de entorno $RIVERMAX_PATH.

Licencia

Necesitas una licencia para utilizar el SDK de Rivermax de NVIDIA con Unreal Engine. Ponte en contacto con NVIDIA para obtener una licencia.

De forma predeterminada, el sistema espera encontrar la licencia junto al DLL de Rivermax. Puedes utilizar la variable del entorno $RIVERMAX_LICENSE_PATH para especificar una ubicación diferente (como una unidad de red) para buscar la licencia.

Pasos de implementación

Los siguientes pasos de implementación se basan en la documentación oficial de NVIDIA.

Opciones de NIC

Connect-X 6

La implementación de Connect-X 6 requiere que instales el controlador WinOF2 y la herramienta de firmware de NVIDIA antes de pasar al siguiente paso:

Instala el controlador Mellanox MLNX WinOF2 para tu sistema operativo.
- MLNX_OFED para Windows - WinOF-2
Instala la herramienta de firmware de NVIDIA para actualizar el firmware de la NIC.
- Herramientas de firmware de NVIDIA (MFT)
Reinicia el sistema.

Connect-X 6 BlueField-2

Al igual que la tarjeta de red Connext-X 6, las NIC BlueField-2 requieren que instales el controlador WinOF2 y la herramienta de firmware de NVIDIA. También necesita Putty, Python y los paquetes de implementación que instalarás en la DPU de la NIC.

Instala Putty
- La secuencia de comandos de implementación utiliza Plink y requiere Putty.
Instala Python 3.10.1
- Añade Python a la ruta.
Instala el controlador Mellanox MLNX WinOF-2.
- MLNX_OFED para Windows - WinOF-2
Instala la herramienta de firmware de Nvidia.
- Herramientas de firmware de NVIDIA (MFT)
- La versión de MFT se especifica en las notas de la versión de WinOF-2 en la página de descarga de WinOF-2.
Reinicia el sistema.
Asegúrate de que el puerto de gestión de la tarjeta BlueField-2 está conectado a Internet. Será necesario durante la implementación.
Descarga el paquete de Rivermax BlueField-2 (DPU).
- Busca e inicia sesión en Cómo empezar a utilizar Rivermax.
- Ve a la sección Archivo.
- Encuentra la versión recomendada del SDK de Rivermax.
- Descarga DPU.zip.
- Extráelo en C:\DPU.
Descarga la imagen BFB de BlueField-2. La guía de implementación de NVIDIA proporciona el enlace de descarga.
- Descarga la imagen de BFB y colócala en C:\DPU\BFB.
  Estas rutas están programadas de forma rígida en secuencias de comandos de implementación.
Configura el archivo de configuración utilizado durante la implementación.
- El archivo se encuentra en C:\DPU\configuration_file.txt
- Debes configurar la opción de IP PTP si quieres utilizar PTP.
Lanza la implementación de DPU.
- Ejecuta el siguiente archivo desde una línea de comandos de administrador: C:\DPU\DPU_Install.bat
Apaga el ordenador y vuelve a encenderlo. No solo reinicies.
Configura tu DPU.
- Ejecuta el siguiente archivo desde una línea de comandos de administrador: C:\DPU\configure_dpu_setting.bat

Actualización defirmware de Mellanox

Actualiza el firmware de Mellanox a la versión más reciente.
- Abre una ventana del símbolo del sistema con privilegios de administrador
  - Ejecuta mlxfwmanager.exe -u --online
  Si no tienes privilegios de administrador, verás este error:
Si el firmware tenía que actualizarse, apaga el ordenador cuando haya terminado y vuelve a encenderlo.

Configuración de PTP para tarjetas BF2

Debes conectarte a través de ssh al puerto de gestión de la tarjeta BF2. Asegúrate de que tienes el nombre de usuario y la contraseña utilizados durante la implementación de BF2.

Para que PTP funcione, el zócalo de botón debe estar conectado a la interfaz p0, que corresponde a la QSFP del centro de la tarjeta.
El dominio esperado para la configuración de PTP en BF2 es 127.
En una ventana de línea de comandos, introduce lo siguiente:

Línea de comandos

C++

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

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

Configura un contenedor DOCA:
- En la ventana de línea de comandos, introduce el comando: ./create_container.sh
- Para validar la función, ejecuta: tail -f /var/log/doca/firefly/ptp4l.log | grep -E 'ptp|phc'
- Si se encuentra PTP, la salida se parecerá a la siguiente imagen y mostrará el ID del reloj GrandMaster que está utilizando. Si no se encuentra PTP, la salida mostrará un mensaje indicando que está utilizando el reloj local.
- También puedes ejecutar firefly_monitor.sh desde el directorio de inicio de la raíz y comprobar si PTP está bloqueado para el GM previsto:
  La salida de firefly_monitor.sh.

Configuración de Rivermax

Activa la compatibilidad para encabezados RTP dinámicos en el controlador Mellanox:
1. Ejecuta lo siguiente desde una línea de comandos con privilegios de administrador para buscar el dispositivo que quieras configurar: mlxconfig.exe query
2. En las salidas, busca la línea: Dispositivo: (MST_DEVICE)
3. En una línea de comandos con privilegios de administrador, ejecuta el siguiente comando para habilitar la compatibilidad con encabezados dinámicos en este dispositivo: mlxconfig.exe -d (MST_DEVICE) set FLEX_PARSER_PROFILE_ENABLE=4 PROG_PARSE_GRAPH=1
  Ejecución de un comando para habilitar la compatibilidad con el encabezado dinámico en el dispositivo.
Apaga el sistema y vuelve a encenderlo.
Configura la licencia de Rivermax:
- Por defecto, Rivermax buscará en su directorio de instalación un archivo de licencia.
  - Por ejemplo, C:\Archivos de programa\Mellanox\Rivermax\lib\Rivermax.lic
- Puedes cambiar el directorio de instalación mediante una variable de entorno que apunte a tu archivo de licencia.
  - RIVERMAX_LICENSE_PATH

Opcional: configuración de GPUDirect

Habilita la opción de barra de tamaño variable en la BIOS.
Para conseguir un rendimiento óptimo, conviene colocar la tarjeta de red y la GPU en el mismo complejo raíz.
Valida la memoria disponible de BAR1.
- Utiliza la información de Nvidia Control Panel - System para validar que se ha habilitado.
Crea una nueva variable de entorno para utilizar CUDA con Rivermax.
- RIVERMAX_ENABLE_CUDA
- Establece su valor en 1.
Durante la inicialización, si el sistema encuentra un dispositivo GPUDirect compatible, inicializará la biblioteca con esta cinoatubukudad. Si no, volverá a la ruta de memoria del sistema.