Las implementaciones de Android pueden incluir una imagen de BLOB del árbol de dispositivos (DTB) para que la use el bootloader. La ubicación de la imagen de DTB (y las opciones para especificar los parámetros de la imagen de DTB) difieren entre las versiones de Android.
En Android 11, los dispositivos que usan la imagen genérica del kernel (GKI) deben admitir 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. Debido a que la imagen del DTB contiene datos específicos del proveedor, ahora forma parte de la partición de inicio del proveedor. Para especificar los parámetros de la imagen de DTB, consulta Encabezado de inicio del proveedor.
En Android 10, los dispositivos pueden incluir la imagen de DTB en la partición de inicio. Para especificar los parámetros de imagen de DTB, consulta Cómo incluir la imagen de DTB en la imagen de inicio.
En Android 9 y versiones anteriores, la imagen de DTB puede existir en su propia partición o adjuntarse al kernel
image.gzpara crear el kernel + la imagen de DTB (que luego se pasa amkbootimgpara crearboot.img).
Formato de imagen de DTB
En Android 10 y versiones posteriores, la imagen de DTB debe usar uno de los siguientes formatos:
Búferes de DT concatenados uno tras otro. El bootloader usa el campo
totalsizeen cada encabezado de FDT para leer y analizar el blob correspondiente.Particiones de DTB/DTBO. El bootloader tiene una forma eficiente de seleccionar el BLOB de DT correcto a través del análisis del struct
dt_table_entry(contiene los camposid,revycustom) que puede contener información de identificación de hardware para la entrada. Para obtener más detalles, consulta Particiones DTB/DTBO.
Cómo incluir la imagen del DTB en la imagen de arranque
Los dispositivos que ejecutan Android 10 pueden incluir la imagen de DTB en la imagen de inicio. Esto elimina la necesidad de que Android admita secuencias de comandos que adjunten la imagen de DTB a image.gz en el kernel y habilita el uso de la prueba del Conjunto de pruebas del proveedor (VTS) para verificar (y estandarizar) la ubicación de DTB.
Además, en el caso de los dispositivos que no son de A/B, es más seguro tener la DTB como parte de la imagen de recuperación en lugar de en una partición independiente para evitar problemas causados por OTAs interrumpidas. Durante una actualización inalámbrica, si se produce un problema después de actualizar la partición de DTB (pero antes de completar la actualización completa), el dispositivo intenta iniciarse en el modo de recuperación para completar la actualización inalámbrica. Sin embargo, como la partición de DTB ya se actualizó, podría producirse una discrepancia con la imagen de recuperación (que aún no se actualizó). Tener la imagen DTB como parte del formato de imagen de arranque evita esos problemas, ya que hace 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 con la siguiente estructura de imagen de inicio.
| Sección de imagen de arranque | Cantidad de páginas |
|---|---|
| Encabezado de inicio (1 página) | 1 |
| Kernel (l páginas) | l = (kernel_size + page_size -
1) / page_size |
| Ramdisk (m de páginas) | m = (ramdisk_size + page_size -
1) / page_size |
| Bootloader de segunda etapa (n páginas) | n = (second_size + page_size - 1) / page_size |
| DTBO de recuperación (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 acceso a la imagen de DTB
En el caso de los dispositivos que ejecutan Android 10, puedes usar la herramienta mkbootimg.py y los siguientes argumentos para especificar la ruta de acceso a la imagen de DTB.
| Argumento | Descripción |
|---|---|
dtb |
Es la ruta de acceso a la imagen de DTB que se incluirá en las imágenes de inicio o 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 propaga como 0x11000000. |
Se debe usar la variable de configuración de la placa BOARD_PREBUILT_DTBIMAGE_DIR para especificar la ruta de acceso a la imagen de la DTB. Si hay más de un archivo con 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 que se usa en la creación de la imagen de arranque.
Para pasar el argumento dtb a mkbootimg.py con la imagen de DTB del 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
Puedes agregar el argumento dtb_offset a la variable de configuración de la placa BOARD_MKBOOTIMG_ARGS con los otros desplazamientos 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)
Compatibilidad con el bootloader
Para que VTS se ejecute correctamente en dispositivos que ejecutan Android 10, el bootloader debe admitir la imagen de inicio actualizada y agregar el parámetro de línea de comandos del kernel androidboot.dtb_idx para indicar el índice del árbol de dispositivos (DT) seleccionado. Solo puedes especificar un (1) índice. Por ejemplo, el parámetro androidboot.dtb_idx=N informa N como el índice basado en cero del árbol de dispositivos que selecciona el bootloader del conjunto de DTB presentes en la imagen de inicio.