BarinkOS/README.md

# Writing an Operating system 
## As a learning experience!
 Inspired by people like Linus Torvalds and Andreas Kling

![Logo](images/BarinkOS.png)

________________________
### Screenshot(s)
![Scrolling the terminal](screenshots/Screenshot1.png)   \
The first scrolling boot screen. 😲


![Interrupt handeling](screenshots/WIP_interruptHandling.png)   \
W.I.P - Working on interrupt handling


![Multiboot integration](screenshots/multiboot.png) \
Multiboot information can be read by the kernel.

![Page faulting](screenshots/PageFault.png) \
Enabled paging and am getting page faults!

![PCI enumeration](screenshots/PCIBusEnumeration.png) \
Enumerating the PCI bus 

![ATAPI CD-ROM Identification](screenshots/CD-ROM_Identify.png) \
Correctly identified our ATAPI device 🎉

![Reading Files from FAT-16](screenshots/ReadingFilesFromFAT16.png) \
Reading a FILE from a FAT-16 Formatted drive 

________________________

### The goal
Writing a hobby operating system to better understand the basic building blocks of any operating system.Initially I'd like for my 
operating system to be able to run bash.

________________________
### Operating System Technical specs/details
The operating system can print strings to the 
screen. The terminal/screen has scrolling so the latest messages are visible on the screen.

________________________
### Planning
[See TODO](todo.md) \
[See Features](features.md)
________________________
### Docs
[Intro](docs/Intro.md) \
[Manuals](docs/Manuals.md) \
[Project structure](docs/ProjectStructure.md) 
________________________
### Resources:

#### General kernel stuff
[wiki.osdev.org/Main_Page](wiki.osdev.org/Main_Page)

[Modern Operating Systems [book]](https://www.amazon.com/Modern-Operating-Systems-Tanenbaum-Andrew/dp/1292061421/ref=sr_1_1?__mk_nl_NL=%C3%85M%C3%85%C5%BD%C3%95%C3%91&dchild=1&keywords=Modern+Operating+systems&qid=1619967779&sr=8-1)

[whiteheadsoftware.dev](https://whiteheadsoftware.dev/operating-systems-development-for-dummies/)

#### More specific stuff
[VFS explained: science.unitn.it](https://www.science.unitn.it/~fiorella/guidelinux/tlk/node102.html)
Initial setup, Basic helloworld kernel from wiki.osdev.org bare bones 2021-05-02 16:02:00 +00:00			`# Writing an Operating system`
Updated README.md, Moved planning to TODO.md 2021-05-03 00:22:12 +00:00			`## As a learning experience!`
			`Inspired by people like Linus Torvalds and Andreas Kling`
Added an otter logo! I think its so cute 2021-05-26 18:51:35 +00:00
Moving logo to png format gitea doesn't handle svg format, simplified screenshot inclusion in readme 2021-05-26 19:03:53 +00:00			`![Logo](images/BarinkOS.png)`
Adding logo properly to README, hopefully this way it show up in preview on gitea 2021-05-26 18:58:27 +00:00
Updated README.md, Moved planning to TODO.md 2021-05-03 00:22:12 +00:00			`________________________`
			`### Screenshot(s)`
Moving logo to png format gitea doesn't handle svg format, simplified screenshot inclusion in readme 2021-05-26 19:03:53 +00:00			`![Scrolling the terminal](screenshots/Screenshot1.png) \`
Added first screenshot 2021-05-03 18:46:11 +00:00			`The first scrolling boot screen. 😲`


Added emulator options, Added header for VBE driver, Added CPUID function, Added demodisk.img as drive 2021-07-22 21:14:58 +00:00			`![Interrupt handeling](screenshots/WIP_interruptHandling.png) \`
More work on interrupt handling, Started timer interrupt implementation, PIC remapped hopefully successfull 2021-05-16 14:53:14 +00:00			`W.I.P - Working on interrupt handling`

Added emulator options, Added header for VBE driver, Added CPUID function, Added demodisk.img as drive 2021-07-22 21:14:58 +00:00
			`![Multiboot integration](screenshots/multiboot.png) \`
			`Multiboot information can be read by the kernel.`
End of the day cleanup. * Added symbol files to .gitignore * Improved text in #PG and #GP handlers * Added the printing of the multiboot structure address and the magic value * Added page fault screenshot to readme 2022-08-18 23:05:10 +00:00
			`![Page faulting](screenshots/PageFault.png) \`
			`Enabled paging and am getting page faults!`

PCI support checked of on features.md, PCI enumeration screenshot added to readme.md 2021-11-28 20:12:12 +00:00			`![PCI enumeration](screenshots/PCIBusEnumeration.png) \`
			`Enumerating the PCI bus`
ATAPI can identify a device correctly 2021-11-30 23:00:45 +00:00
			`![ATAPI CD-ROM Identification](screenshots/CD-ROM_Identify.png) \`
			`Correctly identified our ATAPI device 🎉`

Added FAT-16 screenshot 2022-03-12 16:04:38 +00:00			`![Reading Files from FAT-16](screenshots/ReadingFilesFromFAT16.png) \`
We can now open and read files on the harddisk through a messy virtual filesystem The uri has to contain 8.3 filenames for now as I have not yet figured out how to convert from that to regular filenaming for the name comparison. reading files is still limited to 1 sector 2023-02-26 12:44:41 +00:00			`Reading a FILE from a FAT-16 Formatted drive`
End of the day cleanup. * Added symbol files to .gitignore * Improved text in #PG and #GP handlers * Added the printing of the multiboot structure address and the magic value * Added page fault screenshot to readme 2022-08-18 23:05:10 +00:00
Updated README.md, Moved planning to TODO.md 2021-05-03 00:22:12 +00:00			`________________________`
Initial setup, Basic helloworld kernel from wiki.osdev.org bare bones 2021-05-02 16:02:00 +00:00
			`### The goal`
Basic block allocation for physical memory allocation. - 1 block = 4096 bytes : because this will make page fault handling possibly somewhat easier - 1 byte in the bitmap = 8 blocks of physical memory unsure if the allocation is perfect ... guess i'll find out some day if this is actually correct. The bitmap needs 16kb to keep track of 2gb of physical memory. Seems a decent percentage to me. 2022-02-26 19:44:16 +00:00			`Writing a hobby operating system to better understand the basic building blocks of any operating system.Initially I'd like for my`
			`operating system to be able to run bash.`
Initial setup, Basic helloworld kernel from wiki.osdev.org bare bones 2021-05-02 16:02:00 +00:00
Updated README.md, Moved planning to TODO.md 2021-05-03 00:22:12 +00:00			`________________________`
			`### Operating System Technical specs/details`
			`The operating system can print strings to the`
			`screen. The terminal/screen has scrolling so the latest messages are visible on the screen.`
Initial setup, Basic helloworld kernel from wiki.osdev.org bare bones 2021-05-02 16:02:00 +00:00
Updated README.md, Moved planning to TODO.md 2021-05-03 00:22:12 +00:00			`________________________`
			`### Planning`
Small changes to reflect renaming in readme.md 2021-11-22 19:04:14 +00:00			`[See TODO](todo.md) \`
			`[See Features](features.md)`
Updated README.md, Moved planning to TODO.md 2021-05-03 00:22:12 +00:00			`________________________`
			`### Docs`
			`[Intro](docs/Intro.md) \`
			`[Manuals](docs/Manuals.md) \`
			`[Project structure](docs/ProjectStructure.md)`
			`________________________`
Initial setup, Basic helloworld kernel from wiki.osdev.org bare bones 2021-05-02 16:02:00 +00:00			`### Resources:`

Updated README.md, Moved planning to TODO.md 2021-05-03 00:22:12 +00:00			`#### General kernel stuff`
Initial setup, Basic helloworld kernel from wiki.osdev.org bare bones 2021-05-02 16:02:00 +00:00			`[wiki.osdev.org/Main_Page](wiki.osdev.org/Main_Page)`

			`[Modern Operating Systems [book]](https://www.amazon.com/Modern-Operating-Systems-Tanenbaum-Andrew/dp/1292061421/ref=sr_1_1?__mk_nl_NL=%C3%85M%C3%85%C5%BD%C3%95%C3%91&dchild=1&keywords=Modern+Operating+systems&qid=1619967779&sr=8-1)`
added new resource, removed build.sh, make can do everyting now 2021-05-02 19:53:31 +00:00
Updated README.md, Moved planning to TODO.md 2021-05-03 00:22:12 +00:00			`[whiteheadsoftware.dev](https://whiteheadsoftware.dev/operating-systems-development-for-dummies/)`

			`#### More specific stuff`
			`[VFS explained: science.unitn.it](https://www.science.unitn.it/~fiorella/guidelinux/tlk/node102.html)`

added new resource, removed build.sh, make can do everyting now 2021-05-02 19:53:31 +00:00