summaryrefslogtreecommitdiff
path: root/README.md
blob: e599fdd880687310b8a1e7599724155e169d4fdc (plain)
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
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
Welcome to FoolOS
=================

Disclaimer
----------

THIS IS A WORK IN PROGRESS.

This is a simple and useless "operating system", with very basic 
features, sorry. It is the fruit of my fundamental explorations of 
the x86 architectures,  32-bit protected mode, interrupt handling, 
memory management, scheduling the floppy disk controller, networking 
as well as VESA and a couple of other things.

![Screenshot of FoolOS](/screenshots/foolos.png?raw=true "FoolOs Kernel")

Copyright M.Idziorek 2014 <m.i@gmx.at> unless stated otherwise!

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

Usage
-----

Attach the FoolOS.img floppy image in your favourite emulator and boot
or create a bootable USB stick by copying the raw data in the following way


$ cat ./release/FloppyOS.img > /dev/sdX

This image is not updated on every commit, so it might be out of date.
You can build it yourself by running "make" in the projects 
directory. You might need some dependencies (as newlib) however. 


Supported Platforms
-------------------

FoolOS is tested/developed on the following emulators/machines

* bochs 2.6.6 (compiled with: ./configure --enable-clgd54xx --enable-a20-pin --enable-debugger --enable-disasm --enable-e1000 --with-x --with-x11 --enable-smp)
* qemu 1.1.2
* virtual box 4.1.18
* Acer Aspire 1810TZ (Notebook)
* Q6600 on Asus p5n32-e sli plus (Desktop PC)

Features
--------

Please note that all features are only very rudimentary and buggy.

* Bootloader (2 stages)
* PIT support / Timing
* PIC support & Interrupt handling framework
* PCI bus scanning
* Physical memory management
* Virtual memory management
* Multitasking
* Symmetric Multiprocessing
* ACPI / MP
* Floppy disk driver
* PS2 Mouse driver
* Keyboard driver (redesign!)
* VESA 
* Spinlocks
* Simple Shell
* Simple Ext2 driver (read-only)

Todos
-----

* set up os-specific toolchain!
* set dependancies in the makefile properly!
* Port coreutils, gcc?
* E1000 driver
* Networking stack 
* Web-server
* User space
* window manager

* 64-bit
* ARM
* JVM
* USB driver
* Higher half kernel

Issues
------

* Assumed support for VESA mode 0x114 with linear addressing.
* Control of stack heap growth?

Organization
------------

* asm/	- NASM assembler files
* bochs/ -Bochs config files
* boot/ - 2nd stage bootloader
* boot0/ - 1st stage bootloader
* data/ - datafiles (font-file and fill.asm)
* fs/	- file system related source
* kernel/ - kernel source
* lib/ - some helper sources and includes
* release/ - latest release
* screenshots/ - latest screenshot
* tools/ - scripts and toos
* userspace/ - userspace related code


REFERENCES
==========

* http://www.brokenthorn.com/Resources/OSDev17.html
* http://www.jamesmolloy.co.uk/tutorial_html/9.-Multitasking.html
* http://pdos.csail.mit.edu/6.828/2011/labs/lab6/
* http://pdos.csail.mit.edu/6.828/2011/xv6.html
* http://www.nongnu.org/ext2-doc/
* http://www.osdever.net/tutorials/view/multiprocessing-support-for-hobby-oses-explained
* http://forum.osdev.org/viewtopic.php?f=1&t=10944
* http://wiki.osdev.org/Virtual_8086_Mode
* http://wiki.xomb.org/index.php?title=ACPI_Tables