Dingz mit Home Assistant

dariox

In diesem Beitrag will ich euch kurz zeigen, wie ihr den PIR Sensor von Dingz mit Home Assistant verwenden könnt.
Zuerst muss die Rest API im WEB UI von Dingz aktiviert werden. Die Doku dazu findet ihr unter: https://documenter.getpostman.com/view/11123877/Szf55A3X?version=latest

In Home Assistant braucht es lediglich ein Rest Binary Sensor:

binary_sensor:
   - platform: rest
     resource: http://192.168.2.96/api/v1/motion
     name: Flur Bewegungsmelder rest
     scan_interval: 1 
     value_template: '{{ value_json.motion }}'

Der Interval Wert von 1 generiert natürlich viel Netzwerkverkehr, ich habe jedoch keine Probleme damit festgestellt.

Auch non Binary Sensoren lassen sich einfach integrieren mit:

sensor:
  - platform: rest
    resource: http://192.168.2.96/api/v1/temp
    name: Flur Temperatur
    scan_interval: 60
    value_template: '{{ value_json.temperature }}'

Viel Spass damit

Sofasurfer

dariox danke für die Anleitung.

Für diejenigen, die ebenso neu in Home Assistant sind wie ich, noch eine andere Variante der Konfiguration mit folgenden Unterschieden:

Modularisiert durch !include_dir_list in configuration.yaml und einzelnen Files für die Sensoren in den Unterordnern der Konfiguration.
Temperatur auf 1 Komma Stelle gerundet {{ value_json.temperature|float|round(1) }}
device_class Angabe, womit dann auch das korrekte Symbol und Text angezeigt wird

/config/configuration.yaml

sensor: !include_dir_list sensors/
binary_sensor: !include_dir_list binary_sensors/

/config/sensors/Temperatur/DGZ_Bad_Temp.yaml

platform: rest
method: GET
name: Bad °C
value_template: '{{ value_json.temperature|float|round(1) }}'
resource: http://192.168.1.190/api/v1/temp
scan_interval: 60 
device_class: temperature
unit_of_measurement: '°C'

/config/binary_sensors/Motion/DGZ_Bad_Motion.yaml

platform: rest
method: GET
name: Motion Bad
resource: http://192.168.1.190/api/v1/motion
scan_interval: 1 
device_class: motion
value_template: '{{ value_json.motion }}'

Eine alternative Variante ist Sensoren mit Template einzubinden, was es erlaubt neben Temperatur auch z.B. gleich den Stromverbrauch auszulesen. Ob das mit dem Motion Sensor funktioniert habe ich aber noch nicht rausgefunden. Das was ich an Infos fand, deutet aber eher nicht drauf hin, weil z.B. motion als device_class nicht im template verfügbar ist.
https://forum.dingz.ch/d/27-dingz-sensoren-mit-template-einbinden-watt-temperatur

Weiter findet ihr in https://forum.dingz.ch/t/home-assistant viele weitere Beispiele wie

Dimmer auf Dingz ein-, ausschalten und Helligkeit setzen
Tastendruck auf Dingz auslösen
LED des Dingz steuern
Licht Template für Lovelace

Strupi

Super Thema!

Ich bin neu mit Home Assistant und (logischerweise) auch mit Dingz - sehe aber das riesige Potential dieses Setups.

Wäre es antstatt des Pollings nicht möglich (und besser) als Dingz PIR action einen REST Endpoint bei Home Assistant zu setzen? Das würde gehen, oder? Natürlich ist der Aufwand relativ gross auf Home Assistant seite für jeden Dingz Input einen Enpoint zu definiieren. Spricht noch was anderes dagegen?

johannrichard

Strupi Im Prinzip kann man tatsächlich auch die PIR action nutzen. Unabhängig von der HomeAutomation (HA) Platform gibt es aber ein paar Unterschiede zwischen dem pollen des motion endpoint und der PIR "push" action auf dem dingz -- je nach dem was man erreichen will oder sonst noch macht, ist die eine oder andere Methode passender.

Trigger-Verhalten:

Der motion Endpoint wie hier vorgestellt repräsentiert quasi den physischen Status des PIR sensors. Sobald sich etwas bewegt, geht motion auf true, stoppt die Bewegung (resp. nimmt der PIR nichts mehr wahr), so geht motion sofort zurück auf false. Je nach dem wie oft man pollt (hier: 1s) wird eine Änderung also im Sekundentakt in der HomeAutomation Platform registriert.
Nutzt man die PIR action (So wie von @technikblog hier für Loxone beschrieben), so wird zwar bei einer Bewegung sofort die action ausgelöst und die entsprechende Payload mitgegeben. Jedoch wird der motion reset (also wenn das dingz meldet, dass es keine Bewegung mehr gibt) unabhängig von tatsächlicher Bewegung frühestens nach dem Ablaufen eines Timers ausgelöst welcher standardmässig auf 180s (!) gesetzt ist und über die Web UI (soweit ich beurteilen kann) auf ein Minimum von 5s gesetzt werden kann. (Also ein ähnliches Verhalten, wie man es von "klassischen" PIR Sensoren für die Elektroinstallation kennt)

Weiter gilt es auch noch zu beachten, dass man zwar problemlos einmal pro Sekunde das dingz pollen kann. Kommen allerdings -- aus Gründen -- andere "polls" dazu, so kann es durchaus passieren, dass der poll etwas länger dauert. Das kann unter Umständen zu einer Kasakade an Requests führen welche in ein timeout laufen da das dingz nach meiner Erfahrung zwar schon mit mehreren "parallelen" requests umgehen kann, jedoch nicht mit beliebig vielen -- und dann irgendeinmal nicht mehr reagiert.

Was die PIR action anbelangt: Um sicher zu gehen dass diese möglichst rasch ausgelöst wird, macht es m.E. nach Sinn, hier die IP des HA Servers anzugeben und nicht einen Hostnamen. Damit entfällt die DNS Auflösung und allfällige Verzögerungen deswegen. Hat man mehrere Endpoints for die PIR action gesetzt, so werden diese seriell abgearbeitet. Ist ein Server nicht reaktiv, so hat man eine spürbare Verzögerung bei den weiteren Aktionen. Was zu lustigen Situationen führen kann wenn Mensch und Maschine plötzlich um die Deutungshoheit des AN/AUS Status einer Lampe kämpfen.

Simon

johannrichard Jedoch wird der motion reset (also wenn das dingz meldet, dass es keine Bewegung mehr gibt) unabhängig von tatsächlicher Bewegung frühestens nach dem Ablaufen eines Timers ausgelöst welcher standardmässig auf 180s (!) gesetzt ist und über die Web UI (soweit ich beurteilen kann) auf ein Minimum von 5s gesetzt werden kann.

Wo kannst du diesen Wert auf 5s einstellen im Web UI? Ich habe diesen Wert bislang nur mit der myStrom(!)-App [nicht die Dingz-App] unter dem Punkt 'Motion Sensor' > Aktionen > 'Wenn keine Bewegung erkannt... nach' > Wert aus Liste auswählen: zwischen 30 Sekunden und 60 Minuten. Wichtig: Dieser Wert wird auch verwendet, wenn im nachfolgenden Feld 'ausführen' nichts definiert ist und man die Aktion über eine externe HA-Software ausführt.

Strupi

johannrichard Habe soeben versucht, das so umzusetzen (über die action). Leider bin ich daran gescheitert, dass die Dingz Action URL keine Token Authentifizierung unterstützt, die für die Home Assistant Rest API benötigt wird. Oder übersehe ich etwas?

johannrichard

Simon Sorry, sehe den Kommentar erst jetzt. Du kannst das unter "Motion Detector" -> "Timer" finden:

http://dingz-ip/index.html#/pir

HaKuNa

Strupi genau das problem hatte ich auch mit OpenHAB3. Mein Workaround/Lösung findest Du hier (müsste auch mit HA gehen):
https://github.com/HaKuNaCH/dingzOpenHabHelperApi