HomeMaster WLD-521-R1
The HomeMaster WLD-521-R1 is a DIN-rail water management I/O module for leak detection, pulse water metering, optional heat energy (ΔT) monitoring, and local irrigation logic. It provides five opto-isolated digital inputs, two SPDT relay outputs, isolated sensor power rails, a protected 1-Wire bus for DS18B20 probes, RS-485 Modbus RTU, and USB-C WebConfig.
The module operates from 24 V DC and integrates with HomeMaster MicroPLC, MiniPLC, or any Modbus RTU master. Configuration is stored in onboard flash; local logic can run autonomously while I/O and telemetry remain visible to the PLC, SCADA, or Home Assistant (via ESPHome/Modbus).
Through a MiniPLC or MicroPLC running ESPHome, the module appears in Home Assistant over the native ESPHome API — no MQTT broker, no Modbus register mapping in Home Assistant and no custom converters. Entities are ready to use within seconds, with low latency and no cloud.
Quick Overview
- Water leak, flow, irrigation, and hydronic-oriented Modbus expansion module
- DIN-rail enclosure; 24 V DC supply (V+ / 0V)
- 5 × opto-isolated digital inputs (I1–I5 + GND_ISO); configurable sensor / counter modes
- 2 × SPDT relay outputs (NO / COM / NC); dry contacts — observe system current/voltage limits
- Isolated +5 V and +12 V sensor rails (low-power field sensors only)
- 1-Wire interface (+5 V / DATA / GND) for temperature probes (e.g. DS18B20)
- RS-485 Modbus RTU (A / B / COM) and USB-C WebConfig
- 4 buttons and 4 user LEDs (plus power / comm / relay status LEDs)
Typical Applications
- Basement / utility leak alarms and automatic shut-off valve control
- Pulse water meters and consumption totals (litres)
- Garden or zone irrigation with flow supervision and interlocks
- Hydronic heat monitoring (flow + supply/return temperatures)
- Building water safety and BMS remote I/O
- PLC / SCADA Modbus slave node for water-related signals
- Home Assistant via ESPHome on the RS-485 master controller
Tech Specs
| Specification | Details |
|---|---|
| Microcontroller | RP2350A dual-core microcontroller |
| Flash memory | External QSPI flash (W25Q32JV, 32 Mbit) |
| Power input | 24 V DC nominal (V+ / 0V). Input protection: 1 A time-lag fuse, reverse-polarity diode, TVS, EMI filtering |
| Module power | Typical 3 W (logic + RS-485 + USB-C); maximum 5 W (both relays on + isolated +12 V ISO and +5 V ISO rails loaded + all 5 DI active + RS-485 traffic) |
| Main logic supplies | Buck 24 V → ~5 V; 3.3 V LDO |
| Digital inputs | 5 × isolated 5 V DC discrete inputs (I1–I5 + GND_ISO). Max input voltage: 5 V DC continuous (field wiring per manual) |
| Relay outputs |
2 × SPDT dry-contact relays. Rated load (system limit): 3 A @ 250 V AC (resistive); max 750 VA @ 250 V AC, 90 W @ 30 V DC. Relay components (informative only) may be rated higher; that rating does not apply to the complete module. Relay outputs are not internally fused. |
| Isolated outputs | +12 V ISO: 12 V isolated rail, 2 W; ≤150 mA recommended (≤167 mA theoretical). +5 V ISO: 5 V isolated rail, 1 W; ≤150 mA recommended (≤200 mA theoretical). For low-power sensors only — not for actuators |
| 1-Wire | 1 × protected bus (+5 V, DATA, GND) for 1-Wire sensors |
| User interface | 4 buttons; 9 LEDs (power, 4 user, RX, TX, relay 1, relay 2) |
| Communication | RS-485 Modbus RTU (MAX485, half-duplex), non-isolated; TVS surge protection, PTC fuses, common-mode choke, fail-safe biasing |
| USB | USB-C, 5 V logic, ESD protected — configuration and firmware |
| Storage | LittleFS persistent configuration |
| Modbus address | 1–247 (default: 3) |
| Modbus baud rate | 9600–115200 (default: 19200), 8N1 |
Installation, Environmental & Mechanical
| Category | Specification | Details |
|---|---|---|
| Terminal specifications | Terminal type | Pluggable screw terminal blocks, 5.08 mm pitch |
| Wire cross-section | 0.2–2.5 mm² (AWG 24–12) | |
| Conductor type | Solid or stranded copper; ferrules recommended | |
| Tightening torque | 0.4–0.6 Nm | |
| Environmental ratings | Operating temperature | 0 °C to +40 °C |
| Storage temperature | −10 °C to +55 °C | |
| Relative humidity | 0–90 % RH, non-condensing | |
| Ingress protection | IP20 (inside cabinet) | |
| Maximum altitude | 2000 m | |
| Pollution degree | 2 | |
| Mechanical & packaging | Product dimensions | 71.5 × 90 × 59 mm (L × W × H) |
| DIN width | 4 modules (4 × 17.5 mm) | |
| Mounting | 35 mm DIN rail (EN 50022) | |
| Enclosure | PC/ABS, UL94-V0 | |
| Net / gross weight | See product label / packing slip | |
| Pack size | 140 × 125 × 94 mm (L × W × H) | |
| Mechanical drawing | Front + side views with DIN-clip depth in the datasheet PDF |
Install only inside a control cabinet with ventilation; the cabinet must include a protective front plate covering all module connection terminals and a closing protective door; not for outdoor or exposed installation.
All wiring terminals must be protected against accidental contact by an insulating front plate, wiring duct, or terminal cover. Exposed live terminals are not permitted.
Home Assistant / Modbus / Web Config Integration
The WLD-521-R1 supports:
- HomeMaster MicroPLC and MiniPLC as Modbus masters
- PLC and SCADA via Modbus RTU
- Home Assistant using ESPHome (on the controller) or a Modbus integration
- USB-C setup with WebConfig (Chrome / Edge, Web Serial)
Configuration is saved to flash and restored at power-up.
Quick Setup (USB-C WebConfig)
- Mount & power — DIN rail; connect 24 V DC to V+ / 0V.
- USB-C — connect to the PC.
- Open WebConfig — WebConfig in Chrome or Edge.
- Connect device — Connect → select the serial port.
- Modbus — set address (1–247) and baud rate (9600–115200).
- I/O & logic — inputs (sensor / counter / heat), relays, LEDs, buttons, irrigation zones as required.
- Save — disconnect USB-C for field operation if desired.
WebConfig highlights
- Per-DI mode: water sensor, soil moisture, water counter (flow)
- Counter: pulses per litre, calibration, totals and live rate
- Optional heat: 1-Wire sensors A/B, cp, ρ, power and energy
- Relay source: Modbus, local logic, override
- LED mapping (solid/blink) and button actions
- Irrigation zones with flow supervision and time windows
Register-level detail: Modbus_Table.md and README.md.
Minimal ESPHome YAML (controller side)
Use on MiniPLC/MicroPLC (ESPHome): enables RS-485 and imports the WLD package.
uart:
id: uart_modbus
tx_pin: 17
rx_pin: 16
baud_rate: 19200
parity: NONE
stop_bits: 1
modbus:
id: modbus_bus
uart_id: uart_modbus
turnaround_time: 100ms
send_wait_time: 250ms
packages:
wld1:
url: https://github.com/isystemsautomation/homemaster-dev
ref: main
files:
- path: WLD-521-R1/Firmware/v0.1.0/default_wld_521_r1_plc/default_wld_521_r1_plc.yaml
vars:
wld_prefix: "WLD#1"
wld_id: wld_1
wld_address: "4"
refresh: 1d
ESPHome 2026.7.0 raised the Modbus client defaults —
turnaround_timefrom 100 ms to 600 ms andsend_wait_timefrom 250 ms to 2000 ms (PR #11969).At the 600 ms default the bus carries only about 1.5 Modbus transactions per second, whatever the UART speed, because the controller stays silent for 600 ms after every response. Two modules on one RS-485 bus become slow to respond. With three or more, one module can stop being polled altogether — with no timeout and no CRC error in the log.
On ESPHome 2026.7.0 and newer, set both values explicitly as shown above. On earlier releases these were the defaults and the two lines are not required.
wld_address must match the Modbus address set in WebConfig (factory default is often 3).
Documentation
The WLD-521-R1 is open-source hardware. Firmware, tools, and design files are published in the HomeMaster repository.
Hardware design files
| File | Description | Link |
|---|---|---|
| Field board schematic | Inputs, 1-Wire, isolated sensor rails | WLD-521-R1-FieldBoard.pdf |
| MCU board schematic | Controller, USB, RS-485, power conversion | WLD-521-R1-MCUBoard.pdf |
| Relay board schematic | Relay outputs and contact circuitry | WLD-521-R1-RelayBoard.pdf |
Compliance Documents
| File | Description | Link |
|---|---|---|
| EU Declaration of Conformity (DoC) | Signed EU Declaration of Conformity per Reg. (EC) 765/2008 and Decision 768/2008/EC | DoC_WLD-521-R1.pdf |
| Datasheet | Technical specifications and electrical characteristics | WLD-521-R1_Datasheet.pdf |
Firmware & software
| Resource | Description | Link |
|---|---|---|
| Datasheet | Official specifications, terminals, compliance summary | WLD-521-R1_Datasheet.pdf |
| Firmware & tools | Source, WebConfig page, binaries | GitHub — Firmware |
| Integration guide | Setup, Modbus, ESPHome, use cases | README.md |
| Modbus register table | Compact FC / address reference | Modbus_Table.md |
Connectors & terminal map
Top row (24Vdc | INPUTS | 1-WIRE)
| Pos | Label | Group | Function |
|---|---|---|---|
| 1 | V+ | POWER | 24 V DC input |
| 2 | 0V | POWER | 24 V DC return |
| 3 | I.1 | INPUTS | Input 1 |
| 4 | I.2 | INPUTS | Input 2 |
| 5 | I.3 | INPUTS | Input 3 |
| 6 | I.4 | INPUTS | Input 4 |
| 7 | I.5 | INPUTS | Input 5 |
| 8 | Gnd | INPUTS | Isolated input return (GND_ISO) |
| 9 | +5V | BUS | 1-Wire supply (logic domain, not isolated) |
| 10 | D | BUS | 1-Wire data |
| 11 | Gnd | BUS | 1-Wire ground (logic) |
Bottom row (RS-485 | RELAY OUTPUT | PS 5/12 Vdc)
| Pos | Label | Group | Function |
|---|---|---|---|
| 1 | B | RS485 | RS-485 data - |
| 2 | A | RS485 | RS-485 data + |
| 3 | COM | RS485 | RS-485 signal reference |
| 4 | NO | RELAY1 | Relay 1 normally open |
| 5 | C | RELAY1 | Relay 1 common |
| 6 | NC | RELAY1 | Relay 1 normally closed |
| 7 | NO | RELAY2 | Relay 2 normally open |
| 8 | C | RELAY2 | Relay 2 common |
| 9 | NC | RELAY2 | Relay 2 normally closed |
| 10 | 5Vdc | PS | Isolated sensor rail +5 V |
| 11 | 12Vdc | PS | Isolated sensor rail +12 V |
Ports & service interfaces
| Id | Type | Note |
|---|---|---|
| USB-C | Web-Serial config | ESD-protected; not a field power source. |
Housing notes
- One shared Gnd (GND_ISO) for all five inputs, not one per channel.
- The Gnd on the top-row BUS block is the logic domain. Do not power field sensors from it - use the isolated PS rails.
- Isolated sensor rails 5 Vdc and 12 Vdc, 150 mA total.
Cabling and Wirings
24 V DC supply (V+ / 0V)
- Use a SELV 24 V DC supply within the rated input range
- Observe polarity; input is reverse-polarity protected
- Size the supply for module + relay coils + modest sensor rail load
Digital inputs (leak / moisture / contacts)
Pulse flow meter (counter mode)
1-Wire temperature sensors
Relay outputs (NO / COM / NC)
External protection required: each load shall be protected by a suitable fuse or breaker. Relay contacts are not internally fused. Relay terminals may switch hazardous voltage — install per applicable electrical codes.
RS-485 / Modbus RTU
Terminal order differs across the HomeMaster range. Always read the silkscreen - do not wire by habit from another module. On this module the order is B-A-COM. Swapping A and B damages nothing but the node will not communicate. COM is required on every node.
All HomeMaster controllers and modules share the same RS-485 front end.
| Item | Value |
|---|---|
| Transceiver | MAX485CSA+T, half-duplex |
| Galvanic isolation | None — the transceiver shares the device's logic ground |
| Common-mode range | −7 V … +12 V referred to the device's own ground (MAX485 limit) |
| Terminals | A / B / COM |
| Surge protection | 3 × SMAJ6.8CA TVS (A–COM, B–COM, A–B) |
| Overcurrent | 2 × resettable PTC, 1.5 A hold, in series with A and B |
| EMI filtering | Common-mode choke on the A/B pair; COM referenced through 1 MΩ ∥ 4.7 nF |
| Idle state | Fail-safe biasing on board — do not add external bias resistors |
| Termination | 120 Ω at the two physical ends of the bus only |
Bus wiring rules — apply to every device on the bus:
- One twisted pair for A/B, 120 Ω characteristic impedance.
- Run COM to every node. Required, not optional: the ports are not isolated, and COM is what bounds the common-mode voltage the transceivers see.
- Prefer one power supply for the whole bus, distributed in star topology. With separate supplies, additionally tie the 0 V references together at a single point.
- Bond the cable shield to cabinet PE at one end only. Never land a shield on A, B or COM.
- Where the bus crosses into a different electrical installation with its own earthing reference — a utility or billing meter, another building, another cabinet's PE system — fit an external galvanic RS-485 isolator at that boundary. The on-board components are transient protection, not isolation, and will not survive a sustained ground-potential difference.
| Terminal | Function |
|---|---|
| A | RS-485 A |
| B | RS-485 B |
| COM | RS-485 common / reference |
Cable Recommendations & Shield Grounding
Use shielded, twisted constructions and bond shields correctly to reduce EMI and ground-loop issues (per datasheet).
General routing rules
- Route low-level signal cables separately from power and relay load wiring
- If crossing power cables is unavoidable, cross at 90°
- Keep runs short; avoid long parallel routing with high-current conductors
- Label cables and provide strain relief at terminals
Digital inputs & sensor cables
- Twisted pair from each sensor to the corresponding Ix and return
- Wire size compatible with 5.08 mm terminals (e.g. 0.2–2.5 mm²)
- In noisy panels, prefer shielded cable; terminate shields per the shielding section below — not to signal terminals
RS-485 (Modbus) cable
- Twisted pair for A/B; characteristic impedance ~120 Ω recommended
- Shielded cable recommended in industrial environments
- Second conductor or pair for COM reference where required by the network design
Shield grounding
- Bond cable shield(s) to cabinet PE/EMC ground at one end (PLC/controller side typical)
- Do not connect shields directly to A, B, or COM signal terminals
- Keep shield pigtails short and low-inductance
System Architecture & Pinout
Safety and Installation Notes
- SELV on power and signal terminals as defined in the datasheet; relay contacts may switch up to 250 V AC — observe separation, insulation, and local electrical codes
- Installation by qualified personnel only
- Indoor control cabinet; IP20; protect all terminals from accidental touch
- Respect the 3 A / 750 VA / 90 W system limits for relay loads; use contactors for higher currents or demanding inductive loads
- Provide external fuses or breakers for every switched load; snubbers or suppression for inductive DC/AC loads where required
- Do not power valves, pumps, or heavy actuators from +5 V ISO / +12 V ISO — sensors only, within current limits
- Do not exceed 5 V DC on digital inputs (datasheet continuous maximum)
- USB-C is intended for configuration/diagnostics — not a field power input
Compliance & Certifications
The WLD-521-R1 module is CE marked. ISYSTEMS AUTOMATION S.R.L. (HomeMaster® brand) maintains the technical documentation and a signed EU Declaration of Conformity (DoC) available for download in the Documents and Resources section above.
- EMC Directive 2014/30/EU — EN 55032:2015 (Class B emissions), EN 55035:2017 (immunity), tested by Idvorsky Laboratories Ltd. (Job #1648)
- Low Voltage Directive 2014/35/EU — EN 62368-1:2020 + A11:2020, in-house dielectric and isolation testing by ISYSTEMS AUTOMATION compliance laboratory
- RoHS Directive 2011/65/EU — EN IEC 63000 technical documentation
- HomeMaster® — registered EU trademark (EUTM No. 019082911, EUIPO, registered 15 January 2025)
Build Guides & Tutorials
Step-by-step projects that use the WLD-521-R1.
Fireplace automation where the WLD-521-R1 handles pulse flow metering and the heat counter (flow + supply/return ΔT).
Related products
These other products might interest you