XTOS / OPEN SOURCE REAL-TIME SYSTEMOPEN SOURCE · 1.0.2 · PRERELEASE · IMAGES & SOURCE

System Architecture

From the real-time kernel and SDKs to data processing and application services, supporting AI and Super Intelligence research applications.

Current prerelease: OpenXTOS 1.0.2 · Source c24e9237

XTOS system architecturex86_64 · ARM64; RISC-V64 source / CI only

Applications & integrations

Data consumers and model integration

BCI analysis & feedback · medical research · edge AI inference

User space

BusyBox + initramfs

Data plane

eeg-streamFrames → windows → mean / RMS · hardware acquisition unverified
Offline inputCSV fixtures → EEG pipeline (bypasses device drivers)
EEG pipelineCSV → filters / features · SPSC queue
Signal toolsBenchmarks · replay validation

Public SDK

libxtos-bciDevice sessions · read · configure
libxtos-signalFFT · filters · feature extraction
libxtos-rtScheduling · affinity · SPSC
Kernel / user-space boundary
/dev/xtos0read / ioctl · Character-device access
Signal processing stays in user space
sched_* / mlockScheduling & memory setup

Real-time kernel

Linux 7.3.1
PREEMPT_RT
BCI frameworkCharacter devices · ring buffersxtos_bci_core / xtos_bci_buffer
OpenBCI driverSerial input · packet parsingopenbci_cyton
Linux scheduling & memoryRT preemption · affinity · locked pagesPREEMPT_RT / sched_* / mlock
XTOS scheduling helperOptional kernel integration; not a Linux scheduler replacementxtos_sched

Devices & inputs

Hardware bring-up pending
OpenBCI CytonSerial sample input
Acquisition device configurationApplication → libxtos-bci → ioctl → BCI framework → Cyton driver → device readback

eeg-stream uses xtos_bci_frame_read to process integer frames into window features. The CSV pipeline calls the signal library and SPSC queue. User-space tools also provide direct TTY capture. Applications select models and feedback policies; physical acquisition and control loops still need validation.

xtos_bci_read_samples converts int32 nanovolts to float microvolts; frames retain integer nanovolts. Legacy mmap returns EOPNOTSUPP. Snapshots use ioctl acquisition, read-only mmap, then explicit consumption and release. Cyton supports gain configuration and readback, but not calibration or impedance. Frame timestamps describe host reception.

SPSC queues run in user space; queue use does not imply scheduler calls. This diagram expands source-level calls, not every architecture’s tool inventory. Release artifacts are the x86_64 BIOS/UEFI ISO and ARM64 QEMU virt boot bundle; RISC-V64 has source / CI support only. QEMU results do not establish physical connectivity, latency, or jitter.
Samples and resultsConfiguration and calls

Core components

The kernel handles scheduling and devices, SDKs expose C interfaces, and user-space tools process data and run services.

Kernel Space

Linux PREEMPT_RT, the BCI framework, and device drivers form the kernel base. The XTOS scheduling helper is optional and does not replace the Linux scheduler.

User Space

Core provides BusyBox, acquisition streams, and signal tools. Developer Live separately assembles AI services, networking, update, and application-package tools. The profiles are delivered separately.

SDK Layer

Three libraries expose real-time setup, signal processing, and device sessions. libxtos-rt uses standard Linux sched_* / mlock calls; BCI reads convert nanovolts to microvolts.

Profiles and delivery

Public core images, Developer Live, and application integration have distinct contents. Choose the matching download or build profile.

Public core

The v1.0.2 prerelease provides an x86_64 BIOS/UEFI installer ISO, ARM64 QEMU virt boot bundle, corresponding source, and checksums. It includes the real-time kernel, BCI / signal SDKs, and native acquisition tools. ARM64 validation is QEMU-only.

Developer Live

Developer builds can assemble local ONNX inference, device plugins, XR tools, and system-management commands. update downloads and verifies update bundles; pkg manages application packages. AI runtimes and providers follow explicit build configuration. This profile is separate from the public core images.

Applications and target devices

Applications select data windows, models, and feedback policies. Existing acquisition adapters and inference components support integration; physical devices, model accuracy, GPU operation, and end-to-end latency still require target-specific validation. RISC-V64 has source / CI support only in this release.

Data and call paths

Device acquisition, frame processing, and offline replay use their respective interfaces. Configuration calls follow the dashed paths in the system map back to the device.

Kernel BCI path

Cyton driver → BCI framework → libxtos-bci → eeg-stream. Frames retain integer nanovolts and host-receive timestamps; windows produce mean and RMS features.

Serial and offline input

User-space tools can also capture directly through a TTY. Recorded captures can be replayed as CSV for the EEG pipeline, which uses libxtos-signal and the libxtos-rt SPSC queue.

Control and data access

ioctl handles configuration, start/stop, and data access. XTOS_BCI_FRAME_READ reads frames; snapshot interfaces manage snapshots. Models and application feedback are integrated separately; physical control loops require validation.

Modules and build profiles

Module membership across core images, Developer Live, and source support. The connected system map above shows component calls and data flow.

Modules and build profilesOpenXTOS v1.0.2

Applications

Developers choose models, data, and feedback policies

ApplicationBCI analysisAcquisition analysis and research workflows
ApplicationEdge AI inferenceApplication models and logic
ApplicationFeedback and controlApplication integration and target-device validation

Services and tools

Core and Developer Live use separate build profiles

Public coreAcquisition and signal toolseeg-stream · x86_64: EEG pipeline / bci
Developer LiveLocal AI servicextos-ai-runtime · ONNX · AF_UNIX
Developer LiveSystem managementrt · net · fw · update · pkg

User-space SDK

Public C interfaces for applications and tools

Public corelibxtos-bciSessions · configuration · frame / snapshot
Public corelibxtos-signalFilters · FFT · window features
Public corelibxtos-rtScheduling setup · locked memory · SPSC queues

Kernel and drivers

Linux 7.3.1 · PREEMPT_RT

Public coreLinux scheduling and memorysched_* · CPU affinity · mlock
Public coreBCI framework and driversxtos_bci_core · openbci_cyton
Source supportXTOS scheduling helperOptional queue helper, not a separate sched_class

Platforms and boot

Published artifacts and validation scope are distinct

Public corex86_64BIOS / UEFI installer ISO
Public coreARM64QEMU virt boot bundle
Source supportRISC-V64Build scripts and CI; no image in this release
This inventory groups modules; it is not a single-image inventory. Developer Live AI services and management tools are not included in the public core images. The system architecture diagram above shows the specific calls.