c2f6655aaea2cbb070eae88df7cecf2b6de19854
- Updated data structures for input and output to align with redesign recommendations - Clarified function block logic for fb_lightControl and fb_switch - Improved command handling and priority logic in the fb_lightControl implementation - Added detailed comments for better understanding of the algorithm flow This update ensures consistency with the redesign documentation and improves clarity for future development.
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
Description
Languages
JavaScript
69.8%
Smalltalk
22%
Python
8.2%