Document ID
APT-DS-CXP-DEV-0001
Revision
1.0
IP version
2.2.0
Release date
November 2026
Chapter 4: Register Map

4.3Identification and interrupts

Read ID and VERSION before any write: they confirm the base address and the release. HWCFG and VIDEO_CAP tell firmware how the core was built.

0x000IDROreset 0xA71C0A02

Fixed identification word. Software reads it first: it proves that the base address points at this core.

BitsFieldAccessResetDescription
[31:20]VENDORRO0xA71Vendor code: 0xA71 = ApotheoTech.
[19:8]CORERO0xC0ACore code: 0xC0A = CoaXPress.
[7:0]FUNCTIONRO0x02Function: 0x02 = Device.
0x004VERSIONROreset 0x02020000

Release of the core in the bitstream. A new major number means another register map; a new minor number is a compatible addition; a patch has no software-visible change.

BitsFieldAccessResetDescription
[31:24]MAJORRO0x02Major version: register map generation.
[23:16]MINORRO0x02Minor version.
[15:0]PATCHRO0x0000Patch level.
0x008HWCFGROreset build

The generics the core was built with, so one firmware serves every build.

BitsFieldAccessDescription
[31:24]TDATA_WROvideo_in tdata width in bits.
[23:20]XCVRROTransceiver: 0 GTH (GTHE4), 1 GTY (GTYE4), 2 GTH transmitter only.
[19:18]reservedReserved.
[17]PASSTHRU_TRIGRO1 = the core acknowledges uplink triggers itself.
[16:4]reservedReserved.
[3:0]NUM_LANESROConnections built.
0x00CSCRATCHRWreset 0x00000000

Reads back what was written, byte strobes honoured. No effect on the core.

BitsFieldAccessResetDescription
[31:0]SCRATCHRW0Any value.
0x010RST_CXPWP

Writing a 1 pulses the matching reset, so firmware can recover one path without disturbing the others. Reads 0.

BitsFieldAccessDescription
[31]ALLWPReset the whole core.
[30:8]reservedReserved.
[7]LS_ALLWPAll low-speed (uplink) logic.
[6]HS_ALLWPAll high-speed (downlink) logic.
[5]HRTBTWPHeartbeat generator.
[4]EVENTWPEvent path.
[3]CTRL_ACKWPControl acknowledge path.
[2]STREAMWPStream path.
[1]CTRL_RXWPControl command receiver.
[0]LS_RELOCKWPRe-lock the uplink receiver.
0x014GLBL_IERRWreset 0x00000000

Bit 0 enables the interrupt output cxp_dev_int.

BitsFieldAccessDescription
[31:1]reservedReserved.
[0]GIERW1 = cxp_dev_int may assert.
0x018ISRW1Creset 0x00000000

One sticky bit per source, set by the core whether or not the source is enabled. Write 1 to clear. A source that fires in the clock it is cleared is kept.

BitsFieldAccessDescription
[31:15]reservedReserved.
[14]RATE_ERRW1CLine rate change failed, code in CXP_STATUS[15:14].
[13]TX_READYW1CTransmitter out of reset.
[12]STREAM_OFFW1CStream stopped.
[11]STREAM_ONW1CStream started.
[10]ACK_ERRW1CA CXP_TIMEOUTS flag was set.
[9]HS_ERRW1CA CXP_ERRORS_HS flag was set.
[8]LS_ERRW1CA CXP_ERRORS_LS flag was set.
[7]LS_RX_ALIGNEDW1CUplink receiver locked: a Host is there.
[6]LS_WORD_LOSS_LOCKW1CUplink receiver lost word lock.
[5]LS_BYTE_LOSS_LOCKW1CUplink receiver lost byte lock.
[4]reservedReserved.
[3]LS_EVENT_ACK_VLDW1CEvent acknowledge received.
[2]LS_CNTRL_VLDW1CControl command received.
[1]LS_TRIG_ACKW1CTrigger acknowledge received.
[0]LS_TRIGW1CTrigger received on the uplink.
Table 4-2.Interrupt registers. IER, IPR and IRQ_TEST use the ISR bit positions.
OffsetNameAccessMeaning
0x01CIERRWOne enable bit per ISR bit, same positions.
0x020IPRROThe sources that drive the interrupt output now.
0x024IRQ_TESTW1SWrite 1 to set the matching ISR bit, to test the interrupt handler without the link.