Video and Vision Processing Suite IP User Guide

ID 683329
Date 3/30/2025
Public

Visible to Intel only — GUID: xje1723713158650

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

42.4. Text Box IP Registers

Each register is either read-only (RO) or read-write (RW).
Table 777.  Text Box IP Registers
Address Register Access Description
0x0000 VID_PID RO

Read this register to retrieve the Text box product ID.

This register always returns 0x6AF7_017E.

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 or off. 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

0x0010 IRQ_ENABLED RO Read this register to determine if Enable interrupts is on
0x0014 BPS RO Read this register to determine the number of bits per color plane
0x0018 PIXELS_IN_PARALLEL RO Read this register to determine the number of pixels transmitted per clock cycle at the streaming output
0x001C COLOR_SPACE RO

Read this register to determine the color space and chroma sampling.

This register returns 0 for RGB, 1 for YCbCr 4:4:4, 2 for YCbCr 4:2:2, 3 for YCbCr 4:2:0 and 4 for monochrome

0x0020 ALPHA_ENABLED RO Read this register to determine if Enable alpha channel is on.
0x0024 NUM_CHARS_PER_LINE RO Read this register to return the Number of characters per line.
0x0028 NUM_LINES RO Read this register to return the Number of lines.
0x002C DOUBLE_BUFFERED RO Read this register to determine if Text Double Buffering is on
0x0030 MAX_FONT_SIZE RO Read this register to return the Maximum font size.
0x044 to 0x013C unused
0x0100 IRQ_CONTROL RW IRQ control. Set this register to configure interrupts. Bit 0 : Set to 1 to enable the interrupt in IRQ_STATUS, 0 otherwise.
0x0104 IRQ_STATUS RW

Read this status register to see if an interrupt fired.

0x0108 to 0x00FC unused
0x0140 STATUS RO

The IP lowers this bit at the next field boundary (or if you stop the IP) after a write to the COMMIT register.

0x0144 FIELD_COUNT RO Read this register to determine the output field count. The value in this register is reset to 0 each time you stop the IP.
0x0148 CURRENT_LINE RO Read this register to determine which line of text the IP is currently generating.
0x014C CONTROL RW

Control register. Write 1 to start the IP, 0 to stop after the current field..

0x0150 COMMIT RW The IP holds pending any changes to registers (except where specified) until you write to this register. The value you write is unimportant.
0x0154 WR_BANK WR

Only if text double buffering is on. Write to this register to set which buffer any writes to the character buffer go.

Writing to this register apply immediately, without needing to write to COMMIT.

0x0158 RD_BANK RW Only if text double buffering is on. Write to set which buffer the IP retrives characters from.
0x015C FIELD_INTERLACE RW

Use this register to set the interlace output behavior for outgoing fields. The value you write corresponds to the interlace identifier nibble of outgoing image information packets in full mode.

The IP toggles the f0 and f1 bit when running..

The changes apply at the next field boundary.

Values 0-7 produce progressive outputs.

Values 8-11 cause the field sequence to restart with F0 first.

Values 12-15 cause the field sequence to restart with F1 first.

0x0160 FONT_SIZE RW

Write to set the font size of the text.

This value changes the field dimensions.

0x0164 FONT_R_CR RW Write to set the font color R component if color space is RGB, or Cr component for YCbCr.
0x0168 FONT_G_Y RW Write to set the font color G component if color space is RGB, or Y component for YCbCr.
0x016C FONT_B_CB RW Write to set the font color B component if color space is RGB, or Cb component for YCbCr, or the monochrome component.
0x0170 FONT_ALPHA RW Only if enable alpha channel is on. Write to set the font alpha (transparency) value.
0x0174 BACKGROUND_R_CR RW Write to set the background color R component if color space is RGB, or Cr component for YCbCr.
0x0178 BACKGROUND_G_Y RW Write to set the background color G component if color space is RGB, or Y component for YCbCr.
0x017C BACKGROUND_B_CB RW Write to set the background color B component if color space is RGB, or Cb component for YCbCr, or the monochrome component.
0x0180 BACKGROUND_ALPHA RW Only if enable alpha channel is on. Write to set the background alpha (transparency) value.
0x0178 to 0x1FC unused

0x0200 + (i – 1)*4

to

0x0200 + (num_chars – 1) * 4

CHARACTER_INDEX[i : i+3] WO Character buffer entries. Each word corresponds to 4 extended ASCII characters. You may write to individual bytes via the byte-enable signal of the control interface.

Register Bit Descriptions

Table 778.   VID_PID
Name Bits Description
Text box version and product ID 31:0 This register always returns 0x6AF7_017E
Table 779.   VERSION
Name Bits Description
Register map version 7:0 Register map version. Returns 1
QPDS patch revision 15:8 Returns 0x00
QPDS update revision 23:16 Updated each release. For 24.3, returns 0x03
QPDS major revision 31:24 Updated each release. For 24.3, returns 0x18
Table 780.   LITE_MODE
Name Bits Description
Lite mode parameterization bit 0 Returns 1 if Lite mode is on.
Unused 31:1 Unused
Table 781.   DEBUG_ENABLED
Name Bits Description
Debug features parameterization bit 0 Returns 1 if Debug features is on
Unused 31:1 Unused
Table 782.   IRQ_ENABLED
Name Bits Description
Interrupt enabled parameterization bit 0 Returns 1 if Enable interrupt is on.
Unused 31:1 Unused
Table 783.   BPS
Name Bits Description
Bits per color sample 31:0 Returns the Bits per color sample value
Table 784.   PIP
Name Bits Description
Pixels in parallel 31:0 Returns the Pixels in parallel value
Table 785.   COLOR_SPACE
Name Bits Description
Color space 31:0 Returns the Color space value with. 0 for RGB, 1 for YCbCr 4:4:4, 2 for YCbCr 4:2:2, 3 for YCbCr 4:2:0, 4 for Monochrome
Table 786.   ALPHA_ENABLED
Name Bits Description
Alpha channel enabled 0 Returns 1 if Enable alpha channel is on.
Unused 31:1 Unused
Table 787.   NUM_CHARS_PER_LINE
Name Bits Description
Number of characters per line 31:0 Returns the Number of characters per line of text.
Table 788.   NUM_LINES
Name Bits Description
Number of lines 31:0 Returns the Number of lines of text.
Table 789.   DOUBLE_BUFFERED
Name Bits Description
Double buffering enabled 0 Returns 1 if Double buffering is on.
Unused 31:1 Unused
Table 790.   MAX_FONT_SIZE
Name Bits Description
Maximum font size 31:0 Returns the Maximum font size.
Table 791.   IRQ_CONTROL
Name Bits Description
Interrupt enable 0 Write 1 to enable the frame boundary interrupt. Set to 1 to enable the interrupt in IRQ_STATUS, 0 otherwise.
Unused 31:1 Unused
Table 792.   IRQ_STATUS
Name Bits Description
Interrupt enable 0

Field done. Asserts 1 to indicate when the IP accepts the RD_BANK for the next field. It is then safe to write new data to the opposing bank (buffer).

Write 1 to this bit to acknowledge the interrupt.

Unused 31:1 Unused
Table 793.   STATUS
Name Bits Description
Running bit 0 Returns 1 if the IP is currently generating a field, 0 otherwise.
Pending register update bit 1 Returns 1 if any outstanding register writes yet to be committed by a write to COMMIT exist.

Any writes to registers (excluding WR_BANK, CONTROL, and addresses corresponding to character indices).

Unused 31:2 Unused
Table 794.   FIELD_COUNT
Name Bits Description
Running bit 15:0 Returns the number of fields generated since the IP was last started
Unused 31:16 Unused
Table 795.   CURRENT_LINE
Name Bits Description
Current line 15:0 Returns the text row number that the IP is currently using to generate text.
Unused 31:16 Unused
Table 796.   CONTROL
Name Bits Description
Current line 0 Write 1 to start the core, 0 to stop after the current field.

Write 0 to this register to stop the IP at the end of the current field. Write 1 to this register to start or restart output generation.

This register initializes to 0 at start-up and no output fields are generated until after a write of 1 to this register.

Writes to this register apply immediately, without needing to further write to COMMIT.

Unused 31:1 Unused
Table 797.   COMMIT
Name Bits Description
Unused 31:0 Write to this register after updating RD_BANK
Table 798.   WR_BANK
Name Bits Description
Write bank number 0 Write 0 for characters writes to go to buffer 0, 1 for buffer 1.
Unused 31:1 Unused
Table 799.   RD_BANK
Name Bits Description
Read bank number 0 Write 0 for the IP to read text from buffer 0, 1 for buffer 1.
Unused 31:1 Unused
Table 800.   FIELD_INTERLACE
Name Bits Description
Interlace nibble 3:0 The interlace configuration of outgoing video fields. The nibble follows the standard from the image information packet of the Intel FPGA Video streaming protocol.
Unused 31:4 Unused
Table 801.   FONT_SIZE
Name Bits Description
Text font size clog2(MAX_FONT_SIZE) – 1:0 The font size the IP uses to render the text. At font size 1, each character is 8x8 pixels.
Unused 31: clog2(MAX_FONT_SIZE) Unused
Table 802.   FONT/BACKGROUND_X
Name Bits Description
Color component X BPS – 1:0 The value for color component X.
Unused 31:BPS Unused
Table 803.   CHARACTER_INDEX[i:i+3]
Name Bits Description
String[i] 7:0 Character at index i
String[i+1] 15:8 Character at index (i+1)
String[i+2] 23:16 Character at index (i+2)
String[i+3] 31:24 Character at index (i+3)