summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorJohannes Zink <j.zink@pengutronix.de>2023-03-24 19:29:52 +0100
committerRobert Schwebel <r.schwebel@pengutronix.de>2023-03-27 18:07:53 +0200
commit90e36b542d553850a51e9b399d18549a3f4751e6 (patch)
tree6eeaebcd4bf44d8653bb8a99ec4e3366ccdd14b0 /doc
parenta194368d1bbc482f9d0a55eecf4bd466f4878b41 (diff)
downloadDistroKit-90e36b542d553850a51e9b399d18549a3f4751e6.tar.gz
DistroKit-90e36b542d553850a51e9b399d18549a3f4751e6.tar.xz
doc: v8a: ROCK 3A: add documentation on writing barebox-only images to SD-Card and NOR Flash
It may be useful to sometimes only write a barebox image to SD-Card, e.g. for chainloading, TFTP-Boot or if Android Fastboot is used for flashing the actual full image to a storage medium. Add documentation on which image to use. Also add a short section about how to write barebox to the fallback NOR SPI Flash on the ROCK 3A board. Signed-off-by: Johannes Zink <j.zink@pengutronix.de> Link: https://lore.pengutronix.de/20230324182952.501117-1-j.zink@pengutronix.de Signed-off-by: Robert Schwebel <r.schwebel@pengutronix.de>
Diffstat (limited to 'doc')
-rw-r--r--doc/hardware_v8a_rock3a.rst10
1 files changed, 9 insertions, 1 deletions
diff --git a/doc/hardware_v8a_rock3a.rst b/doc/hardware_v8a_rock3a.rst
index 75acd4d..3aa5a62 100644
--- a/doc/hardware_v8a_rock3a.rst
+++ b/doc/hardware_v8a_rock3a.rst
@@ -5,7 +5,11 @@ Boot Media
----------
Copy the image ``platform-v8a/images/rock3a.img`` onto a microSD card. Put the
-microSD card into the Rock 3A and boot it.
+microSD card into the Rock 3A and boot it, the system will autoboot to linux.
+
+If you just want to boot to barebox instead of a full linux image from microSD card
+(e.g. for chainloading or tftpboot),
+copy the image ``platform-v8a/images/barebox-rock3a.norimg`` onto a microSD card instead.
Alternatively, you may put the Rock 3A into MASKROM mode following the `Rock 3
Hardware User Manual <https://wiki.radxa.com/Rock3/hardware/3a>`_ and boot
@@ -19,6 +23,10 @@ Once Barebox is booted, copy the image ``platform-v8a/images/rock3a.img`` via
tftp or NFS to the eMMC to persist it. Disable MASKROM mode and reboot the
board to start from eMMC.
+Once booted to linux, you can write ``platform-v8a/images/barebox-rock3a.norimg`` using mtd-utils
+to the NOR flash, which can then be used as fallback boot source whenever booting from microSD
+card or eMMC fails.
+
Serial Console
--------------