diff --git a/fhem/FHEM/10_RESIDENTS.pm b/fhem/FHEM/10_RESIDENTS.pm
index dadf54fb0..e446a9698 100644
--- a/fhem/FHEM/10_RESIDENTS.pm
+++ b/fhem/FHEM/10_RESIDENTS.pm
@@ -1587,9 +1587,9 @@ sub RESIDENTS_UpdateReadings (@) {
RESIDENTS
-
+
Define
-
+
define <rgr_ResidentsName> RESIDENTS
Provides a special dummy device to represent a group of individuals living at your home.
@@ -1597,14 +1597,14 @@ sub RESIDENTS_UpdateReadings (@) {
Based on the current state and other readings, you may trigger other actions within FHEM.
Example:
-
+
# Standalone
define rgr_Residents RESIDENTS
-
+
+
Set
-
+
set <rgr_ResidentsName> <command> [<parameter>]
Currently, the following commands are defined.
@@ -1632,12 +1632,12 @@ sub RESIDENTS_UpdateReadings (@) {
Note: If you would like to restrict access to admin set-commands (-> addGuest, addRoommate, removeGuest, create) you may set your FHEMWEB instance's attribute allowedCommands like 'set,set-user'.
The string 'set-user' will ensure only non-admin set-commands can be executed when accessing FHEM using this FHEMWEB instance.
-
+
-
+
Possible states and their meaning
-
+
This module differs between 7 states:
@@ -1665,11 +1665,11 @@ sub RESIDENTS_UpdateReadings (@) {
Note: State 'none' cannot explicitly be set. Setting state to 'gone' will be handled as 'none' for GUEST member devices.
-
+
+
Attributes
-
+
-
rgr_showAllStates - states 'asleep' and 'awoken' are hidden by default to allow simple gotosleep process via devStateIcon; defaults to 0
@@ -1681,11 +1681,11 @@ sub RESIDENTS_UpdateReadings (@) {
rgr_wakeupDevice - reference to enslaved DUMMY devices used as a wake-up timer (part of RESIDENTS Toolkit's wakeuptimer)
-
+
Generated Readings/Events:
-
+
-
lastActivity - the last state change of one of the group members
@@ -1892,11 +1892,11 @@ sub RESIDENTS_UpdateReadings (@) {
wakeup - becomes '1' while a wake-up program of this resident group is being executed
-
+
RESIDENTS Toolkit
-
+
Using set-command create you may add pre-configured configurations to your RESIDENTS, ROOMMATE or GUEST devices for your convenience.
The following commands are currently available:
@@ -1943,8 +1943,8 @@ sub RESIDENTS_UpdateReadings (@) {
-
-
RESIDENTS
-
+
Define
-
+
define <rgr_ResidentsName> RESIDENTS
Stellt ein spezielles Dummy-Device bereit, um eine Gruppe von Personen zu repräsentieren, die zusammen wohnen.
Es kombiniert dabei logisch die individuellen Status von ROOMMATE und GUEST Devices und erlaubt den Status für alle Mitglieder zeitgleich zu ändern. Basierend auf dem aktuellen Status und anderen Readings können andere Aktionen innerhalb von FHEM angestoßen werden.
Beispiele:
-
+
# Einzeln
define rgr_Residents RESIDENTS
-
+
+
Set
-
+
set <rgr_ResidentsName> <command> [<parameter>]
Momentan sind die folgenden Kommandos definiert.
@@ -2000,12 +2000,12 @@ sub RESIDENTS_UpdateReadings (@) {
Hinweis: Sofern der Zugriff auf administrative set-Kommandos (-> addGuest, addRoommate, removeGuest, create) eingeschränkt werden soll, kann in einer FHEMWEB Instanz das Attribut allowedCommands ähnlich wie 'set,set-user' erweitert werden.
Die Zeichenfolge 'set-user' stellt dabei sicher, dass beim Zugriff auf FHEM über diese FHEMWEB Instanz nur nicht-administrative set-Kommandos ausgeführt werden können.
-
+
-
+
Mögliche Status und ihre Bedeutung
-
+
Dieses Modul unterscheidet 7 verschiedene Status:
@@ -2033,11 +2033,11 @@ sub RESIDENTS_UpdateReadings (@) {
Hinweis: Der Status 'none' kann nicht explizit gesetzt werden. Das setzen von 'gone' wird bei Mitgliedern vom Typ GUEST als 'none' behandelt.
-
+
+
Attribute
-
+
-
rgr_showAllStates - die Status 'asleep' und 'awoken' sind normalerweise nicht immer sichtbar, um einen einfachen Zubettgeh-Prozess über das devStateIcon Attribut zu ermöglichen; Standard ist 0
@@ -2049,11 +2049,11 @@ sub RESIDENTS_UpdateReadings (@) {
rgr_wakeupDevice - Referenz zu versklavten DUMMY Geräten, welche als Wecker benutzt werden (Teil von RESIDENTS Toolkit's wakeuptimer)
-
+
Generierte Readings/Events:
-
+
-
lastActivity - der letzte Status Wechsel eines Gruppenmitglieds
@@ -2260,11 +2260,11 @@ sub RESIDENTS_UpdateReadings (@) {
wakeup - hat den Wert '1' während ein Weckprogramm dieser Bewohner-Gruppe ausgeführt wird
-
+
RESIDENTS Toolkit
-
+
Mit dem set-Kommando create können zur Vereinfachung vorkonfigurierte Konfigurationen zu RESIDENTS, ROOMMATE oder GUEST Geräten hinzugefügt werden.
Die folgenden Kommandos sind momentan verfügbar:
@@ -2311,8 +2311,8 @@ sub RESIDENTS_UpdateReadings (@) {
-
-
ENIGMA2
-
+
Define
-
+
define <name> ENIGMA2 <ip-address-or-hostname> [<port>] [<poll-interval>] [<http-user>] [<http-password>]
This module controls ENIGMA2 based devices like Dreambox or VUplus via network connection.
@@ -2838,7 +2838,7 @@ sub ENIGMA2_GetRemotecontrolCommand($) {
Defining an ENIGMA2 device will schedule an internal task (interval can be set with optional parameter <poll-interval> in seconds, if not set, the value is 45 seconds), which periodically reads the status of the device and triggers notify/filelog commands.
Example:
-
+
define SATReceiver ENIGMA2 192.168.0.10
# With custom port
@@ -2849,11 +2849,11 @@ sub ENIGMA2_GetRemotecontrolCommand($) {
# With HTTP user credentials
define SATReceiver ENIGMA2 192.168.0.10 80 20 root secret
-
+
+
Set
-
+
set <name> <command> [<parameter>]
Currently, the following commands are defined.
@@ -2930,36 +2930,36 @@ sub ENIGMA2_GetRemotecontrolCommand($) {
Note: If you would like to restrict access to admin set-commands (-> statusRequest, reboot, restartGui, shutdown) you may set your FHEMWEB instance's attribute allowedCommands like 'set,set-user'.
The string 'set-user' will ensure only non-admin set-commands can be executed when accessing FHEM using this FHEMWEB instance.
-
+
-
+
+
+
Get
-
+
get <name> <what>
Currently, the following commands are defined:
-
+
channel
currentMedia
currentTitle
@@ -2971,11 +2971,11 @@ sub ENIGMA2_GetRemotecontrolCommand($) {
input
streamUrl
volume
-
+
+
Attributes
-
+
-
bouquet-tv - service reference address where the favorite television bouquet can be found (initially set automatically during define)
@@ -3011,11 +3011,11 @@ sub ENIGMA2_GetRemotecontrolCommand($) {
wakeupCmd - Set a command to be executed when turning on an absent device. Can be an FHEM command or Perl command in {}. Available variables: ENIGMA2 device name -> $DEVICE, ENIGMA2 device MAC address -> $MACADDR (default=Wake-on-LAN)
-
+
Generated Readings/Events:
-
+
-
acg - Shows Automatic Gain Control value in percent; reflects overall signal quality strength
@@ -3234,8 +3234,8 @@ sub ENIGMA2_GetRemotecontrolCommand($) {
webifversion - Type and version of the used web interface
-
-
ENIGMA2
-
+
Eine deutsche Version der Dokumentation ist derzeit nicht vorhanden. Die englische Version ist hier zu finden:
-
ONKYO_AVR
-
+
Define
-
+
define <name> ONKYO_AVR <ip-address-or-hostname> [<protocol-version>] [<zone>] [<poll-interval>]
This module controls ONKYO A/V receivers via network connection.
@@ -1695,7 +1695,7 @@ sub ONKYO_AVR_RClayout() {
Defining an ONKYO device will schedule an internal task (interval can be set with optional parameter <poll-interval> in seconds, if not set, the value is 75 seconds), which periodically reads the status of the device and triggers notify/filelog commands.
Example:
-
+
define avr ONKYO_AVR 192.168.0.10
# With explicit protocol version 2013 and later
@@ -1712,11 +1712,11 @@ sub ONKYO_AVR_RClayout() {
# With zone2 and custom interval of 60 seconds
define avr ONKYO_AVR 192.168.0.10 pre2013 zone2 60
-
+
+
Set
-
+
set <name> <command> [<parameter>]
Currently, the following commands are defined (may vary depending on zone).
@@ -1759,22 +1759,22 @@ sub ONKYO_AVR_RClayout() {
Note: If you would like to restrict access to admin set-commands (-> statusRequest, remoteControl) you may set your FHEMWEB instance's attribute allowedCommands like 'set,set-user'.
The string 'set-user' will ensure only non-admin set-commands can be executed when accessing FHEM using this FHEMWEB instance.
-
+
Get
-
+
get <name> <what>
Currently, the following commands are defined (may vary depending on zone):
-
+
power
input
volume
mute
sleep
-
+
+
Generated Readings/Events (may vary depending on zone):
@@ -1800,7 +1800,7 @@ sub ONKYO_AVR_RClayout() {
volume - Reports current volume level of the receiver in percentage values (between 0 and 100 %)
-
ONKYO_AVR
-
+
Eine deutsche Version der Dokumentation ist derzeit nicht vorhanden. Die englische Version ist hier zu finden:
-
-
+
Advanced Ambilight Control
-
+
If you would like to specificly control color for individual sides or even individual LEDs, you may use special addressing to be used with set command 'rgb':
LED addressing format:
<Layer><Side><LED number>
Examples:
-
+
# set LED 0 on left side within layer 1 to color RED
set PhilipsTV rgb L1L0:FF0000
@@ -3720,19 +3720,19 @@ sub PHTV_min {
# set complete layer 1 to color BLUE
set PhilipsTV rgb L1:0000FF
-
-
+
+
-
+
Advanced Ambilight+HUE Control
-
+
Linking to your HUE devices within attributes ambiHueLeft, ambiHueTop, ambiHueRight and ambiHueBottom uses some defaults to calculate the actual color.
More than one HUE device may be added using blank.
The following settings can be fine tuned for each HUE device:
@@ -3746,7 +3746,7 @@ sub PHTV_min {
devicename:<LEDs$gt;:<saturation$gt;:<brightness$gt;
Examples:
-
+
# to push color from top to 2 HUE devices
attr PhilipsTV ambiHueTop HUEDevice0 HUEDevice1
@@ -3767,9 +3767,9 @@ sub PHTV_min {
# to use default LED settings but only adjust their brightness to 50%
attr PhilipsTV ambiHueTop HUEDevice0:::50
-
-
+
+
diff --git a/fhem/FHEM/75_msgConfig.pm b/fhem/FHEM/75_msgConfig.pm
index fa576e274..1d054af0b 100755
--- a/fhem/FHEM/75_msgConfig.pm
+++ b/fhem/FHEM/75_msgConfig.pm
@@ -623,12 +623,12 @@ sub msgConfig_Get($@) {
The device name can be renamed and reconfigured afterwards if desired.
Define
-
+
define <name> msgConfig
-
+
Set
-
+
-
addLocation
@@ -650,7 +650,7 @@ This next step is basically to set attribute msgResidentsDevice to refer to this
-
Define
-
+
define <name> msgConfig
-
+
Set
-
+
-
addLocation
Erstellt auf einfache Weise ein Dummy Device basierend auf dem übergebenen Lokationsnamen. Es wird for die lokations-basierte Verwendung mit dem msg-Kommando vorkonfiguriert. Das Dummy Device wird automatisch zum Attribut msgLocationDevs hinzugefügt. Anschließend ist eine weitere Konfiguration über die Attribute msgContact* oder msgRecipient* notwendig, die auf entsprechende Gateway Devices verweisen, die an dieser Lokation stehen.
-
Note: GEOFANCY is an extension to FHEMWEB. You need to install FHEMWEB to use GEOFANCY.
Define
-
+
define <name> GEOFANCY <infix>
Defines the webhook server. <infix> is the portion behind the FHEMWEB base URL (usually http://hostname:8083/fhem)
Example:
-
+
define geofancy GEOFANCY geo
-
+
The webhook will be reachable at http://hostname:8083/fhem/geo in that case.
-
-
clear readings can be used to cleanup auto-created readings from deprecated devices.
@@ -651,7 +651,7 @@ sub GEOFANCY_ISO8601UTCtoLocal ($) {
Usage information / Hints on Security
-
+
Likely your FHEM installation is not reachable directly from the internet (good idea!).
It is recommended to have a reverse proxy like HAproxy, Pound or Varnish in front of FHEM where you can make sure access is only possible to a specific URI like /fhem/geo. Apache or Nginx might do as well. However, in case you have Apache or Nginx running already you should still consider one of the named reverse proxies in front of it for fine-grain security configuration.
@@ -662,13 +662,13 @@ sub GEOFANCY_ISO8601UTCtoLocal ($) {
To make that reverse proxy available from the internet, just forward the appropriate port via your internet router.
The actual solution on how you can securely make your GEOFANCY webhook available to the internet is not part of this documentation and depends on your own skills.
-
+
Integration with Home Automation
-
+
You might want to have a look to the module family of ROOMMATE, GUEST and RESIDENTS for an easy processing of GEOFANCY events.
-
GEOFANCY
-
+
Eine deutsche Version der Dokumentation ist derzeit nicht vorhanden. Die englische Version ist hier zu finden:
-