07 ioBroker Integration

Im folgenden wird beschrieben, wie man Objekte aus ioBroker über die custom.json in Homehub integrieren kann. Die Vorgehensweise ist grundsätzlich identisch zur Einbindung von Homematic Geräten, man muss aber beachten, dass verschiedene Parameter hier nicht verfügbar sind, bzw. etwas anders verwendet werden (z.B. "name" oder "color")

Vorraussetzung ist ein aktivierter SimpleAPI-Adapter in ioBroker. Die Standardeinstellungen können belassen werden. (https://www.iobroker.net/#de/adapters/adapterref/iobroker.simple-api/README.md)

Parameter für config.json

Parameter	Inhalt/Zustände	Anwendung & Hinweise
"component"	"ioBroker"	fix
"api"	"http://IpdesioBrokers:8087"	Port lt. config des SimpleAPI-Adapters, Standard 8087
"name"	"beliebig"	Achtung bei Sonderzeichen
"icon"	"NameIconDatei.png"	Verzeichnis /homehub/icon/
"objekt"	"ObjektIDioBroker"	ID aus ioBroker Objektbaum
"modus"	"toggle","program","text","dimmer","color"	Siehe Beispiele
"modus"	"midasmode"	speziell für ioBroker.midas-aquatemp Adapter siehe hier
"unit"	1. "beliebig"; 2. "Zahl"	1. für Parameter = "text" ← zeigt Text, z.B. Einheit | 2. für Parameter = "dimmer" ← max. Wert in ioB
"label"	"beliebig"	Nur für "program", ändert Bezeichnung des Buttoms
„showtime“‍	„true | false“	Zeigt letzten Timestamp des Objektes. Gültig für toggle, program, text, dimmer, color, siehe Beispiel 3

für "unit": für z.B. Farbtemperatur kann der notwendige Wertebereich, um den vollen Einstellbereich verwenden zu können, nicht 0-100, sondern z.B. 0-550 sein. Das kann man in ioBroker testen und den max Wert hier hinterlegen.

Beim Modus "text" kann man jetzt per inputfeld einen neuen Wert setzen

---

Beispiele

Modus = "toggle": Zigbee Schalter

 {
 "component":"ioBroker", 
 "api":"http://192.168.178.66:8087",		
 "name":"ZB#7 Wohnzimmer",
 "icon":"message_socket.png",
 "objekt":"zigbee.0.7cb03eaa0a09311e.state",
 "modus":"toggle"
 }

Modus = "program": Zigbee Taster

 {
 "component":"ioBroker", 
 "api":"http://192.168.178.66:8087",		
 "name":"Xiaomi Zigbee Switch left",
 "icon":"control_centr_arrow_right.png",
 "objekt":"zigbee.0.90fd9ffffedae70c.arrow_left_click",
 "modus":"program",
 "label":"Klick"
 }

Modus = "text": Linux-Adapter Abfrage is-online (zeigt Ergebnis der letzten Abfrage mit Zeitpunkt)

 {
 "component":"ioBroker", 
 "api":"http://192.168.178.66:8087",			
 "name":"linux-control.0.DatschaServer.info.is_online",
 "icon":"cyan_dot.png",
 "objekt":"linux-control.0.DatschaServer.info.is_online",
 "modus":"text",
 "color": "#30D5C8",
 "showtime":"true"
 }

Hinweis: nach klicken auf den Namen erscheint ein Eingabefenster mit dem man in ioBroker beschreibbare Werte setzen kann. Beispiel-Anwendung

Modus = "text": Linux-Adapter Batterie Ladezustand

 {
 "component":"ioBroker", 
 "api":"http://192.168.178.66:8087",			
 "name":"Batterie",
 "icon":"measure_battery_75.png",
 "objekt":"linux-control.0.HomeServer.Batterie",
 "modus":"text",
 "unit":"%"
 }

Modus = "text": Shelly pro 3EM Spannung

 {
 "component":"ioBroker", 
 "api":"http://192.168.178.66:8087",			
 "name":"ioB Uservariable (Zahl)",
 "icon":"measure_current.png",
 "objekt":"0_userdata.0.Shelly_3EM.L1_Spannung",
 "modus":"text",
 "unit":"V"
 }

Modus = "color" (kombiniert): RGB-LED-Strip

 {
 "component":"ioBroker", 
 "api":"http://192.168.178.66:8087",	
 "name":"RGBW-Fenster RGB",
 "icon":"light_led_stripe_rgb.png",
 "objekt":"tuya.0.bfc82de5df4eba95a0uswb.22,tuya.0.bfc82de5df4eba95a0uswb.24-rgb,tuya.0.bfc82de5df4eba95a0uswb.20",
 "modus":"dimmer,color,toggle"
 }

Modus = "dimmer" (kombiniert): Zigbee-Lampe kalt-/warmweiss (Einstellbereich 0-550)

 {
 "component":"ioBroker", 
 "api":"http://192.168.178.66:8087",	
 "name":"Decke    Helligkeit | Temp",
 "icon":"light_ceiling_light.png",
 "objekt":"zigbee.0.d0cf5efffe28381c.brightness,zigbee.0.d0cf5efffe28381c.colortemp,zigbee.0.d0cf5efffe28381c.state",
 "modus":"dimmer,dimmer,toggle",
 "unit":",550,"
 }