u-boot/doc/usage
Tom Rini 8cfac237b9 Merge branch '2022-04-25-initial-implementation-of-stdboot'
To quote the author:
The bootflow feature provide a built-in way for U-Boot to automatically
boot an Operating System without custom scripting and other customisation.
This is called 'standard boot' since it provides a standard way for
U-Boot to boot a distro, without scripting.

It introduces the following concepts:

   - bootdev - a device which can hold a distro
   - bootmeth - a method to scan a bootdev to find bootflows (owned by
                U-Boot)
   - bootflow - a description of how to boot (owned by the distro)

This series provides an implementation of these, enabled to scan for
bootflows from MMC, USB and Ethernet. It supports the existing distro
boot as well as the EFI loader flow (bootefi/bootmgr). It works
similiarly to the existing script-based approach, but is native to
U-Boot.

With this we can boot on a Raspberry Pi 3 with just one command:

   bootflow scan -lb

which means to scan, listing (-l) each bootflow and trying to boot each
one (-b). The final patch shows this.

With a standard way to identify boot devices, booting become easier. It
also should be possible to support U-Boot scripts, for backwards
compatibility only.

...

The design is described in these two documents:

https://drive.google.com/file/d/1ggW0KJpUOR__vBkj3l61L2dav4ZkNC12/view?usp=sharing

https://drive.google.com/file/d/1kTrflO9vvGlKp-ZH_jlgb9TY3WYG6FF9/view?usp=sharing
2022-04-25 16:02:27 -04:00
..
cmd Merge branch '2022-04-25-initial-implementation-of-stdboot' 2022-04-25 16:02:27 -04:00
os doc: usage: Convert README.plan9 to reST 2022-03-31 19:06:16 +02:00
cmdline.rst doc: man-page for the env command 2022-04-15 11:23:02 +02:00
dfu.rst doc: usage: DFU: Fix dfu_alt_info document 2022-02-11 11:29:23 -05:00
environment.rst doc: man-page for the env command 2022-04-15 11:23:02 +02:00
fdt_overlays.rst doc: usage: Fix command in fdt overlay apply sequence 2021-12-09 11:43:25 -08:00
fit.rst binman: doc: Add documentation to htmldocs 2021-03-26 17:03:10 +13:00
index.rst bootstd: doc: Add documentation 2022-04-25 10:00:04 -04:00
netconsole.rst doc: move README.NetConsole to HTML documentation 2020-12-15 09:37:00 +01:00
partitions.rst doc: Document partition specifications 2021-02-26 15:30:55 +01:00
semihosting.rst ls1046ardb: Add support for JTAG boot 2022-04-01 16:56:44 -04:00