Skip to content

book

Directory actions

More options

Directory actions

More options

Latest commit

 

History

History

book

README.md

EmbeddedOS: The Complete Guide

From Bootloader to Browser, Kernel to Space

Figure: EoS — 3D SoC Chip Visualization

Author: Srikanth Patchava & EmbeddedOS Contributors Version: 1.0 (April 2026) License: CC BY-SA 4.0

"One unified platform from bootloader to browser, from microcontroller to orbit."

About the Author

Srikanth Patchava is the creator and lead architect of EmbeddedOS, an open-source embedded operating system ecosystem spanning 18 repositories. With deep expertise in embedded systems, real-time operating systems, hardware design, AI inference, and full-stack development, Srikanth designed EoS to be a universal platform supporting 41 product categories across automotive, aerospace, medical, consumer, and industrial domains.

About This Book

This book is the official, comprehensive reference for the entire EmbeddedOS ecosystem. It covers:

  • EoS — the core embedded operating system (kernel, HAL, services, drivers)
  • eBoot — the secure bootloader
  • ebuild — the build system
  • eIPC — inter-process communication
  • eAI — embedded AI/ML inference
  • eNI — neural interface & BCI
  • eApps — application marketplace
  • EoSim — multi-architecture simulation
  • EoStudio — cross-platform design suite
  • eDB — unified database
  • eBrowser — embedded web browser
  • eOffice — office suite
  • eVera — AI virtual assistant
  • eStocks — algorithmic trading
  • eHealth365 — wearable health monitoring hardware
  • ePAM — personal air mobility hardware
  • eRadar360 — automotive radar hardware

Whether you are building a smartwatch, a medical device, an autonomous drone, or a space vehicle, this book provides everything you need.

Table of Contents

Part I — Foundations

  1. Introduction to EmbeddedOS

    • What is EmbeddedOS?
    • The 18-repository ecosystem
    • Architecture overview
    • Who should read this book

  2. Getting Started

    • Prerequisites and tool installation
    • Building EoS from source
    • Your first "Hello World" on host, STM32, RPi4, nRF52
    • Understanding product profiles

  3. Architecture & Design Philosophy

    • Layered architecture (HAL → Kernel → Services → Apps)
    • The product profile system (41 profiles)
    • Cross-platform portability strategy
    • Standards compliance (ISO 26262, DO-178C, IEC 61508)

Part II — Kernel & HAL

  1. Hardware Abstraction Layer

    • The 33 peripheral interfaces
    • GPIO, UART, SPI, I2C, Timer
    • Backend dispatch pattern
    • Writing a custom HAL backend

  2. Extended HAL — Advanced Peripherals

    • ADC, DAC, PWM, CAN, USB
    • WiFi, BLE, Cellular, NFC
    • Camera, Audio, Display, GPU
    • IMU, GNSS, Radar, Motor
    • The vtable dispatch pattern

  3. RTOS Kernel

    • Task management & scheduling
    • Mutex, semaphore, message queues
    • Software timers
    • Priority inversion protection
    • Real-time guarantees

  4. Multicore — SMP & AMP

    • Core management & identification
    • Spinlocks (architecture-aware: ARM, x86, RISC-V)
    • Memory barriers & atomics
    • Inter-processor interrupts (IPI)
    • Shared memory regions
    • Task migration & affinity
    • Remote processor management

  5. Driver Framework

    • Driver probe/remove lifecycle
    • Power management hooks
    • Device tree integration
    • Writing your first driver

Part III — Services

  1. Cryptography

    • SHA-256, SHA-512 (full implementation)
    • AES encryption
    • RSA signing & verification (big-integer arithmetic)
    • ECDSA P-256 (elliptic curve)
    • CRC checksums

  2. Security

    • Keystore & key management
    • Access control lists (ACL)
    • Secure boot chain
    • Integrity monitoring
    • Audit logging

  3. Networking

    • TCP/UDP sockets
    • HTTP client/server
    • MQTT client
    • mDNS service discovery
    • TLS integration

  4. Filesystem & Storage

    • Flash filesystem
    • File operations API
    • Wear leveling
    • Secure storage

  5. OTA Updates

    • Update lifecycle
    • Delta updates
    • Rollback protection
    • Secure update verification

  6. Sensor & Motor Services

    • Sensor framework (register, read, calibrate)
    • Motor control with PID
    • Sensor fusion patterns

  7. Compatibility Layers

    • POSIX (threads, sync, signals, I/O)
    • VxWorks (tasks, semaphores, watchdog, message queues)
    • Linux IPC (D-Bus bridge, shared memory)

  8. UI Framework

    • LVGL integration
    • Touch input handling
    • Display rendering
    • Building a watchface

Part IV — The Ecosystem

  1. eBoot — Secure Bootloader

    • Stage 0 / Stage 1 boot flow
    • Ed25519 signature verification
    • Board support (24+ boards)
    • Secure boot chain integration

  2. ebuild — Build System

    • CLI commands
    • Build configuration (YAML)
    • Cross-compilation toolchains
    • SDK generation
    • CI/CD integration

  3. eIPC — Inter-Process Communication

    • The EIPC protocol (Go + C)
    • HMAC authentication
    • Service discovery
    • Pub/sub messaging
    • Chat & completion handlers

  4. eAI — Embedded AI

    • AI framework architecture
    • Model loading & inference (EAIM binary format)
    • TFLite Micro integration
    • Secure boot for AI models
    • BCI device integration (OpenBCI)
    • On-device LLM (llama.cpp)

  5. eNI — Neural Interface

    • EEG signal acquisition
    • DSP pipeline (Welch's PSD, band power)
    • ONNX model inference
    • Intent decoding
    • Wireless BCI (BlueZ BLE)
    • Python SDK

  6. EoSim — Simulation Platform

    • QEMU integration (QMP, GDB)
    • Native peripheral simulation
    • State bridge architecture
    • Multi-architecture support (52+ platforms)

  7. EoStudio — Design Suite

    • Platform backends (Tkinter, Web, EoS)
    • 12 specialized editors
    • WebSocket remote rendering
    • LLM integration

Part V — Hardware Products

  1. eRadar360 — Automotive Radar

    • System architecture
    • 10-layer hybrid PCB design
    • Antenna design
    • Power sequencing
    • Manufacturing & bring-up

  2. eHealth365 — Health Monitoring

    • Two-device system (Smart Ring Pro + Smart Patch Pro)
    • Sensor specifications (PPG, CGM, sweat biosensor, bioimpedance)
    • 3D model specifications
    • Monthly blood cartridge system
    • 24-hour sensing schedule
    • Mobile app architecture
    • Battery optimization
    • Business plan & go-to-market

  3. ePAM — Personal Air Mobility

    • Four-vehicle product line
    • Eco Car (solar-hybrid ground vehicle)
    • Urban Drone (eVTOL)
    • Space Shuttle (suborbital) + ULP-SSN avionics
    • Combo Unit (trans-atmospheric)
    • Power architecture (solar + H2 + battery + regen)
    • Tesla-like mobile app
    • Manufacturing cost analysis
    • Regulatory path (FAA, EASA, AST)

Part VI — Applications & Tools

  1. eApps — Marketplace

    • 43 applications
    • App lifecycle management
    • Cross-platform deployment
    • Marketplace API

  2. eDB — Database

    • Multi-model database architecture
    • CLI commands
    • Query engine
    • Embedded vs. server modes

  3. eBrowser — Web Browser

    • Browser engine architecture
    • Platform abstraction layer
    • HTML/CSS/JS rendering
    • Embedded device optimization

  4. eOffice — Office Suite

    • 11 productivity applications
    • Desktop (Electron) architecture
    • Document format support

  5. eVera — AI Assistant

    • 24+ specialized agents
    • 183+ tools
    • 3D avatar (Three.js)
    • Voice control (3 modes, 19 languages)
    • Plugin architecture
    • Cross-platform (Electron, React Native, web)

  6. eStocks — Trading System

    • 15 trading strategies
    • 7-layer risk management
    • Backtesting engine
    • Production safety controls
    • Platform integrations (TradingView, IBKR, thinkorswim)

Part VII — Advanced Topics

  1. Cross-Compilation & Toolchains

    • AArch64, ARM hard-float, RISC-V
    • Custom toolchain files
    • Multi-architecture CI/CD

  2. Testing & Quality

    • Unit testing framework
    • Fuzz testing
    • Sanitizers (ASan, UBSan)
    • Valgrind memory checking
    • CI/CD pipeline architecture

  3. Safety & Compliance

    • ISO 26262 (automotive)
    • DO-178C (aerospace)
    • IEC 61508 (industrial)
    • IEC 62304 (medical)
    • Quality management system

  4. Contributing to EmbeddedOS

    • Development workflow
    • Coding standards
    • Pull request process
    • Community guidelines

Appendices

How to Build This Book

Read Online

Visit: https://embeddedos-org.github.io/eos/book/

Build Locally (mdBook)

# Install mdBook
cargo install mdbook

# Build the book
cd docs/book
mdbook build

# Serve locally with live reload
mdbook serve --open

Generate PDF

# Install pandoc + LaTeX
sudo apt-get install pandoc texlive-xetex texlive-fonts-recommended

# Generate PDF from markdown
cd docs/book
./generate-pdf.sh
# Output: embeddedos-complete-guide.pdf

Conventions Used in This Book

  • code — function names, file paths, commands
  • Bold — key terms on first introduction
  • Italic — emphasis
  • eos_ prefix — all EoS public API functions
  • Code blocks with filename headers show source file locations

Copyright (c) 2026 Srikanth Patchava & EmbeddedOS Contributors. Licensed under CC BY-SA 4.0.