feat: partial PCIe support (MCFG table parsing)
[lunaix-os.git] / docs / README_en.md
index f00eac08b9ae6c662b7f9b050411e829b82bd670..c602fc3f2e3bc14ccc6dfc4af5439ebc96ca6eda 100644 (file)
@@ -13,7 +13,7 @@ LunaixOS - A simple (yet naive), POSIX-complaint (hopefully!), operating system
 
 This operating system is a macro-kernel, has its root in Intel's x86 platform and its ecosystem. It runs in protected mode and uses 4GiB addressing with two-level paging mechanism. It does not have x86_64 variant and does not support multi-core machine. 
 
-The memory is split into two parts, that is, 3GiB for user space (0x400000 ~ 0xBFFFFFFF) and 1GiB for kernel space (0xC0000000 ~ 0xFFFFFFFF). Such paradigm is a common practicing found in major operating systems, for example x86_32 version of Linux and Windows. For a more detailed arrangement of memory in LunaixOS, please refer to [LunaixOS Virtual Memory Mappings](docs/img/lunaix-os-mem.png).
+The virtual address space is divided into two parts, that is, 3GiB for user space (0x400000 ~ 0xBFFFFFFF) and 1GiB for kernel space (0xC0000000 ~ 0xFFFFFFFF). Such paradigm is a common practicing found in major operating systems, for example x86_32 version of Linux and Windows. For a more detailed arrangement of memory in LunaixOS, please refer to [LunaixOS Virtual Memory Mappings](img/lunaix-os-mem.png).
 
 
 The following list presents all features it does have in current stage.
@@ -25,17 +25,19 @@ The following list presents all features it does have in current stage.
 + Memory management & demand paging
 + PS/2 Keyboard support
 + Muti-tasking and task management
-+ 15 commonly used POSIX syscall([See Appendix 1](#appendix1))
++ 17 commonly used POSIX syscall([See Appendix 1](#appendix1))
 + User Space
 + Signal
++ PCI 3.0
++ PCIe 2.0 (WIP)
 
 ## Project Structure
 
 | | |
 |-----|------|
-| [lunaix-os](lunaix-os/) | LunaixOS source code |
-| [slides](slides/) | Slides used in my videos |
-| [reference-material](reference-material/)| References |
+| [lunaix-os](../lunaix-os/) | LunaixOS source code |
+| [slides](../slides/) | Slides used in my videos |
+| [reference-material](../reference-material/)| References |
 
 ## Referenced Tutorial
 
@@ -43,7 +45,7 @@ The following list presents all features it does have in current stage.
 
 Thus, the author has devoted large amount of time to go through any related materials such as technical references, manuals, textbooks, and industrial standards. To further ensure the technology used and knowledge taught is up-to-date and is coming "straight from the factory".
 
-You can find most of aforementioned materials in [reference-material](reference-material/).
+You can find most of aforementioned materials in [reference-material](../reference-material/).
 
 The following list also enumerated such materials the author has used:
 
@@ -55,6 +57,7 @@ The following list also enumerated such materials the author has used:
 + 82093AA I/O Advanced Programmable Controller (IOAPIC) (Datasheet)
 + MC146818A (Datasheet)
 + Intel 500 Series Chipset Family Platform Controller Hub (Datasheet - Volume 2)
++ PCI Local Bus Specification, Revision 3.0
 
 #### Textbook
 + *Computer System - A Programmer's Perspective Third Edition* (Bryant, R & O'Hallaron, D), a.k.a. CS:APP
@@ -65,6 +68,7 @@ The following list also enumerated such materials the author has used:
 + [OSDev](https://wiki.osdev.org/Main_Page) - For material gathering.
 + [FreeVGA](http://www.osdever.net/FreeVGA/home.htm) - For VGA references.
 + GNU CC & LD online documentation.
++ [PCI Lookup](https://www.pcilookup.com/) - For device look up
 
 #### Others
 + Linux Manual - For learning the system call behavior on real machine.
@@ -88,6 +92,8 @@ The following list also enumerated such materials the author has used:
 1. `sigprocmask(2)`
 1. `signal(2)`
 1. `kill(2)`
+1. `sigpending(2)`
+1. `sigsuspend(2)`
 
 ### Unique to LunaixOS