SanderOSUSB Save

32 bit singletasking C kernel

Project README

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:

  • :question: unknown
  • :x: not supported
  • :white_check_mark: works
  • :bug: partly working
Devicename VirtualBox Qemu Bochs Real hardware
IDE - ATA :white_check_mark: :white_check_mark: :white_check_mark: :question:
IDE - ATAPI :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark:
AHCI - ATA :white_check_mark: :white_check_mark: :white_check_mark: :bug:
AHCI - ATAPI :white_check_mark: :white_check_mark: :white_check_mark: :x:
PS/2 keyboard :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark:
PS/2 mouse :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark:
PIC :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark:
PCI :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark:
ACPI :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark:
USB - HID - Keyboard :white_check_mark: :white_check_mark: :white_check_mark: :question:
USB - Mass Storage Device :white_check_mark: :white_check_mark: :white_check_mark: :x:
EHCI (USB2.0) - Basic support :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark:
XHCI (USB3.0) - Basic support :x: :white_check_mark: :question: :bug:
RTL8169 :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark:
E1000 :white_check_mark: :question: :question: :question:
Soundblaster 16 :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark:

The following devices are on the list to get implemented:

The following filesystems are supported:

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

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
Open Source Agenda is not affiliated with "SanderOSUSB" Project. README Source: AdeRegt/SanderOSUSB
Stars
63
Open Issues
6
Last Commit
2 years ago
Repository

Open Source Agenda Badge

Open Source Agenda Rating