Skip to the content
2 layers99.5 × 99.5 mmHydroponics tray controller, the printed circuit board in 3D

Hydroponics tray controller

bookofthefuture/hydroponics-pcb

KiCad PCB designs for the two-tier IKEA hydroponics monitoring/control system

Size
99.5 × 99.5 mm
Copper layers
2
Thickness
1.6 mm
Parts
23
Nets
35
Pads
137
Tracks, vias
243, 35
Pours
3
Routed
Yes
KiCad
KiCad 10.0 (file 20260206)
Created
28 Aug 2026
Updated
1 Oct 2026

Overview

Hydroponics tray controller is an open-source printed circuit board by bookofthefuture, from the bookofthefuture/hydroponics-pcb repository on GitHub. It is a 2-layer board of 99.5 × 99.5 mm with 23 parts on 35 nets, routed with 243 tracks and 35 vias.

It is built around the AMS1117-3.3 and SP3485EN-Y. Its parts include 5 capacitors, 5 resistors, 5 connectors, 3 ICs and 1 diode. It belongs with the ESP32 boards of this library.

Main components

2

README

README.md

hydroponics-pcb

KiCad PCB designs for the hydroponics monitoring/control system on a two-tier IKEA growing rack.

Boards

BoardStatusMCUPurpose
tray-boardfab-ready: ERC/DRC/schematic-parity clean, routed with GND pours + stitching, full JLC BOM (all Basic parts) / CPL / gerbers generatedsocketed ESP32 30-pin DevKitPer-tray sensor + display node. One per tray (top / bottom).
reservoir-boardnot startedESP32 (TBD)Reservoir-side control: fill pumps, A/B + pH dosing pumps, level/EC/pH/temp sensing.

Grow-lamp switching currently stays on the original ESP8266 hydroponics_monitor node and is out of scope for these boards (may move to the reservoir board later).

Tray board peripherals

FunctionPartBusNotes
ToF distance (water level)VL53L0X / VL53L1XI²C 3.3 VShared SDA/SCL
Air pressure (+ humidity/temp on BME)BMP280 / BME280I²C 3.3 VShared SDA/SCL
Lux levelBH1750I²C 3.3 VShared SDA/SCL
Water temperatureDS18B201-Wire 3.3 VDedicated GPIO, 4.7 kΩ pull-up
User inputRotary encoder + push switchGPIO / quadrature3.3 V
Display2.4" ILI9341 240×320, resistive touch (XPT2046) + SD cardSPI (shared bus, separate CS lines)LVGL, encoder-driven UI; SD card wired but not yet used by firmware

Display connector (J2, 14-pin) pinout: VCC, GND, CS(D5), RESET(D4), DC(D2), MOSI(D23), SCK(D18), LED(D15), MISO(D34), T_CLK(D18, shared), T_CS(D14), T_DIN(D23, shared), T_DO(D34, shared), T_IRQ(D35). SD card connector (J3, 4-pin, separate from J2): CS(D19), MOSI(D23, shared), MISO(D34, shared), SCK(D18, shared). New GPIOs used: 14, 19, 34, 35 — none of these were previously assigned, so add them to the ESPHome configs without touching the existing pin numbers.

No high-power switching on the tray board. An SP3485EN RS-485 transceiver (120 Ω termination, direction pin on GPIO12) links the two tray boards to the reservoir board.

Comms

All three ESPs talk to Home Assistant over WiFi (ESPHome native API). The tray boards also talk to the reservoir board over RS-485 — a local wired link so fill-level reads and pump control don't depend on WiFi/HA. The reservoir is the controlling node.

Firmware

ESPHome configs live in the separate ha-config repo under esphome/ (hydro-tray-top.yaml, hydro-tray-bottom.yaml). The pin map is shared between the schematic here and those configs — keep them in sync.

Repo layout

text
tray-board/        KiCad project for the tray sensor board
reservoir-board/   (future) KiCad project for the reservoir board
shared-library/    custom symbol (New_Library) + footprint (Library.pretty)
                   library, referenced by both boards' sym-lib-table/
                   fp-lib-table via ${KIPRJMOD}/../../shared-library/ - keep
                   custom parts (ESP32 DevKit socket, display modules, etc.)
                   here rather than per-board copies, which drift silently
docs/              pin maps, block diagrams, datasheets

Working with KiCad from the CLI

Requires KiCad 10.x (kicad-cli) plus the standard symbol/footprint libraries.

text
tools/fab.sh tray-board

runs ERC + DRC (fails on any error/warning) and writes a JLCPCB-ready set to tray-board/production/ (git-ignored — regenerated from source): gerbers (Protel extensions) + separate PTH/NPTH Excellon drill files, zipped as <name>-gerbers.zip; <name>-cpl.csv (SMD-only pick-and-place, DNP parts excluded); <name>-bom.csv (DNP excluded, LCSC Part # column from each part's LCSC schematic field). Parts you're sourcing/fitting yourself (e.g. the socketed ESP32 module) should be marked Do Not Populate in the schematic so they're left out of both the BOM and the CPL automatically.

It also runs tools/check_pins.py, which checks the MCU's pin usage for hardware hazards ERC doesn't catch — currently ESP32 strapping pins (GPIO0, 2, 5, 12, 15) with an external pull that conflicts with their required boot-time level, GPIO6-11 (internal flash, must never be used externally), and UART0 (GPIO1/3, reserved for USB-serial). Fails the build on any ERROR-severity finding; can also be run standalone:

text
tools/check_pins.py path/to/board.kicad_sch

Parts

23
QtyValueFootprintReferences
4MountingHoleMountingHole:MountingHole_3.2mm_M3_Pad_ViaH1, H2, H3, H4
3100nFCapacitor_SMD:C_0805_2012MetricC2, C4, C5
34.7kResistor_SMD:R_0805_2012MetricR3, R4, R5
110uFCapacitor_SMD:C_0805_2012MetricC3
110uFCapacitor_SMD:C_1206_3216MetricC1
1120Resistor_SMD:R_0805_2012MetricR2
11Wire_PeripheralsConnector_JST:JST_XH_B3B-XH-A_1x03_P2.50mm_VerticalJ6
11kResistor_SMD:R_0805_2012MetricR1
1AMS1117-3.3Package_TO_SOT_SMD:SOT-223-3_TabPin2U3
1Display_MSP2401_2.4in_TouchLibrary:Display_MSP2401_2.4in_TouchJ2
1ESP32Library:ESP32_DevKit_30PinU1
1JumperConnector_PinHeader_2.54mm:PinHeader_1x02_P2.54mm_VerticalJ1
1LEDLED_SMD:LED_0805_2012MetricD2
1Power_CommsConnector_JST:JST_XH_B4B-XH-A_1x04_P2.50mm_VerticalJ4
1SP3485ENPackage_SO:SOIC-8_3.9x4.9mm_P1.27mmU2
1i2c_PeripheralsConnector_JST:JST_XH_B6B-XH-A_1x06_P2.50mm_VerticalJ5

More from bookofthefuture/hydroponics-pcb

1
  • 2 layers100 × 100 mmHydroponics reservoir controller, the printed circuit board in 3D

    Hydroponics reservoir controller

    bookofthefuture/hydroponics-pcb

    KiCad PCB designs for the two-tier IKEA hydroponics monitoring/control system

    82 parts

Similar boards

  • 4 layers270 × 34 mmIo board, the printed circuit board in 3D

    Io board

    ReflexCreations/io-board

    This repository contains source documents and manufacturing files for the RE:Flex Dance Pad's I/O Board. It was created using KiCAD 5.1.4.

    95 parts8MIT
  • 2 layers100 × 100 mmV2 Estacion Nviel, the printed circuit board in 3D

    V2 Estacion Nviel

    HecVelaz/Proyecto-Mburica-

    Repositorio central del Proyecto Mburicao: Sistema IoT de monitoreo de nivel de cauces, modelos de predicción con IA y documentación científica

    62 parts3MIT
  • 2 layers0.7 × 0.5 mmCartDiem STM, the printed circuit board in 3D

    CartDiem STM

    cartediem/Carte-Diem

    Carte Diem - Smart Shopping Cart (EECS 473 F25)

    110 parts1GPL-3.0
  • 2 layersTest dev1, the printed circuit board in 3D

    Test dev1

    aayu0-0/RS485-to-WiFi-Gateway

    An STM32-based RS485 to Wi-Fi gateway supporting Modbus communication for industrial IoT applications.

    21 parts
  • 2 layers87 × 72 mmEasyprb, the printed circuit board in 3D

    Easyprb

    KrogeChen/easyprintf

    easy printf debug box for small mcu

    104 partsGPL-3.0
  • 2 layers118 × 58 mmPcb v1, the printed circuit board in 3D

    Pcb v1

    petrikevich2005/wifi-dmx-controller

    этот репозиторий предназначен для хранения прошивки микроконтроллера этого проекта: https://docs.google.com/document/d/1X2l9bCAOKjv8QiKN7pxREiMzuwiFvaY4nnqX09m9t8/edit?usp=sharing

    34 parts
  • 2 layers200 × 200 mmSignalFLowLab, the printed circuit board in 3D

    SignalFLowLab

    Serpant4632/SignalFLowLab

    130 parts

Questions

How big is the Hydroponics tray controller PCB?

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

What parts does the Hydroponics tray controller use?

23 parts, built around the AMS1117-3.3 and SP3485EN-Y. 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 Hydroponics tray controller KiCad files?

From the bookofthefuture/hydroponics-pcb repository on GitHub, at the commit this page was made from: the board is tray-board/hydroponics_tray_controller/hydroponics_tray_controller.kicad_pcb and its schematic reservoir-board/hydroponics_reservoir_controller/hydroponics_reservoir_controller.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the Hydroponics tray controller design in my own project?

Its repository states no licence, so its author keeps all rights: ask bookofthefuture before reusing the design.