Add settings for count up or down to the ETS app. Firmware not finished.

Author: mgeramb

doc/Applikationsbeschreibung-FunctionBlocks.md

@@ -351,43 +351,52 @@ In der Standardeinstellung **Identisch mit Eingängen** wird der DPT der Eingän
   Ein zu kleiner Wert wird durch den Minimalwert des DPT ersetzt, ein zu großer Wert durch den Maximalwert.
 
 
-<!-- DOCEND-->
+<!-- DOC HelpContext="Count-Down"-->
 ## Count-Down Zeitgeber
 
-<!-- DOC -->
-### Einheit
-
-Legt fest, welche Einheit für den Count Down Wert verwendet werden soll
-
-- Sekunden
-- Minuten
-- Stunden
 
 <!-- DOC -->
 ### Ablauf Zeit
 
 Legt die Zeit für den Count Down Ablauf fest die bei einem Start Befehl verwendet wird.
 Hinweis: Die Zeit wird bei Verwendung des Gruppenobjekts 'Start mit Zeit' nicht verwendet.
 
+<!-- DOCEND-->
+### Eingänge
+
+#### Start / Stop
+
+Über diesen Eingang kann der Count-Down gestartet bzw. gestoppt werden.
+Der Start erfolgt über ein EIN (1) Telegram.
+Der Stopp erfolgt über ein AUS (0) Telegram.
+
+#### Pause / Fortsetzten
+
+Über diesen Eingang kann der Count-Down pausiert bzw. fortgesetzt werden.
+Der Pause erfolgt über ein EIN (1) Telegram.
+Der Fortsetzten erfolgt über ein AUS (0) Telegram.
+
 <!-- DOC -->
-### Gruppenobjekt 'Start mit Zeit'
+#### Start mit Zeit
 
 Es wird ein Gruppenobjekt eingeblendet das über einen Zahlenwert den Start des Count Down mit Zeitvorgabe ermöglicht.
 
 Mögliche Einstellungen:
 - Deaktiviert
-- Sekunden
-- Minuten
-- Stunden
+- Einheit Sekunden
+- Einheit Minuten
+- Einheit Stunden
 							
 Beispiel:
 
 Wenn 'Minuten' eingestellt wird und ein Telegram mit dem Zahlenwert 5 empfangen wird, startet der Count Down mit einer Zeitvorgabe von 5 Minuten
 
 <!-- DOC -->
-### Gruppenobjekt Zeitoffset
+#### Laufzeit Verringern / Erhöhen
 
 Mithilfe des Guppenobjekts Zeitoffset wird die Lauf-Zeit um dem eingestellten Betrag erhöht bzw. erniedrigt.
+Über ein EIN (1) Telegram wird die Laufzeit verringert.
+Über ein Aus (2) Telegram wird die Laufzeit erhöht.
 
 Mögliche Einstellungen:
 - Deaktiviert
@@ -410,31 +419,21 @@ Beispiel:
 
 Ist '5 Sekunden' ausgewählt und es wird ein Auf-Befehl (0) empfangen, wird die aktuelle Ablaufzeit um 5 Sekunden verlängert. Bei Emfpang eine Ab-Befehl (1) wird die aktuelle Ablaufzeit um 5 Sekunden verkürzt. 
 
-<!-- DOC -->
-### Gruppenobjekt Trigger
-
-Das Gruppenobjekt Trigger kann verwendet werden um ein Signal am Ende der Laufzeit des Count-Down Zeitgebers zu erzeugen.
-
-Mögliche Einstellungen:
-- Deaktiviert        
-- Nur EIN            
-- Ein für 1 Sekunde
-- Ein für 2 Sekunden 
-- Ein für 5 Sekunden 
-- Ein für 10 Sekunden
-- Ein für 20 Sekunden
-- Ein für 30 Sekunden
-- Ein für 1 Minute 
+<!-- DOCEND-->
+### Ausgänge
 
-**Nur EIN** sendet am Ende der Laufzeit ein Trigger (1) Telegram. Die anderen Einstellungen senden am Ende ein EIN (1) Telegram und nach Ablauf der Zeit ein AUS (2) Telegram.
+<!-- DOC HelpContext="GroupObjectText"-->
+#### Text
 
-Hinweis: Wird der Zeitgeber erneut gestartet bevor die eingestellte Zeit erreicht wurde, wird sofort ein AUS (0) Telegram gesendet.
+Das Gruppenobjekt stellt die Zeit als Text zur bereit.
+Über die Konfiguration kann festgelegt werden, ob die verbleibende Zeit (Abwärts laufend) oder die vergangene Zeit (Aufwärts laufend) dargestellt wird.
 
-<!-- DOCEND-->
-<!-- DOC HelpContext="TemplatePause" -->
-### Textbausteine
+Mögliche Einstellungen:
+- Deaktiviert
+- Verbleibend (Zählt abwärts)
+- Vergangen (Zählt aufwärts)
 
-Textbausteine werden verwendet um die Textausgabe im Gruppenobjekt 'Text' zu formatieren.
+Über Textbausteine kann konfiguriert werden, wie der Text dargestellt wird.
 In den Textbausteine können Platzhalter verwendet werden um Informationen zur verbleibenden Zeit oder den Laufend/Pausierten Zustand zu visualisieren.
 
 Platzhalter:
@@ -444,8 +443,11 @@ Platzhalter:
 - **M1**...Minuten (1 oder mehrstellig)"
 - **S2**...Sekunden (2 oder mehrstellig)
 - **S1**...Sekunden (1 oder mehrstellig)
+- **SX**...10 Sekunden (2 oder mehrstellig)
 - **%**....Läuft / Pause Textbautstein" 
 
+Es wrid empfohlen den Platzhalter **S1** und **S2** nur in Sonderfällen zu verwenden, da in dem Fall der Text alle Sekunden über den KNX-Bus geschickt wird und zu einer hohen Buslast führt. Besser ist stattdessen den Platzhalter *SX* zu verwenden da der nur alle 10 Sekunden eine aktualisiert durchführt.
+
 <!-- DOC HelpContext="TemplatePause" -->
 #### Pause
 
@@ -465,7 +467,7 @@ Standard Text Formatierung.
 
 Hinweis: durch Verwendung des Sekundenplatzhalters wird der KNX Bus start belastet, da jede Sekunde der aktualisierte Text übertragen wird.
 
-Beispiel: "H2:M2 %" gibt bei laufenden Zeitgeber mit einer Restlaufzeit von 3 Stunden und 15 Minuten "03:15 v" aus.
+Beispiel: "H2:M2 %" gibt bei laufenden Zeitgeber mit einer Restlaufzeit von 3 Stunden und 15 Minuten "03:15 *" aus.
 
 <!-- DOC HelpContext="Template1h" -->
 #### Kleiner 1 Stunde
@@ -474,17 +476,56 @@ Die Testformartierung wird verwendet um den Text für eine Restlaufzeit kleiner
 
 Hinweis: durch Verwendung des Sekundenplatzhalters wird der KNX Bus start belastet, da jede Sekunde der aktualisierte Text übertragen wird.
 
-Beispiel: "M2 Minuten %" gibt bei laufenden Zeitgeber mit einer Restlaufzeit von 6 Minuten "06 Minuten v" aus.
+Beispiel: "M2 Minuten %" gibt bei laufenden Zeitgeber mit einer Restlaufzeit von 6 Minuten "06 Minuten *" aus.
 
 <!-- DOC HelpContext="Template1m" -->
 #### Kleiner 1 Minute
 
 Die Testformartierung wird verwendet um den Text für eine Restlaufzeit kleiner 1 Minute auszugeben.
 
-Beispiel: "S2 Sekunden %" gibt bei laufenden Zeitgeber mit einer Restlaufzeit von 6 Sekunden "06 Sekunden v" aus.
+Beispiel: "SX Sekunden %" gibt bei laufenden Zeitgeber mit einer Restlaufzeit von 6 Sekunden (bei SC wird aufgerundet) "10 Sekunden *" aus.
 
 <!-- DOC HelpContext="TemplateEnde" -->
 #### Ende
 
 Text der nach Ablauf der Zeit angezeigt wird. 
-Eventuell verwendete Platzhalter für Stunden, Minuten und Sekunden werden mit 0 bzw. 00 ausgegeben.
+Eventuell verwendete Platzhalter für Stunden, Minuten und Sekunden werden mit 0 bzw. 00 ausgegeben.
+
+
+<!-- DOC HelpContext="GroupObjectCounter" -->
+#### Zähler Verbleibend / Vergangen
+
+Das Gruppenobjekt stellt einen Zähler bereit. 
+Achtung: Der maximalwert des Zählers ist mit 255 begrenzt. 
+Die Einheit muss so gewählt werden, dass sie mit der maximalen Laufzeit abbildbar ist.
+
+Mögliche Einstellungen:
+- Deaktiviert
+- Verbleibend Sekunden (Zählt abwärts)
+- Verbleibend Minuten (Zählt abwärts) 
+- Verbleibend Stunden (Zählt abwärts) 
+- Vergangen Sekunden (Zählt aufwärts) 
+- Vergangen Minuten (Zählt aufwärts)
+- Vergangen Stunden (Zählt aufwärts)
+
+<!-- DOC HelpContext="GroupObjectTrigger" -->
+### Auslöser / Ende
+
+Das Gruppenobjekt Trigger kann verwendet werden um ein Signal am Ende der Laufzeit des Count-Down Zeitgebers zu erzeugen.
+
+Mögliche Einstellungen:
+- Deaktiviert        
+- Nur EIN            
+- Ein für 1 Sekunde
+- Ein für 2 Sekunden 
+- Ein für 5 Sekunden 
+- Ein für 10 Sekunden
+- Ein für 20 Sekunden
+- Ein für 30 Sekunden
+- Ein für 1 Minute 
+
+**Nur EIN** sendet am Ende der Laufzeit ein Trigger (1) Telegram. Die anderen Einstellungen senden am Ende ein EIN (1) Telegram und nach Ablauf der Zeit ein AUS (2) Telegram.
+
+Hinweis: Wird der Zeitgeber erneut gestartet bevor die eingestellte Zeit erreicht wurde, wird sofort ein AUS (0) Telegram gesendet.
+
+<!-- DOCEND-->

src/Baggages/Help_de/FCB-Count-Down-Zeitgeber.md

@@ -0,0 +1,11 @@
+### Count-Down Zeitgeber
+
+Der Funktionsblock zählt von eine vorgebenen Zeit herunter.
+Die Laufzeit kann über konfiguration oder über den Bus gesteuert werden.
+Der Count Down kann pausiert werden.
+Es gibt Ausgänge für
+ - Verbleibende Zeit
+ - Textdartstellung der verbleibenden Zeit mit Einheit
+ - Aktiv laufende Zeit
+ - Pause aktiv
+

src/Baggages/Help_de/FCB-Count-Down.md

@@ -1,11 +1,3 @@
-### Count Down
+### Count-Down Zeitgeber
 
-Der Funktionsblock zählt von eine vorgebenen Zahl in herunter.
-Es kann zwischen Sekunden, Minuten, Stunden als Einheit gewählt werden.
-Der Count Down kann auch pausiert werden.
-Es gibt Ausgänge für
- - Verbleibende Zeit
- - Textdartstellung der verbleibenden Zeit mit Einheit
- - Aktiv laufende Zeit
- - Pause aktiv
 

src/Baggages/Help_de/FCB-Einheit.md

@@ -0,0 +1,15 @@
+### Zähler Verbleibend / Vergangen
+
+Das Gruppenobjekt stellt einen Zähler bereit. 
+Achtung: Der maximalwert des Zählers ist mit 255 begrenzt. 
+Die Einheit muss so gewählt werden, dass sie mit der maximalen Laufzeit abbildbar ist.
+
+Mögliche Einstellungen:
+- Deaktiviert
+- Verbleibend Sekunden (Zählt abwärts)
+- Verbleibend Minuten (Zählt abwärts) 
+- Verbleibend Stunden (Zählt abwärts) 
+- Vergangen Sekunden (Zählt aufwärts) 
+- Vergangen Minuten (Zählt aufwärts)
+- Vergangen Stunden (Zählt aufwärts)
+

src/Baggages/Help_de/FCB-GroupObjectCounter.md

@@ -0,0 +1,25 @@
+### Text
+
+Das Gruppenobjekt stellt die Zeit als Text zur bereit.
+Über die Konfiguration kann festgelegt werden, ob die verbleibende Zeit (Abwärts laufend) oder die vergangene Zeit (Aufwärts laufend) dargestellt wird.
+
+Mögliche Einstellungen:
+- Deaktiviert
+- Verbleibend (Zählt abwärts)
+- Vergangen (Zählt aufwärts)
+
+Über Textbausteine kann konfiguriert werden, wie der Text dargestellt wird.
+In den Textbausteine können Platzhalter verwendet werden um Informationen zur verbleibenden Zeit oder den Laufend/Pausierten Zustand zu visualisieren.
+
+Platzhalter:
+- **H2**...Stunden (2 oder mehrstellig)"
+- **H1**...Stunden (1 oder mehrstellig)"
+- **M2**...Minuten (2 oder mehrstellig)"
+- **M1**...Minuten (1 oder mehrstellig)"
+- **S2**...Sekunden (2 oder mehrstellig)
+- **S1**...Sekunden (1 oder mehrstellig)
+- **SX**...10 Sekunden (2 oder mehrstellig)
+- **%**....Läuft / Pause Textbautstein" 
+
+Es wrid empfohlen den Platzhalter **S1** und **S2** nur in Sonderfällen zu verwenden, da in dem Fall der Text alle Sekunden über den KNX-Bus geschickt wird und zu einer hohen Buslast führt. Besser ist stattdessen den Platzhalter *SX* zu verwenden da der nur alle 10 Sekunden eine aktualisiert durchführt.
+

src/Baggages/Help_de/FCB-GroupObjectText.md

@@ -1,4 +1,4 @@
-### Gruppenobjekt Trigger
+### Auslöser / Ende
 
 Das Gruppenobjekt Trigger kann verwendet werden um ein Signal am Ende der Laufzeit des Count-Down Zeitgebers zu erzeugen.
 

src/Baggages/Help_de/FCB-Gruppenobjekt-Trigger.md renamed to src/Baggages/Help_de/FCB-GroupObjectTrigger.md

@@ -22,8 +22,8 @@ Für jeden Kanal kann für einen Funktionsblock konfiguriert werden:
   Ein Aggregations-Funktionsblock hat bis zu 9 Eingänge mit numerischem Typ.
   Es kann zwischen fünf Funktionen (Summe, Mittelwert, Minimum, Maximum, Spannbreite) zur Berechnung des Ausgangswertes gewählt werden.
 
-- **Count Down**
-  Zählt von eine vorgebenen Zahl in herunter.
-  Es kann zwischen Sekunden, Minuten, Stunden als Einheit gewählt werden.
+- **Count-Down Zeitgeber**
+  Zählt von eine vorgebenen Zeit in herunter.
+  Die Laufzeit kann über konfiguration oder über den Bus gesteuert werden.
 
 

src/Baggages/Help_de/FCB-Kanalauswahl.md

@@ -1,6 +1,8 @@
-### Gruppenobjekt Zeitoffset
+### Laufzeit Verringern / Erhöhen
 
 Mithilfe des Guppenobjekts Zeitoffset wird die Lauf-Zeit um dem eingestellten Betrag erhöht bzw. erniedrigt.
+Über ein EIN (1) Telegram wird die Laufzeit verringert.
+Über ein Aus (2) Telegram wird die Laufzeit erhöht.
 
 Mögliche Einstellungen:
 - Deaktiviert

src/Baggages/Help_de/FCB-Gruppenobjekt-Zeitoffset.md renamed to src/Baggages/Help_de/FCB-Laufzeit-Verringern-Erhoehen.md

@@ -1,12 +1,12 @@
-### Gruppenobjekt 'Start mit Zeit'
+### Start mit Zeit
 
 Es wird ein Gruppenobjekt eingeblendet das über einen Zahlenwert den Start des Count Down mit Zeitvorgabe ermöglicht.
 
 Mögliche Einstellungen:
 - Deaktiviert
-- Sekunden
-- Minuten
-- Stunden
+- Einheit Sekunden
+- Einheit Minuten
+- Einheit Stunden
 
 Beispiel:
 

src/Baggages/Help_de/FCB-Gruppenobjekt-Start-mit-Zeit.md renamed to src/Baggages/Help_de/FCB-Start-mit-Zeit.md

@@ -4,5 +4,5 @@ Standard Text Formatierung.
 
 Hinweis: durch Verwendung des Sekundenplatzhalters wird der KNX Bus start belastet, da jede Sekunde der aktualisierte Text übertragen wird.
 
-Beispiel: "H2:M2 %" gibt bei laufenden Zeitgeber mit einer Restlaufzeit von 3 Stunden und 15 Minuten "03:15 v" aus.
+Beispiel: "H2:M2 %" gibt bei laufenden Zeitgeber mit einer Restlaufzeit von 3 Stunden und 15 Minuten "03:15 *" aus.
 

src/Baggages/Help_de/FCB-Template.md

@@ -4,5 +4,5 @@ Die Testformartierung wird verwendet um den Text für eine Restlaufzeit kleiner
 
 Hinweis: durch Verwendung des Sekundenplatzhalters wird der KNX Bus start belastet, da jede Sekunde der aktualisierte Text übertragen wird.
 
-Beispiel: "M2 Minuten %" gibt bei laufenden Zeitgeber mit einer Restlaufzeit von 6 Minuten "06 Minuten v" aus.
+Beispiel: "M2 Minuten %" gibt bei laufenden Zeitgeber mit einer Restlaufzeit von 6 Minuten "06 Minuten *" aus.
 

src/Baggages/Help_de/FCB-Template1h.md

@@ -2,5 +2,5 @@
 
 Die Testformartierung wird verwendet um den Text für eine Restlaufzeit kleiner 1 Minute auszugeben.
 
-Beispiel: "S2 Sekunden %" gibt bei laufenden Zeitgeber mit einer Restlaufzeit von 6 Sekunden "06 Sekunden v" aus.
+Beispiel: "SX Sekunden %" gibt bei laufenden Zeitgeber mit einer Restlaufzeit von 6 Sekunden (bei SC wird aufgerundet) "10 Sekunden *" aus.
 

src/Baggages/Help_de/FCB-Template1m.md

@@ -1,3 +1,6 @@
 ### Ende
 
 Text der nach Ablauf der Zeit angezeigt wird. 
+Eventuell verwendete Platzhalter für Stunden, Minuten und Sekunden werden mit 0 bzw. 00 ausgegeben.
+
+

src/Baggages/Help_de/FCB-TemplateEnde.md

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <?xml-model href="../../Organization/knxprod-support/knx_project_14/knx-editor.xsd" type="application/xml" schematypens="http://www.w3.org/2001/XMLSchema"?>
 <KNX xmlns:op="http://github.com/OpenKNX/OpenKNXproducer" xmlns="http://knx.org/xml/project/14" CreatedBy="KNX MT" ToolVersion="5.1.255.16695">
-	<op:config name="%IW_NumChannelsDefault%" value="%N%" />
+	<op:config name="%FCB_NumChannelsDefault%" value="0" />
 	<ManufacturerData>
 		<Manufacturer>
 			<ApplicationPrograms>
@@ -158,9 +158,9 @@
 							<ParameterType Id="%AID%_PT-FCBCountDownTimeStartKo" Name="FCBCountDownTimeStartKo" >
 								<TypeRestriction Base="Value" SizeInBit="4" >
 									<Enumeration Id="%ENID%" Value="0"  Text="Deaktiviert"  />
-									<Enumeration Id="%ENID%" Value="1"  Text="Sekunden"  />
-									<Enumeration Id="%ENID%" Value="2"  Text="Minuten"   />
-									<Enumeration Id="%ENID%" Value="3"  Text="Stunden"   />
+									<Enumeration Id="%ENID%" Value="1"  Text="Einheit Sekunden"  />
+									<Enumeration Id="%ENID%" Value="2"  Text="Einheit Minuten"   />
+									<Enumeration Id="%ENID%" Value="3"  Text="Einheit Stunden"   />
 								</TypeRestriction>
 							</ParameterType>
 
@@ -199,6 +199,27 @@
 								</TypeRestriction>
 							</ParameterType>
 
+							<ParameterType Id="%AID%_PT-FCBGrouptObjectText" Name="FCBGrouptObjectText">
+								<TypeRestriction Base="Value" SizeInBit="2" UIHint="DropDown" >
+									<Enumeration Id="%ENID%" Value="0"  Text="Deaktiviert"  />
+									<Enumeration Id="%ENID%" Value="1"  Text="Verbleibend (Zählt abwärts)" />
+									<Enumeration Id="%ENID%" Value="2"  Text="Vergangen (Zählt aufwärts)" />
+								</TypeRestriction>
+							</ParameterType>
+
+							<ParameterType Id="%AID%_PT-FCBGrouptObjectCounter" Name="FCBGrouptObjectCounter">
+								<TypeRestriction Base="Value" SizeInBit="4" UIHint="DropDown" >
+									<Enumeration Id="%ENID%" Value="0"  Text="Deaktiviert"  />
+									<Enumeration Id="%ENID%" Value="1"  Text="Verbleibend Sekunden (Zählt abwärts)" />
+									<Enumeration Id="%ENID%" Value="2"  Text="Verbleibend Minuten (Zählt abwärts)" />
+									<Enumeration Id="%ENID%" Value="3"  Text="Verbleibend Stunden (Zählt abwärts)" />
+									<Enumeration Id="%ENID%" Value="4"  Text="Vergangen Sekunden (Zählt aufwärts)" />
+									<Enumeration Id="%ENID%" Value="5"  Text="Vergangen Minuten (Zählt aufwärts)" />
+									<Enumeration Id="%ENID%" Value="6"  Text="Vergangen Stunden (Zählt aufwärts)" />
+								</TypeRestriction>
+							</ParameterType>
+
+
 							<ParameterType Id="%AID%_PT-FCBCountDownTextTemplate" Name="FCBCountDownTextTemplate">
 								<TypeText SizeInBit="112" />
 								<!-- 14 characters -->
@@ -216,7 +237,7 @@
 							<Union SizeInBit="8">
 								<Memory CodeSegment="%MID%" Offset="0" BitOffset="0" />
 								<!-- Number of channels -->
-								<Parameter Id="%AID%_UP-%TT%00000" Name="VisibleChannels" ParameterType="%AID%_PT-FCBNumChannels" Offset="0" BitOffset="0" Text="Verfügbare Kanäle" Value="%IW_NumChannelsDefault%" SuffixText=" von %N%" />
+								<Parameter Id="%AID%_UP-%TT%00000" Name="VisibleChannels" ParameterType="%AID%_PT-FCBNumChannels" Offset="0" BitOffset="0" Text="Verfügbare Kanäle" Value="%FCB_NumChannelsDefault%" SuffixText=" von %N%" />
 							</Union>							
 						</Parameters>
 						<ParameterRefs>