Relay-Boxes

Many of my projects need mixed outputs (mains, low-voltage, and logic) that can be triggered reliably over the network. To avoid one-off hacks, I built a standard relay box: PSU and wiring inside, Ethernet on the outside, speaking OSC and Art-Net. Controlled by good and secure code, allowing them to be easily used and hacked.

Features

Ethernet-connected
Outputs:
- 2x 230V
- 3x 12V (1x including Schottky & Capacitor for motors)
- 1x 5V
- 2x Relays
Protocols: OSC & Art-Net
Also 4x Button-Inputs, broadcasting a custom OSC-Message
Control Code that
- sends a heartbeat regularly & on boot
- can ensure that a relay cannot be triggered for longer than a given time, written into permanent storage
- allows setting up Art-Net Universe & Start-Address

/*****************************************************************************************************************
 * Relay‑Board “ultimate” firmware – WT32‑ETH01 (ESP32)
 *
 * • OSC Heartbeat every 9s → /heartbeat  (MAC, relay bitmask, init‑flag, maxOn, windowLen, windowQuota, runtimeTotal)
 * • MAC‑based auto‑configuration
 *   ◦ unknown MAC ⇒ DHCP fallback + broadcast heartbeat
 * • OSC runtime API:
 *      /relay/control   i relay, i cmd, i ms?
 *      /relay/setup     i relay, i maxOn, i winLen, i winQ, i dmxAddr
 *      /relay/reset     i relay, i newCounter
 *      /heartbeat/request                    
 *      /artnet/config   i universe, i startAddr
 *      /storage/clear
 * • Art‑Net listener   (universe & start address configurable)
 *      DMX values: 0 off · 1‑127 on N×100 ms · 128 toggle · 129‑254 off (N‑128)×100 ms 255 on (indef.) 
 * • Safety, statistics, NVS persistence, mDNS, discovery probe … 
 *****************************************************************************************************************/