Hình ảnh DTB

Các hoạt động triển khai Android có thể bao gồm hình ảnh blob cây thiết bị (DTB) để trình tải khởi động sử dụng. Vị trí của hình ảnh DTB (và các tuỳ chọn để chỉ định Thông số hình ảnh DTB) khác nhau giữa các bản phát hành Android.

  • Trong Android 11, các thiết bị sử dụng Hạt nhân chung Hình ảnh (GKI) phải hỗ trợ khởi động từ nhà cung cấp phân vùng, bao gồm tất cả thông tin cụ thể về nhà cung cấp được chuyển từ phân vùng khởi động. Vì hình ảnh DTB chứa dữ liệu dành riêng cho nhà cung cấp, nên hình ảnh này hiện là một phần của phân vùng khởi động của nhà cung cấp. Để chỉ định thông số hình ảnh DTB, hãy xem Khởi động nhà cung cấp tiêu đề.

  • Trên Android 10, các thiết bị có thể có hình ảnh DTB trong phân vùng khởi động. Để chỉ định thông số hình ảnh DTB, hãy xem phần Bao gồm DTB trong hình ảnh khởi động.

  • Trong Android 9 trở xuống, hình ảnh DTB có thể tồn tại trong phân vùng riêng hoặc được thêm vào image.gz hạt nhân để tạo hạt nhân + hình ảnh DTB (sau đó được truyền đến mkbootimg để tạo boot.img).

Định dạng hình ảnh DTB

Trong Android 10 trở lên, hình ảnh DTB phải sử dụng một trong các định dạng sau:

  • Các blob DT được nối với nhau. Trình tải khởi động sử dụng trường totalsize trong mỗi tiêu đề FDT để đọc và phân tích cú pháp blob tương ứng.

  • Phân vùng DTB/DTBO. Trình tải khởi động có một cách hiệu quả để chọn đúng blob DT bằng cách kiểm tra cấu trúc dt_table_entry (chứa các trường id, revcustom) có thể chứa thông tin nhận dạng phần cứng cho mục nhập. Để biết chi tiết, hãy xem DTB/DTBO Vách ngăn.

Đưa hình ảnh DTB vào hình ảnh khởi động

Các thiết bị chạy Android 10 có thể đưa hình ảnh DTB vào hình ảnh khởi động. Điều này giúp Android không cần phải hỗ trợ các tập lệnh bổ sung hình ảnh DTB lên image.gz trong nhân hệ điều hành và cho phép sử dụng tính năng Kiểm thử nhà cung cấp Thử nghiệm bộ (VTS) để xác minh (và chuẩn hoá) DTB vị trí.

Ngoài ra, đối với các thiết bị không phải A/B, bạn nên đặt DTB vào hình ảnh khôi phục thay vì trong một phân vùng riêng biệt để ngăn chặn các vấn đề do OTA bị gián đoạn. Trong quá trình OTA, nếu sự cố xảy ra sau khi phân vùng DTB đã cập nhật (nhưng trước khi hoàn tất quá trình cập nhật đầy đủ), thiết bị sẽ cố gắng khởi động vào chế độ khôi phục để hoàn tất OTA; Tuy nhiên, vì phân vùng DTB có đã được cập nhật, trường hợp không khớp có thể xảy ra với hình ảnh khôi phục (hình ảnh này đã chưa được cập nhật). Việc đưa hình ảnh DTB vào định dạng hình ảnh khởi động sẽ ngăn chặn các vấn đề như vậy bằng cách tự cung cấp hình ảnh khôi phục (tức là hình ảnh khôi phục không phụ thuộc vào một phân vùng khác).

Khởi động cấu trúc hình ảnh

Các thiết bị chạy Android 10 có thể có hình ảnh DTB bằng cấu trúc hình ảnh khởi động sau.

Phần hình ảnh khởi động Số trang
Tiêu đề khởi động (1 trang) 1
Hạt nhân (trang l) l = (kernel_size + page_size - 1) / page_size
Ramdisk (m trang) m = (ramdisk_size + page_size – 1) / page_size
Trình tải khởi động giai đoạn hai (n trang) n = (second_size + page_size - 1) / page_size
DTBO khôi phục (o trang) o = (recovery_dtbo_size + page_size - 1) / page_size
DTB (p trang) p = (dtb_size + page_size - 1) / page_size

Đường dẫn hình ảnh DTB

Đối với các thiết bị chạy Android 10, bạn có thể sử dụng Công cụ mkbootimg.py và các đối số sau để chỉ định đường dẫn đến DTB hình ảnh.

Đối số Mô tả
dtb Đường dẫn đến hình ảnh DTB sẽ được đưa vào hình ảnh khởi động/khôi phục.
dtb_offset Khi được thêm vào đối số base, cung cấp địa chỉ tải thực tế cho cây thiết bị cuối cùng. Ví dụ: nếu đối số base0x10000000 và đối số dtb_offset0x01000000, thì dtb_addr_field trong tiêu đề hình ảnh khởi động sẽ được điền là 0x11000000.

Bạn phải sử dụng biến cấu hình bảng BOARD_PREBUILT_DTBIMAGE_DIR để chỉ định đường dẫn đến hình ảnh DTB. Nếu nhiều tệp có đuôi *.dtb là có trong thư mục BOARD_PREBUILT_DTBIMAGE_DIR, hệ thống xây dựng Android nối các tệp để tạo hình ảnh DTB cuối cùng được sử dụng trong hình ảnh khởi động sáng tạo.

Để truyền đối số dtb đến mkbootimg.py bằng hình ảnh DTB từ thư mục do BOARD_PREBUILT_DTBIMAGE_DIR chỉ định, bạn phải đặt biến cấu hình bảng BOARD_INCLUDE_DTB_IN_BOOTIMG thành true. Ví dụ:

BOARD_INCLUDE_DTB_IN_BOOTIMG := true

Bạn có thể thêm đối số dtb_offset vào bảng BOARD_MKBOOTIMG_ARGS config với các giá trị độ lệch và phiên bản tiêu đề khác. Ví dụ:

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)

Hỗ trợ trình tải khởi động

Để VTS chạy thành công trên các thiết bị chạy Android 10, trình tải khởi động phải hỗ trợ hình ảnh khởi động đã cập nhật và phải thêm tham số dòng lệnh nhân androidboot.dtb_idx để cho biết chỉ mục của cây thiết bị (DT) đã chọn. Bạn chỉ có thể chỉ định một (1) chỉ mục. Ví dụ: tham số androidboot.dtb_idx=N báo cáo N là chỉ mục từ 0 của cây thiết bị do trình tải khởi động chọn trong tập hợp DTB có trong hình ảnh khởi động.