Build scripts for BareMetal OS and its related utilities - The easiest way to create a BareMetal OS environment. These scripts will download and compile all of the components needed for using BareMetal OS.
The scripts in this repo depend on a Debian-based Linux system like Ubuntu or Elementary. macOS is also supported to build and test the OS and Assembly applications if you are using Homebrew.
- NASM - Assembly compiler to build the loader and kernel, as well as the apps written in Assembly.
- QEMU - Computer emulator if you plan on running the OS for quick testing.
- GCC - C compiler for building C/C++ applications.
- Git - Version control software for pulling the source code from GitHub.
Optional:
- mtools - Utilities to access DOS disks in Unix. This is only required if you plan on using UEFI.
In Linux this can be completed with the following command:
sudo apt install nasm qemu-system-x86 gcc git
BareMetal OS consists of several different projects:
- Pure64 - The boot sector and software loader. Pure64 is responsible for getting the computer into a clean 64-bit state on boot up.
- BareMetal - The kernel.
- Monitor - A simple command line interface.
- BMFS - The BareMetal File System utility.
- BareMetal-Demo - Various test/example programs.
git clone https://github.com/ReturnInfinity/BareMetal-OS.git
cd BareMetal-OS
./setup.sh
setup.sh
automatically runs the build and install scripts. Once the setup is complete you can execute the run.sh script to verify that everything installed correctly.
./build.sh
./install.sh
This command installs the boot sector, loader (Pure64), kernel, and simple command line interface (Monitor) to the disk image. If you want to attach your own binary to the end of the kernel you can use ./install.sh mybinary.bin
./add-demos.sh
This command installs the various test/example programs to the disk image.
./run.sh
./uefi-run.sh
This command relies on mtools
to create a disk image formatted with FAT.
./vmdk.sh
./vdi.sh
The VDI script rewrites the disk ID of the VDI file to avoid the disk warning in VirtualBox.
// EOF