Warning
There might be dragons and bugs.
ZenOS is a modern 64-bit SMP Preemptive custom operating system, developed entirely from scratch using C and x86_64 assembly, and bootstrapped with the Limine bootloader.
The project focuses on clean design, correctness, and practical experimentation with real hardware concepts, while remaining lightweight and understandable. ZenOS is not a fork of an existing OS, nor is it POSIX-complete by design - it is a ground-up system built to explore kernel architecture, hardware interaction, and userspace execution in a controlled and extensible way. (Note: This is not a Unix / *nix like OS. My goal is to have the cleanest and well structured OS, while remaining optimized and providing userspace plenty.)
- 64-bit x86_64 monolithic kernel
- Symmetric Multiprocessing (SMP) with full AP startup
- Pre-emptive round-robin scheduler
- Kernel ↔ userspace context switching
- Custom syscall ABI with assembly entry path
- ELF64 executable loading
- Userspace process support
- CPU feature detection via CPUID
- SSE and FPU initialization and management
- Spinlock-based synchronization primitives
- High-resolution timing via HPET
- ACPI-based hardware discovery and power handling
- VGA output
- PC speaker support
- Serial output for debugging and logging
- Local APIC and IOAPIC interrupt handling
- ATA disk driver (PIO, 28-bit LBA)
- Socket read/write
- PCI bus enumeration
- Intel e1000 Ethernet driver (early-stage networking)
- Others include RTC, HPET, Keyboard (PS/2), Mouse (PS/2)
- FAT32 (FatFs) port of FatFs made by CHAN
- Native host-side file management tooling (
fat_man) - Used as the primary medium for userspace ELF binaries
ELF64userspace programs- Custom syscall interface (Currently 49 present.)
- Calculator with
+,-,*,/,%,^(calc.c) - C4 : C in 4 functions compiler. (cc.c)
- Clock - Live clock (clock.c)
- Counter program (counter.c)
- Fibonacci sequence (fibonacci.c)
- Figlet - Graphical figlet style thingy (figlet.c)
- GFX Server - Graphics server for Unicode text / shapes (gfxserver.c)
- GFX Test - Program to test the above server (gfxtest.c)
- Hello, world! (hello.c)
- Init (init.c)
- Memory functions test (memtest.c)
- Prime numbers till 100 (primes.c)
- Shell - Simple Shell (shell.c)
- SmallerC compiler to Assembly (smlrc.c)
- Snake (snake.c)
- Sysinfo - Graphical + More detailed system info (sysinfo.c)
- Template program (test.c)
- Uname - System info (uname.c)
- Word counter (wc.c)
- Yes - Spam whatever you say (yes.c)
The ZenOS.vhd file in the repository already usually has these programs in it.
- Run :
make allat the root of the cloned git repo. - Any issues will be reported, to which you can take necessary action, such as missing dependencies.
- For convenience, (
make funcs) has been provided, running it will generatefuncs.txtwith all functions defined in the OS.
All good contributions are gladly welcome! It is suggested to fix an issue in the ISSUES.md, or you can add a feature, fix another unlisted bug, make ZenOS overall better!
-
Maintain a clean, minimal, and readable codebase
-
Provide a solid foundation for experimentation with:
-
Kernel subsystems
-
Filesystems
-
Scheduling
-
SMP
-
Userspace ABI design
-
Support simple dual-boot usage and lightweight utilities such as a Calculator, Text editor, simple apps, File Manager, System Info, etc. (Now in progress)
ZenOS is intended as a learning-oriented operating system project, prioritizing understanding the machine over chasing checklists.
clang
ld.lld
nasm
xorriso
qemu-system-x86_64
gdb
socat- The Limine bootloader. https://codeberg.org/Limine/Limine
- Flanterm Terminal emulator. https://codeberg.org/mintsuki/flanterm
- Scalable Screen Font 2.0. https://gitlab.com/bztsrc/scalable-font2/
- FatFs by CHAN. https://elm-chan.org/fsw/ff/
- SmallerC compiler. https://github.com/alexfru/SmallerC
- C4 Compiler: C in 4 functions. https://github.com/rswier/c4
ZenOS