[PATCH v2 2/2] doc: phytec: update imx8m docs for optee builds

Yannic Moog Y.Moog at phytec.de
Thu Sep 4 08:56:53 CEST 2025


Am Dienstag, dem 02.09.2025 um 07:25 +0000 schrieb Teresa Remmet:
> Hello Yannic,
> 
> Am Donnerstag, dem 14.08.2025 um 14:05 +0200 schrieb Yannic Moog:
> > OP-TEE configs are enabled by default, change the doc to no longer
> > declare OP-TEE as optional.
> > Further, phycore-imx8mm and imx8mm-phygate-tauri-l use different
> > build
> > instructions, so dissolve the common file for building OP-TEE.
> > While at it, introduce style changes where export commands are no
> > longer
> > used.
> 
> you do a lot of changes in this commit. The firmware version change is
> not mentioned in the commit message.

Thanks, forgot that.

>  I think it would be easier to
> follow your changes if you split the commit into multiple ones here.

Ok, will update doc style and then add change related doc.

Yannic
> 
> Kind Regards,
> Teresa
> 
> > 
> > Signed-off-by: Yannic Moog <y.moog at phytec.de>
> > ---
> >  board/phytec/phycore_imx8mm/MAINTAINERS     |  1 -
> >  doc/board/phytec/imx8mm-optee-build.rsti    | 14 ----------
> >  doc/board/phytec/imx8mm-phygate-tauri-l.rst | 42 ++++++++++++++++++-
> > ---------
> >  doc/board/phytec/phycore-imx8mm.rst         | 43
> > +++++++++++++++++++----------
> >  doc/board/phytec/phycore-imx8mp.rst         | 41 ++++++++++++++-----
> > --------
> >  5 files changed, 79 insertions(+), 62 deletions(-)
> > 
> > diff --git a/board/phytec/phycore_imx8mm/MAINTAINERS
> > b/board/phytec/phycore_imx8mm/MAINTAINERS
> > index
> > 7631e1cb331b608335620d0db49104459f673d1d..58c5e2d0af9fe404a5995fecc96
> > cdbaa5845f979 100644
> > --- a/board/phytec/phycore_imx8mm/MAINTAINERS
> > +++ b/board/phytec/phycore_imx8mm/MAINTAINERS
> > @@ -9,6 +9,5 @@ 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:     doc/board/phytec/imx8mm-optee-build.rsti
> >  F:     doc/board/phytec/phycore_imx8mm.rst
> >  F:      include/configs/phycore_imx8mm.h
> > diff --git a/doc/board/phytec/imx8mm-optee-build.rsti
> > b/doc/board/phytec/imx8mm-optee-build.rsti
> > deleted file mode 100644
> > index
> > c83de5cc7cf4a0229cbd89f4c7d2bfd8448cb735..000000000000000000000000000
> > 0000000000000
> > --- a/doc/board/phytec/imx8mm-optee-build.rsti
> > +++ /dev/null
> > @@ -1,14 +0,0 @@
> > -Build the OP-TEE binary (optional)
> > -----------------------------------
> > -
> > -.. code-block:: bash
> > -
> > -   $ git clone https://github.com/OP-TEE/optee_os.git
> > -   $ cd optee_os
> > -   $ make CFG_TEE_BENCHMARK=n \
> > -     CROSS_COMPILE=aarch64-linux-gnu- \
> > -     O=out/arm \
> > -     PLATFORM=imx-mx8mmevk \
> > -     CFG_TZDRAM_START=0x56000000 \
> > -     CFG_DDR_SIZE=0x80000000 \
> > -     CFG_UART_BASE=UART3_BASE
> > diff --git a/doc/board/phytec/imx8mm-phygate-tauri-l.rst
> > b/doc/board/phytec/imx8mm-phygate-tauri-l.rst
> > index
> > 0d9e1024f8c5300e91a3a4c18b2babd5853a0824..4dd82cd9785fa585ed216664a25
> > f593d4e723dbb 100644
> > --- a/doc/board/phytec/imx8mm-phygate-tauri-l.rst
> > +++ b/doc/board/phytec/imx8mm-phygate-tauri-l.rst
> > @@ -9,7 +9,7 @@ Quick Start
> >  -----------
> >  
> >  - Build the ARM Trusted firmware binary
> > -- Build the OP-TEE binary (optional)
> > +- Build the OP-TEE binary
> >  - Get ddr firmware
> >  - Build U-Boot
> >  - Boot
> > @@ -21,23 +21,35 @@ Build the ARM Trusted firmware binary
> >  
> >     $ 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
> > -   $ # with optee
> > -   $ make PLAT=imx8mm BL32_BASE=0x56000000 SPD=opteed bl31
> > -   $ # without optee
> > -   $ make PLAT=imx8mm bl31
> > +   $ make -j $(nproc) \
> > +          CROSS_COMPILE=aarch64-linux-gnu- \
> > +          PLAT=imx8mm \
> > +          IMX_BOOT_UART_BASE=0x30880000 \
> > +          BL32_BASE=0xbe000000 \
> > +          SPD=opteed \
> > +          bl31
> >  
> > -.. include:: imx8mm-optee-build.rsti
> > +Build the OP-TEE binary
> > +-----------------------
> > +
> > +.. code-block:: bash
> > +
> > +   $ git clone https://github.com/OP-TEE/optee_os.git
> > +   $ cd optee_os
> > +   $ make -j $(nproc) \
> > +          CROSS_COMPILE=aarch64-linux-gnu- \
> > +          CFG_TEE_BENCHMARK=n \
> > +          O=out/arm \
> > +          PLATFORM=imx-mx8mm_phygate_tauri_l
> >  
> >  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
> > +   $ wget
> > https://www.nxp.com/lgfiles/NMG/MAD/YOCTO/firmware-imx-8.28-994fa14.bin
> > +   $ chmod +x firmware-imx-8.28-994fa14.bin
> > +   $ ./firmware-imx-8.28-994fa14.bin
> >  
> >  Build U-Boot for SD card
> >  ------------------------
> > @@ -49,15 +61,17 @@ Copy binaries
> >  
> >     $ cp <TF-A dir>/build/imx8mm/release/bl31.bin .
> >     $ cp <OP-TEE dir>/out/arm/core/tee-raw.bin tee.bin
> > -   $ cp firmware-imx-8.23/firmware/ddr/synopsys/lpddr4*.bin .
> > +   $ cp firmware-imx-8.28-994fa14/firmware/ddr/synopsys/lpddr4*.bin
> > .
> >  
> >  Build U-Boot
> >  ^^^^^^^^^^^^
> >  
> >  .. code-block:: bash
> >  
> > -   $ make imx8mm-phygate-tauri-l_defconfig
> > -   $ make flash.bin
> > +   $ make -j $(nproc)
> > +          CROSS_COMPILE=aarch64-linux-gnu- \
> > +          imx8mm-phygate-tauri-l_defconfig \
> > +          flash.bin
> >  
> >  Flash SD card
> >  ^^^^^^^^^^^^^
> > diff --git a/doc/board/phytec/phycore-imx8mm.rst
> > b/doc/board/phytec/phycore-imx8mm.rst
> > index
> > 08f5949e02d8d2bfba71867d93c2b3ed8fdc67e2..d5edbc91474e95f677dd12e5fcc
> > 6c16092dea1cd 100644
> > --- a/doc/board/phytec/phycore-imx8mm.rst
> > +++ b/doc/board/phytec/phycore-imx8mm.rst
> > @@ -9,7 +9,7 @@ Quick Start
> >  -----------
> >  
> >  - Build the ARM Trusted firmware binary
> > -- Build the OP-TEE binary (optional)
> > +- Build the OP-TEE binary
> >  - Get ddr firmware
> >  - Build U-Boot
> >  - Boot
> > @@ -21,23 +21,35 @@ Build the ARM Trusted firmware binary
> >  
> >     $ 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
> > -   $ # with optee
> > -   $ make PLAT=imx8mm BL32_BASE=0x56000000 SPD=opteed bl31
> > -   $ # without optee
> > -   $ make PLAT=imx8mm bl31
> > +   $ make -j $(nproc) \
> > +          CROSS_COMPILE=aarch64-linux-gnu- \
> > +          PLAT=imx8mm \
> > +          IMX_BOOT_UART_BASE=0x30880000 \
> > +          BL32_BASE=0x7e000000 \
> > +          SPD=opteed \
> > +          bl31
> >  
> > -.. include:: imx8mm-optee-build.rsti
> > +Build the OP-TEE binary
> > +-----------------------
> > +
> > +.. code-block:: bash
> > +
> > +   $ git clone https://github.com/OP-TEE/optee_os.git
> > +   $ cd optee_os
> > +   $ make -j $(nproc) \
> > +          CROSS_COMPILE=aarch64-linux-gnu- \
> > +          CFG_TEE_BENCHMARK=n \
> > +          O=out/arm \
> > +          PLATFORM=imx-mx8mm_phyboard_polis
> >  
> >  Get the ddr firmware
> >  --------------------
> >  
> >  .. code-block:: bash
> >  
> > -   $ wget
> > https://www.nxp.com/lgfiles/NMG/MAD/YOCTO/firmware-imx-8.19.bin
> > -   $ chmod +x firmware-imx-8.19.bin
> > -   $ ./firmware-imx-8.19.bin
> > +   $ wget
> > https://www.nxp.com/lgfiles/NMG/MAD/YOCTO/firmware-imx-8.28-994fa14.bin
> > +   $ chmod +x firmware-imx-8.28-994fa14.bin
> > +   $ ./firmware-imx-8.28-994fa14.bin
> >  
> >  Build U-Boot for SD card
> >  ------------------------
> > @@ -48,15 +60,18 @@ Copy binaries
> >  .. code-block:: bash
> >  
> >     $ cp <TF-A dir>/build/imx8mm/release/bl31.bin .
> > -   $ cp firmware-imx-8.19/firmware/ddr/synopsys/lpddr4*.bin .
> > +   $ cp <OP-TEE dir>/out/arm/core/tee-raw.bin tee.bin
> > +   $ cp firmware-imx-8.28-994fa14/firmware/ddr/synopsys/lpddr4*.bin
> > .
> >  
> >  Build U-Boot
> >  ^^^^^^^^^^^^
> >  
> >  .. code-block:: bash
> >  
> > -   $ make phycore-imx8mm_defconfig
> > -   $ make flash.bin
> > +   $ make -j $(nproc) \
> > +          CROSS_COMPILE=aarch64-linux-gnu- \
> > +          phycore-imx8mm_defconfig \
> > +          flash.bin
> >  
> >  Flash SD card
> >  ^^^^^^^^^^^^^
> > diff --git a/doc/board/phytec/phycore-imx8mp.rst
> > b/doc/board/phytec/phycore-imx8mp.rst
> > index
> > 50be99126537a2dc5323bd49c1513b196182c5f3..cea3a2835e69d6c6d3aa4c16698
> > aebd09f73bf49 100644
> > --- a/doc/board/phytec/phycore-imx8mp.rst
> > +++ b/doc/board/phytec/phycore-imx8mp.rst
> > @@ -3,13 +3,13 @@
> >  phyCORE-i.MX 8M Plus
> >  ====================
> >  
> > -The phyCORE-i.MX 8M Plus with 2GB of main memory is supported.
> > +The phyCORE-i.MX 8M Plus with 1,2,4GB of main memory is supported.
> >  
> >  Quick Start
> >  -----------
> >  
> >  - Build the ARM Trusted firmware binary
> > -- Build the OP-TEE binary (optional)
> > +- Build the OP-TEE binary
> >  - Get ddr firmware
> >  - Build U-Boot
> >  - Boot
> > @@ -21,12 +21,13 @@ Build the ARM Trusted firmware binary
> >  
> >     $ 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=0x30860000
> > -   $ # with optee
> > -   $ make PLAT=imx8mp SPD=opteed bl31
> > -   $ # without optee
> > -   $ make PLAT=imx8mp bl31
> > +   $ make -j $(nproc) \
> > +          CROSS_COMPILE=aarch64-linux-gnu- \
> > +          PLAT=imx8mp \
> > +          IMX_BOOT_UART_BASE=0x30860000 \
> > +          BL32_BASE=0x7e000000 \
> > +          SPD=opteed \
> > +          bl31
> >  
> >  Build the OP-TEE binary (optional)
> >  ----------------------------------
> > @@ -35,20 +36,20 @@ Build the OP-TEE binary (optional)
> >  
> >     $ git clone https://github.com/OP-TEE/optee_os.git
> >     $ cd optee_os
> > -   $ make CFG_TEE_BENCHMARK=n \
> > -     CROSS_COMPILE=aarch64-linux-gnu- \
> > -     O=out/arm \
> > -     PLATFORM=imx-mx8mp_phyboard_pollux \
> > -     CFG_TZDRAM_START=0x56000000
> > +   $ make -j $(nproc) \
> > +          CROSS_COMPILE=aarch64-linux-gnu- \
> > +          CFG_TEE_BENCHMARK=n \
> > +          O=out/arm \
> > +          PLATFORM=imx-mx8mp_phyboard_pollux
> >  
> >  Get the ddr firmware
> >  --------------------
> >  
> >  .. code-block:: bash
> >  
> > -   $ wget
> > https://www.nxp.com/lgfiles/NMG/MAD/YOCTO/firmware-imx-8.19.bin
> > -   $ chmod +x firmware-imx-8.19.bin
> > -   $ ./firmware-imx-8.19.bin
> > +   $ wget
> > https://www.nxp.com/lgfiles/NMG/MAD/YOCTO/firmware-imx-8.28-994fa14.bin
> > +   $ chmod +x firmware-imx-8.28-994fa14.bin
> > +   $ ./firmware-imx-8.28-994fa14.bin
> >  
> >  Build U-Boot for SD card
> >  ------------------------
> > @@ -60,15 +61,17 @@ Copy binaries
> >  
> >     $ cp <TF-A dir>/build/imx8mp/release/bl31.bin .
> >     $ cp <OP-TEE dir>/out/arm/core/tee-raw.bin tee.bin
> > -   $ cp firmware-imx-8.19/firmware/ddr/synopsys/lpddr4*.bin .
> > +   $ cp firmware-imx-8.28-994fa14/firmware/ddr/synopsys/lpddr4*.bin
> > .
> >  
> >  Build U-Boot
> >  ^^^^^^^^^^^^
> >  
> >  .. code-block:: bash
> >  
> > -   $ make phycore-imx8mp_defconfig
> > -   $ make flash.bin
> > +   $ make -j $(nproc) \
> > +          CROSS_COMPILE=aarch64-linux-gnu- \
> > +          phycore-imx8mp_defconfig \
> > +          flash.bin
> >  
> >  Flash SD card
> >  ^^^^^^^^^^^^^
> > 
> 
> -- 
> PHYTEC Messtechnik GmbH | Barcelona-Allee 1 | 55129 Mainz, Germany
> 
> Geschäftsführer: Dipl.-Ing. Michael Mitezki, Dipl.-Ing. Bodo Huber,
> Dipl.-Ing. (FH) Markus Lickes | Handelsregister Mainz HRB 4656 |
> Finanzamt Mainz | St.Nr. 26/665/00608, DE 149059855


More information about the U-Boot mailing list