diff --git a/fhem/FHEM/10_RESIDENTS.pm b/fhem/FHEM/10_RESIDENTS.pm index 11b6cd767..ef4616281 100644 --- a/fhem/FHEM/10_RESIDENTS.pm +++ b/fhem/FHEM/10_RESIDENTS.pm @@ -23,7 +23,7 @@ # along with fhem. If not, see . # # -# Version: 1.0.1 +# Version: 1.0.2 # # Major Version History: # - 1.0.0 - 2014-02-08 @@ -948,7 +948,7 @@ sub RESIDENTS_TimeDiff($$) { Attributes


@@ -990,11 +990,101 @@ sub RESIDENTS_TimeDiff($$) {

RESIDENTS

- =end html_DE diff --git a/fhem/FHEM/20_GUEST.pm b/fhem/FHEM/20_GUEST.pm index 1443b46d3..0201b7c73 100644 --- a/fhem/FHEM/20_GUEST.pm +++ b/fhem/FHEM/20_GUEST.pm @@ -23,7 +23,7 @@ # along with fhem. If not, see . # # -# Version: 1.0.1 +# Version: 1.0.2 # # Major Version History: # - 1.0.0 - 2014-02-08 @@ -1028,14 +1028,14 @@ sub GUEST_StartInternalTimers($$) {
  • rg_locationHome - locations matching these will be treated as being at home; first entry reflects default value to be used with state correlation; separate entries by space; defaults to 'home'
  • rg_locationUnderway - locations matching these will be treated as being underway; first entry reflects default value to be used with state correlation; separate entries by comma or space; defaults to "underway"
  • rg_locationWayhome - leaving a location matching these will set reading wayhome to 1; separate entries by space; defaults to "wayhome"
    • -
  • rg_locations - list of locations ot be shown in FHEMWEB; separate entries by comma only and do NOT use spaces
    • +
  • rg_locations - list of locations to be shown in FHEMWEB; separate entries by comma only and do NOT use spaces
  • rg_moodDefault - the mood that should be set after arriving at home or changing state from awoken to home
  • rg_moodSleepy - the mood that should be set if state was changed to gotosleep or awoken
  • rg_moods - list of moods to be shown in FHEMWEB; separate entries by comma only and do NOT use spaces
  • rg_passPresenceTo - synchronize presence state with other GUEST or GUEST devices; separte devices by space
  • rg_realname - whenever GUEST wants to use the realname it uses the value of attribute alias or group; defaults to group
  • rg_showAllStates - states 'asleep' and 'awoken' are hidden by default to allow simple gotosleep process via devStateIcon; defaults to 0
    • -
  • rg_states - list of states ot be shown in FHEMWEB; separate entries by comma only and do NOT use spaces; unsupported states will lead to errors though
    • +
  • rg_states - list of states to be shown in FHEMWEB; separate entries by comma only and do NOT use spaces; unsupported states will lead to errors though


    • @@ -1075,11 +1075,173 @@ sub GUEST_StartInternalTimers($$) {

    GUEST

    - =end html_DE diff --git a/fhem/FHEM/20_ROOMMATE.pm b/fhem/FHEM/20_ROOMMATE.pm index 0d2b39d8f..3a14e95c5 100644 --- a/fhem/FHEM/20_ROOMMATE.pm +++ b/fhem/FHEM/20_ROOMMATE.pm @@ -23,7 +23,7 @@ # along with fhem. If not, see . # # -# Version: 1.0.1 +# Version: 1.0.2 # # Major Version History: # - 1.0.0 - 2014-02-08 @@ -157,7 +157,7 @@ sub ROOMMATE_Define($$) { unless ( exists( $attr{$name}{$name_attr} ) ) { Log3 $name, 4, "ROOMMATE $name: created new attribute '$name_attr'"; - $attr{$name}{$name_attr} = "status_available"; + $attr{$name}{$name_attr} = "people_sensor"; } # attr room @@ -1024,14 +1024,14 @@ sub ROOMMATE_StartInternalTimers($$) {
  • rr_locationHome - locations matching these will be treated as being at home; first entry reflects default value to be used with state correlation; separate entries by space; defaults to 'home'
  • rr_locationUnderway - locations matching these will be treated as being underway; first entry reflects default value to be used with state correlation; separate entries by comma or space; defaults to "underway"
  • rr_locationWayhome - leaving a location matching these will set reading wayhome to 1; separate entries by space; defaults to "wayhome"
    • -
  • rr_locations - list of locations ot be shown in FHEMWEB; separate entries by comma only and do NOT use spaces
    • +
  • rr_locations - list of locations to be shown in FHEMWEB; separate entries by comma only and do NOT use spaces
  • rr_moodDefault - the mood that should be set after arriving at home or changing state from awoken to home
  • rr_moodSleepy - the mood that should be set if state was changed to gotosleep or awoken
  • rr_moods - list of moods to be shown in FHEMWEB; separate entries by comma only and do NOT use spaces
  • rr_passPresenceTo - synchronize presence state with other ROOMMATE or GUEST devices; separte devices by space
  • rr_realname - whenever ROOMMATE wants to use the realname it uses the value of attribute alias or group; defaults to group
  • rr_showAllStates - states 'asleep' and 'awoken' are hidden by default to allow simple gotosleep process via devStateIcon; defaults to 0
    • -
  • rr_states - list of states ot be shown in FHEMWEB; separate entries by comma only and do NOT use spaces; unsupported states will lead to errors though
    • +
  • rr_states - list of states to be shown in FHEMWEB; separate entries by comma only and do NOT use spaces; unsupported states will lead to errors though


    • @@ -1068,11 +1068,177 @@ sub ROOMMATE_StartInternalTimers($$) {

    ROOMMATE

      -Eine deutsche Version der Dokumentation ist derzeit nicht vorhanden. -Die englische Version ist hier zu finden: -
    -
      -ROOMMATE + + + Define +
        + define <rr_FirstName> ROOMMATE [<Device Name der Bewohnergruppe>] +

        + + Stellt ein spezielles Dummy Device bereit, welches einen Mitbewohner repräsentiert.
        + Basierend auf dem aktuelle Status und anderen Readings können andere Aktionen innerhalb von FHEM angestoßen werden.

        + Wird vom übergeordneten Modul RESIDENTS verwendet, kann aber auch einzeln benutzt werden.

        + + Beispiele:
        +
          + # Einzeln
          + define rr_Manfred ROOMMATE +

          + # Typisches Gruppenmitglied
          + define rr_Manfred ROOMMATE rgr_Residents # um Mitglied der Gruppe rgr_Residents zu sein +

          + # Mitglied in mehreren Gruppen
          + define rr_Manfred ROOMMATE rgr_Residents,rgr_Parents # um Mitglied den Gruppen rgr_Residents und rgr_Parents zu sein +

          + # Komplexe Familien Struktur
          + define rr_Manfred ROOMMATE rgr_Residents,rgr_Parents # Elternteil
          + define rr_Lisa ROOMMATE rgr_Residents,rgr_Parents # Elternteil
          + define rr_Rick ROOMMATE rgr_Residents,rgr_Children # Kind1
          + define rr_Alex ROOMMATE rgr_Residents,rgr_Children # Kind2 +
        +

      + +
        Bitte beachten, dass das RESIDENTS Gruppen Device zunächst angelegt werden muss, bevor ein ROOMMATE Objekt dort Mitglied werden kann.

      +
      +
      + + + Set +
        + set <rr_FirstName> <command> [<parameter>] +

        + Momentan sind die folgenden Kommandos definiert.
        +
          +
        • location   -   setzt das Reading 'location'; siehe auch Attribut rr_locations, um die in FHEMWEB angezeigte Liste anzupassen
          • +
        • mood   -   setzt das Reading 'mood'; siehe auch Attribut rr_moods, um die in FHEMWEB angezeigte Liste anzupassen
          • +
        • state   home,gotosleep,asleep,awoken,absent,gone   wechselt den Status; siehe auch Attribut rr_states, um die in FHEMWEB angezeigte Liste anzupassen
          • +
        +
      + +

      +
        + Mögliche Stati und ihre Bedeutung

        +
          + Dieses Modul unterscheidene 6 verschiedene Stati:

          + +
            +
          • home - Mitbrwohner ist zuhause und wach
            • +
          • gotosleep - Mitbewohner ist auf dem Weg ins Bett
            • +
          • asleep - Mitbewohner schläft
            • +
          • awoken - Mitbewohner ist gerade aufgewacht
            • +
          • absent - Mitbewohner ist momentan nicht zuhause, wird aber bald zurück sein
            • +
          • gone - Mitbewohner ist für längere Zeit verreist
            • +
          + +
        +
      +
      +
      + +
        + Zusammenhang zwischen Anwesenheit/Presence und Aufenthaltsort/Location

        +
          + Unter bestimmten Umständen führt der Wechsel des Status auch zu einer Änderung des Readings 'location'.
          +
          + Wannimmer die Anwesenheit (bzw. das Reading 'presence') von 'absent' auf 'present' wechselt, wird 'location' auf 'home' gesetzt. Sofern das Attribut rr_locationHome gesetzt ist, wird die erste Lokation daraus anstelle von 'home' verwendet.
          +
          + Wannimmer die Anwesenheit (bzw. das Reading 'presence') von 'present' auf 'absent' wechselt, wird 'location' auf 'underway' gesetzt. Sofern das Attribut rr_locationUnderway gesetzt ist, wird die erste Lokation daraus anstelle von 'underway' verwendet. +
        +
      +
      +
      + +
        + Auto-Status 'gone'

        +
          + Immer wenn ein Mitbewohner auf 'absent' gesetzt wird, wird ein Zähler gestartet, der nach einer bestimmten Zeit den Status automatisch auf 'gone' setzt.
          + Der Standard ist nach 36 Stunden.
          +
          + Dieses Verhalten kann über das Attribut rr_autoGoneAfter angepasst werden. +
        +
      +
      +
      + +
        + Anwesenheit mit anderen ROOMMATE oder GUEST Devices synchronisieren

        +
          + Wenn Sie immer zusammen mit anderen Mitbewohnern oder Gästen das Haus verlassen oder erreichen, können Sie ihren Status ganz einfach auf andere Mitbewohner übertragen.
          + Durch das Setzen des Attributs rr_PassPresenceTo folgen die dort aufgeführten Mitbewohner ihren eigenen Statusänderungen nach 'home', 'absent' oder 'gone'.
          +
          + Bitte beachten, dass Mitbewohner mit dem aktuellen Status 'gone' oder 'none' (im Falle von Gästen) nicht beachtet werden. +
        +
      +
      +
      + +
        + Zusammenhang zwischen Aufenthaltsort/Location und Anwesenheit/Presence

        +
          + Unter bestimmten Umständen hat der Wechsel des Readings 'location' auch einen Einfluss auf den tatsächlichen Status.
          +
          + Immer wenn eine Lokation mit dem Namen 'home' gesetzt wird, wird auch der Status auf 'home' gesetzt, sofern die Anwesenheit bis dahin noch auf 'absent' stand. Sofern das Attribut rr_locationHome gesetzt wurde, so lösen alle dort angegebenen Lokationen einen Statuswechsel nach 'home' aus.
          +
          + Immer wenn eine Lokation mit dem Namen 'underway' gesetzt wird, wird auch der Status auf 'absent' gesetzt, sofern die Anwesenheit bis dahin noch auf 'present' stand. Sofern das Attribut rr_locationUnderway gesetzt wurde, so lösen alle dort angegebenen Lokationen einen Statuswechsel nach 'underway' aus. Diese Lokationen werden auch nicht in das Reading 'lastLocation' übertragen.
          +
          + Immer wenn eine Lokation mit dem Namen 'wayhome' gesetzt wird, wird das Reading 'wayhome' auf '1' gesetzt, sofern die Anwesenheit zu diesem Zeitpunkt 'absent' ist. Sofern das Attribut rr_locationWayhome gesetzt wurde, so führt das VERLASSEN einer dort aufgeführten Lokation ebenfalls dazu, dass das Reading 'wayhome' auf '1' gesetzt wird. Es gibt also 2 Möglichkeiten den Nach-Hause-Weg-Indikator zu beeinflussen (implizit und explizit).
          + Die Ankunft zuhause setzt den Wert von 'wayhome' zurück auf '0'.
          +
          + Wenn Sie auch das GEOFANCY Modul verwenden, können Sie das Reading 'location' ganz einfach über GEOFANCY Ereignisse aktualisieren lassen. Definieren Sie dazu einen NOTIFY-Trigger wie diesen:
          +
          + + define n_rr_Manfred.location notify geofancy:currLoc_Manfred.* set rr_Manfred location $EVTPART1 +
          +
          + Durch das Anlegen von Geofencing-Zonen mit den Namen 'home' und 'wayhome' in der iOS App werden zukünftig automatisch alle Statusänderungen wie oben beschrieben durchgeführt. +
        +
      +
      +
      + + + Attribute
      +
          +
        • rr_autoGoneAfter - Anzahl der Stunden, nach denen sich der Status automatisch auf 'gone' ändert, wenn der aktuelle Status 'absent' ist; Standard ist 36 Stunden
          • +
        • rr_locationHome - hiermit übereinstimmende Lokationen werden als zuhause gewertet; der erste Eintrag wird für das Zusammenspiel bei Statusänderungen benutzt; mehrere Einträge durch Leerzeichen trennen; Standard ist 'home'
          • +
        • rr_locationUnderway - hiermit übereinstimmende Lokationen werden als unterwegs gewertet; der erste Eintrag wird für das Zusammenspiel bei Statusänderungen benutzt; mehrere Einträge durch Leerzeichen trennen; Standard ist 'underway'
          • +
        • rr_locationWayhome - das Verlassen einer Lokation, die hier aufgeführt ist, lässt das Reading 'wayhome' auf '1' setzen; mehrere Einträge durch Leerzeichen trennen; Standard ist "wayhome"
          • +
        • rr_locations - Liste der in FHEMWEB anzuzeigenden Lokationsauswahlliste in FHEMWEB; mehrere Einträge nur durch Komma trennen und KEINE Leerzeichen verwenden
          • +
        • rr_moodDefault - die Stimmung, die nach Ankunft zuhause oder nach dem Statuswechsel von 'awoken' auf 'home' gesetzt werden soll
          • +
        • rr_moodSleepy - die Stimmung, die nach Statuswechsel zu 'gotosleep' oder 'awoken' gesetzt werden soll
          • +
        • rr_moods - Liste von Stimmungen, wie sie in FHEMWEB angezeigt werden sollen; mehrere Einträge nur durch Komma trennen und KEINE Leerzeichen verwenden
          • +
        • rr_passPresenceTo - synchronisiere die Anwesenheit mit anderen ROOMMATE oder GUEST Devices; mehrere Devices durch Leerzeichen trennen
          • +
        • rr_realname - wo immer ROOMMATE den richtigen Namen verwenden möchte nutzt es den Wert des Attributs alias oder group; Standard ist group
          • +
        • rr_showAllStates - die Stati 'asleep' und 'awoken' sind normalerweise nicht immer sichtbar, um einen einfachen Zubettgeh-Prozess über das devStateIcon Attribut zu ermöglichen; Standard ist 0
          • +
        • rr_states - Liste aller in FHEMWEB angezeigter Stati; Eintrage nur mit Komma trennen und KEINE Leerzeichen benutzen; nicht unterstützte Stati führen zu Fehlern
          • +
      +
      +
      + +
      + Generierte Readings/Events:
      +
          +
        • durTimerAbsence - Timer, der die Dauer der Abwesenheit in Minuten anzeigt
          • +
        • durTimerPresence - Timer, der die Dauer der Anwesenheit in Minuten anzeigt
          • +
        • durTimerSleep - Timer, der die Schlafdauer in Minuten anzeigt/li> +
        • lastArrival - Zeitstempel der letzten Ankunft zu Hause
          • +
        • lastAwake - Zeitstempel des Endes des letzten Schlafzyklus
          • +
        • lastDeparture - Zeitstempel des letzten Verlassens des Zuhauses
          • +
        • lastDurAbsence - Dauer der letzten Abwesenheit im folgenden Format: Stunden:Minuten:Sekunden
          • +
        • lastDurPresence - Dauer der letzten Anwesenheit im folgenden Format: Stunden:Minuten:Sekunden
          • +
        • lastDurSleep - Dauer des letzten Schlafzyklus im folgenden Format: Stunden:Minuten:Sekunden
          • +
        • lastLocation - der vorherige Aufenthaltsort
          • +
        • lastMood - die vorherige Stimmung
          • +
        • lastSleep - Zeitstempel des Beginns des letzten Schlafzyklus
          • +
        • lastState - der vorherige Status
          • +
        • location - der aktuelle Aufenthaltsort
          • +
        • presence - gibt den Zuhause Status in Abhängigkeit des Readings 'state' wieder (kann 'present' oder 'absent' sein)
          • + +
        • mood - die aktuelle Stimmung
          • +
        • state - gibt den aktuellen Status wieder
          • +
        • wayhome - abhängig vom aktullen Aufenthaltsort, kann der Wert '1' werden, wenn die Person auf dem weg zurück nach Hause ist
          • +
      +
    =end html_DE