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

[quality revision] [quality revision]
m
m
 
STM32MP157C-EV1.png
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 stand-alone cross-development toolchain and libraries tailored to the contents of the specific image flashed in the board.

2 Host computer configuration[edit]

2.1 Install extra package[edit]

In order to do basic development tasks or basic cross-compilation, some extra Ubuntu packages should be installed:

PC $> sudo apt-get update
PC $> 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
PC $> sudo apt-get install libsdl1.2-dev xterm corkscrew nfs-common nfs-kernel-server device-tree-compiler mercurial u-boot-tools libarchive-zip-perl
PC $> sudo apt-get install ncurses-dev bc linux-headers-generic gcc-multilib libncurses5-dev libncursesw5-dev lrzsz dos2unix lib32ncurses5 repo libssl-dev libyaml-dev
PC $> sudo apt-get install default-jre

2.2 Additionnal configurations[edit]

  • Allow up to 16 partitions per mmc

By default, on Linux system, a maximum of 8 partitions are allowed on mmc. All Packages (Starter Package, ...) need more than 10 partitons for the storage device. In order to extend the number of partitions per device to 16, the following options must be added to modprobe:

PC $> echo 'options mmc_block perdev_minors=16' > /tmp/mmc_block.conf
PC $> 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.png 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
3.1 For ecosystem release v2.0.0 More info.png[edit]
  • Download the Developer Package SDK into the following directory: $HOME/STM32MPU_workspace/tmp
  • Uncompress the tarball file to get the SDK installation script
PC $> cd $HOME/STM32MPU_workspace/tmp
PC $> tar xvf en.SDK-x86_64-stm32mp1-openstlinux-5.4-dunfell-mp1-20-06-24.tar.xz

4 Run the SDK installation script[edit]

4.1 For ecosystem release v2.0.0 More info.png[edit]
  • Create your STM32MP15 Developer Package SDK directory on your host computer
PC $> mkdir -p $HOME/STM32MPU_workspace/STM32MP15-Ecosystem-v2.0.0/Developer-Package/SDK
  • Change the permissions of the SDK installation script so that it is executable
PC $> chmod +x stm32mp1-openstlinux-5.4-dunfell-mp1-20-06-24/sdk/st-image-weston-openstlinux-weston-stm32mp1-x86_64-toolchain-3.1-openstlinux-5.4-dunfell-mp1-20-06-24.sh
  • Execute the SDK installation script
PC $> ./stm32mp1-openstlinux-5.4-dunfell-mp1-20-06-24/sdk/st-image-weston-openstlinux-weston-stm32mp1-x86_64-toolchain-3.1-openstlinux-5.4-dunfell-mp1-20-06-24.sh -d <working directory absolute path>/Developer-Package/SDK
  • A successful installation outputs the following log:
ST OpenSTLinux - Weston - (A Yocto Project Based Distro) SDK installer version 3.1-openstlinux-5.4-dunfell-mp1-20-06-24
=======================================================================================================================
You are about to install the SDK to "/home/osboxes/MCD/V2.0/Developper-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.
 $ . /<working directory absolute path>/STM32MPU_workspace/STM32MP15-Ecosystem-v2.0.0/Developer-Package/SDK/environment-setup-cortexa7t2hf-neon-vfpv4-ostl-linux-gnueabi

5 Starting up the SDK[edit]

Info.png The SDK environment setup script must be run once in each new working terminal in which you cross-compile

For ecosystem release v2.0.0 More info.png

PC $> cd $HOME/STM32MPU_workspace/STM32MP15-Ecosystem-v2.0.0/Developer-Package 
PC $> source SDK/environment-setup-cortexa7t2hf-neon-vfpv4-ostl-linux-gnueabi

The following checkings allow to ensure that the environment is correctly setup:

  • Check the target architecture
PC $> echo $ARCH
arm
  • Check the toolchain binary prefix for the target tools
PC $> echo $CROSS_COMPILE
arm-ostl-linux-gnueabi- /* For ecosystem release  v2.0.0 More info.png  */

  • Check the C compiler version
PC $> $CC --version
arm-ostl-linux-gnueabi-gcc (GCC) 9.3.0  /* For ecosystem release  v2.0.0 More info.png  */
Copyright (C) 2019 Free Software Foundation, Inc.
This is free software; see the source for copying conditions.  There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
  • Check that the SDK version is the expected one
PC $> echo $OECORE_SDK_VERSION
3.1-openstlinux-5.4-dunfell-mp1-20-06-24 /* For ecosystem release  v2.0.0 More info.png  */


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



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


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

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


{{:Install the SDK}}
<br>

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

{{DISPLAYTITLE:{{SUBPAGENAME}}}}
__NOTOC__
[[Category:STM32MP157x-EV1 - develop on A7 | 01]]
{{PublicationRequestId | Auto}}</noinclude>
Line 1: Line 1:
 
<bookshelf src="Book:Getting started" />
 
<bookshelf src="Book:Getting started" />
{| class="contenttable" style="margin: auto"
+
{| class="st-table" style="text-align:center; margin: auto"
| colspan="7" style="text-align:center; border-color: white; background-color: white" | [[Image:STM32MP157C-EV1.png‎ | 65px | link=]]
+
| colspan="7" style="border-style: hidden;" | [[Image:STM32MP157C-EV1.png‎ | 65px | link=]]
 
|-
 
|-
| colspan="4" style="text-align:left; border-color: white; background-color: white" | [[Getting started/STM32MP1 boards/STM32MP157x-EV1/Develop on Arm® Cortex®-A7 | {{GSModuleCurrent|Develop on Arm® Cortex®-A7}}]]
+
| colspan="4" style="border-style: hidden; text-align:left;" | [[Getting started/STM32MP1 boards/STM32MP157x-EV1/Develop on Arm® Cortex®-A7 | {{GSModuleCurrent|Develop on Arm® Cortex®-A7}}]]
| colspan="3" style="text-align:right; border-color: white; background-color: white" | [[Getting started/STM32MP1 boards/STM32MP157x-EV1/Develop on Arm® Cortex®-M4 | {{GSModuleNext|Develop on Arm® Cortex®-M4}}]]
+
| colspan="3" style="border-style: hidden; text-align:right;" | [[Getting started/STM32MP1 boards/STM32MP157x-EV1/Develop on Arm® Cortex®-M4 | {{GSModuleNext|Develop on Arm® Cortex®-M4}}]]
 
|-
 
|-
| style="border-color: white; background-color: white" | [[Image:step_category_in.png|link=]]
+
| style="border-style: hidden;" | [[Image:step_category_in.png|link=]]
| style="width:150px; text-align:center; border-color: white; background-color: white" | [[Getting started/STM32MP1 boards/STM32MP157x-EV1/Develop on Arm® Cortex®-A7/Install the SDK | {{GSStepCurrent|Install the SDK}}]]
+
| style="border-style: hidden; width:150px;" | [[Getting started/STM32MP1 boards/STM32MP157x-EV1/Develop on Arm® Cortex®-A7/Install the SDK | {{GSStepCurrent|Install the SDK}}]]
| style="border-color: white; background-color: white" | [[Image:step.png|link=]]
+
| style="border-style: hidden;" | [[Image:step.png|link=]]
| style="width:150px; margin-top:0px; text-align:center; border-color: white; background-color: white" | [[Getting started/STM32MP1 boards/STM32MP157x-EV1/Develop on Arm® Cortex®-A7/Create a simple hello-world application | {{GSStepNext|Create a simple hello-world application}}]]
+
| style="border-style: hidden; width:150px;" | [[Getting started/STM32MP1 boards/STM32MP157x-EV1/Develop on Arm® Cortex®-A7/Create a simple hello-world application | {{GSStepNext|Create a simple hello-world application}}]]
| style="border-color: white; background-color: white" | [[Image:step.png|link=]]
+
| style="border-style: hidden;" | [[Image:step.png|link=]]
| style="width:150px; text-align:center; border-color: white; background-color: white" | [[Getting started/STM32MP1 boards/STM32MP157x-EV1/Develop on Arm® Cortex®-A7/Modify, rebuild and reload the Linux® kernel | {{GSStepNext|Modify, rebuild and reload the Linux® kernel}}]]
+
| style="border-style: hidden; width:150px;" | [[Getting started/STM32MP1 boards/STM32MP157x-EV1/Develop on Arm® Cortex®-A7/Modify, rebuild and reload the Linux® kernel | {{GSStepNext|Modify, rebuild and reload the Linux® kernel}}]]
| style="border-color: white; background-color: white" | [[Image:step_category_out.png|link=]]
+
| style="border-style: hidden;" | [[Image:step_category_out.png|link=]]
 
|}
 
|}
 
<br>
 
<br>
Line 19: Line 19:
   
 
<br>
 
<br>
{| class="contenttable" style="margin: auto"
+
{| class="st-table" style="margin: auto"
| style="border-color: white; background-color: white; width:120px; text-align:left" | [[Image:back_button.png|link=Getting started/STM32MP1 boards/STM32MP157x-EV1/Develop on Arm® Cortex®-A7]]
+
| style="border-style: hidden; width:120px; text-align:left" | [[Image:back_button.png|link=Getting started/STM32MP1 boards/STM32MP157x-EV1/Develop on Arm® Cortex®-A7]]
| style="border-color: white; background-color: white; width:360px; text-align:center" | [[Image:overview_button.png|link=Getting started/STM32MP1 boards/STM32MP157x-EV1]]
+
| style="border-style: hidden; width:360px; text-align:center" | [[Image:overview_button.png|link=Getting started/STM32MP1 boards/STM32MP157x-EV1]]
| style="border-color: white; background-color: white; width:120px; text-align:right" | [[Image:next_button.png|link=Getting started/STM32MP1 boards/STM32MP157x-EV1/Develop on Arm® Cortex®-A7/Create a simple hello-world application]]
+
| style="border-style: hidden; width:120px; text-align:right" | [[Image:next_button.png|link=Getting started/STM32MP1 boards/STM32MP157x-EV1/Develop on Arm® Cortex®-A7/Create a simple hello-world application]]
 
|}
 
|}