Controme Integration für Home Assistant

1. Bedienungsanleitung

Version: 0.2.0
Stand: August 2026

---

2. Einführung

Die Controme-Integration verbindet Ihren Controme Miniserver mit Home Assistant. Sie können damit:

• Temperaturen überwachen — Ist-Temperatur, Soll-Temperatur, Luftfeuchtigkeit und Offsets aller Räume in Echtzeit einsehen
• Temperaturen steuern — Die Soll-Temperatur direkt über die Home Assistant Thermostat-Karte ändern
• Temporäre Änderungen vornehmen — z.B. „Für 2 Stunden auf 24°C heizen“ mit automatischem Countdown
• Dauerhafte Änderungen speichern — Eine neue Temperatur als permanenten Sollwert übernehmen
• Heizprogramm umschalten — Zwischen Wochenplänen wechseln (z.B. „Standard“ → „Sommer“ → „Urlaub“)
• Temperaturszenen aktivieren — Pro Raum die aktive Szene wechseln (z.B. „Tag“ → „Nacht“)
• Betriebsart steuern — Heizen, Kühlen, Dauer-Aus oder Dauer-Ein pro Raum einstellen
• Automationen bauen — z.B. Nachtabsenkung, Fensterkontakt-Steuerung, saisonale Programmwechsel oder Benachrichtigungen

Die gesamte Kommunikation bleibt in Ihrem lokalen Netzwerk — es werden keine Cloud-Dienste benötigt.

---

3. Integration vs. Plugin — Was ist der Unterschied?

Controme bietet zwei verschiedene Anbindungen an Home Assistant, die sich in ihrer Richtung und ihrem Einsatzzweck unterscheiden:

Kurz gesagt:

• Sie möchten Controme-Räume in Home Assistant sehen und steuern? → Dann sind Sie hier richtig (Integration).
• Sie möchten Sensoren aus Home Assistant in Controme nutzen? → Dann benötigen Sie das Home Assistant Plugin.

[!TIP]
Beide Anbindungen können gleichzeitig betrieben werden und ergänzen sich ideal.

---

4. Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass folgende Voraussetzungen erfüllt sind:

[!IMPORTANT]
Smart-Heat NOVA 27 & Integrations-Dateien erhalten:
Sowohl Smart-Heat NOVA 27 als auch die Home Assistant Integrations-Dateien sind aktuell auf Anfrage verfügbar. Die Installation des Updates erfolgt durch das Controme-Team. Wir rollen Smart-Heat NOVA 27 schrittweise aus, im ersten Schritt an Kunden mit Services-Paket. Wie der Umstieg abläuft, steht unter Umstieg auf Smart-Heat-OS 26 und Smart-Heat NOVA 27.

Bitte stellen Sie hierzu eine kurze Supportanfrage:

👉 Update-Anfrage stellen

Geben Sie in der Nachricht an, dass Sie die Home Assistant Integration nutzen möchten und bitten Sie um die Aufspielung von Smart-Heat NOVA 27. Unser Support meldet sich mit den nächsten Schritten und führt das Update für Sie durch. Die Integrations-Dateien für Home Assistant erhalten Sie anschließend ebenfalls vom Support.

[!TIP]
Sie finden die IP-Adresse Ihres Miniservers in der Controme Smart-Heat-App unter Einstellungen → Netzwerk oder in der Geräteliste Ihres Routers.

---

5. Installation

Die Controme-Integration ist eine sogenannte Custom Component und wird manuell in das Home Assistant Dateisystem kopiert.

5.1 Schritt 1: Integrations-Dateien entpacken

Entpacken Sie das vom Controme Support erhaltene ZIP-Archiv. Darin befindet sich ein Ordner namens custom_components.

5.2 Schritt 2: Dateien kopieren

Kopieren Sie den Inhalt (den Ordner controme) in das config/custom_components/-Verzeichnis Ihrer Home Assistant Installation, sodass folgende Struktur entsteht:

config/
└── custom_components/
    └── controme/
        ├── __init__.py
        ├── climate.py
        ├── config_flow.py
        ├── const.py
        ├── coordinator.py
        ├── manifest.json
        ├── select.py
        ├── sensor.py
        ├── strings.json
        └── translations/
            ├── de.json
            └── en.json

[!NOTE]
So greifen Sie auf das Dateisystem zu:

• HAOS (Raspberry Pi / NUC): Installieren Sie das Add-on „File Editor“ oder „Samba Share“ aus dem Add-on Store
• Docker: Der Pfad ist der gemountete config-Ordner (z.B. /home/homeassistant/config/)
• Supervised: Standardpfad ist /home/homeassistant/.homeassistant/

5.3 Schritt 3: Home Assistant neustarten

Navigieren Sie zu Einstellungen → System → Neustart und starten Sie Home Assistant neu. Dies ist notwendig, damit die neue Integration erkannt wird.

---

6. Ersteinrichtung

6.1 Automatische Erkennung (ZeroConf)

Wenn sich Ihr Miniserver im selben Netzwerk befindet, erkennt Home Assistant ihn automatisch:

1. Nach dem Neustart erscheint eine Benachrichtigung: „Controme Miniserver gefunden“
2. Klicken Sie auf die Benachrichtigung
3. Geben Sie Ihren Benutzernamen und Ihr Passwort ein
4. Klicken Sie auf Absenden

6.2 Manuelle Einrichtung

Falls die automatische Erkennung nicht funktioniert:

1. Navigieren Sie zu Einstellungen → Geräte & Dienste
2. Klicken Sie unten rechts auf + Integration hinzufügen
3. Suchen Sie nach „Controme“
4. Geben Sie ein:
   • IP-Adresse oder Hostname — z.B. 192.168.178.107
   • Benutzername — Ihr Controme-Login (z.B. benutzer@controme.com)
   • Passwort — Ihr Controme-Passwort
5. Klicken Sie auf Absenden

[!IMPORTANT]
Die Zugangsdaten sind dieselben, die Sie auch für die Controme Smart-Heat-App verwenden.

Nach erfolgreicher Einrichtung sehen Sie die Integration unter Einstellungen → Geräte & Dienste → Controme.

---

7. Übersicht: Was wird eingerichtet?

Nach der Einrichtung erstellt die Integration automatisch folgende Struktur:

7.1 Geräte

7.2 Bereiche (Areas)

Die Integration erstellt automatisch einen Bereich pro Raum mit dem Namen aus dem Smart-Heat-OS. So werden alle Entitäten eines Raums direkt dem richtigen Bereich zugeordnet.

7.3 Entitäten am Miniserver-Gerät

[!NOTE]
Das Heizprogramm-Dropdown erscheint nur, wenn auf Ihrem Miniserver das Heizprogramm-Plugin aktiviert ist und mindestens ein Heizprogramm angelegt wurde.

7.4 Entitäten pro Raum

Für jeden Raum werden folgende Entitäten erstellt:

---

8. Installierte Version prüfen

Welche Version der Integration bei Ihnen läuft, sehen Sie unter Einstellungen → Geräte & Dienste → Controme (Versionsnummer auf der Integrationskarte) oder in der Datei config/custom_components/controme/manifest.json.

[!TIP]
Sie haben eine ältere Version und möchten die neuen Funktionen nutzen? Fordern Sie einfach über eine Supportanfrage die aktuelle Version an und folgen Sie der Anleitung Update auf eine neue Version.

---

9. Bedienung: Thermostat

9.1 Die Thermostat-Karte

Die Thermostat-Karte ist das zentrale Bedienelement. Sie finden sie auf Ihrem Dashboard oder unter Einstellungen → Geräte & Dienste → Controme → [Raum] → Thermostat.

Die Karte zeigt:

• Große Zahl in der Mitte: Die aktuelle Ist-Temperatur
• Ring / Slider: Die Soll-Temperatur (zum Anpassen ziehen)
• Unten: Luftfeuchtigkeit (wenn Sensor vorhanden)
• Preset-Dropdown: Der aktuelle Betriebsmodus

---

9.2 Temperatur ändern (Temporär)

Wenn Sie die Soll-Temperatur über den Slider ändern, wird diese Änderung zunächst temporär gespeichert:

1. Öffnen Sie die Thermostat-Karte eines Raums
2. Ziehen Sie den Temperatur-Slider auf den gewünschten Wert (z.B. 24°C)
3. Die Temperatur wird sofort an den Miniserver übermittelt
4. Das Preset-Dropdown springt auf „Temporär“
5. Der Sensor „Verbleibende Zeit“ zeigt einen Countdown (z.B. 01:59:00)

[!NOTE]
Standard-Dauer: Temporäre Änderungen gelten standardmäßig für 2 Stunden (120 Minuten). Nach Ablauf kehrt der Raum automatisch zur vorherigen Solltemperatur zurück. Die Dauer kann in den Einstellungen angepasst werden.

---

9.3 Temperatur dauerhaft speichern

Wenn Sie möchten, dass die neue Temperatur dauerhaft gilt (auch nach Ablauf des Countdowns), gehen Sie so vor:

1. Ändern Sie zuerst die Temperatur über den Slider (→ Preset springt auf „Temporär“)
2. Öffnen Sie das Preset-Dropdown
3. Wählen Sie „Dauerhaft speichern“
4. Der Miniserver übernimmt die Temperatur als neuen permanenten Sollwert
5. Das Preset springt automatisch auf „Zeitplan“ zurück
6. Die Temperatur bleibt auf dem neuen Wert — ohne Countdown

[!TIP]
Typischer Anwendungsfall: Sie ziehen in eine neue Wohnung und möchten die Grundtemperatur aller Räume einmalig anpassen. Stellen Sie den Wert ein und wählen Sie „Dauerhaft speichern“.

---

9.4 Temporäre Änderung abbrechen

Sie können eine temporäre Änderung jederzeit vorzeitig beenden:

1. Öffnen Sie das Preset-Dropdown
2. Wählen Sie „Zeitplan“
3. Die Temperatur springt auf den vorherigen Sollwert zurück
4. Der Countdown endet sofort

---

9.5 Die drei Preset-Modi erklärt

---

9.6 Sensor „Verbleibende Zeit“

Dieser Sensor zeigt Ihnen auf einen Blick, ob und wie lange eine temporäre Änderung noch aktiv ist:

---

10. Bedienung: Heizprogramm umschalten

Ein Heizprogramm ist ein Wochenplan, der festlegt, wann welche Temperaturszene aktiviert wird (z.B. morgens „Tag“, abends „Nacht“). Sie können auf Ihrem Miniserver mehrere Heizprogramme anlegen (z.B. „Standard“, „Sommer“, „Urlaub“) und über Home Assistant zwischen diesen wechseln.

Es ist immer genau ein Heizprogramm aktiv. Die Umschaltung gilt global für alle Räume.

10.1 So wechseln Sie das Heizprogramm:

1. Navigieren Sie zum Miniserver-Gerät (Einstellungen → Geräte & Dienste → Controme → Controme Miniserver)
2. Öffnen Sie das Heizprogramm-Dropdown
3. Wählen Sie das gewünschte Programm (z.B. „Sommer“)
4. Das Programm wird sofort auf dem Miniserver aktiviert

[!TIP]
Typischer Anwendungsfall: Sie haben eine Klimaanlage und möchten bei warmem Wetter automatisch vom Heizprogramm „Standard“ auf „Sommer“ wechseln — das geht komfortabel per Automation (siehe Automationen).

---

11. Bedienung: Temperaturszene ändern

Temperaturszenen definieren, welche Solltemperatur ein Raum haben soll (z.B. „Tag“ = 22°C, „Nacht“ = 18°C). Normalerweise werden Szenen automatisch durch das aktive Heizprogramm gewechselt. Sie können die Szene aber auch manuell pro Raum über Home Assistant ändern.

11.1 So ändern Sie die Temperaturszene:

1. Navigieren Sie zum gewünschten Raum-Gerät (z.B. Wohnzimmer)
2. Öffnen Sie das Temperaturszene-Dropdown
3. Wählen Sie die gewünschte Szene (z.B. „Nacht“)
4. Die Solltemperatur des Raums ändert sich auf den in der Szene hinterlegten Wert

[!NOTE]
Jeder Raum hat sein eigenes Temperaturszene-Dropdown. Sie können verschiedene Räume auf verschiedene Szenen setzen.

[!IMPORTANT]
Beim nächsten Schaltpunkt des Heizprogramms wird die Szene automatisch auf den dort hinterlegten Wert zurückgesetzt. Eine manuelle Szenenänderung über HA ist daher eine temporäre Maßnahme bis zum nächsten geplanten Wechsel.

---

12. Bedienung: Betriebsart ändern

Die Betriebsart bestimmt, ob ein Raum geheizt, gekühlt, dauerhaft ein- oder ausgeschaltet wird. Sie können die Betriebsart pro Raum einstellen.

12.1 Die vier Betriebsarten:

12.2 So ändern Sie die Betriebsart:

1. Navigieren Sie zum gewünschten Raum-Gerät (z.B. Wohnzimmer)
2. Öffnen Sie das Betriebsart-Dropdown
3. Wählen Sie die gewünschte Betriebsart
4. Die Änderung wird sofort auf dem Miniserver umgesetzt

[!WARNING]
„Dauer-Aus“ und „Dauer-Ein“ mit Bedacht verwenden! Diese Modi überschreiben die automatische Regelung. Ein Raum auf „Dauer-Aus“ wird nicht mehr geheizt, auch wenn die Temperatur unter den Sollwert fällt.

---

13. Einstellungen anpassen

Sie können die Standard-Dauer für temporäre Temperaturänderungen anpassen:

1. Navigieren Sie zu Einstellungen → Geräte & Dienste → Controme
2. Klicken Sie auf Konfigurieren
3. Ändern Sie den Wert bei „Standard-Dauer für temporäre Änderungen (Minuten)“
   • Minimum: 15 Minuten
   • Maximum: 720 Minuten (12 Stunden)
   • Standard: 120 Minuten (2 Stunden)
4. Klicken Sie auf Absenden

[!NOTE]
Die Integration wird nach der Änderung automatisch neu geladen. Bereits laufende temporäre Änderungen sind davon nicht betroffen — die neue Dauer gilt nur für zukünftige Änderungen.

---

14. Automationen erstellen

Die Integration stellt alle Daten als HA-Entitäten bereit, sodass Sie beliebige Automationen und Szenen erstellen können. Hier einige Beispiele:

14.1 Beispiel 1: Nachtabsenkung

„Jeden Abend um 22:00 Uhr alle Räume auf 18°C senken, morgens um 6:00 Uhr zurücksetzen.“

automation:
  - alias: "Nachtabsenkung aktivieren"
    trigger:
      - platform: time
        at: "22:00:00"
    action:
      - service: climate.set_temperature
        target:
          entity_id:
            - climate.wohnzimmer_thermostat
            - climate.schlafzimmer_thermostat
        data:
          temperature: 18

  - alias: "Nachtabsenkung aufheben"
    trigger:
      - platform: time
        at: "06:00:00"
    action:
      - service: climate.set_preset_mode
        target:
          entity_id:
            - climate.wohnzimmer_thermostat
            - climate.schlafzimmer_thermostat
        data:
          preset_mode: "Zeitplan"

14.2 Beispiel 2: Fenster-offen-Erkennung

„Wenn der Fenstersensor meldet, dass ein Fenster geöffnet wurde, die Heizung im Raum für 30 Minuten auf 5°C senken.“

automation:
  - alias: "Fenster offen → Heizung runter"
    trigger:
      - platform: state
        entity_id: binary_sensor.wohnzimmer_fenster
        to: "on"
    action:
      - service: climate.set_temperature
        target:
          entity_id: climate.wohnzimmer_thermostat
        data:
          temperature: 5

  - alias: "Fenster zu → Heizung normal"
    trigger:
      - platform: state
        entity_id: binary_sensor.wohnzimmer_fenster
        to: "off"
    action:
      - service: climate.set_preset_mode
        target:
          entity_id: climate.wohnzimmer_thermostat
        data:
          preset_mode: "Zeitplan"

14.3 Beispiel 3: Benachrichtigung bei Temperaturabweichung

„Benachrichtige mich, wenn das Badezimmer unter 18°C fällt.“

automation:
  - alias: "Kältewarnung Bad"
    trigger:
      - platform: numeric_state
        entity_id: sensor.bad_temperature
        below: 18
    action:
      - service: notify.mobile_app_mein_handy
        data:
          title: "Temperaturwarnung"
          message: >
            Das Badezimmer ist auf {{ states('sensor.bad_temperature') }}°C
            gefallen!

14.4 Beispiel 4: Heizprogramm saisonal umschalten

„Wenn die Klimaanlage auf Kühlen schaltet, wechsle das Heizprogramm auf ‚Sommer‘. Wenn sie ausschaltet, zurück auf ‚Standard‘.“

automation:
  - alias: "Klima an → Sommer-Programm"
    trigger:
      - platform: state
        entity_id: climate.klimaanlage
        attribute: hvac_action
        to: "cooling"
    action:
      - service: select.select_option
        target:
          entity_id: select.controme_heizprogramm
        data:
          option: "Sommer"

  - alias: "Klima aus → Standard-Programm"
    trigger:
      - platform: state
        entity_id: climate.klimaanlage
        attribute: hvac_action
        to: "off"
    action:
      - service: select.select_option
        target:
          entity_id: select.controme_heizprogramm
        data:
          option: "Standard"

14.5 Beispiel 5: Betriebsart per Knopfdruck wechseln

„Alle Räume bei Hitzewelle auf Kühlen umschalten.“

automation:
  - alias: "Alle Räume auf Kühlen"
    trigger:
      - platform: state
        entity_id: input_boolean.hitzewelle
        to: "on"
    action:
      - service: select.select_option
        target:
          entity_id:
            - select.wohnzimmer_betriebsart
            - select.schlafzimmer_betriebsart
            - select.bad_betriebsart
        data:
          option: "Kühlen (Auto)"

[!TIP]
Entity-IDs finden: Navigieren Sie zu Entwicklerwerkzeuge → Zustände und suchen Sie nach controme, um alle verfügbaren Entity-IDs zu sehen.

---

15. Dashboard einrichten

15.1 Thermostat-Karten hinzufügen

1. Öffnen Sie Ihr Dashboard und klicken Sie auf Bearbeiten (Stift-Symbol oben rechts)
2. Klicken Sie auf + Karte hinzufügen
3. Wählen Sie Thermostat
4. Wählen Sie die Entität (z.B. climate.wohnzimmer_thermostat)
5. Klicken Sie auf Speichern

15.2 Raumübersicht als Kacheln

Für eine kompakte Übersicht aller Räume können Sie Kachel-Karten verwenden:

1. + Karte hinzufügen → Kachel
2. Entität: z.B. climate.wohnzimmer_thermostat
3. Wiederholen für jeden Raum

15.3 Sensor-Verlauf anzeigen

Um die Temperaturentwicklung über die Zeit zu sehen:

1. + Karte hinzufügen → Verlauf
2. Entitäten hinzufügen:
   • sensor.wohnzimmer_temperature (Ist-Temperatur)
   • climate.wohnzimmer_thermostat (Soll-Temperatur)
3. Zeitraum wählen (z.B. 24 Stunden)

---

16. Update auf eine neue Version

Wenn Sie eine neue Version der Integration vom Controme Support erhalten:

1. Integration entfernen: Einstellungen → Geräte & Dienste → Controme → ⋮ → Löschen
2. Alte Dateien löschen: Den Ordner config/custom_components/controme/ auf Ihrem Home Assistant Dateisystem löschen
3. Neue Dateien kopieren: Den neuen controme Ordner aus dem bereitgestellten ZIP-Archiv an die gleiche Stelle kopieren
4. Home Assistant neustarten
5. Integration neu einrichten: Einstellungen → Geräte & Dienste → + Integration hinzufügen → Controme

[!NOTE]
Bei einem Update werden die Bereiche (Areas) und Geräte automatisch neu erstellt. Bereits erstellte Automationen, die auf Entity-IDs verweisen, funktionieren weiterhin, da die IDs sich nicht ändern.

---

17. Deinstallation

Wenn Sie die Integration entfernen möchten:

1. Navigieren Sie zu Einstellungen → Geräte & Dienste
2. Klicken Sie auf die Controme-Integration
3. Klicken Sie auf ⋮ (drei Punkte) → Löschen
4. Löschen Sie den Ordner config/custom_components/controme/ in Ihren Home Assistant Dateien
5. Starten Sie Home Assistant neu

---

18. Häufig gestellte Fragen (FAQ)

18.1 Installation & Einrichtung

Ich finde „Controme“ nicht in der Integrationsliste.

Stellen Sie sicher, dass der Ordner controme korrekt unter config/custom_components/ liegt und dass Sie Home Assistant nach dem Kopieren neu gestartet haben. Prüfen Sie unter Einstellungen → System → Protokolle, ob Fehlermeldungen erscheinen.

Die Einrichtung meldet „Verbindung nicht möglich“.

Überprüfen Sie:

• Ist die IP-Adresse korrekt?
• Ist der Miniserver eingeschaltet und im Netzwerk erreichbar? (Testen Sie: http://IHRE-IP im Browser)
• Blockiert eine Firewall die Verbindung?
• Ist der Miniserver im selben Netzwerk/VLAN wie Home Assistant?

Die Einrichtung meldet „Ungültiger Benutzername oder Passwort“.

Verwenden Sie die gleichen Zugangsdaten wie für die Controme Smart-Heat-App. Achten Sie auf Groß-/Kleinschreibung. Testen Sie die Zugangsdaten zuerst im Controme-Webinterface (http://IHRE-IP).

---

18.2 Bedienung

Warum springt die Temperatur nach einer Änderung kurz hin und her?

Nach einer Slider-Änderung zeigt Home Assistant zunächst optimistisch den neuen Wert. Beim nächsten Datenabruf (alle 60 Sekunden) wird der tatsächliche Wert vom Miniserver geladen. Falls diese sich minimal unterscheiden (z.B. durch Rundung), kann es zu einem kurzen „Springen“ kommen. Das ist normal.

Was passiert, wenn ich die Temperatur über die Controme-App UND über Home Assistant ändere?

Die letzte Änderung gewinnt. Beide Systeme nutzen die gleiche API. Beim nächsten Datenabruf (alle 60 Sekunden) synchronisiert sich Home Assistant mit dem aktuellen Stand des Miniservers.

Kann ich die Temperatur auch über Sprachassistenten steuern?

Ja! Da die Integration Standard-Climate-Entitäten erstellt, funktionieren alle Sprachassistenten, die Home Assistant unterstützen (z.B. Google Home, Alexa über HA-Cloud, oder der lokale Assist-Pipeline). Beispiel: „Hey Google, stelle das Wohnzimmer auf 23 Grad.“

Warum zeigt die Thermostat-Karte keinen HVAC-Modus-Schalter (Heizen/Kühlen/Aus)?

Die Betriebsart (Heizen, Kühlen, Aus) wird auf der Thermostat-Karte nur angezeigt, aber nicht darüber geändert. Um die Betriebsart zu ändern, verwenden Sie das Betriebsart-Dropdown des jeweiligen Raums.

Was bedeutet „Zeitplan aktiv“ beim Sensor „Verbleibende Zeit“?

Es ist keine temporäre Änderung aktiv. Der Raum folgt dem regulären Betrieb (Temperaturszenen, Heizprogramm) — so wie er im Controme Smart-Heat-OS konfiguriert ist.

Ich sehe kein Heizprogramm-Dropdown / Temperaturszene-Dropdown. Warum?

Prüfen Sie zuerst Ihre Integrationsversion (siehe Installierte Version prüfen): Die Dropdowns gibt es erst ab Version 0.2.0 — mit Version 0.1.4 fehlen sie grundsätzlich. Fordern Sie in dem Fall die aktuelle Version beim Support an.

Ab Version 0.2.0 erscheinen die Dropdowns nur, wenn die entsprechenden Plugins auf dem Controme Miniserver aktiviert sind:

• Heizprogramm-Dropdown: Benötigt das Plugin „Heizprogramm“ mit mindestens einem angelegten Programm
• Temperaturszene-Dropdown: Benötigt das Plugin „Temperaturszenen“ mit mindestens einer angelegten Szene
• Betriebsart-Dropdown: Benötigt das Plugin „Betriebsarten“

Prüfen Sie in der Controme-Oberfläche unter Module, ob die Plugins aktiv sind.

Wenn ich die Temperaturszene über Home Assistant ändere — überschreibt das Heizprogramm sie wieder?

Ja, beim nächsten Schaltpunkt des Heizprogramms wird die Szene automatisch auf den dort hinterlegten Wert zurückgesetzt. Eine manuelle Szenenänderung über HA ist daher eine temporäre Maßnahme bis zum nächsten geplanten Wechsel.

---

18.3 Temperatursteuerung

Ich habe die Temperatur auf 24°C gestellt, aber im Controme-Webinterface steht ein anderer Wert. Warum?

Im Controme-System gibt es neben der Solltemperatur auch Offsets (z.B. Wetteroffsets, API-Offsets). Die Thermostat-Karte in Home Assistant zeigt während einer temporären Änderung den reinen Sollwert ohne Offsets an. Das Controme-Webinterface zeigt möglicherweise den Wert mit Offsets (= Zieltemperatur).

Was ist der Unterschied zwischen „Solltemperatur“ und „Zieltemperatur“?

• Solltemperatur (Setpoint): Der reine Temperaturwert, wie er im System hinterlegt ist
• Zieltemperatur (Target Temperature): Solltemperatur + aktive Offsets (z.B. Wetterkorrektur +0,5°C)

Die Thermostat-Karte zeigt:

• Im Zeitplan-Modus: Die Zieltemperatur (mit Offsets)
• Im Temporär-Modus: Die Solltemperatur (ohne Offsets, weil temporäre Änderungen Offsets überschreiben)

Wie lange dauert es, bis eine Temperaturänderung wirksam wird?

Die Änderung wird sofort an den Miniserver gesendet. Der Miniserver verarbeitet sie in der nächsten Regelschleife (typisch innerhalb weniger Sekunden). Die Anzeige in Home Assistant aktualisiert sich beim nächsten Datenabruf (alle 60 Sekunden).

---

18.4 Technisches

Wie oft werden die Daten vom Miniserver abgerufen?

Alle 60 Sekunden. Pro Zyklus werden zwei API-Endpunkte parallel abgefragt: die Raumdaten (room_details) und das aktive Heizprogramm. Die Systemlast ist minimal.

Welche Ports/Protokolle werden verwendet?

Die Integration kommuniziert ausschließlich über HTTP (Port 80) im lokalen Netzwerk. Es werden keine Cloud-Dienste benötigt. Die Authentifizierung erfolgt über HTTP Basic Auth.

Werden meine Zugangsdaten sicher gespeichert?

Ja. Die Zugangsdaten werden verschlüsselt im Home Assistant Config-Entry-System gespeichert. Sie werden nur für die direkte Kommunikation mit dem Miniserver verwendet und verlassen nie Ihr lokales Netzwerk.

Kann ich mehrere Miniserver anbinden?

Aktuell unterstützt die Integration einen Miniserver. Wenn Sie mehrere Miniserver betreiben, können Sie die Integration mehrfach einrichten (einmal pro IP-Adresse).

---

19. Fehlerbehebung

19.1 Protokolle prüfen

Bei Problemen sind die Home Assistant Protokolle die erste Anlaufstelle:

1. Navigieren Sie zu Einstellungen → System → Protokolle
2. Filtern Sie nach controme
3. Suchen Sie nach Einträgen mit WARNING oder ERROR

19.2 Debug-Logging aktivieren

Für eine detailliertere Fehleranalyse können Sie das Debug-Logging aktivieren. Fügen Sie folgendes in Ihre configuration.yaml ein:

logger:
  default: info
  logs:
    custom_components.controme: debug

Starten Sie Home Assistant danach neu. Die Protokolle zeigen nun detaillierte Informationen über API-Aufrufe und Datenverarbeitung.

[!CAUTION]
Deaktivieren Sie das Debug-Logging nach der Fehleranalyse wieder, da es die Protokolldateien schnell vergrößert.

19.3 Häufige Fehlermeldungen

---

20. Kontakt & Support

Bei technischen Fragen, Update-Anfragen oder Problemen wenden Sie sich bitte an unseren Kundenservice:

• 👉 Supportanfrage stellen
• E-Mail: support@controme.com
• Web: https://www.controme.com/support/

---

Controme GmbH — Smart-Heat-OS × Home Assistant