QLI Protocol Specification

DYBER-QLI-ARCH-001 Rev 0.1 β€” December 2025

Complete QLI v0.1 protocol reference: 128-bit parallel DDR PHY, packet format, credit-based flow control, CRC-32/KMAC-128 integrity, and QLI-SHORT/STANDARD/EXTENDED configurations. This page provides the formal protocol specification; for integration guidance see the QLI Interface Reference.

Protocol Overview #

QLI Protocol Stack
LayerFunctionKey Parameters
Transaction LayerCommand dispatch, completion, register access10 opcodes, 16-bit tags
Data Link LayerCredit flow control, CRC-32, optional KMAC-12832 initial credits, 8-bit counters
Physical Layer128-bit DDR parallel signaling, clock forwarding1.8V I/O, 50Ξ© impedance

Physical Layer Specification #

ParameterValue
Data width128 bits TX + 128 bits RX (full-duplex)
SignalingSingle-ended CMOS, DDR (data valid on both clock edges)
Clock forwardingSource-synchronous, 1 TX_CLK + 1 RX_CLK
Per-clock bandwidth256 bits/edge Γ— 2 edges = 512 bits/cycle
Bandwidth @ 100 MHz6.4 GB/s per direction, 12.8 GB/s aggregate
Bandwidth @ 200 MHz (GF22FDX)12.8 GB/s per direction, 25.6 GB/s aggregate
Lane grouping4 Γ— 32-bit lanes with per-lane valid signals
Voltage levels1.8V CMOS (VDD_IO)

Packet Format #

QLI Packet Structure (64-byte aligned):
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚ Header   β”‚ Payload                  β”‚ CRC-32     β”‚ KMAC-128     β”‚
β”‚ (8 bytes)β”‚ (variable: 0–4068 bytes) β”‚ (4 bytes)  β”‚ (16 bytes,   β”‚
β”‚          β”‚                          β”‚ mandatory  β”‚  optional)   β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

Header (8 bytes):
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚ OPCODE  β”‚ FLAGS   β”‚ LENGTH   β”‚ TAG     β”‚ RESERVED  β”‚
β”‚ [7:0]   β”‚ [15:8]  β”‚ [31:16]  β”‚ [47:32] β”‚ [63:48]   β”‚
β”‚ 8 bits  β”‚ 8 bits  β”‚ 16 bits  β”‚ 16 bits β”‚ 16 bits   β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
Packet Configurations
TypeTotalHeaderPayloadCRCMACUse Case
QLI-SHORT64 B8 B52 B4 Bβ€”Register access, commands
QLI-STANDARD256 B8 B244 B4 Bβ€”Single polynomial transfer
QLI-EXTENDED4096 B8 B4068 B4 B16 BBulk key/ciphertext transfer

Opcode Definitions #

OpcodeNameDirPacket TypeDescription
0x01WRITE_REGH→QSHORTWrite 32-bit value to MMIO register
0x02READ_REGH→QSHORTRequest register read
0x03READ_RSPQ→HSHORTRegister read response with data
0x10DATA_WRITEH→QSTD/EXTBulk write to SRAM (public key, seed)
0x11DATA_READH→QSHORTRequest bulk SRAM read
0x12DATA_RSPQ→HSTD/EXTBulk read response with data
0x20CMD_DISPATCHH→QSHORTSubmit ML-KEM operation
0x21CMD_COMPLETEQ→HSHORTOperation completion notification
0x30CREDIT_UPDATEBothSHORTCredit return (piggyback or dedicated)
0xF0LINK_MGMTBothSHORTTraining, power state transitions

Credit-Based Flow Control #

Credit Flow Control Protocol:

  Host                                    QCORE-C1
    β”‚                                        β”‚
    │──── LINK_MGMT(credits=32) ───────────→│  Initial credit exchange
    │←─── LINK_MGMT(credits=32) ────────────│  at link-up
    β”‚                                        β”‚
    │──── DATA_WRITE (creditβˆ’1) ───────────→│  Each TX consumes 1 credit
    │──── DATA_WRITE (creditβˆ’1) ───────────→│
    β”‚                                        β”‚
    │←─── CREDIT_UPDATE(+2) ────────────────│  Receiver returns credits
    β”‚                                        β”‚  as buffers are freed
    │──── CMD_DISPATCH (creditβˆ’1) ─────────→│
    β”‚                                        β”‚
    │←─── CMD_COMPLETE ─────────────────────│  Completions are
    │←─── CREDIT_UPDATE(+1) ────────────────│  credit-free (reserved pool)
ParameterValueNotes
Initial credits32Exchanged during CONFIG phase of link training
Max credits2558-bit counter per direction
Credit granularity1 packetRegardless of packet size (SHORT/STD/EXT)
Stall behaviorTX blockedTransmitter pauses until credit received
Credit timeout1 msLink error if no credits returned within timeout

Integrity Verification #

CRC-32 (mandatory, all packets): Polynomial 0x04C11DB7 (IEEE 802.3). Computed over header + payload bytes. Appended as 4-byte little-endian trailer. Detects all burst errors ≀32 bits.

KMAC-128 (optional, QLI-EXTENDED): NIST SP 800-185 KMAC with customization string "QLI-v0.1". 128-bit MAC appended after CRC-32. Per-session key derived during link training via Keccak-based key agreement. Required for all transfers containing secret key material.

StateCodeTimeoutNext StateAction
RESET0x00β€”DETECTPOR complete, release RESET_N
DETECT0x011 ΞΌsPOLLINGDetect partner presence via TX/RX activity
POLLING0x0210 ΞΌsTRAININGLock PLL to received clock, verify frequency
TRAINING0x0350 ΞΌsCONFIGSend/receive PRBS-7 pattern, measure BER
CONFIG0x0410 ΞΌsACTIVEExchange credits, negotiate packet sizes
ACTIVE0x05β€”β€”Normal operation, LINK_UP asserted