Video and Vision Processing Suite IP User Guide

ID 683329
Date 3/30/2025
Public

Visible to Intel only — GUID: cch1692628828930

Ixiasoft

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

13.4. Bits per Color Sample Adapter IP Registers

Each register is either read-only (RO) or read-write (RW).

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

Table 125.  Parameterization Registers
Address Register Access Description
0x0000 VID_PID RO Read this register for the Bits per Color Sample Adapter product ID. This register always returns 6AF7_024C
0x0004 VERSION RO Read this register for the IP version information.
0x0008 LITE_MODE RO Read this register to determine if lite mode is on. This register returns 0 when you turn off lite mode and 1 when you turn on lite mode.
0x000C DEBUG_ENABLED RO Read this register to determine if Debug features is on. This register returns 1 if reads to other registers designated as RW return the last value the IP writes to the register, or an undefined value.
0x0010 BPS_IN RO Read this register to determine the number of bits that represent each color plane on the input tdata bus
0x0014 BPS_OUT RO Read this register to determine the number of bits that represent each color plane on the output tdata bus
0x0018 ENABLE_DITHER RO Read this register to determine if the core has dither enable
0x001C NOISE_OPERATION RO Read this register to determine the noise operation. 33
0x0020 R_DITHER_BITS RO Read this register to determine the noise pad bits for color channel 2 (R/Cr). 33
0x0024 G_DITHER_BITS RO Read this register to determine the noise pad bits for color channel 1 (G/Y). 33
0x0028 B_DITHER_BITS RO Read this register to determine the noise pad bits for color channel 0 (B/Cb). 33
0x002C A_DITHER_BITS RO Read this register to determine the noise pad bits for color channel 3 (A). 33
0x0030 FIXED_RAND_SEED RO Read this register to determine the fixed rand seed value. 33
0x0034 to 0x011F - - Unused.
Table 126.  Control and Debug RegistersFor more information, refer to Control Packets. You must turn on debug features to read the values stored in these registers. If you turn off debug features, reads to these registers return undefined data. The only exception is the STATUS register, the value of which you can always read
Address Register

Access

Description
0x0120 IMG_INFO_WIDTH RO When you turn on Debug features, this register returns the width that the Bits per Color Sample Adapter derives from information in the image information packet.
0x0124 IMG_INFO_HEIGHT RO When you turn on Debug features, this register returns the height that the Bits per Color Sample Adapter derives from information in the image information packet.
0x0128 IMG_INFO_INTERLACE RO When you turn on Debug features, this register returns the interlace nibble that the Bits per Color Sample Adapter derives from information in the image information packet.
0x012C Reserved - Reserved.
0x0130 IMG_INFO_COLORSPACE RO When you turn on Debug features, this register returns the color space that the Bits per Color Sample Adapter derives from information in the image information packet.
0x0134 IMG_INFO_SUBSAMPLING RO When you turn on Debug features, this register returns the subsampling that the Bits per Color Sample Adapter derives from information in the image information packet.
0x0138 IMG_INFO_COSITING RO When you turn on Debug features, this register returns the cositing that the Bits per Color Sample Adapter derives from information in the image information packet.
0x013C IMG_INFO_FIELD_COUNT RO When you turn on Debug features, this register returns the field count that the Bits per Color Sample Adapter derives from information in the image information packet.
0x0140 STATUS RO

Bit0: Status bit.

1 means Bits per Color Sample Adapter is processing a video field, 0 otherwise.

Bit1: Pendingregister updates bit.

Any writes to the output sampling register (0x0148) cause the IP to raise the pending register updates bit, to indicate outstanding changes to the resampling settings.

The IP lowers this bit at the next field boundary after a write to the COMMIT register.

0x0144 COMMIT RW The IP holds any changes to output bits per color value via the register map until you send a write to this register. The value you write is unimportant.
0x0148 IMG_INFO_BPS_OUT RW Write the value for the bits per color field for outgoing image information packets to this register. You write the actual bits per color value. The value for the image information packet is bits per color minus one, but the IP performs the subtraction.
0x014C CONFIGURATION_REG RW Dithering only
0x0150 RAND_SEED_REG RW Write to this register to set the seed value. Dithering only

Register Bit Descriptions

Table 127.  VID_PID
Name Bits Description
Bits per Color Sample Adapter vendor ID and product ID 31:0

This register always returns 0x6AF7_024C.

  • 15:0 is the product ID and always returns 0x024C
  • 31:16 is the vendor ID and always returns 0x6AF7
Table 128.  VERSION
Name Bits Description
Register map version 7:0 Register map version.
IP patch revision 15:8 -
IP update revision 23:16 Updated when the IP version changes.
IP major revision 31:24 Updated when the IP version changes.
Table 129.  LITE_MODE
Name Bits Description
Lite mode parameterization bit 31:0 The IP only uses this register when Lite mode is off. Reads to this register always return 0
Table 130.  DEBUG_ENABLED
Name Bits Description
Debug features parameterization bit 31:0 Returns 1 if you turn on Debug features and 0 otherwise.
Table 131.  BPS_IN
Name Bits Description
Bits per color in 31:0 Returns the number of bits that represent each color plane on the input tdata bus
Table 132.  BPS_OUT
Name Bits Description
Bits per color out 31:0 Returns the number of bits that represent each color plane on the output tdata bus
Table 133.  ENABLE_DITHER
Name Bits Description
Dither enabled 0 Returns if Enable dithering is on.
Unused 31:1 Unused
Table 134.  NOISE_OPERATION
Name Bits Description
Dither Noise Operation 2:0 Returns the noise operation if Enable dithering is on, otherwise undefined
Unused 31:3 Unused
Table 135.  R_DITHER_BITS
Name Bits Description
Dither Red (Cr) Dither bits 3:0 Return the R(Cr) dither bits if Enable dithering is on, otherwise undefined
Unused 31:4 Unused
Table 136.  G_DITHER_BITS
Name Bits Description
Dither Green (Y) Dither bits 3:0 Return the G(Y) dither bits if Enable dithering is on, otherwise undefined
Unused 31:4 Unused
Table 137.  B_DITHER_BITS
Name Bits Description
Dither Blue (Cb) Dither bits 3:0 Returns the B(Cb) dither bits if Enable dithering is on, otherwise undefined
Unused 31:4 Unused
Table 138.  A_DITHER_BITS
Name Bits Description
Dither Alpha Dither bits 3:0 Returns the alpha dither bits if Enable dithering is on, otherwise undefined
Unused 31:4 Unused
Table 139.  FIXED_RAND_SEED
Name Bits Description
Fixed Random Seed 31:0 Returns the fixed random seed if Enable dithering is on, otherwise undefined
Table 140.  IMG_INFO_WIDTH
Name Bits Description
Width bits 15:0 When you turn on Debug features, this register reads the width-1 field from the most recently received image information packet and adds 1 to return a value for width.
unused 31:16 Unused.
Table 141.  IMG_INFO_HEIGHT
Name Bits Description
Height bits 15:0 When you turn on Debug features, this register reads the height-1 field from the most recently received image information packet and adds 1 to return a value for height.
unused 31:16 Unused.
Table 142.  IMG_INFO_INTERLACE
Name Bits Description
IntlaceNibble bits 3:0

When you turn on Debug features, this register returns the intlaceNibble field from the most recently received image information packet.

Unused 31:4 Unused.
Table 143.  IMG_INFO_COLORSPACE
Name Bits Description
CSP code bits 6:0 When you turn on Debug features, this register returns the 7 bit CSP field from the most recently received image information packet.
unused 31:7 Unused.
Table 144.  IMG_INFO_SUBSAMPLING
Name Bits Description
SubSa code bits 1:0 When you turn on Debug features, this register returns the SUBSA field from the most recently received image information packet.
Unused 31:2 Unused.
Table 145.  IMG_INFO_COSITING
Name Bits Description
Cosite code bits 1:0 When you turn on Debug features, this register returns the COSITE field from the most recently received image information packet.
unused 31:2 Unused.
Table 146.  IMG_INFO_FIELD_COUNT
Name Bits Description
Count bits 6:0 When you turn on Debug features, this register returns the 7 bit FIELD_COUNT field from the most recently received image information packet.
unused 31:7 Unused.
Table 147.  STATUS
Name Bits Description
Status bit 0 1 means Bits per Color Sample Adapter is processing a video field, 0 otherwise.
Pending register updates bit 1 1 means Bits per Color Sample Adapter has pending updates, 0 otherwise
Unused 31:2 Unused.
Table 148.  COMMIT
Name Bits Description
Unused 31:0 Unused.
Table 149.  IMG_INFO_BPS_OUT
Name Bits Description
Image info bps out 4:0 Value the IP uses for the bits per color sample field in outgoing image information packers. You should write the true value for the number of bits per color and the IP subtracts 1 from this value to create the correct value for output.
Unused 31:5 Unused.
Table 150.  CONFIGURATION_REG
Name Bits Description
Passthrough 0 Write 1 to turn off dithering
Unused 31:1 Unused
Table 151.   RAND_SEED_REG
Name Bits Description
Random Seed Value 29:0 Write 30 MSBs of the seed value
Unused 31:30 Unused
33 This register is only defined when dither is on, otherwise it undefined.