54 lines
2.1 KiB
Markdown
54 lines
2.1 KiB
Markdown
# TABS
|
|
|
|
Totaal Arbitrair BesturingsSysteem, Zeus maakt een besturingssysteem!
|
|
|
|
## How to use
|
|
|
|
To compile, you need:
|
|
|
|
- `i686-elf-gcc` for cross-compiling the kernel
|
|
- A system `gcc` for compiling the host-helpers
|
|
- `nasm` for compiling the bootloader
|
|
- `qemu-system-i386` for emulating (`qemu-system-x86_64` will probably work too, but that is not directly supported)
|
|
|
|
More information about installing a cross compiler can be found [here](https://wiki.osdev.org/GCC_Cross-Compiler#The_Build).
|
|
|
|
If you run `make bin`, it will generate `target/boot.bin`, this is a binary file layed out as described in [the docs](docs/bootloader.md). To burn it on a USB drive, simply `dd if=target/boot.bin of=/dev/sdb` and the drive is bootable and contains an SFS filesystem with the files in `filesystem/`.
|
|
|
|
In case there are errors in the bootloader you can use `make compile_kernel` to only compile the kernel.
|
|
|
|
To run TABS in the qemu simulator run `make run`.
|
|
To test the operating system in QEMU, first set up a tap interface with the `create_tap.sh` script,
|
|
then run `make run` or `make run_kernelonly`.
|
|
|
|
## Bootloader
|
|
|
|
The bootloader is self-written, based on articles on [the OSDev wiki](https://wiki.osdev.org/). It's a single stage, ELF-loading bootloader in the most basic way possible.
|
|
|
|
More info in [the docs](./docs/bootloader.md)
|
|
|
|
## Kernel
|
|
|
|
The kernel is based on [the bare bones kernel from the OSDev wiki](https://wiki.osdev.org/Bare_Bones).
|
|
|
|
### Features
|
|
|
|
- [x] Terminal output (with newlines!)
|
|
- [x] _Very_ basic (and probably broken) memory management
|
|
- [x] Interrupt handling
|
|
- [x] Keyboard input
|
|
- [x] Exception handling
|
|
- [x] Minimal shell
|
|
- [ ] Filesystem interaction
|
|
- [ ] Show files in directory
|
|
- [ ] Read files in directory
|
|
- [ ] Write files in directory
|
|
- [ ] Tests
|
|
- [ ] Running executables from filesystem
|
|
- [ ] Better memory management
|
|
- [ ] Better shell
|
|
- [X] A driver for E1000-type network cards
|
|
- [X] sending packets
|
|
- [X] receiving packets
|
|
|
|
As a test, I've implemented day 1 of [advent of code](https://adventofcode.com/) on the [AoC branch](https://github.com/Robbe7730/RoBoot/tree/AoC).
|