Video and Vision Processing Suite Intel® FPGA IP User Guide

ID 683329
Date 10/02/2023
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. 3D LUT Intel® FPGA IP 9. AXI-Stream Broadcaster Intel® FPGA IP 10. Bits per Color Sample Adapter Intel FPGA IP 11. Chroma Key Intel® FPGA IP 12. Chroma Resampler Intel® FPGA IP 13. Clipper Intel® FPGA IP 14. Clocked Video Input Intel® FPGA IP 15. Clocked Video to Full-Raster Converter Intel® FPGA IP 16. Clocked Video Output Intel® FPGA IP 17. Color Space Converter Intel® FPGA IP 18. Deinterlacer Intel® FPGA IP 19. FIR Filter Intel® FPGA IP 20. Frame Cleaner Intel® FPGA IP 21. Full-Raster to Clocked Video Converter Intel® FPGA IP 22. Full-Raster to Streaming Converter Intel® FPGA IP 23. Genlock Controller Intel® FPGA IP 24. Generic Crosspoint Intel® FPGA IP 25. Genlock Signal Router Intel® FPGA IP 26. Guard Bands Intel® FPGA IP 27. Interlacer Intel® FPGA IP 28. Mixer Intel® FPGA IP 29. Pixels in Parallel Converter Intel® FPGA IP 30. Scaler Intel® FPGA IP 31. Stream Cleaner Intel® FPGA IP 32. Switch Intel® FPGA IP 33. Tone Mapping Operator Intel® FPGA IP 34. Test Pattern Generator Intel® FPGA IP 35. Video and Vision Monitor Intel FPGA IP 36. Video Frame Buffer Intel® FPGA IP 37. Video Frame Reader Intel FPGA IP 38. Video Frame Writer Intel FPGA IP 39. Video Streaming FIFO Intel® FPGA IP 40. Video Timing Generator Intel® FPGA IP 41. Warp Intel® FPGA IP 42. Design Security 43. Document Revision History for Video and Vision Processing Suite User Guide

10.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 60.  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 version information for the Bits per Color Sample Adapter.
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 to 0x011F - - Unused.
Table 61.  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.

Register Bit Descriptions

Table 62.  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 63.  VERSION
Name Bits Description
Lite mode parameterization bit 7:0 Register map version. Returns 0x01.
QPDS patch revision 15:8 Returns 0x00.
QPDS update revision 23:16 Updated for each release. For 21.4, returns 0x04.
QPDS major revision 31:24 Updated for each release. For 21.4, returns 0x15.
Table 64.  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 65.  DEBUG_ENABLED
Name Bits Description
Debug features parameterization bit 31:0 Returns 1 if you turn on Debug features and 0 otherwise.
Table 66.  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 67.  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 68.  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 69.  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 70.  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 71.  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 72.  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 73.  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 74.  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 75.  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 76.  COMMIT
Name Bits Description
Unused 31:0 Unused.
Table 77.  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.