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