Completer Request Interface - Completer Request Interface - 1.0 English - PG343

Versal Adaptive SoC Integrated Block for PCI Express LogiCORE IP Product Guide (PG343)

Document_ID
PG343
Release_Date
2024-11-22
Version
1.0 English
The Completer Request (CQ) interface are the ports through which all received requests from the link are delivered to the user application. The following table defines the ports in the CQ interface of the core. In the Width column, DW denotes the configured data bus width (64, 128, or 256 bits).
Table 1. Completer Request Interface Port Descriptions
Port I/O Width Description
m_axis_cq_tdata O DW Transmit Data from the CQ Interface.

Only the lower 128 bits are used when the interface width is 128 bits, and only the lower 64 bits are used when the interface width is 64 bits.

Bits [255:128] are set permanently to 0 by the core when the interface width is configured as 128 bits, and bits [255:64] are set permanently to 0 when the interface width is configured as 64 bits.

m_axis_cq_tuser O 109 CQ User Data.

This set of signals contains sideband information for the transaction layer packets (TLP) being transferred. These signals are valid when m_axis_cq_tvalid is High.

Table 2 describes the individual signals in this set.

m_axis_cq_tlast O 1 TLAST indication for CQ Data.

The core asserts this signal in the last beat of a packet to indicate the end of the packet. When a TLP is transferred in a single beat, the core sets this signal in the first beat of the transfer.

m_axis_cq_tkeep O DW/32 TKEEP indication for CQ Data.

The assertion of bit i of this bus during a transfer indicates to the user application that Dword i of the m_axis_cq_tdata bus contains valid data. The core sets this bit to 1 contiguously for all Dwords starting from the first Dword of the descriptor to the last Dword of the payload. Thus, m_axis_cq_tdata is set to all 1s in all beats of a packet, except in the final beat when the total size of the packet is not a multiple of the width of the data bus (in both Dwords). This is true for both Dword-aligned and address-aligned modes of payload transfer.

Bits [7:4] of this bus are set permanently to 0 by the core when the interface width is configured as 128 bits, and bits [7:2] are set permanently to 0 when the interface width is configured as 64 bits.

m_axis_cq_tvalid O 1 CQ Data Valid.

The core asserts this output whenever it is driving valid data on the m_axis_cq_tdata bus. The core keeps the valid signal asserted during the transfer of a packet. The user application can pace the data transfer using the m_axis_cq_tready signal.

m_axis_cq_tready I 1 CQ Data Ready.

Activation of this signal by the user logic indicates to the core that the user application is ready to accept data. Data is transferred across the interface when both m_axis_cq_tvalid and m_axis_cq_tready are asserted in the same cycle.

If the user application deasserts the ready signal when m_axis_cq_tvalid is High, the core maintains the data on the bus and keeps the valid signal asserted until the user application has asserted the ready signal.

pcie_cq_np_req I 2 This input is used by the user application to request the delivery of a Non-Posted request. The core implements a credit-based flow control mechanism to control the delivery of Non-Posted requests across the interface, without blocking Posted TLPs.

This input to the core controls an internal credit count. The credit count is updated in each clock cycle based on the setting of pcie_cq_np_req[1:0] as follows:

  • 00: No change
  • 01: Increment by 1
  • 10 or 11: Reserved (bit [1] only applicable in 512-bit interface)

The credit count is decremented on the delivery of each Non-Posted request across the interface. The core temporarily stops delivering Non-Posted requests to the user logic when the credit count is zero. It continues to deliver any Posted TLPs received from the link even when the delivery of Non-Posted requests has been paused.

The user application can either set pcie_cq_np_req[1:0] in each cycle based on the status of its Non-Posted request receive buffer, or can set it to 11 permanently if it does not need to exercise selective backpressure on Non-Posted requests.

The setting of pcie_cq_np_req[1:0] does not need to be aligned with the packet transfers on the completer request interface.

pcie_cq_np_req_count O 6 This output provides the current value of the credit count maintained by the core for delivery of Non-Posted requests to the user logic. The core delivers a Non-Posted request across the completer request interface only when this credit count is non-zero. This counter saturates at a maximum limit of 32.

Because of internal pipeline delays, there can be several cycles of delay between the user application providing credit on the pcie_cq_np_req[1:0] inputs and the PCIe core updating the pcie_cq_np_req_count output in response.

This count resets on user_reset and de-assertion of user_lnk_up.

When PASID_CAP_ON is enabled, the m_axis_cq_tuser[107:85] pins are specific to passing PASID field information. In all other cases those fields are reserved. The following table provides more information.
Table 2. Sideband Signal Descriptions in m_axis_cq_tuser
Bit Index Name Width Description
3:0 first_be[3:0] 4 Byte enables for the first Dword of the payload.

This field reflects the setting of the First_BE bits in the Transaction-Layer header of the TLP. For Memory Reads and I/O Reads, these four bits indicate the valid bytes to be read in the first Dword. For Memory Writes and I/O Writes, these bits indicate the valid bytes in the first Dword of the payload. For Atomic Operations and Messages with a payload, these bits are set to all 1s.

This field is valid in the first beat of a packet, that is, when sop and m_axis_cq_tvalid are both High.

7:4 last_be[3:0] 4 Byte enables for the last Dword.

This field reflects the setting of the Last_BE bits in the Transaction-Layer header of the TLP. For Memory Reads, these four bits indicate the valid bytes to be read in the last Dword of the block of data. For Memory Writes, these bits indicate the valid bytes in the ending Dword of the payload. For Atomic Operations and Messages with a payload, these bits are set to all 1s. For Memory Reads and Writes of one DW transfers and zero length transfers, these bits should be 0s.

This field is valid in the first beat of a packet, that is, when sop and m_axis_cq_tvalid are both High.

39:8 byte_en[31:0] 32 The user logic can optionally use these byte enable bits to determine the valid bytes in the payload of a packet being transferred. The assertion of bit i of this bus during a transfer indicates that byte i of the m_axis_cq_tdata bus contains a valid payload byte. This bit is not asserted for descriptor bytes.

Although the byte enables can be generated by user logic from information in the request descriptor (address and length) and the settings of the first_be and last_be signals, you can use these signals directly instead of generating them from other interface signals.

When the payload size is more than two Dwords (eight bytes), the one bit on this bus for the payload is always contiguous. When the payload size is two Dwords or less, the one bit can be non-contiguous.

For the special case of a zero-length memory write transaction defined by the PCI Express specifications, the byte_en bits are all 0s when the associated one-DW payload is being transferred.

Bits [31:16] of this bus are set permanently to 0 by the core when the interface width is configured as 128 bits, and bits [31:8] are set permanently to 0 when the interface width is configured as 64 bits.

40 sop 1 Start of packet.

This signal is asserted by the core in the first beat of a packet to indicate the start of the packet. Using this signal is optional.

41 discontinue 1 This signal is asserted by the core in the last beat of a TLP, if it has detected an uncorrectable error while reading the TLP payload from its internal FIFO memory. The user application must discard the entire TLP when such an error is signaled by the core.

This signal is never asserted when the TLP has no payload. It is asserted only in a cycle when m_axis_cq_tlast is High.

When the core is configured as an Endpoint, the error is also reported by the core to the Root Complex to which it is attached, using Advanced Error Reporting (AER).

84:53 parity 32 Bit i provides the odd parity computed for byte i of m_axis_cq_tdata. Only the lower 16 bits are used when the interface width is 128 bits, and only the lower 8 bits are used when the interface width is 64 bits. Bits [31:16] are set permanently to 0 by the core when the interface width is configured as 128 bits, and bits [31:8] are set permanently to 0 when the interface width is configured as 64 bits.
85 PASID TLP Valid 1 Indicates PASID TLP is valid.
105:86 PASID 20 Indicates PASID TLP prefix.
106 Execute Requested 1 Indicates Execute Requested to the user design.
107 Privileged Mode Requested 1 Indicates Privileged Mode Requested to the user design.
108 poisoned_tlp 1 Indicates poisoned bit set on received TLP.
  • 0 - No poisoned TLP received
  • 1 - One poisoned TLP received
Note: Beat is a bus transfer when both axis ready and axis valid are high.