arceos-test-adapter
Skill76 starsChanged 4 days agoApache-2.0View on GitHub
适配或修复 ArceOS 测试用例以通过 `cargo xtask arceos test qemu`。当用户提到新增或修改 `test-suit/arceos` 下的测试、补齐 `qemu-*.toml`、修正成功或失败匹配规则,或让某个 ArceOS 测试在任务工具中正确通过或正确失败时,使用此技能。
In this repository24 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- arch-platform-portingSkill
- board-linux-starry-debugSkill
- board-uboot-fsck-repairSkill
- crates-io-ownerSkill
- cross-kernel-driverSkill
- feature-developmentSkill
- humanizerSkill
- markdown-doc-writerSkill
- multi-arch-layeringSkill
- qemu-gdb-debuggingSkill
- reassign-pr-reviewersSkill
- resolve-github-issueSkill
- review-open-prsSkill
- review-single-prSkill
- rust-api-designSkill
- rust-code-qualitySkill
- rust-concurrency-safetySkill
- rust-unsafe-safetySkill
- starry-syscall-compatibilitySkill
- starry-test-suitSkill
- test-qualitySkill
- update-std-testsSkill
The file
Files
ArceOS 测试适配
适配 test-suit/arceos 下的测试到 cargo xtask arceos test qemu。
测试分层
先确认测试实际需要的能力:算法、数据结构、状态机、协议解析和错误转换留在普通
#[test];真实调度、阻塞/唤醒、IPI、IRQ、timer、SMP、affinity、上下文切换和目标指令
使用本 suite 的 QEMU 测试。ax-task、ax-runtime 等 ArceOS 启动依赖库不创建独立
axtest target,也不得在 std 测试中用 fake runtime 代替真实运行时。
用例的目标风险、必要性、缺陷敏感度与跨层去重先按
test-quality 判断;先复用或增强已有完整功能测试,不按参数、平台实例或 case 清单新增断言。本技能只补充 ArceOS QEMU 的发现、配置和运行契约,指定 case 是执行选择,不是测试设计粒度。
上层 Starry kernel、Axvisor 和板卡测试包才直接持有 axtest 依赖,并通过
cargo xtask ktest qemu 或 cargo xtask ktest board 运行。旧的目录式 axtest 组不由本
命令发现;选择 --test-group axtest 时应转用 ktest。
宿主允许列表和纯模型测试规则见 update-std-tests,
Starry/板卡边界和目录契约见 starry-test-suit。
工作方式
- 先读目标测试的 manifest、实现入口、现有
build-*.toml与qemu-*.toml,不要盲目复制别的目录。 - 再参考最接近的现有测试目录,复用必要配置,但按当前测试的实际行为改写。
- 判断测试属于 Rust、C、generic 还是 board 流程,并使用对应发现器;按test-quality的启动复用约束先检查已有批次,兼容成员统一开启所需feature并集,调用选择与feature解耦。只有存在具体不兼容或判定差异时才独立启动。
- 改完后运行最小的
cargo xtask arceos test qemu ...命令验证。
必查项
- Rust suite:
test-suit/arceos/rust/suite.tomlschema_version=3,顶部run_order集中指定启动顺序,下面[batches.NAME]下嵌套[[batches.NAME.tests]];未知/重复/遗漏批次均拒绝,组定义位置不影响执行,成员顺序决定目标执行顺序,批次arches由成员继承且可收窄。general代替旧all批次;Cargo只维护单项feature依赖,不复制聚合成员。host按当前架构展开features,build.rs按同一声明生成目标绑定;runner.rs保留状态恢复。list展示启动边界,plan/run同源选择;单项优先自身fixture,否则继承批次runtime。成功仍要求每项结果,panic/lockdep/栈保护保留独立启动。 - CPU suite:
cpu/normal/suite.toml显式登记批次顺序、架构、std/freestanding入口、成员及旧case别名;实现唯一位于cpu/src库,normal/build.rs生成顺序调用并强制unit返回,成员失败中止当前启动,全部正常返回才输出带batch/selection的整批标记。普通配置单step;预期boot-trap独立启动并保持专用判定。host通过package.metadata.axbuild.qemu_suite显式选择通用声明执行器,生成器通过测试侧构建依赖读取同一清单;AX_CPU_TEST_BATCH/AX_CPU_TEST_CASE进入构建身份;list/plan/run同源。normal/main.rs为唯一main,std/freestanding两个Cargo声明通过bin.path引用它;CPU清单仅登记QEMU。板端成员统一登记在对应board目录的suite.toml,不另建包装包。增改删规则见cpu/README.md;Rust套件规则见rust/README.md。 - 声明式板测:
board-orangepi-5-plus/suite.toml顶部run_order决定启动顺序,batches登记成员/入口/所需features及unit/result契约。kernel复用Rust runner,CPU成员unit正常返回后才转Ok;IPI保留原Result及RunnerTaskState恢复。pmu-user复用CPU freestanding入口。宿主与目标读取同一板测声明;目标绑定通过arceos-test-build构建依赖生成,不包含axbuild私有源码,AX_BOARD_TEST_SUITE/BATCH/CASES进入构建身份;同批成员选择合并为一次启动,未选成员不会因feature并集被执行。默认kernel、pmu-user两启动,boot已删除。普通板配置只等待整批最终标记,失败必须传到最外层。清单存在时不再目录扫描该板,其他板保持原发现方式。 - C suite:
c/suite.toml以run_order和batches嵌套成员唯一登记,general默认七项一次启动,all仅兼容别名;实现位于c/src。宿主生成全量声明头(test.h包含,所有实现核对原型)及选中调用表头(main专用),不增Cargo包/build.rs,不按文件自动发现函数。list/plan/run共用选择,整批features并集不增加未选函数调用;最终C_BATCH_OK匹配当前批次/选择,失败中止并向外传播。公共cbuild只认识通用编译输入,真实预处理签名复用对象,当前对象集合重建归档,递归脚本/库及双符号完整性控制复用,target/架构锁和原子发布保护并发。不能把预处理说成零编译器调用;新增优先复用批次,改公共构建器补普通C应用验证,详见c/README.md。 - Drivers suite:
drivers/suite.toml用run_order和batches嵌套成员统一登记,一个freestanding包/薄入口,当前x86-q35顺序执行ACPICA→HDA一次启动。宿主使用显式package.metadata.axbuild.qemu_suite和通用声明执行器,build.rs通过arceos-test-build正常依赖生成目标调用;AX_DRIVERS_BATCH/CASES进入构建身份;所需features并集不增加未选函数。list/plan/run同源,两个旧单项名称继续作为成员选择,不保留独立包装包。全部成员正常返回才输出DRIVERS_BATCH_OK;HDA或整批必须保留4096帧宿主PCM核验,ACPICA单项不要求音频,不能用最后内核标记覆盖宿主波形错误。增改删及错误注入验收见drivers/README.md。 - generic suite:按共享发现器提供 build wrapper、package manifest 和 runtime config,不假设存在
src/main.rs。 - board case:使用
board-*.toml与目标 build 配置;普通项目通过cargo xtask arceos test board,Cargo axtest 目标通过cargo xtask ktest board,不混入 QEMU 批次。 - 使用
edition.workspace = true;当前发现器不使用.axconfig.toml或.qemu.toml作为主要契约。 main.rs中若使用no_mangle,按当前仓库风格写成unsafe(no_mangle)。- 清理无关旧产物,如
*.out、*.bin、*.elf、test_cmd。
QEMU 输出匹配规则
success_regex必须按代码成功路径里实际打印的稳定字符串填写,并核对最终 runner 装配后的正则;Rust feature case 可能覆盖 TOML 默认值。- 不要沿用占位字符串,不要猜测,不要默认写
to install packages.。 - 先从
src/main.rs、被调用函数和已有成功日志里找“测试成功结束时一定会出现”的输出。 - 优先选择唯一、完整、稳定的成功提示,例如
Memory tests run OK!、Task yielding tests run OK!。 - 如果代码成功路径没有明确成功提示,先在测试代码中补一条清晰且稳定的成功输出,再回填到
success_regex。 - 普通成功用例可使用
(?i)\bpanic(?:ked)?\b作为失败匹配;预期 panic、page fault、lockdep、stack-guard 或诊断用例必须使用对应专用规则,不能用宽泛正则伪造成功。
适配建议
- 新增测试先加入兼容批次;确认必须独立启动后,才复制最接近的
qemu-*.toml与 build 配置并按实际条件修正。 - 不同架构的
success_regex应与该测试真实输出一致;如果成功输出跨架构相同,可以保持一致。 - 不要为了“让测试通过”去放宽正则到过于宽泛的内容。
- 失败检测要确保内核恐慌会使
xtask以非零状态码退出。
验证
- 优先运行最小验证命令,例如
cargo xtask arceos test qemu --test-group rust --test-case <case> --target <target-triple>。 - 确认 QEMU 实际启动、代码打印稳定成功 marker、runner 输出
ok: <case>,并且 panic/失败 marker 使外层命令返回非零。 - 使用
cargo xtask arceos test qemu --list检查新 case 已被发现;需要 axtest target 时改用cargo xtask ktest qemu。 - 确认故意触发内核恐慌或真实失败时,
ostool或xtask能命中fail_regex并以非零状态码退出。 - 如果有编译警告且与当前改动相关,一并修掉。
Freestanding 用户态 CPU 用例
ArceOS Rust 构建默认使用标准库和 musl PIE。验证 uspace 时,内核 TLS 按运行期契约关闭,不能放宽 someboot 链接断言来容纳标准库 TLS。此类独立 Rust 镜像在 build TOML 显式使用 freestanding = true,由同一个 cargo xtask arceos test qemu/board 入口选择共享裸机 JSON、build-std=core,alloc 与 PIE 内核链接脚本。它与 app-c 互斥,不恢复已删除的 std 配置别名。
软件包应保持 no_std、no_main,按真实需求启用 ax-std 的 mini-std 能力,不启用 ax-std/arceos 带入的 std-compat。全局分配器由 ax-alloc/global-allocator 显式提供。参考 cpu/normal/freestanding 与 cpu/src/user_entry(板端pmu-user也使用同一入口):用户线程经 TaskAddressSpace 保留真实页表及 backing pages,再由 UserExecutionContext 验证并进入,不能绕过调度器创建伪用户上下文。
CPU 契约用例的 CI 归属
test-suit/arceos/cpu 通过 cargo xtask arceos test qemu --arch <arch> --test-group cpu 运行,并在 .github/ci/checks/arceos.toml 以 group = "cpu" 注册。不指定组的本地入口仍发现所有组;CI 普通 runner 显式选择 Rust/C,CPU 组单独使用满足硬件要求的 runner,避免普通 x86 runner 误跑 VMX。x86 CPU 组包含 VMX,必须使用 Intel KVM runner;LoongArch 客体进入使用 LVZ 镜像 runner。针对单个变体的测试路径通过 CI 规划器保留准确的 --test-case,不能降级为只跑默认 Rust 组。
OrangePi以arceos-board注册kernel、pmu-user两个批次,kernel包含PMU、IPI、cpufreq;保持板卡runner,单项诊断不重复加入默认CI。调整这些规则时,运行 test_ci_plan.py 的 CPU QEMU 与板卡路由回归;脚本要求 Python 3.11 以上,系统 Python 3.10 时可用 uv run --python 3.13 --no-project python3 -m unittest discover -s scripts/test -p 'test_ci_*.py'。
CPU QEMU/板卡配置使用最新 ostool 的 [[shell_check_steps]],被动等待用例只在该步骤内声明 success_regex,不填写 shell 命令。fail_regex、timeout、启动参数保留在根配置。不得恢复已删除的根级 success_regex 或 shell_init_cmd;分组程序的执行协议沿用当前 axbuild。
跨架构独立用例必须在 package.metadata.docs.rs.targets 声明实际检查目标。依赖 Rust 标准库的用例使用相应 *-unknown-linux-musl,cargo xtask clippy 将其解析到共享 musl PIE JSON 并构建标准库;freestanding 用例使用共享 bare target。用例选项 feature 必须包含程序必需的 ax-std,因为 feature 独立检查关闭默认 feature。不得通过空 main、架构伪实现或跳过测试包来绕过检查。
PCM 输出波形验收
ArceOS Rust/generic 音频用例可在 QEMU 配置中声明 [host_pcm_waveform] frames = <帧数>。
该夹具负责添加独占 wav 后端,ID 为 pcm-capture;设备参数引用此 ID,不自行填写 -audiodev。
输出格式为 stereo S16LE、48 kHz,输入第 i 帧左声道为 (i * 97) % 20001 - 10000,右声道为其相反数。
帧数限定在 1..=65536。运行器在 Cargo target 下创建每次运行独立的 WAV,成功或失败后自动删除,不能复用旧录音。
客体 marker 通过后仍须检查全部预期样本连续匹配、前后仅静音;缺失、重复、改写、错误格式或截断使外层命令失败。
QEMU 被 marker 停止时 WAV data 长度可能仍为零占位,校验器检查已写入文件的实际样本,而不将未完成的 header 当作零音频成功。
这只能证明 QEMU 输出,不证明物理可听声音。
Intel HDA 的 poll_stream_position() 在轮询间隔达到 80 ms 时拒绝继续跟踪 DMA 环。
该 QEMU 作业使用 ubuntu-base 独立虚拟机及标准容器,避免共享宿主的长停顿侵入客体
轮询契约,并输出实际 QEMU 版本。宿主暂停后的 Device 是有效失败,不能提高门限或
放宽波形断言。本地 QEMU 11.1.1 的 x86 启动链在 icount 下触发了
Bad icount read,不为此用例启用该选项。
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

