3.4 KiB

Raw Permalink Blame History

Backend (Empfang + Auslieferung des Frontends)

Minimaler Server mit Python-Bordmitteln (Python ≥ 3.8, kein pip install, läuft direkt unter Windows). Er nimmt die Messwerte des ESP8266 entgegen, hält die letzten 100 Messungen im Speicher und liefert zusätzlich das Frontend aus. Die Aggregationslogik (Präferenzen, CO2-Hard-Constraint, Sensor-Veto) ist hier noch nicht enthalten.

ESP8266 ──POST /api/messwerte──▶ backend/server.py ◀──GET /api/messwerte── Browser (frontend/)
                                        ▲          ◀──GET /api/messwerte── Unity-Zwilling
                                        └───────────POST /api/steuerung─── Unity-Zwilling

Starten

Doppelklick auf start.bat oder:

python backend/server.py          # Port 3000 (oder: python backend/server.py 8080)
python backend/simulator.py       # optional: Fake-Sensordaten ohne Hardware
python backend/simulator.py --szenario demo   # Szenarien nacheinander: normal, stickig, normal, hitze, kalt

Szenarien des Simulators: wechsel (Standard, Werte schwanken), normal, hitze (→ ca. 30 °C), stickig (→ ca. 1600 ppm), kalt (→ ca. 17 °C), demo. Die Werte ändern sich langsam wie in echt, damit man im Unity-Zwilling sieht, wann die Steuerung umschaltet. Frontend: http://localhost:3000, im Hotspot von anderen Geräten: http://<Laptop-IP>:3000

Beim Start zeigt der Server die IP-Adressen des Laptops und prüft, ob SERVER_IP in firmware/dht11_lcd/wifi_config.h dazu passt („OK“ bzw. „ACHTUNG“). Jeder empfangene Messwert erscheint mit Absender-IP im Fenster (127.0.0.1 = Simulator, 172.20.10.x = ESP im Hotspot).

Firewall (einmalig)

Windows stuft den Handy-Hotspot meist als „öffentliches Netz“ ein und blockiert eingehende Verbindungen. firewall_freigeben.bat per Rechtsklick → „Als Administrator ausführen“ gibt Port 3000 frei.

Schnittstelle (Datenvertrag)

POST /api/messwerte, Content-Type: application/json, reines HTTP (kein TLS):

{"temperatur": 22.5, "luftfeuchte": 45.0, "eco2": 612, "tvoc": 30}

Feld	Einheit	Quelle
`temperatur`	°C	DHT11
`luftfeuchte`	%	DHT11
`eco2`	ppm	CCS811
`tvoc`	ppb	CCS811

Alle Felder sind Zahlen; ein Feld darf fehlen oder null sein (z. B. CCS811 noch nicht bereit). Den Zeitstempel setzt der Server beim Empfang.

GET /api/messwerte liefert {"aktuell": {...} | null, "verlauf": [...]}.

Steuerbefehle vom Unity-Zwilling

POST /api/steuerung (sendet Unity im Modus „Backend“, sobald sich etwas ändert, sonst alle 10 s):

{"window": "open", "blind": 1.0, "heat": 0.0, "vent": 0.0, "light": 0.4, "beamer": 0, "szenario": "Hitze"}

Feld	Bedeutung
`window`	`closed`, `tilted` oder `open`
`blind`, `heat`, `vent`, `light`	Sollwert 0 … 1 (Jalousie unten, Heizung, Lüftungsanlage, Licht)
`beamer`	0/1
`szenario`	vom Zwilling erkanntes Szenario

Der Server merkt sich nur den letzten Stand (GET /api/steuerung → {"aktuell": {...} | null}) und gibt ihn im Fenster aus. Echte Aktoren gibt es noch nicht.

Test ohne Hardware (PowerShell):

Invoke-RestMethod -Method Post -Uri http://localhost:3000/api/messwerte -ContentType "application/json" `
  -Body '{"temperatur":22.5,"luftfeuchte":45,"eco2":1150,"tvoc":30}'

3.4 KiB Raw Permalink Blame History