aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorAdam Ford <aford173@gmail.com>2023-05-28 14:18:01 -0500
committerStefano Babic <sbabic@denx.de>2023-07-11 14:40:05 +0200
commite6ac438d166a4ca71fdcccb9fdc9a1c8abe79e44 (patch)
tree2b3ee8bfcefc51925003308b1a9a2a3779bdcd94 /doc
parentb2d8d6e6251aa9dd61c735f7e88927c6fee8d8f6 (diff)
downloadu-boot-e6ac438d166a4ca71fdcccb9fdc9a1c8abe79e44.zip
u-boot-e6ac438d166a4ca71fdcccb9fdc9a1c8abe79e44.tar.gz
u-boot-e6ac438d166a4ca71fdcccb9fdc9a1c8abe79e44.tar.bz2
imx8m: imx8mm-beacon: Migrate README to rst
Since U-Boot builds HTML documentation, migrate the contents of the README file to an rst file which can generate the proper outputs. Signed-off-by: Adam Ford <aford173@gmail.com>
Diffstat (limited to 'doc')
-rw-r--r--doc/board/beacon/beacon-imx8mm.rst55
-rw-r--r--doc/board/beacon/index.rst1
2 files changed, 56 insertions, 0 deletions
diff --git a/doc/board/beacon/beacon-imx8mm.rst b/doc/board/beacon/beacon-imx8mm.rst
new file mode 100644
index 0000000..8bf983b
--- /dev/null
+++ b/doc/board/beacon/beacon-imx8mm.rst
@@ -0,0 +1,55 @@
+.. SPDX-License-Identifier: GPL-2.0+
+
+U-Boot for the Beacon EmbeddedWorks i.MX8M Mini Devkit
+======================================================
+
+Quick Start
+-----------
+
+- Build the ARM Trusted firmware binary
+- Get DDR firmware
+- Build U-Boot
+- Burn U-Boot to microSD Card
+- Boot
+
+Get and Build the ARM Trusted firmware
+--------------------------------------
+
+.. code-block:: bash
+
+ $ git clone https://github.com/nxp-imx/imx-atf.git -b v2.6
+ $ make PLAT=imx8mm bl31 CROSS_COMPILE=aarch64-linux-gnu-
+ $ cp build/imx8mm/release/bl31.bin ../
+
+Get the DDR firmware
+--------------------
+
+.. code-block:: bash
+
+ $ wget https://www.nxp.com/lgfiles/NMG/MAD/YOCTO/firmware-imx-8.15.bin
+ $ chmod +x firmware-imx-8.15.bin
+ $ ./firmware-imx-8.15
+ $ cp firmware-imx-8.15/firmware/ddr/synopsys/lpddr4*.bin .
+
+Build U-Boot
+------------
+
+.. code-block:: bash
+
+ $ make imx8mm_beacon_defconfig
+ $ make CROSS_COMPILE=aarch64-linux-gnu-
+
+Burn U-Boot to microSD Card
+---------------------------
+
+.. code-block:: bash
+
+ $ sudo dd if=flash.bin of=/dev/sd[x] bs=1024 seek=33
+
+Boot
+----
+
+Set baseboard DIP switches for micoSD Card:
+- S11 (1:8) 01101000
+- S10 (1:8) 11001000
+- S17 (1:8) 0110xxxx
diff --git a/doc/board/beacon/index.rst b/doc/board/beacon/index.rst
index 1fe1046..8eba5e8 100644
--- a/doc/board/beacon/index.rst
+++ b/doc/board/beacon/index.rst
@@ -7,3 +7,4 @@ Beacon
:maxdepth: 2
beacon-imx8mp
+ beacon-imx8mm