| Frieder Schrempf | 199dfd9 | 2021-09-29 16:42:42 +0200 | [diff] [blame] | 1 | .. SPDX-License-Identifier: GPL-2.0+ |
| 2 | |
| 3 | Kontron Electronics SL i.MX8MM SoM |
| 4 | ================================== |
| 5 | |
| 6 | The Kontron SoM-Line i.MX8MM (N801x) by Kontron Electronics GmbH is a SoM module |
| 7 | with an i.MX8M-Mini SoC, 1/2/4 GB LPDDR4 RAM, SPI NOR, eMMC and PMIC. |
| 8 | |
| 9 | The matching evaluation boards (Board-Line) have two Ethernet ports, USB 2.0, |
| 10 | HDMI/LVDS, SD card, CAN, RS485, RS232 and much more. |
| 11 | |
| 12 | Quick Start |
| 13 | ----------- |
| 14 | |
| 15 | - Get and Build the Trusted Firmware-A (TF-A) |
| 16 | - Get the DDR firmware |
| 17 | - Build U-Boot |
| 18 | - Boot |
| 19 | |
| 20 | Get and Build the Trusted Firmware-A (TF-A) |
| 21 | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ |
| 22 | |
| 23 | Note: builddir is U-Boot build directory (source directory for in-tree builds) |
| 24 | |
| 25 | There are two sources for the TF-A. Mainline and NXP. Get the one you prefer |
| 26 | (support and features might differ). |
| 27 | |
| 28 | **NXP's imx-atf** |
| 29 | |
| 30 | 1. Get TF-A from: https://source.codeaurora.org/external/imx/imx-atf, branch: imx_5.4.70_2.3.0 |
| 31 | 2. Apply the patch to select the correct UART for the console, otherwise the TF-A will lock up during boot. |
| 32 | 3. Build |
| 33 | |
| 34 | .. code-block:: bash |
| 35 | |
| 36 | $ make PLAT=imx8mm bl31 |
| 37 | $ cp build/imx8mm/release/bl31.bin $(builddir) |
| 38 | |
| 39 | **Mainline TF-A** |
| 40 | |
| 41 | 1. Get TF-A from: https://git.trustedfirmware.org/TF-A/trusted-firmware-a.git/, tag: v2.4 |
| 42 | 2. Build |
| 43 | |
| 44 | .. code-block:: bash |
| 45 | |
| 46 | $ make PLAT=imx8mm CROSS_COMPILE=aarch64-linux-gnu- IMX_BOOT_UART_BASE="0x30880000" bl31 |
| 47 | $ cp build/imx8mm/release/bl31.bin $(builddir) |
| 48 | |
| 49 | Get the DDR firmware |
| 50 | ^^^^^^^^^^^^^^^^^^^^ |
| 51 | |
| 52 | .. code-block:: bash |
| 53 | |
| 54 | $ wget https://www.nxp.com/lgfiles/NMG/MAD/YOCTO/firmware-imx-8.9.bin |
| 55 | $ chmod +x firmware-imx-8.9.bin |
| 56 | $ ./firmware-imx-8.9.bin |
| 57 | $ cp firmware-imx-8.9/firmware/ddr/synopsys/lpddr4*.bin $(builddir) |
| 58 | |
| 59 | Build U-Boot |
| 60 | ^^^^^^^^^^^^ |
| 61 | |
| 62 | .. code-block:: bash |
| 63 | |
| 64 | $ make kontron-sl-mx8mm_defconfig |
| 65 | $ export ATF_LOAD_ADDR=0x920000 |
| 66 | $ make |
| 67 | |
| 68 | Burn the flash.bin to SD card at an offset of 33 KiB: |
| 69 | |
| 70 | .. code-block:: bash |
| 71 | |
| 72 | $ dd if=flash.bin of=/dev/sd[x] bs=1K seek=33 conv=notrunc |
| 73 | |
| 74 | Boot |
| 75 | ^^^^ |
| 76 | |
| 77 | Put the SD card in the slot on the board and apply power. |
| 78 | |
| 79 | Further Information |
| 80 | ------------------- |
| 81 | |
| 82 | The bootloader configuration is setup to be used with kernel FIT images. Legacy |
| 83 | images might not be working out of the box. |
| 84 | |
| 85 | Please see https://docs.kontron-electronics.de for further vendor documentation. |