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 →
Pixel Pets

Pixel Pets

Pixel Pets is an open-source virtual pet ecosystem built for the M5Stack hardware family, featuring interactive digital companions with adaptive behaviors. It utilizes FreeRTOS for task management and the M5Unified library for hardware abstraction, supporting advanced features like ESP-NOW inter-device communication, offline LLM-based voice control, and real-time environment syncing. The project targets various ESP32 platforms including the CoreS3, Core2, and M5StickC PLUS2.

freertos littlefslwip
ESP32 Bit Pirate

ESP32 Bit Pirate

ESP32 Bit Pirate is an open-source firmware that transforms ESP32-S3 development boards into multi-protocol hardware hacking tools. It provides extensive support for digital protocols like I2C, SPI, and UART, as well as radio communications including Wi-Fi, Bluetooth, and Sub-GHz, utilizing FreeRTOS and LittleFS for robust device interaction.

freertos littlefslwipnimble

ClaudeGauge

A real-time AI usage monitor for Anthropic's Claude API, featuring an LCARS-inspired Star Trek interface. Built for ESP32-S3 and ESP32-C6 hardware, it tracks token costs, rate limits, and Claude.ai subscription status using a custom UI engine and cloud proxy.

freertos tft-espi
ESPHome Plant Watering

ESPHome Plant Watering

An automated irrigation system built with ESPHome for the M5Stack AtomS3-Lite and Unit Watering modules. It supports up to six plants via I2C expansion and features moisture-based automation and safety limits through Home Assistant integration.

freertos platformio-platformio-core
BETTA HA Panel

BETTA HA Panel

BETTA HA Panel is a runtime-configurable Home Assistant dashboard firmware for ESP32-P4 and ESP32-S3 touchscreen devices. Built on the ESP-IDF framework using LVGL and LittleFS, it allows users to design complex, multi-page layouts via a web-based drag-and-drop editor without requiring YAML configuration or firmware rebuilds.

freertos littlefslvgllwip
Xiaozhi AI Desk Buddy (ESP32-S3)

Xiaozhi AI Desk Buddy (ESP32-S3)

An expressive AI desk companion based on the Seeed Xiao ESP32-S3 that features a fully animated face system. It utilizes the ESP-IDF framework with FreeRTOS, LVGL for rendering display interfaces, and SPIFFS for asset storage. The project integrates I2S audio components for listening and speaking capabilities, creating a dynamic interactive experience.

freertos lvglspiffs

High-Fidelity ESP32 Bluetooth Audio Sink with Premium Codecs

An advanced Bluetooth audio receiver firmware for ESP32 that supports high-resolution codecs including LDAC, aptX HD, and AAC. Built on ESP-IDF v5.5.2, it features real-time DSP audio enhancement, integrated LED matrix visualization, and BLE-based remote control.

freertos lwip
Multi-Firmware-ESP

Multi-Firmware-ESP

A custom bootloader for the ESP32 that enables switching between multiple firmware versions using hardware switches. It integrates Over-The-Air (OTA) update capabilities and the ESP-Serial-Flasher library to facilitate remote firmware management and master-slave device flashing.

freertos lwip