diff --git a/fhem/CHANGED b/fhem/CHANGED
index b7bcd3697..64265d54d 100644
--- a/fhem/CHANGED
+++ b/fhem/CHANGED
@@ -1,5 +1,6 @@
# Add changes at the top of the list. Keep it in ASCII, and 80-char wide.
# Do not insert empty lines here, update check depends on it.
+ - feature: PRESENCE: added lepresenced to commandref (by PatrickR)
- feature: PRESENCE: new attribute bluetooth_hci_device to select a
specific bluetooth sender for presence checking
(only for mode "local-bluetooth")
diff --git a/fhem/FHEM/73_PRESENCE.pm b/fhem/FHEM/73_PRESENCE.pm
index c8dff4aff..968e6c691 100755
--- a/fhem/FHEM/73_PRESENCE.pm
+++ b/fhem/FHEM/73_PRESENCE.pm
@@ -1203,7 +1203,7 @@ PRESENCE_ProcessState($$)
It listens on TCP port 5111 for incoming connections from a FHEM PRESENCE instance or a running collectord.
Usage:
- presenced -d [-p <port>] [-P <filename>]
+ presenced [-d] [-p <port>] [-P <filename>]
presenced [-h | --help]
@@ -1232,6 +1232,39 @@ Options:
.deb package for Debian (noarch): presenced-1.4.deb
.deb package for Raspberry Pi (raspbian): presenced-rpi-1.4.deb
+
+ lepresenced
+ lepresenced is a Perl network daemon that provides presence checks of
+ multiple bluetooth devices over network. In contrast to presenced,
+ lepresenced covers Bluetooth 4.0 (low energy) devices, i. e.
+ Gigaset G-Tags, FitBit Charges.
+ lepresenced listens on TCP port 5333 for connections of a PRESENCE definition
+ or collectord.
+
+Usage:
+ lepresenced --bluetoothdevice <bluetooth device> --listenaddress <listen address> --listenport <listen port> --loglevel <log level> --daemon
+ lepresenced -b <bluetooth device> -a <listen address> -p <listen port> -l <log level> -d
+
+valid log levels:
+ LOG_CRIT, LOG_ERR, LOG_WARNING, LOG_NOTICE, LOG_INFO, LOG_DEBUG. Default: LOG_INFO
+
+Examples:
+ lepresenced --bluetoothdevice hci0 --listenaddress 127.0.0.1 --listenport 5333 --daemon
+ lepresenced --loglevel LOG_DEBUG --daemon
+
+
+ To detect the presence of a device, it uses the command hcitool lescan (package:
+ bluez) to continuously listen to
+ beacons of Bluetooth LE devices.
+
+
+ If a device is present, this is send to FHEM, as well as the device name as reading.
+
+ The presenced is available as:
+
collectord
@@ -1395,7 +1428,7 @@ Options:
Jeder Modus kann optional mit spezifischen Prüf-Intervallen ausgeführt werden.
- - check-interval - Das normale Prüfinterval in Sekunden für eine Anwesenheitsprüfung. Standardwert: 30 Sekunden
+ - check-interval - Das normale Prüfinterval in Sekunden für eine Anwesenheitsprüfung. Standardwert: 30 Sekunden
- present-check-interval - Das Prüfinterval in Sekunden, wenn ein Gerät anwesend (present) ist. Falls nicht angegeben, wird der Wert aus check-interval verwendet
@@ -1427,7 +1460,7 @@ Options:
define <name> PRESENCE function {...} [ <Interval> [ <Anwesend-Interval> ] ]
Prüft den Anwesenheitsstatus mithilfe einer selbst geschriebenen Perl-Funktion (z.B. SNMP Abfrage).
- Diese Funktion muss 0 (Abwesend) oder 1 (Anwesend) zurückgeben. Ein entsprechendes Beispiel findet man im FHEM-Wiki.
+ Diese Funktion muss 0 (Abwesend) oder 1 (Anwesend) zurückgeben. Ein entsprechendes Beispiel findet man im FHEM-Wiki.
Beispiel
define iPhone PRESENCE function {snmpCheck("10.0.1.1","0x44d77429f35c")
Mode: shellscript
@@ -1448,7 +1481,7 @@ Options:
Beispiel
define iPhone PRESENCE lan-bluetooth 0a:4f:36:d8:f9:89 127.0.0.1:5222
presenced
- Der presenced ist ein Perl Netzwerk Dienst, welcher eine Bluetooth-Anwesenheitserkennung von ein oder mehreren Geräten über Netzwerk bereitstellt.
+ Der presenced ist ein Perl Netzwerkdienst, welcher eine Bluetooth-Anwesenheitserkennung von ein oder mehreren Geräten über Netzwerk bereitstellt.
Dieser lauscht standardmäßig auf TCP Port 5111 nach eingehenden Verbindungen von dem PRESENCE Modul oder einem collectord.
Usage:
@@ -1483,6 +1516,40 @@ Options:
.deb Paket für Raspberry Pi (raspbian): presenced-rpi-1.4.deb
+ lepresenced
+ lepresenced ist ein Perl Netzwerkdienst, der analog zu presenced eine
+ Bluetooth-Anwesenheitserkennung von ein oder mehreren Geräten
+ über Netzwerk bereitstellt. Im Gegensatz zu presenced unterstützt
+ lepresenced Bluetooth 4.0 (Low Energy) Geräte wie z. B. Gigaset G-Tags,
+ FitBit Charges.
+ lepresenced lauscht standardmäßig auf TCP Port 5333 und wartet
+ auf eingehende Verbindungen des PRESENCE-Moduls bzw. von collectord.
+
+Usage:
+ lepresenced --bluetoothdevice <bluetooth device> --listenaddress <listen address> --listenport <listen port> --loglevel <log level> --daemon
+ lepresenced -b <bluetooth device> -a <listen address> -p <listen port> -l <log level> -d
+
+valid log levels:
+ LOG_CRIT, LOG_ERR, LOG_WARNING, LOG_NOTICE, LOG_INFO, LOG_DEBUG. Default: LOG_INFO
+
+Examples:
+ lepresenced --bluetoothdevice hci0 --listenaddress 127.0.0.1 --listenport 5333 --daemon
+ lepresenced --loglevel LOG_DEBUG --daemon
+
+
+ Zur Bluetooth-Abfrage wird der Befehl hcitool lescan (Paket:
+ bluez) verwendet, der
+ fortwährend auf die Beacons der Bluetooth-LE-Geräte lauscht.
+
+
+ Wenn ein Gerät anwesend ist, wird dies an FHEM übermittelt zusammen mit dem Gerätenamen als Reading.
+
+ Der le presenced ist zum Download verfügbar als:
+
+
collectord
Der collectord ist ein Perl Netzwerk Dienst, welcher Verbindungen zu mehreren presenced-Instanzen verwaltet um eine koordinierte Suche nach ein oder mehreren Bluetooth-Geräten über Netzwerk durchzuführen.
@@ -1568,20 +1635,20 @@ Options:
Standardwert ist 0 (Erkennung durchführen)
- absenceThreshold
Die Anzahl an Checks, welche in "absent" resultieren müssen, bevor der Status der PRESENCE-Definition auf "absent" wechselt.
- Mit dieser Funktion kann man die Abwesenheit eines Gerätes verifizieren bevor der Status final auf "absent" geändert wird.
+ Mit dieser Funktion kann man die Abwesenheit eines Gerätes verifizieren bevor der Status final auf "absent" geändert wird.
Wenn dieses Attribut auf einen Wert >1 gesetzt ist, werden die Readings "state" und "presence" auf den Wert "maybe absent" gesetzt,
bis der Status final auf "absent" oder "present" wechselt.
Standartwert ist 1 (keine Abwesenheitsverifizierung)
- ping_count
(Nur im Modus "ping" anwendbar)
Verändert die Anzahl der Ping-Pakete die gesendet werden sollen um die Anwesenheit zu erkennen.
- Je nach Netzwerkstabilität können erste Pakete verloren gehen oder blockiert werden.
+ Je nach Netzwerkstabilität können erste Pakete verloren gehen oder blockiert werden.
Standartwert ist 4 (Versuche)
- bluetooth_hci_device
(Nur im Modus "local-bluetooth" anwendbar)
Sofern man mehrere Bluetooth-Empfänger verfügbar hat, kann man mit diesem Attribut ein bestimmten Empfänger auswählen, welcher zur Erkennung verwendet werden soll (bspw. hci0, hci1, ...). Es muss dabei ein vorhandener HCI-Gerätename angegeben werden wie z.B. hci0.
- fritzbox_speed
(Nur im Modus "fritzbox")
Zusätzlich zum Status des Geräts wird die aktuelle Verbindungsgeschwindigkeit ausgegeben
- Das macht nur bei WLAN Geräten Sinn, die direkt mit der FritzBox verbunden sind. Bei abwesenden Geräten wird als Geschwindigkeit 0 ausgegeben.
+ Das macht nur bei WLAN Geräten Sinn, die direkt mit der FritzBox verbunden sind. Bei abwesenden Geräten wird als Geschwindigkeit 0 ausgegeben.
Mögliche Werte: 0 => Geschwindigkeit nicht prüfen, 1 => Geschwindigkeit prüfen
Standardwert ist 0 (Keine Geschwindigkeitsprüfung)