u-boot/doc/develop
Mattijs Korpershoek 125d9f3306 bootstd: Add a bootmeth for Android
Android boot flow is a bit different than a regular Linux distro.
Android relies on multiple partitions in order to boot.

A typical boot flow would be:
1. Parse the Bootloader Control Block (BCB, misc partition)
2. If BCB requested bootonce-bootloader, start fastboot and wait.
3. If BCB requested recovery or normal android, run the following:
3.a. Get slot (A/B) from BCB
3.b. Run AVB (Android Verified Boot) on boot partitions
3.c. Load boot and vendor_boot partitions
3.d. Load device-tree, ramdisk and boot

The AOSP documentation has more details at [1], [2], [3]

This has been implemented via complex boot scripts such as [4].
However, these boot script are neither very maintainable nor generic.
Moreover, DISTRO_DEFAULTS is being deprecated [5].

Add a generic Android bootflow implementation for bootstd.
For this initial version, only boot image v4 is supported.

[1] https://source.android.com/docs/core/architecture/bootloader
[2] https://source.android.com/docs/core/architecture/partitions
[3] https://source.android.com/docs/core/architecture/partitions/generic-boot
[4] https://source.denx.de/u-boot/u-boot/-/blob/master/include/configs/meson64_android.h
[5] https://lore.kernel.org/r/all/20230914165615.1058529-17-sjg@chromium.org/

Reviewed-by: Simon Glass <sjg@chromium.org>
Reviewed-by: Julien Masson <jmasson@baylibre.com>
Tested-by: Guillaume La Roque <glaroque@baylibre.com>
Signed-off-by: Mattijs Korpershoek <mkorpershoek@baylibre.com>
2024-07-18 13:51:30 -06:00
..
devicetree doc: process.rst: Document device tree resync rules 2024-06-06 09:28:20 +02:00
driver-model doc: dm: Fix typo 2024-01-29 11:28:44 +01:00
package doc: typo 'it it' in doc/develop/package/index.rst 2022-10-06 22:54:57 +02:00
pics trace: Update documentation 2023-02-11 12:22:35 -05:00
statistics Prepare v2024.07 2024-07-01 12:07:18 -06:00
uefi Prepare v2024.07-rc5 2024-06-24 13:34:52 -06:00
bloblist.rst bloblist: Update documentation and header comment 2023-12-31 07:21:02 -07:00
board_best_practices.rst doc: Begin adding a best practices document for board ports 2023-08-09 08:41:52 +02:00
bootstd.rst bootstd: Add a bootmeth for Android 2024-07-18 13:51:30 -06:00
cedit.rst expo: Update documentation to include textline 2023-10-11 15:43:56 -04:00
checkpatch.rst scripts/checkpatch.pl: Resync with v5.16 2022-02-03 12:16:00 -05:00
ci_testing.rst doc: describe skipping triggering a pipeline in Gitlab 2023-04-01 10:11:50 +02:00
coccinelle.rst doc: Coccinelle: move to HTML doc 2020-07-17 08:45:29 -04:00
codingstyle.rst Restore patch series "arm: dts: am62-beagleplay: Fix Beagleplay Ethernet" 2024-05-20 13:35:03 -06:00
commands.rst doc: develop: commands: Fix function prototype 2024-03-13 08:09:23 +01:00
config_binding.rst doc: Add mention of the /config binding 2021-09-25 12:30:54 +02:00
crash_dumps.rst doc: crash_dumps.rst missing documentation link 2022-08-13 11:09:49 +02:00
cyclic.rst cyclic: make clients embed a struct cyclic_info in their own data structure 2024-06-16 12:13:44 +02:00
designprinciples.rst designprinciples.rst: Perform minor cleanups 2022-07-14 14:13:50 -04:00
directories.rst doc: move directory hierarchy to HTML 2023-01-27 18:32:00 +01:00
distro.rst boot: pxe_utils: skip fdt setup in case legacy kernel is booted 2024-03-01 18:34:08 -05:00
docstyle.rst doc: harmonize Linux kernel documentation links 2023-07-09 04:00:06 +02:00
environment.rst global: Finish CONFIG -> CFG migration 2023-01-20 12:27:24 -05:00
event.rst event: Update documentation for simple spy 2023-08-31 13:16:54 -04:00
expo.rst expo: Update documentation to include textline 2023-10-11 15:43:56 -04:00
falcon.rst doc: falcon: riscv: Falcon Mode boot on RISC-V 2024-01-31 16:51:03 +08:00
gdb.rst doc: develop: Add a general section on gdb usage 2024-06-30 13:58:31 +02:00
global_data.rst common/board_f: remove XTRN_DECLARE_GLOBAL_DATA_PTR dead code 2022-10-06 21:05:17 -04:00
ide_integration.rst doc: add ide_integration.rst to doc/develop 2023-10-11 13:24:55 -04:00
index.rst doc: develop: Add a general section on gdb usage 2024-06-30 13:58:31 +02:00
logging.rst log: force DEBUG when LOG_DEBUG is activated 2022-07-26 02:30:56 -06:00
makefiles.rst doc: Bring in Makefile documentation 2021-07-24 10:49:51 +02:00
menus.rst doc: move README.menu to HTML documentation 2021-01-23 09:53:46 -05:00
patman.rst patman: Add documentation to doc/ 2022-08-13 11:09:49 +02:00
printf.rst doc: printf() codes: Fix format specifier for unsigned int 2023-08-19 04:12:52 +02:00
process.rst doc: process.rst: Document device tree resync rules 2024-06-06 09:28:20 +02:00
py_testing.rst doc: describe usage of virt-make-fs for testing 2022-10-10 16:34:25 +02:00
python_cq.rst patman: Correct pylint errors 2022-03-02 10:28:12 -05:00
qconfig.rst qconfig: Update the documentation 2023-10-04 09:25:22 -06:00
release_cycle.rst Prepare v2024.07 2024-07-01 12:07:18 -06:00
security.rst docs: Add a basic security document 2022-11-06 10:50:04 +01:00
sending_patches.rst doc: fix three-dash references in reStructuredText 2024-01-13 18:17:46 +01:00
smbios.rst doc: describe generation of SMBIOS table 2022-02-26 07:37:00 +01:00
spl.rst doc: spl: Add info regarding memory reservation 2024-01-29 14:49:17 -05:00
system_configuration.rst doc: fix typos 2022-12-17 13:37:33 +00:00
testing.rst doc: develop: testing: Fix reference to test writing section 2024-06-22 17:03:01 +02:00
tests_sandbox.rst Fix references to trace doc 2024-04-13 11:14:29 +02:00
tests_writing.rst Restore patch series "arm: dts: am62-beagleplay: Fix Beagleplay Ethernet" 2024-05-20 13:35:03 -06:00
trace.rst docs: fix wrong usage of proftool 2023-08-19 04:12:52 +02:00
vbe.rst vbe: Add a test for VBE device tree fixups 2022-10-17 21:17:13 -06:00
version.rst acpi: Use U-Boot version for OEM_REVISION 2021-10-06 09:15:14 -04:00