LGF_RandomRange_Real (FC / V3.0.1)


Autor: Siemens Digital Industries

Kurzbeschreibung

Diese Funktion generiert bei jedem Aufruf einen zufälligen Wert zwischen einem definierten Max- und Minwert.
Die Zufallszahl hat den Datentyp Real im spezifiziertem Wertebereich.

Baustein Schnittstelle

LGF_RandomRange_Real (FC)
Real  minValue Ret_Val  Real
    
Real  maxValue error  Bool
    
   status  Word
    
   subfunctionStatus  Word
    
   

Input Parameter

BezeichnerDatentypBeschreibung
minValueRealMinimalwert der für den Wertebereich der Zufallszahl - Untergrenze
maxValueRealMaximalwert der für den Wertebereich der Zufallszahl - Obergrenze

Output Parameter

BezeichnerDatentypBeschreibung
Ret_ValRealZufallszahl vom Datentyp Real im definierten Wertebereich
errorBoolFALSE: Kein Fehler
TRUE: Während der Ausführung des FB ist ein Fehler aufgetreten
statusWord16#0000-16#7FFF: Status des FB
16#8000-16#FFFF: Fehleridentifikation (siehe folgende Tabelle)
subfunctionStatusWordStatus oder Rückgabewert von aufgerufenen FB's / FC's und Systemfunktionen

Status & Error Meldungen

Code / WertBezeichner / Beschreibung
16#0000STATUS_FINISHED_NO_ERROR
Abarbeitung ohne Fehler beendet
16#8200ERR_MAX_LESS_MIN
Fehler: Der spezifizierte Wetebereich is fehlerhaft: `minValue` ist größer als `maxValue`
16#8600ERR_RD_SYS_T
Fehler in Anweisung `RD_SYS_T` - weitere infos in `subFunctionStatus`

Funktionsbeschreibung

Hinweis
In subFunctionStatus wird der Status von aufgerufenen Anweisungen ausgegeben. 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.

Der Baustein generiert zufällige Werte, die zwischen dem angegebenen minValue-Wert und maxValue-Wert liegen. Dieser zufällige Wert wird über den Ret_Val ausgegeben.

Der Zufallswert wird aus den Nanosekunden der aktuellen Systemzeit der CPU gebildet. Dabei wird die Bytereihenfolge dieses Wertes invertiert und anschließend in eine Gleitkommazahl ungewandelt.

Änderungshistorie

Version & DatumÄnderungsbeschreibung
01.00.00Siemens Industry Online Support
19.08.2015First released version
01.00.01Siemens Industry Online Support
02.01.2017Upgrade: TIA Portal V14 Update 1
01.00.02Siemens Industry Online Support
02.03.2017Bugfix: FC number
01.00.03Siemens Industry Online Support
17.08.2018Upgrade: TIA V15 Update 2
01.00.04Siemens Industry Online Support
23.11.2018Upgrade: TIA V15.1
01.01.00Simatic Systems Support
13.11.2019Renamed from "LGF_RandomReal" to "LGF_RandomRange_Real"
Regions, comments and constants are added
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
04.02.2021Insert documentation