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 Fedora 27 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 2.1.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-5.4-dunfell-mp1-20-11-12 ... [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-3.0.0 https://gitlab.com/emcraft/stm32mp15x/meta-emcraft.git layers/meta-st /meta-emcraft ...

  5. Configure build:
  6. [psl@sergmir openstlinux]$ DISTRO=openstlinux-weston MACHINE=stm32mp1-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.
  7. Run the build:
  8. [psl@sergmir build-openstlinuxweston-stm32mp1-som]$ bitbake emcraft-rootfs NOTE: Started PRServer with DBfile: /mnt/build/STMP1/openstlinux/build- openstlinuxweston-stm32mp1-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 = "1.46.0" BUILD_SYS = "x86_64-linux" NATIVELSBSTRING = "universal" TARGET_SYS = "arm-ostl-linux-gnueabi" MACHINE = "stm32mp1-som" DISTRO = "openstlinux-weston" DISTRO_VERSION = "3.1-snapshot-20210418" TUNE_FEATURES = "arm vfp cortexa7 neon vfpv4 thumb callconvention-hard" TARGET_FPU = "hard" DISTRO_CODENAME = "dunfell" ACCEPT_EULA_stm32mp1-som = "1" GCCVERSION = "9.%" PREFERRED_PROVIDER_virtual/kernel = "linux-stm32mp" meta-emcraft = "stm32mp1-5.4.56-dunfell-2.1.0:d82d0ac205b8d9e 7686de2af4aa3639b13a02c2d" meta-python meta-oe meta-gnome meta-initramfs meta-multimedia meta-networking meta-webserver meta-filesystems meta-perl = "HEAD:144077083457ccb75700777d5e6b1da9aaff01aa" meta-st-stm32mp = "HEAD:955b1d9a5f706013d718687b1afa6e3022c68fac" meta-qt5 = "HEAD:fdd19517e17240b0b61765bd02fc483a1bde986f" meta-st-openstlinux = "HEAD:9160c08dfcd0b7ec0eb8f1fd96672695b09680d5" meta = "HEAD:b39bda4cc62db12c0edfbe489d5a7f5988ede6a9" ...

  9. The build-openstlinux-stm32mp1-som/tmp-glibc/deploy/images/stm32mp1-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:
  10. [psl@sergmir build-openstlinuxweston-stm32mp1-som]$ bitbake emcraft-rootfs -c populate_sdk