haus-steuerung/PROJECT.md

Haussteuerung V2 - Projekt Dokumentation

Projektübersicht

Webbasierte Haussteuerung für SPS-Steuerung (AWP-Webserver)

Dateistruktur

web/
├── indexV2.htm           # Hauptseite mit Iframes
├── form.css              # Zentrales CSS
├── lichtV2.htm           # Lichtsteuerung
├── heizungV2.htm         # Heizungssteuerung
├── steckdosenV2.htm      # Steckdosensteuerung
├── rolladen.htm          # Rolladensteuerung
├── stromzaehler.htm      # Stromzähler mit Chart
├── licht_state.html      # Licht Status (wird von SPS befüllt)
├── heizung_state.html    # Heizung Status
├── steckdosen_state.html # Steckdosen Status
├── stromzaehler_state.html # Stromzähler Status
├── WebAppConfig.json     # AWP-Webserver Konfiguration
├── Script/
│   └── tth_script.js     # JavaScript Funktionen
└── images/               # Bilder und Icons

AWP Variablen

Licht (lichtV2.htm)

• "Lichtmerker Küche"
• "Lichtmerker Essen"
• "Lichtmerker Wohnen 1"
• "Lichtmerker Wohnen 2"
• "Lichtmerker HWR"
• "Lichtmerker Arbeiten"
• "Lichtmerker Kind 3"
• "Lichtmerker Dusche"
• "Lichtmerker Abstellraum"
• "Lichtmerker Eltern"
• "Lichtmerker Noah"
• "Lichtmerker Niko"
• "Lichtmerker Bad"
• "Kickertaste"
• "wled_DB".Helligkeit
• "wled_DB".Befehl
• "wled_DB".RGB_hex

Heizung (heizungV2.htm)

• "Temp Wohnen", "Temp Arbeiten", "Temp HWR", "Temp Bad", "Temp Eltern", "Temp Noah", "Temp Mika", "Temp Niko", "Temp Dusche"
• "Einstellungen".Heizung."Heizung Wohnen min/max"
• "Einstellungen".Heizung."Heizung Arbeiten min/max"
• "Einstellungen".Heizung."Heizung HWR min/max"
• "Einstellungen".Heizung."Heizung Bad min/max"
• "Einstellungen".Heizung."Heizung Eltern min/max"
• "Einstellungen".Heizung."Heizung Kind1 min/max"
• "Einstellungen".Heizung."Heizung Kind2 min/max"
• "Einstellungen".Heizung."Heizung Gäste min/max"
• "Einstellungen".Heizung."Heizung Dusche min/max"

Steckdosen (steckdosenV2.htm)

• "Steckdose Deele Garder"
• "Steckdose Wohnen"
• "Steckdose Essen"
• "Steckdose Arbeiten"
• "Steckdose Kind 1"
• "Steckdose Kind 2"
• "Steckdose Gäste"
• "Steckdose Eltern"
• "Arduino Settimio"."Funksteckdose 1 an/aus"
• "Arduino Settimio"."KDY 1 an/aus"
• "Arduino Settimio"."KDY 2 an/aus"
• "Arduino Settimio"."Funksteckdose 4 an/aus"

Rolladen (rolladen.htm)

• "Rolladenmerker Ess l/r/m auf/ab"
• "Rolladenmerker Woh l/r auf/ab"
• "Rolladenmerker Wohtü auf/ab"
• "Rolladenmerker Arbei auf/ab"
• "Rolladenmerker HWR auf/ab"
• "Rolladenmerker Küc l/r auf/ab"
• "Rolladenmerker Elter auf/ab"
• "Rolladenmerker Noah auf/ab"
• "Rolladenmerker Bad auf/ab"
• "Rolladenmerker Niko auf/ab"
• "Rolladenmerker Mika auf/ab"
• "Rolladenmerker Dusche au/ab"
• "Rolladen alle auf/ab"
• "Jalousie_DB".Urlaub

Stromzähler (stromzaehler.htm)

• 12 Zählerwerte aus stromzaehler_state.html
• Berechnung: -1 bis -8 als Differenzwerte

Sonstige (indexV2.htm)

• "Aufgang_Untergang".aktuelle_CPU_Zeit.*
• "Aufgang_Untergang".Aufgang.HOUR/MINUTE
• "Aufgang_Untergang".Untergang.HOUR/MINUTE
• "Aufgang_Untergang".Aufgang_offset
• "Aufgang_Untergang".Untergang_offset
• "Türöffner Handy"
• "Arduino Settimio".Garagentor 1
• "Arduino Settimio".Garagentor 2

CSS (form.css)

• .ui-card - Card-Container mit Hintergrund
• .ui-table - Tabellen-Styling
• .ui-btn - Button-Styling (primary, on, off)
• .ui-iconbtn - Icon-Buttons
• .auto-style6 - Versteckte Status-Elemente (color: transparent, font-size: 1px)

JavaScript

• tth_script.js - Icon-Funktionen (leuchtet_icon, heizt_icon, strom_icon, urlaub_icon)
• Iframe-Resize in indexV2.htm
• Stromzähler: Differenzberechnung für -1 bis -8
• Stromzähler: Canvas-basierter Leistungs-Chart (letzte 5 Min.)

Wichtige Änderungen

• OutputArea in allen Seiten mit clip:rect(0,0,0,0) versteckt
• Header-Zeile "Raum | Taster" aus steckdosenV2.htm und rolladen.htm entfernt
• Erste Tabellenzeile nicht mehr hervorgehoben
• Stromzähler-Werte untereinander angeordnet
• Stromzähler: -1 bis -8 als Differenzwerte

Server

• AWP-Webserver auf SPS (192.168.0.90)
• Standard-Seite: indexV2.htm

V3 (Single-Page, neu)

Parallel zu V2, lässt V2 unangetastet. Erreichbar über indexV3.htm.

Dateien V3

• indexV3.htm — Produktivseite mit SPS-Web-API-Anbindung.
• indexV3_preview.htm — reine Optik-Vorschau ohne SPS, mit Dummy-Daten.
• formV3.css — CSS für V3 (Grid, Karten, responsive Stromzähler-Bereich).
• Script/tth_v3_api.js — JavaScript für indexV3.htm.

Architektur

• Keine Iframes, keine AWP-Formulare.
• Kommunikation mit der S7-1500 über die integrierte Web-API (/api/jsonrpc).
• Lesen per PlcProgram.Read (Batch), schreiben per PlcProgram.Write.
• Anmeldung über Api.Login mit Token (aktuell Benutzer 111).
• Status wird zyklisch gelesen und in lastValues gepuffert.
• Schreibaktionen erfolgen direkt beim Klick auf Buttons/Inputs.

Module in indexV3.htm

1. Stromzähler — Tacho, Werte (Bezug/Einspeisung/Wemos), Power-Chart, Daily-Chart.
2. Licht — 14 Räume + WLED (Helligkeit/Farbe).
3. Heizung — 9 Räume mit IST, SOLL min/max, heizt-Status.
4. Rolladen — alle Räume + Urlaub-Modus.
5. Steckdosen — 8 normale Steckdosen + 4 Funksteckdosen.
6. Haus — Haustür + Garagentor.
7. Uhrzeit — CPU-Uhr, Sonnenauf-/untergang.

Wichtige Variablen-Unterschiede

• Licht: Lesen aus licht_state.html ("Licht Küche" etc.), Schreiben auf "Lichtmerker ..." etc. (unterschiedliche Variablen!).
• Steckdosen: Lesen und Schreiben identisch. Normale Steckdosen sind Bool: false = an, true = aus. Funksteckdosen haben separate an/aus-Variablen.
• Rolladen: Separate auf/ab-Variablen, Schreibwert true.
• Heizung: SOLL-Werte werden als Float geschrieben.
• WLED: "wled_DB".Helligkeit (Int), "wled_DB".RGB_hex (String), "wled_DB".Befehl (Int).

Charts

• Tacho (v3_gauge): Canvas, 180°-Skala, -8000 bis +8000 W, grün=Einspeisung, rot=Bezug.
• Power-Chart (v3_power_chart): Letzte 5 Minuten Leistung, weiche Kurve, Legende "akt. Leistung: xx W".
• Daily-Chart (v3_daily_chart): Balken für die letzten 8 Tage, Wochentage als X-Achse, heute gelb hervorgehoben, blaue Linie für täglichen Bezug.

Responsive Verhalten

• Stromzähler-Bereich bricht auf kleinen Bildschirmen um.
• Canvas-Elemente skalieren mit aspect-ratio: 2 / 1 und bleiben scharf (HiDPI über fitCanvas).

Bekannte Einschränkungen / TODO

• Login-Daten (user: '111', password: '1q2w3e$R') sind im Klartext in tth_v3_api.js hinterlegt.
• Heizungs-Validierung prüft nur min < max clientseitig.
• Keine Rückmeldung, ob ein Schreibvorgang in der SPS tatsächlich wirksam wurde (nur API-Antwort).

Preview

• indexV3_preview.htm enthält feste Dummy-Werte und kein Polling.
• Wird verwendet, um das Layout offline zu testen.
• Taster in der Preview haben keine Funktion.