Esp32-aquarium controller
voltlog·esp32-aquarium-controller·HW/Voltlog ESP32 Relay Controller.kicad_pcb
About the Esp32-aquarium controller PCB
Esp32-aquarium controller is an open source ESP32 PCB design by voltlog, published on GitHub under the GPL-3.0 license. It is a 2-layer board measuring 122 × 86 mm, with 60 components from 37 distinct parts.
Its main chip is the ESP32-WROOM-32D, from the ESP32 family. Other key parts include the NCP1117-3.3_SOT223, FM24C64C and ULN2003AD. By type, the board carries 17 capacitors, 11 connectors, 9 resistors, 6 diodes, 5 fuses and 4 ICs.
It belongs with the sensors designs in this gallery.
From the project
ESP32 based aquarium/terrarium controller
This project started when a friend of mine which has a snake terrarium asked for my help to build a system that is capable of regulating temperature and humidity so the snake can live in optimum conditions. I’m not necessarily a snake lover, I would rather stay away from these kinds of creatures but that doesn’t stop me from helping my friend.
The ESP32 module is the core of this board and it serves as a central processor taking in sensor data and deciding when to switch on/off the 4 relay controlled outputs to adjust the environment inside the aquarium/terrarium.

Main components on the Esp32-aquarium controller
Esp32-aquarium controller bill of materials (BOM)
60 components, 37 distinct parts.
| Qty | Part | Footprint | Refs |
|---|---|---|---|
| 1 | ESP32-WROOM-32D | ESP32-WROOM-32 | U1 |
| 1 | NCP1117-3.3_SOT223 | SOT-223-3_TabPin2 | U2 |
| 1 | FM24C64C | SOIC-8_3.9x4.9mm_P1.27mm | U3 |
| 1 | ULN2003AD | SO-16_3.9x9.9mm_P1.27mm | U4 |
| 1 | AC_IN | TerminalBlock_RND_205-00287_1x02_P5.08mm_Horizontal | J1 |
| 1 | TH2 | TerminalBlock_RND_205-00233_1x03_P5.08mm_Horizontal | J2 |
| 1 | TH1 | TerminalBlock_RND_205-00233_1x03_P5.08mm_Horizontal | J3 |
| 1 | I2C | PinHeader_1x04_P2.54mm_Vertical | J4 |
| 1 | VoltLink_target | VoltLink | J5 |
| 1 | ADC | PinHeader_1x06_P2.54mm_Vertical | J6 |
| 1 | GPIO | PinHeader_1x06_P2.54mm_Vertical | J7 |
| 1 | CH1 | TerminalBlock_Phoenix_MKDS-3-3-5.08_1x03_P5.08mm_Horizontal | J8 |
| 1 | CH2 | TerminalBlock_Phoenix_MKDS-3-3-5.08_1x03_P5.08mm_Horizontal | J9 |
| 1 | CH3 | TerminalBlock_Phoenix_MKDS-3-3-5.08_1x03_P5.08mm_Horizontal | J10 |
| 1 | CH4 | TerminalBlock_Phoenix_MKDS-3-3-5.08_1x03_P5.08mm_Horizontal | J11 |
| 1 | 250V 0.5A (slow) | Fuseholder_Cylinder-5x20mm_Stelvio-Kontek_PTF78_Horizontal_Open | F1 |
| 4 | Fuse | Fuseholder_Cylinder-5x20mm_Stelvio-Kontek_PTF78_Horizontal_Open | F2, F3, F4, F5 |
| 4 | FINDER-36.11 | Relay_SPDT_Finder_36.11 | K1, K2, K3, K4 |
| 1 | Housing | Bernic_BE4969842011 | N1 |
| 1 | TAS5-5-W | TDPOWER-TAS5 | PS1 |
Show 17 more
| Qty | Part | Footprint | Refs |
|---|---|---|---|
| 1 | 275V | RV_Disc_D12mm_W5mm_P7.5mm | RV1 |
| 1 | USER | SW_SPST_PTS645 | SW1 |
| 1 | SMBJ6.0A | D_SMB | D1 |
| 1 | POWER | LED_0805_2012Metric | D2 |
| 1 | CH1 | LED_0805_2012Metric | D3 |
| 1 | CH2 | LED_0805_2012Metric | D4 |
| 1 | CH3 | LED_0805_2012Metric | D5 |
| 1 | CH4 | LED_0805_2012Metric | D6 |
| 9 | 0.1uF | C_0805_2012Metric | C1, C2, C5, C6, C8, C9, C10, C12 +1 |
| 1 | 22uF | C_1206_3216Metric | C3 |
| 1 | 220uF | CP_Elec_8x10.5 | C4 |
| 6 | 10uF | C_0805_2012Metric | C7, C11, C13, C14, C15, C16 |
| 2 | 10K | R_0805_2012Metric | R1, R6 |
| 4 | 4K7 | R_0805_2012Metric | R2, R3, R4, R5 |
| 1 | 1K | R_0805_2012Metric | R7 |
| 1 | 270R | R_Array_Convex_4x0603 | RN1 |
| 1 | 2K | R_Array_Convex_4x0603 | RN3 |
Esp32-aquarium controller design files
The KiCad project lives in the voltlog/esp32-aquarium-controller repository on GitHub; these links point at the commit this page was built from.
Esp32-aquarium controller: common questions
What microcontroller does the Esp32-aquarium controller use?
The Esp32-aquarium controller is built around the ESP32-WROOM-32D, from the ESP32 family.
How big is the Esp32-aquarium controller PCB?
The Esp32-aquarium controller measures 122 × 86 mm, has 2 copper layers and is 1.6 mm thick.
How many components are on the Esp32-aquarium controller?
60 components, from 37 distinct parts. The full bill of materials is listed on this page.
Where can I download the Esp32-aquarium controller design files?
From the voltlog/esp32-aquarium-controller repository on GitHub, which has the KiCad layout; the links under Design files point to each one.
Can I use the Esp32-aquarium controller design in my own project?
Yes, under the terms of its GPL-3.0 license, which voltlog chose for the repository.
Can I test firmware for the Esp32-aquarium controller without the hardware?
Yes. HardLabs builds a simulation of the board from its netlist and BOM, so you can run and debug ESP32 firmware against it before you order a PCB.
Similar boards
ESP32
Open Book Abridged Edition
joeycastillo
85 × 115 mm65 parts2LCC-BY-SA-4.08.1kESP32
Powertrain
byrantech
64 × 45.4 mm171 parts4LMIT4.3kESP32
Esp32 minimal
atopile
36.2 × 26.8 mm20 parts2LMIT4.0kESP32
Badge
atopile
56.3 × 39 mm239 parts4LMIT4.0kESP32
Controller
StuckAtPrototype
29 × 74 mm58 parts4LApache-2.03.8kESP32
Racer
StuckAtPrototype
36 × 50.2 mm70 parts4LApache-2.03.8k