Introduction to FlxOS

Relevant source files

The following files were used as context for generating this wiki page:

• README.md
• ROADMAP.md
• main/core/README.md
• main/main.cpp
• main/CMakeLists.txt
• LVGL_Features.md

FlxOS is a modern, high-performance embedded operating environment designed specifically for ESP32 and ESP32-S3 microcontrollers. It leverages the ESP-IDF framework alongside LVGL 9 and LovyanGFX to provide a desktop-like user experience on resource-constrained hardware. The system is designed to be modular, supporting various applications such as smart home controllers, industrial Human-Machine Interfaces (HMI), and IoT devices with rich graphical interfaces.
Sources: README.md:1-12

The architecture of FlxOS emphasizes a separation between core system logic and user interface components, allowing for flexible deployments including a "Headless Mode" that runs without graphical hardware. This modularity is supported by a centralized Hardware Abstraction Layer (HAL) and a robust service layer that manages connectivity, file systems, and system resources.
Sources: README.md:17-43, main/main.cpp:32-48

Core System Architecture

The project is structured into a logical hierarchy that separates platform-independent logic from hardware-specific implementations. The main/core/ directory serves as the primary hub for system logic, while the hal/ directory manages hardware interactions.
Sources: main/core/README.md:3-12

System Components Overview

Component	Responsibility
System Manager	Handles hardware initialization, storage mounting, and core lifecycle.
App Manager	Manages application lifecycles including starting, stopping, pausing, and resuming.
Window Manager	Provides multi-window support and dynamic UI layouts.
Connectivity Manager	Orchestrates Wi-Fi (Station/SoftAP), Bluetooth, and networking stacks.
Task Manager	Oversees FreeRTOS-based background task scheduling and resource monitoring.
Sources: README.md:23-34, ROADMAP.md:33-47

System Initialization Flow

The system boot process begins in app_main, where the SystemManager initializes hardware and background services before launching optional UI or CLI tasks.

Technical Specifications and Capabilities

Graphics and UI Framework

FlxOS utilizes LVGL 9 and LovyanGFX for hardware-accelerated rendering. This combination enables smooth 60+ FPS animations and complex UI widgets.

• LVGL 9 Features: Reactive UI (data binding), multi-instance support via lv_global, and a CSS-like styling system.
• Layout Engines: Support for Flexbox (1D) and Grid (2D) layouts for responsive design.
• Rendering: Decoupled pipeline supporting software rendering, vector engines (ThorVG), and hardware acceleration via GPU drivers.
  Sources: README.md:25-26, LVGL_Features.md:3-35

Build Configuration and Targets

The system is built using CMake and the ESP-IDF build system. It supports multiple flash sizes and partition schemes depending on the target hardware.

Target	Flash Size	Partition File
ESP32	4MB	partitions_4mb.csv
ESP32	8MB	partitions_8mb.csv
ESP32-S3	16MB	partitions_16mb.csv
Sources: README.md:76-80

Headless Mode

FlxOS can be compiled in a "Headless" configuration. In this mode, graphical components like lvgl and LovyanGFX are excluded from the build to save resources. The system still provides connectivity (WiFi, Hotspot, Bluetooth) and background services, which can be interacted with via the CLI.
Sources: main/CMakeLists.txt:34-40, main/main.cpp:40-45

System Organization

The codebase follows strict naming and directory conventions to maintain modularity.

Directory Layout

• main/core/apps/: User-facing applications (Settings, File Manager).
• main/core/connectivity/: Networking stacks (WiFi, Bluetooth).
• main/core/services/: Background agents (Filesystem, System Info, CLI).
• main/core/system/: Core managers (Display, Power, Theme, Time).
• main/hal/: Hardware Abstraction Layer for specific display and OS implementations.
  Sources: README.md:36-47, main/core/README.md:5-11

Conclusion

FlxOS represents a robust framework for building sophisticated embedded applications on the ESP32 platform. By combining a modern UI engine with a modular service-oriented architecture, it allows developers to create high-performance devices that maintain a responsive user interface while managing complex background networking and system tasks.