View source for OpenSTLinux for VisionSOM-STM32MP1

{{PageHeader|Yocto Dunfell OpenSTLinux for VisionSOM-STM32MP1}} __toc__

= Pre-built images =

There are couple of pre-built images available for VisionSOM-STM32MP1 module and VisionCB-STD-STM32MP1 board. 

* DSI ph720128t003 display and eMMC memory [http://ftp.somlabs.com/VisionSOM-STM32MP1/stm32mp157a-visionsom-dsi-emmc-mx_2021_04.zip stm32mp157a-visionsom-dsi-emmc-mx_2021_04]
* DSI ph720128t003 display and SD card [http://ftp.somlabs.com/VisionSOM-STM32MP1/stm32mp157a-visionsom-dsi-sd-mx_2021_04.zip stm32mp157a-visionsom-dsi-sd-mx_2021_04]
* RGB display and eMMC memory [http://ftp.somlabs.com/VisionSOM-STM32MP1/stm32mp157a-visionsom-rgb-emmc-mx_2021_04.zip stm32mp157a-visionsom-rgb-emmc-mx_2021_04]
* RGB display and SD card [http://ftp.somlabs.com/VisionSOM-STM32MP1/stm32mp157a-visionsom-rgb-sd-mx_2021_04.zip stm32mp157a-visionsom-rgb-sd-mx_2021_04]
* DSI/HDMI converter and eMMC memory [http://ftp.somlabs.com/VisionSOM-STM32MP1/stm32mp157a-visionsom-hdmi-emmc-mx_2021_04.zip stm32mp157a-visionsom-hdmi-emmc-mx_2021_04]
* DSI/HDMI converter and SD card [http://ftp.somlabs.com/VisionSOM-STM32MP1/stm32mp157a-visionsom-hdmi-sd-mx_2021_04.zip stm32mp157a-visionsom-hdmi-sd-mx_2021_04]

== Changelog == 
*openst-meta-somlabs 2021_04
**Updated to STM32MP15-Ecosystem-v3.0.0
**Added config for DS/HDMI LT8912 converter
*openst-meta-somlabs 2020_12
**Updated to STM32MP15-Ecosystem-v2.1.0
*openst-meta-somlabs 2020_11
**Updated OpenSTLinux to dunfell version
**Added SoMLabs u-boot and kernel repositories
**Added demo application sources
**Disabled demo autostart
*openst-meta-somlabs 04_2020
**Added support for the openstlinux-4.19-thud-mp1-20-02-19
**Enabled the second SD-card (on the VisionCB-STD-STM32MP1 board) as an external storage
**Fixed the display transition between u-boot and Linux kernel
**Added support for Riverdi rvt70hsmnwc00 DSI display

== Old versions ==

*openst-meta-somlabs 2020_12
**DSI display and eMMC memory [http://ftp.somlabs.com/VisionSOM-STM32MP1/stm32mp157a-visionsom-dsi-emmc-mx_2020_12.zip stm32mp157a-visionsom-dsi-emmc-mx_2020_12]
**DSI display and SD card [http://ftp.somlabs.com/VisionSOM-STM32MP1/stm32mp157a-visionsom-dsi-sd-mx_2020_12.zip stm32mp157a-visionsom-dsi-sd-mx_2020_12]
**RGB display and eMMC memory [http://ftp.somlabs.com/VisionSOM-STM32MP1/stm32mp157a-visionsom-rgb-emmc-mx_2020_12.zip stm32mp157a-visionsom-rgb-emmc-mx_2020_12]
**RGB display and SD card [http://ftp.somlabs.com/VisionSOM-STM32MP1/stm32mp157a-visionsom-rgb-sd-mx_2020_12.zip stm32mp157a-visionsom-rgb-sd-mx_2020_12]
*openst-meta-somlabs 2020_11
**DSI display and eMMC memory [http://ftp.somlabs.com/VisionSOM-STM32MP1/stm32mp157a-visionsom-dsi-emmc-mx_2020_11.zip stm32mp157a-visionsom-dsi-emmc-mx_2020_11]
**DSI display and SD card [http://ftp.somlabs.com/VisionSOM-STM32MP1/stm32mp157a-visionsom-dsi-sd-mx_2020_11.zip stm32mp157a-visionsom-dsi-sd-mx_2020_11]
**RGB display and eMMC memory [http://ftp.somlabs.com/VisionSOM-STM32MP1/stm32mp157a-visionsom-rgb-emmc-mx_2020_11.zip stm32mp157a-visionsom-rgb-emmc-mx_2020_11]
**RGB display and SD card [http://ftp.somlabs.com/VisionSOM-STM32MP1/stm32mp157a-visionsom-rgb-sd-mx_2020_11.zip stm32mp157a-visionsom-rgb-sd-mx_2020_11]
*openst-meta-somlabs 04_2020
**RGB display with SoMLabs demo application [http://ftp.somlabs.com/VisionSOM-STM32MP1/flashlayout_st-image-weston_FlashLayout_sdcard_stm32mp157a-visionsom-mx-basic_04_2020.zip flashlayout_st-image-weston_FlashLayout_sdcard_stm32mp157a-visionsom-mx-basic_04_2020.zip]
**RGB display without SoMLabs demo application [http://ftp.somlabs.com/VisionSOM-STM32MP1/flashlayout_st-image-weston_FlashLayout_sdcard_stm32mp157a-visionsom-mx-basic_no_demo_04_2020.zip flashlayout_st-image-weston_FlashLayout_sdcard_stm32mp157a-visionsom-mx-basic_no_demo_04_2020.zip]
**DSI display with SoMLabs demo application [http://ftp.somlabs.com/VisionSOM-STM32MP1/flashlayout_st-image-weston_FlashLayout_sdcard_stm32mp157a-visionsom-mx-dsi-basic_04_2020.zip flashlayout_st-image-weston_FlashLayout_sdcard_stm32mp157a-visionsom-mx-dsi-basic_04_2020.zip]
**DSI display without SoMLabs demo application [http://ftp.somlabs.com/VisionSOM-STM32MP1/flashlayout_st-image-weston_FlashLayout_sdcard_stm32mp157a-visionsom-mx-dsi-basic_no_demo_04_2020.zip flashlayout_st-image-weston_FlashLayout_sdcard_stm32mp157a-visionsom-mx-dsi-basic_no_demo_04_2020.zip]
*openst-meta-somlabs 03_2020
**RGB display with SoMLabs demo application [http://ftp.somlabs.com/VisionSOM-STM32MP1/flashlayout_st-image-weston_FlashLayout_sdcard_stm32mp157a-visionsom-mx-basic_03_2020.zip flashlayout_st-image-weston_FlashLayout_sdcard_stm32mp157a-visionsom-mx-basic_03_2020.zip]
**RGB display without SoMLabs demo application [http://ftp.somlabs.com/VisionSOM-STM32MP1/flashlayout_st-image-weston_FlashLayout_sdcard_stm32mp157a-visionsom-mx-basic_no_demo_03_2020.zip flashlayout_st-image-weston_FlashLayout_sdcard_stm32mp157a-visionsom-mx-basic_no_demo_03_2020.zip]
**DSI display with SoMLabs demo application [http://ftp.somlabs.com/VisionSOM-STM32MP1/flashlayout_st-image-weston_FlashLayout_sdcard_stm32mp157a-visionsom-mx-dsi-basic_03_2020.zip flashlayout_st-image-weston_FlashLayout_sdcard_stm32mp157a-visionsom-mx-dsi-basic_03_2020.zip]
**DSI display without SoMLabs demo application [http://ftp.somlabs.com/VisionSOM-STM32MP1/flashlayout_st-image-weston_FlashLayout_sdcard_stm32mp157a-visionsom-mx-dsi-basic_no_demo_03_2020.zip flashlayout_st-image-weston_FlashLayout_sdcard_stm32mp157a-visionsom-mx-dsi-basic_no_demo_03_2020.zip]

= Building own image =

VisionSOM-STM32MP1 module is supported by Yocto meta-layer available on SoMLabs github:

https://github.com/SoMLabs/openst-meta-somlabs

The described layer shall be used with the OpenSTLinux Distribution Package provided by the STMicroelectronics:

https://wiki.st.com/stm32mpu/wiki/STM32MP1_Distribution_Package

It provides the support for VisionSOM-STM32MP1 module and VisionCB-STD-STM32MP1 board and is intended for build with the ''st-image-weston'' system image. 

== Host PC requirements ==

This tutorial was tested on the Xubuntu 18.04 LTS system. The distribution and SDK building requires significant amount of memory, disk space and time. The following hardware configuration was used for compilation:
* Intel Core i7-4510U
* 8GB RAM
* 256GB SSD Disk (30GB required for system build and another 30GB for SDK)

The OpenSTLinux compilation time takes about 8 hours. The SDK building requires another 8 hours when building with the already compiled system.

The PC requirements suggested by the STMicroelectronics may be found here:

https://wiki.st.com/stm32mpu/wiki/PC_prerequisites

The host system needs also the following packages to be installed:

<pre>
sudo apt-get update
sudo apt-get install gawk wget git-core diffstat unzip texinfo gcc-multilib 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 pylint xterm
sudo apt-get install make xsltproc docbook-utils fop dblatex xmlto
sudo apt-get install libmpc-dev libgmp-dev
sudo apt-get install python-git
sudo apt-get install repo
</pre>

== Obtaining the Yocto recipes ==

The following steps are the summary of the image building description that can be found on the ST wiki pages with the additional SoMLabs meta-layer.

First let's clone all of the repositories containing the required packages and system distribution:

<pre>
cd <working directory path>/Distribution-Package
mkdir openstlinux-5.10-dunfell-mp1-21-03-31
cd openstlinux-5.10-dunfell-mp1-21-03-31
repo init -u https://github.com/STMicroelectronics/oe-manifest.git -b refs/tags/openstlinux-5.10-dunfell-mp1-21-03-31
repo sync
cd layers/meta-st
git clone -b dunfell https://github.com/SoMLabs/openst-meta-somlabs.git meta-somlabs
cd ../../
</pre>

The last ''git clone'' instruction downloads the meta layer with VisionSOM-STM32MP1 module support. 

== Bulding the system image ==

The following commands generate the OpenSTLinux weston image that can be run on VisionSOM-STM32MP1 module and VisionCB-STD-STM32MP1 board:

<pre>
DISTRO=openstlinux-weston MACHINE=<MACHINE_NAME> source layers/meta-st/scripts/envsetup.sh
bitbake st-image-weston
</pre>

The following VisionSOM machines are available:

* stm32mp157a-visionsom-rgb-emmc-mx Module with eMMC memory and RGB display connected
* stm32mp157a-visionsom-rgb-sd-mx Module with SD card and RGB display connected
* stm32mp157a-visionsom-dsi-ph720128t003-emmc-mx Module with eMMC memory and ph720128t003 DSI display connected
* stm32mp157a-visionsom-dsi-rvt70hsmnwc00-emmc-mx Module with eMMC memory and rvt70hsmnwc00 DSI display connected
* stm32mp157a-visionsom-dsi-sd-mx Module with SD card and DSI display connected
* stm32mp157a-visionsom-hdmi-emmc-mx Module with eMMC memory and DSI/HDMI LT8912 converter connected
* stm32mp157a-visionsom-hdmi-sd-mx Module with SD card and DSI/HDMI LT8912 converter connected

The compiled image files are located in the directory:

openstlinux-5.10-dunfell-mp1-21-03-31/build-openstlinuxweston-<MACHINE_NAME>/tmp-glibc/deploy/images/<MACHINE_NAME>

In order to prepare the SD card system file the following command is required:

<pre>
cd tmp-glibc/deploy/images/<MACHINE_NAME>
./create_sdcard_from_flashlayout.sh ../flashlayout_st-image-weston/trusted/FlashLayout_sdcard_<MACHINE_NAME>-trusted.tsv
</pre>

== Building the SDK ==

In order to build the cross-compiler and required libraries for software development on the host machine we need to build the SDK. After building the system image as described in the previous chapters we can simply call another bitbake command:

<pre>
bitbake st-image-weston -c populate_sdk
</pre>

It will create the SDK installer ''st-image-weston-openstlinux-weston-stm32mp157a-visionsom-mx-x86_64-toolchain-2.6-snapshot.sh'' or ''st-image-weston-openstlinux-weston-stm32mp157a-visionsom-dsi-mx-x86_64-toolchain-2.6-snapshot.sh'' that is located in the ''tmp-glibc/deploy/sdk'' directory. The installation script should be run on the host machine to install the development toolchain.

= Installing images =

The following articles explain the image installation on the VisionSOM-STM32MP1 modules:
* SD card [[Installing OpenSTLinux on VisionSOM-STM32MP1 with SD card]]
* eMMC [[Installing OpenSTLinux on VisionSOM-STM32MP1 with eMMC memory]]