# CappuccinOS

![LOC](https://img.shields.io/endpoint?url=https://gist.githubusercontent.com/juls0730/c16f26c4c5ab7f613fe758c913f9e71f/raw/cappuccinos-loc.json)

CappuccinOS is a small x86-64 operating system written from scratch in rust. This README will guide you through the process of building and running CappuccinOS.

## Features
- [X] Serial output
- [X] Hardware interrupts
- [X] PS/2 Keyboard support
- [X] ANSI color codes in console
- [X] Heap allocation
- [ ] Externalized kernel modules
    - [X] Initramfs
        - [X] Squashfs driver
            - [X] Programmatic reads
            - [X] Decompression
- [ ] SMP
    - [ ] Use APIC instead of PIC
- [ ] Pre-emptive multitasking
    - [ ] Scheduling
- [ ] Roll my own bootloader
    - [ ] x86 CPU support
    - [ ] armv8 CPU support
- [ ] File system
  - [ ] Block Device support
    - [X] IDE device support
    - [ ] SATA device support
    - [ ] MMC/Nand device support
    - [ ] M.2 NVME device support
- [ ] Basic shell
  - [X] Basic I/O
    - [ ] Executing Programs from disk
- [ ] Lua interpreter
- [ ] Memory management
- [ ] Network support
- [ ] GUI
- [ ] Device drivers
    - [ ] Native intel graphics
- [ ] User authentication
- [ ] Power management
- [ ] Paging
- [ ] RTC Clock

## Setup
Before building CappuccinOS, make sure you have the following installed on your machine:

- rust
- python
- sgdisk
- mtools
- squashfs-tools
- qemu (optional)

Clone the repo:
```BASH
git clone https://github.com/juls0730/CappuccinOS.git
cd CappuccinOS
```

Install rust, if you haven't already:
```BASH
curl https://sh.rustup.rs -sSf | sh -s -- -y --default-toolchain none
```

Install the dependencies:
<details>
    <summary>Arch</summary>

    sudo pacman -S gptfdisk mtools squashfs-tools python
    # Optionally
    sudo pacman -S qemu-system-x86
</details>

<details>
    <summary>Ubuntu</summary>
    Python should be installed by default, and if it's not, make an issue or a PR and I'll fix it

    sudo apt install gdisk mtools squashfs-tools
    # Optionally
    sudo apt install qemu
</details>

## Usage
Run CappuccinOS with QEMU:
```BASH
make run
```

If you would like to just build CappuccinOS but not run it:
```BASH
make build
```

If you would like to target another architecture other than x86_64, set the `ARCH` variable to the a supported architecture. CappuccinOS is also built in release mode by default, if you would like to build CappuccinOS in debug mode, set the `MODE` variable to `debug`.

Run on a bare metal machine by flashing to a USB stick or hard drive:
```
sudo dd if=bin/CappuccinOS.iso of=/dev/sdX bs=1M && sync
```
**Be careful not to overwrite your hard drive when using `dd`!**

## Supported Architectures
- x86_64
- RISC-V64 (experimental until I can get my hands on some RISC-V hardware)

## Credits an attributions
Inspiration was mainly from [JDH's Tetris OS](https://www.youtube.com/watch?v=FaILnmUYS_U), mixed with a growing interest in low level in general and an interest in learning rust (yeah, I started this project with not that much rust experience, maybe a CLI app or two, and trust me it shows).

Some Resources I used over the creation of CappuccinOS:
- [OSDev wiki](https://wiki.osdev.org)
- Wikipedia on various random things
- [Squashfs Binary Format](https://dr-emann.github.io/squashfs/squashfs.html)

And mostly for examples of how people did stuff I used these (projects made by people who actually have a clue what they're doing):
- [MOROS](https://github.com/vinc/moros)
- [Felix](https://github.com/mrgian/felix)
- [mOS](https://github.com/Moldytzu/mOS)

## License
CappuccinOS is license under the MIT License. Feel free to modify and distribute in accordance with the license.