Skip to content

KyronOS 27 Alpha 1

Choose a tag to compare

View all tags
@MaseDev33 MaseDev33 released this 13 Sep 00:05
· 30 commits to main since this release
Alpha
dde9a67

KyronOS 27 Alpha 1

Release status

KyronOS 27 Alpha 1 is an experimental, text-only operating system release for x86 PCs. It boots through GRUB Multiboot2 and presents a VGA terminal shell.

This release is intended for QEMU testing and early real-hardware experiments. It is not production-ready and should not be used as a primary operating system.

Included

  • Bootable hybrid ISO for optical media and USB boot
  • GRUB Multiboot2 kernel bootstrap
  • VGA text console with cursor tracking and line scrolling
  • PS/2-compatible keyboard input
  • Shifted uppercase letters and symbols
  • Tab path completion using the longest matching prefix
  • Directory-aware ls and cd
  • Root filesystem layout with /boot, /dev, /etc, /home, /system, /tmp, /bin, and /kyron
  • User creation and switching with per-user home directories
  • Home-relative prompts using ~
  • Shell navigation commands go back, go home, and go root
  • RAM-backed shell file operations
  • KSFS block-device and superblock validation foundations
  • USB HID boot-report decoding layer
  • Host-side KSFS test

Shell commands

help clear version about echo
ls cd pwd go back go home go root
 touch mkdir rmdir write append cat rm
add user <name>
switch user <name>
devices mem reboot shutdown

A typical prompt looks like:

[kyron]:/#
[kyron]:~#
[alice]:~/projects#

Build and run

Verify dependencies:

./setup.sh

Build the kernel and ISO:

make iso

Run in QEMU with a graphical window:

make run

The generated ISO is:

build/kyronos-alpha1.iso

Download

Download the latest KyronOS ISO from the GitHub Releases page.

The downloadable image is named kyronos-alpha1.iso.

Debugging

Start QEMU paused with a GDB stub:

make debug

Connect from another terminal:

gdb build/kyronos.kernel
(gdb) target remote :1234

Known limitations

  • The kernel is currently a freestanding 32-bit ELF bootstrap loaded by GRUB.
  • Native EHCI/xHCI controller enumeration and USB interrupt transfers are not complete.
  • USB HID report decoding exists, but native USB keyboard input is not yet wired to hardware transport.
  • Storage is RAM-backed; SATA, AHCI, NVMe, IDE, and general internal-disk drivers are not included.
  • KSFS directory and file persistence is still under development.
  • The terminal editor, optical read support, networking, and graphical environment are not included.
  • Hardware support and behavior may vary on physical machines.

Verification

The release ISO was generated successfully with grub2-mkrescue and verified as a bootable ISO9660 image. The host-side KSFS test passes with make test.

Assets 3
Loading