https://github.com/automas-dev/os
Hobby i386 Operating System
https://github.com/automas-dev/os
Last synced: about 1 month ago
JSON representation
Hobby i386 Operating System
- Host: GitHub
- URL: https://github.com/automas-dev/os
- Owner: automas-dev
- Created: 2024-04-13T03:21:19.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2025-12-25T02:01:15.000Z (2 months ago)
- Last Synced: 2025-12-25T16:53:49.148Z (2 months ago)
- Language: C
- Homepage:
- Size: 1.04 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# os
~~Following the tutorials under https://github.com/cfenollosa/os-tutorial~~
Active and planned work is tracked in [notes.md](notes.md)
For current specs see
- [boot.md](design/boot.md)
- ~~[filesystem.md](design/filesystem.md)~~
- [memory.md](design/memory.md)
- [process.md](design/process.md)
- [system_call.md](design/system_call.md)
## Goals
The OS will be finished when all of the following are implemented.
1. Able to get and draw basic http web page
2. Compiler for at least Assembly or C
3. Playable Minecraft Clone
The following lists show the planned development stages and planned tasks to
achieve these goals.
### Near Near Term
- [x] Read extended kernel form floppy
- [x] Switch to protected mode
- [x] some stdio.h
- [x] printf
- [x] some string.h
- [x] keyboard driver
- [x] ata driver
- [x] terminal with command parsing
- [x] circular buffer + tests (builtin, needs separating)
### Near Term
- [ ] Kernel stats (stats command returns # disk io, keys, mounts, etc.)
- [ ] Detect stack overflows
- [ ] fs
- [ ] Finish implementing fs functions
- [ ] Implement file io
- [x] basic malloc (linked list)
- [x] malloc
- [x] Actually manage memory
- [x] Need to find end of kernel to not overflow at runtime (for malloc start)
- [x] Detect max memory for malloc
- [x] Do that fancy memory map
- [x] Paging
- [x] Setup page dir and table
- [x] Enter paging
- [x] Load user space application
- [ ] Ring 3
- [x] Kernel Service Calls
- [ ] Date and Time
- [ ] Optional don't disable interrupts during interrupt (nested interrupts)
- [x] Better key event buffer (with mods) (maybe in addition to char buffer)
- [x] Change stdlib names with k prefix for namespace during testing
- [ ] Optimize disk read to check if area already in buffer
### Long Term
These tasks will be broken down further after completion of Near Term, when
there is a better foundation and design to work with.
- [ ] Switch to 2d graphics mode
- [x] Virtual memory pages / memory paging
- [ ] Memory permissions (eg. stack can't exec, code can't write)
- [ ] User level applications (might need 3rd level kernel from filesystem)
- [ ] Testing
- [ ] FAT or EXT2 filesystem driver
- [ ] Audio Driver
- [x] 64 bit support printf (needs libgcc)
- [ ] Text editor
### Long Long Term
These tasks will be broken down further after completion of Long Term, when
there is enough support for their development.
- [ ] Graphics card driver (pseudo opengl)
- [ ] Threading / multi-process
- [ ] (Maybe) Multiboot or GRUB?
## Setup
You will need to install the gcc i386 elf cross compiler. This project expects
this to be under `~/.local/opt/cross` but this can be changed by editing the
root `CMakeLists.txt`. For instructions of how to build the i386 elf compiler
from source, follow the instructions on the OS-Dev Wiki
[GCC_Cross-Compiler](https://wiki.osdev.org/GCC_Cross-Compiler)
```sh
git clone git@github.com:automas-dev/os.git
cd os
make setup
```
### Building
```sh
make build
```
### Running
```sh
make run
```
Once running, use the `help` command to see what you can do.
### Testing
```sh
make test
make test_cov
make test_cov DARK_MODE=ON
```
### Formatting / Linting
```sh
make lint
make format
```