1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
|
[](https://builds.sr.ht/~shrik3/rustubs/commits/master/x86_64.yml?)
# License & Copyright:
This project aims for a total rewrite TU Dresden OS Group's tutorial OS
"OOStuBS". However this is in its very early stage and is using some
boilerplates from the lecture e.g. the startup assembly code.
This project will adapt GPL when the dependencies are sorted out (hopefully very
soon). Untill then all rights are reserverd.
# The rust port of OOStuBS [WIP]
This is a toy bare metal operation system implemented in Rust. Apologies for my
shitty code, I'm a rust beginner.
The project is based on the OOStuBS, an OS exercise project used in some German
Universities. This one in perticular, is based on the TU Dresden version
(Operating System Construction), led by my Professor Dr. Horst Schirmeier.
**Status / Roadmap**
- [X] Basic code structure
- [X] Build minimal iso image
- [X] bootable using grub
- [X] Setting up CGA display, print something (hello world)
- [X] Intigrate print into rust println! etc.
- [X] Keyboard controller and input handler
- [?] Interrupt handler (WIP)
- linked list for plugbox
- implement plugbox
- interrupt handler code for kbd
- input buffer
- [ ] intrrupt sync
- split upper/lower half of handlers
- [ ] Threading
- stack allocator (could be trivial)
- define context
- implement switch/toc code
- [ ] Scheduler (single CPU)
- DS
- [ ] Timer Interrupt
- [ ] Synchronization Primitives
- implement waiting/wakeup
- [ ] asm! Wrappers for basic instructions
Beyond the original StuBS
- [ ] Task Descriptor structures
- [ ] Paging: PMA and paging structures
- [ ] Paging: pagefault handler
- [ ] user heap and mmap
- [ ] Upperhalf Kernel
- [ ] Address Space for each Process
- [ ] in memory FS
- [ ] user library
- [ ] syscall
- [ ] aarch64 support
## Build
Please take a look at the CI manifest:
`.builds/x86_64.yml`
**>general dependencies:**
- cargo / rustc (nightly)
- xbuild for crossbuild
- basics: nasm, make, glibc, ld etc.
- xorriso and grub (to create bootable image)
- qemu-system-x86_64 (optionly for simulation)
**before building**
- You may need to add the rust sources component by `rustup component add rust-src`
**build and run**
- simply run `make`, you will get `bootdisk.iso`, which you can use to boot a
bare metal
- use `make qemu` to load and test the iso image with qemu
# Remarks
**Why not projects like [blog_os](https://os.phil-opp.com/)?**
firstly, because it's my own practice. "What I can't create, I don't understand".
Secondly, the newest revision of *blog_os* can only be booted with BIOS, not
UEFI. And the complexity (e.g. the sartup.s) is hidden behind the `bootimage`,
I feel necessary to go through the painful part.
**Your code sucks**
Yes. I'm a rust beginner.
**Helper docs**
x86_64 calling conventions
https://aaronbloomfield.github.io/pdr/book/x86-64bit-ccc-chapter.pdf
Rust inline asm
https://rust-lang.github.io/rfcs/2873-inline-asm.html
asm Syntax : (we use nasm in assembly and .intel_syntax noprefix in rust asm)
https://en.wikipedia.org/wiki/X86_assembly_language#Syntax
naming conventions
https://rust-lang.github.io/api-guidelines/naming.html
Makefile Cheatsheet:
https://devhints.io/makefile
AT Keyboard Controller:
https://homepages.cwi.nl/~aeb/linux/kbd/scancodes-8.html
PS/2 Keyboard Controller:
https://wiki.osdev.org/PS/2_Keyboard
|
