blob: 0fe15c95a6cbb5f7654f6d9a190e0791b5543c09 [file] [log] [blame]
Paul Beesleyf3653a62019-05-22 11:22:44 +01001NXP i.MX 8M Series
2==================
Bai Ping06e325e2018-10-28 00:12:34 +08003
4The i.MX 8M family of applications processors based on Arm Corte-A53 and Cortex-M4
5cores provide high-performance computing, power efficiency, enhanced system
6reliability and embedded security needed to drive the growth of fast-growing
7edge node computing, streaming multimedia, and machine learning applications.
8
Jacky Bai98074512021-06-07 10:11:04 +08009imx8mq is dropped in TF-A CI build due to the small OCRAM size, but still actively
10maintained in NXP official release.
11
Bai Ping06e325e2018-10-28 00:12:34 +080012Boot Sequence
Paul Beesleyf3653a62019-05-22 11:22:44 +010013-------------
Bai Ping06e325e2018-10-28 00:12:34 +080014
15Bootrom --> SPL --> BL31 --> BL33(u-boot) --> Linux kernel
16
17How to build
Paul Beesleyf3653a62019-05-22 11:22:44 +010018------------
Bai Ping06e325e2018-10-28 00:12:34 +080019
20Build Procedure
Paul Beesleyf3653a62019-05-22 11:22:44 +010021~~~~~~~~~~~~~~~
Bai Ping06e325e2018-10-28 00:12:34 +080022
23- Prepare AARCH64 toolchain.
24
25- Build spl and u-boot firstly, and get binary images: u-boot-spl.bin,
26 u-boot-nodtb.bin and dtb for the target board.
27
28- Build TF-A
29
30 Build bl31:
31
32 .. code:: shell
33
Mark Dykesef3a4562020-01-08 20:37:18 +000034 CROSS_COMPILE=aarch64-linux-gnu- make PLAT=<Target_SoC> bl31
Bai Ping06e325e2018-10-28 00:12:34 +080035
36 Target_SoC should be "imx8mq" for i.MX8MQ SoC.
Jacky Baia6177002019-03-06 17:15:06 +080037 Target_SoC should be "imx8mm" for i.MX8MM SoC.
Jacky Bai9bd2f842019-11-28 13:16:33 +080038 Target_SoC should be "imx8mn" for i.MX8MN SoC.
Jacky Bai07ed02c2020-06-03 14:28:45 +080039 Target_SoC should be "imx8mp" for i.MX8MP SoC.
Bai Ping06e325e2018-10-28 00:12:34 +080040
41Deploy TF-A Images
Paul Beesleyf3653a62019-05-22 11:22:44 +010042~~~~~~~~~~~~~~~~~~
Bai Ping06e325e2018-10-28 00:12:34 +080043
44TF-A binary(bl31.bin), u-boot-spl.bin u-boot-nodtb.bin and dtb are combined
45together to generate a binary file called flash.bin, the imx-mkimage tool is
46used to generate flash.bin, and flash.bin needs to be flashed into SD card
47with certain offset for BOOT ROM. the u-boot and imx-mkimage will be upstreamed
48soon, this doc will be updated once they are ready, and the link will be posted.
Ying-Chun Liu (PaulLiu)234c2712020-12-22 02:56:00 +080049
50TBBR Boot Sequence
51------------------
52
53When setting NEED_BL2=1 on imx8mm. We support an alternative way of
54boot sequence to support TBBR.
55
56Bootrom --> SPL --> BL2 --> BL31 --> BL33(u-boot with UEFI) --> grub
57
58This helps us to fulfill the SystemReady EBBR standard.
59BL2 will be in the FIT image and SPL will verify it.
60All of the BL3x will be put in the FIP image. BL2 will verify them.
61In U-boot we turn on the UEFI secure boot features so it can verify
62grub. And we use grub to verify linux kernel.