VirtualBox 公共设备模型¶
本页是 VirtualBox 两种架构共用的设备发现与驱动参考,不是镜像安装手册。 ARM64 与 x86_64 使用不同 CPU、固件入口和平台地址,不能互换镜像。各自的构建依赖、镜像制作、虚拟机配置、启动与故障定位完整写在ARM64 操作手册 和 x86_64 操作手册;选择对应架构的一页即可执行,无需先按本页操作。
支持方式¶
VirtualBox 是标准虚拟设备的提供方。A20OS 通过通用 PCI/VirtIO、block、net、display、 input 驱动访问设备,不为 VirtualBox 创建重复的 AHCI 或 E1000 协议实现。平台代码只负责固件入口、RAM/MMIO 映射、ACPI 与中断控制器。
| 项目 | ARM64 | x86_64 |
|---|---|---|
| 实例 | vbox-aarch64 / vbox-aarch64-text |
vbox-x86_64 / vbox-iso-x86_64 / vbox-disk-x86_64 |
| 固件入口 | UEFI BOOTAA64.EFI |
UEFI BOOTX64.EFI,或 GRUB Multiboot ISO |
| 平台 | virtualbox-aarch64 |
qemu-virt-x86_64 的 PC 平台接口 |
| 中断/时钟 | GICv3;协作式软件时钟路径 | APIC/IOAPIC、架构平台时钟 |
| PCI 发现 | UEFI RSDP → ACPI MCFG → ECAM | ACPI MCFG;无可用表时尝试兼容配置空间 |
| 常用存储 | VirtIO-SCSI 1af4:1048 |
AHCI 8086:2922/2829 |
| 常用显示 | SVGAv3 15ad:0406 |
VMSVGA 15ad:0405 |
| 常用网络 | E1000 8086:100e |
E1000 或受支持的 VirtIO net |
| 输入 | xHCI + USB HID | PS/2;其他协议按实际驱动匹配 |
上述设备接口已在 VirtualBox 7.x 环境中完成基准验证。在 ARM64 虚拟机环境下,若 PCI MSI/INTx 路由未使能,驱动将安全降级至轮询模式以确保基本可用性。
驱动部署与验收¶
generic 构建依赖镜像中的 .a20drv 模块及模块加载路径;embedded 将所选驱动链接进内核。两种架构的操作手册均给出显式 DRIVER_DEPLOYMENT=embedded 的设备验收入口,避免把模块未包含或未加载当成 PCI 发现失败。两者都只匹配驱动 ID 表覆盖的设备。
驱动验收应保存以下连续信息,而不是只记录桌面或 shell 出现:
- 固件入口、RAM 和 ACPI/PCI 发现结果。
- 目标 PCI vendor/device、BAR 与驱动绑定。
- 容量、接口、模式等设备 ready 信息。
- 对应类消费者:文件系统挂载/读写、网络收发、framebuffer 更新或输入事件。
- 使用的轮询/IRQ 模式及未验证功能。
没有目标 PCI ID 时先检查虚拟机设备选择;已有 ID 却无驱动绑定时再检查部署方式与 ID 表。增加设备支持时复用标准协议驱动,将宿主/架构差异留在平台和 PCI HAL。