Skip to content

07 Sonstige Integrationen

Jump to bottom Edit New page
63chris edited this page Apr 27, 2025 · 4 revisions

ioBroker

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) grafik

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 grafik

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"
 }

grafik

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"
 }

grafik

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"
 }

grafik

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":"%"
 }

grafik

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"
 }

grafik

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"
 }

grafik

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,"
 }

grafik

CCU-Jack

seit April 25 sind auch 8 ausgewählte Geräte des CCU-Jacks in HH darstellbar.

Die Darstellung in HH ist jetzt für die grün markierten Gerätesymbole möglich, welche unter CCU-Jack ausgewählt werden können.

grafik

CCU-Jack hat keine fest definierten Kanäle zu einem Gerätesymbol. Man klickt sich bis zu 32 beliebige Kanäle selber zusammen. So kann z.B. ein Handsender wie HM-RC-8 Schaltaktoren oder Dimmerkanäle enthalten und keinen Taster. Deshalb wurde die Erkennung von CCU-Jack Geräten nicht als eigenständige Definition, sondern in die jeweilige Gerätedatei des original HM-Gerätes integriert (z.B. eines HM-LC-Sw1-DR).

Als mögliche Kanaltypen funktionieren bis dato:

  • MQTT-Schaltaktor (mit Rückmeldung)
  • MQTT Tür-/Fensterkontakt
  • MQTT Analogwertempfänger
  • MQTT Temperatur-/Feuchtesensor

Das führt auch dazu, dass alle Kanäle nach einem neuerlichen Import unabhängig von der Art der Kanäle in der gleichen Kategorie auftauchen, die dem originalen HM-Gerät in der mapping.json zugeordnet sind. Beispiele:

  • ein CCU-Jack HM-LC-Sw1-DR unter der Kategorie "Geräte"
  • ein CCU-Jack HmIP-STHO unter der Kategorie "Wetter"
  • ein CCU-Jack HM-RC-19 unter der Kategorie "Sender"

Wird für ein solches Gerät der Partent als CCU-Jack-Gerät erkannt und der Datenpunkt (Kanal) ist "STATE", wird er normal als Schalter angeboten. Falls nicht, wird der erste groß geschriebene Datenpunkt genommen. Die Ausgabe ist jedoch dann der direkte Wert. Dieser kann "manipuliert" werden indem man sich einen Datenpunkt nach Gusto auswählt Komponente ist egal. Hier gibt es viele Möglichkeiten.

Parameter für config.json

Parameter Inhalt/Zustände Anwendung & Hinweise
"name" "Name des kanals" so wie in der kategorie angezeigt (analog zu einem original HM-Gerät
"ccujack_value" "type laut statelist.cgi" "STATE, VOLTAGE, ACTUAL_TEMPERATURE, HUMIDITY, PRESS_LONG, PRESS_SHORT"
"ccujack_component" "Dateiname des HM(IP)Gerätes" Referenzgerät für Darstellungsänderung, für Dateinamen siehe /homehub/components, Angabe ohne Dateierweiterung
"ccujack_datapoint" "Typ des Datenpunktes zu ccujack_component" Referenzdatenpunkt für Darstellungsänderung, für Datenpunktbezeichnung siehe z.B. statelist.cgi (type=xxxx)

grafik

Hinweis: parameter wie "showtime" oder "color" können auch hier verwendet werden

Beispiele

Beispiel 1 unformatierter CCU-JACK MQTT-Schaltaktor mit Rückmeldung und showtime (kann man so schon belassen)

{
"name":"Bad-Miefquirl-Aktor",
"icon":"temp_temperature.png",
"showtime":"true"
}

grafik

Beispiel 2 unformatierter CCU-JACK MQTT-Analogwertempfänger

{
"name":"WZ-Rack-2PM-2-Spannung",
"icon":"temp_temperature.png",
}

grafik

Ausgabe formatiert mit dem Datenpunkt "VOLTAGE" eines HmIP-PSM-2

grafik

{
"name":"WZ-Rack-2PM-2-Spannung",
"icon":"temp_temperature.png",
"ccujack_value":"VOLTAGE",
"ccujack_component":"HmIP-PSM-2",
"ccujack_datapoint":"VOLTAGE"
}

grafik

Beispiel 3

unformatierter CCU-JACK MQTT-Analogwertempfänger

{
"name":"WZ-Rack-2PM-2-Temperatur",
"icon":"temp_temperature.png"
}

grafik

Ausgabe formatiert mit dem Datenpunkt "ACTUAL_TEMPERATURE" eines HmIP-STHO (zusätzlich mit showtime und color)

{
"name":"WZ-Rack-2PM-2-Temperatur",
"icon":"temp_temperature.png",
"ccujack_value":"VOLTAGE",
"ccujack_component":"HmIP-STHO",
"ccujack_datapoint":"ACTUAL_TEMPERATURE",
"color": "#FF0000",
"showtime":"true"
}

grafik

Beispiel 4

unformatierter CCU-JACK Tür-/Fensterkontakt

{
"name":"Spueli-DoorState",
"icon":"fts_window_2w_tilt.png"
}

grafik

Ausgabe formatiert mit dem Datenpunkt "STATE" eines HmIP-SWDM

{
"name":"Spueli-DoorState",
"icon":"fts_window_2w_tilt.png",
"ccujack_value":"STATE",
"ccujack_component":"HmIP-SWDM",
"ccujack_datapoint":"STATE"
}

grafik

Beispiel 5

unformatierter CCU-JACK HmIP-STHO - für dieses CCU-Jack Gerät ist die Formatierung schon "fertig"

{
"name":"Sonoff-WK-12",
"icon":"temp_temperature.png"
}

grafik

Add a custom footer
Add a custom sidebar
Clone this wiki locally