qemu创建pci设备

### 创建和配置QEMU中的PCI设备

在QEMU中创建和配置PCI设备涉及几个关键步骤，这些步骤确保了设备能够被正确识别并与虚拟机交互。

#### 初始化PCI总线
为了使PCI设备能够在虚拟环境中正常运行，首先需要初始化PCI总线。这一过程通常由`pc_init1()`函数启动，在此期间会调用`i440fx_init()`来建立一个名为`pci_bus`的对象，并将其与ISA总线连接形成PCI-ISA桥[^3]。

PCIBus *i440fx_init(const char *device_name, int devfn,
                    MemoryRegion **pic_state)
{
    PCIDevice *d;
    
    d = pci_create_simple(pci_find_rootbus(), devfn, device_name);
    ...
}

#### 添加PCI设备到总线上
一旦有了可用的PCI总线实例，就可以通过定义特定类型的PCI设备并将其挂载至该总线上实现扩展功能。这一步骤可以通过提供相应的内存区域操作(`MemoryRegionOps`)以及设置必要的回调机制完成，使得新加入的硬件组件可以响应来自客户操作系统发出的各种请求[^1]。

static void my_pci_device_realize(PCIDevice *dev, Error **errp)
{
    MyState *s = MY_DEVICE(dev);

    memory_region_init_io(&s->mmio, OBJECT(s), &my_ops, s,
                          "my-device", SIZE);
    pci_register_bar(dev, 0, PCI_BASE_ADDRESS_SPACE_MEMORY,
                     &s->mmio);
}

static const VMStateDescription vmstate_my_device = {
    .name = "my-device",
    .version_id = 1,
    .minimum_version_id = 1,
    .fields      = (VMStateField[]) {
        /* ... */
        VMSTATE_END_OF_LIST()
    }
};

static Property my_properties[] = {
    DEFINE_PROP_UINT8("foo", MyState, foo, 0),
    DEFINE_PROP_END_OF_LIST(),
};

static void my_pci_device_class_init(ObjectClass *klass, void *data)
{
    DeviceClass *dc = DEVICE_CLASS(klass);
    PCIDeviceClass *k = PCI_DEVICE_CLASS(klass);

    k->realize = my_pci_device_realize;
    set_bit(DEVICE_CATEGORY_MISC, dc->categories);
    dc->vmsd = &vmstate_my_device;
    dc->props = my_properties;
}

static TypeInfo my_pci_device_info = {
    .name          = TYPE_MY_DEVICE,
    .parent        = TYPE_PCI_DEVICE,
    .instance_size = sizeof(MyState),
    .class_init    = my_pci_device_class_init,
};

上述代码片段展示了如何构建自定义PCI设备类及其属性描述符；同时指定了当此类对象实例化时应执行的实际逻辑——即分配资源地址范围、注册中断处理程序等重要细节。

#### 配置选项传递给QEMU命令行
最后，为了让用户可以在启动虚拟机之前指定想要加载哪些额外的外设模块，还需要支持从外部传入参数的方式来进行灵活定制。例如：

qemu-system-x86_64 \
    -m 2G \
    -cpu host \
    -M pc-q35-7.2 \
    -device my-pci-device,id=my_dev,bus=pcie.0,addr=0x9 \
    -drive file=disk.img,if=virtio \
    ...

在此示例中，`-device` 参数允许使用者轻松地向目标平台添加新的PCI装置，并可通过附加的关键字进一步调整其行为模式或位置信息[^2]。