aboutsummaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorGilles Talis <gilles.talis@gmail.com>2024-10-27 10:52:41 -0400
committerFabio Estevam <festevam@gmail.com>2024-10-29 16:25:25 -0300
commit1beb665c50c6382632649069edc4bb7c9e3a2f80 (patch)
tree2b16e069659f25edec012f5b07e8ac244bf3603c /doc
parent196315d4afa7d8b97ca64ec1cfd371b7e14dc4eb (diff)
downloadu-boot-1beb665c50c6382632649069edc4bb7c9e3a2f80.tar.gz
board: emcraft: Add support for Emcraft Systems NavQ+
The Emcraft Systems NavQ+ kit is a mobile robotics platform based on NXP i.MX8 MPlus SoC. The following interfaces and devices are enabled: - eMMC - Gigabit Ethernet (through eQOS interface) - SD-Card - UART console The device tree file is taken from upstream Linux Kernel through OF_UPSTREAM Signed-off-by: Gilles Talis <gilles.talis@gmail.com> Reviewed-by: Fabio Estevam <festevam@gmail.com>
Diffstat (limited to 'doc')
-rw-r--r--doc/board/emcraft/imx8mp-navqp.rst65
-rw-r--r--doc/board/emcraft/index.rst9
-rw-r--r--doc/board/index.rst1
3 files changed, 75 insertions, 0 deletions
diff --git a/doc/board/emcraft/imx8mp-navqp.rst b/doc/board/emcraft/imx8mp-navqp.rst
new file mode 100644
index 00000000000..89d8f95af2d
--- /dev/null
+++ b/doc/board/emcraft/imx8mp-navqp.rst
@@ -0,0 +1,65 @@
+.. SPDX-License-Identifier: GPL-2.0-or-later
+.. sectionauthor:: Gilles Talis <gilles.talis@gmail.com>
+
+i.MX8M Plus NavQ+ Board
+=======================
+
+U-Boot for the EmCraft Systems i.MX8M Plus NavQ+ board
+
+Quick Start
+-----------
+
+- Build the ARM trusted firmware binary
+- Get the DDR firmware
+- Build U-Boot
+- Flash to eMMC
+- Boot
+
+Get and Build the ARM Trusted Firmware (Trusted Firmware A)
+-----------------------------------------------------------
+
+.. code-block:: bash
+
+ $ echo "Downloading and building TF-A..."
+ $ git clone -b lts-v2.10 https://git.trustedfirmware.org/TF-A/trusted-firmware-a.git
+ $ cd trusted-firmware-a
+
+Then build ATF (TF-A):
+
+.. code-block:: bash
+
+ $ export CROSS_COMPILE=aarch64-linux-gnu-
+ $ make PLAT=imx8mp bl31
+ $ cp build/imx8mp/release/bl31.bin ../
+
+Get the DDR Firmware
+--------------------
+
+.. code-block:: bash
+
+ $ cd ..
+ $ wget https://www.nxp.com/lgfiles/NMG/MAD/YOCTO/firmware-imx-8.23.bin
+ $ chmod +x firmware-imx-8.23.bin
+ $ ./firmware-imx-8.23.bin
+ $ cp firmware-imx-8.23/firmware/ddr/synopsys/lpddr4*_202006.bin ./
+
+Build U-Boot
+------------
+
+.. code-block:: bash
+
+ $ export CROSS_COMPILE=aarch64-linux-gnu-
+ $ make imx8mp_navqp_defconfig
+ $ make
+
+Burn the flash.bin to the MicroSD card at offset 32KB:
+
+.. code-block:: bash
+
+ $ sudo dd if=flash.bin of=/dev/sd[x] bs=1K seek=32 conv=notrunc; sync
+
+Boot
+----
+
+Set Boot switch to SD boot
+Use /dev/ttyUSB0 for U-Boot console
diff --git a/doc/board/emcraft/index.rst b/doc/board/emcraft/index.rst
new file mode 100644
index 00000000000..564552cb369
--- /dev/null
+++ b/doc/board/emcraft/index.rst
@@ -0,0 +1,9 @@
+.. SPDX-License-Identifier: GPL-2.0+
+
+Emcraft
+=======
+
+.. toctree::
+ :maxdepth: 2
+
+ imx8mp-navqp
diff --git a/doc/board/index.rst b/doc/board/index.rst
index 3fb7c84f10c..ca5246e259c 100644
--- a/doc/board/index.rst
+++ b/doc/board/index.rst
@@ -24,6 +24,7 @@ Board-specific doc
cloos/index
congatec/index
coreboot/index
+ emcraft/index
emulation/index
gateworks/index
google/index