
Windowmaster controller v2
Simplycissmus/windowmaster-s3-controller
Open hardware and ESP32-S3 firmware for a local 24 V window actuator controller with MQTT and Home Assistant integration.

Water sensor and cutoff for HomeAssistant using an ESP32 DevKitC board
Water Cutoff is an open-source printed circuit board by cyberknet, from the cyberknet/water-sensor-cutoff repository on GitHub. It is a 2-layer board of 70 × 70 mm with 38 parts on 47 nets, routed with 178 tracks and 21 vias.
It is built around the XL1509-5.0E1, AO3400A and DS1023-1X15SF11, with the SS34, 1N4148W and 2541WV-06P among its other parts. Its parts include 13 resistors, 5 diodes, 5 connectors, 4 transistors and 3 capacitors. It belongs with the home automation and IoT and sensors and measurement boards of this library.
A DIY leak-detection and shutoff controller. It watches a leak probe near a water source and automatically closes a motorized ball valve on the supply line if a leak is detected, integrates with Home Assistant via ESPHome, and can also be driven manually with a front-panel illuminated button.
Built around a socketed ESP32-WROOM-32 DevKitC-32 (30-pin dev board, plugs into female headers on the PCB — nothing is soldered directly to the main board, so the dev board can be swapped if it ever fails).
firmware/water-cutoff.yaml before adapting this for a different
actuator.Full connector-by-connector pinout (J3/J4/J5/DC1, and every GPIO
assignment) is documented at the top of
firmware/water-cutoff.yaml.
Everything on the PCB itself is sourced from LCSC/JLCPCB (see
production/bom.csv). The following is off-board hardware you'll need to
buy separately and wire in:
| Item | Notes | Source |
|---|---|---|
| ESP32-DevKitC-32 ESP-WROOM-32 | 30 pin, 25mm spacing | Amazon |
| 12V DC power supply | Barrel plug, 5.5mm OD × 2.1mm ID | Amazon |
| Motorized ball valve | Innovative Home Systems | |
| Leak/water sensor probe | 2-wire contact or conductivity probe | N/A, 3D Printed |
| Illuminated pushbutton | Momentary switch + 5V RGB LED | Amazon |
Wire colors below reflect this build — if you're sourcing your own actuator/probe/button, verify against whatever ships with your specific part before trusting the color, especially for J4 and J5 where colors vary by manufacturer.
| Pin | Signal | GPIO | Wire color |
|---|---|---|---|
| 1 | Button switch (to GND when pressed) | GPIO22 | Yellow |
| 2 | GND | — | White |
| 3 | LED red channel (via Q1) | GPIO21 | Red |
| 4 | LED green channel (via Q2) | GPIO19 | Green |
| 5 | LED blue channel (via Q3) | GPIO18 | Blue |
| 6 | +5V (LED supply) | — | Black |
| Pin | Signal | GPIO | Wire color | Notes |
|---|---|---|---|---|
| 1 | MOTOR_F | — | Red | |
| 2 | MOTOR_R | — | Green | |
| 3 | GND | — | Black | |
| 4 | Open-limit | GPIO26 | Blue | switch to GND when tripped |
| 5 | GND | — | Gray | |
| 6 | Closed-limit | GPIO32 | Yellow | switch (to GND when tripped) |
| 7 | GND | — | White |
| Pin | Signal | GPIO | Wire color | Notes |
|---|---|---|---|---|
| 1 | Probe signal | GPIO14 | TBD (per probe) | pulled to GND on leak |
| 2 | GND | — | TBD (per probe) |
Standard center-positive 5.5mm OD × 2.1mm ID barrel plug: center pin is +12V, sleeve is GND.
| File/Directory | Description |
|---|---|
| Water Cutoff.kicad_pro/.kicad_sch/.kicad_pcb | KiCad project (schematic + PCB) |
| libs/lcsc/ | Imported LCSC/EasyEDA symbols, footprints, 3D models |
| production/ | JLCPCB-ready fab output |
| firmware/water-cutoff.yaml | ESPHome device config |
| firmware/secrets.yaml.example | Template for WiFi/API credentials |
| stl/ | 3D Models for the leak sensor |
Water Cutoff.kicad_pro in KiCad 10.production/ —
Water_Cutoff.zip contains gerbers and drill files ready to upload
directly to JLCPCB (or any fab that accepts standard RS-274X Gerbers),
alongside bom.csv and positions.csv for assembly.production/bom.csv. Everything is a Basic part except where noted, to
keep assembly cost down.This project uses ESPHome.
firmware/secrets.yaml.example to firmware/secrets.yaml and fill
in your real WiFi credentials, OTA password, and API encryption key.
secrets.yaml is gitignored on purpose — never commit your real one.firmware/water-cutoff.yaml to the ESP32 with esphome run (USB for the first flash; OTA after that).Before relying on this for anything real, verify on the bench:
| Valve state | Short press | Long press (≥3s) |
|---|---|---|
| Open | Closes | Closes |
| Opening | Closes (reverses) | Closes (reverses) |
| Closing | Opens (reverses) | Opens (reverses) |
| Closed (at rest) | Nothing | Opens |
The long-press requirement only applies to opening from a fully-closed rest state — everywhere else, closing is a single short press, since closing is the safety-first direction.
See LICENSE.
| Qty | Value | Footprint | References |
|---|---|---|---|
| 4 | 100Ω | lcsc_footprints:C22775_R0603 | R1, R2, R3, R9 |
| 4 | 10KΩ | lcsc_footprints:C25804_R0603 | R6, R7, R8, R10 |
| 4 | AO3400A | lcsc_footprints:C20917_SOT-23-3_L2_9-W1_3-P1_90-LS2_4-BR | Q1, Q2, Q3, Q4 |
| 4 | MountingHole_Pad | MountingHole:MountingHole_3.2mm_M3_Pad | H1, H2, H3, H4 |
| 3 | 220Ω | lcsc_footprints:C22962_R0603 | R11, R12, R13 |
| 2 | 100uF | lcsc_footprints:C2983553_CAP-SMD_BD6_3-L6_6-W6_6-FD | C2, C3 |
| 2 | DS1023-1X15SF11 | lcsc_footprints:C7509525_HDR-TH_15P-P2_54-V-F | J1, J2 |
| 2 | SS34 | lcsc_footprints:C8678_SMA_L4_3-W2_6-LS5_2-RD | D1, D2 |
| 1 | 1N4148W | lcsc_footprints:C81598_SOD-123F_L2_7-W1_6-LS3_8-RD | D3 |
| 1 | 1uF | lcsc_footprints:C15849_C0603 | C1 |
| 1 | 2.2KΩ | lcsc_footprints:C4190_R0603 | R4 |
| 1 | 2541WV-06P | lcsc_footprints:C5383115_HDR-TH_6P-P2_54-V-M | J3 |
| 1 | 68uH | lcsc_footprints:C9393_IND-SMD_L5_0-W5_0_SMNR5040 | L1 |
| 1 | 820Ω | lcsc_footprints:C23253_R0603 | R5 |
| 1 | DB142R-5.08-2P-GN | lcsc_footprints:C52942255_CONN-TH_4P-P5_08_DB142R-5_08-2P-GN | J5 |
| 1 | DB142R-5.08-7P | lcsc_footprints:C2898714_CONN-TH_7P-P5_08_DIBO_DB142R-5_08-7P | J4 |
| 1 | DC-470-2.1GP | lcsc_footprints:C194407_DC-IN-TH_DC-470-2_1GP | DC1 |
| 1 | KT-0805G | lcsc_footprints:C2297_LED0805-R-RD | LED2 |
| 1 | NCD0805R1 | lcsc_footprints:C84256_LED0805-RD | LED1 |
| 1 | SRD-05VDC-SL-C | lcsc_footprints:C35449_RELAY-TH_SRD-XXVDC-XL-C | K1 |
| 1 | XL1509-5.0E1 | lcsc_footprints:C61063_SOIC-8_L5_0-W4_0-P1_27-LS6_0-BL | U1 |

Simplycissmus/windowmaster-s3-controller
Open hardware and ESP32-S3 firmware for a local 24 V window actuator controller with MQTT and Home Assistant integration.

Excse/plant-watering-system
A completely selfmade smart watering system for plants of any kind integrated into HomeAssistant


gallicchio/AMOD-and-RFMOD
The tutorial's 2x12 adapter (/mudd/133electronics/icepi-zero-dac-adc/adapterboard/) with a 2 x 6 right-angle Pmod socket on a 15 mm extension of its right-hand end, so an Icepi Zero can drive AMOD-A's and RF-MOD's Pmod…

PubInv/PMD_-pseudo-medical-device-aka-Homework2-
In this repo I am practicing KICAD. Created an ESP32 DevKit V1 module and a PCB footprint. I designed a circuit around this ESP32 consisting of six lamps, four switches, and two power jacks and added a voltage…

OETSolutions/swc-module
Steering-wheel-controls adapter module — ESP32-S3, KiCad schematic/PCB, JLCPCB assembly


paulmartinezcuenta/Proyecto_finales_mecatronica_ITLA
Monorepo for two mechatronics projects sharing a panelized PCB: HydroScan (autonomous IoT maritime buoy with LTE, GPS, and solar power) and AUTOAMBU (automated medical respirator prototype with DC control and USB fast…
It measures 70 × 70 mm and has 2 copper layers, 1.6 mm thick.
38 parts, built around the XL1509-5.0E1, AO3400A, DS1023-1X15SF11 and SS34. 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.
From the cyberknet/water-sensor-cutoff repository on GitHub, at the commit this page was made from: the board is Water Cutoff.kicad_pcb and its schematic Water Cutoff.kicad_sch. PCBKit opens the board in the browser, with nothing to install.
Its repository states no licence, so its author keeps all rights: ask cyberknet before reusing the design.