From b3bfd87c7ee3e41179f71f2387dc379bfd855687 Mon Sep 17 00:00:00 2001 From: Sascha Hauer Date: Wed, 6 Oct 2021 11:34:19 +0200 Subject: scripts: Add rk-usb-loader tool This adds a tool suitable for bootstrapping barebox on Rockchip RK3568 SoCs. It has been tested on this SoC only. It might or might not work with minor adjustments on other SoCs. Signed-off-by: Sascha Hauer Tested-by: Michael Riesch --- Documentation/boards/rockchip.rst | 15 +++++++++++++++ 1 file changed, 15 insertions(+) (limited to 'Documentation/boards/rockchip.rst') diff --git a/Documentation/boards/rockchip.rst b/Documentation/boards/rockchip.rst index 55a3956dd4..d52d979cbf 100644 --- a/Documentation/boards/rockchip.rst +++ b/Documentation/boards/rockchip.rst @@ -84,3 +84,18 @@ A bootable SD card can be created with: The barebox image is written to the raw device, so make sure the partitioning doesn't conflict with the are barebox is written to. Starting the first partition at offset 8MiB is a safe bet. + +USB bootstrapping +^^^^^^^^^^^^^^^^^ + +The RK3568 can be bootstrapped via USB for which the rk-usb-loader tool in the barebox +repository can be used. The tool takes the same images as written on SD cards: + +.. code-block:: sh + + ./scripts/rk-usb-loader images/barebox-rk3568-evb.img + +Note that the boot order of the RK3568 is not configurable. The SoC will only enter USB +MaskROM mode when no other bootsource contains a valid bootloader. This means to use USB +you have to make all other bootsources invalid by removing SD cards and shortcircuiting +eMMCs. The RK3568 EVB has a pushbutton to disable the eMMC. -- cgit v1.2.3