Skip to the content
2 layers109.7 × 53.5 mmAquaMind, the printed circuit board in 3D

Open-source smart aquarium monitoring & control system powered by ESP32, Raspberry Pi and AI. 🐟 Real-time sensors, live camera, automation, alerts, web dashboard & mobile app.

Size
109.7 × 53.5 mm
Copper layers
2
Thickness
1.6 mm
Parts
14
Nets
18
Pads
54
Tracks, vias
208, 29
Pours
1
Routed
Yes
KiCad
KiCad 9.0 (file 20241229)
Created
21 Dec 2025
Updated
27 Oct 2026

Overview

AquaMind is an open-source printed circuit board by savergiggio, from the savergiggio/AquaMind repository on GitHub, published under the MIT licence. It is a 2-layer board of 109.7 × 53.5 mm with 14 parts on 18 nets, routed with 208 tracks and 29 vias.

Its parts include 4 resistors and 1 IC. It belongs with the ESP32 and RISC-V boards of this library.

README

README.md

AquaMind — aquarium monitoring system

The brain of your aquarium. 🐟
Real-time monitoring: temp, pH, TDS, level, camera, AI, notifications.

🇬🇧 English · 🇮🇹 Italiano

Firmware Docker KiCad React License PCBs made by PCBWay

Features · Web UI · Mobile app · Architecture · Contents · 3D models · Quick start · API · Components · Sponsor · PCBWay


🇬🇧 AquaMind

🏭 Sponsor · PCBWay

PCBs fabricated by PCBWay

A big thanks to PCBWay for supporting the project and taking care of the PCB fabrication for AquaMind. They manufactured the AquaMind board directly from the Gerber files and production data available in pcb/kicad/. I was really happy with how the board turned out. The overall finish was very clean, the silkscreen was sharp, and the drilling and routing looked precise.

The whole production process was straightforward, and the board arrived quickly and well made. Most importantly, the final result matched the design very closely, which gave me much more confidence in the hardware. Overall, I had a very positive experience with PCBWay. Seeing AquaMind go from a PCB layout on screen to a real, professionally manufactured board was one of the most satisfying parts of the project.

Thanks again to PCBWay for supporting AquaMind and helping turn the design into a real PCB.

  • 📂 Fab-ready Gerbers: pcb/kicad/gerber/
  • 📋 BOM + positions + IPC netlist: pcb/kicad/production/
  • 🧊 3D model of the board: pcb/kicad/AquaMind.step

Want to build the board? Upload the Gerber set to PCBWay — the project thanks everyone who supports the hardware pipeline. 🐟


🐟 What is AquaMind

AquaMind is a complete, open-source system for monitoring and controlling a fish tank. A microcontroller reads the submerged sensors, a Raspberry Pi acts as the central brain (history, video, AI and notifications) and a web dashboard + mobile app let you keep an eye on everything, even from afar.

The project covers the entire chain: from the sensor firmware, to the custom PCB, to the 3D-printed case, all the way to the Docker backend and the React frontend.

📸 The built prototype · 3D-printed case + custom PCB

A photo tour of the physically built prototype: PCB fabricated by PCBWay, 3D-printed enclosure and all the components. Click any photo to open it full size.

PCB fabricated by PCBWay
🏭 PCB fabricated by PCBWay
Components and JST connectors
🧩 Components & JST connectors
Wired sensors and ESP32
🔌 Wired sensors + ESP32
3D-printed enclosure with PCB
🧊 3D-printed enclosure + PCB
Enclosure with OLED display
🖥️ Enclosure with OLED display
3D-printed lid AQUAMIND
🐟 3D-printed lid "AQUAMIND"
Front panel TEMP PH TDS LEVEL
🏷️ Front panel · TEMP · PH · TDS · LEVEL
Open enclosure with PCB inside
📂 Open enclosure, PCB inside
Prototype in the aquarium
🐠 The prototype in the aquarium

⚙️ Features

AreaWhat it does
📷 VideoIMX179 camera (8MP, 1080p) inside a repurposed transparent garden sphere, live MJPEG streaming
💡 ControlsLights, pump, skimmer, heater, feeder — from web and app
📅 SchedulerAutomatic on/off schedules for every device
🤖 AIGoogle Gemini integration for diagnostics and control
🔔 Notificationsntfy and Telegram alerts when a parameter goes out of range
📈 HistoryArchived data with browsable history (/sensors/history API)
🖥️ Web UIReact + Vite + Tailwind dashboard served by Nginx
📱 Mobile appAndroid app riding on the same REST API (sensors, video, AI, guides, backup)
🧩 Home AssistantCustom component for Chihiros lights (BLE)

🖥️ Web UI (React dashboard)

The React dashboard is the control center: live video from the underwater sphere, real-time sensor cards, AI agent, manual controls, schedules, maintenance calendar, fish inventory and full history. Click any screenshot to open it full size.

AquaMind dashboard: live camera, sensors, AI agent, controls
📷 Dashboard — live video, sensors (TEMP · PH · TDS · LEVEL), AquaMind AI agent, manual controls
Maintenance calendar
📅 Maintenance — calendar with scheduled water changes and events
Water parameters and recipe
💧 Water parameters — full analysis, hardness, complete recipe
Fish inventory
🐠 Fish inventory — species, quantity, food and last feeding
Data history
📈 History — telemetry charts with min/max/avg statistics

📱 Mobile app

The Android app rides on the same REST API as the dashboard: sensor cards, live video, AI assistant, treatment guides, tank management and backup — right from the phone. Tap any screenshot to open it full size.

AquaMind app home
🏠 Home — sensor cards (TEMP · PH · TDS · LEVEL), trend charts, AI agent
Guide & Ricette
📖 Guides & recipes — disease treatments saved per tank
Management menu
⚙️ Management — add aquarium, tank manager, backup export/import
AI Assistant chat
🤖 AI Assistant — Gemini chat, quick diagnostic
Full AI diagnostic
🩺 Full diagnostic — pH, nitrogen cycle, GH/KH, TDS, fish compatibility

All 12 app screenshots are in images/.


🧠 Architecture

The flow is simple: the ESP32-S3 reads the sensors and publishes them as JSON over serial; the Raspberry Pi (in Docker) receives and stores them, acts as the hub for video and controls, and pushes events to the dashboard, the app and the notification channels.

mermaid
flowchart LR
  subgraph Tank
    S1[DS18B20]
    S2[PH-4502C]
    S3[TDS]
    S4[RCWL-1670]
    CAM[IMX179]
  end
  S1 --> ESP[ESP32-S3]
  S2 --> ESP
  S3 --> ESP
  S4 --> ESP
  ESP -- serial JSON --> RPI[Raspberry Pi]
  CAM -- MJPEG --> RPI
  RPI --> DB[(SQLite)]
  RPI --> WEB[React Dashboard]
  RPI --> APP[Mobile App]
  RPI --> AI[Gemini AI]
  RPI --> NTF[ntfy / Telegram]

📦 Repository structure

The repo is organized in 4 areas, one per "layer" of the project:

text
.
├── 3D/
│   ├── case/            #    Enclosure: base, lid, sensor mounts, spacer, cap
│   ├── display/         #    display_aquamind + 53 mm glass mount (SLDPRT/STEP)
│   └── completo/        #    Main assemblies as GLB (viewable in the browser)
├── codice/
│   ├── esp32-s3/        # Sensor firmware (ESP32-S3, v2.0.0-S3)
│   └── raspberry/       # Full dockerized system (backend + frontend)
│       ├── backend/     #   Node.js: API, history, video, AI, notifications, Chihiros
│       ├── frontend/    #   React + Vite + Tailwind (dashboard)
│       ├── docs/        #   Setup notes (Bluetooth, etc.)
│       └── docker-compose.yml
├── pcb/
│   └── kicad/           # KiCad project: sch, pcb, gerber, BOM, netlist, positions
│       ├── gerber/      #   Production files (fab-ready)
│       └── production/  #   BOM, designators, IPC netlist, positions
├── rendering/           # Full-system renderings
├── images/              # Built-prototype photos · Web UI screens · mobile app screens
└── docs/                # Page images and banner

🧊 1 · Case and 3D models

The mechanics are designed in SolidWorks (.SLDPRT sources) and exported as STEP (neutral format for CAD/verification). In the repo you will find:

  • 3D/case/ — the complete enclosure: base, lid, sensor mounts, spacer, cap and the full assembly (AquaMind.step).
  • 3D/display/ — the display housing (display_aquamind) and the 53 mm glass mount, the bracket that fixes the camera sphere to the tank glass.
  • 3D/completo/ — the main assemblies as GLB, viewable directly in the browser.

💡 .SLDPRT are the SolidWorks sources, .STEP is the neutral exchange format.

🔲 2 · Sensor firmware (ESP32-S3)

codice/esp32-s3/Aquamind-s3.ino — firmware that reads the 4 sensors and publishes them as JSON over serial/UART every 2 seconds, with a local OLED display and EEPROM-based calibration (pH offset, TDS coefficient, level range).

  • DS18B20 → temperature (OneWire)
  • PH-4502C → pH (ADC)
  • TDS → salinity (ADC)
  • RCWL-1670 → water level (mmWave)
  • SSD1306 → 128×64 OLED display (I²C)

🍓 3 · Raspberry Pi system (Docker)

codice/raspberry/ is the complete dockerized system (backend + frontend in containers):

  • backend/ — Node.js server: REST API, serial ingest, MJPEG video streaming, SQLite history, controls, scheduler, Gemini AI proxy, ntfy/Telegram notifications and a daemon for the Chihiros lights (BLE).
  • frontend/ — React + Vite + Tailwind dashboard, served by Nginx.
  • docker-compose.yml — orchestrates the two services (backend on host network for USB/BLE, frontend on port 80).
What the backend does (subsystems)
SubsystemHow it works
REST APIExpress (server.js) exposes the /api/* endpoints for the dashboard and the mobile app
WebSocketws on /ws → live push of sensors, device states and alerts to the dashboard
Serial ingestserialport reads the JSON frames from the ESP32; one port per tank (tankSerialPorts)
Historybetter-sqlite3 with sensors, alert_log, schedules, chihiros_devices, maintenance_log, water_parameters, fish_inventory tables (+ auto migrations)
Videochild_process + ffmpeg → MJPEG stream from /dev/video0 (/api/stream)
SchedulerAutomatic device on/off, with active-devices lookup (/api/schedules/active-devices)
AlertsConfigurable thresholds and deltas, event log, notification test (/api/alerts/*)
NotificationsPush to ntfy and Telegram when a parameter goes out of range
Chihiros BLEPython daemon (chihiros_daemon.py + bleak) handles scan, on/off, brightness, RGB, channels, schedules and auto-mode
AIGemini proxy (/api/gemini) with saved conversations and recipes
Multi-tankTank CRUD, remote calibration, camera settings, config export/import
FirmwareESP32 firmware flashing over serial upload (/api/tanks/:id/firmware)
BackupDatabase export/import (/api/backup, /api/restore)
Quick start
bash
cd codice/raspberry
cp backend/.env.example backend/.env   # add GEMINI_API_KEY, tokens, etc.
docker-compose build
docker-compose up -d
# Dashboard: http://<raspberry-ip>/

🛠️ 4 · PCB (KiCad)

pcb/kicad/ contains the complete KiCad project of the AquaMind board:

  • AquaMind.kicad_sch / AquaMind.kicad_pcb — schematic and PCB layout (2 layers)
  • gerber/ — complete production set (Cu, mask, silkscreen, paste, edge cuts, drill)
  • production/ — BOM, designators, IPC netlist and positions for manufacturing
  • AquaMind.step — 3D model of the PCB

ℹ️ In the BOM the board uses the ESP32-C3 SuperMini module (U1); the firmware in codice/esp32-s3/Aquamind-s3.ino is written for the ESP32-S3 DevKit — pins are configurable at the top of the file.

🏭 The PCBs of this project are fabricated by PCBWay — the files in gerber/ and production/ are fab-order ready.

🧊 3D models (renders)

Renders of the CAD 3D models (from the GLB assemblies in 3D/) — these are not photos of the built hardware, the physical prototype is in the section above:

Board + sensors assembly
🧊 Board + sensors assembly
Camera sphere assembly
📷 Camera sphere + 53 mm mount
AquaMind PCB
🛠️ AquaMind PCB

📷 The underwater sphere

To house the camera underwater, a transparent garden sphere was purchased — one of those solar-panel LED globes used for garden lighting — and repurposed for this purpose: inside it sits the IMX179 camera (8 MP, 1080p, 1/3.2″ CMOS), and the sphere is fixed to the tank glass with the 53 mm mount (sources in 3D/display/).

IMX179 camera


🚀 Quick start

bash
# 1. Clone the repo
git clone https://github.com/<your-username>/AquaMind.git
cd AquaMind

# 2. Start the Raspberry system (Docker)
cd codice/raspberry
cp backend/.env.example backend/.env
docker-compose build && docker-compose up -d

# 3. Flash the ESP32-S3 firmware (from Arduino IDE)
#    Board: ESP32S3 Dev Module · Port: /dev/ttyUSB*

Open the dashboard at http://<raspberry-ip> and you are up and running. 🐠


🔌 API

EndpointMethodDescription
/api/sensorsGETCurrent sensor data
/api/sensors/history?hours=24GETData history
/api/controlsGET / POSTDevice state / control
/api/schedulesGET / POSTSchedules
/api/schedules/:idPUT / DELETEUpdate / delete schedule
/api/streamGETMJPEG video stream
/api/statusGETSystem status
/api/geminiPOSTGemini AI proxy

Example:

bash
curl http://raspberry/api/sensors
# {"temp":25.4,"ph":8.2,"tds":120,"level":98,"fw_version":"2.0.0-S3"}

curl -X POST http://raspberry/api/controls \
  -H "Content-Type: application/json" \
  -d '{"device":"mainLight","state":true}'

🖼️ Components

The hardware components at the heart of the project:

IMX179 8MP camera moduleTDS probePH-4502C pH probe
🎥 IMX179 — 8MP camera
night-vision in the underwater sphere
🧪 TDS — salinity probe
ADC, EEPROM calibration
🔬 PH-4502C — pH probe
ADC, EEPROM offset
DS18B20 probeRCWL-1670 moduleSSD1306 OLED display
🌡️ DS18B20 — temperature probe
OneWire bus
📶 RCWL-1670 — mmWave module
water-level detection
🖥️ OLED SSD1306 — local display
128×64 I²C
ESP32-S3Raspberry Pi
🧠 ESP32-S3 — microcontroller
sensor reading + OLED
🍓 Raspberry Pi — central hub
API, history, video, AI

📄 License

MIT — fork it, improve it, share it. 🐟

Parts

14
QtyValueFootprintReferences
21KResistor_THT:R_Axial_DIN0207_L6.3mm_D2.5mm_P7.62mm_HorizontalR1K1, R21K1
22KResistor_THT:R_Axial_DIN0207_L6.3mm_D2.5mm_P7.62mm_HorizontalR32K1, R42K1
1AUX1Connector_JST:JST_XH_S3B-XH-A-1_1x03_P2.50mm_HorizontalAUX1
1AUX2Connector_JST:JST_XH_S3B-XH-A-1_1x03_P2.50mm_HorizontalAUX2
1AUX3Connector_JST:JST_XH_S4B-XH-A_1x04_P2.50mm_HorizontalAUX3
1AUX4Connector_JST:JST_XH_S3B-XH-A-1_1x03_P2.50mm_HorizontalAUX4
1DISPLAYConnector_JST:JST_XH_S4B-XH-A_1x04_P2.50mm_HorizontalDISPLAY1
1ESP32-C3_SUPERMINI_SMDesp32-c3:MODULE_ESP32-C3_SUPERMINIU1
1LVLConnector_JST:JST_XH_S4B-XH-A_1x04_P2.50mm_HorizontalLVL1
1PHConnector_JST:JST_EH_B3B-EH-A_1x03_P2.50mm_VerticalPH1
1TDSConnector_JST:JST_EH_B3B-EH-A_1x03_P2.50mm_VerticalTDS1
1TEMPConnector_JST:JST_XH_S3B-XH-A-1_1x03_P2.50mm_HorizontalTEMP1

Similar boards

  • 2 layers116.8 × 30 mmType d, the printed circuit board in 3D

    Type d

    google/mozc-devices

    Circuit diagrams and firmware source code for Gboard DIY keyboards

    14 parts3kApache-2.0
  • 2 layers32 × 22 mmDiff driver, the printed circuit board in 3D

    Diff driver

    rene-dev/stmbl

    AC Servo Driver for STM32F4

    14 parts990GPL-3.0
  • 2 layers34 × 45 mm2032Charger, the printed circuit board in 3D

    2032Charger

    hackclub/OnBoard

    💡 Join 1,000 teenagers and make your first PCB with a $100 grant!

    14 parts915
  • 2 layers34 × 109.9 mmTdisplay s3, the printed circuit board in 3D

    Tdisplay s3

    landonr/homeThing

    Wifi Smart Home Remotes that run on ESPHome

    14 parts551GPL-3.0
  • 2 layers45.3 × 42.7 mmMainPcb, the printed circuit board in 3D

    MainPcb

    adamb314/ServoProject

    Getting the most out of your hobby servo

    14 parts545
  • 2 layers42.5 × 28.8 mmC5VRX JACK DIY, the printed circuit board in 3D

    C5VRX JACK DIY

    Twotoz/C5VRX

    Ultra-minimal, zero-CPU 5.8 GHz analog FPV video receiver using ESP32-C5 Wi-Fi 6 PHY MODEM_DIAG, BitScrambler WBFM demodulation & resistor DAC CVBS

    14 parts515GPL-3.0
  • 2 layers62 × 24 mmMai button, the printed circuit board in 3D

    Mai button

    whowechina/mai_pico

    Pico controller for Maimai

    14 parts475

Questions

How big is the AquaMind PCB?

It measures 109.7 × 53.5 mm and has 2 copper layers, 1.6 mm thick.

What parts does the AquaMind use?

14 parts. The full list of its parts is on this page, with links to each part's symbol and footprint where PCBKit's library has them.

Where can I download the AquaMind KiCad files?

From the savergiggio/AquaMind repository on GitHub, at the commit this page was made from: the board is pcb/kicad/AquaMind.kicad_pcb and its schematic pcb/kicad/AquaMind.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the AquaMind design in my own project?

Its repository publishes it under the MIT licence: you may reuse it on that licence's terms (keep the author's notice, and for a copyleft licence share your changes alike).