XiaomiBTLESens

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 auszulesen und die entsprechenden Daten als Readings darzustellen, z. B. den XiaomiFlowerMonitor (XiaomiFlowerSens).

Das Modul ist der Nachfolger und eine Verallgemeinerung des bisherigen Moduls XiaomiFlowerSens (74_XiaomiFlowerSens). Letzteres ist weiter erreichbar, wird aber nicht mehr weiterentwickelt oder fehlerbereinigt.

Voraussetzung zur Verwendung des Modules

Auf dem Rechner wird

• libjson-perl
• bluez (gatttool und hcitool)

vorausgesetzt.

Für die Konfiguration wird die Bluetooth-Adresse (BT-MAC) des jeweiligen Sensors benötigt, die mit Hilfe von hcitool lescan aus der Liste der vom Rechner erkannten aktiven Bluetooth Low Energy Geräten der Umgebung herausgefunden werden kann. Die Identifikation eines konkreten Sensors kann durch Vergleich der Liste mit und ohne aktivem Sensor (Batterie entfernen!) geschehen.

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 sollte daher unbedingt auf Debian Jessie gewechselt werden (empfohlen wird eine Neuinstallation).

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 anzusprechen.

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 Kommunikation mit dem Gerät, den Abruf von Daten
• disabledForIntervals - deaktiviert das Gerät für den angegebenen Zeitintervall (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 Keyfile basierte Authentifizierung zu konfigurieren. Am elegantesten geschieht das mit einer .ssh/config Datei auf dem SSH-Client.