Merge pull request 'patch-documentation' (#145) from patch-documentation into dev

Reviewed-on: #145

CHANGELOG.md

@@ -1,10 +1,93 @@
-### fix: commandref tag (HEAD -> patch-commandref)
+### ``` Add important usage information for roller shutter control (HEAD -> patch-documentation)
->Tue, 21 Jan 2025 17:53:05 +0100
+>Wed, 5 Feb 2025 07:57:46 +0100
 
 >Author: Marko Oldenburg (fhemdevelopment@cooltux.net)
 
 >Commiter: Marko Oldenburg (fhemdevelopment@cooltux.net)
 
+This update includes new sections in both English and German
+explaining the conditions necessary to prevent delayed operation
+of roller shutters when a window contact is opened. The changes
+clarify that for this functionality to work, the roller shutter
+must be open, the sensor should be set to open, and specific
+attributes (ASC_ShuttersPlace and ASC_Self_Defense_Mode) must
+be appropriately configured.
+
+These additions help users understand proper settings required
+for optimal functionality, improving the overall usability
+and effectiveness of the AutoShuttersControl module. The version
+has been updated to v1.0.1 to reflect these enhancements.
+```
+
+
+
+### docs: changelog
+>Sat, 25 Jan 2025 11:14:17 +0100
+
+>Author: Marko Oldenburg (fhemdevelopment@cooltux.net)
+
+>Commiter: Marko Oldenburg (fhemdevelopment@cooltux.net)
+
+
+
+
+### docs: new version
+>Sat, 25 Jan 2025 11:14:01 +0100
+
+>Author: Marko Oldenburg (fhemdevelopment@cooltux.net)
+
+>Commiter: Marko Oldenburg (fhemdevelopment@cooltux.net)
+
+
+
+
+### docs: Changelog
+>Tue, 21 Jan 2025 18:19:54 +0100
+
+>Author: Marko Oldenburg (fhemdevelopment@cooltux.net)
+
+>Commiter: Marko Oldenburg (fhemdevelopment@cooltux.net)
+
+
+
+
+### fix: commandref
+>Tue, 21 Jan 2025 18:19:42 +0100
+
+>Author: Marko Oldenburg (fhemdevelopment@cooltux.net)
+
+>Commiter: Marko Oldenburg (fhemdevelopment@cooltux.net)
+
+
+
+
+### docs: new changelog
+>Tue, 21 Jan 2025 17:19:04 +0100
+
+>Author: Marko Oldenburg (fhemdevelopment@cooltux.net)
+
+>Commiter: Marko Oldenburg (fhemdevelopment@cooltux.net)
+
+
+
+
+### feat: change version
+>Tue, 21 Jan 2025 17:18:12 +0100
+
+>Author: Marko Oldenburg (fhemdevelopment@cooltux.net)
+
+>Commiter: Marko Oldenburg (fhemdevelopment@cooltux.net)
+
+
+
+
+### feat: https://forum.fhem.de/index.php?topic=136510.0
+>Sun, 12 Jan 2025 12:56:08 +0100
+
+>Author: Marko Oldenburg (oldenburg@b1-systems.de)
+
+>Commiter: Marko Oldenburg (oldenburg@b1-systems.de)
+
 
 
 

FHEM/73_AutoShuttersControl.pm

@@ -870,6 +870,19 @@ __END__
                 <td>Is <abbr>ASC</abbr> globally activated?</td>
             </tr>
         </table>
+        <p></p>
+        <u>Important Information for General Use</u>
+        <p>
+            A possibility has been created to prevent the delayed movement of a roller shutter by opening a window contact.  
+            The handle position is determined before the movement, not before the wait time!  
+            The following settings are required for this function:
+            <ul>
+                <li>the roller shutter must be in the open position</i>
+                <li>the sensor must be set to open</i>
+                <li>the attribute ASC_ShuttersPlace must be set to terrace</i>
+                <li>the attribute ASC_Self_Defense_Mode must be set to off</i>
+            </ul> 
+        </p>
 </ul>
 
 =end html
@@ -1439,6 +1452,19 @@ __END__
         <tr><td>RainWaitingTime</td><td>   </td></tr>
         <tr><td>BlockAscDrivesAfterManual</td><td>   </td></tr>
     </table>
+    <p></p>
+    <u>Wichtige Informationen zur allgemeinen Verwendung</u>
+    <p>
+        Es wurde eine M&ouml;glichkeit geschaffen um das verz&ouml;gerte fahren eines Rolles durch &ouml;ffnen eines Fensterkontaktes zu unterbinden.
+        Feststellung der Griffstellung vor Fahrt, nicht vor Wartezeit!
+        Voraussetzung f&uuml;r diese Funktion ist folgende Einstellung:
+        <ul>
+            <li>das Rollo muss in der Position Open stehen</i>
+            <li>der Sensor muss auf open stehen / gestellt werden</i>
+            <li>Attribut ASC_ShuttersPlace muss auf terrace gesetzt sein</i>
+            <li>Attribut ASC_Self_Defense_Mode muss auf off gesetzt sein</i>
+        </ul> 
+    </p>
 </ul>
 
 =end html_DE
@@ -1462,7 +1488,7 @@ __END__
   ],
   "release_status": "stable",
   "license": "GPL_2",
-  "version": "v0.99.10",
+  "version": "v1.0.1",
   "author": [
     "Marko Oldenburg <fhemdevelopment@cooltux.net>"
   ],

controls_AutoShuttersControl.txt

@@ -1,5 +1,5 @@
-UPD 2025-01-21_17:52:14 116536 FHEM/73_AutoShuttersControl.pm
+UPD 2025-02-05_07:57:04 117935 FHEM/73_AutoShuttersControl.pm
-UPD 2025-01-21_17:38:51 76335 lib/FHEM/Automation/ShuttersControl.pm
+UPD 2025-01-25_11:47:02 76570 lib/FHEM/Automation/ShuttersControl.pm
 UPD 2024-10-12_09:12:30 2691 lib/FHEM/Automation/ShuttersControl/Dev.pm
 UPD 2024-10-12_09:12:30 2675 lib/FHEM/Automation/ShuttersControl/Roommate.pm
 UPD 2024-10-12_09:12:30 31828 lib/FHEM/Automation/ShuttersControl/Shutters.pm

lib/FHEM/Automation/ShuttersControl.pm

@@ -1769,7 +1769,11 @@ sub SetCmdFn {
         || $FHEM::Automation::ShuttersControl::shutters
         ->getWindProtectionStatus eq 'protected'
         || $FHEM::Automation::ShuttersControl::shutters
-        ->getRainProtectionStatus eq 'protected' );
+        ->getRainProtectionStatus eq 'protected'
+        || (   CheckIfShuttersWindowRecOpen($shuttersDev) == 2
+            && $shutters->getStatus == $shutters->getOpenPos
+            && $shutters->getShuttersPlace eq 'terrace'
+            && $shutters->getSelfDefenseMode eq 'off') );
 
     if ( $shutters->getStatus != $posValue ) {
         $shutters->setLastPos( $shutters->getStatus );