Cómo configurar un videowall en Players Rockchip con la aplicación de configuración de videowall

Utilice la aplicación de configuración de videowall para que un Player Android de Rockchip controle varios monitores como si fueran una sola pantalla grande.

Algunas implementaciones requieren que un único Player muestre el contenido en varios monitores como si fueran una sola pantalla grande. La app Video Wall Configuration, para Players Android con hardware Rockchip, permite describir cómo están montados los monitores y escribe la configuración correspondiente en el dispositivo, que se reinicia con la imagen dividida entre los monitores.

Cómo funciona

Video Wall Configuration es una app Android pequeña. Usted define el número de monitores, la resolución y la disposición. La app escribe la configuración correspondiente para el hardware composer de Rockchip, que realiza la división de la imagen (Rockchip llama a esta función splice). Una vez escrito el archivo, el dispositivo se reinicia.

La app en una pared de cuatro monitores

App en ejecución en una pared de 1 x 4. Los cuatro monitores forman una sola pantalla de 7680 x 1080, por lo que la app, que está en el centro, aparece sobre los monitores 2 y 3.

Qué hace Apply and reboot

Al seleccionar Apply and reboot, la app ejecuta estos pasos, en orden:

  1. Solicita confirmación.
  2. Habilita la escritura en la partición /vendor.
  3. Guarda el archivo original como HwComposerEnv.xml.bak, solo si todavía no existe una copia de seguridad. La copia de seguridad nunca se sobrescribe.
  4. Guarda una copia de la configuración que está activa en este momento, usada en el paso de conservar o revertir.
  5. Escribe el nuevo archivo junto al destino, define propietario y permisos, lo renombra sobre el destino, lo lee de nuevo y lo compara.
  6. Define persist.vendor.framebuffer.main con el tamaño del canvas, para que el composer informe a Android de la pared completa como tamaño del display. El valor original se guarda una sola vez.
  7. Borra cualquier override de wm size.
  8. Reinicia el dispositivo. Es necesario un reinicio completo, porque el composer solo lee el archivo cuando se inicia.

Si falla cualquier paso hasta el paso 5, la app se detiene, muestra el motivo y la salida del shell, y no reinicia el dispositivo.

Conservar o revertir el diseño

Después del reinicio, cuando Android termina de iniciar, la app se abre sola y pregunta Keep this layout? en cada monitor de la pared. Esto evita que un diseño que nadie puede ver, o que es claramente incorrecto, permanezca en el dispositivo. También significa que, si usted aplica el diseño sin nadie frente a la pared, siempre se revertirá.

Nota: si nadie responde en 45 segundos, la app restaura la configuración que estaba activa antes de aplicar el diseño y reinicia el dispositivo.

 

Requisitos

La app funciona solo en Android. No depende del fabricante de la placa y funciona en cualquier dispositivo cuyo firmware se haya compilado a partir del kit Android de Rockchip con la función splice incluida. El dispositivo debe cumplir todos estos requisitos:

Requisito Motivo
Firmware de Rockchip con HwComposerEnv.xml en /vendor/etc o /vendor El hardware composer de Rockchip lee este archivo y realiza la división de la imagen. Sin él, la app desactiva el botón Apply and reboot.
Root mediante su, utilizable por apps El archivo está en la partición vendor, que es de solo lectura. La firma de plataforma por sí sola no es suficiente.
Android 11 o posterior Versión mínima de la app.
Más de una salida de video habilitada en el firmware La app solo ofrece las salidas que reporta el kernel.

Nota: una versión de la app sin root requiere un cambio de firmware: un composer que lea el archivo desde una ubicación con permiso de escritura o un servicio auxiliar con root.

 

Instalar la app

Descargue la app desde el enlace de descarga.

  1. Conecte la computadora al Player mediante adb (Guía de conexión ADB).
  2. Ejecute adb install -r Video-Wall-Configuration.apk.
  3. Abra la app una vez en el Player, para que pueda iniciarse sola después de un reinicio.

Configurar el video wall

El lado izquierdo de la pantalla principal tiene tres opciones: número de monitores, resolución de cada monitor y disposición. El lado derecho muestra el Wall preview, el panel Device y las dos acciones, Restore original y Apply and reboot.

La pantalla principal con un solo monitor seleccionado

En Monitors, seleccione el número de monitores. La app ofrece hasta 4, y nunca más que el número de salidas del dispositivo.

En Resolution of each monitor, seleccione Full HD (1920 x 1080) o 4K (3840 x 2160). La resolución es la misma para todos los monitores.

En Arrangement, seleccione la disposición. La app lista todas las disposiciones rectangulares para el número elegido, por ejemplo 1 x 2 (lado a lado) y 2 x 1 (apilados). Los tamaños se escriben como filas x columnas.

La pantalla principal con un solo monitor seleccionado

En el Wall preview, revise el Total canvas. La vista previa está dibujada a escala, y cada celda muestra el número del monitor y la salida que lo controla.

Para cambiar la salida de un monitor, seleccione su celda y elija una salida en el menú. Si elige una salida que otro monitor ya usa, la app intercambia las dos. Esto corrige un orden incorrecto de cables sin tocar los cables. Las celdas angostas usan nombres cortos, como DP 1 para DisplayPort 1.

Tres monitores 4K apilados con el menú de salidas abierto

Si es necesario, elija una salida sin nada conectado. Estas salidas aparecen como not connected y se pueden seleccionar igualmente.

El menú de salidas marcando DisplayPort 1 como not connected

Seleccione Apply and reboot y confirme.

Después del reinicio, revise la pregunta Keep this layout? (consulte Confirmar el diseño, más abajo) y seleccione cualquier parte de la pantalla dos veces para conservar el diseño.

Nota: mientras la app está abierta, vuelve a leer la lista de salidas cada 3 segundos. Conecte o desconecte un cable para descubrir qué puerto físico corresponde a cada salida.

 

Leer el panel Device

  • Connected outputs: lo que el kernel reporta como conectado.
  • Configuration file: dónde se encontró HwComposerEnv.xml.
  • Active canvas: el diseño que está actualmente en el archivo del dispositivo, que no es necesariamente el seleccionado a la izquierda.
  • Backup state: indica si ya se guardó la configuración original.
  • Identify monitors: se muestra cuando hay una pared activa.

Identify monitors

Seleccione Identify monitors para dejar todo el canvas en negro y rellenar la porción de cada salida con un color propio, el nombre de la salida y el número del monitor. Como el composer corta el canvas de la misma manera, cada monitor físico muestra qué salida lo controla. La función identifica el diseño que está activo en el dispositivo, no el que usted está editando. Seleccione cualquier parte para cerrarla.

Identify monitors en una pared de dos monitores

Confirmar el diseño

Después del reinicio, la pregunta Keep this layout? aparece como una tarjeta pequeña en cada monitor, dibujada sobre un patrón (marco, diagonales y un círculo) que abarca todo el canvas. Cuando los monitores están en los lugares correctos, las líneas continúan de una pantalla a la siguiente.

La pregunta Keep this layout? capturada en una pared de dos monitores
  • Cada tarjeta muestra Monitor N of M y la salida, por lo que es fácil notar un monitor faltante.
  • Para conservar el diseño se requieren dos selecciones separadas (clic, toque o Enter). Un doble clic cuenta como una sola.
  • Sin respuesta en 45 segundos, la app restaura lo que estaba activo antes de aplicar el diseño y reinicia el dispositivo.

Restaurar la configuración original

Seleccione Restore original para volver a colocar HwComposerEnv.xml.bak y el valor guardado del framebuffer, borrar el override de wm size y reiniciar el dispositivo. Las copias de seguridad se conservan, por lo que puede repetir la acción.

Nota: Restore original devuelve lo que había en el dispositivo antes de que la app lo modificara por primera vez. Solo equivale al estado de fábrica si el dispositivo no había sido modificado hasta entonces.

 

Archivos y configuraciones que la app modifica

Todos los archivos se encuentran junto al archivo de configuración. La app no modifica nada más en el dispositivo.

Elemento Finalidad
HwComposerEnv.xml Diseño leído por el hardware composer.
HwComposerEnv.xml.bak Archivo original, guardado una sola vez.
HwComposerEnv.xml.framebuffer.bak Valor original de la propiedad del framebuffer, guardado una sola vez.
HwComposerEnv.xml.applied Marcador: el archivo activo fue escrito por esta app.
HwComposerEnv.xml.pending Marcador: el diseño todavía espera confirmación.
HwComposerEnv.xml.previous y archivos relacionados Lo que estaba activo antes de la última aplicación del diseño, se elimina cuando el diseño se conserva o se revierte.
persist.vendor.framebuffer.main Tamaño que el composer informa a Android.
override de wm size Normalmente se borra. Se usa solo como alternativa cuando no se puede definir la propiedad.

Cómo la app encuentra las salidas

La app lista /sys/class/drm, donde el kernel mantiene una entrada por salida (por ejemplo card0-HDMI-A-1), y lee el archivo status de cada entrada. El tipo y el número de esos nombres son exactamente lo que se escribe en el archivo de configuración. Tenga en cuenta dos puntos:

  • Las salidas DSI y los puertos detrás de chips conversores suelen reportar connected con o sin monitor conectado.
  • Un puerto que el firmware no habilita simplemente no aparece, aunque el conector exista en la carcasa.

Dispositivos probados

Dispositivo Salidas reportadas Resultado
Unidad Giada que reporta el modelo dn84 HDMI 1, HDMI 2, DisplayPort 1, DSI 1, todas disponibles como puertos HDMI en la carcasa Paredes lado a lado con 2, 3 y 4 monitores Full HD confirmadas. Las fotos 1 y 2 son de esta unidad.
Sunchip AD-0160 (se identifica como X3588-i), Android 12, build AD_0160-V1.0-12-PAPPER-8K+DP-SW0.1-20221122 HDMI 1, DisplayPort 1, DSI 1 El composer lee el archivo y recorta HDMI 1 correctamente. DisplayPort no se unió a la pared. No resuelto.

En la unidad Sunchip, la segunda salida HDMI de la carcasa está deshabilitada en este firmware (nodo de device tree hdmi@fdea0000), por lo que se necesita otro firmware del fabricante para usarla. La placa también tiene una entrada HDMI.

Límites conocidos

  • La app necesita root.
  • La app admite como máximo 4 monitores, todos con la misma resolución, solo Full HD o 4K.
  • En la unidad Sunchip, DisplayPort quedó fuera de la pared y reflejó todo el canvas. No se investigó la causa.
  • Una app de Player que se inicia en el arranque puede tapar la pregunta Keep this layout?. La cuenta regresiva sigue corriendo detrás, por lo que el diseño se revierte si nadie vuelve a la app a tiempo.
  • En firmware que ignora la propiedad del framebuffer, la alternativa con wm size no puede superar el doble del tamaño que reporta el composer. Esto no alcanza para paredes más anchas que dos monitores.
  • La app solo conoce lo que reporta el kernel. No puede saber de antemano si una salida determinada puede participar en una pared.

Recuperar el dispositivo con adb

adb sigue funcionando sea cual sea la imagen en la pantalla. En dispositivos con el su original, la sintaxis es su 0 <comando>. Ejecute estos comandos en orden:

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

Comprobaciones útiles en un dispositivo nuevo:

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

Solución de problemas

  • Apply and reboot está deshabilitado, o la app muestra un error y no reinicia: el dispositivo no cumple un requisito. Si Apply and reboot está deshabilitado, la app no encontró HwComposerEnv.xml en /vendor/etc ni en /vendor, o el firmware no incluye la función splice. Ejecute adb shell ls /vendor/etc/HwComposerEnv.xml. Si el archivo no existe, el dispositivo necesita un firmware compilado a partir del kit Android de Rockchip con splice incluido. Si la app muestra un error y no reinicia, falló uno de los pasos hasta el paso 5 de la aplicación del diseño, por ejemplo porque la app no tiene acceso root o no puede habilitar la escritura en /vendor. Lea el motivo y la salida del shell en pantalla, y ejecute adb shell su 0 id para confirmar el root.
  • El diseño vuelve al anterior después del reinicio: nadie respondió Keep this layout? en 45 segundos, o una app de Player que se inicia en el arranque tapó la pregunta. Permanezca frente a la pared durante el Apply and reboot y, si la app de Player está al frente, vuelva a Video Wall Configuration antes de que termine la cuenta regresiva.
  • La imagen está en el orden incorrecto entre los monitores: los cables están en un orden distinto al de la configuración. Abra la app, seleccione la celda del monitor en el Wall preview y elija la salida correcta. Use Identify monitors para confirmar qué salida controla cada monitor.
  • El dispositivo quedó con un diseño incorrecto o sin una imagen utilizable: el diseño aplicado no se puede revertir desde la pantalla. Recupere el dispositivo con adb, como se describe en Recuperar el dispositivo con adb.

Artículos relacionados