Documentation

Complete documentation for Valkyrie OS development, architecture, and usage.

Getting Started

To get started with Valkyrie OS development, you'll need to install the required dependencies and build the cross-toolchain. Refer to the README for detailed installation instructions.

Architecture

Bootloader (Stage 1): Loads Stage 2 from disk
Bootloader (Stage 2): Initializes hardware and loads the kernel
Kernel: Manages system resources, drivers, and JVM execution
JVM: Executes Java bytecode programs

Building

Use SCons to build the project:

./scripts/base/dependencies.sh  # Install dependencies
./scripts/base/toolchain.sh toolchain  # Build cross-toolchain
scons  # Build the OS

Running

Run the OS in QEMU:

scons run

Or debug with GDB:

scons debug

Documentation Files

Download the complete technical documentation PDF from GitHub:

📄 Download Technical Documentation (PDF)