SmartDB documentation

Build, configure and understand the current SmartDB v2 bench system: an ESP32-S3 main board with SCT-013 AC current monitoring, MLX90640 thermal sensing, relay protection and RGB–thermal fusion, plus a separate ESP32-CAM for visible images.

Backend and frontend integration

The Firebase API and team handoff now cover accounts, device credentials, durable telemetry/history, alerts, queued commands and fused-image previews. Run sh system.sh from the repository root for local emulators and an optional developer console. The frontend team owns the user dashboard; this console is only for API development. Read the current architecture for responsibilities and the PCB downloads for the permanent v2 CAD.

Start with the setup menu

Open esp_idf/smartdb_fusion in VS Code and choose Terminal → Run Task → SmartDB: Setup. Or run ./setup.sh from that folder.

Enter Wi-Fi settings with menu 1.
Connect the camera’s USB programmer directly to the computer and choose 2.
Connect the main board through J4 USB-C and choose 3.
Use 4 for protection limits, 5 for status, and 8 for the fused-image viewer.

The menu can build and flash the correct firmware for each board. After that initial update, connection settings persist on the boards and can be changed over USB without reflashing. J6 supplies camera power only. Physical re-arm is still required to close the relay, and real camera alignment remains an installation calibration step.

Read the complete setup and configuration guide for wiring, saved settings, troubleshooting and calibration. The Postman guide covers the HTTP interfaces; Postman is optional for setup. Browse the firmware code guide, local HTTP API, USB setup protocol and telemetry reference for implementation details. ByteLab documents the related desktop development workspace.

Implementation status

Available now	Still requires validation or implementation
S3 and ESP32-CAM firmware, USB setup menu, saved Wi-Fi/configuration	Physical board provisioning and sensor/relay behavior
Local AC current/thermal protection, physical re-arm, event history	Actual current accuracy, cutoff timing and component ratings
Registered thermal overlay and native-sample region statistics	Measured camera alignment; trained cloud AI models
Firebase HTTP API, telemetry/history, in-app alerts, command acknowledgements and stored fused preview	Live Firebase deployment, external notifications and production operations
Optional local developer console and documented frontend API	User dashboard implementation by the frontend team

Firmware builds and host tests pass. Hardware operation has not been validated in this design session. The current scope is isolated low-voltage AC monitoring up to the 1 A bench limit; the board’s logic supply remains regulated 5 V DC. This is not a mains-rated protection design. The architecture page separates the implemented bench system from the wider production requirements.

SmartDB v2

Related projects

Development reference