Files
u-boot/doc/board/toradex/smarc-imx95.rst
João Paulo Gonçalves ff0540fcfe board: toradex: add Toradex SMARC iMX95
Add support for the Toradex SMARC iMX95.

Link: https://www.toradex.com/computer-on-modules/smarc-arm-family/nxp-imx95
Link: https://www.toradex.com/products/carrier-board/smarc-development-board-kit
Signed-off-by: João Paulo Gonçalves <joao.goncalves@toradex.com>
Co-developed-by: Emanuele Ghidoli <emanuele.ghidoli@toradex.com>
Signed-off-by: Emanuele Ghidoli <emanuele.ghidoli@toradex.com>
Co-developed-by: Max Krummenacher <max.krummenacher@toradex.com>
Signed-off-by: Max Krummenacher <max.krummenacher@toradex.com>
Co-developed-by: Ernest Van Hoecke <ernest.vanhoecke@toradex.com>
Signed-off-by: Ernest Van Hoecke <ernest.vanhoecke@toradex.com>
2025-10-30 12:39:57 -03:00

173 lines
4.9 KiB
ReStructuredText

.. SPDX-License-Identifier: GPL-2.0-or-later
Toradex SMARC iMX95 Module
==========================
- SoM: https://www.toradex.com/computer-on-modules/smarc-arm-family/nxp-imx95
- Carrier board: https://www.toradex.com/products/carrier-board/smarc-development-board-kit
Quick Start
-----------
- Setup environment
- Get ahab-container.img
- Get DDR PHY Firmware Images
- Get and Build OEI Images
- Get and Build System Manager Image
- Get and Build the ARM Trusted Firmware
- Build the Bootloader Image
- Boot
Setup environment
-----------------
Suggested current toolchains are ARM 14.3 (https://developer.arm.com/downloads/-/arm-gnu-toolchain-downloads):
- https://developer.arm.com/-/media/Files/downloads/gnu/14.3.rel1/binrel/arm-gnu-toolchain-14.3.rel1-x86_64-arm-none-linux-gnueabihf.tar.xz
- https://developer.arm.com/-/media/Files/downloads/gnu/14.3.rel1/binrel/arm-gnu-toolchain-14.3.rel1-x86_64-aarch64-none-linux-gnu.tar.xz
.. code-block:: console
$ export TOOLS=<path/to/directory/with/toolchains>
$ export CROSS_COMPILE_32=<path/to/arm/toolchain/bin/>arm-none-linux-gnueabihf-
$ export CROSS_COMPILE_64=<path/to/arm64/toolchain/bin/>aarch64-none-linux-gnu-
Get ahab-container.img
----------------------
Note: `$srctree` is the U-Boot source directory
.. code-block:: console
$ wget https://www.nxp.com/lgfiles/NMG/MAD/YOCTO/firmware-ele-imx-2.0.2-89161a8.bin
$ sh firmware-ele-imx-2.0.2-89161a8.bin --auto-accept
$ cp firmware-ele-imx-2.0.2-89161a8/mx95b0-ahab-container.img $(srctree)
Get DDR PHY Firmware Images
---------------------------
Note: `$srctree` is the U-Boot source directory
.. code-block:: console
$ wget https://www.nxp.com/lgfiles/NMG/MAD/YOCTO/firmware-imx-8.28-994fa14.bin
$ sh firmware-imx-8.28-994fa14.bin --auto-accept
$ cp firmware-imx-8.28-994fa14/firmware/ddr/synopsys/lpddr5*v202409.bin $(srctree)
Get and Build OEI Images
------------------------
Note: `$srctree` is the U-Boot source directory
Get OEI from: https://git.toradex.com/cgit/imx-oei-toradex.git/
branch: main
.. code-block:: console
$ git clone -b main https://git.toradex.com/cgit/imx-oei-toradex.git/
$ cd imx-oei-toradex
$ make board=toradex-smarc-imx95 oei=ddr DEBUG=1 r=B0 all
$ cp build/toradex-smarc-imx95/ddr/oei-m33-ddr.bin $(srctree)
$ make board=toradex-smarc-imx95 oei=tcm DEBUG=1 r=B0 all
$ cp build/toradex-smarc-imx95/tcm/oei-m33-tcm.bin $(srctree)
The Makefile will set `DDR_CONFIG` automatically based on the selected silicon
revision.
Get and Build the System Manager Image
--------------------------------------
Note: `$srctree` is the U-Boot source directory
Get System Manager from: https://git.toradex.com/cgit/imx-sm-toradex.git/
branch: main
.. code-block:: console
$ git clone -b main https://git.toradex.com/cgit/imx-sm-toradex.git/
$ cd imx-sm-toradex
$ make config=tdx-smarc-imx95 all
$ cp build/tdx-smarc-imx95/m33_image.bin $(srctree)
Get and Build the ARM Trusted Firmware
--------------------------------------
Note: `$srctree` is the U-Boot source directory
Get ATF from: https://github.com/nxp-imx/imx-atf/
branch: lf_v2.12
.. code-block:: console
$ export CROSS_COMPILE=$CROSS_COMPILE_64
$ unset LDFLAGS
$ unset AS
$ git clone -b lf_v2.12 https://github.com/nxp-imx/imx-atf.git
$ cd imx-atf
$ make PLAT=imx95 bl31
$ cp build/imx95/release/bl31.bin $(srctree)
Build the Bootloader Image
--------------------------
.. code-block:: console
$ export CROSS_COMPILE=$CROSS_COMPILE_64
$ make toradex-smarc-imx95_defconfig
$ make
Flash to eMMC
-------------
.. code-block:: console
> tftpboot ${loadaddr} flash.bin
> setexpr blkcnt ${filesize} + 0x1ff && setexpr blkcnt ${blkcnt} / 0x200
> mmc dev 0 1 && mmc write ${loadaddr} 0x0 ${blkcnt}
As a convenience, instead of the last two commands, one may also use the update
U-Boot wrapper:
.. code-block:: console
> run update_uboot
Boot
----
Boot sequence is:
* SPL ---> ATF (TF-A) ---> U-Boot proper
Output:
.. code-block:: console
U-Boot SPL 2025.10-00635-g78345766559d (Oct 21 2025 - 17:53:04 +0200)
SYS Boot reason: por, origin: -1, errid: -1
Trying to boot from MMC1
Primary set selected
Load image from MMC/SD 0xd9000
NOTICE: BL31: v2.12.0(release):lf-6.12.20-2.0.0
NOTICE: BL31: Built : 17:34:12, Oct 21 2025
U-Boot 2025.10-00635-g78345766559d (Oct 21 2025 - 17:53:04 +0200)
CPU: NXP i.MX95 Rev2.0 A55 at 1800 MHz - invalid sensor data
DRAM: 7.8 GiB
Core: 305 devices, 26 uclasses, devicetree: separate
MMC: FSL_SDHC: 0, FSL_SDHC: 1
Loading Environment from MMC... Reading from MMC(0)... OK
In: serial@44380000
Out: serial@44380000
Err: serial@44380000
Model: Toradex 0096 SMARC iMX95 Hexa 8GB WB IT V1.1A
Serial#: 12594027
BuildInfo:
- ELE firmware version 2.0.2-2a118457
Net: No ethernet found.
Hit any key to stop autoboot: 0
SMARC iMX95 #