Open main menu

DAVE Developer's Wiki β

Changes

DESK-MX8M-L/Development/Building Boot Image

7,526 bytes added, 17 January
no edit summary
!colspan="4" style="width:100%; text-align:left"; border-bottom:solid 2px #ededed"|History
|-
!style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#73B2C7; padding:5px; color:white"|Version
!style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#73B2C7; padding:5px; color:white"|Issue Date
!style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#73B2C7; padding:5px; color:white"|Notes
|-
|style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#edf8fb; padding:5px; color:#000000"|1{{oldid|16142|2022/02/18}}|style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#edf8fb; padding:5px; color:#000000"|First DESK-MX8M-L release|-| style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#ededed; padding:5px; color:#000000" |{{oldid|17540|2023/02/24}}| style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#ededed; padding:5px; color:#000000" |DESK-MX8M-L-2.0.0release|-! style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#edf8fbededed; padding:5px; color:#000000"|Jan 20222023/08/22|! style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#edf8fbededed; padding:5px; color:#000000"|First DESK-MX8M -L-4.0.0 release
|-
|}
==Building Boot Image==
 
{{ImportantMessage|text=The following procedure may be used just during the development stage (as an example, for modifying and testing just some part of the overall binary like u-boot).
 
The Yocto build should be used for creating the deployment or production binary artifacts.}}
===Quick reference===
|-
! stable branch
| desk-mx8m-l-rel-24.0x.0x
|-
! stable tag
| desk-mx8m-l-24.0.0-rc2
|}
=== Instructions = i.MX8 Boot Image====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 <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. === Prepare environment ===
It is assumed that the development environment has been set up properly as described [[DESK-MX8M-L#Quick_start_guide|here]].
* start the Linux development VM and login into the system
* open a terminal window and ''cd'' into <code>desk-mx8-mkimage</code> directory <pre class="workstation-terminal">dvdk@vagrant:~$ cd desk-mx-l/desk-mx8-mkimagedvdk@vagrant:~/desk-mx-l/desk-mx8-mkimage$</pre> * in case of needs you can update your local repository with the following git command <pre class="workstation-terminal">dvdk@vagrant:~/desk-mx-l/desk-mx8-mkimage$ git pull</pre> * configure the build environment <pre class="workstation-terminal">dvdk@vagrant:~/desk-mx-l/desk-mx8-mkimage$ source ~/desk-mx-l/desk-mx8m-l-4.0.0_env.sh </pre> === Build U-Boot === First step is to build U-Boot binaries: the same instructions can be found in the dedicated [[DESK-MX8M-L/Development/Building_U-Boot | wiki page]] <pre class="workstation-terminal">dvdk@vagrant:~$ cd ~/desk-mx-l/desk-mx8-mkimage/u-boot-imx/dvdk@vagrant:~/desk-mx-l/desk-mx8-mkimage/u-boot-imx$</pre> * select the proper <code> directorydefconfig</code> and start the ''make'' compilation For [[ORCA SOM| ORCA]] SOM:<pre class="workstation-terminal">dvdk@vagrant:~/desk-mx-l/desk-mx8-mkimage/u-boot-imx$ make imx8mp_mito8mplus_defconfigdvdk@vagrant:~/desk-mx-l/desk-mx8-mkimage/u-boot-imx$ make -j$(nproc)</pre>
For [[MITO 8M Mini SOM| MITO 8M Mini]] SOM:
<pre class="workstation-terminal">
cd dvdk@vagrant:~/desk-mx-l/desk-mx8-mkimage/u-boot-imx$ make imx8mm_mito8mmini_defconfigdvdk@vagrant:~/desk-mx-l/desk-mx8-mkimage/u-boot-imx$ make -j$(nproc)
</pre>
* clone 'recursively This steps produce the Boot repositories<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>
 
=== Build ATF ===
This process builds the ARM Trusted Firmware: please find more information [https://trustedfirmware-a.readthedocs.io/en/v2.2/plat/imx8.html here]
 
<pre class="workstation-terminal">
dvdk@vagrant:~$ cd ~/desk-mx-l/desk-mx8-mkimage/imx-atf/
dvdk@vagrant:~/desk-mx-l/desk-mx8-mkimage/imx-atf$
</pre>
 
* for building the ATF, the following var has to be ''unset''
<pre class="workstation-terminal">
dvdk@vagrant:~/desk-mx-l/desk-mx8-mkimage/imx-atf$ unset LDFLAGS
</pre>
 
Then, build the TF-A binary for the selected platform.
 
For [[ORCA SOM| ORCA]] SOM:
<pre class="workstation-terminal">
dvdk@vagrant:~/desk-mx-l/desk-mx8-mkimage/imx-atf$ make PLAT=imx8mp bl31
</pre>
 
For [[MITO 8M Mini SOM| MITO 8M Mini]] SOM:
<pre class="workstation-terminal">
dvdk@vagrant:~/desk-mx-l/desk-mx8-mkimage/imx-atf$ make PLAT=imx8mm bl31
</pre>
 
=== Get i.MX firmware ===
This will download the binary archive, accept EULA automatically (you must agree with that) and extract the archive itself
 
<pre class="workstation-terminal">
dvdk@vagrant:~$ cd ~/desk-mx-l/desk-mx8-mkimage/
dvdk@vagrant:~/desk-mx-l/desk-mx8-mkimage$ ./fetch_firmware.sh
--2023-07-24 15:25:21-- https://www.nxp.com/lgfiles/NMG/MAD/YOCTO/firmware-imx-8.18.bin
Resolving www.nxp.com (www.nxp.com)... 104.87.170.182
Connecting to www.nxp.com (www.nxp.com)|104.87.170.182|:443... connected.
HTTP request sent, awaiting response... 200 OK
Length: 1513050 (1.4M) [application/octet-stream]
Saving to: ‘firmware-imx-8.18.bin’
 
firmware-imx-8.18.bin 100%[=========================================================================================================================================>] 1.44M --.-KB/s in 0.05s
 
2023-07-24 15:25:21 (31.1 MB/s) - ‘firmware-imx-8.18.bin’ saved [1513050/1513050]
 
Welcome to NXP firmware-imx-8.18.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$
</pre>
 
=== Generate Boot image ===
After building all pieces of software, create the <code>flash.bin</code> boot Image running:
 
<pre class="workstation-terminal">
./${BOARD}_generate_flash.bin
</pre>
 
where BOARD is: <code>imx8mp-mito8mplus</code> or <code>imx8mm-mito8mmini</code>
 
For [[ORCA SOM | ORCA]] SOM:
<pre class="workstation-terminal">
dvdk@vagrant:~$ cd ~/desk-mx-l/desk-mx8-mkimage/
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$
</pre>
 
For [[MITO 8M Mini SOM | MITO M8M Mini]] SOM:
<pre>
git clone --recursive git@git.dave.eu:desk-mx-l/desk-mx8imx8mm-mkimagemito8mmini_generate_flash.gitbin
</pre>
* checkout Binary files can be copied to the required branchtftp root directory <code>/tftpboot/desk-mx-l/</code> with the following command: 
<pre class="workstation-terminal">
git checkout dvdk@vagrant:~/desk-mx-l/desk-mx8-mkimage$ cp flash.bin /tftpboot/desk-mx8m-l/desk-relmx8m-2l-4.0.0 -rc2_imx8mp_flash.bin
</pre>
* configure the build environmentFor [[ORCA SOM| ORCA]] SOM:<pre class="workstation-terminal">dvdk@vagrant:~/desk-mx-l/desk-mx8-mkimage$ cp flash.bin /tftpboot/desk-mx8m-l/desk-mx8m-l-4.0.0_imx8mp_flash.bin</pre>
For [[MITO 8M Mini SOM| MITO 8M Mini]] SOM:
<pre class="workstation-terminal">
source dvdk@vagrant:~/desk-mx-l/homedesk-mx8-mkimage$ cp flash.bin /dvdktftpboot/desk-mxmx8m-l/desk-mx8m-l-24.0.0-rc2_env0_imx8mm_flash.shbin
</pre>
 
Please refer to [[DESK-MX8M-L/Deployment/Standalone_boot|this page]] for more information on how to update the bootloader on your board.
 
<section end=Body/>
----
[[Category:ORCA]] [[Category:MITO 8M Mini]]
8,256
edits