This article explains how to use the Simple ISP preview application for launching a simple preview with ISP running for a better image quality rendering.
1. Description
The Simple ISP preview application is a part of the X-LINUX-ISP Expansion package. It is a simple python application that allows to stream a camera and to display a preview with ISP enabled and 2A algorithms running.
The application demonstrates how to prototype a simple Gstreamer pipeline to stream camera frames (using libcamerasrc) and to display a preview on screen (using gtkwaylandsink). Libcamera IPA is used to configure and enable the DCMIPP ISP algorithms for auto-exposure (AE) and auto-whitebalance (AWB).
2. Installation
2.1. Install from the OpenSTLinux ISP package repository
After having configured the OpenSTLinux ISP package you can install the X-LINUX-ISP packages that contains the Simple ISP preview application:
- To install this application, please use the following command:
x-linux-isp --install simple-isp-preview-python
- Then, restart the demo launcher:
systemctl restart weston-graphical-session.service
2.2. Source code location
- in the OpenSTLinux Distribution with X-LINUX-ISP Expansion Package:
- <Distribution Package installation directory>/layers/meta-st/meta-st-x-linux-isp/recipes-samples/files/simple-isp-preview
- on GitHub:
2.3. Regenerate the package from OpenSTLinux Distribution (optional)
Using the OpenSTLinux Distribution, you are able to rebuild the application.
- Set up the build environment:
cd <Distribution Package installation directory> source layers/meta-st/scripts/envsetup.shBe careful to select the right board in the script to setup the correct environment
- Rebuild the application on STM32MP2x:
bitbake simple-isp-preview-python -c install
The generated package is available here:
<Distribution Package installation directory>/<build directory>/tmp-glibc/work/cortexa35-ostl-linux/simple-isp-preview-python/5.0.0-r0/image
3. How to use the application
3.1. Launching via the demo launcher
You can click on the icon to run the application.
3.2. Executing with the command line
The Simple ISP preview Python application is located in the userfs partition:
/usr/local/x-linux-isp/simple-isp-preview
Run the application by executing the following script:
/usr/local/x-linux-isp/simple-isp-preview/launch_python_simple_isp_preview_app.sh