Mischersteuerung

---- noch nicht Teil von FHEM ----
Zweck / Funktion
Dieses Modul ist noch Entwicklung
Allgemein
Typ	undefiniert
Details
Dokumentation	ModUndef
Modulname	98_STELLMOTOR.pm
Ersteller	epsrw1
Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref!

Das Fhem-Hilfsmodul STELLMOTOR bietet eine einfache Möglichkeit, mit zwei Relais den Rechts-/Linkslauf eines (Mischer)motors zu steuern.

Features

Modul und diese Bearbeitung sind noch in Entwicklung

---

• Wiedereintrittsfähig nach einem Neustart
• Wiederholungsgenauigkeit durch Ausgleich von Rundungs- und Laufzeitabweichungen
• Vermeiden von Blockade des FHEM während der Laufzeit des Motors

Thread im Forum:[1]

Beschreibung

Vorrangig ist dieses Modul für zwei Relais an eine GPIO oder an PIFace Pins eines Rasberrys gedacht; es bietet aber auch die Option, zwei Schaltaktoren per Funk (aus Timinggründen nicht empfohlen) oder 1-Wire anzusteuern.

Die Set-Befehle für die Mischerstellung kommen idealerweise aus der Bewertung der Vorlauftemperatur durch ein Modul wie PID20 [2]. Dieser berücksichtigt auch den zeitlichen Verlauf der Temperaturänderungen im Vorlauf und ist vielfältig anpassbar.

Aus den Werten MaxTics (Default=100, für Prozentanzeige) und MaxDriveSeconds (Laufzeit des Motors von 0 bis 100%) wird die Zeit berechnet, die der Motor nach rechts oder links laufen muss, um die mit set gewünschte Ventilstellung zu erreichen.

FHEM läuft dann weiter ohne einzufrieren, und prüft im Loop nur noch ob, die Stoppzeit im Cache erreicht ist. Da der Stopp nie exakt zur geplanten Zeit ausgeführt wird, liegt im Cache ein weiterer Wert der die Differenz zwischen geplanter und tatsächlicher Stoppzeit dem nächsten Kommando hinzurechnet. So werden sich addierende kleine Zeitdifferenzen vermieden.

Zum Kalibrieren (set calibrate) fährt der Motor einfach volle Zeit nach links/null. Hier wird der in Mischermotoren wie dem Honeywell Centra VMK eingebauten Entschaltetr genutzt, um den "Null-Punkt" sicher zu finden. Falls ein angeschlossener Motor solche Endschalter nicht hat, müssen die für diese Schaltungsweise unbedingt vorgesehen werden.

Define

 define <name> STELLMOTOR <PiFace|Gpio|FhemDev>  

• attrRLPORT und attrSTARTPORT sind workarounds um fhemDev mit leerzeichen definieren zu können (z: keller port2 ...0|1). der eigentliche port wird dann aus dem attr wert (attrRLPORT attrSTARTPORT) gelesen

Für den Schaltvorgang "baut" STELLMOTOR einen set-Befehl zusammen. Beispielsweise bei FhemDev

 set <RL-OUT-Port> 0     sowie      set <RL-OUT-Port> 1      zum Einschalten links  
 set <RL-OUT-Port> 0     sowie      set <RL-OUT-Port> 0      zum Ausschalten links  

Um die Wirkung auszuprobieren, ohne jedes Mal zum Mischer rennen zu müssen, bietet sich an zwei Dummys zu verwenden:

define Stellmotor2rl dummy

define Stellmotor2start dummy

set <name> 45

stellt den Mischer nun auf 45%. Angenommen, stand er bei 10%, wird er nun (45-10)*MaxDriveSeconds/MaxTics Sekunden lang nach rechts laufen und dann von STELLMOTOR gestoppt.

Attribute

ACHTUNG: falsche Einstellung kann zu Kurzschluß am Motor führen, bitte Einstellung genau überdenken oder mit dummy testen bei einzel: Rechtslauf: start=0 rl=1 Linkslauf: start=1 rl=0 Ruhe: start=0 rl=0 bei wechsel: Rechtslauf start=0 rl=1 Linkslauf: L start=1 rl=0 Ruhe: start=0 rl=0

Parameter	Wertebereich	Default	Beschreibung
MaxDriveSeconds	[0...n]	muss angepasst werden	gestoppte Zeit in Sekunden, die der Motor für die Fahrt von 0 bis 100 Prozent braucht
MaxTics	[0...100]	100	Mischerstellung - bei Prozentangaben (PID20) 100, bei Winkelangaben anzupassen
pollInterval		0.1	Zeitintervall nach dem FHEM prüft, ob die interne Stoppzeit erreicht wurde. Hier sollte mit einem möglichst kleinen Wert gestartet werden, der vorsichtig erhöht werden kann, falls FHEM zu langsam läuft wegen des Mischermotors.
resetOtherDeviceAtCalibrate	string		Fhem Device das am Ende des Kalibriervorganges zusätzlich resettet wird. (command: set <resetOtherDeviceAtCalibrate> reset" wird abgesetzt)
attrRLPORT			wert ersetzt "RL-Out-Port" aus define. wird benötigt für schaltaktoren befehle mit blankspace bie zb "set keller portB 1"
attrSTARTPORT			wert ersetzt "start-Out-Port" aus define. wird benötigt für schaltaktoren befehle mit blankspace bie zb "set keller portC 1"
resetOtherDeviceAtCalibrate	string		Fhem Device das am Ende des Kalibriervorganges zusätzlich resettet wird. (command: set <resetOtherDeviceAtCalibrate> reset" wird abgesetzt)
readingFnAttributes			readingFnAttributes

AttributesN

Alle Attributes sind auch in fhem durch das kommando get attrHelp <varname> erkl�rt, f�r's "schnelle nachschauen zwischendurch".

Attribute	(Typ) Default	Beschreibung
STMgpioPortRL	(int) 5	piface port oder gpio port f�r RL oder R relais (bei RL ist 1=R)
STMrlType	(string) einzel	je nach schaltplan, wechsel=start+RL-relais, einzel=R-relais+L-relais
STMresetOtherDeviceAtCalibrate	(string) 0	zus�tzliches fhem device das am ende der kalibrierung 'set ** reset' gesendet bekommt
STMmapOffCmd	(string) 0	string der im device-command anstatt '0' verwendet wird f�r stop
STMmapOnCmd	(string) 0	string der im device-command anstatt '1' verwendet wird f�r start
STMcalibrateDirection	(string) L	auf R wird die kalibrierung nach rechts gefahren, default=links
STMinvertOut	(int) 0	setzen f�r devices die 0 f�r start und 1 f�r stop erwarten
STMmaxTics	(int) 100	Mischerstellung - bei Prozentangaben (PID20) 100, bei Winkelangaben anzupassen
STMsysCmdSTART	(string) 0	freies command das f�r START an die shell �bergeben wird
STMsysCmdRL	(string) 0	freies command das f�r RL an die shell �bergeben wird
STMmaxDriveSeconds	(int) 107	gestoppte Zeit in Sekunden, die der Motor f�r die Fahrt von 0 bis 100 Prozent braucht
STMpollInterval	(float) 0.1	Zeitintervall nach dem FHEM pr�ft, ob die interne Stoppzeit erreicht wurde. Hier sollte m�glichst kleiner Wert aein, nur erh�hen falls FHEM zu langsam l�uft
STMgpioPortSTART	(int) 4	piface port oder gpio port f�r START (oder L relais bei 'einzel')
STMtimeTolerance	(float) 0.01	stop-time differenzen kleiner als dieser wert werden ignoriert
STMfhemDevSTART	(string) RelaisSTART	fhem device name f�r START (oder L) aktor
STMfhemDevRL	(string) RelaisRL	fhem device name f�r RL (oder R) aktor

Settings

SET	Wertebereich	Beschreibung
set <name> N	[1...100]	stellt den Mischer auf N % Öffnung
set <name> calibrate		stellt den Mischer auf 0 %; maximaler Linkslauf bis zur Endschalterpostion links
set <name> reset		Setzt die Position und die Werte im Cache auf Null. Verwendung ist intern (am Ende von calibrate) oder nach mechanischem Neueinbau des Motors (da reicht aber auch ein Calibrate)

Readings

readings	Wertebereich	Beschreibung
position	[1..100%]	der Wert wird gesetzt am Beginn einer Mischerbewegung (anderer Wertebereich, wenn MaxTics nicht 100)
state	active,error,position	Position wird beim Stopp der Motorbewegung gesetzt
lastStart		Zeitstempel der letzten Motorbewegung
locked	[0 1]	Steht auf 1 während der Motor gerade läuft (Calibrate oder gewünsche Position per set). Neue Kommandos werden während lock nur in eine Warteschleife genommen. Zeigt im im Frontend, dass der Motor gerade läuft.
queue_lastdiff		abhängig von der FHEM-Last oder anderen blockierenden Kommandos wird das Stopp-Kommando mir nahe an der kalkulierten Stoppzeit ausgeführt, vermutlich nie exakt. STELLMOTOR merkt sich die Zeitdifferenz, zu der der Motor wirklich gestoppt weurde und addiert bei der nächsten Bewergung des motors die Differenz, um möglichst präzise die wirkliche Motorstellung zu erreichen.
rlport		Pin-Nr, gpio/piface oder fhem device name bei typ FhemDev
startport		Pin-Nr. gpio/piface oder fhem device name bei typ FhemDev
stopTime		Null oder die errechnete Zeit zum Stopp der Motorbewegung
command_queue		Position einer anstehenden neuen Motorposition, die angefordert wurde als die letzte Motorbewegung noch ausgeführt oder das Modul disabled war
OutType		Bei der Defintion gewählte Arbeitsart: PiFace,Gpio,FhemDev
DoResetAtStop		Zeitstempel des Ende der letzten Kalibrierfahrt

ReadingsN

Alle Readings sind auch in fhem durch das kommando get readingsHelp <varname> erkl�rt, f�r's "schnelle nachschauen zwischendurch".

Reading	(Typ) Default	Beschreibung
queue_lastdiff	(float) 0	letzte zeitdifferenz
locked	(int) 0	1 w�hrend motor gerade l�uft
position	(int) 1	aktuelle desired position
DoResetAtStop	(string) afterCalibrate	tempor�rwert nur w�hrend kalibrierungsphase
state	(string) active	aktuelle position oder fehlermeldung
lastStart	(float) 0	zeitstempel letzter start des motors
command_queue	(int) 0	befehl in der warteschleife
stopTime	(float) 0	zeitstempel n�chster stop des motors
OutType	(string) PiFace	in der device definition festgelegter OutType

Weblinks

• Thread im Forum, in dem dieses Modul vorgestellt wurde
• to be continued