[REFRACTOR] Transform OpenOS into Modular Research Kernel Architecture (OpenOS-RK)

.gitignore

@@ -6,6 +6,10 @@ iso/
 *.elf
 *.iso
 *.img
+benchmarks/pipeline_vs_single
+
+# Rust build artifacts
+drivers/config/target/
 
 # Temporary files
 *~

BOOT_FIX_SUMMARY.md

@@ -0,0 +1,84 @@
+# Boot Disk Loading Error and Compilation Warning Fix Summary
+
+## Issues Fixed
+
+### 1. Compilation Warning in kernel/panic.c
+**Problem:** The `line` parameter in `kernel_panic_ext()` function was unused, causing a compilation warning:
+```
+kernel/panic.c:26:66: warning: unused parameter 'line' [-Wunused-parameter]
+```
+
+**Root Cause:** The function signature included a `line` parameter for displaying line numbers in panic messages, but this functionality was not implemented because it requires `sprintf()`, which is not yet available in the kernel.
+
+**Solution:** Added `(void)line;` cast at the beginning of the function to explicitly mark the parameter as intentionally unused, along with a comment explaining why.
+
+**Changes Made:**
+- `kernel/panic.c`: Added explicit unused parameter marking with explanatory comment
+
+**Result:** Clean compilation with no warnings related to unused parameters.
+
+---
+
+### 2. QEMU Boot Disk Loading Error
+**Problem:** During QEMU boot, the system was attempting to boot from Hard Disk and Floppy devices before finally booting from the CD-ROM. This caused failed boot attempts and a delayed boot process.
+
+**Root Cause:** 
+- QEMU's default boot order attempts to boot from floppy (a) and hard disk (c) before trying CD-ROM (d)
+- The GRUB configuration file did not explicitly specify the boot device
+- The QEMU command line did not specify a boot order
+
+**Solution:** 
+1. Updated `grub.cfg` to explicitly set the root device to CD-ROM using standard GRUB device syntax
+2. Modified QEMU invocation to use `-boot d` flag, which forces CD-ROM as the first boot device
+3. Applied the fix consistently across all boot methods
+
+**Changes Made:**
+- `grub.cfg`: Added `set root='(cd0)'` to explicitly specify CD-ROM as boot device using proper GRUB device syntax
+- `tools/run-qemu.sh`: Added `-boot d` flag to QEMU command
+- `Makefile`: Updated `run-iso` target to include `-boot d` flag
+
+**Result:** QEMU now boots directly from CD-ROM without attempting to boot from other devices first, eliminating the boot disk loading errors.
+
+---
+
+## Testing Performed
+
+1. **Clean Build:** Verified kernel builds without compilation warnings
+   ```bash
+   make clean && make
+   ```
+   Result: No warnings about unused parameters
+
+2. **ISO Creation:** Successfully created bootable ISO image
+   ```bash
+   make iso
+   ```
+   Result: 12MB ISO file created successfully with proper GRUB configuration
+
+3. **Boot Order:** Verified QEMU boot configuration includes explicit CD-ROM boot order
+
+---
+
+## Technical Details
+
+### QEMU Boot Order Flag
+The `-boot d` flag tells QEMU to boot from the CD-ROM drive first:
+- `a` = floppy disk
+- `c` = first hard disk  
+- `d` = CD-ROM drive
+
+Without this flag, QEMU defaults to trying `a`, then `c`, then `d`, causing the boot errors seen in the original issue.
+
+### GRUB Root Device
+Setting `set root='(cd0)'` in grub.cfg ensures GRUB knows to look for boot files on the CD-ROM device, improving boot reliability. The parentheses syntax is the standard GRUB device notation for better compatibility across different GRUB versions.
+
+---
+
+## Files Modified
+
+1. `kernel/panic.c` - Fixed unused parameter warning
+2. `grub.cfg` - Added explicit root device specification
+3. `tools/run-qemu.sh` - Added boot order flag
+4. `Makefile` - Updated run-iso target with boot order flag
+
+All changes are minimal and surgical, addressing only the specific issues without modifying unrelated functionality.

CONTRIBUTING.md

@@ -105,7 +105,7 @@ Before submitting a pull request:
 We welcome contributions in:
 
 - **Bug Fixes**: Fix issues in existing code
-- **Features**: Implement items from the roadmap (see docs/roadmap.md)
+- **Features**: Implement items from the roadmap (see docs/roadmap/roadmap.md)
 - **Documentation**: Improve README, add tutorials, write explanations
 - **Code Quality**: Refactor code, add error checking, improve style
 - **Testing**: Add test cases, validation checks

FEATURES.md

@@ -0,0 +1,264 @@
+# OpenOS - New Features Implementation
+
+## Overview
+
+This document describes the newly implemented advanced features for OpenOS, making it a more complete and modern operating system.
+
+## Implemented Features
+
+### 1. IPC Mechanisms (Inter-Process Communication)
+
+**Location**: `include/ipc.h`, `kernel/ipc.c`
+
+OpenOS now includes two essential IPC mechanisms:
+
+#### Pipes
+- Circular buffer-based implementation
+- 4KB buffer size per pipe
+- Support for reader/writer PIDs
+- Non-blocking read/write operations
+
+**API:**
+```c
+pipe_t* pipe_create(uint32_t reader_pid, uint32_t writer_pid);
+int pipe_write(pipe_t* pipe, const void* data, size_t size);
+int pipe_read(pipe_t* pipe, void* buffer, size_t size);
+void pipe_close(pipe_t* pipe);
+```
+
+#### Message Queues
+- Fixed-size message queue (16 messages)
+- Maximum message size: 256 bytes
+- FIFO message delivery
+- Type-based message filtering support
+
+**API:**
+```c
+msg_queue_t* msgqueue_create(uint32_t owner_pid);
+int msgqueue_send(msg_queue_t* queue, uint32_t sender_pid, uint32_t type, const void* data, size_t size);
+int msgqueue_receive(msg_queue_t* queue, message_t* msg);
+void msgqueue_close(msg_queue_t* queue);
+```
+
+**Testing:**
+```
+OpenOS> test_ipc
+```
+
+### 2. Multi-core SMP Support (Symmetric Multi-Processing)
+
+**Location**: `include/smp.h`, `kernel/smp.c`
+
+Provides detection and management of multiple CPU cores:
+
+**Features:**
+- CPUID-based CPU detection
+- Support for up to 16 CPUs
+- Per-CPU data structures
+- CPU state management (ONLINE, OFFLINE, HALTED)
+- Application Processor (AP) boot support
+
+**API:**
+```c
+void smp_init(void);
+uint32_t smp_get_cpu_count(void);
+uint32_t smp_get_current_cpu(void);
+cpu_info_t* smp_get_cpu_info(uint32_t cpu_id);
+int smp_boot_ap(uint32_t cpu_id);
+```
+
+**Testing:**
+```
+OpenOS> test_smp
+```
+
+### 3. GUI/Windowing System
+
+**Location**: `include/gui.h`, `kernel/gui.c`
+
+Basic graphical user interface framework with window management:
+
+**Features:**
+- 800x600x32 framebuffer support
+- Window creation and management
+- Drawing primitives (pixels, rectangles, lines, text)
+- Window states (visible, hidden, minimized)
+- Simple window rendering with title bars
+
+**API:**
+```c
+void gui_init(void);
+window_t* gui_create_window(int x, int y, int width, int height, const char* title);
+void gui_show_window(window_t* window);
+void gui_hide_window(window_t* window);
+void gui_render_window(window_t* window);
+void gui_draw_pixel(int x, int y, uint32_t color);
+void gui_draw_rect(rect_t* rect, uint32_t color);
+void gui_draw_filled_rect(rect_t* rect, uint32_t color);
+```
+
+**Testing:**
+```
+OpenOS> test_gui
+```
+
+### 4. Networking Stack
+
+**Location**: `include/network.h`, `kernel/network.c`
+
+Basic TCP/IP networking implementation:
+
+**Features:**
+- Ethernet frame handling
+- IP header structure
+- TCP and UDP protocol support
+- Socket interface (create, bind, connect, send, receive)
+- Network device abstraction
+- Checksum calculation
+
+**Protocols Supported:**
+- ICMP (protocol 1)
+- TCP (protocol 6)
+- UDP (protocol 17)
+
+**API:**
+```c
+void net_init(void);
+socket_t* net_socket_create(uint8_t protocol);
+int net_socket_bind(socket_t* socket, uint16_t port);
+int net_socket_connect(socket_t* socket, ip_addr_t* ip, uint16_t port);
+int net_socket_send(socket_t* socket, const void* data, size_t size);
+int net_socket_recv(socket_t* socket, void* buffer, size_t size);
+```
+
+**Testing:**
+```
+OpenOS> test_net
+```
+
+### 5. Shell Scripting
+
+**Location**: `include/script.h`, `kernel/script.c`
+
+Enhanced shell with scripting capabilities:
+
+**Features:**
+- Variable storage and management (64 variables)
+- Variable substitution
+- Control flow structures (if, while, for)
+- I/O redirection support
+- Pipe creation between commands
+- Script execution from strings
+
+**API:**
+```c
+void script_init(void);
+int script_execute(const char* script);
+int script_set_var(const char* name, const char* value);
+const char* script_get_var(const char* name);
+int script_parse_if(const char* condition);
+int script_create_pipe(const char* cmd1, const char* cmd2);
+```
+
+**Default Variables:**
+- `PATH`: /bin:/usr/bin
+- `HOME`: /home
+- `PS1`: OpenOS>
+
+**Testing:**
+```
+OpenOS> test_script
+```
+
+## Build Instructions
+
+All features are integrated into the main build system:
+
+```bash
+make clean
+make
+make run
+```
+
+## Boot Sequence
+
+The kernel now initializes all subsystems in the following order:
+
+1. Console initialization
+2. IDT (Interrupt Descriptor Table)
+3. Exception handlers
+4. PIC (Programmable Interrupt Controller)
+5. Timer (100 Hz)
+6. Keyboard
+7. Filesystem (VFS)
+8. IPC mechanisms
+9. SMP support
+10. GUI framework
+11. Networking stack
+12. Shell scripting
+
+## Testing Commands
+
+Five new test commands are available:
+
+1. **test_ipc** - Tests pipes and message queues
+2. **test_smp** - Shows CPU detection and status
+3. **test_gui** - Demonstrates window creation and management
+4. **test_net** - Tests network device and socket operations
+5. **test_script** - Demonstrates variable and script execution
+
+## Architecture
+
+All new features follow the existing modular architecture:
+
+```
+OpenOS/
+├── include/           # New feature headers
+│   ├── ipc.h
+│   ├── smp.h
+│   ├── gui.h
+│   ├── network.h
+│   └── script.h
+└── kernel/            # New feature implementations
+    ├── ipc.c
+    ├── smp.c
+    ├── gui.c
+    ├── network.c
+    └── script.c
+```
+
+## Future Enhancements
+
+While these features provide a solid foundation, several areas can be expanded:
+
+### IPC
+- Add semaphores and mutexes
+- Implement shared memory
+- Add signal support
+
+### SMP
+- Implement APIC (Advanced Programmable Interrupt Controller)
+- Add per-CPU kernel stacks
+- Implement CPU affinity for processes
+
+### GUI
+- Add actual bitmap font rendering
+- Implement mouse support
+- Add GUI widgets (buttons, text boxes, etc.)
+- VBE/VESA mode detection and switching
+
+### Networking
+- Complete TCP state machine
+- Add ARP protocol
+- Implement DHCP client
+- Add packet queuing
+
+### Scripting
+- Expand parser for complex expressions
+- Add function definitions
+- Implement background jobs
+- Add command history
+
+## License
+
+MIT License - See LICENSE file for details.