LGF_TimerSwitch (FB / V3.1.0)

Übersicht

Autor: Siemens Digital Industry

Kurzbeschreibung

Dieser Baustein ist eine Zeitschaltuhr. Es ist möglich tägliche, wöchentliche, monatliche, jährliche Zeitschaltpunkte und Zeitschaltpunkte für Werktage oder Wochenendtage festzulegen.
Mode: Dauerhaft Aus: 0, Täglich: 1, Wöchentlich: 2, Monatlich: 3, Jährlich: 4, Arbeitstage: 5, Wochenende: 6, Dauerhaft Ein: 10

Der Zeitwert wird immer mit der Lokalzeit der SPS verglichen, daher muss der Zeitwert, der bei den On- und Off-Parametern angegeben wird, als lokale Zeit angegeben werden.

Baustein Schnittstelle

LGF_TimerSwitch (FB)
USInt  onMonth signal  Bool
    
USInt  onDay actLocalTime  DTL
    
USInt  onWeekday error  Bool
    
USInt  onHour status  Word
    
USInt  onMinute subFunctionStatus  Word
    
USInt  offMonth   
    
USInt  offDay   
    
USInt  offWeekday   
    
USInt  offHour   
    
USInt  offMinute   
    
USInt  mode   
    
   

Input Parameter

BezeichnerDatentyp Default Wert Beschreibung
onMonthUSInt 0 Monat, in der der Ausgang gesetzt wird
onDayUSInt 0 Tag, an dem der Ausgang gesetzt wird
onWeekdayUSInt 0 Wochentag, an dem der Ausgang gesetzt wird;
Sonntag: 1, Montag: 2, Dienstag: 3, ...
onHourUSInt 0 Stunde, in der der Ausgang gesetzt wird
onMinuteUSInt 0 Minute, in der der Ausgang gesetzt wird
offMonthUSInt 0 Monat, in der der Ausgang zurückgesetzt wird
offDayUSInt 0 Tag, an dem der Ausgang zurückgesetzt wird
offWeekdayUSInt 0 Wochentag, an dem der Ausgang zurückgesetzt wird;
Sonntag: 1, Montag: 2, Dienstag: 3, ...
offHourUSInt 0 Stunde, in der der Ausgang zurückgesetzt wird
offMinuteUSInt 0 Minute, in der der Ausgang zurückgesetzt wird
modeUSInt 0 Angabe des Modus (siehe Funktionsweise);
Dauerhaft Aus: 0, Täglich: 1, Wöchentlich: 2, Monatlich: 3, Jährlich: 4, Arbeitstage: 5, Wochenende: 6, Dauerhaft Ein: 10

Output Parameter

BezeichnerDatentyp Beschreibung
signalBool Ausagngssignal
actLocalTimeDTL Aktuelle Lokalzeit
errorBool FALSE: Kein Fehler / TRUE: Während der Ausführung des FB ist ein Fehler aufgetreten
statusWord 16#0000-16#7FFF: Status des FB / 16#8000-16#FFFF: Fehleridentifikation (siehe folgende Tabelle)
subFunctionStatusWord Status Word einer aufgerufenen Unterfunktion

Status & Error Meldungen

Code / WertBezeichner / Beschreibung
16#0000STATUS_NO_ERROR
Status: kein Fehler aufgetreten
16#8200ERR_NO_MODE_SELECTED
Error: Kein vorhandener Mode ausgewählt, bitte Eingang `mode` prüfen
16#8600ERR_RD_LOC_T
Error in Funktion RD_LOC_T - weitere infos in `subFunctionStatus`

Funktionsbeschreibung

Hinweis
In subFunctionStatus wird der Status von aufgerufenen Anweisungen ausge-geben. Der Ausgangswert in status gibt in diesem Fall an, welche Anweisung den Fehler verursacht hat. Holen Sie sich in diesem Fall die Informationen aus der TIA Portal Online Hilfe zu den jeweiligen Anweisungen.

Hinweis
Die Funktion verwendet intern die Systemfunktion RD_LOC_T um die Lokalzeit der CPU auszulesen, für die korrekte Funktionsweise ist es daher notwendig das die Lokalzeit der CPU korrekt eingestellt ist.

Der Baustein bietet verschiedene Arten einer Zeitschaltuhr, die im Parameter mode bestimmt werden

Der Zeitwert wird immer mit der Lokalzeit der SPS verglichen, daher muss der Zeitwert, der bei den On- und Off-Parametern angegeben wird, als lokale Zeit angegeben werden.

Abhängig vom Modus müssen folgende Formalparameter beschaltet werden:

Mode Mode Required formal parameters
0 . Dauerhaft Aus
  • keine
1 . Tägliche Zeitschaltuhr
  • onHour / offHour
  • onMinute / offMinute
2 . Wöchentlich Zeitschaltuhr
  • onWeekday / offWeekday
  • onHour / offHour
  • onMinute / offMinute
3 . Monatliche Zeitschaltuhr
  • onDay / offDay
  • onHour / offHour
  • onMinute / offMinute
4 . Jährliche Zeitschaltuhr
  • onMonth / offMonth
  • onDay / offDay
  • onHour / offHour
  • onMinute / offMinute
5 . Werktags
  • onHour / offHour
  • onMinute / offMinute
6 . Wochenende
  • onHour / offHour
  • onMinute / offMinute
10 . Dauerhaft Ein
  • keine

Entspricht die eingestellte Startzeit der aktuellen Lokalzeit der Steuerung, wird der Ausgang signal auf TRUE gesetzt. Entspricht die eingestellte Abschaltzeit der aktuellen Lokalzeit der Steuerung, wird der Ausgang signal wieder zurückgesetzt.


Hinweis
Beachten Sie, dass der Baustein in den Modi „Monatliche Zeitschaltuhr“ (mode = 3) oder „Jährliche Zeitschaltuhr“ (mode = 4) nur dann schaltet, wenn die Tage, die Sie an den Eingangsparametern „onDay“ und „offDay“ angeben, tatsächlich in diesem Monat vorkommen.

Änderungshistorie

Version & DatumÄnderungsbeschreibung
01.00.00Siemens Industry Online Support
19.08.2015First released version
01.00.01Siemens Industry Online Support
16.11.2015Fix in mode 2
01.01.00Siemens Industry Online Support
23.05.2016New mode 5 + 6
New output: actLocalTime
01.01.01Siemens Industry Online Support
02.01.2017Upgrade: TIA V14 Update 1
01.01.02Siemens Industry Online Support
14.09.2018Fix in modes 1, 3, 5, 6
01.01.03Siemens Industry Online Support
17.09.2018Upgrade: TIA V15 Update 2
01.01.04Siemens Industry Online Support
10.10.2018Connection to type restored
01.01.05Siemens Industry Online Support
23.11.2018Upgrade: TIA V15.1
01.01.10Simatic Systems Support
13.11.2019Magic numbers removed, tag naming added, code reworked
03.00.00Simatic Systems Support
23.04.2020Set version to V3.0.0, harmonize the version of the whole library
03.00.01Simatic Systems Support
19.01.2020Insert documentation
03.01.00Simatic Systems Support
03.06.2022Insert mode `permanently On`: `10`, `permanently Off`: `0`