Difference between revisions of "DESK-MX8M-L/Development/Building Boot Image"

From DAVE Developer's Wiki
Jump to: navigation, search
(Clone the repositories)
Line 35: Line 35:
 
The System Controller Unit (SCU) represents the evolution of centralized control for system-level resources on i.MX8. The heart of the system controller is a Cortex-M4 that executes System Controller Firmware. The SCF is an essential part of the i.MX8 architecture. Please find more information about SCF [https://community.nxp.com/t5/Connects-Training-Material/Infotainment-Connectivity-Security-Introduction-to-the-System/ta-p/1115096 here].
 
The System Controller Unit (SCU) represents the evolution of centralized control for system-level resources on i.MX8. The heart of the system controller is a Cortex-M4 that executes System Controller Firmware. The SCF is an essential part of the i.MX8 architecture. Please find more information about SCF [https://community.nxp.com/t5/Connects-Training-Material/Infotainment-Connectivity-Security-Introduction-to-the-System/ta-p/1115096 here].
  
TF-A binary, scfw_tcm.bin and u-boot.bin are combined together to generate a binary file called flash.bin; the <code>imx-mkimage</code> tool is used to generate '''flash.bin''', and flash.bin needs to be flashed into the bootable storage device.
+
TF-A binary <code>bl31.bin</code>, <code>scfw_tcm.bin</code> and <code>u-boot.bin</code> are combined together to generate a binary file called <code>flash.bin</code>; the <code>imx-mkimage</code> tool is used to generate '''flash.bin''' which will be flashed into the bootable storage device.
  
 
In the following paragraphs we will explain how to get or build those binaries to be combined in a single binary to be flashed in the bootable storage device.
 
In the following paragraphs we will explain how to get or build those binaries to be combined in a single binary to be flashed in the bootable storage device.
Line 106: Line 106:
 
make imx8mp_mito8mplus_defconfig
 
make imx8mp_mito8mplus_defconfig
 
make
 
make
 +
</pre>
 +
This steps produce the <code>u-boot-spl.bin</code> and <code>u-boot.bin</code> files used at the last step.
 +
<pre class="workstation-terminal">
 +
dvdk@vagrant:~/desk-mx-l/desk-mx8-mkimage/u-boot-imx$ ls -la spl/u-boot-spl.bin
 +
-rwxrwxr-x 1 dvdk dvdk 94328 Feb 17 14:56 spl/u-boot-spl.bin
 +
dvdk@vagrant:~/desk-mx-l/desk-mx8-mkimage/u-boot-imx$ ls -la u-boot.bin
 +
-rw-rw-r-- 1 dvdk dvdk 861312 Feb 17 14:55 u-boot.bin
 +
dvdk@vagrant:~/desk-mx-l/desk-mx8-mkimage/u-boot-imx$
 
</pre>
 
</pre>
  
Line 115: Line 123:
 
</pre>
 
</pre>
  
Please note that this is usually a generic command that generates all required binaries (kernel + device trees) for the different platform. In other words: it is not usually required to specify a different target depending on specific board configuration.
+
and build the TF-A binary for the selected platform.
 +
 
 +
For [[ORCA SOM| ORCA]] SOM:
 +
<pre>
 +
make PLAT=imx8mp bl31
 +
</pre>
 +
 
 +
For [[MITO 8M Mini SOM| MITO 8M Mini]] SOM:
 +
<pre>
 +
make PLAT=imx8mm bl31
 +
</pre>
  
 
=== Get i.MX firmware ===
 
=== Get i.MX firmware ===
Line 148: Line 166:
 
where BOARD is: <code>imx8mp-mito8mplus</code> or <code>imx8mm-mito8mmini</code>  
 
where BOARD is: <code>imx8mp-mito8mplus</code> or <code>imx8mm-mito8mmini</code>  
  
For [[ORCA SOM | ORCA]]:
+
For [[ORCA SOM | ORCA]] SOM:
 
 
 
<pre class="workstation-terminal">
 
<pre class="workstation-terminal">
 
dvdk@vagrant:~/desk-mx-l/desk-mx8-mkimage$ ./imx8mp-mito8mplus_generate_flash.bin  
 
dvdk@vagrant:~/desk-mx-l/desk-mx8-mkimage$ ./imx8mp-mito8mplus_generate_flash.bin  
 +
Compiling mkimage_imx8
 +
PLAT=imx8mp HDMI=no
 +
Compiling mkimage_imx8
 +
gcc  -O2 -pipe -g -feliminate-unused-debug-types  mkimage_imx8.c -o mkimage_imx8 -lz
 +
23582+0 records in
 +
23582+0 records out
 +
94328 bytes (94 kB, 92 KiB) copied, 0.0379032 s, 2.5 MB/s
 +
./../scripts/dtb_check.sh imx8mp-evk.dtb evk.dtb
 +
Use u-boot DTB: imx8mp-evk.dtb
 +
./../scripts/pad_image.sh tee.bin
 +
...
 
...
 
...
 
...
 
...
 +
...
 +
========= OFFSET dump =========
 +
Loader IMAGE:
 +
header_image_off 0x0
 +
dcd_off 0x0
 +
image_off 0x40
 +
csf_off 0x2b800
 +
spl hab block: 0x91ffc0 0x0 0x2b800
 +
 +
Second Loader IMAGE:
 +
sld_header_off 0x58000
 +
sld_csf_off 0x59020
 +
sld hab block: 0x401fcdc0 0x58000 0x1020
 +
 +
******************************
 +
******************************
 +
 +
flash.bin generated successfully
 +
write it on a SD card with
 +
dd if=flash.bin of=/dev/sdX bs=1k seek=32 conv=fsync
 +
 +
******************************
 +
******************************
 
dvdk@vagrant:~/desk-mx-l/desk-mx8-mkimage$  
 
dvdk@vagrant:~/desk-mx-l/desk-mx8-mkimage$  
 +
</pre>
 +
 +
For [[MITO 8M Mini SOM | MITO M8M Mini]] SOM:
 +
<pre>
 +
./imx8mm-mito8mmini_generate_flash.bin
 
</pre>
 
</pre>
  
 
----
 
----
 
[[Category:ORCA]] [[Category:MITO 8M Mini]]
 
[[Category:ORCA]] [[Category:MITO 8M Mini]]

Revision as of 14:05, 17 February 2022

History
Version Issue Date Notes
1.0.0 Feb 2022 First DESK-MX8M release



Building Boot Image[edit | edit source]

Quick reference[edit | edit source]

Repository Information
URL git@git.dave.eu:desk-mx-l/desk-mx8-mkimage.git
stable branch desk-mx8m-l-rel-2.0.0
stable tag desk-mx8m-l-2.0.0-rc2

i.MX8 Boot Image[edit | edit source]

The System Controller Unit (SCU) represents the evolution of centralized control for system-level resources on i.MX8. The heart of the system controller is a Cortex-M4 that executes System Controller Firmware. The SCF is an essential part of the i.MX8 architecture. Please find more information about SCF here.

TF-A binary bl31.bin, scfw_tcm.bin and u-boot.bin are combined together to generate a binary file called flash.bin; the imx-mkimage tool is used to generate flash.bin which will be flashed into the bootable storage device.

In the following paragraphs we will explain how to get or build those binaries to be combined in a single binary to be flashed in the bootable storage device.

Instructions[edit | edit source]

It is assumed that the development environment has been set up properly as described here.

  • start the Linux development VM and login into the system
  • open a terminal window and cd into desk-mx-l directory
cd desk-mx-l

Clone the repositories[edit | edit source]

  • clone recursively the Boot repositories
dvdk@vagrant:~/desk-mx-l$ git clone --recursive git@git.dave.eu:desk-mx-l/desk-mx8-mkimage.git
Cloning into 'desk-mx8-mkimage'...
remote: Enumerating objects: 57, done.
remote: Total 57 (delta 0), reused 0 (delta 0), pack-reused 57
Receiving objects: 100% (57/57), 7.14 KiB | 7.14 MiB/s, done.
Resolving deltas: 100% (28/28), done.
dvdk@vagrant:~/desk-mx-l$ 
  • checkout the required branch
git checkout desk-mx8m-l-rel-2.0.0
  • update the submodule (i.e. sync the sub-repositories)
dvdk@vagrant:~/desk-mx-l/desk-mx8-mkimage$ git submodule update
Cloning into '/home/dvdk/desk-mx-l/desk-mx8-mkimage/imx-atf'...
Cloning into '/home/dvdk/desk-mx-l/desk-mx8-mkimage/imx-mkimage'...
Cloning into '/home/dvdk/desk-mx-l/desk-mx8-mkimage/u-boot-imx'...
Submodule path 'imx-atf': checked out 'a72158b5e10527b9e13a64f8305b4210423fa09b'
Submodule path 'imx-mkimage': checked out '8947fea369ab3932259630232cfb9f87b8f9dda1'
Submodule path 'u-boot-imx': checked out '2af0221006d686ae561a68f324c56bf2da3953ad'
dvdk@vagrant:~/desk-mx-l/desk-mx8-mkimage$ 

In case of ca-certificates failures, which may appears during https access to some repo:

fatal: unable to access 'https://source.codeaurora.org/external/imx/imx-mkimage.git/': server certificate verification failed. CAfile: /etc/ssl/certs/ca-certificates.crt CRLfile: none
fatal: clone of 'https://source.codeaurora.org/external/imx/imx-mkimage.git' into submodule path '/home/dvdk/desk-mx-l/desk-mx8-mkimage/imx-mkimage' failed
Failed to clone 'imx-mkimage'. Retry scheduled
...

a possible solution is to disable the SSL verification setting:

export GIT_SSL_NO_VERIFY=1

Enable the cross-compilation[edit | edit source]

  • configure the build environment for cross-compilation
source /home/dvdk/desk-mx-l/desk-mx8m-l-2.0.0-rc2_env.sh

Build U-Boot[edit | edit source]

First step is to build U-Boot binaries: the same instructions can be found in the dedicated wiki page

cd u-boot-imx
  • select the proper defconfig and start the make compilation
make imx8mp_mito8mplus_defconfig
make

This steps produce the u-boot-spl.bin and u-boot.bin files used at the last step.

dvdk@vagrant:~/desk-mx-l/desk-mx8-mkimage/u-boot-imx$ ls -la spl/u-boot-spl.bin
-rwxrwxr-x 1 dvdk dvdk 94328 Feb 17 14:56 spl/u-boot-spl.bin
dvdk@vagrant:~/desk-mx-l/desk-mx8-mkimage/u-boot-imx$ ls -la u-boot.bin
-rw-rw-r-- 1 dvdk dvdk 861312 Feb 17 14:55 u-boot.bin
dvdk@vagrant:~/desk-mx-l/desk-mx8-mkimage/u-boot-imx$ 

Build ATF[edit | edit source]

This process builds the ARM Trusted Firmware: please find more information here

cd imx-atf

and build the TF-A binary for the selected platform.

For ORCA SOM:

make PLAT=imx8mp bl31

For MITO 8M Mini SOM:

make PLAT=imx8mm bl31

Get i.MX firmware[edit | edit source]

This will download the binary archive, accept EULA automatically (you must agree with that) and extract the archive itself

dvdk@vagrant:~/desk-mx-l/desk-mx8-mkimage$ ./fetch_firmware.sh
--2022-02-17 11:37:24--  https://www.nxp.com/lgfiles/NMG/MAD/YOCTO/firmware-imx-8.10.bin
Resolving www.nxp.com (www.nxp.com)... 104.120.105.182
Connecting to www.nxp.com (www.nxp.com)|104.120.105.182|:443... connected.
HTTP request sent, awaiting response... 200 OK
Length: 1467137 (1.4M) [application/octet-stream]
Saving to: ‘firmware-imx-8.10.bin’

firmware-imx-8.10.bin                           100%[=====================================================================================================>]   1.40M  4.63MB/s    in 0.3s    

2022-02-17 11:37:25 (4.63 MB/s) - ‘firmware-imx-8.10.bin’ saved [1467137/1467137]

Welcome to NXP firmware-imx-8.10.bin

WARNING: EULA has been auto-accepted; this implies that you agree with it.
Unpacking file .......................................................................... done
dvdk@vagrant:~/desk-mx-l/desk-mx8-mkimage$ 

Generate Boot image[edit | edit source]

After building the single pieces of software, run:

./${BOARD}_generate_flash.bin

where BOARD is: imx8mp-mito8mplus or imx8mm-mito8mmini

For ORCA SOM:

dvdk@vagrant:~/desk-mx-l/desk-mx8-mkimage$ ./imx8mp-mito8mplus_generate_flash.bin 
Compiling mkimage_imx8
PLAT=imx8mp HDMI=no
Compiling mkimage_imx8
gcc  -O2 -pipe -g -feliminate-unused-debug-types  mkimage_imx8.c -o mkimage_imx8 -lz
23582+0 records in
23582+0 records out
94328 bytes (94 kB, 92 KiB) copied, 0.0379032 s, 2.5 MB/s
./../scripts/dtb_check.sh imx8mp-evk.dtb evk.dtb
Use u-boot DTB: imx8mp-evk.dtb
./../scripts/pad_image.sh tee.bin
...
...
...
...
========= OFFSET dump =========
Loader IMAGE:
 header_image_off 	0x0
 dcd_off 		0x0
 image_off 		0x40
 csf_off 		0x2b800
 spl hab block: 	0x91ffc0 0x0 0x2b800

Second Loader IMAGE:
 sld_header_off 	0x58000
 sld_csf_off 		0x59020
 sld hab block: 	0x401fcdc0 0x58000 0x1020

******************************
******************************

flash.bin generated successfully
write it on a SD card with
dd if=flash.bin of=/dev/sdX bs=1k seek=32 conv=fsync

******************************
******************************
dvdk@vagrant:~/desk-mx-l/desk-mx8-mkimage$ 

For MITO M8M Mini SOM:

./imx8mm-mito8mmini_generate_flash.bin