System Requirements Document (SRD)

Project Name: agile-wifi

1. Introduction

The agile-wifi project is a state-of-the-art system designed to leverage WiFi signals for advanced environmental sensing, human detection, and activity recognition. This document outlines the system requirements for the project, ensuring clarity and alignment with the goals of the project.

The system is tailored for users in India (IN), with locale-specific considerations, such as compatibility with regional hardware availability and network standards. The project aims to provide a robust platform for analyzing WiFi signals using Channel State Information (CSI) and delivering actionable insights.

This document also incorporates insights from the RuView GitHub repository, which highlights the use of CSI for advanced sensing capabilities, including human detection, activity recognition, and micro-movement analysis.

2. System Overview

The agile-wifi system captures, processes, and analyzes WiFi signal data to detect human presence, activity, and environmental changes. By utilizing CSI (Channel State Information), the system goes beyond basic WiFi scanning to enable advanced features like pose estimation, breathing detection, and heatmap visualizations.

The system is designed to operate on Linux-based environments and requires specific hardware, such as CSI-compatible WiFi adapters (e.g., Intel 5300). It processes data locally and outputs results in user-friendly formats, including CSV files and visualizations.

Key objectives of the system include:

• Providing real-time human detection and activity recognition.
• Supporting advanced environmental sensing through WiFi signals.
• Delivering outputs in intuitive formats for easy interpretation.
• Enabling researchers and developers to customize algorithms for specific use cases.
• Allowing selective re-run capability for regenerating the System Requirements Document (SRD) based on user-triggered requests.

3. Functional Requirements

• As a User, I should be able to capture WiFi signal data using a CSI-compatible adapter.
• As a User, I should be able to process CSI data to detect human presence and activity.
• As a User, I should be able to visualize WiFi signal data as heatmaps or graphs.
• As a User, I should be able to detect micro-movements like breathing using WiFi signals.
• As a User, I should be able to export processed data in CSV format.
• As a Developer, I should be able to configure the system for different WiFi adapters.
• As a Researcher, I should be able to analyze pose estimation using WiFi signals.
• As a Researcher, I should be able to customize algorithms for specific sensing tasks.
• As a User, I should be able to monitor real-time signal activity through a dynamic interface.
• As a User, I should be able to trigger a selective re-run to regenerate the System Requirements Document (SRD).

4. User Personas

1. User:

   • A general user interested in leveraging WiFi signals for environmental sensing.
   • Needs simple interfaces for capturing and visualizing data.

2. Developer:

   • A technical user responsible for configuring and maintaining the system.
   • Requires access to system configurations, debugging tools, and hardware compatibility settings.

3. Researcher:

   • A user conducting advanced studies on WiFi-based human detection.
   • Requires detailed data outputs, support for custom algorithms, and tools for pose estimation and micro-movement analysis.

4. Administrator:

   • A user managing system deployments in larger environments (e.g., labs or offices).
   • Needs tools for monitoring system health and managing multiple devices.

5. Visuals Colors and Theme

Unique Color Palette for agile-wifi:

• Background: #F4F8FD (soft cloud blue)
• Surface: #DCE4F2 (light steel blue)
• Text: #1E2A38 (charcoal gray)
• Accent: #FF7A59 (vibrant orange-red)
• Muted Tones: #A3B1C6 (cool slate gray)

This palette reflects a modern, tech-savvy aesthetic while maintaining a clean and professional look. It emphasizes clarity and precision, aligning with the system's advanced sensing capabilities.

6. Signature Design Concept

Dynamic CSI Signal Visualization

The homepage of the agile-wifi system will feature a dynamic CSI signal visualization interface. Users will experience an interactive, real-time representation of WiFi signal activity, designed to captivate and inform.

• Visual Elements:

  • A 3D grid environment where WiFi signals are represented as flowing, colorful waves.
  • Each wave dynamically adjusts based on real-time CSI data, showing variations in signal strength, frequency, and environmental changes.

• Animations:

  • Smooth, pulsating animations for signal waves, creating a sense of motion and energy.
  • Hover effects that highlight specific signal metrics (e.g., amplitude, phase).

• Transitions:

  • Seamless zoom-in and zoom-out transitions for exploring specific areas of the signal grid.
  • Clicking on a wave opens a detailed panel with options for heatmap visualization, pose estimation, or micro-movement analysis.

• Micro-Interactions:

  • Interactive sliders to adjust visualization parameters (e.g., frequency range, signal intensity).
  • Real-time tooltips that explain the significance of each metric.

This design will make the system instantly engaging and visually memorable, emphasizing its advanced capabilities and user-centric approach.

7. Non-Functional Requirements

• The system must operate on Linux-based environments.
• The system must support real-time data processing with minimal latency.
• The system must be compatible with Intel 5300 WiFi adapters and similar hardware.
• The system must provide outputs in CSV and image formats.
• The system must ensure data privacy and security during processing.
• The system must support modular algorithm integration for researchers.
• The system must be scalable for multi-device deployments.
• The system must allow selective re-run capability for regenerating the SRD.

8. Tech Stack

Frontend:

• React for Web

Backend:

• Python
• FastAPI

Database:

• MySQL (with Alembic for migrations)

AI Models:

• GPT 5.4 for user-friendly responses
• Claude 4.6 Opas for coding and academic tasks

AI Tools:

• Langchain
• Litellm for LLM Routing

Orchestration:

• Docker
• Kubernetes

9. Assumptions and Constraints

• The system assumes access to a CSI-compatible WiFi adapter (e.g., Intel 5300).
• The system assumes users have a basic understanding of Linux environments.
• The system is constrained to operate on 2.4 GHz and 5 GHz WiFi bands.
• The system assumes sufficient computational resources for real-time processing.
• The system assumes users have access to a stable WiFi network for testing and deployment.
• The system assumes users can manually trigger selective re-runs for regenerating the SRD.

10. Glossary

• CSI (Channel State Information): Detailed data about how WiFi signals travel between devices.
• RSSI (Received Signal Strength Indicator): A measure of WiFi signal strength.
• Heatmap: A graphical representation of data where values are depicted by color.
• Pose Estimation: The process of determining the position and orientation of a person.
• Micro-Movement Detection: Identifying small movements, such as breathing, using signal analysis.
• WiFi Adapter: A hardware device that allows a computer to connect to a WiFi network.
• Selective Re-Run: A feature that allows users to manually regenerate the System Requirements Document (SRD) based on updated inputs or requirements.

This updated SRD includes the new requirement for selective re-run capability, ensuring the system can regenerate the SRD upon user request. Let me know if you need further refinements, Ankit!