PQ Tools User Guide

Revision History

Revision	Date	Description
0.1	2020/02/07	Initial
0.2	2020/04/15	Supplement Chapter 1 and Chapter 2; Remove some sections
0.2.0.1	2020/04/24	Adjust Chapter 1 / 2
0.2.1.2	2020/05/17	Add section 2.4.2 (video stream preview tool)
0.2.1.3	2020/07/22	Update sections 1.2, 2.1.2, 2.4.1; Add sectionss 2.1.5, 2.1.6, 2.1.7, 2.1.8 and 2.1.9
0.2.1.4	2020/08/26	Add section 2.1.10
0.2.1.5	2021/01/15	Add sections 2.4.3 and 2.6
0.2.1.5	2021/01/15	Update the picture and description according to the version CviPQ-Tool_20210117A
0.2.1.7	2021/02/22	Update section 2.5
0.2.2	2021/03/04	Add chapter 4 FAQ
0.2.2.1	2021/03/24	Update sections 1.2.4，2.1.4.1 and 2.1.4.2
0.2.2.2	2021/03/26	Update section 2.4.1.3
0.2.2.3	2021/03/31	Update section 1.1
0.2.3.0	2021/04/28	Add sections 4.1 and 4.2
0.2.3.1	2021/05/08	Add section 2.4.1.4，Dump All instructions
1.1.1	2021/06/11	Update version number
1.1.2	2021/10/27	1.2, 1.3, 1.4, 2.1.1, 2.1.2, 2.1.4, update icons, modify and add features introduced
1.1.3	2021/11/01	Add section 2.1.4.3 VO Gamma，section 2.4.5 Bracketing，section 1.4.3.11 Shortcuts；Update other icons and function descriptions
1.1.4	2021/11/05	Add section 3.1.2 Import and export image quality parameters using the library
1.1.5	2021/12/27	Add section 1.2.4 Release package catalog description
1.1.6	2022/04/24	Add section 3.1.2 API and update some parameters description
1.1.7	2022/05/19	Add section 2.4.6 Continuous raw tool
1.1.8	2022/06/27	Modify some titles
1.1.9	2022/08/17	Update graphics and descriptions
1.1.10	2022/10/20	Remove the bin parameter API that overrides the PQbin
1.1.11	2023/02/08	Add instructions for using the LDC page
1.1.12	2023/04/12	Update the descriptions in 2.2.4 and 2.2.5

Contents

• 1. Disclaimer
• 2. Overview
  • 2.1. Tool Overview
  • 2.2. Environment Preparation Instructions
    • 2.2.1. Software and Hardware Requirements
    • 2.2.2. Physical Link Connection
    • 2.2.3. EVB Uart Connection Description
    • 2.2.4. Release Package Description
    • 2.2.5. Installation and operation of board-side software on Linux systems
  • 2.3. PC Software Installation
  • 2.4. Quick Start
    • 2.4.1. Interface of Connecting Single Board
    • 2.4.2. Tool Main Interface
    • 2.4.3. Common Operations
      • 2.4.3.1. Save Tuning Data Files
      • 2.4.3.2. Open Tuning Data File
      • 2.4.3.3. Connect the Single Board
      • 2.4.3.4. Disconnect from the Single Board
      • 2.4.3.5. Image Preview
      • 2.4.3.6. Capture Tool
      • 2.4.3.7. Bin Import and Export
      • 2.4.3.8. Calibration Tool
      • 2.4.3.9. Auxiliary Tools
      • 2.4.3.10. Shortcuts
• 3. Interface and Function Description
  • 3.1. Online Tuning Interface and Function Description
    • 3.1.1. Tuning Structure Interface
    • 3.1.2. Register / Algorithm Parameter Adjustment
      • 3.1.2.1. View and Modify Register / Algorithm Parameters
      • 3.1.2.2. Read Data from Board End
      • 3.1.2.3. Write Parameters to the Board End
      • 3.1.2.4. Parameter Temporary Storage and Recovery
    • 3.1.3. Batch Reading and Writing and Automatic Writing of Tuning Data
    • 3.1.4. Curve Visualized Tuning
      • 3.1.4.1. General Curve Function Description
      • 3.1.4.2. Gamma Visual Tuning
      • 3.1.4.3. VO Gamma
    • 3.1.5. Exposure Data Status and Parameter Setting
      • 3.1.5.1. Exposure Data Status
      • 3.1.5.2. Exposure Parameter Setting
    • 3.1.6. White Balance Data Status and Parameter Setting
      • 3.1.6.1. White Balance Data Status
      • 3.1.6.2. White Balance Parameter Setting
    • 3.1.7. WDR Exposure Parameter Setting and Local-Tone Switch
      • 3.1.7.1. WDR Exposure Parameter Setting
      • 3.1.7.2. Local-tone Switch
    • 3.1.8. 3DNR and YNR Noice Reduction Tuning
    • 3.1.9. Y Sharpen Sharpening and Edge Enhancement Tuning
    • 3.1.10. Top Page
    • 3.1.11. VPSS Adjustment Page
    • 3.1.12. LDC Page
  • 3.2. ISP Calibration Tool
  • 3.3. Advanced Functions
    • 3.3.1. Export and Import of Parameters
    • 3.3.2. Communication Log
  • 3.4. Instructions for Other Auxiliary Tools
    • 3.4.1. Instructions for Use of Capture Tool
      • 3.4.1.1. Tool Interface
      • 3.4.1.2. Capture YUV Image Data
      • 3.4.1.3. Capture Raw Image Data
      • 3.4.1.4. Dump All
      • 3.4.1.5. File Name Format Description of YUV Image and RAW Image
      • 3.4.1.6. File Format and Content Description of Raw Info File
    • 3.4.2. Video Player Instructions (VLC)
      • 3.4.2.1. Steps to use VLC to play video stream on board
    • 3.4.3. Instructions for Auxiliary Focusing Tool
      • 3.4.3.1. Tool Interface
      • 3.4.3.2. Use the Auxiliary Focusing Tool to Focus
      • 3.4.3.3. Focusing Auxiliary Operation
    • 3.4.4. 3A Analyser Tool
      • 3.4.4.1. Tool Interface
      • 3.4.4.2. Obtain Images and Statistics
      • 3.4.4.3. View AE Statistics
      • 3.4.4.4. View AWB Statistics
    • 3.4.5. Bracketing
    • 3.4.6. Continuous Raw Tool
  • 3.5. Detail Description of Parameters
• 4. Tool Application Reference
  • 4.1. How to Import and Export Tool Parameters?
    • 4.1.1. Import and Export Parameters Using Tool
    • 4.1.2. Import and export image quality parameters using libraries
    • 4.1.3. API reference
      • 4.1.3.1. CVI_BIN_GetBinTotalLen
      • 4.1.3.2. CVI_BIN_ExportBinData
      • 4.1.3.3. CVI_BIN_ImportBinData
      • 4.1.3.4. CVI_BIN_GetSingleISPBinLen
      • 4.1.3.5. CVI_BIN_ExportSingleISPBinData
      • 4.1.3.6. CVI_BIN_SaveParamToBin
      • 4.1.3.7. CVI_BIN_LoadParamFromBin
      • 4.1.3.8. CVI_BIN_LoadParamFromBinEx
      • 4.1.3.9. CVI_BIN_SetBinName
      • 4.1.3.10. CVI_BIN_GetBinName
      • 4.1.3.11. CVI_BIN_GetBinExtraAttr
      • 4.1.3.12. CVI_BIN_EnSingleMode
      • 4.1.3.13. CVI_BIN_DisSingleMode
      • 4.1.3.14. CVI_ISP_BIN_SetBypassParams
      • 4.1.3.15. CVI_ISP_BIN_GetBypassParams
      • 4.1.3.16. Error code 1
      • 4.1.3.17. Error code 2
• 5. FAQ
  • 5.1. Why Does the Tool Indicate a Version Mismatch When Opening the Debug Data File?
  • 5.2. Why Does the Tool Prompt SoC Mismatch When Connecting To the Board?