Table of Contents

1. About The Project
   • Built With
2. Getting Started
   • Prerequisites
3. Usage
4. Roadmap
5. Contributing
6. License
7. Contact
8. Acknowledgments

About The Project

A simple 32 bit hobby OS made in order to learn more about how CPUs and OSes work.

(back to top)

Built With

• GCC
• QEMU
• GNU Make
• GDB

(back to top)

Getting Started

Prerequisites

• GNU make

  sudo apt install make

• GCC

  sudo apt install gcc

• QEMU

  sudo apt install qemu-system

• GDB (optional)

  sudo apt install gdb
  

(back to top)

Usage

• To emulate the OS in qemu:

  make

• To write the OS to /dev/sda ENSURE THAT /dev/sda (or whatever you have changed this to in the makefile) is not a system critical disk:

  make install

  then enter your password when prompted
• To debug the OS:

  make debug

  then in a separate shell:

  bash gdb.sh

(back to top)

Roadmap

• Basic boot and hello world
• Switch to 32 bit
• VESA support for higher resolutions
• Virtual memory
• Advanced hardware detection
  • PCI
  • ACPI
• Basic power management
• Reading from secondary storage
• Basic filesystem support
• Multiprocessing
• IPC
• Multithreading

(back to top)

Contributing

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Please note that this is a hobby project and is not even fully featured enough to turn off yet

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

(back to top)

License

Distributed under the MIT License. See LICENSE.txt for more information.

(back to top)

Contact

Project Link: https://github.com/MarkRoss470/pepperOS

(back to top)

Acknowledgments

• osdev.org wiki

(back to top)