From e2323278615b5611e2140997fcc92cf4cfed9b00 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: +
          + define wz FHT 3232
          +
        +
        + 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
        N/A

      + + + 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 }