Home » Uncategorized » BareMetal OS – Build/Install Instructions

BareMetal OS – Build/Install Instructions

BareMetal OS – Build/Install Instructions

Version 0.5.0 (DRAFT), 14 February 2011 – Return Infinity

This documentation details how to build the OS and applications from source and also how to install the OS and applications on a Virtual or Phyisical computer.



Building the OS

Building the BareMetal OS kernel only requires one program to be installed: NASM. NASM will compile the Assembly source files into a executable binary file. NASM is also used to compile any applications that are writtin in Assembly.

Download and extract the BareMetal OS source files to your harddrive. A link to the latest source files is always at the bottom of the BareMetal OS webpage.

nasm kernel64.asm -o kernel64.sys

yasm kernel64.asm -o kernel64.sys

Creating a bootable drive

Get an old IDE hard drive (or a compact flash to IDE adapter with a compact flash card).

Partition the drive in MBR format with a primary partition. The primary partition needs to be FAT16 (2GiB in size or less). Format the partition with FAT16 and set it as active.

Open the hard drive with a hex editor. By default it should load the first sector on the drive (Sector 0).

Big Boat

The infomation for the first partition starts at 0x1BE and the LBA start of the partition is a 32-bit value at 0x1C6. 0x80000000 is actually 0x00000008 as it needs to be converted to Big-endian. In the example screenshot the first sector of the first partition is 128 (0x80). More information on MBR can be found here: MBR layout

Big Boat

Using the hex editor go to the first sector of the first partition. Overwrite bytes 0x3E – 0x1FD of the boot sector with the boot sector from Pure64’s FAT16 boot sector (boot16b.bin).

Copy pure64.sys and kernel64.sys to the hard drive.

Install the hard drive into the computer making sure the hard drive is on the primary IDE channel and that the drive is set to master.
The PC should be bootable now. Pure64 will display debug information in the top right corner of the screen during bootup. If you have any issues please email us at support@returninfinity.com. Writing the disk image to a drive Linux uses dd Windows users can use dd for windows

BareMetal OS is open source and released under the 3-clause “New BSD License” (see docs/LICENSE.TXT in the BareMetal OS distribution). Essentially, it means you can do anything you like with the code, including basing your own project on it, providing you retain the license file and give credit to Return Infinity and the BareMetal OS developers for their work.


Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Google+ photo

You are commenting using your Google+ account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )


Connecting to %s