ITS integrado de la cámara

El Paquete de prueba de imagen de la cámara de Android (ITS) forma parte del verificador del Conjunto de pruebas de compatibilidad (CTS) de Android y, además, incluye pruebas que verifican el contenido de las imágenes. El verificador del CTS admite la automatización de pruebas de ITS con ITS integrado en la cámara. La compatibilidad con pruebas manuales abarca todos los factores de forma de dispositivos Android.

La solución ITS-in-a-box incluye los siguientes beneficios:

• Automatización. No se necesita intervención humana durante la prueba.
• Fácil solución de problemas. La coherencia del entorno de pruebas genera menos errores de configuración y aumenta la reproducibilidad.
• Eficiencia. La capacidad de reintentar para una cámara o escena individual mejora la eficiencia de la ejecución de las pruebas.

Comenzar

El ITS en una caja consta de una caja de plástico cortada con láser a partir de dibujos de diseño asistido por computadora (CAD), una tablet de gráficos y un dispositivo en prueba (DUT). En la siguiente tabla, se describen las funciones y especificaciones de los diferentes sistemas ITS en una sola unidad disponibles.

Para comenzar a usar el ITS integrado de la cámara:

1. Compra o compila un ITS integrado modular, WFoV o RFoV.
2. Configurar una tablet con el software de ITS de la cámara
3. Ejecuta pruebas.
4. Obtén resultados del DUT.

Cómo configurar la tablet

En esta sección, se proporcionan instrucciones paso a paso para configurar una tableta para usarla con las pruebas de ITS de la cámara que se encuentran en el directorio CameraITS. En estas instrucciones, se usa una Pixel C como una tablet de ejemplo. Para obtener información sobre los requisitos y las recomendaciones para tablets, consulta Requisitos para tablets.

Nota: Las secuencias de comandos de Python de ITS de la cámara configuran automáticamente las siguientes opciones en la tablet:
Configuración > Pantalla > Suspender > Después de 30 minutos de inactividad
Brillo adaptable > DESACTIVADO

1. Carga la tablet y enciéndela. Si se te solicita que configures una cuenta, omite este paso (el ITS de la cámara no requiere ninguna cuenta vinculada a la tablet).
2. Actualiza la tablet a Android 7.0 o una versión posterior. Android 6.x y versiones anteriores no son compatibles con ITS de la cámara.
3. Habilita el modo de desarrollador.
4. Vuelve a Configuración y selecciona Opciones para desarrolladores.

   Habilita las opciones	Activado No desactivar Depuración por USB (esto permite que el host ejecute la tablet en modo de depuración. Cuando conectes la tablet al host por primera vez, se te preguntará ¿Permitir la depuración por USB? Si la tablet no muestra el mensaje de depuración, desconéctala y vuelve a conectarla.
   Inhabilitar opciones	Actualizaciones automáticas del sistema Verificar aplicaciones por USB

5. Ejecuta $ adb devices para determinar los IDs de DUT y de gráfico y mostrar una lista de los dispositivos disponibles. Para determinar device_id y chart_id, conecta y desconecta dispositivos y observa los dispositivos que se conectan y desconectan.
6. Realiza tres ejecuciones de prueba para suprimir sugerencias y mensajes del usuario que puedan oscurecer los gráficos en la pantalla de la tablet.
   1. Coloca la tablet con la pantalla hacia arriba sobre una mesa (no la conectes al panel posterior de la caja).
   2. Ejecuta el siguiente comando:

      python tools/run_all_tests.py device=$device_id camera=0 chart=$chart_id scenes=2,3
      

      Las escenas 2 y 3 requieren que la tablet muestre una imagen, por lo que la tablet pregunta ¿Quieres permitir que Drive acceda a las fotos, el contenido multimedia y los archivos de tu dispositivo?. Para borrar este mensaje y evitarlo en el futuro, presiona Permitir.
   3. Ejecute el comando de nuevo. La tablet pregunta ¿Quieres conservar una copia de este archivo? y sugiere Google Drive. Borra este mensaje (y evita que se envíen mensajes en el futuro). Para ello, presiona el ícono de Drive y, luego, Cancelar para subirlo a Drive.
   4. Por último, ejecuta tools/run_all_tests.py y confirma que las escenas cambien automáticamente a medida que la secuencia de comandos alterna entre diferentes escenas. Si bien la mayoría de las pruebas fallan (ya que la cámara no está apuntando al gráfico), puedes verificar que la tablet pase correctamente por las escenas sin mostrar ningún mensaje ni otra ventana emergente en la pantalla.

Cómo ejecutar pruebas

Antes de ejecutar el ITS integrado, asegúrate de que la configuración de prueba incluya el hardware y el software que se indican a continuación:

• Un (1) ITS integrado
• Una (1) tablet de alta resolución de 10" para mostrar escenas, número de serie: 5811000011
• Un (1) DUT que tenga instalada la app del verificador de CTS 7.0_8 o una versión posterior Ejemplo de DUT:
  • Un (1) Pixel NOF26W para la prueba de la cámara posterior(0). Número de serie: FA6BM0305016. Para instalar la app de CTS Verifier, descomprime android-cts-verifier.zip y, luego, ejecútala.

    adb -s FA6BM0305016 install -r -g android-cts-verifier/CtsVerifier.apk
    

Ejecuta escenas basadas en tablets

Sigue estos pasos para ejecutar las escenas 0 a 4, 6 y species_change en la cámara posterior:

cd android-cts-verifier/CameraITS
. build/envsetup.sh
python tools/run_all_tests.py camera=0

Ejemplo:

Volver a intentar las escenas

Puedes volver a intentar escenas para una sola cámara:

• Para volver a intentar capturar escenas en una sola cámara, haz lo siguiente:

  python tools/run_all_tests.py device=FA6BM0305016 camera=0 scenes=3,4
  

Ejecuta la escena 5

La escena 5 requiere una configuración especial con iluminación específica (para obtener más información, consulta CameraITS.pdf en el verificador de CTS, que puedes descargar en Descargas del Conjunto de pruebas de compatibilidad). Debes ejecutar la escena 5 por separado (fuera de la caja).

Para ejecutar la escena 5 de las cámaras frontal y posterior en un solo dispositivo, haz lo siguiente:

python tools/run_all_tests.py device=FA6BM0305016 camera=0 scenes=5
python tools/run_all_tests.py device=FA6BM0305016 camera=1 scenes=5

Cómo obtener resultados

Puedes ver los resultados durante las pruebas y guardar los resultados completos como un informe.

• Ver resultados. Para guardar los resultados de ITS de la cámara como un informe, sigue estos pasos:
  1. Presiona Aprobado y guarda el informe.
     
     Figura 3: Informe del ITS de la cámara
  2. Extraer informes del dispositivo:

     adb -s FA6BM0305016 pull /sdcard/verifierReports
     

  3. Descomprime el archivo del informe y visualiza test_result.xml.
     
     Figura 4: Informes de ITS de la cámara
     

Requisitos de la tablet

En el caso de Android 15 y versiones posteriores, las tablets que se usan para mostrar el gráfico de ITS deben estar en la siguiente lista de tablets permitidas. Para obtener una lista de las tablets que admiten pruebas de escenas con poca luz, consulta Tablets compatibles para escenas con poca luz. Para Android 14 o versiones anteriores, consulta los requisitos de las tablets para Android 14 y versiones anteriores.

Las tablets de la lista de entidades permitidas se eligen según los siguientes criterios:

• Tamaño de pantalla de alrededor de 10 pulgadas con una resolución de pantalla superior a 1920 x 1200 píxeles
• No debe tener ningún parpadeo medido causado por el atenuamiento de la pantalla controlado por modulación de ancho de pulso (PWM).
• Puede ejecutar comandos adb enviados por pruebas de ITS y mostrar imágenes de gráficos con el brillo de la pantalla indicado.

El valor de brightness se debe establecer en config.yml según el modelo de la tableta. Para determinar si el modelo de tu tablet corresponde a un nombre de dispositivo en la lista de entidades permitidas, imprime el valor ro.product.device ejecutando el comando adb adb shell getprop | grep 'ro.product.device'.

Tablets compatibles para escenas con poca luz

Requisitos de las tablets para Android 14 y versiones anteriores

Las tablets deben tener un tamaño de pantalla de aproximadamente 10 pulgadas con una resolución de pantalla superior a 1920 x 1200 píxeles. La tablet no debe usar modulación de ancho de pulso (PWM) para establecer el nivel de brillo. El valor brightness se debe establecer en config.yml según el modelo de la tablet. En la siguiente tabla, se enumeran las tablets recomendadas para las pruebas de ITS, junto con las versiones de Android para las que funcionan las tablets.

Preguntas frecuentes

P.1: ¿Cómo determino qué plataformas de prueba necesito para mi dispositivo?

La revisión 1 de RFoV ITS-in-a-box prueba cámaras RFoV para pruebas de escenas de tablets en el directorio CameraITS/tests. El RFoV se define como 60° < FoV < 90°. En el caso de las cámaras con un campo visual más amplio, es posible que las luces aparezcan en las imágenes o que los gráficos cubran un área demasiado pequeña en el campo visual, lo que afecta los resultados de la prueba.

La revisión 2 del tipo WFoV ITS-in-a-box prueba cámaras WFoV para pruebas de escenas de tablets en el directorio CameraITS/tests. WFoV se define como FoV >= 90°. El equipo de prueba de la revisión 2 es idéntico en términos funcionales a la revisión 1, pero más grande. El equipo de prueba de la revisión 2 puede probar cámaras RFoV y WFoV en Android 9 y versiones posteriores. Debido al mayor espacio, la revisión 2 es ideal si el DUT es una tablet.

El equipo de base modular prueba cámaras WFoV para pruebas de escenas de tablets en el directorio CameraITS/tests. WFoV se define como FoV >= 90°. La plataforma base modular puede probar cámaras RFoV y WFoV en dispositivos que ejecutan Android 9 y versiones posteriores. También admite el sistema de extensión telescópica que se puede conectar para probar cámaras telescópicas con una distancia de enfoque mínima más larga. El sistema de base modular es funcionalmente idéntico al ITS en una caja de WFoV, pero es más pequeño.

La caja de fusión de sensores prueba el desfase de sincronización de la cámara o el giroscopio, y la sincronización de fotogramas de los sistemas de varias cámaras con pruebas en scenes=sensor_fusion. Se requiere un desfase de tiempo de la cámara o el giroscopio de menos de 1 ms para la marca de función REALTIME.

Los dispositivos con varias cámaras se pueden probar con una sola plataforma para pruebas de ITS estáticas y una plataforma de fusión de sensores si la cámara tiene la marca de función REALTIME.

En la siguiente tabla, se proporciona un conjunto de parámetros de configuración de ejemplo.

P.2: ¿Cómo designo qué equipo de prueba está en uso?

Para designar el equipo de prueba correcto, asegúrate de que el parámetro de distancia del gráfico sea correcto. El equipo de prueba de la rev1 (RFoV) tiene una distancia de la tabla de 31 cm, y el equipo de la rev2 (WFoV) tiene una distancia de la tabla de 22 cm. De forma predeterminada, la distancia del gráfico se establece en 31 cm.

De Android 10 a Android 11

python tools/run_all_tests.py ... chart=# dist=22

Android 12 y versiones posteriores

edit config.yml
chart_distance: 31.0 → chart_distance: 22.0

P.3: ¿Cómo controlo el brillo de la tablet?

De forma predeterminada, el brillo de la tablet se establece en 96.

Para cambiar el brillo en tablets con Android 7.0 a Android 9, ejecuta lo siguiente:

edit tools/wake_up_screen.py
DISPLAY_LEVEL=96 → DISPLAY_LEVEL=192

Para cambiar el brillo en las tablets que ejecutan Android 10 a 11, se puede cambiar el valor en la línea de comandos agregando la marca brightness:

python tools/run_all_tests.py device=# camera=# chart=# brightness=192

Para cambiar el brillo en tablets que ejecutan Android 12 y versiones posteriores, ejecuta lo siguiente:

edit config.yml
brightness: 96 → brightness: 192

P.4: ¿Cómo depurar una sola prueba?

Las pruebas se pueden ejecutar de forma individual para depurar, pero los resultados no se informan a CtsVerifier.apk, a menos que se ejecute toda la escena.

Para ejecutar una escena individual en Android 11 y versiones anteriores, haz lo siguiente:

1. Para cargar una escena, agrega la marca scenes en tools/run_all_tests.py:

   python tools/run_all_tests.py device=# camera=# chart=# scenes=#
   

2. Presiona Control + C para detener las pruebas después de que la escena se registre como cargada en stdout.

   Si la escena correcta ya está en la pantalla, actívala:

   python tools/wake_up_screen.py screen=#
   

3. Ejecuta una prueba individual.

   python tests/scene#/test_*.py device=# camera=#

   Luego, se generan tramas en el directorio local y se imprimen stdout y stderr en la pantalla.

   Para obtener más información para depurar, agrega sentencias print a la secuencia de comandos. Para aumentar el resultado de la prueba para la depuración, agrega la marca debug=True.

   python tests/scene#/test_*.py device=# camera=# debug=True

Los resultados se imprimen en la pantalla local y las imágenes se guardan en el directorio local en lugar del directorio /tmp/tmp### generado cuando se ejecuta tools/run_all_tests.py.

Para ejecutar una escena individual en Android 12 y versiones posteriores, haz lo siguiente:

1. Edita el archivo config.yml.

   edit config.yml
   camera: <camera-id> → camera:  0
   scene: <scene-name> → scene: scene1_1

2. Ejecuta la prueba individual.

   python tools/run_all_tests.py -c config.yml --test_bed TEST_BED_TABLET_SCENES
   

Los resultados se imprimen en el directorio /tmp/logs/mobly/TEST_BED_TABLET_SCENES/ ordenados por tiempo de ejecución.

P.5: ¿Por qué debo ejecutar pruebas fallidas como una escena completa en lugar de volver a ejecutarlas de forma individual?

Las pruebas se pueden ejecutar de forma individual para depurar, pero los resultados no se informan a CtsVerifier.apk, a menos que se ejecute toda la escena.

El ITS de la cámara garantiza que las apps de terceros tengan una interfaz de cámara compatible. Al igual que en una prueba de unidades, cada prueba pone a prueba una sola especificación de la cámara. Para detectar un comportamiento poco confiable, se espera que estas pruebas se aprueben como un grupo para una escena completa. Por ejemplo, aunque una sola prueba poco confiable puede aprobar una repetición de una escena completa, es difícil que aprueben varias pruebas poco confiables.

Como ejemplo extremo, considera el caso en el que hay 10 pruebas en una escena que, cada una, tiene una probabilidad del 50% de mostrar PASS. Si se ejecuta cada prueba de forma individual, es muy probable que un operador pueda hacer que la cámara pase la ITS de la cámara. Sin embargo, si las pruebas se ejecutan en conjunto como una escena, solo hay una probabilidad del 0.1% de que la escena pase.

P6: ¿Cómo puedo ejecutar una sola escena o cambiar el orden de las escenas de ejecución?

De forma predeterminada, la secuencia de comandos tools/run_all_tests.py ejecuta todas las escenas en orden. Sin embargo, las escenas se pueden ejecutar de forma individual o en un orden específico, y se pueden informar a CtsVerifier.apk.

Para ejecutar una escena individual (por ejemplo, la escena 2) o más de una en un orden específico en Android 11 o versiones anteriores, haz lo siguiente:

python tools/run_all_tests.py device=# camera=# chart=# scenes=2

python tools/run_all_tests.py device=# camera=# chart=# scenes=3,2

Para ejecutar una escena individual o más de una en un orden específico en Android 12 y versiones posteriores, haz lo siguiente:

python tools/run_all_tests.py scenes=2

python tools/run_all_tests.py scenes=3,2

Los parámetros adicionales se establecen en el archivo config.yml.

P7: Varias pruebas de escena 1 fallan con la configuración de la tablet, pero se aprueban con un gráfico de papel. ¿Cuál es el problema?

Asegúrate de que la tablet y el entorno de pruebas cumplan con las siguientes especificaciones.

Especificaciones de la tablet

Asegúrate de que la tablet cumpla con las siguientes especificaciones:

• Tamaño de la pantalla (pulgadas): 10 pulgadas
• Tamaño de la pantalla (píxeles): superior a 1,920 x 1,200 píxeles

Para obtener más información, consulta los Requisitos para tablets.

Brillo de la tablet

Es posible que las pruebas no obtengan resultados correctos si el brillo de la pantalla de la tablet es demasiado bajo.

Para obtener más detalles, consulta ¿Cómo controlo el brillo de la tablet?

Nivel de iluminación de la caja (requiere luxómetro)

Asegúrate de que el valor en lux objetivo al abrir la tablet esté entre 100 y 300.

Si el nivel de lux es demasiado alto, scene1/test_param_flash_mode.py muestra FAIL. Si el nivel de lux es demasiado bajo, fallarán varias pruebas.

P8: ¿Cómo puedo depurar las pruebas de fusión de sensores?

1. Asegúrate de estar en un grupo dialout.

   groups | egrep ‘dialout'

2. Para asegurarte de que el controlador de fusión de sensores esté conectado, determina si la tecnología de microchip está conectada al puerto USB.

   lsusb
   …
   Bus 003 Device 004: ID 04d8:fc73 Microchip Technology, Inc.
   …
   

3. Ejecuta la prueba varias veces para obtener una distribución de los intentos de prueba con los siguientes comandos.

   En Android 11 o versiones anteriores:

   python tools/run_sensor_fusion_box.py device=A camera=0 num_runs=10 rotator=default
   

   En Android 12 y versiones posteriores:

   python tools/run_sensor_fusion_box.py num_runs=10
   

   Los parámetros adicionales se establecen en el archivo config.yml.

   Los resultados de la ejecución se encuentran en la carpeta /tmp/tmp### creada en las carpetas sensor_fusion_#, donde # es el número de ejecución. Estos son algunos motivos comunes de los errores:

   1. El teléfono no está centrado correctamente.
   2. No se encontraron suficientes características en la imagen (a menudo, un problema de campo de visión o iluminación).
   3. El FAIL que se muestra es válido, y se debe corregir el desfase de tiempo entre la cámara y el giroscopio.

P.9: ¿Qué información debo incluir cuando informo un error de prueba?

Cuando informes un error de prueba, incluye los archivos y las imágenes generados para la prueba.

1. Si ejecutaste la prueba a través de tools/run_all_tests.py, adjunta un directorio /tmp/ comprimido al error.
2. Si ejecutaste la prueba por sí sola, adjunta todos los resultados de la pantalla y las imágenes generadas al error.

También incluye un informe de errores. Después de que falle la prueba en cuestión, usa el siguiente comando para generar un informe de errores y adjuntar el archivo ZIP generado al error.

adb -s device_id bugreport

P.10: ¿Cómo ejecuto una escena de prueba de sensor_fusion con una cámara que tiene una distancia de enfoque mínima que crea imágenes borrosas a una distancia de la tabla de 25 cm?

Si la cámara no puede enfocar a una distancia de 25 cm, quita el panel de montaje de la caja de fusión de sensores. Coloca el gráfico a una distancia en la que el DUT pueda enfocarse y cambia chart_distance en config.yml a la distancia medida entre el DUT y el gráfico. En la figura 5, se muestra un ejemplo de cómo medir la distancia del gráfico en esta situación.

  edit config.yml
chart_distance: 25 → chart_distance: DISTANCE_BETWEEN_DUT_AND_CHART

P.11: ¿Cómo ejecuto escenas de prueba de tablet para una cámara con una distancia de enfoque mínima que crea imágenes borrosas a una distancia de 31 cm de la tabla?

Si la cámara no puede producir imágenes lo suficientemente nítidas a 31 cm (la profundidad del sistema de prueba de RFoV), instálala frente al sistema a una distancia que permita que la escena del gráfico ocupe aproximadamente el 60% del campo visual (FoV) de la cámara con imágenes más nítidas. Esta distancia puede ser menor que la distancia de enfoque mínima de la cámara. Deja el chart_distance en config.yml a 31 cm. El campo de visión de la cámara determina la escala del gráfico en la tablet, como se muestra en la siguiente tabla:

P.12: Con la API de varias cámaras lógica, ¿qué pruebas se ejecutan en qué cámaras?

Si tu cámara usa REQUEST_AVAILABLE_CAPABILITIES_LOGICAL_MULTI_CAMERA, todas las pruebas de ITS compatibles se ejecutan en la cámara lógica de nivel superior. Un subconjunto de las pruebas de ITS se ejecuta en las cámaras secundarias físicas, y estas pruebas se enumeran en tools/run_all_tests.py, debajo de la constante SUB_CAMERA_TESTS.