mirror of
https://github.com/AsahiLinux/u-boot
synced 2024-12-13 06:42:56 +00:00
f0f461287e
As explained in the text at the bottom of the page https://source.codeaurora.org/external/imx/imx-atf: "QUIC repositories on this site will not receive any updates after March 31, 2022, and will be deleted on March 31, 2023." Point to the NXP ATF github repo instead. Signed-off-by: Fabio Estevam <festevam@denx.de> Reviewed-by: Oliver Graute <oliver.graute@kococonnector.com> Reviewed-by: Marcel Ziswiler <marcel.ziswiler@toradex.com> Reviewed-by: Frieder Schrempf <frieder.schrempf@kontron.de>
135 lines
3.8 KiB
ReStructuredText
135 lines
3.8 KiB
ReStructuredText
.. SPDX-License-Identifier: GPL-2.0+
|
|
|
|
Kontron Electronics i.MX8MM SoMs and Boards
|
|
===========================================
|
|
|
|
The SL i.MX8MM and OSM-S i.MX8MM by Kontron Electronics GmbH are SoM modules
|
|
with an i.MX8M-Mini SoC, 1/2/4 GB LPDDR4 RAM, SPI NOR, eMMC and PMIC.
|
|
|
|
The matching evaluation boards (Board-Line, BL) have two Ethernet ports,
|
|
USB 2.0, HDMI/LVDS, SD card, CAN, RS485, RS232 and much more.
|
|
|
|
The OSM-S i.MX8MM is compliant to the Open Standard Module (OSM) 1.1
|
|
specification, size S (https://sget.org/standards/osm).
|
|
|
|
Quick Start
|
|
-----------
|
|
|
|
- Get and Build the Trusted Firmware-A (TF-A)
|
|
- Get the DDR firmware
|
|
- Build U-Boot
|
|
- Boot
|
|
|
|
.. note::
|
|
|
|
To build on a x86-64 host machine, you need a GNU cross toolchain for the
|
|
target architecture (aarch64). Check your distros package manager or
|
|
download and install the necessary tools (``aarch64-linux-gnu-*``) manually.
|
|
|
|
Get and Build the Trusted Firmware-A (TF-A)
|
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
There are two sources for the TF-A. Mainline and NXP. Get the one you prefer
|
|
(support and features might differ).
|
|
|
|
.. note::
|
|
|
|
If you are using GCC 12 and you get compiler/linker errors, try to add the
|
|
following arguments to your make command as workaround:
|
|
``CFLAGS="-Wno-array-bounds" LDFLAGS="--no-warn-rwx-segments"``
|
|
|
|
**NXP's imx-atf**
|
|
|
|
1. Get TF-A from: https://github.com/nxp-imx/imx-atf, branch: imx_5.4.70_2.3.0
|
|
2. Build
|
|
|
|
.. code-block:: bash
|
|
|
|
$ make PLAT=imx8mm CROSS_COMPILE=aarch64-linux-gnu- IMX_BOOT_UART_BASE="0x30880000" bl31
|
|
$ cp build/imx8mm/release/bl31.bin $(builddir)
|
|
|
|
.. note::
|
|
|
|
*builddir* is U-Boot's build directory (source directory for in-tree builds)
|
|
|
|
**Mainline TF-A**
|
|
|
|
1. Get TF-A from: https://git.trustedfirmware.org/TF-A/trusted-firmware-a.git/, tag: v2.4
|
|
2. Build
|
|
|
|
.. code-block:: bash
|
|
|
|
$ make PLAT=imx8mm CROSS_COMPILE=aarch64-linux-gnu- IMX_BOOT_UART_BASE="0x30880000" bl31
|
|
$ cp build/imx8mm/release/bl31.bin $(builddir)
|
|
|
|
Get the DDR firmware
|
|
^^^^^^^^^^^^^^^^^^^^
|
|
|
|
.. code-block:: bash
|
|
|
|
$ wget https://www.nxp.com/lgfiles/NMG/MAD/YOCTO/firmware-imx-8.18.bin
|
|
$ chmod +x firmware-imx-8.18.bin
|
|
$ ./firmware-imx-8.18.bin
|
|
$ cp firmware-imx-8.18/firmware/ddr/synopsys/lpddr4_pmu_train_1d_imem.bin $(builddir)
|
|
$ cp firmware-imx-8.18/firmware/ddr/synopsys/lpddr4_pmu_train_1d_dmem.bin $(builddir)
|
|
$ cp firmware-imx-8.18/firmware/ddr/synopsys/lpddr4_pmu_train_2d_imem.bin $(builddir)
|
|
$ cp firmware-imx-8.18/firmware/ddr/synopsys/lpddr4_pmu_train_2d_dmem.bin $(builddir)
|
|
|
|
Build U-Boot
|
|
^^^^^^^^^^^^
|
|
|
|
.. code-block:: bash
|
|
|
|
$ make kontron-sl-mx8mm_defconfig
|
|
$ make CROSS_COMPILE=aarch64-linux-gnu-
|
|
|
|
Copy the flash.bin to SD card at an offset of 33 KiB:
|
|
|
|
.. code-block:: bash
|
|
|
|
$ dd if=flash.bin of=/dev/sd[x] bs=1K seek=33 conv=notrunc
|
|
|
|
Boot
|
|
^^^^
|
|
|
|
Put the SD card in the slot on the board and apply power. Check the serial
|
|
console for output.
|
|
|
|
Flash the Bootloader to SPI NOR
|
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
1. Determine and note the exact size of the ``flash.bin`` image in bytes (e.g.
|
|
by running ``ls -l flash.bin``)
|
|
|
|
2. On the U-Boot CLI copy the bootloader from SD card to RAM:
|
|
|
|
.. code-block::
|
|
|
|
mmc dev 1
|
|
mmc read $loadaddr 0x42 0x1000
|
|
|
|
3. Erase the SPI NOR flash:
|
|
|
|
.. code-block::
|
|
|
|
sf probe
|
|
sf erase 0x0 0x200000
|
|
|
|
4. Copy the bootloader from RAM to SPI NOR. For the last parameter of the
|
|
command, use the size determined in step 1 in **hexadecimal notation**:
|
|
|
|
.. code-block::
|
|
|
|
sf write $loadaddr 0x400 0x13B6F0
|
|
|
|
.. note::
|
|
|
|
To be able to boot from SPI NOR the OTP fuses need to be set accordingly.
|
|
|
|
Further Information
|
|
-------------------
|
|
|
|
The bootloader configuration is setup to be used with kernel FIT images. Legacy
|
|
images might not be working out of the box.
|
|
|
|
Please see https://docs.kontron-electronics.de for further vendor documentation.
|