http://wiki.fhem.de/w/api.php?action=feedcontributions&feedformat=atom&user=WzutFHEMWiki - Benutzerbeiträge [de]2026-04-25T00:23:11ZBenutzerbeiträgeMediaWiki 1.43.6http://wiki.fhem.de/w/index.php?title=MAX&diff=33373MAX2020-06-09T08:23:28Z<p>Wzut: </p>
<hr />
<div>'''MAX!''' ist eine Heizungssteuerung, die die Raumtemperatur durch funkvernetzte Heizkörperthermostate an den Heizkörpern regelt. MAX! stellt eine Alternative zur [[:Kategorie:FHT Components|FHT]] und [[HomeMatic]] Heizungsteuerung dar.<br />
<br />
== Features ==<br />
* Bidirektionale Kommuniktion (jeder Befehl wird mit ACK quittiert)<br />
* Heizkörperthermostate übertragen auch die gemessene Temperatur<br />
<br />
== FHEM Module ==<br />
Die MAX Komponenten können über den MAX!Cube per Modul 00_MAXLAN oder über einen [[CUL]] oder [[CUNO]] per 14_CUL_MAX gesteuert werden. In beiden Fällen werden die einzelnen MAX! Geräte vom Modul 10_MAX<br />
bereitgestellt. Alternativ kann man nach {{Link2Forum|Topic=38404}} einen MAX!CUBE als CUNO umflashen.<br />
<br />
Nachteil vom Cube ist, dass man ein Polling machen muss, um zu sehen ob sich der Status eines Gerätes geändert hat. Z.B. checkt man das alle 30 Sekunden. Dann sieht man aber auch Änderungen möglicherweise erst nach 30 Sekunden. Beim CUL sieht man die Funknachrichten direkt. Es wird aber auch ein Kombimodus unterstützt, in welchem man alles über den MAXLAN steuert, der CUL_MAX aber für zeitnahe Benachrichtigungen sorgt.<br />
<br />
== Komponenten ==<br />
=== Limit ===<br />
* Auf 8 Thermostate pro Raum beschränkt<br />
* Limit mit Cube liegt bei ca. 140 Geräten. Durch die [[1% Regel]] dürften es aber in der Praxis weniger sein<br />
<br />
=== Heizkörperthermostate ===<br />
Unterstützt wird das Einstellen von<br />
<br />
* desiredTemperature = auto (Wochenprogramm), manuell (4.5 - 30.5), eco, comfort, boost, until<br />
** (Besonderheit der Werte: 4.5 = Off und 30.5 = On)<br />
* ecoTemperature, comfortTemperature, measurementOffset, maximumTemperature, minimumTemperature, windowOpenTemperature, windowOpenDuration<br />
<br />
und das Auslesen<br />
<br />
* der gemessenen Temperatur. (Hinweis: Wird bei Verwendung des MAX CUBE nicht regelmäßig aktualisiert)<br />
<br />
=== Fensterkontakte ===<br />
Der aktuelle Status (offen/geschlossen) wird (praktisch ohne Verzögerung) angezeigt.<br />
<br />
Falls wir nicht mit Ack antworten, wird er mehrmals wiederholt.<br />
<br />
Die Fensterkontakte können zusätzlich direkt an mehrere Heizkörperthermostate angelernt werden, und versetzen diese dann automatisch in windowOpenTemperature während sie geöffnet sind.<br />
<br />
Wenn der Fensterkontakt an mindestens ein Heizkörperthermostat angelernt ist, dann sendet er zusätzlich stündlich seinen aktuellen Zustand.<br />
<br />
'''Beispiel Autocreate'''<br />
MAXLAN_Parse: Paired new device, type ShutterContact, addr 1a2b3c, serial JEQ0123456<br />
autocreate: define MAX_1a2b3c MAX ShutterContact 1a2b3c<br />
autocreate: define FileLog_MAX_1a2b3c FileLog /fhem/log/MAX_1a2b3c-%Y.log MAX_1a2b3c<br />
<br />
'''Beispiel Definition'''<br />
define MAX_1a2b3c MAX ShutterContact 1a2b3c<br />
<br />
'''Beispiel Log'''<br />
==> MAX_1a2b3c-2013.log <==<br />
2013-10-20_18:52:08 MAX_1a2b3c battery: ok<br />
2013-10-20_18:52:08 MAX_1a2b3c onoff: 0<br />
2013-10-20_18:52:08 MAX_1a2b3c closed<br />
<br />
=== Wandthermostate ===<br />
Unterstützt wird das Einstellen von<br />
<br />
* desiredTemperature (siehe Heizkörperthermostate), ecoTemperature, comfortTemperature<br />
<br />
und das Auslesen<br />
<br />
* der gemessenen Temperatur.<br />
<br />
=== Eco-Taster ===<br />
'''Achtung''': Zumindest über MAXLAN lässt sich der Zustand weder auslesen, noch wird man über Veränderungen informiert.<br />
<br />
Per CUL_MAX funktioniert der Eco-Taster problemlos.<br />
<br />
==== Beispielhafte Definition ====<br />
:<code>define BUTTON.EG MAX PushButton 069d33</code><br />
<br />
==== Beispielhafte Event-Ausgabe ====<br />
<br />
2013-07-02 21:06:14 MAX BUTTON.EG battery: ok<br />
2013-07-02 21:06:14 MAX BUTTON.EG onoff: 0<br />
2013-07-02 21:06:14 MAX BUTTON.EG closed<br />
<br />
Wobei gilt<br />
{| class="wikitable"<br />
|-<br />
! onoff !! Bedeutung<br />
|-<br />
| 0 || Eco<br />
|-<br />
| 1 || Auto<br />
|}<br />
<br />
== Anlernen per CUL ==<br />
Das Anlernen funktioniert nur mit zurückgesetzten (Werksreset, also entweder alle 3 Tasten am Heizkörperthermostat betätigen, Batterien einlegen, Anzeige rES; oder in FHEM set factoryReset) Heizkörperthermostaten. Bereits an einen Cube angelernte Heizungsregler können '''nicht''' an ein CUL angemeldet werden, hier ist dann nur das "mitlesen" der Funkbotschaften möglich.<br />
<br />
Info: Durch den Reset geht auch ein evtl. per Cube eingestelltes Automatikprogramm verloren.<br />
<br />
== Konfiguration ==<br />
Siehe {{Link2CmdRef|Anker=CUL_MAX}}.<br />
<br />
Die Module sind so konzipiert, dass man die offizielle Max! Software nicht benutzen muss. Man kann alles aus FHEM heraus machen. Nachdem das MAXLAN oder CUL_MAX Modul konfiguriert wurden (siehe unten), werden bereits gepairte Geräte automatisch erkannt.<br />
<br />
=== MAXLAN ===<br />
Minimale Konfiguration:<br />
:<code>define ml MAXLAN 192.168.178.2</code><br />
wobei 192.168.178.2 die IP des MAX! Cube ist. Das MAXLAN-Modul findet selbstständig bereits gepairte Geräte und trägt diese in die Konfigurationsdatei fhem.cfg ein. Diese können dann im WEB-Interface mittels „alias“ einen eindeutigen Namen bekommen.<br />
<br />
=== CUL_MAX ===<br />
Minimale Konfiguration:<br />
<br />
<nowiki>define CUL0 CUL /dev/ttyACM0@9600 0000<br />
attr CUL0 rfmode MAX<br />
define cm CUL_MAX 123456</nowiki><br />
<br />
=== Anlernen ===<br />
Dazu muss der "pairmode" auf MAXLAN mit<br />
:<code>set ml pairmode</code><br />
bzw. bei CUL_MAX mit<br />
:<code>set cm pairmode</code><br />
oder über das Web-Interface aktiviert werden. Falls kein Parameter angegeben wird, ist er standardmäßig für 60 Sekunden aktiviert. In dieser Zeit können MAX! Geräte nach deren Anleitung in den Anlernmodus versetzt werden, um sie mit FHEM zu pairen.<br />
<br />
=== Geräte untereinander anlernen ===<br />
Die MAX-Devices können direkt untereinander angelernt werden. Dazu gibt es den "associate"-Befehl in FHEM, mit dem die Geräte untereinander<br />
angelernt werden. Er muss in jede Richtung einmal verwendet werden, also sowohl z.B. Fensterkontakt an Thermostat wie auch umgekehrt.<br />
Also<br />
:<code>set Heizthermostat1 associate Fensterkontakt1</code><br />
:<code>set Fensterkontakt1 associate Heizthermostat1</code><br />
Während Wand- und Heizkörperthermostat stets empfangsbereit sind, benötigt der Fensterkontakt zum "Wecken" einen Schaltvorgang<br />
des Reed-Relais (Fenster öffnen oder schließen). Von einer eventuellen Log-Meldung<br />
:<code>There is a packet for ShutterContact Fensterkontakt1 in queue. Please push the button on the respective ShutterContact so the packet can be send.</code><br />
bitte nicht verwirren lassen: Den Anlern-Button auf der Rückseite zu drücken, wäre völlig falsch! Sofern das Pairing erfolgreich war, sich im Logfile aber diese<br />
Meldung trotzdem alle 3 Sekunden wiederholt, hilft ein Restart von FHEM.<br />
<br />
Jetzt wechselt Heizthermostat1 immer dann auf die windowOpenTemperature, wenn der Fensterkontakt1 offen ist. Dabei muss die groupId von beiden Geräte nicht gleich sein.<br />
<br />
Ebenso können Wand- mit Heizkörperthermostaten gekoppelt werden. Temperaturänderung am Wandthermostaten werden so an den / die Heizkörper gesendet. <br />
Allerdings leitet das Wandthermostat nur Änderungen weiter, die am Wandgerät selbst (manuell) vorgenommen wurden. Wer also via FHEM die <code>desiredTemperature</code> an den<br />
Wandthermostaten sendet, verändert damit weder direkt noch indirekt die Einstellung der assoziierten Heizkörper, sondern muss auch an diese Heizkörper senden.<br />
<br />
=== Temperatursturzerkennung ===<br />
Die Heizkörperthermostate verfügen über eine interne "Fenster-offen Erkennung" (Temperatursturzerkennung). Wird diese ausgelöst, regeln sie für die Zeit die unter "windowOpenDuration" festgelegt wurde auf die als "windowOpenTemperature" festgelegte Temperatur herunter und danach wieder auf die zuvor eingestellte Temperatur zurück.<br />
<br />
Nachteil: Die Erkennung benötigt etwas Zeit und reagiert nicht sofort wie es beim Fensterkontakt oben der Fall ist<br />
<br />
Vorteil: Es ist kein Fensterkontakt erforderlich<br />
<br />
'''Wichtig:''' Setzt man die windowOpenTemperature auf "Off" (= 4.5 Grad), dann ist die Fenster-offen-Funktion abgeschaltet. Und auch wenn die desiredTemperature gerade auf "On" (= 30.5 Grad") steht, geht der Heizkörper nicht in die Fenster-offen-Funktion.<br />
<br />
=== Telegram-Benachrichtigung bei dauergeöffnetem Fenster ===<br />
Einen schönen Einstieg in die Event- und Watchdog-Verarbeitung von FHEM bildet die zeitversetzte Benachrichtigung per Telegram, wenn<br />
das Fenster länger offen stehen gelassen wurde.<br />
<br />
Ist ein Telegram-Bot eingerichtet (siehe [[TelegramBot]]), und der Default-Peer gesetzt, so<br />
reicht ein<br />
<br />
:<code> define w1 watchdog Fensterkontakt1:opened 00:12 Fensterkontakt1:closed set Telegram message Das Fenster ist seit 12 min offen!</code><br />
<br />
um pünktlich nach 12 Minuten eine Erinnerungs-Nachricht zu erhalten: Penetrant und schnell wie SMS, kostenlos wie Mail!<br />
<br />
=== Externer Sensor für Fenster-offen-Erkennung ===<br />
'''Achtung''': Wird nur von CUL_MAX unterstützt!<br />
<br />
Ziel dieses Abschnittes ist es, einen externen Sensor (z.B. 1-Wire o.ä.) zu benutzen, um die MAX Heizkörperthermostate in und aus dem Fenster-offen Modus zu holen. Dazu sei bereits ein CUL, ein CUL_MAX und ein MAX Heizkörper definiert:<br />
<br />
<nowiki>define CUL0 CUL /dev/ttyACM0@9600 0000<br />
define cm CUL_MAX 123456<br />
define Heizung MAX HeatingThermostat abcdef<br />
attr Heizung IODev cm</nowiki><br />
<br />
Wir müssen einmalig den internen Fake-Fensterkontakt mit dem Heizkörper assozieren<br />
:<code>set Heizung associate fakeShutterContact</code><br />
damit dieser die Nachrichten vom Fensterkontakt akzeptiert.<br />
<br />
Nun können wir per <br />
:<code>set cm fakeSC Heizung 1</code><br />
die Nachricht "Fenster offen" an die Heizung senden und per<br />
:<code>set cm fakeSC Heizung 0</code><br />
die Nachricht "Fenster zu".<br />
<br />
=== Externer Temperatursensor für Heizkörperregelung ===<br />
'''Achtung''': Wird nur von CUL_MAX unterstützt!<br />
<br />
Ziel dieses Abschnittes ist es, einen externen Sensor (z.B. 1-Wire o.ä.) zu benutzen, um die MAX Heizkörperthermostate zu regeln. Dazu sei bereits ein CUL, ein CUL_MAX und ein MAX Heizkörper definiert:<br />
<br />
<nowiki>define CUL0 CUL /dev/ttyACM0@9600 0000<br />
define cm CUL_MAX 123456<br />
define Heizung MAX HeatingThermostat abcdef<br />
attr Heizung IODev cm</nowiki><br />
<br />
Wir müssen einmalig das interne Fake-Wandthermostat mit dem Heizkörper assozieren: <br />
:<code>set Heizung associate fakeWallThermostat</code><br />
damit dieser die Nachrichten vom Wandthermostat akzeptiert. Achtung: Dies schaltet im<br />
Heizkörperthermostat die Regelung mit dem internen Temperaturfühler aus. Ohne die gleich kommenden "fakeWT" Nachrichten wird das Heizkörperthermostat nicht mehr regeln.<br />
<br />
Nun können wir per <br />
:<code>set cm fakeWT Heizung 14.5 12.1</code><br />
die desiredTemperature 14.5 und gemessene Temperatur 12.1 an die Heizung senden. Diese wird dann die Ventile öffnen, bis wir ein "fakeWT" absetzten, dessen gemessene Temperatur höher als die desiredTemperature ist.<br />
<br />
Falls man zu lange Zeit (ca. 30 Minuten) kein neues "fakeWT" sendet, wird bei der Heizung das Attribut rferror gleich 1. Es ist nicht klar, ob das neben diesem Attribut auch Auswirkung auf die Funktionalität hat. Es wurde beobachtet, dass dann der interne Temperatursensor bis zum nächsten "fakeWT" aktiviert wird.<br />
<br />
Beispiel eines automatischen Sendens einer externen Temperatur, der externe Temperatursensor heißt "WS300":<br />
<br />
<nowiki>define SendExtTemp notify WS300:temperature.* {<br />
MaxFakeWallThermostat("Heizung",&#160;$EVTPART1);<br />
}</nowiki><br />
<br />
Dazu die Funktion, bitte in [https://wiki.fhem.de/wiki/99_myUtils_anlegen 99_myUtils.pm] eintragen:<br />
<br />
<nowiki><br />
sub MaxFakeWallThermostat {<br />
my $heizung = shift;<br />
my $aktTemp = shift;<br />
my $CULMAX = (exists($defs{$heizung}{IODev}->{NAME})) ? $defs{$heizung}{IODev}->{NAME} : '';<br />
my $desiredTemp = ReadingsNum($heizung, 'desiredTemperature', 0);<br />
my $windowOpenTemp = ReadingsNum($heizung, 'windowOpenTemperature', 0);<br />
<br />
return if (!$CULMAX || !$desiredTemp && !$windowOpenTemp);<br />
<br />
my $lastTemp = ReadingsNum($heizung, 'LastExtTemperature', 0);<br />
my $lastSet = ReadingsAge($heizung, 'LastExtTemperature', 0);<br />
<br />
if ((($desiredTemp != $windowOpenTemp) && ($lastSet > 599)) || (abs($aktTemp-$lastTemp) > 0.1)) {<br />
Log3($CULMAX, 3, "$CULMAX, set fakeWT $heizung $desiredTemp $aktTemp");<br />
readingsSingleUpdate($defs{$heizung}, 'LastExtTemperature', $aktTemp, 0);<br />
my $ret = CommandSet(undef, "$CULMAX fakeWT $heizung $desiredTemp $aktTemp");<br />
Log3($CULMAX, 2, "$CULMAX, error : $ret") if ($ret);<br />
}<br />
return;<br />
}</nowiki><br />
<br />
In diesem Beispiel heißt das zu steuernde Thermostat "Heizung". Die vom externen Sensor gemessene Temperatur wird nur unter den folgenden Voraussetzungen gesendet:<br />
* das Thermostat befindet sich nicht im "Fenster-offen" Modus, und<br />
* das letzte Senden liegt mindestens 10min zurück<br />
* oder die gemessene Temperatur weicht um mindestens 0.2°C von der letzten gesendeten Temperatur ab<br />
<br />
=== Wochenheizplan für Wandthermostat/Ventilantriebe erstellen ===<br />
Ein Heizplan, den das Wandthermostat und auch der Ventilantrieb versteht und speichern kann, sieht folgendermaßen aus:<br />
:<code>set WZ_Wandthermostat weekProfile Mon 17,17:30,20,23:00,17 Tue 17,17:30,20,23:00,17 Wed 17,17:30,20,23:00,17 Thu 17,17:30,20,23:00,17 Fri 17,15:00,20,23:00,17 Sat 17,11:00,20,23:00,17 Sun 17,11:00,20,23:00,17</code><br />
Genauer erläutert wird die Funktionsweise auch in der {{Link2CmdRef|Anker=MAX}}.<br />
<br />
Der gesamte Block kann kopiert und als FHEM Befehl abgesetzt werden. Unter Umständen benötigt das Speichern bzw. Übertragen wegen der Größe etwas Zeit, bevor die aktuellen, neu gesetzten Werte wieder ausgelesen werden können.<br />
<br />
'''Bitte folgendes beachten:'''<br />
<br />
Es gibt im Zusammenhang mit dem Wochenprogramm ein Problem mit dem letzten Schaltpunkt des Tages. <br />
Der Workaround wurde {{Link2Forum|Topic=17231|Message=112738|LinkText=hier}}<br />
beschrieben.<br />
Man muss dafür sorgen, dass man kurz vor Ende des Tages noch einen Schaltpunkt setzt! Bei mir hat sich ein Schaltpunkt (ohne Änderung der Soll-Temperatur) um 23:55 bewährt:<br />
:<code>set WZ_Wandthermostat weekProfile Mon 17,17:30,20,22:00,17,23:55,17</code><br />
<br />
=== Werte Plotten ===<br />
[[File:Plot_MAX_Beispiel.png|thumb|right|Plot eines MAX Heizkörperthermostates]]<br />
In den Log-Dateien wird regelmäßig der Batteriestatus, die Soll-Temperatur, die Ventilstellung und die Ist-Temperatur (Vorsicht: Wird nicht zuverlässig, möglicherweise nur bei einer Änderung der Ventilstellung, übertragen.)<br />
<br />
Inhalt der LOG-Datei eines Heizkörperthermostates:<br />
<br />
<nowiki>2012-12-30_08:55:31 MAX_018d3f battery: ok<br />
2012-12-30_08:55:31 MAX_018d3f desiredTemperature: 19.5<br />
2012-12-30_08:55:31 MAX_018d3f valveposition: 83<br />
2012-12-30_08:55:31 MAX_018d3f temperature: 16.4</nowiki><br />
<br />
Mit folgender Plot-Datei (max_temp.gplot) kann der Verlauf der Sensordaten gut angezeigt werden. <br />
<br />
<nowiki>set terminal png transparent size &lt;SIZE&gt; crop<br />
set output '&lt;OUT&gt;.png'<br />
set xdata time<br />
set timefmt "%Y-%m-%d_%H:%M:%S"<br />
set xlabel " "<br />
set y2tics<br />
set title '&lt;L1&gt;'<br />
set grid xtics y2tics<br />
set y2label "Temperatur in Grad Celsius"<br />
set ylabel "Signal in&#160;%"<br />
#FileLog 4:desiredTemperature:0:<br />
#FileLog 4:temperature:0:<br />
#FileLog 4:valveposition:0:<br />
plot \<br />
"&lt; egrep 'desiredTemperature' &lt;IN&gt;"\<br />
using 1:4 axes x1y2 title 'Soll-Temperatur (C)' with lines lw 2 \<br />
"&lt; egrep 'temperature' &lt;IN&gt;"\<br />
using 1:4 axes x1y2 title 'Ist-Temperatur(ungenau)(C)' with lines lw 2 \<br />
"&lt; egrep 'valveposition' &lt;IN&gt;"\<br />
using 1:4 axes x1y1 title 'Ventil (%)' with lines lw 2</nowiki><br />
Einbinden eines Plots in der fhem.cfg<br />
<br />
<nowiki>#Werte plotten<br />
define MAX_017840_weblink weblink fileplot FileLog_MAX_017840:max_temp:CURRENT<br />
attr MAX_017840_weblink label "Kueche Soll-Temperatur Min $data{min1}, Max $data{max1}, Last $data{currval1}"<br />
attr MAX_017840_weblink room MAX</nowiki><br />
<br />
=== Nützliche kleine Erweiterungen ===<br />
'''Einen Alias-Namen vergeben für eine bessere Lesbarkeit im Webinterface'''<br />
:<code>attr MAX_018d3f alias Kueche</code><br />
'''Die Anzeigen für die einzelnen File-Logs füllen das Webinterface schnell und machen es unübersichtlich.''' Die File-Logs können einfach in einen separaten Raum verbannt werden.<br />
:<code>attr FileLog_MAX_018d3f room LOG</code><br />
'''Einstellmöglichkeit für die Soll-Temperatur direkt in der „Raum-Seite“ schaffen.''' Die Temperatur wird dauerhaft auf einen bestimmten Wert gestellt. Das Wochenprogramm in dem Thermostat wird deaktiviert.<br />
:<code>attr MAX_018d3f webCmd desiredTemperature</code><br />
<br />
'''Soll-Temperatur setzen, ohne das automatische Programm des Thermostates abzuschalten.'''<br />
Es besteht die Möglichkeit eine Soll-Temperatur bis zum nächsten Schaltzeitpunkt zu setzen. Zum Beispiel kann das automatische Wochenprogramm in den Thermostaten dazu genutzt werden, nur abends die Soll-Temperatur zu senken. So läuft die Heizung nachts nicht voll durch. Wenn jedoch die Temperatur im Web-Interface von FHEM verändert wird, wird auch der Thermostat auf manuell gesetzt. So greift das Wochenprogramm nicht mehr. Abhilfe schafft der Befehl <br />
:<code>set MAX_04711 desiredTemperature auto 20</code> <br />
Damit die Eingabe komfortabel aus FHEM möglich ist, kann ein Dummy-Device erstellt werden:<br />
<br />
<nowiki>#Dummy für die Schnell-Einstellung der Temperatur bis zum nächsten automatischen Schaltzeitpunkt<br />
define HeizkoerperBad dummy<br />
attr HeizkoerperBad room MAX,Heizungen<br />
attr HeizkoerperBad setList state:eco,auto,14.0,16.0,17.0,18.0,19.0,20.0,21.0,22.0,23.0<br />
attr HeizkoerperBad webCmd state<br />
define HeizkoerperBad.ntfy notify HeizkoerperBad.* {\<br />
my $valtemp = "$EVENT";;\<br />
my $device = "MAX_04711";;\<br />
my $cmd = 'set '.$device.' desiredTemperature auto '.$valtemp;;\<br />
fhem($cmd);;\<br />
}</nowiki><br />
Dieses Dummy-Device kann alternativ oder ergänzend zu <code>attr MAX_018d3f webCmd desiredTemperature</code> verwendet werden.<br />
<br />
== Internals ==<br />
=== IST-Temperaturwerte ===<br />
[[File:Plot_MAX_Beispiel.png|thumb|right|Plot eines MAX Heizkörperthermostates]]<br />
Diese Abbildung zeigt, dass die IST-Temperatur nicht regelmäßig dem MAX CUBE mitgeteilt wird. Im Automatikbetrieb wird bei einer Änderung der Ventilstellung die neue Ventilstellung zusammen mit der aktuellen IST-Temperatur gesendet. Bei der Abbildung war die Therme in der Nacht ausgeschaltet. Daraufhin sank die Temperatur soweit ab, dass das Heizungsthermostat das Ventil in Maximalstellung geöffnet hat. Gegen 08:50 wurde die Therme eingeschaltet und die Soll-Temperatur an diesem Heizungsthermostat erhöht. Während dieser ganzen Zeit erfolgt keine Aktualisierung der Ist-Temperatur. So kommt es auch gegen 10:30 zu einem sprunghaften Temperaturanstieg von 13,5°C auf 19°C (siehe Markierung *A).<br />
<br />
Die IST-Temperatur wird anscheinend aktualisiert bei einer Änderung der:<br />
<br />
* Ventilstellung<br />
* Soll-Temperatur<br />
* des Betriebsmodus (Auto/Manuell)<br />
<br />
Wer eine detaillierte Kurve wünscht, sollte sich den [[MAX! Temperatur-Scanner]] ansehen.<br />
<br />
=== MAXLAN ===<br />
=== CUL_MAX ===<br />
The MAX devices use a CC1100 chip. For parameters see rf_moritz.c in culfw.<br />
The thermostats use a Wake-On-Radio, thus one has to send packets at the right time.<br />
<br />
CC1100 initialization sequence on one of the MAX devices (not Cube) (format: addr value, both in hex):<br />
<br />
<nowiki>00 08<br />
02 46<br />
04 C6<br />
05 26<br />
0B 06<br />
10 C8 //MDMCFG4 DRATE_E=8<br />
11 93 //MDMCFG3 DRATE_M=147, data rate = (256+DRATE_M)*2^DRATE_E/2^28*f_xosc = (9992.599) 1kbit/s (at f_xosc=26 Mhz)<br />
12 03<br />
15 34<br />
17 00<br />
18 18<br />
19 16<br />
1B 43<br />
21 56<br />
25 00<br />
26 11<br />
0D 21<br />
0E 65<br />
0F 6A<br />
07 4C //PKTCTRL1: ADR_CHK=0 APPEND_STATUS=1 CRC_AUTOFLUSH=1 PQT=2 (preamble must have 8 toggling bits before sync word detection)<br />
16 1C //RXTIME=4<br />
RX_TIME_QUAL=1 (when rx timeout expires, keep receiving if either sync word is found or PQI is set (see PQT))<br />
RX_TIME_RSSI=1 (terminate RX if there is no carrier sense within the first 8 symbol periods)<br />
20 78 //WORCTRL, WOR_RES=00 (1.8-1.9 sec), RC_CAL=1, EVENT1=7 (48 ticks), RC_PD=0<br />
1E 87 //WOREVT1<br />
1F 6B //WOREVT0, i.e. EVENT0 = 34667<br />
29 59<br />
2C 81<br />
2D 35<br />
3E C3</nowiki><br />
<nowiki>Not set, i.e. factory defaults:<br />
13 MDMCFG1 NUM_PREAMBLE=2 (4 preamble bytes)</nowiki><br />
From the configuration, we see that the<br />
<br />
<nowiki>RC Oscillator: f_xosc/750 = 34666.66 Hz<br />
Event1 = Event1(=48 ticks)/RC Oscillator = 1.385 ms<br />
t_Event0 = 750/26Mhz * EVENT0 * 2^(5*WOR_RES) = 1.00 second<br />
C(RX_TIME, WOR_RES)= 0.2254<br />
rx timeout = EVENT0·C(RX_TIME, WOR_RES) ·26/X(=26) = 34667*0.2254 us = 7.8139 ms</nowiki><br />
<br />
The ShutterContact seems to always sleep (DEVELOPMENT NOTE: from memory I can state that this phenomenon very likely is similar to / "caused by" the very precisely time-delay-slot-based battery-conserving Rx reception window protocol implementation of certain FS20 devices - window contacts?). Thus it is necessary to trigger it manually (by opening/closing the window) to make it receive messages. Pushing the button may work too. It is also awake just after<br />
pairing, so one may send messages right then. One can use the WakeUp message to keep it from sleeping for some time. (This is also the reason why in the official MAX software, one must trigger the ShutterContact<br />
after removing it from the house. The "factoryReset" packet is sent directly after the "ShutterContactState" packet has been acked.)<br />
<br />
<br />
== Probleme und Lösungen ==<br />
=== Der Wandthermostat oder Heizthermostat reagieren nicht auf Änderungen über FHEM ===<br />
Das Autocreate von FHEM erkennt, wenn aktiviert, die Geräte initial und legt auch Einträge an. Es fehlt aber noch das Pairing, da sonst keine Steuerung möglich ist!<br />
Wenn im Log also Meldungen wie<br />
<br />
<nowiki>2013.03.20 15:12:30 5: CUL_MAX_SendQueueHandler: 1 items in queue<br />
2013.03.20 15:12:30 5: CUL_MAX_SendQueueHandler: 1 items in queue<br />
2013.03.20 15:12:30 2: CUL_MAX_SendQueueHandler: Missing ack from 01c9bb for 0b05008212345601c9bb0000</nowiki><br />
auftauchen (im Verbose Modus 5), dann wurde vermutlich kein oder ein inkorrektes Pairing durchgeführt.<br />
Nach dem Pairing sollten diese Meldungen verschwinden und stattdessen etwas wie<br />
:<code>2013.03.20 15:21:43 5: Got matching ack</code><br />
auftauchen.<br />
<br />
[[Kategorie:Kontaktsensor (magnetisch)]]<br />
[[Kategorie:MAX]]<br />
[[Kategorie:Heizungsventile]]</div>Wzuthttp://wiki.fhem.de/w/index.php?title=BEOK&diff=30110BEOK2019-04-07T06:48:24Z<p>Wzut: /* Hardware */</p>
<hr />
<div>{{Infobox Modul<br />
|ModPurpose=WiFi Raum-Thermostate für FHEM <br />
|ModType=d<br />
|ModCmdRef=BEOK<br />
|ModForumArea=Heizungssteuerung/Raumklima<br />
|ModTechName=38_BEOK.pm<br />
|ModOwner=Wzut ({{Link2FU|1172|Forum}} / [[Benutzer Diskussion:plin/Wzut|Wiki]])}}<br />
<br />
<br />
Das Modul '''BEOK''' implementiert die Steuerung von FHEM zu BEOK / Floureon / Hysen WiFi Raum-Thermostaten.<br />
<br />
<br />
== Voraussetzungen ==<br />
=== FHEM-Server ===<br />
<br />
Da das Modul AES-Verschlüsselung benötigt, müssen ggf. noch zusätzliche Perl Module installiert werden.<br /><br /><br />
<br />
Bsp. für Debian/Raspian :<br /><br />
<code>sudo apt-get install libcrypt-cbc-perl</code><br />
<code>sudo apt-get install libcrypt-rijndael-perl</code><br />
<code>sudo apt-get install libssl-dev</code><br />
<code>sudo cpan Crypt/OpenSSL/AES.pm</code><br />
<br />
=== Hardware ===<br />
Bezugsquellen :<br><br />
[https://www.amazon.de/Fussbodenheizung-Touchscreen-Intelligente-Programmierbare-Raumthermostat/dp/B07B8TKG5Y/ Amazon] Chunyang weiss Tasten 28€<br><br />
<br><br />
[https://de.aliexpress.com/item/16A-AC-220-V-WIFI-Heizung-Thermostat-Wasser-Elektrische-Heizung-System-WIFI-Thermostat-APP-Steuert-f/32889325428.html Ali] KETOTEK weiss Tasten ca 25€<br><br />
<br><br />
[https://www.amazon.de/FLOUREON-programmierbar-Fussbodenheizung-Heizungsthermostat-Heizungsregelung/dp/B077G6JKCX/ref=sr_1_2?s=diy&ie=UTF8&qid=1547653340&sr=1-2&keywords=floureon+wifi+raumthermostat Amazon] Floureon schwarz Touch 40 €<br><br />
<br><br />
[https://de.aliexpress.com/item/Floureon-Smart-Wi-Fi-Programmable-Thermostat-Digital-Touch-Screen-Room-Temperature-Controller-NTC-Underfloor-Heating-Thermostat/32826733099.html Ali] Floureon schwarz Touch 31 €<br />
<br><br><br />
[https://www.amazon.de/BEOK-tds21wifi-ep-Raumthermostat-programmierbar-Fu%C3%9Fbodenheizung/dp/B075WPWGH5/ Amazon]<br />
BEOK TDS21 weiß Touch ca 40€ – z.Z. bei Ali nicht lieferbar<br><br />
<br />
== Installation ==<br />
=== Erste Schritte ===<br />
Spätestens nach einem 'update all' sollte das Modul '''38_BEOK.pm''' verfügbar sein.<br />
<br />
Nun ist ein Device in FHEM anzulegen:<br />
<br />
:<code>define <name> BEOK <ip> [mac]</code><br />
<br />
Zum Beispiel <br />
<code>define Thermo BEOK 192.168.1.100</code><br />
<code>define Thermo BEOK 192.168.1.100 de:ad:be:ef:01:02</code><br />
<br />
== Anwendung ==<br />
=== Attribute ===<br />
<br />
* '''interval'''<br />
: Poll Intevall in Sekunden, 0 = kein Polling , default 60<br />
* '''timesync'''<br />
: Uhrzeit und Wochentag automatisch mit FHEM synchronisieren, default 1 (an)<br />
* '''timeout'''<br />
: Timeout in Sekunden für die Netzwerk Kommunikation, default 5<br />
* '''language'''<br />
: de oder DE f&uuml;r deutsche Bezeichnungen, Raum statt Room , usw.<br />
* '''model'''<br />
: nur für die FHEM Modul Statistik unter [https://fhem.de/stats/statistics.html https://fhem.de/stats/statistics.html]<br />
<br />
=== Set ===<br />
<br />
Das Modul kennt derzeit folgende Commands<br />
<br />
* set <name> '''desired-temp <5 - 99>'''<br />
: Gewünschte Zieltemperatur<br />
<br />
* set <name> '''mode <auto|manual>'''<br />
: Modus auf automatisch oder manuell setzen<br />
<br />
* set <name> '''loop <12345.67 123456.7 1234567>'''<br />
: 12345.67 Montag - Freitag Werktag, Samstag & Sonntag sind Wochenende<br />
: 123456.7 Montag - Samstag Werktag, nur Sonntag ist Wochendende<br />
: 1234567 jeder Tag (inklusive Samstag & Sonntag) ist ein Werktag, kein Wochenende <br />
<br />
* set <name> '''sensor <external|internal|both>'''<br />
: both = internal control temperature, external limit temperature <br />
<br />
* set <name> '''time'''<br />
: synchronisiert Uhrzeit und Wochentag mit FHEM <br />
<br />
* set <name> '''lock <on off>'''<br />
: tbd <br />
<br />
* set <name> '''power-on-memory <on off>'''<br />
: tbd <br />
<br />
* set <name> '''fre <open|close>'''<br />
: Frostschutz Funktion<br />
<br />
* set <name> '''room-temp-adj <-5 - +5>'''<br />
: Korrekturwert (Offset) Raumtemperatur<br />
<br />
* set <name> '''osv <5 - 99>'''<br />
: Maximum Temperatur für externen Sensor <br />
<br />
* set <name> '''svh <5 - 99>'''<br />
: Raumtemperatur Maximum<br />
<br />
* set <name> '''svl <5 - 99>'''<br />
: Raumtemperatur Minimum<br />
<br />
* set <name> '''dif <1 - 9>'''<br />
: difference of limit temperature value of external sensor <br />
<br />
* set <name> '''day-profil[1-6]-temp <5 - 99>'''<br />
: Werktagprofil Temperatur <br />
<br />
* set <name> '''day-profil[1-6]-time <00:00 - 23:59>'''<br />
: Werktagprofil Zeit <br />
<br />
* set <name> '''we-profile[7-8]-temp <5 - 99>'''<br />
: Wochenendprofil Temperatu<br />
<br />
* set <name> '''we-profile[7-8]-time <00:00 - 23:59>'''<br />
: Wochenendprofil Zeit <br />
<br />
* set <name> '''weekprofile'''<br />
: Setzt alle Wochentag Schaltzeiten und Temperaturen mit Werten aus einem Profil des Moduls weekprofile.<br />
: Syntax : set weekprofile <weekprofile_device:profil_name[:Wochentag]><br />
: siehe auch Erklärung im Forum :{{Link2Forum|Topic=80703|Message=901303}}<br />
<br />
== Anwendungsbeispiele ==<br />
<br />
folgen noch<br />
<br />
== Bekannte Probleme / Fehlersuche ==<br />
<br />
folgen noch<br />
<br />
== Links ==<br />
* Erläuterung im Forum: {{Link2Forum|Topic=80703|Message=901303}}<br />
* FHEM Modul Statistik unter [https://fhem.de/stats/statistics.html https://fhem.de/stats/statistics.html]<br />
<br />
<br />
[[Kategorie:Heizungssteuerung]] <br />
<!-- (Modulkategorie wird automatisch gesetzt) --></div>Wzuthttp://wiki.fhem.de/w/index.php?title=BEOK&diff=29671BEOK2019-02-27T18:31:40Z<p>Wzut: /* Hardware */</p>
<hr />
<div>{{Infobox Modul<br />
|ModPurpose=WiFi Raum-Thermostate für FHEM <br />
|ModType=h<br />
|ModCmdRef=BEOK<br />
|ModForumArea=Heizungssteuerung/Raumklima<br />
|ModTechName=38_BEOK.pm<br />
|ModOwner=Wzut ({{Link2FU|1172|Forum}} / [[Benutzer Diskussion:plin/Wzut|Wiki]])}}<br />
<br />
<br />
Das Modul '''BEOK''' implementiert die Steuerung von FHEM zu BEOK / Floureon / Hysen WiFi Raum-Thermostaten.<br />
<br />
<br />
== Voraussetzungen ==<br />
=== FHEM-Server ===<br />
<br />
Da das Modul AES-Verschlüsselung benötigt müssen ggf. noch zusätzliche Perl Module installiert werden.<br /><br /><br />
<br />
Bsp. für Debian/Raspian :<br /><br />
<code>sudo apt-get install libcrypt-cbc-perl</code><br />
<code>sudo apt-get install libcrypt-rijndael-perl</code><br />
<code>sudo apt-get install libssl-dev</code><br />
<code>sudo cpan Crypt/OpenSSL/AES.pm</code><br />
<br />
=== Hardware ===<br />
Bezugsquellen :<br><br />
[https://www.amazon.de/Fussbodenheizung-Touchscreen-Intelligente-Programmierbare-Raumthermostat/dp/B07B8TKG5Y/ Amazon] Chunyang weiss Tasten 28€<br><br />
<br><br />
[https://de.aliexpress.com/item/16A-AC-220-V-WIFI-Heizung-Thermostat-Wasser-Elektrische-Heizung-System-WIFI-Thermostat-APP-Steuert-f/32889325428.html Ali] KETOTEK weiss Tasten ca 25€<br><br />
<br><br />
[https://www.amazon.de/FLOUREON-programmierbar-Fussbodenheizung-Heizungsthermostat-Heizungsregelung/dp/B077G6JKCX/ref=sr_1_2?s=diy&ie=UTF8&qid=1547653340&sr=1-2&keywords=floureon+wifi+raumthermostat Amazon] Floureon schwarz Touch 40 €<br><br />
<br><br />
[https://de.aliexpress.com/item/Floureon-Smart-Wi-Fi-Programmable-Thermostat-Digital-Touch-Screen-Room-Temperature-Controller-NTC-Underfloor-Heating-Thermostat/32826733099.html Ali] Floureon schwarz Touch 31 €<br />
<br><br><br />
Beok tds23 – z.Z. bei Amazon & Ali nicht (oder nie mehr ? ) lieferbar<br />
<br />
== Installation ==<br />
=== Erste Schritte ===<br />
Spätestens nach einem 'update all' sollte das Modul '''38_BEOK.pm''' verfügbar sein.<br />
<br />
Nun ist ein Device in FHEM anzulegen:<br />
<br />
:<code>define <name> BEOK <ip> [mac]</code><br />
<br />
Zum Beispiel <br />
<code>define Thermo BEOK 192.168.1.100</code><br />
<code>define Thermo BEOK 192.168.1.100 de:ad:be:ef:01:02</code><br />
<br />
== Anwendung ==<br />
=== Attribute ===<br />
<br />
* '''interval'''<br />
: Poll Intevall in Sekunden, 0 = kein Polling , default 60<br />
* '''timesync'''<br />
: Uhrzeit und Wochentag automatisch mit FHEM synchronisieren, default 1 (an)<br />
* '''timeout'''<br />
: Timeout in Sekunden für die Netzwerk Kommunikation, default 5<br />
* '''language'''<br />
: de oder DE f&uuml;r deutsche Bezeichnungen, Raum statt Room , usw.<br />
* '''model'''<br />
: nur für die FHEM Modul Statistik unter [https://fhem.de/stats/statistics.html https://fhem.de/stats/statistics.html]<br />
<br />
=== Set ===<br />
<br />
Das Modul kennt derzeit folgende Commands<br />
<br />
* set <name> '''desired-temp <5 - 99>'''<br />
: Gewünschte Zieltemperatur<br />
<br />
* set <name> '''mode <auto|manual>'''<br />
: Modus auf automatisch oder manuell setzen<br />
<br />
* set <name> '''loop <12345.67 123456.7 1234567>'''<br />
: 12345.67 Montag - Freitag Werktag, Samstag & Sonntag sind Wochenende<br />
: 123456.7 Montag - Samstag Werktag, nur Sonntag ist Wochendende<br />
: 1234567 jeder Tag (inklusive Samstag & Sonntag) ist ein Werktag, kein Wochenende <br />
<br />
* set <name> '''sensor <external|internal|both>'''<br />
: both = internal control temperature, external limit temperature <br />
<br />
* set <name> '''time'''<br />
: synchronisiert Uhrzeit und Wochentag mit FHEM <br />
<br />
* set <name> '''lock <on off>'''<br />
: tbd <br />
<br />
* set <name> '''power-on-memory <on off>'''<br />
: tbd <br />
<br />
* set <name> '''fre <open|close>'''<br />
: Frostschutz Funktion<br />
<br />
* set <name> '''room-temp-adj <-5 - +5>'''<br />
: Korrekturwert (Offset) Raumtemperatur<br />
<br />
* set <name> '''osv <5 - 99>'''<br />
: Maximum Temperatur für externen Sensor <br />
<br />
* set <name> '''svh <5 - 99>'''<br />
: Raumtemperatur Maximum<br />
<br />
* set <name> '''svl <5 - 99>'''<br />
: Raumtemperatur Minimum<br />
<br />
* set <name> '''dif <1 - 9>'''<br />
: difference of limit temperature value of external sensor <br />
<br />
* set <name> '''day-profil[1-6]-temp <5 - 99>'''<br />
: Werktagprofil Temperatur <br />
<br />
* set <name> '''day-profil[1-6]-time <00:00 - 23:59>'''<br />
: Werktagprofil Zeit <br />
<br />
* set <name> '''we-profile[7-8]-temp <5 - 99>'''<br />
: Wochenendprofil Temperatu<br />
<br />
* set <name> '''we-profile[7-8]-time <00:00 - 23:59>'''<br />
: Wochenendprofil Zeit <br />
<br />
* set <name> '''weekprofile'''<br />
: Setzt alle Wochentag Schaltzeiten und Temperaturen mit Werten aus einem Profil des Moduls weekprofile.<br />
: Syntax : set weekprofile <weekprofile_device:profil_name[:Wochentag]><br />
: siehe auch Erklärung im Forum :[https://forum.fhem.de/index.php/topic,80703.msg901303.html https://forum.fhem.de/index.php/topic,80703.msg901303.html]<br />
<br />
== Anwendungsbeispiele ==<br />
<br />
folgen noch<br />
<br />
== Bekannte Probleme / Fehlersuche ==<br />
<br />
folgen noch<br />
<br />
== Links ==<br />
* Erläuterung im Forum [https://forum.fhem.de/index.php/topic,80703.msg901303.html#msg901303 https://forum.fhem.de/index.php/topic,80703.msg901303.html#msg901303]<br />
* FHEM Modul Statistik unter [https://fhem.de/stats/statistics.html https://fhem.de/stats/statistics.html]<br />
<br />
<br />
[[Kategorie:Devices]] <br />
<!-- (Modulkategorie wird automatisch gesetzt) --></div>Wzuthttp://wiki.fhem.de/w/index.php?title=BEOK&diff=29670BEOK2019-02-27T18:27:36Z<p>Wzut: /* Hardware */</p>
<hr />
<div>{{Infobox Modul<br />
|ModPurpose=WiFi Raum-Thermostate für FHEM <br />
|ModType=h<br />
|ModCmdRef=BEOK<br />
|ModForumArea=Heizungssteuerung/Raumklima<br />
|ModTechName=38_BEOK.pm<br />
|ModOwner=Wzut ({{Link2FU|1172|Forum}} / [[Benutzer Diskussion:plin/Wzut|Wiki]])}}<br />
<br />
<br />
Das Modul '''BEOK''' implementiert die Steuerung von FHEM zu BEOK / Floureon / Hysen WiFi Raum-Thermostaten.<br />
<br />
<br />
== Voraussetzungen ==<br />
=== FHEM-Server ===<br />
<br />
Da das Modul AES-Verschlüsselung benötigt müssen ggf. noch zusätzliche Perl Module installiert werden.<br /><br /><br />
<br />
Bsp. für Debian/Raspian :<br /><br />
<code>sudo apt-get install libcrypt-cbc-perl</code><br />
<code>sudo apt-get install libcrypt-rijndael-perl</code><br />
<code>sudo apt-get install libssl-dev</code><br />
<code>sudo cpan Crypt/OpenSSL/AES.pm</code><br />
<br />
=== Hardware ===<br />
Bezugsquellen :<br><br />
[https://www.amazon.de/Fussbodenheizung-Touchscreen-Intelligente-Programmierbare-Raumthermostat/dp/B07B8TKG5Y/ Amazon] Chunyang weiss Tasten 28€<br><br />
<br><br />
[https://de.aliexpress.com/item/16A-AC-220-V-WIFI-Heizung-Thermostat-Wasser-Elektrische-Heizung-System-WIFI-Thermostat-APP-Steuert-f/32889325428.html Ali] KETOTEK weiss Tasten ca 25€<br><br />
<br><br />
[https://www.amazon.de/FLOUREON-programmierbar-Fussbodenheizung-Heizungsthermostat-Heizungsregelung/dp/B077G6JKCX/ref=sr_1_2?s=diy&ie=UTF8&qid=1547653340&sr=1-2&keywords=floureon+wifi+raumthermostat Amazon] Floureon schwarz Touch 40 €<br><br />
<br><br />
[https://de.aliexpress.com/item/Floureon-Smart-Wi-Fi-Programmable-Thermostat-Digital-Touch-Screen-Room-Temperature-Controller-NTC-Underfloor-Heating-Thermostat/32826733099.html Ali] Floureon schwarz Touch 31 €<br />
<br><br><br />
<br />
== Installation ==<br />
=== Erste Schritte ===<br />
Spätestens nach einem 'update all' sollte das Modul '''38_BEOK.pm''' verfügbar sein.<br />
<br />
Nun ist ein Device in FHEM anzulegen:<br />
<br />
:<code>define <name> BEOK <ip> [mac]</code><br />
<br />
Zum Beispiel <br />
<code>define Thermo BEOK 192.168.1.100</code><br />
<code>define Thermo BEOK 192.168.1.100 de:ad:be:ef:01:02</code><br />
<br />
== Anwendung ==<br />
=== Attribute ===<br />
<br />
* '''interval'''<br />
: Poll Intevall in Sekunden, 0 = kein Polling , default 60<br />
* '''timesync'''<br />
: Uhrzeit und Wochentag automatisch mit FHEM synchronisieren, default 1 (an)<br />
* '''timeout'''<br />
: Timeout in Sekunden für die Netzwerk Kommunikation, default 5<br />
* '''language'''<br />
: de oder DE f&uuml;r deutsche Bezeichnungen, Raum statt Room , usw.<br />
* '''model'''<br />
: nur für die FHEM Modul Statistik unter [https://fhem.de/stats/statistics.html https://fhem.de/stats/statistics.html]<br />
<br />
=== Set ===<br />
<br />
Das Modul kennt derzeit folgende Commands<br />
<br />
* set <name> '''desired-temp <5 - 99>'''<br />
: Gewünschte Zieltemperatur<br />
<br />
* set <name> '''mode <auto|manual>'''<br />
: Modus auf automatisch oder manuell setzen<br />
<br />
* set <name> '''loop <12345.67 123456.7 1234567>'''<br />
: 12345.67 Montag - Freitag Werktag, Samstag & Sonntag sind Wochenende<br />
: 123456.7 Montag - Samstag Werktag, nur Sonntag ist Wochendende<br />
: 1234567 jeder Tag (inklusive Samstag & Sonntag) ist ein Werktag, kein Wochenende <br />
<br />
* set <name> '''sensor <external|internal|both>'''<br />
: both = internal control temperature, external limit temperature <br />
<br />
* set <name> '''time'''<br />
: synchronisiert Uhrzeit und Wochentag mit FHEM <br />
<br />
* set <name> '''lock <on off>'''<br />
: tbd <br />
<br />
* set <name> '''power-on-memory <on off>'''<br />
: tbd <br />
<br />
* set <name> '''fre <open|close>'''<br />
: Frostschutz Funktion<br />
<br />
* set <name> '''room-temp-adj <-5 - +5>'''<br />
: Korrekturwert (Offset) Raumtemperatur<br />
<br />
* set <name> '''osv <5 - 99>'''<br />
: Maximum Temperatur für externen Sensor <br />
<br />
* set <name> '''svh <5 - 99>'''<br />
: Raumtemperatur Maximum<br />
<br />
* set <name> '''svl <5 - 99>'''<br />
: Raumtemperatur Minimum<br />
<br />
* set <name> '''dif <1 - 9>'''<br />
: difference of limit temperature value of external sensor <br />
<br />
* set <name> '''day-profil[1-6]-temp <5 - 99>'''<br />
: Werktagprofil Temperatur <br />
<br />
* set <name> '''day-profil[1-6]-time <00:00 - 23:59>'''<br />
: Werktagprofil Zeit <br />
<br />
* set <name> '''we-profile[7-8]-temp <5 - 99>'''<br />
: Wochenendprofil Temperatu<br />
<br />
* set <name> '''we-profile[7-8]-time <00:00 - 23:59>'''<br />
: Wochenendprofil Zeit <br />
<br />
* set <name> '''weekprofile'''<br />
: Setzt alle Wochentag Schaltzeiten und Temperaturen mit Werten aus einem Profil des Moduls weekprofile.<br />
: Syntax : set weekprofile <weekprofile_device:profil_name[:Wochentag]><br />
: siehe auch Erklärung im Forum :[https://forum.fhem.de/index.php/topic,80703.msg901303.html https://forum.fhem.de/index.php/topic,80703.msg901303.html]<br />
<br />
== Anwendungsbeispiele ==<br />
<br />
folgen noch<br />
<br />
== Bekannte Probleme / Fehlersuche ==<br />
<br />
folgen noch<br />
<br />
== Links ==<br />
* Erläuterung im Forum [https://forum.fhem.de/index.php/topic,80703.msg901303.html#msg901303 https://forum.fhem.de/index.php/topic,80703.msg901303.html#msg901303]<br />
* FHEM Modul Statistik unter [https://fhem.de/stats/statistics.html https://fhem.de/stats/statistics.html]<br />
<br />
<br />
[[Kategorie:Devices]] <br />
<!-- (Modulkategorie wird automatisch gesetzt) --></div>Wzuthttp://wiki.fhem.de/w/index.php?title=BEOK&diff=29669BEOK2019-02-27T18:26:16Z<p>Wzut: </p>
<hr />
<div>{{Infobox Modul<br />
|ModPurpose=WiFi Raum-Thermostate für FHEM <br />
|ModType=h<br />
|ModCmdRef=BEOK<br />
|ModForumArea=Heizungssteuerung/Raumklima<br />
|ModTechName=38_BEOK.pm<br />
|ModOwner=Wzut ({{Link2FU|1172|Forum}} / [[Benutzer Diskussion:plin/Wzut|Wiki]])}}<br />
<br />
<br />
Das Modul '''BEOK''' implementiert die Steuerung von FHEM zu BEOK / Floureon / Hysen WiFi Raum-Thermostaten.<br />
<br />
<br />
== Voraussetzungen ==<br />
=== FHEM-Server ===<br />
<br />
Da das Modul AES-Verschlüsselung benötigt müssen ggf. noch zusätzliche Perl Module installiert werden.<br /><br /><br />
<br />
Bsp. für Debian/Raspian :<br /><br />
<code>sudo apt-get install libcrypt-cbc-perl</code><br />
<code>sudo apt-get install libcrypt-rijndael-perl</code><br />
<code>sudo apt-get install libssl-dev</code><br />
<code>sudo cpan Crypt/OpenSSL/AES.pm</code><br />
<br />
=== Hardware ===<br />
Bezugsquellen :<br><br />
[https://www.amazon.de/Fussbodenheizung-Touchscreen-Intelligente-Programmierbare-Raumthermostat/dp/B07B8TKG5Y/ Amazon] Chunyang weiss Tasten 28€<br><br />
<br><br />
[https://de.aliexpress.com/item/16A-AC-220-V-WIFI-Heizung-Thermostat-Wasser-Elektrische-Heizung-System-WIFI-Thermostat-APP-Steuert-f/32889325428.html Ali] KETOTEK weiss Tasten ca 25€<br><br />
<br><br />
[https://www.amazon.de/FLOUREON-programmierbar-Fussbodenheizung-Heizungsthermostat-Heizungsregelung/dp/B077G6JKCX/ref=sr_1_2?s=diy&ie=UTF8&qid=1547653340&sr=1-2&keywords=floureon+wifi+raumthermostat Floureon Amazon] schwarz Touch 40 €<br><br />
<br><br />
[https://de.aliexpress.com/item/Floureon-Smart-Wi-Fi-Programmable-Thermostat-Digital-Touch-Screen-Room-Temperature-Controller-NTC-Underfloor-Heating-Thermostat/32826733099.html Ali] Floureon schwarz Touch 31 €<br />
<br><br><br />
<br />
== Installation ==<br />
=== Erste Schritte ===<br />
Spätestens nach einem 'update all' sollte das Modul '''38_BEOK.pm''' verfügbar sein.<br />
<br />
Nun ist ein Device in FHEM anzulegen:<br />
<br />
:<code>define <name> BEOK <ip> [mac]</code><br />
<br />
Zum Beispiel <br />
<code>define Thermo BEOK 192.168.1.100</code><br />
<code>define Thermo BEOK 192.168.1.100 de:ad:be:ef:01:02</code><br />
<br />
== Anwendung ==<br />
=== Attribute ===<br />
<br />
* '''interval'''<br />
: Poll Intevall in Sekunden, 0 = kein Polling , default 60<br />
* '''timesync'''<br />
: Uhrzeit und Wochentag automatisch mit FHEM synchronisieren, default 1 (an)<br />
* '''timeout'''<br />
: Timeout in Sekunden für die Netzwerk Kommunikation, default 5<br />
* '''language'''<br />
: de oder DE f&uuml;r deutsche Bezeichnungen, Raum statt Room , usw.<br />
* '''model'''<br />
: nur für die FHEM Modul Statistik unter [https://fhem.de/stats/statistics.html https://fhem.de/stats/statistics.html]<br />
<br />
=== Set ===<br />
<br />
Das Modul kennt derzeit folgende Commands<br />
<br />
* set <name> '''desired-temp <5 - 99>'''<br />
: Gewünschte Zieltemperatur<br />
<br />
* set <name> '''mode <auto|manual>'''<br />
: Modus auf automatisch oder manuell setzen<br />
<br />
* set <name> '''loop <12345.67 123456.7 1234567>'''<br />
: 12345.67 Montag - Freitag Werktag, Samstag & Sonntag sind Wochenende<br />
: 123456.7 Montag - Samstag Werktag, nur Sonntag ist Wochendende<br />
: 1234567 jeder Tag (inklusive Samstag & Sonntag) ist ein Werktag, kein Wochenende <br />
<br />
* set <name> '''sensor <external|internal|both>'''<br />
: both = internal control temperature, external limit temperature <br />
<br />
* set <name> '''time'''<br />
: synchronisiert Uhrzeit und Wochentag mit FHEM <br />
<br />
* set <name> '''lock <on off>'''<br />
: tbd <br />
<br />
* set <name> '''power-on-memory <on off>'''<br />
: tbd <br />
<br />
* set <name> '''fre <open|close>'''<br />
: Frostschutz Funktion<br />
<br />
* set <name> '''room-temp-adj <-5 - +5>'''<br />
: Korrekturwert (Offset) Raumtemperatur<br />
<br />
* set <name> '''osv <5 - 99>'''<br />
: Maximum Temperatur für externen Sensor <br />
<br />
* set <name> '''svh <5 - 99>'''<br />
: Raumtemperatur Maximum<br />
<br />
* set <name> '''svl <5 - 99>'''<br />
: Raumtemperatur Minimum<br />
<br />
* set <name> '''dif <1 - 9>'''<br />
: difference of limit temperature value of external sensor <br />
<br />
* set <name> '''day-profil[1-6]-temp <5 - 99>'''<br />
: Werktagprofil Temperatur <br />
<br />
* set <name> '''day-profil[1-6]-time <00:00 - 23:59>'''<br />
: Werktagprofil Zeit <br />
<br />
* set <name> '''we-profile[7-8]-temp <5 - 99>'''<br />
: Wochenendprofil Temperatu<br />
<br />
* set <name> '''we-profile[7-8]-time <00:00 - 23:59>'''<br />
: Wochenendprofil Zeit <br />
<br />
* set <name> '''weekprofile'''<br />
: Setzt alle Wochentag Schaltzeiten und Temperaturen mit Werten aus einem Profil des Moduls weekprofile.<br />
: Syntax : set weekprofile <weekprofile_device:profil_name[:Wochentag]><br />
: siehe auch Erklärung im Forum :[https://forum.fhem.de/index.php/topic,80703.msg901303.html https://forum.fhem.de/index.php/topic,80703.msg901303.html]<br />
<br />
== Anwendungsbeispiele ==<br />
<br />
folgen noch<br />
<br />
== Bekannte Probleme / Fehlersuche ==<br />
<br />
folgen noch<br />
<br />
== Links ==<br />
* Erläuterung im Forum [https://forum.fhem.de/index.php/topic,80703.msg901303.html#msg901303 https://forum.fhem.de/index.php/topic,80703.msg901303.html#msg901303]<br />
* FHEM Modul Statistik unter [https://fhem.de/stats/statistics.html https://fhem.de/stats/statistics.html]<br />
<br />
<br />
[[Kategorie:Devices]] <br />
<!-- (Modulkategorie wird automatisch gesetzt) --></div>Wzuthttp://wiki.fhem.de/w/index.php?title=BEOK&diff=29668BEOK2019-02-27T18:24:43Z<p>Wzut: /* Hardware */</p>
<hr />
<div>{{Infobox Modul<br />
|ModPurpose=WiFi Raum-Thermostate für FHEM <br />
|ModType=h<br />
|ModCmdRef=BEOK<br />
|ModForumArea=Heizungssteuerung/Raumklima<br />
|ModTechName=38_BEOK.pm<br />
|ModOwner=Wzut ({{Link2FU|1172|Forum}} / [[Benutzer Diskussion:plin/Wzut|Wiki]])}}<br />
<br />
<br />
Das Modul '''BEOK''' implementiert die Steuerung von FHEM zu BEOK / Floureon / Hysen WiFi Raum-Thermostaten.<br />
<br />
<br />
== Voraussetzungen ==<br />
=== FHEM-Server ===<br />
<br />
Da das Modul AES-Verschlüsselung benötigt müssen ggf. noch zusätzliche Perl Module installiert werden.<br /><br /><br />
<br />
Bsp. für Debian/Raspian :<br /><br />
<code>sudo apt-get install libcrypt-cbc-perl</code><br />
<code>sudo apt-get install libcrypt-rijndael-perl</code><br />
<code>sudo apt-get install libssl-dev</code><br />
<code>sudo cpan Crypt/OpenSSL/AES.pm</code><br />
<br />
=== Hardware ===<br />
Bezugsquellen :<br />
[https://www.amazon.de/Fussbodenheizung-Touchscreen-Intelligente-Programmierbare-Raumthermostat/dp/B07B8TKG5Y/ Amazon] Chunyang weiss Tasten 28€<br />
<br />
[https://de.aliexpress.com/item/16A-AC-220-V-WIFI-Heizung-Thermostat-Wasser-Elektrische-Heizung-System-WIFI-Thermostat-APP-Steuert-f/32889325428.html Ali] KETOTEK weiss Tasten ca 25€<br />
[https://www.amazon.de/FLOUREON-programmierbar-Fussbodenheizung-Heizungsthermostat-Heizungsregelung/dp/B077G6JKCX/ref=sr_1_2?s=diy&ie=UTF8&qid=1547653340&sr=1-2&keywords=floureon+wifi+raumthermostat Floureon Amazon] schwarz Touch 40 €<br />
[https://de.aliexpress.com/item/Floureon-Smart-Wi-Fi-Programmable-Thermostat-Digital-Touch-Screen-Room-Temperature-Controller-NTC-Underfloor-Heating-Thermostat/32826733099.html Ali] Floureon schwarz Touch 31 €<br />
<br />
== Installation ==<br />
=== Erste Schritte ===<br />
Spätestens nach einem 'update all' sollte das Modul '''38_BEOK.pm''' verfügbar sein.<br />
<br />
Nun ist ein Device in FHEM anzulegen:<br />
<br />
:<code>define <name> BEOK <ip> [mac]</code><br />
<br />
Zum Beispiel <br />
<code>define Thermo BEOK 192.168.1.100</code><br />
<code>define Thermo BEOK 192.168.1.100 de:ad:be:ef:01:02</code><br />
<br />
== Anwendung ==<br />
=== Attribute ===<br />
<br />
* '''interval'''<br />
: Poll Intevall in Sekunden, 0 = kein Polling , default 60<br />
* '''timesync'''<br />
: Uhrzeit und Wochentag automatisch mit FHEM synchronisieren, default 1 (an)<br />
* '''timeout'''<br />
: Timeout in Sekunden für die Netzwerk Kommunikation, default 5<br />
* '''language'''<br />
: de oder DE f&uuml;r deutsche Bezeichnungen, Raum statt Room , usw.<br />
* '''model'''<br />
: nur für die FHEM Modul Statistik unter [https://fhem.de/stats/statistics.html https://fhem.de/stats/statistics.html]<br />
<br />
=== Set ===<br />
<br />
Das Modul kennt derzeit folgende Commands<br />
<br />
* set <name> '''desired-temp <5 - 99>'''<br />
: Gewünschte Zieltemperatur<br />
<br />
* set <name> '''mode <auto|manual>'''<br />
: Modus auf automatisch oder manuell setzen<br />
<br />
* set <name> '''loop <12345.67 123456.7 1234567>'''<br />
: 12345.67 Montag - Freitag Werktag, Samstag & Sonntag sind Wochenende<br />
: 123456.7 Montag - Samstag Werktag, nur Sonntag ist Wochendende<br />
: 1234567 jeder Tag (inklusive Samstag & Sonntag) ist ein Werktag, kein Wochenende <br />
<br />
* set <name> '''sensor <external|internal|both>'''<br />
: both = internal control temperature, external limit temperature <br />
<br />
* set <name> '''time'''<br />
: synchronisiert Uhrzeit und Wochentag mit FHEM <br />
<br />
* set <name> '''lock <on off>'''<br />
: tbd <br />
<br />
* set <name> '''power-on-memory <on off>'''<br />
: tbd <br />
<br />
* set <name> '''fre <open|close>'''<br />
: Frostschutz Funktion<br />
<br />
* set <name> '''room-temp-adj <-5 - +5>'''<br />
: Korrekturwert (Offset) Raumtemperatur<br />
<br />
* set <name> '''osv <5 - 99>'''<br />
: Maximum Temperatur für externen Sensor <br />
<br />
* set <name> '''svh <5 - 99>'''<br />
: Raumtemperatur Maximum<br />
<br />
* set <name> '''svl <5 - 99>'''<br />
: Raumtemperatur Minimum<br />
<br />
* set <name> '''dif <1 - 9>'''<br />
: difference of limit temperature value of external sensor <br />
<br />
* set <name> '''day-profil[1-6]-temp <5 - 99>'''<br />
: Werktagprofil Temperatur <br />
<br />
* set <name> '''day-profil[1-6]-time <00:00 - 23:59>'''<br />
: Werktagprofil Zeit <br />
<br />
* set <name> '''we-profile[7-8]-temp <5 - 99>'''<br />
: Wochenendprofil Temperatu<br />
<br />
* set <name> '''we-profile[7-8]-time <00:00 - 23:59>'''<br />
: Wochenendprofil Zeit <br />
<br />
* set <name> '''weekprofile'''<br />
: Setzt alle Wochentag Schaltzeiten und Temperaturen mit Werten aus einem Profil des Moduls weekprofile.<br />
: Syntax : set weekprofile <weekprofile_device:profil_name[:Wochentag]><br />
: siehe auch Erklärung im Forum :[https://forum.fhem.de/index.php/topic,80703.msg901303.html https://forum.fhem.de/index.php/topic,80703.msg901303.html]<br />
<br />
== Anwendungsbeispiele ==<br />
<br />
folgen noch<br />
<br />
== Bekannte Probleme / Fehlersuche ==<br />
<br />
folgen noch<br />
<br />
== Links ==<br />
* Erläuterung im Forum [https://forum.fhem.de/index.php/topic,80703.msg901303.html#msg901303 https://forum.fhem.de/index.php/topic,80703.msg901303.html#msg901303]<br />
* FHEM Modul Statistik unter [https://fhem.de/stats/statistics.html https://fhem.de/stats/statistics.html]<br />
<br />
<br />
[[Kategorie:Devices]] <br />
<!-- (Modulkategorie wird automatisch gesetzt) --></div>Wzuthttp://wiki.fhem.de/w/index.php?title=BEOK&diff=29667BEOK2019-02-27T18:23:09Z<p>Wzut: </p>
<hr />
<div>{{Infobox Modul<br />
|ModPurpose=WiFi Raum-Thermostate für FHEM <br />
|ModType=h<br />
|ModCmdRef=BEOK<br />
|ModForumArea=Heizungssteuerung/Raumklima<br />
|ModTechName=38_BEOK.pm<br />
|ModOwner=Wzut ({{Link2FU|1172|Forum}} / [[Benutzer Diskussion:plin/Wzut|Wiki]])}}<br />
<br />
<br />
Das Modul '''BEOK''' implementiert die Steuerung von FHEM zu BEOK / Floureon / Hysen WiFi Raum-Thermostaten.<br />
<br />
<br />
== Voraussetzungen ==<br />
=== FHEM-Server ===<br />
<br />
Da das Modul AES-Verschlüsselung benötigt müssen ggf. noch zusätzliche Perl Module installiert werden.<br /><br /><br />
<br />
Bsp. für Debian/Raspian :<br /><br />
<code>sudo apt-get install libcrypt-cbc-perl</code><br />
<code>sudo apt-get install libcrypt-rijndael-perl</code><br />
<code>sudo apt-get install libssl-dev</code><br />
<code>sudo cpan Crypt/OpenSSL/AES.pm</code><br />
<br />
=== Hardware ===<br />
Bezugsquellen :<br />
[https://www.amazon.de/Fussbodenheizung-Touchscreen-Intelligente-Programmierbare-Raumthermostat/dp/B07B8TKG5Y/ Amazon] Chunyang weiss Tasten 28€<br />
https://de.aliexpress.com/item/16A-AC-220-V-WIFI-Heizung-Thermostat-Wasser-Elektrische-Heizung-System-WIFI-Thermostat-APP-Steuert-f/32889325428.html KETOTEK weiss Tasten ca 25€<br />
https://www.amazon.de/FLOUREON-programmierbar-Fussbodenheizung-Heizungsthermostat-Heizungsregelung/dp/B077G6JKCX/ref=sr_1_2?s=diy&ie=UTF8&qid=1547653340&sr=1-2&keywords=floureon+wifi+raumthermostat Floureon schwarz Touch 40 €<br />
https://de.aliexpress.com/item/Floureon-Smart-Wi-Fi-Programmable-Thermostat-Digital-Touch-Screen-Room-Temperature-Controller-NTC-Underfloor-Heating-Thermostat/32826733099.html Floureon schwarz Touch 31 €<br />
<br />
== Installation ==<br />
=== Erste Schritte ===<br />
Spätestens nach einem 'update all' sollte das Modul '''38_BEOK.pm''' verfügbar sein.<br />
<br />
Nun ist ein Device in FHEM anzulegen:<br />
<br />
:<code>define <name> BEOK <ip> [mac]</code><br />
<br />
Zum Beispiel <br />
<code>define Thermo BEOK 192.168.1.100</code><br />
<code>define Thermo BEOK 192.168.1.100 de:ad:be:ef:01:02</code><br />
<br />
== Anwendung ==<br />
=== Attribute ===<br />
<br />
* '''interval'''<br />
: Poll Intevall in Sekunden, 0 = kein Polling , default 60<br />
* '''timesync'''<br />
: Uhrzeit und Wochentag automatisch mit FHEM synchronisieren, default 1 (an)<br />
* '''timeout'''<br />
: Timeout in Sekunden für die Netzwerk Kommunikation, default 5<br />
* '''language'''<br />
: de oder DE f&uuml;r deutsche Bezeichnungen, Raum statt Room , usw.<br />
* '''model'''<br />
: nur für die FHEM Modul Statistik unter [https://fhem.de/stats/statistics.html https://fhem.de/stats/statistics.html]<br />
<br />
=== Set ===<br />
<br />
Das Modul kennt derzeit folgende Commands<br />
<br />
* set <name> '''desired-temp <5 - 99>'''<br />
: Gewünschte Zieltemperatur<br />
<br />
* set <name> '''mode <auto|manual>'''<br />
: Modus auf automatisch oder manuell setzen<br />
<br />
* set <name> '''loop <12345.67 123456.7 1234567>'''<br />
: 12345.67 Montag - Freitag Werktag, Samstag & Sonntag sind Wochenende<br />
: 123456.7 Montag - Samstag Werktag, nur Sonntag ist Wochendende<br />
: 1234567 jeder Tag (inklusive Samstag & Sonntag) ist ein Werktag, kein Wochenende <br />
<br />
* set <name> '''sensor <external|internal|both>'''<br />
: both = internal control temperature, external limit temperature <br />
<br />
* set <name> '''time'''<br />
: synchronisiert Uhrzeit und Wochentag mit FHEM <br />
<br />
* set <name> '''lock <on off>'''<br />
: tbd <br />
<br />
* set <name> '''power-on-memory <on off>'''<br />
: tbd <br />
<br />
* set <name> '''fre <open|close>'''<br />
: Frostschutz Funktion<br />
<br />
* set <name> '''room-temp-adj <-5 - +5>'''<br />
: Korrekturwert (Offset) Raumtemperatur<br />
<br />
* set <name> '''osv <5 - 99>'''<br />
: Maximum Temperatur für externen Sensor <br />
<br />
* set <name> '''svh <5 - 99>'''<br />
: Raumtemperatur Maximum<br />
<br />
* set <name> '''svl <5 - 99>'''<br />
: Raumtemperatur Minimum<br />
<br />
* set <name> '''dif <1 - 9>'''<br />
: difference of limit temperature value of external sensor <br />
<br />
* set <name> '''day-profil[1-6]-temp <5 - 99>'''<br />
: Werktagprofil Temperatur <br />
<br />
* set <name> '''day-profil[1-6]-time <00:00 - 23:59>'''<br />
: Werktagprofil Zeit <br />
<br />
* set <name> '''we-profile[7-8]-temp <5 - 99>'''<br />
: Wochenendprofil Temperatu<br />
<br />
* set <name> '''we-profile[7-8]-time <00:00 - 23:59>'''<br />
: Wochenendprofil Zeit <br />
<br />
* set <name> '''weekprofile'''<br />
: Setzt alle Wochentag Schaltzeiten und Temperaturen mit Werten aus einem Profil des Moduls weekprofile.<br />
: Syntax : set weekprofile <weekprofile_device:profil_name[:Wochentag]><br />
: siehe auch Erklärung im Forum :[https://forum.fhem.de/index.php/topic,80703.msg901303.html https://forum.fhem.de/index.php/topic,80703.msg901303.html]<br />
<br />
== Anwendungsbeispiele ==<br />
<br />
folgen noch<br />
<br />
== Bekannte Probleme / Fehlersuche ==<br />
<br />
folgen noch<br />
<br />
== Links ==<br />
* Erläuterung im Forum [https://forum.fhem.de/index.php/topic,80703.msg901303.html#msg901303 https://forum.fhem.de/index.php/topic,80703.msg901303.html#msg901303]<br />
* FHEM Modul Statistik unter [https://fhem.de/stats/statistics.html https://fhem.de/stats/statistics.html]<br />
<br />
<br />
[[Kategorie:Devices]] <br />
<!-- (Modulkategorie wird automatisch gesetzt) --></div>Wzuthttp://wiki.fhem.de/w/index.php?title=BEOK&diff=29666BEOK2019-02-27T18:20:59Z<p>Wzut: /* Hardware */</p>
<hr />
<div>{{Infobox Modul<br />
|ModPurpose=WiFi Raum-Thermostate für FHEM <br />
|ModType=h<br />
|ModCmdRef=BEOK<br />
|ModForumArea=Heizungssteuerung/Raumklima<br />
|ModTechName=38_BEOK.pm<br />
|ModOwner=Wzut ({{Link2FU|1172|Forum}} / [[Benutzer Diskussion:plin/Wzut|Wiki]])}}<br />
<br />
<br />
Das Modul '''BEOK''' implementiert die Steuerung von FHEM zu BEOK / Floureon / Hysen WiFi Raum-Thermostaten.<br />
<br />
<br />
== Voraussetzungen ==<br />
=== FHEM-Server ===<br />
<br />
Da das Modul AES-Verschlüsselung benötigt müssen ggf. noch zusätzliche Perl Module installiert werden.<br /><br /><br />
<br />
Bsp. für Debian/Raspian :<br /><br />
<code>sudo apt-get install libcrypt-cbc-perl</code><br />
<code>sudo apt-get install libcrypt-rijndael-perl</code><br />
<code>sudo apt-get install libssl-dev</code><br />
<code>sudo cpan Crypt/OpenSSL/AES.pm</code><br />
<br />
=== Hardware ===<br />
Bezugsquellen :<br />
https://www.amazon.de/Fussbodenheizung-Touchscreen-Intelligente-Programmierbare-Raumthermostat/dp/B07B8TKG5Y/ Chunyang weiss Tasten 28€<br />
https://de.aliexpress.com/item/16A-AC-220-V-WIFI-Heizung-Thermostat-Wasser-Elektrische-Heizung-System-WIFI-Thermostat-APP-Steuert-f/32889325428.html KETOTEK weiss Tasten ca 25€<br />
https://www.amazon.de/FLOUREON-programmierbar-Fussbodenheizung-Heizungsthermostat-Heizungsregelung/dp/B077G6JKCX/ref=sr_1_2?s=diy&ie=UTF8&qid=1547653340&sr=1-2&keywords=floureon+wifi+raumthermostat Floureon schwarz Touch 40 €<br />
https://de.aliexpress.com/item/Floureon-Smart-Wi-Fi-Programmable-Thermostat-Digital-Touch-Screen-Room-Temperature-Controller-NTC-Underfloor-Heating-Thermostat/32826733099.html Floureon schwarz Touch 31 €<br />
<br />
== Installation ==<br />
=== Erste Schritte ===<br />
Spätestens nach einem 'update all' sollte das Modul '''38_BEOK.pm''' verfügbar sein.<br />
<br />
Nun ist ein Device in FHEM anzulegen:<br />
<br />
:<code>define <name> BEOK <ip> [mac]</code><br />
<br />
Zum Beispiel <br />
<code>define Thermo BEOK 192.168.1.100</code><br />
<code>define Thermo BEOK 192.168.1.100 de:ad:be:ef:01:02</code><br />
<br />
== Anwendung ==<br />
=== Attribute ===<br />
<br />
* '''interval'''<br />
: Poll Intevall in Sekunden, 0 = kein Polling , default 60<br />
* '''timesync'''<br />
: Uhrzeit und Wochentag automatisch mit FHEM synchronisieren, default 1 (an)<br />
* '''timeout'''<br />
: Timeout in Sekunden für die Netzwerk Kommunikation, default 5<br />
* '''language'''<br />
: de oder DE f&uuml;r deutsche Bezeichnungen, Raum statt Room , usw.<br />
* '''model'''<br />
: nur für die FHEM Modul Statistik unter [https://fhem.de/stats/statistics.html https://fhem.de/stats/statistics.html]<br />
<br />
=== Set ===<br />
<br />
Das Modul kennt derzeit folgende Commands<br />
<br />
* set <name> '''desired-temp <5 - 99>'''<br />
: Gewünschte Zieltemperatur<br />
<br />
* set <name> '''mode <auto|manual>'''<br />
: Modus auf automatisch oder manuell setzen<br />
<br />
* set <name> '''loop <12345.67 123456.7 1234567>'''<br />
: 12345.67 Montag - Freitag Werktag, Samstag & Sonntag sind Wochenende<br />
: 123456.7 Montag - Samstag Werktag, nur Sonntag ist Wochendende<br />
: 1234567 jeder Tag (inklusive Samstag & Sonntag) ist ein Werktag, kein Wochenende <br />
<br />
* set <name> '''sensor <external|internal|both>'''<br />
: both = internal control temperature, external limit temperature <br />
<br />
* set <name> '''time'''<br />
: synchronisiert Uhrzeit und Wochentag mit FHEM <br />
<br />
* set <name> '''lock <on off>'''<br />
: tbd <br />
<br />
* set <name> '''power-on-memory <on off>'''<br />
: tbd <br />
<br />
* set <name> '''fre <open|close>'''<br />
: Frostschutz Funktion<br />
<br />
* set <name> '''room-temp-adj <-5 - +5>'''<br />
: Korrekturwert (Offset) Raumtemperatur<br />
<br />
* set <name> '''osv <5 - 99>'''<br />
: Maximum Temperatur für externen Sensor <br />
<br />
* set <name> '''svh <5 - 99>'''<br />
: Raumtemperatur Maximum<br />
<br />
* set <name> '''svl <5 - 99>'''<br />
: Raumtemperatur Minimum<br />
<br />
* set <name> '''dif <1 - 9>'''<br />
: difference of limit temperature value of external sensor <br />
<br />
* set <name> '''day-profil[1-6]-temp <5 - 99>'''<br />
: Werktagprofil Temperatur <br />
<br />
* set <name> '''day-profil[1-6]-time <00:00 - 23:59>'''<br />
: Werktagprofil Zeit <br />
<br />
* set <name> '''we-profile[7-8]-temp <5 - 99>'''<br />
: Wochenendprofil Temperatu<br />
<br />
* set <name> '''we-profile[7-8]-time <00:00 - 23:59>'''<br />
: Wochenendprofil Zeit <br />
<br />
* set <name> '''weekprofile'''<br />
: Setzt alle Wochentag Schaltzeiten und Temperaturen mit Werten aus einem Profil des Moduls weekprofile.<br />
: Syntax : set weekprofile <weekprofile_device:profil_name[:Wochentag]><br />
: siehe auch Erklärung im Forum :[https://forum.fhem.de/index.php/topic,80703.msg901303.html https://forum.fhem.de/index.php/topic,80703.msg901303.html]<br />
<br />
== Anwendungsbeispiele ==<br />
<br />
folgen noch<br />
<br />
== Bekannte Probleme / Fehlersuche ==<br />
<br />
folgen noch<br />
<br />
== Links ==<br />
* Erläuterung im Forum [https://forum.fhem.de/index.php/topic,80703.msg901303.html#msg901303 https://forum.fhem.de/index.php/topic,80703.msg901303.html#msg901303]<br />
* FHEM Modul Statistik unter [https://fhem.de/stats/statistics.html https://fhem.de/stats/statistics.html]<br />
<br />
<br />
[[Kategorie:Devices]] <br />
<!-- (Modulkategorie wird automatisch gesetzt) --></div>Wzuthttp://wiki.fhem.de/w/index.php?title=BEOK&diff=29664BEOK2019-02-27T16:58:30Z<p>Wzut: </p>
<hr />
<div>{{Infobox Modul<br />
|ModPurpose=WiFi Raum-Thermostate für FHEM <br />
|ModType=h<br />
|ModCmdRef=BEOK<br />
|ModForumArea=Heizungssteuerung/Raumklima<br />
|ModTechName=38_BEOK.pm<br />
|ModOwner=Wzut ({{Link2FU|1172|Forum}} / [[Benutzer Diskussion:plin/Wzut|Wiki]])}}<br />
<br />
<br />
Das Modul '''BEOK''' implementiert die Steuerung von FHEM zu BEOK / Floureon / Hysen WiFi Raum-Thermostaten.<br />
<br />
<br />
== Voraussetzungen ==<br />
=== FHEM-Server ===<br />
<br />
Da das Modul AES-Verschlüsselung benötigt müssen ggf. noch zusätzliche Perl Module installiert werden.<br /><br /><br />
<br />
Bsp. für Debian/Raspian :<br /><br />
<code>sudo apt-get install libcrypt-cbc-perl</code><br />
<code>sudo apt-get install libcrypt-rijndael-perl</code><br />
<code>sudo apt-get install libssl-dev</code><br />
<code>sudo cpan Crypt/OpenSSL/AES.pm</code><br />
<br />
=== Hardware ===<br />
Quellen sind: tbd<br />
<br />
== Installation ==<br />
=== Erste Schritte ===<br />
Spätestens nach einem 'update all' sollte das Modul '''38_BEOK.pm''' verfügbar sein.<br />
<br />
Nun ist ein Device in FHEM anzulegen:<br />
<br />
:<code>define <name> BEOK <ip> [mac]</code><br />
<br />
Zum Beispiel <br />
<code>define Thermo BEOK 192.168.1.100</code><br />
<code>define Thermo BEOK 192.168.1.100 de:ad:be:ef:01:02</code><br />
<br />
== Anwendung ==<br />
=== Attribute ===<br />
<br />
* '''interval'''<br />
: Poll Intevall in Sekunden, 0 = kein Polling , default 60<br />
* '''timesync'''<br />
: Uhrzeit und Wochentag automatisch mit FHEM synchronisieren, default 1 (an)<br />
* '''timeout'''<br />
: Timeout in Sekunden für die Netzwerk Kommunikation, default 5<br />
* '''language'''<br />
: de oder DE f&uuml;r deutsche Bezeichnungen, Raum statt Room , usw.<br />
* '''model'''<br />
: nur für die FHEM Modul Statistik unter [https://fhem.de/stats/statistics.html https://fhem.de/stats/statistics.html]<br />
<br />
=== Set ===<br />
<br />
Das Modul kennt derzeit folgende Commands<br />
<br />
* set <name> '''desired-temp <5 - 99>'''<br />
: Gewünschte Zieltemperatur<br />
<br />
* set <name> '''mode <auto|manual>'''<br />
: Modus auf automatisch oder manuell setzen<br />
<br />
* set <name> '''loop <12345.67 123456.7 1234567>'''<br />
: 12345.67 Montag - Freitag Werktag, Samstag & Sonntag sind Wochenende<br />
: 123456.7 Montag - Samstag Werktag, nur Sonntag ist Wochendende<br />
: 1234567 jeder Tag (inklusive Samstag & Sonntag) ist ein Werktag, kein Wochenende <br />
<br />
* set <name> '''sensor <external|internal|both>'''<br />
: both = internal control temperature, external limit temperature <br />
<br />
* set <name> '''time'''<br />
: synchronisiert Uhrzeit und Wochentag mit FHEM <br />
<br />
* set <name> '''lock <on off>'''<br />
: tbd <br />
<br />
* set <name> '''power-on-memory <on off>'''<br />
: tbd <br />
<br />
* set <name> '''fre <open|close>'''<br />
: Frostschutz Funktion<br />
<br />
* set <name> '''room-temp-adj <-5 - +5>'''<br />
: Korrekturwert (Offset) Raumtemperatur<br />
<br />
* set <name> '''osv <5 - 99>'''<br />
: Maximum Temperatur für externen Sensor <br />
<br />
* set <name> '''svh <5 - 99>'''<br />
: Raumtemperatur Maximum<br />
<br />
* set <name> '''svl <5 - 99>'''<br />
: Raumtemperatur Minimum<br />
<br />
* set <name> '''dif <1 - 9>'''<br />
: difference of limit temperature value of external sensor <br />
<br />
* set <name> '''day-profil[1-6]-temp <5 - 99>'''<br />
: Werktagprofil Temperatur <br />
<br />
* set <name> '''day-profil[1-6]-time <00:00 - 23:59>'''<br />
: Werktagprofil Zeit <br />
<br />
* set <name> '''we-profile[7-8]-temp <5 - 99>'''<br />
: Wochenendprofil Temperatu<br />
<br />
* set <name> '''we-profile[7-8]-time <00:00 - 23:59>'''<br />
: Wochenendprofil Zeit <br />
<br />
* set <name> '''weekprofile'''<br />
: Setzt alle Wochentag Schaltzeiten und Temperaturen mit Werten aus einem Profil des Moduls weekprofile.<br />
: Syntax : set weekprofile <weekprofile_device:profil_name[:Wochentag]><br />
: siehe auch Erklärung im Forum :[https://forum.fhem.de/index.php/topic,80703.msg901303.html https://forum.fhem.de/index.php/topic,80703.msg901303.html]<br />
<br />
== Anwendungsbeispiele ==<br />
<br />
folgen noch<br />
<br />
== Bekannte Probleme / Fehlersuche ==<br />
<br />
folgen noch<br />
<br />
== Links ==<br />
* Erläuterung im Forum [https://forum.fhem.de/index.php/topic,80703.msg901303.html#msg901303 https://forum.fhem.de/index.php/topic,80703.msg901303.html#msg901303]<br />
* FHEM Modul Statistik unter [https://fhem.de/stats/statistics.html https://fhem.de/stats/statistics.html]<br />
<br />
<br />
[[Kategorie:Devices]] <br />
<!-- (Modulkategorie wird automatisch gesetzt) --></div>Wzuthttp://wiki.fhem.de/w/index.php?title=BEOK&diff=29663BEOK2019-02-27T16:54:05Z<p>Wzut: </p>
<hr />
<div>{{Infobox Modul<br />
|ModPurpose=BEOK Support für FHEM <br />
|ModType=h<br />
|ModCmdRef=BEOK<br />
|ModForumArea=Heizungssteuerung/Raumklima<br />
|ModTechName=38_BEOK.pm<br />
|ModOwner=Wzut ({{Link2FU|1172|Forum}} / [[Benutzer Diskussion:plin/Wzut|Wiki]])}}<br />
<br />
<br />
Das Modul '''BEOK''' implementiert die Steuerung von FHEM zu BEOK / Floureon / Hysen WiFi Raum-Thermostaten.<br />
<br />
<br />
== Voraussetzungen ==<br />
=== FHEM-Server ===<br />
<br />
Da das Modul AES-Verschlüsselung benötigt müssen ggf. noch zusätzliche Perl Module installiert werden.<br /><br /><br />
<br />
Bsp. für Debian/Raspian :<br /><br />
<code>sudo apt-get install libcrypt-cbc-perl</code><br />
<code>sudo apt-get install libcrypt-rijndael-perl</code><br />
<code>sudo apt-get install libssl-dev</code><br />
<code>sudo cpan Crypt/OpenSSL/AES.pm</code><br />
<br />
=== Hardware ===<br />
Quellen sind: tbd<br />
<br />
== Installation ==<br />
=== Erste Schritte ===<br />
Spätestens nach einem 'update all' sollte das Modul '''38_BEOK.pm''' verfügbar sein.<br />
<br />
Nun ist ein Device in FHEM anzulegen:<br />
<br />
:<code>define <name> BEOK <ip> [mac]</code><br />
<br />
Zum Beispiel <br />
<code>define Thermo BEOK 192.168.1.100</code><br />
<code>define Thermo BEOK 192.168.1.100 de:ad:be:ef:01:02</code><br />
<br />
== Anwendung ==<br />
=== Attribute ===<br />
<br />
* '''interval'''<br />
: Poll Intevall in Sekunden, 0 = kein Polling , default 60<br />
* '''timesync'''<br />
: Uhrzeit und Wochentag automatisch mit FHEM synchronisieren, default 1 (an)<br />
* '''timeout'''<br />
: Timeout in Sekunden für die Netzwerk Kommunikation, default 5<br />
* '''language'''<br />
: de oder DE f&uuml;r deutsche Bezeichnungen, Raum statt Room , usw.<br />
* '''model'''<br />
: nur für die FHEM Modul Statistik unter [https://fhem.de/stats/statistics.html https://fhem.de/stats/statistics.html]<br />
<br />
=== Set ===<br />
<br />
Das Modul kennt derzeit folgende Commands<br />
<br />
* set <name> '''desired-temp <5 - 99>'''<br />
: Gewünschte Zieltemperatur<br />
<br />
* set <name> '''mode <auto|manual>'''<br />
: Modus auf automatisch oder manuell setzen<br />
<br />
* set <name> '''loop <12345.67 123456.7 1234567>'''<br />
: 12345.67 Montag - Freitag Werktag, Samstag & Sonntag sind Wochenende<br />
: 123456.7 Montag - Samstag Werktag, nur Sonntag ist Wochendende<br />
: 1234567 jeder Tag (inklusive Samstag & Sonntag) ist ein Werktag, kein Wochenende <br />
<br />
* set <name> '''sensor <external|internal|both>'''<br />
: both = internal control temperature, external limit temperature <br />
<br />
* set <name> '''time'''<br />
: synchronisiert Uhrzeit und Wochentag mit FHEM <br />
<br />
* set <name> '''lock <on off>'''<br />
: tbd <br />
<br />
* set <name> '''power-on-memory <on off>'''<br />
: tbd <br />
<br />
* set <name> '''fre <open|close>'''<br />
: Frostschutz Funktion<br />
<br />
* set <name> '''room-temp-adj <-5 - +5>'''<br />
: Korrekturwert (Offset) Raumtemperatur<br />
<br />
* set <name> '''osv <5 - 99>'''<br />
: Maximum Temperatur für externen Sensor <br />
<br />
* set <name> '''svh <5 - 99>'''<br />
: Raumtemperatur Maximum<br />
<br />
* set <name> '''svl <5 - 99>'''<br />
: Raumtemperatur Minimum<br />
<br />
* set <name> '''dif <1 - 9>'''<br />
: difference of limit temperature value of external sensor <br />
<br />
* set <name> '''day-profil[1-6]-temp <5 - 99>'''<br />
: Werktagprofil Temperatur <br />
<br />
* set <name> '''day-profil[1-6]-time <00:00 - 23:59>'''<br />
: Werktagprofil Zeit <br />
<br />
* set <name> '''we-profile[7-8]-temp <5 - 99>'''<br />
: Wochenendprofil Temperatu<br />
<br />
* set <name> '''we-profile[7-8]-time <00:00 - 23:59>'''<br />
: Wochenendprofil Zeit <br />
<br />
* set <name> '''weekprofile'''<br />
: Setzt alle Wochentag Schaltzeiten und Temperaturen mit Werten aus einem Profil des Moduls weekprofile.<br />
: Syntax : set weekprofile <weekprofile_device:profil_name[:Wochentag]><br />
: siehe auch Erklärung im Forum :[https://forum.fhem.de/index.php/topic,80703.msg901303.html https://forum.fhem.de/index.php/topic,80703.msg901303.html]<br />
<br />
== Anwendungsbeispiele ==<br />
<br />
folgen noch<br />
<br />
== Bekannte Probleme / Fehlersuche ==<br />
<br />
folgen noch<br />
<br />
== Links ==<br />
* Erläuterung im Forum [https://forum.fhem.de/index.php/topic,80703.msg901303.html#msg901303 https://forum.fhem.de/index.php/topic,80703.msg901303.html#msg901303]<br />
* FHEM Modul Statistik unter [https://fhem.de/stats/statistics.html https://fhem.de/stats/statistics.html]<br />
<br />
<br />
[[Kategorie:Devices]] <br />
<!-- (Modulkategorie wird automatisch gesetzt) --></div>Wzuthttp://wiki.fhem.de/w/index.php?title=BEOK&diff=29657BEOK2019-02-27T06:31:21Z<p>Wzut: </p>
<hr />
<div>{{Infobox Modul<br />
|ModPurpose=BEOK Support für FHEM <br />
|ModType=h<br />
|ModCmdRef=BEOK<br />
|ModForumArea=Sonstiges<br />
|ModTechName=38_BEOK.pm<br />
|ModOwner=Wzut ({{Link2FU|1172|Forum}} / [[Benutzer Diskussion:Wzut|Wiki]])}}<br />
<br />
<br />
Das Modul '''BEOK''' implementiert die Steuerung von FHEM zu BEOK / Floureon / Hysen WiFi Raum-Thermostaten.<br />
<br />
<br />
== Voraussetzungen ==<br />
=== FHEM-Server ===<br />
<br />
Da das Modul AES-Verschlüsselung benötigt müssen ggf. noch zusätzliche Perl Module installiert werden.<br /><br /><br />
<br />
Bsp. für Debian/Raspian :<br /><br />
<code>sudo apt-get install libcrypt-cbc-perl</code><br />
<code>sudo apt-get install libcrypt-rijndael-perl</code><br />
<code>sudo apt-get install libssl-dev</code><br />
<code>sudo cpan Crypt/OpenSSL/AES.pm</code><br />
<br />
=== Hardware ===<br />
Quellen sind: tbd<br />
<br />
== Installation ==<br />
=== Erste Schritte ===<br />
Spätestens nach einem 'update all' sollte das Modul '''38_BEOK.pm''' verfügbar sein.<br />
<br />
Nun ist ein Device in FHEM anzulegen:<br />
<br />
:<code>define <name> BEOK <ip> [mac]</code><br />
<br />
Zum Beispiel <br />
<code>define Thermo BEOK 192.168.1.100</code><br />
<code>define Thermo BEOK 192.168.1.100 de:ad:be:ef:01:02</code><br />
<br />
== Anwendung ==<br />
=== Attribute ===<br />
<br />
* '''interval'''<br />
: Poll Intevall in Sekunden, 0 = kein Polling , default 60<br />
* '''timesync'''<br />
: Uhrzeit und Wochentag automatisch mit FHEM synchronisieren, default 1 (an)<br />
* '''timeout'''<br />
: Timeout in Sekunden für die Netzwerk Kommunikation, default 5<br />
* '''language'''<br />
: de oder DE f&uuml;r deutsche Bezeichnungen, Raum statt Room , usw.<br />
* '''model'''<br />
: nur für die FHEM Modul Statistik unter [https://fhem.de/stats/statistics.html https://fhem.de/stats/statistics.html]<br />
<br />
=== Set ===<br />
<br />
Das Modul kennt derzeit folgende Commands<br />
<br />
* set <name> '''desired-temp <5 - 99>'''<br />
: Gewünschte Zieltemperatur<br />
<br />
* set <name> '''mode <auto|manual>'''<br />
: Modus auf automatisch oder manuell setzen<br />
<br />
* set <name> '''loop <12345.67 123456.7 1234567>'''<br />
: 12345.67 Montag - Freitag Werktag, Samstag & Sonntag sind Wochenende<br />
: 123456.7 Montag - Samstag Werktag, nur Sonntag ist Wochendende<br />
: 1234567 jeder Tag (inklusive Samstag & Sonntag) ist ein Werktag, kein Wochenende <br />
<br />
* set <name> '''sensor <external|internal|both>'''<br />
: both = internal control temperature, external limit temperature <br />
<br />
* set <name> '''time'''<br />
: synchronisiert Uhrzeit und Wochentag mit FHEM <br />
<br />
* set <name> '''lock <on off>'''<br />
: tbd <br />
<br />
* set <name> '''power-on-memory <on off>'''<br />
: tbd <br />
<br />
* set <name> '''fre <open|close>'''<br />
: Frostschutz Funktion<br />
<br />
* set <name> '''room-temp-adj <-5 - +5>'''<br />
: Korrekturwert (Offset) Raumtemperatur<br />
<br />
* set <name> '''osv <5 - 99>'''<br />
: Maximum Temperatur für externen Sensor <br />
<br />
* set <name> '''svh <5 - 99>'''<br />
: Raumtemperatur Maximum<br />
<br />
* set <name> '''svl <5 - 99>'''<br />
: Raumtemperatur Minimum<br />
<br />
* set <name> '''dif <1 - 9>'''<br />
: difference of limit temperature value of external sensor <br />
<br />
* set <name> '''day-profil[1-6]-temp <5 - 99>'''<br />
: Werktagprofil Temperatur <br />
<br />
* set <name> '''day-profil[1-6]-time <00:00 - 23:59>'''<br />
: Werktagprofil Zeit <br />
<br />
* set <name> '''we-profile[7-8]-temp <5 - 99>'''<br />
: Wochenendprofil Temperatu<br />
<br />
* set <name> '''we-profile[7-8]-time <00:00 - 23:59>'''<br />
: Wochenendprofil Zeit <br />
<br />
* set <name> '''weekprofile'''<br />
: Setzt alle Wochentag Schaltzeiten und Temperaturen mit Werten aus einem Profil des Moduls weekprofile.<br />
: Syntax : set weekprofile <weekprofile_device:profil_name[:Wochentag]><br />
: siehe auch Erklärung im Forum :[https://forum.fhem.de/index.php/topic,80703.msg901303.html https://forum.fhem.de/index.php/topic,80703.msg901303.html]<br />
<br />
== Anwendungsbeispiele ==<br />
<br />
folgen noch<br />
<br />
== Bekannte Probleme / Fehlersuche ==<br />
<br />
folgen noch<br />
<br />
== Links ==<br />
* Erläuterung im Forum [https://forum.fhem.de/index.php/topic,80703.msg901303.html#msg901303 https://forum.fhem.de/index.php/topic,80703.msg901303.html#msg901303]<br />
* FHEM Modul Statistik unter [https://fhem.de/stats/statistics.html https://fhem.de/stats/statistics.html]<br />
<br />
<br />
[[Kategorie:Devices]] <br />
<!-- (Modulkategorie wird automatisch gesetzt) --></div>Wzuthttp://wiki.fhem.de/w/index.php?title=SIP-Client&diff=27691SIP-Client2018-08-15T07:06:18Z<p>Wzut: eq "ringing.*" oder besser =~ "ringing" ?</p>
<hr />
<div>{{Infobox Modul<br />
|ModPurpose=SIP-Client für FHEM <br />
|ModType=h<br />
|ModCmdRef=SIP<br />
|ModForumArea=Sonstiges<br />
|ModTechName=96_SIP.pm<br />
|ModOwner=Wzut ({{Link2FU|1172|Forum}} / [[Benutzer Diskussion:Wzut|Wiki]])}}<br />
<br />
Das Modul '''SIP''' ermöglicht die Entgegennahme (DTMF-Töne interpretieren, kontrollierte Annahme) sowie die Durchführung (Audiofile abspielen, DTMF-Töne senden, Textansage) von Anrufen.<br />
<br />
<br />
== Voraussetzungen ==<br />
=== FHEM-Server ===<br />
Für den Remote-Zugang muss das Modul Net::SIP installiert sein; auf einem Raspberry Pi oder unter Ubuntu z.&nbsp;B. mit dem Befehl<br />
:<code>sudo cpan install Net::SIP</code><br />
<br />
oder auch<br />
<br />
:<code>sudo apt-get install libnet-sip-perl</code><br />
<br />
Falls cpan nicht funktioniert, hilft vielleicht dieser Forumseintrag https://forum.fhem.de/index.php/topic,40219.msg421446.html#msg421446<br />
<br />
'''Falls Ihr Text2Speech verwenden wollt'''<br />
<br />
Vorbereitung<br />
* SoX installieren <br />
:<code>sudo apt-get install sox </code><br />
* mp3 Unterstützung für SoX installieren<br />
:<code>sudo apt-get install libsox-fmt-mp3</code><br />
* Text2Speech als Server Device anlegen <br />
:<code>define <name z.B myT2S> text2speech none</code><br />
* beim SIP Device dieses Server Device im Attribut T2S_Device eintragen<br />
<br />
=== SIP-Server ===<br />
Der SIP-Client muss sich an einem SIP-Server anmelden (Fritzbox, Asterisk, VoIP-Provider). <br />
Auf dem SIP-Server, mit dem sich der Client verbinden soll, muss ein User-Account vorhanden sein bzw. angelegt werden. <br />
In der Fritzbox muss z.B. ein neues Telefoniegerät vom Typ LAN/WLAN angelegt und ein Passwort (mind. 8 Stellen und Stufe 'gut') vergeben werden. Das erzeugt ein neues internes Device im internen Rufnummernbereich **62x, typischerweise die 620. Es sollte kontrolliert werden, ob bei den Anmeldeinformationen der Benutzername der Nebenstelle entspricht (z.B. 620) und ein Passwort eingetragen ist.<br />
<br />
=== Hardware ===<br />
Die verwendete Library Net::SIP fordert mehr Ressourcen als RaspberryPi, BananaPi & Co hergeben. Bitte testet, ob Eure Hardware Audofiles sauber abspielen sowie sicher DTMF-Töne empfangen kann und für Euren Einsatzzweck geeignet ist. Erste Tests mit einem Raspi3 lagen im akzeptablen Bereich.<br />
<br />
== Installation ==<br />
=== Erste Schritte ===<br />
Spätestens nach einem 'update all' sollte das Modul '''96_SIP.pm''' verfügbar sein.<br />
<br />
Nun ist der SIP-Client als Device in FHEM anzulegen:<br />
<br />
:<code>define <name> SIP</code><br />
<br />
Anschließend sollten alle sip_Attribute geprüft und für die eigene Umgebung gesetzt werden. Ebenso ist das Passwort mittels set-Command zu speichern.<br />
<br />
Siehe auch {{Link2CmdRef|Lang=de|Anker=SIP}}<br />
<br />
=== Mögliche Fehlermeldungen ===<br />
Sollte schon bei <code>define mySIP SIP</code> die Fehlermeldung kommen, dass dieses Modul nicht existiert, dann bitte 'update all' durchführen.<br />
<br />
== Anwendung ==<br />
=== Attribute ===<br />
<br />
''Basics & Allgemeines'' <br />
* '''sip_from'''<br />
: Meine SIP-Client-Info. Default ist <nowiki>sip:620@fritz.box</nowiki> für ältere Fritz!OS-Versionen. Ab 6.8 ist das Format <nowiki>sip:Benutzername@fritz.box</nowiki>, z.B. sip:meinuser@fritz.box.<br />
* '''sip_ip'''<br />
: Die IP-Addresse meines FHEM-Servers.<br />
* '''sip_port'''<br />
: Port der für den SIP-Client genutzt wird. Default ist 5060 und wird automatisch um 10 erhöht wenn der Port nicht frei ist.<br />
* '''sip_registrar'''<br />
: Hostname oder IP-Addresse des SIP-Servers mit dem sich der Client verbindet. Default ist fritz.box.<br />
* '''sip_user'''<br />
: User Name des SIP-Clients. Default ist 620. Ab 6.8 ist der Benutzername aus sip_from anzugeben, z.B. meinuser.<br />
: Anmerkung: Passwort wird über "set <device> password ''mypassword''" gesetzt.<br />
* '''sip_listen'''<br />
: Das Attribut bietet folgende Optionen<br />
: - '''none''': keine Aktion ('listen' kann auch nicht manuell gestartet werden)<br />
: - '''dtmf''': Beim FHEM-Start geht das Device automatisch in den Status listen und wartet auf DTMF-Anrufer (listen_dtmf). Alternativ kann der Prozess manuell via 'listen' gestartet werden.<br />
: - '''wfp''': Beim FHEM-Start geht das Device automatisch in den Status listen wait-fetch-play (listen_wfp). Alternativ kann der Prozess manuell via 'listen' gestartet werden.<br />
: - '''echo''': Spielt dem Anrufer nur sein eigenes Echo wider. Sonst nix (siehe auch Anwendungsfälle).<br />
* '''sip_waittime'''<br />
: Maximale Wartezeit bei listen_wfp bis das Gespräch automatisch angenommen wird.<br />
* '''sip_ringtime'''<br />
: listen: legt fest wie lange das Modul warten soll bis es den Anruf annimmt. Defaultwert ist 2, das entspricht ca. 1x klingeln.<br />
* '''sip_force_interval'''<br />
: Pause in Sekunden für nicht erfolgreiche "force"-Anrufe, bis der nächste Versuch gestartet wird.<br />
<br />
* '''sip_filter'''<br />
: ist eine Komma getrennte Liste von Rufnummern oder Rufnummernteilen die festlegen, ob der Client bei listen überhaupt abheben soll.<br />
: Bsp.: attr mySIP sip_filter **61,123<br />
: **61 = alle DECT Telefone der Fritzbox (610 -619 )<br />
: 123 = alle Rufnummern in denen die Folge 123 enthalten ist. <br />
: Wenn das Attribut sip_filter gelöscht ist werden alle Anrufe angenommen. Das Atrribut entspricht einer Whitelist der Rufnummern die akzepziert/angenommen werden. Anrufe von nicht gelisteten Rufnummern werden einfach ignoriert.<br />
<br />
* Anmerkung zum '''Audioformat'''<br />
: Für Net::SIP müssen die Audiofiles im alaw- oder ulaw-Format vorliegen und können mit folgendem Command erzeugt werden<br />
: '''sox <file>.wav -t raw -r 8000 -c 1 -e a-law <file>.alaw'''<br />
: da nur diese raw audio Formate unterstützt werden. <br />
: Vom SIP-Modul unterstützte/erkannte Endungen sind .mp3, .alaw und .ulaw. mp3-Files werden automatisch in alaw umgewandelt (das setzt aber einen entsprechenden Konverter wie sox oder ffmpeg voraus). Bitte darauf achten, dass das audiofile und der komplette Pfad die passenden Permissions hat, damit der FHEM User das File auch lesen darf.<br />
<br />
''DTMF empfangen''<br />
* '''sip_dtmf_loop'''<br />
: legt für den listen_dtmf-Modus fest wie oft ein DTMF Code eingeben werden soll ( once oder loop, default ist once ). <br />
: Bei 'once' erwartet der SIP-Cleint die Eingabe eines Codes in der angegebenen Länge und beendet den Anruf. <br />
: Bei 'loop' startet eine Endlosschleife aus Ansage->Code-Erfassung->Quittung->Loop bis der Anrufer irgendwann auflegt.<br />
* '''sip_dtmf_size'''<br />
: Die Anzahl der erwarteten DTMF-Töne im listen_dtmf-Modus (1 bis 4)<br />
* '''sip_audiofile_dtmf'''<br />
: Audiofile das dem Anrufer im listen_dtmf-Modus vorgespielt wird und ihn auffordert einen Code einzugeben. Ist kein File angegeben hört man ein Geräusch.<br />
* '''sip_audiofile_ok'''<br />
: Audiofile das dem Anrufer im listen_dtmf-Modus als Quittungston vorgespielt wird. <br />
* '''sip_blocking'''<br />
: Hier kann so etwas wie eine Blacklist von Rufnummern angegeben werden, die explizit weggedrückt werden. Jede Rufnummer die so behandelt werden soll muss zuerst erfolgreich durch den sip_filter durch und kann danach erst aktiv geblockt werden. Die Syntax ist die gleiche wie bei sip_filter, allerdings gibt es hier den Joker '''.*''' . Ist dieser gesetzt wird jede ankommende Rufnummer geblockt. Damit lassen sich begrenzt Aktionen auslösen (das Event 'ringing_*' wird nach wie vor ausgelöst und die Rufnummer wird als Reading gesetzt) ohne dass Verbindungskosten anfallen.<br />
<br />
''Auf anruf warten und annehmen''<br />
* '''sip_audiofile_wfp'''<br />
: Audiofile das nach dem Command '''fetch''' abgespielt wird. <br />
* '''sip_elbc'''<br />
: erlaubte Werte: no | yes. elbc steht für 'End Listen Befor Call'. Bei Option 'yes' wird ein laufender Listen Prozess beendet falls parallel ein Call rausgehen soll. Danach wird der listen wieder neu gestartet. <br />
<br />
''Anrufen und DTMF senden''<br />
* '''sip_dtmf_send'''<br />
: Bestimmt die Übertragungsart der angegebenen DTMF-Töne und bietet folgende Möglichkeiten:<br />
: 'audio': Es werden Audiotöne übermittelt<br />
: 'rfc2833': Es erfolgt eine Übertragung nach RFC2833 (für das menschliche Ohr weniger ansprechend)<br />
<br />
''Anrufen und etwas senden''<br />
* '''sip_audiofile_call'''<br />
: Audiofile das dem angerufenen bei '''call''' vorgespielt wird. <br />
* '''sip_call_audio_delay''' <br />
: Damit wird festgelegt wie lange bei einem Call mit dem abspielen des Audiofiles gewartet werden soll nachdem man den Anruf angenommen hat. Gültige Werte sind 0 - 3 in 0.25 (1/4) Sekunden Schritten. <br />
<br />
''Anrufen und etwas sagen''<br />
* '''T2S_Device'''<br />
: Name Eures in FHEM eingerichteten Text2Speech-Devices <br />
* '''T2S_Timeout'''<br />
: Timeout für die Text2Speech-Konvertierung (könnte ja sein, dass der TTS-Service im Internet überlastet ist)<br />
* '''audio_converter'''<br />
: Der für die Konvertierung zu verwendende (und vorab installierte) Audiokonverter. Auswahl: sox oder ffmpeg<br />
<br />
''Ergänzungen ab Version 1.75''<br /><br />
alle Attribute die mit sip_audiofile_ beginnen dürfen einen Inhalt der folgenden Form haben:<br /><br />
a. ein .alw oder .ulaw Filename inklusive Pfad<br /><br />
b. ein .mp3 File + Pfad -> wird dann automatisch zu .ulaw gewandelt , Audio Konverter & Schreibrechte im Pfad sind Pflicht<br /><br />
c. ein Text beginnend mit ! der von Text2Speach in eine .mp3 Datei gewandelt wird, diese wird danach behandelt wie unter Punkt b.<br /><br />
<br />
wurde Punkt b. oder c. einmal erfolgreich durchlaufen wird beim nächsten Mal direkt die erzeugte .ulaw Datei verwendet.<br />
<br />
Siehe auch {{Link2CmdRef|Lang=de|Anker=SIP}}<br />
<br />
=== Set ===<br />
<br />
Das Modul kennt derzeit folgende Commands<br />
<br />
* set <name> '''password'''<br />
: Passwort für den User sip_user hinterlegen.<br />
<br />
* set <name> '''reset'''<br />
<br />
: Stoppt laufende listen-Prozess und initalisiert das Device.<br />
<br />
* set <name> '''call <nummer> [<maxtime>] [<nachricht>] [*nn] [&][nn]'''<br />
: Startet einen Anruf an die angegebene Nummer.<br />
: Optional kann die maxtime angegeben werden. Wird keine angegeben wird der Defaultwert von 30 verwendet.<br />
: Optional kann eine Nachricht <br />
: - in Form eines '''Audiofiles''' angegeben werden. Das File ist mit dem vollen Pfad oder dem relativen ab dem Verzeichnis mit fhem.pl anzugeben. Bitte darauf achten, dass das audiofile und der Pfad dort hin passende Permissions hat, damit FHEM das File auch lesen darf. Die maxtime ist in dem Fall nicht optional sondern zwingend.<br />
: - als '''DTMF'''-Sequenz angegeben werden. Diese mit einem Prefix '-' versehen werden, also z.B. '''-'''#47.<br />
: - als '''Text''' angegeben werden. Dieser mit einem Prefix '!' versehen werden, also z.B. '''!'''Hier spricht dein FHEM.<br />
: Bitte hierfür unter 'Voraussetzungen' den Hinweis auf TTS beachten.<br />
: Wir ein Wiederholunsfaktor in der Form '''*nn''' angegeben, wird der Anruf ausgeführt, die Nachricht einmal abgespielt und dann nn mal wiederholt. <br />
: Wird als Wiederholungsfaktor ein negativer Wert angegeben (z.B. '''*-2'''), passiert folgendes: Die Nachricht wird zwar genau wie bei *2 dreimal abgespielt, allerdings erlaubt das - vor der 2 das die Nachricht nur einmal vollständig übertragen werden muß. Der call_state nach dem Call hätte dann z.B. den Wert "ok peer hangup".<br />
: Wird der Call mit '''&''' (force) beendet signalisiert dies, dass er wichtig ist und unbedingt zugestellt werden muss. Der SIP-Client versucht es dann so lange, bis der Anrufer erreicht wird. WICHTIG: wählt die maxtime groß genug damit das Audiofile auch wirklich komplett abgespielt werden kann, bzw. hört's euch auch bis zum Ende an! Wenn ein priorisierter Anruf vorzeitig endet (quasi NOK) wird er nach 1 Minute wiederholt, und zwar so lange bis er erfolgreich war. Wollt Ihr den Ablauf stoppen bitte das von der Wiederholungsschleife gesetzte '''at''' löschen, es befindet sich im gleichen Raum wie euer SIP Device. Dabei gibt es folgende Möglichkeiten:<br />
: set call **611 30 !Das ist ein Test & <-- wird im Fehlerfall nach 60 Sekunden wiederholt oder nach sip_force_interval wenn vorhanden.<br />
: set call **611 30 !Das ist ein Test &300 <-- wiederholt im Fehlerfall nach 5 Minuten egal welchen Wert sip_force_interval hat.<br />
: Werden mehrere Set Call unmittelbar hintereinander abgesetzt, werden diese intern gestackt und nacheinander abgearbeitet.<br />
<br />
* set <name> '''listen'''<br />
: Manueller Start des listen-Prozesses. Setzt voraus, dass die Variable sip_listen auf dtmf oder wfp gesetzt ist:<br />
: '''dtmf''': Der SIP-Client wird in einen Status versetzt in dem er automatisch Anrufe annimmt. Bei einem Anruf wird im Reading 'caller' die Nummer bzw. Id des Anrufers angezeigt. Dem Anrufer wird der eigene Ton als Echo zurückgespielt. Über die Eingabe von '''#''' gefolgt von 2 Zahlen und anschließendem Auflegen kann eine Zahl an das Reading '''dtmf''' übergeben werden. Voraussetzung: Das anrufende Telefon ist auf Tonwahl gestellt (DTMF).<br />
: '''wfp''': Der SIP-Client wird in einen Status versetzt in dem er auf Anrufe wartet (wfp steht für wait-fetch-play). Erfolgt ein Anruf an den Client, wechselt das Reading 'caller_state' zu 'ringing_*', im Reading 'caller' wird die Nummer bzw. Id des Anrufers angezeigt. Nun kann das Gespräch via set-Command 'fetch' angenommen oder der Anruf via 'reject' explizit abgelehnt werden. Das als sip_audiofile angegebene File wird abgespielt. Anschließend wechselt der Status wieder zu listen_wfp.<br />
<br />
* set <name> '''fetch'''<br />
: Anruf im listen_wfp-Modus annehmen.<br />
<br />
* set <name> '''reject'''<br />
: Anruf im listen_wfp-Modus ablehnen.<br />
<br />
=== Readings ===<br />
<br />
<br />
* '''call''': Die Rufnummer des ausgehenden Anrufs. <br />
* '''call_state''': Status für ausgehende Anrufe. <br />
* '''call_time''': Dauer des durchgeführten Anrufs in Sekunden<br />
* '''call_success''': mögliche Werte 0 oder 1<br />
: 0 = call_state ist ungleich ok , 1 = call_state ist gleich ok<br />
: Auf Call mit Repeat übertragen bedeutet das:<br />
: eine 0 wenn die Wiederholungszahl positiv ist und die tatsächliche Anzahl nicht erreicht wurde, aber <br />
: eine 1 bei call_state "ok peer hangup" <br />
* '''caller''': Die Rufnummer bzw. Info des aktuellen Anrufers. <br />
* '''caller_state''': Status für eingehende Anrufe. <br />
* '''caller_time''': Dauer des angenommenen Anrufs in Sekunden<br />
* '''dtmf''': Die via Tonwahl (DTMF) eingegebenen Zahlen.<br />
* '''state''': Der Status des Devices.<br />
<br />
== Anwendungsbeispiele ==<br />
<br />
=== Anruf tätigen und Sound abspielen ===<br />
* Den Anruf initiieren<br />
<code>set <device> call <nummer> [<dauer>] [<audiofile oder Textnachricht>]</code><br />
<code>set mySip call 081547111 30 ./tada.alaw</code><br />
<code>set mySip call 081547111 30 !Hier ist dein FHEM Server</code><br />
* Die Default-Dauer beträgt 30 Sekunden.<br />
* Wird kein Audiofile angegeben, wird nur die Verbindung hergestellt und nach der Anrufdauer wieder unterbrochen.<br />
* Anmerkung: Das Audiofile muss das Format PCM/8000 haben.<br />
* Der Angerufene nimmt das Gespräch entgegen, das Audiofile wird abgespielt.<br />
<br />
=== Anruf tätigen und DTMF-Töne senden ===<br />
* Den Anruf initiieren<br />
: <code>set <device> call <nummer> <dauer> <-tastenkombination></code><br />
* Die Tastenkombination muss mit einem vorangestellten Minus (-) nach der Zielnummer folgen, also z.B. **1 -#23<br />
* Der Angerufene nimmt das Gespräch entgegen, die Tonfolge wird abgespielt.<br />
<br />
=== Auf Anruf warten und DTMF-Töne empfangen ===<br />
* Der SIP-Client wird in den Listen-Modus versetzt.<br />
: Das Attribut sip_listen auf '''dtmf''' setzen und<br />
: <code>set <device> listen</code><br />
* Die Nebenstelle des SIP-Clients wird von einem DTMF-fähigen Telefon aus angerufen.<br />
* Wenn der SIP-Client das Gespräch angenommen hat, betätigt man '''#''', gefolgt von zwei Ziffern und legt dann wieder auf. Wichtig: Es müssen immer genau 3 Tasten betätigt werden (# und nm), damit das Reading dtmf gefüllt wird. n und m müssen zwei verschiedene Zahlen sein (0-9) oder ein Stern.<br />
* Im Reading '''dtmf''' ist diese zweistellige Zahl zu sehen und kann ggf. mit einem notify ausgewertet werden.<br />
<br />
=== Auf Anruf warten und kontrolliert annehmen ===<br />
* Der SIP-Client wird in den Listen-Modus versetzt.<br />
: Das Attribut sip_listen auf '''wfp''' setzen und<br />
: <code>set <device> listen</code><br />
* Die Nebenstelle des SIP-Clients wird angerufen.<br />
* Im Reading '''caller''' ist die Nummer bzw. die Info des Callers zu sehen, im '''caller_state''' erscheint 'ringing'.<br />
* Soll der Anruf angenommen werden setze ich den Status des Devices mittels set auf '''fetch''':<br />
: <code>set <device> fetch</code><br />
* Der SIP-Client nimmt den Anruf an und spielt das im Attribut sip_audiofile angegebene File ab.<br />
* Der SIP-Client legt auf und geht wieder in den Status '''listen_wfp'''.<br />
<br />
=== Auf Anruf warten und Aktion auslösen ===<br />
* Der SIP-Client wird in den Listen-Modus versetzt.<br />
: Das Attribut sip_listen auf '''wfp''' setzen und<br />
: <code>set <device> listen</code><br />
* Die Nebenstelle des SIP-Clients wird angerufen.<br />
* Im Reading '''caller''' ist die Nummer bzw. die Info des Callers zu sehen, im '''caller_state''' erscheint 'ringing'.<br />
* FHEM kann auf Grund dieser Events eine Aktion durchführen.<br />
* Der Anruf wird dann von FHEM abgebrochen. Dafür wird der Befehl '''reject''' genutzt:<br />
: <code>set <device> reject</code><br />
* Der Anrufer weiß auf Grund der Ablehnung, dass FHEM aktiv war.<br />
* Der SIP-Client legt auf und geht wieder in den Status '''listen_wfp'''.<br />
<br />
=== Fritzbox + Doorline - Telefonklingeln beenden ===<br />
Szenario: Als Türklingel ist eine Doorline im Einsatz die auf Direktannahme eingestellt ist. Klingelt jemand an der Tür, erfolgt ein 'Anruf' an die in der Rufgruppe definierten Telefone. Man kann den Anruf entgegennehmen, um zu hören wer an der Tür ist, bevor man die Tür öffnet. Geht man direkt zur Tür, klingeln die Telefone insgesamt 30 Sekunden lang bis sie verstummen. Hat man die Haustür mit einem Türkontakt versehen, hilft folgender Ansatz:<br />
* Der SIP-Client wird in der Fritzbox in die Rufgruppe der Türklingel aufgenommen.<br />
* Das Attribut 'sip_listen' wird auf 'wfp' gesetzt.<br />
* Der SIP-Client wird in den Listen-Modus 'wait-fetch-play' versetzt (Die sip_waittime sollte größer als die Klingeldauer der Doorline sein).<br />
: <code>set <device> listen</code><br />
* Klingelt jemand an der Tür, wird unter anderem die Nebenstelle des SIP-Clients angerufen.<br />
* Über ein DOIF greift man die Kombination SIP-Client caller_state 'ringing' und Haustürkontakt closed->open ab und<br />
* setzt den Status des Devices mittels set auf fetch:<br />
: <code>set <device> fetch</code><br />
* Der SIP-Client nimmt den Anruf an und spielt das im Attribut sip_audiofile angegebene File ab.<br />
* Die Telefone verstummen.<br />
<br />
In FHEM sieht das dann z.B. so aus:<br />
<br />
Es gibt ein Device '''HaustuerStatus''' das den Status des Türkontaktes abbildet: "closed" oder "open".<br />
<br />
Es wird ein Dummy-Device '''HaustuerStatusVar''' für die Status des Automaten angelegt:<br />
<br />
<code>define HaustuerStatusVar dummy</code><br />
<br />
Und ein DOIF '''TuerklingelAus''':<br />
<br />
<pre><br />
define TuerklingelAus DOIF <br />
(([HaustuerStatus:state] eq "closed") and ([FhemSipClient:caller_state] =~ "ringing") and ([FhemSipClient:caller] eq "Klingel sip:**12\@fritz.box")) <br />
(set HaustuerStatusVar ringing;; set HM_4A4047_Mp3 playTone 001 1 10) <br />
DOELSEIF <br />
(([HaustuerStatus:state] eq "open") and ([HaustuerStatusVar:state] =~ "ringing")) <br />
(set FhemSipClient fetch;; set HaustuerStatusVar on) <br />
DOELSEIF <br />
(([HaustuerStatus:state] eq "closed") and ([HaustuerStatusVar:state] ne "off")) <br />
(set HaustuerStatusVar off)<br />
</pre><br />
<br />
Der Caller "Klingel sip:**12\@fritz.box" setzt sich aus dem in der Fritzbox vergebenen Namen, der Nebenstelle (**12 ist eine Doorline mit einem Taster, bei zweien gilt es **11 und **12 zu beachten) sowie dem syntaktischen Drumherum sip:''nebenstelle''\@fritz.box zusammen. Achtet bitte auf den "\" vor dem "@", damit regex nicht mosert.<br />
<br />
HM_4A4047_Mp3 ist übrigens mein mobiler MP3-Tür-/Funkgong der zur Unterstützung einen Gong abspielt.<br />
<br />
=== Nervende Werbeanrufe ===<br />
Ihr kennt das sicher: Unbekannte Rufnummer, man nimmt das Gespräch an und hat entweder irgendwas gewonnen, einen Werber oder ein "Umfrage" dran. Unterm Strich - man will Dir was verkaufen.<br />
<br />
Phase 1: Fritzbox, Rufbehandlung, neue Rufnummernsperre, Nummer eintragen.<br />
<br />
Phase 2: Derselbe Werber taucht unter einem ganzen Kontingent von Rufnummern auf. Blocken alleine reicht dir nicht mehr, du willst Rache.<br />
<br />
Phase 3: <br />
: Du definierst in FHEM den SIP-Client und startest ihn im listen-Modus '''echo'''. <br />
: In der Fritzbox leitest du alle eingehenden Anrufe auch an den SIP-Client weiter. <br />
: Dem SIP-Client gibst du über sip_filter die Werber-Rufnummer als Filterarguiment mit.<br />
: Der SIP-Cleint ist schneller als die Familienmitglieder und nimmt den Anruf an. <br />
<br />
Phase 4: Jetzt bin ich (der Autor dieses Anwendungsfalles) neugierig. Postet Eure Erfahrung mit diesem Modus gerne im Forums-Thread.<br />
<br />
=== FHEM Statusberichte ===<br />
<br />
Man sagt zwar "wer lesen kann ist eindeutig im Vorteil", dennoch gibt es Situationen in denen eine Sprachausgabe praktischer ist. Ein Beispiel findet Ihr im Forum unter [https://forum.fhem.de/index.php/topic,67443.msg742371.html#msg742371]. Das zugehörige Textbeispiel (als Appetithappen):<br />
<br />
"Guten Abend Papa, hier ist Dein Speicherknecht mit dem Bericht von 18 Uhr37. Die Alarmanlage ist aus. Im Garten war jemand um 17 Uhr 45 und an der Haustür um 18 Uhr 16. Im Küche und OG1 ist das Licht an. Mama und Papa sind seit 18 Uhr 29 zu Hause. Die Heizung steht auf Normal Betrieb. Die Vorlaftemperatur beträgt 51 Grad. Der Gasverbrauch beträgt 8 Kubik bei einer Laufzeit von 182 Minuten. Das Wetter ist Schauer. Die Temperatur Aussen beträgt 8 Grad Celsius. Dabei war das Minimum 3 und das Maximum 8 und im Haus ist es 19 Grad warm. Papa, ich wünsche Dir noch einen geruhsamen Abend!"<br />
<br />
== Bekannte Probleme / Fehlersuche ==<br />
=== Fehler bei der Registrierung an der Fritzbox ===<br />
'''Fritzbox'''<br />
* Ist das Device für den SIP-Client in der Fritzbox unter Telefonie > Telefoniegräte gelistet? <br />
* Geräteeinstellungen ändern: Ist für das Device unter 'Anmeldedaten' die Durchwahl als Benutzername angegeben?<br />
* Ist der in dieser Ansicht angegebene 'Registrar' mit der im Attribut sip_registrar identisch? Im Zweifelsfalle die IP-Adresse statt 'fritz.box' verwenden.<br />
* FitzOS ab 6.80: Wurde nach Definition des Gerätes an einem anderen bekannten Gerät der Bestätigungscode eingegeben?<br />
* Wurde in der Fritzbox ein Passwort von mind. 8 Stellen und Sicherheitsstufe 'gut' vergeben? Andernfalls kann es zu einem Registrierungsfehler 404 kommen.<br />
* FritzOS 6.90: Registrierungsfehler 404 konnte erst mit folgenden Angaben gelöst werden<br />
sip_from = sip:mymyuser@fritz.box (wobei dies der mymyuser ist der beim Telefoniegrät als Benutzername angegeben wurde, <br />
bitte die von der FritzBox geforderte Mindestlänge beachten)<br />
sip_user = myuser (statt der Nebenstellennummer)<br />
<br />
'''FHEM'''<br />
<br />
Wurde das Passwort mittels set <mydevice> password <meinpasswort> gesetzt?<br />
<br />
Attribute des Devices prüfen:<br />
* Ist unter sip_from <nowiki>'sip:620@fritz.box'</nowiki> die von der Fritzbox vergebene Durchwahl angegeben? Ab Fritz!OS 6.8 gilt: Ist das Format <nowiki>sip:Benutzername@fritz.box</nowiki> eingehalten?<br />
* Ist unter sip_user die von der Fritzbox vergebene Durchwahl angegeben?<br />
* Ist unter sip_registrar die IP-Adresse der Fritzbox eingetragen ('fritz.box' wird manchmal nicht korrekt aufgelöst)?<br />
* Ist unter sip_ip die IP-Adresse des FHEM-Servers eingetragen (z.B. 192.168.178.47 angeben, keine Adresse aus dem 127er-Segment)?<br />
* Probleme mit dem Standard-Port 5060? Auf 5070 erhöhen.<br />
<br />
=== Erzeugung eines passenden Audiofiles ===<br />
<br />
Eine Alternative zu sox ist ffmpeg. Damit kann direkt von mp3 ins Zielformat konvertiert werden:<br />
<br />
ffmpeg -i meinfile.mp3 -f alaw -ar 8000 meinfile.alaw<br />
<br />
=== Keine korrekte DTMF-Erkennung auf einem Pi ===<br />
<br />
Raspi, Raspi2 und BanaPi sind nicht leistungsstark genug für die Erkennung von DTMF-Tönen. Ab Raspi3 scheint's zu funktionieren.<br />
<br />
Wer trotzdem auf einem "kleinen" Pi die DTMF-Erkennung gemäß RFC2833 nutzen möchte, kann in der DTMF.pm die Zeile 75<br />
<br />
<code>###$sub{$type} = _dtmf_xtc_audio(%pargs);</code><br />
<br />
für die Audio-Erkennung auskommentieren. Zu finden ist DTMF.pm z.B. unter /usr/lib/perl5/site_perl/5.18.2/Net/SIP. Konsequenz: Moderne, RFC2833-unterstützende Geräte können genutzt werden, ältere Telefone mit Tonwahl nicht.<br />
<br />
== Links ==<br />
* {{Link2Forum|Topic=40219|LinkText=Forenthread}} alter Forum-Thread zu FB_SIP.pm und SIP.pm<br />
* {{Link2Forum|Topic=67443|LinkText=Forenthread}} Forum-Thread zu diesem Modul SIP<br />
* [https://de.wikipedia.org/wiki/SIP-Status-Codes SIP-Status Codes]<br />
<br />
[[Kategorie:Hilfsmodul]] <br />
<!-- (Modulkategorie wird automatisch gesetzt) --></div>Wzuthttp://wiki.fhem.de/w/index.php?title=SIP-Client&diff=20800SIP-Client2017-03-19T17:59:17Z<p>Wzut: ringtime durch maxtime ersetzt</p>
<hr />
<div>{{Infobox Modul<br />
|ModPurpose=SIP-Client für FHEM <br />
|ModType=h<br />
|ModCmdRef=SIP<br />
|ModForumArea=Sonstiges<br />
|ModTechName=96_SIP.pm<br />
|ModOwner=Wzut ({{Link2FU|1172|Forum}} / [[Benutzer Diskussion:Wzut|Wiki]])}}<br />
<br />
Das Modul '''SIP''' ermöglicht die Entgegennahme (DTMF-Töne interpretieren, kontrollierte Annahme) sowie die Durchführung (Audiofile abspielen, DTMF-Töne senden, Textansage) von Anrufen.<br />
<br />
<br />
== Voraussetzungen ==<br />
=== FHEM-Server ===<br />
Für den Remote-Zugang muss das Modul Net::SIP installiert sein; auf einem Raspberry Pi oder unter Ubuntu z.&nbsp;B. mit dem Befehl<br />
:<code>sudo cpanm install Net::SIP</code><br />
<br />
oder auch<br />
<br />
:<code>sudo apt-get install libnet-sip-perl</code><br />
<br />
==== Falls Ihr Text2Speech verwenden wollt ====<br />
<br />
Vorbereitung<br />
* SoX installieren <br />
:<code>sudo apt-get install sox </code><br />
* mp3 Unterstützung für SoX installieren<br />
:<code>sudo apt-get install libsox-fmt-mp3</code><br />
* Text2Speech als Server Device anlegen <br />
:<code>define <name z.B myT2S> text2speech none</code><br />
* beim SIP Device dieses Server Device im Attribut T2S_Device eintragen<br />
<br />
=== SIP-Server ===<br />
Der SIP-Client muss sich an einem SIP-Server anmelden (Fritzbox, Asterisk, VoIP-Provider). <br />
Auf dem SIP-Server, mit dem sich der Client verbinden soll, muss ein User-Account vorhanden sein bzw. angelegt werden. <br />
In der Fritzbox muss z.B. ein neues Telefoniegerät vom Typ LAN/WLAN angelegt und ein Passwort vergeben werden. Das erzeugt ein neues internes Device im internen Rufnummernbereich **62x, typischerweise die 620. Es sollte kontrolliert werden, ob bei den Anmeldeinformationen der Benutzername der Nebenstelle entspricht (z.B. 620) und ein Passwort eingetragen ist.<br />
<br />
=== Hardware ===<br />
Die verwendete Library Net::SIP fordert mehr Ressourcen als RaspberryPi, BananaPi & Co hergeben. Bitte testet, ob Eure Hardware Audofiles sauber abspielen sowie sicher DTMF-Töne empfangen kann und für Euren Einsatzzweck geeignet ist.<br />
<br />
== Installation ==<br />
=== Erste Schritte ===<br />
Spätestens nach einem 'update all' sollte das Modul '''96_SIP.pm''' verfügbar sein.<br />
<br />
Nun ist der SIP-Client als Device in FHEM anzulegen:<br />
<br />
:<code>define <name> SIP</code><br />
<br />
Anschließend sollten alle sip_Attribute geprüft und für die eigene Umgebung gesetzt werden. Ebenso ist das Passwort mittels set-Command zu speichern.<br />
<br />
=== Mögliche Fehlermeldungen ===<br />
Sollte schon bei <code>define mySIP SIP</code> die Fehlermeldung kommen, dass dieses Modul nicht existiert, dann bitte 'update all' durchführen.<br />
<br />
== Anwendung ==<br />
=== Define ===<br />
<br />
<code>define <name> SIP</code><br />
<br />
Anschließend sollten alle sip_Attribute geprüft und für die eigene Umgebung gesetzt werden.<br />
<br />
Siehe auch [http://fhem.de/commandref_DE.html#SIP commandref]<br />
<br />
=== Attribute ===<br />
<br />
''Basics & Allgemeines'' <br />
* '''sip_from'''<br />
: Meine SIP-Client-Info. Default ist <nowiki>sip:620@fritz.box</nowiki><br />
* '''sip_ip'''<br />
: Die IP-Addresse meines FHEM-Servers.<br />
* '''sip_port'''<br />
: Port der für den SIP-Client genutzt wird. Default ist 5060 und wird automatisch um 10 erhöht wenn der Port nicht frei ist.<br />
* '''sip_registrar'''<br />
: Hostname oder IP-Addresse des SIP-Servers mit dem sich der Client verbindet. Default ist fritz.box.<br />
* '''sip_user'''<br />
: User Name des SIP-Clients. Default ist 620. Anmerkung: Passwort wird über "set <device> password ''mypassword''" gesetzt.<br />
* '''sip_listen'''<br />
: Das Attribut bietet folgende Optionen<br />
: - '''none''': keine Aktion ('listen' kann auch nicht manuell gestartet werden)<br />
: - '''dtmf''': Beim FHEM-Start geht das Device automatisch in den Status listen und wartet auf DTMF-Anrufer (listen_dtmf). Alternativ kann der Prozess manuell via 'listen' gestartet werden.<br />
: - '''wfp''': Beim FHEM-Start geht das Device automatisch in den Status listen wait-fetch-play (listen_wfp). Alternativ kann der Prozess manuell via 'listen' gestartet werden.<br />
* '''sip_waittime'''<br />
: Maximale Wartezeit bei listen_wfp bis das Gespräch automatisch angenommen wird.<br />
* '''sip_ringtime'''<br />
: listen: legt fest wie lange das Modul warten soll bis es den Anruf annimmt. Defaultwert ist 2, das entspricht ca. 1x klingeln.<br />
<br />
* '''sip_filter'''<br />
: ist eine Komma getrennte Liste von Rufnummern oder Rufnummernteilen die festlegen ob der Client bei listen überhaupt abheben soll.<br />
: Bsp.: attr mySIP sip_filter **61,123<br />
: **61 = alle DECT Telefone der Fritzbox (610 -619 )<br />
: 123 = alle Rufnummern in denen die Folge 123 enthalten ist. <br />
<br />
* Anmerkung zum '''Audioformat'''<br />
: Audiofiles müssen im alaw- oder ulaw-Format vorliegen und können mit folgendem Command erzeugt werden<br />
: '''sox <file>.wav -t raw -r 8000 -c 1 -e a-law <file>.alaw'''<br />
: da nur diese raw audio format unterstützt wird. Unterstützte/erkannte Endungen sind .alaw und .ulaw. Bitte darauf achten, dass das audiofile und der komplette Pfad die passenden Permissions hat, damit der FHEM User das File auch lesen darf.<br />
<br />
''DTMF empfangen''<br />
* '''sip_dtmf_loop'''<br />
: legt für den listen_dtmf-Modus fest wie oft ein DTMF Code eingeben werden soll ( once oder loop, default ist once ). <br />
: Bei 'once' erwartet der SIP-Cleint die Eingabe eines Codes in der angegebenen Länge und beendet den Anruf. <br />
: Bei 'loop' startet eine Endlosschleife aus Ansage->Code-Erfassung->Quittung->Loop bis der Anrufer irgendwann auflegt.<br />
* '''sip_dtmf_size'''<br />
: Die Anzahl der erwarteten DTMF-Töne im listen_dtmf-Modus (1 bis 4)<br />
* '''sip_audiofile_dtmf'''<br />
: Audiofile das dem Anrufer im listen_dtmf-Modus vorgespielt wird und ihn auffordert einen Code einzugeben. Ist kein File angegeben hört man ein Geräusch.<br />
* '''sip_audiofile_ok'''<br />
: Audiofile das dem Anrufer im listen_dtmf-Modus als Quittungston vorgespielt wird. <br />
<br />
''Auf anruf warten und annehmen''<br />
* '''sip_audiofile_wfp'''<br />
: Audiofile das nach dem Command '''fetch''' abgespielt wird. <br />
<br />
''Anrufen und DTMF senden''<br />
* '''sip_dtmf_send'''<br />
: Bestimmt die Übertragungsart der angegebenen DTMF-Töne und bietet folgende Möglichkeiten:<br />
: 'audio': Es werden Audiotöne übermittelt<br />
: 'rfc2833': Es erfolgt eine Übertragung nach RFC2833 (für das menschliche Ohr weniger ansprechend)<br />
<br />
''Anrufen und etwas senden''<br />
* '''sip_audiofile_call'''<br />
: Audiofile das dem angerufenen bei '''call''' vorgespielt wird. <br />
<br />
''Anrufen und etwas sagen''<br />
* '''T2S_Device'''<br />
: Name Eures in FHEM eingerichteten Text2Speech-Devices <br />
* '''T2S_Timeout'''<br />
: Timeout für die Text2Speech-Konvertierung (könnte ja sein, dass der TTS-Service im Internet überlastet ist)<br />
* '''audio_converter'''<br />
: Der für die Konvertierung zu verwendende (und vorab installierte) Audiokonverter. Auswahl: sox oder ffmpeg<br />
<br />
Siehe auch [http://fhem.de/commandref_DE.html#SIP commandref]<br />
<br />
=== Set ===<br />
<br />
Das Modul kennt derzeit folgende Commands<br />
<br />
* set <name> '''password'''<br />
: Passwort für den User sip_user hinterlegen.<br />
<br />
* set <name> '''reset'''<br />
<br />
: Stoppt laufende listen-Prozess und initalisiert das Device.<br />
<br />
* set <name> '''call <nummer> [<maxtime>] [<nachricht>]'''<br />
: Startet einen Anruf an die angegebene Nummer.<br />
: Optional kann die maxtime angegeben werden. Wird keine angegeben wird der Defaultwert von 30 verwendet.<br />
: Optional kann eine Nachricht <br />
: * in Form eines Audiofiles angegeben werden. Das File ist mit dem vollen Pfad oder dem relativen ab dem Verzeichnis mit fhem.pl anzugeben. Bitte darauf achten, dass das audiofile und der Pfad dort hin passende Permissions hat, damit FHEM das File auch lesen darf. Die maxtime ist in dem Fall nicht optional sondern zwingend.<br />
: * als DTMF-Sequenz angegeben werden. Diese mit einem Prefix '-' versehen werden, also z.B. '''-'''#47.<br />
: * als Text angegeben werden. Dieser mit einem Prefix '!' versehen werden, also z.B. '''!'''Hier spricht dein FHEM.<br />
: Bitte hierfür unter 'Voraussetzungen' den Hinweis auf TTS beachten.<br />
<br />
* set <name> '''listen'''<br />
: Manueller Start des listen-Prozesses. Setzt voraus, dass die Variable sip_listen auf dtmf oder wfp gesetzt ist:<br />
: '''dtmf''': Der SIP-Client wird in einen Status versetzt in dem er automatisch Anrufe annimmt. Bei einem Anruf wird im Reading 'caller' die Nummer bzw. Id des Anrufers angezeigt. Dem Anrufer wird der eigene Ton als Echo zurückgespielt. Über die Eingabe von '''#''' gefolgt von 2 Zahlen und anschließendem Auflegen kann eine Zahl an das Reading '''dtmf''' übergeben werden. Voraussetzung: Das anrufende Telefon ist auf Tonwahl gestellt (DTMF).<br />
: '''wfp''': Der SIP-Client wird in einen Status versetzt in dem er auf Anrufe wartet (wfp steht für wait-fetch-play). Erfolgt ein Anruf an den Client, wechselt das Reading 'caller_state' zu 'ringing', im Reading 'caller' wird die Nummer bzw. Id des Anrufers angezeigt. Nun kann das Gespräch via set-Command 'fetch' angenommen werden. Das als sip_audiofile angegebene File wird abgespielt. Anschließend wechselt der Status wieder zu listen_wfp.<br />
<br />
=== Readings ===<br />
<br />
<br />
* '''call''': Die Rufnummer des ausgehenden Anrufs. <br />
* '''call_state''': Status für ausgehende Anrufe. <br />
* '''caller''': Die Rufnummer bzw. Info des aktuellen Anrufers. <br />
* '''caller_state''': Status für eingehende Anrufe. <br />
* '''dtmf''': Die via Tonwahl (DTMF) eingegebenen Zahlen.<br />
* '''state''': Der Status des Devices.<br />
<br />
== Anwendungsbeispiele ==<br />
<br />
=== Anruf tätigen und Sound abspielen ===<br />
* Den Anruf initiieren<br />
<code>set <device> call <nummer> [<dauer>] [<audiofile oder Textnachricht>]</code><br />
<code>set mySip call 081547111 30 ./tada.alaw</code><br />
<code>set mySip call 081547111 30 !Hier ist dein FHEM Server</code><br />
* Die Default-Dauer beträgt 30 Sekunden.<br />
* Wird kein Audiofile angegeben, wird nur die Verbindung hergestellt und nach der Anrufdauer wieder unterbrochen.<br />
* Anmerkung: Das Audiofile muss das Format PCM/8000 haben.<br />
* Der Angerufene nimmt das Gespräch entgegen, das Audiofile wird abgespielt.<br />
<br />
=== Anruf tätigen und DTMF-Töne senden ===<br />
* Den Anruf initiieren<br />
: <code>set <device> call <nummer> <dauer> <-tastenkombination></code><br />
* Die Tastenkombination muss mit einem Minus (-) nach der Zielnummer folgen, also z.B. **1 -#23<br />
* Der Angerufene nimmt das Gespräch entgegen, die Tonfolge wird abgespielt.<br />
<br />
=== Auf Anruf warten und DTMF-Töne empfangen ===<br />
* Der SIP-Client wird in den Listen-Modus versetzt.<br />
: Das Attribut sip_listen auf '''dtmf''' setzen und<br />
: <code>set <device> listen</code><br />
* Die Nebenstelle des SIP-Clients wird von einem DTMF-fähigen Telefon aus angerufen.<br />
* Wenn der SIP-Client das Gespräch angenommen hat, betätigt man '''#''', gefolgt von zwei Ziffern und legt dann wieder auf. Wichtig: Es müssen immer genau 3 Tasten betätigt werden (# und nm), damit das Reading dtmf gefüllt wird. n und m müssen zwei verschiedene Zahlen sein (0-9) oder ein Stern.<br />
* Im Reading '''dtmf''' ist diese zweistellige Zahl zu sehen und kann ggf. mit einem notify ausgewertet werden.<br />
<br />
=== Auf Anruf warten und kontrolliert annehmen ===<br />
* Der SIP-Client wird in den Listen-Modus versetzt.<br />
: Das Attribut sip_listen auf '''wfp''' setzen und<br />
: <code>set <device> listen</code><br />
* Die Nebenstelle des SIP-Clients wird angerufen.<br />
* Im Reading '''caller''' ist die Nummer bzw. die Info des Callers zu sehen, im '''caller_state''' erscheint 'ringing'.<br />
* Soll der Anruf angenommen werden setze ich den Status des Devices mittels set auf '''fetch''':<br />
: <code>set <device> fetch</code><br />
* Der SIP-Client nimmt den Anruf an und spielt das im Attribut sip_audiofile angegebene File ab.<br />
* Der SIP-Client legt auf und geht wieder in den Status '''listen_wfp'''.<br />
<br />
=== Fritzbox + Doorline - Telefonklingeln beenden ===<br />
Szenario: Als Türklingel ist eine Doorline im Einsatz die auf Direktannahme eingestellt ist. Klingelt jemand an der Tür, erfolgt ein 'Anruf' an die in der Rufgruppe definierten Telefone. Man kann den Anruf entgegennehmen, um zu hören wer an der Tür ist, bevor man die Tür öffnet. Geht man direkt zur Tür, klingeln die Telefone insgesamt 30 Sekunden lang bis sie verstummen. Hat man die Haustür mit einem Türkontakt versehen, hilft folgender Ansatz:<br />
* Der SIP-Client wird in der Fritzbox in die Rufgruppe der Türklingel aufgenommen.<br />
* Das Attribut 'sip_listen' wird auf 'wfp' gesetzt.<br />
* Der SIP-Client wird in den Listen-Modus 'wait-fetch-play' versetzt (Die sip_waittime sollte größer als die Klingeldauer der Doorline sein).<br />
: <code>set <device> listen</code><br />
* Klingelt jemand an der Tür, wird unter anderem die Nebenstelle des SIP-Clients angerufen.<br />
* Über ein DOIF greift man die Kombination SIP-Client caller_state 'ringing' und Haustürkontakt closed->open ab und<br />
* setzt den Status des Devices mittels set auf fetch:<br />
: <code>set <device> fetch</code><br />
* Der SIP-Client nimmt den Anruf an und spielt das im Attribut sip_audiofile angegebene File ab.<br />
* Die Telefone verstummen.<br />
<br />
In FHEM sieht das dann z.B. so aus:<br />
<br />
Es gibt ein Device '''HaustuerStatus''' das den Status des Türkontaktes abbildet: "closed" oder "open".<br />
<br />
Es wird ein Dummy-Device '''HaustuerStatusVar''' für die Status des Automaten angelegt:<br />
<br />
<code>define HaustuerStatusVar dummy</code><br />
<br />
Und ein DOIF '''TuerklingelAus''':<br />
<br />
<pre><br />
define TuerklingelAus DOIF <br />
(([HaustuerStatus:state] eq "closed") and ([FhemSipClient:caller_state] eq "ringing") and ([FhemSipClient:caller] eq "Klingel sip:**12\@fritz.box")) <br />
(set HaustuerStatusVar ringing;; set HM_4A4047_Mp3 playTone 001 1 10) <br />
DOELSEIF <br />
(([HaustuerStatus:state] eq "open") and ([HaustuerStatusVar:state] eq "ringing")) <br />
(set FhemSipClient fetch;; set HaustuerStatusVar on) <br />
DOELSEIF <br />
(([HaustuerStatus:state] eq "closed") and ([HaustuerStatusVar:state] ne "off")) <br />
(set HaustuerStatusVar off)<br />
</pre><br />
<br />
Der Caller "Klingel sip:**12\@fritz.box" setzt sich aus dem in der Fritzbox vergebenen Namen, der Nebenstelle (**12 ist eine Doorline mit einem Taster, bei zweien gilt es **11 und **12 zu beachten) sowie dem syntaktischen Drumherum sip:''nebenstelle''\@fritz.box zusammen. Achtet bitte auf den "\" vor dem "@", damit regex nicht mosert.<br />
<br />
HM_4A4047_Mp3 ist übrigens mein mobiler MP3-Tür-/Funkgong der zur Unterstützung einen Gong abspielt.<br />
<br />
== Bekannte Probleme / Fehlersuche ==<br />
=== Fehler bei der Registrierung an der Fritzbox ===<br />
'''Fritzbox'''<br />
* Ist das Device für den SIP-Client in der Fritzbox unter Telefonie > Telefoniegräte gelistet? <br />
* Geräteeinstellungen ändern: Ist für das Device unter 'Anmeldedaten' die Durchwahl als Benutzername angegeben?<br />
* Ist der in dieser Ansicht angegebene 'Registrar' mit der im Attribut sip_registrar identisch? Im Zweifelsfalle die IP-Adresse statt 'fritz.box' verwenden.<br />
* FitzOS ab 6.80: Wurde nach Definition des Gerätes an einem anderen bekannten Gerät der Bestätigungscode eingegeben?<br />
<br />
'''FHEM'''<br />
<br />
Wurde das Passwort mittels set <mydevice> password <meinpasswort> gesetzt?<br />
<br />
Attribute des Devices prüfen:<br />
* Ist unter sip_from <nowiki>'sip:620@fritz.box'</nowiki> die von der Fritzbox vergebene Durchwahl angegeben?<br />
* Ist unter sip_user die von der Fritzbox vergebene Durchwahl angegeben?<br />
* Ist unter sip_registrar die IP-Adresser der Fritzbox eingetragen?<br />
* Ist unter sip_ip die IP-Adresse des FHEM-Servers eingetragen (z.B. 192.168.178.47 angeben, keine Adresse aus dem 127er-Segment)?<br />
<br />
=== Erzeugung eines passenden Audiofiles ===<br />
<br />
Eine Alternative zu sox ist ffmpeg. Damit kann direkt von mp3 ins Zielformat konvertiert werden:<br />
<br />
ffmpeg -i meinfile.mp3 -f alaw -ar 8000 meinfile.alaw<br />
<br />
== Links ==<br />
* {{Link2Forum|Topic=40219|LinkText=Forenthread}} alter Forum-Thread zu FB_SIP.pm und SIP.pm<br />
* {{Link2Forum|Topic=67443|LinkText=Forenthread}} Forum-Thread zu diesem Modul SIP<br />
<br />
[[Kategorie:Hilfsmodul]] <br />
<!-- (Modulkategorie wird automatisch gesetzt) --></div>Wzuthttp://wiki.fhem.de/w/index.php?title=SIP-Client&diff=20743SIP-Client2017-03-15T19:01:49Z<p>Wzut: </p>
<hr />
<div>{{Infobox Modul<br />
|ModPurpose=SIP-Client für FHEM <br />
|ModType=h<br />
|ModCmdRef=SIP<br />
|ModForumArea=Sonstiges<br />
|ModTechName=96_SIP.pm<br />
|ModOwner=Wzut ({{Link2FU|1172|Forum}} / [[Benutzer Diskussion:Wzut|Wiki]])}}<br />
<br />
Das Modul '''SIP''' ermöglicht die Entgegennahme (DTMF-Töne interpretieren, kontrollierte Annahme) sowie die Durchführung (Audiofile abspielen, DTMF-Töne senden, Textansage) von Anrufen.<br />
<br />
<br />
== Voraussetzungen ==<br />
=== FHEM-Server ===<br />
Für den Remote-Zugang muss das Modul Net::SIP installiert sein; auf einem Raspberry Pi oder unter Ubuntu z.&nbsp;B. mit dem Befehl<br />
:<code>sudo cpanm install Net::SIP</code><br />
<br />
oder auch<br />
<br />
:<code>sudo apt-get install libnet-sip-perl</code><br />
<br />
==== Falls Ihr Text2Speech verwenden wollt ====<br />
<br />
Vorbereitung<br />
* SoX installieren <br />
:<code>sudo apt-get install sox </code><br />
* mp3 Unterstützung für SoX installieren<br />
:<code>sudo apt-get install libsox-fmt-mp3</code><br />
* Text2Speech als Server Device anlegen <br />
:<code>define <name z.B myT2S> text2speech none</code><br />
* beim SIP Device dieses Server Device im Attribut T2S_Device eintragen<br />
<br />
=== SIP-Server ===<br />
Der SIP-Client muss sich an einem SIP-Server anmelden (Fritzbox, Asterisk, VoIP-Provider). <br />
Auf dem SIP-Server, mit dem sich der Client verbinden soll, muss ein User-Account vorhanden sein bzw. angelegt werden. <br />
In der Fritzbox muss z.B. ein neues Telefoniegerät vom Typ LAN/WLAN angelegt und ein Passwort vergeben werden. Das erzeugt ein neues internes Device im internen Rufnummernbereich **62x, typischerweise die 620. Es sollte kontrolliert werden, ob bei den Anmeldeinformationen der Benutzername der Nebenstelle entspricht (z.B. 620) und ein Passwort eingetragen ist.<br />
<br />
=== Hardware ===<br />
Die verwendete Library Net::SIP fordert mehr Ressourcen als RaspberryPi, BananaPi & Co hergeben. Bitte testet, ob Eure Hardware Audofiles sauber abspielen sowie sicher DTMF-Töne empfangen kann und für Euren Einsatzzweck geeignet ist.<br />
<br />
== Installation ==<br />
=== Erste Schritte ===<br />
Spätestens nach einem 'update all' sollte das Modul '''96_SIP.pm''' verfügbar sein.<br />
<br />
Nun ist der SIP-Client als Device in FHEM anzulegen:<br />
<br />
:<code>define <name> SIP</code><br />
<br />
Anschließend sollten alle sip_Attribute geprüft und für die eigene Umgebung gesetzt werden. Ebenso ist das Passwort mittels set-Command zu speichern.<br />
<br />
=== Mögliche Fehlermeldungen ===<br />
Sollte schon bei <code>define mySIP SIP</code> die Fehlermeldung kommen, dass dieses Modul nicht existiert, dann bitte 'update all' durchführen.<br />
<br />
== Anwendung ==<br />
=== Define ===<br />
<br />
<code>define <name> SIP</code><br />
<br />
Anschließend sollten alle sip_Attribute geprüft und für die eigene Umgebung gesetzt werden.<br />
<br />
Siehe auch [http://fhem.de/commandref_DE.html#SIP commandref]<br />
<br />
=== Attribute ===<br />
<br />
''Basics & Allgemeines'' <br />
* '''sip_from'''<br />
: Meine SIP-Client-Info. Default ist <nowiki>sip:620@fritz.box</nowiki><br />
* '''sip_ip'''<br />
: Die IP-Addresse meines FHEM-Servers.<br />
* '''sip_port'''<br />
: Port der für den SIP-Client genutzt wird. Default ist 5060 und wird automatisch um 10 erhöht wenn der Port nicht frei ist.<br />
* '''sip_registrar'''<br />
: Hostname oder IP-Addresse des SIP-Servers mit dem sich der Client verbindet. Default ist fritz.box.<br />
* '''sip_user'''<br />
: User Name des SIP-Clients. Default ist 620. Anmerkung: Passwort wird über "set <device> password ''mypassword''" gesetzt.<br />
* '''sip_listen'''<br />
: Das Attribut bietet folgende Optionen<br />
: - '''none''': keine Aktion ('listen' kann auch nicht manuell gestartet werden)<br />
: - '''dtmf''': Beim FHEM-Start geht das Device automatisch in den Status listen und wartet auf DTMF-Anrufer (listen_for_dtmf). Alternativ kann der Prozess manuell via 'listen' gestartet werden.<br />
: - '''wfp''': Beim FHEM-Start geht das Device automatisch in den Status listen wait-fetch-play (listen_for_wfp). Alternativ kann der Prozess manuell via 'listen' gestartet werden.<br />
* '''sip_waittime'''<br />
: Maximale Wartezeit bei listen_for_wfp bis das Gespräch automatisch angenommen wird.<br />
* '''sip_ringtime'''<br />
: listen: legt fest wie lange das Modul warten soll bis es den Anruf annimmt. Defaultwert ist 2, das entspricht ca. 1x klingeln.<br />
: <br />
* Anmerkung zum '''Audioformat'''<br />
: Audiofiles müssen im alaw- oder ulaw-Format vorliegen und können mit folgendem Command erzeugt werden<br />
: '''sox <file>.wav -t raw -r 8000 -c 1 -e a-law <file>.alaw'''<br />
: da nur diese raw audio format unterstützt wird. Unterstützte/erkannte Endungen sind .alaw und .ulaw. Bitte darauf achten, dass das audiofile und der komplette Pfad die passenden Permissions hat, damit der FHEM User das File auch lesen darf.<br />
<br />
''DTMF empfangen''<br />
* '''sip_dtmf_loop'''<br />
: legt für den listen_for_dtmf-Modus fest wie oft ein DTMF Code eingeben werden soll ( once oder loop, default ist once ). <br />
: Bei 'once' erwartet der SIP-Cleint die Eingabe eines Codes in der angegebenen Länge und beendet den Anruf. <br />
: Bei 'loop' startet eine Endlosschleife aus Ansage->Code-Erfassung->Quittung->Loop bis der Anrufer irgendwann auflegt.<br />
* '''sip_dtmf_size'''<br />
: Die Anzahl der erwarteten DTMF-Töne im listen_for_dtmf-Modus (1 bis 4)<br />
* '''sip_audiofile_dtmf'''<br />
: Audiofile das dem Anrufer im listen_for_dtmf-Modus vorgespielt wird und ihn auffordert einen Code einzugeben. Ist kein File angegeben hört man ein Geräusch.<br />
* '''sip_audiofile_ok'''<br />
: Audiofile das dem Anrufer im listen_for_dtmf-Modus als Quittungston vorgespielt wird. <br />
<br />
''Auf anruf warten und annehmen''<br />
* '''sip_audiofile_wfp'''<br />
: Audiofile das nach dem Command '''fetch''' abgespielt wird. <br />
<br />
''Anrufen und DTMF senden''<br />
* '''sip_dtmf_send'''<br />
: Bestimmt die Übertragungsart der angegebenen DTMF-Töne und bietet folgende Möglichkeiten:<br />
: 'audio': Es werden Audiotöne übermittelt<br />
: 'rfc2833': Es erfolgt eine Übertragung nach RFC2833 (für das menschliche Ohr weniger ansprechend)<br />
<br />
''Anrufen und etwas senden''<br />
* '''sip_audiofile_call'''<br />
: Audiofile das dem angerufenen bei '''call''' vorgespielt wird. <br />
<br />
''Anrufen und etwas sagen''<br />
* '''T2S_Device'''<br />
: Name Eures in FHEM eingerichteten Text2Speech-Devices <br />
* '''T2S_Timeout'''<br />
: Timeout für die Text2Speech-Konvertierung (könnte ja sein, dass der TTS-Service im Internet überlastet ist)<br />
* '''audio_converter'''<br />
: Der für die Konvertierung zu verwendende (und vorab installierte) Audiokonverter. Auswahl: sox oder ffmpeg<br />
<br />
Siehe auch [http://fhem.de/commandref_DE.html#SIP commandref]<br />
<br />
=== Set ===<br />
<br />
Das Modul kennt derzeit folgende Commands<br />
<br />
* set <name> '''password'''<br />
: Passwort für den User sip_user hinterlegen.<br />
<br />
* set <name> '''reset'''<br />
<br />
: Stoppt laufende listen-Prozess und initalisiert das Device.<br />
<br />
* set <name> '''call <nummer> [<ringtime>] [<nachricht>]'''<br />
: Startet einen Anruf an die angegebene Nummer.<br />
: Optional kann die ringtime angegeben werden. Wird keine angegeben zieht das Attribut sip_ringtime. Default ist 10.<br />
: Optional kann eine Nachricht <br />
: * in Form eines Audiofiles angegeben werden. Das File ist mit dem vollen Pfad oder dem relativen ab dem Verzeichnis mit fhem.pl anzugeben. Bitte darauf achten, dass das audiofile und der Pfad dort hin passende Permissions hat, damit FHEM das File auch lesen darf. Die ringtime ist in dem Fall nicht optional sondern anzugeben.<br />
: * als DTMF-Sequenz angegeben werden. Diese mit einem Prefix '-' versehen werden, also z.B. '''-'''#47.<br />
: * als Text angegeben werden. Dieser mit einem Prefix '!' versehen werden, also z.B. '''!'''Hier spricht dein FHEM.<br />
: Bitte hierfür unter 'Voraussetzungen' den Hinweis auf TTS beachten.<br />
<br />
* set <name> '''listen'''<br />
: Manueller Start des listen-Prozesses. Setzt voraus, dass die Variable sip_listen auf dtmf oder wfp gesetzt ist:<br />
: '''dtmf''': Der SIP-Client wird in einen Status versetzt in dem er automatisch Anrufe annimmt. Bei einem Anruf wird im Reading 'caller' die Nummer bzw. Id des Anrufers angezeigt. Dem Anrufer wird der eigene Ton als Echo zurückgespielt. Über die Eingabe von '''#''' gefolgt von 2 Zahlen und anschließendem Auflegen kann eine Zahl an das Reading '''dtmf''' übergeben werden. Voraussetzung: Das anrufende Telefon ist auf Tonwahl gestellt (DTMF).<br />
: '''wfp''': Der SIP-Client wird in einen Status versetzt in dem er auf Anrufe wartet (wfp steht für wait-fetch-play). Erfolgt ein Anruf an den Client, wechselt das Reading 'caller_state' zu 'ringing', im Reading 'caller' wird die Nummer bzw. Id des Anrufers angezeigt. Nun kann das Gespräch via set-Command 'fetch' angenommen werden. Das als sip_audiofile angegebene File wird abgespielt. Anschließend wechselt der Status wieder zu listen_for_wfp.<br />
<br />
=== Readings ===<br />
<br />
<br />
* '''call''': Die Rufnummer des ausgehenden Anrufs. <br />
* '''call_state''': Status für ausgehende Anrufe. <br />
* '''caller''': Die Rufnummer bzw. Info des aktuellen Anrufers. <br />
* '''caller_state''': Status für eingehende Anrufe. <br />
* '''dtmf''': Die via Tonwahl (DTMF) eingegebenen Zahlen.<br />
* '''state''': Der Status des Devices.<br />
<br />
== Anwendungsbeispiele ==<br />
<br />
=== Anruf tätigen und Sound abspielen ===<br />
* Den Anruf initiieren<br />
<code>set <device> call <nummer> [<dauer>] [<audiofile oder Textnachricht>]</code><br />
<code>set mySip call 081547111 30 ./tada.alaw</code><br />
<code>set mySip call 081547111 30 !Hier ist dein FHEM Server</code><br />
* Die Default-Dauer beträgt 30 Sekunden.<br />
* Wird kein Audiofile angegeben, wird nur die Verbindung hergestellt und nach der Anrufdauer wieder unterbrochen.<br />
* Anmerkung: Das Audiofile muss das Format PCM/8000 haben.<br />
* Der Angerufene nimmt das Gespräch entgegen, das Audiofile wird abgespielt.<br />
<br />
=== Anruf tätigen und DTMF-Töne senden ===<br />
* Den Anruf initiieren<br />
: <code>set <device> call <nummer> <dauer> <-tastenkombination></code><br />
* Die Tastenkombination muss mit einem Minus (-) nach der Zielnummer folgen, also z.B. **1 -#23<br />
* Der Angerufene nimmt das Gespräch entgegen, die Tonfolge wird abgespielt.<br />
<br />
=== Auf Anruf warten und DTMF-Töne empfangen ===<br />
* Der SIP-Client wird in den Listen-Modus versetzt.<br />
: Das Attribut sip_listen auf '''dtmf''' setzen und<br />
: <code>set <device> listen</code><br />
* Die Nebenstelle des SIP-Clients wird von einem DTMF-fähigen Telefon aus angerufen.<br />
* Wenn der SIP-Client das Gespräch angenommen hat, betätigt man '''#''', gefolgt von zwei Ziffern und legt dann wieder auf. Wichtig: Es müssen immer genau 3 Tasten betätigt werden (# und nm), damit das Reading dtmf gefüllt wird. n und m müssen zwei verschiedene Zahlen sein (0-9) oder ein Stern.<br />
* Im Reading '''dtmf''' ist diese zweistellige Zahl zu sehen und kann ggf. mit einem notify ausgewertet werden.<br />
<br />
=== Auf Anruf warten und kontrolliert annehmen ===<br />
* Der SIP-Client wird in den Listen-Modus versetzt.<br />
: Das Attribut sip_listen auf '''wfp''' setzen und<br />
: <code>set <device> listen</code><br />
* Die Nebenstelle des SIP-Clients wird angerufen.<br />
* Im Reading '''caller''' ist die Nummer bzw. die Info des Callers zu sehen, im '''caller_state''' erscheint 'ringing'.<br />
* Soll der Anruf angenommen werden setze ich den Status des Devices mittels set auf '''fetch''':<br />
: <code>set <device> fetch</code><br />
* Der SIP-Client nimmt den Anruf an und spielt das im Attribut sip_audiofile angegebene File ab.<br />
* Der SIP-Client legt auf und geht wieder in den Status '''listen_for_wfp'''.<br />
<br />
=== Fritzbox + Doorline - Telefonklingeln beenden ===<br />
Szenario: Als Türklingel ist eine Doorline im Einsatz die auf Direktannahme eingestellt ist. Klingelt jemand an der Tür, erfolgt ein 'Anruf' an die in der Rufgruppe definierten Telefone. Man kann den Anruf entgegennehmen, um zu hören wer an der Tür ist, bevor man die Tür öffnet. Geht man direkt zur Tür, klingeln die Telefone insgesamt 30 Sekunden lang bis sie verstummen. Hat man die Haustür mit einem Türkontakt versehen, hilft folgender Ansatz:<br />
* Der SIP-Client wird in der Fritzbox in die Rufgruppe der Türklingel aufgenommen.<br />
* Das Attribut 'sip_listen' wird auf 'wfp' gesetzt.<br />
* Der SIP-Client wird in den Listen-Modus 'wait-fetch-play' versetzt (Die sip_waittime sollte größer als die Klingeldauer der Doorline sein).<br />
: <code>set <device> listen</code><br />
* Klingelt jemand an der Tür, wird unter anderem die Nebenstelle des SIP-Clients angerufen.<br />
* Über ein DOIF greift man die Kombination SIP-Client caller_state 'ringing' und Haustürkontakt closed->open ab und<br />
* setzt den Status des Devices mittels set auf fetch:<br />
: <code>set <device> fetch</code><br />
* Der SIP-Client nimmt den Anruf an und spielt das im Attribut sip_audiofile angegebene File ab.<br />
* Die Telefone verstummen.<br />
<br />
In FHEM sieht das dann z.B. so aus:<br />
<br />
Es gibt ein Device '''HaustuerStatus''' das den Status des Türkontaktes abbildet: "closed" oder "open".<br />
<br />
Es wird ein Dummy-Device '''HaustuerStatusVar''' für die Status des Automaten angelegt:<br />
<br />
<code>define HaustuerStatusVar dummy</code><br />
<br />
Und ein DOIF '''TuerklingelAus''':<br />
<br />
<pre><br />
define TuerklingelAus DOIF <br />
(([HaustuerStatus:state] eq "closed") and ([FhemSipClient:caller_state] eq "ringing") and ([FhemSipClient:caller] eq "Klingel sip:**12\@fritz.box")) <br />
(set HaustuerStatusVar ringing;; set HM_4A4047_Mp3 playTone 001 1 10) <br />
DOELSEIF <br />
(([HaustuerStatus:state] eq "open") and ([HaustuerStatusVar:state] eq "ringing")) <br />
(set FhemSipClient fetch;; set HaustuerStatusVar on) <br />
DOELSEIF <br />
(([HaustuerStatus:state] eq "closed") and ([HaustuerStatusVar:state] ne "off")) <br />
(set HaustuerStatusVar off)<br />
</pre><br />
<br />
Der Caller "Klingel sip:**12\@fritz.box" setzt sich aus dem in der Fritzbox vergebenen Namen, der Nebenstelle (**12 ist eine Doorline mit einem Taster, bei zweien gilt es **11 und **12 zu beachten) sowie dem syntaktischen Drumherum sip:''nebenstelle''\@fritz.box zusammen. Achtet bitte auf den "\" vor dem "@", damit regex nicht mosert.<br />
<br />
HM_4A4047_Mp3 ist übrigens mein mobiler MP3-Tür-/Funkgong der zur Unterstützung einen Gong abspielt.<br />
<br />
== Bekannte Probleme / Fehlersuche ==<br />
=== Fehler bei der Registrierung an der Fritzbox ===<br />
'''Fritzbox'''<br />
* Ist das Device für den SIP-Client in der Fritzbox unter Telefonie > Telefoniegräte gelistet? <br />
* Geräteeinstellungen ändern: Ist für das Device unter 'Anmeldedaten' die Durchwahl als Benutzername angegeben?<br />
* Ist der in dieser Ansicht angegebene 'Registrar' mit der im Attribut sip_registrar identisch? Im Zweifelsfalle die IP-Adresse statt 'fritz.box' verwenden.<br />
* FitzOS ab 6.80: Wurde nach Definition des Gerätes an einem anderen bekannten Gerät der Bestätigungscode eingegeben?<br />
<br />
'''FHEM'''<br />
<br />
Wurde das Passwort mittels set <mydevice> password <meinpasswort> gesetzt?<br />
<br />
Attribute des Devices prüfen:<br />
* Ist unter sip_from <nowiki>'sip:620@fritz.box'</nowiki> die von der Fritzbox vergebene Durchwahl angegeben?<br />
* Ist unter sip_user die von der Fritzbox vergebene Durchwahl angegeben?<br />
* Ist unter sip_registrar die IP-Adresser der Fritzbox eingetragen?<br />
* Ist unter sip_ip die IP-Adresse des FHEM-Servers eingetragen (z.B. 192.168.178.47 angeben, keine Adresse aus dem 127er-Segment)?<br />
<br />
=== Erzeugung eines passenden Audiofiles ===<br />
<br />
Eine Alternative zu sox ist ffmpeg. Damit kann direkt von mp3 ins Zielformat konvertiert werden:<br />
<br />
ffmpeg -i meinfile.mp3 -f alaw -ar 8000 meinfile.alaw<br />
<br />
== Links ==<br />
* {{Link2Forum|Topic=40219|LinkText=Forenthread}} alter Forum-Thread zu FB_SIP.pm und SIP.pm<br />
* {{Link2Forum|Topic=67443|LinkText=Forenthread}} Forum-Thread zu diesem Modul SIP<br />
<br />
[[Kategorie:Hilfsmodul]] <br />
<!-- (Modulkategorie wird automatisch gesetzt) --></div>Wzuthttp://wiki.fhem.de/w/index.php?title=SIP-Client&diff=20742SIP-Client2017-03-15T19:00:33Z<p>Wzut: /* Anruf tätigen und Sound abspielen */</p>
<hr />
<div>{{Infobox Modul<br />
|ModPurpose=SIP-Client für FHEM <br />
|ModType=h<br />
|ModCmdRef=SIP<br />
|ModForumArea=Sonstiges<br />
|ModTechName=96_SIP.pm<br />
|ModOwner=Wzut ({{Link2FU|1172|Forum}} / [[Benutzer Diskussion:Wzut|Wiki]])}}<br />
<br />
Das Modul '''SIP''' ermöglicht die Entgegennahme (DTMF-Töne interpretieren, kontrollierte Annahme) sowie die Durchführung (Audiofile abspielen, DTMF-Töne senden, Textansage) von Anrufen.<br />
<br />
<br />
== Voraussetzungen ==<br />
=== FHEM-Server ===<br />
Für den Remote-Zugang muss das Modul Net::SIP installiert sein; auf einem Raspberry Pi oder unter Ubuntu z.&nbsp;B. mit dem Befehl<br />
:<code>sudo cpanm install Net::SIP</code><br />
<br />
oder auch<br />
<br />
:<code>sudo apt-get install libnet-sip-perl</code><br />
<br />
==== Falls Ihr Text2Speech verwenden wollt ====<br />
<br />
Vorbereitung<br />
* SoX installieren <br />
:<code>sudo apt-get install sox </code><br />
* mp3 Unterstützung für SoX installieren<br />
:<code>sudo apt-get install libsox-fmt-mp3</code><br />
* Text2Speech als Server Device anlegen <br />
:<code>define <name z.B myT2S> text2speech none</code><br />
* beim SIP Device dieses Server Device im Attribut T2S_Device eintragen<br />
<br />
=== SIP-Server ===<br />
Der SIP-Client muss sich an einem SIP-Server anmelden (Fritzbox, Asterisk, VoIP-Provider). <br />
Auf dem SIP-Server, mit dem sich der Client verbinden soll, muss ein User-Account vorhanden sein bzw. angelegt werden. <br />
In der Fritzbox muss z.B. ein neues Telefoniegerät vom Typ LAN/WLAN angelegt und ein Passwort vergeben werden. Das erzeugt ein neues internes Device im internen Rufnummernbereich **62x, typischerweise die 620. Es sollte kontrolliert werden, ob bei den Anmeldeinformationen der Benutzername der Nebenstelle entspricht (z.B. 620) und ein Passwort eingetragen ist.<br />
<br />
=== Hardware ===<br />
Die verwendete Library Net::SIP fordert mehr Ressourcen als RaspberryPi, BananaPi & Co hergeben. Bitte testet, ob Eure Hardware Audofiles sauber abspielen sowie sicher DTMF-Töne empfangen kann und für Euren Einsatzzweck geeignet ist.<br />
<br />
== Installation ==<br />
=== Erste Schritte ===<br />
Spätestens nach einem 'update all' sollte das Modul '''96_SIP.pm''' verfügbar sein.<br />
<br />
Nun ist der SIP-Client als Device in FHEM anzulegen:<br />
<br />
:<code>define <name> SIP</code><br />
<br />
Anschließend sollten alle sip_Attribute geprüft und für die eigene Umgebung gesetzt werden. Ebenso ist das Passwort mittels set-Command zu speichern.<br />
<br />
=== Mögliche Fehlermeldungen ===<br />
Sollte schon bei <code>define mySIP SIP</code> die Fehlermeldung kommen, dass dieses Modul nicht existiert, dann bitte 'update all' durchführen.<br />
<br />
== Anwendung ==<br />
=== Define ===<br />
<br />
<code>define <name> SIP</code><br />
<br />
Anschließend sollten alle sip_Attribute geprüft und für die eigene Umgebung gesetzt werden.<br />
<br />
Siehe auch [http://fhem.de/commandref_DE.html#SIP commandref]<br />
<br />
=== Attribute ===<br />
<br />
''Basics & Allgemeines'' <br />
* '''sip_from'''<br />
: Meine SIP-Client-Info. Default ist <nowiki>sip:620@fritz.box</nowiki><br />
* '''sip_ip'''<br />
: Die IP-Addresse meines FHEM-Servers.<br />
* '''sip_port'''<br />
: Port der für den SIP-Client genutzt wird. Default ist 5060 und wird automatisch um 10 erhöht wenn der Port nicht frei ist.<br />
* '''sip_registrar'''<br />
: Hostname oder IP-Addresse des SIP-Servers mit dem sich der Client verbindet. Default ist fritz.box.<br />
* '''sip_user'''<br />
: User Name des SIP-Clients. Default ist 620. Anmerkung: Passwort wird über "set <device> password ''mypassword''" gesetzt.<br />
* '''sip_listen'''<br />
: Das Attribut bietet folgende Optionen<br />
: - '''none''': keine Aktion ('listen' kann auch nicht manuell gestartet werden)<br />
: - '''dtmf''': Beim FHEM-Start geht das Device automatisch in den Status listen und wartet auf DTMF-Anrufer (listen_for_dtmf). Alternativ kann der Prozess manuell via 'listen' gestartet werden.<br />
: - '''wfp''': Beim FHEM-Start geht das Device automatisch in den Status listen wait-fetch-play (listen_for_wfp). Alternativ kann der Prozess manuell via 'listen' gestartet werden.<br />
* '''sip_waittime'''<br />
: Maximale Wartezeit bei listen_for_wfp bis das Gespräch automatisch angenommen wird.<br />
* '''sip_ringtime'''<br />
: listen: legt fest wie lange das Modul warten soll bis es den Anruf annimmt. Defaultwert ist 2, das entspricht ca. 1x klingeln.<br />
: <br />
* Anmerkung zum '''Audioformat'''<br />
: Audiofiles müssen im alaw- oder ulaw-Format vorliegen und können mit folgendem Command erzeugt werden<br />
: '''sox <file>.wav -t raw -r 8000 -c 1 -e a-law <file>.alaw'''<br />
: da nur diese raw audio format unterstützt wird. Unterstützte/erkannte Endungen sind .alaw und .ulaw. Bitte darauf achten, dass das audiofile und der komplette Pfad die passenden Permissions hat, damit der FHEM User das File auch lesen darf.<br />
<br />
''DTMF empfangen''<br />
* '''sip_dtmf_loop'''<br />
: legt für den listen_for_dtmf-Modus fest wie oft ein DTMF Code eingeben werden soll ( once oder loop, default ist once ). <br />
: Bei 'once' erwartet der SIP-Cleint die Eingabe eines Codes in der angegebenen Länge und beendet den Anruf. <br />
: Bei 'loop' startet eine Endlosschleife aus Ansage->Code-Erfassung->Quittung->Loop bis der Anrufer irgendwann auflegt.<br />
* '''sip_dtmf_size'''<br />
: Die Anzahl der erwarteten DTMF-Töne im listen_for_dtmf-Modus (1 bis 4)<br />
* '''sip_audiofile_dtmf'''<br />
: Audiofile das dem Anrufer im listen_for_dtmf-Modus vorgespielt wird und ihn auffordert einen Code einzugeben. Ist kein File angegeben hört man ein Geräusch.<br />
* '''sip_audiofile_ok'''<br />
: Audiofile das dem Anrufer im listen_for_dtmf-Modus als Quittungston vorgespielt wird. <br />
<br />
''Auf anruf warten und annehmen''<br />
* '''sip_audiofile_wfp'''<br />
: Audiofile das nach dem Command '''fetch''' abgespielt wird. <br />
<br />
''Anrufen und DTMF senden''<br />
* '''sip_dtmf_send'''<br />
: Bestimmt die Übertragungsart der angegebenen DTMF-Töne und bietet folgende Möglichkeiten:<br />
: 'audio': Es werden Audiotöne übermittelt<br />
: 'rfc2833': Es erfolgt eine Übertragung nach RFC2833 (für das menschliche Ohr weniger ansprechend)<br />
<br />
''Anrufen und etwas senden''<br />
* '''sip_audiofile_call'''<br />
: Audiofile das dem angerufenen bei '''call''' vorgespielt wird. <br />
<br />
''Anrufen und etwas sagen''<br />
* '''T2S_Device'''<br />
: Name Eures in FHEM eingerichteten Text2Speech-Devices <br />
* '''T2S_Timeout'''<br />
: Timeout für die Text2Speech-Konvertierung (könnte ja sein, dass der TTS-Service im Internet überlastet ist)<br />
* '''audio_converter'''<br />
: Der für die Konvertierung zu verwendende (und vorab installierte) Audiokonverter. Auswahl: sox oder ffmpeg<br />
<br />
Siehe auch [http://fhem.de/commandref_DE.html#SIP commandref]<br />
<br />
=== Set ===<br />
<br />
Das Modul kennt derzeit folgende Commands<br />
<br />
* set <name> '''password'''<br />
: Passwort für den User sip_user hinterlegen.<br />
<br />
* set <name> '''reset'''<br />
<br />
: Stoppt laufende listen-Prozess und initalisiert das Device.<br />
<br />
* set <name> '''call <nummer> [<ringtime>] [<nachricht>]'''<br />
: Startet einen Anruf an die angegebene Nummer.<br />
: Optional kann die ringtime angegeben werden. Wird keine angegeben zieht das Attribut sip_ringtime. Default ist 10.<br />
: Optional kann eine Nachricht <br />
: * in Form eines Audiofiles angegeben werden. Das File ist mit dem vollen Pfad oder dem relativen ab dem Verzeichnis mit fhem.pl anzugeben. Bitte darauf achten, dass das audiofile und der Pfad dort hin passende Permissions hat, damit FHEM das File auch lesen darf. Die ringtime ist in dem Fall nicht optional sondern anzugeben.<br />
: * als DTMF-Sequenz angegeben werden. Diese mit einem Prefix '-' versehen werden, also z.B. '''-'''#47.<br />
: * als Text angegeben werden. Dieser mit einem Prefix '!' versehen werden, also z.B. '''!'''Hier spricht dein FHEM.<br />
: Bitte hierfür unter 'Voraussetzungen' den Hinweis auf TTS beachten.<br />
<br />
* set <name> '''listen'''<br />
: Manueller Start des listen-Prozesses. Setzt voraus, dass die Variable sip_listen auf dtmf oder wfp gesetzt ist:<br />
: '''dtmf''': Der SIP-Client wird in einen Status versetzt in dem er automatisch Anrufe annimmt. Bei einem Anruf wird im Reading 'caller' die Nummer bzw. Id des Anrufers angezeigt. Dem Anrufer wird der eigene Ton als Echo zurückgespielt. Über die Eingabe von '''#''' gefolgt von 2 Zahlen und anschließendem Auflegen kann eine Zahl an das Reading '''dtmf''' übergeben werden. Voraussetzung: Das anrufende Telefon ist auf Tonwahl gestellt (DTMF).<br />
: '''wfp''': Der SIP-Client wird in einen Status versetzt in dem er auf Anrufe wartet (wfp steht für wait-fetch-play). Erfolgt ein Anruf an den Client, wechselt das Reading 'caller_state' zu 'ringing', im Reading 'caller' wird die Nummer bzw. Id des Anrufers angezeigt. Nun kann das Gespräch via set-Command 'fetch' angenommen werden. Das als sip_audiofile angegebene File wird abgespielt. Anschließend wechselt der Status wieder zu listen_for_wfp.<br />
<br />
=== Readings ===<br />
<br />
<br />
* '''call''': Die Rufnummer des ausgehenden Anrufs. <br />
* '''call_state''': Status für ausgehende Anrufe. <br />
* '''caller''': Die Rufnummer bzw. Info des aktuellen Anrufers. <br />
* '''caller_state''': Status für eingehende Anrufe. <br />
* '''dtmf''': Die via Tonwahl (DTMF) eingegebenen Zahlen.<br />
* '''state''': Der Status des Devices.<br />
<br />
== Anwendungsbeispiele ==<br />
<br />
=== Anruf tätigen und Sound abspielen ===<br />
* Den Anruf initiieren<br />
<code>set <device> call <nummer> [<dauer>] [<audiofile oder Textnachricht>]</code><br />
<code>set mySip call 081547111 30 ./tada.alaw</code><br />
<code>set mySip call 081547111 30 !Hier ist dein FHEM Server/code><br />
* Die Default-Dauer beträgt 30 Sekunden.<br />
* Wird kein Audiofile angegeben, wird nur die Verbindung hergestellt und nach der Anrufdauer wieder unterbrochen.<br />
* Anmerkung: Das Audiofile muss das Format PCM/8000 haben.<br />
* Der Angerufene nimmt das Gespräch entgegen, das Audiofile wird abgespielt.<br />
<br />
=== Anruf tätigen und DTMF-Töne senden ===<br />
* Den Anruf initiieren<br />
: <code>set <device> call <nummer> <dauer> <-tastenkombination></code><br />
* Die Tastenkombination muss mit einem Minus (-) nach der Zielnummer folgen, also z.B. **1 -#23<br />
* Der Angerufene nimmt das Gespräch entgegen, die Tonfolge wird abgespielt.<br />
<br />
=== Auf Anruf warten und DTMF-Töne empfangen ===<br />
* Der SIP-Client wird in den Listen-Modus versetzt.<br />
: Das Attribut sip_listen auf '''dtmf''' setzen und<br />
: <code>set <device> listen</code><br />
* Die Nebenstelle des SIP-Clients wird von einem DTMF-fähigen Telefon aus angerufen.<br />
* Wenn der SIP-Client das Gespräch angenommen hat, betätigt man '''#''', gefolgt von zwei Ziffern und legt dann wieder auf. Wichtig: Es müssen immer genau 3 Tasten betätigt werden (# und nm), damit das Reading dtmf gefüllt wird. n und m müssen zwei verschiedene Zahlen sein (0-9) oder ein Stern.<br />
* Im Reading '''dtmf''' ist diese zweistellige Zahl zu sehen und kann ggf. mit einem notify ausgewertet werden.<br />
<br />
=== Auf Anruf warten und kontrolliert annehmen ===<br />
* Der SIP-Client wird in den Listen-Modus versetzt.<br />
: Das Attribut sip_listen auf '''wfp''' setzen und<br />
: <code>set <device> listen</code><br />
* Die Nebenstelle des SIP-Clients wird angerufen.<br />
* Im Reading '''caller''' ist die Nummer bzw. die Info des Callers zu sehen, im '''caller_state''' erscheint 'ringing'.<br />
* Soll der Anruf angenommen werden setze ich den Status des Devices mittels set auf '''fetch''':<br />
: <code>set <device> fetch</code><br />
* Der SIP-Client nimmt den Anruf an und spielt das im Attribut sip_audiofile angegebene File ab.<br />
* Der SIP-Client legt auf und geht wieder in den Status '''listen_for_wfp'''.<br />
<br />
=== Fritzbox + Doorline - Telefonklingeln beenden ===<br />
Szenario: Als Türklingel ist eine Doorline im Einsatz die auf Direktannahme eingestellt ist. Klingelt jemand an der Tür, erfolgt ein 'Anruf' an die in der Rufgruppe definierten Telefone. Man kann den Anruf entgegennehmen, um zu hören wer an der Tür ist, bevor man die Tür öffnet. Geht man direkt zur Tür, klingeln die Telefone insgesamt 30 Sekunden lang bis sie verstummen. Hat man die Haustür mit einem Türkontakt versehen, hilft folgender Ansatz:<br />
* Der SIP-Client wird in der Fritzbox in die Rufgruppe der Türklingel aufgenommen.<br />
* Das Attribut 'sip_listen' wird auf 'wfp' gesetzt.<br />
* Der SIP-Client wird in den Listen-Modus 'wait-fetch-play' versetzt (Die sip_waittime sollte größer als die Klingeldauer der Doorline sein).<br />
: <code>set <device> listen</code><br />
* Klingelt jemand an der Tür, wird unter anderem die Nebenstelle des SIP-Clients angerufen.<br />
* Über ein DOIF greift man die Kombination SIP-Client caller_state 'ringing' und Haustürkontakt closed->open ab und<br />
* setzt den Status des Devices mittels set auf fetch:<br />
: <code>set <device> fetch</code><br />
* Der SIP-Client nimmt den Anruf an und spielt das im Attribut sip_audiofile angegebene File ab.<br />
* Die Telefone verstummen.<br />
<br />
In FHEM sieht das dann z.B. so aus:<br />
<br />
Es gibt ein Device '''HaustuerStatus''' das den Status des Türkontaktes abbildet: "closed" oder "open".<br />
<br />
Es wird ein Dummy-Device '''HaustuerStatusVar''' für die Status des Automaten angelegt:<br />
<br />
<code>define HaustuerStatusVar dummy</code><br />
<br />
Und ein DOIF '''TuerklingelAus''':<br />
<br />
<pre><br />
define TuerklingelAus DOIF <br />
(([HaustuerStatus:state] eq "closed") and ([FhemSipClient:caller_state] eq "ringing") and ([FhemSipClient:caller] eq "Klingel sip:**12\@fritz.box")) <br />
(set HaustuerStatusVar ringing;; set HM_4A4047_Mp3 playTone 001 1 10) <br />
DOELSEIF <br />
(([HaustuerStatus:state] eq "open") and ([HaustuerStatusVar:state] eq "ringing")) <br />
(set FhemSipClient fetch;; set HaustuerStatusVar on) <br />
DOELSEIF <br />
(([HaustuerStatus:state] eq "closed") and ([HaustuerStatusVar:state] ne "off")) <br />
(set HaustuerStatusVar off)<br />
</pre><br />
<br />
Der Caller "Klingel sip:**12\@fritz.box" setzt sich aus dem in der Fritzbox vergebenen Namen, der Nebenstelle (**12 ist eine Doorline mit einem Taster, bei zweien gilt es **11 und **12 zu beachten) sowie dem syntaktischen Drumherum sip:''nebenstelle''\@fritz.box zusammen. Achtet bitte auf den "\" vor dem "@", damit regex nicht mosert.<br />
<br />
HM_4A4047_Mp3 ist übrigens mein mobiler MP3-Tür-/Funkgong der zur Unterstützung einen Gong abspielt.<br />
<br />
== Bekannte Probleme / Fehlersuche ==<br />
=== Fehler bei der Registrierung an der Fritzbox ===<br />
'''Fritzbox'''<br />
* Ist das Device für den SIP-Client in der Fritzbox unter Telefonie > Telefoniegräte gelistet? <br />
* Geräteeinstellungen ändern: Ist für das Device unter 'Anmeldedaten' die Durchwahl als Benutzername angegeben?<br />
* Ist der in dieser Ansicht angegebene 'Registrar' mit der im Attribut sip_registrar identisch? Im Zweifelsfalle die IP-Adresse statt 'fritz.box' verwenden.<br />
* FitzOS ab 6.80: Wurde nach Definition des Gerätes an einem anderen bekannten Gerät der Bestätigungscode eingegeben?<br />
<br />
'''FHEM'''<br />
<br />
Wurde das Passwort mittels set <mydevice> password <meinpasswort> gesetzt?<br />
<br />
Attribute des Devices prüfen:<br />
* Ist unter sip_from <nowiki>'sip:620@fritz.box'</nowiki> die von der Fritzbox vergebene Durchwahl angegeben?<br />
* Ist unter sip_user die von der Fritzbox vergebene Durchwahl angegeben?<br />
* Ist unter sip_registrar die IP-Adresser der Fritzbox eingetragen?<br />
* Ist unter sip_ip die IP-Adresse des FHEM-Servers eingetragen (z.B. 192.168.178.47 angeben, keine Adresse aus dem 127er-Segment)?<br />
<br />
=== Erzeugung eines passenden Audiofiles ===<br />
<br />
Eine Alternative zu sox ist ffmpeg. Damit kann direkt von mp3 ins Zielformat konvertiert werden:<br />
<br />
ffmpeg -i meinfile.mp3 -f alaw -ar 8000 meinfile.alaw<br />
<br />
== Links ==<br />
* {{Link2Forum|Topic=40219|LinkText=Forenthread}} alter Forum-Thread zu FB_SIP.pm und SIP.pm<br />
* {{Link2Forum|Topic=67443|LinkText=Forenthread}} Forum-Thread zu diesem Modul SIP<br />
<br />
[[Kategorie:Hilfsmodul]] <br />
<!-- (Modulkategorie wird automatisch gesetzt) --></div>Wzuthttp://wiki.fhem.de/w/index.php?title=SIP-Client&diff=20741SIP-Client2017-03-15T18:53:26Z<p>Wzut: </p>
<hr />
<div>{{Infobox Modul<br />
|ModPurpose=SIP-Client für FHEM <br />
|ModType=h<br />
|ModCmdRef=SIP<br />
|ModForumArea=Sonstiges<br />
|ModTechName=96_SIP.pm<br />
|ModOwner=Wzut ({{Link2FU|1172|Forum}} / [[Benutzer Diskussion:Wzut|Wiki]])}}<br />
<br />
Das Modul '''SIP''' ermöglicht die Entgegennahme (DTMF-Töne interpretieren, kontrollierte Annahme) sowie die Durchführung (Audiofile abspielen, DTMF-Töne senden, Textansage) von Anrufen.<br />
<br />
<br />
== Voraussetzungen ==<br />
=== FHEM-Server ===<br />
Für den Remote-Zugang muss das Modul Net::SIP installiert sein; auf einem Raspberry Pi oder unter Ubuntu z.&nbsp;B. mit dem Befehl<br />
:<code>sudo cpanm install Net::SIP</code><br />
<br />
oder auch<br />
<br />
:<code>sudo apt-get install libnet-sip-perl</code><br />
<br />
==== Falls Ihr Text2Speech verwenden wollt ====<br />
<br />
Vorbereitung<br />
* SoX installieren <br />
:<code>sudo apt-get install sox </code><br />
* mp3 Unterstützung für SoX installieren<br />
:<code>sudo apt-get install libsox-fmt-mp3</code><br />
* Text2Speech als Server Device anlegen <br />
:<code>define <name z.B myT2S> text2speech none</code><br />
* beim SIP Device dieses Server Device im Attribut T2S_Device eintragen<br />
<br />
=== SIP-Server ===<br />
Der SIP-Client muss sich an einem SIP-Server anmelden (Fritzbox, Asterisk, VoIP-Provider). <br />
Auf dem SIP-Server, mit dem sich der Client verbinden soll, muss ein User-Account vorhanden sein bzw. angelegt werden. <br />
In der Fritzbox muss z.B. ein neues Telefoniegerät vom Typ LAN/WLAN angelegt und ein Passwort vergeben werden. Das erzeugt ein neues internes Device im internen Rufnummernbereich **62x, typischerweise die 620. Es sollte kontrolliert werden, ob bei den Anmeldeinformationen der Benutzername der Nebenstelle entspricht (z.B. 620) und ein Passwort eingetragen ist.<br />
<br />
=== Hardware ===<br />
Die verwendete Library Net::SIP fordert mehr Ressourcen als RaspberryPi, BananaPi & Co hergeben. Bitte testet, ob Eure Hardware Audofiles sauber abspielen sowie sicher DTMF-Töne empfangen kann und für Euren Einsatzzweck geeignet ist.<br />
<br />
== Installation ==<br />
=== Erste Schritte ===<br />
Spätestens nach einem 'update all' sollte das Modul '''96_SIP.pm''' verfügbar sein.<br />
<br />
Nun ist der SIP-Client als Device in FHEM anzulegen:<br />
<br />
:<code>define <name> SIP</code><br />
<br />
Anschließend sollten alle sip_Attribute geprüft und für die eigene Umgebung gesetzt werden. Ebenso ist das Passwort mittels set-Command zu speichern.<br />
<br />
=== Mögliche Fehlermeldungen ===<br />
Sollte schon bei <code>define mySIP SIP</code> die Fehlermeldung kommen, dass dieses Modul nicht existiert, dann bitte 'update all' durchführen.<br />
<br />
== Anwendung ==<br />
=== Define ===<br />
<br />
<code>define <name> SIP</code><br />
<br />
Anschließend sollten alle sip_Attribute geprüft und für die eigene Umgebung gesetzt werden.<br />
<br />
Siehe auch [http://fhem.de/commandref_DE.html#SIP commandref]<br />
<br />
=== Attribute ===<br />
<br />
''Basics & Allgemeines'' <br />
* '''sip_from'''<br />
: Meine SIP-Client-Info. Default ist <nowiki>sip:620@fritz.box</nowiki><br />
* '''sip_ip'''<br />
: Die IP-Addresse meines FHEM-Servers.<br />
* '''sip_port'''<br />
: Port der für den SIP-Client genutzt wird. Default ist 5060 und wird automatisch um 10 erhöht wenn der Port nicht frei ist.<br />
* '''sip_registrar'''<br />
: Hostname oder IP-Addresse des SIP-Servers mit dem sich der Client verbindet. Default ist fritz.box.<br />
* '''sip_user'''<br />
: User Name des SIP-Clients. Default ist 620. Anmerkung: Passwort wird über "set <device> password ''mypassword''" gesetzt.<br />
* '''sip_listen'''<br />
: Das Attribut bietet folgende Optionen<br />
: - '''none''': keine Aktion ('listen' kann auch nicht manuell gestartet werden)<br />
: - '''dtmf''': Beim FHEM-Start geht das Device automatisch in den Status listen und wartet auf DTMF-Anrufer (listen_for_dtmf). Alternativ kann der Prozess manuell via 'listen' gestartet werden.<br />
: - '''wfp''': Beim FHEM-Start geht das Device automatisch in den Status listen wait-fetch-play (listen_for_wfp). Alternativ kann der Prozess manuell via 'listen' gestartet werden.<br />
* '''sip_waittime'''<br />
: Maximale Wartezeit bei listen_for_wfp bis das Gespräch automatisch angenommen wird.<br />
* '''sip_ringtime'''<br />
: listen: legt fest wie lange das Modul warten soll bis es den Anruf annimmt. Defaultwert ist 2, das entspricht ca. 1x klingeln.<br />
: <br />
* Anmerkung zum '''Audioformat'''<br />
: Audiofiles müssen im alaw- oder ulaw-Format vorliegen und können mit folgendem Command erzeugt werden<br />
: '''sox <file>.wav -t raw -r 8000 -c 1 -e a-law <file>.alaw'''<br />
: da nur diese raw audio format unterstützt wird. Unterstützte/erkannte Endungen sind .alaw und .ulaw. Bitte darauf achten, dass das audiofile und der komplette Pfad die passenden Permissions hat, damit der FHEM User das File auch lesen darf.<br />
<br />
''DTMF empfangen''<br />
* '''sip_dtmf_loop'''<br />
: legt für den listen_for_dtmf-Modus fest wie oft ein DTMF Code eingeben werden soll ( once oder loop, default ist once ). <br />
: Bei 'once' erwartet der SIP-Cleint die Eingabe eines Codes in der angegebenen Länge und beendet den Anruf. <br />
: Bei 'loop' startet eine Endlosschleife aus Ansage->Code-Erfassung->Quittung->Loop bis der Anrufer irgendwann auflegt.<br />
* '''sip_dtmf_size'''<br />
: Die Anzahl der erwarteten DTMF-Töne im listen_for_dtmf-Modus (1 bis 4)<br />
* '''sip_audiofile_dtmf'''<br />
: Audiofile das dem Anrufer im listen_for_dtmf-Modus vorgespielt wird und ihn auffordert einen Code einzugeben. Ist kein File angegeben hört man ein Geräusch.<br />
* '''sip_audiofile_ok'''<br />
: Audiofile das dem Anrufer im listen_for_dtmf-Modus als Quittungston vorgespielt wird. <br />
<br />
''Auf anruf warten und annehmen''<br />
* '''sip_audiofile_wfp'''<br />
: Audiofile das nach dem Command '''fetch''' abgespielt wird. <br />
<br />
''Anrufen und DTMF senden''<br />
* '''sip_dtmf_send'''<br />
: Bestimmt die Übertragungsart der angegebenen DTMF-Töne und bietet folgende Möglichkeiten:<br />
: 'audio': Es werden Audiotöne übermittelt<br />
: 'rfc2833': Es erfolgt eine Übertragung nach RFC2833 (für das menschliche Ohr weniger ansprechend)<br />
<br />
''Anrufen und etwas senden''<br />
* '''sip_audiofile_call'''<br />
: Audiofile das dem angerufenen bei '''call''' vorgespielt wird. <br />
<br />
''Anrufen und etwas sagen''<br />
* '''T2S_Device'''<br />
: Name Eures in FHEM eingerichteten Text2Speech-Devices <br />
* '''T2S_Timeout'''<br />
: Timeout für die Text2Speech-Konvertierung (könnte ja sein, dass der TTS-Service im Internet überlastet ist)<br />
* '''audio_converter'''<br />
: Der für die Konvertierung zu verwendende (und vorab installierte) Audiokonverter. Auswahl: sox oder ffmpeg<br />
<br />
Siehe auch [http://fhem.de/commandref_DE.html#SIP commandref]<br />
<br />
=== Set ===<br />
<br />
Das Modul kennt derzeit folgende Commands<br />
<br />
* set <name> '''password'''<br />
: Passwort für den User sip_user hinterlegen.<br />
<br />
* set <name> '''reset'''<br />
<br />
: Stoppt laufende listen-Prozess und initalisiert das Device.<br />
<br />
* set <name> '''call <nummer> [<ringtime>] [<nachricht>]'''<br />
: Startet einen Anruf an die angegebene Nummer.<br />
: Optional kann die ringtime angegeben werden. Wird keine angegeben zieht das Attribut sip_ringtime. Default ist 10.<br />
: Optional kann eine Nachricht <br />
: * in Form eines Audiofiles angegeben werden. Das File ist mit dem vollen Pfad oder dem relativen ab dem Verzeichnis mit fhem.pl anzugeben. Bitte darauf achten, dass das audiofile und der Pfad dort hin passende Permissions hat, damit FHEM das File auch lesen darf. Die ringtime ist in dem Fall nicht optional sondern anzugeben.<br />
: * als DTMF-Sequenz angegeben werden. Diese mit einem Prefix '-' versehen werden, also z.B. '''-'''#47.<br />
: * als Text angegeben werden. Dieser mit einem Prefix '!' versehen werden, also z.B. '''!'''Hier spricht dein FHEM.<br />
: Bitte hierfür unter 'Voraussetzungen' den Hinweis auf TTS beachten.<br />
<br />
* set <name> '''listen'''<br />
: Manueller Start des listen-Prozesses. Setzt voraus, dass die Variable sip_listen auf dtmf oder wfp gesetzt ist:<br />
: '''dtmf''': Der SIP-Client wird in einen Status versetzt in dem er automatisch Anrufe annimmt. Bei einem Anruf wird im Reading 'caller' die Nummer bzw. Id des Anrufers angezeigt. Dem Anrufer wird der eigene Ton als Echo zurückgespielt. Über die Eingabe von '''#''' gefolgt von 2 Zahlen und anschließendem Auflegen kann eine Zahl an das Reading '''dtmf''' übergeben werden. Voraussetzung: Das anrufende Telefon ist auf Tonwahl gestellt (DTMF).<br />
: '''wfp''': Der SIP-Client wird in einen Status versetzt in dem er auf Anrufe wartet (wfp steht für wait-fetch-play). Erfolgt ein Anruf an den Client, wechselt das Reading 'caller_state' zu 'ringing', im Reading 'caller' wird die Nummer bzw. Id des Anrufers angezeigt. Nun kann das Gespräch via set-Command 'fetch' angenommen werden. Das als sip_audiofile angegebene File wird abgespielt. Anschließend wechselt der Status wieder zu listen_for_wfp.<br />
<br />
=== Readings ===<br />
<br />
<br />
* '''call''': Die Rufnummer des ausgehenden Anrufs. <br />
* '''call_state''': Status für ausgehende Anrufe. <br />
* '''caller''': Die Rufnummer bzw. Info des aktuellen Anrufers. <br />
* '''caller_state''': Status für eingehende Anrufe. <br />
* '''dtmf''': Die via Tonwahl (DTMF) eingegebenen Zahlen.<br />
* '''state''': Der Status des Devices.<br />
<br />
== Anwendungsbeispiele ==<br />
<br />
=== Anruf tätigen und Sound abspielen ===<br />
* Den Anruf initiieren<br />
: <code>set <device> call <nummer> [<dauer>] [<audiofile>]</code><br />
* Die Default-Dauer beträgt 30 Sekunden.<br />
* Wird kein Audiofile angegeben, wird nur die Verbindung hergestellt und nach der Anrufdauer wieder unterbrochen.<br />
* Anmerkung: Das Audiofile muss das Format PCM/8000 haben.<br />
* Der Angerufene nimmt das Gespräch entgegen, das Audiofile wird abgespielt.<br />
<br />
=== Anruf tätigen und DTMF-Töne senden ===<br />
* Den Anruf initiieren<br />
: <code>set <device> call <nummer> <dauer> <-tastenkombination></code><br />
* Die Tastenkombination muss mit einem Minus (-) nach der Zielnummer folgen, also z.B. **1 -#23<br />
* Der Angerufene nimmt das Gespräch entgegen, die Tonfolge wird abgespielt.<br />
<br />
=== Auf Anruf warten und DTMF-Töne empfangen ===<br />
* Der SIP-Client wird in den Listen-Modus versetzt.<br />
: Das Attribut sip_listen auf '''dtmf''' setzen und<br />
: <code>set <device> listen</code><br />
* Die Nebenstelle des SIP-Clients wird von einem DTMF-fähigen Telefon aus angerufen.<br />
* Wenn der SIP-Client das Gespräch angenommen hat, betätigt man '''#''', gefolgt von zwei Ziffern und legt dann wieder auf. Wichtig: Es müssen immer genau 3 Tasten betätigt werden (# und nm), damit das Reading dtmf gefüllt wird. n und m müssen zwei verschiedene Zahlen sein (0-9) oder ein Stern.<br />
* Im Reading '''dtmf''' ist diese zweistellige Zahl zu sehen und kann ggf. mit einem notify ausgewertet werden.<br />
<br />
=== Auf Anruf warten und kontrolliert annehmen ===<br />
* Der SIP-Client wird in den Listen-Modus versetzt.<br />
: Das Attribut sip_listen auf '''wfp''' setzen und<br />
: <code>set <device> listen</code><br />
* Die Nebenstelle des SIP-Clients wird angerufen.<br />
* Im Reading '''caller''' ist die Nummer bzw. die Info des Callers zu sehen, im '''caller_state''' erscheint 'ringing'.<br />
* Soll der Anruf angenommen werden setze ich den Status des Devices mittels set auf '''fetch''':<br />
: <code>set <device> fetch</code><br />
* Der SIP-Client nimmt den Anruf an und spielt das im Attribut sip_audiofile angegebene File ab.<br />
* Der SIP-Client legt auf und geht wieder in den Status '''listen_for_wfp'''.<br />
<br />
=== Fritzbox + Doorline - Telefonklingeln beenden ===<br />
Szenario: Als Türklingel ist eine Doorline im Einsatz die auf Direktannahme eingestellt ist. Klingelt jemand an der Tür, erfolgt ein 'Anruf' an die in der Rufgruppe definierten Telefone. Man kann den Anruf entgegennehmen, um zu hören wer an der Tür ist, bevor man die Tür öffnet. Geht man direkt zur Tür, klingeln die Telefone insgesamt 30 Sekunden lang bis sie verstummen. Hat man die Haustür mit einem Türkontakt versehen, hilft folgender Ansatz:<br />
* Der SIP-Client wird in der Fritzbox in die Rufgruppe der Türklingel aufgenommen.<br />
* Das Attribut 'sip_listen' wird auf 'wfp' gesetzt.<br />
* Der SIP-Client wird in den Listen-Modus 'wait-fetch-play' versetzt (Die sip_waittime sollte größer als die Klingeldauer der Doorline sein).<br />
: <code>set <device> listen</code><br />
* Klingelt jemand an der Tür, wird unter anderem die Nebenstelle des SIP-Clients angerufen.<br />
* Über ein DOIF greift man die Kombination SIP-Client caller_state 'ringing' und Haustürkontakt closed->open ab und<br />
* setzt den Status des Devices mittels set auf fetch:<br />
: <code>set <device> fetch</code><br />
* Der SIP-Client nimmt den Anruf an und spielt das im Attribut sip_audiofile angegebene File ab.<br />
* Die Telefone verstummen.<br />
<br />
In FHEM sieht das dann z.B. so aus:<br />
<br />
Es gibt ein Device '''HaustuerStatus''' das den Status des Türkontaktes abbildet: "closed" oder "open".<br />
<br />
Es wird ein Dummy-Device '''HaustuerStatusVar''' für die Status des Automaten angelegt:<br />
<br />
<code>define HaustuerStatusVar dummy</code><br />
<br />
Und ein DOIF '''TuerklingelAus''':<br />
<br />
<pre><br />
define TuerklingelAus DOIF <br />
(([HaustuerStatus:state] eq "closed") and ([FhemSipClient:caller_state] eq "ringing") and ([FhemSipClient:caller] eq "Klingel sip:**12\@fritz.box")) <br />
(set HaustuerStatusVar ringing;; set HM_4A4047_Mp3 playTone 001 1 10) <br />
DOELSEIF <br />
(([HaustuerStatus:state] eq "open") and ([HaustuerStatusVar:state] eq "ringing")) <br />
(set FhemSipClient fetch;; set HaustuerStatusVar on) <br />
DOELSEIF <br />
(([HaustuerStatus:state] eq "closed") and ([HaustuerStatusVar:state] ne "off")) <br />
(set HaustuerStatusVar off)<br />
</pre><br />
<br />
Der Caller "Klingel sip:**12\@fritz.box" setzt sich aus dem in der Fritzbox vergebenen Namen, der Nebenstelle (**12 ist eine Doorline mit einem Taster, bei zweien gilt es **11 und **12 zu beachten) sowie dem syntaktischen Drumherum sip:''nebenstelle''\@fritz.box zusammen. Achtet bitte auf den "\" vor dem "@", damit regex nicht mosert.<br />
<br />
HM_4A4047_Mp3 ist übrigens mein mobiler MP3-Tür-/Funkgong der zur Unterstützung einen Gong abspielt.<br />
<br />
== Bekannte Probleme / Fehlersuche ==<br />
=== Fehler bei der Registrierung an der Fritzbox ===<br />
'''Fritzbox'''<br />
* Ist das Device für den SIP-Client in der Fritzbox unter Telefonie > Telefoniegräte gelistet? <br />
* Geräteeinstellungen ändern: Ist für das Device unter 'Anmeldedaten' die Durchwahl als Benutzername angegeben?<br />
* Ist der in dieser Ansicht angegebene 'Registrar' mit der im Attribut sip_registrar identisch? Im Zweifelsfalle die IP-Adresse statt 'fritz.box' verwenden.<br />
* FitzOS ab 6.80: Wurde nach Definition des Gerätes an einem anderen bekannten Gerät der Bestätigungscode eingegeben?<br />
<br />
'''FHEM'''<br />
<br />
Wurde das Passwort mittels set <mydevice> password <meinpasswort> gesetzt?<br />
<br />
Attribute des Devices prüfen:<br />
* Ist unter sip_from <nowiki>'sip:620@fritz.box'</nowiki> die von der Fritzbox vergebene Durchwahl angegeben?<br />
* Ist unter sip_user die von der Fritzbox vergebene Durchwahl angegeben?<br />
* Ist unter sip_registrar die IP-Adresser der Fritzbox eingetragen?<br />
* Ist unter sip_ip die IP-Adresse des FHEM-Servers eingetragen (z.B. 192.168.178.47 angeben, keine Adresse aus dem 127er-Segment)?<br />
<br />
=== Erzeugung eines passenden Audiofiles ===<br />
<br />
Eine Alternative zu sox ist ffmpeg. Damit kann direkt von mp3 ins Zielformat konvertiert werden:<br />
<br />
ffmpeg -i meinfile.mp3 -f alaw -ar 8000 meinfile.alaw<br />
<br />
== Links ==<br />
* {{Link2Forum|Topic=40219|LinkText=Forenthread}} alter Forum-Thread zu FB_SIP.pm und SIP.pm<br />
* {{Link2Forum|Topic=67443|LinkText=Forenthread}} Forum-Thread zu diesem Modul SIP<br />
<br />
[[Kategorie:Hilfsmodul]] <br />
<!-- (Modulkategorie wird automatisch gesetzt) --></div>Wzuthttp://wiki.fhem.de/w/index.php?title=SIP-Client&diff=20740SIP-Client2017-03-15T14:12:51Z<p>Wzut: Ansagee geändert auf Ansage , defaultwert 10 in 30 geändert</p>
<hr />
<div>{{Infobox Modul<br />
|ModPurpose=SIP-Client für FHEM <br />
|ModType=h<br />
|ModCmdRef=SIP<br />
|ModForumArea=Sonstiges<br />
|ModTechName=96_SIP.pm<br />
|ModOwner=Wzut ({{Link2FU|1172|Forum}} / [[Benutzer Diskussion:Wzut|Wiki]])}}<br />
<br />
Das Modul '''SIP''' ermöglicht die Entgegennahme (DTMF-Töne interpretieren, kontrollierte Annahme) sowie die Durchführung (Audiofile abspielen, DTMF-Töne senden, Textansage) von Anrufen.<br />
<br />
<br />
== Voraussetzungen ==<br />
=== FHEM-Server ===<br />
Für den Remote-Zugang muss das Modul Net::SIP installiert sein; auf einem Raspberry Pi oder unter Ubuntu z.&nbsp;B. mit dem Befehl<br />
:<code>sudo cpanm install Net::SIP</code><br />
<br />
oder auch<br />
<br />
:<code>sudo apt-get install libnet-sip-perl</code><br />
<br />
==== Falls Ihr Text2Speech verwenden wollt ====<br />
<br />
Vorbereitung<br />
* SoX installieren <br />
:<code>sudo apt-get install sox </code><br />
* mp3 Unterstützung für SoX installieren<br />
:<code>sudo apt-get install libsox-fmt-mp3</code><br />
* Text2Speech als Server Device anlegen <br />
:<code>define <name z.B myT2S> text2speech none</code><br />
* beim SIP Device dieses Server Device im Attribut T2S_Device eintragen<br />
<br />
=== SIP-Server ===<br />
Der SIP-Client muss sich an einem SIP-Server anmelden (Fritzbox, Asterisk, VoIP-Provider). <br />
Auf dem SIP-Server, mit dem sich der Client verbinden soll, muss ein User-Account vorhanden sein bzw. angelegt werden. <br />
In der Fritzbox muss z.B. ein neues Telefoniegerät vom Typ LAN/WLAN angelegt und ein Passwort vergeben werden. Das erzeugt ein neues internes Device im internen Rufnummernbereich **62x, typischerweise die 620. Es sollte kontrolliert werden, ob bei den Anmeldeinformationen der Benutzername der Nebenstelle entspricht (z.B. 620) und ein Passwort eingetragen ist.<br />
<br />
=== Hardware ===<br />
Die verwendete Library Net::SIP fordert mehr Ressourcen als RaspberryPi, BananaPi & Co hergeben. Bitte testet, ob Eure Hardware Audofiles sauber abspielen sowie sicher DTMF-Töne empfangen kann und für Euren Einsatzzweck geeignet ist.<br />
<br />
== Installation ==<br />
=== Erste Schritte ===<br />
Spätestens nach einem 'update all' sollte das Modul '''96_SIP.pm''' verfügbar sein.<br />
<br />
Nun ist der SIP-Client als Device in FHEM anzulegen:<br />
<br />
:<code>define <name> SIP</code><br />
<br />
Anschließend sollten alle sip_Attribute geprüft und für die eigene Umgebung gesetzt werden. Ebenso ist das Passwort mittels set-Command zu speichern.<br />
<br />
=== Mögliche Fehlermeldungen ===<br />
Sollte schon bei <code>define mySIP SIP</code> die Fehlermeldung kommen, dass dieses Modul nicht existiert, dann bitte 'update all' durchführen.<br />
<br />
== Anwendung ==<br />
=== Define ===<br />
<br />
<code>define <name> SIP</code><br />
<br />
Anschließend sollten alle sip_Attribute geprüft und für die eigene Umgebung gesetzt werden.<br />
<br />
Siehe auch [http://fhem.de/commandref_DE.html#SIP commandref]<br />
<br />
=== Attribute ===<br />
<br />
''Basics & Allgemeines'' <br />
* '''sip_from'''<br />
: Meine SIP-Client-Info. Default ist <nowiki>sip:620@fritz.box</nowiki><br />
* '''sip_ip'''<br />
: Die IP-Addresse meines FHEM-Servers.<br />
* '''sip_port'''<br />
: Port der für den SIP-Client genutzt wird. Default ist 5060 und wird automatisch um 10 erhöht wenn der Port nicht frei ist.<br />
* '''sip_registrar'''<br />
: Hostname oder IP-Addresse des SIP-Servers mit dem sich der Client verbindet. Default ist fritz.box.<br />
* '''sip_user'''<br />
: User Name des SIP-Clients. Default ist 620. Anmerkung: Passwort wird über "set <device> password ''mypassword''" gesetzt.<br />
* '''sip_listen'''<br />
: Das Attribut bietet folgende Optionen<br />
: - '''none''': keine Aktion ('listen' kann auch nicht manuell gestartet werden)<br />
: - '''dtmf''': Beim FHEM-Start geht das Device automatisch in den Status listen und wartet auf DTMF-Anrufer (listen_for_dtmf). Alternativ kann der Prozess manuell via 'listen' gestartet werden.<br />
: - '''wfp''': Beim FHEM-Start geht das Device automatisch in den Status listen wait-fetch-play (listen_for_wfp). Alternativ kann der Prozess manuell via 'listen' gestartet werden.<br />
* '''sip_waittime'''<br />
: Maximale Wartezeit bei listen_for_wfp bis das Gespräch automatisch angenommen wird.<br />
* '''sip_ringtime'''<br />
: listen: legt fest wie lange das Modul warten soll bis es den Anruf annimmt. Defaultwert ist 2, das entspricht ca. 1x Klingeln.<br />
: call: sip_ringtime wird nicht mehr verwendet. Wird keine Maximale Zeit angegeben so wird der Default Wert von 30 Sekunden verwendet.<br />
<br />
* Anmerkung zum '''Audioformat'''<br />
: Audiofiles müssen im alaw- oder ulaw-Format vorliegen und können mit folgendem Command erzeugt werden<br />
: '''sox <file>.wav -t raw -r 8000 -c 1 -e a-law <file>.alaw'''<br />
: da nur diese raw audio format unterstützt wird. Unterstützte/erkannte Endungen sind .alaw und .ulaw. Bitte darauf achten, dass das audiofile und der Pfad dort hin passende Permissions hat, damit FHEM das File auch lesen darf.<br />
<br />
''DTMF empfangen''<br />
* '''sip_dtmf_loop'''<br />
: legt für den listen_for_dtmf-Modus fest wie oft ein DTMF Code eingeben werden soll ( once oder loop, default ist once ). <br />
: Bei 'once' erwartet der SIP-Cleint die Eingabe eines Codes in der angegebenen Länge und beendet den Anruf. <br />
: Bei 'loop' startet eine Endlosschleife aus Ansage->Code-Erfassung->Quittung->Loop bis der Anrufer irgendwann auflegt.<br />
* '''sip_dtmf_size'''<br />
: Die Anzahl der erwarteten DTMF-Töne im listen_for_dtmf-Modus (1 bis 4)<br />
* '''sip_audiofile_dtmf'''<br />
: Audiofile das dem Anrufer im listen_for_dtmf-Modus vorgespielt wird und ihn auffordert einen Code einzugeben. Ist kein File angegeben hört man ein Geräusch.<br />
* '''sip_audiofile_ok'''<br />
: Audiofile das dem Anrufer im listen_for_dtmf-Modus als Quittungston vorgespielt wird. <br />
<br />
''Auf anruf warten und annehmen''<br />
* '''sip_audiofile_wfp'''<br />
: Audiofile das nach dem Command '''fetch''' abgespielt wird. <br />
<br />
''Anrufen und DTMF senden''<br />
* '''sip_dtmf_send'''<br />
: Bestimmt die Übertragungsart der angegebenen DTMF-Töne und bietet folgende Möglichkeiten:<br />
: 'audio': Es werden Audiotöne übermittelt<br />
: 'rfc2833': Es erfolgt eine Übertragung nach RFC2833 (für das menschliche Ohr weniger ansprechend)<br />
<br />
''Anrufen und etwas senden''<br />
* '''sip_audiofile_call'''<br />
: Audiofile das dem angerufenen bei '''call''' vorgespielt wird. <br />
<br />
''Anrufen und etwas sagen''<br />
* '''T2S_Device'''<br />
: Name Eures in FHEM eingerichteten Text2Speech-Devices <br />
* '''T2S_Timeout'''<br />
: Timeout für die Text2Speech-Konvertierung (könnte ja sein, dass der TTS-Service im Internet überlastet ist)<br />
* '''audio_converter'''<br />
: Der für die Konvertierung zu verwendende (und vorab installierte) Audiokonverter. Auswahl: sox oder ffmpeg<br />
<br />
Siehe auch [http://fhem.de/commandref_DE.html#SIP commandref]<br />
<br />
=== Set ===<br />
<br />
Das Modul kennt derzeit folgende Commands<br />
<br />
* set <name> '''password'''<br />
: Passwort für den User sip_user hinterlegen.<br />
<br />
* set <name> '''reset'''<br />
<br />
: Stoppt laufende listen-Prozess und initalisiert das Device.<br />
<br />
* set <name> '''call <nummer> [<ringtime>] [<nachricht>]'''<br />
: Startet einen Anruf an die angegebene Nummer.<br />
: Optional kann die ringtime angegeben werden. Wird keine angegeben zieht das Attribut sip_ringtime. Default ist 10.<br />
: Optional kann eine Nachricht <br />
: * in Form eines Audiofiles angegeben werden. Das File ist mit dem vollen Pfad oder dem relativen ab dem Verzeichnis mit fhem.pl anzugeben. Bitte darauf achten, dass das audiofile und der Pfad dort hin passende Permissions hat, damit FHEM das File auch lesen darf. Die ringtime ist in dem Fall nicht optional sondern anzugeben.<br />
: * als DTMF-Sequenz angegeben werden. Diese mit einem Prefix '-' versehen werden, also z.B. '''-'''#47.<br />
: * als Text angegeben werden. Dieser mit einem Prefix '!' versehen werden, also z.B. '''!'''Hier spricht dein FHEM.<br />
: Bitte hierfür unter 'Voraussetzungen' den Hinweis auf TTS beachten.<br />
<br />
* set <name> '''listen'''<br />
: Manueller Start des listen-Prozesses. Setzt voraus, dass die Variable sip_listen auf dtmf oder wfp gesetzt ist:<br />
: '''dtmf''': Der SIP-Client wird in einen Status versetzt in dem er automatisch Anrufe annimmt. Bei einem Anruf wird im Reading 'caller' die Nummer bzw. Id des Anrufers angezeigt. Dem Anrufer wird der eigene Ton als Echo zurückgespielt. Über die Eingabe von '''#''' gefolgt von 2 Zahlen und anschließendem Auflegen kann eine Zahl an das Reading '''dtmf''' übergeben werden. Voraussetzung: Das anrufende Telefon ist auf Tonwahl gestellt (DTMF).<br />
: '''wfp''': Der SIP-Client wird in einen Status versetzt in dem er auf Anrufe wartet (wfp steht für wait-fetch-play). Erfolgt ein Anruf an den Client, wechselt das Reading 'caller_state' zu 'ringing', im Reading 'caller' wird die Nummer bzw. Id des Anrufers angezeigt. Nun kann das Gespräch via set-Command 'fetch' angenommen werden. Das als sip_audiofile angegebene File wird abgespielt. Anschließend wechselt der Status wieder zu listen_for_wfp.<br />
<br />
=== Readings ===<br />
<br />
<br />
* '''call''': Die Rufnummer des ausgehenden Anrufs. <br />
* '''call_state''': Status für ausgehende Anrufe. <br />
* '''caller''': Die Rufnummer bzw. Info des aktuellen Anrufers. <br />
* '''caller_state''': Status für eingehende Anrufe. <br />
* '''dtmf''': Die via Tonwahl (DTMF) eingegebenen Zahlen.<br />
* '''state''': Der Status des Devices.<br />
<br />
== Anwendungsbeispiele ==<br />
<br />
=== Anruf tätigen und Sound abspielen ===<br />
* Den Anruf initiieren<br />
: <code>set <device> call <nummer> [<dauer>] [<audiofile>]</code><br />
* Die Default-Dauer beträgt 30 Sekunden.<br />
* Wird kein Audiofile angegeben, wird nur die Verbindung hergestellt und nach der Anrufdauer wieder unterbrochen.<br />
* Anmerkung: Das Audiofile muss das Format PCM/8000 haben.<br />
* Der Angerufene nimmt das Gespräch entgegen, das Audiofile wird abgespielt.<br />
<br />
=== Anruf tätigen und DTMF-Töne senden ===<br />
* Den Anruf initiieren<br />
: <code>set <device> call <nummer> <dauer> <-tastenkombination></code><br />
* Die Tastenkombination muss mit einem Minus (-) nach der Zielnummer folgen, also z.B. **1 -#23<br />
* Der Angerufene nimmt das Gespräch entgegen, die Tonfolge wird abgespielt.<br />
<br />
=== Auf Anruf warten und DTMF-Töne empfangen ===<br />
* Der SIP-Client wird in den Listen-Modus versetzt.<br />
: Das Attribut sip_listen auf '''dtmf''' setzen und<br />
: <code>set <device> listen</code><br />
* Die Nebenstelle des SIP-Clients wird von einem DTMF-fähigen Telefon aus angerufen.<br />
* Wenn der SIP-Client das Gespräch angenommen hat, betätigt man '''#''', gefolgt von zwei Ziffern und legt dann wieder auf. Wichtig: Es müssen immer genau 3 Tasten betätigt werden (# und nm), damit das Reading dtmf gefüllt wird. n und m müssen zwei verschiedene Zahlen sein (0-9) oder ein Stern.<br />
* Im Reading '''dtmf''' ist diese zweistellige Zahl zu sehen und kann ggf. mit einem notify ausgewertet werden.<br />
<br />
=== Auf Anruf warten und kontrolliert annehmen ===<br />
* Der SIP-Client wird in den Listen-Modus versetzt.<br />
: Das Attribut sip_listen auf '''wfp''' setzen und<br />
: <code>set <device> listen</code><br />
* Die Nebenstelle des SIP-Clients wird angerufen.<br />
* Im Reading '''caller''' ist die Nummer bzw. die Info des Callers zu sehen, im '''caller_state''' erscheint 'ringing'.<br />
* Soll der Anruf angenommen werden setze ich den Status des Devices mittels set auf '''fetch''':<br />
: <code>set <device> fetch</code><br />
* Der SIP-Client nimmt den Anruf an und spielt das im Attribut sip_audiofile angegebene File ab.<br />
* Der SIP-Client legt auf und geht wieder in den Status '''listen_for_wfp'''.<br />
<br />
=== Fritzbox + Doorline - Telefonklingeln beenden ===<br />
Szenario: Als Türklingel ist eine Doorline im Einsatz die auf Direktannahme eingestellt ist. Klingelt jemand an der Tür, erfolgt ein 'Anruf' an die in der Rufgruppe definierten Telefone. Man kann den Anruf entgegennehmen, um zu hören wer an der Tür ist, bevor man die Tür öffnet. Geht man direkt zur Tür, klingeln die Telefone insgesamt 30 Sekunden lang bis sie verstummen. Hat man die Haustür mit einem Türkontakt versehen, hilft folgender Ansatz:<br />
* Der SIP-Client wird in der Fritzbox in die Rufgruppe der Türklingel aufgenommen.<br />
* Das Attribut 'sip_listen' wird auf 'wfp' gesetzt.<br />
* Der SIP-Client wird in den Listen-Modus 'wait-fetch-play' versetzt (Die sip_waittime sollte größer als die Klingeldauer der Doorline sein).<br />
: <code>set <device> listen</code><br />
* Klingelt jemand an der Tür, wird unter anderem die Nebenstelle des SIP-Clients angerufen.<br />
* Über ein DOIF greift man die Kombination SIP-Client caller_state 'ringing' und Haustürkontakt closed->open ab und<br />
* setzt den Status des Devices mittels set auf fetch:<br />
: <code>set <device> fetch</code><br />
* Der SIP-Client nimmt den Anruf an und spielt das im Attribut sip_audiofile angegebene File ab.<br />
* Die Telefone verstummen.<br />
<br />
In FHEM sieht das dann z.B. so aus:<br />
<br />
Es gibt ein Device '''HaustuerStatus''' das den Status des Türkontaktes abbildet: "closed" oder "open".<br />
<br />
Es wird ein Dummy-Device '''HaustuerStatusVar''' für die Status des Automaten angelegt:<br />
<br />
<code>define HaustuerStatusVar dummy</code><br />
<br />
Und ein DOIF '''TuerklingelAus''':<br />
<br />
<pre><br />
define TuerklingelAus DOIF <br />
(([HaustuerStatus:state] eq "closed") and ([FhemSipClient:caller_state] eq "ringing") and ([FhemSipClient:caller] eq "Klingel sip:**12\@fritz.box")) <br />
(set HaustuerStatusVar ringing;; set HM_4A4047_Mp3 playTone 001 1 10) <br />
DOELSEIF <br />
(([HaustuerStatus:state] eq "open") and ([HaustuerStatusVar:state] eq "ringing")) <br />
(set FhemSipClient fetch;; set HaustuerStatusVar on) <br />
DOELSEIF <br />
(([HaustuerStatus:state] eq "closed") and ([HaustuerStatusVar:state] ne "off")) <br />
(set HaustuerStatusVar off)<br />
</pre><br />
<br />
Der Caller "Klingel sip:**12\@fritz.box" setzt sich aus dem in der Fritzbox vergebenen Namen, der Nebenstelle (**12 ist eine Doorline mit einem Taster, bei zweien gilt es **11 und **12 zu beachten) sowie dem syntaktischen Drumherum sip:''nebenstelle''\@fritz.box zusammen. Achtet bitte auf den "\" vor dem "@", damit regex nicht mosert.<br />
<br />
HM_4A4047_Mp3 ist übrigens mein mobiler MP3-Tür-/Funkgong der zur Unterstützung einen Gong abspielt.<br />
<br />
== Bekannte Probleme / Fehlersuche ==<br />
=== Fehler bei der Registrierung an der Fritzbox ===<br />
'''Fritzbox'''<br />
* Ist das Device für den SIP-Client in der Fritzbox unter Telefonie > Telefoniegräte gelistet? <br />
* Geräteeinstellungen ändern: Ist für das Device unter 'Anmeldedaten' die Durchwahl als Benutzername angegeben?<br />
* Ist der in dieser Ansicht angegebene 'Registrar' mit der im Attribut sip_registrar identisch? Im Zweifelsfalle die IP-Adresse statt 'fritz.box' verwenden.<br />
* FitzOS ab 6.80: Wurde nach Definition des Gerätes an einem anderen bekannten Gerät der Bestätigungscode eingegeben?<br />
<br />
'''FHEM'''<br />
<br />
Wurde das Passwort mittels set <mydevice> password <meinpasswort> gesetzt?<br />
<br />
Attribute des Devices prüfen:<br />
* Ist unter sip_from <nowiki>'sip:620@fritz.box'</nowiki> die von der Fritzbox vergebene Durchwahl angegeben?<br />
* Ist unter sip_user die von der Fritzbox vergebene Durchwahl angegeben?<br />
* Ist unter sip_registrar die IP-Adresser der Fritzbox eingetragen?<br />
* Ist unter sip_ip die IP-Adresse des FHEM-Servers eingetragen (z.B. 192.168.178.47 angeben, keine Adresse aus dem 127er-Segment)?<br />
<br />
=== Erzeugung eines passenden Audiofiles ===<br />
<br />
Eine Alternative zu sox ist ffmpeg. Damit kann direkt von mp3 ins Zielformat konvertiert werden:<br />
<br />
ffmpeg -i meinfile.mp3 -f alaw -ar 8000 meinfile.alaw<br />
<br />
== Links ==<br />
* {{Link2Forum|Topic=40219|LinkText=Forenthread}} alter Forum-Thread zu FB_SIP.pm und SIP.pm<br />
* {{Link2Forum|Topic=67443|LinkText=Forenthread}} Forum-Thread zu diesem Modul SIP<br />
<br />
[[Kategorie:Hilfsmodul]] <br />
<!-- (Modulkategorie wird automatisch gesetzt) --></div>Wzuthttp://wiki.fhem.de/w/index.php?title=SIP-Client&diff=20140SIP-Client2017-02-21T06:58:15Z<p>Wzut: </p>
<hr />
<div>{{Infobox Modul<br />
|ModPurpose=SIP-Client für FHEM <br />
|ModType=h<br />
|ModCmdRef=SIP<br />
|ModForumArea=Sonstiges<br />
|ModTechName=96_SIP.pm<br />
|ModOwner=Wzut ({{Link2FU|1172|Forum}} / [[Benutzer Diskussion:Wzut|Wiki]])}}<br />
<br />
Das Modul '''SIP''' ermöglicht die Entgegennahme (DTMF-Töne interpretieren, kontrollierte Annahme) sowie die Durchführung (Audiofile abspielen, DTMF-Töne senden) von Anrufen.<br />
<br />
<br />
== Voraussetzungen ==<br />
=== FHEM-Server ===<br />
Für den Remote-Zugang muss das Modul Net::SIP installiert sein; auf einem Raspberry Pi oder unter Ubuntu z.&nbsp;B. mit dem Befehl<br />
:<code>sudo cpanm install Net::SIP</code><br />
<br />
oder auch<br />
<br />
:<code>sudo apt-get install libnet-sip-perl</code><br />
<br />
=== SIP-Server ===<br />
Der SIP-Client muss sich an einem SIP-Server anmelden (Fritzbox, Asterisk, VoIP-Provider). <br />
Auf dem SIP-Server, mit dem sich der Client konnektieren soll, muss ein User-Account vorhanden sein bzw. angelegt werden. <br />
In der Fritzbox muss z.B. ein neues Telefoniegerät vom Typ LAN/WLAN angelegt und ein Passwort vergeben werden. Das erzeugt ein neues internes Device im Bereich **62x, typischerweise die 620. Es sollte kontrolliert werden, ob bei den Anmeldeinformationen der Benutzername der Nebenstelle entspricht (z.B. 620) und ein Passwort eingetragen ist.<br />
<br />
== Installation ==<br />
=== Erste Schritte ===<br />
Spätestens nach einem 'update all' sollte das Modul '''96_SIP.pm''' verfügbar sein.<br />
<br />
Nun ist der SIP-Client als Device in FHEM anzulegen:<br />
<br />
:<code>define <name> SIP</code><br />
<br />
Anschließend sollten alle sip_Attribute geprüft und für die eigene Umgebung gesetzt werden.<br />
<br />
=== mögliche Fehlermeldungen ===<br />
Sollte schon bei <code>define mySIP SIP</code> die Fehlermeldung kommen, dass dieses Modul nicht existiert, dann bitte 'update all' durchführen.<br />
<br />
== Anwendung ==<br />
=== Define ===<br />
<br />
<code>define <name> SIP</code><br />
<br />
Anschließend sollten alle sip_Attribute geprüft und für die eigene Umgebung gesetzt werden.<br />
<br />
Siehe auch [http://fhem.de/commandref_DE.html#SIP commandref]<br />
<br />
=== Attribute ===<br />
<br />
* '''sip_audiofile'''<br />
: Audiofile das nach dem Command '''fetch''' abgespielt wird. Das Audiofile muss mit folgendem Command erzeugt werden<br />
: '''sox <file>.wav -t raw -r 8000 -c 1 -e a-law <file>.alaw'''<br />
: da nur das raw audio format unterstützt wird.<br />
* '''sip_listen'''<br />
: Das Attribut bietet folgende Optionen<br />
: - '''none''': keine Aktion ('listen' kann auch nicht manuell gestartet werden)<br />
: - '''dtmf''': Beim FHEM-Start geht das Device automatisch in den Status listen und wartet auf DTMF-Anrufer. Alternativ kann der Prozess manuell via 'listen' gestartet werden.<br />
: - '''wfp''': Beim FHEM-Start geht das Device automatisch in den Status listen wait-fetch-play. Alternativ kann der Prozess manuell via 'listen' gestartet werden.<br />
* '''sip_from'''<br />
: Meine SIP-Client-Info. Default ist <nowiki>sip:620@fritz.box</nowiki><br />
* '''sip_ip'''<br />
: Die IP-Addresse meines FHEM-Servers.<br />
* '''sip_port'''<br />
: Port der für den SIP-Client genutzt wird. Default ist 5060 und wird automatisch um 10 erhöht wenn der Port nicht frei ist.<br />
* '''sip_registrar'''<br />
: Hostname oder IP-Addresse des SIP-Servers mit dem sich der Client verbindet. Default ist fritz.box.<br />
* '''sip_ringtime'''<br />
: Klingelzeit für ausgehende Anrufe.<br />
* '''sip_user'''<br />
: User Name des SIP-Clients. Default ist 620.<br />
* '''sip_waits'''<br />
: Interne Wartezeit in Sekunden bevor nach nicht erfolgreichem listen ein erneuter Versuch gestartet wird. <br />
* '''sip_waittime'''<br />
: Maximale Wartezeit des Commands listenwfp bis das Gespräch automatisch angenommen wird.<br />
<br />
Siehe auch [http://fhem.de/commandref_DE.html#SIP commandref]<br />
<br />
=== Set ===<br />
<br />
Das Modul kennt derzeit folgende Commands<br />
<br />
* set <name> '''reset'''<br />
<br />
: Stoppt laufende listen-Prozess und initalisiert das Device.<br />
<br />
* set <name> '''call <nummer> [<ringtime>] [<nachricht>]'''<br />
: Startet einen Anruf an die angegebene Nummer.<br />
: Optional kann die ringtime angegeben werden. Wird keine angegeben zieht das Attribut sip_ringtime. Default ist 10.<br />
: Optional kann eine Nachricht in Form eines Audiofiles angegeben werden. Das File ist mit dem vollen Pfad oder dem relativen ab dem Verzeichnis mit fhem.pl anzugeben.<br />
<br />
* set <name> '''listen'''<br />
: Manueller Start des listen-Prozesses. Setzt voraus, dass die Variable sip_listen auf dtmf oder wfp gesetzt ist:<br />
: '''dtmf''': Der SIP-Client wird in einen Status versetzt in dem er automatisch Anrufe annimmt oder . Dem Anrufer wird der Ton wird als Echo zurückgespielt. Über die Eingabe von '''#''' gefolgt von 2 Zahlen und anschließendem Auflegen kann eine Zahl in das Reading '''dtmf''' übergeben werden. Voraussetzung: Das anrufende Telefon ist auf Tonwahl gestellt (DTMF).<br />
: '''wfp''': Der SIP-Client wird in einen Status versetzt in dem er auf Anrufe wartet (wfp steht für wait-fetch-play). Erfolgt an Anruf an den Client, wechselt der Status zu ringing. Nun kann das Gespräch via set-Command fetch angenommen werden. Das als sip_audiofile angegebene File wird abgespielt. Anschließend wechselt der Status wieder zu listenwfp.<br />
<br />
<br />
=== Readings ===<br />
<br />
<br />
* '''caller''': Die Rufnummer bzw. Info des aktuellen Anrufers. Default-Wert ist '-'.<br />
* '''dtmf''': Die via Tonwahl (DTMF) eingegebenen Zahlen.<br />
* '''state''': Der Status des Devices.<br />
<br />
== Anwendungsbeispiele ==<br />
<br />
=== Anruf tätigen und Sound abspielen ===<br />
* Den Anruf initiieren<br />
: <code>set <device> call <nummer> [<dauer>] [<audiofile>]</code><br />
* Die Default-Dauer beträgt 10 Sekunden.<br />
* Wird kein Audiofile angegeben, wird nur die Verbindung hergestellt und nach der Anrufdauer wieder unterbrochen.<br />
* Anmerkung: Das Audiofile muss das Format PCM/8000 haben.<br />
* Der angerufene nimmt das Gespräch entgegen, das Audiofile wird abgespielt.<br />
<br />
=== Anruf tätigen und DTMF-Töne senden ===<br />
* Den Anruf initiieren<br />
: <code>set <device> call <nummer> <dauer> <-tastenkombination></code><br />
* Die Tastenkombination muss mit einem Minus(-) nach der Zielnummer folgen, also z.B. **1 -#23<br />
* Der angerufene nimmt das Gespräch entgegen, die Tonfolge wird abgespielt<br />
<br />
=== Auf Anruf warten und DTMF-Töne empfangen ===<br />
* Der SIP-Client wird in den Listen-Modus versetzt.<br />
: Das Attribut sip_listen auf '''dtmf''' setzen und<br />
: <code>set <device> listen</code><br />
* Die Nebenstelle des SIP-Clients wird von einem DTMF-fähigen Telefon aus angerufen.<br />
* Wenn der SIP-Client das Gespräch angenommen hat betätigt man '''#''', gefolgt von zwei Ziffern und legt dann wieder auf.<br />
* Im Reading '''dtmf''' ist die zweistellige Zahl zu sehen.<br />
<br />
=== Auf Anruf warten und kontrolliert annehmen ===<br />
* Der SIP-Client wird in den Listen-Modus versetzt.<br />
: Das Attribut sip_listen auf '''wfp''' setzen und<br />
: <code>set <device> listen</code><br />
* Die Nebenstelle des SIP-Clients wird angerufen.<br />
* Im Reading '''caller''' ist die Nummer bzw. die Info des Callers zu sehen.<br />
* Soll der Anruf angenommen werden setze ich den Status des Devices mittels set auf '''fetch''':<br />
: <code>set <device> fetch</code><br />
* Der SIP-Client nimmt den Anruf an und spielt das im Attribut sip_audiofile angegebene File ab.<br />
* Der SIP-Client legt auf und geht wieder in den Status '''listen_for_wfp'''.<br />
<br />
=== Fritzbox + Doorline - Telefonklingeln beenden ===<br />
Szenario: Als Türklingel ist eine Doorline im Einsatz die auf Direktannahme eingestellt ist. Klingelt jemand an der Tür, erfolgt ein 'Anruf' an die in der Rufgruppe definierten Telefone. Man kann den Anruf entgegennehmen, um zu hören wer an der Tür ist, bevor man die Tür öffnet. Geht man direkt zur Tür, klingeln die Telefone insgesamt 30 Sekunden lang bis sie verstummen. Hat man die Haustür mit einem Türkontakt versehen, hilft folgender Ansatz:<br />
* Der SIP-Client wird in der Fritzbox in die Rufgruppe der Türklingel aufgenommen.<br />
* Der SIP-Client wird in den Listen-Modus 'wait-fetch-play' versetzt (Die sip_waittime sollte größer als die Klingeldauer der Doorline sein).<br />
: <code>set <device> listenwfp</code><br />
* Klingelt jemand an der Tür, wird unter anderem die Nebenstelle des SIP-Clients angerufen.<br />
* Über ein DOIF greift man die Kombination SIP-Client-Status 'ringing' und Haustürkontakt closed->open ab und<br />
* setzt den Status des Devices mittels set auf fetch:<br />
: <code>set <device> fetch</code><br />
* Der SIP-Client nimmt den Anruf an und spielt das im Attribut sip_audiofile angegebene File ab.<br />
* Die Telefone verstummen.<br />
<br />
== Bekannte Probleme / Fehlersuche ==<br />
=== Fehler bei der Registrierung an der Fritzbox ===<br />
'''Fritzbox'''<br />
* Ist das Device für den SIP-Client in der Fritzbox unter Telefonie > Telefoniegräte gelistet? <br />
* Geräteeinstellungen ändern: Ist für das Device unter 'Anmeldedaten' die Durchwahl als Benutzername angegeben?<br />
* Ist der in dieser Ansicht angegebene 'Registrar' mit der im Attribut sip_registrar identisch? Im Zweifelsfalle die IP-Adresse statt 'fritz.box' verwenden.<br />
* FitzOS ab 6.80: Wurde nach Definition des Gerätes an einem anderen bekannten Gerät der Bestätigungscode eingegeben?<br />
'''FHEM'''<br />
<br />
Attribute des Devices prüfen:<br />
* Ist unter sip_from <nowiki>'sip:620@fritz.box'</nowiki> mit der von der Fritzbox vergebene Durchwahl angegeben?<br />
* Ist unter sip_user die von der Fritzbox vergebene Durchwahl angegeben?<br />
* Ist unter sip_password das in der Fritzbox hinterlegte Passwort eingetragen?<br />
* Ist unter sip_registrar die IP-Adresser der Fritzbox eingetragen?<br />
* Ist unter sip_ip die IP-Adresse des FHEM-Servers eingetragen (z.B. 192.168.178.47 angeben, keine Adresse aus dem 127er-Segment)?<br />
<br />
== Links ==<br />
* {{Link2Forum|Topic=40219|LinkText=Forenthread}} alter Forum-Thread zu FB_SIP.pm und SIP.pm<br />
* {{Link2Forum|Topic=67443|LinkText=Forenthread}} Forum-Thread zu diesem Modul SIP<br />
<br />
[[Kategorie:Hilfsmodul]] <br />
<!-- (Modulkategorie wird automatisch gesetzt) --></div>Wzuthttp://wiki.fhem.de/w/index.php?title=SIP-Client&diff=20139SIP-Client2017-02-21T06:56:49Z<p>Wzut: </p>
<hr />
<div>{{Infobox Modul<br />
|ModPurpose=SIP-Client für FHEM <br />
|ModType=h<br />
|ModCmdRef=SIP<br />
|ModForumArea=Sonstiges<br />
|ModTechName=96_SIP.pm<br />
|ModOwner=Wzut ({{Link2FU|1172|Forum}} / [[Benutzer Diskussion:Wzut|Wiki]])}}<br />
<br />
Das Modul '''SIP''' ermöglicht die Entgegennahme (DTMF-Töne interpretieren, kontrollierte Annahme) sowie die Durchführung (Audiofile abspielen, DTMF-Töne senden) von Anrufen.<br />
<br />
<br />
== Voraussetzungen ==<br />
=== FHEM-Server ===<br />
Für den Remote-Zugang muss das Modul Net::SIP installiert sein; auf einem Raspberry Pi oder unter Ubuntu z.&nbsp;B. mit dem Befehl<br />
:<code>sudo cpanm install Net::SIP</code><br />
<br />
oder auch<br />
<br />
:<code>sudo apt-get install libnet-sip-perl</code><br />
<br />
=== SIP-Server ===<br />
Der SIP-Client muss sich an einem SIP-Server anmelden (Fritzbox, Asterisk, VoIP-Provider). <br />
Auf dem SIP-Server, mit dem sich der Client konnektieren soll, muss ein User-Account vorhanden sein bzw. angelegt werden. <br />
In der Fritzbox muss z.B. ein neues Telefoniegerät vom Typ LAN/WLAN angelegt und ein Passwort vergeben werden. Das erzeugt ein neues internes Device im Bereich **62x, typischerweise die 620. Es sollte kontrolliert werden, ob bei den Anmeldeinformationen der Benutzername der Nebenstelle entspricht (z.B. 620) und ein Passwort eingetragen ist.<br />
<br />
== Installation ==<br />
=== Erste Schritte ===<br />
Spätestens nach einem 'update all' sollte das Modul '''96_SIP.pm''' verfügbar sein.<br />
<br />
Nun ist der SIP-Client als Device in FHEM anzulegen:<br />
<br />
:<code>define <name> SIP</code><br />
<br />
Anschließend sollten alle sip_Attribute geprüft und für die eigene Umgebung gesetzt werden.<br />
<br />
=== mögliche Fehlermeldungen ===<br />
Sollte schon bei <code>define mySIP SIP</code> die Fehlermeldung kommen, dass dieses Modul nicht existiert, dann bitte 'update all' durchführen.<br />
<br />
== Anwendung ==<br />
=== Define ===<br />
<br />
<code>define <name> SIP</code><br />
<br />
Anschließend sollten alle sip_Attribute geprüft und für die eigene Umgebung gesetzt werden.<br />
<br />
Siehe auch [http://fhem.de/commandref_DE.html#SIP commandref]<br />
<br />
=== Attribute ===<br />
<br />
* '''sip_audiofile'''<br />
: Audiofile das nach dem Command '''fetch''' abgespielt wird. Das Audiofile muss mit folgendem Command erzeugt werden<br />
: '''sox <file>.wav -t raw -r 8000 -c 1 -e a-law <file>.alaw'''<br />
: da nur das raw audio format unterstützt wird.<br />
* '''sip_listen'''<br />
: Das Attribut bietet folgende Optionen<br />
: - '''none''': keine Aktion ('listen' kann auch nicht manuell gestartet werden)<br />
: - '''dtmf''': Beim FHEM-Start geht das Device automatisch in den Status listen und wartet auf DTMF-Anrufer. Alternativ kann der Prozess manuell via 'listen' gestartet werden.<br />
: - '''wfp''': Beim FHEM-Start geht das Device automatisch in den Status listen wait-fetch-play. Alternativ kann der Prozess manuell via 'listen' gestartet werden.<br />
* '''sip_from'''<br />
: Meine SIP-Client-Info. Default ist <nowiki>sip:620@fritz.box</nowiki><br />
* '''sip_ip'''<br />
: Die IP-Addresse meines FHEM-Servers.<br />
* '''sip_port'''<br />
: Port der für den SIP-Client genutzt wird. Default ist 5060 und wird automatisch um 10 erhöht wenn der Port nicht frei ist.<br />
* '''sip_registrar'''<br />
: Hostname oder IP-Addresse des SIP-Servers mit dem sich der Client verbindet. Default ist fritz.box.<br />
* '''sip_ringtime'''<br />
: Klingelzeit für ausgehende Anrufe.<br />
* '''sip_user'''<br />
: User Name des SIP-Clients. Default ist 620.<br />
* '''sip_waits'''<br />
: Interne Wartezeit in Sekunden bevor nach nicht erfolgreichem listen ein erneuter Versuch gestartet wird. <br />
* '''sip_waittime'''<br />
: Maximale Wartezeit des Commands listenwfp bis das Gespräch automatisch angenommen wird.<br />
<br />
Siehe auch [http://fhem.de/commandref_DE.html#SIP commandref]<br />
<br />
=== Set ===<br />
<br />
Das Modul kennt derzeit folgende Commands<br />
<br />
* set <name> '''reset'''<br />
<br />
: Stoppt laufende listen-Prozess und initalisiert das Device.<br />
<br />
* set <name> '''call <nummer> [<ringtime>] [<nachricht>]'''<br />
: Startet einen Anruf an die angegebene Nummer.<br />
: Optional kann die ringtime angegeben werden. Wird keine angegeben zieht das Attribut sip_ringtime. Default ist 10.<br />
: Optional kann eine Nachricht in Form eines Audiofiles angegeben werden. Das File ist mit dem vollen Pfad oder dem relativen ab dem Verzeichnis mit fhem.pl anzugeben.<br />
<br />
* set <name> '''listen'''<br />
: Manueller Start des listen-Prozesses. Setzt voraus, dass die Variable sip_listen auf dtmf oder wfp gesetzt ist:<br />
: '''dtmf''': Der SIP-Client wird in einen Status versetzt in dem er automatisch Anrufe annimmt oder . Dem Anrufer wird der Ton wird als Echo zurückgespielt. Über die Eingabe von '''#''' gefolgt von 2 Zahlen und anschließendem Auflegen kann eine Zahl in das Reading '''dtmf''' übergeben werden. Voraussetzung: Das anrufende Telefon ist auf Tonwahl gestellt (DTMF).<br />
: '''wfp''': Der SIP-Client wird in einen Status versetzt in dem er auf Anrufe wartet (wfp steht für wait-fetch-play). Erfolgt an Anruf an den Client, wechselt der Status zu ringing. Nun kann das Gespräch via set-Command fetch angenommen werden. Das als sip_audiofile angegebene File wird abgespielt. Anschließend wechselt der Status wieder zu listenwfp.<br />
<br />
<br />
=== Readings ===<br />
<br />
<br />
* '''caller''': Die Rufnummer bzw. Info des aktuellen Anrufers. Default-Wert ist '-'.<br />
* '''dtmf''': Die via Tonwahl (DTMF) eingegebenen Zahlen.<br />
* '''state''': Der Status des Devices.<br />
<br />
== Anwendungsbeispiele ==<br />
<br />
=== Anruf tätigen und Sound abspielen ===<br />
* Den Anruf initiieren<br />
: <code>set <device> call <nummer> [<dauer>] [<audiofile>]</code><br />
* Die Default-Dauer beträgt 10 Sekunden.<br />
* Wird kein Audiofile angegeben, wird nur die Verbindung hergestellt und nach der Anrufdauer wieder unterbrochen.<br />
* Anmerkung: Das Audiofile muss das Format PCM/8000 haben.<br />
* Der angerufene nimmt das Gespräch entgegen, das Audiofile wird abgespielt.<br />
<br />
=== Anruf tätigen und DTMF-Töne senden ===<br />
* Den Anruf initiieren<br />
: <code>set <device> call <nummer> <klingelzeit> <-tastenkombination></code><br />
* Die Tastenkombination muss mit einem Minus(-) nach der Zielnummer folgen, also z.B. **1 -#23<br />
* Der angerufene nimmt das Gespräch entgegen, die Tonfolge wird abgespielt<br />
<br />
=== Auf Anruf warten und DTMF-Töne empfangen ===<br />
* Der SIP-Client wird in den Listen-Modus versetzt.<br />
: Das Attribut sip_listen auf '''dtmf''' setzen und<br />
: <code>set <device> listen</code><br />
* Die Nebenstelle des SIP-Clients wird von einem DTMF-fähigen Telefon aus angerufen.<br />
* Wenn der SIP-Client das Gespräch angenommen hat betätigt man '''#''', gefolgt von zwei Ziffern und legt dann wieder auf.<br />
* Im Reading '''dtmf''' ist die zweistellige Zahl zu sehen.<br />
<br />
=== Auf Anruf warten und kontrolliert annehmen ===<br />
* Der SIP-Client wird in den Listen-Modus versetzt.<br />
: Das Attribut sip_listen auf '''wfp''' setzen und<br />
: <code>set <device> listen</code><br />
* Die Nebenstelle des SIP-Clients wird angerufen.<br />
* Im Reading '''caller''' ist die Nummer bzw. die Info des Callers zu sehen.<br />
* Soll der Anruf angenommen werden setze ich den Status des Devices mittels set auf '''fetch''':<br />
: <code>set <device> fetch</code><br />
* Der SIP-Client nimmt den Anruf an und spielt das im Attribut sip_audiofile angegebene File ab.<br />
* Der SIP-Client legt auf und geht wieder in den Status '''listen_for_wfp'''.<br />
<br />
=== Fritzbox + Doorline - Telefonklingeln beenden ===<br />
Szenario: Als Türklingel ist eine Doorline im Einsatz die auf Direktannahme eingestellt ist. Klingelt jemand an der Tür, erfolgt ein 'Anruf' an die in der Rufgruppe definierten Telefone. Man kann den Anruf entgegennehmen, um zu hören wer an der Tür ist, bevor man die Tür öffnet. Geht man direkt zur Tür, klingeln die Telefone insgesamt 30 Sekunden lang bis sie verstummen. Hat man die Haustür mit einem Türkontakt versehen, hilft folgender Ansatz:<br />
* Der SIP-Client wird in der Fritzbox in die Rufgruppe der Türklingel aufgenommen.<br />
* Der SIP-Client wird in den Listen-Modus 'wait-fetch-play' versetzt (Die sip_waittime sollte größer als die Klingeldauer der Doorline sein).<br />
: <code>set <device> listenwfp</code><br />
* Klingelt jemand an der Tür, wird unter anderem die Nebenstelle des SIP-Clients angerufen.<br />
* Über ein DOIF greift man die Kombination SIP-Client-Status 'ringing' und Haustürkontakt closed->open ab und<br />
* setzt den Status des Devices mittels set auf fetch:<br />
: <code>set <device> fetch</code><br />
* Der SIP-Client nimmt den Anruf an und spielt das im Attribut sip_audiofile angegebene File ab.<br />
* Die Telefone verstummen.<br />
<br />
== Bekannte Probleme / Fehlersuche ==<br />
=== Fehler bei der Registrierung an der Fritzbox ===<br />
'''Fritzbox'''<br />
* Ist das Device für den SIP-Client in der Fritzbox unter Telefonie > Telefoniegräte gelistet? <br />
* Geräteeinstellungen ändern: Ist für das Device unter 'Anmeldedaten' die Durchwahl als Benutzername angegeben?<br />
* Ist der in dieser Ansicht angegebene 'Registrar' mit der im Attribut sip_registrar identisch? Im Zweifelsfalle die IP-Adresse statt 'fritz.box' verwenden.<br />
* FitzOS ab 6.80: Wurde nach Definition des Gerätes an einem anderen bekannten Gerät der Bestätigungscode eingegeben?<br />
'''FHEM'''<br />
<br />
Attribute des Devices prüfen:<br />
* Ist unter sip_from <nowiki>'sip:620@fritz.box'</nowiki> mit der von der Fritzbox vergebene Durchwahl angegeben?<br />
* Ist unter sip_user die von der Fritzbox vergebene Durchwahl angegeben?<br />
* Ist unter sip_password das in der Fritzbox hinterlegte Passwort eingetragen?<br />
* Ist unter sip_registrar die IP-Adresser der Fritzbox eingetragen?<br />
* Ist unter sip_ip die IP-Adresse des FHEM-Servers eingetragen (z.B. 192.168.178.47 angeben, keine Adresse aus dem 127er-Segment)?<br />
<br />
== Links ==<br />
* {{Link2Forum|Topic=40219|LinkText=Forenthread}} alter Forum-Thread zu FB_SIP.pm und SIP.pm<br />
* {{Link2Forum|Topic=67443|LinkText=Forenthread}} Forum-Thread zu diesem Modul SIP<br />
<br />
[[Kategorie:Hilfsmodul]] <br />
<!-- (Modulkategorie wird automatisch gesetzt) --></div>Wzuthttp://wiki.fhem.de/w/index.php?title=SIP-Client&diff=20138SIP-Client2017-02-21T06:55:44Z<p>Wzut: DTMF senden angepasst</p>
<hr />
<div>{{Infobox Modul<br />
|ModPurpose=SIP-Client für FHEM <br />
|ModType=h<br />
|ModCmdRef=SIP<br />
|ModForumArea=Sonstiges<br />
|ModTechName=96_SIP.pm<br />
|ModOwner=Wzut ({{Link2FU|1172|Forum}} / [[Benutzer Diskussion:Wzut|Wiki]])}}<br />
<br />
Das Modul '''SIP''' ermöglicht die Entgegennahme (DTMF-Töne interpretieren, kontrollierte Annahme) sowie die Durchführung (Audiofile abspielen, DTMF-Töne senden) von Anrufen.<br />
<br />
<br />
== Voraussetzungen ==<br />
=== FHEM-Server ===<br />
Für den Remote-Zugang muss das Modul Net::SIP installiert sein; auf einem Raspberry Pi oder unter Ubuntu z.&nbsp;B. mit dem Befehl<br />
:<code>sudo cpanm install Net::SIP</code><br />
<br />
oder auch<br />
<br />
:<code>sudo apt-get install libnet-sip-perl</code><br />
<br />
=== SIP-Server ===<br />
Der SIP-Client muss sich an einem SIP-Server anmelden (Fritzbox, Asterisk, VoIP-Provider). <br />
Auf dem SIP-Server, mit dem sich der Client konnektieren soll, muss ein User-Account vorhanden sein bzw. angelegt werden. <br />
In der Fritzbox muss z.B. ein neues Telefoniegerät vom Typ LAN/WLAN angelegt und ein Passwort vergeben werden. Das erzeugt ein neues internes Device im Bereich **62x, typischerweise die 620. Es sollte kontrolliert werden, ob bei den Anmeldeinformationen der Benutzername der Nebenstelle entspricht (z.B. 620) und ein Passwort eingetragen ist.<br />
<br />
== Installation ==<br />
=== Erste Schritte ===<br />
Spätestens nach einem 'update all' sollte das Modul '''96_SIP.pm''' verfügbar sein.<br />
<br />
Nun ist der SIP-Client als Device in FHEM anzulegen:<br />
<br />
:<code>define <name> SIP</code><br />
<br />
Anschließend sollten alle sip_Attribute geprüft und für die eigene Umgebung gesetzt werden.<br />
<br />
=== mögliche Fehlermeldungen ===<br />
Sollte schon bei <code>define mySIP SIP</code> die Fehlermeldung kommen, dass dieses Modul nicht existiert, dann bitte 'update all' durchführen.<br />
<br />
== Anwendung ==<br />
=== Define ===<br />
<br />
<code>define <name> SIP</code><br />
<br />
Anschließend sollten alle sip_Attribute geprüft und für die eigene Umgebung gesetzt werden.<br />
<br />
Siehe auch [http://fhem.de/commandref_DE.html#SIP commandref]<br />
<br />
=== Attribute ===<br />
<br />
* '''sip_audiofile'''<br />
: Audiofile das nach dem Command '''fetch''' abgespielt wird. Das Audiofile muss mit folgendem Command erzeugt werden<br />
: '''sox <file>.wav -t raw -r 8000 -c 1 -e a-law <file>.alaw'''<br />
: da nur das raw audio format unterstützt wird.<br />
* '''sip_listen'''<br />
: Das Attribut bietet folgende Optionen<br />
: - '''none''': keine Aktion ('listen' kann auch nicht manuell gestartet werden)<br />
: - '''dtmf''': Beim FHEM-Start geht das Device automatisch in den Status listen und wartet auf DTMF-Anrufer. Alternativ kann der Prozess manuell via 'listen' gestartet werden.<br />
: - '''wfp''': Beim FHEM-Start geht das Device automatisch in den Status listen wait-fetch-play. Alternativ kann der Prozess manuell via 'listen' gestartet werden.<br />
* '''sip_from'''<br />
: Meine SIP-Client-Info. Default ist <nowiki>sip:620@fritz.box</nowiki><br />
* '''sip_ip'''<br />
: Die IP-Addresse meines FHEM-Servers.<br />
* '''sip_port'''<br />
: Port der für den SIP-Client genutzt wird. Default ist 5060 und wird automatisch um 10 erhöht wenn der Port nicht frei ist.<br />
* '''sip_registrar'''<br />
: Hostname oder IP-Addresse des SIP-Servers mit dem sich der Client verbindet. Default ist fritz.box.<br />
* '''sip_ringtime'''<br />
: Klingelzeit für ausgehende Anrufe.<br />
* '''sip_user'''<br />
: User Name des SIP-Clients. Default ist 620.<br />
* '''sip_waits'''<br />
: Interne Wartezeit in Sekunden bevor nach nicht erfolgreichem listen ein erneuter Versuch gestartet wird. <br />
* '''sip_waittime'''<br />
: Maximale Wartezeit des Commands listenwfp bis das Gespräch automatisch angenommen wird.<br />
<br />
Siehe auch [http://fhem.de/commandref_DE.html#SIP commandref]<br />
<br />
=== Set ===<br />
<br />
Das Modul kennt derzeit folgende Commands<br />
<br />
* set <name> '''reset'''<br />
<br />
: Stoppt laufende listen-Prozess und initalisiert das Device.<br />
<br />
* set <name> '''call <nummer> [<ringtime>] [<nachricht>]'''<br />
: Startet einen Anruf an die angegebene Nummer.<br />
: Optional kann die ringtime angegeben werden. Wird keine angegeben zieht das Attribut sip_ringtime. Default ist 10.<br />
: Optional kann eine Nachricht in Form eines Audiofiles angegeben werden. Das File ist mit dem vollen Pfad oder dem relativen ab dem Verzeichnis mit fhem.pl anzugeben.<br />
<br />
* set <name> '''listen'''<br />
: Manueller Start des listen-Prozesses. Setzt voraus, dass die Variable sip_listen auf dtmf oder wfp gesetzt ist:<br />
: '''dtmf''': Der SIP-Client wird in einen Status versetzt in dem er automatisch Anrufe annimmt oder . Dem Anrufer wird der Ton wird als Echo zurückgespielt. Über die Eingabe von '''#''' gefolgt von 2 Zahlen und anschließendem Auflegen kann eine Zahl in das Reading '''dtmf''' übergeben werden. Voraussetzung: Das anrufende Telefon ist auf Tonwahl gestellt (DTMF).<br />
: '''wfp''': Der SIP-Client wird in einen Status versetzt in dem er auf Anrufe wartet (wfp steht für wait-fetch-play). Erfolgt an Anruf an den Client, wechselt der Status zu ringing. Nun kann das Gespräch via set-Command fetch angenommen werden. Das als sip_audiofile angegebene File wird abgespielt. Anschließend wechselt der Status wieder zu listenwfp.<br />
<br />
<br />
=== Readings ===<br />
<br />
<br />
* '''caller''': Die Rufnummer bzw. Info des aktuellen Anrufers. Default-Wert ist '-'.<br />
* '''dtmf''': Die via Tonwahl (DTMF) eingegebenen Zahlen.<br />
* '''state''': Der Status des Devices.<br />
<br />
== Anwendungsbeispiele ==<br />
<br />
=== Anruf tätigen und Sound abspielen ===<br />
* Den Anruf initiieren<br />
: <code>set <device> call <nummer> [<dauer>] [<audiofile>]</code><br />
* Die Default-Dauer beträgt 10 Sekunden.<br />
* Wird kein Audiofile angegeben, wird nur die Verbindung hergestellt und nach der Anrufdauer wieder unterbrochen.<br />
* Anmerkung: Das Audiofile muss das Format PCM/8000 haben.<br />
* Der angerufene nimmt das Gespräch entgegen, das Audiofile wird abgespielt.<br />
<br />
=== Anruf tätigen und DTMF-Töne senden ===<br />
* Den Anruf initiieren<br />
: <code>set <device> call <nummer> <klingelzeit> <-tatstenkombination></code><br />
* Die Tastenkombination muss mit einem Minus(-) nach der Zielnummer folgen, also z.B. **1 -#23<br />
* Der angerufene nimmt das Gespräch entgegen, die Tonfolge wird abgespielt<br />
<br />
=== Auf Anruf warten und DTMF-Töne empfangen ===<br />
* Der SIP-Client wird in den Listen-Modus versetzt.<br />
: Das Attribut sip_listen auf '''dtmf''' setzen und<br />
: <code>set <device> listen</code><br />
* Die Nebenstelle des SIP-Clients wird von einem DTMF-fähigen Telefon aus angerufen.<br />
* Wenn der SIP-Client das Gespräch angenommen hat betätigt man '''#''', gefolgt von zwei Ziffern und legt dann wieder auf.<br />
* Im Reading '''dtmf''' ist die zweistellige Zahl zu sehen.<br />
<br />
=== Auf Anruf warten und kontrolliert annehmen ===<br />
* Der SIP-Client wird in den Listen-Modus versetzt.<br />
: Das Attribut sip_listen auf '''wfp''' setzen und<br />
: <code>set <device> listen</code><br />
* Die Nebenstelle des SIP-Clients wird angerufen.<br />
* Im Reading '''caller''' ist die Nummer bzw. die Info des Callers zu sehen.<br />
* Soll der Anruf angenommen werden setze ich den Status des Devices mittels set auf '''fetch''':<br />
: <code>set <device> fetch</code><br />
* Der SIP-Client nimmt den Anruf an und spielt das im Attribut sip_audiofile angegebene File ab.<br />
* Der SIP-Client legt auf und geht wieder in den Status '''listen_for_wfp'''.<br />
<br />
=== Fritzbox + Doorline - Telefonklingeln beenden ===<br />
Szenario: Als Türklingel ist eine Doorline im Einsatz die auf Direktannahme eingestellt ist. Klingelt jemand an der Tür, erfolgt ein 'Anruf' an die in der Rufgruppe definierten Telefone. Man kann den Anruf entgegennehmen, um zu hören wer an der Tür ist, bevor man die Tür öffnet. Geht man direkt zur Tür, klingeln die Telefone insgesamt 30 Sekunden lang bis sie verstummen. Hat man die Haustür mit einem Türkontakt versehen, hilft folgender Ansatz:<br />
* Der SIP-Client wird in der Fritzbox in die Rufgruppe der Türklingel aufgenommen.<br />
* Der SIP-Client wird in den Listen-Modus 'wait-fetch-play' versetzt (Die sip_waittime sollte größer als die Klingeldauer der Doorline sein).<br />
: <code>set <device> listenwfp</code><br />
* Klingelt jemand an der Tür, wird unter anderem die Nebenstelle des SIP-Clients angerufen.<br />
* Über ein DOIF greift man die Kombination SIP-Client-Status 'ringing' und Haustürkontakt closed->open ab und<br />
* setzt den Status des Devices mittels set auf fetch:<br />
: <code>set <device> fetch</code><br />
* Der SIP-Client nimmt den Anruf an und spielt das im Attribut sip_audiofile angegebene File ab.<br />
* Die Telefone verstummen.<br />
<br />
== Bekannte Probleme / Fehlersuche ==<br />
=== Fehler bei der Registrierung an der Fritzbox ===<br />
'''Fritzbox'''<br />
* Ist das Device für den SIP-Client in der Fritzbox unter Telefonie > Telefoniegräte gelistet? <br />
* Geräteeinstellungen ändern: Ist für das Device unter 'Anmeldedaten' die Durchwahl als Benutzername angegeben?<br />
* Ist der in dieser Ansicht angegebene 'Registrar' mit der im Attribut sip_registrar identisch? Im Zweifelsfalle die IP-Adresse statt 'fritz.box' verwenden.<br />
* FitzOS ab 6.80: Wurde nach Definition des Gerätes an einem anderen bekannten Gerät der Bestätigungscode eingegeben?<br />
'''FHEM'''<br />
<br />
Attribute des Devices prüfen:<br />
* Ist unter sip_from <nowiki>'sip:620@fritz.box'</nowiki> mit der von der Fritzbox vergebene Durchwahl angegeben?<br />
* Ist unter sip_user die von der Fritzbox vergebene Durchwahl angegeben?<br />
* Ist unter sip_password das in der Fritzbox hinterlegte Passwort eingetragen?<br />
* Ist unter sip_registrar die IP-Adresser der Fritzbox eingetragen?<br />
* Ist unter sip_ip die IP-Adresse des FHEM-Servers eingetragen (z.B. 192.168.178.47 angeben, keine Adresse aus dem 127er-Segment)?<br />
<br />
== Links ==<br />
* {{Link2Forum|Topic=40219|LinkText=Forenthread}} alter Forum-Thread zu FB_SIP.pm und SIP.pm<br />
* {{Link2Forum|Topic=67443|LinkText=Forenthread}} Forum-Thread zu diesem Modul SIP<br />
<br />
[[Kategorie:Hilfsmodul]] <br />
<!-- (Modulkategorie wird automatisch gesetzt) --></div>Wzuthttp://wiki.fhem.de/w/index.php?title=SIP-Client&diff=20102SIP-Client2017-02-19T18:25:45Z<p>Wzut: Korrektur DTMF</p>
<hr />
<div>{{Infobox Modul<br />
|ModPurpose=SIP-Client für FHEM <br />
|ModType=d<br />
|ModForumArea=Hilfsmodul<br />
|ModTechName=96_SIP.pm<br />
|ModOwner=Wzut ({{Link2FU|1172|Forum}} / [[Benutzer Diskussion:Wzut|Wiki]])}}<br />
<br />
Das Modul '''SIP''' ermöglicht die Entgegennahme (DTMF-Töne interpretieren, kontrollierte Annahme) sowie die Durchführung (Audiofile abspielen, DTMF-Töne senden) von Anrufen.<br />
<br />
<br />
== Voraussetzungen ==<br />
=== FHEM-Server ===<br />
Für den Remote-Zugang muss das Modul Net::SIP installiert sein; auf einem Raspberry Pi oder unter Ubuntu z.&nbsp;B. mit dem Befehl<br />
:<code>sudo cpanm install Net::SIP</code><br />
<br />
oder auch<br />
<br />
:<code>sudo apt-get install libnet-sip-perl</code><br />
<br />
=== SIP-Server ===<br />
Der SIP-Client muss sich an einem SIP-Server anmelden (Fritzbox, Asterisk, VoIP-Provider). <br />
Auf dem SIP-Server, mit dem sich der Client konnektieren soll, muss ein User-Account vorhanden sein bzw. angelegt werden. <br />
In der Fritzbox muss z.B. ein neues Telefoniegerät vom Typ LAN/WLAN angelegt und ein Passwort vergeben werden. Das erzeugt ein neues internes Device im Bereich **62x, typischerweise die 620. Es sollte kontrolliert werden, ob bei den Anmeldeinformationen der Benutzername der Nebenstelle entspricht (z.B. 620) und ein Passwort eingetragen ist.<br />
<br />
== Installation ==<br />
=== Erste Schritte ===<br />
Spätestens nach einem 'update all' sollte das Modul '''96_SIP.pm''' verfügbar sein.<br />
<br />
Danach wird es im FHEM-Webinterface mittels <br />
:<code>reload 96_SIP.pm</code><br />
geladen.<br />
<br />
Nun ist der SIP-Client als Device in FHEM anzulegen:<br />
<br />
:<code>define <name> SIP</code><br />
<br />
Anschließend sollten alle sip_Attribute geprüft und für die eigene Umgebung gesetzt werden.<br />
<br />
=== mögliche Fehlermeldungen ===<br />
Sollte schon bei <code>define mySIP SIP</code> die Fehlermeldung kommen, dass dieses Modul nicht existiert, dann bitte 'update all' durchführen.<br />
<br />
== Anwendung ==<br />
=== Define ===<br />
<br />
<code>define <name> SIP</code><br />
<br />
Anschließend sollten alle sip_Attribute geprüft und für die eigene Umgebung gesetzt werden.<br />
<br />
Siehe auch [http://fhem.de/commandref_DE.html#SIP commandref]<br />
<br />
=== Attribute ===<br />
<br />
* '''sip_audiofile'''<br />
: Audiofile das nach dem Command '''fetch''' abgespielt wird. Das Audiofile muss mit folgendem Command erzeugt werden<br />
: '''sox <file>.wav -t raw -r 8000 -c 1 -e a-law <file>.alaw'''<br />
: da nur das raw audio format unterstützt wird.<br />
* '''sip_listen'''<br />
: Das Attribut bietet folgende Optionen<br />
: - '''none''': keine Aktion<br />
: - '''dtmf''': Beim FHEM-Start geht das Device automatisch in den Status listen und wartet auf DTMF-Anrufer.<br />
: - '''wfp''': Beim FHEM-Start geht das Device automatisch in den Status listen wait-fetch-play.<br />
* '''sip_from'''<br />
: Meine SIP-Client-Info. Default ist sip:620@fritz.box<br />
* '''sip_ip'''<br />
: Die IP-Addresse meines FHEM-Servers.<br />
* '''sip_port'''<br />
: Port der für den SIP-Client genutzt wird. Default ist 5060 und wird automatisch um 10 erhöht wenn der Port nicht frei ist.<br />
* '''sip_registrar'''<br />
: Hostname oder IP-Addresse des SIP-Servers mit dem sich der Client verbindet. Default ist fritz.box.<br />
* '''sip_ringtime'''<br />
: Klingelzeit für ausgehende Anrufe.<br />
* '''sip_user'''<br />
: User Name des SIP-Clients. Defualt ist 620.<br />
* '''sip_waits'''<br />
: Interne Wartezeit in Sekunden bevor nach nicht erfolgreichem listen ein erneuter Versuch gestartet wird. <br />
* '''sip_waittime'''<br />
: Maximale Wartezeit des Commands listenwfp bis das Gespräch automatisch angenommen wird.<br />
<br />
Siehe auch [http://fhem.de/commandref_DE.html#SIP commandref]<br />
<br />
=== Set ===<br />
<br />
Das Modul kennt derzeit folgende Commands<br />
<br />
* set <name> '''reset'''<br />
<br />
: Stoppt laufende listen-Prozess und initalisiert das Device.<br />
<br />
* set <name> '''call <nummer> [<ringtime>] [<nachricht>]'''<br />
: Startet einen Anruf an die angegebene Nummer.<br />
: Optional kann die ringtime angegeben werden. Wird keine angegeben zieht das Attribut sip_ringtime. Default ist 10.<br />
: Optional kann eine Nachricht in Form eines Audiofiles angegeben werden. Das File ist mit dem vollen Pfad oder dem relativen ab dem Verzeichnis mit fhem.pl anzugeben.<br />
<br />
* set <name> '''listen'''<br />
: Manueller Start des listen-Prozesses:<br />
: Der SIP-Client wird in einen Status versetzt in dem er automatisch Anrufe annimmt oder . Dem Anrufer wird der Ton wird als Echo zurückgespielt. Über die Eingabe von '''#''' gefolgt von 2 Zahlen und anschließendem Auflegen kann eine Zahl in das Reading '''dtmf''' übergeben werden. Voraussetzung: Das anrufende Telefon ist auf Tonwahl gestellt (DTMF).<br />
: Der SIP-Client wird in einen Status versetzt in dem er auf Anrufe wartet (wfp steht für wait-fetch-play). Erfolgt an Anruf an den Client, wechselt der Status zu ringing. Nun kann das Gespräch via set-Command fetch angenommen werden. Das als sip_audiofile angegebene File wird abgespielt. Anschließend wechselt der Status wieder zu listenwfp.<br />
<br />
<br />
=== Readings ===<br />
<br />
<br />
* '''caller''': Die Rufnummer bzw. Info des aktuellen Anrufers. Default-Wert ist '-'.<br />
* '''dtmf''': Die via Tonwahl (DTMF) eingegebenen Zahlen.<br />
* '''state''': Der Status des Devices.<br />
<br />
== Anwendungsbeispiele ==<br />
<br />
=== Anruf tätigen und Sound abspielen ===<br />
* Den Anruf initiieren<br />
: <code>set <device> call <nummer> [<dauer>] [<audiofile>]</code><br />
* Die Default-Dauer beträgt 10 Sekunden.<br />
* Wird kein Audiofile angegeben, wird nur die Verbindung hergestellt und nach der Anrufdauer wieder unterbrochen.<br />
* Anmerkung: Das Audiofile muss das Format PCM/8000 haben.<br />
* Der angerufene nimmt das Gespräch entgegen, das Audiofile wird abgespielt.<br />
<br />
=== Anruf tätigen und DTMF-Töne senden ===<br />
* Den Anruf initiieren<br />
: <code>set <device> call <nummer> <tatstenkombination></code><br />
* Die Tastenkombination muss mit einem Minus(-) nach der Zielnummer folgen, also z.B. **1 -#23<br />
* Der angerufene nimmt das Gespräch entgegen, die Tonfolge wird abgespielt<br />
<br />
=== Auf Anruf warten und DTMF-Töne empfangen ===<br />
* Der SIP-Client wird in den Listen-Modus versetzt.<br />
: <code>set <device> listendtmf</code><br />
* Die Nebenstelle des SIP-Clients wird von einem DTMF-fähigen Telefon aus angerufen.<br />
* Wenn der SIP-Client das Gespräch angenommen hat betätigt man '''#''', gefolgt von zwei Ziffern und legt dann wieder auf.<br />
* Im Reading '''dtmf''' ist die zweistellige Zahl zu sehen.<br />
<br />
=== Auf Anruf warten und kontrolliert annehmen ===<br />
* Der SIP-Client wird in den Listen-Modus versetzt.<br />
: <code>set <device> listenwfp</code><br />
* Die Nebenstelle des SIP-Clients wird angerufen.<br />
* Der Status des Devices wechselt auf '''ringing'''.<br />
* Im Reading '''caller''' ist die Nummer bzw. die Info des Callers zu sehen.<br />
* Soll der Anruf angenommen werden setze ich den Status des Devices mittels set auf '''fetch''':<br />
: <code>set <device> fetch</code><br />
* Der SIP-Client nimmt den Anruf an und spielt das im Attribut sip_audiofile angegebene File ab.<br />
* Der SIP-Client legt auf und geht wieder in den Status '''listenwfp'''.<br />
<br />
=== Fritzbox + Doorline - Telefonklingeln beenden ===<br />
Szenario: Als Türklingel ist eine Doorline im Einsatz die auf Direktannahme eingestellt ist. Klingelt jemand an der Tür, erfolgt ein 'Anruf' an die in der Rufgruppe definierten Telefone. Man kann den Anruf entgegennehmen, um zu hören wer an der Tür ist, bevor man die Tür öffnet. Geht man direkt zur Tür, klingeln die Telefone insgesamt 30 Sekunden lang bis sie verstummen. Hat man die Haustür mit einem Türkontakt versehen, hilft folgender Ansatz:<br />
* Der SIP-Client wird in der Fritzbox in die Rufgruppe der Türklingel aufgenommen.<br />
* Der SIP-Client wird in den Listen-Modus 'wait-fetch-play' versetzt (Die sip_waittime sollte größer als die Klingeldauer der Doorline sein).<br />
: <code>set <device> listenwfp</code><br />
* Klingelt jemand an der Tür, wird unter anderem die Nebenstelle des SIP-Clients angerufen.<br />
* Der Status des Devices wechselt auf '''ringing'''.<br />
* Über ein DOIF greift man die Kombination SIP-Client-Status 'ringing' und Haustürkontakt closed->open ab und<br />
* setzt den Status des Devices mittels set auf fetch:<br />
: <code>set <device> fetch</code><br />
* Der SIP-Client nimmt den Anruf an und spielt das im Attribut sip_audiofile angegebene File ab.<br />
* Die Telefone verstummen.<br />
<br />
== Bekannte Probleme / Fehlersuche ==<br />
=== Fehler bei der Registrierung an der Fritzbox ===<br />
'''Fritzbox'''<br />
* Ist das Device für den SIP-Client in der Fritzbox unter Telefonie > Telefoniegräte gelistet? <br />
* Geräteeinstellungen ändern: Ist für das Device unter 'Anmeldedaten' die Durchwahl als Benutzername angegeben?<br />
* Ist der in dieser Ansicht angegebene 'Registrar' mit der im Attribut sip_registrar identisch? Im Zweifelsfalle die IP-Adresse statt 'fritz.box' verwenden.<br />
* FitzOS ab 6.80: Wurde nach Definition des Gerätes an einem anderen bekannten Gerät der Bestätigungscode eingegeben?<br />
'''FHEM'''<br />
<br />
Attribute des Devices prüfen:<br />
* Ist unter sip_from 'sip:620@fritz.box' mit der von der Fritzbox vergebene Durchwahl angegeben?<br />
* Ist unter sip_user die von der Fritzbox vergebene Durchwahl angegeben?<br />
* Ist unter sip_password das in der Fritzbox hinterlegte Passwort eingetragen?<br />
* Ist unter sip_registrar die IP-Adresser der Fritzbox eingetragen?<br />
* Ist unter sip_ip die IP-Adresse des FHEM-Servers eingetragen (z.B. 192.168.178.47 angeben, keine Adresse aus dem 127er-Segment)?<br />
<br />
== Links ==<br />
* {{Link2Forum|Topic=40219|LinkText=Forenthread}} alter Forum-Thread zu FB_SIP.pm und SIP.pm<br />
* {{Link2Forum|Topic=29725|LinkText=Forenthread}} Forum-Thread zu diesem Modul SIP<br />
<br />
[[Kategorie:Hilfsmodul]] <br />
<!-- (Modulkategorie wird automatisch gesetzt) --></div>Wzuthttp://wiki.fhem.de/w/index.php?title=Ubiquit_mFi/mPower&diff=18594Ubiquit mFi/mPower2017-01-19T14:45:19Z<p>Wzut: /* Hinweis zum Betrieb mit FHEM */</p>
<hr />
<div>== Ubiquiti mFi/mPower ==<br />
<br />
'''Ubiquiti mFi/mPower IP Steckdosen'''<br />
<br />
Über WiFi/LAN schaltbare Steckdosenleiste mit Verbrauchsmessung. (LAN nur mit Pro Version)<br />
<br />
== Features ==<br />
230V IP-Steckdosenleiste mit unterschiedlicher Portanzahl. Jede Steckdose kann extra per Befehl geschaltet werden. Die angeschlossene Last wird gemessen und stellt folgende Werte pro Port zur Verfügung:<br />
* Stromaufnahme<br />
* Stromspannung <br />
* Wirkleistungsfaktor<br />
* aktuelle Energieaufnahme<br />
* verbrauchte Energie - aktuelles Monat (ab Firmware 2.1.x)<br />
* verbrauchte Energie - Vormonat (ab Firmware 2.1.x)<br />
<br />
Protokolle<br />
* http, https, HTTPS, telnet, ssh, ntp<br />
<br />
== Allgemein ==<br />
Die Leisten lassen sich komplett per Web Browser flashen,bedienen und konfigurieren. <br /><br />
Die Standard Login-Zugangsdaten zur Ubi-WEB-UI lauten: User:ubnt / Passwort: ubnt<br />
<br />
<br />
Grundsätzlich waren die Geräte in Verbindung mit der Ubiquiti Kontroller Software vorgesehen, können nun aber auch problemlos "standalone" verwendet werden.<br />
<br />
Alle hier in diesem WIKI zusammengestellten Informationen beziehen sich auf die Verwendung der Leisten '''ohne''' Ubiquiti Kontrollersoftware.<br />
<br />
Bei Lieferungen im April 2015 war auf allen Leisten die Firmware Version 2.0.8 installiert. Diese Firmware bietet nur rudimentäre Funktionen und auch die Energiemessung funktioniert nur in Verbindung mit der 64-Bit Java-Kontrollersoftware.<br />
'''Darum ist ein Firmwareupdate auf mind. 2.1.8 (Stand 2/2015) notwendig.'''<br />
<br />
== Bekannte Probleme ==<br />
<br />
=== Verhalten nach Stromausfall===<br />
Nach einem Stromausfall (bzw. direkt nach dem Einstecken in eine Steckdose) werden die Ports nach dem Starten der Firmware immer eingeschaltet.<br />
Das gilt allerdings nur ohne der Verwendung der Ubiquiti Kontrollersoftware.<br />
<br />
=== Auslieferungsfirmware Version 2.0.8 ===<br />
* In dieser Version funktioniert die Energiemessung im Standalone-Modus nicht. <br />
* Keine Möglichkeit die Zeitzone sowie die NTP Zeit-Synchronistaion über die WEB-UI einzustellen.<br />
<br />
''' Lösung: Firmware auf mind. 2.1.8 upgraden.'''<br />
<br />
=== Zeitsynchronisation ===<br />
Wenn die NTP Zeitsynchronisation mit der erforderliche Zeitzone nicht eingestellt wird, funktionieren gewisse Dinge wie z. B. das Summieren der Verbrauchswerte nicht.<br />
<br />
Darum muss unbedingt der NTP Sync in der WEB-UI der Leiste nach dem Upgrade auf 2.1.8, wie in diesem Wiki beschrieben, eingestellt werden.<br />
<br />
=== WiFi Frequenzen / Kanäle ===<br />
Es wurde beobachtet, dass sich die Leisten bei der Verwendung des WiFi Kanals 13 (2472 MHz) nicht verbinden. <br />
Dieses Verhalten wurde sogar bei Kanälen ab 8 (2447 MHz) beobachtet.<br />
Dabei wurde die Firmware 2.1.8 und 2.1.11 verwendet.<br />
<br />
''' Lösung: WiFi Kanal von 1 - 7 (2412 MHz - 2442 MHz) bei den WLAN-Accesspoints einstellen. '''<br />
<br />
=== WiFi Reconnects alle 2 Minuten ===<br />
Wird kein Software-Kontroller verwendet und ist WiFi mit WPA Verschlüsselung eingestellt verliert die Leiste immer die Verbindung zum Accesspoint.<br><br />
Der Grund ist ein periodischer Neustart des WPA Dienstes in der Leiste. Auch ein Update auf die Version 2.1.11 hat das Problem nicht beseitigt.<br />
[http://community.ubnt.com/t5/mFi/mFi-mPower-mini-disassociates-and-reassociates-to-WiFi-AP-every/m-p/1372786 Eintrag im Ubnt Forum]<br />
<br />
''' Lösung: Im Moment stellt nur die Verwendung der unsicheren WEP Verschlüsselung das Problem ab. '''<br />
<br />
== Firmware Versionen ==<br />
Folgende Versionen wurden von Ubiquiti zum Download freigegeben.<br />
<br />
* 2.0.7<br />
* 2.0.8 (Download nicht auffindbar - Standard-Auslieferungsversion? <br />
* 2.0.12<br />
* 2.0.13<br />
* 2.0.14<br />
* 2.0.15<br />
* 2.0.23<br />
* 2.0.24<br />
* 2.1.1<br />
* 2.1.2<br />
* 2.1.3<br />
* 2.1.4<br />
* 2.1.5<br />
* 2.1.8 - 2015-02-26<br />
* 2.1.11 - 2015-04-16<br />
<br />
== Modelle EU Raum ==<br />
* 1 Port / P1E / WiFi<br />
* 3 Port / P3E / WiFi<br />
* 6 Port / P6E / WiFi & LAN (Pro Version)<br />
<br />
=== Spezifikationen mPower Pro (EU)===<br />
[[Datei:Ubi-mPower6eu.jpg|200px|thumb|right|mPower 6 Port EU]]<br />
* Größe: 250.37 x 116.7 x 49 mm<br />
* Gewicht: 754,4g<br />
* Spannung: 220-250VAC, 50Hz, 16A pro Ausgang, 16A Gesamt<br />
* Ausgänge: 6<br />
* Speicher: 16 MB RAM, 8 MB Flash<br />
* LAN: 1 x 10/100 Ethernet<br />
* WiFi Standard: 802.11b/g/n<br />
* LEDs: 1 LED Status<br />
* Betriebstemperatur: 0 bis 40°C<br />
* Luftfeuchte: 10 bis 90% Nichtkondensierend<br />
<br />
=== Spezifikationen mPower (EU)===<br />
[[Datei:Ubi-mPower3eu.jpg|200px|thumb|right|mPower 3 Port EU]]<br />
* Größe: 240 x 82.8 x 41.5 mm<br />
* Gewicht: 545g<br />
* Spannung: 220-250VAC, 50Hz, 16A pro Ausgang, 16A Gesamt<br />
* Ausgänge: 3<br />
* Speicher: 16 MB RAM, 8 MB Flash<br />
* WiFi Standard: 802.11b/g/n<br />
* LEDs: 1 LED Status<br />
* Betriebstemperatur: -10 bis 45°C<br />
* Luftfeuchte: 95% max.<br />
<br />
=== Spezifikationen mPower mini (EU)===<br />
[[Datei:Ubi-mPower1eu.jpg|100px|thumb|right|mPower 1 Port EU]]<br />
* Größe: 110.8 x 71 x 67.7 mm<br />
* Gewicht: 170g<br />
* Spannung: 220-250VAC, 50Hz, 10A <br />
* Ausgänge: 1<br />
* Speicher: 16 MB RAM, 8 MB Flash<br />
* WiFi Standard: 802.11b/g/n<br />
* LEDs: 1 LED Status<br />
* Betriebstemperatur: 0 bis 40°C<br />
* Luftfeuchte: 10 bis 90% Nichtkondensierend<br />
<br />
== Hinweis zum Betrieb mit FHEM ==<br />
Die Geräte können mit dem Modul 98_UbiquitiMP gesteuert werden.<br><br />
Weitere Infos dazu sind in dieser [http://forum.fhem.de/index.php/topic,35722.0.html Diskussion im Fhem Forum]zu finden.<br />
<br />
== Ersteinrichtung ohne Controller == <br />
<br />
=== Ersteinrichtung der Leiste ohne Controller / Iphone ===<br />
<br />
Smartphone / z.B. mit dem Iphone unter IOS7 <br /><br />
Ubiquiti Auslieferungs-Firmware Version: 2.0.8 (oder alle 2.x Versionen)<br />
<br />
# Reset der Leiste mit "Factory reset" - Drücken der reset Taste auf der Leiste für mindestend 10 Sekunden. <br />Die Leiste startet neu hoch und erstellt einen Accesspoint mit einer eigenen SSID mit dem Namen mfi-xxxxx. <br />
# Verbinden mit dem neuen WLAN Netzwerk - nach ein paar Sekunden erscheint die UBI-Web Oberfläche automtatisch. (Captive Portal). <br /> Einfach warten, bis das Portal erscheint, das kann schon mal 10 bis 20 Sekunden dauern. <br />
# Sobald das Portal sichtbar ist, das eigene WLAN auswählen und die Zugangsdaten eingeben.<br />
# Danach den mFi Account konfigurieren. Dabei ist der Eintrag Personal auszuwählen und alles andere frei zu lassen. <br />
# Apply dücken, die mPower Leiste startet neu und nach ca. 1 Minute sollte sie sich mit dem WiFi verbunden haben und per DHCP eine IP-Adresse erhalten haben. <br />
# Um die IP-Adresse herauszufinden, einfach das [http://www.ubnt.com/downloads/discovery/ubnt-discovery-v2.3.zip IP-Address Ubiquiti Discovery Tool v2.3] runterladen und entpacken. <br />Dann die .bat oder die .jar Datei doppelklicken und das Tool sucht im lokalen Netz nach UBI-Produkten. <br />
# Nun die Firmware Version 2.1.8 von http://www.ubnt.com/downloads/mfi/2.1.8/firmware/M2M/firmware.bin downloaden. <br /> Ab der 2.1x Version gibt es für alle Leisten (1-Port, 3-Port und 6 Port) die selbe firmware.bin <br />
# Jetzt wird die Leiste mit einem Browser geflasht (am Besten mit Firefox) indem man auf die IP der Leiste geht und direkt zur upgrade.cgi surft. <br /> '''<nowiki> http://IP-UBILeiste/upgrade.cgi</nowiki>''' - Username=ubnt / Passwort=ubnt <br />Wenn das Upgrade fertig ist bleibt der Updatebalken bei 100% stehen. <br />
# '''Nach dem Updaten die Ports der Leiste über die WEB Oberfläche aus- und einschalten.''' <br />Ab sofort zählt sie dann auch die verbrauchte Energie wie gewünscht ohne Ubi-Kontroller!<br />
# Weiter geht es mit der Einrichtung der [[#Einstellung_der_Timezone_und_NTP_Timesync|Zeitzone/Timesync]]<br />
<br />
----<br />
Screenshots Iphone:<br />
<gallery><br />
File:Ubi-discoverytool.JPG|Ubi Discovery Toolbox<br />
File:Iphone-captive1.jpg|Captive Portal - select WiFi Network / mFi Account<br />
File:Iphone-captive2.jpg|Captive Portal - select mFi Account<br />
File:upgrade-2-0-8.jpg|UBI Web UI - upgrade.cgi<br />
File:upgrade-2-0-8-final.jpg|UBI Web UI - upgrade.cgi done<br />
<br />
</gallery><br />
<br />
=== Ersteinrichtung der Leiste ohne Controller / Windows7 ===<br />
Ubiquiti Auslieferungs-Firmware Version: 2.0.8 (oder alle 2.x Versionen)<br />
<br />
# Reset der Leiste mit "Factory reset" - Drücken der reset Taste auf der Leiste für mindestend 10 Sekunden. <br />Die Leiste startet neu hoch und erstellt einen Accesspoint mit einer eigenen SSID mit dem Namen mfi-xxxxx. <br />
# Verbinden des PC mit dem neuen WLAN Netzwerk. <br />
# Warten bis das Fenster zum neuen Netzwerk erscheint - dann Heimnetzwerk wählen. <br />
# Dann mit dem Firefox auf <nowiki> http://192.168.2.20 </nowiki> gehen und eine Ausnahme für das Zertifikat hinzufügen. <br />
# Es erschein die Konfigurationsseite. Dort Network scannen und die Security Daten des WLAN eingeben. '''Beim mFi Account ist NICHTS auszuwählen - alles leer lassen! '''<br />
# Apply dücken. Die mPower Leiste startet neu und nach ca. 1 Minute sollte sie sich mit dem WiFi verbunden haben und per DHCP eine IP-Adresse erhalten haben <br />
# Um die IP-Adresse herauszufinden, einfach das [http://www.ubnt.com/downloads/discovery/ubnt-discovery-v2.3.zip IP-Address Ubiquiti Discovery Tool v2.3] runterladen und entpacken. <br />Dann die .bat oder die .jar Datei doppelklicken und das Tool sucht im lokalen Netz nach UBI-Produkten. <br />
# Nun die Firmware Version 2.1.8 von http://www.ubnt.com/downloads/mfi/2.1.8/firmware/M2M/firmware.bin downloaden. <br /> Ab der 2.1x Version gibt es für alle Leisten (1-Port, 3-Port und 6 Port) die selbe firmware.bin.<br />
# Vor dem Flashen mit dem Browser normal auf die Leiste surfen. <nowiki> http://IP-Leiste</nowiki> <br /> Wechseln zum Reiter Configuration. Wenn nochmal die Konfigurationsseite kommen sollte, einfach den Kontroller neu einstellen - alles leer lassen. <br />
# Jetzt wird die Leiste mit einem Browser geflasht (am Besten mit Firefox) indem man auf die IP der Leiste geht und direkt zur upgrade.cgi surft. <br /> '''<nowiki> http://IP-UBILeiste/upgrade.cgi</nowiki>''' - Username=ubnt / Passwort=ubnt <br />Wenn das Upgrade fertig ist bleibt der Updatebalken bei 100% stehen. <br />
# '''Nach dem Updaten die Ports der Leiste über die WEB Oberfläche aus- und einschalten.''' <br />Ab sofort zählt sie dann auch die verbrauchte Energie wie gewünscht ohne Ubi-Kontroller!<br />
# Weiter geht es mit der Einrichtung der [[#Einstellung_der_Timezone_und_NTP_Timesync|Zeitzone/Timesync]]<br />
<br />
<br />
----<br />
Screenshots:<br />
<gallery><br />
File:Pc-wlan1.jpg|WiFi verbinden<br />
File:Pc-wlan2-netzwerk.JPG|Netztwerktyp<br />
File:Pc-wlan3-firefox.JPG|Firefox Zertifikat 1<br />
File:Pc-wlan4-firefox.JPG|Firefox Zertifikat 2<br />
File:Pc-wlan5-firefox.JPG|UBI Config UI<br />
File:Pc-wlan7-firefox.JPG|UBI Config UI<br />
File:Iphone-captive2.jpg|UBI FW 2.0.8 UI<br />
<br />
<br />
</gallery><br />
<br />
<br />
=== Update alter 1er Firmware ===<br />
<br />
Eine uralte Firmware (vor 2.0) auf die 2.1.8 Version upzudaten ist nur per Telnet/SSH/SCP möglich.<br />
<br />
# Windows Benutzer bitte Putty downloaden. Es wird pscp und putty benötigt. Alle Dateien in ein einfach zu ereichendes Verzeichnis wie z.B. c:\temp downloaden.<br />http://the.earth.li/~sgtatham/putty/latest/x86/pscp.exe<br />http://the.earth.li/~sgtatham/putty/latest/x86/putty.exe <br /> Linux Benutzer sollten ssh installiert haben.<br />
# Die Firmware Version 2.1.8 von http://www.ubnt.com/downloads/mfi/2.1.8/firmware/M2M/firmware.bin downloaden. <br /> Ab der 2.1x Version gibt es für alle Leisten (1-Port, 3-Port und 6 Port) die selbe firmware.bin. <br /> Linux User Download mit: <br /><code><nowiki> wget http://www.ubnt.com/downloads/mfi/2.1.8/firmware/M2M/firmware.bin </nowiki> </code><br />
# Reset der Leiste mit "Factory reset" - Drücken der reset Taste auf der Leiste für mindestend 10 Sekunden. <br />Die Leiste startet neu hoch und erstellt einen Accesspoint mit einer eigenen SSID mit dem Namen mfi-xxxxx. <br />
# Verbinden mit dem neuen WLAN Netzwerk. Die IP Adresse der Leiste lautet: 192.168.2.20.<br />
# Windows Nutzer gehen auf die Eingabeaufforderung und wechseln in das Verzeichnis c:\temp. <br /> <code>c: <ENTER> <br />cd \temp <Enter> </code><br />
# Dann wird die Firmware übertragen. Benutzername und Passwort lauten ubnt <br /> Windows:<br /> <code> pscp.exe -scp firmware.bin ubnt@192.168.2.20:/tmp/fwupdate.bin </code> <br /> Linux: <br /><code> scp firmware.bin ubnt@192.168.2.20:/tmp/fwupdate.bin </code><br />
# Nun mit SSH oder Telnet auf die Leiste gehen. Login: ubnt / Passwort: ubnt <br /> Windows:<br /> <code> putty.exe -telnet 192.168.2.20 </code><br /> Linux: <br /> <code> ssh ubnt@192.168.2.20 </code><br />
# Jetzt das Firmware-Flashen anstoßen. Das abschließende & Zeichen nicht vergessen! <br/> Windows und Linux: <br /> <code> /sbin/syswrapper.sh upgrade2 & </code><br />
# Die LED der Leiste blinkt nach kurzer Zeitg abwechselnd orange und blau. Diesen Vorgang nicht unterbrechen!! Nach ein paar Minuten ist der Vorgang beendet. <br />
# Abschließend noch mal einen Hardware Reset mit der Taste, wie am Anfang, machen. <br />
# Nun kann die Leiste, wie in der Ersteinrichtung beschrieben, konfiguriert werden. Die Updateprozeduren müssen natürlich nicht nochmal ausgeführt werden.<br />
<br />
=== Einstellung der Timezone und NTP Timesync ===<br />
Die UBI-Web-UI der Firmware 2.1.8 zeigt 2 neue Reiter System und Machines.<br />
Im Reiter System wird die Zeitzone eingestellt. <br /> GMT+1 Central European Time (Daylight Savings) und aktivieren Enable NTP Client mit dem Server pool-ntp.org. <br /><br />
Dann den Button "Change" klicken und "Configuration contains changes. Apply these changes? APPLY"<br />
<br />
<br />
Ab sofort hat die Leiste immer die richtige Zeit.<br />
<br />
<gallery><br />
<br />
File:ubi-fw-2.1.8-ui.jpg|Web UI 2.1.8<br />
File:ubi-zeitzone.jpg|Zeitzoneneinstellung<br />
<br />
</gallery><br />
<br />
== Links ==<br />
* Website von Ubiquiti[http://www.ubnt.com/]<br />
* PDF Datenblatt mFi/mPower [http://dl.ubnt.com/datasheets/mfi/mFi_DS.pdf]<br />
* Forum des Herstellers [http://community.ubnt.com/t5/mFi/bd-p/mFi]<br />
* mFi/mPower Firmware release 2.1.8 (2/2015) [http://community.ubnt.com/t5/mFi/mFi-release-2-1-8/td-p/1188368/jump-to/first-unread-message]<br />
* mFi/mPower Firmware release 2.1.11 (4/2015) [http://community.ubnt.com/t5/mFi/mFi-release-2-1-11/m-p/1230774]<br />
* Upgrade Prozedur aus dem Ubiquiti Forum [https://community.ubnt.com/t5/mFi-Frequently-Asked-Questions/mFi-Can-I-upgrade-mFi-device-firmware-manually/ta-p/485311]<br />
* Varia Store Deutschland (Bezugsquelle) [http://varia-store.com/Hardware/UBIQUITI-Networks:::637_734.html]<br />
* Forenbeitrag Fhem: {{Link2Forum|Topic=35722}}<br />
<br />
[[Kategorie:Other Components]]<br />
[[Kategorie:IP Components]]<br />
[[Kategorie:Schalter (Empfänger)]]<br />
[[Kategorie:Energieverbrauchsmessung]]</div>Wzuthttp://wiki.fhem.de/w/index.php?title=Ubiquit_mFi/mPower&diff=18593Ubiquit mFi/mPower2017-01-19T14:43:40Z<p>Wzut: </p>
<hr />
<div>== Ubiquiti mFi/mPower ==<br />
<br />
'''Ubiquiti mFi/mPower IP Steckdosen'''<br />
<br />
Über WiFi/LAN schaltbare Steckdosenleiste mit Verbrauchsmessung. (LAN nur mit Pro Version)<br />
<br />
== Features ==<br />
230V IP-Steckdosenleiste mit unterschiedlicher Portanzahl. Jede Steckdose kann extra per Befehl geschaltet werden. Die angeschlossene Last wird gemessen und stellt folgende Werte pro Port zur Verfügung:<br />
* Stromaufnahme<br />
* Stromspannung <br />
* Wirkleistungsfaktor<br />
* aktuelle Energieaufnahme<br />
* verbrauchte Energie - aktuelles Monat (ab Firmware 2.1.x)<br />
* verbrauchte Energie - Vormonat (ab Firmware 2.1.x)<br />
<br />
Protokolle<br />
* http, https, HTTPS, telnet, ssh, ntp<br />
<br />
== Allgemein ==<br />
Die Leisten lassen sich komplett per Web Browser flashen,bedienen und konfigurieren. <br /><br />
Die Standard Login-Zugangsdaten zur Ubi-WEB-UI lauten: User:ubnt / Passwort: ubnt<br />
<br />
<br />
Grundsätzlich waren die Geräte in Verbindung mit der Ubiquiti Kontroller Software vorgesehen, können nun aber auch problemlos "standalone" verwendet werden.<br />
<br />
Alle hier in diesem WIKI zusammengestellten Informationen beziehen sich auf die Verwendung der Leisten '''ohne''' Ubiquiti Kontrollersoftware.<br />
<br />
Bei Lieferungen im April 2015 war auf allen Leisten die Firmware Version 2.0.8 installiert. Diese Firmware bietet nur rudimentäre Funktionen und auch die Energiemessung funktioniert nur in Verbindung mit der 64-Bit Java-Kontrollersoftware.<br />
'''Darum ist ein Firmwareupdate auf mind. 2.1.8 (Stand 2/2015) notwendig.'''<br />
<br />
== Bekannte Probleme ==<br />
<br />
=== Verhalten nach Stromausfall===<br />
Nach einem Stromausfall (bzw. direkt nach dem Einstecken in eine Steckdose) werden die Ports nach dem Starten der Firmware immer eingeschaltet.<br />
Das gilt allerdings nur ohne der Verwendung der Ubiquiti Kontrollersoftware.<br />
<br />
=== Auslieferungsfirmware Version 2.0.8 ===<br />
* In dieser Version funktioniert die Energiemessung im Standalone-Modus nicht. <br />
* Keine Möglichkeit die Zeitzone sowie die NTP Zeit-Synchronistaion über die WEB-UI einzustellen.<br />
<br />
''' Lösung: Firmware auf mind. 2.1.8 upgraden.'''<br />
<br />
=== Zeitsynchronisation ===<br />
Wenn die NTP Zeitsynchronisation mit der erforderliche Zeitzone nicht eingestellt wird, funktionieren gewisse Dinge wie z. B. das Summieren der Verbrauchswerte nicht.<br />
<br />
Darum muss unbedingt der NTP Sync in der WEB-UI der Leiste nach dem Upgrade auf 2.1.8, wie in diesem Wiki beschrieben, eingestellt werden.<br />
<br />
=== WiFi Frequenzen / Kanäle ===<br />
Es wurde beobachtet, dass sich die Leisten bei der Verwendung des WiFi Kanals 13 (2472 MHz) nicht verbinden. <br />
Dieses Verhalten wurde sogar bei Kanälen ab 8 (2447 MHz) beobachtet.<br />
Dabei wurde die Firmware 2.1.8 und 2.1.11 verwendet.<br />
<br />
''' Lösung: WiFi Kanal von 1 - 7 (2412 MHz - 2442 MHz) bei den WLAN-Accesspoints einstellen. '''<br />
<br />
=== WiFi Reconnects alle 2 Minuten ===<br />
Wird kein Software-Kontroller verwendet und ist WiFi mit WPA Verschlüsselung eingestellt verliert die Leiste immer die Verbindung zum Accesspoint.<br><br />
Der Grund ist ein periodischer Neustart des WPA Dienstes in der Leiste. Auch ein Update auf die Version 2.1.11 hat das Problem nicht beseitigt.<br />
[http://community.ubnt.com/t5/mFi/mFi-mPower-mini-disassociates-and-reassociates-to-WiFi-AP-every/m-p/1372786 Eintrag im Ubnt Forum]<br />
<br />
''' Lösung: Im Moment stellt nur die Verwendung der unsicheren WEP Verschlüsselung das Problem ab. '''<br />
<br />
== Firmware Versionen ==<br />
Folgende Versionen wurden von Ubiquiti zum Download freigegeben.<br />
<br />
* 2.0.7<br />
* 2.0.8 (Download nicht auffindbar - Standard-Auslieferungsversion? <br />
* 2.0.12<br />
* 2.0.13<br />
* 2.0.14<br />
* 2.0.15<br />
* 2.0.23<br />
* 2.0.24<br />
* 2.1.1<br />
* 2.1.2<br />
* 2.1.3<br />
* 2.1.4<br />
* 2.1.5<br />
* 2.1.8 - 2015-02-26<br />
* 2.1.11 - 2015-04-16<br />
<br />
== Modelle EU Raum ==<br />
* 1 Port / P1E / WiFi<br />
* 3 Port / P3E / WiFi<br />
* 6 Port / P6E / WiFi & LAN (Pro Version)<br />
<br />
=== Spezifikationen mPower Pro (EU)===<br />
[[Datei:Ubi-mPower6eu.jpg|200px|thumb|right|mPower 6 Port EU]]<br />
* Größe: 250.37 x 116.7 x 49 mm<br />
* Gewicht: 754,4g<br />
* Spannung: 220-250VAC, 50Hz, 16A pro Ausgang, 16A Gesamt<br />
* Ausgänge: 6<br />
* Speicher: 16 MB RAM, 8 MB Flash<br />
* LAN: 1 x 10/100 Ethernet<br />
* WiFi Standard: 802.11b/g/n<br />
* LEDs: 1 LED Status<br />
* Betriebstemperatur: 0 bis 40°C<br />
* Luftfeuchte: 10 bis 90% Nichtkondensierend<br />
<br />
=== Spezifikationen mPower (EU)===<br />
[[Datei:Ubi-mPower3eu.jpg|200px|thumb|right|mPower 3 Port EU]]<br />
* Größe: 240 x 82.8 x 41.5 mm<br />
* Gewicht: 545g<br />
* Spannung: 220-250VAC, 50Hz, 16A pro Ausgang, 16A Gesamt<br />
* Ausgänge: 3<br />
* Speicher: 16 MB RAM, 8 MB Flash<br />
* WiFi Standard: 802.11b/g/n<br />
* LEDs: 1 LED Status<br />
* Betriebstemperatur: -10 bis 45°C<br />
* Luftfeuchte: 95% max.<br />
<br />
=== Spezifikationen mPower mini (EU)===<br />
[[Datei:Ubi-mPower1eu.jpg|100px|thumb|right|mPower 1 Port EU]]<br />
* Größe: 110.8 x 71 x 67.7 mm<br />
* Gewicht: 170g<br />
* Spannung: 220-250VAC, 50Hz, 10A <br />
* Ausgänge: 1<br />
* Speicher: 16 MB RAM, 8 MB Flash<br />
* WiFi Standard: 802.11b/g/n<br />
* LEDs: 1 LED Status<br />
* Betriebstemperatur: 0 bis 40°C<br />
* Luftfeuchte: 10 bis 90% Nichtkondensierend<br />
<br />
== Hinweis zum Betrieb mit FHEM ==<br />
Die Geräte können mit dem Modul 98_UbiquitiMP gesteuert werden.<br />
Weitere Infos dazu sind in dieser [http://forum.fhem.de/index.php/topic,35722.0.html Diskussion im Fhem Forum]zu finden.<br />
<br />
== Ersteinrichtung ohne Controller == <br />
<br />
=== Ersteinrichtung der Leiste ohne Controller / Iphone ===<br />
<br />
Smartphone / z.B. mit dem Iphone unter IOS7 <br /><br />
Ubiquiti Auslieferungs-Firmware Version: 2.0.8 (oder alle 2.x Versionen)<br />
<br />
# Reset der Leiste mit "Factory reset" - Drücken der reset Taste auf der Leiste für mindestend 10 Sekunden. <br />Die Leiste startet neu hoch und erstellt einen Accesspoint mit einer eigenen SSID mit dem Namen mfi-xxxxx. <br />
# Verbinden mit dem neuen WLAN Netzwerk - nach ein paar Sekunden erscheint die UBI-Web Oberfläche automtatisch. (Captive Portal). <br /> Einfach warten, bis das Portal erscheint, das kann schon mal 10 bis 20 Sekunden dauern. <br />
# Sobald das Portal sichtbar ist, das eigene WLAN auswählen und die Zugangsdaten eingeben.<br />
# Danach den mFi Account konfigurieren. Dabei ist der Eintrag Personal auszuwählen und alles andere frei zu lassen. <br />
# Apply dücken, die mPower Leiste startet neu und nach ca. 1 Minute sollte sie sich mit dem WiFi verbunden haben und per DHCP eine IP-Adresse erhalten haben. <br />
# Um die IP-Adresse herauszufinden, einfach das [http://www.ubnt.com/downloads/discovery/ubnt-discovery-v2.3.zip IP-Address Ubiquiti Discovery Tool v2.3] runterladen und entpacken. <br />Dann die .bat oder die .jar Datei doppelklicken und das Tool sucht im lokalen Netz nach UBI-Produkten. <br />
# Nun die Firmware Version 2.1.8 von http://www.ubnt.com/downloads/mfi/2.1.8/firmware/M2M/firmware.bin downloaden. <br /> Ab der 2.1x Version gibt es für alle Leisten (1-Port, 3-Port und 6 Port) die selbe firmware.bin <br />
# Jetzt wird die Leiste mit einem Browser geflasht (am Besten mit Firefox) indem man auf die IP der Leiste geht und direkt zur upgrade.cgi surft. <br /> '''<nowiki> http://IP-UBILeiste/upgrade.cgi</nowiki>''' - Username=ubnt / Passwort=ubnt <br />Wenn das Upgrade fertig ist bleibt der Updatebalken bei 100% stehen. <br />
# '''Nach dem Updaten die Ports der Leiste über die WEB Oberfläche aus- und einschalten.''' <br />Ab sofort zählt sie dann auch die verbrauchte Energie wie gewünscht ohne Ubi-Kontroller!<br />
# Weiter geht es mit der Einrichtung der [[#Einstellung_der_Timezone_und_NTP_Timesync|Zeitzone/Timesync]]<br />
<br />
----<br />
Screenshots Iphone:<br />
<gallery><br />
File:Ubi-discoverytool.JPG|Ubi Discovery Toolbox<br />
File:Iphone-captive1.jpg|Captive Portal - select WiFi Network / mFi Account<br />
File:Iphone-captive2.jpg|Captive Portal - select mFi Account<br />
File:upgrade-2-0-8.jpg|UBI Web UI - upgrade.cgi<br />
File:upgrade-2-0-8-final.jpg|UBI Web UI - upgrade.cgi done<br />
<br />
</gallery><br />
<br />
=== Ersteinrichtung der Leiste ohne Controller / Windows7 ===<br />
Ubiquiti Auslieferungs-Firmware Version: 2.0.8 (oder alle 2.x Versionen)<br />
<br />
# Reset der Leiste mit "Factory reset" - Drücken der reset Taste auf der Leiste für mindestend 10 Sekunden. <br />Die Leiste startet neu hoch und erstellt einen Accesspoint mit einer eigenen SSID mit dem Namen mfi-xxxxx. <br />
# Verbinden des PC mit dem neuen WLAN Netzwerk. <br />
# Warten bis das Fenster zum neuen Netzwerk erscheint - dann Heimnetzwerk wählen. <br />
# Dann mit dem Firefox auf <nowiki> http://192.168.2.20 </nowiki> gehen und eine Ausnahme für das Zertifikat hinzufügen. <br />
# Es erschein die Konfigurationsseite. Dort Network scannen und die Security Daten des WLAN eingeben. '''Beim mFi Account ist NICHTS auszuwählen - alles leer lassen! '''<br />
# Apply dücken. Die mPower Leiste startet neu und nach ca. 1 Minute sollte sie sich mit dem WiFi verbunden haben und per DHCP eine IP-Adresse erhalten haben <br />
# Um die IP-Adresse herauszufinden, einfach das [http://www.ubnt.com/downloads/discovery/ubnt-discovery-v2.3.zip IP-Address Ubiquiti Discovery Tool v2.3] runterladen und entpacken. <br />Dann die .bat oder die .jar Datei doppelklicken und das Tool sucht im lokalen Netz nach UBI-Produkten. <br />
# Nun die Firmware Version 2.1.8 von http://www.ubnt.com/downloads/mfi/2.1.8/firmware/M2M/firmware.bin downloaden. <br /> Ab der 2.1x Version gibt es für alle Leisten (1-Port, 3-Port und 6 Port) die selbe firmware.bin.<br />
# Vor dem Flashen mit dem Browser normal auf die Leiste surfen. <nowiki> http://IP-Leiste</nowiki> <br /> Wechseln zum Reiter Configuration. Wenn nochmal die Konfigurationsseite kommen sollte, einfach den Kontroller neu einstellen - alles leer lassen. <br />
# Jetzt wird die Leiste mit einem Browser geflasht (am Besten mit Firefox) indem man auf die IP der Leiste geht und direkt zur upgrade.cgi surft. <br /> '''<nowiki> http://IP-UBILeiste/upgrade.cgi</nowiki>''' - Username=ubnt / Passwort=ubnt <br />Wenn das Upgrade fertig ist bleibt der Updatebalken bei 100% stehen. <br />
# '''Nach dem Updaten die Ports der Leiste über die WEB Oberfläche aus- und einschalten.''' <br />Ab sofort zählt sie dann auch die verbrauchte Energie wie gewünscht ohne Ubi-Kontroller!<br />
# Weiter geht es mit der Einrichtung der [[#Einstellung_der_Timezone_und_NTP_Timesync|Zeitzone/Timesync]]<br />
<br />
<br />
----<br />
Screenshots:<br />
<gallery><br />
File:Pc-wlan1.jpg|WiFi verbinden<br />
File:Pc-wlan2-netzwerk.JPG|Netztwerktyp<br />
File:Pc-wlan3-firefox.JPG|Firefox Zertifikat 1<br />
File:Pc-wlan4-firefox.JPG|Firefox Zertifikat 2<br />
File:Pc-wlan5-firefox.JPG|UBI Config UI<br />
File:Pc-wlan7-firefox.JPG|UBI Config UI<br />
File:Iphone-captive2.jpg|UBI FW 2.0.8 UI<br />
<br />
<br />
</gallery><br />
<br />
<br />
=== Update alter 1er Firmware ===<br />
<br />
Eine uralte Firmware (vor 2.0) auf die 2.1.8 Version upzudaten ist nur per Telnet/SSH/SCP möglich.<br />
<br />
# Windows Benutzer bitte Putty downloaden. Es wird pscp und putty benötigt. Alle Dateien in ein einfach zu ereichendes Verzeichnis wie z.B. c:\temp downloaden.<br />http://the.earth.li/~sgtatham/putty/latest/x86/pscp.exe<br />http://the.earth.li/~sgtatham/putty/latest/x86/putty.exe <br /> Linux Benutzer sollten ssh installiert haben.<br />
# Die Firmware Version 2.1.8 von http://www.ubnt.com/downloads/mfi/2.1.8/firmware/M2M/firmware.bin downloaden. <br /> Ab der 2.1x Version gibt es für alle Leisten (1-Port, 3-Port und 6 Port) die selbe firmware.bin. <br /> Linux User Download mit: <br /><code><nowiki> wget http://www.ubnt.com/downloads/mfi/2.1.8/firmware/M2M/firmware.bin </nowiki> </code><br />
# Reset der Leiste mit "Factory reset" - Drücken der reset Taste auf der Leiste für mindestend 10 Sekunden. <br />Die Leiste startet neu hoch und erstellt einen Accesspoint mit einer eigenen SSID mit dem Namen mfi-xxxxx. <br />
# Verbinden mit dem neuen WLAN Netzwerk. Die IP Adresse der Leiste lautet: 192.168.2.20.<br />
# Windows Nutzer gehen auf die Eingabeaufforderung und wechseln in das Verzeichnis c:\temp. <br /> <code>c: <ENTER> <br />cd \temp <Enter> </code><br />
# Dann wird die Firmware übertragen. Benutzername und Passwort lauten ubnt <br /> Windows:<br /> <code> pscp.exe -scp firmware.bin ubnt@192.168.2.20:/tmp/fwupdate.bin </code> <br /> Linux: <br /><code> scp firmware.bin ubnt@192.168.2.20:/tmp/fwupdate.bin </code><br />
# Nun mit SSH oder Telnet auf die Leiste gehen. Login: ubnt / Passwort: ubnt <br /> Windows:<br /> <code> putty.exe -telnet 192.168.2.20 </code><br /> Linux: <br /> <code> ssh ubnt@192.168.2.20 </code><br />
# Jetzt das Firmware-Flashen anstoßen. Das abschließende & Zeichen nicht vergessen! <br/> Windows und Linux: <br /> <code> /sbin/syswrapper.sh upgrade2 & </code><br />
# Die LED der Leiste blinkt nach kurzer Zeitg abwechselnd orange und blau. Diesen Vorgang nicht unterbrechen!! Nach ein paar Minuten ist der Vorgang beendet. <br />
# Abschließend noch mal einen Hardware Reset mit der Taste, wie am Anfang, machen. <br />
# Nun kann die Leiste, wie in der Ersteinrichtung beschrieben, konfiguriert werden. Die Updateprozeduren müssen natürlich nicht nochmal ausgeführt werden.<br />
<br />
=== Einstellung der Timezone und NTP Timesync ===<br />
Die UBI-Web-UI der Firmware 2.1.8 zeigt 2 neue Reiter System und Machines.<br />
Im Reiter System wird die Zeitzone eingestellt. <br /> GMT+1 Central European Time (Daylight Savings) und aktivieren Enable NTP Client mit dem Server pool-ntp.org. <br /><br />
Dann den Button "Change" klicken und "Configuration contains changes. Apply these changes? APPLY"<br />
<br />
<br />
Ab sofort hat die Leiste immer die richtige Zeit.<br />
<br />
<gallery><br />
<br />
File:ubi-fw-2.1.8-ui.jpg|Web UI 2.1.8<br />
File:ubi-zeitzone.jpg|Zeitzoneneinstellung<br />
<br />
</gallery><br />
<br />
== Links ==<br />
* Website von Ubiquiti[http://www.ubnt.com/]<br />
* PDF Datenblatt mFi/mPower [http://dl.ubnt.com/datasheets/mfi/mFi_DS.pdf]<br />
* Forum des Herstellers [http://community.ubnt.com/t5/mFi/bd-p/mFi]<br />
* mFi/mPower Firmware release 2.1.8 (2/2015) [http://community.ubnt.com/t5/mFi/mFi-release-2-1-8/td-p/1188368/jump-to/first-unread-message]<br />
* mFi/mPower Firmware release 2.1.11 (4/2015) [http://community.ubnt.com/t5/mFi/mFi-release-2-1-11/m-p/1230774]<br />
* Upgrade Prozedur aus dem Ubiquiti Forum [https://community.ubnt.com/t5/mFi-Frequently-Asked-Questions/mFi-Can-I-upgrade-mFi-device-firmware-manually/ta-p/485311]<br />
* Varia Store Deutschland (Bezugsquelle) [http://varia-store.com/Hardware/UBIQUITI-Networks:::637_734.html]<br />
* Forenbeitrag Fhem: {{Link2Forum|Topic=35722}}<br />
<br />
[[Kategorie:Other Components]]<br />
[[Kategorie:IP Components]]<br />
[[Kategorie:Schalter (Empfänger)]]<br />
[[Kategorie:Energieverbrauchsmessung]]</div>Wzuthttp://wiki.fhem.de/w/index.php?title=LaCrosseGateway_V1.x&diff=15451LaCrosseGateway V1.x2016-05-31T05:41:03Z<p>Wzut: Link zur Unterseite korrigiert</p>
<hr />
<div>Das WiFi-LaCrosse-Gateway erfüllt den gleichen Zweck wie ein [[JeeLink|JeeLink USB-Stick]] und zwar das Empfangen, Abfragen und Steuern von funkbasierten LaCrosse Sensoren und Aktoren, die im 868 MHz FSK Sendeverfahren arbeiten (OOK-Sendeverfahren (433 Mhz) wird nicht unterstützt). Die Verarbeitung der Daten und Steuerung der Aktoren, erfolgt mithilfe von FHEM, die als zentrale Steuereinheit dient. <br />
Der signifikante Unterschied zu einem JeeLink USB-Stick ist, der Betrieb über Wireless LAN ([https://de.wikipedia.org/wiki/Wi-Fi WiFi]). <br />
Das Herzstück des LaCrosse Gateways besteht aus einem ESP8266-12E. Das LaCrosseGateway ist aufgrund des hohen Stromverbrauchs, nicht für den Akkubetrieb geeignet.<br />
<br />
Der Einsatz eines WiFi-LaCrosse-Gateways bietet folgende Vorteile:<br />
*Kann an eine Stelle platziert werden, an der alle Sensoren optimal empfangen werden, dafür ist nur Strom (5V/1A USB Netzteil) und [https://de.wikipedia.org/wiki/Wi-Fi WiFi] Access Point erforderlich<br />
*Erweiterbar (Derzeit (Stand: 05.2016) ist ca. 30% Programmspeicher des ESP8266 belegt, im Gegensatz zu 99% bei einem ATMega328, damit steht deutlich mehr Rechenleistung zur Verfügung)<br />
*Im Minimalausbau nur zwei Bauteile NodeMCU DEVKIT 1.0 + RFM69 (siehe Bauteile) nötig <br />
*Alternativ am USB-Port wie ein JeeLink verwendbar<br />
*Einsatz von on board Sensoren / Aktoren (siehe [[#Unterstützte Sensoren und Aktoren | Unterstützte Sensoren und Aktoren]]) möglich<br />
<br />
{{Randnotiz|RNText=Projektstatus: Release mit einigen Beta-Anteilen.}}<br />
<br />
<br />
<br />
{{Randnotiz|RNTyp=y|RNText=Dokumentationsstand Version 1.19}}<br />
=Hardware=<br />
==Bauteile==<br />
Für das WiFi-LaCrosse-Gateway werden folgende Bauteile verwendet:<br />
*[Option 1] [http://www.esp8266.com/wiki/doku.php?id=esp8266-module-family#esp-12-e_q ESP8266 ESP-12E Modul].<br />Diese Variante eignet sich für Projekte für die eine kleine Bauform benötigt wird.<br />Für die Inbetriebnahme, insbesondere für das Aufbringen der Firmware, muss das Modul an ein [[Medium:Lgw USB2Serial Adapter.jpg|USB2Serial-Adapter]], angeschlossen werden. Für diese Variante sind Lötkenntnisse erforderlich. <br />
*[Option 2] [https://raw.githubusercontent.com/nodemcu/nodemcu-devkit-v1.0/master/Documents/NodeMCU_DEVKIT_1.0.jpg NodeMCU DEVKIT 1.0 (oder 2.0)]ist die Inbetriebnahme einfacher, da alles für das Aufbringen der Firmware bereits vorhanden ist und kein Löten nötig ist.<br />[https://forum.fhem.de/index.php/topic,45594.msg430183.html#msg430183 Hinweis:] Folgende Devkits werden nicht unterstützt:<br />
** V0.9<br />
** V3.0 - passt nicht, ist größer als das 2.0. Auf der Rückseite steht "Lolin"!<br />
** Devkits mit einem CH340 USB converter<br />
*[Option 3] Alternativ zu einem Devkit 1.0 kann auch ein [http://www.wemos.cc/Products/d1_mini.html "WeMOS D1 mini"] eingesetzt werden. Vorteil bei diesem Kit ist die kleine Bauform bei gleichem Funktionsumfang wie das DEVKIT 1.0.<br />
*[Option 4] ESP8266-07 auf einem DEVKIT 1.0. für den Betrieb mit einer externen Wifi Antenne.<br />
**''Hinweis:'' Der ESP-07 hat einen 25Q80 1M flash Chip. Dieser ist für den Betrieb mit der LaCrosseGateway Firmware geeignet, für ein OTA-Update ist es jedoch zu wenig. Aus diesem Grund muss/kann dieser auf 4M flash umgebaut werden. Weitere Informationen und Details zum Umbau sind im {{Link2Forum|Topic=45594|Message=448307|LinkText=Forenthread (Gehäuse-Variante)}} beschrieben.<br />
*[Optional] RFM69CW - Für das Senden und Emfangen funkbasierte LaCrosse Aktoren und Sensoren<br />
*[Optional] On board Sensoren (siehe [[#Unterstützte Sensoren und Aktoren | Unterstützte Sensoren und Aktoren]])<br />
*[Optional] SC16IS750 Zur Bereitstellung der seriellen Schnittstelle, da die GPIOs (GPIO1 / GPIO3) DEVKIT's V1.0 von FTDI verwendet werden und damit nicht genutzt werden können.<br />
*[Optional] OLED-Display SSD1306 I2C zur Darstellung von Daten (Bootvorgang, on board Sensoren, Inhalte aus FHEM)<br />
*[Optional] [[#MCP23008|MCP23008]] zur Bereitstellung (Konfigurierbar) von digitalen 8 Ein- Ausgängen oder Sonderfunktion (OLED)<br />
*Steckbrett (inkl. Kabel/Wiederstände) / Lochrasterplatine (Lötkolben, Lötzinn, Wiederstände etc.)) / [[#Platine|PeMue Platine]]<br />
<br />
==Schaltung==<br />
===Variante: Devkit 1.0===<br />
[[Datei:lgw_Schaltplan_Devkit.png|400px|thumb|left|Variante: Devkit 1.0]]<br />
<div style="clear:both;"></div><br />
===Variante: ESP8266-12E===<br />
[[Datei:lgw_Schaltplan_FTDI.png|400px|thumb|left|Variante: FTDI]]<br />
<div style="clear:both;"></div><br />
===Variante: Platine (PeMue)===<br />
[[Datei:lgw_Schaltplan_Platine.png|400px|thumb|left|Variante: Platine (PeMue)]]<br />
<div style="clear:both;"></div><br />
===Addon Schaltung=== <br />
[[Datei:lgw_Addon-with-example.png|400px|thumb|left|Die Schaltung des kompletten AddOn mit allen aktuell möglichen Optionen]]<br />
<div style="clear:both;"></div><br />
Siehe [[#Erweiterungsmöglichkeiten | Erweiterungsmöglichkeiten]].<br />
===MCP2308=== <br />
I2C Adresse 0x27 -> A0,A1,A2 = 3.3V<br />
<source lang="php"> <br />
|-------\/-------|<br />
LGW D1 |1 SCL VDD 18| LGW 3.3V <br />
LGW D2 |2 SDA GP7 17| PB7 --/ --- GND or Output<br />
LGW 3.3V |3 A2 GP6 16| PB6 --/ --- GND or Output<br />
LGW 3.3V |4 A1 GP5 15| PB5 --/ --- GND or Output<br />
LGW 3.3V |5 A0 GP4 14| PB4 --/ --- GND or Output<br />
LGW 3.3V |6 RES GP3 13| PB3 --/ --- GND or Output<br />
|7 NC GP2 12| PB2 --/ --- GND or Output<br />
|8 INT GP1 11| PB1 --/ --- GND or Output<br />
LGW GND |9 VSS GP0 10| PB0 --/ --- GND or Output<br />
|----------------|</source><br />
<br />
==Aufbau auf einem Steckbrett==<br />
[[Datei:lgw_Steckbrett.png|600px|thumb|left|LaCrosseGateway Aufbau auf einem Steckbrett]]<br />
<div style="clear:both;"></div><br />
'''''Hinweis:''' Der Sender und Empfänger RFM12, der auf dem Steckbrett zu sehen ist, wird nicht mehr unterstützt.''<br />
<br />
==Platine==<br />
PeMue (vielen Dank) hat {{Link2Forum|Topic=45594|LinkText=hier}} eine Platine (7,1cm x 5,0cm) für das LaCrosseGateway entworfen (Stand 05.2016).<br />
<br />
===Oberseite===<br />
[[Datei:lgw_Platine_Oberseite.jpg|400px|thumb|left|LaCrosseGateway Platine Oberseite]]<br />
<div style="clear:both;"></div><br />
<br />
===Unterseite===<br />
[[Datei:lgw_Platine_Unterseite.jpg|400px|thumb|left|LaCrosseGateway Platine Unterseite]]<br />
<div style="clear:both;"></div><br />
<br />
===Devkit 1.0 bestückt Oberseite===<br />
[[Datei:Lgw_Platine_Devkit_oberseite.png|400px|thumb|left|LaCrosseGateway Platine Oberseite]]<br />
<div style="clear:both;"></div><br />
<br />
===Devkit 1.0 bestückt Unterseite===<br />
[[Datei:lgw_Platine_Devkit_unterseite.png|400px|thumb|left|LaCrosseGateway Platine Oberseite]]<br />
<div style="clear:both;"></div><br />
<br />
===ESP8266-12E bestückt Oberseite===<br />
{| class="galleryTable noFloat"<br />
|-<br />
| [[Datei:lgw_Platine_ESP-12E_oberseite.png|400px|thumb|left|(1) LaCrosseGateway Platine Oberseite mit 2 x RFM69CW, BME280 und DHT22]]<br />
| [[Datei:lgw_Platine_ESP-12E_oberseite_2.jpg|490px|thumb|left|(2) LaCrosseGateway Platine Oberseite mit 2 x RFM69CW, BME280]]<br />
| [[Datei:lgw_Platine_ESP-12E_oberseite_2_inkl_GE.jpg.jpg|325px|thumb|left|(2) LaCrosseGateway Platine Oberseite mit 2 x RFM69CW, BME280 inkl. Gehäuse]]<br />
|}<br />
'''''Hinweis:''' Die Platine (Bild (1)) ist mit einem LM75 Sensor bestück. Diese Bestückung macht zusammen mit einem BME280 keinen Sinn, es handelt sich hierbei, um eine Entwicklungsplatine.''<br />
<br />
===ESP8266-12E bestückt Unterseite===<br />
{| class="galleryTable noFloat"<br />
|-<br />
| [[Datei:lgw_Platine_ESP-12E_unterseite.png|400px|thumb|left|(1) LaCrosseGateway Platine Oberseite]]<br />
| [[Datei:lgw_Platine_ESP-12E_unterseite_2.jpg|415px|thumb|left|(2) LaCrosseGateway Platine Oberseite mit 2 x RFM69CW, BME280]]<br />
|}<br />
<br />
===Platine bestücken (Hinweise und Tipps)===<br />
*Auf der Platine (Version 1.0) ist für das RFM69CW-Modul eine Markierung (zwei Quadrate) aufgedruckt, die den Chip und den Quarz symbolisieren. Wenn man den RFM69CW so drauflötet, wie abgebildet, ist er falsch rum drauf.<br />Es muss darauf geachtet werden, wo auf dem RFM69CW die "Ant" Beschriftung steht, dieser Lötpunkt muss auf die Platine an den Punkt "1" ausgerichtet werden. Zur Sicherheit bitte den [[#Variante: Platine (PeMue)|Schaltplan]] konsultieren und die genaue Position ermitteln.<br />
*Die Antennenlänge für das RFM69CW beträgt 82 mm. Dafür möglichst eindrähtigen Leiter (aus Kupfer) verwenden.<br />
<br />
==Erweiterungsmöglichkeiten==<br />
Das LaCrosseGateway kann optional mit verschiedenen Komponenten erweitert werden.<br />
<br />
Folgende Erweiterungen sind möglich:<br />
*es kann ein eigener Prozessor (mit eigener Firmware) angeschlossen werden, der Daten empfängt und diese dem LGW übergibt.<br />
*es kann z.B. ein NanoCUL angeschlossen werden, dessen serielle Schnittstelle transparent auf einem Port im Web bereitgestellt wird.<br />
*es kann ein vierter und fünfter RFM69CW angeschlossen werden, diese können alles, was die bisherigen drei auch können.<br />
*es kann ein aktiver Piezo Summer (Piezo Buzzer) angeschlossen (an GPIO7 des SC16IS750) werden, um von FHEM aus das LaCrosseGateway einen Alarm ausgeben zu lassen. Hinweis: Falls der Strom von 10mA, den die Ausgänge liefern, nicht reicht, ist noch eine Transistor-Schaltstufe vorzusehen.<br />
<br />
Alle diese Daten stellt das LaCrosseGateway per WiFi an FHEM zu, dort wird es von den entsprechenden Modulen (JeeLink, LaCrosse, PCA301, ...) weiterverarbeitet.<br />
<br />
Alle Komponenten werden automatisch erkannt, sofern angeschlossen.<br />
Für die Realisierung der o.g Möglichkeiten wird ein [http://www.aliexpress.com/item/1x-Breakout-Board-for-SC16IS750-I2C-SPI-to-UART-IC/1327351219.html?spm=2114.30010308.3.38.HxdznQ&ws_ab_test=searchweb201556_9,searchweb201602_2_10034_507_10020_10001_10002_10017_10010_10005_10011_10006_10021_10003_10004_10022_10009_10008_10018_10019,searchweb201603_6&btsid=97b30f2b-e937-426b-8202-de585dd7ee97 SC16IS750] verwendet.<br />
<br />
Der SC16IS750 wird per I2C an das LaCrosseGateway angeschlossen und bietet eine serielle Schnittstelle und 8 Digital I/Os<br />
<br />
<br />
'''Auf dieser Basis sind momentan folgende Erweiterungen möglich:'''<br />
<br />
===SubProzessor===<br />
Der SubProzessor dient dazu, dass mit einem eigenen Sketch Daten erfasst werden können, ohne sich um die ganze Nummer, die das LGW macht (WiFi, Kommunikation mit FHEM, Frontend, OTA, ...), kümmern zu müssen.<br />
Ferner ermöglicht es die Implementierung von eigenen Projekten, dabei werden die zeitkritischen Abläufe des LGWs nicht beeinträchtig.<br />
<br />
An die serielle Schnittstelle des SC16IS750 kann optional ein Arduino angeschlossen werden (z.B. ein Pro Mini)<br />
Entweder ein 3.3V / 8MHz oder ein 5V / 16MHz, der aber dann auch mit 3.3V betrieben wird.<br />
<br />
'''''Wichtig:''' Alle LaCrosseGateway Komponenten laufen ausschließlich mit '''3.3V''', aus diesem Grund dürfen keine '''5V''' Komponenten angeschlossen werden.''<br />
<br />
Die Firmware kann über das LGW auf den SubProzessor (Voraussetzung: Arduino hat einen bootloader) geflasht werden.<br />
<br />
Dazu wird sie auf das LGW hochgeladen (<nowiki>http://<LGW-IP>/ota/addon.hex</nowiki>).<br />
<br />
Das LGW nimmt den Upload entgegen, wandelt das Intel-Hex in binary um und schickt es per STK500-Protokoll an den Arduino.<br />
<br />
Die Firmware kann z.B. mithilfe von "curl" mit dem nachfolgendem Befehl hochgeladen werden:<br />
<source lang="php">curl --http1.0 -H "Content_Type:multipart/form-data" -F "file=@/myFolder/LGW-Addon.ino.hex; filename=addon.hex" http://192.168.31.211/ota/addon.hex</source><br />
<br />
'''''Hinweis:''' fielname=addon.hex im Beispiel darf nicht verändert werden, nur /myFolder/LGW-Addon.ino.hex und die IP-Adresse wird entsprechend angepasst.''<br />
<br />
Der Upload dauert etwas, danach sollte bei Erfolg vom LGW ein Protokoll zurückgeschickt bekommen, der wie folgt aussieht:<br />
<source lang="php">Start receiving 'addon.hex'<br />
File: /addon.hex Size: 21417<br />
Starting flash<br />
Sending sync<br />
Enter program mode<br />
Binary size is:7608<br />
Leave Program Mode<br />
Flash finished</source><br />
<br />
Mit dem SubProzessor können die entsprechenden Daten auf zwei mögliche Arten am LGW übermittelt werden:<br />
<br />
'''KeyValueProtokoll (KVP):'''<br />
Format:<source lang="php">KV <Type> <Address> <Key>=<Value>,<Key>=<Value>,<Key>=<Value>, ...</source><br />
Beispiel:<source lang="php">KV DHT 01 Temperature=21.5,Humidity=62</source><br />
<br />
Das LGW übermittelt die Daten als KVP an FHEM und dort entsteht ein KVP Device, das die Daten darstellt.<br />
<br />
'''LaCrosse:'''<br />
<br />
Format:<source lang="php">LC <Address> T=<Temperature>,H=<Humidity></source><br />
Beispiel:<br />
<source lang="php">LC 9F T=21.5,H=62</source><br />
<source lang="php">LC 9F T=21.5</source><br />
Das LGW setzt die Werte in das LaCrosse Protokoll um (wie z.B. ein TX29DTH) und schickt sie an FHEM.<br />
In FHEM entsteht ein LaCrosse Device (autocreate, LaCrossePairForSec ...), als ob es ein LaCrosse Sensor wäre.<br />
<br />
Das [https://forum.fhem.de/index.php?action=dlattach;topic=43672.0;attach=48914 LGW-Addon.ino] ist ein einfaches Beispiel, das diese Technik veranschaulicht.<br />
Es bindet den geliebten DHT22 an und sendet ihn als LaCrosse-Sensor (über das LGW) an FHEM und es misst die Spannung und sendet sie zusammen mit der UpTime des SubProzessors als KVP<br />
<br />
Der umrandete Bereich [[#Addon Schaltung |Schaltung - "Example"]] "Example" ist das zu [https://forum.fhem.de/index.php?action=dlattach;topic=43672.0;attach=48914 LGW-Addon.ino] passende Beispiel.<br />
<br />
==Unterstützte Sensoren und Aktoren==<br />
Alle Sensoren, die auch vom "LaCrosse Arduino" Sketch unterstützt werden, incl. WS 1600 und WS 1080 (Hinweis beachten)<br />
siehe [[JeeLink#LaCrosse_Sketch |LaCrosse Sketch]]<br />
<br />
{| class="wikitable"<br />
!Bezeichnung !! Datenrate !! Sonstiges !!Funktion !!Link<br />
|-<br />
| TX21IT || 17.241 kbps ||extern||||<br />
|-<br />
| TX25-IT || 17.241 kbps ||extern||||<br />
|-<br />
| TX27-IT || 17.241 kbps ||extern||||<br />
|-<br />
| TX29-IT || 17.241 kbps ||extern||||<br />
|-<br />
| TX29DTH-IT || 17.241 kbps ||extern||||<br />
|-<br />
| TX37 || 17.241 kbps ||extern||||<br />
|-<br />
| TX35TH-IT || 9.579 kbps ||extern||||<br />
|-<br />
| TX35DTH-IT || 9.579 kbps ||extern||||<br />
|-<br />
| 30.3143.IT || 17.241 kbps ||extern||||<br />
|-<br />
| 30.3144.IT || 17.241 kbps ||extern|||| ({{Link2Forum|Topic=17662|LinkText=Forenthread}})<br />
|-<br />
| 30.3147.IT || 17.241 kbps ||extern||||<br />
|-<br />
| 30.3155WD || 9.579 kbps ||extern|||| kritisch; nicht zu empfehlen; siehe {{Link2Forum|Topic=14786|Message=352550|LinkText=Forenbeitrag}}<br />
|-<br />
| 30.3156WD || 9.579 kbps ||extern|||| Batterie-kritisch. Funktioniert schlecht mit Akkus!<br />
|-<br />
| 30.3187.IT || 17.241 kbps ||extern||||<br />
|-<br />
| WT440XH || 17.241 kbps ||extern||||<br />
|-<br />
| WS 1600 (TX22) || 8.842 kbps || extern |||| ({{Link2Forum|Topic=14786|Message=297293|LinkText=Forenbeitrag}})<br />
|-<br />
| WS 1080 || 17.241 kbps || extern |||| Bitte Hinweise beachten! ({{Link2Forum|Topic=14786|Message=363766|LinkText=Forenbeitrag}})<br />
|-<br />
| [[EMT7110]] || 9.579 kbps || extern |||| ({{Link2Forum|Topic=26494|LinkText=Forenthread}})<br />
|-<br />
| LevelSender || 17.241 kbps || extern ||||<br />
|-<br />
| PCA301 ||868950 kHz (868,970 und 868,990 ) 6.631 kbps || extern || Energiemess-Steckdose (Unterstützung werden bis zu 50 Dosen)|| <br />
|-<br />
| EC3000 ||868.300 kHz mit 20.000 kbps|| extern || Energiemess-Steckdose funktioniert nur mit RFM69, nicht mit RFM12 || <br />
|-<br />
| RFM69CW || || on board || Zum Empfangen und Senden von Sensor/Aktor Daten.|| Hinweise DHT22 beachten.<br />
|-<br />
| BME280 || || on board || Temperatur, Feuchte und Druck || Bei Einsatz von Breakout (GY-68) kein PullUp mit 4,7k Wiederständen nötig. Verifizieren!<br />
|-<br />
| BMP180 || || on board || Temperatur und Druck || Bei Einsatz von Breakout (GY-68) kein PullUp mit 4,7k Wiederständen nötig. Verifizieren!<br />
|-<br />
| LM75 || || on board|| Temperatur || <br />
|-<br />
| DHT22 || ||on board|| Temperatur und Feuchte. ||<br />
|-<br />
| SC16IS750 || I2C Adresse: 0x90 ||on board|| OI Erweiterung || Kann anstatt RFM69 Radio#3 eingesetzt werden.<br />
|-<br />
| OLED SSD1306|| I2C Adresse: 0x3C || on board || OLED Display||<br />
|-<br />
| MCP23008|| I2C Adresse: 0x27 || on board || Input/Output Port Expander||<br />
|-<br />
| Piezo Summer |||| on board ||Piezo Buzzer||<br />
<br />
|}<br />
<br />
Hinweis zur WS 1080: Die WS 1080 gibt es (unter gleichem Namen) in einer OOK- und in einer FSK-Version<br />
Der LaCrosse Sketch und das LaCrosseGateway können nur die FSK-Version empfangen, die OOK-Version nicht.<br />
Die FSK-Version erkennt man an dem grünen Aufkleber im Batteriefach der Station mit dem Aufdruck "PASS 7". Nur diese Version kann empfangen werden.<br />
Die OOK-Version erkennt man an dem grünen Aufkleber im Batteriefach der Station mit dem Aufdruck "PASS A14C". <br />
<br />
<br />
Alle direkt am LGW anschließbare Sensoren werden automatisch erkannt, wenn sie vorhanden sind.<br />
<br />
<u>Sie werden in folgender Reihenfolge verwendet:</u><br />
<br />
Wenn ein BME280 vorhanden ist, wird dieser verwendet und sonst nichts, da man dann bereits Temperatur, Feuchte und Druck hat.<br />
<br />
Ist kein BME280 vorhanden, wird geschaut, ob ein BMP180 vorhanden ist. Falls ja, haben wir Druck und Temperatur.<br />
<br />
Dann wird geschaut, ob ein DHT22 vorhanden ist. Wenn ja, wird er zusätzlich verwendet, aber vom BMP180 dann nur noch der Druck.<br />
<br />
Temperatur und Feuchte vom DHT22, dass dieses Wertepaar von einem Sensor stammt.<br />
<br />
Wenn kein BMP180 und kein BME180 da ist, sondern nur ein DHT22, dann hat man Temperatur und Feuchte.<br />
<br />
Wenn nichts vorhanden ist (also keiner der bisher genannten Sensoren), wird, falls vorhanden, der LM75 verwendet.<br />
<br />
=Software=<br />
==Funktionsumfang==<br />
*Access Point für die Konfiguration<br />
*Konfiguration über WEB-Frontend (Erreichbar per ''<nowiki>http://IP-Adresse oder Hostname/setup</nowiki>'' auf Port 80 )<br />
**SSID und Password (Die Konfiguration wird im EEPROM gespeichert und bei zukünftigen Neustarts verwendet.)<br />
**Statische IP-Adresse anstatt DHCP<br />
**Hostname<br />
*Vom JeeLink FHEM-Modul über IP-Adresse:Port ansprechbar. Der Port ist konfigurierbar.<br />
*Unterstützt bis zu 5 x RFM69CW (Keine Unterstützung für RFM12) <br />
*On board und externe Sensoren und Aktoren ([[#Unterstützte Sensoren und Aktoren |Unterstützte Sensoren und Aktoren]])<br />
*Betrieb nur per USB möglich, als ob es ein JeeLink wäre<br />
*FHEM Anbindung<br />
*Log im Web-Frontend<br />
*Firmware OTA-Update (Firmware-Over-the-Air-Update per FHEM)<br />
*Erweiterungsmöglichkeiten per SC16IS750 (Für Buzzer und für weitere zwei RFM69)<br />
*SubProzessor (An die serielle Schnittstelle des SC16IS750 kann optional ein Arduino angeschlossen werden (z.B. ein Pro Mini))<br />
*Serial bridge (Optional kann die serielle Schnittstelle des SC16IS750 transparent auf einem TCP Port bereitgestellt werden)<br />
<br />
==Sourcecode==<br />
Der Quellcode des LaCrosse Gateways befindet sich [https://sourceforge.net/p/fhem/code/HEAD/tree/trunk/fhem/contrib/arduino/36_LaCrosseGateway.zip?format=raw im FHEM SourceForge Repository (contrib)].<br />
<br />
==Firmware Download==<br />
Die [https://sourceforge.net/p/fhem/code/HEAD/tree/trunk/fhem/FHEM/firmware/JeeLink_LaCrosseGateway.bin?format=raw Firmware] befindet sich auf dem [https://sourceforge.net/projects/fhem/ FHEM SourceForge Repository] und wird per FHEM Update verteilt. Neue Version der [https://sourceforge.net/p/fhem/code/HEAD/tree/trunk/fhem/FHEM/firmware/JeeLink_LaCrosseGateway.bin?format=raw Firmware] wird im {{Link2Forum|Topic=43672|LinkText=FHEM Forum "LaCrosse Gateway"}} angekündigt und der Funktionsumfang bzw. die Änderungen beschrieben.<br />
<br />
Nach einem FEHM-Update alternativ auch: ''<FHEM-Installations-Verzeichnis>/FHEM/firmware/JeeLink_LaCrosseGateway.bin''<br />
<br />
'''SDK:'''<br />
Arduino 1.6.9 / Espressiv 1.5.3 / Arduino Core Rev. 14405<br />
<br />
==Firmware aufspielen==<br />
Wie bei einem JeeLink muss auch für das LaCrosse Gateway die Firmware aufgespielt werden.<br />
<br />
Das [https://raw.githubusercontent.com/nodemcu/nodemcu-devkit-v1.0/master/Documents/NodeMCU_DEVKIT_1.0.jpg NodeMCU DEVKIT 1.0] hat eine CP2102 UART Bridge implementiert, dafür muss ein CP2102 Treiber installiert sein.<br />
<br />
Bei einem ESP8266-12E Modul kann die Firmware Mithilfe eines Seriell-USB-Konverters aufgespielt werden.<br />
<br />
===Windows/Mac/Linux per "esptool"===<br />
Verifiziert und getestet wurde dieses Vorgehen auf Windows (Windows 10), Mac (El Capitan):<br />
<br />
1) Das [https://github.com/igrr/esptool-ck/releases esptool 0.4.6] für die entsprechende Plattform herunterladen.<br />
<br />
2) Zum Aufspielen der Firmware, muss ein Befehl nach der folgenden Syntax ausgeführt werden:<br />
<source lang="php"><br />
esptool -vv -cp [Port] -cb 921600 -ca 0x00000 -cd nodemcu -cf [Pfad zur Firmware (bin-File)]</source><br />
'''[Port]''' und '''[Pfad zur Firmware (bin-File)]''' müssen angepasst werden.<br />
<br />
''Beispiel (Mac/Linux):''<br />
<br />
<source lang="php">esptool -vv -cp /dev/tty.SLAB_USBtoUART -cb 921600 -ca 0x00000 -cd nodemcu -cf JeeLink_LaCrosseGateway.bin</source><br />
<br />
'''''Hinweis:''' Das esptool ist nicht sonderlich stabil. Es kommt vor, dass es manchmal den upload nicht startet oder nicht durchbekommt. In diesem Fall hilft es den Vorgang, auch mehrmals, zu wiederholen.''<br />
<br />
===Windows per "nodemcu-flasher"===<br />
<br />
1) [http://bbs.espressif.com/download/file.php?id=315&sid=a9040f05a6bf12258fe8b73a52de3a42 Espressif Flashtool] downloaden und entpacken:<br />
<br />
2) [https://sourceforge.net/p/fhem/code/HEAD/tree/trunk/fhem/FHEM/firmware/JeeLink_LaCrosseGateway.bin?format=raw Firmware] downloaden<br />
<br />
3) FlashTool starten und wie folgt einstellen:<br />
<br />
{| class="galleryTable noFloat"<br />
|-<br />
| [[Datei:nodemcu-flasher_1.png|450px|thumb|left|Firmware auswählen]]<br />
| [[Datei:nodemcu-flasher_2.png|450px|thumb|left|Flash Parameter (Advanced Tab) wie abgebildet einstellen]]<br />
|}<br />
<br />
4) COM-Port auswählen und den Flashvorgang starten (Button: '''Flash(F)''') ...<br />
[[Datei:nodemcu-flasher_3.png|450px|thumb|left|COM Port auswählen und das "Flashen" initiieren]]<br />
<div style="clear:both;"></div><br />
<br />
Nach dem Flashen sollte über die serielle Ausgabe des ESP der Start und das Öffen des AccessPoints zu sehen sein.<br />
<br />
'''''Hinweis:''' Die Geschwindigkeit von 921600 baud ist nicht auf jedem Rechner (besonders auf virtualisierten Systemen) machbar. In diesem Fall die Baudrate auf 57600 reduzieren.''<br />
<br />
==Funktionsweise==<br />
Während des Startvorgangs versucht sich das LaCrosse Gateway in einem WLAN anzumelden. Dazu muss es eine SSID und das entsprechende Passwort kennen.<br />
<br />
Beim ersten Start (nach dem initialen Aufspielen der Firmware) sind diese Informationen noch unbekannt. Aus diesem Grund wird folgende Strategie verfolgt:<br />
<br />
Wenn es sich in keinem WLAN anmelden kann, dann öffnet es einen Access Point mit der SSID "LaCrosseGateway_'''xxxxxx'''", wobei '''xxxxxx''' die eindeutige Chip-ID des ESP ist.<br />
<br />
Der Access Point wird aus Sicherheitsgründen nach 15 Minuten wieder geschlossen.<br />
Innerhalb dieser 15 Minuten kann man sich mit dem Access Point verbinden. Der Access Point vergibt (per DHCP) IP-Adressen aus dem Netzwerk 192.168.222.0. Anschließend kann über die LaCrosseGateway Konfigurationsseite [http://192.168.222.1/setup http://192.168.222.1/setup] die initiale Konfiguration vorgenommen werden.<br />
Die Konfiguration wird im EEPROM gespeichert und bei zukünftigen Neustarts verwendet.<br />
Die Konfigurationsseite ist auch im "Normalbetrieb" (ohne Access Point) über die Adresse http://''seine aktuelle IP-Adresse''/setup erreichbar.<br />
<br />
Wenn sich das LaCrosse Gateway an dem konfigurierten WLAN anmelden konnte (es wartet max. 30 Sekunden auf einen connect) und von diesem per DHCP eine IP-Adresse erhalten hat, dann stellt es auf dieser Adresse den Port 81 zur Verfügung, über den in FHEM das JeeLink Modul senden und empfangen kann - als wenn es ein JeeLink wäre.<br />
<br />
'''Optische Darstellung der Initialisierung'''<br />
<br />
Beim Start und der Initialisierung wird mit der Board-eigenen LED signalisieren, was gerade passiert:<br />
*5 schnelle blinks direkt nach dem Start, als Zeichen, dass ein Reset stattgefunden hat<br />
*Blinken im Sekundentakt, während versucht wird, sich mit einem WLAN zu verbinden.<br />
*LED aus, wenn der Connect zu einem WLAN geklappt hat und dann vereinzeltes Blinken, wenn Daten an FHEM übermittelt werden<br />
<br />
== LaCrosseGateway einrichten ==<br />
Für die Ersteinrichtung des LaCrosseGateways werden die SSID und das Passwort des WLAN-Routers benötigt. Ferner wird empfohlen auf dem WLAN-Router bzw. dem DHCP-Server eine IP-Adresse für das LaCrosseGateway zu reservieren. Für die Reservierung wird die MAC-Adresse des LaCrosseGateways benötigt, diese kann über die "Home"-Page des LaCrosseGateways ermittelt, alternativ von dem [[#Windows per "nodemcu-flasher" |NODEMCU Firmware Programmer]] (''Reiter "Operation -> "STA MAC"'') entnommen werden. <br />
<br />
Sofern diese Vorbereitungen getroffen wurden und alle Informationen vorliegen, kann das LaCrosseGateway eingerichtet werden.<br />
<br />
'''''<u>Für die Konfiguration sind folgende Schritte nötig:</u>'''''<br />
*Mit dem LaCrosseGateway Access Point "LaCrosseGateway_xxxxxx" verbinden (siehe [[#Funktionsweise |Beschreibung Funktionsweise]])<br />
*Mithilfe eines Browsers die [http://192.168.222.1/setup LaCrosseGateway "Setup"-Page] öffnen<br />
*SSID und das Password eintragen<br />
*''[Empfohlen]'' Das Frontend Passwort festlegen<br />
*''[Optional]'' Falls kein DHCP-Server zur Verfügung steht bzw. keine Reservierung erwünscht ist, dann muss die IP-Adresse / Netmask / Gateway eingetragen werden<br />
*''[Empfohlen]'' Hostnamen festlegen bzw. anpassen<br />
*Alle Angaben mit dem Button "save and restart" bestätigen. Dabei werden die vorgenommen Einstellungen im EEPROM gespeichert und ein Neustart des LaCrosseGateways initiiert.<br />
<br />
Nach dem Neustart verbindet sich das LaCrosseGateway mit dem WLAN-Router. <br />
<br />
Anschließend kann mit der [[#Hinweise zum Betrieb mit FHEM |Inbetriebnahme in FHEM]] fortgefahren werden.<br />
<br />
==Firmware aktualisieren==<br />
<br />
Nachfolgend werden, neben der unter dem Punkt [[#Firmware aufspielen |Firmware aufspielen]] beschriebenen Möglichkeiten, weitere Möglichkeiten zur Aktualisierung der LaCrosseGateway [[Firmware Download |Firmware]] aufgezeigt.<br />
<br />
Hinweis: Die Einstellungen des LaCrosseGateway werden dabei nicht gelöscht.<br />
<br />
=== Per FHEM (OTA-Update)===<br />
Voraussetzungen:<br />
<br />
*Das LGW muss auf der IP-Adresse, die im JeeLink Modul definiert ist, erreichbar sein<br />
*Es wird kein avrdude benötigt<br />
*Das Attribut "flashCommand" spielt keine Rolle<br />
<br />
Die LaCrosseGateway Firmware kann von JeeLink Device (JeeLink Modul) aus mit <br />
<source lang="php">set myJeeLik flash</source> aktualisiert werden.<br />
'''''myJeeLik''' muss bei Bedarf auf den Gerätenamen in FHEM angepasst werden.''<br />
<br />
'''''Hinweis:''' Das Update dauert ca. 30 Sekunden.''<br />
<br />
=== Per CURL ===<br />
Voraussetzungen:<br />
*[https://curl.haxx.se/download.html curl-Tool] installiert <br />
<br />
'''''Beispiel:'''''<br />
<source lang="php">curl --http1.0 -# -o ~output.txt -H "Content_Type:multipart/form-data" -F "file=@.\JeeLink_LaCrosseGateway.bin; filename=firmware.bin" http://192.168.31.211/ota/firmware.bin</source><br />
<br />
'''Firmwaredateiname (file=)''' und die '''IP-Adresse''' muss entsprechend angepasst werden.<br />
<br />
=== Per WEB OTA-Update (deprecated)===<br />
<br />
'''''deprecated'''''<br />
<br />
==LaCrosseGateway Web-Frontend==<br />
===Staus-Wert RSSI===<br />
Die WiFi Signalstärke (dBm). -36 ist besser als -60<br />
<br />
===Staus-Wert FramesPerMinute===<br />
Dieser gibt an, wie viele frames von Sensoren in der letzten Minute erfolgreich empfangen, dekodiert und verarbeitet wurden.<br />
Es eignet sich zur Überwachung, wenn weniger als ein Grenzwert empfangen wurde, dann kann ein Alarm (Benachrichtigung, Restart etc.) ausgelöst werden.<br />
<br />
===Staus-Wert ReceivedFrames===<br />
Dieser Wert gibt an, wie viele seit dem Start des LGW empfangen wurden.<br />
<br />
===Sensor-ID===<br />
Bei Einsatz von mehr als einem LaCrosseGateway, muss die LaCrosse-ID, mit der die internen Sensoren des Gateways übermittelt werden, angepasst werden. <br />
Hierbei ist darauf zu achten, dass die LaCrosse-ID nur einmal auf einer FHEM Instanz vorkommen darf. Die ID kann entweder Dezimal (211) oder Hex (0xD3) angegeben werden.<br />
<br />
'''''Detailinformationen:''''' Wenn ein LGW interne Sensoren hat (BMP280, BMP180, DHT22, ...) dann sendet es die Daten des Sensors so, als ob es eine Wetterstation wäre (WS 1600 Format) an das LGW. Bisher hat es dafür die Sensor-ID 0 verwendet. Wenn man mehrere LGWs an ein FHEM angebunden hat, dann mischen sich deren Sensor-Daten auf dem LaCrosse device mit der ID 0. Um das zu vermeiden, kann man nun konfigurieren, mit welcher Sensor-ID die internen Sensoren gesendet werden sollen und die beiden LGWs unterschiedliche konfigurieren.<br />
<br />
Die Anpassung der LaCrosse-ID hat keinerlei Einfluss auf die Daten, die von den Radios empfangen werden.<br />
<br />
===SC16IS750-Clone===<br />
Wenn aktiviert, wird die I2C clock auf 100 kHz runtergenommen und<br />
es wird an einigen Stellen etwas auf die Bremse getreten, dass ein SC16IS70-Clone, der langsamer<br />
als echte Hardware ist, mitkommt.<br />
Sollte man ohne zwingenden Grund nicht aktivieren.<br />
<br />
===Use MDNS=== <br />
Legt fest, ob das LGW seine IP-Adresse per MDSN bekannt gibt. Dies ist nötig, wenn man einen Mac hat oder bei Windows einen Bonjour-Service laufen hat.<br />
Dies ist beim Entwickeln sinnvoll, kann üblicherweise ausgeschaltet bleiben.<br />
<br />
===MCP23008=== <br />
Konfigurationsmöglichkeit für die 8 IO Pins (siehe auch [[#Inbetriebnahme_von_MCP23008|Inbetriebnahme von MCP23008]]).<br />
<br />
===Serial bridge port und bridge baud===<br />
Das LGW kann nun optional die serielle Schnittstelle des SC16IS750 transparent auf einem TCP Port bereitstellen.<br />
Dazu gibt es die neuen settings "Serial bridge port" und "Serial bridge baud" auf der "config"-Page des LGWs.<br />
Das LGW überträgt transparent die Daten der seriellen Schnittstelle an FHEM und umgekehrt.<br />
<br />
===Statuswerte abrufen===<br />
Mit http://<IP-des-LGW>/state können die Statuswerte, die das LGW-Frontend anzeigt, als XML zur Weiterverarbeitung abgerufen werden.<br />
<br />
Beispiel:<br />
<source lang="php"><LGW><br />
<Info Key="UpTimeSeconds" Value="107086"/><br />
<Info Key="UpTimeText" Value="1Tg. 5Std. 44Min. 46Sek. "/><br />
<Info Key="WIFI" Value="NeverTellThem"/><br />
<Info Key="MacAddress" Value="18:FE:34:9A:6D:48"/><br />
<Info Key="ChipID" Value="10120520"/><br />
<Info Key="ReceivedFrames" Value="93593"/><br />
<Info Key="FramesPerMinute" Value="52"/><br />
</LGW></source><br />
<br />
===Funktionsweise Log===<br />
Das Log ist als Hilfsmittel bei der Fehlersuche gedacht z.B. um bei PCA301 zu verfolgen, wann wer was wie frägt und antwortet oder um zu schauen, ob irgend welche Sensoren überhaupt empfangen werden und die Daten an FHEM geliefert werden.<br />
<br />
[[Datei:lgw_LogPage.png|600px|thumb|left|LaCrosseGateway Log ebfrontend]]<br />
<div style="clear:both;"></div><br />
Mit "Command" kann man Befehle an das LGW senden. Sie entsprechen dem, was man mit "set myJeeLink raw ..." aus FHEM schicken kann.<br />
Die obere Liste enthält die Daten, die an FHEM übermittelt werden (bzw. würden, wenn sich ein FHEM auf das LGW verbunden hat)<br />
Die untere Liste enthält debug-Informationen u.a. wird hier der letzte Systemstart aufgezeichnet.<br />
Die verwendete SDK-Version und der letzte Reset-Grund werden ebenfalls ausgegeben<br />
<br />
Das Log kann per HTTP abgerufen werden:<br />
<source lang="php">http://<LGW-IP>/getLogData</source><br />
<br />
'''''Beispiel:'''''<br />
<source lang="php">http://192.168.31.211/getLogData</source><br />
<br />
das Ergebnis sieht wie folgt aus:<br />
<source lang="php">DATA:OK 22 117 196 0 58 226 102 0 58 191 86 0 0 40 172 0 105 1 101 3 0 [75 C4 E2 66 00 00 BF 56 00 00 00 02 3B FC DC 00 69 01 65 4A A4 C4 F9 F2 4F 11 A4 F6 7C 03 A0 00 00 00 00 03 A0 38 09 21 27]<br />
DATA:OK 9 11 130 4 173 125 [92 D5 97 7D 75]<br />
DATA:OK EMT7110 84 81 8 207 0 36 0 1 1 199 1 [25 6A 54 51 40 02 00 24 C3 41 C7 9B]<br />
SYS: AddOn: KV ADDON 01 Voltage=3.33,UpTime=4921<br />
DATA:OK VALUES ADDON 01 Voltage=3.33,UpTime=4921<br />
DATA:OK 9 38 1 4 67 65 [99 84 91 41 07]<br />
DATA:OK 22 126 67 0 65 236 34 0 65 231 116 0 0 32 103 0 48 0 134 1 0 [7E 43 EC 22 00 00 E7 74 00 00 00 01 C7 AC D7 00 30 00 86 00 57 E4 69 1E 46 8E D4 68 C7 04 10 00 00 00 00 04 10 18 0A DC F7]<br />
DATA:OK 9 36 1 4 128 61 [99 05 52 3D 96]<br />
DATA:OK WS 0 4 4 185 255 255 255 255 255 255 255 255 255 0 3 252</source><br />
<br />
'''''DATA:''''' für die obere Liste<br />
<br />
'''''SYS: ''''' für die untere Liste<br />
<br />
<br />
Bei jedem Aufruf werden die seit dem letzten Abruf neu aufgelaufenen Logeinträge geliefert.<br />
Intern werden maximal 40 Einträge gepuffert (aber kein Ringpuffer, weil die ersten 40 mit dem Bootlog erhalten bleiben müssen)<br />
<br />
'''''Hinweis:''''' Aus Performance- und Stabilitätsgründen sollten die Daten nicht zu häufig und nicht von zwei Instanzen gleichzeitig abgerufen werden.<br />
<br />
=Hinweise zum Betrieb mit FHEM=<br />
<br />
<br />
==Voraussetzungen==<br />
Es wird ein [[#LaCrosseGateway einrichten |vorkonfiguriertes]] LaCrosseGateway vorausgesetzt.<br />
<br />
Perl Modul: ''LWP::UserAgent'' - Dieses wird für das Firmware Update per FHEM JeeLink Modul benötigt.<br />
Auf einem Raspberry Pi kann die Instllation wie folgt durchgeführt werden:<br />
<source lang="php">sudo apt-get install libwww-perl</source><br />
alternativ auch mit<br />
<source lang="php">sudo cpan LWP::UserAgent</source><br />
<br />
'''FHEM Module'''<br />
<br />
''36_KeyValueProtocol.pm'' (wird per FHEM Update verteilt)<br />
<br />
''36_JeeLink.pm'' (wird per FHEM Update verteilt)<br />
<br />
''36_LaCrosse.pm'' (wird per FHEM Update verteilt)<br />
<br />
''36_PCA301.pm'' (wird per FHEM Update verteilt)<br />
<br />
''36_EC3000.pm'' (wird per FHEM Update verteilt)<br />
<br />
==Device Definition==<br />
===WLAN===<br />
Die Definition sieht dann wie folgt aus:<br />
''define myJeeLink JeeLink <IP-Adresse>:81''<br />
Der name "myJeeLink" kann bei Bedarf angepasst werden.<br />
<IP-Adresse> muss entsprechend angepasst werden.<br />
Beispiel:<br />
<source lang="php">define myJeeLink JeeLink 192.168.22.33:81</source><br />
IP-Adresse ermitteln: Das LaCrosseGateway heist per default Einstellung "''LaCrosseGateway''" per ping auf den Hostnamen ''LaCrosseGateway'' kann die IP-Adresse ermittelt werden.<br />
===USB===<br />
Für den Betrieb via USB sieht die Definition wie folgt aus:<br />
''define myJeeLink JeeLink <USB-Port>@57600''<br />
<br />
Der name "myJeeLink" kann bei Bedarf angepasst werden.<br />
<IP-Adresse> muss entsprechend angepasst werden.<br />
<br />
Beispiel:<br />
<source lang="php">define myJeeLink JeeLink /dev/ttyUSB0@57600</source><br />
*'''/dev/ttyUSB0''' Falls bereits mehrere USB Geräte angeschlossen sind muss der USB Port angepasst werden.<br />
<br />
<br />
'''Hinweis:''' Sind mehrere USB Devices am FHEM Server (z.B. RPI, Cubietruck etc.) in Betrieb, dann ist die Zuordnung über den USB-Port nicht zuverlässig. Die Ports werden u.a. in der Reihenfolge vergeben, in der die Geräte angeschlossen werden. Zuverlässiger und eindeutiger ist die Zuordnung über die Serial-ID.<br />
<br />
Dieser Befehl zeigt die Serial-ID der angeschlossenen USB-Devices an: <br />
<source lang="php">ls -l /dev/serial/by-id</source><br />
<br />
Beispiel für die Ausgabe:<br />
<source lang="php">lrwxrwxrwx 1 root root 13 Mai 14 10:37 usb-Prolific_Technology_Inc._USB-Serial_Controller-if00-port0 -> ../../ttyUSB1<br />
lrwxrwxrwx 1 root root 13 Mai 30 11:27 usb-Silicon_Labs_CP2102_USB_to_UART_Bridge_Controller_0001-if00-port0 -> ../../ttyUSB2<br />
lrwxrwxrwx 1 root root 13 Apr 16 14:52 usb-Silicon_Labs_ELV_USB-Modul_UM2102_EVFSRFF8COEXIKOT-if00-port0 -> ../../ttyUSB0</source><br />
In diesem Fall ist u.a. ein DEVKIT 1.0 mit der Serial-ID ''usb-Silicon_Labs_CP2102_USB_to_UART_Bridge_Controller_0001-if00-port0 -> ../../ttyUSB2'' angeschlossen.<br />
<br />
Auf Basis dieser Informationen lässt sich folgende Definition erstellen:<br />
<br />
<source lang="php">define myJeeLink JeeLink /dev/serial/by-id/usb-Silicon_Labs_CP2102_USB_to_UART_Bridge_Controller_0001-if00-port0@57600</source><br />
Wichtig ist es, die Übertragungsrate von 57600 bit/s anzugeben.<br />
<br />
==Reconnect==<br />
Falls das LaCrosse Gateway nicht erreichbar ist (Kein Strom/Stromausfall, WLAN Verbingung unterbrochen etc.), bricht das JeeLink Device die Kommunikation ab. Über das entsprechende ''timeout'' Attribut kann das JeeLink device so konfigurert werden, dass es in regelmässigen Abständen erneut versucht eine Verbindung mit dem LaCrosseGateway herzustellen.<br />
<br />
Konfigurationsempfehlung für ''timeout'' = 120 Sekunden und ''checkInterval'' = 30 Sekunden:<br />
<br />
Der Wert kann in FHEM wie folgt gesetzt werden:<br />
<source lang="php">attr myJeeLik timeout 120,30</source><br />
'''''myJeeLik''' muss auf den Gerätenamen in FHEM angepasst werden.''<br />
<br />
Während das LaCrosseGateway eine WiFi-Verbindungen aufbaut, benötigt das JeeLink-Modul je nach Konfiguration einige Zeit bis es einen neuen Connect auf den Datenport des LaCrosseGateway versucht. Das Finden der optimalen Werte erfordert etwas Geduld, es kann auch schon mal ein, zwei Minuten Dauern, bis die ersten Daten in FHEM übertragen werden.<br />
<br />
<br />
'''''Erklärung der Timeout Werte:'''''<br />
120,30 prüft alle 30 Sekunden, ob seit mindestens 120 Sekunden keine Daten mehr übermittelt wurden (myJeeLink_TIME) und falls dem so ist, macht es einen Reset auf der Schnittstelle, was die Verbindung zum LaCrosseGateway neu aufbaut. Das bedeutet, in so einem Fall ist die Verbindung nach spätestens 150 Sekunden wieder hergestellt.<br />
<br />
'''''Hinweis:''' Mit diesem Attribut wird lediglich eine neue Verbindung aufgebaut, dabei wird das LaCrosseGateway nicht resetet.''<br />
<br />
==JeeLink Set/Get-Befehle==<br />
Mit dem LaCrosseGateway Skatch funktionieren nur die foldenden JeeLink ''"Set"''-Befehle:<br />
<source lang="php">LaCrossePairForSec, flash, raw und reset</source><br />
'''''Achtung:''' Die Verwendung von hier nicht aufgeführten Befehlen kann zu inkonsistenten Einstellungen des LaCrosseGateway führen.''<br />
<br />
Bisher existieren keine funktionierenden JeeLink ''"Get"'' Befehle.<br />
<br />
==Liste aller initCommands==<br />
Eine aktuelle Liste der initCommands, die man von FHEM, Terminalprogramm oder Web-Frontend aus senden kann, sind auf dem Web-Frontend "Help"-Page" des LaCrosseGateways (ab V1.17) aufgeführt.<br />
<br />
[http://IP-Adresse/setup http://IP-Adresse oder Hostname/setup]<br />
<br />
<source lang="php"><br />
<n>a set to 0 if the blue LED bothers<br />
<n>c use one of the possible data rates (for transmit on RFM #1)<br />
<n>d set to 1 to see debug messages<br />
<8266>e Clear EEPROM<br />
<n>f initial frequency in kHz (5 kHz steps, 860480 ... 879515)<br />
<n>h Altitude<br />
<n,f,i>i Init PCA for Radio #<n> to <m>MHz and <i>s Interval<br />
<n>m bits 1: 17.241 kbps, 2 : 9.579 kbps, 4 : 8.842 kbps, 8 : 20.000 kbps (for RFM #1)<br />
<n>M bits 1: 17.241 kbps, 2 : 9.579 kbps, 4 : 8.842 kbps, 8 : 20.000 kbps (for RFM #2)<br />
<n>#<x>m bits 1: 17.241 kbps, 2 : 9.579 kbps, 4 : 8.842 kbps, 8 : 20.000 kbps (for RFM #x)<br />
<n>o set HF-parameter e.g. 50305o for RFM12 or 1,4o for RFM69<br />
<n>p payload on the serial port (1: all, 2: only undecoded data)<br />
<n>r use one of the possible data rates (for RFM #1)<br />
<n>R use one of the possible data rates (for RFM #2)<br />
<n>#<x>r use one of the possible data rates (for RFM #x)<br />
<x,x,...>s Send to PCA301 (must be 10 byte)<br />
<x,x,...>S Send to CustomSensor<br />
<n>t 0=no toggle, else interval in seconds (for RFM #1)<br />
<n>T 0=no toggle, else interval in seconds (for RFM #2)<br />
<n>#<x>t 0=no toggle, else interval in seconds (for RFM #x)<br />
v show version<br />
<n>w 0=no wifi<br />
<n>z set to 1 to display analyzed frame data instead of the normal data<br />
</source><br />
<br />
==LaCrosseGateway zurücksetzen==<br />
Das LaCrosseGateway kann über ein Terminalprogramm, dafür muss das LaCrosseGateway per USB angeschlossen sein, zurückgesetzt werden.<br />
Im Terminalprogramm (Baudrate 57600) den Befehl: <source lang="php">8266e</source> senden.<br />
<br />
Daraufhin wird wieder der Access Point aktiviert auf der die initiale Konfiguration über die [http://192.168.222.1/setup "Setup"] Seite vorgenommen werden kann.<br />
<br />
==Sensoren/Aktoren anlegen==<br />
<br />
Voraussetzung: FHEM autocreat ist aktiv.<br />
Die [http://fhem.de/commandref.html#autocreate FHEM autocreate Funktion] ist aktiv.<br />
<br />
Die erkannnten Sensoren und Aktoren werden automatisch erkannt und in FHEM angelegt, sobald Daten empfangen werden.<br />
<br />
Empfangene Sensoren werden nur hinzugefügt werden, wenn man LaCrossePairForSec auf 120 Sekunden gesetzt wird.<br />
<source lang="php">set myJeeLink LaCrossePairForSec 120 ignore_battery</source><br />
<br />
==Inbetriebnahme von BMP180 / BME280==<br />
Damit die Daten der o.g. Sensoren in FHEM zur Verfügung stehen, muss zunächst das FHEM-Device angelegt werden.<br />
<br />
Das Anlegen kann automatisch erfolgen, dafür muss der folgende FHEM Befehl ausgeführt werden:<br />
<source lang="php">set myJeeLink LaCrossePairForSec 120 ignore_battery</source><br />
<br />
Dann sollte von [http://fhem.de/commandref.html#autocreate FHEM autocreate Funktion] ein LaCrosse Device mit der [[#Sensor-ID | Sensor-ID]] (Default Wert: 0) angelegt werden.<br />
<br />
Alternativ kann das FHEM Device manuell angelegt werden:<br />
Die '''''ID''''', mit der das LGW die internen Sensoren sendet, entspricht der konfugurierten [[#Sensor-ID | Sensor-ID]] (Default Wert: 0)<br />
Es verhält sich so, als ob es eine Wetterstation (wie z.B. WS 1600) wäre.<br />
<source lang="php">define <name> LaCrosse 00</source><br />
Anchließend muss eine Höhenkorrektur (Grund: der Luftdruck wird immer bezogen auf NN angegeben, der Sensor liefert aber den Absolutdruck) mit dem command '''''h''''' in den initCommands vorgenommen werden, dies erfolgt mit dem FHEM Befehl:<br />
<br />
'''''Beispiel:''' 220h legt 220m über NN fest.''<br />
<source lang="php">attr myJeeLik initCommands 220h</source><br />
<br />
==Inbetriebnahme Piezo Summer==<br />
<br />
Der Piezo Summer wird in FHEM über das JeeLink Modul angesteuert.<br />
<br />
'''Beispiele:''' <br />
<source lang="php"><br />
set myJeeLink raw 1,60b -> beep ... beep ... beep 60 Sekunden lang<br />
set myJeeLink raw 2,300b -> beep beep ... beep beep ... beep beep 300 Sekunden lang<br />
set myJeeLink raw 3,120b -> beep beep beep ... beep beep beep ... 120 Sekunden lang<br />
set myJeeLink raw 0b -> beep stoppen<br />
</source><br />
<br />
==Inbetriebnahme von RFM69CW==<br />
Mit dem LaCrosseGateway ist es möglich mehrere RFM69CW einzusetzten. Nachfolgend wird die Konfiguration des Senders/Empfängers erläutert.<br />
<br />
Die "Default Werte" (wenn keine Angaben definiert werden) für die data rate sind wie folgt definiert:<br />
<source lang="php"><br />
#1 (Erste) => 17241<br />
#2 (Zweite) => 9579<br />
#3 (Dritte) => 8842<br />
#4 (Vierte) => 20000<br />
#5 (Fünfte) => 17241<br />
</source><br />
<br />
'''''Hinweis:''' Detailinformationen sind auch auf der LaCrosseGateway "Help"-Page zu finden.''<br />
<br />
{| class="wikitable" style="margin-left: auto; margin-left: 0px;"<br />
|-<br />
|colspan="2" style="text-align:center"|'''<Datenrate>#<Radio-Nummer><command>'''<br />
|-<br />
| <code>m t:</code> || ''Toggle-Steuerung'' <br />
|-<br />
| <code>r:</code> || ''Datarate'' <br />
|-<br />
| <code>f:</code> || ''Frequenz'' <br />
|}<br />
<br />
<br />
'''''Beispiele:'''''<br />
<br />
''<br />
{| class="wikitable" style="margin-left: auto; margin-left: 0px;"<br />
!Definition !! Erläuterungen <br />
|-<br />
| <source lang="php">attr myJeeLink initCommands 0#1r v</source><br />
| DataRate des ersten RFM setzen<br />
|-<br />
| <source lang="php">attr myJeeLink initCommands 8842#3r v </source><br />
| DataRate des dritten RFM setzen<br />
|-<br />
| <source lang="php">attr myJeeLink initCommands 868300#2f v</source><br />
| Frequenz des zweiten RFM setzten<br />
|-<br />
| <source lang="php">attr myJeeLink initCommands 868295#3f v</source><br />
| Frequenz des dritten RFM setzten<br />
|-<br />
| <source lang="php">attr myJeeLink initCommands 17241#1r 8842#2r v</source><br />
| Zwei RFM69CW mit DataRate 17241 und 8842<br />
|-<br />
| <source lang="php">attr myJeeLink initCommands 3#1m 20#1t 8842#2r v</source><br />
| Zwei RFM69CW mit 20 Sekunden DataRate 17241 toggle 9579 plus 8842 permanent<br />
|-<br />
| <source lang="php">attr myJeeLink initCommands 220h 868295#1f 868310#2f v</source><br />
| Zwei RFMs Frequenz 868295 und 868310 sowie Höhe über NN<br />
|-<br />
| <source lang="php">attr myJeeLink initCommands 868295#1f 3#1m 20#1t 2,868950,60i 8842#3r 220h 0a v</source><br />
| Drei RFMs Frequenz 868295 / PCA301 / WS1600 sowie Höhe über NN <br>Radio 1 auf 868295 MHz und Toggle 9K/17K mit 20 Sekunden<br>Radio 2 für PCA301 initialisiert (geht nur bei mir, ist noch nicht in der 1.11 enthalten)<br>Radio 3 macht 8842 kbps für die WS 1600<br>Höhe 220m über NN<br>Activity LED aus<br>v am Ende ruft die neu gesetzen Daten vom LaCrosseGateway ab, damit sie in FHEM JeeLink Modul aktualisiert werden.<br />
|}<br />
<br />
'''''Hinweis:''' Es ist wichtig ein "v" an das Ende eines initCommands anzuhängen. Damit wird veranlasst, dass das LaCrosseGateway seine neuen Einstellungen an FHEM zurückmeldet.<br />
==Inbetriebnahme von PCA301==<br />
PCA301 im LGW funtioniert ähnlich dem PCA301 Sketch, allerding mit einigen systembedingten Abweichungen.<br />
<br />
Per default ist PCA301 nicht aktiviert, es muss in den initCommands aktiviert werden. Dazu gibt es das command "'''''i'''''".<br />
<br />
'''<RadioNr>,<Frequenz>,<Poll-Intervall>i'''<br />
<br />
Die Initialisierung kann auch erneut geschickt werden, um z.B. das Poll-Intervall zu ändern.<br />
<br />
<br />
'''''Wichtig:''''' Es darf nur '''"ein"''' Radio für PCA301 initialisiert sein, nicht mehrere. Das PCA301 initialisierte Radio ist dediziert für PCA301 zuständig, es kann nicht zwischen anderen Protokollen (z.B. LaCrosse) toggeln.''<br />
<br />
Das ''Poll-Interval'' sollte nicht extrem heruntergesetzt (nicht unter eine Minute) werden, da PCA301 sonst LaCrosse verdrängt. PCA301 hat hörere Priorität, da es bei der Kommunikation<br />
mit den Dosen keine Antworten überhören darf.<br />
<br />
Unter Umständen muss die Frequenz etwas angepasst werden, wenn das Radio und/oder die Dosen nicht genau auf 868950 liegen.<br />
Das ist daran zu erkennen, dass entweder gar keine Antwort von den Dosen oder verzögerte Antwort ankommt.<br />
Werte von 868960 oder 960970 haben in manchen Fällen Abhilfe gebracht.<br />
<br />
'''''Beispiele:'''''<br />
<br />
{| class="wikitable" style="margin-left: auto; margin-left: 0px;"<br />
! Definition !! Erläuterungen <br />
|-<br />
| style="width:40%" | <code>attr myJeeLink initCommands 2,868950,120i v</code><br />
| Initialisiert den zweiten RFM auf 868950 MHz und setzt das Poll-Intervall auf 120 Sekunden<br />
|-<br />
| <code>attr myJeeLink initCommands 1,868950,120 3#2m 20#2t 220h 0a v</code><br />
| Initialisierung eines LaCrosseGateways mit zwei Radios für TX29, TX35, PCA301 und BMP180/BME280.<br>Das erste Radio macht PCA301 und das zweite toggelt 17241/9579 im 20 Sekunden Takt um TX29 und TX35 zu empfangen<br>der BMP180/BME280 liefert den Druck für 220m Meereshöhe<br>die LED ist deaktiviert<br />
|}<br />
<br />
'''Ablauf:'''<br />
<br />
Nachdem PCA301 initialisiert ist, lauscht das LaCrosseGateway auf der entsprechenden Frequenz.<br />
Sobald eine Dose empfangen wurde, wird sie in der Konfiguration (EEPROM) dauerhaft registriert und ab sofort gepollt.<br />
<br />
Das ''Polling'' funtioniert so, dass für jede Dose geschaut wird, wann sie zuletzt empfangen wurde und wenn das länger als das konfigurierte Interval zurück liegt,<br />
dann wird sie abgefragt. Wenn sonst etwas (Basisstation, anderes FHEM) die Dose abgefragt hat und das LaCrosseGateway die Antwort gehört hat, dann gilt das auch als<br />
empfangen und es wird kein eigener Poll für die Dose ausgelöst. ''Das Zusammenspiel mit einer echten Basisstation konnte bisher nur grob simuliert werden.''<br />
<br />
Das ''Pairing'' (also die Vergabe eines Kanals) funktioniert wie im PCA301-Sketch, button an der Dose ''"3 Sekunden"'' drücken, dann vergibt das LaCrosseGateway den nächsten freien Kanal.<br />
Dosen, die bereits einen Kanal haben, können durch ein Schalten vor Ort, an das LaCrosseGateway anlernt werden. Das LaCrosseGateway erkennt sie und nimmt sie in die<br />
Konfiguration auf. Falls die Dose bereits mit einem anderen Kanal bekannt war, wird der Kanal im LaCrosseGateway aktualisisert.<br />
<br />
Auf der Setup-Page im Web-Frontend (http://IP-Adresse oder Hostname/setup) des LaCrosseGateway kann die Liste der bekannten Dosen (ID=Kanal) eingesehen werden. Hinweis: Es sollten keine Änderungen in diesem Bereich vorgenommen werden.<br />
<br />
Wenn ein Kommando (Schalten, Daten abfragen, ...) an eine Dose gesendet wurde und keine Antwort kam, wird bereits im Sketch drei mal versucht, eine Antwort zu bekommen.<br />
<br />
Das PCA301 Modul in FHEM funktioniert komplett wie bisher.<br />
<br />
Weiterführende Themen zum PCA301 sind im Wiki [[PCA301 Funkschaltsteckdose mit Energieverbrauchsmessung]] und PCA301 FHEM Thread {{Link2Forum|Topic=11648|LinkText=JeeLink / PCA301 Thread}} beschrieben.<br />
<br />
Die Befehle, die der PCA301-Sketch kennt, gibt es im LaCrosseGateway nur teilweise:<br />
{| class="wikitable" style="margin-left: auto; margin-left: 0px;"<br />
! Befehl (Beschreibung)!! Erläuterungen <br />
|-<br />
| <code>a "turn activity LED on or off</code><br />
| wie bisher<br />
|-<br />
| <code>l "list known devices"</code><br />
| entfallen, kann man nun im Web-Frontend sehen<br />
|-<br />
| <code>q "turn quiet mode on or off"</code><br />
| wie bisher<br />
|-<br />
| <code>r "list recordings"</code><br />
| entfallen<br />
|-<br />
| <code>s "send to plug"</code><br />
| wie bisher<br />
|-<br />
| <code>v "report version and configuration parameters"</code><br />
| wie bisher<br />
|-<br />
| <code>d, e, p "poll / turn a device on / off"</code><br />
| entfallen<br />
|-<br />
| <code>h, +, -, # "modify and display RF12 Frequency register"</code><br />
| entfallen, ersetzt durch das "i" command bzw. das bereits vorhandene "f" command<br />
|}<br />
<br />
==Inbetriebnahme von Energy Count 3000 (EC3000)==<br />
Die EC3000 sendet auf 868.300 kHz mit 20.000 kbps. Dafür wurde eine neue data rate hinzugefügt.<br />
Sie kann mit 3r oder 20000r gesetzt werden. Wenn diese data rate gesetzt wird, wird auch automatisch der RFM69 auf den Empfang von EC3000 uminitialisiert.<br />
<br />
EC3000 kann auch in einen data rate toggle mit einbezogen werden. Dazu gibt es nun das bit mit dem Wert 8 für 20.000 kbps<br />
<br />
Um EC3000 dediziert mit einem der drei RFMs zu empfangen muss man einfach die data rate des gewünschten RFM setzen. Beispiel initCommand:<br />
20000#2r<br />
<br />
Um EC3000 in einen data rate toggle mit einzubeziehen muss im m command das 8-wertige bit gesetzt werden.<br />
Wenn man z.B. mit dem zweiten Radio 17k Sensoren (TX29...) und EC3000 empfangen soll (20 Sekunden toggle), wäre das initCommand:<br />
<br />
'''Beispiel:'''<br />
<source lang="php">attr myJeeLink initCommands 9#2m 20#2t v</source><br />
<br />
==Inbetriebnahme von MCP23008==<br />
Auf der LaCrosseGateway "config"-page kann für jeden der 8 IO Pins konfiguriert werden, ob es ein Input oder Output Pin ist.<br />
<br />
'''Input''': Eingang, wird per KVP an FHEM übermittelt. Einsatzzweck: z.B. Anschluß von Pushbuttons.<br />
<br />
'''Output''': Kann von FHEM aus gesetzt werden. Einsatzzweck: z.B. Anschluß von LEDs.<br />
<br />
<br />
Beispiel: ''Input => Eingang, wird per KVP an FHEM übermittelt''<br />
<source lang="php">OK VALUES LGPB 211 GP2=0,GP3=1,GP4=0,GP5=0,GP6=0,GP7=0</source><br />
<br />
Beispiel: ''Output => Kann von FHEM aus gesetzt werden.''<br />
<source lang="php">set myJeeLink raw "MCP GP0=1,GP1=0"</source><br />
<br />
==Inbetriebnahme von OLED-Display==<br />
Wird derzeit (Stand: 05.2016) {{Link2Forum|Topic=52921|LinkText=hier}} diskutiert und entwickelt.<br />
<br />
Ab der Version 1.19 ist der nachfolgende Funktionsumfang implementiert:<br />
<br />
*OLED ein- und auschalten über FHEM, mithilfe des JeeLink-Moduls<br />
* Anzeige von Statusinformationen in der obersten Zeile mithilfe von Symbolen (siehe Abbildung - von links nach rechts)<br />
**WiFI connect erfolgreich<br />
**Ein FHEM hat sich auf einen DataPort connected<br />
**Ein FHEM hat sich auf den Prozessor an der [[#Serial_transparent_bridge|uart bridge]] connected<br />
**Rechts oben wird die WiFi Signalstärke (dBm) angezeigt. Hinweis: -36 ist besser als -60 <br />
<br />
[[Datei:lgw_oled_statuszeile.png|400px|thumb|left|OLED Anzeige von Statusinformationen]]<br />
<div style="clear:both;"></div><br />
<br />
'''''Beispiele:'''''<br />
<br />
{| class="wikitable" style="margin-left: auto; margin-left: 0px;"<br />
! Definition !! Erläuterungen <br />
|-<br />
| style="width:50%" | <source lang="php">set myJeeLink raw "OLED On"</source><br />
| Schaltet ein angeschlossenes Display ein<br />
|-<br />
| <source lang="php">set myJeeLink raw "OLED Off"</source><br />
| Schaltet ein angeschlossenes Display aus<br />
|}<br />
<br />
==Serial transparent bridge==<br />
Das LGW kann optional die serielle Schnittstelle des SC16IS750 transparent auf einem TCP Port bereitstellen.<br />
Dazu gibt es die neuen settings ''"Serial bridge port"'' und ''"Serial bridge baud"'' auf der "Setup"-Page" (Web-Frontend) des LaCrosseGateways.<br />
Das LaCrosseGateway überträgt transparent die Daten der seriellen Schnittstelle an FHEM und umgekehrt.<br />
Damit kann z.B. ein NanoCUL an das LaCrosseGateway angeschlossen werden und in FHEM verwenden werden.<br />
<br />
<br />
'''''Vorgehensweise:'''''<br />
*Einen NanoCUL bauen, z.B. auf Basis eines Arduino Pro Mini, flashen und testweise in Betrieb nehmen. <br />
*Den NanoCUL an die serielle Schnittstelle des SC16IS70 anschließen<br />
*Port und baud rate auf der "Setup"-Page des LaCrosseGateways festlegen, z.B. Port 85 und 38400 baud<br />
*CUL in FHEM definieren (Beispiel): <br />
<source lang="php">define CULXYZ CUL <IP-Adresse>:85 0000</source><br />
'''''<CULXYZ>''''' Muss nach eigenen Bedürfnissen angepasst werden.<br />
<br />
'''''<IP-Adresse>''''' Muss entsprechend angepasst werden.<br />
<br />
Sollte das CUL-Device nicht erreichbar sein (Restart, Austausch im Falle eines Deffekts etc.), empfiehlt sich einen reconnect Mechnismus in FHEM zu implementieren.<br />
<br />
Dieser kann wie folgt aussehen: <br />
<br />
<source lang="php">define CULXYZ-Reconnector at +*00:00:30 {\<br />
my $deviceName = "<CULXYZ>";;\<br />
my $version = CommandGet("", $deviceName . " version");;\<br />
my $gotAnswer = index($version, 'No answer') == -1;;\<br />
\<br />
if(!$gotAnswer) {\<br />
fhem("set " . $deviceName . " reopen");;\<br />
}\<br />
\<br />
} </source><br />
'''''<CULXYZ>''''' Muss nach eigenen Bedürfnissen angepasst werden.<br />
<br />
==Zugriff mit mehreren FHEM Instanzen==<br />
<br />
Bis zu drei FHEM Instanzen können auf das LaCrosseGateway gleichzeitig zugreifen.<br />
Auf der "Setup"-Page des LaCrosseGateways können bis zu drei Ports (Data ports), pro Port eine FHEM Instanz, definiert werden (Reboot erforderlich).<br />
Aus Performancegründen empfiehlt sich nur die benötigten Ports zu definieren.<br />
<br />
'''''Hinweise:''''' Die Portnummer 8266 wird für OTA Update verwendet, und 80 für die "Config"-page. Aus diesem Grund ist die Verwendung dieser ports nicht erlaubt.<br />
<br />
Wenn sich mehrere FHEM Instanzen ein LaCrosseGateway teilen, dann ist darauf zu achten, dass die eine gemeinsame/gleiche initCommand Konfiguration haben. Sollten die FHEM Instanzen unterschiedliche initCommands senden, gewinnt das (zufällig) letzte und legt es für alle anderen fest.<br />
<br />
<br />
=Nano LaCrosse Gateway=<br />
Das nano LaCrosse Gateway verwendet die gleiche [https://sourceforge.net/p/fhem/code/HEAD/tree/trunk/fhem/FHEM/firmware/JeeLink_LaCrosseGateway.bin?format=raw Firmware] wie das WiFi LaCrosse Gateway, der signifikante Unterschied ist die kompakte (portable) Bauform. Aufgrund der Bauform können jeodch nicht alle Bauteile verwendet werden.<br />
Das Gateway eignet sich sehr gut als Entwicklungstick (dies ist der Entstehungsgrund) oder zum Empfangen und Steuern von LaCrosse basierten Sensoren/Aktoren an einem FHEM Server (RPI,Cubietruck, etc.).<br />
<br />
Der Betieb über WiFi, entsprechende Stromversorgung (per USB) vorausgesetzt, ist ebenfalls möglich.<br />
<br />
Weiterführende Informationen zum nano LaCrosse Gateway und Ideensammlung für eine Platine sind im {{Link2Forum|Topic=51329|LinkText=FHEM Forum}} zu finden.<br />
<br />
==Bauteile==<br />
Folgende bauteile werden benötigt:<br />
*[http://www.elv.de/output/controller.aspx?cid=74&detail=10&detail2=36507 Gehäuse]<br />
*ESP-12E<br />
*Auto-Flash-Reset-Schaltung mit zwei Widerständen<br />
*[http://www.aliexpress.com/item/6Pin-USB-2-0-to-TTL-UART-Module-Serial-Converter-CP2102-STC-Replace-Ft232/32364013343.html?spm=2114.13010208.99999999.261.mWmpl5 CP2102 FTDI]<br />
*Breakout board mit einem AMS 1117 3.3V<br />
*RFM69CW<br />
*Status-LED<br />
<br />
==Schaltung==<br />
[[Datei:lgw_nano_Schaltplan.png|600px|thumb|left|LaCrosseGateway Platine Oberseite]]<br />
<div style="clear:both;"></div><br />
<br />
==Selbstbau nano LaCrosse Gateway==<br />
{| class="galleryTable noFloat"<br />
|-<br />
| [[Datei:lgw_nano_Selbstbau1.png|320px|thumb|left|Selbstbau nano LaCrosse Gateway 1]]<br />
| [[Datei:lgw_nano_Selbstbau2.png|300px|thumb|left|Selbstbau nano LaCrosse Gateway 2]]<br />
| [[Datei:lgw_nano_Selbstbau3.png|475px|thumb|left|Selbstbau nano LaCrosse Gateway 3]]<br />
|}<br />
<br />
==Platine nano LaCrosse Gateway==<br />
Stand 05.2016 noch nicht fertig gestellt. <br />
Der aktuelle Entwicklungsstand ist im {{Link2Forum|Topic=51329|LinkText=FHEM Forum}} zu finden.<br />
<br />
[[Datei:lgw_nano_Platine_Prototyp.jpg|600px|thumb|left|Ein Protoyp der Platine für das nano LaCrosse Gateway]]<br />
<div style="clear:both;"></div><br />
<br />
= Tipps & Tricks =<br />
<br />
==Löschen des kompletten Flash des ESP8266 mit dem esptool==<br />
Aufgrund eines aktuell im espressif SDK vorhandenen Bugs, kann es passieren, dass das LaCrosseGateway nach dem Aufspielen der Firmware, mit einer Exception den Bootvorgang (nach "Start WIFI_STA") abbricht und nicht mehr ordnungsgemäß starten kann. In diesem fall hilft nur noch das Löschen des kompletten Speichers des ESP8266 und das erneute Aufspielen der Firmware.<br />
<br />
Mit dem nachfolgenden Befehl kann der Speicher des ESP8266 komplett gelöscht werden.<br />
<br />
'''''Achtung:''' Dabei werden alle Einstellungen unwiderruflich gelöscht''<br />
<source lang="php">./esptool -vv -cp /dev/tty.SLAB_USBtoUART -cb 115200 -ca 0x00000 -cd nodemcu -ce</source><br />
<br />
'''''</dev/tty.SLAB_USBtoUART>''' Muss entsprechend angepasst werden.''<br />
<br />
=Weiterführende Links=<br />
Diskussionsthread aus dem Forum:<br />
<br />
[https://forum.fhem.de/index.php/topic,43672.0.html LaCrosseGateway - LaCrosse, PCA301 und EC3000 über wifi mit ESP8266 ohne Arduino]<br />
<br />
[https://forum.fhem.de/index.php/topic,45594.0.html Platine für LaCrosseGateway: Platinenbestellung]<br />
<br />
[https://forum.fhem.de/index.php/topic,51329.30.html Platine für nanoLGW (LaCrosse Gateway): Layout]<br />
<br />
[https://forum.fhem.de/index.php/topic,52921.0.html Display für LaCrosseGateway]<br />
<br />
[https://forum.fhem.de/index.php/topic,52895.0.html SC16IS750-Software-Clone]<br />
<br />
[[Kategorie:Interfaces]]<br />
[[Kategorie:IP Components]]<br />
[[Kategorie:Other Components]]<br />
[[Kategorie:Temperatursensoren]]<br />
[[Kategorie:Feuchtesensoren]]<br />
[[Kategorie:Wetterstationen]]</div>Wzuthttp://wiki.fhem.de/w/index.php?title=JeeLink&diff=11954JeeLink2015-08-12T11:39:36Z<p>Wzut: </p>
<hr />
<div>'''JeeLink''' ist ein RF-Gerät im Formfaktor eines USB-Sticks mit externer Antenne.<br />
{{Infobox Hardware<br />
|Bild=JeeLink.jpg<br />
|Bildbeschreibung=JeeLink mit Drahtantenne<br />
|HWProtocol=PCA301, EC3000, RoomNode oder LaCrosse und EMT7110<br />
|HWType=[[Interface]]<br />
|HWCategory=<br />
|HWComm=433/868/913 MHz<br />
|HWChannels=?<br />
|HWVoltage=5 V<br />
|HWPowerConsumption=ca. 90 mA<br />
|HWPoweredBy=USB<br />
|HWSize=23*67*9mm<br />
|HWDeviceFHEM=[http://fhem.de/commandref.html#JeeLink 36_JeeLink.pm]<br />
|ModOwner=[http://forum.fhem.de/index.php?action=profile;u=430 Andre / justme1968]<br />
|HWManufacturer=JeeLabs<br />
}}<br />
<br />
== Beschreibung ==<br />
Vergleichbar mit dem [[CUL]] von Busware, ist der JeeLink ein USB-Stick, mit dem Funk-Hausautomations-Komponenten angebunden werden können. CUL und JeeLink unterscheiden sich im Funkmodul (CUL -> CC1101; JeeLink -> RF12B), die nicht miteinander kompatibel sind. Daher kann man auch keinen CUL als JeeLink-Ersatz nutzen!<br />
<br />
Den JeeLink gibt es in einer <br />
* 433 MHz Version<br />
* 868 MHz Version (Standard)<br />
* 915 MHz Version (Betrieb in Europa nicht zugelassen)<br />
<br />
== Vorbereitung JeeLink == <br />
Um mit dem JeeLink die jeweils gewünschten Signale empfangen zu können, ist er zunächst mit der passenden Firmware zu versorgen. Dies kann auf zwei Arten geschehen. Entweder durch das selber kompilieren der Software und das Flashen aus der Arduino IDE oder aus Fhem heraus mit einem aktuellen Firmwareimage das per update mit ausgeliefert wird.<br />
<br />
=== Selber Kompilieren ===<br />
[[Datei:JeeLink_flashen_1.jpg|mini|100px|rechts|Vorbereitung: Arduino einrichten]]<br />
Um den JeeLink mit Fhem benutzen zu können, muss (mit der Arduino Software / Entwicklungsumgebung (IDE)) eine spezifische "Firmware" (ein Sketch) auf dem JeeLink installiert werden. Die generelle Vorbereitung für diese Aktion ist unabhängig vom benötigten Sketch und besteht aus den folgenden Schritten:<br />
* Für Windows oder Mac OS X den passenden [http://www.ftdichip.com/Drivers/VCP.htm FTDI Treiber] installieren, unter Linux ist dieser meist schon vorhanden<br />
* Installation der [http://arduino.cc/de/Guide/HomePage Arduino Software] für die benutzte Plattform (verfügbar sind Windows, Mac OS X und Linux)<br />
* Je nach Sketch einbinden der [https://github.com/jcw/jeelib/archive/master.zip Jeelabs Library] in die Arduino IDE<br />
* Herunterladen des benötigten Sketches (aus [http://sourceforge.net/p/fhem/code/HEAD/tree/trunk/fhem/contrib/arduino/ FHEM/contrib])<br />
* Anschließen des JeeLink an einen USB-Anschluss des Rechners mit der Arduino IDE<br />
* Start der Arduino Software und JeeLink flashen<br />
<br />
=== JeeLink aus Arduino flashen ===<br />
[[Datei:JeeLink_flashen_2.jpg|mini|100px|rechts|JeeLink Flashen]]<br />
* Anschließen des JeeLink an einen USB-Anschluss des Rechners mit der Arduino IDE<br />
* Start der Arduino Software<br />
* Seriellen Port des JeeLink auswählen<br />
* Einstellungen: in den Tools als Board "Arduino Uno" auswählen<br />
* Sketch mit "Datei öffnen" auswählen<br />
* Upload klicken<br />
<br />
=== JeeLink aus Fhem flashen ===<br />
* Auf dem Fhem System muss <code>avrdude</code> installiert sein. Das kann z.B. über die "normale" Linux Paketverwaltung geschehen.<br />
* mit <code>set <JeeLinkDevice> flash [firmware]</code> wird das Flashen angestossen<br><code>firmware</code> kann LaCrosse, PCA301 oder EC3000 sein. Wenn <code>firmware</code> nicht angegeben wird versucht FHEM den Namen der zu flashenden Firmware aus der zur Zeit installierten Firmware abzuleiten.<br />
* im Fhem Log kann der Ausgang des Flashvorgangs kontrolliert werden<br />
* über das <code>flashCommand</code> Attribut lässt sich das Kommando zum Flashen an besondere Anforderungen anpassen<br />
<br />
== Hinweise zum Betrieb mit Fhem == <br />
Um den JeeLink (erstmalig) mit Fhem benutzen zu können, muss dieser erfolgreich geflasht worden sein.<br />
* JeeLink an den Fhem-Rechner anschließen<br />
* Auf Linux Systemen kann es notwendig sein, mit <code>mknod /dev/ttyUSB0 c 188 0</code> das Device anzulegen (bitte erst überprüfen, ob der Stick nicht automatisch erkannt wird)<br />
<br />
=== Definition in fhem.cfg ===<br />
Erforderliche Definitionen in Fhem:<br />
:<code>define myJeeLink JeeLink /dev/ttyUSBx@57600</code><br />
*'''USBx''' ist anzupassen an die aktuell benutzte Schnittstelle, 0 wenn sonst nichts am USB-Port hängt<br />
*x=0,1,2, usw.<br />
<br />
Die [http://fhem.de/commandref.html#autocreate autocreate-Funktion] sollte aktiv sein. Alle erkannten Devices (PCA301, LaCrosse Sensoren incl. IT+ Wetterstation WS1600, EMT7110, EC3000, und RoomNodes) werden dann automatisch angelegt, sobald die jeweiligen Daten empfangen werden.<br />
<br />
Pro Geräte-Art/Protokoll muss ein eigener JeeLink mit dem passenden Sketch zum Empfang dieser Daten vorhanden sein (es kann jeweils nur ein Sketch im JeeLink aktiv sein und es gibt (zumindest derzeit (04/2014)) keinen Sketch, der mehr als eines der Protokolle abdeckt).<br />
<br />
'''Anmerkung:''' Der LaCrosse Sketch deckt sowohl die LaCrosse Temperatursensoren, die IT+ Wetterstation WS1600 als auch den Energieverbrauchssensor EMT7110 ab.<br />
<br />
=== PCA301 Sketch ===<br />
Der Sketch für die Unterstützung der ''PCA301 Funkschaltsteckdose mit Energieverbrauchsmessung'' (PCA301-pcaSerial.zip) kann von [http://sourceforge.net/p/fhem/code/HEAD/tree/trunk/fhem/contrib/arduino/ sourceforge] heruntergeladen werden. Details zur Benutzung finden sich im Artikel zur [[PCA301 Funkschaltsteckdose mit Energieverbrauchsmessung|PCA301]].<br />
<br />
Unter Umständen werden die Signale der PCA301 nicht empfangen. Insbesondere mit selbst erstellten "JeeLinks" durch wahrscheinlich hohe Bauteiltoleranzen der RF12B Sendeeinheiten. Mit dem im Sketch voreingestellten rf12_center_freq = 0xA6FE (868,9500 MHz) bekommt man in diesem Fall keine Steckdose angelernt.<br />
<br />
==== Frequenzanpassung über modifizierten Sketch ====<br />
Durch Tests mittels ''set <myJeeLink> raw +'' bzw ''set <myJeeLink> raw -'' kann man dann ermitteln, ob die Funksignale z.B. ab A703 bis A715 empfangen werden. Das entspricht einem Frequenzbereich zwischen 868,9750 MHz und 869,0550 MHz.<br />
Die Mitte ist die Lösung, die man dann im Sketch ändern muss:<br />
:<code>static uint16_t rf12_center_freq = 0xA70C;</code><br />
Anschließend auf den JeeLink neu flashen.<br />
<br />
==== Frequenzanpassung über Attribut initCommands ====<br />
Über das <code>initCommands</code> lässt sich die gefundene Frequenz einstellen, ohne dass die Firmware verändert werden muss. <br />
:<code>attr <JeeLinkDevice> initCommands <hhhh>h</code><br />
<br />
=== LaCrosse Sketch ===<br />
Der Sketch für die Unterstützung der LaCrosse Temperatursensoren, der IT+ Wetterstation WS1600 und des Energieverbrauchssensors EMT7110 kann von [http://sourceforge.net/p/fhem/code/HEAD/tree/trunk/fhem/contrib/arduino/ sourceforge] heruntergeladen werden.<br><br />
<br />
'''In der neuesten Version unterstützt er auch den SuperJee''' (siehe auch diesen {{Link2Forum|Topic=14786|Message=316924|LinkText=Forenbeitrag´}}) mit folgenden Optionen: <br />
<br />
* Option 1 (Dual RFM): <br />
:Es kann ein zweiter RFM12B oder RFM69CW angeschlossen werden. Somit können zwei data rates (z.B. 17241 für TX29DTH und 8842 für WS 1600) gleichzeitig empfangen werden. Das geht natürlich auch mit dem toggle mode, nur ist es bei der Wetterstation ärgerlich, wenn man 30 Sekunden lang nichts empfängt und dadurch die alles entscheidende Windböe verpasst.<br />
* Option 2 (BMP180): <br />
:Da der Luftdruck in den Basisstationen gemessen wird, steht er für FHEM nicht zur Verfügung.<br />
Deshalb kann nun optional ein BMP180 oder BMP085 angeschlossen werden. Auch hier wird automatisch erkannt, ob er vorhanden ist. <br />
:Der BMP180 wird mit 3,3V versorgt und SDA mit PC4 und SCL mit PC5 verbunden (siehe die in diesem {{Link2Forum|Topic=14786|Message=316924|LinkText=Forenbeitrag}} angehängte SuperJee-CL.png) <br />
<br />
==== Relay-Betrieb ====<br />
Der LaCrosse Sketch ermöglicht auch den Relay-Betrieb zur Reichweitenverbesserung. Er funktioniert damit ähnlich wie z.&nbsp;B. ein WLAN Range Extender. Wenn der Sketch für den Relay-Betrieb konfiguriert ist, wird jedes empfangene IT+ Datenpaket, das eine gültige Prüfsumme hat, direkt nach dem Empfang wieder gesendet.<br />
<br />
Das Prinzip ist generell recht einfach:<br />
# JeeLink im Sketch als Relais konfigurieren und flashen.<br />
# Auf "halber Strecke" (d.h. irgendwo zwischen dem primären Sender und dem entfernten Empfänger) auf ein USB-Steckernetzteil stecken. Der JeeLink arbeitet in diesem Modus "autonom", er benötigt also lediglich einen Spannungsversorgung.<br />
<br />
Der JeeLink empfängt und decodiert alle Protokolle, die er auch für FHEM unterstützt. Wenn er ein Paket empfangen hat (egal von welchem Sensor) und CRC OK war, dann sendet er es wieder aus. Der JeeLink am FHEM merkt keinen Unterschied. Falls ein Paket es doch bis zum FHEM direkt geschafft hat, kommt es dort zweimal an. Diese Situation muss in Fhem behandelt werden.<br />
<br />
Details zu diesem Betriebsmodus sind in diesen Forenbeiträgen ({{Link2Forum|Topic=14786|Message=165153|LinkText=LaCrosse}} bzw. {{Link2Forum|Topic=26494|Message=196648|LinkText=EMT7110}}) zu finden.<br />
<br />
==== Frequenzanpassung ====<br />
Ab Version LaCrosseITPlusReader.10.1e<br />
wurde der Sketch so erweitert, dass man von FHEM aus die Frequenz setzen kann.<br />
Dazu versteht er das neue Kommando "f":<br />
:<code>set myJeeLink raw 868295f</code><br />
setzt die Frequenz auf 868295 kHz<br />
<br />
Die Frequenz kann im Bereich von 860480 kHz bis 879515 kHz in 5 kHz -Schritten eingestellt werden.<br />
Details dazu in diesem {{Link2Forum|Topic=14786|Message=222541}} im Forum.<br />
<br />
==== Getestete iT+ Sensoren incl. Wetterstation WS 1600 ====<br />
Die in der folgenden Liste (Quelle: {{Link2Forum|Topic=14786|Message=164801|LinkText=Fhem Forum}}) aufgeführten Sensoren wurden bisher erfolgreich getestet:<br />
<br />
{| class="wikitable"<br />
!Bezeichnung !! Datenrate !! Link<br />
|-<br />
| TX25-IT || 17.241 kbps<br />
|-<br />
| TX27-IT || 17.241 kbps<br />
|-<br />
| TX29-IT || 17.241 kbps<br />
|-<br />
| TX29DTH-IT || 17.241 kbps<br />
|-<br />
| TX37 || 17.241 kbps<br />
|-<br />
| TX35TH-IT || 9.579 kbps<br />
|-<br />
| TX35DTH-IT || 9.579 kbps<br />
|-<br />
| 30.3143.IT || 17.241 kbps<br />
|-<br />
| 30.3144.IT || 17.241 kbps || ({{Link2Forum|Topic=17662|LinkText=Forenthread}})<br />
|-<br />
| 30.3147.IT || ? kbps<br />
|-<br />
| 30.3155WD || 9.579 kbps<br />
|-<br />
| 30.3156WD || 9.579 kbps<br />
|-<br />
|| WS 1600 || 8.842 kbps || ({{Link2Forum|Topic=14786|Message=297293|LinkText=Forenbeitrag}})<br />
|}<br />
<br />
==== EMT7110 ====<br />
Der EMT7110 läuft mit einer Datenrate von 9.579 kbps (Details dazu in diesem {{Link2Forum|Topic=26494|LinkText=Forenthread}}).<br />
<br />
Werden Sensoren mit unterschiedlichen Datenraten gleichzeitig betrieben, ist der Toggle Modus einzustellen, z.B. mit dem Befehl <br />
:<code>initCommands 30t v </code><br />
wobei ''30t'' für "Toggle Modus, alle 30 Sekunden" steht.<br />
<br />
=== Energy Count 3000 Sketch ===<br />
Der Sketch für die Unterstützung der Energy Count 3000 Zwischenstecker kann von [http://sourceforge.net/p/fhem/code/HEAD/tree/trunk/fhem/contrib/arduino/ sourceforge] heruntergeladen werden.<br />
<br />
Das Fhem Modul dazu (36_EC3000.pm) ist genau wie die Module für JeeLink (36_JeeLink.pm) und PCA301 (36_PCA301.pm) mittlerweile im aktuellen Fhem enthalten.<br />
<br />
=== JeeLabs RoomNode ===<br />
Eine Beschreibung zum Empfang der JeeLabs RoomNodes ist in {{Link2Forum|Topic=11648|Message=92037 diesem Forenbeitrag] enthalten.<br />
<br />
=== JeeLink LED deaktivieren ===<br />
Ein "dauerhaftes" Deaktivieren der LED des JeeLink ist möglich mit<br />
:<code>define not.global notify global:INITIALIZED set myJeeLink led off</code><br />
damit wird, sobald Fhem komplett gestartet ist, von Fhem der Befehl zum Ausschalten der LED gesendet. Alternativ kann mit <br />
:<code>attr myJeeLink initCommands 0a v</code><br />
dem Sketch die Anweisung gegeben werden, bei der Initialisierung die LED zu deaktivieren.<br />
''Quelle: dieser {{Link2Forum|Topic=27161|LinkText=Forenthread}}''<br />
<br />
=== Weitergehende Informationen ===<br />
Hinweise zum Betrieb eines JeeLink mit Fhem finden sich aktuell in größerer Anzahl in verschiedenen Diskussionen im Forum:<br />
* {{Link2Forum|Topic=11648|LinkText=JeeLink / PCA301}} - Analyse des Funkprotokolls; Anfänge der Entstehung der PCA301 Unterstützung in Fhem.<br />
* {{Link2Forum|Topic=14786|LinkText=JeeLink / LaCrosse}} - JeeLink Modul zur Einbindung von La Crosse<br />
* {{Link2Forum|Topic=11648|Message=92019|LinkText=JeeLink / EC3000}} - Anfänge der Entstehung der EC3000 Unterstützung in Fhem.<br />
* Hinweise zu {{Link2Forum|Topic=11648|Message=92037|LinkText=JeeLabs RoomNode}} und anderen JeeLab Nodes<br />
* {{Link2Forum|Topic=25399|Message=183910|LinkText=JeeLink mit FHEM2FHEM nutzen}}<br />
<br />
== Bekannte Probleme ==<br />
* Beim Betrieb an einer [[AVM Fritz!Box|FritzBox]] wird der JeeLink unter Umständen als ''Für die Nutzung mit dem USB-Fernanschluss reserviert'' angezeigt. In diesem Fall muss die Reservierung deaktiviert/aufgehoben werden (Details dazu in diesem {{Link2Forum|Topic=16579|LinkText=Forenthread}}).<br />
* Die Version ''v3c'' des JeeLink funktioniert (Stand 06/2015) nicht mit dem PCA301 Sketch (siehe Diskussion im Forum, startend {{Link2Forum|Topic=11648|Message=308267|LinkText=hier}}). Der LaCrosse Sketch funktioniert jedoch.<br />
<br />
== Weblinks ==<br />
* [http://jeelabs.com/products/jeelink JeeLabs], JeeLink Hersteller<br />
* [http://sourceforge.net/p/fhem/code/HEAD/tree/trunk/fhem/contrib/arduino/ PCA301 Sketch] auf sourceforge<br />
* [http://sourceforge.net/p/fhem/code/HEAD/tree/trunk/fhem/contrib/arduino/ LaCrosse Sketch] auf sourceforge<br />
* [http://sourceforge.net/p/fhem/code/HEAD/tree/trunk/fhem/contrib/arduino/ EC3000 Sketch] auf sourceforge<br />
* [http://blog.moneybag.de/hausautomation-fhem-mit-funksteckdose-energiemessung-elv-pca-301/ Blog] zum Thema JeeLink zur Anbindung von PCA301 und von LaCrosse Temperatursensoren an Fhem<br />
* [http://forum.fhem.de/index.php/topic,23217.0.html LevelSender] Tankfüllstand mit JeeLink empfangen<br />
<br />
<br />
[[Kategorie:Interfaces]]<br />
[[Kategorie:Other Components]]</div>Wzut