Visible to Intel only — GUID: xje1723713158650
Ixiasoft
Visible to Intel only — GUID: xje1723713158650
Ixiasoft
42.4. 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
Name | Bits | Description |
Text box version and product ID | 31:0 | This register always returns 0x6AF7_017E |
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 |
Name | Bits | Description |
Lite mode parameterization bit | 0 | Returns 1 if Lite mode is on. |
Unused | 31:1 | Unused |
Name | Bits | Description |
Debug features parameterization bit | 0 | Returns 1 if Debug features is on |
Unused | 31:1 | Unused |
Name | Bits | Description |
Interrupt enabled parameterization bit | 0 | Returns 1 if Enable interrupt is on. |
Unused | 31:1 | Unused |
Name | Bits | Description |
Bits per color sample | 31:0 | Returns the Bits per color sample value |
Name | Bits | Description |
Pixels in parallel | 31:0 | Returns the Pixels in parallel value |
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 |
Name | Bits | Description |
Alpha channel enabled | 0 | Returns 1 if Enable alpha channel is on. |
Unused | 31:1 | Unused |
Name | Bits | Description |
Number of characters per line | 31:0 | Returns the Number of characters per line of text. |
Name | Bits | Description |
Number of lines | 31:0 | Returns the Number of lines of text. |
Name | Bits | Description |
Double buffering enabled | 0 | Returns 1 if Double buffering is on. |
Unused | 31:1 | Unused |
Name | Bits | Description |
Maximum font size | 31:0 | Returns the Maximum font size. |
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 |
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 |
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 |
Name | Bits | Description |
Running bit | 15:0 | Returns the number of fields generated since the IP was last started |
Unused | 31:16 | Unused |
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 |
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 |
Name | Bits | Description |
Unused | 31:0 | Write to this register after updating RD_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 |
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 |
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 |
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 |
Name | Bits | Description |
Color component X | BPS – 1:0 | The value for color component X. |
Unused | 31:BPS | Unused |
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) |