Files

nearxos bf7bd56fe7 Initial commit: Home automation docs and CODESYS project

- Reorganized project: codesys/, docs/codesys|redesign|integration|reference/, scripts/
- CODESYS project and exports in codesys/
- Documentation index in docs/README.md
- Redesign and light naming configuration
- Water boiler control and safety design

Co-authored-by: Cursor <cursoragent@cursor.com>

2026-02-07 21:52:46 +02:00

2.0 KiB

Raw Blame History

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

2.0 KiB Raw Blame History Unescape Escape