Document ID
APT-DS-CXP-HOST-0001
Revision
1.0
IP version
2.2.1
Release date
November 2026
Chapter 3: Interfaces and Timing

3.1IP customization parameters

Every setting in the IP GUI is a drop-down list; fields the GUI works out are shown read-only. Software reads the build back from HWCFG and VIDEO_CAP, so one driver serves every build. Defaults are in bold.

Table 3-1.Link page.
GUI fieldParameterValuesDescription
TransceiverTRANSCEIVER_TYPEGTY (GTYE4), GTH (GTHE4)Selects the DRP rate tables for the line rate change.
ConnectionsNUM_LANES1Coax connections. 2 and 4 on request.
AXI4-Lite clock (aclk)ACLK_FREQ_MHZ50, 100, 125, 150, 200, 250, 300 MHzFrequency of aclk; converts the line rate change timeouts to clock cycles.
Trigger acknowledgeTRIG_AUTO_ACKBy the core, By softwareWho acknowledges a high-speed trigger from the camera.
Event acknowledgeEVENT_AUTO_ACKBy the core, By softwareWho acknowledges an event packet.

3.1.2Video

Table 3-2.Video page.
GUI fieldParameterValuesDescription
Mono / BayerVID_EN_MONOBuilt, Not builtMono, Bayer and Raw layouts, 1 component.
RGBVID_EN_RGBBuilt, Not builtRGB, 3 components.
YCbCr 4:4:4VID_EN_YCBCR444Built, Not built3 components.
YCbCr 4:2:2VID_EN_YCBCR422Built, Not built2 components.
YCbCr 4:2:0VID_EN_YCBCR420Built, Not built4:2:0 on the bus, 4:2:2 on the link.
Bit depths on the linkVID_LINK_WIDTHS8, 10, 12, 14 and 16-bit, or any subsetThe larger saving: each depth is a gearbox of its own.
Pixels per beatVID_PPC2, 4Pixels per video_out beat.
Bits per componentVID_BPC8, 10, 12, 14, 16Component width on the bus.
Components per pixelVID_CPPread-only, 13 with RGB or YCbCr 4:4:4, 2 with YCbCr 4:2:2 or 4:2:0, else 1.
TDATA width (bit)MAX_TDATA_WIDTHread-only, 64VID_PPC x VID_CPP x VID_BPC, rounded up to whole bytes.
Pixel format after resetPIXEL_TYPE_DEFAULT25 codes, Mono / Bayer 8-bit (0x08)Reset value of PIXEL_TYPE and pixel_type_out.

3.1.3Buffers

Table 3-3.Buffers page.
GUI fieldParameterValues
Control FIFOs (words)CMD_PCKT_MAX1024, 2048, 4096
Event FIFO (words)EVENT_PCKT_MAX_SIZE512, 1024, 2048
Stream FIFO (words)STREAM_FIFO_DEPTH2048, 4096, 8192, 16384
Video output FIFO (beats)AXI4S_DEPTH512, 1024, 2048, 4096

3.1.4Advanced

Table 3-4.Advanced page.
GUI fieldParameterValues
Synchronizer flopsSYNC_STAGE2, 3, 4, 5, 6
IDLE words for lockIDLE_LOCK_CNTR64, 128, 256, 512, 1024
Words without IDLE for an errorIDLE_ERR_NUM50, 100, 200, 500, 1000
Extra reset attemptsRECONFIG_RETRIES0, 1, 2, 3
DRP timeoutRECONFIG_DRP_TIMEOUT_US1 ms, 2, 5, 10 ms
Reset acknowledge timeoutRECONFIG_RST_ACK_TIMEOUT_US100 µs, 1, 10, 100 ms
Reset done timeoutRECONFIG_DONE_TIMEOUT_US20 ms, 50, 100, 200 ms

From a block design script, for a Mono / Bayer and RGB build at 2 pixels of 8 bits on a GTH:

set_property -dict [list \
    CONFIG.TRANSCEIVER_TYPE {GTHE4} \
    CONFIG.ACLK_FREQ_MHZ    {100} \
    CONFIG.VID_PPC          {2} \
    CONFIG.VID_BPC          {8} \
    CONFIG.VID_EN_RGB       {1} \
    CONFIG.VID_LINK_WIDTHS  {1} \
    CONFIG.PIXEL_TYPE_DEFAULT {24} \
] [get_bd_cells cxp_host_0]

Leave VID_CPP and MAX_TDATA_WIDTH out of scripts: the GUI derives them from the switches.