# MiniOS_PendSV

**Repository Path**: zchhacker/MiniOS_PendSV

## Basic Information

- **Project Name**: MiniOS_PendSV
- **Description**: MiniOS_PendSV
- **Primary Language**: C
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-11-24
- **Last Updated**: 2025-12-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# MiniOS PendSV

MiniOS PendSV is a lightweight, real‑time operating system (RTOS) inspired by FreeRTOS, targeting **ARM Cortex‑M4/M7** (and Windows simulation). It now includes:

- **Task Scheduler** (`xTaskCreate`, `vTaskStartScheduler`, `vTaskDelay`, `vTaskDelayUntil`)
- **Inter‑Task Queue** (`xQueueCreate`, `xQueueSend`, `xQueueReceive`)
- **Software Timer Service** (`xTimerCreate`, `xTimerStart`, `xTimerStop`, `xTimerChangePeriod`)
- **Event Groups** (`xEventGroupCreate`, `xEventGroupSetBits`, `xEventGroupWaitBits`)
- **Custom 8‑byte‑aligned Heap** (`MiniOS_Malloc`, `MiniOS_Free`)
- **Debug Trace** (`MINIOS_DEBUG`)

## 📚 Documentation

The documentation is organized in the `docs/` folder:

| Manual | Description |
|--------|-------------|
| **[Architecture Manual](docs/ARCHITECTURE.md)** | System layers, core modules, runtime flow (PlantUML), data structures, example usage. |
| **[Build & Run Guide](docs/BUILD.md)** | How to compile with `arm-none-eabi-gcc` or run the Windows simulation. |
| **[Configuration Guide](docs/CONFIGURATION.md)** | Feature switches, SMP/AMP settings, stack/heap configuration. |
| **[Porting Guide](docs/PORTING.md)** | Steps to port MiniOS to a new Cortex‑M/A chip, hardware hooks, multi‑core considerations, and a checklist that now includes Event Groups and Software Timers. |
| **[ARM Quick Start](docs/ARM_QUICKSTART.md)** | End‑to‑end example for STM32F4 (or similar) hardware. |

## 🚀 Quick Start (Windows Simulation)

```bash
# 1. Build
make build

# 2. Run
./build/bin/main.exe
```

## 📂 Project Structure

```
MiniOS_PendSV/
├─ core/          # Kernel (tasks, queues, timers, event groups, heap, list)
├─ hal/           # Hardware Abstraction Layer (ARM Cortex‑M4/M7, Windows shim)
├─ app/           # Sample application (demonstrates queue, timer, event group)
├─ utils/         # Debug trace utilities
└─ docs/          # Documentation
```

---
*Generated on 2025‑12‑02.*