Skip to content

joverse962/LiteTUI

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 

Repository files navigation

📡 CSI Lite-TUI

A Handheld Scope for the Invisible World

Real-time Wi-Fi Channel State Information (CSI) visualization built for the M5Stack CoreS3 SE.


M5Stack CoreS3 SE Device        Blind-Cam Hero View




🛠️ Supported Hardware

This lightweight terminal user interface (TUI) is strictly optimized for the M5Stack CoreS3 SE IoT Controller. Its compact form factor, physical touch interface, and robust ESP32 processing power make it the ultimate vessel for a portable spectral analyzer.


📖 Operational Manual & Interface Guide


🟢 1. The Boot Sequence

Upon powering up the CoreS3 SE, the system initiates the neon-styled retro TUI. Designed for high-visibility in field operations, the interface carries zero bloat. Tap START VISUALIZING to initialize the radio and memory allocation.

Welcome Screen

⚙️ 2. Deployment Modes

Adapt to your environment by selecting the appropriate connection topology:

  • STATION MODE
  • SNIFFER MODE
  • ESP-NOW MODE
Modes Screen

📈 3. Amplitude (Packets/Sec)

Visualize the raw volume of data moving through the airwaves. This real-time graph maps amplitude across subcarriers, instantly highlighting network congestion, heavy data transfers, or high-bandwidth anomalies in your immediate vicinity.

Amplitude View

〰️ 4. Unwrapped Phase Offset

Strip away the noise and look at the physical properties of the signal. By tracking the unwrapped phase offset, you can detect microscopic environmental shifts, physical movement within a room, and complex multipath fading effects.

Phase View

🔥 5. Spectral Waterfall

A scrolling matrix mapping amplitude history over time into a density color-map. This view acts as a "heat map" for the air, allowing you to track fleeting signal bursts, frequency hopping, and persistent noise floors as they happen across the spectrum.

Waterfall View

📡 6. Signal Strength (RSSI) & EMA

Track the aggregate power of your selected target. This graph plots signal strength (in dBm) over time. It utilizes an Exponential Moving Average (EMA) to smooth out erratic environmental spikes, providing a clear directional trend for tracking.

RSSI View

💾 7. Edge Data Logging

Don't lose your scan data. Before deployment, the TUI prompts you to initialize the onboard SD card. Capturing raw CSI data as CSV files allows you to extract the payload later for advanced filtering and machine-learning analysis on your main machine.

SD Card Save Prompt

ℹ️ 8. On-Device Reference

A built-in tactical manual. If you need a quick refresher on module definitions or the color-coded intensity spectrum (e.g., matching 'Dark Indigo' to 65% Intensity), the reference guide is instantly accessible without interrupting your workflow.

On-Device Manual

👾 System Architects

  • Maryam Odat (modatt)
  • Abdullah Alawad (Abdullah-Alawad)
Credits Screen

Authors

Contributors

Contributing

Contributions are welcome! If you have ideas for new features, bug fixes, or improvements, please open an issue or submit a pull request.

License

This project is licensed under the Apache License, Version 2.0. See the LICENSE file for more details.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors