Iteration Plan for August 2025

[ZCShou]

Endgame

1. 阶段 2025.8.1 ~ 2025.8.31

2. 任务根据功能分类并以无序列表的形式展现，并在编写时采用 Markdown 的 -[ ] 开头以显示复选框，选中复选框表示任务已经完成

3. 任务格式：【进度百分比】[可选✨符号] 任务名字或者直接写对应的 ISSUE（子 ISSUE 则以子列表形式列出） @负责人，其中的 [可选 ✨符号]表示本周正在处理或完成的任务。

4. 每周需要在任务（子任务）对应的 ISSUE 中以评论的形式列出每周进度情况，以便周例会汇报进度使用

5. 完整示例如下所示：

   • 【100%】✨ 制定 7 月阶段计划 https://github.com/orgs/arceos-hypervisor/discussions/198 @ZCShou
     • 子任务 1
     • 子任务 2

驱动完善

• 【100%】✨添加及完善 MMC 驱动 新增 SD 卡或 EMMC 驱动程序 #150 @YanLien
  • 排查phytium-mci的中断问题 #202
  • 合并两个sd卡相关的crate（sdmmc和phytiom-mci） #203
  • 在ostool测试框架中验证新的sd卡驱动功能可用 #204
  • 移植到在arceos中验证功能可用 #205
• 【100%】✨添加及完善 SMMU 驱动 完善 SMMU 支持 #172 @bullhh (songzhy)
  • linux客户机显示smmuv3成功使能 #192
  • 设备绑定smmuv3 #193
  • 使用igb网卡测试smmu驱动 #215
• 【70%】添加及完善USB系列驱动 https://github.com/drivercraft/CrabUSB @ZR233
  • 控制器驱动及usb传输层完成，支持异步、同步、内核态和用户态调用。
  • 键盘驱动
  • UVC 摄像头驱动，整体代码完成，在linux用户态测试成功，可以连续获取图像帧
    • 测试qemu 内核态（训练营学员验证中）
    • 测试真机 内核态（训练营学员验证中）

新平台适配

适配 ArceOS 新的 newhal 的改动，由 @ZR233 和 @Josen-B 重点跟进，与 @aarkegz 沟通，推动尽快完成相关内容！

Axvisor已有工作的整理

• 【95%】增加中断虚拟化支持 ArceOS newhal Adapt ArceOS new hal  #213 @ZR233
  • 代码推进到客户机通过tval写寄存器注册timer，之后timer时间到后应触发软中断，目前timer不触发中断。@ZR233
  • 解决不触发中断的问题 @ZR233
  • bug: gicv3 虚拟中断配置后客户机不触发。arceos-hypervisor/arm_vcpu@b1ff952 @ZR233
  • ✨中断注入代码移入gicv3 Gicv3 hyper support rcore-os/arm-gic-driver#8 @ZR233
  • ✨x86 self-host runner测试 x86 ci 远程测试 #231 @ZR233
  • 无视质量跑通代码
  • make 脚本重构 https://github.com/arceos-hypervisor/axvisor/blob/new_hal_dyn/doc/task.py-usage.md @ZR233
  • x86 platform @Josen-B 验证支持x86_64平台 #230
    • arceos 32位bug fix: x86 add .code64 directive for 64-bit code section arceos-org/axplat_crates#22 @ZR233
  • 【20%】从主设备树中获取axvisor参数、客户机设备树 从主设备树中获取axvisor参数、客户机设备树 #224 @bullhh(songzhy)
    • ✨新增axvisor从arceos获取设备树文件接口 #225
    • ✨axvisor中gic参数从设备树文件中获取 #226
      合并后再继续优化：
    • riscv platform @YanLien
    • 代码质量提升
    • vgic 代码完善 添加虚拟寄存器读写 arm_vgic#18 @ZR233
    • 根据axvisor的设备树文件和客户机配置中memory、CPU等参数，生成客户机设备树相关节点 #227
    • 简化客户机配置参数，直通设备地址等从设备树文件中读取 #228

ArceOS 虚拟化支持修改

未完成的均在待 review 状态，等待新的代码审核机制执行后推进

- [ ] 【90%】axhal::irq::fetch_irq 待pr
- [ ] 【90%】axhal::irq::inject_interrupt 待pr
- [ ] 【90%】axhal::gicd_paddr 待pr

• ✨【100%】axhal::irq::irq_handle [feat] make irq_handler public for hypervisor reuse arceos-org/arceos#287
• 【50%】ArceOS 与 Axvisor 架构中断之间关系的梳理，设计修改方案
  • 【100%】aarch64 梳理架构特点 @ZR233
  • 【100%】x86架构了解 @Josen-B
  • 【100%】riscv 梳理架构特点 @ZR233
  • (待review) x86\riscv 两平台 arceos axvisor vmexit 互不干扰，无需修改，arm平台，vmexit 使用 中断向量表注册入口地址，arceos需向axvisor提供注册入口的方式，已向axcpu 提起PR [feat] add aarch64 el2 entry_guest and vmexit support arceos-org/axcpu#15
  • 【90%】重构 arm_vcpu，移除中断处理流，仅处理vmexit。已完成代码 https://github.com/arceos-hypervisor/arm_vcpu/tree/dev-irq
• ✨【100%】新增 axipi axipi移植到newhal #206 @Josen-B
  • 2025.8.21 equation314 已合入 PR

整理 Crates

依据 https://github.com/orgs/arceos-hypervisor/discussions/196 中的要求，整理 AxVisor 相关 Crates，并发布到 crates.io。由 @YanLien 重点跟进，与 @aarkegz 沟通，推动尽快完成相关内容！

• 【90%】整理AxVisor相关Crates，并发布到crates.io #223 @YanLien
  • 【100%】arm_vcpu
  • 【100%】arm_vgic
  • 【100%】axvisor_api
  • 【100%】axaddrspace
  • 【100%】x86_vcpu
  • 【100%】x86_vlapic
  • 【60%】riscv_vcpu
  • 【100%】axdevice_base
  • 【100%】axvcpu
  • 【100%】axvmconfig

文档

• 【100%】逐步将 Crates Doc 扩展到 ArceOS、Starry 等 @ZCShou
  • https://arceos-hypervisor.github.io/axvisor-crates-book/
  • https://arceos.org/arceos-crates-book/
  • https://starry-os.github.io/starry-crates-book/
• 【100%】整理及讨论 8 月份的开发计划 https://github.com/orgs/arceos-hypervisor/discussions/211 @ZCShou

测试

• 【20%】✨搭建集成测试环境，利用 Github Action 远程推送到本地进行集成测试 @ZCShou @Josen-B
  • 整理及完善集成测试方案 #222 @ZCShou
  • 本地测试方案搭建 #221 @Josen-B
  • 编写 Github Actions 配置文件及整体测试验证 #220 @ZCShou

功能完善

• 【30%】添加虚拟机管理工具，以支持在控制台中对客户机增删改查 #140 @YanLien
  • 为 AxViosr 增加一个控制台 #138
  • 添加基本的文件系统命令，例如 ls，cd 等，可以直接在控制台中使用 #139
• 【0%】AxVisor 支持从文件系统加载客户机配置文件后启动客户机 #144 @bullhh
  • axvisor从文件系统中读取文件 #151
  • 客户机配置参数使用文件系统中文件 #152
  • 从文件系统中读取多个客户机配置文件使用 #153
  • 配置文件修改后重启后能生效 #154

其他

1. 在 arceos 的仓库中创建一个 Hypervisor的分支，由 石磊 和 杨金博 来进行 PR @chyyuu
2. 后续将周例会时间改在每周五下午 3 点半，每周只进行一次周例会