mirror of
https://github.com/AsahiLinux/u-boot
synced 2024-12-24 03:53:31 +00:00
d9778ff0d3
Recent versions of Chrome OS do not have a kernel in the root disk, to save space. With the improvements to the 'zboot' command it is fairly easy to load the kernel from the raw partition. Add instructions on how to do this. Signed-off-by: Simon Glass <sjg@chromium.org> Reviewed-by: Wolfgang Wallner <wolfgang.wallner@br-automation.com> Reviewed-by: Bin Meng <bmeng.cn@gmail.com>
218 lines
6.8 KiB
Text
218 lines
6.8 KiB
Text
Chromium OS Support in U-Boot
|
|
=============================
|
|
|
|
Introduction
|
|
------------
|
|
|
|
This describes how to use U-Boot with Chromium OS. Several options are
|
|
available:
|
|
|
|
- Running U-Boot from the 'altfw' feature, which is available on selected
|
|
Chromebooks from 2019 onwards (initially Grunt). Press '1' from the
|
|
developer-mode screen to get into U-Boot. See here for details:
|
|
https://sites.google.com/a/chromium.org/dev/chromium-os/poking-around-your-chrome-os-device?pli=1
|
|
|
|
- Running U-Boot from the disk partition. This involves signing U-Boot and
|
|
placing it on the disk, for booting as a 'kernel'. See
|
|
README.chromium-chainload for information on this. This is the only
|
|
option on non-U-Boot Chromebooks from 2013 to 2018 and is somewhat
|
|
more involved.
|
|
|
|
- Running U-Boot with Chromium OS verified boot. This allows U-Boot to be
|
|
used instead of either or both of depthcharge (a bootloader which forked
|
|
from U-Boot in 2013) and coreboot. See below for more information on
|
|
this.
|
|
|
|
- Running U-Boot from coreboot. This allows U-Boot to run on more devices
|
|
since many of them only support coreboot as the bootloader and have
|
|
no bare-metal support in U-Boot. For this, use the 'coreboot' target.
|
|
|
|
- Running U-Boot and booting into a Chrome OS image, but without verified
|
|
boot. This can be useful for testing.
|
|
|
|
|
|
U-Boot with Chromium OS verified boot
|
|
-------------------------------------
|
|
|
|
To obtain:
|
|
|
|
git clone https://github.com/sglass68/u-boot.git
|
|
cd u-boot
|
|
git checkout cros-master
|
|
|
|
cd ..
|
|
git clone https://chromium.googlesource.com/chromiumos/platform/vboot_reference
|
|
cd vboot_reference
|
|
git checkout 45964294
|
|
# futility: updater: Correct output version for Snow
|
|
|
|
To build for sandbox:
|
|
|
|
UB=/tmp/b/chromeos_sandbox # U-Boot build directory
|
|
cd u-boot
|
|
make O=$UB chromeos_sandbox_defconfig
|
|
make O=$UB -j20 -s VBOOT_SOURCE=/path/to/vboot_reference \
|
|
MAKEFLAGS_VBOOT=DEBUG=1 QUIET=1
|
|
|
|
Replace sandbox with another supported target.
|
|
|
|
This produces $UB/image.bin which contains the firmware binaries in a SPI
|
|
flash image.
|
|
|
|
To run on sandbox:
|
|
|
|
$UB/tpl/u-boot-tpl -d $UB/u-boot.dtb.out \
|
|
-L6 -c "host bind 0 $CROS/src/build/images/cheza/latest/chromiumos_image.bin; vboot go auto" \
|
|
-l -w -s state.dtb -r
|
|
|
|
To run on other boards:
|
|
Install image.bin in the SPI flash of your device
|
|
Boot your system
|
|
|
|
|
|
Sandbox
|
|
-------
|
|
|
|
Most Chromium OS development with U-Boot is undertaken using sandbox. There is
|
|
a sandbox target available (chromeos_sandbox) which allows running U-Boot on
|
|
a Linux machine completion with emulations of the display, TPM, disk, etc.
|
|
|
|
Running sandbox starts TPL, which contains the first phase of vboot, providing
|
|
a device tree and binding a Chromium OS disk image for use to find kernels
|
|
(any Chromium OS image will do). It also saves driver state between U-Boot
|
|
phases into state.dtb and will automatically ensure that memory is shared
|
|
between all phases. TPL will jump to SPL and then on to U-Boot proper.
|
|
|
|
It is possible to run with debugging on, e.g.
|
|
|
|
gdb --args $UB/tpl/u-boot-tpl -d ....
|
|
|
|
Breakpoints can be set in any U-Boot phase. Overall this is a good debugging
|
|
environment for new verified-boot features.
|
|
|
|
|
|
Samus
|
|
-----
|
|
|
|
Basic support is available for samus, using the chromeos_samus target. If you
|
|
have an em100, use:
|
|
|
|
sudo em100 -s -c W25Q128FW -d $UB/image.bin -t -r
|
|
|
|
to write the image and then boot samus (Power-Refresh).
|
|
|
|
|
|
Boot flow
|
|
---------
|
|
|
|
Verified boot starts in TPL, which selects the A or B SPL, which in turn selects
|
|
the A or B U-Boot. Then this jumps to the selected kernel. If anything goes
|
|
wrong, the device reboots and the recovery SPL and U-Boot are used instead.
|
|
|
|
More details are available here:
|
|
|
|
https://www.chromium.org/chromium-os/chromiumos-design-docs/firmware-boot-and-recovery
|
|
|
|
|
|
New uclasses
|
|
------------
|
|
|
|
Several uclasses are provided in cros/:
|
|
|
|
UCLASS_CROS_AUX_FW Chrome OS auxiliary firmware
|
|
UCLASS_CROS_FWSTORE Chrome OS firmware storage
|
|
UCLASS_CROS_NVDATA Chrome OS non-volatile data device
|
|
UCLASS_CROS_VBOOT_EC Chrome OS vboot EC operations
|
|
UCLASS_CROS_VBOOT_FLAG Chrome OS verified boot flag
|
|
|
|
The existing UCLASS_CROS_EC is also used.
|
|
|
|
|
|
Commands
|
|
--------
|
|
|
|
A new 'vboot' command is provided to run particular vboot stages. The most
|
|
useful command is 'vboot go auto', which continues where the last stage left
|
|
off.
|
|
|
|
Note that TPL and SPL do not supports commands as yet, so the vboot code is
|
|
called directly from the SPL boot devices (BOOT_DEVICE_CROS_VBOOT). See
|
|
cros_load_image_tpl() and cros_load_image_spl() which both call
|
|
vboot_run_auto().
|
|
|
|
|
|
Config options
|
|
--------------
|
|
|
|
The main option is CONFIG_CHROMEOS, which enables a wide array of other options
|
|
so that the required features are present.
|
|
|
|
|
|
Device-tree config
|
|
------------------
|
|
|
|
Various options are available which control the operation of verified boot.
|
|
See cros/dts/bindings/config.txt for details. Most config is handled at run-
|
|
time, although build-time config (with Kconfig) could also be added fairly
|
|
easily.
|
|
|
|
|
|
Porting to other hardware
|
|
-------------------------
|
|
|
|
A basic port to samus (Chromebook Pixel 2015) is in a basic working state,
|
|
using the chromeos_samus target. Patches will likely be forthcoming in early
|
|
2019. Ports to an ARM board and coreboot (for x86 Chromebooks) are in the
|
|
dreaming state.
|
|
|
|
|
|
Tests
|
|
-----
|
|
|
|
Chromium OS firmware has a very limited set of tests. The tests that originally
|
|
existed in U-Boot were not brought over to coreboot or depthcharge.
|
|
|
|
The U-Boot tests ('make check') do operate, but at present there are no
|
|
Chromium OS tests available. These will hopefully come together over time. Of
|
|
course the above sandbox feature provides a sort of functional test and can
|
|
detect problems that affect the flow or particular vboot features.
|
|
|
|
|
|
U-Boot without Chromium OS verified boot
|
|
----------------------------------------
|
|
|
|
The following script can be used to boot a Chrome OS image on coral:
|
|
|
|
# Read the image header and obtain the address of the kernel
|
|
# The offset 4f0 is defined by verified boot and may change for other
|
|
# Chromebooks
|
|
read mmc 2:2 100000 0 80; setexpr loader *001004f0;
|
|
|
|
# Get the kernel size and calculate the number of blocks (0x200 bytes each)
|
|
setexpr size *00100518; setexpr blocks $size / 200;
|
|
|
|
# Read the full kernel and calculate the address of the setup block
|
|
read mmc 2:2 100000 80 $blocks; setexpr setup $loader - 1000;
|
|
|
|
# Locate the command line
|
|
setexpr cmdline $loader - 2000;
|
|
|
|
# Start the zboot process with the loaded kernel, setup block and cmdline
|
|
zboot start 100000 0 0 0 $setup $cmdline;
|
|
|
|
# Load the kernel, fix up the 'setup' block, dump information
|
|
zboot load; zboot setup; zboot dump
|
|
|
|
# Boot into Chrome OS
|
|
zboot go
|
|
|
|
|
|
TO DO
|
|
-----
|
|
|
|
Get the full ACPI tables working with Coral
|
|
|
|
|
|
Simon Glass
|
|
sjg@chromium.org
|
|
7 October 2018
|