LGF_Random_Real (FC / V3.0.1)


Author: Siemens Digital Industries

Short description

This function generates a random value with each call.
The random number has the data type Real in the range from 0.0 to 1.0.

Block Interface

LGF_Random_Real (FC)
   Ret_Val  Real
    
   error  Bool
    
   status  Word
    
   subfunctionStatus  Word
    
   

Output parameter

IdentifierData typeDescription
Ret_ValRealRandom Real number between 0.0 and 1.0
errorBoolFALSE: No error
TRUE: An error occurred during the execution of the FB
statusWord16#0000-16#7FFF: Status of the FB
16#8000-16#FFFF: Error identification (see following Table)
subfunctionStatusWordStatus or return value of called FB's, FC's and system blocks

Status & Error codes

Code / ValueIdentifier / Description
16#0000STATUS_FINISHED_NO_ERROR
Execution finished without errors
16#8600ERR_RD_SYS_T
Error in `RD_SYS_T` command - check `subFunctionStatus` code

Functional description

Note
The status of called commands is output in subFunctionStatus. In this case, the output value in status indicates which command caused the error. In this case, refer to the TIA Portal Online Help section for information on the respective commands.

The function generates random values in the range:
0.0 ≤ ReturnVal ≤ 1.0.

The random value is formed from the nanoseconds of the current system time of the CPU. The byte order of this value is inverted and then converted to a floating point.

Change log

Version & DateChange description
01.00.00Siemens Industry Online Support
27.01.2017First released version
01.00.01Siemens Industry Online Support
17.08.2018Upgrade: TIA V15 Update 2
01.00.02Siemens Industry Online Support
23.11.2018Upgrade: TIA V15.1
01.01.00Simatic Systems Support
13.11.2019Renamed from "LGF_RandomBasic" to "LGF_Random_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