Select version

CSI Lite-TUI
v0.2 RETRO TUI // M5STACK CORES3 SE

CSI Lite-TUI

A Handheld Scope for the Invisible World

Lightweight terminal UI for real-time Wi-Fi Channel State Information visualization — a portable spectral analyzer for the airwaves around you.

PROJECT OVERVIEW

Portable Spectral Analysis

CSI Lite-TUI is a lightweight terminal user interface designed for real-time Wi-Fi Channel State Information (CSI) visualization. It acts as a portable spectral analyzer, allowing users to monitor and interpret wireless signals in their immediate environment.

Real-time CSI Retro neon TUI M5Stack CoreS3 SE SD card logging On-device manual
CSI Lite-TUI handheld unit
HANDHELD UNIT
M5Stack CoreS3 SE
M5STACK CORES3 SE

Supported Hardware

The system is strictly optimized for the M5Stack CoreS3 SE IoT Controller. It utilizes the device's compact form factor, physical touch interface, and robust ESP32 processing power for field operations.

  • Touch-First Interface Physical tap controls for boot, mode selection, and in-field navigation.
  • ESP32 Processing High-frequency CSI packet capture and real-time TUI rendering on-device.
  • SD Card Edge Logging Onboard storage for raw CSV capture during deployment.

Core Features & Operations

Every visualization module in the CSI Lite-TUI stack.

The Boot Sequence BOOT

The Boot Sequence

A highly visible, zero-bloat, neon-styled retro TUI. Users initialize the radio and allocate memory by tapping START VISUALIZING.

Amplitude (Packets/Sec) AMPLITUDE

Amplitude (Packets/Sec)

A real-time graph mapping amplitude across subcarriers to highlight network congestion, heavy data transfers, and high-bandwidth anomalies.

Unwrapped Phase Offset PHASE

Unwrapped Phase Offset

Strips away noise to track physical signal properties, allowing for the detection of microscopic environmental shifts, physical movement, and multipath fading effects.

Spectral Waterfall WATERFALL

Spectral Waterfall

A scrolling color-map matrix that logs amplitude history over time — a heat map for the airwaves to track fleeting signal bursts, frequency hopping, and persistent noise floors.

Signal Strength (RSSI) & EMA RSSI

Signal Strength (RSSI) & EMA

Plots the target's aggregate power (in dBm) over time. Uses an Exponential Moving Average (EMA) to smooth environmental spikes and show clear directional trends.

Edge Data Logging CSV LOG

Edge Data Logging

Supports onboard SD card initialization to capture and save raw CSI data as CSV files for advanced, post-deployment machine-learning analysis.

On-Device Reference MANUAL

On-Device Reference

A built-in tactical manual that provides quick refreshers on module definitions and color-coded intensity spectrums without interrupting workflow.

Deployment Modes

Adapt to different environmental topologies using three specific modes.

STATION MODE

Connects to a Wi-Fi network as a station client, capturing CSI from associated traffic and uplink activity.

SNIFFER MODE

Passive intercept mode — monitors all traffic on a specific channel without requiring a network association.

ESP-NOW MODE

Direct peer-to-peer ESP wireless protocol for low-latency CSI exchange between devices in the field.

Live Module Demos

Screen recordings from the M5Stack CoreS3 SE display.

AMPLITUDE
WATERFALL
PHASE

Project Information

System Architects & Authors

License

Apache License, Version 2.0

Open-source distribution under the Apache 2.0 license — free to use, modify, and deploy with attribution.

Interface Gallery

Screens, modes, and field captures from CSI Lite-TUI.

Mode Selection
1 / 5

Mode Selection

Choose between Station, Sniffer, and ESP-NOW deployment topologies from the main menu.