This function generates a random value in defined limits with each call.
The random number has the data type UDInt in the specified range.
LGF_RandomRange_UDInt (FC) | ||||||||
---|---|---|---|---|---|---|---|---|
UDInt | minValue | Ret_Val | UDInt | |||||
UDInt | maxValue | error | Bool | |||||
status | Word | |||||||
subfunctionStatus | Word | |||||||
Identifier | Data type | Description |
---|---|---|
minValue | UDInt | Minimum value of the range of the random number - lower border |
maxValue | UDInt | Maximum value of the range of the random number - upper border |
Identifier | Data type | Description |
---|---|---|
Ret_Val | UDInt | Random UDInt number in the predefined range |
error | Bool | FALSE: No error TRUE: An error occurred during the execution of the FB |
status | Word | 16#0000-16#7FFF: Status of the FB 16#8000-16#FFFF: Error identification (see following Table) |
subfunctionStatus | Word | Status or return value of called FB's, FC's and system blocks |
Code / Value | Identifier / Description |
---|---|
16#0000 | STATUS_FINISHED_NO_ERROR Execution finished without errors |
16#8200 | ERR_MAX_LESS_MIN Error: The ranges specified are wrong: `minValue` is greater than `maxValue` |
16#8600 | ERR_RD_SYS_T Error in `RD_SYS_T` command - check `subFunctionStatus` code |
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 block generates random values that are between the specified minValue
and the maxValue
. This random value is output via the Ret_Val
.
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 UDInt.
Version & Date | Change description | |
---|---|---|
01.00.00 | Simatic Systems Support | |
11.12.2019 | First released version copied from "LGF_RandomRange_DInt" | |
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 | |
04.02.2021 | Insert documentation |