aboutsummaryrefslogtreecommitdiff
path: root/doc/README.chromium
diff options
context:
space:
mode:
authorSimon Glass2020-09-05 14:50:53 -0600
committerBin Meng2020-09-25 11:27:11 +0800
commitd9778ff0d3e827ff6c0fba390e01dc7045b9dabe (patch)
treeb1b34121088b1735c9e6ae9741956067bdd9b0fc /doc/README.chromium
parentdc8e7a91f4ac65b6fcf6a5b5a914929b47e753a3 (diff)
cros: Add information about booting Chrome OS on x86
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>
Diffstat (limited to 'doc/README.chromium')
-rw-r--r--doc/README.chromium32
1 files changed, 32 insertions, 0 deletions
diff --git a/doc/README.chromium b/doc/README.chromium
index c56545cb7ff..75f2f24042c 100644
--- a/doc/README.chromium
+++ b/doc/README.chromium
@@ -27,6 +27,9 @@ available:
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
-------------------------------------
@@ -175,6 +178,35 @@ 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
-----