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>

docs/reference/hardware.md

@@ -0,0 +1,124 @@
+# Hardware Inventory
+
+## Overview
+
+Complete inventory of physical hardware components in the home automation system.
+
+## Control Hardware
+
+### Raspberry Pi
+
+- **Model**: [To be filled, e.g., Raspberry Pi 4 Model B]
+- **RAM**: [To be filled]
+- **Storage**: [To be filled]
+- **OS**: [To be filled]
+- **Purpose**: CODESYS Runtime
+- **Location**: [Physical location]
+- **Power Supply**: [To be filled]
+
+### Beckhoff EtherCAT IO Card
+
+- **Model**: [To be filled]
+- **Part Number**: [To be filled]
+- **I/O Channels**: [To be filled]
+- **Specifications**: [To be filled]
+- **Connection**: [EtherCAT connection details]
+
+### Relay Module
+
+- **Model**: [To be filled]
+- **Number of Channels**: [To be filled]
+- **Voltage/Current Ratings**: [To be filled]
+- **Connection**: [How it connects to EtherCAT card]
+
+## Zigbee Hardware
+
+### Coordinator
+
+- **Model**: [To be filled, e.g., CC2531, CC2652, etc.]
+- **Firmware**: [To be filled]
+- **Connection**: [USB, Ethernet, etc.]
+- **Location**: [Physical location for optimal coverage]
+
+### Zigbee Switches
+
+| Switch # | Model | Location | Functions | Notes |
+|----------|-------|----------|------------|-------|
+| 1 | [Model] | [Location] | [Functions] | |
+| 2 | [Model] | [Location] | [Functions] | |
+| ... | | | | |
+
+## Controlled Devices
+
+### Lighting
+
+| Light # | Type | Location | Controlled By | Relay # |
+|---------|------|----------|---------------|---------|
+| 1 | [Type] | [Location] | [Switch/Relay] | [Relay #] |
+| 2 | [Type] | [Location] | [Switch/Relay] | [Relay #] |
+| ... | | | | |
+
+### Water Boiler
+
+- **Model**: [To be filled]
+- **Type**: [To be filled]
+- **Control Interface**: [To be filled]
+- **Relay Assignment**: [To be filled]
+- **Safety Features**: [To be filled]
+
+## Network Hardware
+
+### Switches
+
+- **Model**: [To be filled]
+- **Ports**: [To be filled]
+- **Features**: [VLAN support, PoE, etc.]
+
+### Routers/Gateways
+
+- **Model**: [To be filled]
+- **Configuration**: [To be filled]
+
+## Host Systems
+
+### LXC Host
+
+- **Hardware**: [To be filled]
+- **OS**: [To be filled]
+- **Containers**: [List containers]
+
+### Other Hosts
+
+[Document other physical or virtual hosts]
+
+## Wiring
+
+### Power Distribution
+
+[Document power distribution if relevant]
+
+### Low Voltage Wiring
+
+[Document low voltage wiring for relays, sensors, etc.]
+
+### Network Cabling
+
+[Document network cable runs if relevant]
+
+## Physical Layout
+
+[Describe or diagram the physical layout of hardware]
+
+## Spare Parts
+
+- **Spare Components**: [List]
+- **Replacement Parts**: [List]
+
+## Maintenance Schedule
+
+- **Regular Maintenance**: [Schedule]
+- **Component Lifespan**: [Expected lifespan of components]
+
+---
+
+**Status**: Template - needs hardware details