RKISP Tuner

RKISP Tuner (hereinafter referred to as Tuner) provides a set of tools for users to debug ISP parameters, enabling calibration and tuning of all ISP modules within Tuner.

Test Environment:

  • LKD3588: Buildroot

  • Kernel Version: 5.10.110

  • Camera: OV13855

Installing Tuner Tool

Download the installer-free version from: Cloud Disk

Capturing OV13855 YUV Data

Starting rkaiq_tool_server

root@RK3588:/tmp# rkaiq_tool_server -s /dev/video22
[aiqtool][main]:#### AIQ tool server 20221001_110437 ####
[aiqtool][main]:iqfile cmd_parser.get  /oem/etc/iqfiles
[aiqtool][main]:g_mode cmd_parser.get  -1
......
[aiqtool][main]:================== -1 =====================
[aiqtool][main]:Access streaming device
[aiqtool][Setup]:Linux,Create domain socket success.
[aiqtool][Setup]:Credentials from SO_PEERCRED: pid=711, euid=0, egid=0
[aiqtool][main]:#### ToolServer connect AIQ success ####
[aiqtool][Process]:TCPServer::Process
[aiqtool][Accepted]:TCPServer::Accepted

The default node for OV13855 on LKD3588 is /dev/video22 or /dev/video31. The actual node can be found using v4l2-ctl --list-devices.

Parameters and configuration for rkaiq_tool_server

-d: Selects the sensor device; if there are multiple sensors, use device numbers like 0/1/2. Default is 0.
    Example usage: -d 1 (corresponds to sensor index NN as seen in media-ctl -p -d /dev/mediaX output)

-s: Specifies the video node for YUV capture. Defaults to automatically detecting the iqtool capture node. Can be manually configured as mainPath or selfPath.

-r: RTSP streaming enable/disable switch. 0 for off, 1 for on. Default is 0. Enables RTSP streaming for use with Start RTSP in CaptureTool.

-i: Path for IQ file reading. Modify this path if the IQ file path changes. Can be ignored when -r is 0.

-w/-h: Configures RTSP video stream preview output resolution. Scaled based on ISP output size to meet requirements. Defaults to 1920/1080.

-n: Configures the number of buffers used for continuous Raw online capture. Default is 4, increase for extensive Raw capture.

-f: Configures the frame rate for offline frame functionality. Default is 10 frames.

Using Tuner Tool

Ensure PC and LKD3588 are on the same network.

Connecting Devices

../../_images/tuner_home.png

  1. Select RK3588 corresponding to LKD3588.

  2. Enter LKD3588’s IP address.

  3. Click Connect.

If connection fails, check:

  • Ensure rkaiq_tool_server is running correctly.

  • PC can ping LKD3588.

Capturing YUV Data

../../_images/tuner_yuv_capture.png

  1. Click on Online Capture.

  2. Set File Name with the appropriate video node (e.g., 22).

  3. Click CaptureYUV.

  4. Captured files are stored in the raw_capture directory of the tool.

FAQ

Compiling rkaiq_tool_server from Source

  • Source Path: SDK/external/camera_engine_rkaiq/rkaiq_tool_server

  • Compilation: ./build.sh external/camera_engine_rkaiq

  • Output Path: SDK/output/rockchip_rk3588/target/usr/bin/rkaiq_tool_server

References for rkaiq_tool_server

Refer to the documentation under: Common->CAMERA->ISP3X