4. VxWorks PCI子系统架构

VxWorks 的 PCI 子系统为嵌入式开发者提供了一套标准化的软件抽象层，用于访问 PCI/PCIe 设备的配置空间、内存空间和 I/O 空间。本章深入剖析 pciConfigLib 库的核心接口，包括设备扫描函数 pciFindDevice() 以及配置读写函数 pciReadConfig() / pciWriteConfig()，帮助您建立从硬件寄存器到软件 API 的完整映射。

4.1 PCI 子系统软件分层

VxWorks PCI 软件栈分为三层，每一层都承担特定的职责，并通过清晰的接口向上层提供服务。

4.2 pciFindDevice()：设备枚举与定位

pciFindDevice() 是 VxWorks 中最常用的 PCI 设备查找函数。它通过遍历 PCI 总线树，匹配 Vendor ID 和 Device ID，返回目标设备的总线号、设备号和功能号。

函数原型

STATUS pciFindDevice
    (
    UINT16  vendorId,       /* 厂商 ID */
    UINT16  deviceId,       /* 设备 ID */
    UINT16  index,          /* 匹配索引（从 0 开始） */
    UINT32  *pBusNo,        /* 返回：总线号 */
    UINT32  *pDeviceNo,     /* 返回：设备号 */
    UINT32  *pFuncNo        /* 返回：功能号 */
    )

参数说明

典型用法示例

UINT32  busNo, devNo, funcNo;
STATUS  status;

/* 查找系统中第一个 Vendor ID=0x10EE, Device ID=0x7021 的 PCIe 设备 */
status = pciFindDevice(0x10EE, 0x7021, 0, &busNo, &devNo, &funcNo);

if (status == OK)
    {
    printf("设备位于 BDF: %02x:%02x.%x\n", busNo, devNo, funcNo);
    }
else
    {
    printf("未找到匹配设备\n");
    }

4.3 pciReadConfig() / pciWriteConfig()：配置空间访问

一旦通过 pciFindDevice() 获取了设备的 BDF（Bus:Device.Function），就可以使用 pciReadConfig() 和 pciWriteConfig() 直接访问该设备的 PCI 配置空间寄存器。

函数原型

STATUS pciReadConfig
    (
    UINT32  busNo,          /* 总线号 */
    UINT32  deviceNo,       /* 设备号 */
    UINT32  funcNo,         /* 功能号 */
    UINT32  offset,         /* 配置空间偏移地址（0x00 ~ 0xFF） */
    UINT32  *pData          /* 输出：读取到的 32 位数据 */
    );

STATUS pciWriteConfig
    (
    UINT32  busNo,          /* 总线号 */
    UINT32  deviceNo,       /* 设备号 */
    UINT32  funcNo,         /* 功能号 */
    UINT32  offset,         /* 配置空间偏移地址（0x00 ~ 0xFF） */
    UINT32  data            /* 待写入的 32 位数据 */
    );

常用配置空间偏移地址

实战：读取并打印 BAR0 地址

UINT32  bar0Value;
STATUS  status;

/* 读取 BDF=0:0:0 设备的 BAR0（偏移 0x10） */
status = pciReadConfig(0, 0, 0, 0x10, &bar0Value);

if (status == OK)
    {
    printf("BAR0 = 0x%08X\n", bar0Value);

    /* 判断 BAR 类型：bit0 == 0 表示 Memory Space，bit0 == 1 表示 I/O Space */
    if (bar0Value & 0x01)
        printf("  → I/O Space\n");
    else
        printf("  → Memory Space\n");
    }
else
    {
    printf("配置空间读取失败\n");
    }

4.4 综合实战：完整设备初始化流程

以下代码演示了从设备查找到配置空间读写，再到 BAR 地址转换的完整流程。这是 VxWorks PCIe 驱动开发的标准模板。

#include <vxWorks.h>
#include <pci.h>
#include <sysLib.h>

STATUS pcieDeviceInit
    (
    UINT16 vendorId,
    UINT16 deviceId
    )
    {
    UINT32  busNo, devNo, funcNo;
    UINT32  bar0Value, bar0Addr;
    UINT32  cmdReg;
    STATUS  status;

    /* 步骤 1：查找设备 */
    status = pciFindDevice(vendorId, deviceId, 0, &busNo, &devNo, &funcNo);
    if (status != OK)
        {
        printf("设备 0x%04X:0x%04X 未找到\n", vendorId, deviceId);
        return ERROR;
        }

    /* 步骤 2：读取 BAR0 */
    status = pciReadConfig(busNo, devNo, funcNo, 0x10, &bar0Value);
    if (status != OK)
        {
        printf("BAR0 读取失败\n");
        return ERROR;
        }

    /* 步骤 3：将 BAR0 中的总线地址转换为 CPU 本地地址 */
    bar0Addr = sysBusToLocalAdrs(bar0Value & 0xFFFFFFF0);

    printf("设备 BDF: %02x:%02x.%x\n", busNo, devNo, funcNo);
    printf("BAR0 原始值: 0x%08X\n", bar0Value);
    printf("BAR0 本地地址: 0x%08X\n", bar0Addr);

    /* 步骤 4：使能 Memory Space 和 Bus Master */
    status = pciReadConfig(busNo, devNo, funcNo, 0x04, &cmdReg);
    if (status != OK)
        {
        printf("Command 寄存器读取失败\n");
        return ERROR;
        }

    cmdReg |= 0x06;   /* 设置 bit1 (Memory Space) 和 bit2 (Bus Master) */
    status = pciWriteConfig(busNo, devNo, funcNo, 0x04, cmdReg);
    if (status != OK)
        {
        printf("Command 寄存器写入失败\n");
        return ERROR;
        }

    printf("设备初始化完成\n");
    return OK;
    }

4.5 常见错误与调试技巧