3. QEMU 设备模型回顾：TYPE_DEVICE、realize 函数、MemoryRegion、SysBusDevice

在深入 SD 卡控制器模拟之前，必须牢固掌握 QEMU 设备模型的核心抽象。QEMU 使用一套基于 GObject 的类型系统来管理所有模拟设备，这套系统将设备的初始化、内存映射、总线连接和生命周期管理统一起来。本章将逐一拆解 TYPE_DEVICE、realize 函数、MemoryRegion 和 SysBusDevice 这四个关键概念，并展示它们如何协同工作。

3.1 TYPE_DEVICE：所有模拟设备的基类

在 QEMU 中，TYPE_DEVICE 是所有模拟设备的根类型。它定义了一个设备必须具备的基本属性和生命周期回调。任何外设，无论是简单的 GPIO 控制器还是复杂的 SD 卡控制器，都必须从 TYPE_DEVICE 派生。

设备类型注册通常使用 type_register_static 宏，并填充一个 TypeInfo 结构体。下表列出了 TypeInfo 中最关键的字段：

3.2 realize 函数：设备初始化的核心入口

realize 是 TYPE_DEVICE 提供的一个关键虚函数。它标志着设备从“已创建”状态进入“已就绪”状态。在 realize 函数中，开发者必须完成所有需要父总线或系统资源才能进行的初始化工作。

一个典型的 realize 函数执行流程如下：

1. 验证设备配置：检查用户提供的属性（如中断号、内存大小）是否合法。
2. 创建 MemoryRegion：为设备的 MMIO 区域分配并初始化内存区域。
3. 注册中断：通过 sysbus_init_irq 声明设备的中断输出线。
4. 挂载到总线：将 MemoryRegion 通过 sysbus_init_mmio 注册到系统总线。
5. 初始化内部状态：重置设备内部寄存器、FIFO 缓冲区等。

static void sd_controller_realize(DeviceState *dev, Error **errp)
{
    SDControllerState *s = SD_CONTROLLER(dev);
    SysBusDevice *sbd = SYS_BUS_DEVICE(dev);

    /* 1. 验证配置 */
    if (s->sd_card == NULL) {
        error_setg(errp, "SD card not connected");
        return;
    }

    /* 2. 创建 MMIO 内存区域 */
    memory_region_init_io(&s->iomem, OBJECT(dev), &sd_controller_ops,
                          s, "sd-controller", 0x1000);

    /* 3. 注册中断 */
    sysbus_init_irq(sbd, &s->irq);

    /* 4. 挂载到系统总线 */
    sysbus_init_mmio(sbd, &s->iomem);

    /* 5. 初始化内部状态 */
    sd_controller_reset(s);
}

3.3 MemoryRegion：设备与 CPU 的通信桥梁

MemoryRegion 是 QEMU 中描述一段连续地址空间的抽象。CPU 对设备寄存器的读写操作，最终都会通过 MemoryRegion 分发到对应的回调函数。每个设备通常拥有一个或多个 MemoryRegion，用于暴露控制寄存器、数据 FIFO 或 DMA 区域。

MemoryRegion 的核心是 MemoryRegionOps 结构体，它定义了读写回调函数：

3.4 SysBusDevice：系统总线的标准接口

SysBusDevice 是 TYPE_DEVICE 的一个子类，专门用于挂载在系统总线（System Bus）上的设备。它提供了标准化的方法将设备的 MemoryRegion 和中断线暴露给系统。

使用 SysBusDevice 的主要优势在于：

• 自动地址分配：通过 sysbus_init_mmio 注册的 MemoryRegion，可以在设备实例化时由 QEMU 自动分配基地址。
• 中断线管理：通过 sysbus_init_irq 声明的中断输出线，可以方便地连接到中断控制器。
• 设备树集成：SysBusDevice 支持通过 -device 命令行参数动态创建，并自动接入系统总线。

下面的 SVG 图展示了 QEMU 设备模型中，从类型注册到设备就绪的完整流程，以及 MemoryRegion 和 SysBusDevice 在其中扮演的角色：

3.5 四者关系总结

下表从职责、时机和关键 API 三个维度，对比了这四个核心概念：