Util Library Documentation ¶ Company System Title Util Version 3.5.19.0 Categories Application|Common Author 3S - Smart Software Solutions GmbH Placeholder Util Description 1 ¶ Provides data types for generator modes and points. And provides function blocks and functions for the following use cases: Analog monitors, BCD conversions, bit/byte functions, controller, function manipulators, mathematical functions and signals. In the folder TimerSwitch the types, functions and function blocks are located for handling UTC and local time and the implementation of a timer switch. Contents: ¶ Analog Monitors HYSTERESIS (FunctionBlock) LIMITALARM (FunctionBlock) BCD Conversions BCD_TO_BYTE (Function) BCD_TO_DWORD (Function) BCD_TO_INT (Function) BCD_TO_WORD (Function) BYTE_TO_BCD (Function) DWORD_TO_BCD (Function) INT_TO_BCD (Function) WORD_TO_BCD (Function) Bit/Byte Functions BIT_AS_BYTE (FunctionBlock) BIT_AS_DWORD (FunctionBlock) BIT_AS_WORD (FunctionBlock) BYTE_AS_BIT (FunctionBlock) DWORD_AS_BIT (FunctionBlock) EXTRACT (Function) GETBIT (Function) PACK (Function) PUTBIT (Function) SETBIT (Function) SWITCHBIT (Function) UNPACK (FunctionBlock) WORD_AS_BIT (FunctionBlock) Constants TextBlockSize (ParamList) Controller PD (FunctionBlock) PID (FB) Temperature control with PID and LIMIT PID_FIXCYCLE (FunctionBlock) Datatypes GEN_MODE (Enum) POINT (Struct) PT_SIZE (Struct) Encoding BASE64 (Function) Function Manipulators CHARCURVE (FunctionBlock) RAMP_INT (FunctionBlock) RAMP_REAL (FunctionBlock) Gray Conversions BYTE_TO_GRAY (Function) DWORD_TO_GRAY (Function) GRAY_TO_BYTE (Function) GRAY_TO_DWORD (Function) GRAY_TO_WORD (Function) WORD_TO_GRAY (Function) HEX/ASCII Functions BYTE_TO_HEXinASCII (Function) HEXinASCII_TO_BYTE (Function) WORD_AS_STRING (Function) Library Information GetLibVersion (Function) GetLibVersionNumber (Function) IsLibReleased (Function) Mathematical Functions DERIVATIVE (FunctionBlock) INTEGRAL (FunctionBlock) LIN_TRAFO (FunctionBlock) ROTATION_DIFFERENCE (FunctionBlock) STATISTICS_INT (FunctionBlock) STATISTICS_REAL (FunctionBlock) VARIANCE (FunctionBlock) Signals BLINK (FunctionBlock) FREQ_MEASURE (FunctionBlock) GEN (FunctionBlock) TimerSwitch Enums FunctionBlocks Functions GlobalConstants Interfaces Structs Types Indices and tables ¶ 1 Based on Util.library, last modified 02.03.2023, 10:46:37. LibDoc 4.4.0.0-b.27 The content file Util.clean.json was generated with CODESYS V3.5 SP16 Patch 3 on 02.03.2023, 10:46:40.

HYSTERESIS (FB) ¶ FUNCTION_BLOCK HYSTERESIS Realizes a hysteresis function InOut: Scope Name Type Comment Input IN INT Input value HIGH INT Upper limit LOW INT Lower limit Output OUT BOOL TRUE : Input IN is less than input LOW FALSE : Input IN is greater than input HIGH

Analog Monitors ¶ HYSTERESIS (FunctionBlock) LIMITALARM (FunctionBlock)

BCD Conversions ¶ A BYTE in the BCD format contains integers between 0 and 99. Four BITs are used for each decimal place. The ten decimal place is stored in the BITs 4-7. Thus the BCD format is similar to the hexadecimal presentation, with the simple difference that only values between 0 and 99 can be stored in a BCD BYTE, whereas a hexadecimal BYTE reaches from 0 to FF. Example: The integer 51 should be converted to BCD format: 5 in binary code is 0101, 1 in binary code is 0001, which makes the BYTE 01010001 in BCD code, which corresponds to the value $51=81. BCD_TO_BYTE (Function) BCD_TO_DWORD (Function) BCD_TO_INT (Function) BCD_TO_WORD (Function) BYTE_TO_BCD (Function) DWORD_TO_BCD (Function) INT_TO_BCD (Function) WORD_TO_BCD (Function)

LIMITALARM (FB) ¶ FUNCTION_BLOCK LIMITALARM Monitors if an input value is between a lower and a upper limit InOut: Scope Name Type Comment Input IN INT Input value HIGH INT Upper limit LOW INT Lower limit Output O BOOL TRUE : IN > HIGH FALSE : Else U BOOL TRUE : IN < LOW FALSE : Else IL BOOL TRUE : Neither O nor U are TRUE

BCD_TO_BYTE (FUN) ¶ FUNCTION BCD_TO_BYTE : BYTE Converts one byte in BCD code into one byte in binary code Use BYTE_TO_BCD for the reverse conversion. InOut: Scope Name Type Comment Return BCD_TO_BYTE BYTE Value in binary code for the input B Input B BYTE Value in BCD code

BCD_TO_DWORD (FUN) ¶ FUNCTION BCD_TO_DWORD : DWORD Converts one DWORD in BCD code into one DWORD in binary code Use DWORD_TO_BCD for the reverse conversion. InOut: Scope Name Type Comment Return BCD_TO_DWORD DWORD Value in binary code for the input X Input X DWORD Value in BCD code

BCD_TO_INT (FUN) ¶ FUNCTION BCD_TO_INT : INT Converts one byte in BCD format into an INT value Example in ST: i := BCD_TO_INT ( 73 ); (* Result is 49 *) k := BCD_TO_INT ( 151 ); (* Result is 97 *) l := BCD_TO_INT ( 15 ); (* Output -1, because it is not in BCD format *) InOut: Scope Name Type Comment Return BCD_TO_INT INT Value as INT for the input B Input B BYTE Value in BCD code. If the value is not in the BCD format, then the output is -1.

BCD_TO_WORD (FUN) ¶ FUNCTION BCD_TO_WORD : WORD Converts one WORD in BCD code into one WORD in binary code Use WORD_TO_BCD for the reverse conversion. InOut: Scope Name Type Comment Return BCD_TO_WORD WORD Value in binary code for the input W Input W WORD Value in BCD code

BYTE_TO_BCD (FUN) ¶ FUNCTION BYTE_TO_BCD : BYTE Converts one byte in binary code in the range of 0..99 into one byte in BCD code Use BCD_TO_BYTE for the reverse conversion. InOut: Scope Name Type Comment Return BYTE_TO_BCD BYTE Value in BCD code for the input B Input B BYTE Value in binary code