ARCHITECTURE.md

ESP32-Mapper WiFi Architecture

Overview

ESP32-Mapper WiFi is structured as a command-driven scan service exposed over a local HTTP API.

Runtime Flow

1. Firmware boots and starts AP+STA mode.
2. HTTP routes are registered.
3. Mobile client sends commands (configure, start, stop).
4. Scan loop finalizes asynchronous Wi-Fi scans.
5. Results are filtered, sorted, and served via JSON.

Modules

src/main.cpp

Firmware entrypoint only:

• initializes ScannerServer
• delegates setup() and loop()

include/scanner_server.h

Declares:

• configuration models (ScannerConfig, NetworkRecord)
• scanner server state
• route handlers and helper methods

src/scanner_server.cpp

Implements:

• AP initialization
• HTTP route registration
• JSON request/response handling
• scan lifecycle and result processing
• telemetry/logging output

State Model

ScannerServer tracks:

• active scan state
• last command and command timestamp
• cached network list
• scanner configuration
• device metadata

Companion App

This firmware is designed for:

• IOS-Mapper WiFi