读取 LTSSM 状态寄存器——初诊第一手

链路训练出问题，你第一步该干什么？

我个人习惯——先读 LTSSM 状态寄存器。

为什么？因为这玩意儿直接告诉你，卡在哪个状态了。Detect、Polling、Configuration……就像病人告诉医生“我头疼”，你立刻知道往哪排查。

读哪里？地址与访问方法

状态寄存器藏在 PCIe 配置空间的 PCI Express Capability 结构里。具体偏移看下面这张表：

访问方式有两种：

• 通过 lspci：lspci -vvv -s 01:00.0 | grep -i “LnkSta”。会显示类似 LnkSta: Speed 8GT/s, Width x4, … LTSSM: L0。我一般先用这个快速看一眼。
• 直接 MMIO 读：通过 /sys/devices/pciXXXX/XXXX/resource 或 mmap 映射物理地址。适合写自动化测试脚本。

举个例子（Linux 用户空间读取代码）：

#include <stdio.h>
#include <fcntl.h>
#include <sys/mman.h>
#include <unistd.h>

int main(int argc, char *argv[]) {
    // 假设已知 RC 端配置空间基地址为 0xE0000000
    unsigned long base = 0xE0000000;
    int fd = open("/dev/mem", O_RDWR);
    if (fd < 0) { perror("open"); return 1; }

    void *map = mmap(NULL, 4096, PROT_READ, MAP_SHARED, fd, base);
    if (map == MAP_FAILED) { perror("mmap"); return 1; }

    // 读取偏移 0x12 处的 2 字节 (Link Status Register)
    unsigned short link_status = *(volatile unsigned short *)(map + 0x12);
    unsigned char ltssm_state = (link_status >> 9) & 0x0F;

    printf("LTSSM state code: 0x%X\n", ltssm_state);
    close(fd);
    return 0;
}

状态码怎么解读？

拿到数值后，对照 PCIe 规范查表。下面是最常见的状态码：

实战案例：从状态码直接定位故障

有一次我调试一块 FPGA 加的 PCIe EP 卡。上电后 lspci 读不到设备。

我自己写了个内核模块，定时读 Link Status Register。发现状态码一直在 0x2 (Configuration) 和 0x7 (Recovery) 之间跳。这明显不正常。

为什么？因为在 Configuration 阶段，两端交换链路能力参数。如果一边说“我能跑 Gen4 x8”，另一边只认“Gen3 x4”，就可能反复协商失败回退。我查了 EP 的配置寄存器，发现它的 Max Link Speed 被错误设成了 0xF（保留值），导致 RC 没法识别。这就是个典型的寄存器配置 bug。

还有个例子——状态码停在 0x0 (Detect)。嗯，先检查时钟。拿示波器一看，REFCLK 对端根本就没有输出。所以，先读状态码，再对照这个常见问题清单，效率高很多。

SVG 流程图：读取 LTSSM 状态寄存器调试主线

总结几行实用口诀

• Detect 不动 – 查供电、复位、REFCLK。
• Polling 卡死 – 查差分信号极性、交流耦合电容。
• Configuration 来回跳 – 查 Capability 寄存器里 Max Link Speed/Width 是否匹配。
• Recovery 反复进出 – 查链路噪声、参考时钟抖动、去加重设置。