Last edited 3 weeks ago

STM32 ISP IQTune: application for sensor image quality tuning

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. What is the STM32 ISP IQTune desktop application?[edit | edit source]

IQTune.png
STM32 ISP IQTune is a comprehensive STM32 ISP tuning software application offering a wide range of features and services to help professional and nonprofessional STM32 users tune an embedded ISP.

It consists of two components:

  • A desktop application, running on a host computer (Linux Ubuntu, Windows or MacOS)
  • An embedded application, running on the STM32 device to be tuned.

These two components communicate through a USB link connecting the host computer to the STM32 board to be tuned.

STM32 ISP IQTune provides all the services to allow users to tune the STM32 ISP for an RGB RAW Bayer sensor and its associated lens:

  • It gives access to the STM32 ISP parameters that can be tuned.
  • It provides image quality analyzing capabilities to easily tune the STM32 ISP for any light conditions. For a white-balance profile, the image quality analyzing services provide:
    • The possibility to define the white-balance ISP gain.
    • The possibility to define the color correction matrix.
    • Information and metrics about the color accuracy according to the ISP configuration defined by the user.

2. How to install STM32 ISP IQTune[edit | edit source]

Go to st.com to download the STM32 ISP IQTune software for your OS:

  • Windows : STM32-IQTune-Win
  • MacOS : STM32-IQTune-Mac
  • Ubuntu : STM32-IQTune-Lin


Run the installer, which automates the installation process and ensures that all necessary files, settings, and dependencies are properly configured for your system.

Info white.png Information
On Ubuntu, .AppImage is a self-contained application, so there is no need to install it.

3. How to use STM32 ISP IQTune[edit | edit source]

3.1. Connect the board[edit | edit source]

Connect the host computer running the STM32 ISP IQtune desktop application to the target USB Type-C (OTG) port with a USB cable.

ISP_board_connection

3.2. Launch the board application[edit | edit source]

Make sure that the STM32 ISP IQTune app is installed on the platform.

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.

After configuring the OpenSTLinux ISP package, you can install the X-LINUX-ISP package, containing the STM32 ISP IQTune application:

  • To install this application, use the following command:
  x-linux-isp -i packagegroup-x-linux-isp-iqtune
  • Then, restart the demo launcher with this command:
 systemctl restart weston-graphical-session

The STM32 ISP IQTune" app is now available from the demo launcher.

IQTune_from_weston
  • Run the application to:
    • Start the camera preview.
    • Prepare the USB connection with the remote desktop application.
IQTune_target

3.3. Launch the desktop application[edit | edit source]

When the application is launched, it first checks for the USB connection with the remote embedded application.

IQTune_start_wait_device

As soon as the remote embedded application has started, the connection port is detected. Click on Connect.

IQTune_start_connect_device

The application starts and displays the following:

  • The right-hand Live Feedback panel displays feedback of the image displayed on the target, allowing you to make ISP adjustments and see changes.
  • Useful sensor information is displayed in the bottom left panel.
  • The tuning procedure can be started with the Start tuning from scratch button in the top left panel.
IQTune_start_tuning

4. Documentation[edit | edit source]

Click the Documentation icon on the left-hand side of the application for more detailed documentation.

IQTune_documentation