XiaomiBTLESens

Aus FHEMWiki
Version vom 2. Dezember 2017, 15:19 Uhr von Drhirn (Diskussion | Beiträge) (Attribut ''disabledForIntervals'' ergänzt)
XiaomiBTLESens
Zweck / Funktion
Auslesen eines Xiaomi Flower Sensors
Allgemein
Typ Gerätemodul
Details
Dokumentation EN / DE
Support (Forum) Sonstige Systeme
Modulname 74_XiaomiFlowerSens.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 den XiaomiFlowerMonitor (Device Xiaomi Flower Sensor) auszulesen und die entsprechenden Daten als Readings darzustellen.

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> XiaomiFlowerSens <BT-MAC>

Beispiel:

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

Diese Anweisung erstellt ein XiaomiFlowerSens Device mit dem Namen Weihnachtskaktus und der BT MAC C4:7C:8D:62:42:6F.


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

  • statusRequest - aktive Abfrage des aktuellen Status des Xiaomi Flower Monitor und seiner Werte
  • clearFirmwareReading - löscht das Reading firmware für/nach Upgrade

Attribute

  • interval - Intervallzeit in Sekunden, nach der der nächste automatische Datenabruf erfolgen soll
  • 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.