FreeRTOS

202411.00
FreeRTOS is a market-leading real-time operating system kernel designed for microcontrollers and small microprocessors, featuring a small memory footprint and fast execution times. It provides a comprehensive ecosystem of libraries for IoT connectivity, security, and over-the-air updates, supporting over 40 processor architectures including ARM and RISC-V.

Features

  • Preemptive or co-operative multitasking with priority-based scheduling for deterministic performance.

  • Symmetric Multiprocessing (SMP) support for multi-core microcontroller architectures.

  • Native TCP/IP stack (FreeRTOS+TCP) with comprehensive support for both IPv4 and IPv6.

  • Integrated TLS v1.3 support via MbedTLS and WolfSSL for secure encrypted communications.

  • AWS IoT integration for Over-the-air (OTA) updates, Device Shadow, and Jobs management.

  • Support for ARMv8-M TrustZone and ARMv8.1-M PACBTI security extensions for firmware protection.

  • Lightweight IoT messaging via coreMQTT and coreMQTT Agent for shared network connections.

  • Cryptographic identity and key management through the corePKCS11 library.

  • Formal verification of software correctness for core libraries using CBMC proofs.

  • Memory Protection Unit (MPU) support for task isolation and enhanced system reliability.

  • Cellular interface library for seamless mobile network integration.

  • SNTP client for accurate network-based time synchronization across devices.

  • Support for 40+ architectures and 15+ toolchains including latest RISC-V and ARMv8-M.

  • Low power modes and tickless idle functionality for energy-efficient battery operation.

  • Trace and profiling support via Percepio View for real-time application analysis.

Architecture

FreeRTOS utilizes a microkernel design focused on providing a minimal but robust set of primitives for real-time applications. The core kernel is responsible for task management, scheduling, and inter-process communication (IPC) through queues, semaphores, and mutexes. It is designed to be highly portable, with a clear separation between the hardware-independent core and the hardware-dependent port layer. This architecture allows it to maintain a tiny memory footprint, typically around 6K to 12K bytes of ROM, depending on the architecture and configuration.

The system is highly modular, following a “kernel + libraries” approach. While the core kernel handles execution, additional functionality such as the TCP/IP stack (FreeRTOS+TCP), MQTT, and security protocols are provided as optional, loosely coupled libraries under the FreeRTOS-Plus umbrella. This design pattern ensures that developers only include the code necessary for their specific application, optimizing resource usage for constrained embedded devices.

Core Components

  • Task Scheduler: Supports preemptive, co-operative, and round-robin scheduling with priority levels.
  • IPC Primitives: Includes thread-safe queues, binary semaphores, counting semaphores, and recursive mutexes.
  • Software Timers: Allows for the execution of functions at specific times or periodic intervals.
  • Event Groups: Enables tasks to wait for combinations of events to occur.
  • Stream/Message Buffers: Optimized for task-to-task and interrupt-to-task data transfer.

Use Cases

This RTOS is ideal for:

  • Industrial Automation: Managing real-time sensor data and motor control loops with deterministic timing requirements.
  • Consumer Electronics: Powering smart home devices, wearables, and appliances that require low power consumption and small footprints.
  • Medical Devices: Providing a reliable and formally verified foundation for life-critical monitoring and diagnostic equipment.
  • IoT Gateways: Handling complex networking stacks, TLS encryption, and cloud connectivity for edge-to-cloud data routing.
  • Automotive Systems: Implementing non-safety critical telematics and infotainment systems using ARM Cortex-R or Cortex-A processors.
  • Smart Energy: Managing smart meters and grid infrastructure components that require long-term stability and remote OTA updates.

Getting Started

To begin developing with FreeRTOS, it is recommended to clone the main repository using the --recurse-submodules flag, as the kernel and supplementary libraries are maintained in separate Git submodules. Developers should start by exploring the FreeRTOS/Demo directory, which contains pre-configured projects for hundreds of hardware platforms and various compilers (GCC, IAR, Keil). These demos provide a functional baseline that includes the necessary port files and configuration headers (FreeRTOSConfig.h).

Extensive documentation is available on the official FreeRTOS website, including a Kernel Quick Start Guide and a comprehensive API Reference. For community support, developers can access the FreeRTOS Support Forums to interact with the primary developers and the broader ecosystem.

Related Projects

View All Projects →
ESP32-C5 ITS Logger

ESP32-C5 ITS Logger

A specialized V2X and ITS G5 message logger that utilizes the ESP32-C5 to capture IEEE 802.11p traffic at 5.9GHz. It supports GPS integration for synchronized time and positioning, logging raw data to SD cards or USB for analysis in Wireshark and CANalyzer.

freertos
ESP32 CYD Aquarium

ESP32 CYD Aquarium

An autonomous virtual aquarium firmware designed for the ESP32-2432S028R 'Cheap Yellow Display'. It features a stylized dot-grid renderer, simulated aquatic life, and automatic backlight adjustment using onboard sensors.

freertos littlefstft-espi
Periscope-OS (v2.0.0-SIGINT)

Periscope-OS (v2.0.0-SIGINT)

Periscope-OS is a passive 2.4GHz RF spectrum analyzer and signals intelligence tool for the M5Stack M5StickS3. It utilizes the ESP32-S3's promiscuous mode for deep packet inspection of 802.11 frames, featuring a sonar-style radar UI and IMU-based spatial tracking. The project leverages SPIFFS for telemetry logging and the M5Unified library for hardware abstraction.

freertos spiffs

esp32-tunnel

A networking library for ESP32 and ESP8266 that exposes local web servers to the public internet without port forwarding or complex cloud configurations. It leverages FreeRTOS tasks to handle background connectivity and supports multiple tunneling providers including WebSocket relays, localtunnel, and bore.

freertos
HomeTiles

HomeTiles

HomeTiles is a tile-based firmware for ESP32-P4 touch displays designed to function as a highly configurable Home Assistant dashboard. It utilizes LVGL for its touch-first UI and FreeRTOS for task management, providing features like MQTT integration, web-based drag-and-drop configuration, and on-device OTA updates. The project targets high-performance hardware including the M5Stack Tab5 and various Waveshare MIPI-DSI displays.

freertos littlefslvgl

pocket-dial

A self-contained SIP PBX designed for the ESP32-S3 that manages VoIP signaling without requiring external servers or cloud dependencies. It leverages C++17 and the ESP-IDF framework to provide a full-featured telephony environment where RTP media flows peer-to-peer, ensuring the microcontroller never becomes an audio bottleneck.

freertos lvgllwip

ESP-Hosted Open

A specialized fork of Espressif's ESP-Hosted-MCU that unlocks low-level radio capabilities typically hidden by stock firmware, including 802.11p, CSI sensing, and FTM ranging. It operates as a wireless co-processor firmware for ESP32 chips, communicating with host MCUs over SDIO using FreeRTOS, lwIP, and NimBLE.

freertos lwipnimbleopen-thread

VitalMonitor: ESP32 Portable Vital-Signs Monitor

A portable biomedical monitor built on ESP32 and FreeRTOS that tracks ECG, SpO2, temperature, and respiration. It features a validated QRS detection algorithm, local OLED visualization, and a real-time web dashboard for remote patient monitoring.

freertos lwip