kkelomatic_home/docs/redesign/redesign-summary.md

Redesign Summary - Quick Reference

What We're Changing

Current Structure → New Structure

Before:

• Room-based with generic l_1, l_2 names
• Fixed 6 lights per room
• Toggle-based control
• No status feedback from relays

After:

• Room-based in CODESYS, flat in Home Assistant
• Descriptive names: kitchen_main, master_bedroom_bedside_left
• Command-based control (ON/OFF for HA, toggle for Zigbee)
• Actual relay status feedback
• Water boiler with comprehensive safety

---

Key Documents

1. light-naming-configuration.md ⭐ START HERE

   • Complete light naming for all 16 rooms
   • Water boiler control structure
   • Safety measures
   • Action: Review and modify with your actual lights

2. redesign-implementation-roadmap.md

   • Step-by-step implementation guide
   • Phase-by-phase checklist
   • Timeline estimates

3. structure-redesign-analysis.md

   • Detailed analysis of structure options
   • Why Option 4 (Hybrid) was chosen

4. fb_switch-redesign-recommendation.md

   • Function block redesign details
   • Control logic improvements

---

Quick Structure Reference

Light Naming Convention

Format: {room}_{function}

Examples:
- kitchen_main
- master_bedroom_bedside_left
- outdoor_front_security

Function Types

• main - Primary light
• bedside_left/right - Bedside lamps
• under_cabinet - Task lighting
• security - Security lighting
• ambient - Atmospheric lighting
• etc.

CODESYS Access

rooms.kitchen.main.ha_on := TRUE;
rooms.master_bedroom.bedside_left.state;

Home Assistant Entity

light.kitchen_main
light.master_bedroom_bedside_left

---

Water Boiler Safety Features

1. ✅ Temperature Protection (max 80°C, min 10°C)
2. ✅ Time Limits (max 8h ON, min 30m OFF)
3. ✅ Flow Detection (shut off if no flow)
4. ✅ Emergency Stop (immediate shutdown)
5. ✅ Pressure Protection (if sensor available)
6. ✅ State Monitoring (relay status readback)
7. ✅ Error Reporting (comprehensive error codes)

---

Next Steps

1. Review light-naming-configuration.md
2. Modify light names per room based on actual installation
3. Map relays to lights
4. Start Phase 1 of implementation roadmap

---

Status: Ready for configuration review
Priority: Review and customize light names first