nearxos
86ed249e4c
- Introduced new naming conventions for data types and function blocks to align with the redesign - Updated references in the documentation to reflect changes from `fb_switch` to `fb_room` and `fb_lightControl` to `fb_light` - Enhanced clarity in the mapping of existing to new names for better understanding of the redesign This update improves consistency and readability in the documentation 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