Video and Vision Processing Suite Intel® FPGA IP User Guide

ID 683329
Date 7/08/2024
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents
1. About the Video and Vision Processing Suite 2. Getting Started with the Video and Vision Processing IPs 3. Video and Vision Processing IPs Functional Description 4. Video and Vision Processing IP Interfaces 5. Video and Vision Processing IP Registers 6. Video and Vision Processing IPs Software Programming Model 7. Protocol Converter Intel® FPGA IP 8. 1D LUT Intel® FPGA IP 9. 3D LUT Intel® FPGA IP 10. Adaptive Noise Reduction Intel® FPGA IP 11. Advanced Test Pattern Generator Intel® FPGA IP 12. AXI-Stream Broadcaster Intel® FPGA IP 13. Bits per Color Sample Adapter Intel FPGA IP 14. Black Level Correction Intel® FPGA IP 15. Black Level Statistics Intel® FPGA IP 16. Chroma Key Intel® FPGA IP 17. Chroma Resampler Intel® FPGA IP 18. Clipper Intel® FPGA IP 19. Clocked Video Input Intel® FPGA IP 20. Clocked Video to Full-Raster Converter Intel® FPGA IP 21. Clocked Video Output Intel® FPGA IP 22. Color Plane Manager Intel® FPGA IP 23. Color Space Converter Intel® FPGA IP 24. Defective Pixel Correction Intel® FPGA IP 25. Deinterlacer Intel® FPGA IP 26. Demosaic Intel® FPGA IP 27. FIR Filter Intel® FPGA IP 28. Frame Cleaner Intel® FPGA IP 29. Full-Raster to Clocked Video Converter Intel® FPGA IP 30. Full-Raster to Streaming Converter Intel® FPGA IP 31. Genlock Controller Intel® FPGA IP 32. Generic Crosspoint Intel® FPGA IP 33. Genlock Signal Router Intel® FPGA IP 34. Guard Bands Intel® FPGA IP 35. Histogram Statistics Intel® FPGA IP 36. Interlacer Intel® FPGA IP 37. Mixer Intel® FPGA IP 38. Pixels in Parallel Converter Intel® FPGA IP 39. Scaler Intel® FPGA IP 40. Stream Cleaner Intel® FPGA IP 41. Switch Intel® FPGA IP 42. Tone Mapping Operator Intel® FPGA IP 43. Test Pattern Generator Intel® FPGA IP 44. Unsharp Mask Intel® FPGA IP 45. Video and Vision Monitor Intel FPGA IP 46. Video Frame Buffer Intel® FPGA IP 47. Video Frame Reader Intel FPGA IP 48. Video Frame Writer Intel FPGA IP 49. Video Streaming FIFO Intel® FPGA IP 50. Video Timing Generator Intel® FPGA IP 51. Vignette Correction Intel® FPGA IP 52. Warp Intel® FPGA IP 53. White Balance Correction Intel® FPGA IP 54. White Balance Statistics Intel® FPGA IP 55. Design Security 56. Document Revision History for Video and Vision Processing Suite User Guide

35.4. Histogram Statistics IP Registers

Each register is either read-only (RO) or read-write (RW).
Table 608.  Histogram Statistics Registers

In the software API the register names appear with a prefix of INTEL_VVP, INTEL_VVP_CORE, or INTEL_VVP_HS as appropriate and with an optional REG suffix.

Address Register Access Description
Lite 111 Full
Parameterization registers
0x0000 VID_PID RO N/A

Read this register to retrieve the ID of the IP.

This register always returns 0x6FA7_017B.

0x0004 VERSION RO N/A Read this register for the IP version information.
0x0008 LITE_MODE RO N/A

Read this register to determine if Lite mode is on.

This register always returns 1.

0x000C DEBUG_ENABLED RO N/A

Read this register to determine if Debug features are on.

This register returns 0 for off and 1 for on.

0x0010 BPS_IN RO N/A Read this register to determine the Bits per color symbol used for the input streaming video interface.
0x0014 BPS_OUT RO N/A

Read this register to determine the Bits per color symbol used for the output streaming video interface.

The value of this register reads the same for its input counterpart.

0x0018 NUM_COLOR_IN RO N/A Read this register to determine the Number of color planes for the input streaming video interface.
0x001C NUM_COLOR_OUT RO N/A

Read this register to determine the Number of color planes for the output streaming video interface.

The value of this register reads the same for its input counterpart.

0x0020 PIP RO N/A Read this register to determine the Number of pixels in parallel.
0x0024 MAX_WIDTH RO N/A Read this register to determine the Maximum field width.
0x0028 MAX_HEIGHT RO N/A Read this register to determine the Maximum field height.
0x002C NUM_HIST_BINS RO N/A Read this register to determine the Number of histogram bins.
0x0030 to 0x011F - - - Reserved
Control, debugging, and statistics registers
0x0120 IMG_INFO_WIDTH RW N/A The expected width of the incoming video fields.
0x0124 IMG_INFO_HEIGHT RW N/A The expected height of the incoming video fields.
0x0128 to 0x013F - - - Reserved
0x0140 STATUS RO N/A

Read this register for information about the IP status.

0x0144 FRAME_STATS RO N/A

Read this register for some frame statistics.

0x0148 COMMIT RW N/A

Write any value to this register to submit changes to the control and region of interest registers.

A pending commit request does not block Freeze Statistics Request of the CONTROL register, which the IP samples continuously.

0x014C CONTROL RW N/A

Control bits and fields of the IP.

0x0150 H_START RW N/A Region of interest horizontal start value.
0x0154 V_START RW N/A Region of interest vertical start value.
0x0158 H_END RW N/A Region of interest horizontal end value.
0x015c V_END RW N/A Region of interest vertical end value.
0x0160 to 0x01FF - - - Reserved.

0x0200 to 0x0200 + 4 x NUM_HIST_BINS - 1

FRAME_STATISTICS RO N/A Histogram statistics calculated across the whole frame. The IP stores Number of histogram bins linearly starting from bin index 0 across the range of the registers.

0x0200 + 4 x NUM_HIST_BINS

to

0x0200 + 8 x NUM_HIST_BINS - 1

ROI_STATISTICS RO N/A Histogram statistics calculated inside the region of interest. The IP stores Number of histogram bins linearly starting from bin index 0 across the range of the registers.

0x0200 + 8 x NUM_HIST_BINS

to

end of memory

- - - Reserved or not implemented.

Reserved if the address is within the range of the memory-mapped control interface, otherwise not implemented

Register Bit Descriptions

Table 609.   STATUS
Name Bits Description
Reserved 31:3 Reserved.
Stats are Frozen. 2 The IP sets this bit to indicate it stopped updating the statistics.
Commit 1 Pending commit
Running 0 When 1, the IP is processing data..
Table 610.   FRAME_STATS
Name Bits Description
Reserved 31:8 Reserved.
Checksum 7:0 A simple checksum of the frame.
Table 611.   CONTROL
Name Bits Description
Freeze Statistics Request 31 Set this bit to 1 for the IP to start sampling a new set of histogram and frame statistics. The IP lowers the Stats are Frozen bit of the STATUS register as a response, and you need to poll Stats are Frozen bit until it is 1 before reding the statistics. The IP expects you to keep Freeze Statistics Request 1 until it raises Stats are Frozen. Set Freeze Statistics Request to 0 before starting over with a new sampling request. Deviation from this flow might result in unexpected IP behavior.
Reserved 30:0 Reserved. Write 0.
Table 612.   H_START
Name Bits Description
Reserved 31:16

Reserved.

Position 15:0

Horizontal position of the first pixel in the region of interest. The IP starts counts the pixels from index 0.

Table 613.   V_START
Name Bits Description
Reserved 31:16 Reserved.
Position 15:0

Vertical position of the first line in the region of interest. The IP starts counts the pixels from index 0.

Table 614.   H_END
Name Bits Description
Reserved 31:16

Reserved.

Position 15:0

Horizontal position of the last pixel in the region of interest. The IP starts counts the pixels from index 0.

Table 615.   V_END
Name Bits Description
Reserved 31:16

Reserved.

Position 15:0

Vertical position of the last line in the region of interest. The IP starts counts the pixels from index 0.

111

Registers are RW only if you also turn on Debug features, otherwise they are WO.