LGF_RandomRange_UDInt (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 UDInt im spezifiziertem Wertebereich.

Baustein Schnittstelle

LGF_RandomRange_UDInt (FC)
UDInt  minValue Ret_Val  UDInt
    
UDInt  maxValue error  Bool
    
   status  Word
    
   subfunctionStatus  Word
    
   

Input Parameter

BezeichnerDatentypBeschreibung
minValueUDIntMinimalwert der für den Wertebereich der Zufallszahl - Untergrenze
maxValueUDIntMaximalwert der für den Wertebereich der Zufallszahl - Obergrenze

Output Parameter

BezeichnerDatentypBeschreibung
Ret_ValUDIntZufallszahl vom Datentyp UDInt 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 UDInt ungewandelt.

Änderungshistorie

Version & DatumÄnderungsbeschreibung
01.00.00Simatic Systems Support
11.12.2019First released version
copied from "LGF_RandomRange_DInt"
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