AutoShuttersControl

An dieser Seite wird momentan noch gearbeitet.

AutoShuttersControl
Zweck / Funktion
Steuerung von Rollläden
Allgemein
Typ	Inoffiziell
Details
Dokumentation	siehe Forum
Support (Forum)	Automatisierung
Modulname	73_AutoShuttersControl.pm
Ersteller	CoolTux
Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref!

Mit AutoShuttersControl oder kurz ASC können typische Aufgabenstellungen im Zusammenhang mit Rollläden u.ä. automatisiert werden, wie zum Beispiel das Öffnen bei Sonnenaufgang, Schließen bei Sonnenuntergang oder das Anfahren von Lüftungspositionen beim Öffnen des zugehörigen Fensters.

Das Modul befindet sich derzeit noch in der Entwicklung; der jeweils aktuelle Stand ist diesem "Thread im Forum" zu entnehmen.

Basics

Zur Nutzung des Moduls sollten folgende andere FHEM-Devices vorhanden sein:

• Rollläden
• Fensterkontakte und
• Bewohnerstatus auf Basis von Residents/Roomates in englisch. Ersatzweise andere Devices, z.B. Dummys, welche als state home, asleep, gotosleep und awoken setzen sowie ein Reading lastState.

Die Einrichtung des Moduls bzw. dessen Funktionalität erfolgt in mehreren Schritten:

• Definition des ASC-Devices
• Einstellung zentraler Vorgaben am ASC-Device
• Markieren der zukünftig zu steuernden Rollladen-Devices
• Einbinden der Rollladen-Devices in das ASC-Device
• Einstellen der individuellen Vorgaben je Rollladen (am Rollladen-Device)

Einrichtung

Vorbereitung

Ihr benötigt ein aktuelles FHEM. Update ab dem 04.09.2018 Voraussetzung!

Zunächst muß das Modul aus dem Link im Forum entpackt werden und die Datei 73_AutoShuttersControl.pm in das Unterverzeichnis für die Module kopiert werden und die Rechte angepaßt.

Speicherort für Linux-Standardinstallationen: /opt/fhem/FHEM Rechte: sudo chown 73_AutoShuttersControl.pm und sudo chmod 644 73_AutoShuttersControl.pm

Danach sollte ein reload AutoShuttersControl in FHEM-Eingabefeld ausreichen, um das Modul verfügbar zu machen.

Eventuell muß FHEM auch einmalig neu gestartet werden, um das Modul nutzen zu können.

Define des ASC-Devices

Es genügt ein einfaches define ohne weitere Parameter. define <name> AutoShuttersControl Dies bewirkt neben der Anlage des Devices selbst auch, dass als weiteres globales Attribut AutoShuttersControl verfügbar wird.

Einstellung zentraler Vorgaben

Es stehen am ASC-Device einige Attribute zur Verfügung, über die sich das Verhalten des ASC-Devices insgesamt steuern läßt, z.B. zur Vermeidung von morgendlichen oder abendlichen Fahrten sowie bei Gefahr von Schäden an den Rollläden durch Frost oder zur Reaktion auf Fensterkontakte. Details sind der Commandref zu entnehmen. Diese können auch nachträglich noch geändert werden.

Markieren zu steuernder Rollladen-Devices

Um einen oder mehrere Rollläden durch das ASC-Device zu steuern, wird für jeden Rollladen jeweils das neue globale Attribut AutoShuttersControl gesetzt. Der Wert ist mit 1 oder 2 festzulegen, wobei 1 bedeutet, dass

• die Offen-Position kleiner ist als die Geschlossen-Position, also typischerweise 0 offen bedeutet und 100 für geschlossen steht
• eine bestimmte Position mit position angefahren wird, also z.B. set <name> position 70.

Dies ist z.B. die passende Wahl für ROLLO-Devices

Die 2 steht für ein umgekehrtes Verhalten und den Befehlsteil pct, also offen für set <name> pct 100. Typischer Vertreter dieses Typs sind HomeMatic (CUL_HM-) Geräte.

Einbinden in das ASC-Device

Nachdem man das obige Attribut bei einem oder mehreren Rollladen-Devices gesetzt hat, kann mit set <name> scanForShutters ein Suchlauf gestartet werden, mit dem dann diese Rollläden durch das Modul gefunden und in die Steuerungslogik eingebunden werden.

Einstellen der individuellen Vorgaben

Danach sind jeweils an den Rollladen-Devices weitere Attribute verfügbar, mit denen die für den jeweiligen Rollladen geltenden Einstellungen vorgenommen werden können. Die Beschreibung der Attribute ist in der commandref enthalten.

Readings

Readings im AutoShuttersControl Device selbst.

Name	Datentyp/ Wertebereich	Bedeutung
..._nextAstroTimeEvent		Uhrzeit des nächsten Astro Events, Sonnenauf, Sonnenuntergang oder feste Zeit pro Rollonamen
..._lastPosValue		letzter abgesetzter Fahrbefehl pro Rollonamen
..._lastDelayPosValue		letzter abgesetzter Fahrbefehl welcher beim nächsten zulässigen Event ausgeführt wird.
partyMode	on, off	aktiviert den globalen Partymodus, alle Rollläden welche das Attribut AutoShuttersControl_Partymode bei sich auf on gestellt haben werden nicht mehr gesteuert. Der letzte Schaltbefehle welcher durch ein Fensterevent oder Bewohnerstatus an die Rollläden gesendet wurde, wird beim off setzen durch set ASC-Device partyMode off ausgeführt
lockOut	on, off	für das aktivieren des Aussperrschutzes gemäß dem entsprechenden Attribut AutoShuttersControl_lock-out im jeweiligen Rolladen. (siehe Beschreibung bei den Attributen für die Rolladendevices)
room_...		Auflistung aller Rollläden welche in den jeweiligen Rämen gefunden wurde, Bsp.: room_Schlafzimmer,Terrasse
state		Status des Devices active, enabled, disabled
sunriseTimeWeHoliday	on,off	wird das Rolladen Device Attribut Attributes AutoShuttersControl_Time_Up_WE_Holiday Beachtet oder nicht
userAttrList	rolled out	Status der UserAttribute welche an die Rollläden gesendet werden

Readings in den Rolllädendevices

Name	Bedeutung
AutoShuttersControl_Time_Sunrise	Sonnenaufgangszei für das Rollo
AutoShuttersControl_Time_Sunset	Sonnenuntergangszeit für das Rollo

Settings

Set Befehle für AutoShuttersControl Device

Name	Datentyp/ Wertebereich	Beschreibung
partyMode	on, off	aktiviert den globalen Partymodus. Siehe Reading partyMode
lockOut	on, off	aktiviert den globalen Aussperrschutz. Siehe Reading partyMode
renewSetSunriseSunsetTimer		erneuert bei allen Rollläden die Zeiten für Sunset und Sunrise und setzt die internen Timer neu.
scanForShutters		sucht alle FHEM Devices mit dem Attribut "AutoShuttersControl" 1/2
sunriseTimeWeHoliday	on,off	aktiviert/deaktiviert die Beachtung des Rolladen Device Attributes AutoShuttersControl_Time_Up_WE_Holiday

Attribute

Attribute im AutoShuttersControl Device selbst.

Name	Datentyp/ Wertebereich	Default-Wert	Beschreibung
AutoShuttersControl_antifreezeTemp			Temperatur ab welcher der Frostschutz greifen soll und das Rollo nicht mehr fährt. Der letzte Fahrbefehl wird gespeichert.
AutoShuttersControl_autoAstroModeEvening	aktuell REAL, CIVIL, NAUTIC, ASTRONOMIC		(in genau dieser Schreibweise)
AutoShuttersControl_autoAstroModeEveningHorizon			Höhe über Horizont wenn beim Attribut AutoShuttersControl_autoAstroModeEvening HORIZON ausgewählt
AutoShuttersControl_autoAstroModeMorning	aktuell REAL, CIVIL, NAUTIC, ASTRONOMIC		(in genau dieser Schreibweise)
AutoShuttersControl_autoAstroModeMorningHorizon			Höhe über Horizont wenn beim Attribut AutoShuttersControl_autoAstroModeMorning HORIZON ausgewählt
AutoShuttersControl_autoShuttersControlComfort	on, off		schaltet die Komfortfunktion an. Bedeutet das ein Rollladen mit einem threestate Sensor am Fenster beim öffnen in eine weit offen Position fährt. Die Offenposition wird beim Rollladen über das Attribut AutoShuttersControl_Pos_after_ComfortOpen eingestellt.
AutoShuttersControl_autoShuttersControlEvening	on, off		ob Abends die Rollläden automatisch nach Zeit gesteuert werden sollen
AutoShuttersControl_autoShuttersControlMorning	on, off		ob Morgens die Rollläden automatisch nach Zeit gesteuert werden sollen
AutoShuttersControl_temperatureReading			Reading für die Aussentemperatur
AutoShuttersControl_temperatureSensor			Device für die Aussentemperatur
AutoShuttersControl_timeUpHolidayDevice			Device zur Urlaubserkennung oder Sonstiges / muss 0 oder 1 im Reading state beinhalten.

Attribute in den Rolllädendevices

Name	Datentyp/ Wertebereich	Default-Wert	Beschreibung
AutoShuttersControl	0, 1, 2		1 = "Inverse oder Rollo Bsp.: Rollo Oben 0, Rollo Unten 100 und der Befehl zum Prozentualen fahren ist position", 2 = "Homematic Style Bsp.: Rollo Oben 100, Rollo Unten 0 und der Befehl zum Prozentualen fahren ist pct
AutoShuttersControl_Antifreeze	on, off		Frostschutz an oder aus
AutoShuttersControl_AutoAstroModeEvening	aktuell REAL, CIVIL, NAUTIC, ASTRONOMIC
AutoShuttersControl_AutoAstroModeEveningHorizon			Höhe über Horizont wenn beim Attribut AutoShuttersControl_autoAstroModeEvening HORIZON ausgewählt
AutoShuttersControl_AutoAstroModeMorning	aktuell REAL, CIVIL, NAUTIC, ASTRONOMIC
AutoShuttersControl_AutoAstroModeMorningHorizon			Höhe über Horizont wenn beim Attribut AutoShuttersControl_autoAstroModeMorning HORIZON ausgewählt
AutoShuttersControl_Closed_Pos			in 10 Schritten von 0 bis 100, default Vorgabe ist abhängig vom Attribut AutoShuttersControl
AutoShuttersControl_Down	astro, time		bei Astro wird Sonnenuntergang berechnet, bei time wird der Wert aus AutoShuttersControl_Time_Down_Early als Fahrzeit verwendet
AutoShuttersControl_Mode_Down	always, absent, off		wann darf die Automatik steuern. immer, niemals, bei abwesenheit des Roomate (ist kein Roommate und absent eingestellt wird gar nicht gesteuert)
AutoShuttersControl_Mode_Up	always, absent, off		wann darf die Automatik steuern. immer, niemals, bei abwesenheit des Roomate (ist kein Roommate und absent eingestellt wird gar nicht gesteuert)
AutoShuttersControl_Offset_Minutes_Evening			maximale zufällige Verzögerung in Minuten (minimal 1) bei der Berechnung der Fahrzeiten für Abends
AutoShuttersControl_Offset_Minutes_Morning			maximale zufällige Verzögerung in Minuten (minimal 1) bei der Berechnung der Fahrzeiten für Morgens
AutoShuttersControl_Open_Pos			in 10 Schritten von 0 bis 100, default Vorgabe ist abhängig vom Attribut AutoShuttersControl
AutoShuttersControl_Partymode	on, off		schaltet den Partymodus an oder aus, Wird dann am ASC Device set ASC-DEVICE partyMode on geschalten, werden alle Fahrbefehle an den Rollläden welche das Attribut auf on haben zwischen gespeichert und später erst ausgeführt
AutoShuttersControl_Pos_Cmd			der set Befehl um den Rollladen in Prozent Angaben zu fahren, muss der selbe sein wie das Reading welches die Position des Rollladen in Prozent an gibt
AutoShuttersControl_Pos_after_ComfortOpen			in 10 Schritten von 0 bis 100, default Vorgabe ist abhängig vom Attribut AutoShuttersControl
AutoShuttersControl_Roommate_Reading			das Reading zum Roommate Device welches den Status wieder gibt
AutoShuttersControl_Roommate_Device			Name des Roommate Devices welcher den Bewohner des Raumes vom Rollladen wieder gibt
AutoShuttersControl_Time_Down_Early			Sunset frühste Zeit zum runter fahren
AutoShuttersControl_Time_Down_Late			Sunset späteste Zeit zum runter fahren
AutoShuttersControl_Time_Up_Early			Sunrise frühste Zeit zum hoch fahren
AutoShuttersControl_Time_Up_Late			Sunrise späteste Zeit zum hoch fahren
AutoShuttersControl_Time_Up_WE_Holiday			Sunrise frühste Zeit zum hochfahren am Wochenende und/oder Urlaub (we2holiday wird beachtet), Achtung sollte nicht größer sein wie AutoShuttersControl_Time_Up_Late sonst wird AutoShuttersControl_Time_Up_Late verwendet
AutoShuttersControl_Up	astro, time		bei Astro wird Sonnenaufgang berechnet, bei time wird der Wert aus AutoShuttersControl_Time_Up_Early als Fahrzeit verwendet
AutoShuttersControl_Ventilate_Pos			in 10 Schritten von 0 bis 100, default Vorgabe ist abhängig vom Attribut AutoShuttersControl
AutoShuttersControl_Ventilate_Window_Open			auf lüften, wenn das Fenster gekippt/geöffnet wird und aktuelle Position unterhalb der Lüften-Position ist
AutoShuttersControl_WindowRec			Name des Fensterkontaktes an welchen Fenster der Rolladen angebracht ist
AutoShuttersControl_WindowRec_subType			Typ des verwendeten Fensterkontakts: twostate (optisch oder magnetisch) oder threestate (Drehgriffkontakt)
AutoShuttersControl_lock-out	soft, hard		stellt entsprechend den Aussperrschutz ein. Bei global aktiven Aussperrschutz (set ASC-Device lockOut soft) und einem Fensterkontakt open bleibt dann der Rolladen oben. Dies gilt nur bei Steuerbefehle über das ASC Modul. Stellt man global auf hard, wird bei entsprechender Möglichkeit versucht den Rolladen Hardwareseitig zu blockieren. Dann ist auch ein fahren über die Taster nicht mehr möglich.
AutoShuttersControl_lock-outCmd	inhibit, blocked		set Befehl für das Rolladen-Device zum Hardware sperren. Zum gesetzt werden wenn man "AutoShuttersControl_lock-out" auf hard setzt

Hilfsmittel

tbd

readingsGroup, um die diversen Level einzustellen:

define rg_ASC_Rollaeden_Level readingsGroup <Gerät>,<Closed_Pos>,<Open_Pos>,<Shading_Pos>,<Ventilate_Pos> (Rolladen_.*|Jalousie_.*)..:?AutoShuttersControl_Closed_Pos,?AutoShuttersControl_Open_Pos,?AutoShuttersControl_Shading_Pos,?AutoShuttesControl_Ventilate_Pos
attr rg_ASC_Rollaeden_Level commands { AutoShuttersControl_Closed_Pos => 'AutoShuttersControl_Closed_Pos:0,10,20,30,35,40,45,50,55,60,65,70,75,80,85,90,95,100',\
AutoShuttersControl_Open_Pos => 'AutoShuttersControl_Open_Pos:0,10,20,30,35,40,45,50,55,60,65,70,75,80,85,90,95,100',\
AutoShuttersControl_Shading_Pos => 'AutoShuttersControl_Shading_Pos:0,10,20,30,35,40,45,50,55,60,65,70,75,80,85,90,95,100',\
AutoShuttersControl_Ventilate_Pos => 'AutoShuttersControl_Ventilate_Pos:0,10,20,30,35,40,45,50,55,60,65,70,75,80,85,90,95,100'}

readingsGroup, um die diversen Zeiten einzustellen:

define rg_ASC_Rollaeden_Times readingsGroup <Gerät>,<Stand>,<Time_Up_Early>,<Time_Up_WE>,<Time_Up_Late>,<Time_Down_Early>,Time_Down_Late>,<Mode_Down>,<Mode_Up> (Rolladen_.*|Jalousie_.*)..:level,?AutoShuttersControl_Time_Up_Early,?AutoShuttersControl_Time_Up_WE_Holiday,?AutoShuttersControl_Time_Up_Late,?AutoShuttersControl_Time_Down_Early,?AutoShuttersControl_Time_Down_Late,?AutoShuttersControl_Mode_Down,?AutoShuttersControl_Mode_Up
attr rg_ASC_Rollaeden_Times commands {level => 'pct:0,10,20,30,35,40,45,50,55,60,65,70,75,80,85,90,95,100', \
AutoShuttersControl_Mode_Down => 'AutoShuttersControl_Mode_Down:always,absent,off',\
AutoShuttersControl_Mode_Up => 'AutoShuttersControl_Mode_Up:always,absent,off',\
AutoShuttersControl_Time_Down_Early => 'AutoShuttersControl_Time_Down_Early:15:00,15:15,15:30,15:45,16:00,16:15,16:30,16:45,17:00,17:15,17:30,17:45,18:00,18:15,18:30,18:45,19:00,19:15,19:30,19:45,20:00,20:15,20:30,20:45,21:00,21:15,21:30,21:45,22:00', \
AutoShuttersControl_Time_Down_Late  => 'AutoShuttersControl_Time_Down_Late:20:15,20:30,20:45,21:00,21:15,21:30,21:45,22:00,22:15,22:30,22:45,23:00,23:15,23:30',\
AutoShuttersControl_Time_Up_Early => 'AutoShuttersControl_Time_Up_Early:05:00,05:05,05:30,05:45,06:00,06:15,06:30,06:45,07:00,07:15,07:30,07:45,08:00,08:15,08:30,08:45,09:00,09:15,09:30,09:45,10:00', \
AutoShuttersControl_Time_Up_Late =>'AutoShuttersControl_Time_Up_Late:06:00,06:15,06:30,06:45,07:00,07:15,07:30,07:45,08:00,08:15,08:30,08:45,09:00,09:15,09:30,09:45,10:00',AutoShuttersControl_Time_Up_WE_Holiday => 'AutoShuttersControl_Time_Up_WE_Holiday:06:00,06:15,06:30,06:45,07:00,07:15,07:30,07:45,08:00,08:15,08:30,08:45,09:00,09:15,09:30,09:45,10:00'}

Weblinks

• "Thread zur Entwicklung im Forum"
• "Thread zu den Scripten von user cluni", die der Entwicklung des Moduls zugrunde liegen