nearxos
63b343f139
- Revised documentation to reflect the use of the EL2809 output module, including updated channel descriptions and process image details. - Introduced Option C for relay feedback, clarifying the method of using output copies for feedback instead of hardware read-back. - Enhanced comments and explanations in the main program logic to improve understanding of the relay feedback implementation across multiple rooms. This update improves the clarity and accuracy of the documentation for the home automation system's PLC algorithms.
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
Information Needed
See INFORMATION_NEEDED.md for what’s required to complete the documentation.
Maintenance
- Last Updated: January 27, 2026
- System Status: Operational