From 1beb665c50c6382632649069edc4bb7c9e3a2f80 Mon Sep 17 00:00:00 2001
From: Gilles Talis <gilles.talis@gmail.com>
Date: Sun, 27 Oct 2024 10:52:41 -0400
Subject: 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>
---
 doc/board/emcraft/imx8mp-navqp.rst | 65 ++++++++++++++++++++++++++++++++++++++
 doc/board/emcraft/index.rst        |  9 ++++++
 doc/board/index.rst                |  1 +
 3 files changed, 75 insertions(+)
 create mode 100644 doc/board/emcraft/imx8mp-navqp.rst
 create mode 100644 doc/board/emcraft/index.rst

(limited to 'doc')

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
-- 
cgit