Home Automation System

Overview

This project documents a comprehensive home automation system built around a Raspberry Pi running CODESYS, integrated with Node-RED, Zigbee2MQTT, MQTT broker, and Home Assistant.

System Architecture

• CODESYS Runtime (Raspberry Pi) — Industrial control, physical I/O
• Beckhoff EtherCAT IO — Relays for lighting and water boiler
• Node-RED — Automation logic and integration
• MQTT Broker (LXC) — Message broker
• Zigbee2MQTT — Zigbee ↔ MQTT bridge
• Home Assistant — Dashboard and automation
• Zigbee Switches — Wireless light switches

Project Structure

kkelomatic_home/
├── codesys/                 # CODESYS project and exports
│   ├── Home_Automation (1).project
│   ├── Home_Automation.export
│   ├── Home_Automation.xml
│   └── Home_Automation.projectarchive
├── docs/                    # Documentation
│   ├── README.md            # Documentation index (start here)
│   ├── codesys/             # CODESYS docs
│   ├── integration/        # Node-RED, MQTT, HA, Zigbee
│   ├── redesign/           # Redesign and implementation
│   └── reference/           # Architecture, hardware, setup
├── scripts/                 # Helper scripts
│   └── parse-codesys-xml.py
├── INFORMATION_NEEDED.md
└── README.md

Documentation

See docs/README.md for the full documentation index.

Quick links

• Architecture
• CODESYS Configuration
• Setup Guide
• Redesign Summary
• Light Naming Configuration

Information Needed

See INFORMATION_NEEDED.md for what’s required to complete the documentation.

Maintenance

• Last Updated: January 27, 2026
• System Status: Operational