How agf-b/badlands works
BadLands is an experimental x86-64 UEFI operating system. Its principal flow is firmware boot, bootloader preparation and kernel handoff, then kernel initialization and hardware/runtime services; users interact through keyboard input and the shell. The README documents memory management, ACPI, interrupts, PCIe/USB, storage, filesystems, scheduling, and framebuffer output. Several connections below are dashed because the relevant implementation excerpts were not provided; the shown xHCI-to-scheduler relationship is visible in the excerpt.
Main entry points: src/entry.cpp Kernel Entry · src/entry.cpp Boot Entry · Controller.cpp xHCI Controller · kernel_loader.cpp Kernel Loader
Components 26
UEFI Boot
- Boot Entry
bootloader/src/entry.cpp - EFI Filesystem
bootloader/src/efi/efi_fs.cpp - Kernel Loader
bootloader/src/loader/kernel_loader.cpp - Loader Paging
bootloader/src/loader/paging.cpp - ACPI Discovery
bootloader/src/loader/acpi_check.cpp
Kernel Platform
- Virtual Memory
kernel/src/mm/VirtualMemory.cpp - Physical Memory
kernel/src/mm/PhysicalMemory.cpp - ACPI Tables
kernel/src/acpi/Interface.cpp - PCIe Enumeration
kernel/src/pci/PCI.cpp - APIC Interrupts
kernel/src/interrupts/APIC.cpp - Shared Memory Primitives
common/include/shared/memory/defs.hpp
Device Drivers
- xHCI Controller
kernel/src/devices/USB/xHCI/Controller.cpp - USB HID
kernel/src/devices/USB/HID/Driver.cpp - USB Keyboard
kernel/src/devices/USB/HID/Keyboard.cpp - PS/2 Keyboard
kernel/src/devices/PS2/Controller.cpp - Keyboard Dispatch
kernel/src/devices/KeyboardDispatcher/Multiplexer.cpp - Block Storage
kernel/src/devices/Block/Device.cpp - USB Mass Storage
kernel/src/devices/USB/MassStorage/BBB/Driver.cpp
Kernel Runtime
- Kernel Entry
kernel/src/entry.cpp - Task Scheduler
kernel/src/sched/TaskManager.cpp
Storage and Interface
- Virtual Filesystem
kernel/src/fs/VFS.cpp - Nonpersistent FS
kernel/src/fs/NPFS.cpp - Shell Service
kernel/src/services/shell/entry.cpp - Framebuffer Output
kernel/src/screen/Framebuffer.cpp
Other components
- UEFI Firmware
- System User
Connections 25
- UEFI Firmware → Boot Entry: starts bootloader
- Boot Entry → EFI Filesystem: uses filesystem
- Boot Entry → Kernel Loader: loads kernel
- Kernel Loader → Loader Paging: maps kernel
- Boot Entry → ACPI Discovery: discovers ACPI
- Kernel Loader → Kernel Entry: hands off
- Kernel Entry → Virtual Memory: initializes memory
- Kernel Entry → APIC Interrupts: initializes interrupts
- Kernel Entry → PCIe Enumeration: starts enumeration
- Kernel Entry → ACPI Tables: reads tables
- PCIe Enumeration → xHCI Controller: detects controller
- xHCI Controller → Task Scheduler: schedules updater
kernel/src/devices/USB/xHCI/Controller.cpp - xHCI Controller → USB HID: initializes devices
- USB HID → USB Keyboard: handles keyboard
- PS/2 Keyboard → Keyboard Dispatch: forwards key events
- USB Keyboard → Keyboard Dispatch: forwards key events
- PCIe Enumeration → Block Storage: discovers storage
- xHCI Controller → USB Mass Storage: supports mass storage
- USB Mass Storage → Block Storage: provides block device
- Block Storage → Virtual Filesystem: serves filesystem
- Virtual Filesystem → Nonpersistent FS: mounts filesystem
- System User → Shell Service: uses shell
- Shell Service → Virtual Filesystem: accesses files
- Kernel Entry → Framebuffer Output: initializes display
- Kernel Entry → Task Scheduler: starts scheduling