From a2a243be11c5be87fdb487c029deb0976fbb4f9e Mon Sep 17 00:00:00 2001
From: jl-jiang <jjl9807@aliyun.com>
Date: Sat, 26 Aug 2023 17:34:03 +0800
Subject: [PATCH 01/13] finish the article

---
 ...20230815-qemu-system-device-model-part1.md | 387 ++++++++++++++++++
 .../DeviceClass.svg                           |   4 +
 .../init_type_list.svg                        |   4 +
 .../qdev_realize.svg                          |   4 +
 4 files changed, 399 insertions(+)
 create mode 100644 articles/20230815-qemu-system-device-model-part1.md
 create mode 100644 articles/images/qemu-system-device-model-part1/DeviceClass.svg
 create mode 100644 articles/images/qemu-system-device-model-part1/init_type_list.svg
 create mode 100644 articles/images/qemu-system-device-model-part1/qdev_realize.svg

diff --git a/articles/20230815-qemu-system-device-model-part1.md b/articles/20230815-qemu-system-device-model-part1.md
new file mode 100644
index 0000000..82c130f
--- /dev/null
+++ b/articles/20230815-qemu-system-device-model-part1.md
@@ -0,0 +1,387 @@
+> Corrector: [TinyCorrect](https://gitee.com/tinylab/tinycorrect) v0.2-rc2<br/>
+> Author:    jl-jiang <jjl9807@aliyun.com><br/>
+> Date:      2023/08/15<br/>
+> Revisor:   Bin Meng <bmeng@tinylab.org><br/>
+> Project:   [RISC-V Linux 内核剖析](https://gitee.com/tinylab/riscv-linux)<br/>
+> Proposal:  [【老师提案】QEMU 系统模拟模式分析](https://gitee.com/tinylab/riscv-linux/issues/I61KIY)<br/>
+> Sponsor:   PLCT Lab, ISCAS
+
+# QEMU 设备模型简析（一）：生命周期
+
+## 前言
+
+QEMU 系统模拟模式能够提供运行虚拟机所需的完整环境，包括 CPU，内存和外部设备等。其中，设备模拟是系统模拟模式的重要组成部分，也是系统模拟模式和用户模拟模式的本质区别之一。设备模型是 QEMU 中用于描述和实现设备模拟的软件结构和框架，它为设备提供了标准化的接口和方法，使得开发者可以轻松地为 QEMU 添加新的设备。本文将以 8.0.0 版本的 QEMU RISC-V (qemu-system-riscv64) 为例，分析介绍 QEMU 设备模型的生命周期。
+
+## 设备类型注册
+
+### 定义
+
+QEMU 模拟的每一种设备都必须定义对应的设备类型，这个设备类型在代码中由结构体 `TypeInfo` 描述：
+
+```c
+/* include/qom/object.h: 412 */
+
+struct TypeInfo
+{
+    const char *name;
+    const char *parent;
+
+    size_t instance_size;
+    size_t instance_align;
+    void (*instance_init)(Object *obj);
+    void (*instance_post_init)(Object *obj);
+    void (*instance_finalize)(Object *obj);
+
+    bool abstract;
+    size_t class_size;
+
+    void (*class_init)(ObjectClass *klass, void *data);
+    void (*class_base_init)(ObjectClass *klass, void *data);
+    void *class_data;
+
+    InterfaceInfo *interfaces;
+};
+```
+
+该结构体的成员变量比较繁多，目前只需要关注以下两个成员：
+
+- **name：** 设备类型名称
+- **parent：** 父设备类型名称
+
+通过这两个变量我们可以发现，QEMU 设备模型中使用名称作为设备类型的唯一标识，并且设备类型之间还存在继承关系。
+
+### 注册
+
+完成设备类型的定义后，必须注册这一设备类型，以通知 QEMU 系统可以支持这一类型的设备，为后续添加这一类型的设备准备条件。注册工作由 `type_register` 函数负责：
+
+```c
+/* qom/object.c: 140 */
+
+static TypeImpl *type_register_internal(const TypeInfo *info)
+{
+    TypeImpl *ti;
+    ti = type_new(info);
+
+    type_table_add(ti);
+    return ti;
+}
+
+TypeImpl *type_register(const TypeInfo *info)
+{
+    assert(info->parent);
+    return type_register_internal(info);
+}
+```
+
+该函数通过调用 `type_new` 生成一个 `TypeInfo` 对应的 `TypeImpl` 类型，并以 `name` 为关键字添加到名为 `type_table` 的一个哈希表中。`type_table` 是 QEMU 维护的一个全局的类型哈希表，使用类型名字符串索引到具体的 `TypeImpl` 对象。
+
+下面给出 `TypeImpl` 结构体的定义：
+
+```c
+/* qom/object.c: 48 */
+
+struct TypeImpl
+{
+    const char *name;
+
+    size_t class_size;
+
+    size_t instance_size;
+    size_t instance_align;
+
+    void (*class_init)(ObjectClass *klass, void *data);
+    void (*class_base_init)(ObjectClass *klass, void *data);
+
+    void *class_data;
+
+    void (*instance_init)(Object *obj);
+    void (*instance_post_init)(Object *obj);
+    void (*instance_finalize)(Object *obj);
+
+    bool abstract;
+
+    const char *parent;
+    TypeImpl *parent_type;
+
+    ObjectClass *class;
+
+    int num_interfaces;
+    InterfaceImpl interfaces[MAX_INTERFACES];
+};
+```
+
+通过观察不难发现 `TypeInfo` 和 `TypeImpl` 两个结构体的结构相似，绝大多数成员变量都相同，那么为什么注册过程中不直接使用，而要重新复制一遍呢？这与 QEMU 对象系统的设计理念有关，`TypeInfo` 结构体是面向 API 使用者的一个工具，使用者只有在注册设备类型的时候会使用到 `TypeInfo`，提供类型注册所需的必要信息和回调函数，此后 QEMU 会根据 `TypeInfo` 自动生成对应的 `TypeImpl` 结构体，至此 `TypeInfo` 的生命周期就结束了。换句话说，`TypeInfo` 保存静态的注册数据，而 `TypeImpl` 保存动态的运行数据，这种设计降低了系统的耦合度，提升了稳定性。
+
+下面我们来分析 `type_register()` 函数的调用时机，这里就需要引申出另一个问题，就是注册函数本身也有“注册 - 执行”机制。我们以虚拟网卡设备 e1000 为例进行分析：
+
+```c
+/* hw/e1000.c: 1822 */
+
+static void e1000_register_types(void)
+{
+    int i;
+
+    type_register_static(&e1000_base_info);
+    for (i = 0; i < ARRAY_SIZE(e1000_devices); i++) {
+        const E1000Info *info = &e1000_devices[i];
+        TypeInfo type_info = {};
+
+        type_info.name = info->name;
+        type_info.parent = TYPE_E1000_BASE;
+        type_info.class_data = (void *)info;
+        type_info.class_init = e1000_class_init;
+
+        type_register(&type_info);
+    }
+}
+
+type_init(e1000_register_types)
+```
+
+函数 `e1000_register_types` 负责执行 e1000 网卡的设备类型注册，注意最后一行代码调用 `type_init` 函数对 `e1000_register_types` 函数进行注册，下面给出 `type_init` 函数的定义：
+
+```c
+/* include/qemu/module.h: 56 */
+
+#define type_init(function) module_init(function, MODULE_INIT_QOM)
+```
+
+`type_init` 函数实际上是通过宏的形式对 `module_init` 进行包装：
+
+```c
+/* include/qemu/module.h: 35 */
+
+#define module_init(function, type)                                         \
+static void __attribute__((constructor)) do_qemu_init_ ## function(void)    \
+{                                                                           \
+    register_module_init(function, type);                                   \
+}
+```
+
+这里我们需要关注的是这个修饰 `__attribute__((constructor))`，它是 GCC 的一个扩展，用于确保被修饰的函数在 `main` 函数执行之被调用。仍然以上文的 e1000 网卡为例，调用 `type_init` 时传入的函数名为 `e1000_register_types`，这个宏的作用就是生成函数`static void do_qemu_init_e1000_register_types(void)`，并保证其在 `main` 函数之前被调用，以达到自动初始化的目的。
+
+下面分析 `register_module_init` 函数的行为：
+
+```c
+/* util/module.c: 70 */
+
+void register_module_init(void (*fn)(void), module_init_type type)
+{
+    ModuleEntry *e;
+    ModuleTypeList *l;
+
+    e = g_malloc0(sizeof(*e));
+    e->init = fn;
+    e->type = type;
+
+    l = find_type(type);
+
+    QTAILQ_INSERT_TAIL(l, e, node);
+}
+```
+
+QEMU 维护了一个全局的链表头数组 ` init_type_list`，分别指向不同类型的注册函数链表，具体如下图所示：
+
+![](images/qemu-system-device-model-part1/init_type_list.svg)
+
+ `register_module_init` 函数会将待注册的设备类型注册函数，这里的例子中是 `e1000_register_types`，添加到 `MODULE_INIT_QOM` 下标所指向的链表尾部，完成注册工作。直到此时，真正的设备类型注册函数都没有执行，到底什么时候进行设备类型的注册呢？在[之前的文章](https://gitee.com/tinylab/riscv-linux/blob/master/articles/20230801-qemu-system-event-loop-part2.md)中，我们有分析过 QEMU 主事件循环的一般执行流程，`main` 函数会调用 `qemu_init` 函数进行初始化， `qemu_init` 在执行过程中会调用 `qemu_init_subsystems` 函数，而 `qemu_init_subsystems` 则会调用 `module_call_init` 函数，并传入参数 `MODULE_INIT_QOM`：
+
+```c
+/* util/module.c: 755 */
+
+void module_call_init(module_init_type type)
+{
+    ModuleTypeList *l;
+    ModuleEntry *e;
+
+    if (modules_init_done[type]) {
+        return;
+    }
+
+    l = find_type(type);
+
+    QTAILQ_FOREACH(e, l, node) {
+        e->init();
+    }
+
+    modules_init_done[type] = true;
+}
+```
+
+这里 `module_call_init` 函数作用就是找到 `MODULE_INIT_QOM` 对应的链表，然后依次执行链表项中的 `init` 成员函数，对于 e1000 网卡而言就是之前通过 `register_module_init` 注册的的 `e1000_register_types` 函数。
+
+到此为止，设备类型注册的逻辑链条就算完整了。
+
+## 设备类型初始化
+
+设备类型注册后，在使用之前需要初始化该类型，并生成对应的 `ObjectClass` 对象。
+
+这里回顾一下上文介绍的 `TypeImpl` 结构体，可以发现其中有一个名为 `class` 的 `ObjectClass` 类型的成员变量，所谓初始化其实就是初始化这个 `class` 成员，负责具体初始化工作的是 ` type_initialize` 函数：
+
+```c
+/* qom/object.c: 286 */
+
+static void type_initialize(TypeImpl *ti)
+{
+    TypeImpl *parent;
+
+    if (ti->class) {
+        return;
+    }
+
+    ti->class_size = type_class_get_size(ti);
+    ti->instance_size = type_object_get_size(ti);
+    /* Any type with zero instance_size is implicitly abstract.
+     * This means interface types are all abstract.
+     */
+    if (ti->instance_size == 0) {
+        ti->abstract = true;
+    }
+    if (type_is_ancestor(ti, type_interface)) {
+        assert(ti->instance_size == 0);
+        assert(ti->abstract);
+        assert(!ti->instance_init);
+        assert(!ti->instance_post_init);
+        assert(!ti->instance_finalize);
+        assert(!ti->num_interfaces);
+    }
+    ti->class = g_malloc0(ti->class_size);
+
+    parent = type_get_parent(ti);
+    if (parent) {
+        type_initialize(parent);
+        GSList *e;
+        int i;
+
+        g_assert(parent->class_size <= ti->class_size);
+        g_assert(parent->instance_size <= ti->instance_size);
+        memcpy(ti->class, parent->class, parent->class_size);
+        ti->class->interfaces = NULL;
+
+        for (e = parent->class->interfaces; e; e = e->next) {
+            InterfaceClass *iface = e->data;
+            ObjectClass *klass = OBJECT_CLASS(iface);
+
+            type_initialize_interface(ti, iface->interface_type, klass->type);
+        }
+
+        for (i = 0; i < ti->num_interfaces; i++) {
+            TypeImpl *t = type_get_by_name(ti->interfaces[i].typename);
+            if (!t) {
+                error_report("missing interface '%s' for object '%s'",
+                             ti->interfaces[i].typename, parent->name);
+                abort();
+            }
+            for (e = ti->class->interfaces; e; e = e->next) {
+                TypeImpl *target_type = OBJECT_CLASS(e->data)->type;
+
+                if (type_is_ancestor(target_type, t)) {
+                    break;
+                }
+            }
+
+            if (e) {
+                continue;
+            }
+
+            type_initialize_interface(ti, t, t);
+        }
+    }
+
+    ti->class->properties = g_hash_table_new_full(g_str_hash, g_str_equal, NULL,
+                                                  object_property_free);
+
+    ti->class->type = ti;
+
+    while (parent) {
+        if (parent->class_base_init) {
+            parent->class_base_init(ti->class, ti->class_data);
+        }
+        parent = type_get_parent(parent);
+    }
+
+    if (ti->class_init) {
+        ti->class_init(ti->class, ti->class_data);
+    }
+}
+```
+
+` type_initialize` 函数首先执行一些必要的检查，接着会设置类型的大小并创建该类型，设置类型实例的大小，为实例化设备做准备，
+然后初始化父设备类型和接口类型，最后调用父设备类型的 `class_base_init` 和自己的 `class_init` 完成初始化工作。
+
+此外，通过上述代码我们还可以得出两点结论：
+
+- QEMU 设备管理是一个树型结构
+- QEMU 设备模型采用了面向对象的思想，存在继承关系
+
+本文重点关注设备的生命周期，以上两点这里不展开讨论，在后面的文章中会专题分析。
+
+## 设备实例化
+
+完成了设备类型的初始化，接着就要实例化设备了，这个过程由 `object_initialize` 函数实现，而 `object_initialize` 又通过调用 `object_initialize_with_type` 完成实例化工作。抽象地看，设备实例化主要完成三件事：首先，建立`Object` 和 `ObjectClass` 之间的关联；然后，递归调用父类型的 `instance_init` 函数；最后，调用自己的 `instance_init` 函数。需要注意的是，这种抽象的视角简化了设备实例化流程，也模糊了很多真实场景下的具体细节。
+
+### 实例化函数
+
+下面以 `DeviceClass` 为例详细分析设备的实例化过程。`DeviceClass` 是 QEMU 设备模型的核心组件，它继承自 `ObjectClass`，提供了设备的基本行为和属性的模板，是很多设备的父类，其实例化过程很有代表性。下图给出了 `DeviceClass` 有关类和对象之间的关系：
+
+![](images/qemu-system-device-model-part1/DeviceClass.svg)
+
+这里我们需要关注的是负责实例化 `DeviceClass` 的函数 ` device_initfn`：
+
+```c
+/* hw/core/qdev.c: 652 */
+
+static void device_initfn(Object *obj)
+{
+    DeviceState *dev = DEVICE(obj);
+
+    if (phase_check(PHASE_MACHINE_READY)) {
+        dev->hotplugged = 1;
+        qdev_hot_added = true;
+    }
+
+    dev->instance_id_alias = -1;
+    dev->realized = false;
+    dev->allow_unplug_during_migration = false;
+
+    QLIST_INIT(&dev->gpios);
+    QLIST_INIT(&dev->clocks);
+}
+```
+
+` device_initfn` 函数的整体执行逻辑比较简单，主要分为以下四个步骤：
+
+- **设备状态转换：** 将传入的 `Object` 指针转换为 `DeviceState` 指针。`DEVICE` 是一个宏，用于从基类 `Object` 转换到派生类 `DeviceState`
+- **检查机器准备状态：** 使用 `phase_check` 函数检查当前的机器初始化阶段是否为 `PHASE_MACHINE_READY`。如果是，则设置设备的 `hotplugged` 属性为 1，表示该设备是在虚拟机已经启动后热插入的。同时，全局变量 `qdev_hot_added` 被设置为 `true`，表示有设备被热插入
+- **初始化设备属性：** `instance_id_alias` 被设置为 `-1`，表示没有别名；`realized` 被设置为 `false`，表示设备尚未实现；`allow_unplug_during_migration` 被设置为 `false`，表示在迁移期间不允许拔出此设备
+- **初始化设备的 GPIO 和时钟列表：** 使用 `QLIST_INIT` 宏初始化了设备的 GPIO 和时钟列表
+
+### realized 属性设置
+
+我们注意到 ` device_initfn` 函数将 `DeviceState` 的 `realized` 被设置为 `false`，意味着这个设备还没有被实现，那么这个属性究竟是什么时候被设置为 `Ture` 的呢？通过分析 QEMU 的启动流程，可以梳理出如下函数调用链：
+
+![](images/qemu-system-device-model-part1/qdev_realize.svg)
+
+QEMU 在初始化阶段经过一系列函数调用，最终调用 `qdev_realize` 函数，该函数是 QEMU 设备模型中的一个核心函数，用于激活设备，也就是将设备对应的 `DeviceState` 结构的 `realized` 属性设置为 `true`，表示设备已经被实例化并准备好在模拟环境中运行。在设置 `realized` 属性之前，函数会执行一些基础的检查，以确保设备尚未被实例化并且没有父总线，然后函数会检查设备总线类型并设置父总线，最后调用 `object_property_set_bool` 函数设置 `realized` 属性设置为 `true`，完成设备实例化。
+
+## 设备销毁
+
+设备销毁的步骤与设备创建过程正好相反，一般包含以下四个步骤：
+
+- **设备反实例化：** 停止操作设备并释放占用资源后，通过代码 `object_property_set_bool(OBJECT(dev), "realized", false, &error)` 设置 `realized` 属性设置为 `false`，标记设备已经反实例化
+- **从总线中移除：** 设备通常连接到一个总线，在销毁设备之前，需要从其父总线中将之移除
+- **销毁设备对象：** 调用 `object_unref` 函数减少设备对象的引用计数，当引用计数降为 0 时，并调用设备对象的析构函数，释放所占内存空间及其他资源
+- **反注册设备类型：** 有时可能还需要反注册设备类型，注销回调函数，清理释放为设备分配的各种资源
+
+总而言之，设备的销毁过程可以视作设备添加过程的逆操作，除了顺序相反之外，执行流程基本相似，设备销毁的细节也不是本文关注的重点，这里仅介绍主要步骤，不再详细分析。
+
+## 总结
+
+本文从设备的生命周期这一角度入手，介绍了设备类型注册、设备类型初始化、设备实例化等环节的基本原理和执行流程，打通了从设备类型表创建到设备销毁的逻辑链条，在一个较为抽象的层面对 QEMU 设备模型进行了初步分析。下一篇文章中，我们将专题介绍 QEMU 对象模型以及面向对象的设备管理。
+
+## 参考资料
+
+- [The QEMU Object Model (QOM) ](https://www.qemu.org/docs/master/devel/qom.html)
+- [浅谈QEMU的对象系统](https://juejin.cn/post/6844903845550620685)
+- [understanding_qemu](https://richardweiyang-2.gitbook.io/understanding_qemu)
+- 《QEMU/KVM 源码解析与应用》李强，机械工业出版社
\ No newline at end of file
diff --git a/articles/images/qemu-system-device-model-part1/DeviceClass.svg b/articles/images/qemu-system-device-model-part1/DeviceClass.svg
new file mode 100644
index 0000000..0da844c
--- /dev/null
+++ b/articles/images/qemu-system-device-model-part1/DeviceClass.svg
@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- Do not edit this file with editors other than draw.io -->
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" version="1.1" width="481px" height="281px" viewBox="-0.5 -0.5 481 281" content="&lt;mxfile host=&quot;Electron&quot; modified=&quot;2023-08-26T07:48:28.274Z&quot; agent=&quot;Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) draw.io/21.6.8 Chrome/114.0.5735.289 Electron/25.5.0 Safari/537.36&quot; etag=&quot;sCjbUk4vBrH7jN1gZXCw&quot; version=&quot;21.6.8&quot; type=&quot;device&quot;&gt;&lt;diagram name=&quot;第 1 页&quot; id=&quot;CP4m-22Ge3NDiC2Oe01g&quot;&gt;7VlZc9owEP41PKbjA9zwGEzSTieZdMJDmr5khLXYSoRFZRlDf30lW/LBFac5oClPeFe7K+3xfQjTcf3p4gtHs+iKYaAdx8KLjjvsOI5t9Sz5oTTLQuM5/UIRcoK1UaUYkd9gPLU2JRiShqFgjAoyayoDFscQiIYOcc6yptmE0eauMxTCmmIUILquvSVYRFrr9brVwlcgYWS2tj2d4BQZa51KEiHMsprKPe+4PmdMFE/ThQ9UVc8UpvC72LJanoxDLFo5XGfZY3Z1H/w8ub0dfru592/GJzrKHNFUZ9xxPCrjDSZMhpWnFktdC+9XyszCSZJ36kwa2N5MdntQrasyo6Dpc5kGBCO54rM4YTJgzdoL1ef1+EH2z6coScwJZCrFIQoLXcXyPA5naYxBZWfJ5SwiAkazYudMTqPURWJKpWSrUxNKfUYZz33dyQS8IJD6RHD2CLUV/Lk/tqxyvzlwAYutJbfLRkoIAJuC4Etpoh1OdeuXTTGrT5LWRbUhMnZID29YBq7aKx90h5/TbWutiIDlvGuRcRGxkMWInlfaQbPMlc0lYzNd3AcQYqnBi1LBmqWHBRE/lPunnpbudDD1PFzUhaURYplvzUmJdyaeEiq3XDJ+GCVRfla77KDKcHf/ZEFYygPYVTlDPoiHIHYZbh4IDhQJMm8e5NX76xwKmocwJwF8bDTvH869vaK5juUS2U+g2a5juQbtLWh+RQC7/wJ+3UPBb/Ft/HGg27UO7JvYO0K3NXS7LaHr7BO6p8eb1d91t9+yu+4+u9s9FGIuLlYjgQR8XHbePz3bm27S/xG+IcZn6u2JFGMWQ6G5IKqIr83uTtuL2UtvZtr1OyM5Yhcrc7U6eyZEkYD2qr9eeSJQKZtARYZrgfL5LPN5wcgezKscEkfASevbo+QN0Rz7JtnoAawzk1YhSsJYioEcOpD6gWIhEiB6phemBOMciZtYr4lOisZAByh4DHO92QnDBKW0OveLeM52V2bNXue5TTTnvhnNbfrBcaS5t6C5tpfY/puwXHfbu4vnstxqoPdmuf6R5A6c5Lq9dyM5KVZ/nxQTVv0L5Z7/AQ==&lt;/diagram&gt;&lt;/mxfile&gt;" style="background-color: rgb(255, 255, 255);"><defs/><g><rect x="0" y="0" width="160" height="80" fill="#ffe6cc" stroke="#d79b00" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 158px; height: 1px; padding-top: 40px; margin-left: 1px;"><div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: center;"><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;"><font face="Lucida Console" style="font-size: 16px;">ObjectClass</font></div></div></div></foreignObject><text x="80" y="44" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">ObjectClass</text></switch></g><path d="M 80 130 L 80 86.37" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" stroke-dasharray="3 3" pointer-events="stroke"/><path d="M 80 81.12 L 83.5 88.12 L 80 86.37 L 76.5 88.12 Z" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="all"/><rect x="0" y="200" width="160" height="80" fill="#ffe6cc" stroke="#d79b00" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 158px; height: 1px; padding-top: 240px; margin-left: 1px;"><div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: center;"><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;"><font face="Lucida Console" style="font-size: 16px;">DeviceClass</font></div></div></div></foreignObject><text x="80" y="244" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">DeviceClass</text></switch></g><path d="M 320 40 L 166.37 40" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 161.12 40 L 168.12 36.5 L 166.37 40 L 168.12 43.5 Z" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="all"/><rect x="320" y="0" width="160" height="80" fill="#ffe6cc" stroke="#d79b00" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 158px; height: 1px; padding-top: 40px; margin-left: 321px;"><div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: center;"><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;"><font face="Lucida Console" style="font-size: 16px;">Object</font></div></div></div></foreignObject><text x="400" y="44" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">Object</text></switch></g><path d="M 320 240 L 166.37 240" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 161.12 240 L 168.12 236.5 L 166.37 240 L 168.12 243.5 Z" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="all"/><path d="M 400 130 L 400 86.37" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" stroke-dasharray="3 3" pointer-events="stroke"/><path d="M 400 81.12 L 403.5 88.12 L 400 86.37 L 396.5 88.12 Z" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="all"/><rect x="320" y="200" width="160" height="80" fill="#ffe6cc" stroke="#d79b00" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 158px; height: 1px; padding-top: 240px; margin-left: 321px;"><div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: center;"><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;"><font face="Lucida Console" style="font-size: 16px;">DeviceState</font></div></div></div></foreignObject><text x="400" y="244" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">DeviceState</text></switch></g><path d="M 80 200 L 80 160" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" stroke-dasharray="3 3" pointer-events="stroke"/><rect x="50" y="130" width="60" height="30" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 58px; height: 1px; padding-top: 145px; margin-left: 51px;"><div data-drawio-colors="color: rgb(0, 0, 0); background-color: rgb(255, 255, 255); " style="box-sizing: border-box; font-size: 0px; text-align: center;"><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; background-color: rgb(255, 255, 255); white-space: normal; overflow-wrap: normal;"><font face="Lucida Console" style="font-size: 16px;">inherit</font></div></div></div></foreignObject><text x="80" y="149" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">inherit</text></switch></g><path d="M 400 200 L 400 160" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" stroke-dasharray="3 3" pointer-events="stroke"/><rect x="370" y="130" width="60" height="30" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 58px; height: 1px; padding-top: 145px; margin-left: 371px;"><div data-drawio-colors="color: rgb(0, 0, 0); background-color: rgb(255, 255, 255); " style="box-sizing: border-box; font-size: 0px; text-align: center;"><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; background-color: rgb(255, 255, 255); white-space: normal; overflow-wrap: normal;"><font face="Lucida Console" style="font-size: 16px;">inherit</font></div></div></div></foreignObject><text x="400" y="149" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">inherit</text></switch></g></g><switch><g requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"/><a transform="translate(0,-5)" xlink:href="https://www.drawio.com/doc/faq/svg-export-text-problems" target="_blank"><text text-anchor="middle" font-size="10px" x="50%" y="100%">Text is not SVG - cannot display</text></a></switch></svg>
\ No newline at end of file
diff --git a/articles/images/qemu-system-device-model-part1/init_type_list.svg b/articles/images/qemu-system-device-model-part1/init_type_list.svg
new file mode 100644
index 0000000..c3bbdc1
--- /dev/null
+++ b/articles/images/qemu-system-device-model-part1/init_type_list.svg
@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- Do not edit this file with editors other than draw.io -->
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" version="1.1" width="991px" height="351px" viewBox="-0.5 -0.5 991 351" content="&lt;mxfile host=&quot;Electron&quot; modified=&quot;2023-08-26T07:51:37.514Z&quot; agent=&quot;Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) draw.io/21.6.8 Chrome/114.0.5735.289 Electron/25.5.0 Safari/537.36&quot; etag=&quot;IrsjESCs1DylKk-8wR84&quot; version=&quot;21.6.8&quot; type=&quot;device&quot;&gt;&lt;diagram name=&quot;第 1 页&quot; id=&quot;UgWYep8dxeBD_CwyjKxU&quot;&gt;7Vxtc6I6FP41/bh3QAT1o2/t9m6tu9Wd2+4XJ5Wo2UbCDbHq/voNEIpIVOgq4jYznSk5hBDOeZ4nySFyZbTnqxsK3FmP2BBfVTR7dWV0rioVXTM1/s+3rEOLVWmEhilFtqgUGwboF4yuFNYFsqGXqMgIwQy5SeOYOA4cs4QNUEqWyWoTgpN3dcEUpgyDMcBp63/IZjNhtcxqfOIzRNNZdGvdEg84B1Ft8SjeDNhkuWEyuldGmxLCwqP5qg2x773IMeF11zvOvvWMQodluWD89QXNvXu381Rb9vpfvzy+LFafKmErrwAvxBOLzrJ15ALeb9c/ZODZN7U8BigTkdJ4mbueAeRAyst6UMYYuB4Kaoc1Zgjbd2BNFixqJyq1Jvxq0Zhu+WWEcZtgQoObG5MJtMbj4K6UvMCNM3at8axpooVrMEfYh9jdYoxswB+gTRyPBP1N+0m47hVSBlcbJuG3G0jmkNE1ryLO1kUI18niMkbEm222AQYjCj0QKJy+tRzHiR+IUOUIm5EzbA8+8FozQtEvP1pYBGY7lN4SzTFwOKKBvWVqkYDCWioUyJlBivxQMuKKGhhOmDh8JoyRuShQ4RtNChObEncI6BRGVTax4BDHD6ZLkMMCb5ot/sf929b+Ma9M/sRtXtbjMv/zq1PmI4FRjlC/WQg8toSeDHlpnOxlzGHwHIJH9VToqErQYWH/mW30mkCJ9f/Cl58W5vz9FPWtyatUqu4q8ElUgx9NxX8ceU/alH/ikxf41W9It1INaRMwTl6TYm3qtr1+5/tdd3R7fzsc9W5vHprD2/591BfupLA7yS5yc/C8kXUHQXjEGQL4gQ8fwJkGkjFjcyzUbDlDDA7csMdLPsiFiucPNiCG7i5KEA6TCQ5Uf4ZsGzpyVOdjTsABSLuvMKSC/n4wG4WAWbQWezh/cwDzJ3YA4zq0cGwvRZG3nr6fNTWlqeXX1HUSHmeT2HoBErurpVKKcuuu3/6SU5CVTGfkRy0zP/5+mdZ1CfWUTpdTp7OulE6m07psgXt2sex/HQ52aqXSv92c/2AC2K+4lYrRHH3rg+uHV1Dz6gMnmrMruSuf3OmVAvVOCo7dS38hd3+oXN/6PSVcUgTt46rSLe4LXelWaXXLOrduHZym/aFuDR+a7a5SruzKpWZcsS9qSrnKqlwV7dzKtTsTeBzleuzej1rN9pfufUfpV3b9+qApM6kvTKVfpdWvIt9kSMFhnVi/7m5b3/oq25VDukwlXfE0VNsJEaVd59auIrP7cnTI3gUdU7yuv//4MRo2H266Q6VgORaP2seUMPnLCzMFUuQgNmJrF44w4pTdhhD3GUvCJQkEEV5JxAFGUw6Gzhj6oeQGPwJoDHBTnJhzuARYlAGQ+j6AkUAe2ld5GBu591nqjeRGSzMtMJYkqMbJ9OXg5Kiot4cBWCiccrjwuGaUomQ8ZRHfgFj+jbdHCHh1a2etIXmBostCfrIhxZCt5/fNQCSzjQ+wI7paTQZOmoepSgJXP1ngGjkDp6aO75k67idNvvFeho/TvRnVJPi48F3RUNc07W1YCGYU3oE9eM9U7b/Lj+9GIfg+MJ/N0lwBS/Kq2oB3CUK7Z6d0sbq7+9VuCbZKn3A7TFa9VSqcEfzV972T/jtV2LRSGIH2FA5EkUvPjEyJA3A3tm4t8OM6dySIqR+bn5CxtQgOWDCSBBhcIfa4cfzkN8UlLyx1VqLloBApNg8qXT9uFjau8ovxZUEpum7nKsUjCypYu3fXFYvk/NCw7jtuL5woxIChV5joxtGV0kz/AqlH7AWGXSdqXmWJ+BnTSK499dqZ00SmyhlkiVvNKlvOwFQ5g7NNZc0LyBlYBeYM3jETdccjG83nKgFw+lfyKgGwwQqVALgE1SxLAsBSCQCVADiKClsqAbDhjPQ3gNRqUfbtJrNkq0WrmgqOytxsZWQOpm7McqVuLLVR5LQbRepaksWFbhRxtdv6479Ts0e17z9fOk9TNPgs+VFQgSyOmfu0ceYAi/V8LLaBNwv6qr+FcItt7+O4Vc/I8ZBUZ6P0wR/2FEVpPtTirEwuxzB/BMLrmr6VLWwUN25LCZ/+FY0ifCbCV6oZCa+flfCVg99OUIQ/IeGtRsn4foHT9JjiTwmGZ+A7dOym/73kGB/cco0wTkT4KHqQeZIfMrIAPZDG/wJfsF9G/M2s8Q+nYMePPy/Gn90O8zHx18uN7m8=&lt;/diagram&gt;&lt;/mxfile&gt;" style="background-color: rgb(255, 255, 255);"><defs/><g><rect x="0" y="30" width="280" height="320" fill="#ffe6cc" stroke="none" pointer-events="none"/><path d="M 0 30 L 280 30 L 280 350 L 0 350 L 0 30" fill="none" stroke="#d79b00" stroke-linecap="square" stroke-miterlimit="10" pointer-events="none"/><path d="M 0 70 L 280 70" fill="none" stroke="#d79b00" stroke-miterlimit="10" pointer-events="none"/><path d="M 0 110 L 280 110" fill="none" stroke="#d79b00" stroke-miterlimit="10" pointer-events="none"/><path d="M 0 150 L 280 150" fill="none" stroke="#d79b00" stroke-miterlimit="10" pointer-events="none"/><path d="M 0 190 L 280 190" fill="none" stroke="#d79b00" stroke-miterlimit="10" pointer-events="none"/><path d="M 0 230 L 280 230" fill="none" stroke="#d79b00" stroke-miterlimit="10" pointer-events="none"/><path d="M 0 270 L 280 270" fill="none" stroke="#d79b00" stroke-miterlimit="10" pointer-events="none"/><path d="M 0 310 L 280 310" fill="none" stroke="#d79b00" stroke-miterlimit="10" pointer-events="none"/><path d="M 0 30 M 280 30 M 280 70 M 0 70" fill="none" stroke="#d79b00" stroke-linecap="square" stroke-miterlimit="10" pointer-events="none"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 278px; height: 1px; padding-top: 50px; margin-left: 1px;"><div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: center; max-height: 36px; overflow: hidden;"><div style="display: inline-block; font-size: 16px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: none; white-space: normal; overflow-wrap: normal;"><div style="line-height: 24px;"><font face="Lucida Console" style="font-size: 16px;">MODULE_INIT_MIGRATION</font></div></div></div></div></foreignObject><text x="140" y="55" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="16px" text-anchor="middle">MODULE_INIT_MIGRATION</text></switch></g><path d="M 0 70 M 280 70 M 280 110 M 0 110" fill="none" stroke="#d79b00" stroke-linecap="square" stroke-miterlimit="10" pointer-events="none"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 278px; height: 1px; padding-top: 90px; margin-left: 1px;"><div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: center; max-height: 36px; overflow: hidden;"><div style="display: inline-block; font-size: 16px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: none; white-space: normal; overflow-wrap: normal;"><div style="line-height: 24px;"><div style=""><font face="Lucida Console" style="font-size: 16px;">MODULE_INIT_BLOCK</font></div></div></div></div></div></foreignObject><text x="140" y="95" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="16px" text-anchor="middle">MODULE_INIT_BLOCK</text></switch></g><path d="M 0 110 M 280 110 M 280 150 M 0 150" fill="none" stroke="#d79b00" stroke-linecap="square" stroke-miterlimit="10" pointer-events="none"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 278px; height: 1px; padding-top: 130px; margin-left: 1px;"><div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: center; max-height: 36px; overflow: hidden;"><div style="display: inline-block; font-size: 16px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: none; white-space: normal; overflow-wrap: normal;"><font face="Lucida Console" style="font-size: 16px;">MODULE_INIT_OPTS</font></div></div></div></foreignObject><text x="140" y="135" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="16px" text-anchor="middle">MODULE_INIT_OPTS</text></switch></g><path d="M 0 150 M 280 150 M 280 190 M 0 190" fill="none" stroke="#d79b00" stroke-linecap="square" stroke-miterlimit="10" pointer-events="none"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 278px; height: 1px; padding-top: 170px; margin-left: 1px;"><div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: center; max-height: 36px; overflow: hidden;"><div style="display: inline-block; font-size: 16px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: none; white-space: normal; overflow-wrap: normal;"><font face="Lucida Console">MODULE_INIT_QOM</font></div></div></div></foreignObject><text x="140" y="175" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="16px" text-anchor="middle">MODULE_INIT_QOM</text></switch></g><path d="M 0 190 M 280 190 M 280 230 M 0 230" fill="none" stroke="#d79b00" stroke-linecap="square" stroke-miterlimit="10" pointer-events="none"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 278px; height: 1px; padding-top: 210px; margin-left: 1px;"><div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: center; max-height: 36px; overflow: hidden;"><div style="display: inline-block; font-size: 16px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: none; white-space: normal; overflow-wrap: normal;"><font face="Lucida Console">MODULE_INIT_TRACE</font></div></div></div></foreignObject><text x="140" y="215" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="16px" text-anchor="middle">MODULE_INIT_TRACE</text></switch></g><path d="M 0 230 M 280 230 M 280 270 M 0 270" fill="none" stroke="#d79b00" stroke-linecap="square" stroke-miterlimit="10" pointer-events="none"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 278px; height: 1px; padding-top: 250px; margin-left: 1px;"><div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: center; max-height: 36px; overflow: hidden;"><div style="display: inline-block; font-size: 16px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: none; white-space: normal; overflow-wrap: normal;"><font face="Lucida Console">MODULE_INIT_XEN_BACKEND</font></div></div></div></foreignObject><text x="140" y="255" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="16px" text-anchor="middle">MODULE_INIT_XEN_BACKEND</text></switch></g><path d="M 0 270 M 280 270 M 280 310 M 0 310" fill="none" stroke="#d79b00" stroke-linecap="square" stroke-miterlimit="10" pointer-events="none"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 278px; height: 1px; padding-top: 290px; margin-left: 1px;"><div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: center; max-height: 36px; overflow: hidden;"><div style="display: inline-block; font-size: 16px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: none; white-space: normal; overflow-wrap: normal;"><font face="Lucida Console">MODULE_INIT_LIBQOS</font></div></div></div></foreignObject><text x="140" y="295" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="16px" text-anchor="middle">MODULE_INIT_LIBQOS</text></switch></g><path d="M 0 310 M 280 310 M 280 350 M 0 350" fill="none" stroke="#d79b00" stroke-linecap="square" stroke-miterlimit="10" pointer-events="none"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 278px; height: 1px; padding-top: 330px; margin-left: 1px;"><div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: center; max-height: 36px; overflow: hidden;"><div style="display: inline-block; font-size: 16px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: none; white-space: normal; overflow-wrap: normal;"><font face="Lucida Console">MODULE_INIT_FUZZ_TARGET</font></div></div></div></foreignObject><text x="140" y="335" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="16px" text-anchor="middle">MODULE_INIT_FUZZ_TARGET</text></switch></g><g transform="translate(-0.5 -0.5)"><switch><foreignObject pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 58px; height: 1px; padding-top: 15px; margin-left: 111px;"><div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: center;"><div style="display: inline-block; font-size: 16px; font-family: &quot;Lucida Console&quot;; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: none; white-space: normal; overflow-wrap: normal;">init_type_list</div></div></div></foreignObject><text x="140" y="20" fill="rgb(0, 0, 0)" font-family="Lucida Console" font-size="16px" text-anchor="middle">init_ty...</text></switch></g><rect x="400" y="270" width="160" height="40" fill="#ffe6cc" stroke="#d79b00" pointer-events="none"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 158px; height: 1px; padding-top: 290px; margin-left: 401px;"><div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: center;"><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: none; white-space: normal; overflow-wrap: normal;"><font face="Lucida Console" style="font-size: 16px;">type_register</font></div></div></div></foreignObject><text x="480" y="294" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">type_register</text></switch></g><rect x="360" y="150" width="240" height="80" fill="#ffe6cc" stroke="none" pointer-events="none"/><path d="M 360 150 L 600 150 L 600 230 L 360 230 L 360 150" fill="none" stroke="#d79b00" stroke-linecap="square" stroke-miterlimit="10" pointer-events="none"/><path d="M 360 190 L 600 190" fill="none" stroke="#d79b00" stroke-miterlimit="10" pointer-events="none"/><path d="M 360 150 M 600 150 M 600 190 M 360 190" fill="none" stroke="#d79b00" stroke-linecap="square" stroke-miterlimit="10" pointer-events="none"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 238px; height: 1px; padding-top: 170px; margin-left: 361px;"><div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: center; max-height: 36px; overflow: hidden;"><div style="display: inline-block; font-size: 16px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: none; white-space: normal; overflow-wrap: normal;"><div style="line-height: 24px;"><font face="Lucida Console" style="font-size: 16px;">e1000_register_types</font><br /></div></div></div></div></foreignObject><text x="480" y="175" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="16px" text-anchor="middle">e1000_register_types&#xa;</text></switch></g><path d="M 360 190 M 600 190 M 600 230 M 360 230" fill="none" stroke="#d79b00" stroke-linecap="square" stroke-miterlimit="10" pointer-events="none"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 238px; height: 1px; padding-top: 210px; margin-left: 361px;"><div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: center; max-height: 36px; overflow: hidden;"><div style="display: inline-block; font-size: 16px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: none; white-space: normal; overflow-wrap: normal;"><div style="line-height: 24px;"><div style=""><font face="Lucida Console">MODULE_INIT_QOM</font><br /></div></div></div></div></div></foreignObject><text x="480" y="215" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="16px" text-anchor="middle">MODULE_INIT_QOM&#xa;</text></switch></g><path d="M 280 170 L 353.63 170" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="none"/><path d="M 358.88 170 L 351.88 173.5 L 353.63 170 L 351.88 166.5 Z" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="none"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 58px; height: 1px; padding-top: 135px; margin-left: 451px;"><div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: center;"><div style="display: inline-block; font-size: 16px; font-family: &quot;Lucida Console&quot;; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: none; white-space: normal; overflow-wrap: normal;">ModuleEntry</div></div></div></foreignObject><text x="480" y="140" fill="rgb(0, 0, 0)" font-family="Lucida Console" font-size="16px" text-anchor="middle">ModuleE...</text></switch></g><rect x="680" y="150" width="240" height="80" fill="#ffe6cc" stroke="none" pointer-events="none"/><path d="M 680 150 L 920 150 L 920 230 L 680 230 L 680 150" fill="none" stroke="#d79b00" stroke-linecap="square" stroke-miterlimit="10" pointer-events="none"/><path d="M 680 190 L 920 190" fill="none" stroke="#d79b00" stroke-miterlimit="10" pointer-events="none"/><path d="M 680 150 M 920 150 M 920 190 M 680 190" fill="none" stroke="#d79b00" stroke-linecap="square" stroke-miterlimit="10" pointer-events="none"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 238px; height: 1px; padding-top: 170px; margin-left: 681px;"><div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: center; max-height: 36px; overflow: hidden;"><div style="display: inline-block; font-size: 16px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: none; white-space: normal; overflow-wrap: normal;"><div style="line-height: 24px;"><font face="Lucida Console">pc_dimm_register_types</font><br /></div></div></div></div></foreignObject><text x="800" y="175" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="16px" text-anchor="middle">pc_dimm_register_types&#xa;</text></switch></g><path d="M 680 190 M 920 190 M 920 230 M 680 230" fill="none" stroke="#d79b00" stroke-linecap="square" stroke-miterlimit="10" pointer-events="none"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 238px; height: 1px; padding-top: 210px; margin-left: 681px;"><div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: center; max-height: 36px; overflow: hidden;"><div style="display: inline-block; font-size: 16px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: none; white-space: normal; overflow-wrap: normal;"><div style="line-height: 24px;"><div style=""><font face="Lucida Console">MODULE_INIT_QOM</font><br /></div></div></div></div></div></foreignObject><text x="800" y="215" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="16px" text-anchor="middle">MODULE_INIT_QOM&#xa;</text></switch></g><g transform="translate(-0.5 -0.5)"><switch><foreignObject pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 58px; height: 1px; padding-top: 135px; margin-left: 771px;"><div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: center;"><div style="display: inline-block; font-size: 16px; font-family: &quot;Lucida Console&quot;; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: none; white-space: normal; overflow-wrap: normal;">ModuleEntry</div></div></div></foreignObject><text x="800" y="140" fill="rgb(0, 0, 0)" font-family="Lucida Console" font-size="16px" text-anchor="middle">ModuleE...</text></switch></g><path d="M 600 170 L 673.63 170" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="none"/><path d="M 678.88 170 L 671.88 173.5 L 673.63 170 L 671.88 166.5 Z" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="none"/><rect x="720" y="270" width="160" height="40" fill="#ffe6cc" stroke="#d79b00" pointer-events="none"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 158px; height: 1px; padding-top: 290px; margin-left: 721px;"><div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: center;"><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: none; white-space: normal; overflow-wrap: normal;"><font face="Lucida Console" style="font-size: 16px;">type_register</font></div></div></div></foreignObject><text x="800" y="294" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">type_register</text></switch></g><path d="M 960 270 L 960 290 L 886.37 290" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" stroke-dasharray="3 3" pointer-events="none"/><path d="M 881.12 290 L 888.12 286.5 L 886.37 290 L 888.12 293.5 Z" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="none"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 58px; height: 1px; padding-top: 255px; margin-left: 931px;"><div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: center;"><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: none; white-space: normal; overflow-wrap: normal;"><font face="Lucida Console" style="font-size: 16px;">call</font></div></div></div></foreignObject><text x="960" y="259" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">call</text></switch></g><path d="M 640 270 L 640 290 L 566.37 290" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" stroke-dasharray="3 3" pointer-events="none"/><path d="M 561.12 290 L 568.12 286.5 L 566.37 290 L 568.12 293.5 Z" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="none"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 58px; height: 1px; padding-top: 255px; margin-left: 611px;"><div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: center;"><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: none; white-space: normal; overflow-wrap: normal;"><font face="Lucida Console" style="font-size: 16px;">call</font></div></div></div></foreignObject><text x="640" y="259" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">call</text></switch></g><path d="M 600 170 L 640 170 L 640 240" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" stroke-dasharray="3 3" pointer-events="none"/><path d="M 920 170 L 960 170 L 960 240" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" stroke-dasharray="3 3" pointer-events="none"/></g><switch><g requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"/><a transform="translate(0,-5)" xlink:href="https://www.drawio.com/doc/faq/svg-export-text-problems" target="_blank"><text text-anchor="middle" font-size="10px" x="50%" y="100%">Text is not SVG - cannot display</text></a></switch></svg>
\ No newline at end of file
diff --git a/articles/images/qemu-system-device-model-part1/qdev_realize.svg b/articles/images/qemu-system-device-model-part1/qdev_realize.svg
new file mode 100644
index 0000000..2382d83
--- /dev/null
+++ b/articles/images/qemu-system-device-model-part1/qdev_realize.svg
@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- Do not edit this file with editors other than draw.io -->
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" version="1.1" width="1061px" height="399px" viewBox="-0.5 -0.5 1061 399" content="&lt;mxfile host=&quot;Electron&quot; modified=&quot;2023-08-26T08:12:40.380Z&quot; agent=&quot;Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) draw.io/21.6.8 Chrome/114.0.5735.289 Electron/25.5.0 Safari/537.36&quot; etag=&quot;QuPwDEKb15Ca-VpyYL1L&quot; version=&quot;21.6.8&quot; type=&quot;device&quot;&gt;&lt;diagram name=&quot;第 1 页&quot; id=&quot;jlvdNiT0j2TS_nkKn7i8&quot;&gt;7VpZc9s2EP4tfdCMlRl3eIiU/GgdcZq6aWaUaesnDkSCEhKQoEFQR399AQK8RFJHrKMe+0UiFgsssPt9C2HFjjkK1g8URIs/iAdxx9C8dcccdwxD1yyNfwnJRkps404K5hR5SqkQTNG/MBuppAnyYFxRZIRghqKq0CVhCF1WkQFKyaqq5hNctRqBOawJpi7AdenfyGMLJbWtXtHxCaL5IjOt22qDAci01VbiBfDIqiQyJx1zRAlh8ilYjyAW3sscI8d9bOnNV0ZhyA4ZsOh5k+ev4aeHz0+/r788fl5Se32b+Tlmm2zL0OMeUE1C2YLMSQjwpJAOKUlCD4ppNd4qdB4JibhQ58LvkLGNCidIGOGiBQuw6oVrxP4Rw3+1VOup1DNeq5nTxiZrhIxuSoNE86ncVwxLW9k4uT+xqVa/KVFMEurCXc5SAAR0DtkOPSOPLucFJAHk6+HjKMSAoWV1HUABdJ7rFSHkDyqKx0RUzrsEOFGWnmGQOChE7KZbC3Y1lKsFYnAagdQLK87oath8hPGIYELTsabvQ9t1uTxmlPyApR6vfzfTxIQ+CdlHECAsovGYuMgD3P6IhDFJkST6FUp0Ow/WElIG17vDVXdvNiCDtMo4PdVcleibyRYl5may0wdEr3n9nWI7qXMAxcxrUsxoptjaEd50Igr5aeSj+Zugm1Vlm27U6WbYF6Wb8U63g+lmHki33jXpZjbTzaUQMOi4GDkeXCIXxm+CcL0q4QytgXCDixLOfCfcwYTrHUg465qE69UIJwmW/oh0/CR03wTT+laVaYMGpukXZZr9+phW4VlBu/MzzTqQafYLmZYOvacUbEoKEUEhi0szfxWC0iVlsHVJMbfu7lv6pv0yfVvbAp9ccAHFfOc/j06rfkzztKHOZgd43ptIGluBzQNRThraRZNG//Uljasdz/aBSWNwzePZ3kc0x6ckcJ495L6Nko+tVU/qhpKPedGDelCLUMewMVO75z0+UDC0nxNR/x3WHJX3VIKXCcU0t3HqxXuuoNvRWqqmHSu1R9EVEhoAnHYWM9pz8Z2ihl+iMJ9H4ESukG9YLlIq1eATr1CAQQjPgZ0TYKFn7C9I2E33oxwhJ0fDXSsaPLRsDO8MuD/mKU9vXekmEUo6n90YFoc6X4ZWfuiWYu8r6t3nWOL7SRX59CAQIVJGRjwZIkh5zxe42u6UQwISkljGNzfQhDqMQni7KKFOv1Nd25jbt/P6iBkhWK4+HciXEzaOLDmKQ6p/Z0HD3gv7EujlxFLlZpzm0ikDjKtoH440rmm6NtAajXPbLTalx4dJfAarsyTeaXVCKRFA+HBCm5DSqMVoOdekQGjAhhL1h4frZhAOZ3EkcdksOhGOQBzzRNWGoF8ugZnbfIMVp7zcpKKH14qawrXys9bUXrcD5IHjtBOnWzLXDM0ZvTRYga9p3qxxP8hvD+UN32VXzHAOsv1/dnksIPcdITFkzl6Y3KTYFTk21REPIjF2r+zvi0aFQpbQcGcqOY61mub7jZZ8gOO2M30vX8/l7f741HbFjCeMD9zhtFeTFS52UO8wNJ789dto4jxMvjmjx/vpdEdO6J7t5OJ5xmGbqC2i+8+tn8PjqzkJT5yNdsCBzL5DV7wPQCKOv016YMjbTDMsTmf5z+HnyejbLvjlV8KjvGrqlm41WiwkpZ+OhU771eN0yZ/RpD2N5QfvUfDfB+xt6VaphMG1kJdKItw185A/Y+iLHlHpQC7A90ocIM+T9VfIr9lglk4kaK7+T+CzWsOONRYzJYzEqozW2a6phCStz5QLMEp0UIXlmJJn9hpIterdUHPpN9Rc8mr5ETUX3izemZT/XRSvnpqT/wA=&lt;/diagram&gt;&lt;/mxfile&gt;" style="background-color: rgb(255, 255, 255);"><defs/><g><path d="M 140 40 L 140 73.63" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 140 78.88 L 136.5 71.88 L 140 73.63 L 143.5 71.88 Z" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="all"/><rect x="70" y="0" width="140" height="40" fill="#ffe6cc" stroke="#d79b00" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 138px; height: 1px; padding-top: 20px; margin-left: 71px;"><div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: center;"><div style="display: inline-block; font-size: 16px; font-family: &quot;Lucida Console&quot;; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">qemu_init()</div></div></div></foreignObject><text x="140" y="25" fill="rgb(0, 0, 0)" font-family="Lucida Console" font-size="16px" text-anchor="middle">qemu_init()</text></switch></g><path d="M 140 120 L 140 153.63" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 140 158.88 L 136.5 151.88 L 140 153.63 L 143.5 151.88 Z" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="all"/><rect x="10" y="80" width="260" height="40" fill="#ffe6cc" stroke="#d79b00" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 258px; height: 1px; padding-top: 100px; margin-left: 11px;"><div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: center;"><div style="display: inline-block; font-size: 16px; font-family: &quot;Lucida Console&quot;; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">qemu_x_exit_preconfig()</div></div></div></foreignObject><text x="140" y="105" fill="rgb(0, 0, 0)" font-family="Lucida Console" font-size="16px" text-anchor="middle">qemu_x_exit_preconfig()</text></switch></g><path d="M 140 200 L 140 233.63" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 140 238.88 L 136.5 231.88 L 140 233.63 L 143.5 231.88 Z" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="all"/><rect x="0" y="160" width="280" height="40" fill="#ffe6cc" stroke="#d79b00" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 278px; height: 1px; padding-top: 180px; margin-left: 1px;"><div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: center;"><div style="display: inline-block; font-size: 16px; font-family: &quot;Lucida Console&quot;; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">qemu_create_cli_devices()</div></div></div></foreignObject><text x="140" y="185" fill="rgb(0, 0, 0)" font-family="Lucida Console" font-size="16px" text-anchor="middle">qemu_create_cli_devices()</text></switch></g><path d="M 140 280 L 140 313.63" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 140 318.88 L 136.5 311.88 L 140 313.63 L 143.5 311.88 Z" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="all"/><rect x="35" y="240" width="210" height="40" fill="#ffe6cc" stroke="#d79b00" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 208px; height: 1px; padding-top: 260px; margin-left: 36px;"><div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: center;"><div style="display: inline-block; font-size: 16px; font-family: &quot;Lucida Console&quot;; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">device_init_func()</div></div></div></foreignObject><text x="140" y="265" fill="rgb(0, 0, 0)" font-family="Lucida Console" font-size="16px" text-anchor="middle">device_init_func()</text></switch></g><path d="M 140 360 L 140 390 L 320 390 L 320 20 L 558.63 20" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 563.88 20 L 556.88 23.5 L 558.63 20 L 556.88 16.5 Z" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="all"/><rect x="40" y="320" width="200" height="40" fill="#ffe6cc" stroke="#d79b00" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 198px; height: 1px; padding-top: 340px; margin-left: 41px;"><div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: center;"><div style="display: inline-block; font-size: 16px; font-family: &quot;Lucida Console&quot;; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">qdev_device_add()</div></div></div></foreignObject><text x="140" y="345" fill="rgb(0, 0, 0)" font-family="Lucida Console" font-size="16px" text-anchor="middle">qdev_device_add()</text></switch></g><path d="M 720 40 L 720 73.63" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 720 78.88 L 716.5 71.88 L 720 73.63 L 723.5 71.88 Z" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="all"/><rect x="565" y="0" width="310" height="40" fill="#ffe6cc" stroke="#d79b00" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 308px; height: 1px; padding-top: 20px; margin-left: 566px;"><div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: center;"><div style="display: inline-block; font-size: 16px; font-family: &quot;Lucida Console&quot;; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">qdev_device_add_from_qdict()</div></div></div></foreignObject><text x="720" y="25" fill="rgb(0, 0, 0)" font-family="Lucida Console" font-size="16px" text-anchor="middle">qdev_device_add_from_qdict()</text></switch></g><path d="M 380 103 L 380 80 L 1060 80 L 1060 103" fill="#ffe6cc" stroke="#d79b00" stroke-miterlimit="10" pointer-events="all"/><path d="M 380 103 L 380 390 L 1060 390 L 1060 103" fill="none" stroke="#d79b00" stroke-miterlimit="10" pointer-events="none"/><path d="M 380 103 L 1060 103" fill="none" stroke="#d79b00" stroke-miterlimit="10" pointer-events="none"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 678px; height: 1px; padding-top: 92px; margin-left: 381px;"><div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: center;"><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: none; font-weight: bold; white-space: normal; overflow-wrap: normal;"><font style="font-size: 16px; font-weight: normal;" face="Lucida Console">qdev_realize()</font></div></div></div></foreignObject><text x="720" y="95" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle" font-weight="bold">qdev_realize()</text></switch></g><g transform="translate(-0.5 -0.5)"><switch><foreignObject pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe flex-start; width: 1px; height: 1px; padding-top: 250px; margin-left: 387px;"><div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: left;"><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: none; white-space: nowrap;"><div style="background-color: rgb(255, 255, 255); font-family: Consolas, &quot;Courier New&quot;, monospace; font-size: 16px; line-height: 19px;"><div style="">bool <span style="color: #795e26;">qdev_realize</span>(DeviceState *<span style="color: #001080;">dev</span>, BusState *<span style="color: #001080;">bus</span>, Error **<span style="color: #001080;">errp</span>)</div><div>{</div><div>    <span style="color: #795e26;">assert</span>(!<span style="color: #001080;">dev</span>-&gt;<span style="color: #001080;">realized</span> &amp;&amp; !<span style="color: #001080;">dev</span>-&gt;<span style="color: #001080;">parent_bus</span>);</div><br /><div>    <span style="color: #af00db;">if</span> (bus) {</div><div>        <span style="color: #af00db;">if</span> (!<span style="color: #795e26;">qdev_set_parent_bus</span>(dev, bus, errp)) {</div><div>            <span style="color: #af00db;">return</span> <span style="color: #0000ff;">false</span>;</div><div>        }</div><div>    } <span style="color: #af00db;">else</span> {</div><div>        <span style="color: #795e26;">assert</span>(!<span style="color: #795e26;">DEVICE_GET_CLASS</span>(dev)-&gt;<span style="color: #001080;">bus_type</span>);</div><div>    }</div><br /><div>    <span style="color: #af00db;">return</span> <span style="color: #795e26;">object_property_set_bool</span>(<span style="color: #795e26;">OBJECT</span>(dev), <span style="color: #a31515;">"realized"</span>, <span style="color: #0000ff;">true</span>, errp);</div><div>}</div></div></div></div></div></foreignObject><text x="387" y="254" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px">bool qdev_realize(DeviceState *dev, BusState *bus, Error **errp)...</text></switch></g></g><switch><g requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"/><a transform="translate(0,-5)" xlink:href="https://www.drawio.com/doc/faq/svg-export-text-problems" target="_blank"><text text-anchor="middle" font-size="10px" x="50%" y="100%">Text is not SVG - cannot display</text></a></switch></svg>
\ No newline at end of file
-- 
Gitee


From fa7a31242fbaa59bfefc094c4d6e5282f71553c8 Mon Sep 17 00:00:00 2001
From: jl-jiang <jjl9807@aliyun.com>
Date: Sat, 26 Aug 2023 17:36:30 +0800
Subject: [PATCH 02/13] qemu-system-device-model-part1.md: commit correct
 result of tinycorrect-spaces

Signed-off-by: jl-jiang <jjl9807@aliyun.com>
---
 articles/20230815-qemu-system-device-model-part1.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/articles/20230815-qemu-system-device-model-part1.md b/articles/20230815-qemu-system-device-model-part1.md
index 82c130f..b4e7d54 100644
--- a/articles/20230815-qemu-system-device-model-part1.md
+++ b/articles/20230815-qemu-system-device-model-part1.md
@@ -1,4 +1,4 @@
-> Corrector: [TinyCorrect](https://gitee.com/tinylab/tinycorrect) v0.2-rc2<br/>
+> Corrector: [TinyCorrect](https://gitee.com/tinylab/tinycorrect) v0.2-rc2 - [spaces]<br/>
 > Author:    jl-jiang <jjl9807@aliyun.com><br/>
 > Date:      2023/08/15<br/>
 > Revisor:   Bin Meng <bmeng@tinylab.org><br/>
@@ -184,7 +184,7 @@ QEMU 维护了一个全局的链表头数组 ` init_type_list`，分别指向不
 
 ![](images/qemu-system-device-model-part1/init_type_list.svg)
 
- `register_module_init` 函数会将待注册的设备类型注册函数，这里的例子中是 `e1000_register_types`，添加到 `MODULE_INIT_QOM` 下标所指向的链表尾部，完成注册工作。直到此时，真正的设备类型注册函数都没有执行，到底什么时候进行设备类型的注册呢？在[之前的文章](https://gitee.com/tinylab/riscv-linux/blob/master/articles/20230801-qemu-system-event-loop-part2.md)中，我们有分析过 QEMU 主事件循环的一般执行流程，`main` 函数会调用 `qemu_init` 函数进行初始化， `qemu_init` 在执行过程中会调用 `qemu_init_subsystems` 函数，而 `qemu_init_subsystems` 则会调用 `module_call_init` 函数，并传入参数 `MODULE_INIT_QOM`：
+ `register_module_init` 函数会将待注册的设备类型注册函数，这里的例子中是 `e1000_register_types`，添加到 `MODULE_INIT_QOM` 下标所指向的链表尾部，完成注册工作。直到此时，真正的设备类型注册函数都没有执行，到底什么时候进行设备类型的注册呢？在[之前的文章](https://gitee.com/tinylab/riscv-linux/blob/master/articles/20230801-qemu-system-event-loop-part2.md)中，我们有分析过 QEMU 主事件循环的一般执行流程，`main` 函数会调用 `qemu_init` 函数进行初始化，`qemu_init` 在执行过程中会调用 `qemu_init_subsystems` 函数，而 `qemu_init_subsystems` 则会调用 `module_call_init` 函数，并传入参数 `MODULE_INIT_QOM`：
 
 ```c
 /* util/module.c: 755 */
@@ -384,4 +384,4 @@ QEMU 在初始化阶段经过一系列函数调用，最终调用 `qdev_realize`
 - [The QEMU Object Model (QOM) ](https://www.qemu.org/docs/master/devel/qom.html)
 - [浅谈QEMU的对象系统](https://juejin.cn/post/6844903845550620685)
 - [understanding_qemu](https://richardweiyang-2.gitbook.io/understanding_qemu)
-- 《QEMU/KVM 源码解析与应用》李强，机械工业出版社
\ No newline at end of file
+- 《QEMU/KVM 源码解析与应用》李强，机械工业出版社
-- 
Gitee


From e58da0d1ee6d71bf6f9d9ea39133a9bb9dd20d32 Mon Sep 17 00:00:00 2001
From: jl-jiang <jjl9807@aliyun.com>
Date: Sat, 26 Aug 2023 17:37:03 +0800
Subject: [PATCH 03/13] qemu-system-device-model-part1.md: commit correct
 result of tinycorrect-codeinline

Signed-off-by: jl-jiang <jjl9807@aliyun.com>
---
 ...20230815-qemu-system-device-model-part1.md | 20 +++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/articles/20230815-qemu-system-device-model-part1.md b/articles/20230815-qemu-system-device-model-part1.md
index b4e7d54..43243b0 100644
--- a/articles/20230815-qemu-system-device-model-part1.md
+++ b/articles/20230815-qemu-system-device-model-part1.md
@@ -1,4 +1,4 @@
-> Corrector: [TinyCorrect](https://gitee.com/tinylab/tinycorrect) v0.2-rc2 - [spaces]<br/>
+> Corrector: [TinyCorrect](https://gitee.com/tinylab/tinycorrect) v0.2-rc2 - [spaces codeinline]<br/>
 > Author:    jl-jiang <jjl9807@aliyun.com><br/>
 > Date:      2023/08/15<br/>
 > Revisor:   Bin Meng <bmeng@tinylab.org><br/>
@@ -158,7 +158,7 @@ static void __attribute__((constructor)) do_qemu_init_ ## function(void)    \
 }
 ```
 
-这里我们需要关注的是这个修饰 `__attribute__((constructor))`，它是 GCC 的一个扩展，用于确保被修饰的函数在 `main` 函数执行之被调用。仍然以上文的 e1000 网卡为例，调用 `type_init` 时传入的函数名为 `e1000_register_types`，这个宏的作用就是生成函数`static void do_qemu_init_e1000_register_types(void)`，并保证其在 `main` 函数之前被调用，以达到自动初始化的目的。
+这里我们需要关注的是这个修饰 `__attribute__((constructor))`，它是 GCC 的一个扩展，用于确保被修饰的函数在 `main` 函数执行之被调用。仍然以上文的 e1000 网卡为例，调用 `type_init` 时传入的函数名为 `e1000_register_types`，这个宏的作用就是生成函数 `static void do_qemu_init_e1000_register_types(void)`，并保证其在 `main` 函数之前被调用，以达到自动初始化的目的。
 
 下面分析 `register_module_init` 函数的行为：
 
@@ -180,7 +180,7 @@ void register_module_init(void (*fn)(void), module_init_type type)
 }
 ```
 
-QEMU 维护了一个全局的链表头数组 ` init_type_list`，分别指向不同类型的注册函数链表，具体如下图所示：
+QEMU 维护了一个全局的链表头数组 `init_type_list`，分别指向不同类型的注册函数链表，具体如下图所示：
 
 ![](images/qemu-system-device-model-part1/init_type_list.svg)
 
@@ -216,7 +216,7 @@ void module_call_init(module_init_type type)
 
 设备类型注册后，在使用之前需要初始化该类型，并生成对应的 `ObjectClass` 对象。
 
-这里回顾一下上文介绍的 `TypeImpl` 结构体，可以发现其中有一个名为 `class` 的 `ObjectClass` 类型的成员变量，所谓初始化其实就是初始化这个 `class` 成员，负责具体初始化工作的是 ` type_initialize` 函数：
+这里回顾一下上文介绍的 `TypeImpl` 结构体，可以发现其中有一个名为 `class` 的 `ObjectClass` 类型的成员变量，所谓初始化其实就是初始化这个 `class` 成员，负责具体初始化工作的是 `type_initialize` 函数：
 
 ```c
 /* qom/object.c: 286 */
@@ -306,7 +306,7 @@ static void type_initialize(TypeImpl *ti)
 }
 ```
 
-` type_initialize` 函数首先执行一些必要的检查，接着会设置类型的大小并创建该类型，设置类型实例的大小，为实例化设备做准备，
+`type_initialize` 函数首先执行一些必要的检查，接着会设置类型的大小并创建该类型，设置类型实例的大小，为实例化设备做准备，
 然后初始化父设备类型和接口类型，最后调用父设备类型的 `class_base_init` 和自己的 `class_init` 完成初始化工作。
 
 此外，通过上述代码我们还可以得出两点结论：
@@ -318,7 +318,7 @@ static void type_initialize(TypeImpl *ti)
 
 ## 设备实例化
 
-完成了设备类型的初始化，接着就要实例化设备了，这个过程由 `object_initialize` 函数实现，而 `object_initialize` 又通过调用 `object_initialize_with_type` 完成实例化工作。抽象地看，设备实例化主要完成三件事：首先，建立`Object` 和 `ObjectClass` 之间的关联；然后，递归调用父类型的 `instance_init` 函数；最后，调用自己的 `instance_init` 函数。需要注意的是，这种抽象的视角简化了设备实例化流程，也模糊了很多真实场景下的具体细节。
+完成了设备类型的初始化，接着就要实例化设备了，这个过程由 `object_initialize` 函数实现，而 `object_initialize` 又通过调用 `object_initialize_with_type` 完成实例化工作。抽象地看，设备实例化主要完成三件事：首先，建立 `Object` 和 `ObjectClass` 之间的关联；然后，递归调用父类型的 `instance_init` 函数；最后，调用自己的 `instance_init` 函数。需要注意的是，这种抽象的视角简化了设备实例化流程，也模糊了很多真实场景下的具体细节。
 
 ### 实例化函数
 
@@ -326,7 +326,7 @@ static void type_initialize(TypeImpl *ti)
 
 ![](images/qemu-system-device-model-part1/DeviceClass.svg)
 
-这里我们需要关注的是负责实例化 `DeviceClass` 的函数 ` device_initfn`：
+这里我们需要关注的是负责实例化 `DeviceClass` 的函数 `device_initfn`：
 
 ```c
 /* hw/core/qdev.c: 652 */
@@ -349,16 +349,16 @@ static void device_initfn(Object *obj)
 }
 ```
 
-` device_initfn` 函数的整体执行逻辑比较简单，主要分为以下四个步骤：
+`device_initfn` 函数的整体执行逻辑比较简单，主要分为以下四个步骤：
 
 - **设备状态转换：** 将传入的 `Object` 指针转换为 `DeviceState` 指针。`DEVICE` 是一个宏，用于从基类 `Object` 转换到派生类 `DeviceState`
 - **检查机器准备状态：** 使用 `phase_check` 函数检查当前的机器初始化阶段是否为 `PHASE_MACHINE_READY`。如果是，则设置设备的 `hotplugged` 属性为 1，表示该设备是在虚拟机已经启动后热插入的。同时，全局变量 `qdev_hot_added` 被设置为 `true`，表示有设备被热插入
-- **初始化设备属性：** `instance_id_alias` 被设置为 `-1`，表示没有别名；`realized` 被设置为 `false`，表示设备尚未实现；`allow_unplug_during_migration` 被设置为 `false`，表示在迁移期间不允许拔出此设备
+- **初始化设备属性：**`instance_id_alias` 被设置为 `-1`，表示没有别名；`realized` 被设置为 `false`，表示设备尚未实现；`allow_unplug_during_migration` 被设置为 `false`，表示在迁移期间不允许拔出此设备
 - **初始化设备的 GPIO 和时钟列表：** 使用 `QLIST_INIT` 宏初始化了设备的 GPIO 和时钟列表
 
 ### realized 属性设置
 
-我们注意到 ` device_initfn` 函数将 `DeviceState` 的 `realized` 被设置为 `false`，意味着这个设备还没有被实现，那么这个属性究竟是什么时候被设置为 `Ture` 的呢？通过分析 QEMU 的启动流程，可以梳理出如下函数调用链：
+我们注意到 `device_initfn` 函数将 `DeviceState` 的 `realized` 被设置为 `false`，意味着这个设备还没有被实现，那么这个属性究竟是什么时候被设置为 `Ture` 的呢？通过分析 QEMU 的启动流程，可以梳理出如下函数调用链：
 
 ![](images/qemu-system-device-model-part1/qdev_realize.svg)
 
-- 
Gitee


From 701fb034ee66877bf46d05b09e816102890fa633 Mon Sep 17 00:00:00 2001
From: jl-jiang <jjl9807@aliyun.com>
Date: Sat, 26 Aug 2023 17:37:33 +0800
Subject: [PATCH 04/13] qemu-system-device-model-part1.md: commit correct
 result of tinycorrect-images

Signed-off-by: jl-jiang <jjl9807@aliyun.com>
---
 articles/20230815-qemu-system-device-model-part1.md | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/articles/20230815-qemu-system-device-model-part1.md b/articles/20230815-qemu-system-device-model-part1.md
index 43243b0..046d192 100644
--- a/articles/20230815-qemu-system-device-model-part1.md
+++ b/articles/20230815-qemu-system-device-model-part1.md
@@ -1,4 +1,4 @@
-> Corrector: [TinyCorrect](https://gitee.com/tinylab/tinycorrect) v0.2-rc2 - [spaces codeinline]<br/>
+> Corrector: [TinyCorrect](https://gitee.com/tinylab/tinycorrect) v0.2-rc2 - [spaces codeinline images]<br/>
 > Author:    jl-jiang <jjl9807@aliyun.com><br/>
 > Date:      2023/08/15<br/>
 > Revisor:   Bin Meng <bmeng@tinylab.org><br/>
@@ -182,7 +182,7 @@ void register_module_init(void (*fn)(void), module_init_type type)
 
 QEMU 维护了一个全局的链表头数组 `init_type_list`，分别指向不同类型的注册函数链表，具体如下图所示：
 
-![](images/qemu-system-device-model-part1/init_type_list.svg)
+![init_type_list.svg](images/qemu-system-device-model-part1/init_type_list.svg)
 
  `register_module_init` 函数会将待注册的设备类型注册函数，这里的例子中是 `e1000_register_types`，添加到 `MODULE_INIT_QOM` 下标所指向的链表尾部，完成注册工作。直到此时，真正的设备类型注册函数都没有执行，到底什么时候进行设备类型的注册呢？在[之前的文章](https://gitee.com/tinylab/riscv-linux/blob/master/articles/20230801-qemu-system-event-loop-part2.md)中，我们有分析过 QEMU 主事件循环的一般执行流程，`main` 函数会调用 `qemu_init` 函数进行初始化，`qemu_init` 在执行过程中会调用 `qemu_init_subsystems` 函数，而 `qemu_init_subsystems` 则会调用 `module_call_init` 函数，并传入参数 `MODULE_INIT_QOM`：
 
@@ -324,7 +324,7 @@ static void type_initialize(TypeImpl *ti)
 
 下面以 `DeviceClass` 为例详细分析设备的实例化过程。`DeviceClass` 是 QEMU 设备模型的核心组件，它继承自 `ObjectClass`，提供了设备的基本行为和属性的模板，是很多设备的父类，其实例化过程很有代表性。下图给出了 `DeviceClass` 有关类和对象之间的关系：
 
-![](images/qemu-system-device-model-part1/DeviceClass.svg)
+![DeviceClass.svg](images/qemu-system-device-model-part1/DeviceClass.svg)
 
 这里我们需要关注的是负责实例化 `DeviceClass` 的函数 `device_initfn`：
 
@@ -360,7 +360,7 @@ static void device_initfn(Object *obj)
 
 我们注意到 `device_initfn` 函数将 `DeviceState` 的 `realized` 被设置为 `false`，意味着这个设备还没有被实现，那么这个属性究竟是什么时候被设置为 `Ture` 的呢？通过分析 QEMU 的启动流程，可以梳理出如下函数调用链：
 
-![](images/qemu-system-device-model-part1/qdev_realize.svg)
+![qdev_realize.svg](images/qemu-system-device-model-part1/qdev_realize.svg)
 
 QEMU 在初始化阶段经过一系列函数调用，最终调用 `qdev_realize` 函数，该函数是 QEMU 设备模型中的一个核心函数，用于激活设备，也就是将设备对应的 `DeviceState` 结构的 `realized` 属性设置为 `true`，表示设备已经被实例化并准备好在模拟环境中运行。在设置 `realized` 属性之前，函数会执行一些基础的检查，以确保设备尚未被实例化并且没有父总线，然后函数会检查设备总线类型并设置父总线，最后调用 `object_property_set_bool` 函数设置 `realized` 属性设置为 `true`，完成设备实例化。
 
-- 
Gitee


From c1ad1d73b9bfae08447a09146549021eb0e2d4e8 Mon Sep 17 00:00:00 2001
From: jl-jiang <jjl9807@aliyun.com>
Date: Sat, 26 Aug 2023 17:38:27 +0800
Subject: [PATCH 05/13] qemu-system-device-model-part1.md: commit correct
 result of tinycorrect-pangu

Signed-off-by: jl-jiang <jjl9807@aliyun.com>
---
 articles/20230815-qemu-system-device-model-part1.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/articles/20230815-qemu-system-device-model-part1.md b/articles/20230815-qemu-system-device-model-part1.md
index 046d192..59c0732 100644
--- a/articles/20230815-qemu-system-device-model-part1.md
+++ b/articles/20230815-qemu-system-device-model-part1.md
@@ -1,4 +1,4 @@
-> Corrector: [TinyCorrect](https://gitee.com/tinylab/tinycorrect) v0.2-rc2 - [spaces codeinline images]<br/>
+> Corrector: [TinyCorrect](https://gitee.com/tinylab/tinycorrect) v0.2-rc2 - [spaces codeinline images urls refs pangu]<br/>
 > Author:    jl-jiang <jjl9807@aliyun.com><br/>
 > Date:      2023/08/15<br/>
 > Revisor:   Bin Meng <bmeng@tinylab.org><br/>
@@ -382,6 +382,6 @@ QEMU 在初始化阶段经过一系列函数调用，最终调用 `qdev_realize`
 ## 参考资料
 
 - [The QEMU Object Model (QOM) ](https://www.qemu.org/docs/master/devel/qom.html)
-- [浅谈QEMU的对象系统](https://juejin.cn/post/6844903845550620685)
+- [浅谈 QEMU 的对象系统](https://juejin.cn/post/6844903845550620685)
 - [understanding_qemu](https://richardweiyang-2.gitbook.io/understanding_qemu)
 - 《QEMU/KVM 源码解析与应用》李强，机械工业出版社
-- 
Gitee


From 1440bf292f84bda8bdc68b355243b0a5517a1200 Mon Sep 17 00:00:00 2001
From: jl-jiang <jjl9807@aliyun.com>
Date: Sat, 26 Aug 2023 17:38:53 +0800
Subject: [PATCH 06/13] qemu-system-device-model-part1.md: commit correct
 result of tinycorrect-autocorrect

Signed-off-by: jl-jiang <jjl9807@aliyun.com>
---
 articles/20230815-qemu-system-device-model-part1.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/articles/20230815-qemu-system-device-model-part1.md b/articles/20230815-qemu-system-device-model-part1.md
index 59c0732..4cb9904 100644
--- a/articles/20230815-qemu-system-device-model-part1.md
+++ b/articles/20230815-qemu-system-device-model-part1.md
@@ -1,4 +1,4 @@
-> Corrector: [TinyCorrect](https://gitee.com/tinylab/tinycorrect) v0.2-rc2 - [spaces codeinline images urls refs pangu]<br/>
+> Corrector: [TinyCorrect](https://gitee.com/tinylab/tinycorrect) v0.2-rc2 - [spaces codeinline images urls refs pangu autocorrect]<br/>
 > Author:    jl-jiang <jjl9807@aliyun.com><br/>
 > Date:      2023/08/15<br/>
 > Revisor:   Bin Meng <bmeng@tinylab.org><br/>
@@ -112,7 +112,7 @@ struct TypeImpl
 
 通过观察不难发现 `TypeInfo` 和 `TypeImpl` 两个结构体的结构相似，绝大多数成员变量都相同，那么为什么注册过程中不直接使用，而要重新复制一遍呢？这与 QEMU 对象系统的设计理念有关，`TypeInfo` 结构体是面向 API 使用者的一个工具，使用者只有在注册设备类型的时候会使用到 `TypeInfo`，提供类型注册所需的必要信息和回调函数，此后 QEMU 会根据 `TypeInfo` 自动生成对应的 `TypeImpl` 结构体，至此 `TypeInfo` 的生命周期就结束了。换句话说，`TypeInfo` 保存静态的注册数据，而 `TypeImpl` 保存动态的运行数据，这种设计降低了系统的耦合度，提升了稳定性。
 
-下面我们来分析 `type_register()` 函数的调用时机，这里就需要引申出另一个问题，就是注册函数本身也有“注册 - 执行”机制。我们以虚拟网卡设备 e1000 为例进行分析：
+下面我们来分析 `type_register()` 函数的调用时机，这里就需要引申出另一个问题，就是注册函数本身也有 “注册 - 执行” 机制。我们以虚拟网卡设备 e1000 为例进行分析：
 
 ```c
 /* hw/e1000.c: 1822 */
-- 
Gitee


From 5ece4a7feb104128536385f96e5f1f7f2cdf37a4 Mon Sep 17 00:00:00 2001
From: jl-jiang <jjl9807@aliyun.com>
Date: Sat, 26 Aug 2023 17:40:09 +0800
Subject: [PATCH 07/13] fix typos

---
 articles/20230815-qemu-system-device-model-part1.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/articles/20230815-qemu-system-device-model-part1.md b/articles/20230815-qemu-system-device-model-part1.md
index 4cb9904..0a2f78d 100644
--- a/articles/20230815-qemu-system-device-model-part1.md
+++ b/articles/20230815-qemu-system-device-model-part1.md
@@ -377,11 +377,11 @@ QEMU 在初始化阶段经过一系列函数调用，最终调用 `qdev_realize`
 
 ## 总结
 
-本文从设备的生命周期这一角度入手，介绍了设备类型注册、设备类型初始化、设备实例化等环节的基本原理和执行流程，打通了从设备类型表创建到设备销毁的逻辑链条，在一个较为抽象的层面对 QEMU 设备模型进行了初步分析。下一篇文章中，我们将专题介绍 QEMU 对象模型以及面向对象的设备管理。
+本文从设备的生命周期这一角度入手，介绍了设备类型注册、设备类型初始化、设备实例化等环节的基本原理和执行流程，打通了从设备类型表创建到设备销毁的逻辑链条，在一个较为抽象的层面对 QEMU 设备模型进行了初步分析。下一篇文章中，我们将专题介绍 QEMU 对象模型以及面向对象的设备管理方法。
 
 ## 参考资料
 
 - [The QEMU Object Model (QOM) ](https://www.qemu.org/docs/master/devel/qom.html)
-- [浅谈 QEMU 的对象系统](https://juejin.cn/post/6844903845550620685)
 - [understanding_qemu](https://richardweiyang-2.gitbook.io/understanding_qemu)
+- [浅谈 QEMU 的对象系统](https://juejin.cn/post/6844903845550620685)
 - 《QEMU/KVM 源码解析与应用》李强，机械工业出版社
-- 
Gitee


From d2a04aa3e606dedb8e26006c5904222c550a5553 Mon Sep 17 00:00:00 2001
From: jl-jiang <jjl9807@aliyun.com>
Date: Sat, 26 Aug 2023 17:41:15 +0800
Subject: [PATCH 08/13] qemu-system-device-model-part1.md: commit correct
 result of tinycorrect-urls

Signed-off-by: jl-jiang <jjl9807@aliyun.com>
---
 .../20230815-qemu-system-device-model-part1.md    | 15 ++++++++++-----
 1 file changed, 10 insertions(+), 5 deletions(-)

diff --git a/articles/20230815-qemu-system-device-model-part1.md b/articles/20230815-qemu-system-device-model-part1.md
index 0a2f78d..c5161e9 100644
--- a/articles/20230815-qemu-system-device-model-part1.md
+++ b/articles/20230815-qemu-system-device-model-part1.md
@@ -1,4 +1,4 @@
-> Corrector: [TinyCorrect](https://gitee.com/tinylab/tinycorrect) v0.2-rc2 - [spaces codeinline images urls refs pangu autocorrect]<br/>
+> Corrector: [TinyCorrect](https://gitee.com/tinylab/tinycorrect) v0.2-rc2 - [urls]<br/>
 > Author:    jl-jiang <jjl9807@aliyun.com><br/>
 > Date:      2023/08/15<br/>
 > Revisor:   Bin Meng <bmeng@tinylab.org><br/>
@@ -184,7 +184,7 @@ QEMU 维护了一个全局的链表头数组 `init_type_list`，分别指向不
 
 ![init_type_list.svg](images/qemu-system-device-model-part1/init_type_list.svg)
 
- `register_module_init` 函数会将待注册的设备类型注册函数，这里的例子中是 `e1000_register_types`，添加到 `MODULE_INIT_QOM` 下标所指向的链表尾部，完成注册工作。直到此时，真正的设备类型注册函数都没有执行，到底什么时候进行设备类型的注册呢？在[之前的文章](https://gitee.com/tinylab/riscv-linux/blob/master/articles/20230801-qemu-system-event-loop-part2.md)中，我们有分析过 QEMU 主事件循环的一般执行流程，`main` 函数会调用 `qemu_init` 函数进行初始化，`qemu_init` 在执行过程中会调用 `qemu_init_subsystems` 函数，而 `qemu_init_subsystems` 则会调用 `module_call_init` 函数，并传入参数 `MODULE_INIT_QOM`：
+ `register_module_init` 函数会将待注册的设备类型注册函数，这里的例子中是 `e1000_register_types`，添加到 `MODULE_INIT_QOM` 下标所指向的链表尾部，完成注册工作。直到此时，真正的设备类型注册函数都没有执行，到底什么时候进行设备类型的注册呢？在[之前的文章][001]中，我们有分析过 QEMU 主事件循环的一般执行流程，`main` 函数会调用 `qemu_init` 函数进行初始化，`qemu_init` 在执行过程中会调用 `qemu_init_subsystems` 函数，而 `qemu_init_subsystems` 则会调用 `module_call_init` 函数，并传入参数 `MODULE_INIT_QOM`：
 
 ```c
 /* util/module.c: 755 */
@@ -381,7 +381,12 @@ QEMU 在初始化阶段经过一系列函数调用，最终调用 `qdev_realize`
 
 ## 参考资料
 
-- [The QEMU Object Model (QOM) ](https://www.qemu.org/docs/master/devel/qom.html)
-- [understanding_qemu](https://richardweiyang-2.gitbook.io/understanding_qemu)
-- [浅谈 QEMU 的对象系统](https://juejin.cn/post/6844903845550620685)
+- [The QEMU Object Model (QOM)][004]
+- [understanding_qemu][003]
+- [浅谈 QEMU 的对象系统][002]
 - 《QEMU/KVM 源码解析与应用》李强，机械工业出版社
+
+[001]: https://gitee.com/tinylab/riscv-linux/blob/master/articles/20230801-qemu-system-event-loop-part2.md
+[002]: https://juejin.cn/post/6844903845550620685
+[003]: https://richardweiyang-2.gitbook.io/understanding_qemu
+[004]: https://www.qemu.org/docs/master/devel/qom.html
-- 
Gitee


From bd4a6a0a88448082cd962d8edd6972dd0cbcd718 Mon Sep 17 00:00:00 2001
From: falcon <falcon@tinylab.org>
Date: Sat, 2 Sep 2023 11:46:35 +0000
Subject: [PATCH 09/13] Update
 articles/20230815-qemu-system-device-model-part1.md

---
 articles/20230815-qemu-system-device-model-part1.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/articles/20230815-qemu-system-device-model-part1.md b/articles/20230815-qemu-system-device-model-part1.md
index c5161e9..81bcdcc 100644
--- a/articles/20230815-qemu-system-device-model-part1.md
+++ b/articles/20230815-qemu-system-device-model-part1.md
@@ -208,7 +208,7 @@ void module_call_init(module_init_type type)
 }
 ```
 
-这里 `module_call_init` 函数作用就是找到 `MODULE_INIT_QOM` 对应的链表，然后依次执行链表项中的 `init` 成员函数，对于 e1000 网卡而言就是之前通过 `register_module_init` 注册的的 `e1000_register_types` 函数。
+这里 `module_call_init` 函数作用就是找到 `MODULE_INIT_QOM` 对应的链表，然后依次执行链表项中的 `init` 成员函数，对于 e1000 网卡而言就是之前通过 `register_module_init` 注册的 `e1000_register_types` 函数。
 
 到此为止，设备类型注册的逻辑链条就算完整了。
 
-- 
Gitee


From 375a725ab5ba168b319d224271e1a7a681489770 Mon Sep 17 00:00:00 2001
From: falcon <falcon@tinylab.org>
Date: Sat, 2 Sep 2023 11:47:02 +0000
Subject: [PATCH 10/13] Update
 articles/20230815-qemu-system-device-model-part1.md

---
 articles/20230815-qemu-system-device-model-part1.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/articles/20230815-qemu-system-device-model-part1.md b/articles/20230815-qemu-system-device-model-part1.md
index 81bcdcc..97e34fc 100644
--- a/articles/20230815-qemu-system-device-model-part1.md
+++ b/articles/20230815-qemu-system-device-model-part1.md
@@ -368,7 +368,7 @@ QEMU 在初始化阶段经过一系列函数调用，最终调用 `qdev_realize`
 
 设备销毁的步骤与设备创建过程正好相反，一般包含以下四个步骤：
 
-- **设备反实例化：** 停止操作设备并释放占用资源后，通过代码 `object_property_set_bool(OBJECT(dev), "realized", false, &error)` 设置 `realized` 属性设置为 `false`，标记设备已经反实例化
+- **设备反实例化：** 停止操作设备并释放占用资源后，通过代码 `object_property_set_bool(OBJECT(dev), "realized", false, &error)` 把 `realized` 属性设置为 `false`，标记设备已经反实例化
 - **从总线中移除：** 设备通常连接到一个总线，在销毁设备之前，需要从其父总线中将之移除
 - **销毁设备对象：** 调用 `object_unref` 函数减少设备对象的引用计数，当引用计数降为 0 时，并调用设备对象的析构函数，释放所占内存空间及其他资源
 - **反注册设备类型：** 有时可能还需要反注册设备类型，注销回调函数，清理释放为设备分配的各种资源
-- 
Gitee


From fe3530a373cc559bd4e25cfca78303816258383a Mon Sep 17 00:00:00 2001
From: falcon <falcon@tinylab.org>
Date: Sat, 2 Sep 2023 11:47:22 +0000
Subject: [PATCH 11/13] Update
 articles/20230815-qemu-system-device-model-part1.md

---
 articles/20230815-qemu-system-device-model-part1.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/articles/20230815-qemu-system-device-model-part1.md b/articles/20230815-qemu-system-device-model-part1.md
index 97e34fc..1d538ca 100644
--- a/articles/20230815-qemu-system-device-model-part1.md
+++ b/articles/20230815-qemu-system-device-model-part1.md
@@ -369,7 +369,7 @@ QEMU 在初始化阶段经过一系列函数调用，最终调用 `qdev_realize`
 设备销毁的步骤与设备创建过程正好相反，一般包含以下四个步骤：
 
 - **设备反实例化：** 停止操作设备并释放占用资源后，通过代码 `object_property_set_bool(OBJECT(dev), "realized", false, &error)` 把 `realized` 属性设置为 `false`，标记设备已经反实例化
-- **从总线中移除：** 设备通常连接到一个总线，在销毁设备之前，需要从其父总线中将之移除
+- **从总线中移除：** 设备通常连接到一个总线，在销毁设备之前，需要将其从父总线中移除
 - **销毁设备对象：** 调用 `object_unref` 函数减少设备对象的引用计数，当引用计数降为 0 时，并调用设备对象的析构函数，释放所占内存空间及其他资源
 - **反注册设备类型：** 有时可能还需要反注册设备类型，注销回调函数，清理释放为设备分配的各种资源
 
-- 
Gitee


From 08e833fcb8216830212fdb17a17015991b3cf3f5 Mon Sep 17 00:00:00 2001
From: falcon <falcon@tinylab.org>
Date: Sat, 2 Sep 2023 11:47:51 +0000
Subject: [PATCH 12/13] Update
 articles/20230815-qemu-system-device-model-part1.md

---
 articles/20230815-qemu-system-device-model-part1.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/articles/20230815-qemu-system-device-model-part1.md b/articles/20230815-qemu-system-device-model-part1.md
index 1d538ca..8e6a39b 100644
--- a/articles/20230815-qemu-system-device-model-part1.md
+++ b/articles/20230815-qemu-system-device-model-part1.md
@@ -358,7 +358,7 @@ static void device_initfn(Object *obj)
 
 ### realized 属性设置
 
-我们注意到 `device_initfn` 函数将 `DeviceState` 的 `realized` 被设置为 `false`，意味着这个设备还没有被实现，那么这个属性究竟是什么时候被设置为 `Ture` 的呢？通过分析 QEMU 的启动流程，可以梳理出如下函数调用链：
+我们注意到 `device_initfn` 函数将 `DeviceState` 的 `realized` 设置为 `false`，意味着这个设备还没有被实现，那么这个属性究竟是什么时候被设置为 `true` 的呢？通过分析 QEMU 的启动流程，可以梳理出如下函数调用链：
 
 ![qdev_realize.svg](images/qemu-system-device-model-part1/qdev_realize.svg)
 
-- 
Gitee


From ed4a040c30f58414ad6a2a7669abd609ba0cca46 Mon Sep 17 00:00:00 2001
From: falcon <falcon@tinylab.org>
Date: Sat, 2 Sep 2023 11:48:26 +0000
Subject: [PATCH 13/13] Update
 articles/20230815-qemu-system-device-model-part1.md

---
 articles/20230815-qemu-system-device-model-part1.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/articles/20230815-qemu-system-device-model-part1.md b/articles/20230815-qemu-system-device-model-part1.md
index 8e6a39b..2114c79 100644
--- a/articles/20230815-qemu-system-device-model-part1.md
+++ b/articles/20230815-qemu-system-device-model-part1.md
@@ -362,7 +362,7 @@ static void device_initfn(Object *obj)
 
 ![qdev_realize.svg](images/qemu-system-device-model-part1/qdev_realize.svg)
 
-QEMU 在初始化阶段经过一系列函数调用，最终调用 `qdev_realize` 函数，该函数是 QEMU 设备模型中的一个核心函数，用于激活设备，也就是将设备对应的 `DeviceState` 结构的 `realized` 属性设置为 `true`，表示设备已经被实例化并准备好在模拟环境中运行。在设置 `realized` 属性之前，函数会执行一些基础的检查，以确保设备尚未被实例化并且没有父总线，然后函数会检查设备总线类型并设置父总线，最后调用 `object_property_set_bool` 函数设置 `realized` 属性设置为 `true`，完成设备实例化。
+QEMU 在初始化阶段经过一系列函数调用，最终调用 `qdev_realize` 函数，该函数是 QEMU 设备模型中的一个核心函数，用于激活设备，也就是将设备对应的 `DeviceState` 结构的 `realized` 属性设置为 `true`，表示设备已经被实例化并准备好在模拟环境中运行。在设置 `realized` 属性之前，函数会执行一些基础的检查，以确保设备尚未被实例化并且没有父总线，然后函数会检查设备总线类型并设置父总线，最后调用 `object_property_set_bool` 函数设置 `realized` 属性为 `true`，完成设备实例化。
 
 ## 设备销毁
 
-- 
Gitee