Board and SoC model development on top of QEMU
A downstream tree for new machine models, boot flows, and test coverage.
Process Mission maintains this downstream QEMU branch for board and SoC models that are not yet carried by upstream QEMU. The branch is regularly rebased on top of upstream QEMU as new machine models, boot flows, and tests are added.
Looking for something specific? Start with the machine model list, browse the system emulation documentation, or open an issue for a new machine request or a bug report.
Machine models · Build and documentation · Development workflow
The table below is the current map of machine models covered by this tree.
| Architecture | Machine | Direct boot | Firmware | Origin |
|---|---|---|---|---|
| RISC-V | k230-canmv |
✅ | ✅ | PM |
| RISC-V | k3-pico-itx |
✅ | ✅ | PM |
| RISC-V | milkv-duo |
✅ | ✅ | UP |
| RISC-V | riscv-server-ref |
✅ | ✅ | UP |
| ARM | ardep-v2 |
✅ | ✅ | PM |
| ARM | ax650x-pyramid |
✅ | — | PM |
| ARM | phytium-pi |
✅ | ✅ | PM |
| ARM | rk3588-evb |
✅ | ✅ | PM |
| ARM | rk3588s-roc-pc |
✅ | ✅ | PM |
| ARM | rock-5b-plus |
✅ | ✅ | PM |
| ARM | s32k566-cvb-r52 |
✅ | — | PM |
| ARM | stm32g474 |
✅ | — | PM |
| MCS-51 | stc8g1k08a |
✅ | ✅ | PM |
| MCS-251 | stc32g144k246 |
✅ | ✅ | PM |
Origin legend
| Mark | Meaning |
|---|---|
PM |
Process Mission downstream-maintained model |
UP |
Imported from upstream QEMU/qemu-devel |
OSS |
Imported from another open-source repository |
VND |
Imported from vendor sources |
This tree follows the upstream QEMU build and documentation layout. Use the upstream README for the general build path, then explore the local system and developer documentation for model-specific details.
- QEMU build and contribution guide
- System emulation documentation
- Developer documentation
- Online QEMU documentation
Machine models in this branch are developed with the
oh-my-qemu workflow. It
provides agent skills for planning, register extraction, peripheral modeling,
board modeling, qtest, build, debugging, and verification.