--- title: "Beispiele für Interaktionen zwischen BleBox-Steuerungen" description: "Jedes Steuergerät hat einen eigenen API-Typ, der auf der Registerkarte „Details, Aktualisierung und Hilfe“ eingesehen werden kann; so hat beispielsweise der Temperatursensor „tempSensor“ den API-Typ „multiSensor“. Ausführliche Unterlagen finden Sie unter diesem Link: https://technical.blebox.eu/ ## switchBox *Für Aktionen vom Typ…" url: "https://faq.blebox.eu/de/docs/beispiele-fuer-interaktionen-zwischen-blebox-steuerungen/" updated: "2026-10-07" category: Beispiele für Interaktionen zwischen Geräten --- # Beispiele für Interaktionen zwischen BleBox-Steuerungen Jedes Steuergerät hat einen eigenen API-Typ, der auf der Registerkarte „Details, Aktualisierung und Hilfe“ eingesehen werden kann; so hat beispielsweise der Temperatursensor „tempSensor“ den API-Typ „multiSensor“. Ausführliche Unterlagen finden Sie unter diesem Link: https://technical.blebox.eu/ ## switchBox *Für Aktionen vom Typ **„URL senden**“: – http://IP/s/(…REQUEST…)* *Für Aktionen vom Typ: **„Ein anderes Gerät steuern“:*** *– (…REQUEST…)* *wobei (…REQUEST…) die im Folgenden beschriebene Ziffer ist:* - *0 – deaktiviert* - *1 – schaltet ein* - *2 – schaltet den Zustand in den entgegengesetzten um (wenn er eingeschaltet war, wird er ausgeschaltet und umgekehrt)* **Fortgeschrittene:** - 1/forTime/(…TIMES…)/ns/0 *wobei (…TIMES…) die Zeit in Sekunden angibt, für die die SwitchBox eingeschaltet bleiben soll* *Beispiele:* - 1/forTime/5/ns/0 – Das angeschlossene Gerät wird für 5 Sekunden eingeschaltet ## SwitchBox mit mehreren Ausgängen *Für Aktionen vom Typ **„URL** **senden**“: – http://IP/s/(…OUTPUT…)/(…REQUEST…)* *Für Aktionen vom Typ: **„Ein anderes Gerät steuern“:*** *– (…OUTPUT…)/(…REQUEST…)* *wobei (…OUTPUT…) die im Folgenden beschriebene Ziffer ist:* - *0 – erster Ausgang (O1)* - *1 – zweiter Ausgang (O2)* *wobei (…REQUEST…) die im Folgenden beschriebene Ziffer ist:* - *0 – deaktiviert* - *1 – schaltet ein* - *2 – schaltet den Zustand in den entgegengesetzten um (wenn er eingeschaltet war, wird er ausgeschaltet und umgekehrt)* *Beispiele:* - 0/1 – schaltet den Ausgang O1 ein - 1/1 – schaltet den Ausgang O2 ein - 0/2 – kehrt den Zustand des Ausgangs O1 um *(wenn der Ausgang eingeschaltet war, wird er ausgeschaltet und umgekehrt)* **Fortgeschrittene:** - (…OUTPUT…)/1/forTime/(…TIMES…)/ns/0 *wobei (…OUTPUT…) die Ausgangsnummer ist (siehe oben) und (…TIMES…) die Zeit in Sekunden angibt, für die der Ausgang „switchBoxD“ eingeschaltet werden soll.* *Beispiele:* - 0/1/forTime/5/ns/0 – schaltet den Ausgang O1 für 5 Sekunden ein - 1/1/forTime/5/ns/0 – schaltet den Ausgang O2 für 5 Sekunden ein ## wLightBoxS und dimmerBox *Für Aktionen vom Typ **„URL senden**“: – http://IP/s/(…REQUEST…)* *Für Aktionen vom Typ: **„Ein anderes Gerät steuern“:*** *– (…REQUEST…)* *wobei (…REQUEST…) der Helligkeitswert im WW-Format ist. Er wird hexadezimal mit zwei Zeichen dargestellt (00–FF, was der dezimalen Darstellung 0–255 entspricht):* - *00 – schaltet aus* - *FF – schaltet ein, stellt die Helligkeit auf 100 % ein* *Beispiele:* - 00 – ausschalten - 19 – schaltet das Licht ein und stellt die Helligkeit auf 10 % ein - 33 – schaltet das Licht ein und stellt die Helligkeit auf 20 % ein - 4D – schaltet das Gerät ein und stellt die Helligkeit auf 30 % ein - 66 – schaltet das Gerät ein und stellt die Helligkeit auf 40 % ein - 7F – schaltet das Licht ein und stellt die Helligkeit auf 50 % ein - 99 – schaltet das Gerät ein und stellt die Helligkeit auf 60 % ein - B3 – schaltet das Licht ein und stellt die Helligkeit auf 70 % ein - CC – schaltet das Gerät ein und stellt die Helligkeit auf 80 % ein - E6 – schaltet das Gerät ein und stellt die Helligkeit auf 90 % ein - FF – schaltet das Licht ein und stellt die Helligkeit auf 100 % ein **Erweiterte Funktionen in LightBoxS:** - offon/last —> ändert den Zustand – aus / letzter Zustand (letzte Helligkeit) - onlast —> aktiviert immer den letzten Zustand - inc/XX —> erhöht die aktuelle Helligkeit um XX (hex) - dec/XX —> verringert die aktuelle Helligkeit um XX (hex) - x/(…EFFECT_ID…) —> aktiviert den Effekt mit der angegebenen ID (0–9) - x/(…EFFECT_ID…)/forTime/(…TIME_S…) —> aktiviert den angegebenen Effekt für die festgelegte Dauer - XX/colorFadeMs/(…TIME_MS…) —> aktiviert die angegebene Helligkeit mit der vorgegebenen Aufhellungszeit - XX/forTime/(…TIME_S…) —> schaltet die jeweilige Helligkeit für die festgelegte Zeit ein - s/XX/colorFadeMs/(…TIME_MS…)/forTime/(…TIME_S…) —> schaltet die angegebene Helligkeit für die festgelegte Zeit mit der festgelegten Aufhellzeit ein *wobei XX einen Wert zwischen 0 und FF darstellt, (…TIME_S…) die Zeit in Sekunden angibt, (…TIME_MS…) die Aufhellungszeit in Millisekunden angibt und (…EFFECT_ID…) eine Ziffer – die Nummer des Effekts aus der App (0–9) – darstellt.* **Erweiterte DimmerBox:** - offon/last —> ändert den Zustand – aus / letzter Zustand (letzte Helligkeit) - offon/toggle —> ändert den Zustand – aus / ein (max. 100 %) - offon/XX —> ändert den Zustand – off / XX (Helligkeit in HEX 00–FF) - onlast —> aktiviert immer den letzten Zustand - onfull —> schaltet immer auf Maximum (genau wie /s/FF) - off —> deaktiviert (genau wie /s/00) - inc/XX —> erhöht die aktuelle Helligkeit um XX (hex) - dec/XX —> verringert die aktuelle Helligkeit um XX (hex) ## wLighBox (5CH) und pixelBox **Aktionen**(Befehle) **für das Produkt in LightBox und pixelBox:** *Für Aktionen vom Typ **„URL senden**“: – http://IP/s/(…CHANNELS…)* *Für Aktionen vom Typ: **„Ein anderes Gerät steuern“:*** *– (…CHANNELS…)* *wobei (…CHANNELS…) für 5 Helligkeitswerte (RR-GG-BB-WW-CW) steht. Diese werden im Hexadezimalformat mit jeweils zwei Zeichen pro Farbe bzw. LED-Streifenkanal gespeichert (00–FF, was der Dezimalschreibweise 0–255 entspricht), und zwar wie folgt:* - RR – d. h. 00–FF (0–255) – Helligkeit der roten Farbe / Kanal 1 - GG – d. h. 00–FF (0–255) – Helligkeit der Farbe Grün / Kanal 2 - BB – d. h. 00–FF (0–255) – Helligkeit der Farbe Blau / Kanal 3 - WW – d. h. 00–FF (0–255) – Helligkeit der Farbe „Warmweiß“ / Kanal 4 - CW – d. h. 00–FF (0–255) – Helligkeit der Farbe „Kaltweiß“ / Kanal 5 *Umgerechnete Helligkeitsskala:* - 00 – Helligkeit 0 % - 19 – Helligkeit 10 % - 33 – Helligkeit 20 % - 4D – Helligkeit 30 % - 66 – Helligkeit 40 % - 7F – Helligkeit 50 % - 99 – Helligkeit 60 % - B3 – Helligkeit 70 % - CC – Helligkeit 80 % - E6 – Helligkeit 90 % - FF – Helligkeit 100 % *Beispiele:* - 0000000000 – schaltet das LED-Band aus / alle Kanäle ausgeschaltet - FF00000000 – schaltet die Farbe Rot ein / Kanal 1 eingeschaltet, die übrigen ausgeschaltet - 00FF000000 – schaltet die Farbe Grün ein / Kanal 2 eingeschaltet, die übrigen ausgeschaltet - 0000FF0000 – aktiviert die Farbe Blau / Kanal 3 aktiviert, die übrigen Kanäle deaktiviert - 000000FF00 – schaltet die Farbe „Warmweiß“ ein / Kanal 4 eingeschaltet, die übrigen Kanäle ausgeschaltet - 00000000FF – schaltet die Farbe „Kaltweiß“ ein / Kanal 5 eingeschaltet, die übrigen ausgeschaltet - FFFFFF0000 – aktiviert die Farbe Weiß (Rot, Grün, Blau) - FFFF000000 – aktiviert die Farbe Gelb (Rot, Grün) - FF00FF0000 – aktiviert die Farbe Fuchsia (rot, blau) - 00FFFF0000 – aktiviert die Farbe Cyan (grün, blau) - FF7F000000 – aktiviert die Farbe Orange (Rot, 50 % Grün) **Fortgeschrittene:** - offon/last *schaltet die zuletzt eingestellte Farbe/Helligkeit der Kanäle ein oder aus. Mit anderen Worten: Wenn das LED-Band leuchtet, wird es ausgeschaltet; wenn es nicht leuchtet, wird die zuletzt eingestellte Farbe eingeschaltet.* - (…KANÄLE…)/forTime/(…ZEITEN…) *wobei (…CHANNELS…) für die 4 Helligkeitswerte steht (siehe oben) und (…TIMES…) für die Zeit in Sekunden, für die die jeweilige Helligkeit/Farbe aktiviert werden soll.* - x/(…EFFECT_ID…) *wobei (…EFFECT_ID…) eine Ziffer ist – die Nummer des Effekts aus der App (0–9).* *Beispiele:* - offon/last – *Schaltet die zuletzt eingestellte Farbe bzw. Helligkeit der Kanäle ein oder aus.* - FF00000000/forTime/5 – schaltet die Farbe Rot für 5 Sekunden ein - x/0 – deaktiviert den Effekt - x/1 – aktiviert den Effekt mit der Nummer 1 - x/5 – aktiviert den Effekt mit der Nummer 5 ## shutterBox *Für Aktionen vom Typ **„URL senden**“: – http://IP/s/(…REQUEST…)* *Für Aktionen vom Typ: **„Ein anderes Gerät steuern“:*** *– (…REQUEST…)* *wobei (…REQUEST…) ein Zeichen oder ein Wert ist (im Falle einer am Steuergerät durchgeführten Kalibrierung), der im Folgenden beschrieben wird:* - u – öffnen - d – schließen - s – Stopp - n – nächster Befehl in der Abfolge (nächster Befehl in der Abfolge „Öffnen-Stopp-Schließen-Stopp“) - f – Lieblingsposition (nur bei kalibriertem Steuergerät) *Beispiele:* - u – führt zum Öffnen - d – führt zum Schließen - s – führt zum Anhalten - n- löst den nächsten Befehl in der Abfolge „Öffnen-Stopp-Schließen-Stopp“ aus - f – führt dazu, dass das Programm zur Favoritenposition „springt“ **Fortgeschrittene:** - p/(…VALUE_PERCENTAGE…) - t/(…VALUE_PERCENTAGE…) *wobei (…VALUE_PERCENTAGE…) eine Zahl zwischen 0 und 100 ist, die den Schließprozentsatz angibt (nur bei einem kalibrierten Regler).* *Beispiele:* - p/0 – bewirkt das Öffnen (entspricht u) - p/100 – führt zum Schließen (entspricht d) - p/50 – bewirkt, dass sich das Tor zur Hälfte schließt - t/0 – bewirkt die minimale Lamellenstellung, abhängig vom Motor - t/100 – bewirkt die maximale Einstellung der Lamellen je nach Motor - t/50 – bewirkt die Einstellung der Lamellen je nach Motor ## rollerGate *Für Aktionen vom Typ **„URL senden**“: – http://IP/s/(…REQUEST…)* *Für Aktionen vom Typ: **„Ein anderes Gerät steuern“:*** *– (…REQUEST…)* *wobei (…REQUEST…) das unten beschriebene Zeichen ist:* - o – öffnen - c – schließen - s – Stopp - n – nächster Befehl in der Abfolge (nächster Befehl in der Abfolge „Öffnen-Stopp-Schließen-Stopp“) - w – Übergangs-/Lüftungsstellung (nur bei kalibriertem Regler) *Beispiele:* - o – bewirkt das Öffnen - c – führt zum Schließen - s – führt zum Anhalten - n – löst den nächsten Befehl in der Abfolge „Öffnen-Stopp-Schließen-Stopp“ aus - w – führt zu einer „Fahrt“ zur Favoritenposition, zu Fußgängerüberwegen oder zum Lüften **Fortgeschrittene:** - p/(…VALUE_PERCENTAGE…) *wobei (…VALUE_PERCENTAGE…) eine Zahl zwischen 0 und 100 ist, die den Prozentsatz des Torverschlusses angibt (nur bei kalibrierter Steuerung).* *Beispiele:* - p/0 – bewirkt das Öffnen (gleichbedeutend mit o) - p/100 – führt zum Schließen (entspricht c) - p/50 – bewirkt, dass sich das Tor zur Hälfte schließt ## gateBox *Für Aktionen vom Typ **„URL senden**“: – http://IP/s/(…REQUEST…)* *Für Aktionen vom Typ: **„Ein anderes Gerät steuern“:*** *– (…REQUEST…)* *wobei (…REQUEST…) das unten beschriebene Zeichen ist:* - p – den ersten Ausgang ansteuern (Impuls am Tastereingang der Torsteuerung) - s – den zweiten Ausgang ansteuern (Impuls am Tastereingang der Torsteuerung), (fällt bei der doorBox weg) *Beispiele:* - p – bewirkt die Ansteuerung des ersten Ausgangs - s – bewirkt die Ansteuerung des zweiten Ausgangs (nicht vorhanden bei der doorBox) ## saunaBox **Maßnahmen**(Anweisungen) **für das Produkt „saunaBox“:** *Für Aktionen vom Typ **„URL senden**“: – http://IP/s/(…REQUEST…)* *Für Aktionen vom Typ: **„Ein anderes Gerät steuern“:*** *– (…REQUEST…)* *wobei (…REQUEST…) die im Folgenden beschriebene Ziffer ist:* - 0 – Heizung ausschalten - 1 – Heizung mit der zuletzt eingestellten Temperatur einschalten *Beispiele:* - 0 – schaltet die Heizung aus - 1 – schaltet die Heizung mit der zuletzt eingestellten Temperatur ein **Fortgeschrittene:** - t/(…TEMPERATURE_X100…) *wobei (…TEMPERATURE_X100…) die mit 100 multiplizierte Temperatur ist, d. h. von -5500 bis 12500 (von -55 bis +125).* *Beispiele:* - t/0 – stellt die Temperatur auf 0 Grad ein (schaltet die Sauna weder ein noch aus) - t/125 – stellt die Temperatur auf 125 Grad ein (schaltet die Sauna nicht ein/aus) - t/60 – stellt die Temperatur auf 60 Grad ein (schaltet die Sauna nicht ein/aus) ## thermoBox *Für Aktionen vom Typ **„URL senden**“: – http://IP/s/(…REQUEST…)* *Für Aktionen vom Typ: **„Ein anderes Gerät steuern“:*** *– (…REQUEST…)* *wobei (…REQUEST…) die im Folgenden beschriebene Ziffer ist:* - 0 – Controller ausschalten - 1 – Schalten Sie den Regler mit der zuletzt eingestellten Temperatur ein - 3 – Aktiviere den BOOST-Modus *Beispiele:* - 0 – schaltet die Heizung aus - 1 – schaltet die Heizung mit der zuletzt eingestellten Temperatur ein **Fortgeschrittene:** - 1/t/(…TEMPERATURE_X100…) - 0/t/(…TEMPERATURE_X100…) - t/(…TEMPERATURE_X100…) - t/inc/(…TEMPERATURE_X100…) - t/dec/(…TEMPERATURE_X100…) *wobei (…TEMPERATURE_X100…) die mit 100 multiplizierte Temperatur ist, d. h. von -5500 bis 12500 (von -55 bis +125).* *Beispiele:* - 1/t/2300 – bewirkt das Einschalten des Reglers und die Einstellung der Temperatur auf 23 Grad - t/2000 – stellt die Temperatur auf 20 Grad ein (schaltet den Regler nicht ein/aus) - t/2250 – stellt die Temperatur auf 22,5 Grad ein (schaltet den Regler nicht ein/aus) - 0/t/2100 – bewirkt das Ausschalten des Reglers und die Einstellung der Temperatur auf 21 (z. B. für die zukünftige Heizperiode) - t/inc/100 – bewirkt einen Temperaturanstieg um 1 Grad - t/dec/50 – bewirkt eine Senkung der Temperatur um 0,5 Grad ## actionBox *Für Aktionen vom Typ **„URL senden**“: (Achtung: anders als bei anderen Treibern) – http://IP/t/(…REQUEST…)* *Für Aktionen vom Typ: **„Ein anderes Gerät steuern“:*** *– (…REQUEST…)* *wobei (…REQUEST…) für **/** steht, wobei:* - ***** ist eine Zahl zwischen 0 und 3 (entsprechend der Nummer der actionBox-Taste, die mit 1 bis 4 gekennzeichnet ist)* - ****** ist der in der actionBox festgelegte Trigger: - 1 – kurzer Klick - 2 – Langdruck - 3 – abfallende Flanke (z. B. Loslassen einer Taste) - 4 – ansteigende Flanke (z. B. beim Drücken einer Taste) - 5 – Schräge (z. B. sowohl Loslassen als auch Drücken) *Beispiele:* - 0/1 - 2/5 ## multiSensor **Maßnahmen**(Anweisungen) **für das Produkt „saunaBox“:** *Für Aktionen vom Typ **„URL senden**“: – http://IP/(…ENDPOINT…)* *wobei (…ENDPOINT…) der unten beschriebene Pfad ist:* - *`state` –* gibt den Grundzustand der Sensoren zurück (id, type, value, state, trend, elapsedTimeS) - `state/extended` – führt zum Auslesen der vollständigen Sensordaten einschließlich ihrer Bezeichnungen und Symbole ### Sensortypen (`type` als Reaktion auf `state`) - `temperature` – Temperatur - Weitere Typen, abhängig vom Modell/der Konfiguration der Sonden – siehe `api/probes/state` ### Felder zur Beschreibung eines einzelnen Sensors - *`id` –* Sensornummer - `type` – Sensortyp - `value` – aktueller Wert - `state` – Messstatus (Zahlencode) - `trend` – Richtung des Werttrends (Zahlencode) - `elapsedTimeS` – Zeit (s) seit der letzten Messung - *`iconSet` (nur `state/extended`)*– dem Sensor zugewiesenes Symbol - *`name` (nur „`state/extended`“)* – Bezeichnung des Sensors