Kercy/krcyos
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
A toy RISC-V kernel built with Zig for OS exploration (WIP).
76 commits 1 branch 0 tags 995 KiB
  • Zig 97.2%
  • Linker Script 1.8%
  • Assembly 1%
Find a file
Exact
KercyDing 525a04e579 docs: simplify README
2026-06-20 23:54:40 +08:00
assets docs: update demo webp 2026-06-04 06:41:15 +08:00
bootloader chore: add banner and select sbi for level 2026-05-02 11:07:11 +08:00
os docs: simplify README 2026-06-20 23:54:40 +08:00
.gitignore chore: rm fxxking .DS_Store 2026-05-05 00:47:30 +08:00
build.zig feat: add basic TrapFrame 2026-06-20 05:39:33 +08:00
build.zig.zon chore: use Zig 0.16.0 2026-06-15 00:53:38 +08:00
Onlyfile docs: update unit tests and webp 2026-05-26 06:12:34 +08:00
README.md docs: simplify README 2026-06-20 23:54:40 +08:00

README.md

🌱 KrcyOS

A toy RISC-V kernel built with Zig for OS exploration.

Github: URL

 

Motivation

Just for fun.

Prerequisites

  • Zig (pinned to 0.16.0)
  • QEMU (>=11.0.0, if you don't have a real board)
  • Only (task runner if you like)

Skill issue? Click here.

Getting Started

Clone the toy

git clone https://code.kercy666.com/Kercy/krcyos.git
# if you prefer github:
# git clone https://github.com/KercyDing/krcyos.git
cd krcyos
# ...

Simply run it

zig build run
# or:
# only run qemu

If you have a real board:

zig build run -Dboard=real_board
# or:
# only run real

Then flash to your board.

Press Ctrl+A + X to exit qemu.

What's more

Try another log level:

zig build run -Dlog=debug
# or:
# only run qemu debug

Run unit tests:

zig build test
# or:
# only test

That's it.

Why not C/Rust?

No reason. Zig worth.