A_A _ MOS Real-Time Operating System
o'' )_____// Simple RTOS on Cortex-M
`_/ MOS ) Developed with C/C++, Tested on Renode
(_(_/--(_/ [Apache License Version 2.0]
- Run
git submodule init && git submodule update
to pull the submodules. - Install
arm-none-eabi-gcc
toolchain. - Install EIDE plugin, open
*.code-workspace
withVSCode
, and runBuild
script to compile. - Install Renode emulation platform, and add
renode
to/usr/bin
path. - Run
./run.sh emulation/*.resc
to start the emulation, types
to start, andq
to quit. - Open a
TCP
connection tolocalhost:3333/3334
and observe the serial output.
- 用户手册(中文) | [Manual(English)](translation in progress)
.
├── 📁 emulation // Renode emulation script
├── 📁 vendor // Vendor HAL (SPL/HAL/LL/...)
├── 📁 core
│ ├── 📁 arch // Architecture-Specific Code
│ │ └── cpu.hpp // Initialization/Context Switching
│ │
│ ├── 📁 kernel // Kernel Layer (Architecture-Independent)
│ │ ├── macro.hpp // Kernel Constants Macro
│ │ ├── type.hpp // Basic Types
│ │ ├── concepts.hpp // Type Constraints (Optional)
│ │ ├── data_type.hpp // Basic Data Structures
│ │ ├── alloc.hpp // Memory Management
│ │ ├── global.hpp // Kernel Layer Global Variables
│ │ ├── printf.h/.c // Thread-Safe printf (Reference Open Source Implementation)
│ │ ├── task.hpp // Task Control
│ │ ├── sync.hpp // Synchronization Primitives
│ │ ├── scheduler.hpp // Scheduler
│ │ ├── ipc.hpp // Inter-Process Communication
│ │ └── utils.hpp // Other Utilities
│ │
│ ├── config.h // System Configuration
│ ├── kernel.hpp // Kernel Modules
│ └── shell.hpp // Shell Command Line
│
└── 📁 app // User Code
├── main.cpp // Entry Function
└── test.hpp // Test Code
Mutex Test(Priority Ceiling Protocol)
LCD Driver & GUI Demo
Concurrent Task Period & Time Sequence
// MOS Kernel & Shell
#include "mos/kernel.hpp"
#include "mos/shell.hpp"
// HAL and Device
#include "drivers/stm32f4xx/hal.hpp"
#include "drivers/device/led.hpp"
namespace MOS::User::Global
{
using namespace HAL::STM32F4xx;
using namespace Driver::Device;
using namespace DataType;
// Shell I/O UART and Buffer
auto& stdio = STM32F4xx::convert(USARTx);
DataType::SyncRxBuf_t<16> io_buf;
// LED red, green, blue
Device::LED_t leds[] = {...};
}
namespace MOS::User::BSP
{
using namespace Driver;
using namespace Global;
void LED_Config()
{
for (auto& led: leds) {
led.init();
}
}
void USART_Config()
{
stdio.init(9600-8-1-N)
.rx_config(PXa) // RX -> PXa
.tx_config(PYb) // TX -> PYb
.it_enable(RXNE) // Enable RXNE interrupt
.enable(); // Enable UART
}
...
}
namespace MOS::User::App
{
Sync::Barrier_t bar {2}; // Set Barrier to sync tasks
void led1(Device::LED_t leds[])
{
bar.wait();
for (auto _: Range(0, 20)) {
leds[1].toggle(); // green
Task::delay(250_ms);
}
kprintf(
"%s exits...\n",
Task::current()->get_name()
);
}
void led0(Device::LED_t leds[])
{
Task::create(
led1,
leds,
Task::current()->get_pri(),
"led1"
);
bar.wait();
while (true) {
leds[0].toggle(); // red
Task::delay(500_ms);
}
}
...
}
int main()
{
using namespace MOS;
using namespace Kernel;
using namespace User;
using namespace User::Global;
BSP::config(); // Init hardware and clocks
Task::create( // Create Calendar with RTC
App::time_init, nullptr, 0, "time/init"
);
Task::create( // Create Shell with buffer
Shell::launch, &stdio.buf, 1, "shell"
);
/* User Tasks */
Task::create(App::led_init, &leds, 2, "led/init");
...
/* Test examples */
Test::MutexTest();
Test::MsgQueueTest();
...
// Start scheduling, never return
Scheduler::launch();
}
A_A _ Version @ x.x.x(...)
o'' )_____// Build @ TIME, DATE
`_/ MOS ) Chip @ MCU, ARCH
(_(_/--(_/ 2023-2024 Copyright by Eplankton
Tid Name Priority Status Mem%
----------------------------------------
#0 idle 15 READY 10%
#1 shell 1 BLOCKED 21%
#2 led0 2 RUNNING 9%
----------------------------------------
📦 v0.1
✅ Done:
- Basic data structures, scheduler, and task control, memory management
📌 Planned:
- Timers, round-robin scheduling
- Inter-Process Communication (IPC), pipes, message queues
- Process synchronization (Sync), semaphores, mutexes
- Porting a simple Shell
- Variable page sizes, memory allocator
- SPI driver, porting GuiLite/LVGL graphics libraries
- Porting to other boards/arch, e.g., ESP32-C3 (RISC-V)
📦 v0.2
✅ Done:
- Synchronization primitives
Sync::{Sema_t, Lock_t, Mutex_t<T>, CondVar_t, Barrier_t}
Scheduler::Policy::PreemptPri
with round-robinRoundRobin
scheduling for same priority levelsTask::terminate
implicitly called upon task exit to reclaim resources- Simple command-line interaction
Shell::{Command, CmdCall, launch}
HAL::STM32F4xx::SPI_t
andDriver::Device::ST7735S_t
, porting theGuiLite
graphics library- Blocking delay with
Kernel::Global::os_ticks
andTask::delay
- Refactored project organization into
{kernel, arch, drivers}
- Support for
GCC
compilation, compatible withSTM32Cube HAL
- Real-time calendar
HAL::STM32F4xx::RTC_t
,CmdCall::date_cmd
,App::Calendar
idle
usesKernel::Global::zombie_list
to reclaim inactive pages- Three basic page allocation policies
Page_t::Policy::{POOL, DYNAMIC, STATIC}
📦 v0.3
✅ Done:
- Mapping
Tids
toBitMap_t
- Message queue
IPC::MsgQueue_t
Task::create
allows generic function signatures asvoid fn(auto argv)
with type checker- Added
ESP32-C3
as aWiFi
component- Added
Driver::Device::SD_t
,SD
card driver, portingFatFs
file system- Added
Shell::usr_cmds
for user-registered commands- [Experimental] Atomic types
<stdatomic.h>
- [Experimental]
Utils::IrqGuard_t
, nested interrupt critical sections- [Experimental] Simple formal verification of
Scheduler + Mutex
📌 Planned:
- Inter-Process Communication: pipes/channels
FPU
hardware float support- Performance benchmarking
- Error handling with
Result<T, E>
,Option<T>
DMA_t
DMA Driver- Software/hardware timers
Timer
- [Experimental] Adding
POSIX
support- [Experimental] Asynchronous stackless coroutines
Async::{Future_t, async/await}
- [Experimental] More real-time scheduling algorithms
📦 v0.4
✅ Done:
- Shift to run
Renode
emulation platform, stable support forCortex-M
series- [Experimental] Add scheduler lock
Scheduler::suspend()
- How to build a Real-Time Operating System(RTOS)
- PeriodicScheduler_Semaphore
- STM32F4-LCD_ST7735s
- A printf/sprintf Implementation for Embedded Systems
- GuiLite
- STMViewer
- FatFs
- The Zephyr Project
- Eclipse ThreadX
- Embassy
- Renode
There's a movie on TV.
Four boys are walking on railroad tracks...
I better go, too.