diff mbox series

[v2,2/3] doc: board: phytec: Add phyGATE-Tauri board documentation

Message ID 20240110-wip-y-moog-phytec-de-tauri-l_upstream-v2-2-4ea2dd6a4f74@phytec.de
State Accepted
Commit ba9762da1cbf9e8eed2b2cb504088dda19cf8e33
Delegated to: Fabio Estevam
Headers show
Series This series adds support for the phyGATE-Tauri-L. | expand

Commit Message

Yannic Moog Jan. 10, 2024, 1:35 p.m. UTC
Add brief documentation on how to build a bootable U-Boot image for the
phyGATE-Tauri-L.

Signed-off-by: Yannic Moog <y.moog@phytec.de>
---
 board/phytec/phycore_imx8mm/MAINTAINERS     |  2 +
 doc/board/phytec/imx8mm-phygate-tauri-l.rst | 60 +++++++++++++++++++++++++++++
 doc/board/phytec/index.rst                  |  1 +
 3 files changed, 63 insertions(+)

Comments

Teresa Remmet Jan. 11, 2024, 10:55 a.m. UTC | #1
Am Mittwoch, dem 10.01.2024 um 14:35 +0100 schrieb Yannic Moog:
> Add brief documentation on how to build a bootable U-Boot image for
> the
> phyGATE-Tauri-L.
> 
> Signed-off-by: Yannic Moog <y.moog@phytec.de>

Reviewed-by: Teresa Remmet <t.remmet@phytec.de>

> ---
>  board/phytec/phycore_imx8mm/MAINTAINERS     |  2 +
>  doc/board/phytec/imx8mm-phygate-tauri-l.rst | 60
> +++++++++++++++++++++++++++++
>  doc/board/phytec/index.rst                  |  1 +
>  3 files changed, 63 insertions(+)
> 
> diff --git a/board/phytec/phycore_imx8mm/MAINTAINERS
> b/board/phytec/phycore_imx8mm/MAINTAINERS
> index 05d48ba2472..cf6f92c07e5 100644
> --- a/board/phytec/phycore_imx8mm/MAINTAINERS
> +++ b/board/phytec/phycore_imx8mm/MAINTAINERS
> @@ -10,4 +10,6 @@ F:    arch/arm/dts/imx8mm-phygate-tauri-l-u-
> boot.dtsi
>  F:      board/phytec/phycore_imx8mm/
>  F:     configs/imx8mm-phygate-tauri-l_defconfig
>  F:      configs/phycore-imx8mm_defconfig
> +F:     doc/board/phytec/imx8mm-phygate-tauri-l.rst
> +F:     doc/board/phytec/index.rst
>  F:      include/configs/phycore_imx8mm.h
> diff --git a/doc/board/phytec/imx8mm-phygate-tauri-l.rst
> b/doc/board/phytec/imx8mm-phygate-tauri-l.rst
> new file mode 100644
> index 00000000000..28b614fd144
> --- /dev/null
> +++ b/doc/board/phytec/imx8mm-phygate-tauri-l.rst
> @@ -0,0 +1,60 @@
> +.. SPDX-License-Identifier: GPL-2.0+
> +
> +phyGATE-Tauri-L-i.MX 8M Mini
> +============================
> +
> +The phyGATE-Tauri-L-i.MX 8M Mini with 2GB of main memory is
> supported.
> +
> +Quick Start
> +-----------
> +
> +- Build the ARM Trusted firmware binary
> +- Get ddr firmware
> +- Build U-Boot
> +- Boot
> +
> +Build the ARM Trusted firmware binary
> +-------------------------------------
> +
> +.. code-block:: bash
> +
> +   $ git clone
> https://git.trustedfirmware.org/TF-A/trusted-firmware-a.git
> +   $ cd trusted-firmware-a
> +   $ export CROSS_COMPILE=aarch64-linux-gnu
> +   $ export IMX_BOOT_UART_BASE=0x30880000
> +   $ make PLAT=imx8mm bl31
> +
> +Get the ddr firmware
> +--------------------
> +
> +.. code-block:: bash
> +
> +   $ 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
> +
> +Build U-Boot for SD card
> +------------------------
> +
> +Copy binaries
> +^^^^^^^^^^^^^
> +
> +.. code-block:: bash
> +
> +   $ cp <TF-A dir>/build/imx8mm/release/bl31.bin .
> +   $ cp firmware-imx-8.23/firmware/ddr/synopsys/lpddr4*.bin .
> +
> +Build U-Boot
> +^^^^^^^^^^^^
> +
> +.. code-block:: bash
> +
> +   $ make imx8mm-phygate-tauri-l_defconfig
> +   $ make flash.bin
> +
> +Flash SD card
> +^^^^^^^^^^^^^
> +
> +.. code-block:: bash
> +
> +   $ sudo dd if=flash.bin of=/dev/sd[x] bs=1024 seek=33 conv=sync
> diff --git a/doc/board/phytec/index.rst b/doc/board/phytec/index.rst
> index a5b442045ed..9996bce9741 100644
> --- a/doc/board/phytec/index.rst
> +++ b/doc/board/phytec/index.rst
> @@ -6,5 +6,6 @@ PHYTEC
>  .. toctree::
>     :maxdepth: 2
>  
> +   imx8mm-phygate-tauri-l
>     phycore-imx8mm
>     phycore-imx8mp
>
diff mbox series

Patch

diff --git a/board/phytec/phycore_imx8mm/MAINTAINERS b/board/phytec/phycore_imx8mm/MAINTAINERS
index 05d48ba2472..cf6f92c07e5 100644
--- a/board/phytec/phycore_imx8mm/MAINTAINERS
+++ b/board/phytec/phycore_imx8mm/MAINTAINERS
@@ -10,4 +10,6 @@  F:	arch/arm/dts/imx8mm-phygate-tauri-l-u-boot.dtsi
 F:      board/phytec/phycore_imx8mm/
 F:	configs/imx8mm-phygate-tauri-l_defconfig
 F:      configs/phycore-imx8mm_defconfig
+F:	doc/board/phytec/imx8mm-phygate-tauri-l.rst
+F:	doc/board/phytec/index.rst
 F:      include/configs/phycore_imx8mm.h
diff --git a/doc/board/phytec/imx8mm-phygate-tauri-l.rst b/doc/board/phytec/imx8mm-phygate-tauri-l.rst
new file mode 100644
index 00000000000..28b614fd144
--- /dev/null
+++ b/doc/board/phytec/imx8mm-phygate-tauri-l.rst
@@ -0,0 +1,60 @@ 
+.. SPDX-License-Identifier: GPL-2.0+
+
+phyGATE-Tauri-L-i.MX 8M Mini
+============================
+
+The phyGATE-Tauri-L-i.MX 8M Mini with 2GB of main memory is supported.
+
+Quick Start
+-----------
+
+- Build the ARM Trusted firmware binary
+- Get ddr firmware
+- Build U-Boot
+- Boot
+
+Build the ARM Trusted firmware binary
+-------------------------------------
+
+.. code-block:: bash
+
+   $ git clone https://git.trustedfirmware.org/TF-A/trusted-firmware-a.git
+   $ cd trusted-firmware-a
+   $ export CROSS_COMPILE=aarch64-linux-gnu
+   $ export IMX_BOOT_UART_BASE=0x30880000
+   $ make PLAT=imx8mm bl31
+
+Get the ddr firmware
+--------------------
+
+.. code-block:: bash
+
+   $ 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
+
+Build U-Boot for SD card
+------------------------
+
+Copy binaries
+^^^^^^^^^^^^^
+
+.. code-block:: bash
+
+   $ cp <TF-A dir>/build/imx8mm/release/bl31.bin .
+   $ cp firmware-imx-8.23/firmware/ddr/synopsys/lpddr4*.bin .
+
+Build U-Boot
+^^^^^^^^^^^^
+
+.. code-block:: bash
+
+   $ make imx8mm-phygate-tauri-l_defconfig
+   $ make flash.bin
+
+Flash SD card
+^^^^^^^^^^^^^
+
+.. code-block:: bash
+
+   $ sudo dd if=flash.bin of=/dev/sd[x] bs=1024 seek=33 conv=sync
diff --git a/doc/board/phytec/index.rst b/doc/board/phytec/index.rst
index a5b442045ed..9996bce9741 100644
--- a/doc/board/phytec/index.rst
+++ b/doc/board/phytec/index.rst
@@ -6,5 +6,6 @@  PHYTEC
 .. toctree::
    :maxdepth: 2
 
+   imx8mm-phygate-tauri-l
    phycore-imx8mm
    phycore-imx8mp