Quickstart — Run AeroOS in 10 minutes
What you need
| Tool | Purpose | Install (Ubuntu/WSL) |
|---|---|---|
| clang 18+ / lld | C compile + link | wget -O - https://apt.llvm.org/llvm.sh \| sudo bash -s 22 |
| riscv64 binutils | Generate .bin |
sudo apt install binutils-riscv64-linux-gnu |
| QEMU riscv64 | Run | sudo apt install qemu-system-riscv64 |
| Rust / cargo | Build aero-ld | curl ... rustup.rs |
| Aero compiler 1.2.4 | Compile .aero |
Download from GitHub releases |
One-step build
cd AeroOS-26R1
bash build.sh
Output:
build/AeroOS-26R1-riscv64.elf 30 KB # QEMU -kernel directly loads
build/AeroOS-26R1-riscv64.bin 8 KB # Raw binary for flashing
One-step run
./run-qemu.sh
# Ctrl-A X to exit
One-step verify
./test-boot.sh # Boot test (3s timeout)
./test-interrupt.sh # Interrupt response test (10s timeout)
exit code 0 means all PASS.
Expected output
OpenSBI v1.3
AeroOS 26R1 booting...
sched: 4 S-mode + 1 U-mode tasks created
T0: idle loop
hello from Aero
...