nearxos
6ef31cd12a
- Updated the output structure for `struct_room_outs` to focus solely on light states, removing unnecessary status feedback fields. - Simplified the control logic for lights 1 to 6, aligning with the new design approach for Option C. - Added detailed instructions for declaring `EtherCAT_RelayFeedback` and `EtherCAT_Outputs` in the Global Variable List, enhancing clarity for integration with the EL2809 module. This update improves the documentation's accuracy and usability for developers working on the home automation system.
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