Como configurar o SMPTE 2110 na Unreal Engine
Esta página contém tudo que você precisa saber para definir e implantar o SMPTE 2110 na Unreal Engine usando o NVIDIA Rivermax. Este guia destina-se a usuários que precisam de funcionalidade SMPTE 2110 de alta largura de banda, incluindo o setor de Radiodifusão e Cinema.
Pré-requisitos
A seguir apresentamos os requisitos de hardware e as licenças para integrar o SMPTE 2110 usando o NVIDIA Rivermax:
Hardware
O Rivermax é um SDK desenvolvido pela NVIDIA que funciona com placas de rede Mellanox Connect-X.
Embora existam outros produtores de 2110, as funcionalidades da Unreal Engine 5.4 SMPTE 2110 (no momento da publicação) exigem especificamente o NVIDIA Rivermax.
Placas de rede compatíveis
Orientar uma parede de LEDs requer Bluefield para precisão de PTP (protocolo de tempo de precisão). A lista a seguir descreve as placas de rede (NICs) atualmente aceitas pela Unreal Engine:
| Placa de rede (NIC) | Informações |
|---|---|
BlueField-2 com Connect-X 6 | Recomendamos esta família de NICs compatível, pois possui precisão PTP (protocolo de tempo de precisão) nos sistemas Windows. O PTP é necessário para orientar uma parede de LEDs. |
Connect-X 6 | Esta família de NICs é compatível, mas limitada por não ter precisão PTP nos sistemas Windows. |
Connect-X 5 | Esta família de NICs é compatível com o SDK Rivermax, mas não a recomendamos para novas instalações. |
Consulte uma visão mais detalhada no site da NVIDIA (você precisa de uma conta NVIDIA para visualizar o site).
Os recursos de GPUDirect são restritos a GPUs profissionais a partir da classe 4000 e superiores, e exigem a arquitetura Ampere ou uma futura geração de arquitetura (por exemplo, RTX 6000 Ada, RTX 5000 Ada, RTX 4500 Ada ou RTX 4000 Ada). Para obter uma lista completa de GPUs compatíveis com GPUDirect, consulte o site da NVIDIA.
Além disso, você precisa de uma placa-mãe com suporte a uma opção de barras redimensionáveis, o que pode exigir uma atualização de hardware do BIOS.
Software
Para usar o Rivermax com a Unreal Engine, recomendamos que siga o guia de implantação encontrado no site do NVIDIA Rivermax, Implementação de DPU do Windows (versão 2.51).
Os cards Bluefield-2 estão em faseamento a partir de agosto de 2025 e, em breve, chegarão ao fim da vida.
As cards Bluefield 3 são compatíveis com o Rivermax versões 1.41.11 e 1.60.6 (a partir da UE 5.5 e 5.6). No entanto, eles exigem uma versão diferente dos códigos de implantação da DPU, e o novo microcódigo é instalado automaticamente com os códigos da DPU usando um arquivo Bluefield Bootstream (BFB).
Bluefield 2
| versão da Unreal Engine | Versão do SDK Rivermax | Versão do WinOF-2 | Versão da DPU | Versão do firmware do 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
| versão da Unreal Engine | Versão do SDK Rivermax | Versão do WinOF-2 | Versão dos scripts da DPU |
|---|---|---|---|
5.5 | 1.41.11 | 25.4.50020 | 3.0.0 |
Caminho de instalação do SDK Rivermax
O caminho de instalação padrão para o SDK Rivermax é "C:\Program Files\Mellanox\Rivermax\lib".
Na Unreal Engine 5.4 e posteriores, além de usar o caminho padrão, você pode especificar o caminho de instalação para o SDK Rivermax usando a variável de ambiente $RIVERMAX_PATH.
Licença
Você precisa de uma licença para usar o SDK Rivermax NVIDIA com a Unreal Engine. Entre em contato com a NVIDIA para obter uma licença.
Por padrão, o sistema espera encontrar a licença ao lado da DLL do Rivermax. Você pode usar a variável de ambiente $RIVERMAX_LICENSE_PATH para especificar uma localização diferente (como uma unidade de rede) para procurar a licença.
Etapas de implantação
As etapas de implementação a seguir se baseiam na documentação oficial da NVIDIA.
Opções de NIC
Connect-X 6
A implantação da Connect-X 6 requer que você instale o driver WinOF2 e a ferramenta de hardware da NVIDIA antes de passar para a próxima etapa:
Instale o driver Mellanox MLNX WinOF2 para o seu sistema operacional.
Instale a ferramenta de firmware da NVIDIA para atualizar o firmware da NIC.
Reinicie o sistema.
BlueField-2 com Connect-X 6
Como as placas de rede Connext-X 6, as NICs BlueField-2 exigem que você instale o driver WinOF2 e a ferramenta de firmware da NVIDIA. Também precisa de Putty, Python e dos pacotes de implantação que você instalará no DPU da NIC.
Instalação do Putty
O script de implantação usa Plink e requer Putty.
Instalação do Python 3.10.1
Adicione "Python" a "PATH".
Instale o driver Mellanox MLNX WinOF-2.
Baixe a ferramenta de firmware da NVIDIA.
A versão do MFT é especificada nas notas de versão do WinOF-2 na página de download do WinOF-2.
Reinicie o sistema.
Certifique-se de que a porta de gerenciamento da placa BlueField-2 esteja conectada à internet. Isso será necessário durante a implantação.
Baixe o pacote Rivermax BlueField-2 (DPU).
Navegue e faça login em Introdução a Rivermax.
Vá para a seção Arquivo.
Procure a versão recomendada do SDK Rivermax.
Baixe o
DPU.zip.Extraia para
C:\DPU.
Baixe a imagem BlueField-2 BFB. O guia de implantação da NVIDIA fornece o link para download.
Baixe a imagem BFB e coloque-a em
C:\DPU\BFB.Esses caminhos foram incorporados ao código nos scripts de implantação.
Defina o arquivo de configuração usado durante a implantação.
O arquivo está localizado em
C:\DPU\configuration_file.txtVocê precisará configurar a opção de IP PTP se quiser usar o PTP.
Inicialize a implantação da DPU.
Execute o seguinte arquivo na linha de comando como administrador:
C:\DPU\DPU_Install.bat
Desligue o computador e, em seguida, ligue-o novamente. Não simplesmente reinicie.
Configure sua DPU.
Execute o seguinte arquivo na linha de comando como administrador:
C:\DPU\configura_dpu_setting.bat
Atualização do firmware Mellanox
Atualize o firmware da Mellanox para a versão mais recente.
Abra uma janela de prompt de comando com privilégios de administrador
Execute
mlxfwmanager.exe -u --online
Se o software precisar de uma atualização, desligue o computador assim que terminar e, em seguida, ligue-o novamente.
Configuração de PTP para cards BF2
Você precisa se conectar por meio de "ssh" à porta de gerenciamento das placas BF2. Certifique-se de ter o nome de usuário e a senha usados durante a implantação do BF2.
Para que o PTP funcione, você precisa ter o cabo conectado à interface p0 que corresponde ao QSFP no meio do card.
O domínio esperado para a configuração do PTP do BF2 é 127.
Usando uma janela de linha de comando, insira o seguinte:
Linha de comando
putty -ssh root@Your_BlueField_2_Managment_IP 22 -pw Your_BlueField-2_PasswordConfigure um contêiner DOCA:
Na janela da linha de comando, insira o comando:
./create_container.shPara validar a funcionalidade, execute:
tail -f /var/log/doca/firefly/ptp4l.log | grep -E 'ptp|phc'Se o PTP for encontrado, a saída será parecida com a imagem a seguir e exibirá o ID do relógio do GrandMaster que está usando. Se o PTP não for encontrado, a saída exibirá uma mensagem informando que está usando o relógio local.
Você também pode executar
firefly_monitor.shdo diretório inicial da raiz e ver se o PTP está bloqueado para o GM esperado:A saída de
firefly_monitor.sh.
Configuração do Rivermax
Habilite o suporte para cabeçalhos RTP dinâmicos no driver Mellanox:
Procure o dispositivo que deseja configurar executando o seguinte em uma linha de comando com privilégios de administrador:
mlxconfig.exe queryNos resultados, procure a linha:
Dispositivo: (MST_DEVICE)Usando uma linha de comando com privilégios de administrador, execute o seguinte comando para habilitar o suporte dinâmico a cabeçalhos para este dispositivo:
mlxconfig.exe -d (MST_DEVICE) set FLEX_PARSER_PROFILE_ENABLE=4 PROG_PARSE_GRAPH=1Execução de um comando para habilitar o suporte dinâmico a cabeçalhos no dispositivo.
Desligue o sistema e ligue-o novamente.
Configure a licença do Rivermax:
Por padrão, o Rivermax procurará em seu diretório de instalação o arquivo de licença.
Por exemplo,
C:\Program Files\Mellanox\Rivermax\lib\Rivermax.lic
Você pode alterar o diretório de instalação usando uma variável de ambiente que aponte para o arquivo de licença.
RIVERMAX_LICENSE_PATH
Opcional: configuração do GPUDirect
Habilite a opção de BAR redimensionável na BIOS.
Para obter o desempenho ideal, você deve colocar as placas de rede e a GPU no mesmo complexo-raiz.
Valide a memória disponível de BAR1.
Use o Nvidia Control Panel — Informações sobre o sistema para validar se está habilitado.
Crie uma variável de ambiente para usar CUDA com o Rivermax.
RIVERMAX_ENABLE_CUDADefina seu valor como 1.
Durante a inicialização, se o sistema encontrar um dispositivo GPUDirect compatível, inicializará a biblioteca com esse suporte. Caso contrário, voltará a usar o caminho de memória do sistema.