XiaomiBTLESens

Aus FHEMWiki
Zur Navigation springen Zur Suche springen
XiaomiBTLESens
Zweck / Funktion
Auslesen unterstützter Xiaomi BTLE Sensoren
Allgemein
Typ Gerätemodul
Details
Dokumentation EN / DE
Support (Forum) Sonstige Systeme
Modulname 74_XiaomiBTLESens.pm
Ersteller CoolTux
(Forum / Wiki)
Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref!


Beschreibung

Mit diesem Modul ist es möglich diverse BTLE Sensoren der Firma Xiaomi aus zu lesen auszulesen und die entsprechenden Daten als Readings darzustellen. Zum Beispiel den XiaomiFlowerMonitor.

Voraussetzung zur Verwendung des Modules ist:

  • libjson-perl
  • bluez (gatttool und hcitool)

Mittels hcitool lescan bekommt man die BT-MAC, die benötigte Bluetooth MAC Adresse.

Achtung: auf einem Debian Wheezy scheint es Probleme mit dem Bluetooth Stack zu geben. Selbst wenn man ein aktuelles BT 5.x selbst kompiliert und installiert gibt spätestens das gatttool keine Daten mehr aus. Es muss zwingend auf Debian Jessie geupgraded werden.

Definition

define <name> XiaomiBTLESens <BT-MAC>

Beispiel:

define Weihnachtskaktus XiaomiBTLESens C4:7C:8D:62:42:6F

Diese Anweisung erstellt ein XiaomiBTLESens Device mit dem Namen Weihnachtskaktus und der BT MAC C4:7C:8D:62:42:6F. Als nächstes sollte auf jeden Fall das Attribut model gesetzt werden, um das korrekte Gerät an zu sprechen.


Readings

  • state - aktueller Status des Device.
  • battery - Status der Batterie in Abhängigkeit des batteryLevel Readings.
  • batteryLevel - Füllstand der Batterie in Prozent.
  • fertility - Nährstoffgehalt des Pflanzenbodens (Dünger) - Bodenleitfähigkeit
  • firmware - aktuelle Firmware auf dem Device
  • lux - aktuelle Lichtintensität
  • moisture - Wassergehalt (Feuchtigkeit) des Pflanzenbodens
  • temperature - Umgebungstemperatur

Set

  • devicename - setzt einen Devicenamen

Get

  • sensorData - aktive Abfrage der Sensors Werte
  • devicename - liest den Devicenamen aus
  • firmware - liest die Firmeware aus

Attribute

  • interval - Intervallzeit in Sekunden, nach der der nächste automatische Datenabruf erfolgen soll
  • model - Auswahl eines unterstützten Gerätes
  • disable - deaktiviert die den Abruf
  • disabledForIntervals - deaktiviert das Gerät für den angegebenen Zeitinterval (13:00-18:30 or 13:00-18:30 22:00-23:00)
  • minFertility - min Fruchtbarkeits-Grenzwert für ein Ereignis minFertility low
  • maxFertility - max Fruchtbarkeits-Grenzwert für ein Ereignis maxFertility high
  • minMoisture - min Feuchtigkeits-Grenzwert für ein Ereignis minMoisture low
  • maxMoisture - max Feuchtigkeits-Grenzwert für ein Ereignis maxMoisture high
  • minTemp - min Temperatur-Grenzwert für ein Ereignis minTemp low
  • maxTemp - max Temperatur-Grenzwert für ein Ereignis maxTemp high
  • minlux - min Helligkeits-Grenzwert für ein Ereignis minlux low
  • maxlux - max Helligkeits-Grenzwert für ein Ereignis maxlux high
    Beispiele für min/max-Ereignisse:
    2017-03-16 11:08:05 XiaomiFlowerSens Dracaena minMoisture low
    2017-03-16 11:08:06 XiaomiFlowerSens Dracaena maxTemp high
  • sshHost - FQDN oder IP-Adresse eines entfernten SSH-Systems. Das SSH-System ist auf eine Zertifikat basierte Authentifizierung zu konfigurieren. Am elegantesten geschieht das mit einer .ssh/config Datei auf dem SSH-Client.