From b272c4fe7d751014a69299de036a8b1a637a4cfc Mon Sep 17 00:00:00 2001
From: rudolfkoenig <>
Date: Fri, 28 Feb 2014 07:48:55 +0000
Subject: [PATCH] FHT: german doc
git-svn-id: https://svn.fhem.de/fhem/trunk@5070 2b470e98-0d58-463d-a4d8-8e2adae1ed80
---
fhem/FHEM/11_FHT.pm | 330 +++++++++++++++++++++++++++++++-
fhem/contrib/commandref_join.pl | 4 +-
2 files changed, 329 insertions(+), 5 deletions(-)
diff --git a/fhem/FHEM/11_FHT.pm b/fhem/FHEM/11_FHT.pm
index 956a00566..e801edc5a 100755
--- a/fhem/FHEM/11_FHT.pm
+++ b/fhem/FHEM/11_FHT.pm
@@ -5,7 +5,7 @@
# Copyright by
# e-mail:
#
-# This file is part of fhem.
+# This file is part of FHEM.
#
# Fhem is free software: you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
@@ -18,7 +18,7 @@
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
-# along with fhem. If not, see .
+# along with FHEM. If not, see .
#
##############################################################################
package main;
@@ -982,7 +982,7 @@ getFhtBuffer($)
tmpcorr
Correct the temperature reported by the FHT by the value specified.
- Note: only the measured-temp value reported by fhem (used for logging)
+ Note: only the measured-temp value reported by FHEM (used for logging)
will be modified.
@@ -1027,4 +1027,328 @@ getFhtBuffer($)
=end html
+
+=begin html_DE
+
+
+FHT
+
+ Fhem kann FHT Funktelegramme (868.35 MHz) entweder mit einem FHZ oder einem CUL empfangen, daher muss
+ dieses zuerst definiert sein.
+
+
+
+ Define
+
+ define <name> FHT <fhtaddress>
+
+
+ <fhtaddress> ist eine vierstellige HEX Zahl entsprechend der
+ Adresse des FHT80b Gerätes.
+
+
+ Beispiel:
+
+
+ Mehr dazu im FHT Abschnitt set.
+
+
+
+
+ Set
+
+ set <name> <valuetype> <value>
+
+ Wobei value eines von folgenden ist:
+
+ desired-temp
+ day-temp night-temp
+ report1 report2
+ refreshvalues
+ mode
+ holiday1 holiday2 # siehe mode holiday_short oder holiday
+ manu-temp # Keine Ahnung was das bewirkt
+ year month day hour minute
+ time date
+ lowtemp-offset # Alarm-Temp.-Differenz
+ windowopen-temp
+ mon-from1 mon-to1 mon-from2 mon-to2
+ tue-from1 tue-to1 tue-from2 tue-to2
+ wed-from1 wed-to1 wed-from2 wed-to2
+ thu-from1 thu-to1 thu-from2 thu-to2
+ fri-from1 fri-to1 fri-from2 fri-to2
+ sat-from1 sat-to1 sat-from2 sat-to2
+ sun-from1 sun-to1 sun-from2 sun-to2
+
+
+ Beispiele:
+
+ set wz desired-temp 22.5
+ set fl desired-temp 20.5 day-temp 19.0 night-temp 16.0
+
+
+
+ Hinweise:
+
+ - Folgende Events werden (mehr oder weniger regelmäßig) von
+ jedem FHT Device gemeldet:
+
+ measured-temp actuator actuator1...actuator8 warnings
+
+ Diese Strings können für notify oder
+ FileLog Definitionen verwendet werden.
+
+ - Warnings können folgende Strings enthalten:
+ none, Battery low,Temperature too low, Window open,
+ Fault on window sensor
+
+ - actuator (ohne Suffix) steht für alle Aktoren.
+ - actuator or actuator1..8 kann folgende Werte verarbeiten:
+
+ - <value>%
+ Das ist der Normalfall. Der Aktor wird angewiesen auf diesen
+ Wert zu öffnen.
+
+ - offset <value>%
+ Der Aktor läuft mit diesem Offset.
+
+ - lime-protection
+ Der Aktor wird angewiesen die lime-protection (Kalkschutz)
+ Prozedur auszuführen.
+
+ - synctime
+ Wenn Sond/Sync beim FHT80B gewählt wird, wird ein
+ Countdown gesetzt.
+
+ - test
+ Der Aktor wird vom FHT80b angewiesen zu piepsen (beep).
+
+ - pair
+ Das FHT80b sendet ein "you-belong-to-me"
+ (Du-gehörst-zu-mir) an diesen Aktor.
+
+
+
+
+
+ - Das FHT ist sehr sparsam (oder faul). Es akzeptiert eine Nachricht
+ vom FHZ1x00 alle 115+x Sekunden, wobei x von der fhtaddress
+ abhängt. Nicht überrascht sein wenn ein Befehl erst 10
+ Minuten später vom Gerät angenommen wird. Die FHT Befehle
+ werden im FHZ1x00/CUL gepuffert bis sie zum FHT geschickt werden.
+ Siehe den zugehörigen fhtbuf Eintrag im der get Abschnitt. Es können bis zu 8 Befehle in
+ einer Nachricht an ein FHT geschickt werden wenn diese alle als
+ Argumente im gleichen set Befehl zusammengefasst werden. Siehe
+ nachfolgendes Beispiel.
+
+ - time setzt Stunde und Minute auf lokale Zeit
+
+ - date setzt Jahr, Monat und Tag auf lokale Zeit
+
+ - refreshvalues ist ein Alias für report1 255 report2 255
+
+ - Alle *-temp Werte brauchen eine Temperatur als Argument welche auf
+ 0.5°C gerundet wird.
Temperatur Werte müssen zwischen
+ 5.5°C und 30.5°C sein. Der Wert 5.5 setzt den Aktor auf OFF,
+ der Wert 30.5 setzt den Aktor auf ON
+
+ - mode kann auto, manual, holiday or
+ holiday_short sein.
+ Wenn der mode holiday ist, schaltet dieser zurück auf entweder
+ auto oder manual um 00:00 des Tages der wie folgt spezifiziert wird:
+
+ - holiday1 setzt Endtag des Urlaubs
+ - holiday2 setzt den Endmonat des Urlaubs
+
+ Für holiday_short (Party Modus)
+
+ - holiday1 setzt die absolute Stunde zu der von diesem Modus
+ zurück geschalten wird (in 10-Minuten Schritten, max.
+ 144)
+
+ - holiday2 setzt den Tag des Monats an dem von diesem Modus
+ zurück geschalten wird (kann nur heute oder morgen sein, da
+ holiday1 nur 24h akzeptiert.)
+
+ Beispiel:
+
+ - Aktuelles Datum ist der 29. Januar, Uhrzeit ist 18:05
+ - Es soll bis morgen 1:00Uhr in den Party Modus geschalten
+ sein
+ - set holiday1 to 6 (6 x 10min = Std) and holiday2 to
+ 30
+
+
+
+ Die Temperatur für den Urlaubszeitraum wird durch den
+ desired-temperature Parameter setzt.
Bitte beachten, dass der
+ Holiday Mode nicht früher als auf Übermorgen eingestellt
+ werden kann. Alternativ muss hier holiday_short genutzt werden.
+ Weiterhin bitte beachten das diese Kommandos nur in einem
+ "Sammelkommando" erfolgen können. Beispiel:
+
+ set FHT1 mode holiday holiday1 24 holiday2 12 desired-temp 14
+
+
+ - Die *-from1/*-from2/*-to1/*-to2 Wertetypen brauchen eine
+ Zeitspezifikation als Argument im Format HH:MM. Diese definieren den
+ Zeitraum in dem die day-temp gültig ist. Minuten (MM) werden
+ auf 10er gerundet, 24:00 bedeutet OFF.
+
+ - Um die FHZ Zeit zu synchronisieren und um "stumme" Geräte
+ zu wecken, wird folgendes Kommando empfohlen:
define fht_sync at
+ +*3:30 set TYPE=FHT time
+
+ - report1 mit dem Parameter 255 fordert das Senden aller Einstellungen
+ von Montag bis Sonntag an. Das Argument ist ein Bitfeld um einzelne
+ Werte wie folgt anzufordern:
+
+ - 1: monday
+ - 2: tuesday
+ - 4: thursday
+ - 8: wednesday
+ - 16: friday
+ - 32: saturday
+ - 64: sunday
+
+ measured-temp und actuator werden mitgesendet wenn vom FHT als
+ notwendig erachtet.
+
+ Hinweis: Dieser Befehl erzeugt sehr viel Funkverkehr was zu
+ weiteren Problemen führen kann, besonders wenn Empfang nicht gut
+ ist.
+
+ - report2 mit dem Parameter 255 fordert die Ausgabe der nachfolgenden
+ Einstellungen an:
day-temp night-temp windowopen-temp
+ lowtemp-offset desired-temp measured-temp mode warnings.
Das
+ Argument ist ein Bitfeld, um einzelne Werte abzufragen folgendes
+ anhängen:
+
+ - 1: warnings
+ - 2: mode
+ - 4: day-temp, night-temp, windowopen-temp
+ - 64: lowtemp-offset
+
+ measured-temp und actuator werden mitgesendet wenn vom FHT als
+ notwendig erachtet.
+
+ - lowtemp-offset braucht eine Temperatur als Argument. Gültige
+ Werte müssen zwischen 1.0 und 5.0°C liegen.
Wird eine
+ Warnung erzeugen wenn die desired-temp - measured-temp >
+ lowtemp-offset, jedoch frühestens 1,5Stunden nach der letzten
+ Änderung der desired-temp.
+
+ - FHEM hat optional einen internen Softwarepuffer für FHT
+ Devices. Dieser Puffer soll vor Übertragungsfehlern
+ schützen. Wenn nach einem bestimmten Zeitraum keine
+ Bestätigung erhalten wurde wird FHEM den Befehl erneut senden.
+ Die Befehle in der Warteschlagen können mit list <fht-device> angezeigt werden. Siehe die
+ Attribute fhtsoftbuffer, retrycount und minfhtbuffer für weitere Details.
+
+
+ - Befehle im Softwarepuffer werden in folgender Reihenfolge
+ gesendet:
+ desired-temp,mode,report1,report2,holiday1,holiday2,day-temp,night-temp,
+ [all other commands]
+
+
+
+
+
+ Get
+
+
+ Attribute
+
+ - dummy
+ Hinweis: Es macht Sinn ein FHT Device auch für ein FHT8b zu
+ definieren da sonst der Fehler "unknown FHT device, please define one"
+ für jedes FHT8b generiert wird, denn das CUL meldet die 8b
+ Nachrichten. Das dummy Attribut sollte bei diesen Devices gesetzt werden
+ da sonst der interne FHT Buffer des CUL mit 8b-Daten gefüllt wird
+ die niemals gebraucht werden. Wenn der Puffer dann voll ist werden "EOB"
+ Nachrichten vom CUL erzeugt, und Senden zu den 8b ist nicht mehr
+ möglich.
+
+
+ - retrycount
+ Wenn das fhtsoftbuffer Attribut gesetzt ist,
+ dann werden die Befehle entsprechend dem retrycount n-mal erneut
+ versendet wenn nach 240 Sekunden keine Bestätigungsmeldung vom
+ entsprechenden FHZ Device empfangen wurde.
Der Default-Wert ist
+ 1.
+
+
+ - minfhtbuffer
+ FHEM sendet keine Befehle mehr zum FHZ wenn der fhtbuffer-Wert diesen
+ Wert unterschritten hat. Default-Wert ist 0. Wenn dieser Wert zu niedrig
+ ist hat die Reihenfolge von fht-Befehlen weniger Einfluss da nur Befehle
+ im Softbuffer priorisiert werden können. (Siehe Hinweise in der FHT
+ Sektion set) Der Maximalwert sollte 7 unter dem
+ Hardware Maximum sein, siehe fhtbuf.
+
+
+ - lazy
+ Wenn das Attribut lazy (faul) gesetzt wurde sendet FHEM keine Befehle
+ wenn die aktuell gelesenen Werte und der zu setzende Wert identisch sind.
+ Das spart Funkzeit und hilft Konflikte mit der Regelung die besagt, dass
+ maximal 1% der Zeit als Funkzeit verwendet werden darf, zu vermeiden.
+ Nicht standardmäßig aktiviert.
+
+
+ - tmpcorr
+ Korrigiert die Werte die vom FHZ gemeldet werden um den angegebenen Wert.
+ Hinweis: nur die measured-temp Werte die von FHEM gemeldet (für
+ Logging genutzt) werden angepasst.
+
+ - ignore
+ - do_not_notify
+ - model (fht80b)
+ - showtime
+ - IODev
+ - eventMap
+ - readingFnAttributes
+
+
+
+
+
+ Erzeugte Events:
+
+ - actuator
+ - actuator1 actuator2 actuator3 actuator4
+ actuator5 actuator6 actuator7 actuator8
+ (wird gesendet wenn ein Offset zum entsprechenden Ventil konfiguriert wurde)
+ - mon-from1 mon-to1 mon-from2 mon-to2
+ - tue-from1 tue-to1 tue-from2 tue-to2
+ - wed-from1 wed-to1 wed-from2 wed-to2
+ - thu-from1 thu-to1 thu-from2 thu-to2
+ - fri-from1 fri-to1 fri-from2 fri-to2
+ - sat-from1 sat-to1 sat-from2 sat-to2
+ - sun-from1 sun-to1 sun-from2 sun-to2
+ - mode
+ - holiday1 holiday2
+ - desired-temp
+ - measured-temp measured-low measured-high
+ - warnings
+ - manu-temp
+ - year month day hour minute
+ - day-temp night-temp lowtemp-offset windowopen-temp
+ - ack can-xmit can-rcv ack2 start-xmit end-xmit (Nur wenn das CUL
+ für die Übertragung von FHT Protokoll Daten konfiguriert
+ ist)
+
+
+
+
+
+=end html_DE
+
=cut
diff --git a/fhem/contrib/commandref_join.pl b/fhem/contrib/commandref_join.pl
index 2014827a0..d6e1c0aa2 100755
--- a/fhem/contrib/commandref_join.pl
+++ b/fhem/contrib/commandref_join.pl
@@ -109,8 +109,8 @@ foreach my $lang (@lang) {
$mod
- Sorry, keine deutsche Dokumentation vorhanden.
- Die englische Doku gibt es hier: $mod
+ Leider keine deutsche Dokumentation vorhanden. Die englische Version gibt es
+ hier: $mod
EOF
}