Obrazy DTB

Implementacje Androida mogą zawierać obraz pliku blob drzewa urządzenia (DTB) do wykorzystania przez bootloader. Lokalizacja obrazu DTB (i opcje określania parametrów tego obrazu) różni się w zależności od wersji Androida.

  • W Androidzie 11 urządzenia korzystające z Generic Kernel Image (GKI) muszą obsługiwać partycję rozruchu dostawcy, która zawiera wszystkie informacje dostawcy przeniesione z partycji rozruchu. Ponieważ obraz DTB zawiera dane specyficzne dla dostawcy, jest teraz częścią partycji rozruchowej dostawcy. Aby określić parametry obrazu DTB, zapoznaj się z nagłówkiem specyfikacji dostawcy.

  • W Androidzie 10 na partycji rozruchowej mogą się znajdować obrazy DTB. Aby określić parametry obrazu DTB, zapoznaj się z artykułem Uwzględnianie obrazu DTB w obrazie rozruchowym.

  • W Androidzie 9 i starszych obraz DTB może znajdować się na osobnej partycji lub być dołączony do jądra image.gz, aby utworzyć obraz jądra image.gz + DTB (który jest następnie przekazywany do mkbootimg w celu utworzenia obrazu boot.img).

Format obrazu DTB

W Androidzie 10 i nowszych obraz DTB musi być w jednym z tych formatów:

  • Bloby DT złączone jeden po drugim. Bootloader używa pola totalsize w każdym nagłówku FDT do odczytu i analizy odpowiedniego bloba.

  • Partycje DTB/DTBO. Bootloader ma skuteczny sposób na wybranie prawidłowego pliku blob DT, sprawdzając strukturę dt_table_entry (zawierającą pola id, rev i custom), która może zawierać informacje identyfikujące sprzęt dla danego wpisu. Więcej informacji znajdziesz w artykule DTB/DTBO: partycje.

Dołącz obraz DTB do obrazu rozruchowego

Urządzenia z Androidem 10 mogą zawierać obraz DTB w obrazie rozruchowym. Dzięki temu Android nie musi obsługiwać skryptów, które dołączają obraz DTB do image.gz w jądrze. Umożliwia to użycie testu Vendor Test Suite (VTS) do weryfikacji (i ujednolicenia) umieszczania DTB.

Ponadto w przypadku urządzeń innych niż A/B bezpieczniej jest umieścić DTB w ramach obrazu odzyskiwania, a nie na osobnej partycji, aby uniknąć problemów spowodowanych przerwanymi aktualizacjami OTA. Jeśli podczas aktualizacji OTA wystąpi problem po zaktualizowaniu partycji DTB (ale przed zakończeniem pełnej aktualizacji), urządzenie spróbuje uruchomić tryb odzyskiwania, aby dokończyć aktualizację OTA. Ponieważ jednak partycja DTB została już zaktualizowana, może wystąpić niezgodność z obrazem odzyskiwania (który nie został jeszcze zaktualizowany). Użycie obrazu DTB jako części formatu obrazu rozruchowego zapobiega takim problemom, ponieważ obraz odzyskiwania jest samowystarczalny (czyli nie zależy od innej partycji).

Struktura obrazu rozruchowego

Urządzenia z Androidem 10 mogą zawierać obraz DTB, który korzysta z tej struktury obrazu rozruchowego.

Sekcja obrazu rozruchowego Liczba stron
Nagłówek uruchamiania (1 strona) 1
Kernel (l pages) l = (kernel_size + page_size - 1) / page_size
Ramdisk (m stron) m = (ramdisk_size + page_size - 1) / page_size
Program rozruchowy drugiego etapu (n stron) n = (second_size + page_size - 1) / page_size
Recovery DTBO (o pages) o = (recovery_dtbo_size + page_size - 1) / page_size
DTB (p stron) p = (dtb_size + page_size - 1) / page_size

Ścieżka obrazu DTB

W przypadku urządzeń z Androidem 10 możesz użyć narzędzia mkbootimg.py i podać te argumenty, aby określić ścieżkę do obrazu DTB.

Argument Opis
dtb Ścieżka do obrazu DTB, który ma być uwzględniony w obrazach rozruchowych lub odzyskiwania.
dtb_offset Gdy zostanie dodany do argumentu base, udostępnia fizyczny adres ładowania dla końcowego drzewa urządzeń. Jeśli na przykład argument base to 0x10000000, a argument dtb_offset to 0x01000000, argument dtb_addr_field w nagłówku obrazu rozruchowego jest wypełniany jako 0x11000000.

Aby określić ścieżkę do obrazu DTB, musisz użyć zmiennej konfiguracji tablicy BOARD_PREBUILT_DTBIMAGE_DIR. Jeśli w katalogu BOARD_PREBUILT_DTBIMAGE_DIR znajduje się więcej niż 1 plik z rozszerzeniem *.dtb, system kompilacji Androida łączy te pliki, aby utworzyć ostateczny obraz DTB, który jest używany podczas tworzenia obrazu rozruchowego.

Aby przekazać argument dtb do funkcji mkbootimg.py wraz z obrazem DTB z katalogu określonego przez zmienną BOARD_PREBUILT_DTBIMAGE_DIR, zmienna konfiguracji płyty BOARD_INCLUDE_DTB_IN_BOOTIMG musi być ustawiona na true. Przykład:

BOARD_INCLUDE_DTB_IN_BOOTIMG := true

Możesz dołączyć argument dtb_offset do zmiennej BOARD_MKBOOTIMG_ARGS boardconfig z innymi przesunięciami i wersją nagłówka. Przykład:

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)

Obsługa programu rozruchowego

Aby VTS działał prawidłowo na urządzeniach z Androidem 10, bootloader musi obsługiwać zaktualizowany obraz rozruchu i musi dodać parametr wiersza poleceń jądra androidboot.dtb_idx, aby wskazać indeks wybranego drzewa urządzenia (DT). Możesz określić tylko 1 indeks. Na przykład parametr androidboot.dtb_idx=N zwraca wartość N jako indeks od zera drzewa urządzenia wybranego przez bootloadera z zestawu DTB obecnych w obrazie rozruchowym.