XiaomiBTLESens: Unterschied zwischen den Versionen
Drhirn (Diskussion | Beiträge) K (Attribut ''disabledForIntervals'' ergänzt) |
Keine Bearbeitungszusammenfassung |
||
| Zeile 3: | Zeile 3: | ||
|ModType=d | |ModType=d | ||
|ModForumArea=Sonstige Systeme | |ModForumArea=Sonstige Systeme | ||
|ModTechName= | |ModTechName=74_XiaomiBTLESens.pm | ||
|ModOwner=CoolTux <br/>({{Link2FU|13684|Forum}} / [[Benutzer:CoolTux|Wiki]]) | |ModOwner=CoolTux <br/>({{Link2FU|13684|Forum}} / [[Benutzer:CoolTux|Wiki]]) | ||
}} | }} | ||
==Beschreibung== | ==Beschreibung== | ||
Mit diesem Modul ist es möglich | 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: | Voraussetzung zur Verwendung des Modules ist: | ||
| Zeile 19: | Zeile 19: | ||
===Definition=== | ===Definition=== | ||
<code>define <name> | <code>define <name> XiaomiBTLESens <BT-MAC></code> | ||
'''Beispiel:''' | '''Beispiel:''' | ||
<code>define Weihnachtskaktus | <code>define Weihnachtskaktus XiaomiBTLESens C4:7C:8D:62:42:6F</code> | ||
Diese Anweisung erstellt ein | 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. | |||
| Zeile 39: | Zeile 40: | ||
===Set=== | ===Set=== | ||
* | * devicename - setzt einen Devicenamen | ||
* | |||
===Get=== | |||
* sensorData - aktive Abfrage der Sensors Werte | |||
* devicename - liest den Devicenamen aus | |||
* firmware - liest die Firmeware aus | |||
===Attribute=== | ===Attribute=== | ||
* interval - Intervallzeit in Sekunden, nach der der nächste automatische Datenabruf erfolgen soll | * 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 | * 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) | * disabledForIntervals - deaktiviert das Gerät für den angegebenen Zeitinterval (13:00-18:30 or 13:00-18:30 22:00-23:00) | ||
Version vom 16. Januar 2018, 15:31 Uhr
| XiaomiBTLESens | |
|---|---|
| Zweck / Funktion | |
| Auslesen eines Xiaomi Flower Sensors | |
| 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
- Beispiele für min/max-Ereignisse:
- 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.