Read in another language: English (this document) · Français.

Autonomous network inventory and discovery appliance powered by ESP32-S3.

Gateway Lab is an autonomous network gateway that discovers, identifies and keeps the history of the devices present on a home local network.

Built around an ESP32-S3, the project favours simplicity of deployment, autonomy, low power consumption and local data retention.

• Multi-protocol discovery (ARP, ICMP, mDNS, SSDP, DNS-SD, NetBIOS...)
• Persistent inventory of detected devices
• Automatic classification (manufacturer, category, type)
• History of connections, disconnections and changes
• Favourites and user notes
• Continuous network monitoring and a per-device stability score
• CSV and JSON export, backup and restore
• Responsive web interface, OTA updates
• Fully local operation, no cloud

Exhaustive feature list: see docs/FEATURES.md.

Network information, connection state, system diagnostics and quick access to the main functions.

Inventory of detected devices with filters, favourites, notes, confidence level and administration tools.

Chronological log of new devices, reconnections, disconnections and detected changes.

Simplified view of the gateway, the detected access points and the attached devices.

WiFi configuration, automatic monitoring, status NeoPixel, backup/restore, OTA and system state.

1. Clone the repository and build with PlatformIO (pio run --target upload)
2. Connect to the GatewayLab-Setup WiFi network
3. Configure WiFi from the browser
4. Reach Gateway Lab at http://gatewaylab.local

Detailed guide: INSTALLATION.md · Developer guide: docs/DEVELOPMENT.md

ESP32-S3 DevKitC-1 N16R8 — 16 MB Flash, 8 MB PSRAM, dual-core 240 MHz.

• include/board_config.h — do not modify
• include/secrets.h — never commit
• CSS only in web_src/styles.css
• HTML only in web_src/*.html (never an inline <style> or <script>)
• JavaScript only in web_src/*.js
• Versioning only in platformio.ini via PROJECT_VERSION
• After any change to web_src/ or data/oui.json → re-run python tools/minify_web.py

Full web pipeline and project structure: docs/ARCHITECTURE.md.

Open-source personal project published for learning, experimentation and knowledge sharing around the ESP32, networking and embedded systems.