Document ID
APT-DS-CXP-HOST-0001
Revision
1.0
IP version
2.2.1
Release date
November 2026
Chapter 2: Functional Description

2.5Pixel formats

The camera states its pixel format in the image header; software selects the same format in PIXEL_TYPE. The code is {layout, bit depth on the link}:

Table 2-3.PIXEL_TYPE codes: bits [7:4] select the layout, bits [3:0] the bit depth on the link (8 = 8-bit to C = 16-bit). 0x00 is accepted as RGB 8-bit, the code of earlier releases.
Layout8-bit10-bit12-bit14-bit16-bitComponents, LSB firstBuilt by
Mono / Bayer / Raw0x080x090x0A0x0B0x0Cthe sampleVID_EN_MONO
RGB0x180x190x1A0x1B0x1CG, B, RVID_EN_RGB
YCbCr 4:4:40x280x290x2A0x2B0x2CY, Cb, CrVID_EN_YCBCR444
YCbCr 4:2:20x380x390x3A0x3B0x3CY, C (Cb even pixels, Cr odd)VID_EN_YCBCR422
YCbCr 4:2:00x480x490x4A0x4B0x4CY, C (C on even lines only)VID_EN_YCBCR420
  • Built by switch. Each layout has a switch in the IP GUI and Bit depths on the link picks the depths. Mono / Bayer at every depth is the default. With everything on, one build carries 25 formats. VIDEO_CAP reports what was built, and PIXEL_TYPE.NOT_BUILT flags a code the bitstream has no path for.
  • Run-time selection. A write to PIXEL_TYPE restarts the stream path with the new format. Write it with the acquisition stopped.
  • Format port. The same code leaves the core on pixel_type_out, so a packer or ISP behind video_out follows the one register write without a second register or a GPIO. It changes one AXI4-Lite clock after the write and at no other time.
  • YCbCr 4:2:0. CoaXPress has no packed 4:2:0 format, so the link carries YCbCr 4:2:2. With a 4:2:0 code the core delivers UG934 4:2:0 (chroma on even lines only); with the 4:2:2 code the same stream comes out as 4:2:2. Any 4:2:2 camera can feed a 4:2:0 consumer such as an encoder.

2.5.1Lines and frames

  • A line is a multiple of 4 pixels. A YCbCr 4:2:2 line of 4n + 2 pixels is accepted at 4 pixels per beat; its last beat has pixels 2 and 3 zero, as UG934 asks.
  • Every line starts in a new link word and the core drops the zero padding of the last word of a line.
  • A line that breaks the width rule still ends with tlast. It is flagged in PIXEL_TYPE.LINE_ERR, counted in PIX_LINE_ERRS and raises PIX_LINE_ERR.
  • Everything before the first start of frame is discarded, so the first thing out is a whole frame. A start of frame inside a line starts a new frame and is flagged the same way.
  • Line and frame size are checked against the image header and counted in FRAME_XSIZE_ERRS and FRAME_YSIZE_ERRS.

2.5.2Throughput

Table 2-4.Pixel path throughput: share of the link words of one connection the path takes per word clock, and the pixel rate one CXP-12 connection carries.
Format2 pixels per beat4 pixels per beatMpx/s at CXP-12
Mono / Bayer 8-bit50 %100 %1220
Mono / Bayer 10-bit62 %100 %976
Mono / Bayer 12-bit75 %100 %813
Mono / Bayer 14-bit87 %100 %697
Mono / Bayer 16-bit100 %100 %610
YCbCr 4:2:2 8 / 10 / 12-bit100 %100 %610 / 488 / 407
RGB or YCbCr 4:4:4 8 / 10 / 12-bit100 %100 %407 / 325 / 271

The video clock must carry the pixel rate: video_out_clk ≥ pixels per second / VID_PPC. A colour pipeline loses nothing at 2 pixels per beat; Mono and Bayer formats below 16 bits need 4 pixels per beat to use a whole connection.