Imported from GitHub: jirihusak/majordomus · commit c8d1d12 · license GPL-3.0

Description

Open source system for smart home

README

Majordmus - Open source system for Smart Home

About

Majordomus is a modular automation system built on open standards. It fills the gap between closed, expensive commercial solutions and unreliable consumer-grade components — designed to be repairable, expandable, and to last for decades.

Features

• 🧩 Modular hardware — base unit + interchangeable modules ( I/O, sensors)
• 🔌 Standardized interface — RS-485 / ModBus HW interface, MQTT SW interface
• 🔓 Vendor lock-in free — open hardware, open software, your choice
• 🧠 Node-RED inside — visual programming for automation flows
• 🧠 Home Assistant interface — MQTT integration for popular platform
• 📡 Offline-first — works without internet, cloud is optional

Use Cases

Domain	Examples
🏠 Smart home	lighting, heating, blinds, security, energy management
🏭 Industry	machine control, data acquisition, monitoring, alarms
📊 Monitoring	weather, air quality, energy meters, IoT sensors

Architecture

   ┌─────────────────────┐
   │      node-RED       │
   │   Home Assistant    │
   └──────────┬──────────┘
              │
             MQTT
              │
   ┌──────────┴──────────┐
   │ Majordomus Control  │
   │    MQTT bridge      │
   └──────────┬──────────┘
              │
       Modbus / RS-485
              │
    ┌─────────┼─────────┐
    │         │         │
   Unit A   Unit B   Unit C
  (+ modules) (+ modules) (+ modules)

Hardware

🌡️ RoomSensor

All-in-one ambient monitoring unit for indoor environments.

• 🌡️ Temperature & humidity
• 💨 CO₂, VOC & NOx measurement
• 🚶 PIR motion detection
• ☀️ Ambient light (lux)
• 🔊 Ambient noise measurement
• 🖥️ Display with 3 buttons
• 🔔 Piezo buzzer for acoustic signaling
• 🔌 Digital I/O for door/window contacts or local buttons
• 🔗 I²C port for external sensors
• 🏠 Wall-mount

🔲 BoxIO

Compact relay & input unit for in-wall or junction-box installation.

• ⚡ Replaceable relay outputs (electromagnetic or SSR)
• 🔘 Digital inputs for buttons
• 📊 Hardware input counters for energy monitoring
• 🎛️ Manual control of all outputs (AUTO / MAN ON / MAN OFF)
• 🔗 I²C port for external sensors

🎛️ RoomIO

Multi-purpose I/O unit for room-level automation and control.

• 🔘 Digital inputs & outputs
• 📥 Analog inputs (ADC) — 0–10 V
• 📤 Analog outputs (DAC) — 0–10 V for dimming, fan speed, valves
• 📊 Hardware input counters for energy monitoring
• 🔗 I²C port for external sensors

Schematics and BOMs live in hardware/.

Software

Majordomus Control

Bridge from HW modules to MQTT interface

Node-RED - Custom Node-RED nodes

Documentation

• Documentation web

Contributing

Contributions welcome — hardware, firmware, Node-RED flows, or docs.

Contact

• Web: majordomus.tech