Linux多MSI向量问题：pci_alloc_irq_vectors仅返回1个但设备支持8个

我之前在做FPGA PCIe驱动开发时也碰到过类似的多MSI向量分配问题，结合你的场景（1X PCIe Gen2端点、Ubuntu 16.04 LTS 4.10内核），给你梳理几个排查和解决的关键方向：

1. 确认中断类型参数的正确性 #

你的设备明确支持多消息MSI（8个中断），但你调用pci_alloc_irq_vectors时同时传入了PCI_IRQ_MSI | PCI_IRQ_MSIX——这两个标志在多数内核版本中是互斥的，内核会优先尝试初始化MSI-X，如果设备不支持MSI-X，才会回退到MSI，但这种混合标志的写法可能导致内核对MSI的多消息支持识别异常。

建议先修改调用参数，只指定PCI_IRQ_MSI，把PCI_IRQ_MSIX去掉：

irq_qty = pci_alloc_irq_vectors(dev, 1, 8, PCI_IRQ_MSI | PCI_IRQ_AFFINITY);

2. 验证硬件侧的MSI配置是否正确 #

FPGA PCIe端点的MSI能力很容易因为配置错误导致内核无法识别全部向量，你可以通过以下步骤验证：

• 用lspci -vvv -s <你的设备BDF>查看PCI配置空间，找到MSI相关的字段，比如：

  MSI: Enable+ Count=8/8 Maskable- 64bit+
  这里的Count=8/8表示硬件支持的最大MSI向量数是8，如果显示的是Count=1/8或者更小，说明你的FPGA端点的MSI Capability寄存器没有正确配置成8个向量，需要修改FPGA的PCIe核配置。

• 确认PCIe链路训练正常：同样在lspci输出中找LnkSta:字段，确保显示Speed=5GT/s, Width=x1（符合Gen2 x1的规格），链路训练失败会导致PCIe功能被限制。

3. 检查系统级的MSI限制 #

Ubuntu 16.04的4.10内核可能存在默认的MSI向量分配限制，你可以做以下检查：

• 查看内核启动参数：执行cat /proc/cmdline，确认没有pci=nomsi、msi=limit=1这类限制MSI的参数；
• 查看系统已分配的MSI中断：执行cat /proc/interrupts，统计以MSI开头的中断数量，确认系统还有剩余的MSI向量可以分配（老内核对MSI总数量有一定限制）。

4. 手动初始化MSI向量（备选方案） #

如果pci_alloc_irq_vectors始终只能分配1个向量，可以尝试绕过这个封装函数，手动初始化MSI：

int ret;
// 启用1-8个MSI向量
ret = pci_enable_msi_range(dev, 1, 8);
if (ret < 0) {
    dev_err(&dev->dev, "Failed to enable MSI range\n");
    return ret;
}
// 获取每个向量的irq号并注册处理函数
for (int i = 0; i < ret; i++) {
    int irq = pci_irq_vector(dev, i);
    if (irq < 0) {
        dev_err(&dev->dev, "Failed to get irq vector %d\n", i);
        continue;
    }
    ret = request_irq(irq, your_irq_handler, IRQF_SHARED, "fpga-msi-%d", your_data);
    if (ret < 0) {
        dev_err(&dev->dev, "Failed to request irq %d\n", irq);
        // 清理已注册的中断
        for (int j = 0; j < i; j++) {
            free_irq(pci_irq_vector(dev, j), your_data);
        }
        pci_disable_msi(dev);
        return ret;
    }
}

这种方式更直接，但需要你手动处理中断的启用、注册和清理流程。

总结 #

优先排查FPGA硬件的MSI配置和驱动的中断类型参数，这两个是导致向量分配不足的最常见原因。如果都没问题，再检查系统级的MSI限制，最后尝试手动初始化方案。

内容的提问来源于stack exchange，提问作者Riton38