X-LINUX-AI OpenSTLinux Expansion Package

Revision as of 18:30, 10 June 2020 by Registered User (→‎Contents)
AI Expansion Package inserted in the STM32MPU Embedded software distribution


X-LINUX-AI is the STM32 MPU OpenSTLinux Expansion Package that targets artificial intelligence for STM32MP1 Series devices.

This package contains Linux AI frameworks, as well as application examples to get started with some basic use cases such as computer vision (CV).

It is composed of an OpenEmbedded meta layer, named meta-st-stm32mpu-ai, to be added on top of the STM32MP1 Distribution Package.

It brings a complete and coherent easy-to-build / install environment to take advantage of AI on the STM32MP1 Series.


1. Version[edit source]

1.1. v2.0.0[edit source]

Info white.png Information
This version has been validated against the ecosystem release v2.0.0

Validated on STM32MP157x-DKx and STM32MP157x-EV1 boards.

1.1.1. Contents[edit source]

1.1.2. Software structure[edit source]

File:X-LINUX-AI-CV software structure.png
X-LINUX-AI-CV v1.1.0 Expansion Package Software structure

1.1.3. Validated hardware[edit source]

As any software expansion package, the X-LINUX-AI is supported on all STM32MP1 Series and has been validated on the following boards:

  • STM32MP157C-DK2[7]
  • STM32MP157C-EV1[8]
  • STM32MP157A-EV1[9]

1.1.4. Build and flash the X-LINUX-AI expansion package[edit source]

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.

Info white.png Information
The meta-st-stm32mpu-ai layer depends on the meta-clang layer.
  • Clone following git repositories into <Distribution Package installation directory>/layers/meta-st
 cd <Distribution Package installation directory>/layers
 git clone https://github.com/kraj/meta-clang -b thud
 cd <Distribution Package installation directory>/layers/meta-st
 git clone https://github.com/STMicroelectronics/meta-st-stm32mpu-ai.git -b thud
  • Set up the build environment
 cd ../..
 DISTRO=openstlinux-weston MACHINE=stm32mp1 source layers/meta-st/scripts/envsetup.sh
  • Add the new layers in that order
 bitbake-layers add-layer ../layers/meta-clang
 bitbake-layers add-layer ../layers/meta-st/meta-st-stm32mpu-ai
  • Build the image
 bitbake st-image-ai-cv
Info white.png Information
Note that building the image could take more than 3 hours depending on the host computer performance.
  • Flash the built image
Follow this link to know how to flash the built image.

1.2. v1.0.0[edit source]

1.2.1. Contents[edit source]

Info white.png Information
The artificial intelligence expansion package meta-st-stm32mpu-ai has been validated against the ecosystem release v1.0.0

1.2.2. BuilSTM32MP1 DK2 or EV1 boards[edit source]

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.

Info white.png Information
The meta-st-stm32mpu-ai layer depends on the meta-clang layer.
  • Clone following git repositories into <Distribution Package installation directory>/layers/meta-st
 cd <Distribution Package installation directory>/layers
 git clone https://github.com/kraj/meta-clang -b thud
 cd <Distribution Package installation directory>/layers/meta-st
 git clone https://github.com/STMicroelectronics/meta-st-stm32mpu-ai.git -b thud
  • Set up the build environment
 cd ../..
 DISTRO=openstlinux-weston MACHINE=stm32mp1 source layers/meta-st/scripts/envsetup.sh
  • Add the new layers in that order
 bitbake-layers add-layer ../layers/meta-clang
 bitbake-layers add-layer ../layers/meta-st/meta-st-stm32mpu-ai
  • Build the image
 bitbake st-image-ai-cv
Info white.png Information
Note that building the image could take more than 2 hours depending on the host computer performance.

1.3. Installation of the meta layer[edit source]

1.3.1. STM32MP1 DK2 or EV1 boards[edit source]

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.

Info white.png Information
The meta-st-stm32mpu-ai layer depends on the meta-clang layer.
  • Clone following git repositories into <Distribution Package installation directory>/layers/meta-st
 cd <Distribution Package installation directory>/layers
 git clone https://github.com/kraj/meta-clang -b thud
 cd <Distribution Package installation directory>/layers/meta-st
 git clone https://github.com/STMicroelectronics/meta-st-stm32mpu-ai.git -b thud
  • Set up the build environment
 cd ../..
 DISTRO=openstlinux-weston MACHINE=stm32mp1 source layers/meta-st/scripts/envsetup.sh
  • Add the new layers in that order
 bitbake-layers add-layer ../layers/meta-clang
 bitbake-layers add-layer ../layers/meta-st/meta-st-stm32mpu-ai

1.3.2. STM32MP1 Avenger96 board[edit source]

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.

Info white.png Information
The meta-st-stm32mpu-ai layer depends on the meta-clang layer.
  • Clone following git repositories into <Distribution Package installation directory>/layers/meta-st
 cd <Distribution Package installation directory>/layers
 git clone https://github.com/kraj/meta-clang -b thud
 git clone https://github.com/vinceab/meta-av96.git -b thud
 cd <Distribution Package installation directory>/layers/meta-st
 git clone https://github.com/STMicroelectronics/meta-st-stm32mpu-ai.git -b thud
  • Set up the build environment
 cd ../..
 META_LAYER_ROOT=layers DISTRO=openstlinux-weston MACHINE=stm32mp1-av96 source layers/meta-st/scripts/envsetup.sh
  • Add the new layers in that order
 bitbake-layers add-layer ../layers/meta-av96
 bitbake-layers add-layer ../layers/meta-clang
 bitbake-layers add-layer ../layers/meta-st/meta-st-stm32mpu-ai

2. References[edit source]