3. PCI/PCIe设备接口适配

在QNX实时操作系统下进行PCI/PCIe设备驱动开发，核心在于对PCI配置空间的正确访问、对基地址寄存器（BAR）空间的物理地址映射、中断资源的获取与绑定，以及对整个PCI总线拓扑的扫描与设备树管理。本章将围绕这四个关键环节，结合QNX特有的pci_*接口与io-pkt框架，提供完整的实战适配方案。

3.1 PCI配置空间访问：标准机制与QNX封装

PCI配置空间是每个PCI功能设备必须实现的256字节（PCIe扩展至4KB）寄存器集合，用于识别设备类型、控制资源分配与状态查询。QNX通过pci_attach_device()与pci_read_config*()/pci_write_config*()系列函数提供标准访问接口。

3.1.1 配置空间关键寄存器布局

3.1.2 QNX配置空间访问示例

#include <hw/pci.h>
#include <sys/mman.h>

/* 设备句柄与配置空间访问 */
pci_handle_t   hdl;
uint16_t       vendor_id, device_id;
uint32_t       bar0_raw;

/* 1. 通过vendor/device ID挂载设备 */
hdl = pci_attach_device(0, PCI_SHARE, 0, 0x8086, 0x10D3, 0);
if (hdl == NULL) {
    fprintf(stderr, "pci_attach_device failed\n");
    return -1;
}

/* 2. 读取Vendor ID与Device ID */
vendor_id = pci_read_config16(hdl, PCI_VENDOR_ID, NULL);
device_id = pci_read_config16(hdl, PCI_DEVICE_ID, NULL);
printf("Detected: %04x:%04x\n", vendor_id, device_id);

/* 3. 读取BAR0原始值（含低位属性位） */
bar0_raw = pci_read_config32(hdl, PCI_BAR0, NULL);
printf("BAR0 raw: 0x%08X\n", bar0_raw);

/* 4. 使能总线主控与内存空间 */
uint16_t cmd = pci_read_config16(hdl, PCI_COMMAND, NULL);
cmd |= (PCI_COMMAND_MEMORY | PCI_COMMAND_MASTER);
pci_write_config16(hdl, PCI_COMMAND, cmd);

3.2 BAR空间映射：物理地址到虚拟地址的转换

BAR（Base Address Register）定义了设备在PCI地址空间中的资源窗口。驱动需要将BAR中的物理地址映射到QNX进程的虚拟地址空间，才能通过内存访问指令直接操作设备寄存器。

3.2.1 BAR类型与地址解析

3.2.2 QNX BAR映射实战代码

/* 从BAR0获取物理基地址与大小 */
uint64_t    paddr, size;
uint32_t    bar_low, bar_high;
uintptr_t   vaddr;

bar_low = pci_read_config32(hdl, PCI_BAR0, NULL);

/* 判断是否为64位Memory BAR */
if ((bar_low & 0x06) == 0x04) {  /* 64-bit */
    bar_high = pci_read_config32(hdl, PCI_BAR1, NULL);
    paddr = ((uint64_t)bar_high << 32) | (bar_low & ~0x0F);
    /* 获取BAR大小：写全1再读回 */
    pci_write_config32(hdl, PCI_BAR0, 0xFFFFFFFF);
    uint32_t mask_low = pci_read_config32(hdl, PCI_BAR0, NULL);
    pci_write_config32(hdl, PCI_BAR1, 0xFFFFFFFF);
    uint32_t mask_high = pci_read_config32(hdl, PCI_BAR1, NULL);
    pci_write_config32(hdl, PCI_BAR0, bar_low);
    pci_write_config32(hdl, PCI_BAR1, bar_high);
    size = ~(((uint64_t)mask_high << 32) | (mask_low & ~0x0F)) + 1;
} else {  /* 32-bit Memory 或 I/O */
    paddr = bar_low & ~0x0F;
    pci_write_config32(hdl, PCI_BAR0, 0xFFFFFFFF);
    uint32_t mask = pci_read_config32(hdl, PCI_BAR0, NULL);
    pci_write_config32(hdl, PCI_BAR0, bar_low);
    size = ~(mask & ~0x0F) + 1;
}

/* 映射到进程虚拟地址空间 */
vaddr = mmap_device_memory(0, size,
                           PROT_READ | PROT_WRITE | PROT_NOCACHE,
                           0, paddr);
if (vaddr == MAP_DEVICE_FAILED) {
    perror("mmap_device_memory failed");
    return -1;
}
printf("BAR0 mapped: phys=0x%llx virt=0x%lx size=%llu\n",
       paddr, vaddr, size);

3.3 中断号获取：INTx、MSI与MSI-X

PCI设备支持三种中断模型：传统INTx（共享中断线）、MSI（Message Signaled Interrupt）和MSI-X（扩展MSI）。QNX通过InterruptAttach()/InterruptAttachEvent()绑定中断服务例程（ISR），中断号来源因模型而异。

3.3.1 中断号获取方式对比

3.3.2 MSI-X中断绑定示例

/* 1. 检查并启用MSI-X */
int         msix_count;
uint16_t    msix_cap;

msix_cap = pci_find_cap(hdl, PCI_CAP_MSIX, NULL);
if (msix_cap == 0) {
    fprintf(stderr, "MSI-X not supported\n");
    return -1;
}

/* 2. 获取MSI-X表信息（BAR索引、偏移、条目数） */
pci_msix_table_info_t table_info;
pci_msix_get_table_info(hdl, &table_info);
printf("MSI-X Table: BAR%d offset=0x%x entries=%d\n",
       table_info.bar_index, table_info.offset, table_info.entries);

/* 3. 映射MSI-X Table所在的BAR空间 */
uintptr_t msix_table_vaddr = mmap_device_memory(0,
    table_info.entries * 16 + 0x1000,
    PROT_READ | PROT_WRITE | PROT_NOCACHE,
    0, pci_read_bar_addr(hdl, table_info.bar_index));

/* 4. 为每个队列绑定中断 */
for (int i = 0; i < table_info.entries; i++) {
    int irq = pci_msix_attach(hdl, i, 0);
    if (irq == -1) {
        fprintf(stderr, "MSI-X attach failed for vector %d\n", i);
        continue;
    }
    /* 绑定ISR */
    InterruptAttach(irq, my_isr, (void *)(uintptr_t)i, 0, 0);
    printf("MSI-X vector %d bound to IRQ %d\n", i, irq);
}

3.4 设备树与PCI拓扑扫描

QNX不直接使用Device Tree（FDT）来描述PCI拓扑，而是通过运行时扫描PCI总线，动态构建设备树。驱动开发者需要理解pci_scan_bus()、pci_find_device()等接口，并结合io-pkt或自定义资源管理器完成设备枚举。

3.4.1 PCI拓扑扫描步骤

1. 初始化PCI子系统：调用pci_attach(0)初始化PCI库，加载PCI BIOS或ECAM配置空间访问方法。
2. 枚举总线与设备：使用pci_find_device()遍历所有总线/设备/功能，或通过pci_scan_bus()递归扫描桥接设备。
3. 读取设备树信息：对每个设备读取Vendor ID、Device ID、Class Code、Subsystem ID等，构建设备节点。
4. 资源分配与冲突检测：检查BAR地址是否重叠，中断号是否已被占用，必要时重新分配。
5. 驱动匹配与加载：将设备节点与驱动列表匹配，调用驱动的probe()函数完成初始化。

3.4.2 自定义PCI拓扑扫描代码

/* 递归扫描PCI总线 */
void scan_pci_bus(int bus) {
    for (int dev = 0; dev < 32; dev++) {
        for (int func = 0; func < 8; func++) {
            pci_handle_t hdl = pci_attach_device(0, PCI_SHARE,
                bus, dev, func, 0);
            if (hdl == NULL) continue;

            uint16_t vendor = pci_read_config16(hdl, PCI_VENDOR_ID, NULL);
            uint16_t device = pci_read_config16(hdl, PCI_DEVICE_ID, NULL);
            uint8_t  hdr_type = pci_read_config8(hdl, PCI_HEADER_TYPE, NULL);

            if (vendor == 0xFFFF) {
                pci_detach_device(hdl);
                continue;
            }

            printf("Bus %02d Dev %02d Func %d: %04x:%04x [hdr=0x%02x]\n",
                   bus, dev, func, vendor, device, hdr_type);

            /* 如果是PCI-to-PCI桥，递归扫描下游总线 */
            if ((hdr_type & 0x7F) == 0x01) {
                uint8_t secondary_bus = pci_read_config8(hdl,
                    PCI_SECONDARY_BUS, NULL);
                printf("  -> Bridge to bus %d\n", secondary_bus);
                scan_pci_bus(secondary_bus);
            }

            pci_detach_device(hdl);
        }
    }
}

/* 主函数调用 */
int main() {
    pci_attach(0);
    scan_pci_bus(0);  /* 从总线0开始扫描 */
    return 0;
}