# LGF_Frequency (FB / V3.0.1)

Autor: Siemens Industry Support

## Kurzbeschreibung

Diese Funktion generiert ein Signal, das in Abhängigkeit von einer definierten Frequenz und einem Pulspausenverhältnis, zwischen den Werten `FALSE` und `TRUE` wechselt.

### Baustein Schnittstelle

| LGF_Frequency (FB) |
--- | --- | ---
Real |  |  | frequency |  | clock |  |  | Bool
Real |  |  | pulsePauseRatio |  | countdown |  |  | Time

### Input Parameter

Bezeichner | Datentyp | Default Wert | Beschreibung
--- | --- | --- | ---
frequency | Real | 0.0 | Taktfrequenz in Hz.
pulsePauseRatio | Real | 1.0 | Pulspausenverhältnis (Standard: 1.0 entspricht 1:1).

### Output Parameter

Bezeichner | Datentyp | Beschreibung
--- | --- | ---
clock | Bool | Ausgang wechselt mit definierter Frequenz.
countdown | Time | Verbleibende Zeit des aktuellen Zustands von `clock`.

## Funktionsbeschreibung

Der Ausgang `clock` ist ein boolescher Wert, der in der gewünschten Frequenz toggelt. Über den Eingang `pulsePauseRatio` wird das Pulspausenverhältnis eingestellt.

Der Ausgang `countdown` gibt die verbleibende Zeit des aktuellen Zustands von `clock` aus.

Falls die gewünschte Frequenz oder das Pulspausenverhältnis kleiner oder gleich `0.0` ist, ist der Ausgang `clock` = FALSE und `countdown` = `0s`.

###### Beispiel

Hinweis
  Der Takt (`clock`) des FB LGF_Frequency ist abhängig von der Zykluszeit des OB Main. Um die Genauigkeit zu erhöhen, kann der FB auch in einem Weckalarm-OB (Cyclic Interrupt OB) mit niedrigem Zeittakt aufgerufen werden.

## Änderungshistorie

Version & Datum | Änderungsbeschreibung
--- | ---
| 01.00.00 | Siemens Industry Online Support
| 19.08.2015 | First released version
| 01.01.00 | Siemens Industry Online Support
| 25.05.2016 | New function: pulse pause ratio
| 01.01.01 | Siemens Industry Online Support
| 26.05.2016 | Add comments
| 01.01.02 | Siemens Industry Online Support
| 02.01.2017 | Upgrade: TIA Portal V14 Update 1
| 01.01.03 | Siemens Industry Online Support
| 17.08.2018 | Upgrade: TIA V15 Update 2
| 01.01.04 | Siemens Industry Online Support
| 23.11.2018 | Upgrade: TIA V15.1
| 01.00.07 | Simatic Systems Support
| 20.09.2019 | Code refactoring, regions and more comments added
| 03.00.00 | Simatic Systems Support
| 23.04.2020 | Set version to V3.0.0, harmonize the version of the whole library
| 03.00.01 | Simatic Systems Support
| 15.02.2021 | Insert documentation