{"id":5106,"date":"2019-07-17T08:49:41","date_gmt":"2019-07-17T15:49:41","guid":{"rendered":"https:\/\/visualgdb.com\/w\/?p=5106"},"modified":"2020-08-17T07:00:13","modified_gmt":"2020-08-17T14:00:13","slug":"building-an-openstlinux-sdk-for-stm32mp1-devices","status":"publish","type":"post","link":"https:\/\/visualgdb.com\/tutorials\/linux\/stm32mp1\/sdk\/","title":{"rendered":"Building an OpenSTLinux SDK for STM32MP1 Devices"},"content":{"rendered":"

This tutorial shows how to build an OpenSTLinux SDK for the STM32MP1 devices. The SDK includes the SD card images for common development boards, a cross-toolchain and the headers\/libraries necessary to cross-compile Linux applications that will run on the Cortex-A cores of the STM32MP1 device. We will show how to use the repo<\/strong> and bitbake<\/strong> tools to generate the SDK and how to use it the SDK to compile Linux applications for the STM32MP1 device.<\/p>\n

    \n
  1. The OpenSTLinux build process depends on a large and relatively fragile ecosystem of Linux tools and hence requires using a specific version of Linux to be running on the build machine. The\u00a0openstlinux-4.19-thud-mp1-19-02-20<\/strong> version shown in this tutorial requires the Ubuntu 18.04.2, so we recommend creating a Linux VM based on ubuntu-18.04.2-desktop-amd64.iso<\/a> with at least 80GB of disk space. To speed up the build, ensure the VM has as many CPU cores as your host machine does.<\/li>\n
  2. Connect to your build machine via SSH and run the following command to install the packages required by the OpenSTLinux tools:\n
    sudo apt-get install sed wget curl cvs subversion git-core coreutils unzip texi2html texinfo docbook-utils gawk python-pysqlite2 diffstat help2man make gcc build-essential g++ desktop-file-utils chrpath libxml2-utils xmlto docbook bsdmainutils iputils-ping cpio python-wand python-pycryptopp python-crypto libsdl1.2-dev xterm corkscrew nfs-common nfs-kernel-server device-tree-compiler mercurial u-boot-tools libarchive-zip-perl ncurses-dev bc linux-headers-generic gcc-multilib libncurses5-dev libncursesw5-dev lrzsz dos2unix lib32ncurses5 repo libssl-dev<\/pre>\n
    Then confirm the package installation:\"\"<\/a><\/li>\n
  3. Create a directory for the OpenSTLinux distro you are going to build (e.g. \/opt\/stlinux-weston<\/strong>) and ensure your user account can write to it. Then clone and initialize the OpenSTLinux repository:\n
    sudo mkdir \/opt\/stlinux-weston\r\nsudo chown <username>:<groupname> \/opt\/stlinux-weston\r\ncd \/opt\/sylinux-weston\r\nrepo init -u https:\/\/github.com\/STMicroelectronics\/oe-manifest.git -b refs\/tags\/openstlinux-4.19-thud-mp1-19-02-20 && repo sync<\/pre>\n
    You can safely ignore the 404 errors during the repo initialization as long as the repo sync command completes successfully:\"\"<\/a><\/li>\n
  4. Once the repository is initialized, the repo tool will show the list of available tags:\"\"<\/a><\/li>\n
  5. Now you are almost ready to start building the OpenSTLinux SDK. Run the following command to setup the necessary environment:\n
    DISTRO=openstlinux-weston MACHINE=stm32mp1 source layers\/meta-st\/scripts\/envsetup.sh<\/pre>\n
    Note the image name shown by the envsetup.sh<\/strong> script:\"\"<\/a><\/li>\n
  6. Now it’s time to build the SDK. Run the following command to begin the build:\n
    bitbake st-image-weston<\/pre>\n
    Note that if your VM has insufficient RAM, the build will fail with the following error:<\/p>\n
    ERROR: Worker process (21931) exited unexpectedly (-9), shutting down...<\/pre>\n
    If this happens, try increasing the RAM size of your VM, or decrease the amount of its CPU cores. Otherwise, the build will successfully complete after several hours and may produce a few warnings that can be ignored:\"\"<\/a><\/li>\n
  7. Go to the \/opt\/stlinux-weston\/build-openstlinuxweston-stm32mp1\/tmp-glibc\/deploy\/images\/stm32mp1<\/strong> directory and obtain a list of all files there:\"\"<\/a><\/li>\n
  8. Note that the stm32mp1<\/strong> directory itself contains multiple binary files, while the flashlayout_st-image-weston<\/strong> subdirectory contains text files that describe how the binaries should be mapped to different memories (e.g. partitions on the SD card):\"\"<\/a><\/li>\n
  9. Now we will program the SD card on the board. In this tutorial we are using Windows, so we will copy the entire \/opt\/stlinux-weston\/build-openstlinuxweston-stm32mp1\/tmp-glibc\/deploy\/images\/stm32mp1<\/strong> directory to the Windows side (use SmarTTY<\/a> to handle symlinks automatically).\u00a0 Switch your board into the bootloader mode via the jumpers and connect both power and data USB connectors:\"\"<\/a><\/li>\n
  10. Locate the FLASH layout file that matches your board. It should typically contain the board name and the word “trusted” indicating the trusted bootchain in the name (e.g. FlashLayout_sdcard_stm32mp157c-dk2-trusted.tsv). Then program it using our FLASH Programming tool for STM32WB1 devices<\/a>:\"\"<\/a><\/li>\n
  11. Once the SD card image has been programmed, switch the board back to “boot from SD card” mode and connect the power and the on-board ST-Link:\"\"<\/a><\/li>\n
  12. The on-board ST-Link includes a COM port connected to one of the STM32MP1’s UART ports. Locate it in the Device Manager:\"\"<\/a><\/li>\n
  13. Then connect to the port (use a baud rate of 115200) via a terminal program and reset the board. The board will start up and open a root terminal:\u00a0 \"\"<\/a><\/li>\n
  14. The on-board LCD screen will display a demo application:\"\"<\/a><\/li>\n
  15. Finally, we will build an SDK that allows compiling C\/C++ Linux applications that will run on the STM32MP1 device. Switch back to the build environment (started by running envsetup.sh on the build machine) and run the following command:\n
    bitbake -c populate_sdk st-image-weston<\/pre>\n
    \"\"<\/a><\/li>\n
  16. This command will build an SDK installer (a self-extracting .sh<\/strong> file under the tmp-glibc\/deploy\/sdk directory). Locate the installer script and run it to extract the SDK for the previously built image:\"\"<\/a><\/li>\n
  17. In order to build C\/C++ programs for the board, load the environment from the <sdk location>\/environment-setup-cortexa7t2hf-neon-vfpv4-openstlinux_weston-linux-gnueabi<\/strong> file. This will set the CC,<\/strong> LD<\/strong> and other common environment variables to point to the correct SDK tools including all flags. Then you can simply invoke $CC<\/strong> instead of the regular gcc<\/strong> executable to produce binaries compatible with the STM32MP1 board:\"\"<\/a><\/li>\n<\/ol>\n
     <\/p>\n","protected":false},"excerpt":{"rendered":"
    This tutorial shows how to build an OpenSTLinux SDK for the STM32MP1 devices. The SDK includes the SD card images<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[10],"tags":[186,61,187,185],"_links":{"self":[{"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/posts\/5106"}],"collection":[{"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/comments?post=5106"}],"version-history":[{"count":4,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/posts\/5106\/revisions"}],"predecessor-version":[{"id":5127,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/posts\/5106\/revisions\/5127"}],"wp:attachment":[{"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/media?parent=5106"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/categories?post=5106"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/tags?post=5106"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}