DDR5 Pin Rules - DDR5 Pin Rules - 1.0 English - PG456

Integrated DDR5/LPDDR5/5X Memory Controller LogiCORE IP Product Guide (PG456)

Document_ID
PG456
Release_Date
2026-08-07
Version
1.0 English
Note: You are encouraged to try the Obtaining and Verifying Versal Adaptive SoC Memory Pinouts tutorial available on GitHub. This is a fast and effective way to quickly generate pinouts for Versal DDRMCs. All pin swaps must be captured in the design's XDC and validated before generating hardware. PCB level pin swaps not captured in the tools can lead to hardware failures if pin rules are not followed.
  1. All Command, Address, Control, Clock, Reset, and Alert pins are fixed.
    1. Command/Address/Control pins: CA[13:0], CS_n, PAR, and ALERT_N.
      1. CA (Address) signals of Channel 0 can be swapped within Channel 0 and similarly CA (Address) signals of Channel 1 can be swapped within Channel 1.
      2. CA (Address) signals of Channel 0 cannot be swapped with CA (Address) signals of Channel 1.
    2. Clock pins: CK_T, CK_C.
  2. DQS/DQ/DM_n Pin Guidelines that are fixed:
    1. DQS Guidelines:
      1. x4 interfaces: DQS_t must be placed on pin 2 and DQS_c on pin 3 of octad.
      2. x8/x16 interfaces: DQS_t/DQS_c must be placed on pin 2 and 3 respectively in one of the two octads used for data nibbles. The placement of the DQS_t/DQS_c signals is fixed for a given octad pair.
    2. DQ/DM_n Guidelines:
      1. x8/x16 interfaces: All DQ and associated DQS/DM_n must be within the octad pair (0/1, 2/3, 4/5, 6/7).
      2. x4 interfaces: All DQ and associated DQS must be placed within the octad.
      3. All interfaces: DQs are mapped to pins 0, 1, 4, and 5 only.
      4. x16 interfaces: All DQs of word (byte pairs 0/1 & 2/3) must be placed in consecutive octads. So DQ[7:0] and DQ[15:8] pairs have to be placed in consecutive octads and DQ[31:24] and DQ[23:16] pairs have to be placed in consecutive octads.
      5. Component Interfaces: DM_n is mapped to pin 6.
      6. DIMM Interfaces: DM_n is fixed to pin 2 of one of the octads in an octad pair.
  3. All DQ/DM_n/DQS pins are fixed with the following swapping allowed:
    1. DDR5 DQ bit swap:
      1. DQ bits within a nibble can be swapped for x4 based interfaces.
        Table 1. Example of DQ Bits swapped within Nibble
        Package Pin Name Un-swapped x4 Swapped x4 Notes
        IO_L0P_H0O0P0_M0P0_700 DQ0 DQ3  
        IO_L0N_H0O0P1_M0P1_700 DQ1 DQ2  
        IO_L1P_XCC_H0O0P2_M0P2_700 DQS0_t DQS0_t Cannot move
        IO_L1N_XCC_H0O0P3_M0P3_700 DQS0_c DQS0_c Cannot move
        IO_L2P_H0O0P4_M0P4_700 DQ2 DQ1  
        IO_L2N_H0O0P5_M0P5_700 DQ3 DQ0  
        IO_L3P_GC_H0O0P6_M0P6_700 CS_0[0] CS_0[0] Cannot swap
        IO_L3N_GC_H0O0P7_M0P7_700 CA_0[0] CA_0[0] Cannot swap
      2. DQ bits within a byte can be swapped for x8/x16 based interfaces.
        Table 2. Example of DQ Bits swapped within Byte
        Package Pin Name Un-swapped x8 Swapped x8 Notes
        IO_L0P_H0O0P0_M0P0_700 DQ0 DQ5  
        IO_L0N_H0O0P1_M0P1_700 DQ1 DQ7  
        IO_L1P_XCC_H0O0P2_M0P2_700 DQS0_t DQS0_t Cannot move
        IO_L1N_XCC_H0O0P3_M0P3_700 DQS0_c DQS0_c Cannot move
        IO_L2P_H0O0P4_M0P4_700 DQ2 DQ6  
        IO_L2N_H0O0P5_M0P5_700 DQ3 DQ4  
        IO_L3P_GC_H0O0P6_M0P6_700 DM_n[0] DM_n[0] Cannot swap
        IO_L3N_GC_H0O0P7_M0P7_700 CS_0[0] CS_0[0] Cannot swap
        IO_L4P_H0O1P0_M0P8_700 DQ4 DQ0  
        IO_L4N_H0O1P1_M0P9_700 DQ5 DQ2  
        IO_L5P_XCC_H0O1P2_M0P10_700 CA_0[0] CA_0[0] Cannot swap
        IO_L5N_XCC_H0O1P3_M0P11_700      
        IO_L6P_H0O1P4_M0P12_700 DQ6 DQ3  
        IO_L6N_H0O1P5_M0P13_700 DQ7 DQ1  
        IO_L7P_H0O1P6_M0P14_700 CA_0[1] CA_0[1] Cannot swap
        IO_L7N_H0O1P7_M0P15_700 CA_0[2] CA_0[2] Cannot swap
    2. DDR5 DQ nibble/byte swap:
      1. x8 based component interfaces: Any byte can be swapped with any other byte for x8 based component interfaces.
      2. x4 based component interfaces: Any nibble can be swapped with any other nibble for x4 based component interfaces.
      3. x16 based component interfaces: Only complete swap of one x16 with another x16 is allowed. Swapping one byte (8-bits) from a x16 with one byte from another x16 is not allowed.
        • Example of swapping between two x16 byte pairs:
          • DQ[15:0], associated DQS and associated DM_n are placed in octads 0, 1, 2, and 3 of Bank x
          • DQ[31:16], associated DQS and associated DM_n are placed in octads 0, 1, 2, and 3 of Bank x+1
          • Only a complete swap of DQ[15:0] (and its associated DQS, DM_n) with DQ[31:16] (and its associated DQS, DM_n) is allowed. Resulting in DQ[15:0] (and its associated DQS, DM_n) being placed in octads 0, 1, 2, and 3 of Bank x+1. And DQ[31:16] (and its associated DQS, DM_n) being placed in octads 0, 1, 2, and 3 of Bank x after the swap.
          • Swapping a single nibble or byte from DQ[15:0] with a single byte or nibble from DQ[31:16] is not allowed.
        • Example of swapping within a x16 byte pair:
          • DQ[15:0], associated DQS and associated DM_n are placed in octads 0, 1, 2, and 3 of Bank x. Where DQ[7:0] is placed in octad 0 and 1, and DQ[15:8] is placed in octad 2 and 3.
          • DQ[31:16], associated DQS and associated DM_n are placed in octads 0, 1, 2, and 3 of Bank x+1. Where DQ[23:16] is placed in octad 0 and 1, and DQ[31:24] is placed in octad 2 and 3.
          • Swapping DQ[7:0] with DQ[15:8] is allowed. Resulting in DQ[7:0] being placed in octad 2 and 3. And DQ[15:8] being placed in octad 0 and 1 after the swap.
          • Similarly swapping DQ[23:16] with DQ[31:24] results in DQ[23:16] being placed in octad 2 and 3, and DQ[31:24] being placed in octad 0 and 1.
      4. The signals included in swapping nibble or byte are: DQ bits, associated DQS and associated DM_n. In addition:
        • DQ bits in one nibble or byte can only be swapped with DQ bits in the other nibble or byte
        • DQS pair in one nibble or byte can only be swapped with the DQS pair in the other nibble or byte
        • DM_n in one byte can only be swapped with DM_n in the other byte
        • Example:
          • Octad 0 has DM_n_0 and DQ[3:0], Octad 1 has DQS_0 and DQ[7:4]
          • Octad 2 has DQS4 and DQ[39:36], Octad 3 has DM_n_4 and DQ[35:32]
          • When swapping byte DQ[7:0] with byte DQ[39:32], DQS_0 must be placed in Octad 2 and DQS_4 must be placed in Octad 1. DM_n_0 must be placed in Octad 3 and DM_n_4 must be placed in Octad 0.
      5. When swapping nibbles or bytes or byte pairs, Address/Command/Control bits remain fixed.
      6. x8 based DIMM: swap of any byte with any other byte within a DIMM channel is allowed. Byte swaps are only allowed within 12 octads (or three X5PHIO banks) that are associated with a single DDRMC5.
      7. x4 based DIMM: swap of any byte with any other byte, and swap of nibbles within bytes is only allowed within a DIMM channel. Byte swaps or nibble swaps within a byte are only allowed within 12 octads (or three X5PHIO banks) that are associated with a single DDRMC5.
        • Example of byte swapping:
          • DQ[3:0] and associated DQS are placed in octad 0, DQ[7:4] and associated DQS are placed in octad 1
          • DQ[11:8] and associated DQS are placed in octad 2, DQ[15:12] and associated DQS are placed in octad 3
          • Only a complete swap of DQ[7:0] (nibbles DQ[3:0] and DQ[7:4]) with DQ[15:8] (nibbles DQ[11:8] and DQ[15:12]) is allowed.
        • Example of swapping nibbles within a byte:
          • DQ[3:0] and associated DQS are placed in octad 0, DQ[7:4] and associated DQS are placed in octad 1
          • DQ[11:8] and associated DQS are placed in octad 2, DQ[15:12] and associated DQS are placed in octad 3
          • Swapping of DQ[3:0] with DQ[7:4] is allowed within a byte
          • Swapping of DQ[11:8] with DQ[15:12] is allowed within a byte
      8. x4 based DIMM: swap of a single nibble with another nibble outside the byte is not allowed.
        • Example of nibble swapping that is not allowed:
          • DQ[3:0] and associated DQS are placed in octad 0, DQ[7:4] and associated DQS are placed in octad 1
          • DQ[11:8] and associated DQS are placed in octad 2, DQ[15:12] and associated DQS are placed in octad 3
          • Swapping DQ[3:0] with DQ[11:8] while keeping DQ[7:4] and DQ[15:12] unswapped is not allowed
          • Similarly, swapping DQ[7:4] with DQ[15:8] while keeping DQ[3:0] and DQ[11:8] un-swapped is not allowed
      9. RDIMM designs intended to support both x4 and x8 RDIMMs must follow all rules for x4 and x8 DIMMs. If the same pinout is to be used for x4 and x8 RDIMMs, the pinout must be verified with both x4 rules and x8 rules.
      10. x16 based DIMM: Only complete swap of one x16 (byte pair) with another x16 (byte pair) is allowed. Swapping one byte (8-bits) from a x16 with one byte from another x16 is not allowed. Additionally, byte pair swaps are restricted to occur only within the 12 octads (that is, three X5PHIO banks) associated with a single DDRMC5. Cross-channel byte pair swapping between different DDRMC5 instances is not supported. Refer to rule 3.b.iii.
  4. DQ, associated DQS, and DM_n must be placed in an octad or consecutive octad pairs such as 0/1, 2/3
    1. For x8/x16 devices:
      1. DQ[7:0], DQS[0], DM_n[0] must be placed in consecutive octad pairs such as 0/1, 2/3, 4/5, 6/7 of Bank
      2. DQ[15:8], DQS[1], DM_n[1] must be placed in consecutive octad pairs such as 0/1, 2/3, 4/5, 6/7 of Bank
    2. For x4 devices:
      1. DQ[3:0] and DQS[0] must be placed in a single octad of Bank
      2. DQ[7:4] and DQS[1] must be placed in a single octad of Bank
  5. RDIMM signals: LBDQ/LBDQS pin rules:
    1. LBDQ must be mapped to Channel-A and LBDQS must be mapped to Channel-B.
    2. LBDQ and LBDQS cannot be swapped. LBDQ and LBDQS must be associated with their respective channels.
  6. In X5PHIO bank 700 and bank 800 (not present in all devices), there is an additional bank pin that is used as a reference to calibrate internal on-die termination. The IO_VR_700/IO_VR_800 pin must be externally connected to a 240Ω resistor on the PCB and pulled up to the bank VCCO voltage.
  7. One differential system clock source (sys_clk or ref_clk) is required per integrated DDRMC5 and must be placed on a clock capable pin pair.
    • A single differential system clock source can be shared between adjacent DDRMC5_0 and DDRMC5_1
    • A single differential system clock source cannot be shared between DDRMC5_1 and DDRMC5_2
    • A single differential system clock source can be shared for DIMM interfaces that use a pair of adjacent DDRMC5 controllers
  8. DIMMs are placed in six consecutive banks, hence the sys_clk is placed in the middle two banks.
  9. For components with a single MC interface the sys_clk can be placed in any of the banks where the interface is located.
    Example
    In a design with an interface occupying Bank 700,701,702, the sys_clk can be placed in either of the three banks. Similarly for an interface in the next three consecutive banks (703,704,705) the sys_clk can be placed in any of the three banks.
    Example
    In a design with an interface occupying Banks 700 and 701, the sys_clk can be placed in Bank 700,701, or 702. Similarly, for an interface occupying Banks 703 and 704 the sys_clk can be placed in 703, 704, or 705.
    Note: Allowed combinations for six consecutive banks are Banks '700, 701, 702, 703, 704,705' and Banks '706,707,708,709,710,711'
  10. In a design with two interfaces occupying six consecutive banks and no sys_clk sharing, the sys_clk can be placed in the respective banks of each interface. The sys_clk can also be placed in the adjacent bank of the other interface.
    Note: This rule only applies to above mentioned six consecutive bank configuration.
    Example
    In a design with an interface occupying Bank 706, 707, and 708 and the second interface occupying Bank 709, 710 and 711:
    • sys_clk of the first interface can be placed in Bank 706, 707 or 708
    • sys_clk of the second interface can be placed in Bank 709, 710, or 711
    • sys_clk of the first interface can be placed in Bank 709 and sys_clk of second interface can be placed in Bank 708
  11. In a design with two interfaces occupying six consecutive banks with sys_clk sharing, the sys_clk must be placed in the middle two banks of the six bank interface.
    Note: sys_clk sharing is only allowed in the above mentioned six consecutive bank configuration.
    Example
    In a design with an interface occupying Banks 706, 707, and 708 and the second interface occupying Banks 709, 710, and 711:
    • With sys_clk sharing, the sys_clk can be placed in either Bank 708 or 709.
  12. Unused pins in an octad can be utilized for non-memory designs for route through only.
  13. Multi-component interfaces must use same data width components. For example, a 32-bit interface can use four x8 components or two x16 components. A 40-bit interface can use five x8 components, but cannot be implemented with x16 components. A 40-bit interface made up of x16 components would have 8 bits unused in one of the components. This would cause DDR5 on-die ECC to mis-correct perceived ECC errors, resulting in data corruption.
  14. For RDIMM and CUDIMM memory interfaces, you must enable the PMC I2C port and connect the HSA, HSCL, and HSDA signals between the Versal Adaptive SoC and the DIMM. Refer to Versal Adaptive SoC PCB Design User Guide (UG863) and DDR5 PMIC I2C/I3C Interface.