Home

Welcome to the csi-sensing wiki!# 📡 CSI Sensing Platform – Wiki

Welcome to the CSI Sensing Platform Wiki. This Wiki provides detailed documentation on firmware, data formats, processing pipelines, algorithms, and usage examples for the ESP32-based CSI sensing system.

---

📘 Wiki Index

1. Overview

• [Project Introduction](#project-introduction)
• [System Architecture](#system-architecture)
• [Supported Applications](#supported-applications)

2. ESP32 Firmware

• [Firmware Setup](#firmware-setup)
• [Building with ESP-IDF](#building-with-esp-idf)
• [CSI Packet Format](#csi-packet-format)
• [Configuration Options](#configuration-options)

3. Data Collection

• [Collecting CSI via UART](#collecting-csi-via-uat)
• [Collecting CSI via TCP/WebSocket](#collecting-csi-via-tcpwebsocket)
• [Dataset Directory Structure](#dataset-directory-structure)

4. CSI Processing Pipeline

• [Preprocessing Algorithms](#preprocessing-algorithms)
• [Feature Extraction](#feature-extraction)
• [Filtering Techniques](#filtering-techniques)
• [Visualization Tools](#visualization-tools)

5. Machine Learning / Deep Learning

• [Training Classical ML Models](#training-classical-ml-models)
• [Deep Learning (CNN/LSTM/Transformer)](#deep-learning)
• [Real-Time Inference](#real-time-inference)

6. Examples & Tutorials

• [Basic CSI Plotting](#basic-csi-plotting)
• [Heatmap Visualization](#heatmap-visualization)
• [Real-Time CSI Streaming](#real-time-csi-streaming)

7. Advanced Topics

• [Multipath & Subcarrier Analysis](#multipath-and-subcarrier-analysis)
• [CSI-based Localization](#csi-based-localization)
• [Human Activity Recognition](#human-activity-recognition)
• [Gesture Detection](#gesture-detection)

8. Troubleshooting

• [Common Firmware Issues](#common-firmware-issues)
• [No CSI Output](#no-csi-output)
• [Noise & Unstable CSI](#noise-and-unstable-csi)

9. Development Notes

• [Contributing Guide](#contributing-guide)
• [Coding Style](#coding-style)
• [Planned Features](#planned-features)

---

📘 Project Introduction

This project implements a full CSI (Channel State Information) sensing stack using ESP32 for collecting wireless CSI data and Python/C++ for processing, visualization, and machine learning.

---

📡 System Architecture

ESP32 → CSI Data → UART/TCP → Logger → Preprocessing → ML/DL → Applications

Components:

• ESP32 firmware
• Data collector
• Processing toolkit
• ML/DL models
• Real-time live tools

---

🧪 Supported Applications

• Human Activity Recognition (HAR)
• Passive motion detection
• Gesture recognition
• Device-free localization
• Breathing monitoring
• Fall detection

---

This is the main Wiki home page. Let me know which pages you want to auto-generate next (e.g., Firmware, CSI Format, Preprocessing, ML Guide, etc.).