X-LINUX-AI Starter package

Applicable for

STM32MP13x lines, STM32MP15x lines, STM32MP25x lines

---

1. Install from the OpenSTLinux AI package repository

Information

The STMicroelectronics packages repository service is provided for evaluation purposes only, its content may be updated at any time without notice and is therefore not approved for use in production.

All the generated X-LINUX-AI packages are available from the OpenSTLinux AI package repository service hosted at the non-browsable URL http://extra.packages.openstlinux.st.com/AI.

This repository contains AI packages that can be simply installed using apt-* utilities, which the same as those used on a Debian system:

• the main group contains the selection of AI packages whose installation is automatically tested by STMicroelectronics
• the updates group is reserved for future uses such as package revision update.

You can install them individually or by package group.

2. Material needed

To use the X-LINUX-AI OpenSTLinux Expansion Package, choose one of the following materials:

• STM32MP257F-EV1 Evaluation board + a Sony™ IMX335 5Mpx sensor
• STM32MP257F-DK Discovery kit + a Sony™ IMX335 5Mpx sensor
• STM32MP157F-DK2 Discovery kit + an UVC USB WebCam
• STM32MP157F-EV1 Evaluation board with the built in camera module: MB1379 (OmniVision OV5640 parallel camera)
• STM32MP135F-DK Discovery kit with the built in camera module: MB1897 (GalaxyCore 2145 parallel camera)

Optional:

• Coral USB Edge TPU™ accelerator

3. Prerequisites

• Flash the Starter Package on your SDCard

For OpenSTLinux ecosystem release v5.1.0  :

Select and follow the correct Starter Package procedure based on the board used

As example:

For STM32MP257x-EV, follow this Starter Package procedure

For STM32MP157x-DK2, follow this Starter Package procedure

• Your board has an internet connection either through the network cable or through a WiFi connection.

Information

If your internet access depends on a proxy server, you should define the http_proxy environment variable with the following command before any apt-* commands: export http_proxy='http://<proxy url>:<proxy port>/'

4. Boot the OpenSTlinux Starter Package

At the end of the boot sequence, the demo launcher application appears on the screen.

5. Install the X-LINUX-AI tool

Once the board is booted, execute the following command in the console in order to download X-LINUX-AI tool package from OpenSTLinux package repository:

For ecosystem release v5.1.0  :

• Synchronize the OpenSTLinux package repository.

 apt-get update

• Install X-LINUX-AI tool package:

 apt-get install x-linux-ai-tool 

• Synchronize the X-LINUX-AI package repository.

 apt-get update

• Check that X-LINUX-AI is properly installed:

 x-linux-ai -v
X-LINUX-AI version: 5.1.0

Information

The x-linux-ai binary (installed in the /usr/bin directory) allows to recover information on the X-LINUX-AI delivery, like version, features, supported applications. It is also used for package management, please refer to the dedicated wiki page for more information.

6. Install AI packages

Warning

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

6.1. Install X-LINUX-AI demonstration packages

To get started with X-LINUX-AI, it is recommended to install the X-LINUX-AI demonstration package, which provides all the AI frameworks, applications examples, tools and utilities optimized for the specific target used.

Command	Description
x-linux-ai -i packagegroup-x-linux-ai-demo	Install the X-LINUX-AI demonstration packages which provide AI frameworks, application examples and tools dedicated to the board used.

After having installed the x-linux-ai-tool you can install the X-LINUX-AI demonstration packages.

 x-linux-ai -i packagegroup-x-linux-ai-demo

And restart the demo launcher:

 systemctl restart weston-graphical-session.service

6.2. [OPTIONAL] Going further with X-LINUX-AI package management

6.2.1. Install X-LINUX-AI package-group

In addition with the X-LINUX-AI demonstration package, there are also other groups of packages dedicated to providing all the necessary packages and tools for a specific artificial intelligence functionality named "packagegroup".

The available packagegroups are the following:

• packagegroup-x-linux-ai-demo: Default packagegroup provinding for X-LINUX-AI expansion package evaluation.
• packagegroup-x-linux-ai-npu: Provide minimal packages to address NN hardware acceleration on NPU for STM32MP2 series' boards .
• packagegroup-x-linux-ai-<tflite/onnxruntime/coral>: Provide packages and tools dedicated to a specific AI frameworks like TensorFlow Lite, ONNX and Coral.
• packagegroup-x-linux-ai: Packagegroup used to install all the packages available in X-LINUX-AI for the target used.

Command	Description
x-linux-ai -i packagegroup-x-linux-ai-demo	Install X-LINUX-AI demonstration packages which provide AI frameworks, application examples and tools dedicated to the board used.
x-linux-ai -i packagegroup-x-linux-ai-npu	Install X-LINUX-AI packages allowing to use OpenVX stack for the NPU hardware acceleration (including application samples)
x-linux-ai -i packagegroup-x-linux-ai-tflite	Install X-LINUX-AI packages related to TensorFlow™ Lite framework (including application samples)
x-linux-ai -i packagegroup-x-linux-ai-coral	Install X-LINUX-AI packages related to the Coral Edge TPU™ framework (including application samples)
x-linux-ai -i packagegroup-x-linux-ai-onnxruntime	Install X-LINUX-AI packages related to ONNX Runtime™ (including application samples)
x-linux-ai -i packagegroup-x-linux-ai	Install all X-LINUX-AI packages available for the target

6.2.2. Install X-LINUX-AI individual packages

To be able to list or manage all the X-LINUX-AI individual packages available please refer to the dedicated X-LINUX-AI Tool article

7. Launch an AI application sample

Once the demo launcher is restarted, notice that it is slightly different because new AI application samples have been installed.
The demo launcher has the following appearance, and you can navigate into the different screens by using the NEXT or BACK buttons.

7.1. For STM32MP25x lines

7.2. For STM32MP1 series

The demo launcher now contain AI application samples that are described within dedicated article available in the X-LINUX-AI application samples page.

7.3. Enjoy running your own NN models

The above examples provide application samples to demonstrate how to execute models easily on the STM32MPUs.

You are free to update the C/C++ application or Python scripts for your own purposes, using your own NN models.

Source code locations are provided in application sample pages.

Artificial intelligence

USB vdeo class

Flash memory shortened to gain space in titles, tables and block diagrams

Neural network

Neural processing unit - NEW

Artificial intelligence

USB vdeo class

Flash memory shortened to gain space in titles, tables and block diagrams

Neural network

Neural processing unit - NEW

Flash memories combine high density and cost effectiveness of EPROMs with the electrical erasability of EEPROMs. For this reason, the Flash memory market is one of the most exciting areas of the semiconductor industry today and new applications requiring in system reprogramming, such as cellular telephones, automotive engine management systems, hard disk drives, PC BIOS software for Plug & Play, digital TV, set top boxes, fax and other modems, PC cards and multimedia CD-ROMs, offer the prospect of very high volume demand.