Telecontrol formula editor

1

Nodes for the formula

List of available nodes.

2

Input slot

Connection point on a node that receives data from another node's output. An input slot can only have one connection at a time.

3

Output slot

Connection point that sends data to the inputs of one or more nodes. An output slot can have multiple connections at a time.

4

Connection

Connection between two nodes.

Input value

Value of a configured value point in the formula

• Last changed

• Metadata: additional information for the formula simulation, e.g. Last changed.

Selection:

• Value point: select the required input value point

• Value

Output value

Submit a (calculated) value to an output value point

• Metadata: additional information for the formula simulation, e.g. Last changed

Slot:

• Value

Selection:

• Value point: Select the required output value point

IEC return value

Submit (calculated) values to the grid operator.

Slots:

• Value

• Timestamp

Quality bits (COT):

• Negative Confirmation

• Blocked

• Replaced

• Outdated

• Invalid

• Overflow

• Elapsed

• Adjusted

• Carry

• Transient

• Elapsed time

IEC command

Receive a command from the grid operator to perform an action on-site.

Examples:

• P/Q setpoint

• Switch commands

• Value

• Value (bit 1)

• Value (bit 2)

• COT

• Timestamp

• Command Qualifier

• Select/Execute

IEC command output

Return quality bit information via IEC for command telegrams

Slots:

• Negative Confirmation

• Blocked

• Replaced

• Outdated

• Invalid

• Overflow

• Elapsed

• Adjusted

• Carry

Display calculated values

Watch and display multiple (calculated) values at once to test the formula. Simulation mode only.

Slot:

• Connect to a value to read and display data

Scale value range

Scales an input value from a defined source range to a corresponding value in a target range, e.g. to calculate an alternative output or a percentage.

• Input min

• Input max

• Output min

• Output max

Slot:

• Value (input)

• Scaled value

Time

Current time for time-dependent functionality of the formula.

• Time (ms)

• Time (s)

Constant number

Constant numeric value.

Selection:

• Value (number)

• Value

Constant boolean

Constant boolean value.

Selection:

• Value (boolean)

• True

• False

Constant string

Constant string value.

Selection:

• Value (string)

• Value

Length of value

Returns the length of strings.

Slot:

• Input

• Output

Convert to number

Converts any input value to a numeric type

Slot:

• Input

• Output

Random value

Generates random numbers within a specified range.

• min (default 0)

• max (default 1)

• Output: random number between min and max

Clamp value

Restricts a value to be within a specified range.

• min (default 0)

• max (default 1)

Slot:

• Input

• Output

Absolute value

Calculates the absolute value of the input.

Slot:

• Input

• Output

Round down

Rounds down to the nearest integer.

Slot:

• Input

• Output

Fractional part

Returns the fractional part of a number.

Slot:

• Input

• Output

Pass value

Selects between two inputs based on a boolean condition.

When the control signal is true, the node passes input A through. When false, it passes input B. Can be used e.g. for choosing between different data sources or control paths.

Slots:

• Input (boolean)

• Input A

• Input B

• Output

Math operation

Process two inputs using one of the following mathematical operations: +, -, *, /, % (modulo), ^, max, min.

When using this node, the OP (operation) must be defined.

• A (value 1 for simulation)

• B (value 2 for simulation)

• OP (Operation)

Slot:

• Input A

• Input B

• Result

Compare values

Compares two values and returns boolean results for different comparison operators.

Slots:

• Input A

• Input B

• Equal

• Not equal

Evaluate condition

Evaluates one of the following conditions between two values and returns true/false results: >, <, ==, !=, <=, >=, ||, && .

The output value of each slot is a boolean (true/false).

The output value needs to be converted to a number when used in output value points.

Slots:

• Input A

• Input B

Selection:

• Cond (>, <, ==, !=, <=, >=, ||, &&)

• True

• False

Branch by condition

Sends the input value to one of two outputs based on a condition.

Output:

• True: Returns the input value if the condition is true, otherwise null

• False: Returns the input value if the condition is false, otherwise null

Slots:

• Input

• Boolean condition

• Output

Convert to text

Converts any numbers or booleans to a string

• Input

• Output

Compare text

Compares two strings and returns boolean results for different comparison operators.

• Input A

• Input B

• Output

Join text

Joins two strings to form a single string

• Input A

• Input B

• Output

Text contains

Checks whether a string contains a character. The output is a boolean (true/false)

• Input A

• Input B

• Output

Uppercase text

Converts a string from lowercase to uppercase text.

• Input

• Output

Split text

Splits strings using a comma (,) separator.

The output is an array of values

• Text

• Separator

• Output

AND

Logical operator that returns true if all inputs are true.

• Input A

• Input B

• Output

OR

Logical operator that returns true if at least one input is true.

• Input A

• Input B

• Output

NOT

Logical operator that returns the logical negation of the input.

• Input

• Output

Compare booleans

Compares whether boolean values are equal.

• Input A

• Input B

• Output

1

Calculation of the bit value

Depends on numeric value:

2

Security mechanism

Use the Branch by condition node:

Condition: Parameter <ORT> is 0.

Result: Bit values for the switch command are only transferred if ORT = 0.

IEC command output node (optional): Some grid operators require a negative confirmation if no switch is performed.

3

Output values

Two possible output values. The output value depends on the result of the security mechanism.