Difference between revisions of "Getting started/STM32MP1 boards/STM32MP157x-DK2/Develop on Arm® Cortex®-A7/Install the SDK"

[quality revision] [unchecked revision]
Develop on Arm® Cortex®-A7 Develop on Arm® Cortex®-M4
Step category in.png Install the SDK Step.png Create a simple hello-world application Step.png Modify, rebuild and reload the Linux® kernel Step category out.png

1 Overview[edit]

This stage explains how to install the SDK.
The SDK for OpenSTLinux distribution provides a standalone cross-development toolchain and libraries tailored to the contents of the specific image flashed onto the board.

2 Host computer configuration[edit]

2.1 Install extra packages[edit]

Additional Ubuntu packages must be installed to perform basic development tasks, basic cross-compilation (via Developer Package) or more complex cross-compilation such as OpenEmbedded does (via Distribution Package):

 sudo apt-get update
 sudo apt-get install gawk wget git diffstat unzip texinfo gcc build-essential chrpath socat cpio python3 python3-pip python3-pexpect xz-utils debianutils iputils-ping python3-git python3-jinja2 libegl1-mesa libsdl1.2-dev pylint3 xterm python3-subunit mesa-common-dev zstd liblz4-tool
 sudo apt-get install make xsltproc docbook-utils fop dblatex xmlto
 sudo apt-get install libmpc-dev libgmp-dev
  • Packages needed for some "Developer Package" use cases:
 sudo apt-get install build-essential libncurses-dev libyaml-dev libssl-dev 
  • Package for repo (used to download the "Distribution Package" source code):
Please follow the installation instructions described in repo.
 For Ubuntu 20.04, first set python3 as default:  sudo apt install python-is-python3

  • Useful tools:
 sudo apt-get install coreutils bsdmainutils sed curl bc lrzsz corkscrew cvs subversion mercurial nfs-common nfs-kernel-server libarchive-zip-perl dos2unix texi2html diffstat libxml2-utils

2.2 Additional configurations[edit]

Additional configurations have to be installed to support up to 16 partitions per MMC. By default, on Linux® systems, a maximum of 8 partitions are allowed on MMC. All Packages (Starter Package, ...) need more than 10 partitions for the storage device. In order to extend the number of partitions per device to 16, the following options must be added to modprobe:

 echo 'options mmc_block perdev_minors=16' > /tmp/mmc_block.conf
 sudo mv /tmp/mmc_block.conf /etc/modprobe.d/mmc_block.conf

3 Download the SDK[edit]

The software package is provided AS IS, and by downloading it, you agree to be bound to the terms of the software license agreement (SLA). The detailed content licenses can be found here.

Warning white.png Warning
To download a package, it is recommended to be logged in to your "myst" account [1]. If, trying to download, you encounter a “403 error”, you could try to empty your browser cache to workaround the problem. We are working on the resolution of this problem.
We apologize for this inconvenience
  • Download the Developer Package SDK into the following directory: $HOME/STM32MPU_workspace/tmp
  • Uncompress the tarball file to get the SDK installation script
 cd $HOME/STM32MPU_workspace/tmp
 tar xvf SDK-x86_64-stm32mp1-openstlinux-5.15-yocto-kirkstone-mp1-v22.06.15.tar.xz

4 Run the SDK installation script[edit]

  • Create your STM32MP1 Developer Package SDK directory on your host computer
 mkdir -p $HOME/STM32MPU_workspace/STM32MP1-Ecosystem-v4.0.0/Developer-Package/SDK
  • Change the permissions of the SDK installation script so that it is executable
 chmod +x stm32mp1-openstlinux-5.15-yocto-kirkstone-mp1-v22.06.15/sdk/st-image-weston-openstlinux-weston-stm32mp1-x86_64-toolchain-4.0.1-openstlinux-5.15-yocto-kirkstone-mp1-v22.06.15.sh
  • Execute the SDK installation script
 ./stm32mp1-openstlinux-5.15-yocto-kirkstone-mp1-v22.06.15/sdk/st-image-weston-openstlinux-weston-stm32mp1-x86_64-toolchain-4.0.1-openstlinux-5.15-yocto-kirkstone-mp1-v22.06.15.sh -d <working directory absolute path>/Developer-Package/SDK
  • The following log is output when the installation is successful:
ST OpenSTLinux - Weston - (A Yocto Project Based Distro) SDK installer version 4.0.1-openstlinux-5.15-yocto-kirkstone-mp1-v22.06.15
You are about to install the SDK to "/home/osboxes/STM32MPU_workspace/STM32MP1-Ecosystem-v4.0.0/Developer-Package/SDK". Proceed [Y/n]? Y
Extracting SDK............................................................................................................................................................................................................................done
Setting it up...done
SDK has been successfully set up and is ready to be used.
Each time you wish to use the SDK in a new shell session, you need to source the environment setup script e.g.
 $ . /home/osboxes/STM32MPU_workspace/STM32MP1-Ecosystem-v4.0.0/Developer-Package/SDK/environment-setup-cortexa7t2hf-neon-vfpv4-ostl-linux-gnueabi

5 Start the SDK up[edit]

Info white.png Information
The SDK environment setup script must be run once on each new working terminal on which you cross-compile
 cd $HOME/STM32MPU_workspace/STM32MP1-Ecosystem-v4.0.0/Developer-Package 
 source SDK/environment-setup-cortexa7t2hf-neon-vfpv4-ostl-linux-gnueabi

The following checks ensure that the environment is correctly set up:

  • Check the target architecture
 echo $ARCH
  • Check the toolchain binary prefix for the target tools

  • Check the C compiler version
 $CC --version
arm-ostl-linux-gnueabi-gcc (GCC) 11.2.0
Copyright (C) 2021 Free Software Foundation, Inc.
This is free software; see the source for copying conditions.  There is NO
  • Check that the SDK version is the expected one (e.g.)

If any of these commands fails or does not return the expected result, try to reinstall the SDK.

Back button.png Overview button.png Next button.png

<bookshelf src="Book:Getting started" />

{| class="st-table" style="text-align:center; margin: auto"
| colspan="7" style="border-style: hidden;" | [[Image:STM32MP157X-DK2.png‎ | 80px | link=]]
| colspan="4" style="border-style: hidden; text-align:left;" | [[Getting started/STM32MP1 boards/STM32MP157x-DK2/Develop on Arm® Cortex®-A7 | {{GSModuleCurrent|Develop on Arm® Cortex®-A7}}]]
| colspan="3" style="border-style: hidden; text-align:right;" | [[Getting started/STM32MP1 boards/STM32MP157x-DK2/Develop on Arm® Cortex®-M4 | {{GSModuleNext|Develop on Arm® Cortex®-M4}}]]
| style="border-style: hidden;" | [[Image:step_category_in.png|link=]]
| style="border-style: hidden; width:150px;" | [[Getting started/STM32MP1 boards/STM32MP157x-DK2/Develop on Arm® Cortex®-A7/Install the SDK |{{GSStepCurrent|Install the SDK}}]]
| style="border-style: hidden;" | [[Image:step.png|link=]]
| style="border-style: hidden; width:150px;" | [[Getting started/STM32MP1 boards/STM32MP157x-DK2/Develop on Arm® Cortex®-A7/Create a simple hello-world application | {{GSStepNext|Create a simple hello-world application}}]]
| style="border-style: hidden;" | [[Image:step.png|link=]]
| style="border-style: hidden; width:150px;" | [[Getting started/STM32MP1 boards/STM32MP157x-DK2/Develop on Arm® Cortex®-A7/Modify, rebuild and reload the Linux® kernel | {{GSStepNext|Modify, rebuild and reload the Linux® kernel}}]]
| style="border-style: hidden;" | [[Image:step_category_out.png|link=]]

{{:Install the SDK}}

{| class="st-table" style="margin: auto"
| style="border-style: hidden; width:120px; text-align:left" | [[Image:back_button.png|link=Getting started/STM32MP1 boards/STM32MP157x-DK2/Develop on Arm® Cortex®-A7]]
| style="border-style: hidden; width:360px; text-align:center" | [[Image:overview_button.png|link=Getting started/STM32MP1 boards/STM32MP157x-DK2]]
| style="border-style: hidden; width:120px; text-align:right" | [[Image:next_button.png|link=Getting started/STM32MP1 boards/STM32MP157x-DK2/Develop on Arm® Cortex®-A7/Create a simple hello-world application]]

[[Category:STM32MP157x-DK2 - develop on A7 | 01]]
{{PublicationRequestId | Auto19653| 2021-04-19}}</noinclude>
Line 29: Line 29:
[[Category:STM32MP157x-DK2 - develop on A7 | 01]]
[[Category:STM32MP157x-DK2 - develop on A7 | 01]]
{{PublicationRequestId | Auto}}
{{PublicationRequestId | 19653| 2021-04-19}}