Umgebungssteuerung & Aktorik¶

Kamerplanter schließt den Regelkreis zwischen Sensorik und Aktorik: Das System misst Temperatur, Luftfeuchtigkeit, CO₂ und das Dampfdruckdefizit (VPD), bewertet diese Werte anhand hinterlegter Regeln und steuert darüber Geräte wie Lüfter, Befeuchter oder Bewässerungsventile. Du kannst jederzeit direkt eingreifen, indem du einen Aktor manuell ein- oder ausschaltest.

Voraussetzungen¶

• Mindestens ein Standort mit einem Bereich (Site & Location) ist eingerichtet — siehe Standorte & Substrate
• Für die automatische Steuerung über Home Assistant: HA-Integration eingerichtet — siehe Home Assistant Integration
• Für Sensor-Regeln: Sensoren liefern Messwerte — siehe Sensorik

Der Sensor-Aktor-Regelkreis¶

Jede automatische Steuerungsaktion folgt demselben Kreislauf:

flowchart LR
    S[Sensor misst<br/>Temperatur / rH / CO₂ / VPD] --> E{Regel-Engine<br/>wertet aus}
    E -->|Schwellwert überschritten| P{Prioritäts-<br/>prüfung}
    E -->|Alles im Rahmen| W[Warten<br/>bis zur nächsten Messung]
    P -->|Kein Konflikt| A[Aktor-Befehl<br/>wird gesendet]
    P -->|Konflikt erkannt| K[Konflikt-<br/>auflösung]
    K --> A
    A --> H[Hysterese-Timer<br/>startet]
    H --> S

Das Backend wertet Regeln und Zeitpläne zyklisch alle 30 Sekunden aus. Jeder ausgeführte Befehl wird dauerhaft mit Zeitstempel, Auslöser (Zeitplan, Regel, manuell, Sicherheit, Fallback) und Erfolgsstatus gespeichert — eine eigene Ansicht dafür gibt es in der Oberfläche noch nicht, siehe Für technische Nutzer / Self-Hoster.

Aktoren anlegen¶

Ein Aktor ist ein steuerbares Gerät (z. B. Lüfter, Licht, Pumpe), das einem Bereich (Location) zugeordnet wird.

Neuen Aktor anlegen¶

1. Öffne in der Seitenleiste den Bereich Umgebungssteuerung > Aktorik & Steuerung.
2. Klicke auf Aktor anlegen.
3. Wähle Standort (Site) und Bereich (Location) und vergib einen Namen.
4. Wähle Aktor-Typ und Protokoll — je nach Protokoll erscheint ein weiteres Pflichtfeld (siehe unten).
5. Optional: Leistungsaufnahme (für die Verbrauchsübersicht) und Notizen.

Protokolle im Vergleich¶

Sicherheits-Wertebereich (Envelope)¶

Aktor-Typen¶

Aktoren bedienen¶

Auf der Karte jedes Aktors zeigt Kamerplanter den aktuellen Zustand (Ein/Aus/Störung) sowie ob das Gerät online erreichbar ist.

• Einschalten / Ausschalten senden sofort einen direkten Befehl an den Aktor — unabhängig davon, was eine Regel oder ein Zeitplan gerade vorsieht.
• Schlägt die Übertragung fehl (z. B. weil Home Assistant nicht erreichbar ist), meldet das System das nicht als Fehler, sondern legt automatisch eine Aufgabe zur manuellen Bedienung an: „Gerät ist nicht direkt erreichbar — der Befehl wurde als Aufgabe zur manuellen Bedienung hinterlegt."

Automatische Steuerung: Priorität und Hysterese¶

Kamerplanter wertet für jeden Aktor zyklisch aus, welche Steuerungsquelle gerade gewinnen soll. Konkurrieren mehrere Quellen um denselben Aktor, gilt folgende Reihenfolge:

flowchart TB
    M[1. Manueller Override<br/>höchste Priorität, zeitlich befristet]
    S[2. Sicherheitsregeln<br/>z.B. Übertemperatur-Abluft]
    R[3. Regelbasierte Steuerung<br/>Sensor-Schwellwerte]
    Z[4. Zeitplan<br/>niedrigste Priorität]
    M --> S --> R --> Z

Gewinnt eine Regel oder ein Zeitplan, wird der resultierende Befehl an den Aktor gesendet und dabei — genau wie ein direkter Befehl — auf den konfigurierten Sicherheits-Wertebereich begrenzt.

Hysterese konfigurieren¶

Sensor-Regeln verwenden Hysterese, um zu verhindern, dass ein Aktor bei einem knapp erreichten Schwellwert im Sekundentakt ein- und ausschaltet:

Beispiel: VPD-Befeuchter-Regelung

  Einschalten bei: VPD > 1,5 kPa   ← obere Schwelle (on_threshold)
  Ausschalten bei: VPD < 1,2 kPa   ← untere Schwelle (off_threshold)
  Mindestlaufzeit: 5 Minuten        (min_on_duration_seconds)
  Mindestpause:    3 Minuten        (min_off_duration_seconds)

Diese Hysterese-Werte legst du je Regel über die API fest, siehe Für technische Nutzer / Self-Hoster — ein Formular dafür gibt es in der Oberfläche noch nicht.

Wenn Home Assistant nicht erreichbar ist¶

Schlägt ein Befehl an Home Assistant fehl — egal ob durch einen Klick auf der Karte, eine Regel oder einen Zeitplan ausgelöst —, markiert Kamerplanter den Aktor als offline und legt automatisch eine Aufgabe zur manuellen Bedienung an, statt den Befehl ergebnislos zu verwerfen. Ist der Aktor selbst mit dem Protokoll Manuell konfiguriert, gilt dasselbe für jede Aktion von vornherein — es wird nie ein Live-Befehl gesendet.

Notabschaltung¶

Für Notfälle gibt es eine sofortige Notabschaltung.

Neben diesem Brand-Alarm-Szenario kennt das System zwei weitere, aktuell nur über die API auslösbare Szenarien:

Jeder betroffene Aktor wird einzeln angesteuert: Scheitert das Abschalten eines einzelnen Geräts (z. B. weil Home Assistant es gerade nicht erreicht), bricht die Notabschaltung dadurch nicht ab — alle anderen Geräte werden trotzdem abgeschaltet. Kamerplanter meldet dir anschließend genau, welche Geräte nicht erreicht wurden, zum Beispiel: „Notabschaltung teilweise ausgeführt: 4 Aktor(en) abgeschaltet, 1 Aktor(en) konnten NICHT abgeschaltet werden (Abluftventilator Zelt 1). Bitte diese Geräte sofort manuell prüfen und trennen." — so weißt du sofort, welches Gerät du von Hand trennen musst.

Für technische Nutzer / Self-Hoster¶

Die folgenden Funktionen sind im Backend bereits vollständig implementiert, aber noch ohne Bedienoberfläche — du erreichst sie aktuell nur über die REST-API unter dem mandantenspezifischen Pfad /api/v1/t/{tenant_slug}/. Lesende Aufrufe akzeptieren jede aktive Mitgliedschaft; schreibende Aufrufe (Anlegen, Befehl, Override, Regeln, Zeitpläne, Notabschaltung) erfordern mindestens die Rolle Grower; das Löschen eines Aktors erfordert Admin.

Häufige Fragen¶

Siehe auch¶

• Sensorik einrichten
• Wachstumsphasen
• Home Assistant Integration
• VPD-Optimierung
• Tankmanagement