FHEMWiki - Benutzerbeiträge [de]

HomeMatic Devices pairen

2014-08-15T14:29:47Z

Yfhem: Removed space before full stop.

HomeMatic Geräte müssen mit dem für das HomeMatic-Protokoll eingesetzten IO-Device (zB CUL, CUN, HMLAN) ''gepaart'' = ''gepairt'' werden, damit sie von Fhem gesteuert oder ausgelesen werden können.

Die Adresse eines HomeMatic Gerätes ist nicht frei einstellbar, sondern für jedes Gerät fest vorgegeben. Da die HM-Geräte über eine sehr komplexe Kanalstruktur verfügen, empfiehlt sich daher, die Geräte in Fhem per ''autocreate'' Funktion anlegen zu lassen, Eine nachträgliche Umbenennung oder manuelle Bearbeitung der erzeugten Konfigurationsdaten ist problemlos möglich.

Erster Schritt: [[HomeMatic_Installieren|CUL/CUN/HMLAN installieren]]. Danach hier weiter:

= Grundlagen=
Durch das Pairing wird ein HM-Gerät genau einem IO-Device (zB CUL) zugeordnet. Wenn ein Gerät mit dem IO-Device gepairt ist, kann es darüber gesteuert werden.

Beim Pairing wird die HMID des IO-Device in das Gerät geschrieben. Das Pairing findet also im Wesentlichen im Gerät statt, nicht in FHEM selbst.

Zu bemerken ist, dass ein IO-Device (zB CUL) standardmäßig die ID F11034 von FHEM erhält. Da viele HM-Geräte das IO-Device nur anhand der HMIDs erkennen, können alle in Reichweite der HM-Geräte befindlichen IO-Devices mit der in das HM-Gerät geschriebenen HMID das HM-Gerät steuern. Hinzu kommt, dass die ''autocreate'' Funktion die in Reichweite befindlichen HM-Geräte findet und automatisch einbindet. Nachbarn, die IO-Devices mit der gleichen HMID betreiben, können also HM-Geräte untereinander sehen und steuern!

Es ist daher dringen zu empfehlen, die HMID vor dem Pairing der HM-Geräte mit:

attr <CUL> hmId <6-stellige Hexadresse>

zu individualisieren.

Gepairt wird nur das Device. Die Channels sind dem Device untergeordnet und somit implizit auch gepairt.

'''Achtung:''' Ist ein Device gepairt werden Konfigurationsänderungen über die Zentrale (FHEM) vorgenommen. Man kann u.a. keine Kanäle mehr ''direkt'' peeren (verknüpfen). Stattdessen verwendet man Kommandos in FHEM. Siehe <u>[[Homematic_Peering_Beispiele|peeren]]</u>

= IO-Device in den Pairing-Modus versetzen =
* CUL/CUN/HMLAN Konfigurator in den "Akzeptiere-Pairing-Requests-Modus" bringen:

set <CUL> hmPairForSec 600

600 bedeutet hier, dass das IO-Device 600 Sekunden, also 10 Minuten lang im Pairing-Modus ist.

Bei aktivem Pairing-Modus gibt das IO-Device folgende ''Internals'' Variable zurück:

hmPair 1

Alternativ kann

set <CUL> hmPairSerial <serial>

genutzt werden.

= Devices pairen =

Dazu ist ein Knopf zu drücken, üblicherweise so lange bis die LEDs blinken, meist nach ca. 5 Sekunden (bitte Handbuch beachten, Stichwort "anlernen"). Das Gerät wird in den Anlern- oder auch Konfigurationsmode versetzt. Es sendet hierzu eine entsprechende Nachricht an alle.
In FHEM werden nun:
* alle fehlenden Devices und Channels angelegt
* das Register pairCentral im Device gesetzt.

Ein save danach kann nicht schaden.

= Pairing verifizieren =
Nur weil ein Gerät angelegt wurde, heißt das '''nicht''', dass es auch gepaired ist. In den Readings eines Devices muss stehen (list <name> oder im Webinterface):

R_pairCentral 0xABCDEF

ABCDEF steht dabei für die HMID des IO-Device (zB CUL). Wurde für das IO-Device kein attribute mit einer individuellen HMID gesetzt, sollte hier die Standard-ID F11034 stehen. Die führende 0x steht für den Hinweis auf eine HEX-Adresse.

Ist das Pairing noch nicht abgeschlossen, kann man nach kurzer Pause den Befehl:

set <HM-Gerät> getConfig

absetzen, um zu prüfen, ob sich der Status zwischenzeitlich geändert hat. Wenn das Reading R_pairCentral nicht auftaucht oder der Wert mit set_ beginnt, hat das Pairing '''nicht''' geklappt. Man kann entweder:
* noch einmal probieren, ein getConfig auszulösen - vielleicht hat das Lesen nicht funktioniert
* noch einmal pairen - das schadet nichts

Alternativ kann man auch mit HMinfo einen Config check durchführen:

define hm HMInfo
set hm configCheck

= Vorgehen bei Problemen =

Wenn das Pairing nicht erfolgreich ist, das Gerät sich also nicht steuern lässt, ist es möglich, dass es schon bzw. noch mit einem anderen IO-Device gepairt ist. Dann das Gerät in den Auslieferungszustand bringen (siehe Handbuch, oft Knopf mindestens 5 Sekunden drücken, bis es blinkt, dann loslassen und nochmals 5 Sekunden drücken, bis es schneller blinkt) und danach erneut pairen.

Alternativ kann das Pairing per Befehl gelöst werden. Siehe dazu unten.

Wenn das zu pairende Geräte ein Empfänger ist, kann mit FHEM per Telnet oder in der Kommandozeile des Webinterfaces folgendes Kommando abgesetzt werden:

set <CUL> hmPairSerial <10-stellige Seriennummer>

Die 10-stellige Seriennummer ist beim Empfängern idR. auf der Rückseite des Geräte aufgedruckt. Die Seriennummer fängt normalerweise mit Buchstaben an und endet mit Zahlen.

Es gilt auch sicherzustellen, dass das zu pairende Gerät nicht bereits zuvor mit der Homematic Config Software gepairt wurde. Ist dies der Fall, so sollte das Pairing in der Homematic Config Software gelöscht und das Pairing in FHEM erneut durchgeführt werden.

= Gezieltes Pairing =
Bei bereits bekanntem HM-Gerät kann man mit:

set <Name HM-Gerät> pair

das pairing überschreiben. Es funktioniert aber nur, wenn schon ein IO-Device eingetragen ist.

= Pairing lösen =
Das Pairing kann mit:

set <Name HM-Gerät> unpair

gelöst werden. Wichtig ist dabei, dass das IO-Device, das entpairt werden soll, mit der ursprünglich in das HM-Gerät geschriebenen HMID konfiguriert ist.

[[Kategorie:HomeMatic Components]]
[[Kategorie:HOWTOS]]

CUL HomeMatic und FS20

2014-02-23T15:48:26Z

Yfhem: /* Antwort */ Fixed spacing.

== Frage ==
ist es möglich über FHEM mit einer CUL HomeMatic und FS20 parallel zu betreiben?

== Antwort ==
Nein. FS20, FHT etc. ist amplitudenmoduliert (AM) und sendet/empfängt mit einer Datenrate von 1 khz,
wärend HomeMatic frequenzmoduliert mit 20 khz Datenrate sendet/empfängt.

Ein CUL mit culfw kann man '''entweder''' im [[SlowRF]] Mode betreiben, und damit einige
Geraete mit 1kHz Datenrate, AM Modulation empfangen (FS20, S300, FHT, usw) '''oder''' im HomeMatic Mode mit 20kHz Datenrate, FM Modulation, aber nicht beides gleichzeitig.

Überdies ist in älteren Versionen des CUL (namentlich V2 oder älter) zu wenig Speicherplatz, sodass
die kombinierte culfw für beide Versionen nicht in den Speicher passt. Hier muss man sich dann für eine
speziell auf SlowRF oder HM angepasste Version der culfw entscheiden.

Es ist aber möglich, FHEM mit 2 CULs, eines im SlowFR (FS20/FHT) Modus und eines mit CUL_HM zu betreiben.
Ebenso kann ein CUL im SlowFR (FS20/FHT) Modus mit einem [[HMLAN Konfigurator]] in Kombination betreiben werden.

Siehe auch
[http://fhem.de/commandref.html#rfmode]

[[Kategorie:FAQ]]

Volkszaehler

2014-01-05T17:16:55Z

Yfhem: /* Daten mit Volkszaehler loggen */

[[Datei:volkszaehler.png|right]]

Volkszaehler.org ist ein freies SmartMeter Projekt für den Selbstbau ([http://www.volkszaehler.org siehe volkszaehler.org]) Der Nutzer behält dabei die vollständige Kontrolle über die anfallenden Daten seiner Strom-, Wasser- und Gaszähler.

==Features==
* 100% Open-Source
* kostenlos
* offene Protokolle
* erweiterbar
* minmale Anforderungen (LAMP-Stack)
* flexibele Verwaltungsmöglichkeiten
* Verbrauchs & Kostenprognose
* verschiedenste Messgrößen
** Strom
** Wasser
** Gas
** Betriebsstunden
** Temperatur
* Läuft u. a. auf Raspberry Pi ([http://wiki.volkszaehler.org/howto/raspberry_pi_image Installationsbeschreibung)]

== Volkszaehler in fhem einbinden ==

Das fhem-Modul für Volkszaehler.org bindet diese Daten in fhem ein. Das Modul 23_volkszaehler.pm greift per http auf den Volkszaehler zu und interpretiert die JSON-Antwort in fhem-device-Readings. Daraus können Logs und Plots gebildet werden oder devices mit Kennzahlen aus den Volkszaehler-Daten.

Es ist z. B. für Solarstrom-Anlagenbesitzer denkbar, bei hoher verfügbarer Sonnenenergie mit fhem Verbraucher einzuschalten, um die Eigenverbrauchsrate zu erhöhen, was die Energiekosten reduziert.

== Installation ==
Für die Installation müssen einige Files heruntergeladen und in die richtigen Verzeichnisse kopiert werden.

=== fhem-Modul ===
Die folgende Beschreibung geht von der Installation auf einer [[FritzBox]] aus.

Meine aktuellen Versionen liegen hier: <code>https://github.com/bgewehr/fhem</code>

Die Datei <code>23_VOLKSZAEHLER.pm</code> kommt ins Verzeichnis <code>\\fritz.box\FRITZ.NAS\fhem\fhem\</code>

Die Datei <code>volkszaehler.gplot</code> kommt ins Verzeichnis <code>\\fritz.box\FRITZ.NAS\fhem\fhem\www\gplot</code>

Nur zur Sicherheit: Um die Dateien auf einem Windows-Rechner lokal zu erstellen, bitte den Text aus der "raw" Ansicht aus Github kopieren und bitte nicht in Notepad, sondern in z. B. [http://www.heise.de/download/notepad.html Notepad++] einfügen und dann unter dem richtigen Dateinamen speichern. Mit Notepad von Microsoft werden falsche Zeilenenden erzeugt, die dann unter Linux nicht funktionieren.

=== JSON für Perl ===
Das Modul nutzt einen JSON-Interpreter, um die Antwort vom Volkszaehler in eine PERL-Variable zu wandeln. Dazu sind einige zusätzliche PERL Module notwendig.

JSON für PERL kann von hier geladen werden:

http://cpansearch.perl.org/src/MAKAMAKA/JSON-1.15/lib/JSON/
oder
https://github.com/makamaka/JSON/tree/master/lib

Das File JSON.pm muss auf einer Fritzbox 7390 mit fhem im internen Speicher in das Verzeichnis

\\fritz.box\FRITZ.NAS\fhem\lib\perl5\site_perl\5.12.2\mips-linux\

Für die Files Converter.pm und Parser.pm wird ein neues Verzeichnis angelegt:

\\fritz.box\FRITZ.NAS\fhem\lib\perl5\site_perl\5.12.2\mips-linux\JSON\

und die files dann dort abgelegt.

Auf anderen Plattformen müssen die Pfade ggf. entsprechend angepasst werden. Im Script startfhem werden die lib-Pfade mit

export xyz=pfad:pfad

angegeben, in die man die files ablegen kann, damit sie beim Aufruf gefunden werden.

== Definition der devices ==
Die Device Definitionen werden in einer Konfigurationsdatei (üblicherweise fhem.cfg) angelegt

define <name> VOLKSZAEHLER <ip-address> <port-nr> <channel> <state:last/min/max/average/consumption> <poll-delay>

* <name>: Name des neuen fhem-devices
* <ip-address>: IP des Volkszaehlers
* <port-Nr>: Port, auf dem der Volkszaehler-http-Server erreichtbar ist
* <channel>: UUID des Volkszaehler-Frontend-Channels, der gelesen werden soll
* <state>: Das Reading, welches als state genommen werden soll, kann im define gewählt werden. Dabei besteht die Auswahl aus
** last (letzter geladener Wert, manchmal leer bei zu kleinem poll-delay)
** min (kleinster Wert innerhalb des poll-delay, manchmal leer bei zu kleinem poll-delay)
** max (größter Wert innerhalb des poll-delay, manchmal leer bei zu kleinem poll-delay)
** average (Durchschnitt der Werte im poll-delay, manchmal leer bei zu kleinem poll-delay)
** consumption (Verbrauch innerhalb des poll-delays, manchmal leer bei zu kleinem poll-delay)
* <poll-delay>: Zeitraum, der ausgelesen werden soll in Sekunden

== Beispiele ==
Ein vollständiges Beispiel für die erforderlichen Definitionen und das daraus resultierende Ergebnis:

=== Momentanverbrauch ===
Kanal im Volkszaehler, der den Momentanverbrauch per I/R-Lesekopf ermittelt (alle 60 Sekunden, daraus der Mittelwert)

define Verbrauch_aktuell VOLKSZAEHLER 192.168.178.45 80 635481a0-6fcd-11e2-8587-eda25228f8bf average 60
attr Verbrauch_aktuell group Strom
attr Verbrauch_aktuell room Volkszaehler

=== Logdatei ===
Definition der Logdatei, aus der die Grafik erzeugt werden kann:

define FileLog_Verbrauch_aktuell FileLog ./log/Verbrauch_aktuell-%Y-%m.log Verbrauch_aktuell
attr FileLog_Verbrauch_aktuell group Volkszaehler
attr FileLog_Verbrauch_aktuell logtype text
attr FileLog_Verbrauch_aktuell room Z_Log

=== Der Graph dazu ===
define FilePlot_Verbrauch_aktuell weblink fileplot FileLog_Verbrauch_aktuell:Volkszaehler:CURRENT
attr FilePlot_Verbrauch_aktuell label "Stromverbrauch: $data{currval1}"
attr FilePlot_Verbrauch_aktuell room Volkszaehler

=== Zählerstand ===
Kanal im Volkszaehler, der den Zählerstand per I/R-Lesekopf ermittelt, jede Stunde davon der letzte Wert.

define Zaehlerstand VOLKSZAEHLER 192.168.178.45 80 ebb9c9b0-7058-11e2-b5ed-d12ec87a3a7f last 1800
attr Zaehlerstand group Strom
attr Zaehlerstand room Volkszaehler

=== Verbrauch ===
Kanal im Volkszaehler, der den Zählerstand per I/R-Lesekopf ermittelt, alle 24 Stunden davon der Verbrauch.

define Verbrauch_24h VOLKSZAEHLER 192.168.178.45 80 635481a0-6fcd-11e2-8587-eda25228f8bf consumption 86400
attr Verbrauch_24h group Strom
attr Verbrauch_24h room Volkszaehler

=== Ergebnis ===
[[Datei:23_volkszaehler.JPG|mini|zentriert|hochkant=3.0|Strom- und Gasverbrauch aus Volkszählerdaten generiert - Beispieldarstellung]]

== Daten mit Volkszaehler loggen ==
Hier eine Möglichkeit mit einem notify Temperaturen (oder andere Messwerte) an die Middelware vom Volkszaehler zu schicken um die Daten über ein Volkszaehler Frontend auswerten zu können:
.*:temperature.* {
# return "Heizung $NAME" if $NAME =~ /\A.{3}Heizung/; # [[MAX]] Geräte ausschließen. Wordaround für aufgebrauchte credits.
my $base_url = AttrVal('vz', 'vz_URL', undef);
my $temp = ReadingsVal($NAME, 'temperature', undef);
my $uuid = AttrVal($NAME, 'vz_UUID', undef);
unless (defined($uuid)) {
my $create_url = $base_url . '/channel.json?type=temperature&title=' . $NAME . '&public=on&style=lines&operation=add';
Log 5, $create_url;
my $response = decode_json(get($create_url));
$uuid = $response->{entity}->{uuid};
$attr{$NAME}{'vz_UUID'} = $uuid;
Log 4, "created $uuid for $NAME";
}
my $update_url = $base_url . '/data/' . $uuid . '.json?operation=add&value=' . $temp;
Log 5, $update_url;
Log 4, get($update_url);
}

Die Volkszaehler URL wird in einem Attribut (vz_URL) eines dummies gespeichert, welches vorher angelegt werden muss.

define vz dummy
attr vz vz_URL http://localhost/volkszaehler.org/htdocs/middleware.php

Jedes Termometer, dass auch im Volkszaehler erscheinen soll, muss nun nur noch im Volkszaehler angelegt werden und die UUID als Attribut (vz_UUID) des Termometers gespeichert werden. Dieser Schritt kann auch ausgelassen werden. In diesem Fall wird ein neues Termometer automatisch angelegt.

== Links ==
* Volkszähler [http://www.volkszaehler.org Homepage]
* [https://github.com/bgewehr/fhem FHEM Module] für Volkszähler von "bgewehr"
* Quellen von JSON für Perl: [http://cpansearch.perl.org/src/MAKAMAKA/JSON-1.15/lib/JSON/ CPAN] / [https://github.com/makamaka/JSON/tree/master/lib github]

[[Kategorie:Other Components]]
[[Kategorie:HOWTOS]]

Volkszaehler

2014-01-05T17:14:43Z

Yfhem: Daten mit Volkszaehler loggen

[[Datei:volkszaehler.png|right]]

Volkszaehler.org ist ein freies SmartMeter Projekt für den Selbstbau ([http://www.volkszaehler.org siehe volkszaehler.org]) Der Nutzer behält dabei die vollständige Kontrolle über die anfallenden Daten seiner Strom-, Wasser- und Gaszähler.

==Features==
* 100% Open-Source
* kostenlos
* offene Protokolle
* erweiterbar
* minmale Anforderungen (LAMP-Stack)
* flexibele Verwaltungsmöglichkeiten
* Verbrauchs & Kostenprognose
* verschiedenste Messgrößen
** Strom
** Wasser
** Gas
** Betriebsstunden
** Temperatur
* Läuft u. a. auf Raspberry Pi ([http://wiki.volkszaehler.org/howto/raspberry_pi_image Installationsbeschreibung)]

== Volkszaehler in fhem einbinden ==

Das fhem-Modul für Volkszaehler.org bindet diese Daten in fhem ein. Das Modul 23_volkszaehler.pm greift per http auf den Volkszaehler zu und interpretiert die JSON-Antwort in fhem-device-Readings. Daraus können Logs und Plots gebildet werden oder devices mit Kennzahlen aus den Volkszaehler-Daten.

Es ist z. B. für Solarstrom-Anlagenbesitzer denkbar, bei hoher verfügbarer Sonnenenergie mit fhem Verbraucher einzuschalten, um die Eigenverbrauchsrate zu erhöhen, was die Energiekosten reduziert.

== Installation ==
Für die Installation müssen einige Files heruntergeladen und in die richtigen Verzeichnisse kopiert werden.

=== fhem-Modul ===
Die folgende Beschreibung geht von der Installation auf einer [[FritzBox]] aus.

Meine aktuellen Versionen liegen hier: <code>https://github.com/bgewehr/fhem</code>

Die Datei <code>23_VOLKSZAEHLER.pm</code> kommt ins Verzeichnis <code>\\fritz.box\FRITZ.NAS\fhem\fhem\</code>

Die Datei <code>volkszaehler.gplot</code> kommt ins Verzeichnis <code>\\fritz.box\FRITZ.NAS\fhem\fhem\www\gplot</code>

Nur zur Sicherheit: Um die Dateien auf einem Windows-Rechner lokal zu erstellen, bitte den Text aus der "raw" Ansicht aus Github kopieren und bitte nicht in Notepad, sondern in z. B. [http://www.heise.de/download/notepad.html Notepad++] einfügen und dann unter dem richtigen Dateinamen speichern. Mit Notepad von Microsoft werden falsche Zeilenenden erzeugt, die dann unter Linux nicht funktionieren.

=== JSON für Perl ===
Das Modul nutzt einen JSON-Interpreter, um die Antwort vom Volkszaehler in eine PERL-Variable zu wandeln. Dazu sind einige zusätzliche PERL Module notwendig.

JSON für PERL kann von hier geladen werden:

http://cpansearch.perl.org/src/MAKAMAKA/JSON-1.15/lib/JSON/
oder
https://github.com/makamaka/JSON/tree/master/lib

Das File JSON.pm muss auf einer Fritzbox 7390 mit fhem im internen Speicher in das Verzeichnis

\\fritz.box\FRITZ.NAS\fhem\lib\perl5\site_perl\5.12.2\mips-linux\

Für die Files Converter.pm und Parser.pm wird ein neues Verzeichnis angelegt:

\\fritz.box\FRITZ.NAS\fhem\lib\perl5\site_perl\5.12.2\mips-linux\JSON\

und die files dann dort abgelegt.

Auf anderen Plattformen müssen die Pfade ggf. entsprechend angepasst werden. Im Script startfhem werden die lib-Pfade mit

export xyz=pfad:pfad

angegeben, in die man die files ablegen kann, damit sie beim Aufruf gefunden werden.

== Definition der devices ==
Die Device Definitionen werden in einer Konfigurationsdatei (üblicherweise fhem.cfg) angelegt

define <name> VOLKSZAEHLER <ip-address> <port-nr> <channel> <state:last/min/max/average/consumption> <poll-delay>

* <name>: Name des neuen fhem-devices
* <ip-address>: IP des Volkszaehlers
* <port-Nr>: Port, auf dem der Volkszaehler-http-Server erreichtbar ist
* <channel>: UUID des Volkszaehler-Frontend-Channels, der gelesen werden soll
* <state>: Das Reading, welches als state genommen werden soll, kann im define gewählt werden. Dabei besteht die Auswahl aus
** last (letzter geladener Wert, manchmal leer bei zu kleinem poll-delay)
** min (kleinster Wert innerhalb des poll-delay, manchmal leer bei zu kleinem poll-delay)
** max (größter Wert innerhalb des poll-delay, manchmal leer bei zu kleinem poll-delay)
** average (Durchschnitt der Werte im poll-delay, manchmal leer bei zu kleinem poll-delay)
** consumption (Verbrauch innerhalb des poll-delays, manchmal leer bei zu kleinem poll-delay)
* <poll-delay>: Zeitraum, der ausgelesen werden soll in Sekunden

== Beispiele ==
Ein vollständiges Beispiel für die erforderlichen Definitionen und das daraus resultierende Ergebnis:

=== Momentanverbrauch ===
Kanal im Volkszaehler, der den Momentanverbrauch per I/R-Lesekopf ermittelt (alle 60 Sekunden, daraus der Mittelwert)

define Verbrauch_aktuell VOLKSZAEHLER 192.168.178.45 80 635481a0-6fcd-11e2-8587-eda25228f8bf average 60
attr Verbrauch_aktuell group Strom
attr Verbrauch_aktuell room Volkszaehler

=== Logdatei ===
Definition der Logdatei, aus der die Grafik erzeugt werden kann:

define FileLog_Verbrauch_aktuell FileLog ./log/Verbrauch_aktuell-%Y-%m.log Verbrauch_aktuell
attr FileLog_Verbrauch_aktuell group Volkszaehler
attr FileLog_Verbrauch_aktuell logtype text
attr FileLog_Verbrauch_aktuell room Z_Log

=== Der Graph dazu ===
define FilePlot_Verbrauch_aktuell weblink fileplot FileLog_Verbrauch_aktuell:Volkszaehler:CURRENT
attr FilePlot_Verbrauch_aktuell label "Stromverbrauch: $data{currval1}"
attr FilePlot_Verbrauch_aktuell room Volkszaehler

=== Zählerstand ===
Kanal im Volkszaehler, der den Zählerstand per I/R-Lesekopf ermittelt, jede Stunde davon der letzte Wert.

define Zaehlerstand VOLKSZAEHLER 192.168.178.45 80 ebb9c9b0-7058-11e2-b5ed-d12ec87a3a7f last 1800
attr Zaehlerstand group Strom
attr Zaehlerstand room Volkszaehler

=== Verbrauch ===
Kanal im Volkszaehler, der den Zählerstand per I/R-Lesekopf ermittelt, alle 24 Stunden davon der Verbrauch.

define Verbrauch_24h VOLKSZAEHLER 192.168.178.45 80 635481a0-6fcd-11e2-8587-eda25228f8bf consumption 86400
attr Verbrauch_24h group Strom
attr Verbrauch_24h room Volkszaehler

=== Ergebnis ===
[[Datei:23_volkszaehler.JPG|mini|zentriert|hochkant=3.0|Strom- und Gasverbrauch aus Volkszählerdaten generiert - Beispieldarstellung]]

== Daten mit Volkszaehler loggen ==
Hier eine Möglichkeit mit einem notify Temperaturen (oder andere Messwerte) an die Middelware vom Volkszaehler zu schicken um die Daten über ein Volkszaehler Frontend auswerten zu können:
.*:temperature.* {
# return "Heizung $NAME" if $NAME =~ /\A.{3}Heizung/; # [[MAX]] Geräte ausschließen. Wordaround für aufgebrauchte credits.
my $base_url = AttrVal('vz', 'vz_URL', undef);
my $temp = ReadingsVal($NAME, 'temperature', undef);
my $uuid = AttrVal($NAME, 'vz_UUID', undef);
unless (defined($uuid)) {
my $create_url = $base_url . '/channel.json?type=temperature&title=' . $NAME . '&public=on&style=lines&operation=add';
Log 5, $create_url;
my $response = decode_json(get($create_url));
$uuid = $response->{entity}->{uuid};
$attr{$NAME}{'vz_UUID'} = $uuid;
Log 4, "created $uuid for $NAME";
}
my $update_url = $base_url . '/data/' . $uuid . '.json?operation=add&value=' . $temp;
Log 5, $update_url;
Log 4, get($update_url);
}

Die Volkszaehler URL wird in einem Attribut (vz_URL) eines dummies gespeichert, welches vorher angelegt werden muss.

define vz dummy
attr vz vz_URL http://localhost/volkszaehler.org/htdocs/middleware.php

Jedes Termometer, dass auch im Volkszaehler erscheinen soll, muss nun nur noch im Volkszaehler angelegt werden und die UUID als Attribut (vz_UUID) des Termometers gespeichert werden.

== Links ==
* Volkszähler [http://www.volkszaehler.org Homepage]
* [https://github.com/bgewehr/fhem FHEM Module] für Volkszähler von "bgewehr"
* Quellen von JSON für Perl: [http://cpansearch.perl.org/src/MAKAMAKA/JSON-1.15/lib/JSON/ CPAN] / [https://github.com/makamaka/JSON/tree/master/lib github]

[[Kategorie:Other Components]]
[[Kategorie:HOWTOS]]

Jalousie und Beleuchtung in mehreren Räumen

2013-11-12T19:46:37Z

Yfhem: /* /etc/fhem/Schlafzimmer.cfg */ isn't numeric in numeric eq (==).

Dies ist die Beschreibung einer Fhem-Konfiguration, die zur Steuerung einer Hausautomation auf Basis von [[HomeMatic]] dient. Gesteuert werden in verschiedenen Räumen das '''Licht und die Jalousien'''. Die Länge dieser Beschreibung soll nicht abschreckend wirken, viele Zeilen sind Kommentare oder durch den ''autocreate'' Prozeß erzeugte Zeilen!

== Verwendete Hard- und Software ==
Als [[:Kategorie:Server Hardware|Server]] dient ein PC mit einem Athlon 64 X2 Dual Core Prozessor 6000+, 4 GB Hauptspeicher, 2 TB gespiegeltem Diskspeicher und Gigabit Ethernet. Auf dem Server ist ein Ubuntu 11.04 Serveredition installiert, die automatisch auf dem neuesten Stand gehalten wird. Perl ist in der Version 5.10.1 vorhanden. Fhem ist dabei nur eine von vielen Applikationen, die auf dem Server laufen.

Der Server kann über das Ethernet im Hausnetz auf eine [[AVM Fritz!Box|Fritzbox 7170]] zugreifen, die wiederum mittels WLAN mit einer Fritzbox 3170 verbunden ist, die als WLAN-Repeater dient. An die 3170 ist als Hauszentrale ein HomeMatic Lan [[Interface]] ([[HMLAN Konfigurator]]) angeschlossen.

Der CPU-Verbrauch hält sich sehr in Grenzen, bei einer stichprobenartigen Überwachung hat Fhem etwa 5-6 CPU Sekunden verbraucht in 24 Stunden.

[[File:Konfiguration-Ethernet.jpg|628px]]

Folgende HomeMatic Komponenten kommen zum Einsatz:

<table border="1">
<tr>
<th> Produktcode </th>
<th> Funktion </th>
<th> Anzahl
</th></tr>
<tr>
<td> HM-CFG-LAN </td>
<td> LanInterface </td>
<td> 1
</td></tr>
<tr>
<td> HM-RC-12-W </td>
<td> Funkfernbedienung 12-Tasten </td>
<td> 1
</td></tr>
<tr>
<td> HM-RC-4-B </td>
<td> Funkfernbedienung 4-Tasten </td>
<td> 1
</td></tr>
<tr>
<td> HM-PB-2-WM </td>
<td> Funk-Wandtaster 2fach </td>
<td> 3
</td></tr>
<tr>
<td> HM-PB-4-WM </td>
<td> Funk-Wandtaster 4fach </td>
<td> 2
</td></tr>
<tr>
<td> HM-LC-Sw1-FM </td>
<td> Funk-Schaltaktor 1-fach, Unterputzmontage </td>
<td> 2
</td></tr>
<tr>
<td> HM-LC-Sw2-FM </td>
<td> Funk-Schaltaktor 2-fach, Unterputzmontage </td>
<td> 3
</td></tr>
<tr>
<td> HM-LC-Bl1-FM </td>
<td> Funk-Jalousieaktor 1-fach, Unterputzmontage </td>
<td> 2
</td></tr>
<tr>
<td> HM-LC-Sw1PB-FM </td>
<td> Funk-Schaltaktor 1-fach, Unterputzmontage mit Tasteraufsatz </td>
<td> 1
</td></tr></table>

'''Namensregeln''': Alle Definitionen, die NICHT eindeutig einem Raum zuzuordnen sind, erhalten ein XX_ an den Anfang, alle anderen Definitionen erhalten eine der folgenden Kennungen:

<table border="1">
<tr>
<th> Kennung </th>
<th> Raum
</th></tr>
<tr>
<td> AK_ </td>
<td> Arbeitskeller
</td></tr>
<tr>
<td> BA_ </td>
<td> Bad
</td></tr>
<tr>
<td> BU_ </td>
<td> Büro
</td></tr>
<tr>
<td> DB </td>
<td> Dachboden
</td></tr>
<tr>
<td> FL_ </td>
<td> Flur
</td></tr>
<tr>
<td> GA_ </td>
<td> Garage
</td></tr>
<tr>
<td> KU_ </td>
<td> Küche
</td></tr>
<tr>
<td> SK_ </td>
<td> Saunakeller
</td></tr>
<tr>
<td> SZ_ </td>
<td> Schlafzimmer
</td></tr>
<tr>
<td> TG_ </td>
<td> Terasse/Garten
</td></tr>
<tr>
<td> TH_ </td>
<td> Treppenhaus
</td></tr>
<tr>
<td> VK_ </td>
<td> Vorratskeller
</td></tr>
<tr>
<td> WK_ </td>
<td> Waschkeller
</td></tr>
<tr>
<td> WZ_ </td>
<td> Wohnzimmer
</td></tr></table>

== Konfigurationsdateien ==
Alle Dateien, bis auf fhem.cfg, befinden sich in /etc/fhem. Alle Komponenten, die nicht physikalisch einem Raum zuzuordnen sind (Logs, Globales, etc.) wurden dem virtuellen Raum ''Server'' zugeordnet.

=== /etc/fhem.cfg ===
Die Datei /etc/fhem.cfg ist der Haupteinstiegspunkt für die Konfiguration. Aus Gründen der besseren Wartbarkeit beinhaltet die Datei nur include Anweisungen, mit der andere Dateien aus dieser Datei heraus aufgerufen werden. Das hat den Vorteil, dass Kommentare in den include Dateien erhalten bleiben. Dies ist (bzw. war seinerzeit) nicht der Fall für fhem.cfg, wenn man die Funktion autocreate verwendet. Attribute für die Definition ''global'' dürfen nicht aus der fhem.cfg ausgelagert werden, sie müssen Bestandteil der fhem.cfg bleiben.

<nowiki>attr global autoload_undefined_devices 1
attr global logfile /var/log/fhem/fhem-%Y-%m.log
attr global modpath /usr/share/fhem
attr global port 7072
attr global room Server
attr global statefile /var/log/fhem/fhem.save
include /etc/fhem/Web.cfg
include /etc/fhem/Autocreate.cfg
include /etc/fhem/LanInterface.cfg
include /etc/fhem/Fernbedienung.cfg
include /etc/fhem/Schlafzimmer.cfg
include /etc/fhem/Gaestezimmer.cfg
include /etc/fhem/Wohnzimmer.cfg
# include /etc/fhem/Buero.cfg
include /etc/fhem/Flur.cfg</nowiki>

=== /etc/fhem/Web.cfg ===
Alle relevanten Konfigurationsparameter für den Webzugriff sind in dieser Datei zu finden. Es sind die aus der Installation bekannten Standardwerte übernommen worden.

<nowiki>#########################################################################
## Webdefinitionen
## Zweck.........: Definitionen für den Zugriff auf den Webserver
## Standort......: Server
## Typ...........:
## Installation..: 15.09.2011
## Besonderheiten:
##
#########################################################################
define XX_WEB FHEMWEB 8083 global
attr XX_WEB fwcompress 0
attr XX_WEB room Server
define XX_WEBphone FHEMWEB 8084
attr XX_WEBphone room Server
attr XX_WEBphone smallscreen 1
define XX_WEBtablet FHEMWEB 8085
attr XX_WEBtablet room Server
attr XX_WEBtablet touchpad 1</nowiki>

=== /etc/fhem/Autocreate.cfg ===
Diese Datei enthält alle wichtigen Information zu dem Autocreate Prozess. Keine Änderung gegenüber den Standardwerten.

<nowiki>#########################################################################
## Autocreate Definitionen
## Zweck.........: Autocreate aktivieren
## Standort......: Server
## Typ...........:
## Installation..: 15.09.2011
## Besonderheiten:
##
#########################################################################
define XX_Autocreate autocreate
attr XX_Autocreate autosave 1
attr XX_Autocreate device_room %TYPE
attr XX_Autocreate filelog /var/log/fhem/%NAME-%Y.log
attr XX_Autocreate room Server
attr XX_Autocreate weblink 1
attr XX_Autocreate weblink_room Plots</nowiki>

=== /etc/fhem/LanInterface.cfg ===
Das Lan-Interface stellt das Bindeglied zwischen dem Server und den einzelnen Homematic-Komponenten dar. Es ist mit einem Ethernetnetzwerkkabel an das Netzwerk angeschlossen. Dem Lan-Interface wurde eine feste IP-Adresse vergeben, um immer auf der gleichen Adresse ansprechbar zu sein. Der Zugriff auf das Interface geschieht über Port 1000.

<nowiki>#########################################################################
## Lan Adapter
## Zweck.........: Bindeglied zwischen Server/fhem und Homematic Aktoren und Sender
## Standort......: Gästezimmer
## Typ...........:
## Installation..: 15.09.2011
## Besonderheiten: feste IP-Adresse 192.168.0.6 Port 1000
## wird an 3170 WLAN-Repeater betrieben wegen besserer Abdeckung
#########################################################################
define XX_LANInterface HMLAN 192.168.0.6:1000
attr XX_LANInterface hmId xxxxxx
attr XX_LANInterface room Gästezimmer</nowiki>

=== /etc/fhem/Fernbedienung.cfg ===
Fernbedienungen sind nicht an einen Standort gebunden und können bewegt werden, daher eine eigene Konfiguration, wenn die Fernbedienung nicht einem Zimmer ausschließlich zugeordnet ist.

<nowiki>#########################################################################
## Fernbedienungen
## Zweck.........: alle verfügbaren Sender, wenn sie nicht einem Raum
## unmittelbar zugeordnet sind
## Standort......: verschiedene
## Typ...........: verschiedene
## Installation..: 15.09.2011 12-Tasten-Fernbedienung
## Besonderheiten:
#########################################################################
#########################################################################
## 12-Tasten Fernbedienung
## Zweck.........: Rollladensteuerung, Licht im Wohnzimmer und Flur
## Scheinwerfer im Garten
## Standort......: normalerweise Wohnzimmer
## Typ...........: HM-RC-12
## Installation..: 15.09.2011 12-Tasten-Fernbedienung
## Besonderheiten: es wird nicht zwischen langem und kurzem Tasten-
## druck unterschieden
#########################################################################
define XX_FB_12_1 CUL_HM xxxxxx
attr XX_FB_12_1 devInfo 0C0000
attr XX_FB_12_1 firmware 1.1
attr XX_FB_12_1 hmClass sender
attr XX_FB_12_1 model HM-RC-12
attr XX_FB_12_1 room Wohnzimmer
attr XX_FB_12_1 serialNr xxxxxxxxxx
attr XX_FB_12_1 subType remote

#########################################################################
## linker Button Reihe 1
## Funktion......: Rollladen runter im Wohnzimmer
## Besonderheiten: ACHTUNG, on und off sind im Wohnzimmer vertauscht
## wegen der Tasten auf dem Taster an dem Aktuator
#########################################################################
define XX_FB_12_1_1_Off notify XX_FB_12_1:Btn1.off.* set WZ_Rollladen off
attr XX_FB_12_1_1_Off room Wohnzimmer
#########################################################################
## rechter Button Reihe 1
## Funktion......: Rollladen hoch im Wohnzimmer
## Besonderheiten: ACHTUNG, on und off sind im Wohnzimmer vertauscht
## wegen der Tasten auf dem Taster an dem Aktuator
#########################################################################
define XX_FB_12_1_1_On notify XX_FB_12_1:Btn1.on.* set WZ_Rollladen on
attr XX_FB_12_1_1_On room Wohnzimmer
#########################################################################
## linker Button Reihe 2
## Funktion......: Rollladen runter im Gästezimmer
## Besonderheiten: on=runter off=hoch
#########################################################################
define XX_FB_12_1_2_Off notify XX_FB_12_1:Btn2.off.* set GZ_Rollladen on
attr XX_FB_12_1_2_Off room Wohnzimmer
#########################################################################
## rechter Button Reihe 2
## Funktion......: Rollladen hoch im Gästezimmer
## Besonderheiten: on=runter off=hoch
#########################################################################
define XX_FB_12_1_2_On notify XX_FB_12_1:Btn2.on.* set GZ_Rollladen off
attr XX_FB_12_1_2_On room Wohnzimmer
#########################################################################
## linker Button Reihe 3
## Funktion......: Rollladen runter im Flur
## Besonderheiten: on=runter off=hoch
#########################################################################
define XX_FB_12_1_3_Off notify XX_FB_12_1:Btn3.off.* set FL_Rollladen on
attr XX_FB_12_1_3_Off room Wohnzimmer
#########################################################################
## rechter Button Reihe 3
## Funktion......: Rollladen hoch im Flur
## Besonderheiten: on=runter off=hoch
#########################################################################
define XX_FB_12_1_3_On notify XX_FB_12_1:Btn3.on.* set FL_Rollladen off
attr XX_FB_12_1_3_On room Wohnzimmer
#########################################################################
## linker Button Reihe 4
## Funktion......:
## Besonderheiten: derzeit nicht belegt
#########################################################################
#########################################################################
## rechter Button Reihe 4
## Funktion......:
## Besonderheiten: derzeit nicht belegt
#########################################################################
#########################################################################
## linker Button Reihe 5
## Funktion......:
## Besonderheiten: derzeit nicht belegt
#########################################################################
#########################################################################
## rechter Button Reihe 5
## Funktion......:
## Besonderheiten: derzeit nicht belegt
#########################################################################
#########################################################################
## oberer Button rechts an der Fernbedienung
## Funktion......:
## Besonderheiten: derzeit nicht belegt
#########################################################################
#########################################################################
## unterer Button rechts an der Fernbedienung
## Funktion......:
## Besonderheiten: derzeit nicht belegt
#########################################################################</nowiki>

Um eine Kommando mit einer Taste zu verknüpfen, wird die jeweilige Taste mittels notify abgefragt. Die Identifikation um welche Fernbedienung und welche Taste es sich handelt wird durch die Kennung „Name der Fernbedienung“ : und Rückgabestring“ abgehandelt.
Fhem gibt immer einen String mit den Information zurück. Dieser String enthält auch Leerzeichen. Diese Leerzeichen müssen in der Definition durch jeweils einen Punkt ersetzt werden, da Fhem sonst die ganze Befehlskette nicht richtig identifiziert. Der Stern am Ende deklariert den Rest des Rückgabestrings als nicht relevant.

Die 12-Tasten-Fernbedienung steuert derzeit die Jalousien für Gäste-, Wohnzimmer und Flur und die Tastenbelegung ist so gestaltet, dass die jeweils linke Taste in einer Reihe die Jalousie herunter fährt und die rechte Taste diese Jalousie wieder hoch fährt. Diese Fernbedienung wird global dem Raum Wohnzimmer zugeordnet, weil das der bevorzugte Platz für diese Fernbedienung sein soll.

=== /etc/fhem/Schlafzimmer.cfg ===
Im Schlafzimmer kommen hauptsächlich Schaltaktoren für Licht zur Anwendung. Eine Fernbedienung ermöglicht die Schaltungen vom Bett aus. Das Deckenlicht wird von einem Taster an der Tür oder von einer Fernbedienung geschaltet. Im Schlafzimmer sind 2 Unterputzaktoren 1fach, 1 Unterputzaktor 2fach, 1 Taster 2fach und eine 4-Tasten-Fernbedienung installiert.

<nowiki>#########################################################################
## Schlafzimmer
## Zweck.........: Alle Homematic Komponenten im Schlafzimmer
## Standort......: Schlafzimmer
## Typ...........: verschiedene
## Installation..: 15.09.2011
## Besonderheiten:
##
#########################################################################
#########################################################################
## Aktor für die senkrechten Deckenstrahler
#########################################################################
define SZ_Lampe_Decke CUL_HM xxxxxx
attr SZ_Lampe_Decke devInfo 010100
attr SZ_Lampe_Decke firmware 1.9
attr SZ_Lampe_Decke hmClass receiver
attr SZ_Lampe_Decke model HM-LC-SW1-FM
attr SZ_Lampe_Decke room Schlafzimmer
attr SZ_Lampe_Decke serialNr xxxxxxxxxx
attr SZ_Lampe_Decke subType switch
#########################################################################
## Aktor für die Strahler an den Bettseiten
## und für die Deckenlampen in der Schräge
#########################################################################
define SZ_Lampen_Seite CUL_HM xxxxxx
attr SZ_Lampen_Seite devInfo 010100
attr SZ_Lampen_Seite firmware 1.9
attr SZ_Lampen_Seite hmClass receiver
attr SZ_Lampen_Seite model HM-LC-SW1-FM
attr SZ_Lampen_Seite room Schlafzimmer
attr SZ_Lampen_Seite serialNr xxxxxxxxxx
attr SZ_Lampen_Seite subType switch

#########################################################################
## Aktor für die Strahler über dem Bett links
## Besonderheit: Dies ist ein 2-Fach Schaltaktor
## anderer Port wird für Bett rechts benutzt
#########################################################################
define SZ_Lampe_Bett_links CUL_HM xxxxxx
attr SZ_Lampe_Bett_links devInfo 020100
attr SZ_Lampe_Bett_links firmware 1.9
attr SZ_Lampe_Bett_links hmClass receiver
attr SZ_Lampe_Bett_links model HM-LC-SW2-FM
attr SZ_Lampe_Bett_links room Schlafzimmer
attr SZ_Lampe_Bett_links serialNr xxxxxxxxxx
attr SZ_Lampe_Bett_links subType switch
#########################################################################
## Aktor für die Strahler über dem Bett rechts
## Besonderheit: Dies ist ein 2-Fach Schaltaktor
## anderer Port wird für Bett links benutzt
#########################################################################
define SZ_Lampe_Bett_rechts CUL_HM xxxxxx
attr SZ_Lampe_Bett_rechts devInfo 020100
attr SZ_Lampe_Bett_rechts firmware 1.9
attr SZ_Lampe_Bett_rechts hmClass receiver
attr SZ_Lampe_Bett_rechts model HM-LC-SW2-FM
attr SZ_Lampe_Bett_rechts room Schlafzimmer
attr SZ_Lampe_Bett_rechts serialNr xxxxxxxxxx
attr SZ_Lampe_Bett_rechts subType switch
#########################################################################
## Sender an der Tür
## schaltet Decken- und Seitenlampen ein oder aus
## bei einem langen Tastendruck (onLong) werden alle Deckenlampen und
## die Lampen an der Seite eingeschaltet, bei einem kurzen Tastendruck
## werden nur die Hälfte der Lampen an der Decke angeschaltet
#########################################################################
define SZ_Taster_Tuer CUL_HM xxxxxx
attr SZ_Taster_Tuer devInfo 020000
attr SZ_Taster_Tuer firmware 1.2
attr SZ_Taster_Tuer hmClass sender
attr SZ_Taster_Tuer model HM-PB-2-WM
attr SZ_Taster_Tuer room Schlafzimmer
attr SZ_Taster_Tuer serialNr xxxxxxxxxx
attr SZ_Taster_Tuer subType remote
define SZ_Taster_Tuer_On_Alles notify SZ_Taster_Tuer:Btn1.onLong.* set SZ_Lampe_Decke,SZ_Lampen_Seite on
attr SZ_Taster_Tuer_On_Alles room Schlafzimmer
define SZ_Taster_Tuer_On_Decke notify SZ_Taster_Tuer:Btn1.on.* set SZ_Lampe_Decke on
attr SZ_Taster_Tuer_On_Decke room Schlafzimmer
define SZ_Taster_Tuer_Off notify SZ_Taster_Tuer:Btn1.off.* set SZ_Lampe_Decke,SZ_Lampen_Seite off
attr SZ_Taster_Tuer_Off room Schlafzimmer
#########################################################################
## 4-Tastenfernbedienung
## Zweck.........: Lichtschaltungen im Schlafzimmer vom Bett aus
## Standort......: Schlafzimmer
## Typ...........: HM-RC-4
## Installation..: 23.09.2011
## Besonderheiten: arbeitet mit toggle
#########################################################################
define SZ_Fernbedienung_4_1 CUL_HM xxxxxx
attr SZ_Fernbedienung_4_1 devInfo 040000
attr SZ_Fernbedienung_4_1 firmware 1.3
attr SZ_Fernbedienung_4_1 hmClass sender
attr SZ_Fernbedienung_4_1 model HM-RC-4-B
attr SZ_Fernbedienung_4_1 room Schlafzimmer
attr SZ_Fernbedienung_4_1 serialNr xxxxxxxxxx
attr SZ_Fernbedienung_4_1 subType remote
#########################################################################
## linker Button Reihe 1
## Funktion......: Licht links am Bett ein-/ausschalten
## Besonderheiten:
#########################################################################
define SZ_FB_Btn1_off notify SZ_Fernbedienung_4_1:Btn1.off.* set SZ_Lampe_Bett_links toggle
attr SZ_FB_Btn1_off room Schlafzimmer

#########################################################################
## rechter Button Reihe 1
## Funktion......: Licht rechts am Bett ein-/ausschalten
## Besonderheiten:
#########################################################################
define SZ_FB_Btn1_on notify SZ_Fernbedienung_4_1:Btn1.on.* set SZ_Lampe_Bett_rechts toggle
attr SZ_FB_Btn1_on room Schlafzimmer
#########################################################################
## linker Button Reihe 2
## Funktion......: Deckenlampen schalten
## Besonderheiten:
#########################################################################
define SZ_FB_Btn2_off notify SZ_Fernbedienung_4_1:Btn2.off.* set SZ_Lampe_Decke toggle
attr SZ_FB_Btn2_off room Schlafzimmer
#########################################################################
## rechter Button Reihe 2
## Funktion......: Seitenlampen schalten
## Besonderheiten:
#########################################################################
define SZ_FB_Btn2_on notify SZ_Fernbedienung_4_1:Btn2.on.* set SZ_Lampen_Seite toggle
attr SZ_FB_Btn2_on room Schlafzimmer
#########################################################################
## Alternative! Um SZ_Lampe_Decke und SZ_Lampen_Seite mit einem
## Tastendruck zu schalten
## Durch dieses Notify wird zuerst SZ_Lampe_Decke eingeschaltet, dann
## beim nächsten Tastendruck wird SZ_Lampen_Seite dazugeschaltet und
## dann beim dritten Tastendruck werden beide wieder ausgeschaltet
## Bei Aktivierung vorher SZ_FB_Btnx.on/off deaktivieren!!!
#########################################################################
#define MyNotify notify Fernbedienung:Btn2.on.* {if(Value("SZ_Lampe_Decke") eq "on" && Value("SZ_Lampen_Seite") eq "on") {fhem "set SZ_Lampe_Decke,SZ_Lampen_Seite off"} elsif(Value("SZ_Lampe_Decke") eq "on" && Value("SZ_Lampen_Seite") eq "off") {fhem "set SZ_Lampen_Seite on"} else{fhem "set SZ_Lampe_Decke on"}}</nowiki>
Der Taster an der Tür soll nur Licht ein- und ausschalten, daher wurde auf eine Unterscheidung zwischen einem langen und einem kurzen Tastendruck verzichtet. Da zwei verschiedene Lichtquellen zu schalten sind, müssen bei dem set Kommando beide Quellen jeweils angegeben werden. Es dürfen keine Leerzeichen in der Liste der Aktoren sein und die Aktoren müssen per Komma getrennt werden. (Achtung: "else if" muss in Perl als "elsif" geschrieben werden.)

=== /etc/fhem/Gaestezimmer.cfg ===
Im Gästezimmer wird derzeit nur die Jalousie gesteuert. Hier ist nur ein Unterputzjalousieaktor installiert.

<nowiki>#########################################################################
## Gästezimmer
## Zweck.........: Alle Homematic Komponenten im Gästezimmer
## Standort......: Gästezimmer
## Typ...........: verschiedene
## Installation..: 15.09.2011
## Besonderheiten:
##
#########################################################################
#########################################################################
## Aktor für die Rollladen
#########################################################################
define GZ_Rollladen CUL_HM xxxxx
attr GZ_Rollladen devInfo 010100
attr GZ_Rollladen firmware 1.5
attr GZ_Rollladen hmClass receiver
attr GZ_Rollladen model HM-LC-BL1-FM
attr GZ_Rollladen room Gästezimmer
attr GZ_Rollladen serialNr xxxxxxxxxx
attr GZ_Rollladen subType blindActuator
attr GZ_Rollladen eventMap on:zu off:offen
#########################################################################
## eigenes Log
#########################################################################
define GZ_Rollladen_FileLog FileLog /var/log/fhem/GZ_Rollladen-%Y.log GZ_Rollladen
attr GZ_Rollladen_FileLog logtype text
attr GZ_Rollladen_FileLog room Server
#########################################################################
## Rollladen soll fix um 08:00h jeden Tag hochfahren
#########################################################################
define GZ_Rollladen_hoch at *08:00 set GZ_Rollladen offen
attr GZ_Rollladen_hoch room Gästezimmer
#########################################################################
## Rollladen soll variabel je nach Sonnenuntergang, aber
## nicht vor 17:00h und nicht nach 21:00h jeden Tag runterfahren
#########################################################################
define GZ_Rollladen_runter at *{sunset(0,"17:00","21:00")} set GZ_Rollladen zu
attr GZ_Rollladen_runter room Gästezimmer</nowiki>

Die Jalousie soll immer morgens um 8 Uhr hoch gefahren werden, wobei aufgrund der Verkabelung am Aktor Hochfahren mit dem Status off eingeleitet wird. Das Herunterfahren soll variabel aufgrund der Untergangszeit der Sonne geschehen. Siehe [[Sunset Sunrise]]. Die früheste Zeit zum Herunterfahren ist 17:00 Uhr und spätestens um 21:00 Uhr sollen die Jalousien auf jeden Fall heruntergefahren sein. Dies wird auf alle Jalousien angewendet. Zur besseren Lesbarkeit der Anzeige wurde der Status der Rollade durch Setzen des Attributes EventMap umbenannt. Wenn der Aktor den Status ''on'' meldet, dann wird ''zu'' angezeigt und alternativ bei ''off'' dann ''offen''.

=== /etc/fhem/Wohnzimmer.cfg ===
Im Wohnzimmer wird derzeit eine Jalousie und die Beleuchtung gesteuert. Installiert sind: ein Jalousieaktor mit Tasteraufsatz, zwei 4fach-Taster, ein Unterputzdoppelaktor.

<nowiki>#########################################################################
## Wohnzimmer
## Zweck.........: Alle Homematic Komponenten im Wohnzimmer
## Standort......: Wohnzimmer
## Typ...........: verschiedene
## Installation..: 15.09.2011
## Besonderheiten: ACHTUNG, on und off bei der Rollladensteuerung
## ist im Wohnzimmer vertauscht on=rauf off=runter
#########################################################################
#########################################################################
## Aktor für die Rollladen
#########################################################################
define WZ_Rollladen CUL_HM xxxxxx
attr WZ_Rollladen devInfo 010100
attr WZ_Rollladen firmware 1.6
attr WZ_Rollladen hmClass receiver
attr WZ_Rollladen model HM-LC-BL1-PB-FM
attr WZ_Rollladen room Wohnzimmer
attr WZ_Rollladen serialNr xxxxxxxxxx
attr WZ_Rollladen subType blindActuator
attr WZ_Rollladen eventMap on:offen off:zu
#########################################################################
## eigenes Log
#########################################################################
define WZ_Rollladen_FileLog FileLog /var/log/fhem/WZ_Rollladen-%Y.log WZ_Rollladen
attr WZ_Rollladen_FileLog logtype text
attr WZ_Rollladen_FileLog room Server
#########################################################################
## Rollladen soll fix um 08:00h jeden Tag hochfahren
#########################################################################
define WZ_Rollladen_hoch at *08:00 set WZ_Rollladen offen
attr WZ_Rollladen_hoch room Wohnzimmer
#########################################################################
## Rollladen soll variabel je nach Sonnenuntergang, aber
## nicht vor 17:00h und nicht nach 21:00h jeden Tag runterfahren
#########################################################################
define WZ_Rollladen_runter at *{sunset(0,"17:00","21:00")} set WZ_Rollladen zu
attr WZ_Rollladen_runter room Wohnzimmer
#########################################################################
## Aktor für die Lampen auf der Schrankseite des Wohnzimmers
## dies ist ein gemeinsamer Aktor mit WZ_Lampe_Couch
#########################################################################
define WZ_Lampe_Schrank CUL_HM xxxxxx
attr WZ_Lampe_Schrank devInfo 020100
attr WZ_Lampe_Schrank firmware 1.9
attr WZ_Lampe_Schrank hmClass receiver
attr WZ_Lampe_Schrank model HM-LC-SW2-FM
attr WZ_Lampe_Schrank room Wohnzimmer
attr WZ_Lampe_Schrank serialNr xxxxxxxxxx
attr WZ_Lampe_Schrank subType switch
define FileLog_WZ_Lampe_Schrank FileLog /var/log/fhem/WZ_Lampe_Schrank-%Y.log WZ_Lampe_Schrank
attr FileLog_WZ_Lampe_Schrank logtype text
attr FileLog_WZ_Lampe_Schrank room Server
#########################################################################
## Aktor für die Lampen auf der Couchseite des Wohnzimmers
## dies ist ein gemeinsamer Aktor mit WZ_Lampe_Schrank
#########################################################################
define WZ_Lampe_Couch CUL_HM xxxxxx
attr WZ_Lampe_Couch devInfo 020100
attr WZ_Lampe_Couch firmware 1.9
attr WZ_Lampe_Couch hmClass receiver
attr WZ_Lampe_Couch model HM-LC-SW2-FM
attr WZ_Lampe_Couch room Wohnzimmer
attr WZ_Lampe_Couch serialNr xxxxxxxxxxx
attr WZ_Lampe_Couch subType switch
define FileLog_WZ_Lampe_Couch FileLog /var/log/fhem/WZ_Lampe_Couch-%Y.log WZ_Lampe_Couch
attr FileLog_WZ_Lampe_Couch logtype text
attr FileLog_WZ_Lampe_Couch room Server
#########################################################################
## Doppeltaster im Wohnzimmer beim Flur
## Dieser Taster schaltet die Lampen im Wohnzimmer bei dem Schrank
## und bei der Couch
#########################################################################
define WZ_Taster CUL_HM xxxxxx
attr WZ_Taster devInfo 040000
attr WZ_Taster firmware 1.2
attr WZ_Taster hmClass sender
attr WZ_Taster model HM-PB-4-WM
attr WZ_Taster room Wohnzimmer
attr WZ_Taster serialNr xxxxxxxxxxx
attr WZ_Taster subType remote
define FileLog_WZ_Taster FileLog /var/log/fhem/WZ_Taster-%Y.log WZ_Taster
attr FileLog_WZ_Taster logtype text
attr FileLog_WZ_Taster room Server
define WZ_Taster_On_Links notify WZ_Taster:Btn1.on.* set WZ_Lampe_Schrank toggle
attr WZ_Taster_On_Links room Wohnzimmer
define WZ_Taster_Off_Links notify WZ_Taster:Btn1.off.* set WZ_Lampe_Schrank toggle
attr WZ_Taster_Off_Links room Wohnzimmer
define WZ_Taster_On_Rechts notify WZ_Taster:Btn2.on.* set WZ_Lampe_Couch toggle
attr WZ_Taster_On_Rechts room Wohnzimmer
define WZ_Taster_Off_Rechts notify WZ_Taster:Btn2.off.* set WZ_Lampe_Couch toggle
attr WZ_Taster_Off_Rechts room Wohnzimmer</nowiki>

Die Jalousie soll immer morgens um acht Uhr hochgefahren werden, wobei aufgrund der Verkabelung am Aktor Hochfahren mit dem Status on eingeleitet wird. Dies ist anders als im Gästezimmer oder Flur! Das Herunterfahren soll variabel aufgrund der Untergangszeit der Sonne geschehen. Siehe [[Sunset Sunrise]].

Die früheste Zeit zum Herunterfahren ist 17:00 Uhr und spätestens um 21:00 Uhr sollen die Jalousien auf jeden Fall heruntergefahren sein. Die Taster schalten egal bei welchem Tastendruck das Licht an oder aus.

=== /etc/fhem/Flur.cfg ===
Im Flur werden derzeit eine Jalousie und die Beleuchtung gesteuert. Installiert sind ein Unterputzjalousieaktor, ein 4fach Taster, zwei 2fach Taster, ein Unterputzdoppelaktor. Dadurch wurde eine Wechselschaltung simuliert.

<nowiki>#########################################################################
## Flur
## Zweck.........: Alle Homematic Komponenten im Flur
## Standort......: Flur
## Typ...........: verschiedene
## Installation..: 15.09.2011
## Besonderheiten:
##
#########################################################################
#########################################################################
## Aktor für die Rollladen
#########################################################################
define FL_Rollladen CUL_HM xxxxxx
attr FL_Rollladen devInfo 010100
attr FL_Rollladen firmware 1.5
attr FL_Rollladen hmClass receiver
attr FL_Rollladen model HM-LC-BL1-FM
attr FL_Rollladen room Flur
attr FL_Rollladen serialNr xxxxxxxxxx
attr FL_Rollladen subType blindActuator
attr FL_Rollladen eventMap on:zu off:offen
#########################################################################
## eigenes Log
#########################################################################
define FL_Rollladen_FileLog FileLog /var/log/fhem/FL_Rollladen-%Y.log FL_Rollladen
attr FL_Rollladen_FileLog logtype text
attr FL_Rollladen_FileLog room Server
#########################################################################
## Rollladen soll fix um 08:00h jeden Tag hochfahren
#########################################################################
define FL_Rollladen_hoch at *08:00 set FL_Rollladen offen
attr FL_Rollladen_hoch room Flur
#########################################################################
## Rollladen soll variabel je nach Sonnenuntergang, aber
## nicht vor 17:00h und nicht nach 21:00h jeden Tag runterfahren
#########################################################################
define FL_Rollladen_runter at *{sunset(0,"17:00","21:00")} set FL_Rollladen zu
attr FL_Rollladen_runter room Flur
#########################################################################
## Aktor für die Lampen im FLur bei der Garderobe
## Dies ist ein gemeinsamer Aktor mit FL_Lampe_Treppe
#########################################################################
define FL_Lampe_Garderobe CUL_HM xxxxxx
attr FL_Lampe_Garderobe devInfo 020100
attr FL_Lampe_Garderobe firmware 1.9
attr FL_Lampe_Garderobe hmClass receiver
attr FL_Lampe_Garderobe model HM-LC-SW2-FM
attr FL_Lampe_Garderobe room Flur
attr FL_Lampe_Garderobe serialNr xxxxxxxxxx
attr FL_Lampe_Garderobe subType switch
define FileLog_FL_Lampe_Garderobe FileLog /var/log/fhem/FL_Lampe_Garderobe-%Y.log FL_Lampe_Garderobe
attr FileLog_FL_Lampe_Garderobe logtype text
attr FileLog_FL_Lampe_Garderobe room Server
#########################################################################
## Aktor für die Lampen im FLur bei der kleinen Treppe
## Dies ist ein gemeinsamer Aktor mit FL_Lampe_Garderobe
#########################################################################
define FL_Lampe_Treppe CUL_HM xxxxxx
attr FL_Lampe_Treppe devInfo 020100
attr FL_Lampe_Treppe firmware 1.9
attr FL_Lampe_Treppe hmClass receiver
attr FL_Lampe_Treppe model HM-LC-SW2-FM
attr FL_Lampe_Treppe room Flur
attr FL_Lampe_Treppe serialNr xxxxxxxxxx
attr FL_Lampe_Treppe subType switch
define FileLog_FL_Lampe_Treppe FileLog /var/log/fhem/FL_Lampe_Treppe-%Y.log FL_Lampe_Treppe
attr FileLog_FL_Lampe_Treppe logtype text
attr FileLog_FL_Lampe_Treppe room Server
#########################################################################
## Taster im Flur beim Eingang Badezimmer
## Dieser Taster schaltet die Lampen im Flur bei der kleinen Treppe
## arbeitet im Wechsel mit FL_Taster
#########################################################################
define FL_Taster_Bad CUL_HM xxxxxx
attr FL_Taster_Bad devInfo 020000
attr FL_Taster_Bad firmware 1.2
attr FL_Taster_Bad hmClass sender
attr FL_Taster_Bad model HM-PB-2-WM
attr FL_Taster_Bad room Flur
attr FL_Taster_Bad serialNr xxxxxxxxxx
attr FL_Taster_Bad subType remote
define FileLog_FL_Taster_Bad FileLog /var/log/fhem/FL_Taster_Bad-%Y.log FL_Taster_Bad
attr FileLog_FL_Taster_Bad logtype text
attr FileLog_FL_Taster_Bad room Server
define FL_Taster_Bad_On notify FL_Taster_Bad:Btn1.on.* set FL_Lampe_Treppe toggle
attr FL_Taster_Bad_On room Flur
define FL_Taster_Bad_Off notify FL_Taster_Bad:Btn1.off.* set FL_Lampe_Treppe toggle
attr FL_Taster_Bad_Off room Flur
#########################################################################
## Taster im Flur beim Wohnungseingang
## Dieser Taster schaltet die Lampen im Flur bei der Garderobe
## arbeitet im Wechsel mit FL_Taster
#########################################################################
define FL_Taster_Eingang CUL_HM xxxxxx
attr FL_Taster_Eingang devInfo 020000
attr FL_Taster_Eingang firmware 1.2
attr FL_Taster_Eingang hmClass sender
attr FL_Taster_Eingang model HM-PB-2-WM
attr FL_Taster_Eingang room Flur
attr FL_Taster_Eingang serialNr xxxxxxxxxx
attr FL_Taster_Eingang subType remote
define FileLog_FL_Taster_Eingang FileLog /var/log/fhem/FL_Taster_Eingang-%Y.log FL_Taster_Eingang
attr FileLog_FL_Taster_Eingang logtype text
attr FileLog_FL_Taster_Eingang room Server
define FL_Taster_Eingang_On notify FL_Taster_Eingang:Btn1.on.* set FL_Lampe_Garderobe toggle
attr FL_Taster_Eingang_On room Flur
define FL_Taster_Eingang_Off notify FL_Taster_Eingang:Btn1.off.* set FL_Lampe_Garderobe toggle
attr FL_Taster_Eingang_Off room Flur
#########################################################################
## Doppeltaster im Flur beim Wohnzimmer
## Dieser Taster schaltet die Lampen im Flur bei der Garderobe und
## im Flur bei der kleinen Treppe
## Diese Taster arbeiten als Wechselschaltung
#########################################################################
define FL_Taster CUL_HM xxxxxx
attr FL_Taster devInfo 040000
attr FL_Taster firmware 1.2
attr FL_Taster hmClass sender
attr FL_Taster model HM-PB-4-WM
attr FL_Taster room Flur
attr FL_Taster serialNr xxxxxxxxxx
attr FL_Taster subType remote
define FileLog_FL_Taster FileLog /var/log/fhem/FL_Taster-%Y.log FL_Taster
attr FileLog_FL_Taster logtype text
attr FileLog_FL_Taster room Server
define FL_Taster_On_Links notify FL_Taster:Btn1.on.* set FL_Lampe_Treppe toggle
attr FL_Taster_On_Links room Flur
define FL_Taster_Off_Links notify FL_Taster:Btn1.off.* set FL_Lampe_Treppe toggle
attr FL_Taster_Off_Links room Flur
define FL_Taster_On_Rechts notify FL_Taster:Btn2.on.* set FL_Lampe_Garderobe toggle
attr FL_Taster_On_Rechts room Flur
define FL_Taster_Off_Rechts notify FL_Taster:Btn2.off.* set FL_Lampe_Garderobe toggle
attr FL_Taster_Off_Rechts room Flur</nowiki>

Die Jalousie soll immer morgens um 8 Uhr hoch gefahren werden, wobei aufgrund der Verkabelung am Aktor Hochfahren mit dem Status off eingeleitet wird. Das Herunterfahren soll variabel aufgrund der Untergangszeit der Sonne geschehen. Siehe [[Sunset Sunrise]].

Die früheste Zeit zum Herunterfahren ist 17:00 Uhr und spätestens um 21:00 Uhr sollen die Jalousien auf jeden Fall heruntergefahren sein. Mit den Tastern werden 2 Wechselschaltungen simuliert, wobei derzeit keine besonderen Schaltvorgänge ermöglicht werden.

[[Kategorie:Examples]]

Jalousie und Beleuchtung in mehreren Räumen

2013-11-12T19:01:52Z

Yfhem: Added ref to Sunset Sunrise. Docu here was a little out-of-date.

Dies ist die Beschreibung einer Fhem-Konfiguration, die zur Steuerung einer Hausautomation auf Basis von [[HomeMatic]] dient. Gesteuert werden in verschiedenen Räumen das '''Licht und die Jalousien'''. Die Länge dieser Beschreibung soll nicht abschreckend wirken, viele Zeilen sind Kommentare oder durch den ''autocreate'' Prozeß erzeugte Zeilen!

== Verwendete Hard- und Software ==
Als [[:Kategorie:Server Hardware|Server]] dient ein PC mit einem Athlon 64 X2 Dual Core Prozessor 6000+, 4 GB Hauptspeicher, 2 TB gespiegeltem Diskspeicher und Gigabit Ethernet. Auf dem Server ist ein Ubuntu 11.04 Serveredition installiert, die automatisch auf dem neuesten Stand gehalten wird. Perl ist in der Version 5.10.1 vorhanden. Fhem ist dabei nur eine von vielen Applikationen, die auf dem Server laufen.

Der Server kann über das Ethernet im Hausnetz auf eine [[AVM Fritz!Box|Fritzbox 7170]] zugreifen, die wiederum mittels WLAN mit einer Fritzbox 3170 verbunden ist, die als WLAN-Repeater dient. An die 3170 ist als Hauszentrale ein HomeMatic Lan [[Interface]] ([[HMLAN Konfigurator]]) angeschlossen.

Der CPU-Verbrauch hält sich sehr in Grenzen, bei einer stichprobenartigen Überwachung hat Fhem etwa 5-6 CPU Sekunden verbraucht in 24 Stunden.

[[File:Konfiguration-Ethernet.jpg|628px]]

Folgende HomeMatic Komponenten kommen zum Einsatz:

<table border="1">
<tr>
<th> Produktcode </th>
<th> Funktion </th>
<th> Anzahl
</th></tr>
<tr>
<td> HM-CFG-LAN </td>
<td> LanInterface </td>
<td> 1
</td></tr>
<tr>
<td> HM-RC-12-W </td>
<td> Funkfernbedienung 12-Tasten </td>
<td> 1
</td></tr>
<tr>
<td> HM-RC-4-B </td>
<td> Funkfernbedienung 4-Tasten </td>
<td> 1
</td></tr>
<tr>
<td> HM-PB-2-WM </td>
<td> Funk-Wandtaster 2fach </td>
<td> 3
</td></tr>
<tr>
<td> HM-PB-4-WM </td>
<td> Funk-Wandtaster 4fach </td>
<td> 2
</td></tr>
<tr>
<td> HM-LC-Sw1-FM </td>
<td> Funk-Schaltaktor 1-fach, Unterputzmontage </td>
<td> 2
</td></tr>
<tr>
<td> HM-LC-Sw2-FM </td>
<td> Funk-Schaltaktor 2-fach, Unterputzmontage </td>
<td> 3
</td></tr>
<tr>
<td> HM-LC-Bl1-FM </td>
<td> Funk-Jalousieaktor 1-fach, Unterputzmontage </td>
<td> 2
</td></tr>
<tr>
<td> HM-LC-Sw1PB-FM </td>
<td> Funk-Schaltaktor 1-fach, Unterputzmontage mit Tasteraufsatz </td>
<td> 1
</td></tr></table>

'''Namensregeln''': Alle Definitionen, die NICHT eindeutig einem Raum zuzuordnen sind, erhalten ein XX_ an den Anfang, alle anderen Definitionen erhalten eine der folgenden Kennungen:

<table border="1">
<tr>
<th> Kennung </th>
<th> Raum
</th></tr>
<tr>
<td> AK_ </td>
<td> Arbeitskeller
</td></tr>
<tr>
<td> BA_ </td>
<td> Bad
</td></tr>
<tr>
<td> BU_ </td>
<td> Büro
</td></tr>
<tr>
<td> DB </td>
<td> Dachboden
</td></tr>
<tr>
<td> FL_ </td>
<td> Flur
</td></tr>
<tr>
<td> GA_ </td>
<td> Garage
</td></tr>
<tr>
<td> KU_ </td>
<td> Küche
</td></tr>
<tr>
<td> SK_ </td>
<td> Saunakeller
</td></tr>
<tr>
<td> SZ_ </td>
<td> Schlafzimmer
</td></tr>
<tr>
<td> TG_ </td>
<td> Terasse/Garten
</td></tr>
<tr>
<td> TH_ </td>
<td> Treppenhaus
</td></tr>
<tr>
<td> VK_ </td>
<td> Vorratskeller
</td></tr>
<tr>
<td> WK_ </td>
<td> Waschkeller
</td></tr>
<tr>
<td> WZ_ </td>
<td> Wohnzimmer
</td></tr></table>

== Konfigurationsdateien ==
Alle Dateien, bis auf fhem.cfg, befinden sich in /etc/fhem. Alle Komponenten, die nicht physikalisch einem Raum zuzuordnen sind (Logs, Globales, etc.) wurden dem virtuellen Raum ''Server'' zugeordnet.

=== /etc/fhem.cfg ===
Die Datei /etc/fhem.cfg ist der Haupteinstiegspunkt für die Konfiguration. Aus Gründen der besseren Wartbarkeit beinhaltet die Datei nur include Anweisungen, mit der andere Dateien aus dieser Datei heraus aufgerufen werden. Das hat den Vorteil, dass Kommentare in den include Dateien erhalten bleiben. Dies ist (bzw. war seinerzeit) nicht der Fall für fhem.cfg, wenn man die Funktion autocreate verwendet. Attribute für die Definition ''global'' dürfen nicht aus der fhem.cfg ausgelagert werden, sie müssen Bestandteil der fhem.cfg bleiben.

<nowiki>attr global autoload_undefined_devices 1
attr global logfile /var/log/fhem/fhem-%Y-%m.log
attr global modpath /usr/share/fhem
attr global port 7072
attr global room Server
attr global statefile /var/log/fhem/fhem.save
include /etc/fhem/Web.cfg
include /etc/fhem/Autocreate.cfg
include /etc/fhem/LanInterface.cfg
include /etc/fhem/Fernbedienung.cfg
include /etc/fhem/Schlafzimmer.cfg
include /etc/fhem/Gaestezimmer.cfg
include /etc/fhem/Wohnzimmer.cfg
# include /etc/fhem/Buero.cfg
include /etc/fhem/Flur.cfg</nowiki>

=== /etc/fhem/Web.cfg ===
Alle relevanten Konfigurationsparameter für den Webzugriff sind in dieser Datei zu finden. Es sind die aus der Installation bekannten Standardwerte übernommen worden.

<nowiki>#########################################################################
## Webdefinitionen
## Zweck.........: Definitionen für den Zugriff auf den Webserver
## Standort......: Server
## Typ...........:
## Installation..: 15.09.2011
## Besonderheiten:
##
#########################################################################
define XX_WEB FHEMWEB 8083 global
attr XX_WEB fwcompress 0
attr XX_WEB room Server
define XX_WEBphone FHEMWEB 8084
attr XX_WEBphone room Server
attr XX_WEBphone smallscreen 1
define XX_WEBtablet FHEMWEB 8085
attr XX_WEBtablet room Server
attr XX_WEBtablet touchpad 1</nowiki>

=== /etc/fhem/Autocreate.cfg ===
Diese Datei enthält alle wichtigen Information zu dem Autocreate Prozess. Keine Änderung gegenüber den Standardwerten.

<nowiki>#########################################################################
## Autocreate Definitionen
## Zweck.........: Autocreate aktivieren
## Standort......: Server
## Typ...........:
## Installation..: 15.09.2011
## Besonderheiten:
##
#########################################################################
define XX_Autocreate autocreate
attr XX_Autocreate autosave 1
attr XX_Autocreate device_room %TYPE
attr XX_Autocreate filelog /var/log/fhem/%NAME-%Y.log
attr XX_Autocreate room Server
attr XX_Autocreate weblink 1
attr XX_Autocreate weblink_room Plots</nowiki>

=== /etc/fhem/LanInterface.cfg ===
Das Lan-Interface stellt das Bindeglied zwischen dem Server und den einzelnen Homematic-Komponenten dar. Es ist mit einem Ethernetnetzwerkkabel an das Netzwerk angeschlossen. Dem Lan-Interface wurde eine feste IP-Adresse vergeben, um immer auf der gleichen Adresse ansprechbar zu sein. Der Zugriff auf das Interface geschieht über Port 1000.

<nowiki>#########################################################################
## Lan Adapter
## Zweck.........: Bindeglied zwischen Server/fhem und Homematic Aktoren und Sender
## Standort......: Gästezimmer
## Typ...........:
## Installation..: 15.09.2011
## Besonderheiten: feste IP-Adresse 192.168.0.6 Port 1000
## wird an 3170 WLAN-Repeater betrieben wegen besserer Abdeckung
#########################################################################
define XX_LANInterface HMLAN 192.168.0.6:1000
attr XX_LANInterface hmId xxxxxx
attr XX_LANInterface room Gästezimmer</nowiki>

=== /etc/fhem/Fernbedienung.cfg ===
Fernbedienungen sind nicht an einen Standort gebunden und können bewegt werden, daher eine eigene Konfiguration, wenn die Fernbedienung nicht einem Zimmer ausschließlich zugeordnet ist.

<nowiki>#########################################################################
## Fernbedienungen
## Zweck.........: alle verfügbaren Sender, wenn sie nicht einem Raum
## unmittelbar zugeordnet sind
## Standort......: verschiedene
## Typ...........: verschiedene
## Installation..: 15.09.2011 12-Tasten-Fernbedienung
## Besonderheiten:
#########################################################################
#########################################################################
## 12-Tasten Fernbedienung
## Zweck.........: Rollladensteuerung, Licht im Wohnzimmer und Flur
## Scheinwerfer im Garten
## Standort......: normalerweise Wohnzimmer
## Typ...........: HM-RC-12
## Installation..: 15.09.2011 12-Tasten-Fernbedienung
## Besonderheiten: es wird nicht zwischen langem und kurzem Tasten-
## druck unterschieden
#########################################################################
define XX_FB_12_1 CUL_HM xxxxxx
attr XX_FB_12_1 devInfo 0C0000
attr XX_FB_12_1 firmware 1.1
attr XX_FB_12_1 hmClass sender
attr XX_FB_12_1 model HM-RC-12
attr XX_FB_12_1 room Wohnzimmer
attr XX_FB_12_1 serialNr xxxxxxxxxx
attr XX_FB_12_1 subType remote

#########################################################################
## linker Button Reihe 1
## Funktion......: Rollladen runter im Wohnzimmer
## Besonderheiten: ACHTUNG, on und off sind im Wohnzimmer vertauscht
## wegen der Tasten auf dem Taster an dem Aktuator
#########################################################################
define XX_FB_12_1_1_Off notify XX_FB_12_1:Btn1.off.* set WZ_Rollladen off
attr XX_FB_12_1_1_Off room Wohnzimmer
#########################################################################
## rechter Button Reihe 1
## Funktion......: Rollladen hoch im Wohnzimmer
## Besonderheiten: ACHTUNG, on und off sind im Wohnzimmer vertauscht
## wegen der Tasten auf dem Taster an dem Aktuator
#########################################################################
define XX_FB_12_1_1_On notify XX_FB_12_1:Btn1.on.* set WZ_Rollladen on
attr XX_FB_12_1_1_On room Wohnzimmer
#########################################################################
## linker Button Reihe 2
## Funktion......: Rollladen runter im Gästezimmer
## Besonderheiten: on=runter off=hoch
#########################################################################
define XX_FB_12_1_2_Off notify XX_FB_12_1:Btn2.off.* set GZ_Rollladen on
attr XX_FB_12_1_2_Off room Wohnzimmer
#########################################################################
## rechter Button Reihe 2
## Funktion......: Rollladen hoch im Gästezimmer
## Besonderheiten: on=runter off=hoch
#########################################################################
define XX_FB_12_1_2_On notify XX_FB_12_1:Btn2.on.* set GZ_Rollladen off
attr XX_FB_12_1_2_On room Wohnzimmer
#########################################################################
## linker Button Reihe 3
## Funktion......: Rollladen runter im Flur
## Besonderheiten: on=runter off=hoch
#########################################################################
define XX_FB_12_1_3_Off notify XX_FB_12_1:Btn3.off.* set FL_Rollladen on
attr XX_FB_12_1_3_Off room Wohnzimmer
#########################################################################
## rechter Button Reihe 3
## Funktion......: Rollladen hoch im Flur
## Besonderheiten: on=runter off=hoch
#########################################################################
define XX_FB_12_1_3_On notify XX_FB_12_1:Btn3.on.* set FL_Rollladen off
attr XX_FB_12_1_3_On room Wohnzimmer
#########################################################################
## linker Button Reihe 4
## Funktion......:
## Besonderheiten: derzeit nicht belegt
#########################################################################
#########################################################################
## rechter Button Reihe 4
## Funktion......:
## Besonderheiten: derzeit nicht belegt
#########################################################################
#########################################################################
## linker Button Reihe 5
## Funktion......:
## Besonderheiten: derzeit nicht belegt
#########################################################################
#########################################################################
## rechter Button Reihe 5
## Funktion......:
## Besonderheiten: derzeit nicht belegt
#########################################################################
#########################################################################
## oberer Button rechts an der Fernbedienung
## Funktion......:
## Besonderheiten: derzeit nicht belegt
#########################################################################
#########################################################################
## unterer Button rechts an der Fernbedienung
## Funktion......:
## Besonderheiten: derzeit nicht belegt
#########################################################################</nowiki>

Um eine Kommando mit einer Taste zu verknüpfen, wird die jeweilige Taste mittels notify abgefragt. Die Identifikation um welche Fernbedienung und welche Taste es sich handelt wird durch die Kennung „Name der Fernbedienung“ : und Rückgabestring“ abgehandelt.
Fhem gibt immer einen String mit den Information zurück. Dieser String enthält auch Leerzeichen. Diese Leerzeichen müssen in der Definition durch jeweils einen Punkt ersetzt werden, da Fhem sonst die ganze Befehlskette nicht richtig identifiziert. Der Stern am Ende deklariert den Rest des Rückgabestrings als nicht relevant.

Die 12-Tasten-Fernbedienung steuert derzeit die Jalousien für Gäste-, Wohnzimmer und Flur und die Tastenbelegung ist so gestaltet, dass die jeweils linke Taste in einer Reihe die Jalousie herunter fährt und die rechte Taste diese Jalousie wieder hoch fährt. Diese Fernbedienung wird global dem Raum Wohnzimmer zugeordnet, weil das der bevorzugte Platz für diese Fernbedienung sein soll.

=== /etc/fhem/Schlafzimmer.cfg ===
Im Schlafzimmer kommen hauptsächlich Schaltaktoren für Licht zur Anwendung. Eine Fernbedienung ermöglicht die Schaltungen vom Bett aus. Das Deckenlicht wird von einem Taster an der Tür oder von einer Fernbedienung geschaltet. Im Schlafzimmer sind 2 Unterputzaktoren 1fach, 1 Unterputzaktor 2fach, 1 Taster 2fach und eine 4-Tasten-Fernbedienung installiert.

<nowiki>#########################################################################
## Schlafzimmer
## Zweck.........: Alle Homematic Komponenten im Schlafzimmer
## Standort......: Schlafzimmer
## Typ...........: verschiedene
## Installation..: 15.09.2011
## Besonderheiten:
##
#########################################################################
#########################################################################
## Aktor für die senkrechten Deckenstrahler
#########################################################################
define SZ_Lampe_Decke CUL_HM xxxxxx
attr SZ_Lampe_Decke devInfo 010100
attr SZ_Lampe_Decke firmware 1.9
attr SZ_Lampe_Decke hmClass receiver
attr SZ_Lampe_Decke model HM-LC-SW1-FM
attr SZ_Lampe_Decke room Schlafzimmer
attr SZ_Lampe_Decke serialNr xxxxxxxxxx
attr SZ_Lampe_Decke subType switch
#########################################################################
## Aktor für die Strahler an den Bettseiten
## und für die Deckenlampen in der Schräge
#########################################################################
define SZ_Lampen_Seite CUL_HM xxxxxx
attr SZ_Lampen_Seite devInfo 010100
attr SZ_Lampen_Seite firmware 1.9
attr SZ_Lampen_Seite hmClass receiver
attr SZ_Lampen_Seite model HM-LC-SW1-FM
attr SZ_Lampen_Seite room Schlafzimmer
attr SZ_Lampen_Seite serialNr xxxxxxxxxx
attr SZ_Lampen_Seite subType switch

#########################################################################
## Aktor für die Strahler über dem Bett links
## Besonderheit: Dies ist ein 2-Fach Schaltaktor
## anderer Port wird für Bett rechts benutzt
#########################################################################
define SZ_Lampe_Bett_links CUL_HM xxxxxx
attr SZ_Lampe_Bett_links devInfo 020100
attr SZ_Lampe_Bett_links firmware 1.9
attr SZ_Lampe_Bett_links hmClass receiver
attr SZ_Lampe_Bett_links model HM-LC-SW2-FM
attr SZ_Lampe_Bett_links room Schlafzimmer
attr SZ_Lampe_Bett_links serialNr xxxxxxxxxx
attr SZ_Lampe_Bett_links subType switch
#########################################################################
## Aktor für die Strahler über dem Bett rechts
## Besonderheit: Dies ist ein 2-Fach Schaltaktor
## anderer Port wird für Bett links benutzt
#########################################################################
define SZ_Lampe_Bett_rechts CUL_HM xxxxxx
attr SZ_Lampe_Bett_rechts devInfo 020100
attr SZ_Lampe_Bett_rechts firmware 1.9
attr SZ_Lampe_Bett_rechts hmClass receiver
attr SZ_Lampe_Bett_rechts model HM-LC-SW2-FM
attr SZ_Lampe_Bett_rechts room Schlafzimmer
attr SZ_Lampe_Bett_rechts serialNr xxxxxxxxxx
attr SZ_Lampe_Bett_rechts subType switch
#########################################################################
## Sender an der Tür
## schaltet Decken- und Seitenlampen ein oder aus
## bei einem langen Tastendruck (onLong) werden alle Deckenlampen und
## die Lampen an der Seite eingeschaltet, bei einem kurzen Tastendruck
## werden nur die Hälfte der Lampen an der Decke angeschaltet
#########################################################################
define SZ_Taster_Tuer CUL_HM xxxxxx
attr SZ_Taster_Tuer devInfo 020000
attr SZ_Taster_Tuer firmware 1.2
attr SZ_Taster_Tuer hmClass sender
attr SZ_Taster_Tuer model HM-PB-2-WM
attr SZ_Taster_Tuer room Schlafzimmer
attr SZ_Taster_Tuer serialNr xxxxxxxxxx
attr SZ_Taster_Tuer subType remote
define SZ_Taster_Tuer_On_Alles notify SZ_Taster_Tuer:Btn1.onLong.* set SZ_Lampe_Decke,SZ_Lampen_Seite on
attr SZ_Taster_Tuer_On_Alles room Schlafzimmer
define SZ_Taster_Tuer_On_Decke notify SZ_Taster_Tuer:Btn1.on.* set SZ_Lampe_Decke on
attr SZ_Taster_Tuer_On_Decke room Schlafzimmer
define SZ_Taster_Tuer_Off notify SZ_Taster_Tuer:Btn1.off.* set SZ_Lampe_Decke,SZ_Lampen_Seite off
attr SZ_Taster_Tuer_Off room Schlafzimmer
#########################################################################
## 4-Tastenfernbedienung
## Zweck.........: Lichtschaltungen im Schlafzimmer vom Bett aus
## Standort......: Schlafzimmer
## Typ...........: HM-RC-4
## Installation..: 23.09.2011
## Besonderheiten: arbeitet mit toggle
#########################################################################
define SZ_Fernbedienung_4_1 CUL_HM xxxxxx
attr SZ_Fernbedienung_4_1 devInfo 040000
attr SZ_Fernbedienung_4_1 firmware 1.3
attr SZ_Fernbedienung_4_1 hmClass sender
attr SZ_Fernbedienung_4_1 model HM-RC-4-B
attr SZ_Fernbedienung_4_1 room Schlafzimmer
attr SZ_Fernbedienung_4_1 serialNr xxxxxxxxxx
attr SZ_Fernbedienung_4_1 subType remote
#########################################################################
## linker Button Reihe 1
## Funktion......: Licht links am Bett ein-/ausschalten
## Besonderheiten:
#########################################################################
define SZ_FB_Btn1_off notify SZ_Fernbedienung_4_1:Btn1.off.* set SZ_Lampe_Bett_links toggle
attr SZ_FB_Btn1_off room Schlafzimmer

#########################################################################
## rechter Button Reihe 1
## Funktion......: Licht rechts am Bett ein-/ausschalten
## Besonderheiten:
#########################################################################
define SZ_FB_Btn1_on notify SZ_Fernbedienung_4_1:Btn1.on.* set SZ_Lampe_Bett_rechts toggle
attr SZ_FB_Btn1_on room Schlafzimmer
#########################################################################
## linker Button Reihe 2
## Funktion......: Deckenlampen schalten
## Besonderheiten:
#########################################################################
define SZ_FB_Btn2_off notify SZ_Fernbedienung_4_1:Btn2.off.* set SZ_Lampe_Decke toggle
attr SZ_FB_Btn2_off room Schlafzimmer
#########################################################################
## rechter Button Reihe 2
## Funktion......: Seitenlampen schalten
## Besonderheiten:
#########################################################################
define SZ_FB_Btn2_on notify SZ_Fernbedienung_4_1:Btn2.on.* set SZ_Lampen_Seite toggle
attr SZ_FB_Btn2_on room Schlafzimmer
#########################################################################
## Alternative! Um SZ_Lampe_Decke und SZ_Lampen_Seite mit einem
## Tastendruck zu schalten
## Durch dieses Notify wird zuerst SZ_Lampe_Decke eingeschaltet, dann
## beim nächsten Tastendruck wird SZ_Lampen_Seite dazugeschaltet und
## dann beim dritten Tastendruck werden beide wieder ausgeschaltet
## Bei Aktivierung vorher SZ_FB_Btnx.on/off deaktivieren!!!
#########################################################################
#define MyNotify notify Fernbedienung:Btn2.on.* {if(Value("SZ_Lampe_Decke") == "on" && Value("SZ_Lampen_Seite") == "on") {fhem "set SZ_Lampe_Decke,SZ_Lampen_Seite off"} elsif(Value("SZ_Lampe_Decke") == "on" && Value("SZ_Lampen_Seite") == "off") {fhem "set SZ_Lampen_Seite on"} else{fhem "set SZ_Lampe_Decke on"}}</nowiki>
Der Taster an der Tür soll nur Licht ein- und ausschalten, daher wurde auf eine Unterscheidung zwischen einem langen und einem kurzen Tastendruck verzichtet. Da zwei verschiedene Lichtquellen zu schalten sind, müssen bei dem set Kommando beide Quellen jeweils angegeben werden. Es dürfen keine Leerzeichen in der Liste der Aktoren sein und die Aktoren müssen per Komma getrennt werden. (Achtung: "else if" muss in Perl als "elsif" geschrieben werden.)

=== /etc/fhem/Gaestezimmer.cfg ===
Im Gästezimmer wird derzeit nur die Jalousie gesteuert. Hier ist nur ein Unterputzjalousieaktor installiert.

<nowiki>#########################################################################
## Gästezimmer
## Zweck.........: Alle Homematic Komponenten im Gästezimmer
## Standort......: Gästezimmer
## Typ...........: verschiedene
## Installation..: 15.09.2011
## Besonderheiten:
##
#########################################################################
#########################################################################
## Aktor für die Rollladen
#########################################################################
define GZ_Rollladen CUL_HM xxxxx
attr GZ_Rollladen devInfo 010100
attr GZ_Rollladen firmware 1.5
attr GZ_Rollladen hmClass receiver
attr GZ_Rollladen model HM-LC-BL1-FM
attr GZ_Rollladen room Gästezimmer
attr GZ_Rollladen serialNr xxxxxxxxxx
attr GZ_Rollladen subType blindActuator
attr GZ_Rollladen eventMap on:zu off:offen
#########################################################################
## eigenes Log
#########################################################################
define GZ_Rollladen_FileLog FileLog /var/log/fhem/GZ_Rollladen-%Y.log GZ_Rollladen
attr GZ_Rollladen_FileLog logtype text
attr GZ_Rollladen_FileLog room Server
#########################################################################
## Rollladen soll fix um 08:00h jeden Tag hochfahren
#########################################################################
define GZ_Rollladen_hoch at *08:00 set GZ_Rollladen offen
attr GZ_Rollladen_hoch room Gästezimmer
#########################################################################
## Rollladen soll variabel je nach Sonnenuntergang, aber
## nicht vor 17:00h und nicht nach 21:00h jeden Tag runterfahren
#########################################################################
define GZ_Rollladen_runter at *{sunset(0,"17:00","21:00")} set GZ_Rollladen zu
attr GZ_Rollladen_runter room Gästezimmer</nowiki>

Die Jalousie soll immer morgens um 8 Uhr hoch gefahren werden, wobei aufgrund der Verkabelung am Aktor Hochfahren mit dem Status off eingeleitet wird. Das Herunterfahren soll variabel aufgrund der Untergangszeit der Sonne geschehen. Siehe [[Sunset Sunrise]]. Die früheste Zeit zum Herunterfahren ist 17:00 Uhr und spätestens um 21:00 Uhr sollen die Jalousien auf jeden Fall heruntergefahren sein. Dies wird auf alle Jalousien angewendet. Zur besseren Lesbarkeit der Anzeige wurde der Status der Rollade durch Setzen des Attributes EventMap umbenannt. Wenn der Aktor den Status ''on'' meldet, dann wird ''zu'' angezeigt und alternativ bei ''off'' dann ''offen''.

=== /etc/fhem/Wohnzimmer.cfg ===
Im Wohnzimmer wird derzeit eine Jalousie und die Beleuchtung gesteuert. Installiert sind: ein Jalousieaktor mit Tasteraufsatz, zwei 4fach-Taster, ein Unterputzdoppelaktor.

<nowiki>#########################################################################
## Wohnzimmer
## Zweck.........: Alle Homematic Komponenten im Wohnzimmer
## Standort......: Wohnzimmer
## Typ...........: verschiedene
## Installation..: 15.09.2011
## Besonderheiten: ACHTUNG, on und off bei der Rollladensteuerung
## ist im Wohnzimmer vertauscht on=rauf off=runter
#########################################################################
#########################################################################
## Aktor für die Rollladen
#########################################################################
define WZ_Rollladen CUL_HM xxxxxx
attr WZ_Rollladen devInfo 010100
attr WZ_Rollladen firmware 1.6
attr WZ_Rollladen hmClass receiver
attr WZ_Rollladen model HM-LC-BL1-PB-FM
attr WZ_Rollladen room Wohnzimmer
attr WZ_Rollladen serialNr xxxxxxxxxx
attr WZ_Rollladen subType blindActuator
attr WZ_Rollladen eventMap on:offen off:zu
#########################################################################
## eigenes Log
#########################################################################
define WZ_Rollladen_FileLog FileLog /var/log/fhem/WZ_Rollladen-%Y.log WZ_Rollladen
attr WZ_Rollladen_FileLog logtype text
attr WZ_Rollladen_FileLog room Server
#########################################################################
## Rollladen soll fix um 08:00h jeden Tag hochfahren
#########################################################################
define WZ_Rollladen_hoch at *08:00 set WZ_Rollladen offen
attr WZ_Rollladen_hoch room Wohnzimmer
#########################################################################
## Rollladen soll variabel je nach Sonnenuntergang, aber
## nicht vor 17:00h und nicht nach 21:00h jeden Tag runterfahren
#########################################################################
define WZ_Rollladen_runter at *{sunset(0,"17:00","21:00")} set WZ_Rollladen zu
attr WZ_Rollladen_runter room Wohnzimmer
#########################################################################
## Aktor für die Lampen auf der Schrankseite des Wohnzimmers
## dies ist ein gemeinsamer Aktor mit WZ_Lampe_Couch
#########################################################################
define WZ_Lampe_Schrank CUL_HM xxxxxx
attr WZ_Lampe_Schrank devInfo 020100
attr WZ_Lampe_Schrank firmware 1.9
attr WZ_Lampe_Schrank hmClass receiver
attr WZ_Lampe_Schrank model HM-LC-SW2-FM
attr WZ_Lampe_Schrank room Wohnzimmer
attr WZ_Lampe_Schrank serialNr xxxxxxxxxx
attr WZ_Lampe_Schrank subType switch
define FileLog_WZ_Lampe_Schrank FileLog /var/log/fhem/WZ_Lampe_Schrank-%Y.log WZ_Lampe_Schrank
attr FileLog_WZ_Lampe_Schrank logtype text
attr FileLog_WZ_Lampe_Schrank room Server
#########################################################################
## Aktor für die Lampen auf der Couchseite des Wohnzimmers
## dies ist ein gemeinsamer Aktor mit WZ_Lampe_Schrank
#########################################################################
define WZ_Lampe_Couch CUL_HM xxxxxx
attr WZ_Lampe_Couch devInfo 020100
attr WZ_Lampe_Couch firmware 1.9
attr WZ_Lampe_Couch hmClass receiver
attr WZ_Lampe_Couch model HM-LC-SW2-FM
attr WZ_Lampe_Couch room Wohnzimmer
attr WZ_Lampe_Couch serialNr xxxxxxxxxxx
attr WZ_Lampe_Couch subType switch
define FileLog_WZ_Lampe_Couch FileLog /var/log/fhem/WZ_Lampe_Couch-%Y.log WZ_Lampe_Couch
attr FileLog_WZ_Lampe_Couch logtype text
attr FileLog_WZ_Lampe_Couch room Server
#########################################################################
## Doppeltaster im Wohnzimmer beim Flur
## Dieser Taster schaltet die Lampen im Wohnzimmer bei dem Schrank
## und bei der Couch
#########################################################################
define WZ_Taster CUL_HM xxxxxx
attr WZ_Taster devInfo 040000
attr WZ_Taster firmware 1.2
attr WZ_Taster hmClass sender
attr WZ_Taster model HM-PB-4-WM
attr WZ_Taster room Wohnzimmer
attr WZ_Taster serialNr xxxxxxxxxxx
attr WZ_Taster subType remote
define FileLog_WZ_Taster FileLog /var/log/fhem/WZ_Taster-%Y.log WZ_Taster
attr FileLog_WZ_Taster logtype text
attr FileLog_WZ_Taster room Server
define WZ_Taster_On_Links notify WZ_Taster:Btn1.on.* set WZ_Lampe_Schrank toggle
attr WZ_Taster_On_Links room Wohnzimmer
define WZ_Taster_Off_Links notify WZ_Taster:Btn1.off.* set WZ_Lampe_Schrank toggle
attr WZ_Taster_Off_Links room Wohnzimmer
define WZ_Taster_On_Rechts notify WZ_Taster:Btn2.on.* set WZ_Lampe_Couch toggle
attr WZ_Taster_On_Rechts room Wohnzimmer
define WZ_Taster_Off_Rechts notify WZ_Taster:Btn2.off.* set WZ_Lampe_Couch toggle
attr WZ_Taster_Off_Rechts room Wohnzimmer</nowiki>

Die Jalousie soll immer morgens um acht Uhr hochgefahren werden, wobei aufgrund der Verkabelung am Aktor Hochfahren mit dem Status on eingeleitet wird. Dies ist anders als im Gästezimmer oder Flur! Das Herunterfahren soll variabel aufgrund der Untergangszeit der Sonne geschehen. Siehe [[Sunset Sunrise]].

Die früheste Zeit zum Herunterfahren ist 17:00 Uhr und spätestens um 21:00 Uhr sollen die Jalousien auf jeden Fall heruntergefahren sein. Die Taster schalten egal bei welchem Tastendruck das Licht an oder aus.

=== /etc/fhem/Flur.cfg ===
Im Flur werden derzeit eine Jalousie und die Beleuchtung gesteuert. Installiert sind ein Unterputzjalousieaktor, ein 4fach Taster, zwei 2fach Taster, ein Unterputzdoppelaktor. Dadurch wurde eine Wechselschaltung simuliert.

<nowiki>#########################################################################
## Flur
## Zweck.........: Alle Homematic Komponenten im Flur
## Standort......: Flur
## Typ...........: verschiedene
## Installation..: 15.09.2011
## Besonderheiten:
##
#########################################################################
#########################################################################
## Aktor für die Rollladen
#########################################################################
define FL_Rollladen CUL_HM xxxxxx
attr FL_Rollladen devInfo 010100
attr FL_Rollladen firmware 1.5
attr FL_Rollladen hmClass receiver
attr FL_Rollladen model HM-LC-BL1-FM
attr FL_Rollladen room Flur
attr FL_Rollladen serialNr xxxxxxxxxx
attr FL_Rollladen subType blindActuator
attr FL_Rollladen eventMap on:zu off:offen
#########################################################################
## eigenes Log
#########################################################################
define FL_Rollladen_FileLog FileLog /var/log/fhem/FL_Rollladen-%Y.log FL_Rollladen
attr FL_Rollladen_FileLog logtype text
attr FL_Rollladen_FileLog room Server
#########################################################################
## Rollladen soll fix um 08:00h jeden Tag hochfahren
#########################################################################
define FL_Rollladen_hoch at *08:00 set FL_Rollladen offen
attr FL_Rollladen_hoch room Flur
#########################################################################
## Rollladen soll variabel je nach Sonnenuntergang, aber
## nicht vor 17:00h und nicht nach 21:00h jeden Tag runterfahren
#########################################################################
define FL_Rollladen_runter at *{sunset(0,"17:00","21:00")} set FL_Rollladen zu
attr FL_Rollladen_runter room Flur
#########################################################################
## Aktor für die Lampen im FLur bei der Garderobe
## Dies ist ein gemeinsamer Aktor mit FL_Lampe_Treppe
#########################################################################
define FL_Lampe_Garderobe CUL_HM xxxxxx
attr FL_Lampe_Garderobe devInfo 020100
attr FL_Lampe_Garderobe firmware 1.9
attr FL_Lampe_Garderobe hmClass receiver
attr FL_Lampe_Garderobe model HM-LC-SW2-FM
attr FL_Lampe_Garderobe room Flur
attr FL_Lampe_Garderobe serialNr xxxxxxxxxx
attr FL_Lampe_Garderobe subType switch
define FileLog_FL_Lampe_Garderobe FileLog /var/log/fhem/FL_Lampe_Garderobe-%Y.log FL_Lampe_Garderobe
attr FileLog_FL_Lampe_Garderobe logtype text
attr FileLog_FL_Lampe_Garderobe room Server
#########################################################################
## Aktor für die Lampen im FLur bei der kleinen Treppe
## Dies ist ein gemeinsamer Aktor mit FL_Lampe_Garderobe
#########################################################################
define FL_Lampe_Treppe CUL_HM xxxxxx
attr FL_Lampe_Treppe devInfo 020100
attr FL_Lampe_Treppe firmware 1.9
attr FL_Lampe_Treppe hmClass receiver
attr FL_Lampe_Treppe model HM-LC-SW2-FM
attr FL_Lampe_Treppe room Flur
attr FL_Lampe_Treppe serialNr xxxxxxxxxx
attr FL_Lampe_Treppe subType switch
define FileLog_FL_Lampe_Treppe FileLog /var/log/fhem/FL_Lampe_Treppe-%Y.log FL_Lampe_Treppe
attr FileLog_FL_Lampe_Treppe logtype text
attr FileLog_FL_Lampe_Treppe room Server
#########################################################################
## Taster im Flur beim Eingang Badezimmer
## Dieser Taster schaltet die Lampen im Flur bei der kleinen Treppe
## arbeitet im Wechsel mit FL_Taster
#########################################################################
define FL_Taster_Bad CUL_HM xxxxxx
attr FL_Taster_Bad devInfo 020000
attr FL_Taster_Bad firmware 1.2
attr FL_Taster_Bad hmClass sender
attr FL_Taster_Bad model HM-PB-2-WM
attr FL_Taster_Bad room Flur
attr FL_Taster_Bad serialNr xxxxxxxxxx
attr FL_Taster_Bad subType remote
define FileLog_FL_Taster_Bad FileLog /var/log/fhem/FL_Taster_Bad-%Y.log FL_Taster_Bad
attr FileLog_FL_Taster_Bad logtype text
attr FileLog_FL_Taster_Bad room Server
define FL_Taster_Bad_On notify FL_Taster_Bad:Btn1.on.* set FL_Lampe_Treppe toggle
attr FL_Taster_Bad_On room Flur
define FL_Taster_Bad_Off notify FL_Taster_Bad:Btn1.off.* set FL_Lampe_Treppe toggle
attr FL_Taster_Bad_Off room Flur
#########################################################################
## Taster im Flur beim Wohnungseingang
## Dieser Taster schaltet die Lampen im Flur bei der Garderobe
## arbeitet im Wechsel mit FL_Taster
#########################################################################
define FL_Taster_Eingang CUL_HM xxxxxx
attr FL_Taster_Eingang devInfo 020000
attr FL_Taster_Eingang firmware 1.2
attr FL_Taster_Eingang hmClass sender
attr FL_Taster_Eingang model HM-PB-2-WM
attr FL_Taster_Eingang room Flur
attr FL_Taster_Eingang serialNr xxxxxxxxxx
attr FL_Taster_Eingang subType remote
define FileLog_FL_Taster_Eingang FileLog /var/log/fhem/FL_Taster_Eingang-%Y.log FL_Taster_Eingang
attr FileLog_FL_Taster_Eingang logtype text
attr FileLog_FL_Taster_Eingang room Server
define FL_Taster_Eingang_On notify FL_Taster_Eingang:Btn1.on.* set FL_Lampe_Garderobe toggle
attr FL_Taster_Eingang_On room Flur
define FL_Taster_Eingang_Off notify FL_Taster_Eingang:Btn1.off.* set FL_Lampe_Garderobe toggle
attr FL_Taster_Eingang_Off room Flur
#########################################################################
## Doppeltaster im Flur beim Wohnzimmer
## Dieser Taster schaltet die Lampen im Flur bei der Garderobe und
## im Flur bei der kleinen Treppe
## Diese Taster arbeiten als Wechselschaltung
#########################################################################
define FL_Taster CUL_HM xxxxxx
attr FL_Taster devInfo 040000
attr FL_Taster firmware 1.2
attr FL_Taster hmClass sender
attr FL_Taster model HM-PB-4-WM
attr FL_Taster room Flur
attr FL_Taster serialNr xxxxxxxxxx
attr FL_Taster subType remote
define FileLog_FL_Taster FileLog /var/log/fhem/FL_Taster-%Y.log FL_Taster
attr FileLog_FL_Taster logtype text
attr FileLog_FL_Taster room Server
define FL_Taster_On_Links notify FL_Taster:Btn1.on.* set FL_Lampe_Treppe toggle
attr FL_Taster_On_Links room Flur
define FL_Taster_Off_Links notify FL_Taster:Btn1.off.* set FL_Lampe_Treppe toggle
attr FL_Taster_Off_Links room Flur
define FL_Taster_On_Rechts notify FL_Taster:Btn2.on.* set FL_Lampe_Garderobe toggle
attr FL_Taster_On_Rechts room Flur
define FL_Taster_Off_Rechts notify FL_Taster:Btn2.off.* set FL_Lampe_Garderobe toggle
attr FL_Taster_Off_Rechts room Flur</nowiki>

Die Jalousie soll immer morgens um 8 Uhr hoch gefahren werden, wobei aufgrund der Verkabelung am Aktor Hochfahren mit dem Status off eingeleitet wird. Das Herunterfahren soll variabel aufgrund der Untergangszeit der Sonne geschehen. Siehe [[Sunset Sunrise]].

Die früheste Zeit zum Herunterfahren ist 17:00 Uhr und spätestens um 21:00 Uhr sollen die Jalousien auf jeden Fall heruntergefahren sein. Mit den Tastern werden 2 Wechselschaltungen simuliert, wobei derzeit keine besonderen Schaltvorgänge ermöglicht werden.

[[Kategorie:Examples]]

Jalousie und Beleuchtung in mehreren Räumen

2013-11-12T18:59:30Z

Yfhem: Added ref to Sunset Sunrise. Docu here was a little out-of-date.

Dies ist die Beschreibung einer Fhem-Konfiguration, die zur Steuerung einer Hausautomation auf Basis von [[HomeMatic]] dient. Gesteuert werden in verschiedenen Räumen das '''Licht und die Jalousien'''. Die Länge dieser Beschreibung soll nicht abschreckend wirken, viele Zeilen sind Kommentare oder durch den ''autocreate'' Prozeß erzeugte Zeilen!

== Verwendete Hard- und Software ==
Als [[:Kategorie:Server Hardware|Server]] dient ein PC mit einem Athlon 64 X2 Dual Core Prozessor 6000+, 4 GB Hauptspeicher, 2 TB gespiegeltem Diskspeicher und Gigabit Ethernet. Auf dem Server ist ein Ubuntu 11.04 Serveredition installiert, die automatisch auf dem neuesten Stand gehalten wird. Perl ist in der Version 5.10.1 vorhanden. Fhem ist dabei nur eine von vielen Applikationen, die auf dem Server laufen.

Der Server kann über das Ethernet im Hausnetz auf eine [[AVM Fritz!Box|Fritzbox 7170]] zugreifen, die wiederum mittels WLAN mit einer Fritzbox 3170 verbunden ist, die als WLAN-Repeater dient. An die 3170 ist als Hauszentrale ein HomeMatic Lan [[Interface]] ([[HMLAN Konfigurator]]) angeschlossen.

Der CPU-Verbrauch hält sich sehr in Grenzen, bei einer stichprobenartigen Überwachung hat Fhem etwa 5-6 CPU Sekunden verbraucht in 24 Stunden.

[[File:Konfiguration-Ethernet.jpg|628px]]

Folgende HomeMatic Komponenten kommen zum Einsatz:

<table border="1">
<tr>
<th> Produktcode </th>
<th> Funktion </th>
<th> Anzahl
</th></tr>
<tr>
<td> HM-CFG-LAN </td>
<td> LanInterface </td>
<td> 1
</td></tr>
<tr>
<td> HM-RC-12-W </td>
<td> Funkfernbedienung 12-Tasten </td>
<td> 1
</td></tr>
<tr>
<td> HM-RC-4-B </td>
<td> Funkfernbedienung 4-Tasten </td>
<td> 1
</td></tr>
<tr>
<td> HM-PB-2-WM </td>
<td> Funk-Wandtaster 2fach </td>
<td> 3
</td></tr>
<tr>
<td> HM-PB-4-WM </td>
<td> Funk-Wandtaster 4fach </td>
<td> 2
</td></tr>
<tr>
<td> HM-LC-Sw1-FM </td>
<td> Funk-Schaltaktor 1-fach, Unterputzmontage </td>
<td> 2
</td></tr>
<tr>
<td> HM-LC-Sw2-FM </td>
<td> Funk-Schaltaktor 2-fach, Unterputzmontage </td>
<td> 3
</td></tr>
<tr>
<td> HM-LC-Bl1-FM </td>
<td> Funk-Jalousieaktor 1-fach, Unterputzmontage </td>
<td> 2
</td></tr>
<tr>
<td> HM-LC-Sw1PB-FM </td>
<td> Funk-Schaltaktor 1-fach, Unterputzmontage mit Tasteraufsatz </td>
<td> 1
</td></tr></table>

'''Namensregeln''': Alle Definitionen, die NICHT eindeutig einem Raum zuzuordnen sind, erhalten ein XX_ an den Anfang, alle anderen Definitionen erhalten eine der folgenden Kennungen:

<table border="1">
<tr>
<th> Kennung </th>
<th> Raum
</th></tr>
<tr>
<td> AK_ </td>
<td> Arbeitskeller
</td></tr>
<tr>
<td> BA_ </td>
<td> Bad
</td></tr>
<tr>
<td> BU_ </td>
<td> Büro
</td></tr>
<tr>
<td> DB </td>
<td> Dachboden
</td></tr>
<tr>
<td> FL_ </td>
<td> Flur
</td></tr>
<tr>
<td> GA_ </td>
<td> Garage
</td></tr>
<tr>
<td> KU_ </td>
<td> Küche
</td></tr>
<tr>
<td> SK_ </td>
<td> Saunakeller
</td></tr>
<tr>
<td> SZ_ </td>
<td> Schlafzimmer
</td></tr>
<tr>
<td> TG_ </td>
<td> Terasse/Garten
</td></tr>
<tr>
<td> TH_ </td>
<td> Treppenhaus
</td></tr>
<tr>
<td> VK_ </td>
<td> Vorratskeller
</td></tr>
<tr>
<td> WK_ </td>
<td> Waschkeller
</td></tr>
<tr>
<td> WZ_ </td>
<td> Wohnzimmer
</td></tr></table>

== Konfigurationsdateien ==
Alle Dateien, bis auf fhem.cfg, befinden sich in /etc/fhem. Alle Komponenten, die nicht physikalisch einem Raum zuzuordnen sind (Logs, Globales, etc.) wurden dem virtuellen Raum ''Server'' zugeordnet.

=== /etc/fhem.cfg ===
Die Datei /etc/fhem.cfg ist der Haupteinstiegspunkt für die Konfiguration. Aus Gründen der besseren Wartbarkeit beinhaltet die Datei nur include Anweisungen, mit der andere Dateien aus dieser Datei heraus aufgerufen werden. Das hat den Vorteil, dass Kommentare in den include Dateien erhalten bleiben. Dies ist (bzw. war seinerzeit) nicht der Fall für fhem.cfg, wenn man die Funktion autocreate verwendet. Attribute für die Definition ''global'' dürfen nicht aus der fhem.cfg ausgelagert werden, sie müssen Bestandteil der fhem.cfg bleiben.

<nowiki>attr global autoload_undefined_devices 1
attr global logfile /var/log/fhem/fhem-%Y-%m.log
attr global modpath /usr/share/fhem
attr global port 7072
attr global room Server
attr global statefile /var/log/fhem/fhem.save
include /etc/fhem/Web.cfg
include /etc/fhem/Autocreate.cfg
include /etc/fhem/LanInterface.cfg
include /etc/fhem/Fernbedienung.cfg
include /etc/fhem/Schlafzimmer.cfg
include /etc/fhem/Gaestezimmer.cfg
include /etc/fhem/Wohnzimmer.cfg
# include /etc/fhem/Buero.cfg
include /etc/fhem/Flur.cfg</nowiki>

=== /etc/fhem/Web.cfg ===
Alle relevanten Konfigurationsparameter für den Webzugriff sind in dieser Datei zu finden. Es sind die aus der Installation bekannten Standardwerte übernommen worden.

<nowiki>#########################################################################
## Webdefinitionen
## Zweck.........: Definitionen für den Zugriff auf den Webserver
## Standort......: Server
## Typ...........:
## Installation..: 15.09.2011
## Besonderheiten:
##
#########################################################################
define XX_WEB FHEMWEB 8083 global
attr XX_WEB fwcompress 0
attr XX_WEB room Server
define XX_WEBphone FHEMWEB 8084
attr XX_WEBphone room Server
attr XX_WEBphone smallscreen 1
define XX_WEBtablet FHEMWEB 8085
attr XX_WEBtablet room Server
attr XX_WEBtablet touchpad 1</nowiki>

=== /etc/fhem/Autocreate.cfg ===
Diese Datei enthält alle wichtigen Information zu dem Autocreate Prozess. Keine Änderung gegenüber den Standardwerten.

<nowiki>#########################################################################
## Autocreate Definitionen
## Zweck.........: Autocreate aktivieren
## Standort......: Server
## Typ...........:
## Installation..: 15.09.2011
## Besonderheiten:
##
#########################################################################
define XX_Autocreate autocreate
attr XX_Autocreate autosave 1
attr XX_Autocreate device_room %TYPE
attr XX_Autocreate filelog /var/log/fhem/%NAME-%Y.log
attr XX_Autocreate room Server
attr XX_Autocreate weblink 1
attr XX_Autocreate weblink_room Plots</nowiki>

=== /etc/fhem/LanInterface.cfg ===
Das Lan-Interface stellt das Bindeglied zwischen dem Server und den einzelnen Homematic-Komponenten dar. Es ist mit einem Ethernetnetzwerkkabel an das Netzwerk angeschlossen. Dem Lan-Interface wurde eine feste IP-Adresse vergeben, um immer auf der gleichen Adresse ansprechbar zu sein. Der Zugriff auf das Interface geschieht über Port 1000.

<nowiki>#########################################################################
## Lan Adapter
## Zweck.........: Bindeglied zwischen Server/fhem und Homematic Aktoren und Sender
## Standort......: Gästezimmer
## Typ...........:
## Installation..: 15.09.2011
## Besonderheiten: feste IP-Adresse 192.168.0.6 Port 1000
## wird an 3170 WLAN-Repeater betrieben wegen besserer Abdeckung
#########################################################################
define XX_LANInterface HMLAN 192.168.0.6:1000
attr XX_LANInterface hmId xxxxxx
attr XX_LANInterface room Gästezimmer</nowiki>

=== /etc/fhem/Fernbedienung.cfg ===
Fernbedienungen sind nicht an einen Standort gebunden und können bewegt werden, daher eine eigene Konfiguration, wenn die Fernbedienung nicht einem Zimmer ausschließlich zugeordnet ist.

<nowiki>#########################################################################
## Fernbedienungen
## Zweck.........: alle verfügbaren Sender, wenn sie nicht einem Raum
## unmittelbar zugeordnet sind
## Standort......: verschiedene
## Typ...........: verschiedene
## Installation..: 15.09.2011 12-Tasten-Fernbedienung
## Besonderheiten:
#########################################################################
#########################################################################
## 12-Tasten Fernbedienung
## Zweck.........: Rollladensteuerung, Licht im Wohnzimmer und Flur
## Scheinwerfer im Garten
## Standort......: normalerweise Wohnzimmer
## Typ...........: HM-RC-12
## Installation..: 15.09.2011 12-Tasten-Fernbedienung
## Besonderheiten: es wird nicht zwischen langem und kurzem Tasten-
## druck unterschieden
#########################################################################
define XX_FB_12_1 CUL_HM xxxxxx
attr XX_FB_12_1 devInfo 0C0000
attr XX_FB_12_1 firmware 1.1
attr XX_FB_12_1 hmClass sender
attr XX_FB_12_1 model HM-RC-12
attr XX_FB_12_1 room Wohnzimmer
attr XX_FB_12_1 serialNr xxxxxxxxxx
attr XX_FB_12_1 subType remote

#########################################################################
## linker Button Reihe 1
## Funktion......: Rollladen runter im Wohnzimmer
## Besonderheiten: ACHTUNG, on und off sind im Wohnzimmer vertauscht
## wegen der Tasten auf dem Taster an dem Aktuator
#########################################################################
define XX_FB_12_1_1_Off notify XX_FB_12_1:Btn1.off.* set WZ_Rollladen off
attr XX_FB_12_1_1_Off room Wohnzimmer
#########################################################################
## rechter Button Reihe 1
## Funktion......: Rollladen hoch im Wohnzimmer
## Besonderheiten: ACHTUNG, on und off sind im Wohnzimmer vertauscht
## wegen der Tasten auf dem Taster an dem Aktuator
#########################################################################
define XX_FB_12_1_1_On notify XX_FB_12_1:Btn1.on.* set WZ_Rollladen on
attr XX_FB_12_1_1_On room Wohnzimmer
#########################################################################
## linker Button Reihe 2
## Funktion......: Rollladen runter im Gästezimmer
## Besonderheiten: on=runter off=hoch
#########################################################################
define XX_FB_12_1_2_Off notify XX_FB_12_1:Btn2.off.* set GZ_Rollladen on
attr XX_FB_12_1_2_Off room Wohnzimmer
#########################################################################
## rechter Button Reihe 2
## Funktion......: Rollladen hoch im Gästezimmer
## Besonderheiten: on=runter off=hoch
#########################################################################
define XX_FB_12_1_2_On notify XX_FB_12_1:Btn2.on.* set GZ_Rollladen off
attr XX_FB_12_1_2_On room Wohnzimmer
#########################################################################
## linker Button Reihe 3
## Funktion......: Rollladen runter im Flur
## Besonderheiten: on=runter off=hoch
#########################################################################
define XX_FB_12_1_3_Off notify XX_FB_12_1:Btn3.off.* set FL_Rollladen on
attr XX_FB_12_1_3_Off room Wohnzimmer
#########################################################################
## rechter Button Reihe 3
## Funktion......: Rollladen hoch im Flur
## Besonderheiten: on=runter off=hoch
#########################################################################
define XX_FB_12_1_3_On notify XX_FB_12_1:Btn3.on.* set FL_Rollladen off
attr XX_FB_12_1_3_On room Wohnzimmer
#########################################################################
## linker Button Reihe 4
## Funktion......:
## Besonderheiten: derzeit nicht belegt
#########################################################################
#########################################################################
## rechter Button Reihe 4
## Funktion......:
## Besonderheiten: derzeit nicht belegt
#########################################################################
#########################################################################
## linker Button Reihe 5
## Funktion......:
## Besonderheiten: derzeit nicht belegt
#########################################################################
#########################################################################
## rechter Button Reihe 5
## Funktion......:
## Besonderheiten: derzeit nicht belegt
#########################################################################
#########################################################################
## oberer Button rechts an der Fernbedienung
## Funktion......:
## Besonderheiten: derzeit nicht belegt
#########################################################################
#########################################################################
## unterer Button rechts an der Fernbedienung
## Funktion......:
## Besonderheiten: derzeit nicht belegt
#########################################################################</nowiki>

Um eine Kommando mit einer Taste zu verknüpfen, wird die jeweilige Taste mittels notify abgefragt. Die Identifikation um welche Fernbedienung und welche Taste es sich handelt wird durch die Kennung „Name der Fernbedienung“ : und Rückgabestring“ abgehandelt.
Fhem gibt immer einen String mit den Information zurück. Dieser String enthält auch Leerzeichen. Diese Leerzeichen müssen in der Definition durch jeweils einen Punkt ersetzt werden, da Fhem sonst die ganze Befehlskette nicht richtig identifiziert. Der Stern am Ende deklariert den Rest des Rückgabestrings als nicht relevant.

Die 12-Tasten-Fernbedienung steuert derzeit die Jalousien für Gäste-, Wohnzimmer und Flur und die Tastenbelegung ist so gestaltet, dass die jeweils linke Taste in einer Reihe die Jalousie herunter fährt und die rechte Taste diese Jalousie wieder hoch fährt. Diese Fernbedienung wird global dem Raum Wohnzimmer zugeordnet, weil das der bevorzugte Platz für diese Fernbedienung sein soll.

=== /etc/fhem/Schlafzimmer.cfg ===
Im Schlafzimmer kommen hauptsächlich Schaltaktoren für Licht zur Anwendung. Eine Fernbedienung ermöglicht die Schaltungen vom Bett aus. Das Deckenlicht wird von einem Taster an der Tür oder von einer Fernbedienung geschaltet. Im Schlafzimmer sind 2 Unterputzaktoren 1fach, 1 Unterputzaktor 2fach, 1 Taster 2fach und eine 4-Tasten-Fernbedienung installiert.

<nowiki>#########################################################################
## Schlafzimmer
## Zweck.........: Alle Homematic Komponenten im Schlafzimmer
## Standort......: Schlafzimmer
## Typ...........: verschiedene
## Installation..: 15.09.2011
## Besonderheiten:
##
#########################################################################
#########################################################################
## Aktor für die senkrechten Deckenstrahler
#########################################################################
define SZ_Lampe_Decke CUL_HM xxxxxx
attr SZ_Lampe_Decke devInfo 010100
attr SZ_Lampe_Decke firmware 1.9
attr SZ_Lampe_Decke hmClass receiver
attr SZ_Lampe_Decke model HM-LC-SW1-FM
attr SZ_Lampe_Decke room Schlafzimmer
attr SZ_Lampe_Decke serialNr xxxxxxxxxx
attr SZ_Lampe_Decke subType switch
#########################################################################
## Aktor für die Strahler an den Bettseiten
## und für die Deckenlampen in der Schräge
#########################################################################
define SZ_Lampen_Seite CUL_HM xxxxxx
attr SZ_Lampen_Seite devInfo 010100
attr SZ_Lampen_Seite firmware 1.9
attr SZ_Lampen_Seite hmClass receiver
attr SZ_Lampen_Seite model HM-LC-SW1-FM
attr SZ_Lampen_Seite room Schlafzimmer
attr SZ_Lampen_Seite serialNr xxxxxxxxxx
attr SZ_Lampen_Seite subType switch

#########################################################################
## Aktor für die Strahler über dem Bett links
## Besonderheit: Dies ist ein 2-Fach Schaltaktor
## anderer Port wird für Bett rechts benutzt
#########################################################################
define SZ_Lampe_Bett_links CUL_HM xxxxxx
attr SZ_Lampe_Bett_links devInfo 020100
attr SZ_Lampe_Bett_links firmware 1.9
attr SZ_Lampe_Bett_links hmClass receiver
attr SZ_Lampe_Bett_links model HM-LC-SW2-FM
attr SZ_Lampe_Bett_links room Schlafzimmer
attr SZ_Lampe_Bett_links serialNr xxxxxxxxxx
attr SZ_Lampe_Bett_links subType switch
#########################################################################
## Aktor für die Strahler über dem Bett rechts
## Besonderheit: Dies ist ein 2-Fach Schaltaktor
## anderer Port wird für Bett links benutzt
#########################################################################
define SZ_Lampe_Bett_rechts CUL_HM xxxxxx
attr SZ_Lampe_Bett_rechts devInfo 020100
attr SZ_Lampe_Bett_rechts firmware 1.9
attr SZ_Lampe_Bett_rechts hmClass receiver
attr SZ_Lampe_Bett_rechts model HM-LC-SW2-FM
attr SZ_Lampe_Bett_rechts room Schlafzimmer
attr SZ_Lampe_Bett_rechts serialNr xxxxxxxxxx
attr SZ_Lampe_Bett_rechts subType switch
#########################################################################
## Sender an der Tür
## schaltet Decken- und Seitenlampen ein oder aus
## bei einem langen Tastendruck (onLong) werden alle Deckenlampen und
## die Lampen an der Seite eingeschaltet, bei einem kurzen Tastendruck
## werden nur die Hälfte der Lampen an der Decke angeschaltet
#########################################################################
define SZ_Taster_Tuer CUL_HM xxxxxx
attr SZ_Taster_Tuer devInfo 020000
attr SZ_Taster_Tuer firmware 1.2
attr SZ_Taster_Tuer hmClass sender
attr SZ_Taster_Tuer model HM-PB-2-WM
attr SZ_Taster_Tuer room Schlafzimmer
attr SZ_Taster_Tuer serialNr xxxxxxxxxx
attr SZ_Taster_Tuer subType remote
define SZ_Taster_Tuer_On_Alles notify SZ_Taster_Tuer:Btn1.onLong.* set SZ_Lampe_Decke,SZ_Lampen_Seite on
attr SZ_Taster_Tuer_On_Alles room Schlafzimmer
define SZ_Taster_Tuer_On_Decke notify SZ_Taster_Tuer:Btn1.on.* set SZ_Lampe_Decke on
attr SZ_Taster_Tuer_On_Decke room Schlafzimmer
define SZ_Taster_Tuer_Off notify SZ_Taster_Tuer:Btn1.off.* set SZ_Lampe_Decke,SZ_Lampen_Seite off
attr SZ_Taster_Tuer_Off room Schlafzimmer
#########################################################################
## 4-Tastenfernbedienung
## Zweck.........: Lichtschaltungen im Schlafzimmer vom Bett aus
## Standort......: Schlafzimmer
## Typ...........: HM-RC-4
## Installation..: 23.09.2011
## Besonderheiten: arbeitet mit toggle
#########################################################################
define SZ_Fernbedienung_4_1 CUL_HM xxxxxx
attr SZ_Fernbedienung_4_1 devInfo 040000
attr SZ_Fernbedienung_4_1 firmware 1.3
attr SZ_Fernbedienung_4_1 hmClass sender
attr SZ_Fernbedienung_4_1 model HM-RC-4-B
attr SZ_Fernbedienung_4_1 room Schlafzimmer
attr SZ_Fernbedienung_4_1 serialNr xxxxxxxxxx
attr SZ_Fernbedienung_4_1 subType remote
#########################################################################
## linker Button Reihe 1
## Funktion......: Licht links am Bett ein-/ausschalten
## Besonderheiten:
#########################################################################
define SZ_FB_Btn1_off notify SZ_Fernbedienung_4_1:Btn1.off.* set SZ_Lampe_Bett_links toggle
attr SZ_FB_Btn1_off room Schlafzimmer

#########################################################################
## rechter Button Reihe 1
## Funktion......: Licht rechts am Bett ein-/ausschalten
## Besonderheiten:
#########################################################################
define SZ_FB_Btn1_on notify SZ_Fernbedienung_4_1:Btn1.on.* set SZ_Lampe_Bett_rechts toggle
attr SZ_FB_Btn1_on room Schlafzimmer
#########################################################################
## linker Button Reihe 2
## Funktion......: Deckenlampen schalten
## Besonderheiten:
#########################################################################
define SZ_FB_Btn2_off notify SZ_Fernbedienung_4_1:Btn2.off.* set SZ_Lampe_Decke toggle
attr SZ_FB_Btn2_off room Schlafzimmer
#########################################################################
## rechter Button Reihe 2
## Funktion......: Seitenlampen schalten
## Besonderheiten:
#########################################################################
define SZ_FB_Btn2_on notify SZ_Fernbedienung_4_1:Btn2.on.* set SZ_Lampen_Seite toggle
attr SZ_FB_Btn2_on room Schlafzimmer
#########################################################################
## Alternative! Um SZ_Lampe_Decke und SZ_Lampen_Seite mit einem
## Tastendruck zu schalten
## Durch dieses Notify wird zuerst SZ_Lampe_Decke eingeschaltet, dann
## beim nächsten Tastendruck wird SZ_Lampen_Seite dazugeschaltet und
## dann beim dritten Tastendruck werden beide wieder ausgeschaltet
## Bei Aktivierung vorher SZ_FB_Btnx.on/off deaktivieren!!!
#########################################################################
#define MyNotify notify Fernbedienung:Btn2.on.* {if(Value("SZ_Lampe_Decke") == "on" && Value("SZ_Lampen_Seite") == "on") {fhem "set SZ_Lampe_Decke,SZ_Lampen_Seite off"} elsif(Value("SZ_Lampe_Decke") == "on" && Value("SZ_Lampen_Seite") == "off") {fhem "set SZ_Lampen_Seite on"} else{fhem "set SZ_Lampe_Decke on"}}</nowiki>
Der Taster an der Tür soll nur Licht ein- und ausschalten, daher wurde auf eine Unterscheidung zwischen einem langen und einem kurzen Tastendruck verzichtet. Da zwei verschiedene Lichtquellen zu schalten sind, müssen bei dem set Kommando beide Quellen jeweils angegeben werden. Es dürfen keine Leerzeichen in der Liste der Aktoren sein und die Aktoren müssen per Komma getrennt werden. (Achtung: "else if" muss in Perl als "elsif" geschrieben werden.)

=== /etc/fhem/Gaestezimmer.cfg ===
Im Gästezimmer wird derzeit nur die Jalousie gesteuert. Hier ist nur ein Unterputzjalousieaktor installiert.

<nowiki>#########################################################################
## Gästezimmer
## Zweck.........: Alle Homematic Komponenten im Gästezimmer
## Standort......: Gästezimmer
## Typ...........: verschiedene
## Installation..: 15.09.2011
## Besonderheiten:
##
#########################################################################
#########################################################################
## Aktor für die Rollladen
#########################################################################
define GZ_Rollladen CUL_HM xxxxx
attr GZ_Rollladen devInfo 010100
attr GZ_Rollladen firmware 1.5
attr GZ_Rollladen hmClass receiver
attr GZ_Rollladen model HM-LC-BL1-FM
attr GZ_Rollladen room Gästezimmer
attr GZ_Rollladen serialNr xxxxxxxxxx
attr GZ_Rollladen subType blindActuator
attr GZ_Rollladen eventMap on:zu off:offen
#########################################################################
## eigenes Log
#########################################################################
define GZ_Rollladen_FileLog FileLog /var/log/fhem/GZ_Rollladen-%Y.log GZ_Rollladen
attr GZ_Rollladen_FileLog logtype text
attr GZ_Rollladen_FileLog room Server
#########################################################################
## Rollladen soll fix um 08:00h jeden Tag hochfahren
#########################################################################
define GZ_Rollladen_hoch at *08:00 set GZ_Rollladen offen
attr GZ_Rollladen_hoch room Gästezimmer
#########################################################################
## Rollladen soll variabel je nach Sonnenuntergang, aber
## nicht vor 17:00h und nicht nach 21:00h jeden Tag runterfahren
#########################################################################
define GZ_Rollladen_runter at *{sunset(0,"17:00","21:00")} set GZ_Rollladen zu
attr GZ_Rollladen_runter room Gästezimmer</nowiki>

Die Jalousie soll immer morgens um 8 Uhr hoch gefahren werden, wobei aufgrund der Verkabelung am Aktor Hochfahren mit dem Status off eingeleitet wird. Das Herunterfahren soll variabel aufgrund der Untergangszeit der Sonne geschehen. Dabei ist die geografische Koordinate in der Datei /usr/share/fhem/FHEM/99_SUNRISE_EL.pm einzutragen. Koordinaten lassen sich durch Tools für GoogleMap ermitteln. Die früheste Zeit zum Herunterfahren ist 17:00 Uhr und spätestens um 21:00 Uhr sollen die Jalousien auf jeden Fall heruntergefahren sein. Dies wird auf alle Jalousien angewendet. Zur besseren Lesbarkeit der Anzeige wurde der Status der Rollade durch Setzen des Attributes EventMap umbenannt. Wenn der Aktor den Status ''on'' meldet, dann wird ''zu'' angezeigt und alternativ bei ''off'' dann ''offen''.

=== /etc/fhem/Wohnzimmer.cfg ===
Im Wohnzimmer wird derzeit eine Jalousie und die Beleuchtung gesteuert. Installiert sind: ein Jalousieaktor mit Tasteraufsatz, zwei 4fach-Taster, ein Unterputzdoppelaktor.

<nowiki>#########################################################################
## Wohnzimmer
## Zweck.........: Alle Homematic Komponenten im Wohnzimmer
## Standort......: Wohnzimmer
## Typ...........: verschiedene
## Installation..: 15.09.2011
## Besonderheiten: ACHTUNG, on und off bei der Rollladensteuerung
## ist im Wohnzimmer vertauscht on=rauf off=runter
#########################################################################
#########################################################################
## Aktor für die Rollladen
#########################################################################
define WZ_Rollladen CUL_HM xxxxxx
attr WZ_Rollladen devInfo 010100
attr WZ_Rollladen firmware 1.6
attr WZ_Rollladen hmClass receiver
attr WZ_Rollladen model HM-LC-BL1-PB-FM
attr WZ_Rollladen room Wohnzimmer
attr WZ_Rollladen serialNr xxxxxxxxxx
attr WZ_Rollladen subType blindActuator
attr WZ_Rollladen eventMap on:offen off:zu
#########################################################################
## eigenes Log
#########################################################################
define WZ_Rollladen_FileLog FileLog /var/log/fhem/WZ_Rollladen-%Y.log WZ_Rollladen
attr WZ_Rollladen_FileLog logtype text
attr WZ_Rollladen_FileLog room Server
#########################################################################
## Rollladen soll fix um 08:00h jeden Tag hochfahren
#########################################################################
define WZ_Rollladen_hoch at *08:00 set WZ_Rollladen offen
attr WZ_Rollladen_hoch room Wohnzimmer
#########################################################################
## Rollladen soll variabel je nach Sonnenuntergang, aber
## nicht vor 17:00h und nicht nach 21:00h jeden Tag runterfahren
#########################################################################
define WZ_Rollladen_runter at *{sunset(0,"17:00","21:00")} set WZ_Rollladen zu
attr WZ_Rollladen_runter room Wohnzimmer
#########################################################################
## Aktor für die Lampen auf der Schrankseite des Wohnzimmers
## dies ist ein gemeinsamer Aktor mit WZ_Lampe_Couch
#########################################################################
define WZ_Lampe_Schrank CUL_HM xxxxxx
attr WZ_Lampe_Schrank devInfo 020100
attr WZ_Lampe_Schrank firmware 1.9
attr WZ_Lampe_Schrank hmClass receiver
attr WZ_Lampe_Schrank model HM-LC-SW2-FM
attr WZ_Lampe_Schrank room Wohnzimmer
attr WZ_Lampe_Schrank serialNr xxxxxxxxxx
attr WZ_Lampe_Schrank subType switch
define FileLog_WZ_Lampe_Schrank FileLog /var/log/fhem/WZ_Lampe_Schrank-%Y.log WZ_Lampe_Schrank
attr FileLog_WZ_Lampe_Schrank logtype text
attr FileLog_WZ_Lampe_Schrank room Server
#########################################################################
## Aktor für die Lampen auf der Couchseite des Wohnzimmers
## dies ist ein gemeinsamer Aktor mit WZ_Lampe_Schrank
#########################################################################
define WZ_Lampe_Couch CUL_HM xxxxxx
attr WZ_Lampe_Couch devInfo 020100
attr WZ_Lampe_Couch firmware 1.9
attr WZ_Lampe_Couch hmClass receiver
attr WZ_Lampe_Couch model HM-LC-SW2-FM
attr WZ_Lampe_Couch room Wohnzimmer
attr WZ_Lampe_Couch serialNr xxxxxxxxxxx
attr WZ_Lampe_Couch subType switch
define FileLog_WZ_Lampe_Couch FileLog /var/log/fhem/WZ_Lampe_Couch-%Y.log WZ_Lampe_Couch
attr FileLog_WZ_Lampe_Couch logtype text
attr FileLog_WZ_Lampe_Couch room Server
#########################################################################
## Doppeltaster im Wohnzimmer beim Flur
## Dieser Taster schaltet die Lampen im Wohnzimmer bei dem Schrank
## und bei der Couch
#########################################################################
define WZ_Taster CUL_HM xxxxxx
attr WZ_Taster devInfo 040000
attr WZ_Taster firmware 1.2
attr WZ_Taster hmClass sender
attr WZ_Taster model HM-PB-4-WM
attr WZ_Taster room Wohnzimmer
attr WZ_Taster serialNr xxxxxxxxxxx
attr WZ_Taster subType remote
define FileLog_WZ_Taster FileLog /var/log/fhem/WZ_Taster-%Y.log WZ_Taster
attr FileLog_WZ_Taster logtype text
attr FileLog_WZ_Taster room Server
define WZ_Taster_On_Links notify WZ_Taster:Btn1.on.* set WZ_Lampe_Schrank toggle
attr WZ_Taster_On_Links room Wohnzimmer
define WZ_Taster_Off_Links notify WZ_Taster:Btn1.off.* set WZ_Lampe_Schrank toggle
attr WZ_Taster_Off_Links room Wohnzimmer
define WZ_Taster_On_Rechts notify WZ_Taster:Btn2.on.* set WZ_Lampe_Couch toggle
attr WZ_Taster_On_Rechts room Wohnzimmer
define WZ_Taster_Off_Rechts notify WZ_Taster:Btn2.off.* set WZ_Lampe_Couch toggle
attr WZ_Taster_Off_Rechts room Wohnzimmer</nowiki>

Die Jalousie soll immer morgens um acht Uhr hochgefahren werden, wobei aufgrund der Verkabelung am Aktor Hochfahren mit dem Status on eingeleitet wird. Dies ist anders als im Gästezimmer oder Flur! Das Herunterfahren soll variabel aufgrund der Untergangszeit der Sonne geschehen. Dabei ist die geografische Koordinate in der Datei /usr/share/fhem/FHEM/99_SUNRISE_EL.pm einzutragen. Koordinaten lassen sich durch Tools für GoogleMap ermitteln.

Die früheste Zeit zum Herunterfahren ist 17:00 Uhr und spätestens um 21:00 Uhr sollen die Jalousien auf jeden Fall heruntergefahren sein. Die Taster schalten egal bei welchem Tastendruck das Licht an oder aus.

=== /etc/fhem/Flur.cfg ===
Im Flur werden derzeit eine Jalousie und die Beleuchtung gesteuert. Installiert sind ein Unterputzjalousieaktor, ein 4fach Taster, zwei 2fach Taster, ein Unterputzdoppelaktor. Dadurch wurde eine Wechselschaltung simuliert.

<nowiki>#########################################################################
## Flur
## Zweck.........: Alle Homematic Komponenten im Flur
## Standort......: Flur
## Typ...........: verschiedene
## Installation..: 15.09.2011
## Besonderheiten:
##
#########################################################################
#########################################################################
## Aktor für die Rollladen
#########################################################################
define FL_Rollladen CUL_HM xxxxxx
attr FL_Rollladen devInfo 010100
attr FL_Rollladen firmware 1.5
attr FL_Rollladen hmClass receiver
attr FL_Rollladen model HM-LC-BL1-FM
attr FL_Rollladen room Flur
attr FL_Rollladen serialNr xxxxxxxxxx
attr FL_Rollladen subType blindActuator
attr FL_Rollladen eventMap on:zu off:offen
#########################################################################
## eigenes Log
#########################################################################
define FL_Rollladen_FileLog FileLog /var/log/fhem/FL_Rollladen-%Y.log FL_Rollladen
attr FL_Rollladen_FileLog logtype text
attr FL_Rollladen_FileLog room Server
#########################################################################
## Rollladen soll fix um 08:00h jeden Tag hochfahren
#########################################################################
define FL_Rollladen_hoch at *08:00 set FL_Rollladen offen
attr FL_Rollladen_hoch room Flur
#########################################################################
## Rollladen soll variabel je nach Sonnenuntergang, aber
## nicht vor 17:00h und nicht nach 21:00h jeden Tag runterfahren
#########################################################################
define FL_Rollladen_runter at *{sunset(0,"17:00","21:00")} set FL_Rollladen zu
attr FL_Rollladen_runter room Flur
#########################################################################
## Aktor für die Lampen im FLur bei der Garderobe
## Dies ist ein gemeinsamer Aktor mit FL_Lampe_Treppe
#########################################################################
define FL_Lampe_Garderobe CUL_HM xxxxxx
attr FL_Lampe_Garderobe devInfo 020100
attr FL_Lampe_Garderobe firmware 1.9
attr FL_Lampe_Garderobe hmClass receiver
attr FL_Lampe_Garderobe model HM-LC-SW2-FM
attr FL_Lampe_Garderobe room Flur
attr FL_Lampe_Garderobe serialNr xxxxxxxxxx
attr FL_Lampe_Garderobe subType switch
define FileLog_FL_Lampe_Garderobe FileLog /var/log/fhem/FL_Lampe_Garderobe-%Y.log FL_Lampe_Garderobe
attr FileLog_FL_Lampe_Garderobe logtype text
attr FileLog_FL_Lampe_Garderobe room Server
#########################################################################
## Aktor für die Lampen im FLur bei der kleinen Treppe
## Dies ist ein gemeinsamer Aktor mit FL_Lampe_Garderobe
#########################################################################
define FL_Lampe_Treppe CUL_HM xxxxxx
attr FL_Lampe_Treppe devInfo 020100
attr FL_Lampe_Treppe firmware 1.9
attr FL_Lampe_Treppe hmClass receiver
attr FL_Lampe_Treppe model HM-LC-SW2-FM
attr FL_Lampe_Treppe room Flur
attr FL_Lampe_Treppe serialNr xxxxxxxxxx
attr FL_Lampe_Treppe subType switch
define FileLog_FL_Lampe_Treppe FileLog /var/log/fhem/FL_Lampe_Treppe-%Y.log FL_Lampe_Treppe
attr FileLog_FL_Lampe_Treppe logtype text
attr FileLog_FL_Lampe_Treppe room Server
#########################################################################
## Taster im Flur beim Eingang Badezimmer
## Dieser Taster schaltet die Lampen im Flur bei der kleinen Treppe
## arbeitet im Wechsel mit FL_Taster
#########################################################################
define FL_Taster_Bad CUL_HM xxxxxx
attr FL_Taster_Bad devInfo 020000
attr FL_Taster_Bad firmware 1.2
attr FL_Taster_Bad hmClass sender
attr FL_Taster_Bad model HM-PB-2-WM
attr FL_Taster_Bad room Flur
attr FL_Taster_Bad serialNr xxxxxxxxxx
attr FL_Taster_Bad subType remote
define FileLog_FL_Taster_Bad FileLog /var/log/fhem/FL_Taster_Bad-%Y.log FL_Taster_Bad
attr FileLog_FL_Taster_Bad logtype text
attr FileLog_FL_Taster_Bad room Server
define FL_Taster_Bad_On notify FL_Taster_Bad:Btn1.on.* set FL_Lampe_Treppe toggle
attr FL_Taster_Bad_On room Flur
define FL_Taster_Bad_Off notify FL_Taster_Bad:Btn1.off.* set FL_Lampe_Treppe toggle
attr FL_Taster_Bad_Off room Flur
#########################################################################
## Taster im Flur beim Wohnungseingang
## Dieser Taster schaltet die Lampen im Flur bei der Garderobe
## arbeitet im Wechsel mit FL_Taster
#########################################################################
define FL_Taster_Eingang CUL_HM xxxxxx
attr FL_Taster_Eingang devInfo 020000
attr FL_Taster_Eingang firmware 1.2
attr FL_Taster_Eingang hmClass sender
attr FL_Taster_Eingang model HM-PB-2-WM
attr FL_Taster_Eingang room Flur
attr FL_Taster_Eingang serialNr xxxxxxxxxx
attr FL_Taster_Eingang subType remote
define FileLog_FL_Taster_Eingang FileLog /var/log/fhem/FL_Taster_Eingang-%Y.log FL_Taster_Eingang
attr FileLog_FL_Taster_Eingang logtype text
attr FileLog_FL_Taster_Eingang room Server
define FL_Taster_Eingang_On notify FL_Taster_Eingang:Btn1.on.* set FL_Lampe_Garderobe toggle
attr FL_Taster_Eingang_On room Flur
define FL_Taster_Eingang_Off notify FL_Taster_Eingang:Btn1.off.* set FL_Lampe_Garderobe toggle
attr FL_Taster_Eingang_Off room Flur
#########################################################################
## Doppeltaster im Flur beim Wohnzimmer
## Dieser Taster schaltet die Lampen im Flur bei der Garderobe und
## im Flur bei der kleinen Treppe
## Diese Taster arbeiten als Wechselschaltung
#########################################################################
define FL_Taster CUL_HM xxxxxx
attr FL_Taster devInfo 040000
attr FL_Taster firmware 1.2
attr FL_Taster hmClass sender
attr FL_Taster model HM-PB-4-WM
attr FL_Taster room Flur
attr FL_Taster serialNr xxxxxxxxxx
attr FL_Taster subType remote
define FileLog_FL_Taster FileLog /var/log/fhem/FL_Taster-%Y.log FL_Taster
attr FileLog_FL_Taster logtype text
attr FileLog_FL_Taster room Server
define FL_Taster_On_Links notify FL_Taster:Btn1.on.* set FL_Lampe_Treppe toggle
attr FL_Taster_On_Links room Flur
define FL_Taster_Off_Links notify FL_Taster:Btn1.off.* set FL_Lampe_Treppe toggle
attr FL_Taster_Off_Links room Flur
define FL_Taster_On_Rechts notify FL_Taster:Btn2.on.* set FL_Lampe_Garderobe toggle
attr FL_Taster_On_Rechts room Flur
define FL_Taster_Off_Rechts notify FL_Taster:Btn2.off.* set FL_Lampe_Garderobe toggle
attr FL_Taster_Off_Rechts room Flur</nowiki>

Die Jalousie soll immer morgens um 8 Uhr hoch gefahren werden, wobei aufgrund der Verkabelung am Aktor Hochfahren mit dem Status off eingeleitet wird. Das Herunterfahren soll variabel aufgrund der Untergangszeit der Sonne geschehen. Siehe [[Sunset Sunrise]].

Die früheste Zeit zum Herunterfahren ist 17:00 Uhr und spätestens um 21:00 Uhr sollen die Jalousien auf jeden Fall heruntergefahren sein. Mit den Tastern werden 2 Wechselschaltungen simuliert, wobei derzeit keine besonderen Schaltvorgänge ermöglicht werden.

[[Kategorie:Examples]]

MAX

2013-11-10T21:52:38Z

Yfhem: Added to Kategorie:Heizungsventile.

MAX! ist eine Heizungssteuerung, die die Raumtemperatur durch funkvernetzte Heizkörperthermostate an den Heizkörpern regelt. MAX! stellt eine Alternative zur FHT und HomeMatic Heizungsteuerung dar.
== Features ==
* Bidirektionale Kommuniktion (jeder Befehl wird mit ACK quittiert)
* Heizkörperthermostate übertragen auch die gemessene Temperatur
== FHEM Module ==
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
bereitgestellt.

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.

== Komponenten ==
=== Limit ===
* Auf 8 Thermostate pro Raum beschränkt
* Limit mit Cube liegt bei ca. 140 Geräten. Durch die [[1% Regel]]ung dürften es aber in der Praxis weniger sein

=== Heizkörperthermostate ===
Unterstützt wird das Einstellen von

* desiredTemperature = auto (Wochenprogramm), manuell (4.5 - 30.5), eco, comfort, boost, until
** (Besonderheit der Werte: 4.5 = Off und 30.5 = On)
* ecoTemperature, comfortTemperature, measurementOffset, maximumTemperature, minimumTemperature, windowOpenTemperature, windowOpenDuration

und das Auslesen

* der gemessenen Temperatur. (Hinweis: Wird bei Verwendung des MAX CUBE nicht regelmäßig aktualisiert)
=== Fensterkontakte ===
Der aktuelle Status (offen/geschlossen) wird (praktisch ohne Verzögerung) angezeigt. '''[[Nur bei CUL, oder?]]'''

Falls wir nicht mit Ack antworten, wird er mehrmals wiederholt.

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.

Wenn der Fensterkontakt an mindestens ein Heizkörperthermostat angelernt ist, dann sendet er zusätzlich stündlich seinen aktuellen Zustand.

'''Beispiel Autocreate'''
MAXLAN_Parse: Paired new device, type ShutterContact, addr 1a2b3c, serial JEQ0123456
autocreate: define MAX_1a2b3c MAX ShutterContact 1a2b3c
autocreate: define FileLog_MAX_1a2b3c FileLog /fhem/log/MAX_1a2b3c-%Y.log MAX_1a2b3c

'''Beispiel Definition'''
define MAX_1a2b3c MAX ShutterContact 1a2b3c

'''Beispiel Log'''
==> MAX_1a2b3c-2013.log <==
2013-10-20_18:52:08 MAX_1a2b3c battery: ok
2013-10-20_18:52:08 MAX_1a2b3c onoff: 0
2013-10-20_18:52:08 MAX_1a2b3c closed

=== Wandthermostate ===
Unterstützt wird das Einstellen von

* desiredTemperature (siehe Heizkörperthermostate), ecoTemperature, comfortTemperature

und das Auslesen

* der gemessenen Temperatur.
=== Eco-Taster ===
'''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.

==== Beispielhafte Definition ====
define BUTTON.EG MAX PushButton 069d33

==== Beispielhafte Event-Ausgabe ====

2013-07-02 21:06:14 MAX BUTTON.EG battery: ok
2013-07-02 21:06:14 MAX BUTTON.EG onoff: 0
2013-07-02 21:06:14 MAX BUTTON.EG closed

Wobei gilt
{| class="wikitable"
|-
! onoff !! Bedeutung
|-
| 0 || Eco
|-
| 1 || Auto
|}

== Anlernen per CUL ==
Das Anlernen funktioniert nur mit zurückgesetzen (Werksreset, also entweder alle 3 Tasten am Heizkörperthermostate 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.
Info: Durch den Reset geht auch ein evtl. per Cube eingestelltes Automatikprogramm verloren.

== Konfiguration ==
Siehe [http://fhem.de/commandref.html#CUL_MAX CUL_MAX].

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.

=== MAXLAN ===
Minimale Konfiguration:

<nowiki>define ml MAXLAN 192.168.178.2</nowiki>
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.

=== CUL_MAX ===
Minimale Konfiguration:

<nowiki>define CUL0 CUL /dev/ttyACM0@9600 0000
attr CUL0 rfmode MAX
define cm CUL_MAX 123456</nowiki>
=== Anlernen ===
Dazu muss der "pairmode" auf MAXLAN/CUL_MAX per

<nowiki>set cm/ml pairmode</nowiki>
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.

=== Geräte untereinander anlernen ===
Es gibt einen anderen Befehl, um Devices untereinander anzulernen (in neueren Versionen des MAX Moduls enthalten, heißt "associate").

Wenn ich z.B.
set MAXFensterKontakt0 associate MaxHeizkörperthermostat3
ausführe, dann
sendet der MAXFensterKontakt0 jede Änderung zusätzlich (direkt über Funk, ohne Cube oder FHEM)
an das MaxHeizkörperthermostat3.

Damit MaxHeizkörperthermostat3 auch auf die Nachrichten vom MAXFensterKontakt0 hört, muss noch ein
set MaxHeizkörperthermostat3 associate MAXFensterKontakt0
erfolgen.

Dann wechselt MaxHeizkörperthermostat3 immer dann auf die windowOpenTemperature, wenn der MAXFensterKontakt0 offen ist.
Dabei muss die groupId von beiden Geräte gar nicht gleich sein! (Die Semantik der groupId erschließt sich mir deshalb noch nicht ganz.
Ich glaube, man kann damit Befehle (ala set desiredTemperature) an mehrere Thermostate gleichzeitig richten. Im Moment sendet FHEM einfach an jedes Thermostat einen Befehl.)

Wahrscheinlich funktioniert associate genauso zwischen Heizkörper/Wandthermostaten. Das müsste mal eine ausprobieren und dann hier berichten.

=== Temperatursturzerkennung ===
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" festgelegt Temperatur herunter und danach wieder auf die zuvor eingestellte Temperatur zurück.
Nachteil: Die Erkennung benötigt etwas Zeit und reagiert nicht sofort wie es beim Fensterkontakt oben der Fall ist
Vorteil: Es ist kein Fensterkontakt erforderlich

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

=== Externer Sensor für Fenster-offen-Erkennung ===
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:

<nowiki>define CUL0 CUL /dev/ttyACM0@9600 0000
define cm CUL_MAX 123456
define Heizung MAX HeatingThermostat abcdef
attr Heizung IODev cm</nowiki>
Wir müssen einmalig den internen Fake-Fensterkontakt mit dem Heizkörper assozieren

<nowiki>set Heizung associate fakeShutterContact</nowiki>
damit dieser die Nachrichten vom Fensterkontakt akzeptiert.

Nun können wir per

<nowiki>set cm fakeSC Heizung 1</nowiki>
die Nachricht "Fenster offen" an die Heizung senden und per

<nowiki>set cm fakeSC Heizung 0</nowiki>
die Nachricht "Fenster zu".

=== Externer Temperatursensor für Heizkörperregelung ===
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:

<nowiki>define CUL0 CUL /dev/ttyACM0@9600 0000
define cm CUL_MAX 123456
define Heizung MAX HeatingThermostat abcdef
attr Heizung IODev cm</nowiki>
Wir müssen einmalig das interne Fake-Wandthermostat mit dem Heizkörper assozieren:

<nowiki>set Heizung associate fakeWallThermostat</nowiki>
damit dieser die Nachrichten vom Wandthermostat akzeptiert. Achtung: Dies schaltet im
Heizkörperthermostat die Regelung mit dem internen Temperaturfühler aus. Ohne die gleich kommenden "fakeWT" Nachrichten wird das Heizkörperthermostat nicht mehr regeln.

Nun können wir per

<nowiki>set cm fakeWT Heizung 14.5 12.1</nowiki>
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.

Falls man zu lange Zeit (ca. 30 Minuten) kein neues "fakeWT" sendet, wird bei Heizung das Attribut rferror gleich 1. Es ist nicht klar, ob das neben diesem Attribute auch Auswirkung auf die Funktionalität hat. Es wurde beobachtet, das dann der interne Temperatursensor bis zum nächsten FakeWT aktiviert wird.

Beispiel eines automatischen Sendens einer externen Temperatur, der externe Temperatursensor heißt "WS300":

<nowiki>define SendExtTemp notify WS300:temperature.* {
MaxFakeWallThermostat("Heizung", %EVTPART1);
}</nowiki>
Dazu die Funktion, bitte in 99_MyUtils.pm eintragen:

<nowiki>sub MaxFakeWallThermostat($$)
{
my ($heizung, $aktTemp) = @_;
my $CULMAX = $defs{$heizung}{LASTInputDev};
my $desiredTemp = ReadingsVal($heizung, "desiredTemperature", undef);
my $windowOpenTemp = ReadingsVal($heizung, "windowOpenTemperature", undef);
my $lastTemp = ReadingsVal($heizung, "LastExtTemperature", 0);
my $lastSet = ReadingsTimestamp($heizung, "LastExtTemperature", 0);
if($desiredTemp && $windowOpenTemp &&
$desiredTemp != $windowOpenTemp &&
(time()-time_str2num($lastSet) >= 600 || abs($aktTemp-$lastTemp)>=0.2 )) {
Log 3, "set $CULMAX fakeWT $heizung $desiredTemp $aktTemp";
readingsSingleUpdate($defs{$heizung}, "LastExtTemperature", $aktTemp, 0);
fhem("set $CULMAX fakeWT $heizung $desiredTemp $aktTemp");
}
}</nowiki>
In diesem Beispiel heißt das zu steuernde Thermostat "Heizung". Die vom externen Sensor gemessene Temperatur wird nur unter den folgenden Voraussetzungen gesendet:
- Das Thermostat befindet sich nicht im "Fenster-offen" Modus, und
- das letzte Senden liegt mindestens 10min zurück
- oder die gemessene Temperatur weicht um mindestens 0.2°C von der letzten gesendeten Temperatur ab

=== Wochenheizplan für Wandthermostat erstellen ===
Ein Heizplan, den der Wandthermostat versteht und speichern kann, sieht folgendermaßen aus:

<nowiki>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</nowiki>
Genauer erläutert wird die Funktionsweise auch unter [http://fhem.de/commandref.html#MAX http://fhem.de/commandref.html#MAX].
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.

=== Werte Plotten ===
[[File:Plot_MAX_Beispiel.png|thumb|right|Plot eines MAX Heizkörperthermostates]]
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.)

Inhalt der LOG-Datei eines Heizkörperthermostates:

<nowiki>2012-12-30_08:55:31 MAX_018d3f battery: ok
2012-12-30_08:55:31 MAX_018d3f desiredTemperature: 19.5
2012-12-30_08:55:31 MAX_018d3f valveposition: 83
2012-12-30_08:55:31 MAX_018d3f temperature: 16.4</nowiki>

Mit folgender Plot-Datei (max_temp.gplot) kann der Verlauf der Sensordaten gut angezeigt werden.

<nowiki>set terminal png transparent size <SIZE> crop
set output '<OUT>.png'
set xdata time
set timefmt "%Y-%m-%d_%H:%M:%S"
set xlabel " "
set y2tics
set title '<L1>'
set grid xtics y2tics
set y2label "Temperatur in Grad Celsius"
set ylabel "Signal in %"
#FileLog 4:desiredTemperature:0:
#FileLog 4:temperature:0:
#FileLog 4:valveposition:0:
plot \
"< egrep 'desiredTemperature' <IN>"\
using 1:4 axes x1y2 title 'Soll-Temperatur (C)' with lines lw 2 \
"< egrep 'temperature' <IN>"\
using 1:4 axes x1y2 title 'Ist-Temperatur(ungenau)(C)' with lines lw 2 \
"< egrep 'valveposition' <IN>"\
using 1:4 axes x1y1 title 'Ventil (%)' with lines lw 2</nowiki>
Einbinden eines Plots in der fhem.cgf

<nowiki>#Werte plotten
define MAX_017840_weblink weblink fileplot FileLog_MAX_017840:max_temp:CURRENT
attr MAX_017840_weblink label "Kueche Soll-Temperatur Min $data{min1}, Max $data{max1}, Last $data{currval1}"
attr MAX_017840_weblink room MAX</nowiki>
=== Nützliche kleine Erweiterungen ===
'''Einen Alias-Namen vergeben für eine bessere Lesbarkeit im Webinterface'''
<nowiki>attr MAX_018d3f alias Kueche</nowiki>
'''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.
<nowiki>attr FileLog_MAX_018d3f room LOG</nowiki>
'''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.

<nowiki>attr MAX_018d3f webCmd desiredTemperature</nowiki>
'''Soll-Temperatur setzen, ohne das automatische Programm des Thermostates abzuschalten.'''
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 <code>set MAX_04711 desiredTemperature auto 20</code>. Damit die Eingabe komfortabel aus Fhem möglich ist, kann ein Dummy-Device erstellt werden:

<nowiki>#Dummy für die Schnell-Einstellung der Temperatur bis zum nächsten automatischen Schaltzeitpunkt
define HeizkoerperBad dummy
attr HeizkoerperBad room MAX,Heizungen
attr HeizkoerperBad setList state:eco,auto,14.0,16.0,17.0,18.0,19.0,20.0,21.0,22.0,23.0
attr HeizkoerperBad webCmd state
define HeizkoerperBad.ntfy notify HeizkoerperBad.* {\
my $valtemp = "%";;\
my $device = "MAX_04711";;\
my $cmd = 'set '.$device.' desiredTemperature auto '.$valtemp;;\
fhem($cmd);;\
}</nowiki>
Diese Dummy-Device kann alternativ oder ergänzend zu <code>attr MAX_018d3f webCmd desiredTemperature</code> verwendet werden.

== Internals ==
=== IST-Temperaturwerte ===
[[File:Plot_MAX_Beispiel.png|thumb|right|Plot eines MAX Heizkörperthermostates]]
Diese Abbildung zeigt, dass die IST-Temperatur nicht regelmäßig dem MAX CUBE mitgeteilt wird. Im Automatikbetrieb wird beim 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 sinkte 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).

Die IST-Temperatur wird anscheinend aktualisiert bei einer Änderung der:

* Ventilstellung
* Soll-Temperatur
* des Betriebsmodis (Auto/Manuell)

=== MAXLAN ===
=== CUL_MAX ===
The Max devices use a CC1100 chip. For parameters see rf_moritz.c in culfw.
The thermostats use a Wake-On-Radio, thus one has to send packets at the right time.

CC1100 initialization sequence on one of the max devices (not Cube) (format: addr value, both in hex):

<nowiki>00 08
02 46
04 C6
05 26
0B 06
10 C8 //MDMCFG4 DRATE_E=8
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)
12 03
15 34
17 00
18 18
19 16
1B 43
21 56
25 00
26 11
0D 21
0E 65
0F 6A
07 4C //PKTCTRL1: ADR_CHK=0 APPEND_STATUS=1 CRC_AUTOFLUSH=1 PQT=2 (preamble must have 8 toggling bits before sync word detection)
16 1C //RXTIME=4
RX_TIME_QUAL=1 (when rx timeout expires, keep receiving if either sync word is found or PQI is set (see PQT))
RX_TIME_RSSI=1 (terminate RX if there is no carrier sense within the first 8 symbol periods)
20 78 //WORCTRL, WOR_RES=00 (1.8-1.9 sec), RC_CAL=1, EVENT1=7 (48 ticks), RC_PD=0
1E 87 //WOREVT1
1F 6B //WOREVT0, i.e. EVENT0 = 34667
29 59
2C 81
2D 35
3E C3</nowiki>
<nowiki>Not set, i.e. factory defaults:
13 MDMCFG1 NUM_PREAMBLE=2 (4 preamble bytes)</nowiki>
From the configuration, we see that the

<nowiki>RC Oscillator: f_xosc/750 = 34666.66 Hz
Event1 = Event1(=48 ticks)/RC Oscillator = 1.385 ms
t_Event0 = 750/26Mhz * EVENT0 * 2^(5*WOR_RES) = 1.00 second
C(RX_TIME, WOR_RES)= 0.2254
rx timeout = EVENT0·C(RX_TIME, WOR_RES) ·26/X(=26) = 34667*0.2254 us = 7.8139 ms</nowiki>

The ShutterContact seems to always sleep. Thus it is necessary to trigger it manually (by opening/closing the window) to make it receive messages. Pushing the button may work to. It is also awake just after
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
after removing it from the house. The "factoryReset" packet is sent directly after the "ShutterContactState" packet has been acked.)

== Probleme und Lösungen ==
=== Der Wandthermostat oder Heizthermostat reagieren nicht auf Änderungen über FHEM ===
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!
Wenn im Log also Meldungen wie

<nowiki>2013.03.20 15:12:30 5: CUL_MAX_SendQueueHandler: 1 items in queue
2013.03.20 15:12:30 5: CUL_MAX_SendQueueHandler: 1 items in queue
2013.03.20 15:12:30 2: CUL_MAX_SendQueueHandler: Missing ack from 01c9bb for 0b05008212345601c9bb0000</nowiki>
auftauchen (im Verbose Modus 5), dann wurde vermutlich kein oder ein inkorrektes Paring durchgeführt.
Nach dem Pairing sollten diese Meldungen verschwinden und stattdessen etwas wie

<nowiki>2013.03.20 15:21:43 5: Got matching ack</nowiki>
auftauchen.

[[Kategorie:Kontaktsensor (magnetisch)]]
[[Kategorie:Glossary]]
[[Kategorie:MAX]]
[[Kategorie:Heizungsventile]]

DevelopmentGuidelines

2013-11-10T18:34:14Z

Yfhem: /* Bezeichnungen */ Remove dot in source.

''Wichtiger Hinweis'': Diese Seite enthält die Ideen der fhem-Entwickler, wie fhem in einer künftigen Version funktionieren soll. Es beschreibt nicht den Zustand der aktuellen Umsetzung in den Release- oder den SVN-Versionen.

==Definitionen==
TODO: Rudis kanonische Begriffe verwenden!

===Allgemeines===
Die Version von fhem, in der diese Guidelines umgesetzt werden sollen, wird mit fhem-NEU bezeichnet. Mit fhem 4.x wird die aktuelle Architektur bezeichnet, die auch fuer fhem 5.x zutrifft.

===Readings===
Ein Reading (Ablesewert) ist jeglicher Wert, Zustand, etc., der von einem Geraet ausgelesen werden kann. Beispiele dafuer sind Messtemperatur, Luftfeuchtigkeit, Schaltzustand (an/aus), Firmwareversion, Empfangsstaerke.

=== I/O-Devices und Clients===
Um Readings durch fhem verarbeiten zu koennen, muessen die Daten erst ueber ein I/O-Device in den Rechner kommen. Beispiele: FHZ1300, CUL, CM11, M232.

Ein I/O-Device ist ueber einen Port (Beispiel fuer Unix: /dev/ttyS0) oder einen Socket ansprechbar.

Ein I/O-Device kann selbst ein Geraet sein, das Readings liefert (Beispiel: SCIVT, sowie die meisten anderen Schnittstellengeraete, wenn man die Geraeteversion oder die Uptime mit zu den Readings zaehlt), oder die Readings von anderen Geraeten (Clients) weiterleiten (Beispiel: FHZ1300).

==Requests for Proposal==
===Aktualisierung der Readings===
====Aktive und passive Readings====

Es sind zwei Arten von Readings zu unterscheiden:
# Readings, die vom Geraet aktiv mitgeteilt werden, entweder ad-hoc oder in regelmäßigen Zeitabständen (aktive Readings). Beispiele: measuredTemp bei FHT80B, wind bei KS300
# Readings, nach denen fhem die Geräte fragen muss (passive Readings). Beispiele: energyDay bei EM1010PC, counter bei M232, temperature bei OWTEMP

Dasselbe Geraet kann sowohl aktive als auch passive Readings beinhalten. Bei Geraeten mit aktiven Readings sind passive Readings meist Informationen wie Versionsnummer oder Uptime (CUL, CM11).

Geraete, die mehrere verschiedene Readings haben, senden diese haeufig im Batch an fhem (Beispiel: FHT80b, KS300).

====Mechanismus fuer aktive Readings====
''TODO: Mechanismus mit ParseFn, GetFn, Match usw. beschreiben (wie in fhem 4.x)!''

====Mechanismus fuer passive Readings====
Fuer passive Geräte gibt es eine Polling-Infrastruktur.

'''Status Quo in fhem 4.x:'''

In der Routine DEVICE_Define wird ein interner Timer gestartet, der die Updatefunktion aufruft. INTERVAL ist die Periode in Sekunden.

sub
DEVICE_Define($$) {
...
InternalTimer(gettimeofday()+$hash->{INTERVAL}, "DEVICE_GetUpdate", $hash, 0);
...
}

In der Routine DEVICE_GetUpdate werden dann die Readings vom Gerät geholt und der Timer wird mit dem gleichen Befehl erneut gestartet.

sub
DEVICE_GetUpdate($$) {
...
# start internal timer; do it at the beginning to achieve equal intervals no matter how long it takes to gather data
InternalTimer(gettimeofday()+$hash->{INTERVAL}, "DEVICE_GetUpdate", $hash, 1);
# gather data
...
}

Der letzte Paramater 0 oder 1 ist waitIfInitNotDone.

Fragen:
* Kann/soll dieses Verfahren in einem Modul gekapselt werden? Geraete melden sich dann an der Polling-Infrastruktur an. Wenn ja, wie?
* Wie wird waitIfInitNotDone korrekt eingesetzt?

====Mechanismus fuer langsame Readings====
'''Problemstellung:''' Laengere Verarbeitungsprozesse in einzelnen Modulen (z.B. aufgrund von Netzwerklatenzen oder toten Geraeten) halten fhem komplett an und verhindern die Verarbeitung von Events.

'''Loesung:''' Multiprocessing

Beim Multiprocessing wird der fhem-Prozess geforkt, wenn ein Reading vom Geraet eingelesen werden soll. Der Vaterprozess wird sofort fortgesetzt und erledigt weitere Aufgaben. Der Kindprozess holt die Readings vom Geraet, liefert sie an den Vaterprozess und verendet.

Die Lieferung an den Vaterprozess erfolgt durch eine Verbindung zu fhem via Netzwerk und Aufruf des Befehls

set myDevice childupdate reading1:value1 reading2:value2 ...

Beispielcode:

DEVICE_StartUpdate wird periodisch aufgerufen.

<nowiki>sub
DEVICE_StartUpdate($)
{
my ($hash) = @_;
# %updates contains the names of the readings to be updated
my %updates = (
"reading1" => "",
"reading2" => "",
"reading3" => "",
);
# care for some prerequisites
...
if($hash->{CHILDPID}) {
# there is still the child process running => try again next time
Log 2, "DEVICE: Child already forked: timeout too short?";
return;
}
# fork a child process and return if we are the parent process
return if(($hash->{CHILDPID} = fork));
# if we are here, we are the child process
my @ret;
foreach my $r (sort keys %updates) {
my $ret = ... # retrieve reading $r from device
$ret = "" if(!defined($ret));
last if($ret eq ""); # break on error
push(@ret, $r . ":" . $ret); # append readingI:valueI to array
}
# now connect to parent process and pass retrieved readings
my @port = split(" ", $attr{global}{port});
my $server = IO::Socket::INET->new(PeerAddr => "localhost:$port[0]");
Log 0, "DEVICE: Can't connect to parent\n" if(!$server);
syswrite($server, "set $hash->{NAME} childupdate ".join(" ",@ret)."\n");
exit(0);
} </nowiki>

Aus der Routine DEVICE_Set wird DEVICE_ChildUpdate aufgerufen, wenn das Kommando "set childupdate ..." lautet:

<nowiki>sub
DEVICE_ChildUpdate($$) {
my ($hash, @ret)= @_;
delete $hash->{CHILDPID};
# evaluate readings
...
# inform about changes
...
}</nowiki>

'''Fragen''':
* Kann dieser Mechanismus in einem Modul gekapselt werden, damit nicht jedes Geraet den o.g. Kode replizieren muss?
* Soll es diesen Mechanismus nur passive Readings geben oder gibt es Anwendungsfaelle fuer aktive Readings?

'''Verworfene Alternative''': Multithreading

Argumente gegen Multithreading:
* Wird praktisch auf keiner kleinen Plattform unterstuetzt.
* Negative Erfahrungen (z.B. Probleme bei vielen 3rd-party-Komponenten)
* Kaum Programmiererfahrung mit Multithreading in Perl.

==Verabschiedete Richtlinien==
===Zeichensatz===
Alle nach aussen sichtbaren Werte sind in der Zeichenkodierung ASCII (Codes 32..127). Dies vermeidet Konvertierungsprobleme bei der Bearbeitung des Quellkodes, bei der Ausgabe durch Perl, beim Transport in Internet-Protokollen und bei der Darstellung im Frontend/GUI.

===Klassifizierung der Attribute===
Die Attribute eines Moduls werden in logische Klassen (Rubriken) eingeteilt.

====Sinn und Zweck====
Die Rubriken helfen...
* zu sortieren, welche Attribute bei (xml)list gezeigt werden und welche nicht,
* zu definieren, welche Werte per save in die Sicherung kommen und welche nicht,
* zu vereinbaren, welche Änderungen ein notify auslösen und welche nicht,
* zu definieren, wie ein Attribut im $hash->{} abgelegt wird (in $hash->{}, $hash->{READINGS}, $hash->{INTERNALS}, ...),
* zu gliedern, welche Namenskonventionen jeweils für Attribute verwendet werden (Kleinbuchstaben, Großbuchstaben, CamelCaps, ...),
* abzugrenzen, wo der Entwickler sich an Vorgaben halten muß (z.B. bei System Internals) und wo er frei ist, Attribute zu erfinden oder wegzulassen, und
* festzulegen, wo bzgl. der Inhalte Standards notwendig sind und wo nicht (z.B. bei "Logical Readings", wenn diese im GUI angezeigt werden sollten).

====Logische Rubriken====
Die folgenden Rubriken stellen eine sehr feine Einteilung dar:
* System Internals: werden vom Framework (fhem.pl) benoetigt/verwendet/erkannt, z.B. NAME, NR, CHANGED
* Device Readings: Rohdaten, die vom physischen Geraet ausgelesen werden (nicht interpretiert), z.B. rain_raw (Wippenschlaege des Regensensors) in KS300
* Hilfsvariablen: z.B. rain_raw_adj (rain_raw, jedoch bereinigt um die bei einigen KS300 auftretenden erratischen Spruenge) in KS300, Zwischenergebnisse von Daten/Werten, welche zur Mittelwertberechnung benoetigt werden
* Logical Readings: ausgewertete Messdaten und Zustaende, z.B. Temperatur, Niederschlag (nicht als Wippenschlaege sondern in l/qm)
* Derived Readings: aus den Messdaten abgeleitete Werte, z.B. durchschnittliche Temperatur der laufenden Woche, Niederschlagsmenge des Tages
* Physical Device Parameter: z.B. Modell oder Housecode und Unitcode bei X10 oder die Sensornummer beim BS (brightness sensor)
* Logical Device Parameter: statische Werte, die als Grundlage für Berechnungen genutzt werden, z.B. Korrekturfaktoren bei den Energiemessgeraeten, die Tankgeometrie beim USF1000
* Messages: alle Nachrichten, die das Gerät betreffen, z.B. "AVG_Month erfolgreich berechnet", "Script XYZ am xx.xx.xx gestartet", LastIODEV, LastRAWMSG
* Trigger: wenn Trigger direkt am Geraet hinterlegt werden, muessen nicht mehr alle Notifies durchsucht werden, sondern es kann das Modul direkt ermitteln, ob ein Notify ausgeloest wird.

====Ablage im Programm====
Programmtechnisch werden die Attribute eines Moduls so in Behaeltern abgelegt, dass folgende Kriterien erfuellt sind:
* Die Aufteilung ist moeglichst einfach/minimalistisch.
* Anhand des Behaelters laesst sich entscheiden,
** ob die Werte der darin enthaltene Attribute ueber das Programmende hinaus gespeichert oder nicht gespeichert werden,
** welchen Anzeigestandards oder Programmierstandards die darin enthaltenen Attribute entsprechen, und
** ob es sich um fhem-interne Attribute, Readings oder Hilfsvariablen handelt.

Es gibt folgende Behaelter:

readings
* Logische Rubrik: Device Reading, Logical Reading, Derived Reading
* Wird gespeichert
* Alle vom Geraet gelieferten bzw. berechneten Werte, die den Endanwender interessieren. Keine Rohdaten vom Geraet, die erst interpretiert werden muessen (Wippenschlaege beim Regensensor).
* Alle Daten haben einen Wert und ein Zeitstempel
* Beispiele:
$defs{Lampe}{readings}{switchedTo}{value} = "on"; $defs{Lampe}{readings}{switchedTo}{time} = "2010-03-29 23:32:26"
$defs{FHToben}{readings}{measuredTemp}{value} = "23"; $defs{FHToben}{readings}{switchedTo}{time} = "2010-03-29 21:58:36"

helper
* Logische Rubrik: Hilfsvariable, Device Reading
* Wird gespeichert
* Alle Werte, die fuer den Endanwender nicht direkt Sinn machen, aber vom Modul fuer unterschiedliche Zwecke benoetigt werden. Kann auch rohe Readings enthalten.
* Beispiele:

$defs{ks300}{helper}{cumMonth} = "23 T: 131.4 H: 816 W: 775.1 R: -651.1"
$defs{emwz}{helper}{basis} = "4776493"

fhem
* Logische Rubrik: System Internals, Physical Device Parameter, Logical Device Parameter
* Wird nicht gespeichert
* Alle Geraete-Werte, die nicht gespeichert werden muessen, weil entweder berechnet, oder aus der Definition hervorgehen.
* Beispiele

$defs{emwz}{fhem}{def} = "1 75 900"
$defs{emwz}{fhem}{lastIODev} = "CUL"

Verworfener Behaelter STATE
* Logische Rubrik: Device Reading, Logical Reading, Derived Reading
* Wird gespeichert
* Kurze(!) Zusammenfassung der wichtigsten Information des Geraetes. Was man in einer Uebersicht ueber die Geraete sehen moechte, z.B. eine Warnung oder die aktuelle Temperatur beim FHT80 oder der Zeitpunkt der letzten Aktivierung beim PIRI. Falls es sowas nicht gibt, dann einheitlich "defined". GGf. ueber Attribute am Modul steuerbar. Eigentlich ist es kein Behaelter im ueblichen Sinne, da es keine Untereinheiten hat.

Der Behaelter wurde verworfen, weil er redundant ist, an sich gar kein Behaelter, und einfacher und flexibler ueber einen Verweis auf das Reading realisiert werden kann, der per Default angezeigt werden soll.

====Status====
Kurze Zusammenfassung der wichtigsten Information des Geraetes. Was man in einer Uebersicht ueber die Geraete sehen moechte, z.B. eine Warnung oder die aktuelle Temperatur beim FHT80 oder der Zeitpunkt der letzten Aktivierung beim PIRI. Falls es sowas nicht gibt, dann einheitlich "defined". Modulseitig gibt es einen Default, der auf das relevante Reading verweist. Dieser ist ueber das Attribut defaultReading am individuellen Geraet steuerbar.

Beispiel: Definition in der Konfigurationsdatei: attr myDevice defaultReading measuredTemp Verwendung im Code:

$defs{myDevice}{readings}{$attr{defaultReading}}

Die logischen Rubriken Messages und Trigger wurden noch nicht diskutiert.

===Bezeichnungen===
Verwendung von lowerCamelCaps fuer alle vom Modul nach aussen sichtbaren Bezeichner: a) die Bezeichnungen der Behaelter fuer Readings, Fhem und Helper und der Untereintraege, b) die Bezeichnungen der Readings, c) die Bezeichnungen der Attribute.

Beispiel:

$defs{myFHT}{readings}{measuredTemp}{time}

===Readings===
====Standardisierung der Readings====
Die Readings werden standardisiert, indem Geraeteklassen gebildet werden wie in DevelopmentInterfaces beschrieben. Die Definition der Interfaces ist explizit nicht Gegenstand dieser Entscheidungsvorlage und wird weiterentwickelt und angepasst, wie es sich bei der Entwicklung von fhem-NEU ergibt.
Struktur im Code

Zu jedem Reading gibt es die folgenden Unterbehaelter:
* value: Wert der Messgroesse
* time: Zeitpunkt, zu dem der Wert ermittelt wurde

Beispiel:

$defs{myFHT}{readings}{measuredTemp}{time}= timestamp;
$defs{myFHT}{readings}{measuredTemp}{value}= 23.5;

Readings enthalten grundsaetzlich genau einen Wert und diesen ohne Einheit.

====Einheitendarstellung====
Die verwendete Einheit fuer ein Reading ergibt sich aus der Interfacespezifikation.

Beispiel: Gerät ist ein Thermometer => es gibt ein Reading "temperature" und dessen Einheit ist immer °C oder Celsius

Verworfene Alternative:
* Einheit ergibt sich aus der Dokumentation
* Einheit ergibt sich aus einem expliziten Untereintrag $defs{deviceName}{readings}{theReading}{unit}="°C"
* Einheit ergibt sich aus Festlegung gemaess "FHEM-Standard", z.B. immer SI-Einheiten, Temperaturen in Celsius, etc.

===Zeitdarstellung in fhem===
Zeiten werden im Programm grundsaetzlich immer maschinenlesbar abgelegt, also sowohl in $defs{deviceName}{readings}{time} als auch z.B. bei der Speicherung des Zeitpunkts der Ausfuehrung des naechsten at-Kommandos.

Es gibt uebergreifende Hilfsfunktionen, die die maschinenlesbare in eine menschenlesbare Darstellung umwandeln.

Argumente fuer maschinenlesbar:
* vereinfacht Datumsarithmetik, z.B. die Berechnung der Zeitdauer zwischen zwei Ereignissen
* kann vom Frontend in die regionale Darstellung des Anwenders uebersetzt werden
* hat keine Probleme mit doppelt auftretenden Zeitpunkten bei der Umstellung von Sommer- auf Winterzeit

Folgende Zeitdarstellungen werden ausschliesslich verwendet:

A. Zahl der Sekunden seit der Unix-Epoche (was time liefert); auch wenn time eine Ganzzahl liefert, muss der Verwender damit rechnen, eine Gleitkommazahl vorzufinden. Das ist z.B. dann der Fall, wenn fuer die Zeibestimmung hoeheraufloesende Funktionen (z.B. Time::HiRes) zum Einsatz kamen und Sekundenbruchteile mitgespeichert wurden.

Hinweis zu potentiellen Problemen:
* Ab perl 5.12 ist das Jahr-2038-Problem in Perl beseitigt.
* Ab MacOS X liefert time auch auf Macs die Zahl der Sekunden seit der Unix-Epoche (statt seit Anfang 1904)

B. ISO8601 mit optionaler Zeitzonenangabe, wobei bei fehlender Zeitzone die lokale Zeitzone des fhem-Servers gilt

Die Zeitdarstellungen werden wie folgt verwendet:
* Zur Programmlaufzeit in Variablen immer A
* In Konfigurationsdateien (fhem.conf, fhem.save) immer B
* In Logs, die fuer den Menschen bestimmt sind, B
* In Logs, die fuer die Maschine bestimmt sind, also z.B. bei Weiterverarbeitung in einem GUI, A
* In Listen (list, xmllist friendly), die fuer den Menschen bestimmt sind, B
* In Listen (xmllist), die fuer die Maschine bestimmt sind, also z.B. bei Weiterverarbeitung in einem GUI, A

Die Unterscheidung bei den Logs ist noch zu diskutieren.

Hinweise zu gnuplot:

<nowiki>set timefmt '%Y-%m-%dT%H:%M:%S' </nowiki>

(ISO8601) funktioniert, und zwar unabhaengig davon, ob die optionale Zeitzonenangabe anhaengt oder nicht (getestet mit Gnuplot v4.2 pl3). Fuer die Sekunden seit der Unix-Epoche:

<nowiki>set timefmt '%s' </nowiki>

(nicht getestet).

==Allgemeine Dokumentation==
===Events, Filter, Notify===
====Event====
Ein Event tritt ein, wenn ein oder mehrere Readings eines Geraetes aktualisiert werden, weil z.B. ein Datagramm empfangen oder zeitgesteuert Werte eingelesen wurden. Es wird durch drei Angaben

<nowiki>(device, timestamp, { reading1, ..., readingN } )</nowiki>

beschrieben:
* das Geraet device
* der Zeitpunkt der Aktualisierung timestamp
* die Menge der N>= 1 geaenderten Readings reading1, .. readingN

Wenn N> 1, dann handelt es sich um ein Sammelevent, wie es z.B. von KS300 generiert wird.

====Filter====
Ein Filter filtert Events. Er hat die Form

deviceNamePattern

bzw.

deviceNamePattern:readingNamePattern

Ein Filter passt auf ein Event, wenn deviceNamePattern den Namen des device matcht und, sofern vorhanden, readingNamePattern mindestens irgendeinen Namen von reading1 bis readingN matcht.

====Mechanismus====
0. Fuer das Geraet device namens deviceName wird ein Datagramm empfangen oder es werden zeitgesteuert Werte eingelesen.

1. Die Readings werden aktualisiert. Fuer X= 1..N:

$defs{deviceName}{readings}{readingX}{value}= valueX;
$defs{deviceName}{readings}{readingX}{time}= timestamp;

2. Das Event wird erstellt und an DoTrigger uebergeben.

3. DoTrigger informiert zunaechst alle Clients mit inform-Wunsch.

4. Das Event wird sodann von DoTrigger nacheinander an alle NotifyFn in der alphabetischen Reihenfolge der Geraetenamen gereicht. Darunter auch jene von Logs.

5. Wenn der Filter des Logs auf das Event passt, wird ein Log-Eintrag der Form

timestamp deviceName reading1: value1 reading2: value2 ... readingN: valueN

erzeugt.

==Zurueckgestellte Entscheidungen==
===Attribute vs. Internals===
Die Unterscheidung zwischen Attributen und Internals ist nicht eindeutig. Manche define-Parameter sind optional, und man kann define-Parameter mit "modify" aendern. Insofern koennte man theoretisch einen der beiden Verfahren (modify vs. attribute) abloesen.

1. Idee: define-Parameter duerfen nachtraeglich nicht geaendert werden, auch wenn es sich um optionale Parameter handelt => nicht-modifizierbare Internals

Pros:
* define-Parameter sind elementar fuer den Betrieb des Geraetes und koennen nicht sinnvoll zur Programmlaufzeit geaendert werden (z.B. Hauskode bei X10, FHTId bei FHT80b)
* Aus den define-Parametern werden bei der Initialisierung des Geraets weitere Helper und Internals abgeleitet und gespeichert. Eine nachtraegliche Aenderung zieht Aenderungen der Helper und Internals nach sich mit ggf. schwer durchschaubaren Nebeneffekten (z.B. corr1..corr4 bei EM, rainadjustment bei KS300). Auch die Logs aendern sich nicht nachtraeglich.

Contras:
* Man will nicht ein Geraet loeschen und neu anlegen, wenn es ausgetauscht wird.
* modify sollte bleiben, weil es nuetzlich ist.

2. Idee: Attribute enthalten Werte, die ohne Nebeneffekte zur Laufzeit geaendert werden koennen, weil sie z.B. ad-hoc ausgewertet werden.
* follow-on-for-timer
* retrycount
* lazy

3. Idee: Attribute beinhalten geraeteunabhaengige Meta-Informationen:
* room
* defaultReading

Contras:
* Nach 2. und 3. muesste

attr my_at disabled

doch zu Definition gehoeren. Und "skip_next" auch.

Spezialitaeten
* beim FS20 bleibt alles, wie es ist, also model als Attribut, was Auswirkung auf die moeglichen set Befehle hat.
* 1wire setzt nach define das model Attribut, laesst aber eine Aenderung nicht zu, oder wenn doch, dann muss sich dementsprechend verhalten, es macht ja evtl. Sinn es zu aendern. Was machbar ist, entscheidet der Modul-Author.

Damit ist "model" immer ein Attribut.

Fazit

Da es keine ueberzeugende Alternative zum Ist-Zustand in fhem 4.x gibt, wird b.a.w. nicht hierueber entschieden.

===notify===
Die Frage, ob der notify-Mechanismus, der weiter oben dokumentiert ist, aus Performancegruenden optimiert werden sollte, ist offen.

In fhem 4.x bekommt jedes Geraet mit NotifyFn jedes Event mit. Alternativ koennte sich ein Geraet als EventListener mit einem Filter bei fhem anmelden. Dann koennten die Events nur an die NotifyFn verteilt werden, fuer die es ein Match auf den Filter gaebe.

Der Punkt wurde zurueckgestellt, bis nachgewiesen ist, dass sich aus dieser Vorgehensweise relevante Auswirkungen auf die Systemlast ergeben.

==Entscheidungen==
;E1
:Es werden die Container fhem, readings und helper verwendet.
;E2
:Es wird ein Attribut defaultReading verwendet.
;E3
:Verwendung von lowerCamelCaps fuer a) die Bezeichnungen der Behaelter fuer Readings, Fhem und Helper und der Untereintraege, b) die Bezeichnungen der Readings, c) die Bezeichnungen der Attribute.
;E4
:Verwendung von value und time.
;E5
:Zeitdarstellung im Programm grundsaetzlich maschinenlesbar
;E6
:Zulaessige Zeitdarstellungen
* Sekunden seit der Unix-Epoche
* ISO8601 mit optionaler Zeitzonenangabe
ISO8601 mit _ statt T war nicht mehrheitsfaehig.
;E7
:Verwendung der Zeitdarstellungen
;E8
:Readings enthalten grundsaetzlich genau einen Wert und diesen ohne Einheit.
;E9
:Einheiten ergeben sich aus der Interfacespezifikation.
;E10
:Entscheidung fuer ASCII
;E11
:Die Readings werden standardisiert, indem Geraeteklassen gebildet werden wie in DevelopmentInterfaces beschrieben. Die Definition der Interfaces ist explizit nicht Gegenstand dieser Entscheidungsvorlage und wird weiterentwickelt und angepasst, wie es sich bei der Entwicklung von fhem-NEU ergibt.

[[Kategorie:Development]]

DevelopmentIntroduction

2013-11-10T18:31:18Z

Yfhem: /* STATE */ Added space.

= Developer's Introduction to FHEM =
== Introduction ==
This page is intended to give an introduction to the FHEM application from a developer's perspective. If you're interested in extending, modifying or reusing the FHEM code, then hopefully you will find this a useful document. Note that this document is a work in progress! I myself at the time of writing this have only a few hours of experience under my belt, but I'm documenting things I learn as I learn them.

== Application Lifecycle ==
When you first launch the FHEM server, the following activities take place:

# Application variables are initialised
# The valid application commands are loaded into a structure (%cmds) with the corresponding function name to call
# Do the job, either act as client or server. One of the following applies:
## If the application has been called as a FHEM client (eg perl fhem.pl 127.0.0.1:7072 commandToExecute)
### Connect to the FHEM server
### Execute the command
### Exit the program
## Otherwise (the application has been started as a server)
### Execute each of the commands listed in the configuration file to initialise the server (see the CommandInclude and then the AnalyzeCommandChain methods)
### Execute each of the commands in the state file if configured to restore the devices to the last state recorded when the server last ran
### Start the main application loop

== Main Application Loop ==
The following code is repeated until the application ends:

# For each input device (eg FHZ1000 / FHZ1300 / CUL):
## Use that device module's Ready and Read functions to read data from the device
## For CUL devices, the data is read and parsed at this point
## For FHZ devices, the FHZ_CheckCRC method is used to validate the received data
## Call the Dispatch method in FHEM.pl to pass the message onto the correct device and corresponding module (Parse function)
$server->fileno() is used to check for and accept new connections to the server
For each connected client:
# Read data from the client using sysread
# Pass the received input into the AnalyzeInput method to execute the command

== Configuration and State Files ==
Note that these are just lists of commands to execute in a text file! So anything in these files will be interpreted by FHEM in the exact same way if a user keys the commands manually into a client application, eg a telnet connection.

== Readings ==
The following mechanism is recommended for updating readings. It saves lines of codes and automatically makes your module honor the event-on-update-reading and event-on-change-reading attributes.

Before you start updating readings, write (in case $hash = $defs{<device>})

<nowiki>readingsBeginUpdate($hash);</nowiki>
For every reading you update, write

<nowiki>readingsBulkUpdate($hash,$reading,$value);</nowiki>
Terminate with

<nowiki>readingsEndUpdate($hash, $dotrigger);</nowiki>
The $dotrigger parameter should be 0 for updates initiated by fhem message dispatcher as the dispatcher already calls DoTrigger on its behalf. $dotrigger should be 1 for updates initiated by internal timers, e.g. for polling devices.

As a shorthand notation for updating just one reading write

<nowiki>readingsSingleUpdate($hash,$reading,$value,$dotrigger);</nowiki>
which is the same as

<nowiki>readingsBeginUpdate($hash);
readingsBulkUpdate($hash,$reading,$value);
readingsEndUpdate($hash, $dotrigger);</nowiki>
== STATE ==
Vorschlag zur Umsetzung, diskutiert [https://groups.google.com/forum/?hl=de&fromgroups#!topic/fhem-developers/vqCx4M4X5l0 hier].

In den [[DevelopmentGuidelines]], Kapselung, Standardisierung der Vorgehensweise.

Die Funktion '''readingsEndUpdate''' aktualisiert $hash->{STATE} grundsätzlich immer bei jedem Aufruf nach folgendem Algorithmus:

Falls $sr= $attr{$name}{stateReading} gesetzt ist:

<nowiki>Fall 1: wenn $sr =~ "^{.*}$" dann eval "\$hash->{STATE} = $sr";
Fall 2: sonst $hash->{STATE}= $hash->{READINGS}{$sr}{VAL}</nowiki>
sonst

<nowiki>Falls es $hash->{READINGS}{state} gibt, $hash->{STATE}= $hash->{READINGS}{state}{VAL}</nowiki>
sonst

<nowiki>Tue nichts (das Modul hat sich gekuemmert).</nowiki>
Ausserdem wird

<nowiki>ReplaceEventMap()</nowiki>
losgelassen, um die EventMaps des Anwenders auch im STATE zur Anwendung zu bringen.

Aus '''DoTrigger''' werden

<nowiki>$defs{$dev}{STATE} = ReplaceEventMap($dev, $defs{$dev}{STATE}, 1);</nowiki>
und

<nowiki># STATE && {READINGS}{state} should be the same
my $r = $defs{$dev}{READINGS};
$r->{state}{VAL} = $defs{$dev}{STATE} if($r && $r->{state});</nowiki>
entfernt.

== Global Attributes ==
In fhem.pl existiert ein

<nowiki>my $AttrList = "room comment alias ...";</nowiki>
Weiterhin kann jedes Modul im Initialize mit addToAttrList eigene Attribute zu
global userattr hinzufuegen.

[[Kategorie:Development]]

DevelopmentIntroduction

2013-11-10T16:32:05Z

Yfhem: /* Main Application Loop */ Clean up.

= Developer's Introduction to FHEM =
== Introduction ==
This page is intended to give an introduction to the FHEM application from a developer's perspective. If you're interested in extending, modifying or reusing the FHEM code, then hopefully you will find this a useful document. Note that this document is a work in progress! I myself at the time of writing this have only a few hours of experience under my belt, but I'm documenting things I learn as I learn them.

== Application Lifecycle ==
When you first launch the FHEM server, the following activities take place:

# Application variables are initialised
# The valid application commands are loaded into a structure (%cmds) with the corresponding function name to call
# Do the job, either act as client or server. One of the following applies:
## If the application has been called as a FHEM client (eg perl fhem.pl 127.0.0.1:7072 commandToExecute)
### Connect to the FHEM server
### Execute the command
### Exit the program
## Otherwise (the application has been started as a server)
### Execute each of the commands listed in the configuration file to initialise the server (see the CommandInclude and then the AnalyzeCommandChain methods)
### Execute each of the commands in the state file if configured to restore the devices to the last state recorded when the server last ran
### Start the main application loop

== Main Application Loop ==
The following code is repeated until the application ends:

# For each input device (eg FHZ1000 / FHZ1300 / CUL):
## Use that device module's Ready and Read functions to read data from the device
## For CUL devices, the data is read and parsed at this point
## For FHZ devices, the FHZ_CheckCRC method is used to validate the received data
## Call the Dispatch method in FHEM.pl to pass the message onto the correct device and corresponding module (Parse function)
$server->fileno() is used to check for and accept new connections to the server
For each connected client:
# Read data from the client using sysread
# Pass the received input into the AnalyzeInput method to execute the command

== Configuration and State Files ==
Note that these are just lists of commands to execute in a text file! So anything in these files will be interpreted by FHEM in the exact same way if a user keys the commands manually into a client application, eg a telnet connection.

== Readings ==
The following mechanism is recommended for updating readings. It saves lines of codes and automatically makes your module honor the event-on-update-reading and event-on-change-reading attributes.

Before you start updating readings, write (in case $hash = $defs{<device>})

<nowiki>readingsBeginUpdate($hash);</nowiki>
For every reading you update, write

<nowiki>readingsBulkUpdate($hash,$reading,$value);</nowiki>
Terminate with

<nowiki>readingsEndUpdate($hash, $dotrigger);</nowiki>
The $dotrigger parameter should be 0 for updates initiated by fhem message dispatcher as the dispatcher already calls DoTrigger on its behalf. $dotrigger should be 1 for updates initiated by internal timers, e.g. for polling devices.

As a shorthand notation for updating just one reading write

<nowiki>readingsSingleUpdate($hash,$reading,$value,$dotrigger);</nowiki>
which is the same as

<nowiki>readingsBeginUpdate($hash);
readingsBulkUpdate($hash,$reading,$value);
readingsEndUpdate($hash, $dotrigger);</nowiki>
== STATE ==
Vorschlag zur Umsetzung, diskutiert [https://groups.google.com/forum/?hl=de&fromgroups#!topic/fhem-developers/vqCx4M4X5l0 hier].

In den [[DevelopmentGuidelines]], Kapselung, Standardisierung der Vorgehensweise.

Die Funktion '''readingsEndUpdate'''aktualisiert $hash->{STATE} grundsätzlich immer bei jedem Aufruf nach folgendem Algorithmus:

Falls $sr= $attr{$name}{stateReading} gesetzt ist:

<nowiki>Fall 1: wenn $sr =~ "^{.*}$" dann eval "\$hash->{STATE} = $sr";
Fall 2: sonst $hash->{STATE}= $hash->{READINGS}{$sr}{VAL}</nowiki>
sonst

<nowiki>Falls es $hash->{READINGS}{state} gibt, $hash->{STATE}= $hash->{READINGS}{state}{VAL}</nowiki>
sonst

<nowiki>Tue nichts (das Modul hat sich gekuemmert).</nowiki>
Ausserdem wird

<nowiki>ReplaceEventMap()</nowiki>
losgelassen, um die EventMaps des Anwenders auch im STATE zur Anwendung zu bringen.

Aus '''DoTrigger'''werden

<nowiki>$defs{$dev}{STATE} = ReplaceEventMap($dev, $defs{$dev}{STATE}, 1);</nowiki>
und

<nowiki># STATE && {READINGS}{state} should be the same
my $r = $defs{$dev}{READINGS};
$r->{state}{VAL} = $defs{$dev}{STATE} if($r && $r->{state});</nowiki>
entfernt.

== Global Attributes ==
In fhem.pl existiert ein

<nowiki>my $AttrList = "room comment alias ...";</nowiki>
Weiterhin kann jedes Modul im Initialize mit addToAttrList eigene Attribute zu
global userattr hinzufuegen.

[[Kategorie:Development]]

SUNRISE EL

2013-11-06T15:18:37Z

Yfhem: Added link to commandref.html.

'''Lichtsteuerung per sunset / sunrise'''

Siehe auch: [http://fhem.de/commandref.html#SUNRISE_EL commandref.html]
== Voraussetzungen ==
In der ''fhem.cfg'' müssen Sie vorher Ihren Wohnsitz definieren, da der Sonnenauf- und -untergang ja nicht nur vom Datum, sondern auch vom Längen- und Breitengrad Ihres Standortes abhängig ist. Hierzu tragen Sie folgende Zeilen in die ''fhem.cfg'' ein:

<nowiki>attr global latitude 5X.XYZ
attr global longitude 6.XYZ</nowiki>
und zwar in genau dieser Schreibweise. Entweder benutzen Sie zur Bestimmung ein GPS-System oder sie befragen einen entsprechenden Internet-Dienst.

Als Internet-Dienst eignet sich beipielsweise [http://www.openstreetmap.org/#map=12/52.4994/13.4960 OpenStreetMap]. Die Werte latitude und longitude können aus der URL abgelesen werden. In diesem Beispiel latitude 52.4994 und longitude 13.4960.

== Steuerung ==
Mittels folgender Skriptzeilen in der ''fhem.cfg''
<nowiki># Außenlampe - Steuerung An-/Ausschaltzeit
define AussenlampeAn1 at *{sunset(0,"17:00","22:00")} set EG.Diele.Aussenlampe on
define AussenlampeAus1 at *{sunrise(0,"05:00","07:30")} set EG.Diele.Aussenlampe off</nowiki>
wird der Funk-Lichtschalter für die Außenbeleuchtung (hier das FHEM-Gerät mit dem Namen ''EG.Diele.Aussenlampe'')

* morgens zum Sonnenaufgang, aber nicht vor 05:00 und nicht nach 07:30 Uhr ausgeschaltet

und

* abends zum Sonnenuntergang eingeschaltet, aber nicht vor 17:00 Uhr und nicht nach 22:00 Uhr.

Im FHEM-Standard wird der sogenannte bürgerliche Sonnenuntergang/-aufgang genutzt.

Bis bzw. ab dieser Zeit ist das Lesen ohne zusätzliche Beleuchtung möglich.
Da dies nicht immer gewünscht ist, ist es möglich bei den sunrise/sunset-Funktionen *optional* als ersten Parameter vorne REAL, CIVIL, NAUTIC, ASTRONOMIC oder z.B. HORIZON=-6.0 oder "HORIZON -6.0" anzustellen:

# Normales Verhalten wie im obigen Beispiel:
{sunset(0,"17:00","22:00")}
Ergebnis (als Beispiel): 19:59:22

# Gleiches Beispiel mit CIVIL als 1. Parameter:
{sunset("CIVIL",0,"17:00","22:00")}
Ergebnis (als Beispiel): 19:59:22

# Gleiches Beispiel mit Eingabe der Höhe über Horizont als 1. Parameter:
{sunset("HORIZON=-6.0",0,"17:00","22:00")}
Ergebnis (als Beispiel): 19:59:22

# Gleiches Beispiel mit dem realen Sonnenuntergang auf 0 Grad als 1. Parameter:
{sunset("REAL",0,"17:00","22:00");;}
Ergebnis (als Beispiel): 19:22:07

== Kontrolle ==
Um die Zeiten zu kontrollieren können Sie in der FHEM-Befehlszeile den Befehl

<code>
list AussenlampeAn1
</code>

eingeben und mit der <Enter>-Taste (nicht "save-Button") bestätigen. Sie sehen dann (hier eine Ausgabe vom 17.01.2013) z.B. folgendes:

<nowiki>Internals:
DEF *{sunset(0,"17:00","22:00")} set EG.Diele.Aussenlampe on
NAME AussenlampeAn1
NR 225
NTM 17:37:09
REP -1
STATE Next: 17:37:09
TRIGGERTIME 1358527029
TYPE at
Attributes:
room Diele</nowiki>
Der Sonnenuntergang liegt am genannten Tag '''innerhalb''' des Start-/Ende-Zeitraums, so dass die Lampe um 17:37 Uhr eingeschaltet wird.

Die Ausgabe (gleiches Datum) von

<code>
list AussenlampeAus1
</code>

lautet:

<nowiki>Internals:
DEF *{sunrise(0,"05:00","07:30")} set EG.Diele.Aussenlampe off
NAME AussenlampeAus1
NR 228
NTM 07:30:00
REP -1
STATE Next: 07:30:00
TRIGGERTIME 1358490600
TYPE at
Attributes:
room Diele</nowiki>
Hier liegt der Sonnenaufgang noch '''außerhalb''' des Start-/Ende-Zeitraums, so dass die Lampe um 07:30 Uhr ausgeschaltet wird.

== Hinweise ==
* Da es [https://groups.google.com/forum/?fromgroups=#!topic/fhem-users/y2CbOQmTVsg Eintrag in der ehemaligen FHEM-Google-Group] entnehmen.
* Die ''sunset / sunrise'' Einstellungen arbeiten meist erst '''am nächsten Tag''' richtig. Das hängt zusammen mit einer Falschberechnung beim setzen dieses ''defines''. An einer Korrektur wird gearbeitet (Stand Januar 2013).
[[Kategorie:HOWTOS]]

Bekannte HomeMatic Geräte

2013-11-05T12:44:48Z

Yfhem: Updated link.

Die folgenden Geräte sind in der CUL_HM.pm vorhanden. (03.06.12, [http://sourceforge.net/p/fhem/code/HEAD/tree/trunk/fhem/FHEM/10_CUL_HM.pm?revision=1603 Rev. 1603])

<nowiki>"0001" => "HM-LC-SW1-PL-OM54",
"0002" => "HM-LC-SW1-SM",
"0003" => "HM-LC-SW4-SM",
"0004" => "HM-LC-SW1-FM", # Tested
"0005" => "HM-LC-BL1-FM", # Tested by ruebezahl (2011-09-22)
"0006" => "HM-LC-BL1-SM",
"0007" => "KS550", # Tested
"0008" => "HM-RC-4", # cant pair(AES)-> broadcast only
"0009" => "HM-LC-SW2-FM",
"000A" => "HM-LC-SW2-SM",
"000B" => "HM-WDC7000", # Tested by elanter (2011-09-22)
"000D" => "ASH550",
"000E" => "ASH550I",
"000F" => "S550IA",
"0011" => "HM-LC-SW1-PL", # Tested
"0012" => "HM-LC-DIM1L-CV",
"0013" => "HM-LC-DIM1L-PL",
"0014" => "HM-LC-SW1-SM-ATMEGA168",
"0015" => "HM-LC-SW4-SM-ATMEGA168",
"0016" => "HM-LC-DIM2L-CV",
"0018" => "CMM",
"0019" => "HM-SEC-KEY",
"001A" => "HM-RC-P1",
"001B" => "HM-RC-SEC3",
"001C" => "HM-RC-SEC3-B",
"001D" => "HM-RC-KEY3",
"001E" => "HM-RC-KEY3-B",
"0022" => "WS888",
"0026" => "HM-SEC-KEY-S",
"0027" => "HM-SEC-KEY-O",
"0028" => "HM-SEC-WIN", # some experiments
"0029" => "HM-RC-12",
"002A" => "HM-RC-12-B",
"002D" => "HM-LC-SW4-PCB",
"002E" => "HM-LC-DIM2L-SM",
"002F" => "HM-SEC-SC",
"0030" => "HM-SEC-RHS", # Tested
"0034" => "HM-PBI-4-FM",
"0035" => "HM-PB-4-WM", # Tested
"0036" => "HM-PB-2-WM",
"0037" => "HM-RC-19",
"0038" => "HM-RC-19-B",
"0039" => "HM-CC-TC", # Selected commands
"003A" => "HM-CC-VD", # Actuator, battery/etc missing
"003B" => "HM-RC-4-B",
"003C" => "HM-WDS20-TH-O",
"003D" => "HM-WDS10-TH-O", # Reported to work (2011-07-26)
"003E" => "HM-WDS30-T-O",
"003F" => "HM-WDS40-TH-I", # Tested by peterp
"0040" => "HM-WDS100-C6-O", # Identical to KS550?
"0041" => "HM-WDC7000", # Tested by elanter (2011-09-22)
"0042" => "HM-SEC-SD", # Tested
"0043" => "HM-SEC-TIS",
"0044" => "HM-SEN-EP",
"0045" => "HM-SEC-WDS", # Tested by peterp
"0046" => "HM-SWI-3-FM", # Tested by NorbertW
"0047" => "KFM-Display",
"0048" => "IS-WDS-TH-OD-S-R3",
"0049" => "KFM-Sensor",
"004A" => "HM-SEC-MDIR", # Tested
"004B" => "HM-Sec-Cen", # by peterp
"004C" => "HM-RC-12-SW",
"004D" => "HM-RC-19-SW",
"004E" => "HM-LC-DDC1-PCB",
"004F" => "HM-SEN-MDIR-SM",
"0050" => "HM-SEC-SFA-SM",
"0051" => "HM-LC-SW1-PB-FM",
"0052" => "HM-LC-SW2-PB-FM", # Tested
"0053" => "HM-LC-BL1-PB-FM", # Tested by ruebezahl (2011-09-22)
"0056" => "HM-CC-SCD",
"0057" => "HM-LC-DIM1T-PL",
"0058" => "HM-LC-DIM1T-CV",
"0059" => "HM-LC-DIM1T-FM",
"005A" => "HM-LC-DIM2T-SM",
"005C" => "HM-OU-CF-PL",
"005F" => "HM-SCI-3-FM", # Tested by fhem-hm-knecht
"0060" => "HM-PB-4DIS-WM", # Tested
"0061" => "HM-LC-SW4-DR", # Tested by fhem-hm-knecht
"0062" => "HM-LC-SW2-DR",
"0066" => "HM_LC_Sw4-WM", # Tested by peterp
"0067" => "HM-LC_Dim1PWM-CV", # Tested by peterp
"006C" => "HM-LC-SW1-BA-PCB", # Tested by MartiMcFly</nowiki>

[[Kategorie:HomeMatic Components]]

SUNRISE EL

2013-11-05T10:41:57Z

Yfhem: /* Kontrolle */ Added space.

'''Lichtsteuerung per sunset / sunrise'''
== Voraussetzungen ==
In der ''fhem.cfg'' müssen Sie vorher Ihren Wohnsitz definieren, da der Sonnenauf- und -untergang ja nicht nur vom Datum, sondern auch vom Längen- und Breitengrad Ihres Standortes abhängig ist. Hierzu tragen Sie folgende Zeilen in die ''fhem.cfg'' ein:

<nowiki>attr global latitude 5X.XYZ
attr global longitude 6.XYZ</nowiki>
und zwar in genau dieser Schreibweise. Entweder benutzen Sie zur Bestimmung ein GPS-System oder sie befragen einen entsprechenden Internet-Dienst.

Als Internet-Dienst eignet sich beipielsweise [http://www.openstreetmap.org/#map=12/52.4994/13.4960 OpenStreetMap]. Die Werte latitude und longitude können aus der URL abgelesen werden. In diesem Beispiel latitude 52.4994 und longitude 13.4960.

== Steuerung ==
Mittels folgender Skriptzeilen in der ''fhem.cfg''
<nowiki># Außenlampe - Steuerung An-/Ausschaltzeit
define AussenlampeAn1 at *{sunset(0,"17:00","22:00")} set EG.Diele.Aussenlampe on
define AussenlampeAus1 at *{sunrise(0,"05:00","07:30")} set EG.Diele.Aussenlampe off</nowiki>
wird der Funk-Lichtschalter für die Außenbeleuchtung (hier das FHEM-Gerät mit dem Namen ''EG.Diele.Aussenlampe'')

* morgens zum Sonnenaufgang, aber nicht vor 05:00 und nicht nach 07:30 Uhr ausgeschaltet

und

* abends zum Sonnenuntergang eingeschaltet, aber nicht vor 17:00 Uhr und nicht nach 22:00 Uhr.

Im FHEM-Standard wird der sogenannte bürgerliche Sonnenuntergang/-aufgang genutzt.

Bis bzw. ab dieser Zeit ist das Lesen ohne zusätzliche Beleuchtung möglich.
Da dies nicht immer gewünscht ist, ist es möglich bei den sunrise/sunset-Funktionen *optional* als ersten Parameter vorne REAL, CIVIL, NAUTIC, ASTRONOMIC oder z.B. HORIZON=-6.0 oder "HORIZON -6.0" anzustellen:

# Normales Verhalten wie im obigen Beispiel:
{sunset(0,"17:00","22:00")}
Ergebnis (als Beispiel): 19:59:22

# Gleiches Beispiel mit CIVIL als 1. Parameter:
{sunset("CIVIL",0,"17:00","22:00")}
Ergebnis (als Beispiel): 19:59:22

# Gleiches Beispiel mit Eingabe der Höhe über Horizont als 1. Parameter:
{sunset("HORIZON=-6.0",0,"17:00","22:00")}
Ergebnis (als Beispiel): 19:59:22

# Gleiches Beispiel mit dem realen Sonnenuntergang auf 0 Grad als 1. Parameter:
{sunset("REAL",0,"17:00","22:00");;}
Ergebnis (als Beispiel): 19:22:07

== Kontrolle ==
Um die Zeiten zu kontrollieren können Sie in der FHEM-Befehlszeile den Befehl

<code>
list AussenlampeAn1
</code>

eingeben und mit der <Enter>-Taste (nicht "save-Button") bestätigen. Sie sehen dann (hier eine Ausgabe vom 17.01.2013) z.B. folgendes:

<nowiki>Internals:
DEF *{sunset(0,"17:00","22:00")} set EG.Diele.Aussenlampe on
NAME AussenlampeAn1
NR 225
NTM 17:37:09
REP -1
STATE Next: 17:37:09
TRIGGERTIME 1358527029
TYPE at
Attributes:
room Diele</nowiki>
Der Sonnenuntergang liegt am genannten Tag '''innerhalb''' des Start-/Ende-Zeitraums, so dass die Lampe um 17:37 Uhr eingeschaltet wird.

Die Ausgabe (gleiches Datum) von

<code>
list AussenlampeAus1
</code>

lautet:

<nowiki>Internals:
DEF *{sunrise(0,"05:00","07:30")} set EG.Diele.Aussenlampe off
NAME AussenlampeAus1
NR 228
NTM 07:30:00
REP -1
STATE Next: 07:30:00
TRIGGERTIME 1358490600
TYPE at
Attributes:
room Diele</nowiki>
Hier liegt der Sonnenaufgang noch '''außerhalb''' des Start-/Ende-Zeitraums, so dass die Lampe um 07:30 Uhr ausgeschaltet wird.

== Hinweise ==
* Da es [https://groups.google.com/forum/?fromgroups=#!topic/fhem-users/y2CbOQmTVsg Eintrag in der ehemaligen FHEM-Google-Group] entnehmen.
* Die ''sunset / sunrise'' Einstellungen arbeiten meist erst '''am nächsten Tag''' richtig. Das hängt zusammen mit einer Falschberechnung beim setzen dieses ''defines''. An einer Korrektur wird gearbeitet (Stand Januar 2013).
[[Kategorie:HOWTOS]]

SUNRISE EL

2013-11-05T10:41:26Z

Yfhem: /* Kontrolle */ Added space.

'''Lichtsteuerung per sunset / sunrise'''
== Voraussetzungen ==
In der ''fhem.cfg'' müssen Sie vorher Ihren Wohnsitz definieren, da der Sonnenauf- und -untergang ja nicht nur vom Datum, sondern auch vom Längen- und Breitengrad Ihres Standortes abhängig ist. Hierzu tragen Sie folgende Zeilen in die ''fhem.cfg'' ein:

<nowiki>attr global latitude 5X.XYZ
attr global longitude 6.XYZ</nowiki>
und zwar in genau dieser Schreibweise. Entweder benutzen Sie zur Bestimmung ein GPS-System oder sie befragen einen entsprechenden Internet-Dienst.

Als Internet-Dienst eignet sich beipielsweise [http://www.openstreetmap.org/#map=12/52.4994/13.4960 OpenStreetMap]. Die Werte latitude und longitude können aus der URL abgelesen werden. In diesem Beispiel latitude 52.4994 und longitude 13.4960.

== Steuerung ==
Mittels folgender Skriptzeilen in der ''fhem.cfg''
<nowiki># Außenlampe - Steuerung An-/Ausschaltzeit
define AussenlampeAn1 at *{sunset(0,"17:00","22:00")} set EG.Diele.Aussenlampe on
define AussenlampeAus1 at *{sunrise(0,"05:00","07:30")} set EG.Diele.Aussenlampe off</nowiki>
wird der Funk-Lichtschalter für die Außenbeleuchtung (hier das FHEM-Gerät mit dem Namen ''EG.Diele.Aussenlampe'')

* morgens zum Sonnenaufgang, aber nicht vor 05:00 und nicht nach 07:30 Uhr ausgeschaltet

und

* abends zum Sonnenuntergang eingeschaltet, aber nicht vor 17:00 Uhr und nicht nach 22:00 Uhr.

Im FHEM-Standard wird der sogenannte bürgerliche Sonnenuntergang/-aufgang genutzt.

Bis bzw. ab dieser Zeit ist das Lesen ohne zusätzliche Beleuchtung möglich.
Da dies nicht immer gewünscht ist, ist es möglich bei den sunrise/sunset-Funktionen *optional* als ersten Parameter vorne REAL, CIVIL, NAUTIC, ASTRONOMIC oder z.B. HORIZON=-6.0 oder "HORIZON -6.0" anzustellen:

# Normales Verhalten wie im obigen Beispiel:
{sunset(0,"17:00","22:00")}
Ergebnis (als Beispiel): 19:59:22

# Gleiches Beispiel mit CIVIL als 1. Parameter:
{sunset("CIVIL",0,"17:00","22:00")}
Ergebnis (als Beispiel): 19:59:22

# Gleiches Beispiel mit Eingabe der Höhe über Horizont als 1. Parameter:
{sunset("HORIZON=-6.0",0,"17:00","22:00")}
Ergebnis (als Beispiel): 19:59:22

# Gleiches Beispiel mit dem realen Sonnenuntergang auf 0 Grad als 1. Parameter:
{sunset("REAL",0,"17:00","22:00");;}
Ergebnis (als Beispiel): 19:22:07

== Kontrolle ==
Um die Zeiten zu kontrollieren können Sie in der FHEM-Befehlszeile den Befehl

<code>
list AussenlampeAn1
</code>

eingeben und mit der <Enter>-Taste (nicht "save-Button") bestätigen. Sie sehen dann (hier eine Ausgabe vom 17.01.2013) z.B. folgendes:

<nowiki>Internals:
DEF *{sunset(0,"17:00","22:00")} set EG.Diele.Aussenlampe on
NAME AussenlampeAn1
NR 225
NTM 17:37:09
REP -1
STATE Next: 17:37:09
TRIGGERTIME 1358527029
TYPE at
Attributes:
room Diele</nowiki>
Der Sonnenuntergang liegt am genannten Tag '''innerhalb''' des Start-/Ende-Zeitraums, so dass die Lampe um 17:37 Uhr eingeschaltet wird.

Die Ausgabe (gleiches Datum) von

<code>
list AussenlampeAus1
</code>

lautet:

<nowiki>Internals:
DEF *{sunrise(0,"05:00","07:30")} set EG.Diele.Aussenlampe off
NAME AussenlampeAus1
NR 228
NTM 07:30:00
REP -1
STATE Next: 07:30:00
TRIGGERTIME 1358490600
TYPE at
Attributes:
room Diele</nowiki>
Hier liegt der Sonnenaufgang noch '''außerhalb'''des Start-/Ende-Zeitraums, so dass die Lampe um 07:30 Uhr ausgeschaltet wird.

== Hinweise ==
* Da es [https://groups.google.com/forum/?fromgroups=#!topic/fhem-users/y2CbOQmTVsg Eintrag in der ehemaligen FHEM-Google-Group] entnehmen.
* Die ''sunset / sunrise'' Einstellungen arbeiten meist erst '''am nächsten Tag''' richtig. Das hängt zusammen mit einer Falschberechnung beim setzen dieses ''defines''. An einer Korrektur wird gearbeitet (Stand Januar 2013).
[[Kategorie:HOWTOS]]

SUNRISE EL

2013-11-05T10:33:07Z

Yfhem: /* Voraussetzungen */ Added ref to OSM.

'''Lichtsteuerung per sunset / sunrise'''
== Voraussetzungen ==
In der ''fhem.cfg'' müssen Sie vorher Ihren Wohnsitz definieren, da der Sonnenauf- und -untergang ja nicht nur vom Datum, sondern auch vom Längen- und Breitengrad Ihres Standortes abhängig ist. Hierzu tragen Sie folgende Zeilen in die ''fhem.cfg'' ein:

<nowiki>attr global latitude 5X.XYZ
attr global longitude 6.XYZ</nowiki>
und zwar in genau dieser Schreibweise. Entweder benutzen Sie zur Bestimmung ein GPS-System oder sie befragen einen entsprechenden Internet-Dienst.

Als Internet-Dienst eignet sich beipielsweise [http://www.openstreetmap.org/#map=12/52.4994/13.4960 OpenStreetMap]. Die Werte latitude und longitude können aus der URL abgelesen werden. In diesem Beispiel latitude 52.4994 und longitude 13.4960.

== Steuerung ==
Mittels folgender Skriptzeilen in der ''fhem.cfg''
<nowiki># Außenlampe - Steuerung An-/Ausschaltzeit
define AussenlampeAn1 at *{sunset(0,"17:00","22:00")} set EG.Diele.Aussenlampe on
define AussenlampeAus1 at *{sunrise(0,"05:00","07:30")} set EG.Diele.Aussenlampe off</nowiki>
wird der Funk-Lichtschalter für die Außenbeleuchtung (hier das FHEM-Gerät mit dem Namen ''EG.Diele.Aussenlampe'')

* morgens zum Sonnenaufgang, aber nicht vor 05:00 und nicht nach 07:30 Uhr ausgeschaltet

und

* abends zum Sonnenuntergang eingeschaltet, aber nicht vor 17:00 Uhr und nicht nach 22:00 Uhr.

Im FHEM-Standard wird der sogenannte bürgerliche Sonnenuntergang/-aufgang genutzt.

Bis bzw. ab dieser Zeit ist das Lesen ohne zusätzliche Beleuchtung möglich.
Da dies nicht immer gewünscht ist, ist es möglich bei den sunrise/sunset-Funktionen *optional* als ersten Parameter vorne REAL, CIVIL, NAUTIC, ASTRONOMIC oder z.B. HORIZON=-6.0 oder "HORIZON -6.0" anzustellen:

# Normales Verhalten wie im obigen Beispiel:
{sunset(0,"17:00","22:00")}
Ergebnis (als Beispiel): 19:59:22

# Gleiches Beispiel mit CIVIL als 1. Parameter:
{sunset("CIVIL",0,"17:00","22:00")}
Ergebnis (als Beispiel): 19:59:22

# Gleiches Beispiel mit Eingabe der Höhe über Horizont als 1. Parameter:
{sunset("HORIZON=-6.0",0,"17:00","22:00")}
Ergebnis (als Beispiel): 19:59:22

# Gleiches Beispiel mit dem realen Sonnenuntergang auf 0 Grad als 1. Parameter:
{sunset("REAL",0,"17:00","22:00");;}
Ergebnis (als Beispiel): 19:22:07

== Kontrolle ==
Um die Zeiten zu kontrollieren können Sie in der FHEM-Befehlszeile den Befehl

<code>
list AussenlampeAn1
</code>

eingeben und mit der <Enter>-Taste (nicht "save-Button") bestätigen. Sie sehen dann (hier eine Ausgabe vom 17.01.2013) z.B. folgendes:

<nowiki>Internals:
DEF *{sunset(0,"17:00","22:00")} set EG.Diele.Aussenlampe on
NAME AussenlampeAn1
NR 225
NTM 17:37:09
REP -1
STATE Next: 17:37:09
TRIGGERTIME 1358527029
TYPE at
Attributes:
room Diele</nowiki>
Der Sonnenuntergang liegt am genannten Tag '''innerhalb'''des Start-/Ende-Zeitraums, so dass die Lampe um 17:37 Uhr eingeschaltet wird.

Die Ausgabe (gleiches Datum) von

<code>
list AussenlampeAus1
</code>

lautet:

<nowiki>Internals:
DEF *{sunrise(0,"05:00","07:30")} set EG.Diele.Aussenlampe off
NAME AussenlampeAus1
NR 228
NTM 07:30:00
REP -1
STATE Next: 07:30:00
TRIGGERTIME 1358490600
TYPE at
Attributes:
room Diele</nowiki>
Hier liegt der Sonnenaufgang noch '''außerhalb'''des Start-/Ende-Zeitraums, so dass die Lampe um 07:30 Uhr ausgeschaltet wird.

== Hinweise ==
* Da es [https://groups.google.com/forum/?fromgroups=#!topic/fhem-users/y2CbOQmTVsg Eintrag in der ehemaligen FHEM-Google-Group] entnehmen.
* Die ''sunset / sunrise'' Einstellungen arbeiten meist erst '''am nächsten Tag''' richtig. Das hängt zusammen mit einer Falschberechnung beim setzen dieses ''defines''. An einer Korrektur wird gearbeitet (Stand Januar 2013).
[[Kategorie:HOWTOS]]

SUNRISE EL

2013-11-05T10:29:02Z

Yfhem: space added.

'''Lichtsteuerung per sunset / sunrise'''
== Voraussetzungen ==
In der ''fhem.cfg'' müssen Sie vorher Ihren Wohnsitz definieren, da der Sonnenauf- und -untergang ja nicht nur vom Datum, sondern auch vom Längen- und Breitengrad Ihres Standortes abhängig ist. Hierzu tragen Sie folgende Zeilen in die ''fhem.cfg'' ein:

<nowiki>attr global latitude 5X.XYZ
attr global longitude 6.XYZ</nowiki>
und zwar in genau dieser Schreibweise. Entweder benutzen Sie zur Bestimmung ein GPS-System oder sie befragen einen entsprechenden Internet-Dienst.

== Steuerung ==
Mittels folgender Skriptzeilen in der ''fhem.cfg''
<nowiki># Außenlampe - Steuerung An-/Ausschaltzeit
define AussenlampeAn1 at *{sunset(0,"17:00","22:00")} set EG.Diele.Aussenlampe on
define AussenlampeAus1 at *{sunrise(0,"05:00","07:30")} set EG.Diele.Aussenlampe off</nowiki>
wird der Funk-Lichtschalter für die Außenbeleuchtung (hier das FHEM-Gerät mit dem Namen ''EG.Diele.Aussenlampe'')

* morgens zum Sonnenaufgang, aber nicht vor 05:00 und nicht nach 07:30 Uhr ausgeschaltet

und

* abends zum Sonnenuntergang eingeschaltet, aber nicht vor 17:00 Uhr und nicht nach 22:00 Uhr.

Im FHEM-Standard wird der sogenannte bürgerliche Sonnenuntergang/-aufgang genutzt.

Bis bzw. ab dieser Zeit ist das Lesen ohne zusätzliche Beleuchtung möglich.
Da dies nicht immer gewünscht ist, ist es möglich bei den sunrise/sunset-Funktionen *optional* als ersten Parameter vorne REAL, CIVIL, NAUTIC, ASTRONOMIC oder z.B. HORIZON=-6.0 oder "HORIZON -6.0" anzustellen:

# Normales Verhalten wie im obigen Beispiel:
{sunset(0,"17:00","22:00")}
Ergebnis (als Beispiel): 19:59:22

# Gleiches Beispiel mit CIVIL als 1. Parameter:
{sunset("CIVIL",0,"17:00","22:00")}
Ergebnis (als Beispiel): 19:59:22

# Gleiches Beispiel mit Eingabe der Höhe über Horizont als 1. Parameter:
{sunset("HORIZON=-6.0",0,"17:00","22:00")}
Ergebnis (als Beispiel): 19:59:22

# Gleiches Beispiel mit dem realen Sonnenuntergang auf 0 Grad als 1. Parameter:
{sunset("REAL",0,"17:00","22:00");;}
Ergebnis (als Beispiel): 19:22:07

== Kontrolle ==
Um die Zeiten zu kontrollieren können Sie in der FHEM-Befehlszeile den Befehl

<code>
list AussenlampeAn1
</code>

eingeben und mit der <Enter>-Taste (nicht "save-Button") bestätigen. Sie sehen dann (hier eine Ausgabe vom 17.01.2013) z.B. folgendes:

<nowiki>Internals:
DEF *{sunset(0,"17:00","22:00")} set EG.Diele.Aussenlampe on
NAME AussenlampeAn1
NR 225
NTM 17:37:09
REP -1
STATE Next: 17:37:09
TRIGGERTIME 1358527029
TYPE at
Attributes:
room Diele</nowiki>
Der Sonnenuntergang liegt am genannten Tag '''innerhalb'''des Start-/Ende-Zeitraums, so dass die Lampe um 17:37 Uhr eingeschaltet wird.

Die Ausgabe (gleiches Datum) von

<code>
list AussenlampeAus1
</code>

lautet:

<nowiki>Internals:
DEF *{sunrise(0,"05:00","07:30")} set EG.Diele.Aussenlampe off
NAME AussenlampeAus1
NR 228
NTM 07:30:00
REP -1
STATE Next: 07:30:00
TRIGGERTIME 1358490600
TYPE at
Attributes:
room Diele</nowiki>
Hier liegt der Sonnenaufgang noch '''außerhalb'''des Start-/Ende-Zeitraums, so dass die Lampe um 07:30 Uhr ausgeschaltet wird.

== Hinweise ==
* Da es [https://groups.google.com/forum/?fromgroups=#!topic/fhem-users/y2CbOQmTVsg Eintrag in der ehemaligen FHEM-Google-Group] entnehmen.
* Die ''sunset / sunrise'' Einstellungen arbeiten meist erst '''am nächsten Tag''' richtig. Das hängt zusammen mit einer Falschberechnung beim setzen dieses ''defines''. An einer Korrektur wird gearbeitet (Stand Januar 2013).
[[Kategorie:HOWTOS]]

SUNRISE EL

2013-11-04T15:54:06Z

Yfhem: /* Voraussetzungen */

'''Lichtsteuerung per sunset / sunrise'''
== Voraussetzungen ==
In der ''fhem.cfg''müssen Sie vorher Ihren Wohnsitz definieren, da der Sonnenauf- und -untergang ja nicht nur vom Datum, sondern auch vom Längen- und Breitengrad Ihres Standortes abhängig ist. Hierzu tragen Sie folgende Zeilen in die ''fhem.cfg'' ein:

<nowiki>attr global latitude 5X.XYZ
attr global longitude 6.XYZ</nowiki>
und zwar in genau dieser Schreibweise. Entweder benutzen Sie zur Bestimmung ein GPS-System oder sie befragen einen entsprechenden Internet-Dienst.

== Steuerung ==
Mittels folgender Skriptzeilen in der ''fhem.cfg''
<nowiki># Außenlampe - Steuerung An-/Ausschaltzeit
define AussenlampeAn1 at *{sunset(0,"17:00","22:00")} set EG.Diele.Aussenlampe on
define AussenlampeAus1 at *{sunrise(0,"05:00","07:30")} set EG.Diele.Aussenlampe off</nowiki>
wird der Funk-Lichtschalter für die Außenbeleuchtung (hier das FHEM-Gerät mit dem Namen ''EG.Diele.Aussenlampe'')

* morgens zum Sonnenaufgang, aber nicht vor 05:00 und nicht nach 07:30 Uhr ausgeschaltet

und

* abends zum Sonnenuntergang eingeschaltet, aber nicht vor 17:00 Uhr und nicht nach 22:00 Uhr.

Im FHEM-Standard wird der sogenannte bürgerliche Sonnenuntergang/-aufgang genutzt.

Bis bzw. ab dieser Zeit ist das Lesen ohne zusätzliche Beleuchtung möglich.
Da dies nicht immer gewünscht ist, ist es möglich bei den sunrise/sunset-Funktionen *optional* als ersten Parameter vorne REAL, CIVIL, NAUTIC, ASTRONOMIC oder z.B. HORIZON=-6.0 oder "HORIZON -6.0" anzustellen:

# Normales Verhalten wie im obigen Beispiel:
{sunset(0,"17:00","22:00")}
Ergebnis (als Beispiel): 19:59:22

# Gleiches Beispiel mit CIVIL als 1. Parameter:
{sunset("CIVIL",0,"17:00","22:00")}
Ergebnis (als Beispiel): 19:59:22

# Gleiches Beispiel mit Eingabe der Höhe über Horizont als 1. Parameter:
{sunset("HORIZON=-6.0",0,"17:00","22:00")}
Ergebnis (als Beispiel): 19:59:22

# Gleiches Beispiel mit dem realen Sonnenuntergang auf 0 Grad als 1. Parameter:
{sunset("REAL",0,"17:00","22:00");;}
Ergebnis (als Beispiel): 19:22:07

== Kontrolle ==
Um die Zeiten zu kontrollieren können Sie in der FHEM-Befehlszeile den Befehl

<code>
list AussenlampeAn1
</code>

eingeben und mit der <Enter>-Taste (nicht "save-Button") bestätigen. Sie sehen dann (hier eine Ausgabe vom 17.01.2013) z.B. folgendes:

<nowiki>Internals:
DEF *{sunset(0,"17:00","22:00")} set EG.Diele.Aussenlampe on
NAME AussenlampeAn1
NR 225
NTM 17:37:09
REP -1
STATE Next: 17:37:09
TRIGGERTIME 1358527029
TYPE at
Attributes:
room Diele</nowiki>
Der Sonnenuntergang liegt am genannten Tag '''innerhalb'''des Start-/Ende-Zeitraums, so dass die Lampe um 17:37 Uhr eingeschaltet wird.

Die Ausgabe (gleiches Datum) von

<code>
list AussenlampeAus1
</code>

lautet:

<nowiki>Internals:
DEF *{sunrise(0,"05:00","07:30")} set EG.Diele.Aussenlampe off
NAME AussenlampeAus1
NR 228
NTM 07:30:00
REP -1
STATE Next: 07:30:00
TRIGGERTIME 1358490600
TYPE at
Attributes:
room Diele</nowiki>
Hier liegt der Sonnenaufgang noch '''außerhalb'''des Start-/Ende-Zeitraums, so dass die Lampe um 07:30 Uhr ausgeschaltet wird.

== Hinweise ==
* Da es [https://groups.google.com/forum/?fromgroups=#!topic/fhem-users/y2CbOQmTVsg Eintrag in der ehemaligen FHEM-Google-Group] entnehmen.
* Die ''sunset / sunrise'' Einstellungen arbeiten meist erst '''am nächsten Tag''' richtig. Das hängt zusammen mit einer Falschberechnung beim setzen dieses ''defines''. An einer Korrektur wird gearbeitet (Stand Januar 2013).
[[Kategorie:HOWTOS]]

DevelopmentIntroduction

2013-10-29T11:42:52Z

Yfhem: /* Application Lifecycle */ Improved list.

= Developer's Introduction to FHEM =
== Introduction ==
This page is intended to give an introduction to the FHEM application from a developer's perspective. If you're interested in extending, modifying or reusing the FHEM code, then hopefully you will find this a useful document. Note that this document is a work in progress! I myself at the time of writing this have only a few hours of experience under my belt, but I'm documenting things I learn as I learn them.

== Application Lifecycle ==
When you first launch the FHEM server, the following activities take place:

# Application variables are initialised
# The valid application commands are loaded into a structure (%cmds) with the corresponding function name to call
# Do the job, either act as client or server. One of the following applies:
## If the application has been called as a FHEM client (eg perl fhem.pl 127.0.0.1:7072 commandToExecute)
### Connect to the FHEM server
### Execute the command
### Exit the program
## Otherwise (the application has been started as a server)
### Execute each of the commands listed in the configuration file to initialise the server (see the CommandInclude and then the AnalyzeCommandChain methods)
### Execute each of the commands in the state file if configured to restore the devices to the last state recorded when the server last ran
### Start the main application loop

== Main Application Loop ==
The following code is repeated until the application ends:

# For each input device (eg FHZ1000 / FHZ1300 / CUL):
## Use that device module's Ready and Read functions to read data from the device
## For CUL devices, the data is read and parsed at this point
## For FHZ devices, the FHZ_CheckCRC method is used to validate the received data
## Call the Dispatch method in FHEM.pl to pass the message onto the correct device and corresponding module (Parse function)
</li><li> $server->fileno() is used to check for and accept new connections to the server
</li><li> For each connected client:
# Read data from the client using sysread
# Pass the received input into the AnalyzeInput method to execute the command
</li></ol>
== Configuration and State Files ==
Note that these are just lists of commands to execute in a text file! So anything in these files will be interpreted by FHEM in the exact same way if a user keys the commands manually into a client application, eg a telnet connection.

== Readings ==
The following mechanism is recommended for updating readings. It saves lines of codes and automatically makes your module honor the event-on-update-reading and event-on-change-reading attributes.

Before you start updating readings, write (in case $hash = $defs{<device>})

<nowiki>readingsBeginUpdate($hash);</nowiki>
For every reading you update, write

<nowiki>readingsBulkUpdate($hash,$reading,$value);</nowiki>
Terminate with

<nowiki>readingsEndUpdate($hash, $dotrigger);</nowiki>
The $dotrigger parameter should be 0 for updates initiated by fhem message dispatcher as the dispatcher already calls DoTrigger on its behalf. $dotrigger should be 1 for updates initiated by internal timers, e.g. for polling devices.

As a shorthand notation for updating just one reading write

<nowiki>readingsSingleUpdate($hash,$reading,$value,$dotrigger);</nowiki>
which is the same as

<nowiki>readingsBeginUpdate($hash);
readingsBulkUpdate($hash,$reading,$value);
readingsEndUpdate($hash, $dotrigger);</nowiki>
== STATE ==
Vorschlag zur Umsetzung, diskutiert [https://groups.google.com/forum/?hl=de&fromgroups#!topic/fhem-developers/vqCx4M4X5l0 hier].

In den [[DevelopmentGuidelines]], Kapselung, Standardisierung der Vorgehensweise.

Die Funktion '''readingsEndUpdate'''aktualisiert $hash->{STATE} grundsätzlich immer bei jedem Aufruf nach folgendem Algorithmus:

Falls $sr= $attr{$name}{stateReading} gesetzt ist:

<nowiki>Fall 1: wenn $sr =~ "^{.*}$" dann eval "\$hash->{STATE} = $sr";
Fall 2: sonst $hash->{STATE}= $hash->{READINGS}{$sr}{VAL}</nowiki>
sonst

<nowiki>Falls es $hash->{READINGS}{state} gibt, $hash->{STATE}= $hash->{READINGS}{state}{VAL}</nowiki>
sonst

<nowiki>Tue nichts (das Modul hat sich gekuemmert).</nowiki>
Ausserdem wird

<nowiki>ReplaceEventMap()</nowiki>
losgelassen, um die EventMaps des Anwenders auch im STATE zur Anwendung zu bringen.

Aus '''DoTrigger'''werden

<nowiki>$defs{$dev}{STATE} = ReplaceEventMap($dev, $defs{$dev}{STATE}, 1);</nowiki>
und

<nowiki># STATE && {READINGS}{state} should be the same
my $r = $defs{$dev}{READINGS};
$r->{state}{VAL} = $defs{$dev}{STATE} if($r && $r->{state});</nowiki>
entfernt.

== Global Attributes ==
In fhem.pl existiert ein

<nowiki>my $AttrList = "room comment alias ...";</nowiki>
Weiterhin kann jedes Modul im Initialize mit addToAttrList eigene Attribute zu
global userattr hinzufuegen.

[[Kategorie:Development]]

Neues Charting Frontend

2013-10-27T19:32:04Z

Yfhem: Fixed typo.

Diese Anleitung beschreibt die Installation und Konfiguration des neuen ExtJS-Frontends, das u.a. eine auf Javascript basierende Chartingfunktion bietet.

[[File:Frontend1.png|200px|right|thumb]]
[[File:Frontend_current.jpg|200px|right|thumb]]
[[File:Frontendtable.jpg|200px|right|thumb]]

== Aktueller Funktionsumfang ==

* Anzeige von Charts mit mehreren, frei wählbaren Y-Achsen (FHEM Geräte und Readings wählbar)
* Charts können dynamisch (z.B. heutiger Tag) oder über einen festen Zeitraum angezeigt werden
* Charts können generalisiert werden, um auch größere Datenmengen im Browser mit akzeptabler Geschwindigkeit darzustellen
* Charts können mit Statistikfunktionen erstellt werden, z.B. mit Durchschnittswerten für einen gewissen Zeitraum (Average per Hour, Max per day, ...)
* Charts können Solllinien hinzugefügt werden mit wählbarem Start- und Endwert
* Chartachsen können selektiv ein- und ausgeschaltet werden durch Klick auf die Legende
* Charts können eingefärbt werden mit Farbe nach Wahl, zudem ist eine Füllung möglich
* Charts können gezoomt werden mit Hilfe der Maus durch Aufziehen einer Box direkt im Chart
* Charts werden bei Bedarf in der Datenbank über DbLog abgespeichert und können im Frontend auch wieder gelöscht werden
* "Database Tables" ermöglicht die Anzeige des gesamten Datenbankinhalts in einer Tabelle im Browser, egal wie groß diese ist.
* Anzeige der verfügbaren Geräte über den linken Bereich. Nach Auswahl eines Gerätes erhält man die Übersicht zu den aktuellen Readings.

Die Werte in dieser Ansicht werden automatisch alle 5 Sekunden aktualisiert. Zudem ist die Steuerung von "sets" möglich (on / off Button, Dropdown, etc.)

* FHEM Kommandozeile, die mit Enter-Taste und dem Execute Button bedient werden kann.
* Save Button, der wie bisher bekannt die Änderungen in der fhem.cfg speichert.
* Shutdown und Restart Buttons, über die sich FHEM herunterfahren oder neustarten lässt. Bei einem Restart wird die Seite, sobald FHEM wieder hochgefahren ist, automatisch neugeladen

Zwingende Voraussetzung für die Nutzung des Frontends ist eine Datenbank und das Einbinden des Moduls 93_DbLog, da u.a. für das Charting auf die geloggten Daten zugegriffen wird.
Daher ist eine Installation nur auf Systemen möglich, die die entsprechenden Perl Module mitbringen, bzw. nachinstallieren lassen.

Nach derzeitigem Stand ist die Installation inzwischen sogar neben PCs, Synologys und Raspberrys auch auf Fritzboxen möglich. Dazu bitte auch die Anleitung [[Cpan auf Fritzbox]] beachten.


== Installation ==
=== Basisinstallation ===

#FHEM auf den neuesten Stand bringen mit dem Befehl "update".
#In FHEM oder über telnet den folgenden Befehl aufrufen und ein paar Minuten warten:
<nowiki>update thirdparty http://svn.code.sf.net/p/fhem/code/trunk/fhem/www/frontend frontend</nowiki>

=== DbLog installieren und konfigurieren ===
[http://fhem.de/commandref_DE.html#DbLog DbLog] muss, falls noch nicht geschehen, konfiguriert werden. Dazu wie folgt vorgehen:

* Eine Datenbank sollte installiert sein. MySQL, Postgres, SQLite oder Oracle.
* Unter Umständen müssen fehlende Perl Module nachinstalliert werden.

Ob dies nötig ist fällt spätestens auf, wenn im übernächsten Schritt die fhem.cfg angepasst und fhem neu gestartet wurde.
Dann sollten sich bei Problemen im Log von fhem entsprechnde Hinweise finden.
Unter Linux installiert man die Module z.B. für SQLite mit <code>apt-get install libdbi-perl libdbd-sqlite3-perl</code>. Alternativ auch direkt über Perl möglich mit cpan ([http://fhem.de/commandref_DE.html#DbLog DbLog commandref]). Auf einer Synology kann der folgende Beitrag helfen: [http://forum.fhem.de/index.php/topic,11071.0.html DBLog auf Synology]

* Die Datenbank muss nun vorbereitet werden, sprich es müssen zumindest 2 Tabellen erstellt werden.

Beispielscripte findet man z.B. bei [http://fhem.svn.sourceforge.net/viewvc/fhem/trunk/fhem/contrib/dblog/ sourceforge].
Es muss also eine Tabelle '''history''' und eine Tabelle '''current''' erstellt werden, wie in den Beispiel SQLs zu sehen ist.
Anschließend muss die Datei db.conf angepasst werden.
Dort müssen der Datenbankname, der Benutzer und das Passwort für die Datenbank eingetragen werden. Beispiele dazu findet man auch in dem vorigen Link.

* In die fhem.cfg muss eine Zeile eingefügt werden, die definiert, was alles über DbLog gespeichert werden soll.

Diese Zeile kann z.B. so aussehen (loggt alles in die Datenbank):

<nowiki>define myDbLog DbLog /etc/fhem/db.conf .*:.*</nowiki>
oder, für ein konkretes Gerät (Groß/Kleinschreibung beachten!):

<nowiki>define logdb DbLog db.conf ESA2000_LED_011e</nowiki>
* FHEM neu starten und ins FHEM-Log schauen. FHEM sollte hochfahren und auch loggen, dass es zur Datenbank verbunden ist.

Tut es das nicht oder FHEM startet gar nicht, liegt eine Fehlkonfiguration vor. Dann nochmals die vorherigen Schritte prüfen und das Logfile nach dem Problem befragen.

=== Datenbank vorbereiten ===
Zuletzt muss in der Datenbank eine Tabelle für das Frontend erstellt werden.

Für MySQL kann folgendes SQL in der Datenbank abgesetzt werden:
:<code>CREATE TABLE frontend (ID int NOT NULL UNIQUE AUTO_INCREMENT, TIMESTAMP TIMESTAMP DEFAULT CURRENT_TIMESTAMP, TYPE varchar(64), NAME varchar(64), VALUE TEXT)</code>
Für SQLite3 kann folgendes SQL in der Datenbank abgesetzt werden:
:<code>CREATE TABLE frontend (ID INTEGER PRIMARY KEY, TIMESTAMP TIMESTAMP DEFAULT CURRENT_TIMESTAMP, TYPE TEXT, NAME TEXT, VALUE TEXT);</code>
Für Postgres kann folgendes SQL in der Datenbank abgesetzt werden:
:<code>CREATE TABLE frontend (ID SERIAL, TIMESTAMP TIMESTAMP (0) DEFAULT LOCALTIMESTAMP, TYPE TEXT, NAME TEXT, VALUE TEXT);</code>

Sollte DbLog nun laufen, kann das Frontend über <code>Adresse_des_Servers:8083/fhem/frontend/index.html</code> aufgerufen werden, z.B.

<nowiki>http://192.168.0.100:8083/fhem/frontend/index.html</nowiki>
Sollte DbLog noch nicht entsprechend konfiguriert sein, so bekommt man hier entsprechendes Feedback.
Ansonsten ist das Frontend nun einsatzbereit. Für eine Bedienungsanleitung siehe im unteren Abschnitt "Bedienung".

== Das Frontend Updaten ==
In FHEM oder über telnet den folgenden Befehl aufrufen und ein paar Minuten warten:

<nowiki>update thirdparty http://svn.code.sf.net/p/fhem/code/trunk/fhem/www/frontend frontend</nowiki>

== Bedienung ==
Ziel des Frontends ist eine möglichst selbsterklärende Bedienung. Fragen und Probleme können jederzeit im Forum, am besten in [http://forum.fhem.de/index.php/topic,10439.0.html diesem Beitrag] gestellt werden. Eine Anleitung folgt, sobald ich mehr Zeit dazu finde...

== Installation auf einem Raspberry Pi (Anleitung von "Puschel") ==
Diese Anleitung funktioniert auch auf einem BeagleBone Black mit Debian.

===Hardwarevoraussetzungen===
* RasPi Model B
* Funktionierende Internetanbindung
===Softwarevoraussetzungen===
* Deutsches Tastaturlayout (j für Ja)
* Funktionsfähige FHEM-Installation auf RPi Wheezy, welche mittels update auf den letzten Stand gebracht wurde (siehe auch: [[:Kategorie:Raspberry_Pi|Raspberry Pi]])
* Das Frontend wurde installiert mittels
:<code>update thirdparty <nowiki>http://svn.code.sf.net/p/fhem/code/trunk/fhem/www/frontend</nowiki> frontend</code>
* Zugriff auf den RPi mittels Putty ist gegeben.
* Zugriffsberechtigungen der Ordner sind auch gegeben (Schreiben in /opt/fhem)

:<code><Befehl></code> = diese Zeile wird am Putty-Prompt eingegeben (ohne <>)
:<code><IP_des_RPi></code> = IP-Adresse über der der RPi erreichbar ist

Was wird gemacht?

Wir werden das neue Chart-Frontend mittels SQLite3 und allen benötigten Bibliotheken auf dem RPi einrichten.

# Wir verbinden uns per Putty mit unserem RPi und loggen uns ein.
# Um uns das ständige sudo zu ersparen geben wir als erstes ein <sudo bash> ein.
# <apt-get update>
# <apt-get upgrade> und die Nachfrage mit „j“ beantworten
# <apt-get install sqlite3>
# <apt-get install libdbi-perl libdbd-sqlite3-perl>
# <apt-get install –f> (das "-" hier ggf. in der Putty-Sitzung überschreiben; unter Umständen stimmt der Hex-Code des Zeichens nach Copy/Paste nicht)

Was haben wir bis hierher gemacht?

* Wir haben die Pakete für unser RPi neu eingelesen.
* Wir haben unsere RPi-Paketinstallation auf den neuesten Stand gebracht.
* Wir haben sqlite3 installiert.
* Wir haben die benötigten Bibliotheken installiert.
* Wir haben alle Abhängigkeiten aufgelöst und fehlende Pakete nachinstallieren lassen.</nowiki>

Nun bereiten wir unsere Datenbank vor.

In Putty geben wir als erstes ein <cd /opt/fhem> ein.

Nun werden alle Dateien in diesem Ordner erstellt – wer will kann das natürlich anpassen.

Anschliessend geben wir am Putty-Promt <sqlite3 fhem.db> ein.

Damit haben wir unsere Datenbank angelegt und diese fhem.db genannt. Nun zeigt unser Prompt in Putty sqlite3> an. Wir befinden uns also in unserer Datenbank.

In dieser Datenbank werden wir noch 2 TABLES anlegen – einmal current und einmal history. Dies könnt ihr einfach per copy&paste übernehmen.

:<code>CREATE TABLE `history` (TIMESTAMP TIMESTAMP, DEVICE varchar(32), TYPE varchar(32), EVENT varchar(512), READING varchar(32), VALUE varchar(32), UNIT varchar(32));</code>

:<code>CREATE TABLE `current` (TIMESTAMP TIMESTAMP, DEVICE varchar(32), TYPE varchar(32), EVENT varchar(512), READING varchar(32), VALUE varchar(32), UNIT varchar(32));</code>

Und noch eine für das Frontend:
:<code>CREATE TABLE frontend (ID INTEGER PRIMARY KEY, TIMESTAMP TIMESTAMP DEFAULT CURRENT_TIMESTAMP, TYPE TEXT, NAME TEXT, VALUE TEXT);</code>

Nun können wir
* mit <code><.tables></code> schauen, ob 3 Einträge auftauchen (current, history, frontend)
* mit <code><.exit></code> verlassen wir SQLite3 und kehren wieder auf unseren Putty-Prompt zurück.

Bevor wir nun in fhem DBLog definieren, müssen wir erst unsere db.conf anlegen. Dies geschieht mittels <code><nano db.conf></code>.

Gefüllt wird diese Konfigurationsdatei mit

<nowiki> %dbconfig= (
connection => "SQLite:dbname=/opt/fhem/fhem.db",
user => "",
password => ""
);</nowiki>
Mit STRG+X und „j“ abspeichern und nano wieder verlassen.

Im Ordner /opt/fhem sollten nun also zusätzlich die Dateien db.conf und fhem.db liegen.

Ist das der Fall und die fhem.db hat die benötigten Rechte, können wir in fhem unser DBLog definieren. Ich habe der Einfachheit halber der Gruppe und jedem Benutzer Schreibzugriff gewährt.

Dies geschieht mittels

<chmod -R g+w fhem.db>
<chmod -R o+w fhem.db>
in der Putty-Eingabe, da fhem gemeckert hat, dass es nicht in die Datei schreiben kann ("-" ggf wieder überschreiben nach Copy/Paste).

Nun also noch unser

:<code>define myDbLog DbLog /opt/fhem/db.conf .*:.*</code>
in fhem eingetragen und ab hier wird nun ALLES in die Datenbank geschrieben.

Nun können wir in unserem Browser (getestet mit Firefox 19.0.2) auf unser Frontend zugreifen:

<nowiki>http://<IP-des_RPi>:8083/fhem/frontend/index.html</nowiki>
Achtung! Nicht erschrecken, wenn beim ersten Zugriff nur eine leere Seite erscheint. Einfach den Browser aktualisieren und am neuen Frontend erfreuen.

Getestet: 26.03.2013

==Links==
* [http://forum.fhem.de/index.php/topic,10439.0.html Forumsdiskussion über dieses Frontend]; bei Problemen, Fragen oder Wünschen am besten dort eine Frage oder Nachricht hinterlassen.

[[Kategorie:Glossary]]
[[Kategorie:FHEM Frontends]]

Junkers Therme Stetigregelung

2013-10-23T20:09:12Z

Yfhem: /* Ansteuerung einer Junkerstherme mit einer Steuerspannung von 3-22V (0-32V möglich) */ Improved understanding, fixed typo.

[[Kategorie:Examples]]

=Ansteuerung einer Junkerstherme mit einer Steuerspannung von 3-22V (0-32V möglich)=

Viele Heizungsthermen haben eine Regelung über einen Kontakt an dem eine feste Spannung anliegt oder eben nicht anliegt. Also als Beispiel: 0V Heizung aus – 12V Heizung an, es gibt keine weiteren Zwischenstufen. Für diese Thermen ist diese Anleitung unzweckmäßig.
Bei einigen Junkersthermen ist dies jedoch anders 3V => 0% bis 22V => 100%. Es sind beliebige Zwischenwerte möglich. Ob man eine solche Heizung hat, kann man einfach feststellen in dem man die Steuerspannung bei angeschlossenem Regler misst. Junkers nennt diese Regler auch Raumtemperaturregler mit Stetigausgang.
Beobachtung (kein Wissen): Über diese Steuerspannung wird der Brenner in Abhängigkeit der Rücklauf gesteuert. Umso niedriger die Steuerspannung desto später (tiefere Rücklauftemperatur) beginnt die Therme zu heißen. Bei der vorhandenen Junkertherme kann die Vorlauftemperatur nicht über die Steuerspannung eingestellt werden.

==Ziel dieses Projektes==

<ul>
<li>Keine Veränderung der Therme (Sicherheits-, Versicherungs- ,Garantie-Gründe)</li>
<li>Sicher: Für den Fall eines Defekts der automatischen Steuerung soll der alte Regler soll erhalten</li>
<li>Erzeugen einer Spannung von 3-22Volt (Simulation des bisherigen Raumtemperaturreglers)</li>
<li>Messung der Vorlauf und Rücklauftemperatur</li>
<li>Günstig</li>
<li>Geringe Energieaufnahme</li>
<li>Ansteuerung mittels Netzwerk</li>
<li>Integration in FHEM</li>
</ul>

==Umsetzung==

<ul>
<li>Pollin AVR-NET-IO-Board</li>
<li>Software: Ethersex</li>
<li>kleine Zusatzplatine für die Spannungserzeugung (wird einfach parallel zu dem bestehenden Regler angeschlossen)</li>
<li>Messung der Vorlauf und Rücklauftemperatur mittels OneWire</li>
</ul>

==Vorbereitung 1==
[[File:Junkers_Therme_Stetigregelung_analoge_Anzeige.JPG|120px|right|thumb|Steuersignal]]
Da die Heizungsregelung eine sehr sensible Sache ist besonders bezüglich Frostschäden (beim Ausfall der automatischen Steuerung) und persönlicher Befindlichkeiten musste eine einfache und extrem ausfallsichere Kontrolleinheit her. Hierfür wird einfaches Drehspulmessinstrument verwendet. Anzeigewerte: 0V=Fehler, 3V=Heizung aus, 22V=Therme 100%.
Der alte Raumtemperaturregler ist weiterhin aktiv, momentan ist er auf 12°C Solltemperatur gestellt. Das bedeutet:
<ol>
<li>Wenn die automatische Reglung ausfällt, aktiviert der alte Raumtemperaturregler die Heizung bevor Frostschäden entstehen können.</li>
<li>Wenn die automatische Reglung ausfällt, kann die Therme einfach durch einstellen einer neuen Solltemperatur aktiviert werden.</li>
</ol>
Beide Fälle sind auf Grund von Ausfällen eines anderen FHEM-Systems im ersten Winter aufgetreten.

==Vorbereitung 2==
<p>
[[File:Junkers Therme Stetigregelung Signalverteiler.JPG|80px|right|thumb|Steuersignal]]
Die Leitung zu dem bisherigen Regler muss gesplittet werden. Hierfür die Heizung ausschalten (Sicherung auslösen) die Leitung auftrennen und einen Abzweig für die neue Regelung einfügen. Das Ganze kann mit einer Schmelzsicherung (für die 24V VCC Leitung) und einem 3poligem-Schalter (vollständiges Wegschalten der automatischen Regelung) versehen werden.
</p>

==Vorbereitung 3==
<p>
Netzwerk zu der Therme oder das Steuersignal zum Netzwerk ziehen. Das AVR-NET-IO-Board kann irgendwo in die Steuersignal-Leitung eingesetzt werden. Theoretisch kann auch die 24V Spannungsversorgung für den ursprünglichen Raumtemperaturregler verwendet werden. Hier muss einfach ein DC/DC-Wandler eingesetzt werden. (Bitte Leistungsabgabe der Heizung und Leistungsaufnahme des AVR-NET-IO-Board überprüfen)
</p>

==Digital-to-Analog-Converter==

Die Schaltung besteht aus einem DAC (LTC1257) und einem Operationsverstärker (LM358). Der LTC1257 wandelt (bei interner Referenzspannung) einen digital übermittelten Wert (über die Eingänge CLK, DIN und LOAD) in eine Spannung von 0-2,048V. Diese Spannung wird anschließend von dem LM358 erhöht. Die Elemente R1,R2, C1 und C2 gehören zur Grundbeschaltung des LTC1257. Mittels der Widerstände R3 und R4 wird der Verstärkungsfaktor der Operationsverstärkerschaltung eingestellt. Der OP ist als nicht invertierender Verstärker ausgeführt. Mit zwei Widerständen könnte aus dem LM358 eine doppelte invertierende Verstärkerschaltung (in Reihe geschaltete) aufgebaut werden. Das würde die Genauigkeit erhöhen. Die Schaltung funktioniert jedoch einwandfrei und eine höhere Genauigkeit wird vermutlich nur selten einen Vorteil bieten.
In diesem Fall ist hat VCC_Therme eine Spannung von 24V. Der LM358 kann bis 32V arbeiten, dann muss jedoch der Widerstandswert von R4 erhöht werden. An dem Steuersignal_Therme liegt je nach dem welchen Wert der LTC1257 gerade in einen anlogen Wert umsetzt eine Spannung von 0-24V. Diese Schaltung kann eingesetzt werden um Junkers-Thermen mit „Stetigeingang“ anzusteuern.

[[File:Junkers_Therme_Stetigregelung_0MP.png|center|alt=Variante 1 - keine Messpunkte]]

Variant 2: Die Ausgangsspannung der Schaltung kann zwischen dem Widerstand R3 und R4 von einem ADC gemessen werden. Da an R4 über 90% der Spannung abfällt, kann die Messung problemlos mittels eines 5V ADCs erfolgen.

[[File:Junkers_Therme_Stetigregelung_1MP.jpg|center|alt=Variante 2 - ein Messpunkt]]

In der Varianten 3 ist eine Sicherheitsfunktion eingebaut, welche durchaus sinnvoll ist. Die Diode D1 verhindert, dass diese Schaltung die Spannung unter einem Wert des alten externen Reglers zieht. Diese Schaltung ist so dimensioniert, dass bei Verwendung eines Junkers TRQ 21 Raumtemperaturreglers, die Therme von dieser Ansteuerung oder von dem TRQ 21 eingeschaltet werden kann. Wenn die Diode entfällt, kann diese Steuerung die Spannung von 0V ziehen und die Therme ausschalten. Im Fehlerfall und starkem Frost kann das unschön sein. Da an der Diode eine Spannung abfällt ist die Messung von Messpunkt 1 immer um diesen Wert geringer als an Messpunkt 2. Das ist aber kein Problem.

[[File:Junkers_Therme_Stetigregelung_2MP.png|center|alt=Variante 2 - ein Messpunkt]]

==Prototyp der Schaltung==

Der Aufbau des Prototypen erfolgte auf einer Punkt-Streifenrasterplatine (Immer drei Punkte einer Reihe sind miteinander verbunden (s. blaue Markierungen)). Um die Schaltung nachzubauen sind keine besonderen Lötkenntnisse erforderlich. Da nur wenige Brücken eingelötet werden müssen, lohnt sich eine fertige Platine nicht. Die Widerstände R4 und R6 sind jeweils als zwei Widerstände ausgeführt.

[[File:Junkers_Therme_Stetigregelung_Prototyp.jpg|center|alt=Variante 2 - ein Messpunkt]]

==Pinzuordnung==

Die Verbindung zu dem AVR-NET-IO-Board erfolgt über die Pins der SUB-D Anschlussplatine (Kx):
<ul>
<li>CLK -> K12 -> PA2</li>
<li>DIN -> K11 -> PA1</li>
<li>LOAD -> K9 -> PC7</li>
<li>Messpunkt1 -> K10 -> PA0</li>
<li>Messpunkt2 -> K13 -> PA3</li>
<li>Onewire -> KK3 -> PC1</li>
</ul>

==Ethersex==

Die Firmware der AVR-NET-IO-Boards wird durch eine erweiterte Firmware ausgetauscht.

Der Vorgang ist hier beschrieben: [[AVR-NET-IO#Konfiguration_und_Flashen_von_ethersex]]

===Ethersex-Bauen===
Als Buildumgebung kann freetz-linux 1.1.1 verwendet werden. freetz-linux läuft sehr gut als Virtuelle Maschine in Virtual Box (unter Windows). Der AVR-ISP-Programmer lässt sich in die VM durchreichen. Eine Programmierung des ATMega kann so aus der VM erfolgen. Bei einem Test mit einer neueren freetz-linux Version schlug der Build-Vorgang fehl. In der Datei pinning/hardware/netio.m4 sind die PIN-Zuordnungen. Mittels „make menuconfig“ kann alles Mögliche eingestellt werden und mittels „make“ wird Ethersex für das AVR-NET-IO-Board erstellt.

===Ethersex-Flashen===
Die Datei ethersex.hex aus dem tar Archive auf den Atmega 644 flashen. Hierfür eignet sich der AVRISP aus Hongkong von eBay (unter 4€ incl. Porto). Nicht vergessen die Fuses zu setzten.

==Teileliste==
Preise sind grob gerundet

<ul>
<li>eBay</li>
<ul>
<li>AVRISP-Programmer um Ethersex auf den AVR zu flashen 4€ (wenn nicht schon vorhanden)</li>
</ul>
<li>Pollin</li>
<ul>
<li>AVR-NET-IO - Fertigmodul 28€ (als Bausatz 8€ günstiger)</li>
<li>ATmega644-20PU 7€ (optional)</li>
<li>2x Temperatur-Sensor DS18S20 5€</li>
<li>5V-Netzteil EcoFriendly 5€ (ein einfaches USB-Ladegerät reicht)</li>
<li>Bausatz SUB-D Anschlussplatine 4€</li>
<li>Versandkosten 5€</li>
</ul>
<li>Reichelt</li>
<ul>
<li>LTC 1257 CN8 7€</li>
<li>Platine+Kleinteile < 10€</li>
<li>Versandkosten 6€</li>
</ul>
</ul>

Zusammen ca. 55-85€

==Erste Inbetriebnahme==
<ol>
<li>
Versuchen das AVR-NET-IO-Board per Ping zu erreichen. <br>(Die Datei aus dem tar-Archive sollte in dem Netz 192.168.178.0/24 sein)
</li>
<li>
Versuchen auf die Konsole des AVR-NET-IO-Board zuzugreifen Port: 2701 (Mit Putty, TerraTerm, netcat, ...)
</li>
<li>
Verfügbare Befehle ansehen:<br>
Befehl: help
</li>
<li>
OneWire Geräte auf Konsole scannen: 1w list<br>
Es sollten zwei Geräte (Vorlauftemperatur, Rücklauftemperatur) gefunden werden.<br>
Befehl: 1w list<br>
Ausgabe: 1069ad4d020800d8<br>
Ausgabe: 10884e5b0208002d<br>
Ausgabe: OK<br>
</li>
<li>
Temperatur einlesen:<br>
Befehl: 1w get 1069ad4d020800d8<br>
Ausgabe: 26.4<br>
</li>
<li>
Steuersignal der Heizung abfragen<br>
Befehl: adc get 0<br>
Ausgabe: 04D<br>
Befehl: adc get 3<br>
Ausgabe: 04F<br>
</li>
<li>
Steuersignal auf Maximum stellen<br>
Befehl: ltc1257_set 2000<br>
Ausgabe: OK<br>
</li>
<li>
Steuersignal der Heizung erneut abfragen<br>
Befehl: adc get 0<br>
Ausgabe: 0BF<br>
Befehl: adc get 3<br>
Ausgabe: 0C9<br>
</li>
</ol>

==Ermittlung der Betriebspunkte==

Wichtig sind vier Werte:
<ol>
<li>Messwert (ADC) für den Betriebspunkt Therme 0%</li>
<li>Messwert (ADC) für den Betriebspunkt Therme 100%</li>
<li>Stellwert (DAC) für den Betriebspunkt Therme 0%</li>
<li>Stellwert (DAC) für den Betriebspunkt Therme 100%</li>
</ol>

===Ermitteln der Messwerte===
Vorbereitung den Operationsverstärker (LM358) aus der Schaltung entfernen.
Minimalwert: Messwert wenn der Raumtemperaturregler die Therme ausschaltet. Hierfür den Raumtemperaturregler auf minimale Temperatur einstellen. Die Steuersignalspannung sollte ca. 3V betragen. Mittels „adc get“ den Wert ermitteln und ausschreiben.
Maximalwert: Messwert wenn der Raumtemperaturregler die Therme auf 100%. Hierfür den Raumtemperaturregler auf maximale Temperatur einstellen. Die Steuersignalspannung sollte ca. 18-22V betragen. Mittels „adc get“ den Wert ermitteln und ausschreiben.

===Ermitteln der Stellwerte===
Vorbereitung den Operationsverstärker (LM358) wieder in die Schaltung einsetzen. Und den Raumtemperaturregler auf minimale Raumtemperatur einstellen.
Jetzt werden die Stellwerte ermittelt. Der Sollwert des LTC1257 langsam erhöht und der aktuelle Wert mittels des ADC gemessen. Hierfür werden abwechselnd die Befehle: „ltc1257_set SOLLWERT“ und „adc get“ verwendet. Beide Werte auschreiben.

==Integration in FHEM==

In FHEM muss das Setzen der Sollwerte und die Erfassung der aktuellen Sollwerte/Istwerte integriert werden. Wenn der alt Raumtemperaturregler entfällt kann zweites auch entfallen.

===Setzen der Sollwerte===

Der LTC1257 bekommt den Sollwert mittels des Befehls ltc1257_set SOLLWERT (0 <= SOLLWERT >= 2048) zugewiesen. Hierfür wird eine classdef Datei erstellt, z.B.:

<nowiki>
# Umsetzung in ECMD Befehle
# Ein Uebergabeparameter -> Sollwert
set setDacValue params dacValue
set setDacValue cmd {"ltc1257_set %dacValue"}
# Keine Uebergabeparameter
set init cmd {"ltc1257_init"}
</nowiki>

Danach kann der LTC1257 als ECMD Device in FHEM (fhem.cfg) angelegt werden. Hierfür wird eine möglicherweise bestehende „NETIO classdefs“ erweitert:

<nowiki>
attr NETIO_01 classdefs [Andere ECMD Geräte]:LTC1257=/opt/fhem/ltc1257.classdef
</nowiki>

Anschließend den DAC(/LTC1257) als ECMDDevice definieren

<nowiki>
define MEINDAC ECMDDevice LTC1257
attr MEINDAC room MEINRAUM
</nowiki>

Der Befehl zum Setzen eines neuen Spannungswertes lautet:

<nowiki>
my $dacValue = 1345;;\
fhem("set MEINDAC setDacValue ".$dacValue);;\
</nowiki>

===Ermitteln der Istwerte===

Der ADC ermittelt den aktuellen Sollwert über einen Spannungsteiler. Dieser Wert wird in einen Prozentwert (0-100) umgerechnet. Hierfür wird eine classdef Datei (adc.classdef)erstellt, z.B.:

<nowiki>
# Umsetzung in ECMD Befehle
# Ein Uebergabeparameter -> Sollwert
set setDacValue params dacValue
set setDacValue cmd {"ltc1257_set %dacValue"}
set setDacValue postproc {\
Log 3, "Setze Wert";;\
}
# Keine Uebergabeparameter
set init cmd {"ltc1257_init"}
</nowiki>

Danach kann der ADC als ECMD Device in FHEM (fhem.cfg) angelegt werden. Hierfür wird eine möglicherweise bestehende „NETIO classdefs“ erweitert:

<nowiki>
attr NETIO_01 classdefs [Andere ECMD Geräte]:LTC1257=/opt/fhem/adc.classdef
</nowiki>

Anschließend den ADC als ECMDDevice definieren

<nowiki>
define MEINADC ECMDDevice LTC1257
attr MEINADC room MEINRAUM
</nowiki>

==Möglichkeiten==

Ein Bild sagt mehr als tausend Worte
[[File:ScreenshotFHEMTherme.png|center|thumb|alt=Screenshot FHEM Therme]]

==Kritische Nachbetrachtung==
<ul>
<li>Anschluss der Zusatzplatine nicht über die SUB-D Anschlussplatine sondern über den 10poligen Pfostenstecker. Das würde viel sauberer/professioneller aussehen und ist bei dem verwendeten Platinentyp sehr einfach zu relaisieren.</li>
<li>Spannungsversorgung des AVR-NET-IO-Boards über die 24V Spannung der Therme (irgendwie cooler)</li>
<li>Eventuell ist es auch bei diesen Junkersthermen sinnvoller die Steuerspannung mittels eines Relais/Transistors zwischen 3-22V zu schalten. Unter Verwendung von 2 Relais/Transistoren wären auch 4 Schaltstufen möglich (0%, 25%, 50% und 100%). </li>
<li>Die Zusatzplatine trennt das AVR-NET-IO-Board/Netzwerk und die Heizung nicht. Wenn keine Messung der Steuersignalspannung gewünscht ist, würde ich den LTC1257 galvanisch trennen. Bislang gab es aber keine Probleme diesbezüglich. </li>
</ul>

FHT80b Einstellungen

2013-10-21T19:48:00Z

Yfhem: /* FHT80b Programme auf Knopfdruck ändern */ Fixed link.

Um an einem '''[[FHT80b]] Einstellungen''' vonzunehmen, können die im folgenden aufgeführten Beispielanweisungen verwendet werden.

== FHT80b Programme auf Knopfdruck ändern ==
Update 26-05-2013: Anstelle der aufgeführten Routinen empfiehlt es sich mittlerweile, das neue [[Heizungskontrolle Einfach|Heizungskontrolle]] Modul für [[:Kategorie:FHT Components|FHTs]] zu verwenden. Der hier dargestellte Code kann ggf. dazu dienen, die Grundeinstellungen für die Automatikfunktion der FHTs zu übertragen.

Die Funktionen des Heating Control Moduls sind für die hier dargestellte Lösung wesentlich besser zu verwenden.

Um verschiedene Programme ("Gästezimmer heizen", "abwesend", "auch tagsüber heizen, da Urlaub" zu realisieren, bedarf es üblicherweise vieler Parametereinstellungen für die einzelnen Tage. Das lässt sich über ein paar Dummy [[:Kategorie:FS20 Components|FS20]] Devices vereinfachen.

== Vorgehen ==
Für die verschiedenen Modi werden FS20 Dummies angelegt. Diese Dummies können als Schalter über das Standard Fhem [[:Kategorie:Frontends|Frontend]] ([[PGM2]]) gesetzt werden. Über einen zusätzlichen FS20 Dummy --> _OK (OK, "_" vorgestellt, damit er in der Ansicht als unterster Schalter erscheint) werden dann die Daten übernommen und von FHEM auf die einzelnen FHTs nacheinander übertragen. Dadurch eignet sich diese Möglichkeit zur Einstellung besonders gut für die Kontrolle z. B. über ein Smartphone.

Wichtig für die Anfänger unter den Script Programmierern: innerhalb der Routine dürfen keine Leerzeilen vorhanden, sein, dies würde umgehend zu Fehlermeldungen führen.

Damit die fhem.cfg lesbar bleibt, integriert man diesen Teil idealerweise in eine separate Datei (z. B. 99_myFHTsettings.conf) und integriert diese Datei in der fhem.cfg dann über das Kommando: include ./FHEM/99_myFHTsettings.conf

== Beispiel Code ==
<nowiki>define Gaeste FS20 1233 1233
attr Gaest room FHT_Settings
set Gaeste off
define Athome FS20 1232 1232
attr Athome room FHT_Settings
set Athome off
define Urlaub FS20 1231 1231
attr Urlaub room FHT_Settings
set Urlaub off
define _OK FS20 1311 1311
attr _OK room FHT_Settings
set _OK off
define checkprogram at +*00:02:00 {\
if("$value{_OK}" eq "on"){\
my $hm = sprintf("%%02d:%%02d", $hour, $min);;\
my ($wz_dt, $wz_nt, $wz_ct, $wz_wdf1, $wz_wdt1, $wz_wdf2, $wz_wdt2, $wz_wef1, $wz_wet1, $wz_wef2, $wz_wet2);;\
my ($ku_dt, $ku_nt, $ku_ct, $ku_wdf1, $ku_wdt1, $ku_wdf2, $ku_wdt2, $ku_wef1, $ku_wet1, $ku_wef2, $ku_wet2);;\
my ($sz_dt, $sz_nt, $sz_ct, $sz_wdf1, $sz_wdt1, $sz_wdf2, $sz_wdt2, $sz_wef1, $sz_wet1, $sz_wef2, $sz_wet2);;\
my ($kz_dt, $kz_nt, $kz_ct, $kz_wdf1, $kz_wdt1, $kz_wdf2, $kz_wdt2, $kz_wef1, $kz_wet1, $kz_wef2, $kz_wet2);;\
my ($ba_dt, $ba_nt, $ba_ct, $ba_wdf1, $ba_wdt1, $ba_wdf2, $ba_wdt2, $ba_wef1, $ba_wet1, $ba_wef2, $ba_wet2);;\
my ($so_dt, $so_nt, $so_ct, $so_wdf1, $so_wdt1, $so_wdf2, $so_wdt2, $so_wef1, $so_wet1, $so_wef2, $so_wet2);;\
my ($bo_dt, $bo_nt, $bo_ct, $bo_wdf1, $bo_wdt1, $bo_wdf2, $bo_wdt2, $bo_wef1, $bo_wet1, $bo_wef2, $bo_wet2);;\
my ($tempstr1, $tempstr2, $tempstr3, $tempstr4, $tempstr5, $tempstr6, $tempstr7, $tempstr8);;\
if($value{Urlaub}" eq "off"){\
$wz_dt = 21.0;; $wz_nt = 18.0;; $wz_ct = 18.0;;\
$wz_wdf1= "06:00";; $wz_wdt1 = "08:30";; $wz_wdf2 = "16:00";; $wz_wdt2 = "23:00";;\
$wz_wef1 = "06:30;; $wz_wet1 = "23:00";;\
$ku_dt = 20.0;; $ku_nt = 17.0;; $ku_ct = 17.0;;\
$ku_wdf1 = "06:00";; $ku_wdt1 = "07:30";; $ku_wdf2 = "17:00";; $ku_wdt2 = "20:30";;\
$ku_wef1 = "06:30";; $ku_wet1 = "22:00";;\
$sz_dt = 20.0;; $sz_nt = 18.0;; $sz_ct = 18.0;;\
$sz_wdf1 = "06:00";; $sz_wdt1 = "08:00";; $sz_wdf2 = "18:30";; $sz_wdt2 = "21:00";;\
$sz_wef1 = "06:30";; $sz_wet1 = "08:30";; $sz_wef2 = "19:30";; $sz_wet2 = "21:00";;\
$kz_dt = 15.0;; $kz_nt = 13.0;; $kz_ct = 13.0;;\
$kz_wdf1 = "07:00";; $kz_wdt1 = "07:05";; $kz_wdf2 = "07:06";; $kz_wdt2 = "07:10";;\
$kz_wef1 = "07:00";; $kz_wet1 = "07:05";; $kz_wef2 = "07:06";;$kz_wet2 = "07:10";;\
$ba_dt = 20.5;; $ba_nt = 18.0;; $ba_ct = 18.0;;\
$ba_wdf1 = "06:00";; $ba_wdt1 = "07:30";; $ba_wdf2 = "18:00";; $ba_wdt2 = "19:30";;\
$ba_wef1 = "06:30";; $ba_wet1 = "08:30";; $ba_wef2 = "19:30";; $ba_wet2 = "21:00";;\
$so_dt = 15.0;; $so_nt = 13.0;; $so_ct = 13.0;;\
$so_wdf1 = "08:00";; $so_wdt1 = "08:05";; $so_wdf2 = "08:06";; $so_wdt2 = "08:10";;\
$so_wef1 = "08:00";; $so_wet1 = "08:05";; $so_wef2 = "08:06";; $so_wet2 = "08:10";;\
$bo_dt = 15.0;; $bo_nt = 13.0;; $bo_ct = 13.0;;\
$bo_wdf1 = "08:00";; $bo_wdt1 = "08:05";; $bo_wdf2 = "08:06";; $bo_wdt2 = "08:10";;\
$bo_wef1 = "08:00";; $bo_wet1 = "08:05";; $bo_wef2 = "08:06";; $bo_wet2 = "08:10";;\
if("$value{Gaeste}" eq "on"){\
$so_dt = 20.5;; $so_nt = 18.0;; $so_ct = 18.0;;\
$so_wdf1 = "06:30";; $so_wdt1 = "08:30";; $so_wdf2 = "20:30";; $so_wdt2 = "22:00";;\
$so_wef1 = "06:30";; $so_wet1 = "08:30";; $so_wef2 = "21:00";; $so_wet2 = "22:30";;\
$bo_dt = 20.5;; $bo_nt = 18.0;; $bo_ct = 18.0;;\
$bo_wdf1 = "06:30";; $bo_wdt1 = "08:30";; $bo_wdf2 = "20:30";; $bo_wdt2 = "22:00";;\
$bo_wef1 = "06:30";; $bo_wet1 = "08:30";;$bo_wef2 = "21:00";; $bo_wet2 = "22:30";;\
}\
if("$value{Athome}" eq "on"){\
$wz_wdf1 = "06:30";; $wz_wdt1 = "23:00";; $ku_wdf1 = "06:30";; $ku_wdt1 = "22:00";;\
}\
}\
if("$value{Urlaub}" eq "on"){\
$wz_dt = 15.0;; $wz_nt = 13.0;; $wz_ct = 13.0;; $ku_dt = 15.0;; $ku_nt = 13.0;; $ku_ct = 13.0;;\
$sz_dt = 15.0;; $sz_nt = 13.0;; $sz_ct = 13.0;; $kz_dt = 15.0;; $kz_nt = 13.0;; $kz_ct = 13.0;;\
$ba_dt = 15.0;; $ba_nt = 15.0;; $ba_ct = 13.0;; $so_dt = 15.0;; $so_nt = 13.0;; $so_ct = 13.0;;\
$bo_dt = 15.0;; $bo_nt = 13.0;; $bo_ct = 13.0;;\
}\
$tempstr1 = ReadingsVal("FHT_Kueche", "day-temp", $ku_dt);;\
$tempstr2 = ReadingsVal("FHT_Kueche", "night-temp", $ku_nt);;\
if($tempstr1 ne $ku_dt || $tempstr2 ne $ku_nt){\
fhem ("set FHT_Kueche day-temp $ku_dt night-temp $ku_nt");;\
fb_mail('deineemail@googlemail.com',"FHEM-Status: Aenderung FHT_Kueche DayTemp $tempstr1 -> $ku_dt, NightTemp $tempstr2 -> $ku_nt",'');;\
}\
else{\
fb_mail('deineemail@googlemail.com',"FHEM-Status: Keine Aenderung FHT_Kueche DayTemp $ku_dt, NightTemp $ku_nt",'');;\
}\
…… dieser Code fuer Day-Tem, Night-Temp wird sinngemaess fuer alle FHTs kopiert (FHT_Kueche, FHT_WohnZ, FHT_Bad, FHT_Kinderzimmer, FHT_Schlafzimmer, FHT_GaesteSchlafZ, FHT_GaesteBad)

$tempstr1 = ReadingsVal("FHT_Kueche", "mon-from1", $ku_wdf1);;\
$tempstr2 = ReadingsVal("FHT_Kueche", "mon-to1", $ku_wdt1);;\
$tempstr3 = ReadingsVal("FHT_Kueche", "mon-from2", $ku_wdf2);;\
$tempstr4 = ReadingsVal("FHT_Kueche", "mon-to2", $ku_wdt2);;\
$tempstr5 = ReadingsVal("FHT_Kueche", "sun-from1", $ku_wef1);;\
$tempstr6 = ReadingsVal("FHT_Kueche", "sun-to1", $ku_wet1);;\
$tempstr7 = ReadingsVal("FHT_Kueche", "sun-from2", $ku_wef2);;\
$tempstr8 = ReadingsVal("FHT_Kueche", "sun-to2", $ku_wet2);;\
if($tempstr1 ne $ku_wdf1 || $tempstr2 ne $ku_wdt1 || $tempstr3 ne $ku_wdf2 || $tempstr4 ne $ku_wdt2){\
fhem ("set FHT_Kueche mon-from1 $ku_wdf1 mon-to1 $ku_wdt1 mon-from2 $ku_wdf2 mon-to2 $ku_wdt2");;\
fhem ("set FHT_Kueche tue-from1 $ku_wdf1 tue-to1 $ku_wdt1 tue-from2 $ku_wdf2 tue-to2 $ku_wdt2");;\
fhem ("set FHT_Kueche wed-from1 $ku_wdf1 wed-to1 $ku_wdt1 wed-from2 $ku_wdf2 wed-to2 $ku_wdt2");;\
fhem ("set FHT_Kueche thu-from1 $ku_wdf1 thu-to1 $ku_wdt1 thu-from2 $ku_wdf2 thu-to2 $ku_wdt2");;\
fhem ("set FHT_Kueche fri-from1 $ku_wdf1 fri-to1 $ku_wdt1 fri-from2 $ku_wdf2 fri-to2 $ku_wdt2");;\
fb_mail('deineemail@googlemail.com',"FHEM-Status: Aenderung FHT_Kueche Wochentag From1 $tempstr1 -> $ku_wdf1, To1 $tempstr2 -> $ku_wdt1, From2 $tempstr3 -> $ku_wdf2, To2 $tempstr4 -> $ku_wdt2",'');;\
}\
else{\
fb_mail('deineemail@googlemail.com',"FHEM-Status: Keine Aenderung FHT_Kueche Wochentag From1 $ku_wdf1, To1 $ku_wdt1, From2 $ku_wdf2, To2 $ku_wdt2",'');;\
}\
if($tempstr5 ne $ku_wef1 || $tempstr6 ne $ku_wet1 || $tempstr7 ne $ku_wef2 || $tempstr8 ne $ku_wet2){\
fhem ("set FHT_Kueche sat-from1 $ku_wef1 sat-to1 $ku_wet1 sat-from2 $ku_wef2 sat-to2 $ku_wet2");;\
fhem ("set FHT_Kueche sun-from1 $ku_wef1 sun-to1 $ku_wet1 sun-from2 $ku_wef2 sut-to2 $ku_wet2");;\
fb_mail('deineemail@googlemail.com',"FHEM-Status: Aenderung FHT_Kueche Wochenend From1 $tempstr5 -> $ku_wef1, To1 $tempstr6 -> $ku_wet1, From2 $tempstr7 -> $ku_wef2, To2 $tempstr8 -> $ku_wet2",'');;\
}\
else{\
fb_mail('deineemail@googlemail.com',"FHEM-Status: Keine Aenderung FHT_Kueche Wochenend From1 $ku_wef1, To1 $ku_wet1, From2 $ku_wef2, To2 $ku_wet2",'');;\
}\

….. dieser Code für from1 to1, from2, to2 wird sinngemaess fuer alle FHTs kopiert (FHT_Kueche, FHT_WohnZ, FHT_Bad, FHT_Kinderzimmer, FHT_Schlafzimmer, FHT_GaesteSchlafZ, FHT_GaesteBad)

fhem("set _OK off");;\
}\
}</nowiki>

[[Kategorie:Code Snippets]]
[[Kategorie:FHT Components]]

Grundriss mit FHEM-Buttons

2013-10-20T18:51:48Z

Yfhem: /* Lösungsalternativen */ Not clickable links. Fixed.

Ziel ist, auf einem Hintergrundbild (z.B. einem Grundriss) fhem-'buttons' zu platzieren, mit denen fhem-devices geschaltet werden können. Im Weiteren wird durchweg der Begriff 'Grundriss' verwendet, es kann aber jedes beliebige Bild/Szenario verwendet werden, z.B. ein Foto der eigenen Stereoanlage mit entsprechenden Schaltern darauf.
== Lösungsalternativen ==
Um das o.g. Ziel zu erreichen, gibt es drei Lösungsvarianten:

# Seit 03/2012 das in fhem integrierte FLOORPLAN. Das Programms sowie die zugehörigen css-Dateien sind seit 04/2012 Bestandteil von updatefhem, befinden sich also auf allen aktualisierten fhem-Installationen. Die (sehr guten) [http://fhem.de/commandref.html#FLOORPLAN commandref-Eintrag] verlinkt.
# Die in diesem Wiki-Eintrag beschriebene HTML-Lösung
# Eine php-basierte Lösung unter folgenden Links: [http://heimserver.nendzig.net/projekte/HomeMini/homemini.tar Download]
# SVG-basierte Lösung [http://fhzctrl.sourceforge.net Homepage]

== Lösungsansatz über HTML ==
HINWEIS

* Die erzeugte html-Datei ist lokal. Sie kann also von einem PC oder Mac aus angezeigt werden, für die Anzeige auf dem iPad o.ä. ist ein Webserver erforderlich.

Dieser Lösungsansatz stammt von Boris Neubert:

* Zum Steuern werden die URLs von den im fhem-webfrontend angezeigten 'on/off'-Links genutzt
* Es gibt eine GrundrissStart.html, die zwei Frames erzeugt:
# einen sichtbaren Bereich für die Darstellung von 'Grundriss.html',
# einen unsichtbaren Bereich für die Rückmeldungen von der fhem-webpage

== Vorgehensweise ==
=== Erstellen der Startdatei ===
Erzeugen Sie eine Datei 'GrundrissStart.html' mit folgendem Inhalt:

<nowiki><HTML>
<HEAD>
<TITLE>Meine kleine Schaltzentrale</TITLE>
</HEAD>
<FRAMESET ROWS="*,0" BORDER=0 FRAMEBORDER=0 FRAMESPACING=0>
<FRAME SRC="Grundriss.html" NAME="control" NORESIZE>
<FRAME NAME="log">
</FRAMESET>
</HTML></nowiki>
=== Erstellen des Hintergrundbilds ===
Es kann jedes beliebige Internetformat verwendet werden, also z.B. .jpg , .png
Der Grundriss kann z.B. in Powerpoint erstellt und als Hintergrundbild.png gespeichert werden.

=== Hinzufügen der fhem-Schalt-Links ===
Dem Bild übergelagert platzieren Sie nun die Schaltflächen. Diese rufen einen Link folgenden Formats:

<nowiki><A HREF="[http:// http://]<ip>:8083/fhem?cmd=set%20Lampe1%20on" target="log">Lampe1 an</A>
<A HREF="[http:// http://]<ip>:8083/fhem?cmd=set%20Lampe1%20off" target="log">Lampe1 aus</A></nowiki>
Der in href angegebene link lässt sich der Einfachheit halber per Copy/Paste aus dem fhem-webfrontend kopieren.

Wichtig ist der Zusatz ''target="log"''. Wenn dies fehlt, funktionieren zwar die Links, jedoch verlässt man nach dem Klick auf einen button die Grundriss-Seite und landet auf dem fhem-Webfrontend. Durch den Zusatz wird diese fhem-Rückantwort in den unsichtbaren frame namens "log" umgeleitet - auf dem Bildschirm bleibt also Grundriss.html .

Hier eine Grundriss.html mit zwei Darstellungsvarianten: Lampe1 erscheint mit on/off-Schaltern, Lampe2 erscheint nur als Symbol, das selbst als toggle-button dient.

<nowiki><html>
<head>
<meta http-equiv="refresh" content="5; URL=Grundriss.html">
<title>Grundriss mit fhem-Schaltern</title>
</head>
<body>
<img src= "Hintergrundbild.png">

<div style="position:absolute; top:190px; left:340px">
<a href="http://<ip>:8083/fhem?cmd.Lampe1=set%20Lampe1%20on" target="log">ON</a>
<img src=http://<ip>:8083/fhem/icons/Lampe1>
<a href="http://<ip>:8083/fhem?cmd.Lampe1=set%20Lampe1%20off" target="log">OFF</a>
</div>

<div style="position:absolute; top:300px; left:340px">
<a href="http://<ip>:8083/fhem?cmd.Lampe2=set%20Lampe2%20toggle" target="log">
<img src=http://<ip>:8083/fhem/icons/Lampe2>
</a>
</div>
</body>
</html></nowiki>
refresh: Der screen wird alle 5 Sekunden aktualisiert.
HINWEIS

* Alternativ können Sie zu der in fhem verwendeten Web-Instanz (z.B. WEB) '''attr WEB longpoll 1''' setzen. Damit werden die icons auf dem Bildschirm automatisch refreshed, sobald sich ihr Zustand ändert. Der html-Refresh wird damit hinfällig.

Mit <div>divisions</div> wird die Positionierung der Schaltelemente auf dem Bildschirm erreicht.

Die <a>Anchors</a> tragen als Link die kopierte URL der on/off-buttons aus dem fhem webfrontend.

Die <img>Images</img> -URL liefert das Symbol zum genannten Gerät in dessen aktzuellem Schaltzustand zurück.

Wenn Sie die o.g. Zeilen mehrfach kopieren und Lampe1 bzw Lampe2 durch Ihre Gerätenamen erstzen, können Sie Ihre Konfiguration recht einfach einrichten.

== Aufruf ==
Öffnen Sie GrundrissStart.html

== Special: Anzeigen von FHT-Werten ==
Will man z.B. die gemessene Temperatur eines FHT auf dem Grundriss anzeigen, muss man ein wenig tricksen. Der Lösungsansatz besteht aus zwei Schritten: 1. Dem Schreiben der gemessenen Temperatur in ein .txt-File, 2. dem Anzeigen des Inhalts dieser Datei im Grundriss.

1. Das Schreiben der Temperatur in eine Datei namens FHT-temperature.txt wird durch ein notify erreicht:

<nowiki>##fhem.cfg##
define ez_FHT_notify notify ez_FHT { \
my $FHT = "%";; \
#die Actuator-Auswertung tut hier nicht zur Sache \
if ($FHT =~ "actuator:") { \
$FHT = (substr($FHT, 9, (length($FHT)-10)));; \
fhem("set hzg_Actuator $FHT") \
} \
#jetzt kommt's: \
if ($FHT =~ "measured-temp") { \
$FHT = substr($FHT, 15, 4);; \
system("(echo $FHT > FHT-temperature.txt)") \
} \
}</nowiki>
Durch den system()-Befehl wird der Inhalt der Variablen $FHT, also die gemessene Temperatur, in die Datei FHT-temperature.txt geschrieben.

2. Anzeigen des Datei-Inhalts auf dem Grundriss - dies sind Zusatzeinträge in der Grundriss.html :

<nowiki><div style= "position:absolute; top:366px; left:130px">
<object data = "..\fhem\FHT-temperature.txt"></object>
</div>
<div style="position:absolute; top:370px; left:170px; color:grey">
°C
</div></nowiki>
Achten Sie darauf, die Pfadangaben korrekt zu setzen.

=== Anzeigen von S300TH-Werten ===
So wie für FHTs funktioniert's auch für S300TH-Geräte:

<nowiki>define ez_Aussensensor_schreiben notify S300TH:temperature:.* \
{ system(" echo %EVTPART1 > S300TH-temperature.txt") }</nowiki>
Erklärung: Wann immer vom Gerät S300TH eine Meldung kommt, die mit "temperature" beginnt, schreibe den Meldungsteil zwischen der ersten und zweiten Leerstelle (%EVTPART1) in die Datei S300TH-temperature.txt .
Für die Darstellung auf der html-Seite muss man nun analog FHT das <object data...> tag einbauen. Fertig :-)

[[Kategorie:HOWTOS]]

CUL

2013-10-20T06:35:33Z

Yfhem: Updated forum link.

'''CUL''' ('''C'''C1101 '''U'''SB '''L'''ite) ist ein RF-Gerät im Formfaktor eines USB-Dongles mit externer [[CUL Ausstattung|Antenne]]. Die über das ISM/SRD Band empfangenen Daten werden durch einen Onboard 8 bit Atmel Prozessor vorverarbeitet. Mit verfügbarer quelloffener Firmware (im Umfeld von FHEM die "culfw") kann das CUL verschiedene 868MHz [[CUL HomeMatic und FS20|Protokolle]] empfangen und senden, insbesondere die FS20/FHT/S300/EM/HMS sowie durch kurzfristiges Umschaltung auf 433 MHz Intertechno (z. B. viele Baumarkt Funksteckdosen) Protokolle.

Im Umfeld von FS20/FHT/EM/S300/HMS ("[[SlowRF]] - Mode") wird die Dekodierung der per AM in 1 kHz übertragenen Signale per culfw auf dem Atmel Prozessor direkt erledigt und dann per USB an den Hostrechner weitergegeben.

Das CUL kann mittels des CULModuls von FHEM angesprochen und somit wie eine FHZ1X00PC verwendet werden.

Das CUL kann auch im HM-Mode als HomeMatic Zentrale alternativ zur CCU oder dem [[HMLAN Konfigurator]] betrieben werden. Bei CULs älter als Version 3 ist jedoch der Speicher zu klein, um die Software für FS20/FHT/S300/EM/HMS und HomeMatic zugleich im Speicher zu halten, hier muss man sich beim [[CUL an einer Fritzbox 7390 flashen|Flashen]] der Firmware für eine Protokollfamilie entscheiden. Mit zwei CULs ist aber auch der Mischbetrieb an einem FHEM Hostrechner möglich.

Ferner ist der Einsatz eines CUL als [[RFR CUL]] für den SlowRF Mode (jedoch nicht für den HM Mode) möglich, um die Reichweite zu erhöhen. Die Verbindung erfolgt hierbei über Funk, sodass keine USB Verbindung zum FHEM Hostrechner erforderlich ist.

Seit Ende 2012 gibt es ausserdem ein Modul zur Ansteuerung der [[MAX]]! Heizungsteuerung. Auch hier ist ein Mischbetrieb (MAX! und z. B. FS20 gleichzeitig über ein CUL) wohl [http://forum.fhem.de/index.php/topic,10510.0.html nicht angeraten].

Obwohl die eigentliche Betriebsfrequenz der FHT und FS20-Komponenten 868,35 MHz ist, ist bei den aktuellen CUL Firmwareversionen zum Betrieb mit FHEM die Frequenz auf 868,30 MHz eingestellt. Dies stellt einen Kompromiss zum besseren Empfang von EM1000EM (Energiemonitor) Geräten dar.

Falls keine RP-SMA-Antenne verfügbar ist, kann (nur für erste Tests) auch die abschraubbare Antenne für 802.11b/g WLAN-Geräte (2,4 GHz) benutzt werden, so diese anschlusstechnisch auf den RP-SMA-Stecker des CUL passt (dies funktioniert zumindest mit FS20- und EM-Geräten). Besser ist auf jeden Fall eine speziell auf den Einsatzzweck (Frequenz) abgestimmte Antenne.

Frequenz und Bandbreite können aber im SlowRF Mode frei angepasst und somit für örtlichen Empfangsgegebenheiten optimiert werden.

== Hinweise zum Betrieb mit FHEM ==
'''Anmerkung:'''Nachfolgende Beispiele sind so wie dargestellt in die FHEM-Eingabezeile oder per Telnet auf FHEM zu übertragen und per <Enter> abzuschicken (nicht "save" klicken). "myCUL" ist nur ein Platzhalter und mit dem Namen '''Ihres''' CUL zu ersetzen:

* Ist Empfang eingeschaltet ?
*: <code> get myCUL raw C35</code> (13 = ja, z. b.: C35 = 0D / 13)
* Auslesen der CULFW Version:
*: <code>get myCUL raw V</code>
* LED soll nur bei Senden / Empfangen blinken
*: <code>set myCUL raw l00</code>
* LED soll regelmäßig (1Hz) und beim Senden / Empfangen blinken
*: <code>set myCUL raw l02</code>
* Reboot / Reset des CUL:
*: <code>get myCUL raw B00. Andere Werte als 00 starten das CUL im Bootloader-Modus (=> neue Firmware)</code>
* Freie CUL Sendezeit ([[1% Regel]]):
*: <code>get myCUL raw X</code> 2. Wert ist Sendezeit in 10ms slots, ein FS20 Befehl braucht ca. 210ms, eine FHT Kommunikation wesentlich mehr.
* Freie Kapazität des FHT Buffers
*: <code> get myCUL raw T03</code> Ergebniss bytes in HEX. Leer = 4a
* Inhalt des FHT Buffers
*: <code> get myCUL raw T02</code> (CUL V2 Buffer ist 74 Bytes gross, Platz für 14 bis 31 FHT Messages)
* Eingestellte Frequenz, Bandbreite etc. Ausgeben
*: <code> get myCUL ccconf</code>. <br>Rückgabe z. B.: <br><code><nowiki>myCUL ccconf => freq:868.300MHz bWidth:325kHz rAmpl:42dB sens:4dB</nowiki></code>
* eingestelle Bandbreite erhöhen (z.b. auf 464 kHz, mehr hat meist keinen Sinn):
*:<code>set myCUL bWidth 464</code>
* Einstellen der Sendestärke:
*: <code>set myCUL raw x09</code> Einstellen der Sendeleistung.

Gültige Werte für die Sendeleistung sind 00-09. Verwendet werden sollten nur die Werte 05-09, diese entsprechen
-10/-5/0/5/10 Sendeleistung in db. Default ist x08 = +5db. Bitte im Interesse von Nachbarn und der Abhörsicherheit den kleinsten problemlos funktionierenden Wert einstellen. Dies ist meistens x07 oder x08. Da speziell die Kommunikation mit den FHTs bidirektional ist, kann die Kommunikation durch höhere Werte oft nicht verbessert werden, da die FHTs selber dadurch nicht stärker senden. Besser versuchen, Lage und Antennenausrichtung des CUL zu verändern. Siehe auch Diskussion unter [https://groups.google.com/group/cul-fans/browse_thread/thread/683ca5c892eae1c3/c682a640f1ba863c?lnk=gst&q=bWidth+freq#c682a640f1ba863c GoogleGroups-CUL-Fans]

Werte x00-x04 sind '''mit''' Ramping und führen zum Verlust der Kommunikationsfähigkeit mit anderen CULs, z. B. [[RFR CUL]].

'''Hinweis:''' Beim CUL im HM-Modus kann man (ohne firmware-mod) die Empfangs-/Sendeparameter '''nicht''' verstellen. Die üblichen freq/x09 etc. haben hier keine Wirkung ([http://forum.fhem.de/index.php?t=msg&th=10203&goto=57191&rid=417#msg_57191 Quelle]).

Weiterhin kann man zunehmend mehr Debuggingoutput auf dem CUL einschalten mit :

* <code> set CUL1 raw X61</code> Communication wird im Detail angezeigt
* <code>set CUL1 raw X25</code> auch checksum Fehler / unerkannte Protokolle werden gemeldet
* <code>set CUL1 raw X2F</code> alle empfangenen Flanken werden gemeldet
* <code>set CUL1 raw X80</code> RSSI / Signalstaerke jeder Flanke wird gemeldet
* <code>set CUL1 raw X21</code> normal Modus

Achtung: Auf Gross- und Kleinschreibung des "x,X" achten!

Die kompletten Kommandos mit Erklärung für CUL stehen hier: [http://culfw.de/commandref.html http://culfw.de/commandref.html]

== Versionen ==
Das CUL gibt es in mehreren Versionen, die sich überwiegend in Prozessor und Speicherkonfiguration unterscheiden.

* CUL V1 - AT90USB162 Prozessor, 0,5Kb RAM, 16Kb Flashmemory, 0,5 kByte EEPROM. Einsatzfähigkeit unbekannt (aber vermutlich wie V2). Wird nicht mehr hergestellt.
* CUL V2 - AT90USB162 Prozessor, 0,5Kb RAM, 16Kb Flashmemory, 0,5 kByte EEPROM. Einsatzfähig. Der Flashspeicher ist jedoch zu klein für eine culfw (CUL Firmware), die Code für SlowRF Geräte und zugleich HM Geräte enthält. Es muss also vor dem Flashen der Firmware zwischen zwei jeweils reduzierten Versionen gewählt werden. Da ein CUL ohnehin nicht beide Sendemodi '''zeitgleich''' betreiben kann, ist dies keine wirkliche Einschränkung. Wird nicht mehr hergestellt.
* CUL V3 - ATMega32U4 Prozessor, 2,5 kB RAM, 32 kB Flashmemory, 1 kByte EEPROM). Voll einsatzfähig.
* CUL V4 - ATMega32U2 Prozessor, 1 kB RAM 32 kB Flashmemory, 1 kByte EEPROM. Voll einsatzfähig. Genau genommen ein "Sparmodell" des V3, um Lieferengpässe des atmega32u4 Prozessors zu umgehen. Der reduzierte RAM-Speicher verursacht (zumindest gegenwärtig) beim Betrieb mit culfw und Fhem keine Einschränkungen oder Nachteile. Achtung: Flashen des CULv4 setzt DFU-Programmer 0.5.4 oder höher voraus.
== Sendefrequenz ==
Das CUL gibt es in Ausführungen für 868 und 433 MHz.
Die Sende- und Empfangsfrequenz des CUL sind in weiten Bereichen einstellbar, im SlowRF Mode auch durch direkte Befehle aus Fhem (im HM Mode derzeit nicht unterstützt). Der wesentliche Unterschied der 868 und 433 MHz CULs ist ein auf die Frequenz richtig abgestimmter HF-Eingangskreis inklusive Antennenlänge.
Es ist es durchaus möglich, ein 868 MHz CUL auf 433 MHz einzustellen. Da dann aber die HF-Eingangskreis-Abstimmung und Antennenlänge nicht korrekt sind, ist Empfangs- und Sendeleistung suboptimal, die Reichweite sinkt. Dennoch wird diese Möglichkeit des freien Einstellens durch das Fhem Intertechnomodul genutzt, da Intertechnokomponenten mit 433 MHz arbeiten. Dazu wird beim Senden eines Intertechno-Befehls die Frequenz eines 868 MHz CULs kurz umgestellt.

Denkbar ist auch der Einsatz eines CUL 433 MHz im Zusammenhang mit HomeMatic. Hier wird das CUL normalerweise im HM Mode betrieben, dessen Frequenz auf 868 MHz fest eingestellt ist. Die verminderte Sendeleistung aufgrund der falschen Antenne fällt je nach örtlicher Gegebenheit eventuell nicht ins Gewicht, da HomeMatic aufgrund seiner besseren Empfänger grundsätzlich etwas bessere Reichweiten hat als die empfangsseitig simplen Intertechnomodule. Soll nun ein Intertechnomodul geschaltet werden, wird das CUL kurzzeitig auf SlowRF umgeschaltet und dann in 433 MHz betrieben, jetzt mit optimaler Antennenabstimmung zur Reichweitenoptimierung der Intertechno-Komponenten, danach wird sofort in den HM Modus zurückgeschaltet, wodurch sich die Frequenz auch automatisch wieder auf 868 MHz ändert. Theoretisch ist hierbei allerdings der Verlust von HM-ACK Meldungen möglich, wenn diese in dem Moment eintreffen, in dem das CUL gerade auf Intertechno umgeschaltet ist.

== Bekannte Probleme ==
Im Gegensatz zu den original FHZ Zentralen ist das CUL recht flankensteil, d.h. die Sende- und Empfangsfrequenz wird genauer eingehalten als z. B. bei einer FHZ1x00PC. Dies kann im Zusammenhang mit den eher ungenauen Sendern z. B. der FHT Raumregler zu Empfangsproblemen führen. Es kann daher mitunter sinnvoll sein, die Sende- und Empfangsbandbreite des CUL etwas zu erhöhen. Dies senkt jedoch gleichzeitig die Empfindlichkeit.

Bei Empfangsproblemen von z. B. HEM-Sensoren oder dem S300TH kann man folgendes testen:

* Man kann die Frequenz des CUL auf genau 868,35 MHz einstellen. Standardmäßig ist hier aus Kompatibilitätsgründen 868,30 MHz eingestellt. Diese Einstellung wird fest im NVRAM gespeichert und braucht nur einmal vorgenommen zu werden.
*: <code>set CUL_0 freq 868.350</code>
* Es ist möglich die "decision boundary" zu vergrößern, frei beschrieben: die "Entscheidungsgrenze" ob die empfangene Signalflanke digital "0" oder "1" darstellte ([http://forum.fhem.de/index.php?t=msg&goto=44388&rid=73&srch=decision+boundary#msg_44388 siehe Diskussion hier]). Möglich sind die Werte "4", "8" und "16". Default-Einstellung ist hier "4". Zur Steigerung der Empfangsqualität soll es hilfreich sein, hier "8" einzustellen. Mitunter bringt jedoch erst die Einstellung auf "16" signifikante Verbesserungen beim Empfang von S300TH-Sensoren.
*: <code>set CUL_0 sens 8</code>
* Oft hilft auch, die Bandbreite auf z. B. 464 kHz aufzuweiten.
= Links =
* Hersteller / Bezugsquelle für CUL: [http://www.busware.de/tiki-index.php?page=CUL busware.de]
* [http://culfw.de/culfw.html culfw.de] - Homepage der CUL firmware
* [http://culfw.svn.sourceforge.net/viewvc/culfw/trunk/culfw/ Sourceforge CUL firmware]
* Google groups [https://groups.google.com/group/cul-fans/ CUL fans]

[[Kategorie:Interface]]
[[Kategorie:CUL]]

Anwesenheitserkennung

2013-06-29T10:42:01Z

Yfhem: Richtiges Deutsch verwendet.

Viele Benutzer führen bereits eine eigene Anwesenheitserkennung durch. Diese basiert in den meisten Fällen auf Ping Checks oder bei FritzBoxen über den Befehl ''ctlmgr_ctl''. Diese Lösungen können aber je nach Aufbau und Funktion FHEM massiv beeinträchtigen. Aufgrund des Aufbaus vom FHEM kann dieses dadurch für mehrere Sekunden zum völligen Stillstand gebracht werden.

Daher gibt es nun ein Modul, welches eine zuverlässige Anwesenheitserkennung bietet, ohne dabei FHEM bei der Ausführung zu beeinträchtigen.

= Vorüberlegungen =

Generell gibt es mehrere Ansätze um Anwesenheitserkennung mit Handys/Smartphones durchzuführen.

* via PING Checks im gesamten WLAN
* Aktivitätsprüfung auf einer FritzBox
* Bluetooth Checks in der gesamten Wohnung
* eigene Perl-Funktion

Dabei gilt bei der Auswahl der Art darauf zu achten wie sich das jeweilige Device verhält. Aufgrund der Vielfältigkeit kann man hier keine allgemeine Vorgehensweise empfehlen. Als einfacher Start eignet sich die Ping-Überprüfung und die FritzBox-Abfrage sehr gut.

== Randbedingungen ==

Es gibt Geräte, welche ihr WLAN/Bluetooth auch im Standby ständig an haben und auf Anfragen antworten können (fast alle Android-Geräte). Gerade bei Tests über WLAN kann sich das aber signifikant auf die Akku Leistung auswirken.

Andere Geräte wiederum schalten WLAN im Standby Betrieb aus um Akku zu sparen. Bluetooth hingegen bleibt weiterhin aktiviert und kann auf Anfragen reagieren. (iPhone)

Wenn man bei einem iPhone die Funktion "über WLAN synchronisieren" aktiviert hat, so ist dies auch im Standby jederzeit pingbar wenn der Recher auf dem iTunes zum synchroniseren läuft auch an ist. Ansonsten ist bei iPhone Geräten nur die Aktivitätsprüfung mit einer FritzBox oder das überwachen der DHCP lease auf einer Airport Basestation wirklich zuverlässig.

Auch wenn man Bluetooth aktiviert hat, so bleiben einige Handys erst dann empfangsbereit, wenn sie bereits zu irgend einem Bluetoothgerät gekoppelt wurden. Sind diese Geräte noch nie gekoppelt worden, so deaktivieren diese ihren Bluetooth Empfänger beim verlassen des Bluetooth-Menüs im Gerät (iPhone).

Hier gilt es vor allem auszuprobieren wie stark der Akku durch eine Anwesenheitserkennung beeinträchtigt wird. Entscheidend ist hier in welchem Abstand man eine Anwesenheitserkennung durchführt. Viele Abfragen wirken sich stärker auf den Akku aus als wenige. Wenige Abfragen bieten aber keine zuverlässige und zeitnahe Erkennung.

= Das PRESENCE Modul =

Das PRESENCE Modul bietet für die Anwesenheitserkennung mehrere Varianten an. Diese sind aktuell folgende:

* '''lan-ping''' - Das überwachen via PING Checks, welche durch den FHEM Server versandt werden.
* '''fritzbox''' - Das überwachen von Geräten auf einer FritzBox via ctlmgr_ctl (Nur auf einer FritzBox möglich)
* '''local-bluetooth''' - Das überwachen via Bluetooth Checks, welche vom FHEM Server direkt durchgeführt werden (angeschlossener Bluetooth-Stick und die Software bluez voraussgesetzt)
* '''lan-bluetooth''' - Das überwachen von Bluetoothgeräte, über Netzwerk. Auf einer oder mehreren Maschinen im Netzwerk (z.B. [[:Kategorie:Raspberry Pi|Raspberry Pi]]) läuft eine Presence-Daemon, welcher nach Bluetooth-Geräten sucht. Um mehrere Presence-Daemon mit FHEM zu verbinden, gibt es den Collector-Daemon, welche sich zu allen Presence-Damons im Netzwerk verbindet und das Ergebnis von allen zusammenfasst.
* '''function''' - Das überwachen mithilfe einer selbst geschrieben Perl-Funktion die den Anwesenheitsstatus zurück gibt (0 oder 1)
* '''shell-script''' - Das überwachen mithilfe eines selbst geschriebenen Shell-Programms/Skript, welches eine 0 oder 1 ausgibt um den Anwesenheitsstatus mitzuteilen.

== Ping-Überwachung von Geräten im WLAN/LAN ==
Um ein Gerät via Ping zu überwachen definiert man folgendes in der fhem.cfg:

<pre>
define Handy PRESENCE lan-ping 192.168.0.30
</pre>

Dadurch wird die IP-Addresse 192.168.0.30 aller 30 Sekunden geprüft, ob sie erreichbar ist. Wenn sie erreichbar ist, ist der Status "present" (anwesend), ansonsten "absent" (abwesend)

Mann kann das Timeout verändern indem man es als zusätzlichen Wert hinten anhängt:

<pre>
define Handy PRESENCE lan-ping 192.168.0.30 60
</pre>

Nun würde das Handy aller 60 Sekunden geprüft werden.

Nur wenn man bei einem iPhone/iPad die Funktion "über WLAN synchronisieren" aktiviert hat, so ist dies auch im Standby zuverlässig pingbar. Standardmäßig deaktivieren Apple-Geräte ihr WLAN im Standby-Betrieb um Akku zu sparen.

== FritzBox: direktes Abfragen der Aktivität via ctlmgr_ctl ==
Eine sehr häufige und auch zuverlässige Methode ist auf einer FritzBox die Abfrage mittels ctlmgr_ctl Befehl. Über diesen lassen sich alle Geräte abfragen ob sie aktiv sind. Ist ein Gerät aktiv, so gilt es als anwesend.

Dieser Modus kann allerdings nur in FHEM Installationen direkt auf einer FritzBox verwendet werden. Desweiteren muss FHEM unter dem User root laufen.
Um ein Gerät zu überwachen wird lediglich der Gerätename benötigt, so wie er unter dem Menüpunkt "Heimnetz" auftaucht. In der fhem.cfg sieht dies folgendermaßen aus.

<pre>
define Handy PRESENCE fritzbox iPhone-4S
</pre>

=== FHEM Ausführung von User boxusr99/fhem zu root ändern ===

Eine detaillierte Beschreibung um FHEM wieder unter root auf der FritzBox zu starten findet ihr in dem Artikel [[FritzBox: fhem unter root starten]]

== Bluetooth-Überwachung von Geräten durch den FHEM Server ==
[[Datei:Bluetooth-Adresse-iPhone.png|thumb|Bluetooth-Adresse eines iPhones]]
Jenach Aufstellungsort des FHEM Servers kann es sinnvoll sein, eine Bluetooth-Überwachung direkt durch den FHEM Server durchzuführen. Hierbei gilt allerdings zu beachten, das Bluetooth nicht für große Reichweiten gedacht ist und in den meisten Fällen keine Wände überwinden können. Das heist, dass man in den meisten Fällen damit nur einen Raum überwachen kann.

Je nach Einsatzzweck kann das auch so gewollt sein. Bluetooth USB Sticks welche bereits Bluetooth 4.0 unterstützen können höhere Reichweiten über Zimmerwände hinaus erreichen. Voraussgesetzt das Handy unterstützt Bluetooth 4.0.

Um eine Überwachung per Bluetooth durchführen zu können benötigt man die Bluetooth-Adresse eines Gerätes. Diese ähnelt sich vom Aufbau einer MAC-Adresse. Generell wird die Adresse in den Telefon-Informationen bei Smartphones angezeigt.

Um eine Anwesenheitserkennung via Bluetooth durchzuführen wird folgende Zeile in der fhem.cfg benötigt:

<pre style="margin-right: 210px;">
define Handy PRESENCE local-bluetooth XX:XX:XX:XX:XX:XX
</pre>

== Bluetooth-Überwachung von Geräten durch verteilte Agenten in der Wohnung (presencd/collectord) ==
[[Datei:Raspberry-Pi-mit-WLAN-und-Bluetooth-Stick.jpg|thumb|left|Raspberry Pi mit Bluetooth- und WLAN-USB-Stick]]
Um eine zuverlässige und flächendeckende Bluetooth-Anwesenheitserkennung durchzuführen, ist es unerlässlich mehrere Bluetooth-Empfänger zu verwenden, welche auf mehrere oder alle Räume verteilt sind.

Hierführ bietet sich zum Beispiel ein Raspberry Pi mit einem Mini-Bluetooth-USB-Stick und evtl. einem WLAN-USB-Stick an. Jeder Raum wird mit solch einem Raspberry ausgestattet und ist im WLAN Netz verfügbar.

Dieses Netz aus Raspberrys wird mit dem presenced (Download-Link ist in der [http://fhem.de/commandref_DE.html#PRESENCE Commandref] zum Modul enthalten) ausgestattet. Es stehen bereits entsprechende Pakete für das Raspberry zur Verfügung.

Beide Programme (presenced/collectord) sind Perl-Skripte welche als Daemon im Hintergrund laufen und auf Anfragen via Netzwerk warten. Es wird lediglich eine vollständige Perl-Grundinstallation benötigt mit Standardmodulen. Nach Installation der *.deb Paket sollten diese noch angewiesen werden, automatisch beim Rechner-Neustart gestartet zu werden:

<pre>
sudo update-rc.d presenced defaults
sudo update-rc.d collectord defaults
</pre>

Eine detaillierte Benutzung von presenced findet man in der [http://fhem.de/commandref_DE.html#PRESENCE Commandref] zum PRESENCE Modul.

=== Jeden Raum einzeln ansprechen (presenced) ===

Nun kann man zuallererst jeden Raum einzeln ansprechen. Dabei ist zu beachten, dass pro Definition in der FHEM.cfg nur ein Gerät in einem Raum spezifisch überwacht werden kann.

Eine Definition sieht dabei wie folgend aus:

<pre>
define Handy_Wohnzimmer PRESENCE lan-bluetooth XX:XX:XX:XX:XX:XX 192.168.0.10:5111
</pre>

Damit wird nun das Handy nur im Wohnzimmer (Raspberry mit IP 192.168.0.10) überwacht.

=== Alle Räume gemeinsam ansprechen (collectord) ===

Um jedoch alle Räume gemeinsam zu verwenden gibt es den Collector-Daemon. Dieser kennt alle presenced-Installationen im Netzwerk und führt eine koordinierte Suche nach den gewünschten Geräten durch. Sobald ein Gerät in einem Raum erkannt wurde, meldet der collectord den Status inkl. der Angabe des Raumes, in welchem das Gerät erkannt wurde.

Um alle Räume zu kennen, müssen diese mit einem Config-File dem collectord mitgeteilt werden. Dieses sieht folgendermaßen aus:

<pre>
[Schlafzimmer] # Name des Raumes (wird in FHEM als Reading angezeigt)
address=192.168.179.31 # IP-Adresse oder Hostname des presenced
port=5111 # TCP Port welcher verwendet werden soll (standardmäßig Port 5111)
presence_timeout=120 # Prüfinterval welches verwendet werden soll, wenn ein Gerät anwesend ist
absence_timeout=20 # Prüfinterval welches verwendet werden soll, wenn ein Gerät abwesend ist

[Wohnzimmer]
address=192.168.179.34
port=5111
presence_timeout=180
absence_timeout=20
</pre>

Mit dieser Konfiguration kann der Collectord gestartet werden. Es empfiehlt sich diesen mit auf dem FHEM Server zu betreiben.
Nun kann man in der fhem.cfg folgenden Eintrag hinzufügen.

<pre>
define Handy PRESENCE lan-bluetooth XX:XX:XX:XX:XX:XX 127.0.0.1:5222
</pre>

Sobald das Handy irgendwo in der Wohnung erkannt wurde, meldet der Collectord dies sofort an FHEM und teilt den Raum mit.

Eine detaillierte Benutzung von collectord findet man in der Commandref zum PRESENCE Modul.

== Überwachung von Geräten mit Perl-Code ==

Es ist möglich zum Überwachen von Geräten eine eigene Perl-Funktion zu verwenden die dann vom PRESENCE Modul im Hintergrund aufgerufen wird.

<pre>
define <name> PRESENCE function {...} [ <check-interval> [ <present-check-interval> ] ]
</pre>

Sobald die Funktion den Rückgabewert 1 hat, ist das Gerät anwesend, bei 0 abwesend.

=== Beispiel DHCP überwachung auf Airport Basestation ===

Die hier vorgestellte Überwachung der DHCP Lease auf Airport Basestations per SNMP ist absolut robust gegenüber dem Ruhezustand von iOS und setzt keine weitere Konfiguration auf dem iPhone voraus.. Das abmelden beim verlassen des Empfangsbereiches der Basestation geschieht mit etwa 5-10 Minuten Verzögerung und ist somit auch vor kurzzeitigen Empfangsproblemen sicher. Das nebenstehende Bild verdeutlicht noch mal die unterschiede zwischen einer IP-Basierten Ping-Überwachung und der Überwachung auf Ebene der Basestation oder FritzBox.

Bevor der folgende Code verwendet werden kann ist das Perl Modul Net:SNMP zu installieren. das geht z.b. mit: cpan install use Net::SNMP.

Zuerst ist folgender Code in 99_myUtils.pl einzufügen:

<pre>
use Net::SNMP;
sub
snmpCheck($$)
{
my ($airport,$client)= @_;

my $community = "public";
my $host = $airport;
my $oid = ".1.3.6.1.2.1.3.1.1.2";
#my $oid = ".1.3.6.1.2.1.3.1.1.2.25.1.10.0.1";

my ( $session, $error ) = Net::SNMP->session(
-hostname => $host,
-community => $community,
-port => 161,
-version => 1
);

if( !defined($session) ) {
return 0;
return "Can't connect to host $host.";
}

my @snmpoids = ();

my $response = $session->get_next_request($oid);
my @nextid = keys %$response;
while ( $nextid[0] =~ m/^$oid/ ) {
push( @snmpoids, $nextid[0] );

$response = $session->get_next_request( $nextid[0] );
@nextid = keys %$response;
}

if( !defined($response = $session->get_request( @snmpoids ) ) ) {
return 0;
}

foreach my $value (values %$response) {
return 1 if( $value eq $client )
}

return 0;
}
</pre>

Danach lässt sich das Mobilgerät so überwachen:

<pre>
define iPhone PRESENCE function {snmpCheck("10.0.1.1","0x44d77429f35c")} 30 30
</pre>

wobei 10.0.1.1 durch die IP-Adresse der Basestation und 0x44d77429f35c durch die MAC adresse des Geräts als HEX-Zahl ersetzt werden muss.

= Beispiele für die Nutzung der Anwesenheitserkennung =
Hier sollen Beispiele für die Nutzung von PRESENCE aufgezeigt werden.

== Abschalten aller Verbraucher (Licht, Musikanlage) beim Verlassen der Wohnung ==

Typisches Szenario: Man geht ausser Haus, aber hat vergessen im Bad das Licht aus zu machen. Allerdings geht man heutzutage fast garnicht mehr ohne Handy aus dem Haus.

Nun soll FHEM in der gesamten Wohnung das Licht, sowie sonstige Verbraucher ausschalten, wenn ich länger als 15 Minuten ausser Haus bin.
Dazu benötigt man zuerst eine structure, welche alle Verbraucher und sonstige Devices, welche das betrifft zusammenfasst.

<pre>
define Gesamte_Wohnung structure Gesamtes_Licht Licht_Wohnzimmer Licht_Kueche LED_Kueche Licht_Bad Licht_Schlafzimmer AV_Receiver TV_Steckdose
attr Gesamte_Wohnung room Wohnung
</pre>

Nun kann man mittels eines watchdogs eine Überwachung für sein Handy anlegen:

<pre>
# Überwachen der gesamten Wohnung mittels collectord sowie presenced in jedem Raum
define Handy PRESENCE lan-bluetooth XX:XX:XX:XX:XX:XX 127.0.0.1:5222

# Nach 15 Minuten Abwesenheit (Handy im Status "absent") soll die gesamte Wohnung ausgeschaltet werden.
define watchdog_Anwesenheit watchdog Handy:absent 00:15 Handy:present set Gesamte_Wohnung off ; setstate watchdog_Anwesenheit defined
attr watchdog_Anwesenheit regexp1WontReactivate 1
</pre>

[[Kategorie:Code Snippets]]
[[Kategorie:Glossary]]

CUL

2013-06-27T19:02:17Z

Yfhem: e.g.: z.b. -> z. B.

'''CUL'''
= Beschreibung =
CUL ('''C'''C1101 '''U'''SB '''L'''ite) ist ein RF-Gerät im Formfaktor eines USB-Dongles mit externer Antenne. Die über das ISM/SRD Band empfangenen Daten werden durch einen Onboard 8bit Atmel Prozessor vorverarbeitet. Mit verfügbarer quell offener Firmware (im Umfeld von FHEM die "culfw") kann das CUL verschiedene 868MHz Protokolle empfangen und senden, insbesondere die FS20/FHT/S300/EM/HMS sowie durch kurzfristiges Umschaltung auf 433 MHz Intertechno (z. B. viele Baumarkt Funksteckdosen) Protokolle.

Im Umfeld von FS20/FHT/EM/S300/HMS ("[[SlowRF]] - Mode") wird die Dekodierung der per AM in 1 kHz übertragenen Signale per culfw auf dem Atmel Prozessor direkt erledigt und dann per USB an den Hostrechner weitergegeben.

Das CUL kann mittels des CULModuls von FHEM angesprochen und somit wie eine FHZ1X00PC verwendet werden.

Das CUL kann auch im HM-Mode als HomeMatic Zentrale alternativ zur CCU oder dem [[HMLAN Konfigurator]]). Bei CULs älter als Version 3 ist außerdem der Speicher zu klein, um die Software für FS20/FHT/S300/EM/HMS und HomeMatic zugleich im Speicher zu halten, hier muss man sich beim Flashen der Firmware für eine Protokollfamilie entscheiden. Mit zwei CULs ist aber auch der Mischbetrieb an einem FHEM Hostrechner möglich.

Ferner ist der Einsatz eines CUL als [[RFR CUL]] für den SlowRF Mode (jedoch nicht für den HM Mode) möglich, um die Reichweite zu erhöhen. Die Verbindung erfolgt hierbei über Funk, sodass keine USB Verbindung zum FHEM Hostrechner erforderlich ist.

Seit Ende 2012 gibt es ausserdem ein Modul zur Ansteuerung der [[MAX]]! Heizungsteuerung. Auch hier ist ein Mischbetrieb (MAX! und z. B. FS20 gleichzeitig über ein CUL) wohl [http://forum.fhem.de/index.php?t=msg&th=10510&start=0&rid=417 nicht angeraten].

Obwohl die eigentliche Betriebsfrequenz der FHT und FS20-Komponenten 868,35 MHz ist, ist bei den aktuellen CUL Firmwareversionen zum Betrieb mit FHEM die Frequenz auf 868,30 MHz eingestellt. Dies stellt einen Kompromiss zum besseren Empfang von EM1000EM (Energiemonitor) Geräten dar.

Falls keine RP-SMA-Antenne verfügbar ist, kann (nur für erste Tests) auch die abschraubbare Antenne für 802.11b/g WLAN-Geräte (2,4 GHz) benutzt werden, so diese anschlusstechnisch auf den RP-SMA-Stecker des CUL passt (dies funktioniert zumindest mit FS20- und EM-Geräten). Besser ist auf jeden Fall eine speziell auf den Einsatzzweck (Frequenz) abgestimmte Antenne.

Frequenz und Bandbreite können aber im SlowRF Mode frei angepasst und somit für örtlichen Empfangsgegebenheiten optimiert werden.

= Hinweise zum Betrieb mit FHEM =
'''Anmerkung:'''Nachfolgende Beispiele sind so wie dargestellt in die FHEM-Eingabezeile oder per Telnet auf FHEM zu übertragen und per <Enter> abzuschicken (nicht "save" klicken). "myCUL" ist nur ein Platzhalter und mit dem Namen '''Ihres''' CUL zu ersetzen:

* Ist Empfang eingeschaltet ?
*: <code> get myCUL raw C35</code> (13 = ja, z. b.: C35 = 0D / 13)
* Auslesen der CULFW Version:
*: <code>get myCUL raw V</code>
* LED soll nur bei Senden / Empfangen blinken
*: <code>set myCUL raw l00</code>
* LED soll regelmäßig (1Hz) und beim Senden / Empfangen blinken
*: <code>set myCUL raw l02</code>
* Reboot / Reset des CUL:
*: <code>get myCUL raw B00. Andere Werte als 00 starten das CUL im Bootloader-Modus (=> neue Firmware)</code>
* Freie CUL Sendezeit ([[1% Regel]]):
*: <code>get myCUL raw X</code> 2. Wert ist Sendezeit in 10ms slots, ein FS20 Befehl braucht ca. 210ms, eine FHT Kommunikation wesentlich mehr.
* Freie Kapazität des FHT Buffers
*: <code> get myCUL raw T03</code> Ergebniss bytes in HEX. Leer = 4a
* Inhalt des FHT Buffers
*: <code> get myCUL raw T02</code> (CUL V2 Buffer ist 74 Bytes gross, Platz für 14 bis 31 FHT Messages)
* Eingestellte Frequenz, Bandbreite etc. Ausgeben
*: <code> get myCUL ccconf</code>. Rückgabe z. B.:
<nowiki>myCUL ccconf => freq:868.300MHz bWidth:325KHz rAmpl:42dB sens:4dB</nowiki>
* Einstellen der Sendestärke:
*: <code>set myCUL raw x09</code> Einstellen der Sendeleistung.

Gültige Werte sind 00-09. Verwendet werden sollten nur die Werte 05-09, diese entsprechen
-10/-5/0/5/10 Sendeleistung in db. Default ist x08 = + 5db. Bitte im Interesse von Nachbarn und der Abhörsicherheit kleinsten problemlos funktionierenden Wert einstellen. Dies ist meistens x07 oder x08. Da speziell die Kommunikation mit den FHTs bidirektional ist, kann die Kommunikation durch höhere Werte oft nicht verbessert werden, da die FHTs selber dadurch nicht stärker senden. Besser versuchen, Lage und Antennenausrichtung des CUL zu verändern. Siehe auch Diskussion unter [https://groups.google.com/group/cul-fans/browse_thread/thread/683ca5c892eae1c3/c682a640f1ba863c?lnk=gst&q=bWidth+freq#c682a640f1ba863c GoogleGroups-CUL-Fans]

Werte x00-x04 sind MIT Ramping und führen zum Verlust der Kommunikationsfähigkeit mit anderen CULs, z. B. [[RFR CUL]].

'''Hinweis:'''Beim CUL im HM-Modus kann man (ohne firmware-mod) die Empfangs-/Sendeparameter '''nicht'''verstellen. Die üblichen freq/x09 etc. haben hier keine Wirkung ([http://forum.fhem.de/index.php?t=msg&th=10203&goto=57191&rid=417#msg_57191 Quelle]).

Weiterhin kann man zunehmend mehr Debuggingoutput auf dem CUL einschalten mit :

* *: <code> set CUL1 raw X61</code> Communication wird im Detail angezeigt
* *: <code>set CUL1 raw X25</code> auch checksum Fehler / unerkannte Protokolle werden gemeldet
* *: <code>set CUL1 raw X2F</code> alle empfangenen Flanken werden gemeldet
* *: <code>set CUL1 raw X80</code> RSSI / Signalstaerke jeder Flanke wird gemeldet
* *: <code>set CUL1 raw X21</code>normal Modus

Achtung: Auf Gross- und Kleinschreibung des "x,X" achten!

Die kompletten Kommandos mit Erklärung für CUL stehen hier: [http://culfw.de/commandref.html http://culfw.de/commandref.html]

= Versionen =
Das CUL gibt es in mehreren Versionen, die sich überwiegend in Prozessor und Speicherkonfiguration unterscheiden.

* CUL V1 - AT90USB162 Prozessor, 0,5Kb RAM, 16Kb Flashmemory, 0,5 kByte EEPROM. Einsatzfähigkeit unbekannt (aber vermutlich wie V2). Wird nicht mehr hergestellt.
* CUL V2 - AT90USB162 Prozessor, 0,5Kb RAM, 16Kb Flashmemory, 0,5 kByte EEPROM. Einsatzfähig. Der Flashspeicher ist jedoch zu klein für eine culfw (CUL Firmware), die Code für SlowRF Geräte und zugleich HM Geräte enthält. Es muss also vor dem Flashen der Firmware zwischen zwei jeweils reduzierten Versionen gewählt werden. Da ein CUL ohnehin nicht beide Sendemodi '''zeitgleich''' betreiben kann, ist dies keine wirkliche Einschränkung. Wird nicht mehr hergestellt.
* CUL V3 - ATMega32U4 Prozessor, 2,5 Kb RAM, 32 Kb Flashmemory, 1 kByte EEPROM). Voll einsatzfähig.
* CUL V4 - ATMega32U2 Prozessor, 1 Kb RAM 32 Kb Flashmemory, 1 kByte EEPROM. Voll einsatzfähig. Genau genommen ein "Sparmodell" des V3, um Lieferengpässe des atmega32u4 Prozessors zu umgehen. Der reduzierte RAM-Speicher verursacht (zumindest gegenwärtig) beim Betrieb mit culfw und Fhem keine Einschränkungen oder Nachteile. Achtung: Flashen des CULv4 setzt DFU-Programmer 0.5.4 oder höher voraus.
= Sendefrequenz =
Das CUL gibt es in Ausführungen für 868 und 433 MHz.
Die Sende- und Empfangsfrequenz des CUL sind in weiten Bereichen einstellbar, im SlowRF Mode auch durch direkte Befehle aus Fhem (im HM Mode derzeit nicht unterstützt). Der wesentliche Unterschied der 868 und 433 MHz CULs ist ein auf die Frequenz richtig abgestimmter HF-Eingangskreis inklusive Antennenlänge.
Es ist es durchaus möglich, ein 868 MHz CUL auf 433 MHz einzustellen. Da dann aber die HF-Eingangskreis-Abstimmung und Antennenlänge nicht korrekt sind, ist Empfangs- und Sendeleistung suboptimal, die Reichweite sinkt. Dennoch wird diese Möglichkeit des freien Einstellens durch das Fhem Intertechnomodul genutzt, da Intertechnokomponenten mit 433 MHz arbeiten. Dazu wird beim Senden eines Intertechno-Befehls die Frequenz eines 868 MHz CULs kurz umgestellt.

Denkbar ist auch der Einsatz eines CUL 433 MHz im Zusammenhang mit HomeMatic. Hier wird das CUL normalerweise im HM Mode betrieben, dessen Frequenz auf 868 MHz fest eingestellt ist. Die verminderte Sendeleistung aufgrund der falschen Antenne fällt je nach örtlicher Gegebenheit eventuell nicht ins Gewicht, da HomeMatic aufgrund seiner besseren Empfänger grundsätzlich etwas bessere Reichweiten hat als die empfangsseitig simplen Intertechnomodule. Soll nun ein Intertechnomodul geschaltet werden, wird das CUL kurzzeitig auf SlowRF umgeschaltet und dann in 433 MHz betrieben, jetzt mit optimaler Antennenabstimmung zur Reichweitenoptimierung der Intertechno-Komponenten, danach wird sofort in den HM Modus zurückgeschaltet, wodurch sich die Frequenz auch automatisch wieder auf 868 MHz ändert. Theoretisch ist hierbei allerdings der Verlust von HM-ACK Meldungen möglich, wenn diese dem Moment eintreffen, in dem das CUL gerade auf Intertechno umgeschaltet ist.

= Bekannte Probleme =
Im Gegensatz zu den original FHZ Zentralen ist das CUL recht flankensteil, d.h. die Sende- und Empfangsfrequenz wird genauer eingehalten als z. B. bei einer FHZ1x00PC. Dies kann im Zusammenhang mit den eher ungenauen Sendern z. B. der FHTs Raumregler zu Empfangsproblemen führen. Es kann daher mitunter sinnvoll sein, die Sende und Empfangsbandbreite des CUL etwas zu erhöhen. Dies senkt jedoch gleichzeitig die Empfindlichkeit.

Bei Empfangsproblemen von z. B. HEM-Sensoren oder dem S300TH kann man folgendes testen:

* Man kann die Frequenz des CUL auf genau 868,35MHz einstellen. Standardmäßig ist hier aus Kompatibelitätsgründen 868,30MHz eingestellt. Diese Einstellung wird fest im NVRAM gespeichert und braucht nur einmal vorgenommen zu werden.
*: <code>set CUL_0 freq 868.350</code>
* Es ist möglich die "decision boundary" zu vergrößern, frei beschrieben: die "Entscheidungsgrenze" ob die empfangene Signalflanke digital "0" oder "1" darstellte (<nowiki>[https://groups.google.com/forum/#!msg/fhem-users/HAaBri3eQgk/pqxHlN1aHkIJ%7Csie Diskussion hier]</nowiki>). Möglich sind die Werte "4", "8" und "16". Default-Einstellung ist hier "4". Zur Steigerung der Empfangsqualität soll es hilfreich sein hier "8" einzustellen. Mitunter bringt jedoch erst die Einstellung auf "16" signifikante Verbesserungen beim Empfang von S300TH-Sensoren.
*: <code>set CUL_0 sens 8</code>
* Oft hilft auch, die Bandweite auf z. B. 464 khz aufzuweiten.
= Links =
* [[:Kategorie:CUL]] - weitere Seiten rund um CUL
* Hersteller / Bezugsquelle für CUL: [http://www.busware.de/tiki-index.php?page=CUL busware.de]
* [http://culfw.de/culfw.html culfw.de] - Homepage der CUL firmware
** [http://culfw.svn.sourceforge.net/viewvc/culfw/trunk/culfw/ Sourceforge CUL firmware]
* Google groups [https://groups.google.com/group/cul-fans/ CUL fans]

[[Kategorie:Other Components]]
[[Kategorie:CUL]]
[[Kategorie:Glossary]]

Maximal nutzbare SlowRF Geräte

2013-06-22T15:11:05Z

Yfhem: Wikilink eingefügt, Korrektur.

Maximal nutzbare Geräte im FS20 / FHT System mit FHEM

Die Anzahl der mit FHEM per steuerbaren Geräte ist softwareseitig im Prinzip unbegrenzt.

Es ergeben sich jedoch insbesondere in Funksystemen deutliche Einschränkungen. So ist die Anzahl der praktisch nutzbaren Geräte vor allem durch die [[1% Regel]] eingeschränkt. Theoretisch ist auch der Adressraum eine Beschränkung, da z. B. FS20 256 Adressen für Geräte kennt; durch Nutzung von Dummy-Geräten wird der Adressraum zudem weiter belastet. Soweit wie bei FHEM mehrere Hauscodes frei verwendet werden können (in Abhängigkeit der verwendeten Funkschnittstelle), lässt sich diese Einschränkung allerdings umgehen.

==grundsätzliche Überlegungen==

Wegen der 1% Regel dürfen Geräte im FS20 / FHT und ähnlichen Funksystemen basierend auf dem 868 MHz Bereich nur 1% einer Stunde mit Funkbefehlen belegt werden, dies entspricht nur 0,6 Minuten (36 Sekunden).

Wärend die einzelnen Devices wie FS20 Aktoren oder FHT80bs diese Zeiten kaum erreichen, sind die Zentralen wie CUN, CUL oder FHZ stärker betroffen.

Besonders problematisch ist der Einsatz von FHT80b Raumreglern:

1. Das FHT/FS20 Funkprotokoll ("SlowRF") ist Gegensatz zum HomeMatic Protokoll relativ langsam, sodass eine Befehl siginifikante Sendezeit verbraucht.

2. Ist die FHT-Kommunikation mit der Zentrale bidirektional und

3. sendet ein FHT80b alle 15 Minuten Statuswerte an eine gepairte Zentrale.

Die Zentrale wird also quasi von aussen gezwungen, Daten an die bekannten (gepairten) FHT80bs zu senden, selbst wenn es eigentlich nichts mitzuteilen gibt. Die dadurch entstehende Funklast ist nicht unerheblich. Rechnerisch verbraucht die Kommunikation mit eine FHT80b ca. 2,1 Sekunden Sendezeit auf Seiten der Zentrale, also etwa 6% der je Stunde zur Verfügung stehenden Sendezeit. Daraus ergibt sich eine Obergrenze von 17 einsetzbaren FHT80bs je Zentrale. In realen Umgebungen wird die Kommunikation aber nicht fehlerfrei ablaufen, es wird also Wiederholungen geben. Ebenso belasten auch die ausgesendeten Telegramme an FS20 Aktoren und Temperaturänderungen an FHT80bs den Funkkanal zusätzlich. Faktisch sind daher circa ein Dutzend FHT80bs sinnvoll einsetzbar.

==detailierte Betrachtung==

Die bidirektionale Kommunikation kann mit FHEM bei Einsatz eines CUL/CUN(O) mitprotokolliert werden ("set CUL raw X61" vorher nicht vergessen). Hier ein beispielhafter Mitschnitt:

2008-09-28 13:04:18 FHT wz actuator: 0%
2008-09-28 13:04:18 FHT wz actuator: 0%
2008-09-28 13:04:18 FHT wz start-xmit: 17
2008-09-28 13:04:18 FHT wz FHZ:start-xmit: 17
2008-09-28 13:04:19 FHT wz measured-low: 21.9 (Celsius)
2008-09-28 13:04:19 FHT wz FHZ:measured-low: 21.9 (Celsius)
2008-09-28 13:04:19 FHT wz measured-high: 0
2008-09-28 13:04:19 FHT wz FHZ:measured-high: 0
2008-09-28 13:04:19 FHT wz ack: 0
2008-09-28 13:04:20 FHT wz FHZ:ack: 0
2008-09-28 13:04:20 FHT wz warnings: none
2008-09-28 13:04:20 FHT wz FHZ:warnings: none
2008-09-28 13:04:20 FHT wz ack: 0
2008-09-28 13:04:20 FHT wz FHZ:ack: 0
2008-09-28 13:04:20 FHT wz end-xmit: 0
2008-09-28 13:04:20 FHT wz FHZ:end-xmit: 0

Jede Zeile steht für ein Telegramm (und nicht für 3, wie beim FS20).

FHZ:xxx Telegramme wurden von dem FHZ (oder CUN/CUL) gesendet, die anderen vom FHT.

fhem fasst measured-low und measured-high zu measured-temp zusammen, es werden also im normalen log (telnet: inform timer) 2 Zeilen weniger gemeldet.

17 ist der FHT-ID des protokollierten FHZ. Wenn das FHZ nicht mit dem richtigen FHT-ID antwortet, dann geht die Kommunikation nicht weiter.

Wenn das FHT nicht an dem FHZ angemeldet ist (d.h. das FHT hat nicht die FHT-ID des FHZ gespeichert), werden keine Temperaturdaten uebermittelt.
Set Prog:Cent:N/A setzt die FHT-ID des FHT80 auf 100, dann sollte jede FHZ auf "start-xmit" antworten, und das FHT merkt den ersten. Noch besser dem FHT via FHEM was zu senden, dann muss man nicht auf die nächste Temperaturmeldung (bis zu 15 Minuten) warten.
Mehr dazu auch hier: [[FHT mit RFR CUL pairen]]
Falls die Gegenseite nicht wie erwartet antwortet, dann wird es nach einem Timeout das Telegramm einmal wiederholt. Falls immer noch keine korrekte Antwort vorliegt, dann wird es nach 115+x Sekunden das ganze Vorgang einmal wiederholt.

Jedes Telegramm ist bei 1000Baud ca 75ms lang. Die Temperatur wird pro FHT 4-mal die Stunde gemeldet: 4*7*75ms = 2.1s FHZ-Sendezeit pro FHT und Stunde, und da man wg. 1% 36 Sekunden hat, entspricht das 5.833% pro FHT. Wenn das 1% erschoepft ist, dann versucht das CUL zu antworten, aber es wird bei jedem Versuch LOVF ausgegeben.

Falls die Kommunikation nie abbricht (also fehlerfrei stattfinden kann), und sonst auch nichts gesendet wird, kann man mit einem FHZ 17 FHTs versorgen. Faktisch wird die Menge der einsetzbaren FHTs wesentlich geringer sein. ELV geht als Hersteller offenbar von maximal 10-14 FHTs aus, so unterstützt das Wärmerelais FHT8w maximal 10 Räume, während es in der Bedienungsanleitung der FHZ1000 Standalone Zentrale heisst, es könnten bis zu 15 Räume gesteuert werden. Da die FHZ1000 einen Raum selbst bedient, ist die Kommunikation mit weiteren 14 FHT80b Geräten notwendig.

==mögliche Abhilfe==

Denkbar ist der Einsatz mehrerer Zentralen, also z. B. mittels Anschluss mehrerer CULs/CUNs oder Nutzung von RFR CULs. Somit könnten Geräte auf die Zentralen verteilt werden, um die jeweilige Last zu senken.

Allerdings kann durchaus diskutiert werden, ob dies überhaupt zulässig wäre: Wenn man den FHEM-Hostrechner und angeschlossene FHZ Zentralen als ein System auffasst, könnte das Gesamtsystem rechtlich der 1% Regel unterworfen sein, auch wenn es technisch möglich ist, 2% zu senden.

Vor allem aber steigt die Wahrscheinlichkeit, dass FS20 oder FHT Nachrichten wegen Kanalbelegung nicht mehr erfolgreich übermittelt werden deutlich an. Insbesondere bei FS20 Aktoren, die in der Regel den jeweiligen Befehl unmittelbar ausführen sollen, kann das System recht unzuverlässig werden.

Sendefehler entstehen je nach Konfiguration sogar zwangsweise: Da wegen dem 115+x (x = 0.5sec * Low-Nibble der FHT-ID) die FHT-Sendeintervalle unterschiedlich sind, "kreuzen" sich zwei FHTs mit der FHT-ID 10 (115s Intervall) und FHT-ID 12 (116s Intervall) alle 115*115sec = 13225sec = 3.67h zwangsweise. Bei mehreren FHTs steigen die Kreuzungsmöglichkeiten.

Da die Zentrale nach der FHT Meldung sofort mit FHT:can-xmit antworten muss, steigt zusätzlich das Risiko, das FHTs mit dem übermitteln der Daten abbrechen, nur weil die FHZ Rückmeldung gestört wurde. D.H der Wiederholungsverkehr steigt vermutlich überproportional an.

Mehrere an einen FHEM Hostrechner angeschlossen Zentralen haben zur besseren Ausleuchtung durchaus ihre Berechtigung, zur Erhöhung der maximal nutzbaren Geräte sind sie aber nur bedingt geeignet, wenn nicht sogar unzulässig.

==Links==

[[Kommunikationsprobleme_mit_FHT]]

[[Kategorie:FS20 Components]]
[[Kategorie:FHT Components]]