diff --git a/73_AutoShuttersControl.pm b/73_AutoShuttersControl.pm index 263ebd8..108393a 100644 --- a/73_AutoShuttersControl.pm +++ b/73_AutoShuttersControl.pm @@ -5179,29 +5179,35 @@ sub getblockAscDrivesAfterManual { Define
define <name> AutoShuttersControl
-
+ define <name> AutoShuttersControl
+
define myASControl AutoShuttersControl
set myASControl scanForShutters
+ +
define myASControl AutoShuttersControl
+ This creates an new AutoShuttersControl device, called myASControl.
+ Now was the new global attribute ASC added to the FHEM installation.
+ Each shutter that is to be controlled by AutoShuttersControl must now have the attribute ASC set to 1 or 2.
+ The value 1 is to be used with devices whose state is given as position (i.e. ROLLO or Siro, shutters
+ openend is 0, shutters closed is 100), 2 with devices whose state is given as percent closed (i.e. HomeMatic,
+ shutters opened is 100, closed is 0).
+
+ After setting the attributes to all devices who should be controlled, the automatic scan at the main device
+ can be started for example with
+ set myASControl scanForShutters
+
Within the ASC device:
Within the shutter devices:
At shutter devices, controlled by ASC:
50:20 ASC_Closed_Pos.
++ Shading +
++ Shading is only available if the following prerequests are met: +
+
+ +- + The ASC_autoShuttersControlShading attribute is set to on, and there is a device + of type Astro or Twilight configured to ASC_twilightDevice, and ASC_tempSensor + is set. +
+- + ASC_BrightnessSensor is configured to any shutter device. +
+- + All other attributes are optional and the default value for them is used, if they are not + otherwise configured. Please review the settings carefully, especially the values for + StateChange_Cloudy and StateChange_Sunny. +
++ The following attributes are available: +
++
+- ASC_Shading_Angle_Left - Minimal shading angle in relation to the window, + from when shade is applied. For example: Window is 180 ° (perpendicular) − 85 ° set + for ASC_Shading_Angle_Left → shading starts if sun position is 95 °. + Defaults to 75. +
+- ASC_Shading_Angle_Right - Complements ASC_Shading_Angle_Left and + sets the maximum shading angle in relation to the window. For example: Window is 180 ° + (perpendicular) + 85 ° set from ASC_Shading_Angle_Right → shading until + sun position of 265 ° is reached. Defaults to 75. +
+- ASC_Shading_Direction - Compass point degrees for which the window resp. shutter + points. East is 90 °, South 180 °, West is 270 ° and North is 0 °. + Defaults to South (180). +
+- ASC_Shading_Min_Elevation - Shading starts as this point of sun elevation is + reached, depending also on other sensor values. Defaults to 25.0. +
+- ASC_Shading_Min_OutsideTemperature - Shading starts at this outdoor temperature, + depending also on other sensor values. Defaults to 18.0. +
+- ASC_Shading_Mode absent|always|off|home - see ASC_Mode_Down above, + but for shading. Defaults to off. +
+- ASC_Shading_Pos - Shading position in percent.
+- ASC_Shading_StateChange_Cloudy - Shading ends at this + outdoor brightness, depending also on other sensor values. Defaults to 20000. +
+- ASC_Shading_StateChange_Sunny - Shading starts at this + outdoor brightness, depending also on other sensor values. Defaults to 35000. +
+- ASC_Shading_WaitingPeriod - Waiting time in seconds before additional sensor values + to ASC_Shading_StateChange_Sunny or ASC_Shading_StateChange_Cloudy + are used for shading. Defaults to 120. +
+
AutoShuttersControl API description
- It's possible to access internal data of the ASC module by calling the API function. + It's possible to access internal data of the ASC module by calling the API function.
Data points of a shutter device, controlled by ASC@@ -5723,11 +5767,7 @@ sub getblockAscDrivesAfterManual {
@@ -5762,7 +5802,7 @@ sub getblockAscDrivesAfterManual {