Last edited 2 weeks ago

X-LINUX-ISP Starter package

Applicable for STM32MP25x lines

Warning DB.png Important
This version of X-LINUX-ISP expansion package is validated against the ecosystem release v5.1.0 . It has not been ported yet on ecosystem release v6.0.0 More info.png .

1. Install from the OpenSTLinux ISP package repository[edit | edit source]

Info white.png Information
The STMicroelectronics package 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 generated X-LINUX-ISP packages are available from the OpenSTLinux ISP package repository service hosted at the non-browsable URL ''http://extra.packages.openstlinux.st.com/ISP''.

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

  • The main group contains the selection of ISP packages whose installation is automatically tested by STMicroelectronics.
  • The updates group is reserved for future use, such as package revision updates.

They can be installed individually or by package group.

2. Material needed[edit | edit source]

To use the X-LINUX-ISP OpenSTLinux expansion package, choose one of the following materials:

  • STM32MP257F-EV1 Evaluation board More info green.png + a Sony™ IMX335 5Mpx sensor
  • STM32MP257F-DK Discovery kit More info green.png + a Sony™ IMX335 5Mpx sensor

3. Prerequisites[edit | edit source]

  • Program the Starter package onto your SDCard.
For OpenSTLinux ecosystem release v5.1.0 : STM32MP257x-EV Starter Package procedure
  • The board must have an internet connection either through the network cable or a WiFi connection.
Info white.png Information

If your internet access uses a proxy server, you should define the http_proxy environment variable with the following command before using any apt-* commands:

export http_proxy='http://<proxy url>:<proxy port>/'

4. Boot the OpenSTLinux Starter package[edit | edit source]

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

Demo launcher appearance when X-LINUX-ISP is not installed

5. Install the X-LINUX-ISP tool[edit | edit source]

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


For ecosystem release v5.1.0 :

  • Synchronize the OpenSTLinux package repository:
apt-get update
  • Install the X-LINUX-ISP tool package:
apt-get install x-linux-isp-tool 
  • Check that X-LINUX-ISP is properly installed:
x-linux-isp -v
X-LINUX-ISP version: 5.0.0
Info white.png Information
The x-linux-isp binary (installed in the /usr/bin directory) allows you to recover information on the X-LINUX-ISP delivery, such as the version, features, and supported applications. It is also used for package management - refer to the dedicated wiki page for more information.

6. Install ISP packages[edit | edit source]

Warning white.png 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-ISP packages[edit | edit source]

To get started with X-LINUX-ISP, we recommended installing the X-LINUX-ISP package, which provides all ISP frameworks, application examples, tools, and utilities optimized for the specific target used.

Command Description
 x-linux-isp -i packagegroup-x-linux-isp 
Install all X-LINUX-ISP packages, which provide ISP frameworks, application examples, and tools dedicated to the board used.

After installing the installed the x-linux-isp-tool, install the X-LINUX-ISP packages:

x-linux-isp -i packagegroup-x-linux-isp

And restart the demo launcher:

systemctl restart weston-graphical-session

6.2. [OPTIONAL] Going further with X-LINUX-ISP package management[edit | edit source]

6.2.1. Install X-LINUX-ISP package-group[edit | edit source]

In addition to the X-LINUX-ISP full package, there are also other groups of packages dedicated to providing all the necessary packages and tools for a specific ISP functionality (like libcamera or the IQTune application) named "packagegroup".

Command Description
x-linux-isp -i packagegroup-x-linux-isp-iqtune
Install X-LINUX-ISP packages, allowing the use of the IQTune application to perform image sensor tuning.
x-linux-isp -i packagegroup-x-linux-isp-libcamera
Install the X-LINUX-ISP packages related to libcamera framework (including gstreamer plugin and application samples)

6.2.2. Install X-LINUX-ISP individual packages[edit | edit source]

To be able to list or manage all X-LINUX-ISP individual packages available, refer to the dedicated X-LINUX-ISP Tool article.

7. Launch an ISP application sample[edit | edit source]

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


Demo launcher appearance when X-LINUX-ISP is installed on MP25x


The demo launcher now contains ISP application samples and tools that are described within the dedicated article available in the X-LINUX-ISP application samples and X-LINUX-ISP tools wiki pages.

Warning DB.png Important
X-LINUX-ISP native camera preview.png
The native "Camera preview" application does not support the X-LINUX-ISP image quality processing. It does not use libcamera with the DCMIPP ISP algorithms, so the preview image quality is not at the right level compared to the "Simple ISP preview" application example provided with the X-LINUX-ISP expansion package.