中断路由 (B7): - apic.drv: LAPIC enable + IOAPIC重定向表编程(MADT ISO感知) + apic_route/apic_route_legacy/apic_diag开关 - UTSM: LAPIC EOI钩子(register_apic_eoi, ABI尾部追加) + IDT 0-255全覆盖 + spurious 0xFF特判 - FUCK: apic_route=0默认PIC(零回归) / =1 IOAPIC->LAPIC接管(失败完整降级) / legacy放开IRQ1/12/11 存储: - nvme.drv: 写路径 + PRP list + 读回校验 + MSI/MSI-X中断驱动(nvme_msi开关, 回退纯轮询) - build.ps1: apic.drv纳入构建(原为预置二进制) 网络: - virtio_net: virtqueue RX/TX + netdev注册 + DHCP自测(slirp真实OFFER) PE兼容层: - pe_shim: guest->host指针转换(g_emu_mem_base + gp()) + shim fn32列补齐 - gen_pe.py: PE32+ RVA偏置修复(BUG-004) + cmd.exe生成 - desktop_app.h: da_mouse_poll先判AUX位 + da_mouse_init冲刷残留(BUG-003/008) - shell: Ctrl修饰键跟踪(BUG-001) + g_run_image扩至1MB(BUG-002) QEMU测试套件: - 9用例全自动化(Run-All.ps1): boot-regression/driver-matrix/linux-compat/pe-compat/deaicup-e2e/userapps-matrix/network-e2e/performance-baseline/x86emu32-coverage - QemuTest.ps1公共库: 串口断言/monitor sendkey/screendump/HTTP服务器/并发隔离 文档: - CLAUDE.md: APIC/IOAPIC能力 + kernel_api暴露 + IRQ后端升级状态 - LESSONS_LEARNED.md: B7 LAPIC/IOAPIC经验教训(2条) - Bug记录.txt: BUG-20260801-001~008 + BUG-20260803-009(9条) - test-cases/*.md: 全部补充自动化脚本小节 - 桌面设计.md: .lnk快捷方式 + LINUXAPP.CNF Linux应用图标 - 系统开发策划.md: NVMe/virtio_net标完成 + B2/B7标已解决 + M2进度列
3.8 KiB
3.8 KiB
14 DKM 驱动功能矩阵
对应计划 Phase C3:每个驱动的加载、探测、功能验证点
状态: ⬜ PENDING
驱动清单
| # | 驱动 | stage | class | required | QEMU 参数 | 期望串口日志 | 功能验证点 | 状态 | Bug# |
|---|---|---|---|---|---|---|---|---|---|
| 1 | timer | 0 | timer | ✅ | 默认 | [DKM:timer] |
100ms busy-wait 精度 | ⬜ | |
| 2 | apic | 0 | interrupt | ✅ | 默认 | [DKM:apic] MADT found |
LAPIC MMIO 只读 | ⬜ | |
| 3 | acpi | 0 | platform | ❌ | 默认 | [DKM:acpi] |
RSDP/XSDT 枚举 | ⬜ | |
| 4 | pci | 0 | bus | ✅ | 默认 | [DKM:pci] |
PCI config space 扫描 | ⬜ | |
| 5 | console_fb | 1 | console | ❌ | 默认 | [DKM:console_fb] |
淡蓝色背景清屏 | ⬜ | |
| 6 | ahci | 1 | storage | ❌ | +SATA 测试盘 | [DKM:ahci] ahci0 registered |
LBA0 读取 | ⬜ | |
| 7 | nvme | 1 | storage | ❌ | -device nvme |
[DKM:nvme] 1b36:0010 found |
BAR0 读取(高位 MMIO 未解决则 SKIP) | ⏭ | |
| 8 | bootfs | 1 | fs | ✅ | 默认 | [DKM:bootfs] |
Limine boot module FS | ⬜ | |
| 9 | vfs | 2 | fs-core | ✅ | 默认 | [DKM:vfs] |
挂载 bootfs | ⬜ | |
| 10 | fat32 | 2 | fs | ❌ | +SATA 测试盘 | [DKM:fat32] |
BPB/FAT/目录项解析 | ⬜ | |
| 11 | devfs | 2 | fs | ❌ | 默认 | [DKM:devfs] |
/dev/version, /dev/fb0 等 | ⬜ | |
| 12 | e1000 | 3 | net | ❌ | -device e1000 |
tx=ready rx=ready |
DHCP + ping | ⬜ | |
| 13 | virtio_net | 3 | net | ❌ | -device virtio-net-pci |
[DKM:virtio_net] 1af4:1001 found |
capability 枚举 | ⬜ | |
| 14 | ath9k | 3 | net | ❌ | (QEMU 不支持 WiFi) | no Atheros WiFi device found |
跳过(QEMU 限制) | ⏭ | |
| 15 | ps2kbd | 3 | input | ❌ | 默认 | scan code 读取 | 输入回显 | ⬜ |
stage 加载顺序
stage 0 (platform): timer → apic → acpi → pci
stage 1 (boot): console_fb → ahci → nvme → bootfs
stage 2 (fs): vfs → fat32 → devfs
stage 3 (optional): e1000 → virtio_net → ath9k → ps2kbd
测试设备 QEMU 参数
AHCI + FAT32 测试盘
-drive id=sata0,format=raw,file=.build_tmp/sata_fat32_dsk.img,if=none ^
-device ide-hd,drive=sata0,bus=ide.0 ^
NVMe
-device nvme,drive=nvme0,serial=UTSMTEST ^
-drive id=nvme0,format=raw,file=.build_tmp/nvme_test.img,if=none ^
e1000
-netdev user,id=net0 ^
-device e1000,netdev=net0,mac=52:54:00:12:34:56 ^
virtio-net
-netdev user,id=net0 ^
-device virtio-net-pci,netdev=net0 ^
自动化脚本
tests/qemu/driver-matrix.ps1 单次 QEMU 会话挂全设备 (SATA 测试盘 + NVMe 测试盘 + xHCI USB 盘 + e1000),断言 4 个 stage 共 16 个清单驱动的 加载顺序与功能锚点:
.\tests\qemu\driver-matrix.ps1 # 复用现有镜像
.\tests\qemu\driver-matrix.ps1 -Build # 先全量构建再测
自动断言内容:
- 16 个
driver ready锚点按 manifest 顺序(ath9k 走 FUCK 禁用路径,断言[DSM] driver disabled by FUCK) - 功能锚点:ahci/nvme block provider 注册、fat32 经块设备解析镜像、e1000 netdev+link、ps2kbd IRQ1、virtio_net 无设备降级
- NVMe 写路径回归:LBA0 签名识别 → write+flush+readback 逐字节校验(PRP2 + PRP list 两趟)→ 签名完好,且 ahci0=0 → nvme0=1 注册顺序
[DKM] external driver active≥ 15、[DSM] stage end× 4
已知限制(与上方一致):virtio_net 在 e1000-only 拓扑断言降级锚点;xhci USB MSC 枚举仅断言驱动就绪。
已知限制
- NVMe BAR0 在 QEMU 中常位于 4G 以上,当前 HHDM 不能安全访问,需 Phase 0 高位 MMIO 映射解决
- ath9k 在 QEMU 中无对应设备模拟,永远走 "not found" 路径
- 多个 NIC 同时挂载会改变 PCI 拓扑,可能影响 e1000 探测位置