u-boot.git/doc/develop/bootstd.rst, branch master

doc: Move bootstd into its own directory

2024-07-19T11:53:05+00:00

Before adding more files, move the bootstd docs into a new directory,
with an index.

Signed-off-by: Simon Glass 
Reviewed-by: Quentin Schulz 
Reviewed-by: Mattijs Korpershoek

bootstd: Add a bootmeth for Android

2024-07-18T19:51:30+00:00

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 
Reviewed-by: Julien Masson 
Tested-by: Guillaume La Roque 
Signed-off-by: Mattijs Korpershoek

doc: bootstd: fix typos

2024-06-20T17:41:43+00:00

This fixes a few syntactic issues as well as typos and grammar.

Signed-off-by: Quentin Schulz 
Reviewed-by: Simon Glass

bootstd: support scanning a single partition

2024-03-04T15:25:47+00:00

The "bootflow" command currently doesn't support scanning a single
partition. This is inconvenient in setups with multiple bootable
partitions within a single disk, but only one is desired.

Support scanning a single disk partition. Specifically, support the
syntax:
	bootflow scan mmc1:4
which scans only mmc device 1, partition 4.

Signed-off-by: Nam Cao

doc: typo fdtaddr_addr_r

2023-11-20T18:06:22+00:00

%s/fdtaddr_addr_r/fdt_addr_r/

Signed-off-by: Heinrich Schuchardt 
Reviewed-by: Simon Glass

bootstd: Drop some TODOs

2023-10-11T17:22:32+00:00

The existing TODOs are done, so remove them. Add another that came up
today.

Signed-off-by: Simon Glass

Mark DISTRO_DEFAULTS as deprecated

2023-09-19T15:36:26+00:00

Standard boot has been in place for a while now. Quite a few problems
have been found and fixed. It seems like a good time to mark the
script-based approach as deprecated and encourage people to use standard
boot.

Update the DISTRO_DEFAULTS Kconfig to encourage people to move to
standard boot, which is able to boot Linux distributions automatically.

Add a short migration guide to make this easier.

Signed-off-by: Simon Glass 
Reviewed-by: Tom Rini

Merge tag 'v2023.10-rc4' into next

2023-09-04T14:51:58+00:00

Prepare v2023.10-rc4

bootstd: Adjust the default bootmeth order

2023-08-28T19:59:22+00:00

The existing distro scripts check extlinux and scripts before EFI. Adjust
the default ordering to do the same, to avoid breaking existing flows.

Add some documentation, mentioning that this order will likely change in
future.

Signed-off-by: Simon Glass 
Reported-by: Da Xue

bootstd: Support bootmeths which can scan any partition

2023-08-25T21:55:19+00:00

Some bootmeths support scanning a partition without a filesystem on it.
Add a flag to support this.

This will allow the ChromiumOS bootmeth to find kernel partition, which
are stored in a special format, without a filesystem.

Signed-off-by: Simon Glass