Neuer ioBroker-Blog online: Monatsrückblick März/April 2026

[franzda]

Das Script realisiert eine sichere, triggerbasierte Heizungssteuerung über den Viessmann‑API‑Adapter in ioBroker. Die beiden Funktionen können zeitgesteuert, ereignisgesteuert oder manuell über zwei boolesche Trigger gestartet werden.

Beim Start legt das Script die beiden Steuer‑Datenpunkte 0_userdata.0.Heizung.Heizung_EIN und 0_userdata.0.Heizung.Heizung_AUS automatisch an, initialisiert sie sauber auf false und stellt damit sicher, dass die Trigger jederzeit definiert und einsatzbereit sind.

Eine geprüfte Schreibfunktion (safeSet) verhindert Fehlzustände, indem sie vor jedem Setzen prüft, ob der Ziel‑State existiert und beschreibbar ist. Dadurch werden fehlerhafte API‑Aufrufe und unnötiger Log‑Spam zuverlässig vermieden.

Die beiden Trigger steuern den Heizkreis direkt über die Viessmann‑API:

Heizung EIN setzt den Betriebsmodus auf heating, aktiviert den Heizzeitplan und stellt die Vorlauftemperatur auf 35 °C.

Heizung AUS setzt den Modus auf standby, deaktiviert den Zeitplan und setzt die Temperatur auf 0 °C.

Nach jeder Ausführung setzt sich der jeweilige Trigger automatisch wieder auf false, sodass jede Aktion exakt einmal ausgeführt wird und keine Mehrfachauslösungen entstehen.

// ===============================================================
//   Triggerbasierte Viessmann‑Heizungssteuerung (Ein/Aus)
//   Automatische DP‑Initialisierung + sichere Schreibfunktion
//   Steuerung über Viessmann‑API (heating / standby)
//   Version mit xxxxxx als Geräte-ID
// ===============================================================
// === Trigger-Datenpunkte beim Start anlegen und initialisieren ===
function ensureDP(id) {
    if (!existsState(id)) {
        createState(id, false, {
            type: "boolean",
            role: "switch",
            read: true,
            write: true
        }, () => {
            setState(id, false, true);
            console.info("ANGELEGT: " + id);
        });
    } else {
        setState(id, false, true);
    }
}

// Trigger anlegen
ensureDP("0_userdata.0.Heizung.Heizung_EIN");
ensureDP("0_userdata.0.Heizung.Heizung_AUS");


// === Hilfsfunktion zum sicheren Schreiben ===
function safeSet(id, value) {
    if (!existsState(id)) {
        console.info("FEHLT: " + id);
        return;
    }

    const obj = getObject(id);
    if (!obj || !obj.common || obj.common.write !== true) {
        console.info("NICHT SCHREIBBAR: " + id);
        return;
    }

    setState(id, value, false);
    console.info("SET: " + id + " -> " + value);
}


// === TRIGGER: HEIZUNG EIN ===
on({ id: "0_userdata.0.Heizung.Heizung_EIN", val: true }, () => {
    console.info("TRIGGER: Heizung EIN gestartet");

    safeSet("viessmannapi.0.xxxxxx.0.features.heating.circuits.0.operating.modes.active.commands.setMode.setValue", "heating");
    safeSet("viessmannapi.0.xxxxxx.0.features.heating.circuits.0.heating.schedule.properties.active.value", true);
    safeSet("viessmannapi.0.xxxxxx.0.features.heating.circuits.0.temperature.properties.value.value", 35);

    console.info("Heizung EIN ausgefuehrt.");

    // Trigger zurücksetzen
    setState("0_userdata.0.Heizung.Heizung_EIN", false, false);
});


// === TRIGGER: HEIZUNG AUS ===
on({ id: "0_userdata.0.Heizung.Heizung_AUS", val: true }, () => {
    console.info("TRIGGER: Heizung AUS gestartet");

    safeSet("viessmannapi.0.xxxxxx.0.features.heating.circuits.0.operating.modes.active.commands.setMode.setValue", "standby");
    safeSet("viessmannapi.0.xxxxxx.0.features.heating.circuits.0.heating.schedule.properties.active.value", false);
    safeSet("viessmannapi.0.xxxxxx.0.features.heating.circuits.0.temperature.properties.value.value", 0);

    console.info("Heizung AUS ausgefuehrt.");

    // Trigger zurücksetzen
    setState("0_userdata.0.Heizung.Heizung_AUS", false, false);
});