Repository files navigation

This repository contains a simple UEFI ELF bootloader which loads a simple demonstration kernel. It provides an extremely basic example implementation of a UEFI bootloader for a bare-metal x86-64 system, though this example should be portable to other architectures.

The aim of this repository is to serve as a basic teachable example of how to implement a UEFI bootloader.

This bootloader assumes a GCC cross-compiler toolchain targeting the bare-metalx86_64-elf architecture. Instructions for building and obtaining a valid cross-compiler toolchain can be foundhere.

This bootloader can be built simply by runningmake within thesrc directory. This will create thebuild/kernel.img file, which is a bootable disk image containing the bootloader loading a demonstration kernel. There is arun script within the root directory containing a script for testing the bootloader/kernel combination using QEMU.

• GNU Make
• GNU EFI
• Anx86_64-elf-gcc cross-compiler toolchain present inPATH

This project is broken down into two distinct components: The bootloader, and the example kernel. These can be found in thesrc/bootloder andsrc/kernel directories respectively. These can be built and tested individually using the makefiles within their individual directories. Running the makefile within the top levelsrc directory will build the entire project.

The bootloader component of this repository, contained within thesrc/bootloader directory, contains the basic implementation of a UEFI ELF bootloader for the x86-64 platform. The bootloader is hardcoded to load and execute a bare-metal x86-64 application located at/kernel.elf on the boot media.This path can be modifid from within thesrc/bootloader/src/include/bootloader.h file by modifying theKERNEL_INCLUDE_PATH preprocessor directive.

The bootloader will output debugging information over the system's serial port, if present. Otherwise VGA output will be used.

The bootloader passes aKernel_Boot_Info struct to the loaded kernel containing basic system information, such as the memory map. This struct is defined within thesrc/bootloader/src/include/bootloader.h header file. This implementation is not tied to any specific architecture.

The bootloader will open the Graphics Output Protocol and Serial Protocol. A routine has been provided for drawing a test screen to demonstrate that the graphics output protocol has been loaded correctly. This can be toggled by setting theDRAW_TEST_SCREEN preprocessor directive at the top of thesrc/bootloader/src/main.c file.

This repository contains a minimal x86-64 kernel for testing purposes. This is located within thesrc/kernel directory. It contains a basic UART implementation suitable for testing that the kernel has been correctly loaded.

Feel free to direct any questions or feedback to me directly atajxs [at] panoptic.online