Como configurar um videowall em Players Rockchip com o aplicativo de configuração de videowall

Utilize o aplicativo Video Wall Configuration para fazer com que um único Rockchip Android Player controle vários monitores como uma única tela grande.

Algumas instalações precisam que um único Player exiba o conteúdo em vários monitores como se fossem uma só tela grande. O app Video Wall Configuration, para Players Android com hardware Rockchip, permite descrever como os monitores estão montados e grava a configuração correspondente no dispositivo, que reinicia com a imagem dividida entre os monitores.

Como funciona

O Video Wall Configuration é um app Android pequeno. Você define o número de monitores, a resolução e o arranjo. O app grava a configuração correspondente para o hardware composer da Rockchip, que faz a divisão da imagem (a Rockchip chama esse recurso de splice). Depois que o arquivo é gravado, o dispositivo reinicia.

O app em uma parede de quatro monitores

App em execução em uma parede 1 x 4. Os quatro monitores formam uma única tela de 7680 x 1080, então o app, que fica no centro dela, aparece sobre os monitores 2 e 3.

O que o Apply and reboot faz

Ao selecionar Apply and reboot, o app executa estas etapas, em ordem:

  1. Pede confirmação.
  2. Torna a partição /vendor gravável.
  3. Salva o arquivo original como HwComposerEnv.xml.bak, somente se ainda não existir um backup. O backup nunca é sobrescrito.
  4. Salva uma cópia da configuração que está ativa no momento, usada na etapa de manter ou reverter.
  5. Grava o novo arquivo ao lado do destino, define proprietário e permissões, renomeia o arquivo sobre o destino, lê o resultado de volta e compara.
  6. Define persist.vendor.framebuffer.main com o tamanho do canvas, para que o composer informe ao Android a parede inteira como tamanho do display. O valor original é salvo uma única vez.
  7. Limpa qualquer override de wm size.
  8. Reinicia o dispositivo. O reinício completo é necessário, porque o composer só lê o arquivo quando inicia.

Se qualquer etapa até a etapa 5 falhar, o app para, mostra o motivo e a saída do shell, e não reinicia o dispositivo.

Manter ou reverter o layout

Depois do reinício, quando o Android termina de iniciar, o app abre sozinho e pergunta Keep this layout? em cada monitor da parede. Isso impede que um layout que ninguém consegue ver, ou que está claramente errado, permaneça no dispositivo. Também significa que, se você aplicar o layout sem ninguém diante da parede, ele sempre será revertido.

Nota: se ninguém responder em 45 segundos, o app restaura a configuração que estava ativa antes de você aplicar o layout e reinicia o dispositivo.

 

Requisitos

O app funciona somente em Android. Ele não depende do fabricante da placa e funciona em qualquer dispositivo cujo firmware tenha sido compilado a partir do kit Android da Rockchip com o recurso splice incluído. O dispositivo precisa atender a todos estes requisitos:

Requisito Motivo
Firmware Rockchip com HwComposerEnv.xml em /vendor/etc ou /vendor O hardware composer da Rockchip lê esse arquivo e faz a divisão da imagem. Sem ele, o app desativa o botão Apply and reboot.
Root via su, utilizável por apps O arquivo fica na partição vendor, que é somente leitura. A assinatura de plataforma sozinha não é suficiente.
Android 11 ou superior Versão mínima do app.
Mais de uma saída de vídeo habilitada no firmware O app só oferece as saídas que o kernel reporta.

Nota: uma versão do app sem root exige uma mudança de firmware: um composer que leia o arquivo de um local gravável ou um serviço auxiliar com root.

 

Instalar o app

Baixe o app no link de download.

  1. Conecte o computador ao Player via adb (Guia de conexão ADB).
  2. Execute adb install -r Video-Wall-Configuration.apk.
  3. Abra o app uma vez no Player, para que ele possa iniciar sozinho após um reinício.

Configurar o video wall

O lado esquerdo da tela principal tem três escolhas: número de monitores, resolução de cada monitor e arranjo. O lado direito mostra o Wall preview, o painel Device e as duas ações, Restore original e Apply and reboot.

A tela principal com um único monitor selecionado

Em Monitors, selecione o número de monitores. O app oferece até 4, e nunca mais do que o número de saídas do dispositivo.

Em Resolution of each monitor, selecione Full HD (1920 x 1080) ou 4K (3840 x 2160). A resolução é a mesma para todos os monitores.

Em Arrangement, selecione o arranjo. O app lista todos os arranjos retangulares para o número escolhido, por exemplo 1 x 2 (lado a lado) e 2 x 1 (empilhados). Os tamanhos são escritos como linhas x colunas.

A tela principal com um único monitor selecionado

No Wall preview, confira o Total canvas. O preview é desenhado em escala, e cada célula mostra o número do monitor e a saída que o aciona.

Para mudar a saída de um monitor, selecione a célula e escolha uma saída no menu. Se você escolher uma saída que outro monitor já usa, o app troca as duas. Isso corrige uma ordem errada de cabos sem mexer nos cabos. Células estreitas usam nomes curtos, como DP 1 para DisplayPort 1.

Três monitores 4K empilhados com o menu de saídas aberto

Se necessário, escolha uma saída sem nada conectado. Essas saídas aparecem como not connected e continuam selecionáveis.

O menu de saídas marcando DisplayPort 1 como not connected

Selecione Apply and reboot e confirme.

Depois do reinício, confira a pergunta Keep this layout? (veja Confirmar o layout, abaixo) e selecione qualquer lugar da tela duas vezes para manter o layout.

Nota: enquanto o app está aberto, ele relê a lista de saídas a cada 3 segundos. Conecte ou desconecte um cabo para descobrir qual porta física corresponde a cada saída.

 

Ler o painel Device

  • Connected outputs: o que o kernel reporta como conectado.
  • Configuration file: onde o HwComposerEnv.xml foi encontrado.
  • Active canvas: o layout que está no arquivo do dispositivo no momento, que não é necessariamente o selecionado à esquerda.
  • Backup state: indica se a configuração original já foi salva.
  • Identify monitors: exibido quando há uma parede ativa.

Identify monitors

Selecione Identify monitors para deixar todo o canvas preto e preencher a fatia de cada saída com uma cor própria, o nome da saída e o número do monitor. Como o composer corta o canvas da mesma forma, cada monitor físico mostra qual saída o aciona. A função identifica o layout que está ativo no dispositivo, não o que você está editando. Selecione qualquer lugar para fechar.

Identify monitors em uma parede de dois monitores

Confirmar o layout

Depois do reinício, a pergunta Keep this layout? aparece como um cartão pequeno em cada monitor, desenhado sobre um padrão (moldura, diagonais e um círculo) que ocupa todo o canvas. Quando os monitores estão nos lugares certos, as linhas continuam de uma tela para a seguinte.

A pergunta Keep this layout? capturada em uma parede de dois monitores
  • Cada cartão mostra Monitor N of M e a saída, o que facilita notar um monitor ausente.
  • Para manter o layout, são necessárias duas seleções separadas (clique, toque ou Enter). Um clique duplo conta como uma só.
  • Sem resposta em 45 segundos, o app restaura o que estava ativo antes de você aplicar o layout e reinicia o dispositivo.

Restaurar a configuração original

Selecione Restore original para recolocar o HwComposerEnv.xml.bak e o valor salvo do framebuffer, limpar o override de wm size e reiniciar o dispositivo. Os backups são mantidos, então você pode repetir a ação.

Nota: o Restore original traz de volta o que estava no dispositivo antes da primeira alteração feita pelo app. Isso só equivale ao estado de fábrica se o dispositivo estava intocado até então.

 

Arquivos e configurações que o app altera

Todos os arquivos ficam ao lado do arquivo de configuração. O app não altera mais nada no dispositivo.

Item Finalidade
HwComposerEnv.xml Layout lido pelo hardware composer.
HwComposerEnv.xml.bak Arquivo original, salvo uma única vez.
HwComposerEnv.xml.framebuffer.bak Valor original da propriedade do framebuffer, salvo uma única vez.
HwComposerEnv.xml.applied Marcador: o arquivo ativo foi gravado por este app.
HwComposerEnv.xml.pending Marcador: o layout ainda aguarda confirmação.
HwComposerEnv.xml.previous e arquivos relacionados O que estava ativo antes da última aplicação do layout, removido quando o layout é mantido ou revertido.
persist.vendor.framebuffer.main Tamanho que o composer informa ao Android.
override de wm size Normalmente limpo. Usado apenas como alternativa quando a propriedade não pode ser definida.

Como o app encontra as saídas

O app lista /sys/class/drm, onde o kernel mantém uma entrada por saída (por exemplo card0-HDMI-A-1), e lê o arquivo status de cada entrada. O tipo e o número desses nomes são exatamente o que vai para o arquivo de configuração. Tenha dois pontos em mente:

  • Saídas DSI e portas atrás de chips conversores costumam reportar connected com ou sem monitor conectado.
  • Uma porta que o firmware não habilita simplesmente não aparece, mesmo que o conector exista na carcaça.

Dispositivos testados

Dispositivo Saídas reportadas Resultado
Unidade Giada que reporta o modelo dn84 HDMI 1, HDMI 2, DisplayPort 1, DSI 1, todas disponibilizadas como portas HDMI na carcaça Paredes lado a lado com 2, 3 e 4 monitores Full HD confirmadas. As fotos 1 e 2 são desta unidade.
Sunchip AD-0160 (identifica-se como X3588-i), Android 12, build AD_0160-V1.0-12-PAPPER-8K+DP-SW0.1-20221122 HDMI 1, DisplayPort 1, DSI 1 O composer lê o arquivo e recorta a HDMI 1 corretamente. A DisplayPort não entrou na parede. Não resolvido.

Na unidade Sunchip, a segunda saída HDMI da carcaça está desativada neste firmware (nó de device tree hdmi@fdea0000), então é necessário outro firmware do fornecedor para usá-la. A placa também tem uma entrada HDMI.

Limites conhecidos

  • O app precisa de root.
  • O app suporta no máximo 4 monitores, todos com a mesma resolução, somente Full HD ou 4K.
  • Na unidade Sunchip, a DisplayPort ficou fora da parede e espelhou o canvas inteiro. A causa não foi investigada.
  • Um app de Player que inicia no boot pode cobrir a pergunta Keep this layout?. A contagem continua por trás dele, então o layout é revertido se ninguém voltar ao app a tempo.
  • Em firmwares que ignoram a propriedade do framebuffer, a alternativa com wm size não pode passar de duas vezes o tamanho que o composer reporta. Isso não basta para paredes mais largas que dois monitores.
  • O app só conhece o que o kernel reporta. Ele não consegue saber de antemão se uma saída específica pode participar de uma parede.

Recuperar o dispositivo com adb

O adb continua funcionando seja qual for a imagem na tela. Em dispositivos com o su original, a sintaxe é su 0 <comando>. Execute estes comandos em ordem:

adb shell su 0 mount -o rw,remount /vendor
adb shell su 0 cp -p /vendor/etc/HwComposerEnv.xml.bak /vendor/etc/HwComposerEnv.xml
adb shell su 0 rm -f /vendor/etc/HwComposerEnv.xml.applied /vendor/etc/HwComposerEnv.xml.pending
adb shell su 0 cat /vendor/etc/HwComposerEnv.xml.framebuffer.bak
adb shell su 0 setprop persist.vendor.framebuffer.main <value printed by the previous line>
adb shell wm size reset
adb reboot

Verificações úteis em um dispositivo novo:

adb shell ls /vendor/etc/HwComposerEnv.xml
adb shell getprop persist.vendor.framebuffer.main
adb shell grep . /sys/class/drm/card0-*/status
adb shell su 0 id
adb shell wm size

Solução de problemas

  • Apply and reboot está desativado, ou o app mostra um erro e não reinicia: o dispositivo não atende a um requisito. Se o Apply and reboot está desativado, o app não encontrou o HwComposerEnv.xml em /vendor/etc nem em /vendor, ou o firmware não inclui o recurso splice. Execute adb shell ls /vendor/etc/HwComposerEnv.xml. Se o arquivo não existir, o dispositivo precisa de um firmware compilado a partir do kit Android da Rockchip com splice incluído. Se o app mostra um erro e não reinicia, uma das etapas até a etapa 5 da aplicação do layout falhou, por exemplo porque o app não tem acesso root ou não consegue tornar /vendor gravável. Leia o motivo e a saída do shell na tela e execute adb shell su 0 id para confirmar o root.
  • O layout volta ao anterior depois do reinício: ninguém respondeu Keep this layout? em 45 segundos, ou um app de Player que inicia no boot cobriu a pergunta. Fique diante da parede durante o Apply and reboot e, se o app de Player estiver na frente, volte ao Video Wall Configuration antes do fim da contagem.
  • A imagem está na ordem errada entre os monitores: os cabos estão em uma ordem diferente da configuração. Abra o app, selecione a célula do monitor no Wall preview e escolha a saída correta. Use Identify monitors para confirmar qual saída aciona cada monitor.
  • O dispositivo ficou com um layout errado ou sem imagem utilizável: o layout aplicado não pode ser revertido pela tela. Recupere o dispositivo com adb, conforme descrito em Recuperar o dispositivo com adb.

Artigos relacionados