[PATCH 21/22] doc: K3: Add documentation

Sascha Hauer s.hauer at pengutronix.de
Thu Aug 3 03:50:02 PDT 2023

Add some documentation for bringing up K3 SoCs, basically the BeaglePlay
for now.

Signed-off-by: Sascha Hauer <s.hauer at pengutronix.de>
 Documentation/boards/k3.rst | 29 +++++++++++++++++++++++++++++
 1 file changed, 29 insertions(+)
 create mode 100644 Documentation/boards/k3.rst

diff --git a/Documentation/boards/k3.rst b/Documentation/boards/k3.rst
new file mode 100644
index 0000000000..f675c4510c
--- /dev/null
+++ b/Documentation/boards/k3.rst
@@ -0,0 +1,29 @@
+Texas Instruments K3
+K3 is for Keystone 3 and denotes a family of SoCs from Texas Instruments. From these
+SoCs the AM62x is currently supported under barebox. The boot flow needs several images,
+only the last stage is supported by barebox. To start up the help of U-Boot is still
+The board currently supported by barebox is the BeaglePlay board, see
+https://www.beagleboard.org/boards/beagleplay. The following examples assume
+this board is used.
+Building barebox
+.. code-block:: sh
+  make ARCH=arm CROSS_COMPILE=<ARM toolchain prefix> multi_v8_defconfig
+Running barebox
+barebox can be started from running U-Boot with:
+.. code-block:: sh
+  dhcp 0x82000000 <serverip>:barebox-beagleplay.img; bootm 0x82000000
+To start barebox from SD/eMMC replace the ``u-boot.img`` on a bootable SD/eMMC card
+with the content of ``images/barebox-beagleplay-fit.img``

More information about the barebox mailing list