Beispiele für Homebridge Mappings in FHEM


Dieser Beitrag soll euch möglichst viele Beispiele an Homebridge Mappings für FHEM liefern. Nicht alle Beispiele stammen von mir, da mir schlichtweg diese Geräte in meiner SmartHome Sammlung fehlen. Diese Liste wird stetig erweitert sobald es neue Devices gibt. Sollten euch Fehler oder Ergänzungen auffallen, dann schreibt einfach per Kommentar oder über das Kontaktformular.

Fakegato-history

Wer sein homebridge-fhem Modul seit Mitte Februar 2019 aktulisiert und auch das fakegato-history Modul installiert hat, der sollte zu seinen Homebridge Mappings unbedingt history:size=1024 hinzufügen. Dadurch erhaltet ihr in der EVE App diese tollen Verlaufskurven, die es sonst nur für die original EVE Geräte gibt.

„Defekte Attribute“

Es kommt leider immer mal wieder vor, dass einzelne Attributenach einem Update nicht mehr funktionieren. Dies hat im besten Fall keinerlei Einfluss auf das Device, kann aber im Einzelfall bis zum Absturz der HomeBridge führen.

Aktuell mir bekannte Problemfälle sind:

  • FirmwareRevision: Kann zum Absturz der Homebridge führen (Stand: Feb 2019)
  • Model: Das Attribut wird beim genericDeviceType Speaker einfach leer in der EVE App angezeigt (Stand: Apr 2019)

Temperatur- und Feuchtigkeitssensoren

Xiaomi Mijia Temperature Humidity Sensor

Xiaomi Mijia Temperatur- und Feuchtigkeitssensor

Einfacher Temperatur und Feuchtigkeitssensor von Xiaomi Mijia.
Zunächst müsste ihr definieren ob es als Temperatur- oder Feuchtigkeitssensor behandelt werden soll.
Dies entscheidet welcher Wert in der EVE App primär angezeigt wird.

attr <Device> genericDeviceType TemperatureSensor
oder
attr <Device> genericDeviceType HumiditySensor

Homebridge Mapping:

CurrentRelativeHumidity=humidity
CurrentTemperature=temperature
StatusLowBattery=batteryState,values=ok:BATTERY_LEVEL_NORMAL;/^.*/:BATTERY_LEVEL_LOW
095c46e2-278e-4e3c-b9e7-364622a0f501:dewpoint,name=Taupunkt,format=FLOAT,unit=CELSIUS,maxValue=30,minValue=-30,minStep=.1
history:size=1024

Optionale Mappings:

Ihr könnt euch zusätzlich noch die Spannung der Batterie anzeigen lassen

E863F10A-079E-48FF-8F27-9C2605A29F52=batteryVoltage,factor=1000,name=Voltage,format=FLOAT
Sensor Batterie Spannung

Beide Werte gleichzeitig anzeigen

Wollt ihr direkt beide Werte (Temperatur und Feuchtigkeit) in der Übersicht sehen, dann bleibt leider nur der Umweg über ein Dummy Device.
Dafür definiert ihr den Sensor und das Mapping wie folgt:

attr <Device> genericDeviceType TemperatureSensor

CurrentTemperature=temperature
StatusLowBattery=batteryState,values=ok:BATTERY_LEVEL_NORMAL;/^.*/:BATTERY_LEVEL_LOW
history:size=1024

Anschließend ein Dummy Device erstellen und definieren:

define <Dummy> dummy
attr <Dummy> genericDeviceType HumiditySensor

CurrentRelativeHumidity=<Device>:humidity
history:size=1024
Xiaomi Aqara Temperatur, Feuchtigkeits- und Luftdrucksensor

Xiaomi Aqara Temperatur, Feuchtigkeits- und Luftdrucksensor

Der etwas neuere Sensor von Xiaomi Aqara unterscheidet sich von dem Mijia Sensor nur darin, dass zusätzlich auch noch der Luftdruck gemessen wird. Daher wird an dieser Stelle auch nur das Homebridge Mapping gezeigt, alles Andere kann von dem Mijia Sensor übernommen werden.

Homebridge Mapping

Der Luftdruck wird vom Sensor nur in kPa ausgegeben, daher erhöhen wir den Wert um den Faktor 10 um auf den, von der EVE App unterstützen, hPa Wert zu kommen.

attr <Device> genericDeviceType TemperatureSensor

E863F10F-079E-48FF-8F27-9C2605A29F52=pressure,format=FLOAT,factor=10
095c46e2-278e-4e3c-b9e7-364622a0f501:dewpoint,name=Taupunkt,format=FLOAT,unit=CELSIUS,maxValue=30,minValue=-30,minStep=.1
CurrentRelativeHumidity=humidity
CurrentTemperature=temperature
StatusLowBattery=batteryState,values=ok:BATTERY_LEVEL_NORMAL;/^.*/:BATTERY_LEVEL_LOW
history:size=1024

Alternative

Man kann sich natürlich auch vorher bereits die kPa in hPa umwandeln und nutzen.
Dazu einfach ein UserReading erstellen und das Mapping anpassen:

attr <Device> userReadings pressure_hpa { ReadingsNum("<Device>","pressure",0) * 10 }

Mapping:
E863F10F-079E-48FF-8F27-9C2605A29F52=pressure_hpa,format=FLOAT

Vielen Dank an Jens für den Tipp mit dem Taupunkt.

Xiaomi Aqara Leakage Sensor

Xiaomi Aqara Water Leak Sensor

Der Xiaomi Aquara Water Leak Sensor soll dabei helfen auslaufende Flüssigkeiten zu erkennen. Hauptsächlich wird er sicherlich im Bereich von Wasch- und Spülmaschine oder im Keller eingesetzt.

Homebridge Mapping

attr <Device> genericDeviceType LeakSensor

LeakDetected=state,values=no_leak:LEAK_NOT_DETECTED;leak:LEAK_DETECTED
StatusLowBattery=batteryState,values=ok:BATTERY_LEVEL_NORMAL;/^.*/:BATTERY_LEVEL_LOW

Licht und Beleuchtung

Yeelight Light Strip

Yeelight LED Light Strip

Homebridge Mapping

clear wird verwendet um die Default Mappings zu löschen.

attr <Device> genericDeviceType Lightbulb

clear
On=power,valueOn=on,valueOff=off,cmdOn=on,cmdOff=off
Brightness=bright,cmd=bright,minStep=10
Hue=hue,cmd=hue,minStep=10
Saturation=sat,cmd=sat,minStep=10
StatusActive=state,valueOn=opened,valueOff=disconnected

Heizung

AVM FritzDect 301

FRITZ!DECT 300/301

Homebridge Mapping

attr <Device> genericDeviceType thermostat

TargetTemperature=desired-temp:desired-temp,minValue=14,maxValue=25,minStep=1
CurrentTemperature=temperature,nocache=1
StatusLowBattery=batterylow,values=0:BATTERY_LEVEL_NORMAL;1:BATTERY_LEVEL_LOW
BatteryLevel=batteryPercent
LockPhysicalControls=devicelock,values=no:CONTROL_LOCK_DISABLED;yes:CONTROL_LOCK_ENABLED
Model=FBTYPE
StatusActive=present,valueOn=yes,valueOff=no
history:size=1024
FritzDect 301 Eve App

Bewegungsmelder

Xiaomi Mijia Motion Sensor

Älterer Bewegungssensor von Xiaomi Mijia. Etwa günstiger als der neuere Bewegungssensor von Xiaomi Aqara. Kann aber auch nicht die Umgebungshelligkeit messen. Zu erkennen am Mijia Logo oben auf dem Gehäuse und dem Loch an der Seite.

Homebridge Mapping

attr <Device> genericDeviceType MotionSensor

MotionDetected=state,values=motion:1;off:0
StatusLowBattery=batteryState,values=ok:BATTERY_LEVEL_NORMAL;/^.*/:BATTERY_LEVEL_LOW
history:size=1024
Xiaomi Mijia Motion Sensor Eve App

Xiaomi Aqara Motion Sensor

Neuerer Bewegungssensor von Xiaomi Aqara. Kann zusätzlich die Umgebungshelligkeit messen. Zu erkennen am Aqara Logo auf der Gehäuseoberseite und dem Button an der Seite.

Homebridge Mapping

attr <Device> genericDeviceType MotionSensor

MotionDetected=state,values=motion:1;off:0
StatusLowBattery=batteryState,values=ok:BATTERY_LEVEL_NORMAL;/^.*/:BATTERY_LEVEL_LOW
0000006B-0000-1000-8000-0026BB765291:lux,name=BRIGHTNESS,format=FLOAT,unit=LUX,maxValue=10000,minValue=0,minStep=.0001
history:size=1024

Kontaktsensoren

Xiaomi Mijia/Aqara Door Window Sensor

Die Kontaktsensoren von Mijia und Aqara unterscheiden sich äußerlich, aber nicht in deren Funktion. Da die Aqara Sensoren etwas neuer sind, sollten diese bei ähnlichem Preis bevorzugt werden.

Homebridge Mapping

CurrentDoorState wird nur für Türen benötigt, bei Fenstern nicht.

attr <Device> genericDeviceType ContactSensor

ContactSensorState=state,values=close:CONTACT_DETECTED;open:CONTACT_NOT_DETECTED
CurrentDoorState=state,values=close:CLOSED;open:OPEN
StatusLowBattery=batteryState,values=ok:BATTERY_LEVEL_NORMAL;/^.*/:BATTERY_LEVEL_LOW
history:size=1024

WLAN

FRITZ!Box und FRITZ!WLAN Repeater

Die FritzBox und auch die WLAN Repeater lassen sich sehr einfach über FHEM und HomeKit steuern. Nebenbei kann man sich auch den Stromverbrauch der Geräte errechnen.

Homebridge Mapping

Bei einigen Geräten, wie z.B. der WLAN Repeater 1750E, ist der Wert box_cpuTemp immer 0, daher kann das Characteristic weggelassen werden.

attr <FritzDevice> genericDeviceType switch

On=box_wlan_2.4GHz,valueOn=on,valueOff=off,cmdOn=wlan+on,cmdOff=wlan+off
CurrentTemperature=box_cpuTemp
Model=box_model
history:size=1024

Stromverbrauch berechnen

Um den Stromverbrauch des Gerätes zu berechnen, bedarf es nur einer kleinen Erweiterung. Der Wert wird automatisch vom Homebridge Mapping erfasst und muss nicht manuell hinzugefügt werden.

attr <FritzDevice> userReadings power {ReadingsVal("<FritzDevice>","box_powerRate",0)/100*<MaxWatt>}

Den Wert <MaxWatt> einfach aus folgender Tabelle entnehmen:

  • FRITZ!Box 7590: 30
  • FRITZ!Box 7582: 22
  • FRITZ!Box 7580: 30
  • FRITZ!Box 7560: 22
  • FRITZ!Box 7530: 18
  • FRITZ!Box 7520: 12
  • FRITZ!Box 7490: 27
  • FRITZ!Box 7430: 22
  • FRITZ!Box 7412: 10.3
  • FRITZ!Box 7362 SL: 14
  • FRITZ!Box 6890 LTE: 30
  • FRITZ!Box 6820 LTE: 6
  • FRITZ!Box 6591 Cable: 27.5
  • FRITZ!Box 6590 Cable: 26
  • FRITZ!Box 6490 Cable: 25
  • FRITZ!Box 6430 Cable: 22
  • FRITZ!Box 5491: 22
  • FRITZ!Box 5490: 27
  • FRITZ!Box 4040: 13
  • FRITZ!Box 4020: 9
  • FRITZ!Box 3490: 20
  • FRITZ!WLAN Repeater 1750E: 5.5
  • FRITZ!WLAN Repeater DVB-C: 5.5

Weitere Modelle findet Ihr unter folgendem Link https://avm.de/service/handbuecher/ und dann in den Handbüchern suchen nach Wirkleistung oder Stromverbauch. Wichtig ist die maximale Wirkleistung, es reicht nicht die „Durchschnittliche“ oder „im Betrieb“.

Gäste WLAN

Um das Gäste WLAN zu steuern eignet sich am Besten ein readingsProxy, ein Dummy würde auch gehen, bräuchte aber weitere Notifications um zu funktionieren.

define <Device> readingsProxy <FritzDevice>:box_guestWlan
attr <Device> event-on-change-reading state
attr <Device> genericDeviceType switch
attr <Device> homebridgeMapping On=state,valueOn=on,valueOff=off,cmdOn=on,cmdOff=off
attr <Device> setFn {fhem("set Fritzrepeater guestWlan ". ($CMD eq 'on' ?"on":"off"))}
attr <Device> setList state:on,off
attr <Device> webCmd on:off

Lautsprecher

Yamaha WX-010 und WX-030

Seit iOS 11.4 ist es möglich auch Lautsprecher über HomeKit zu steuern. Da diese älteren Lautspreche von Yamaha kein AirPlay 2 unterstützen, ist die Bedienung relativ weit eingeschränkt. Trotzdem kann man zumindest Grundlegende Funktionen über HomeKit steuern.

Homebridge Mapping

clear
On=state,valueOn=/on|mute|1/,valueOff=/off|standby|disappeared|0/,cmdOn=on,cmdOff=off
Volume=volume,maxValue=60,minStep=3,delay=true
Mute=mute,values=0:False;1:True
StatusActive=presence,valueOn=present,valueOff=absent

Die maximale Lautstärke ist auf 60 begrenzt bei diesen Lautsprechern.

Musiccast Lautsprecher in EVE App

Jalousien und Rolladen

Somfy

Auf Nachfrage habe ich folgendes Mapping für Somfy Rolladen hinzugefügt. Ich selber besitze derzeit keine Rolladen-Akktoren, daher habe ich dieses Beispiel als Grundlage genommen. Sollte etwas nicht passen, kurze Nachricht an mich und ich passe es an.

Homebridge Mapping

attr <Device> genericDeviceType blind
attr <Device> devStateIcon open:fts_shutter_10 10:fts_shutter_10 20:fts_shutter_20 30:fts_shutter_30 40:fts_shutter_40 50:fts_shutter_50 60:fts_shutter_60 70:fts_shutter_70 80:fts_shutter_80 90:fts_shutter_90 100:fts_shutter_90@lightblue schatten:fts_shutter_90@lightblue down:fts_shutter_100@blue closed:fts_shutter_100@blue

clear
CurrentPosition=userposition,invert=1,minValue=0,maxValue=100,minStep=10
TargetPosition=userposition,invert=1,minValue=0,maxValue=100,minStep=10,cmd=pos

Gefällt dir dieser Beitrag?

DislikeLike (+2 rating, 4 votes)
Loading...
Stefan

Stefan

IT Consultant für Microsoft Cloud Produkte, der gerne in seiner Freizeit am SmartHome arbeitet und optimiert.

Das könnte Dich auch interessieren …

2 Antworten

  1. Avatar Jens sagt:

    Zu den Aqara Temperatur Sensoren, Taupunkt in FHEm berechnen lassen. Dann das Homebridge Mapping um

    095c46e2-278e-4e3c-b9e7-364622a0f501:dewpoint,name=Taupunkt,format=FLOAT,unit=CELSIUS,maxValue=30,minValue=-30,minStep=.1
    erweitern und man hat in Eve, auch den Taupunkt.

    Hast due ein Beispiel für Doorbell aus einem Fensterkontakt mit on/off oder open/close? Oder auch ein Beispiel wie ich den Türsummer einbinde, habe dort nur ein Relais mit on/off.

    Website sieht gut aus, Beispiele sind Top, hast sogar ein Beispiel aus dem FHEM Forum von mir übernommen.
    Gruß Jens

    • Stefan Stefan sagt:

      Hi Jens,
      vielen Dank für deinen Kommentar.
      Werde ich zeitnah testen und dann in meiner Liste ergänzen.
      Wenn ich Beispiele übernehme versuche ich auch die Quelle zu nennen, scheint hier untergegangen zu sein.
      Hole ich nach.
      Bezüglich Doorbell bin ich noch nicht so weit, gab schon einige Überlegungen, aber einiges lässt sich in einer Mietwohnung nicht umsetzen.

      Vielen Dank,
      Stefan

Schreibe einen Kommentar

Deine E-Mail-Adresse wird nicht veröffentlicht. Erforderliche Felder sind mit * markiert.