How arbuz7277/arbuzos works
ArbuzOS is a learning-oriented 32-bit x86 operating system booted through an MBR. Its principal workflow is firmware boot into real-mode startup, transition to protected mode, then kernel initialization and VGA output; interrupt setup enables timer and keyboard handling. The tree also shows disk-access routines, panic reporting, and screen/keyboard helpers. The README documents the MBR boot and 32-bit OS, but most assembly was not sampled, so connections involving those modules are shown as unverified rather than asserted.
Main entry points: idt.cpp IDT Setup · boot.asm MBR Startup · pmode.asm Protected Entry · kernel.cpp Kernel Startup
Components 25
Boot and Disk
- MBR Startup
boot.asm - Disk Address Packet
disks/dap.asm - LBA Support
disks/lba_support.asm
CPU Modes
- Protected Entry
pmode.asm - GDT Setup
protected_mode/gdt.asm - Real-Mode Text
real_mode/print_str.asm - Protected Text
protected_mode/print_str.asm
Kernel Core
- Kernel Startup
kernel/kernel.cpp - Panic Reporter
kernel/kernel_panic.cpp - Port I/O
kernel/include/ports.hpp
Interrupts
- IDT Setup
kernel/idt/idt.cpp - IDT Definitions
kernel/include/idt.hpp - ISR Stubs
kernel/idt/gates/isr_stub.asm - Double Fault
kernel/idt/gates/double_fault.asm - PIC Remap
kernel/idt/pic_remap.asm - Timer IRQ
kernel/idt/irq/timer.asm - Keyboard IRQ
kernel/idt/irq/keyboard.asm
Display and Input
- VGA Printer
kernel/drivers/print.cpp - Print API
kernel/include/print.hpp - Interrupt Messages
kernel/idt/idt_msg.asm - Character Output
protected_mode/screen/putc.asm - Hex Output
protected_mode/screen/print_hex.asm - Scancode Handler
protected_mode/screen/keyboard/handle_scancode.asm - US Keymap
protected_mode/screen/keyboard/keymap_us.asm
Other components
- BIOS / User
Connections 24
- BIOS / User → MBR Startup: boots MBR
README.md - MBR Startup → Disk Address Packet: uses disk access
- MBR Startup → LBA Support: reads sectors
- MBR Startup → Real-Mode Text: prints text
- MBR Startup → Protected Entry: enters protected mode
- Protected Entry → GDT Setup: loads GDT
- Protected Entry → Protected Text: prints text
- Protected Entry → Kernel Startup: transfers control
- Kernel Startup → IDT Setup: initializes IDT
kernel/kernel.cpp - Kernel Startup → PIC Remap: remaps PIC
kernel/kernel.cpp - Kernel Startup → VGA Printer: prints banner
kernel/kernel.cpp - IDT Setup → IDT Definitions: uses definitions
kernel/idt/idt.cpp - IDT Setup → ISR Stubs: registers default handler
kernel/idt/idt.cpp - IDT Setup → Double Fault: registers vector 8
kernel/idt/idt.cpp - IDT Setup → Timer IRQ: registers vector 32
kernel/idt/idt.cpp - IDT Setup → Keyboard IRQ: registers vector 33
kernel/idt/idt.cpp - Panic Reporter → VGA Printer: prints diagnostics
kernel/kernel_panic.cpp - VGA Printer → Print API: implements API
kernel/drivers/print.cpp - VGA Printer → Character Output: writes VGA text
- Protected Text → Character Output: renders characters
- Protected Text → Hex Output: formats hexadecimal
- Keyboard IRQ → Scancode Handler: handles key input
- Scancode Handler → US Keymap: maps scancodes
- IDT Setup → Interrupt Messages: reports interrupts