homemaster-dev

🚧 Project Status: Under Active Development & Testing

Important Notice: This documentation, hardware designs, and firmware are for the pre-release version of the HomeMaster system. All information is preliminary and may contain errors or be subject to change.

Please use this information for evaluation and development purposes only

HOMEMASTER – Modular, Resilient Smart Automation System

License: CERN-OHL-W v2 + GPLv3 + MIT Status: Open Hardware Works with: ESPHome & Home Assistant Home Assistant

Releases: see the latest tagged build on GitHub Releases. Versioning uses YYYY‑MM.
Fully open‑source hardware, firmware, and configuration tools.

🛠️ Hardware Guide

HomeMaster is an industrial‑grade, modular automation system for smart homes, labs, and professional installations. It features:

Local resilience: Modules include onboard logic and continue functioning even if the controller or network is offline.

System Architecture

%%{init: {"flowchart":{"htmlLabels":true,"nodeSpacing":50,"rankSpacing":60}}}%%
flowchart TD
  %% Classes
  classDef hub fill:#EDEFFB,stroke:#6B72FF,stroke-width:1.2px,color:#111,font-weight:bold;
  classDef big fill:#EDEFFB,stroke:#1F35FF,stroke-width:3px,color:#111,font-weight:bold,font-size:28px;
  classDef mod fill:#FFFffC,stroke:#E0B100,stroke-width:1.2px,color:#111,font-weight:bold,font-size:22px;
  classDef ghost fill:transparent,stroke:transparent,color:transparent;

  %% Double-sized HA and PLC (bigger font + extra line breaks)
  HA["Home Assistant<br/><br/>"]:::big --> PLC["MiniPLC / MicroPLC<br/><br/>"]:::big
  PLC --> RS485[RS-485 Bus]:::hub

  %% Subgraph with taller nodes; extra <br/> increases node height
  subgraph Mods["<br/>"]
    ENM[ENM‑223‑R1<br>⚡ Energy Meter]:::mod
    ALM[ALM‑173‑R1<br>🚨 Alarm I/O]:::mod
    DIM[DIM‑420‑R1<br>💡 AC Dimmer]:::mod
    AIO[AIO‑422‑R1<br>🌡️ Analog I/O]:::mod
    RGB[RGB‑621‑R1<br>🎨 LED Controller]:::mod
    DIO[DIO‑430‑R1<br>🔌 Digital I/O]:::mod
    STR[STR‑3221‑R1<br>💫 Staircase LED]:::mod
    WLD[WLD‑521‑R1<br>💧 Leak Detection]:::mod
    SP1["<br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/>"]:::ghost
  end
  style Mods fill:#FFFFFF,stroke:#E0B100,stroke-width:1.5px, font-weight:bold,font-size:22px

  %% Edges
  RS485 --> ENM
  RS485 --> ALM
  RS485 --> DIM
  RS485 --> AIO
  RS485 --> RGB
  RS485 --> DIO
  RS485 --> STR
  RS485 --> WLD

🎯 Quick Module Selector

Controller Comparison

Feature / Use Case 🟢 MiniPLC
MiniPLC		 🔵 MicroPLC
MicroPLC
Size Full‑width DIN enclosure Compact DIN enclosure
Onboard I/O 6× Relays, 4× DI, 2× RTD, 2× AI/O, Display, RTC 1× Relay, 1× DI, 1‑Wire, RTC
Connectivity Ethernet, USB‑C, Wi‑Fi, BLE + Improv USB‑C, Wi‑Fi, BLE + Improv
Storage microSD card slot Internal flash only
Ideal For Full homes, labs, HVAC/solar, automation pros Makers, room‑level, modular expansion setups
Power Input AC/DC wide range or 24 VDC 24 VDC only

Module Overview

Image Module Inputs Outputs Key Features Best For
ENM‑223‑R1 ENM‑223‑R1 3‑Phase CTs 2 Relays Per‑phase power metrics Solar, grid monitoring
ALM‑173‑R1 ALM‑173‑R1 17 DI 3 Relays AUX power, alarm logic Security systems
DIM‑420‑R1 DIM‑420‑R1 4 DI 2 Dimming Phase‑cut dimming Lighting control
AIO‑422‑R1 AIO‑422‑R1 4 AI + 2 RTD 2 AO 0‑10V I/O, PT100/1000 HVAC, sensors
DIO‑430‑R1 DIO‑430‑R1 4 DI 3 Relays Override buttons, logic mapping General control
RGB‑621‑R1 RGB‑621‑R1 2 DI 5 PWM + 1 Relay RGB+CCT, smooth fades Color lighting
STR‑3221‑R1 STR‑3221‑R1 3 DI 32 LED Channels Animated sequences Architectural lighting
WLD‑521‑R1 WLD‑521‑R1 5 DI + Temp 2 Relays Leak detection, pulse metering Safety systems

🚀 Quick Start

5‑Minute Setup

  1. Power the controller — ESPHome is pre‑installed on MiniPLC and MicroPLC.
  2. Join Wi‑Fi with Improv — Use Improv (BLE or Serial) to set Wi‑Fi and adopt the device.
  3. Wire RS‑485 — A/B differential pair; 120 Ω termination at both bus ends.
  4. Configure each module — Connect via USB‑C and use WebConfig to set Modbus address and module settings (calibration, mapping, rules).
  5. Open Home Assistant — Add the ESPHome controller; modules appear as entities via the controller config.

⚙️ Configuration

Compatibility

| Component | Home Assistant | ESPHome | Standalone | |—|—|—|—| | All Modules | ✅ Full | ✅ Native | ✅ Basic | | MiniPLC | ✅ Full | ✅ Pre‑installed | ✅ Full | | MicroPLC | ✅ Full | ✅ Pre‑installed | ✅ Basic |

Controller Setup

All HomeMaster controllers come with ESPHome pre‑installed and support Improv onboarding:

  1. Power on the controller
  2. Connect via improv-wifi.com (BLE or USB)
  3. Enter Wi‑Fi credentials
  4. Appears in ESPHome Dashboard & Home Assistant

Module Configuration (WebConfig)

Each module includes USB WebConfig — no drivers needed:

💡 WebConfig works in Chrome/Edge — just plug in USB‑C and click Connect

Networking

🔧 Advanced

Firmware Development

All HomeMaster controllers and modules support firmware customization via USB‑C.

USB‑C Developer Flashing

Both controllers and modules support easy flashing and auto-reset via USB‑C, with no need to press BOOT or RESET buttons.

⚠️ Note: All controllers and modules ship with pre-installed firmware.

Flashing is only required for advanced users who want to replace default firmware.

Arduino & PlatformIO Notes

Home Assistant Example (ESPHome)

# Example ESPHome configuration for Alarm Module
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

# ---------- Pull ALM Modbus entities from GitHub ----------
packages:

  alm1:
    url: https://github.com/isystemsautomation/homemaster-dev
    ref: main
    files:
      - path: ALM-173-R1/Firmware/default_alm_173_r1_plc/default_alm_173_r1_plc.yaml

📚 Resources

🎓 Learning & Community

⚠️ Safety Information

Electrical Safety

Installation

Device‑specific Warnings

License

Licensing

This project uses a hybrid licensing model.

Hardware

Hardware designs (schematics, PCB layouts, BOMs) are licensed under: CERN-OHL-W v2

Firmware & ESPHome Integration

All firmware, ESPHome configurations, and software components are licensed under: MIT License

This ensures full compatibility with ESPHome and Home Assistant while protecting hardware designs.

See LICENSE files in each directory for full terms.

🔄 Version Info

Current: HomeMaster 2024.12+ series
Check: Releases page for version‑specific notes