# Clock7d1Ch

## `Clock7d1Ch` (FB)

FUNCTION\_BLOCK Clock7d1Ch

### Kurzbeschreibung

> Schaltuhr mit 7 Wochentagen, je einem Ein- / Ausschaltzeitpunkt und binärem Gesamtausgang.\
> Die Funktionsweise (Einschaltperiode oder Ausschaltperiode) ist pro Wochentag definierbar.\
> Typische Anwendung: Festlegung des Nacht- / Tagbetriebs einer Zonentemperaturregelung.

### Darstellung

<figure><img src="https://879424349-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQR4vCFzt6ixgsqlR3pdR%2Fuploads%2Fgit-blob-b8d06de4432b8cdaf03f9d33a775ff28a27901df%2FClock7d1Ch_FB.png?alt=media" alt=""><figcaption></figcaption></figure>

### Schnittstellen

#### Eingänge

| Name  | Datentyp | Wertebereich | Initialwert | Funktion        |
| ----- | -------- | ------------ | ----------- | --------------- |
| *xEn* | BOOL     |              |             | Freigabeeingang |

#### Ausgänge

| Name               | Datentyp | Wertebereich | Initialwert | Funktion                                    |
| ------------------ | -------- | ------------ | ----------- | ------------------------------------------- |
| *xActive*          | BOOL     |              |             | Anzeige aktiver Schaltperioden              |
| *todActivatedFrom* | TOD      |              |             | Einschaltzeitpunkt des aktuellen Wochentags |
| *todActivatedTo*   | TOD      |              |             | Ausschaltzeitpunkt des aktuellen Wochentags |

#### Sollwerte / Parameter

| Name           | Datentyp | Wertebereich | Initialwert | Funktion                           |
| -------------- | -------- | ------------ | ----------- | ---------------------------------- |
| **todMonFrom** | TOD      |              | TOD#07:00   | Einschaltzeitpunkt - Montag        |
| **todMonTo**   | TOD      |              | TOD#12:00   | Ausschaltzeitpunkt - Montag        |
| **xMonMode**   | BOOL     |              | TRUE        | Modus - Schaltperiode - Montag     |
| **todTueFrom** | TOD      |              | TOD#07:00   | Einschaltzeitpunkt - Dienstag      |
| **todTueTo**   | TOD      |              | TOD#12:00   | Ausschaltzeitpunkt - Dienstag      |
| **xTueMode**   | BOOL     |              | TRUE        | Modus - Schaltperiode - Dienstag   |
| **todWedFrom** | TOD      |              | TOD#07:00   | Einschaltzeitpunkt - Mittwoch      |
| **todWedTo**   | TOD      |              | TOD#12:00   | Ausschaltzeitpunkt - Mittwoch      |
| **xWedMode**   | BOOL     |              | TRUE        | Modus - Schaltperiode - Mittwoch   |
| **todThuFrom** | TOD      |              | TOD#07:00   | Einschaltzeitpunkt - Donnerstag    |
| **todThuTo**   | TOD      |              | TOD#12:00   | Ausschaltzeitpunkt - Donnerstag    |
| **xThuMode**   | BOOL     |              | TRUE        | Modus - Schaltperiode - Donnerstag |
| **todFriFrom** | TOD      |              | TOD#07:00   | Einschaltzeitpunkt - Freitag       |
| **todFriTo**   | TOD      |              | TOD#12:00   | Ausschaltzeitpunkt - Freitag       |
| **xFriMode**   | BOOL     |              | TRUE        | Modus - Schaltperiode - Freitag    |
| **todSatFrom** | TOD      |              | TOD#07:00   | Einschaltzeitpunkt - Samstag       |
| **todSatTo**   | TOD      |              | TOD#12:00   | Ausschaltzeitpunkt - Samstag       |
| **xSatMode**   | BOOL     |              | TRUE        | Modus - Schaltperiode - Samstag    |
| **todSunFrom** | TOD      |              | TOD#07:00   | Einschaltzeitpunkt - Sonntag       |
| **todSunTo**   | TOD      |              | TOD#12:00   | Ausschaltzeitpunkt - Sonntag       |
| **xSunMode**   | BOOL     |              | TRUE        | Modus - Schaltperiode - Sonntag    |
| **sNotice**    | STRING   |              | ‘Notice’    | Bezeichnung - Schaltuhr            |

### Funktionsbeschreibung

#### Allgemeines

#### Wochentage 1 - 7 (Montag … Sonntag, XXX = Mon, Tue, Wed, Thu, Fri, Sat, Sun)

Jedem der sieben Wochentage ist eine eigene Schaltperiode zugeordnet.\
\
Jede Schaltperiode ist durch einstellbare Daten (Einschaltzeitpunkt **todXXXTimeFrom** und Ausschaltzeitpunkt **todXXXTimeTo**) definiert.\
Zusätzlich kann eine Betriebsart (**xXXXMode**) pro Wochentag festgelegt werden.\
\
Liegt der Ausschaltzeitpunkt vor dem Einschaltzeitpunkt, so wird für die Prüfung der Ausschaltzeitpunkt auf den Wert des Einschaltzeitpunkts gelegt.\
\
Eine Schaltperiode ist aktiv, falls sich die aktuelle Uhrzeit am Wochentag XXX innerhalb der Schaltperiode des Wochentag XXX befindet (**xXXXMode** = TRUE).\
Eine Schaltperiode ist aktiv, falls sich die aktuelle Uhrzeit am Wochentag XXX außerhalb der Schaltperiode des Wochentag XXX befindet (**xXXXMode** = FALSE).

> **Sonderfall 1: Einschaltzeitpunkt = Ausschaltzeitpunkt = TOD#00:00**
>
> Bei aktiver Einschaltperiode ( **xXXXMode** = TRUE ) ist die Schaltperiode ganztägig nicht aktiv.\
> Bei aktiver Ausschaltperiode ( **xXXXMode** = FALSE ) ist die Schaltperiode ganztägig aktiv.
>
> **Sonderfall 2: Einschaltzeitpunkt = Ausschaltzeitpunkt = TOD#23:59**
>
> Bei aktiver Einschaltperiode (**xXXXMode** = TRUE) ist die Schaltperiode ganztägig aktiv.\
> Bei aktiver Ausschaltperiode (**xXXXMode** = FALSE) ist die Schaltperiode ganztägig nicht aktiv.
>
> **Voraussetzung für den Einsatz des Funktionsbausteins Clock7d1Ch**
>
> Zur korrekten Funktion ist der Einsatz des Funktionsbausteins TimeRead2 erforderlich.

#### Einschaltperiode

<figure><img src="https://879424349-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQR4vCFzt6ixgsqlR3pdR%2Fuploads%2Fgit-blob-39d84c4a7f8fbd7fa98a556ed0ad75c20f902db4%2FClock7d1Ch_Bild_1.png?alt=media" alt=""><figcaption></figcaption></figure>

#### Ausschaltperiode

<figure><img src="https://879424349-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQR4vCFzt6ixgsqlR3pdR%2Fuploads%2Fgit-blob-303d5146cbf904c17254a4e84369bd350ef78bbf%2FClock7d1Ch_Bild_2.png?alt=media" alt=""><figcaption></figcaption></figure>

#### Freigabeeingang *xEn*

| *xEn* | *xActive*                                                         | *todActivatedFrom*                                            | *todActivatedTo*                                              | Hinweis        |
| ----- | ----------------------------------------------------------------- | ------------------------------------------------------------- | ------------------------------------------------------------- | -------------- |
| FALSE | FALSE                                                             | unverändert                                                   | unverändert                                                   | FB deaktiviert |
| TRUE  | Zustand abhängig vom Wochentag, der Uhrzeit und der Schaltperiode | Einschaltzeitpunkt der Schaltperiode des aktuellen Wochentags | Ausschaltzeitpunkt der Schaltperiode des aktuellen Wochentags | FB aktiviert   |

#### Anzeigeausgang *xActive*

Der Anzeigeausgang *xActive* nimmt den Zustand TRUE an, falls bei aktivem Freigabeeingang (*xEn* = TRUE) die Uhrzeit am Wochentag XXX innerhalb der Schaltperiode des Wochentags XXX liegt (**xXXXMode** = TRUE, Einschaltperiode).\
Der Anzeigeausgang *xActive* nimmt den Zustand TRUE an, falls bei aktivem Freigabeeingang (*xEn* = TRUE) die Uhrzeit am Wochentag XXX außerhalb der Schaltperiode des Wochentags XXX liegt (**xXXXMode** = FALSE, Ausschaltperiode).\
In allen übrigen Fällen nimmt der Anzeigeausgang *xActive* den Zustand FALSE an.

| *xEn* | *xActive* | Schaltperiode XXX | **xXXXMode** - XXX | Hinweis                      |
| ----- | --------- | ----------------- | ------------------ | ---------------------------- |
| FALSE | FALSE     | X                 | X                  | FB deaktiviert               |
| TRUE  | FALSE     | FALSE             | TRUE               | Einschaltperiode nicht aktiv |
| TRUE  | TRUE      | TRUE              | TRUE               | Einschaltperiode aktiv       |
| TRUE  | TRUE      | FALSE             | FALSE              | Ausschaltperiode nicht aktiv |
| TRUE  | FALSE     | TRUE              | FALSE              | Ausschaltperiode aktiv       |

#### Einschaltzeitpunkt der Schaltperiode des aktuellen Wochentags *todActivatedFrom*

Dieser Ausgang zeigt permanent den Einschaltzeitpunkt der Schaltperiode des aktuellen Wochentags an, falls der Freigabeeingang (*xEn* = TRUE) aktiv ist.\
In allen übrigen Situationen wird er nicht verändert. In den Sonderfällen 1 und 2 wird stets der Wert TOD#00:00 angezeigt.

#### Ausschaltzeitpunkt der Schaltperiode des aktuellen Wochentags *todActivatedTo*

Dieser Ausgang zeigt permanent den Ausschaltzeitpunkt der Schaltperiode des aktuellen Wochentags an, falls der Freigabeeingang (*xEn* = TRUE) aktiv ist.\
In allen übrigen Situationen wird er nicht verändert. Im Sonderfall 1 wird stets der Wert TOD#00:00, im Sonderfall 2 der Wert TOD#23:59 angezeigt.

### Visualisierung

Passendes Visualisierungselement aus der HVACV Visu Library: **FB\_Clock7d1Ch**

#### Darstellung

>

#### Schnittstellen Visu-Element

| Name               | Datentyp   | Typ          | Initialwert | Funktion                                         |
| ------------------ | ---------- | ------------ | ----------- | ------------------------------------------------ |
| **FB\_Clock7d1Ch** | Clock7d1Ch | VAR\_IN\_OUT |             | Hier FB Clock7d1Ch eintragen Bsp. PRG.Clock7d1Ch |

Oder Visuelement **Clock7d1Ch\_D** als Dialog. Aufruf des Dialogs z.B. über das Viuelement **Clock7d1Ch\_Button**

<figure><img src="https://879424349-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQR4vCFzt6ixgsqlR3pdR%2Fuploads%2Fgit-blob-0efb1874527a017d69a3d8c7809d149fab826a7b%2FFB_Clock7d1Ch.PNG?alt=media" alt=""><figcaption></figcaption></figure>

#### Schnittstellen Visu-Element

| Name               | Datentyp   | Typ          | Initialwert | Funktion                                                                                                                                                                                                                                    |
| ------------------ | ---------- | ------------ | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **FB\_Clock7d1Ch** | Clock7d1Ch | VAR\_IN\_OUT |             | Hier FB Clock7d1Ch eintragen Bsp. PRG.Clock7d1Ch                                                                                                                                                                                            |
| **ClockNumber**    | INT        | VAR\_INPUT   |             | Uhrnummer. Nur für die Anzeige des Titels verwendet.                                                                                                                                                                                        |
| **BMS\_Active**    | BOOL       | VAR\_INPUT   |             | BMS (Building Management System) GLT (Gebäudeleittechnik). Wenn BMS\_Active = TRUE wird die Eingabe/Editierung der Uhren deaktiviert da diese dann nur über das BMS eingestellt werden können. Uhrzeiten können dann nur angeschaut werden. |
| **DisableInput**   | BOOL       | VAR\_INPUT   |             | DisableInput = TRUE Uhrzeiten der Wochenuhren können nur angesehen werden und nicht editiert werden.                                                                                                                                        |

\
Hinweis: VAR\_IN\_OUT Schnittstellen müssen belegt werden, VAR\_INPUT sind optional.

### CODESYS

InOut:

| Scope       | Name               | Type       | Initial                       |
| ----------- | ------------------ | ---------- | ----------------------------- |
| Input       | `xEn`              | `BOOL`     |                               |
| Input Const | `todMonFrom`       | `TOD`      | TIME\_OF\_DAY#6:0             |
| Input Const | `todMonTo`         | `TOD`      | TIME\_OF\_DAY#18:0            |
| Input Const | `xMonMode`         | `BOOL`     | TRUE                          |
| Input Const | `todTueFrom`       | `TOD`      | TIME\_OF\_DAY#6:0             |
| Input Const | `todTueTo`         | `TOD`      | TIME\_OF\_DAY#18:0            |
| Input Const | `xTueMode`         | `BOOL`     | TRUE                          |
| Input Const | `todWedFrom`       | `TOD`      | TIME\_OF\_DAY#6:0             |
| Input Const | `todWedTo`         | `TOD`      | TIME\_OF\_DAY#18:0            |
| Input Const | `xWedMode`         | `BOOL`     | TRUE                          |
| Input Const | `todThuFrom`       | `TOD`      | TIME\_OF\_DAY#6:0             |
| Input Const | `todThuTo`         | `TOD`      | TIME\_OF\_DAY#18:0            |
| Input Const | `xThuMode`         | `BOOL`     | TRUE                          |
| Input Const | `todFriFrom`       | `TOD`      | TIME\_OF\_DAY#6:0             |
| Input Const | `todFriTo`         | `TOD`      | TIME\_OF\_DAY#18:0            |
| Input Const | `xFriMode`         | `BOOL`     | TRUE                          |
| Input Const | `todSatFrom`       | `TOD`      | TIME\_OF\_DAY#6:0             |
| Input Const | `todSatTo`         | `TOD`      | TIME\_OF\_DAY#18:0            |
| Input Const | `xSatMode`         | `BOOL`     | TRUE                          |
| Input Const | `todSunFrom`       | `TOD`      | TIME\_OF\_DAY#6:0             |
| Input Const | `todSunTo`         | `TOD`      | TIME\_OF\_DAY#18:0            |
| Input Const | `xSunMode`         | `BOOL`     | TRUE                          |
| Input Const | `sNotice`          | `STRING`   | ‘Notice’                      |
| Input Const | `eMode`            | eClockMode | eClockMode.EachModeSeparately |
| Output      | `xActive`          | `BOOL`     |                               |
| Output      | `todActivatedFrom` | `TOD`      |                               |
| Output      | `todActivatedTo`   | `TOD`      |                               |