yywd123/SanderOSUSB

32 bit singletasking C kernel

SanderOSUSB

Thank you for showing interest in SanderOSUSB! SanderOSUSB is a 32bit single tasking monolythic kernel that is supposed to run from USB or cd-rom.

Compiling

For compiling you need the following programs:

• gcc
• nasm or fasm
• xorriso (grub)

sudo apt install gcc nasm xorriso

And then run the file /kernel/build.sh [ARGS] to generate kernel file Where:

• empty : only generates a kernel.bin file
• --grub : generates a grub-iso image
• --pxe : generates a pxe image

Runing the OS

• install qemu

sudo apt install qemu qemu-utils qemu-kvm

• go to the repo directory
• run:

qemu-system-x86_64 -cdrom ./cdrom.iso

Suported Devices

Currently the following devices are supported:

• ❓ unknown
• ❌ not supported
• ✅ works
• 🐛 partly working

Devicename	VirtualBox	Qemu	Bochs	Real hardware
IDE - ATA	✅	✅	✅	❓
IDE - ATAPI	✅	✅	✅	✅
AHCI - ATA	✅	✅	✅	🐛
AHCI - ATAPI	✅	✅	✅	❌
PS/2 keyboard	✅	✅	✅	✅
PS/2 mouse	✅	✅	✅	✅
PIC	✅	✅	✅	✅
PCI	✅	✅	✅	✅
ACPI	✅	✅	✅	✅
USB - HID - Keyboard	✅	✅	✅	❓
USB - Mass Storage Device	✅	✅	✅	❌
EHCI (USB2.0) - Basic support	✅	✅	✅	✅
XHCI (USB3.0) - Basic support	❌	✅	❓	🐛
RTL8169	✅	✅	✅	✅
E1000	✅	❓	❓	❓
Soundblaster 16	✅	✅	✅	✅

The following devices are on the list to get implemented:

The following filesystems are supported:

Filesystemname	Read	Write
ISO 9660	✅	❌
MBR	✅	❌
EFI-MBR	✅	❌
EXT2 (very basic)	✅	❌
FAT 12,16,32	✅	✅
SFS	✅	✅
TFTP	✅	❌

the following executable formats are supported:

• 32-ELF (relocation and executable type)
• raw binary at 0x2000
• BASfile (with basic.bin)

the following executable formats are on the list to get implemented:

• 32-MZPE
• 32-MZCOFF
• Marble

the following bootmethods are supported:

• GRUB2
• PXE
• qemu --kernel loader

Directories

• boot: Grub bin folder
• kernel: Kernel source code
• lib: kernel static library to which programs attach to
• programs: example programs

Instalation on CDROM

• build system with ./build.sh --grub
• burn cdrom.iso to a cdrom

Instalation on USB

• make a usbstick with EXT as filesystem
• run sudo grub-install --target=i386-pc --root-directory=[mountpoint_filesystem] /dev/sdb
• copy grub command file sudo cp ../boot/grub/grub.cfg [mountpoint_filesystem]/boot/grub/grub.cfg
• copy kernel sudo cp ../kernel.bin /media/sander/SOS/kernel.bin