Technical guide

PCIe Link Training and LTSSM Explained: Detect, Polling, Configuration, L0, and Recovery

Understand how PCIe links detect devices, train lanes, negotiate width and speed, reach L0, retrain through Recovery, and why a lower negotiated link is evidence rather than a diagnosis.

On this page
  1. PCIe has to establish a working link before normal traffic can flow
  2. Detect answers the first electrical question: is a receiver present?
  3. Polling and Configuration turn detected lanes into a coherent link
  4. L0 is the normal active state
  5. Recovery is normal machinery for retraining and speed changes
  6. Maximum capability and negotiated link state are different facts
  7. Link training is separate from ASPM and device power states
  8. Use LTSSM evidence as a map when troubleshooting a marginal PCIe path

PCIe has to establish a working link before normal traffic can flow

A PCI Express card fitting into a slot is only the physical starting point. The two ends of the connection still have to detect one another, establish signaling, configure usable lanes and reach an operational link state before normal PCIe traffic can flow.

The Physical Layer coordinates that process with the Link Training and Status State Machine, usually shortened to LTSSM. Intel describes link training as an automatic Physical Layer process that configures and initializes the link without software intervention. When training succeeds, the LTSSM reaches the normal active L0 state.

The main LTSSM states are stages of a link lifecycle, not performance modes
StatePrimary roleWhat it tells you
DetectLook for a link partner / receiverWhether the electrical path can see a partner
PollingExchange training sequences and establish low-level synchronizationTraining communication has begun
ConfigurationEstablish the usable link configuration and lanesThe two sides are converging on a working link
L0Normal active operationThe trained link is up and can carry normal traffic
RecoveryRetrain, recover, or change link operating conditionsThe link is re-establishing normal operation
L0s / L1 / deeper power statesReduce link power under supported policiesPower management, not initial device detection
Disabled / Hot Reset / LoopbackSpecial control, reset, or test behaviorNot ordinary active data transfer

Detect answers the first electrical question: is a receiver present?

The LTSSM begins by determining whether a link partner is present on the electrical path. Receiver detection happens per lane, which matters because a physically wide connector does not guarantee that every lane is actually available or usable.

A failure to progress beyond Detect therefore points toward the link-establishment path, but it does not identify one failed component by itself. Slot routing, a riser, connector seating, endpoint power, the root port, board design, or the endpoint can all affect whether a receiver is detected.

Polling and Configuration turn detected lanes into a coherent link

After detection, Polling uses PCIe training sequences to establish the low-level communication needed for further configuration. Configuration then organizes the usable lanes into the link configuration. PCI-SIG troubleshooting material and Intel's PCIe documentation show these states as the normal path toward L0.

This is why a PCIe link is negotiated rather than inferred from the connector label. The platform and endpoint have capabilities, but the operating link is the configuration that successfully trains across the complete path.

L0 is the normal active state

When link training completes successfully, the LTSSM should settle in L0 during normal active operation. Intel's Link Inspector documentation notes that a stable L0 link does not generate new LTSSM transition records because there is no state transition to capture.

L0 should not be confused with a PCIe generation. A link can be in L0 while operating at different negotiated speeds and widths. The LTSSM state describes what the link is doing; generation and lane width describe the negotiated transport configuration.

Recovery is normal machinery for retraining and speed changes

Recovery does not automatically mean the device is failing. It is the LTSSM family used when an established link needs to retrain or change operating conditions. A healthy link can enter Recovery and return to L0.

Repeated or persistent Recovery activity can still be valuable diagnostic evidence when paired with a reproducible symptom. The important distinction is between observing a state transition and assigning a root cause: LTSSM history localizes where the link is spending time, but additional electrical, topology, firmware, error-log, and device evidence is needed to explain why.

Maximum capability and negotiated link state are different facts

PCIe devices and ports expose capability information as well as current link status. Microsoft documents the PCI Express Link Status register as reporting negotiated link speed and negotiated link width, while the Link Training bit indicates configuration/recovery activity or a pending retrain condition.

A device capable of a newer generation or wider link can therefore operate at a lower negotiated speed or width. That can be intentional because of slot wiring or topology, or it can be a symptom of a marginal path or configuration problem. The negotiated result alone does not tell you which explanation applies.

Link training is separate from ASPM and device power states

LTSSM includes low-power link states, but PCIe link training should not be collapsed into Active State Power Management. ASPM policy governs supported idle link-power transitions such as L0s and L1; initial detection, configuration, normal L0 operation, and Recovery are broader parts of the link lifecycle.

Device-level power states are another layer again. A GPU, NVMe SSD, network adapter, or other endpoint can have internal power-management behavior while its PCIe connection has its own link state. Keeping those layers separate prevents a power-state observation from being misread as a lane-training failure.

Use LTSSM evidence as a map when troubleshooting a marginal PCIe path

For ordinary PC troubleshooting, start with the observable result: whether the device enumerates, the negotiated speed and width, whether errors or disconnects occur, and whether the behavior changes after sleep, under load, or with a riser removed. Check the exact motherboard topology and endpoint specification before changing firmware controls.

On engineering and FPGA platforms that expose LTSSM traces, the state history provides a much finer map. Intel's current Link Inspector can capture state transitions, while PCI-SIG troubleshooting material uses LTSSM flow analysis to inspect link-training behavior. That evidence can narrow the stage of failure, but it still should not be turned into a universal consumer-PC diagnosis without the rest of the link context.

Sources

Primary and technical sources

Technical details can vary by exact model, firmware, and platform. These are the sources used for the factual claims in this article.

  1. 01 Intel

    Link Inspector — PCIe LTSSM transition capture
  2. 02 Intel

    Link Training — PCI Express Physical Layer initialization
  3. 03 PCI-SIG

    Troubleshooting PCI Express Link Training and Protocol Issues
  4. 04 Microsoft Learn

    PCI Express Link Status Register
  5. 05 Linux kernel documentation

    PCI subsystem trace points: PCIe link events

Related

Compatibility & upgrades

PCIe 5.0 vs PCIe 4.0: Bandwidth and Compatibility

Compare PCIe 5.0 and PCIe 4.0 at the link level: 32 vs 16 GT/s, lane bandwidth, x4/x8/x16 scaling, backward compatibility, link negotiation, and what the generation label does not guarantee.