Imágenes DTB

Las implementaciones de Android pueden incluir una imagen de blob de árbol de dispositivos (DTB) para que la use el gestor de arranque. La ubicación de la imagen DTB (y las opciones para especificar los parámetros de la imagen DTB) difiere entre las versiones de Android.

  • En Android 11, los dispositivos que usan Generic Kernel Image (GKI) deben ser compatibles con la partición de inicio del proveedor , que incluye toda la información específica del proveedor que se reubicó desde la partición de inicio. Dado que la imagen DTB contiene datos específicos del proveedor, ahora forma parte de la partición de arranque del proveedor. Para especificar parámetros de imagen DTB, consulte Encabezado de arranque del proveedor .

  • En Android 10, los dispositivos pueden incluir la imagen DTB en la partición de arranque. Para especificar los parámetros de la imagen DTB, consulte Inclusión de la imagen DTB en la imagen de arranque .

  • En Android 9 y versiones anteriores, la imagen DTB puede existir en su propia partición o agregarse a kernel image.gz para crear la imagen kernel + DTB (que luego se pasa a mkbootimg para crear boot.img ).

formato de imagen DTB

En Android 10 y versiones posteriores, la imagen DTB debe usar uno de los siguientes formatos:

  • Blobs DT concatenados uno tras otro. El cargador de arranque usa el campo de totalsize en cada encabezado FDT para leer y analizar el blob correspondiente.

  • Particiones DTB/DTBO. El cargador de arranque tiene una manera eficiente de seleccionar el blob DT correcto examinando la estructura dt_table_entry (contiene id , rev y campos custom ) que puede contener información de identificación de hardware para la entrada). Para obtener más información, consulte Particiones DTB/DTBO .

Incluir la imagen DTB en la imagen de arranque

Los dispositivos que ejecutan Android 10 pueden incluir la imagen DTB en la imagen de arranque. Esto elimina la necesidad de que Android admita scripts que agregan la imagen DTB a image.gz en el kernel y permite el uso de la prueba Vendor Test Suite (VTS) para verificar (y estandarizar) la ubicación de DTB.

Además, para los dispositivos que no son A/B, es más seguro tener el DTB como parte de la imagen de recuperación en lugar de una partición separada para evitar problemas causados ​​por OTA interrumpidos. Durante una OTA, si ocurre un problema después de actualizar la partición DTB (pero antes de completar la actualización completa), el dispositivo intenta iniciarse en modo de recuperación para completar la OTA; sin embargo, dado que la partición DTB ya se ha actualizado, podría producirse una discrepancia con la imagen de recuperación (que aún no se ha actualizado). Tener la imagen DTB como parte del formato de la imagen de inicio evita estos problemas al hacer que la imagen de recuperación sea autosuficiente (es decir, no depende de otra partición).

Estructura de la imagen de arranque

Los dispositivos que ejecutan Android 10 pueden incluir una imagen DTB usando la siguiente estructura de imagen de arranque.

Sección de imagen de arranque Número de páginas
Encabezado de arranque (1 página) 1
Núcleo (l páginas) l = ( kernel_size + page_size - 1) / page_size
Ramdisk (m páginas) m = ( ramdisk_size + page_size - 1) / page_size
Cargador de arranque de segunda etapa (n páginas) n = ( second_size + page_size - 1) / page_size
Recuperación DTBO (o páginas) o = ( recovery_dtbo_size + page_size - 1) / page_size
DTB (p páginas) p = ( dtb_size + page_size - 1) / page_size

Ruta de la imagen DTB

Para dispositivos que ejecutan Android 10, puede usar la herramienta mkbootimg.py y los siguientes argumentos para especificar la ruta a la imagen DTB.

Argumento Descripción
dtb Ruta a la imagen DTB que se incluirá en las imágenes de arranque/recuperación.
dtb_offset Cuando se agrega al argumento base , proporciona la dirección de carga física para el árbol de dispositivos final. Por ejemplo, si el argumento base es 0x10000000 y el argumento dtb_offset es 0x01000000 , el dtb_addr_field en el encabezado de la imagen de arranque se completa como 0x11000000 .

La variable de configuración de la placa BOARD_PREBUILT_DTBIMAGE_DIR debe usarse para especificar la ruta a la imagen DTB. Si hay más de un archivo con la extensión *.dtb en el directorio BOARD_PREBUILT_DTBIMAGE_DIR , el sistema de compilación de Android concatena los archivos para crear la imagen DTB final utilizada en la creación de la imagen de arranque.

Para pasar el argumento dtb a mkbootimg.py con la imagen DTB desde el directorio especificado por BOARD_PREBUILT_DTBIMAGE_DIR , la variable de configuración de la placa BOARD_INCLUDE_DTB_IN_BOOTIMG debe establecerse en true . Por ejemplo:

BOARD_INCLUDE_DTB_IN_BOOTIMG := true

Puede agregar el argumento dtb_offset a la variable de configuración de la placa BOARD_MKBOOTIMG_ARGS con las otras compensaciones y la versión del encabezado. Por ejemplo:

BOARD_MKBOOTIMG_ARGS := --ramdisk_offset $(BOARD_RAMDISK_OFFSET) --dtb_offset $(BOARD_DTB_OFFSET) --tags_offset $(BOARD_KERNEL_TAGS_OFFSET) --header_version $(BOARD_BOOTIMG_HEADER_VERSION)

Soporte de cargador de arranque

Para que VTS se ejecute correctamente en dispositivos que ejecutan Android 10, el cargador de arranque debe admitir la imagen de arranque actualizada y debe agregar el parámetro de línea de comando del kernel androidboot.dtb_idx para indicar el índice del árbol de dispositivos (DT) seleccionado. Puede especificar solo un (1) índice. Por ejemplo, el parámetro androidboot.dtb_idx=N informa N como el índice basado en cero del árbol de dispositivos seleccionado por el gestor de arranque del conjunto de DTB presentes en la imagen de arranque.