LGF_Random_UDInt (FC / V3.0.1)


Autor: Siemens Digital Industries

Kurzbeschreibung

Diese Funktion generiert bei jedem Aufruf einen zufälligen Wert.
Die Zufallszahl hat den Datentyp UDInt.

Baustein Schnittstelle

LGF_Random_UDInt (FC)
   Ret_Val  UDInt
    
   error  Bool
    
   status  Word
    
   subfunctionStatus  Word
    
   

Output Parameter

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

Die Funktion generiert zufällige Werte im Bereich:
0 ≤ ReturnVal ≤ 4294967295.

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

Änderungshistorie

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