QEMU ACPI CPU 熱插拔接口規(guī)范深度解析寄存器協(xié)議、AML 固件實(shí)現(xiàn)與 OSPM 協(xié)作機(jī)制【免費(fèi)下載鏈接】qemuOfficial QEMU mirror. Please see https://www.qemu.org/contribute/ for how to submit changes to QEMU. Pull Requests are disabled. Please only use release tarballs from the QEMU website.項(xiàng)目地址: https://gitcode.com/gh_mirrors/qe/qemu本篇技術(shù)指南以 QEMU 官方接口規(guī)范文檔 docs/specs/acpi_cpu_hotplug.rst 為核心骨架結(jié)合倉庫內(nèi) hw/acpi/cpu.c、include/hw/acpi/cpu.h、include/hw/acpi/pc-hotplug.h 等源碼與 tests/qtest/bios-tables-test.c 測(cè)試用例系統(tǒng)講解 QEMU 與 ACPI BIOS 之間用于 CPU 熱插拔的現(xiàn)代寄存器接口。讀者將掌握寄存器塊的布局與讀寫語義、命令字段的完整協(xié)議、OST 狀態(tài)上報(bào)流程以及檢測(cè)接口 → 獲取事件 CPU → 枚舉 CPU → 觸發(fā) eject四條標(biāo)準(zhǔn) OSPM 操作路徑的精確實(shí)現(xiàn)步驟并能對(duì)照源碼理解每個(gè)寄存器位在 QEMU 內(nèi)部狀態(tài)的落地方式。一、接口背景QEMU 與 ACPI BIOS 如何協(xié)作實(shí)現(xiàn) CPU 熱插拔QEMU 通過 ACPI高級(jí)配置與電源管理接口向客戶機(jī)提供 CPU 熱插拔CPU hotplug能力。整個(gè)交互模型是QEMU 硬件側(cè)寄存器 ACPI BIOS 固件 客戶機(jī) OSPM操作系統(tǒng)電源管理三方協(xié)作QEMU 側(cè)在 IO 空間中暴露一組固定布局的寄存器塊作為設(shè)備模型與固件之間的郵箱記錄每個(gè) CPU 插槽的插入/移除狀態(tài)、事件標(biāo)志與 OSTOSPM Status Table信息ACPI BIOS 側(cè)生成描述這些寄存器的 ACPI 表與 AML 代碼由build_cpus_aml()動(dòng)態(tài)構(gòu)建并實(shí)現(xiàn)CSCN掃描、CEJ0彈出、COSTOST 上報(bào)等控制方法OSPM 側(cè)通過_STA、_EJ0、_OST等 ACPI 對(duì)象查詢 CPU 狀態(tài)、請(qǐng)求彈出并回寫操作結(jié)果。文檔明確指出ACPI BIOS GPE.2 處理器專用于向 OS 通知 CPU hot-add熱添加與 hot-remove熱移除事件。QEMU 內(nèi)部對(duì)應(yīng)的事件源定義于 include/hw/acpi/acpi_dev_interface.hACPI_CPU_HOTPLUG_STATUS 4在通用事件設(shè)備GED路徑中由 hw/acpi/generic_event_device.c 處理。二、現(xiàn)代 CPU 熱插拔寄存器塊總覽2.1 基地址與大小項(xiàng)目值ICH9-LPCq35 機(jī)型IO 端口0x0cd8PIIX-PMi440fx/pc 機(jī)型IO 端口0xaf00寄存器塊長度ACPI_CPU_HOTPLUG_REG_LEN 12字節(jié)兩個(gè)基地址在源碼中均有明確宏定義見 include/hw/acpi/pc-hotplug.h#define ICH9_CPU_HOTPLUG_IO_BASE 0x0CD8 #define PIIX4_CPU_HOTPLUG_IO_BASE 0xaf00寄存器塊長度宏定義于 include/hw/acpi/cpu.h#define ACPI_CPU_HOTPLUG_REG_LEN 12。QEMU 側(cè)初始化寄存器塊的入口是cpu_hotplug_hw_init()以 q35 為例hw/acpi/ich9.c 中將其掛載到 LPC 的 PCI IO 地址空間cpu_hotplug_hw_init(pci_address_space_io(lpc_pci), OBJECT(lpc_pci), pm-cpuhp_state, ICH9_CPU_HOTPLUG_IO_BASE);2.2 全局訪問約定規(guī)范對(duì)寄存器塊的全局行為做出如下約定任何固件實(shí)現(xiàn)都必須遵守字節(jié)序下述所有寄存器訪問均為小端字節(jié)序little-endian與cpu_hotplug_ops中聲明的DEVICE_LITTLE_ENDIAN一致見 hw/acpi/cpu.c保留寄存器寫入被忽略讀取返回全 0CPU selector 合法性CPU selector中最后存儲(chǔ)的值必須指向一個(gè)可能的 CPUpossible CPU即小于max_cpus否則從任意寄存器讀取返回 0對(duì)其它寄存器的寫入被忽略直到向 selector 寫入合法值復(fù)位語義QEMU 啟動(dòng)時(shí)CPU selector被初始化為一個(gè)合法值系統(tǒng)復(fù)位reset時(shí)保持當(dāng)前值不變。從源碼結(jié)構(gòu)看selector 越界檢查在每次讀/寫操作入口完成cpu_hotplug_rd()在cpu_st-selector cpu_st-dev_count時(shí)直接返回 0cpu_hotplug_wr()在地址非零且 selector 越界時(shí)直接返回見 hw/acpi/cpu.c 與 hw/acpi/cpu.c。三、讀訪問行為Read Access Behavior讀訪問通過先寫 selector 選中 CPU再讀目標(biāo)偏移的兩步流程進(jìn)行。各偏移語義如下。3.1 offset [0x0-0x3]Command data 2DWORD 訪問讀取結(jié)果取決于Command field中最后存儲(chǔ)的值Command field 最后存儲(chǔ)值讀取結(jié)果0返回0x03返回架構(gòu)特定 CPU ID 值的高 32 位其它保留對(duì)應(yīng)源碼 hw/acpi/cpu.c命令CPHP_GET_CPU_ID_CMD值 3時(shí)返回cdev-arch_id 32。3.2 offset [0x4]CPU device status fields1 字節(jié)訪問位語義bit 0Device enabled設(shè)備已啟用客戶機(jī)可以使用該 CPUbit 1Device insert event設(shè)備插入事件標(biāo)志用于區(qū)分尚未向 OSPM 發(fā)出 device check 事件的設(shè)備。僅當(dāng) bit 0 置位時(shí)有效bit 2Device remove event設(shè)備移除事件標(biāo)志用于區(qū)分尚未向 OSPM 發(fā)出 device eject 請(qǐng)求的設(shè)備。固件必須忽略此位bit 3保留OSPM 應(yīng)忽略bit 4若置 1表示OSPM 請(qǐng)求固件執(zhí)行設(shè)備彈出device ejectbit 5-7保留OSPM 應(yīng)忽略該狀態(tài)位在 QEMU 內(nèi)部由AcpiCpuStatus結(jié)構(gòu)體的布爾字段支撐見 include/hw/acpi/cpu.h讀取時(shí)打包返回見 hw/acpi/cpu.cval | cdev-cpu ? 1 : 0; /* bit0: enabled */ val | cdev-is_inserting ? 2 : 0; /* bit1: insert event */ val | cdev-is_removing ? 4 : 0; /* bit2: remove event */ val | cdev-fw_remove ? 16 : 0; /* bit4: fw eject requested */3.3 offset [0x5-0x7]保留讀取返回 0。3.4 offset [0x8]Command dataDWORD 訪問讀取結(jié)果同樣取決于Command field最后存儲(chǔ)的值Command field 最后存儲(chǔ)值讀取結(jié)果0包含有待處理事件的 CPU 的CPU selector值3架構(gòu)特定 CPU ID 值的低 32 位x86 場(chǎng)景下即APIC ID其它返回 0對(duì)應(yīng)源碼 hw/acpi/cpu.c命令CPHP_GET_NEXT_CPU_WITH_EVENT_CMD值 0時(shí)返回cpu_st-selector命令CPHP_GET_CPU_ID_CMD值 3時(shí)返回cdev-arch_id 0xFFFFFFFF。四、寫訪問行為Write Access Behavior4.1 offset [0x0-0x3]CPU selectorDWORD 訪問選中當(dāng)前活動(dòng)的 CPU 設(shè)備。后續(xù)對(duì)其它寄存器的所有訪問都將讀寫該 CPU 的數(shù)據(jù)。有效取值范圍[0 .. max_cpus)對(duì)應(yīng)源碼 hw/acpi/cpu.ccpu_st-selector data。4.2 offset [0x4]CPU device control fields1 字節(jié)訪問位語義bit 0保留OSPM 寫入前必須將其清除bit 1若置 1清除設(shè)備插入事件。OSPM 在已對(duì)選中的 CPU 設(shè)備發(fā)出 device check 事件后置位bit 2若置 1清除設(shè)備移除事件。OSPM 在已對(duì)選中的 CPU 設(shè)備發(fā)出 device eject 請(qǐng)求后置位bit 3若置 1發(fā)起設(shè)備彈出。OSPM 觸發(fā) CPU 設(shè)備移除并調(diào)用_EJ0方法時(shí)置位或固件在 bit 4 置位時(shí)置位。若 bit 4 被置位本位將在彈出過程中被清除bit 4若置 1OSPM 將設(shè)備彈出交給固件執(zhí)行。固件應(yīng)按 bit 3 所述發(fā)出 eject 請(qǐng)求OSPM 在請(qǐng)求固件執(zhí)行彈出時(shí)不應(yīng)觸碰 bit 3bit 5-7保留OSPM 寫入前必須清除注意 bit 3發(fā)起彈出與 bit 4固件執(zhí)行彈出是互斥的兩條路徑前者由 OSPM 自己執(zhí)行_EJ0后者由 OSPM 委托固件。對(duì)應(yīng)源碼 hw/acpi/cpu.cif (data 2) { /* bit1: clear insert event */ cdev-is_inserting false; } else if (data 4) { /* bit2: clear remove event */ cdev-is_removing false; } else if (data 8) { /* bit3: initiate eject */ hotplug_ctrl qdev_get_hotplug_handler(dev); hotplug_handler_unplug(hotplug_ctrl, dev, NULL); object_unparent(OBJECT(dev)); cdev-fw_remove false; } else if (data 16) { /* bit4: fw does eject */ cdev-fw_remove true; }從源碼結(jié)構(gòu)可以推斷QEMU 不允許彈出首個(gè) CPUfirst_cpu當(dāng)選中無效設(shè)備或彈出首 CPU 時(shí)會(huì)拒絕并記錄 trace見 hw/acpi/cpu.c。4.3 offset [0x5]Command field1 字節(jié)訪問命令字段決定后續(xù)Command data寄存器的讀寫語義值語義0選擇有插入/移除事件的 CPU 設(shè)備。隨后讀取Command data寄存器返回被選中的 CPUCPU selector值。若沒有帶事件的 CPU當(dāng)前CPU selector不變且不修改對(duì)應(yīng)的 insert/remove 事件標(biāo)志1隨后寫入Command data寄存器將設(shè)置 QEMU 中的OST event寄存器2隨后寫入Command data寄存器將設(shè)置 QEMU 中的OST status寄存器3隨后讀取Command data與Command data 2將返回當(dāng)前選中 CPU 的架構(gòu)特定 CPU ID其它保留源碼中的命令枚舉定義見 hw/acpi/cpu.cenum { CPHP_GET_NEXT_CPU_WITH_EVENT_CMD 0, CPHP_OST_EVENT_CMD 1, CPHP_OST_STATUS_CMD 2, CPHP_GET_CPU_ID_CMD 3, CPHP_CMD_MAX };命令0的實(shí)現(xiàn)采用環(huán)形掃描從當(dāng)前 selector 開始遍歷所有設(shè)備找到第一個(gè)帶事件is_inserting/is_removing/fw_remove的 CPU 并將其設(shè)為選中掃描一圈回到起點(diǎn)則保持原狀見 hw/acpi/cpu.c。4.4 offset [0x6-0x7]保留寫入被忽略。4.5 offset [0x8]Command dataDWORD 訪問寫入行為取決于Command field最后存儲(chǔ)的值Command field 值寫入行為1將值存入OST event 寄存器2將值存入OST status 寄存器并觸發(fā) QEMU 向外部應(yīng)用發(fā)送ACPI_DEVICE_OSTQMP 事件事件攜帶當(dāng)前 OST event 與 status 寄存器的值其它保留對(duì)應(yīng)源碼 hw/acpi/cpu.cOST status 寫入后會(huì)構(gòu)建ACPIOSTInfo并通過qapi_event_send_acpi_device_ost()發(fā)出 QMP 事件。而acpi_cpu_ospm_status()hw/acpi/cpu.c可遍歷全部設(shè)備將每個(gè) CPU 的 OST 狀態(tài)導(dǎo)出為ACPIOSTInfoList供query-acpi-ospm-status類 QMP 查詢使用。五、典型使用流程Typical Usecases規(guī)范給出了三條 OSPM 固件必須實(shí)現(xiàn)的標(biāo)準(zhǔn)操作路徑以下為精確步驟復(fù)現(xiàn)。5.1 x86檢測(cè)現(xiàn)代 CPU 熱插拔接口QEMU 默認(rèn)啟用現(xiàn)代 CPU 熱插拔接口固件按以下步驟探測(cè)其存在性向CPU selector寄存器寫入0x0確保 selector 處于合法值向Command field寄存器寫入0x0讀取Command data 2寄存器讀值為0x0→ 現(xiàn)代接口已啟用否則 → 無可用 CPU 熱插拔接口。該探測(cè)原理對(duì)應(yīng)命令0下Command data 2恒返回 0 的讀取語義見 hw/acpi/cpu.c。5.2 獲取帶待處理事件的 CPU向CPU selector寫入0x0向Command field寫入0x0讀取CPU device status fields寄存器若讀值中 bit 1 與 bit 2均為 0說明沒有帶待處理事件的 CPU當(dāng)前 selector 保持不變否則讀取Command data寄存器讀值即為帶事件 CPU 的 selector該 CPU 已被選中。5.3 枚舉 present / non-present CPU將 present CPU 計(jì)數(shù)置 0將迭代器置 0向CPU selector寫入0x0確保其處于合法狀態(tài)且后續(xù)寄存器訪問不會(huì)被忽略向Command field寫入0x0使Command data返回當(dāng)前選中 CPU 的 selector 值讀取CPU device status fields寄存器若 bit 0 置位present CPU 計(jì)數(shù)加 1迭代器加 1將迭代器寫入CPU selector寄存器讀取Command data寄存器若讀值非零跳回第 5 步否則向CPU selector寫入0x0使其回到合法狀態(tài)并退出——此時(shí)迭代器恰等于max_cpus。該流程利用了命令0下Command data返回當(dāng)前 selector 的特性來探測(cè)該 selector 是否越界是固件遍歷全部 possible CPU 的經(jīng)典手法。六、源碼級(jí)實(shí)現(xiàn)剖析6.1 狀態(tài)結(jié)構(gòu)與寄存器映射QEMU 用CPUHotplugState保存寄存器塊的運(yùn)行時(shí)狀態(tài)include/hw/acpi/cpu.htypedef struct CPUHotplugState { MemoryRegion ctrl_reg; uint32_t selector; /* CPU selector 寄存器 */ uint8_t command; /* Command field 寄存器 */ uint32_t dev_count; /* possible CPU 總數(shù) */ AcpiCpuStatus *devs; /* 每個(gè) CPU 槽位的狀態(tài)數(shù)組 */ } CPUHotplugState;每個(gè) CPU 槽位的狀態(tài)由AcpiCpuStatus描述include/hw/acpi/cpu.h包含cpu當(dāng)前已插入的 CPUState 指針、arch_id架構(gòu)特定 CPU IDx86 下即 APIC ID、is_inserting、is_removing、fw_remove以及ost_event/ost_status。寄存器偏移的宏定義hw/acpi/cpu.c與文檔一一對(duì)應(yīng)#define ACPI_CPU_SELECTOR_OFFSET_WR 0 /* CPU selector (0x0-0x3, 寫) */ #define ACPI_CPU_FLAGS_OFFSET_RW 4 /* status/control (0x4, 讀/寫) */ #define ACPI_CPU_CMD_OFFSET_WR 5 /* Command field (0x5, 寫) */ #define ACPI_CPU_CMD_DATA_OFFSET_RW 8 /* Command data (0x8, 讀/寫) */ #define ACPI_CPU_CMD_DATA2_OFFSET_R 0 /* Command data 2 (0x0-0x3, 讀) */MemoryRegion 的訪問屬性hw/acpi/cpu.c允許 1~4 字節(jié)訪問、小端序與文檔DWORD 訪問 / 1 字節(jié)訪問的粒度約定吻合。6.2 插入與移除的事件流QEMU 設(shè)備模型側(cè)通過三個(gè)回調(diào)驅(qū)動(dòng)事件狀態(tài)hw/acpi/cpu.cacpi_cpu_plug_cb()CPU 插入時(shí)若為運(yùn)行期熱插入設(shè)備dev-hotplugged置is_inserting true并通過acpi_send_event(..., ACPI_CPU_HOTPLUG_STATUS)拉高 GPE觸發(fā) BIOS 掃描acpi_cpu_unplug_request_cb()CPU 移除請(qǐng)求時(shí)置is_removing true并同樣觸發(fā) GPEacpi_cpu_unplug_cb()移除完成后將cdev-cpu NULL槽位回歸未啟用狀態(tài)。固件側(cè)的事件發(fā)現(xiàn)則依賴命令0環(huán)形掃描與狀態(tài)位讀取二者配合完成QEMU 置位事件 → BIOS 掃描發(fā)現(xiàn) → 通知 OSPM → OSPM 清除事件的完整閉環(huán)。6.3 遷移狀態(tài)寄存器塊狀態(tài)通過vmstate_cpu_hotplug納入遷移hw/acpi/cpu.c持久化selector、command以及每個(gè)設(shè)備的is_inserting、is_removing、ost_event、ost_status保證 live migration 后熱插拔狀態(tài)不丟失。相關(guān)宏VMSTATE_CPU_HOTPLUG定義于 include/hw/acpi/cpu.h。七、AML 固件側(cè)寄存器如何變成 ACPI 對(duì)象寄存器塊只是郵箱真正讓 OSPM 可用的是build_cpus_aml()hw/acpi/cpu.c動(dòng)態(tài)生成的 AML 代碼它完成三件事聲明資源設(shè)備\_SB.PRES_HID PNP0A06、_UID CPU Hotplug resources通過 OperationRegionPRST將 12 字節(jié)寄存器塊映射為可訪問的 ACPI 字段CPEN/CINS/CRMV/CEJ0/CEJF/CCMD/CSEL/CDAT并帶一個(gè)互斥鎖CPLK見 hw/acpi/cpu.c聲明 CPU 容器設(shè)備\_SB.CPUS_HID ACPI0010、_CID PNP0A05實(shí)現(xiàn)CSCN掃描并通知、CTFY按 UID 通知對(duì)應(yīng) CPU、COST寫 OST 事件/狀態(tài)等控制方法以及每個(gè) CPU 子設(shè)備的_STA、_MAT、_EJ0、_OST見 hw/acpi/cpu.c將掃描入口接到 GPE生成的event_handler_methodGPE.2 對(duì)應(yīng)的處理函數(shù)只做一件事——調(diào)用\_SB.CPUS.CSCN見 hw/acpi/cpu.c。CSCN方法內(nèi)部體現(xiàn)了兩個(gè)值得注意的工程細(xì)節(jié)兼容 Windows XP為避免舊 Windows 崩潰新增/移除 CPU 列表使用 ACPI 1.0 的PackageOp最多 255 個(gè)元素并通過外層循環(huán)分批處理從而支持超過單批容量的 CPU 數(shù)量見 hw/acpi/cpu.c固件上電拉入fw unplug / SMI 回?fù)墚?dāng)固件協(xié)商了ICH9_LPC_SMI_F_CPU_HOTPLUG_BITopts.smi_path非空時(shí)掃描到新增 CPU 后會(huì)先通過 SMI 讓固件把 CPU 拉入再向 OSPM 發(fā)送 notify見 hw/acpi/cpu.c_EJ0路徑也會(huì)在opts.fw_unplugs_cpu時(shí)改為寫CEJF并觸發(fā) SMI見 hw/acpi/cpu.c。八、測(cè)試與驗(yàn)證倉庫通過 ACPI 表對(duì)比測(cè)試持續(xù)驗(yàn)證該接口在兩種 x86 機(jī)型上的 AML 生成結(jié)果見 tests/qtest/bios-tables-test.cstatic void test_acpi_piix4_tcg_cphp(void) { data.machine MACHINE_PC; /* PIIX4: 0xaf00 */ test_acpi_one(-smp 2,cores3,sockets2,maxcpus6 -object memory-backend-ram,idram0,size64M -object memory-backend-ram,idram1,size64M -numa node,memdevram0 -numa node,memdevram1 -numa dist,src0,dst1,val21, data); }用例acpi/piix4/cpuhp與acpi/q35/cpuhp分別針對(duì) PIIX40xaf00與 ICH90x0cd8兩條基地址路徑以-smp ... maxcpus6構(gòu)造多 CPU 拓?fù)鋵⑸傻?DSDT 與基線.cphp變體比對(duì)任何寄存器布局、字段偏移或 AML 結(jié)構(gòu)變化都會(huì)導(dǎo)致測(cè)試失敗——這正是本規(guī)范最直接的回歸守護(hù)。九、總結(jié)QEMU 現(xiàn)代 ACPI CPU 熱插拔接口是一套設(shè)計(jì)緊湊的 12 字節(jié) IO 寄存器協(xié)議selector 決定操作對(duì)象command 決定數(shù)據(jù)語義狀態(tài)位承載插入/移除事件OST 通道實(shí)現(xiàn)操作系統(tǒng)對(duì)熱插拔結(jié)果的上報(bào)。固件側(cè)通過 GPE.2 CSCN掃描驅(qū)動(dòng)整個(gè)事件循環(huán)而 QEMU 側(cè)則以 hw/acpi/cpu.c 中的AcpiCpuStatus數(shù)組為狀態(tài)中樞配合 tests/qtest/bios-tables-test.c 的 ACPI 表回歸測(cè)試保證協(xié)議穩(wěn)定性。對(duì)虛擬化平臺(tái)開發(fā)者與固件工程師而言本文的寄存器語義表、典型操作序列與源碼映射關(guān)系可直接作為實(shí)現(xiàn) ACPI BIOS CPU 熱插拔邏輯的參考基線。【免費(fèi)下載鏈接】qemuOfficial QEMU mirror. Please see https://www.qemu.org/contribute/ for how to submit changes to QEMU. Pull Requests are disabled. Please only use release tarballs from the QEMU website.項(xiàng)目地址: https://gitcode.com/gh_mirrors/qe/qemu創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考