mirror of
https://github.com/fhem/fhem-mirror.git
synced 2025-03-10 09:16:53 +00:00
PRESENCE: added lepresenced commandref (by PatrickR), replaced special chars with html entities
git-svn-id: https://svn.fhem.de/fhem/trunk@11650 2b470e98-0d58-463d-a4d8-8e2adae1ed80
This commit is contained in:
markusbloch
parent
cce492564c
commit
fd3d1f9122
@ -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")
|
||||
|
||||
@ -1203,7 +1203,7 @@ PRESENCE_ProcessState($$)
|
||||
It listens on TCP port 5111 for incoming connections from a FHEM PRESENCE instance or a running collectord.<br>
|
||||
<PRE>
|
||||
Usage:
|
||||
presenced -d [-p <port>] [-P <filename>]
|
||||
presenced [-d] [-p <port>] [-P <filename>]
|
||||
presenced [-h | --help]
|
||||
|
||||
|
||||
@ -1232,6 +1232,39 @@ Options:
|
||||
<li>.deb package for Debian (noarch): <a href="http://svn.code.sf.net/p/fhem/code/trunk/fhem/contrib/PRESENCE/deb/presenced-1.4.deb" target="_new">presenced-1.4.deb</a></li>
|
||||
<li>.deb package for Raspberry Pi (raspbian): <a href="http://svn.code.sf.net/p/fhem/code/trunk/fhem/contrib/PRESENCE/deb/presenced-rpi-1.4.deb" target="_new">presenced-rpi-1.4.deb</a></li>
|
||||
</ul>
|
||||
</ul><br><br>
|
||||
<u>lepresenced</u><br><br>
|
||||
<ul>lepresenced is a Perl network daemon that provides presence checks of
|
||||
multiple bluetooth devices over network. In contrast to presenced,
|
||||
lepresenced covers <u>Bluetooth 4.0 (low energy) devices, i. e.
|
||||
Gigaset G-Tags, FitBit Charges.</u>
|
||||
lepresenced listens on TCP port 5333 for connections of a PRESENCE definition
|
||||
or collectord.<br>
|
||||
<PRE>
|
||||
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
|
||||
</PRE>
|
||||
|
||||
To detect the presence of a device, it uses the command <i>hcitool lescan</i> (package:
|
||||
<a href="http://www.bluez.org" target="_new">bluez</a>) to continuously listen to
|
||||
beacons of Bluetooth LE devices.
|
||||
<br><br>
|
||||
|
||||
If a device is present, this is send to FHEM, as well as the device name as reading.<br><br>
|
||||
|
||||
The presenced is available as:<br><br>
|
||||
<ul>
|
||||
<li>Perl script: <a href="http://svn.code.sf.net/p/fhem/code/trunk/fhem/contrib/PRESENCE/lepresenced" target="_new">lepresenced</a></li>
|
||||
<li>.deb package (noarch): <a href="http://svn.code.sf.net/p/fhem/code/trunk/fhem/contrib/PRESENCE/deb/" target="_new">contrib/PRESENCE/deb/</a></li>
|
||||
</ul>
|
||||
</ul><br><br>
|
||||
<u>collectord</u><br><br>
|
||||
<ul>
|
||||
@ -1395,7 +1428,7 @@ Options:
|
||||
<br>
|
||||
Jeder Modus kann optional mit spezifischen Prüf-Intervallen ausgeführt werden.<br><br>
|
||||
<ul>
|
||||
<li>check-interval - Das normale Prüfinterval in Sekunden für eine Anwesenheitsprüfung. Standardwert: 30 Sekunden</li>
|
||||
<li>check-interval - Das normale Prüfinterval in Sekunden für eine Anwesenheitsprüfung. Standardwert: 30 Sekunden</li>
|
||||
<li>present-check-interval - Das Prüfinterval in Sekunden, wenn ein Gerät anwesend (<i>present</i>) ist. Falls nicht angegeben, wird der Wert aus check-interval verwendet</li>
|
||||
</ul>
|
||||
<br><br>
|
||||
@ -1427,7 +1460,7 @@ Options:
|
||||
<code>define <name> PRESENCE function {...} [ <Interval> [ <Anwesend-Interval> ] ]</code><br>
|
||||
<br>
|
||||
Prüft den Anwesenheitsstatus mithilfe einer selbst geschriebenen Perl-Funktion (z.B. SNMP Abfrage).<br><br>
|
||||
Diese Funktion muss 0 (Abwesend) oder 1 (Anwesend) zurückgeben. Ein entsprechendes Beispiel findet man im <a href="http://www.fhemwiki.de/wiki/Anwesenheitserkennung" target="_new">FHEM-Wiki</a>.<br><br>
|
||||
Diese Funktion muss 0 (Abwesend) oder 1 (Anwesend) zurückgeben. Ein entsprechendes Beispiel findet man im <a href="http://www.fhemwiki.de/wiki/Anwesenheitserkennung" target="_new">FHEM-Wiki</a>.<br><br>
|
||||
<u>Beispiel</u><br><br>
|
||||
<code>define iPhone PRESENCE function {snmpCheck("10.0.1.1","0x44d77429f35c")</code><br><br>
|
||||
<b>Mode: shellscript</b><br><br>
|
||||
@ -1448,7 +1481,7 @@ Options:
|
||||
<u>Beispiel</u><br><br>
|
||||
<code>define iPhone PRESENCE lan-bluetooth 0a:4f:36:d8:f9:89 127.0.0.1:5222</code><br><br>
|
||||
<u>presenced</u><br><br>
|
||||
<ul>Der presenced ist ein Perl Netzwerk Dienst, welcher eine Bluetooth-Anwesenheitserkennung von ein oder mehreren Geräten über Netzwerk bereitstellt.
|
||||
<ul>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.<br>
|
||||
<PRE>
|
||||
Usage:
|
||||
@ -1483,6 +1516,40 @@ Options:
|
||||
<li>.deb Paket für Raspberry Pi (raspbian): <a href="http://svn.code.sf.net/p/fhem/code/trunk/fhem/contrib/PRESENCE/deb/presenced-rpi-1.4.deb" target="_new">presenced-rpi-1.4.deb</a></li>
|
||||
</ul>
|
||||
</ul><br><br>
|
||||
<u>lepresenced</u><br><br>
|
||||
<ul>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 <u>Bluetooth 4.0 (Low Energy) Geräte wie z. B. Gigaset G-Tags,
|
||||
FitBit Charges.</u>
|
||||
lepresenced lauscht standardmäßig auf TCP Port 5333 und wartet
|
||||
auf eingehende Verbindungen des PRESENCE-Moduls bzw. von collectord.<br>
|
||||
<PRE>
|
||||
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
|
||||
</PRE>
|
||||
|
||||
Zur Bluetooth-Abfrage wird der Befehl <i>hcitool lescan</i> (Paket:
|
||||
<a href="http://www.bluez.org" target="_new">bluez</a>) verwendet, der
|
||||
fortwährend auf die Beacons der Bluetooth-LE-Geräte lauscht.
|
||||
<br><br>
|
||||
|
||||
Wenn ein Gerät anwesend ist, wird dies an FHEM übermittelt zusammen mit dem Gerätenamen als Reading.<br><br>
|
||||
|
||||
Der le presenced ist zum Download verfügbar als:<br><br>
|
||||
<ul>
|
||||
<li>Perl Skript: <a href="http://svn.code.sf.net/p/fhem/code/trunk/fhem/contrib/PRESENCE/lepresenced" target="_new">lepresenced</a></li>
|
||||
<li>.deb Paket (architekturunabhängig) unter <a href="http://svn.code.sf.net/p/fhem/code/trunk/fhem/contrib/PRESENCE/deb/" target="_new">contrib/PRESENCE/deb/</a></li>
|
||||
</ul>
|
||||
</ul><br><br>
|
||||
<u>collectord</u><br><br>
|
||||
<ul>
|
||||
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.<br><br>
|
||||
@ -1568,20 +1635,20 @@ Options:
|
||||
Standardwert ist 0 (Erkennung durchführen)<br><br>
|
||||
<li><a name="PRESENCE_absenceThreshold">absenceThreshold</a></li>
|
||||
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.<br><br>
|
||||
Standartwert ist 1 (keine Abwesenheitsverifizierung)<br><br>
|
||||
<li><a name="PRESENCE_ping_count">ping_count</a></li> (Nur im Modus "ping" anwendbar)<br>
|
||||
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.<br><br>
|
||||
Je nach Netzwerkstabilität können erste Pakete verloren gehen oder blockiert werden.<br><br>
|
||||
Standartwert ist 4 (Versuche)<br><br>
|
||||
<li><a name="PRESENCE_bluetooth_hci_device">bluetooth_hci_device</a></li> (Nur im Modus "local-bluetooth" anwendbar)<br>
|
||||
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. <code>hci0</code>.
|
||||
<br><br>
|
||||
<li><a name="PRESENCE_fritzbox_speed">fritzbox_speed</a></li> (Nur im Modus "fritzbox")<br>
|
||||
Zusätzlich zum Status des Geräts wird die aktuelle Verbindungsgeschwindigkeit ausgegeben<br>
|
||||
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.
|
||||
<br><br>
|
||||
Mögliche Werte: 0 => Geschwindigkeit nicht prüfen, 1 => Geschwindigkeit prüfen<br>
|
||||
Standardwert ist 0 (Keine Geschwindigkeitsprüfung)
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user