Building Bootable Linux Images Print

 

This application note explains how to build the bootable Linux images for the Emcraft STM32MP1 System-On-Module from the Yocto distribution. The following procedure was explicitly validated on a Ubuntu 20.04 Linux host.

Step through the following procedure:

  1. Prepare the build host, see Linux PC requirements https://wiki.st.com/stm32mpu/wiki/PC_prerequisites#Linux_PC.
  2. Setup OpenSTLinux release 5.0.0 sources: 
    [psl@sergmir openstlinux]$ curl https://storage.googleapis.com/\
git-repo-downloads/repo > repo
[psl@sergmir openstlinux]$ chmod 755 repo
[psl@sergmir openstlinux]$ sudo mv repo /usr/bin
[psl@sergmir openstlinux]$ repo init -u https://github.com/STMicroelectronics
/oe-manifest.git -b refs/tags/openstlinux-6.1-yocto-mickledore-mp1-v23.06.21
...
[psl@sergmir openstlinux]$ repo sync
...
[psl@sergmir openstlinux]$ ls -l
total 4
drwxrwxr-x 7 psl psl 4096 Apr 18 18:37 layers
[psl@sergmir openstlinux]$ ls -l layers/
total 20
drwxrwxr-x 14 psl psl 4096 Apr 18 18:37 meta-openembedded
drwxrwxr-x 12 psl psl 4096 Apr 18 18:37 meta-qt5
drwxrwxr-x  6 psl psl 4096 Apr 18 18:37 meta-st
drwxrwxr-x  6 psl psl 4096 Apr 18 18:37 meta-timesys
drwxrwxr-x  9 psl psl 4096 Apr 18 18:37 openembedded-core
[psl@sergmir openstlinux]$
  3. Clone Emcraft meta layer:
    4. [psl@sergmir openstlinux]$ git clone -b linux-stm32mp1-4.0.0 
https://gitlab.com/emcraft/stm32mp15x/meta-emcraft.git layers/meta-st
/meta-emcraft
...
  4. Configure build:
    5. [psl@sergmir openstlinux]$ DISTRO=openstlinux-weston 
MACHINE=stm32mp15-som source layers/meta-st/scripts/envsetup.sh
...
    The BSP for STM32MP1 depends on packages and firmware which are covered by a software license agreement (SLA). You will be asked to read and to accept this EULA.
  5. Run the build:
    6. [psl@sergmir build-openstlinuxweston-stm32mp15-som]$ bitbake emcraft-rootfs
NOTE: Started PRServer with DBfile: /mnt/build/STMP1/openstlinux/build-
openstlinuxweston-stm32mp15-som/cache/prserv.sqlite3, IP: 127.0.0.1, 
PORT: 46597, PID: 29713
Loading cache: 100% |####################################| Time: 0:00:01
Loaded 3740 entries from dependency cache.
Parsing recipes: 100% |###################################| Time: 0:00:03
Parsing of 2546 .bb files complete (2542 cached, 4 parsed). 3744 targets, 
104 skipped, 0 masked, 0 errors.
NOTE: Resolving any missing task queue dependencies

Build Configuration:
BB_VERSION           = "2.4.0" 
BUILD_SYS            = "x86_64-linux" 
NATIVELSBSTRING      = "universal" 
TARGET_SYS           = "arm-ostl-linux-gnueabi" 
MACHINE              = "stm32mp15-som" 
DISTRO               = "openstlinux-weston" 
DISTRO_VERSION       = "4.2.1-snapshot-20230821" 
TUNE_FEATURES        = "arm vfp cortexa7 neon vfpv4 thumb 
callconvention-hard" 
TARGET_FPU           = "hard" 
DISTRO_CODENAME      = "mickledore" 
ACCEPT_EULA_stm32mp1-som = "1" 
GCCVERSION           = "12.%" 
PREFERRED_PROVIDER_virtual/kernel = "linux-stm32mp" 
meta-emcraft         = "linux-stm32mp1-4.0.0:bc1f71503775a6e37dce78b13e
7107a09ebfa1a7" 
meta-python          
meta-oe              
meta-gnome           
meta-initramfs       
meta-multimedia      
meta-networking      
meta-webserver       
meta-filesystems     
meta-perl            = "HEAD:c032fd0b1a9d444711103c2703dfa8e2964a3865"
meta-st-stm32mp      = "HEAD:931b3f5be2c00f55d114c8f9122082a9d229b776"
meta-qt5             = "HEAD:cf6ffcbad5275a3428f6046468a0c9d572e813d1"
meta-st-openstlinux  = "HEAD:8c780facff81d3c3878c5fdcd18bdd24fc36478d"
meta                 = "HEAD:20cd64812d286c920bd766145ab1cd968e72667e"
...
  6. The build-openstlinux-stm32mp15-som/tmp-glibc/deploy/images/stm32mp15-som directory contains complete file system images ready for flashing. If you are planning development outside of the Yocto build tree (e.g. compiling some application), build the SDK toolchain:
    7. [psl@sergmir build-openstlinuxweston-stm32mp15-som]$ bitbake emcraft-rootfs
 -c populate_sdk