Tm246tre 00-Eng PDF

t

rin
Structured Text (ST)

ep TM246
rr
t fo
no
t
rin
ep
rr
t fo

Requirements
Training modules: TM210 – The Basics of Automation Studio
TM211 – Automation Studio Online Communication
TM213 – Automation Runtime

no
TM223 – Automation Studio Diagnostics
Software: None
Hardware: None
2 TM246 Structured Text (ST)

Table of contents
1. INTRODUCTION 4
1.1 Objectives 5
t
2. STRUCTURED TEXT FEATURES 6
rin
2.1 General information 6
2.2 Properties 7
2.3 Possibilities 7
3. THE BASICS OF STRUCTURED TEXT 8

3.1 Expressions 8
ep
3.2 Assignment 8
3.3 Comments 9
3.4 Operator priorities 10
4. COMMAND GROUPS 12
4.1 Boolean operations 12
4.2 Arithmetic operations 14
rr
4.3 Comparison operators 18
4.4 Decisions 18
4.5 Case statements 27
4.6 Loops 30
t fo
4.7 Calling function blocks 36

4.8 Pointers and dynamic variables 39
5. SUMMARY 40
6. EXERCISES 41
7. APPENDIX 42
7.1 Keywords 42
no
7.2 Functions 43
7.3 Solutions 45
Structured Text (ST) TM246 3

Introduction
1. INTRODUCTION
Structured Text is a high level language. For those who are comfortable
programming in Basic, PASCAL or Ansi C, learning Structured Text is
simple. Structured Text (ST) has standard constructs that are easy to
understand, and is a fast and efficient way to program in the automation
t
industry.
rin
ep
rr
Fig. 1 Book printing: then and now
t fo
The following chapters will introduce you to the use of commands, key
words, and syntax in Structured Text. Simple examples will give you a
chance to use these functions and more easily understand them.
no

Introduction
1.1 Objectives
Participants will get to know the programming language Structured Text
(ST) for programming techincal applications.
t
You will learn the individual command groups and how they work together.
rin
You will get an overview of the reserved keywords in ST.
ep
rr
Fig. 2 Overview
t fo
no

Structured Text Features
2. STRUCTURED TEXT FEATURES
2.1 General information

ST is a text-based high-level language for programming automation
systems. Simple standard constructs enable fast and efficient
t
programming. ST uses many traditional qualities of high level languages,
including variables, operators, functions, and elements for controlling the
rin
program flow.
So, what is Structured Text? The "Structured" refers to the qualities of a

high level language that make structured programming possible. The "Text"
refers to the ability to use text in place of symbols, as in the ladder
diagram.
ep
No other programming language can replace ST. Every programming
language has its advantages and disadvantages. The main advantage of ST
is that complex mathematical calculations can be programmed easily.
rr
t fo
no

Structured Text Features
2.2 Properties
Structured Text is characterized by the following features:
• High-level text language
t
• Structured programming
• Easy to use standard constructs
rin
• Fast and efficient programming
• Self explanatory and flexible use
• Similar to PASCAL
• Easy to use for people with experience in PC programming
languages
• Conforms to the IEC 61131-3 standard
2.3 Possibilities
•
•
ep
Automation Studio supports the following functions:
• Digital and analog inputs and outputs

Logical operation
Logical comparison expressions
rr
• Arithmetic operations
• Decisions
• Step sequencers
• Loops
• Function blocks
• Optional use of dynamic variables
t fo
• Diagnostic tools
no

The Basics of Structured Text
3. THE BASICS OF STRUCTURED TEXT
3.1 Expressions
An expression is a construct that returns a value after it has been
evaluated. Expressions are composed of operators and operands. An
t
operand can be a constant, a variable, a function call or another
expression.
rin
Example: Expressions
3.2 Assignment
Fig. 3 Expressions
ep
The assignment of a value to a variable through a result of an expression or
rr
a value. The assignment consists of a variable on the left side, which is
designated to the result of a calculation on the right side by the assignment
operator ":=". All assignments must be closed with a semicolon ";".
Example: Assignment
t fo
Fig. 4 Assignment
When the code line has been processed, the value of variable "Var1" is
twice as big as the value of variable "Var2".
no

3.3 Comments
Comments are sometimes left out, but are nevertheless an important
component of the source code. They describe the code and make it more
easy to read. Comments make it possible for you or others to read a
t
program easily, even long after it was written. They are not compiled and
have no influence over the execution of the program. Comments must be
rin
placed between a pair of parenthesis and asterix "(*comment*)".
Example: Comment
Fig. 5 One-line comment
ep
Fig. 6 Multi-line comment
rr
t fo
no

3.4 Operator priorities

The use of several operators in one line brings up the question of priority
(order of execution). The execution is determined by priority.
t
Expressions are executed starting with the operator of highest priority,
followed by the next highest, and so on until the expression has been
rin
completely executed. Operators with the same priority are executed from
left to right as they appear in the expression.
Operator Symbol / Syntax:

Parentheses () Highest priority
Function call Call argument(s)
ep
Examples LN(A), MAX(X), etc.
Exponent **
Negation NOT
Multiplication *
Division /
Modulo division (whole MOD
rr
number remainder of
division)
Addition +
Subtraction -
Comparisons <, >, <=, >=
t fo
Equal to =
Not equal to <>
Boolean AND AND
Boolean exclusive OR XOR
Boolean OR OR Lowest priority

no

The order of execution at runtime:
Example: Operator priorities without parentheses
t
rin
Fig. 7 Order of execution
Multiplication is executed first, then addition, and finally subtraction.

The order of operations can be changed by putting higher priority
operations in parentheses. This is shown in the next example.
ep
Example: Operator priorities with parentheses
As shown in the following figure, the use of parentheses influences the

execution of the expression.
rr
Fig. 8 Order of execution
The expression is executed from left to right. The operations in

t fo
parentheses are executed first, then the multiplication, since the

parentheses have higher priority. You can see that the parentheses lead
to a different result.
no

Command Groups
4. COMMAND GROUPS
ST has the following command groups:
• Boolean operations
• Arithmetic operations
t
• Comparison operations
rin
• Decisions
• Case statements
4.1 Boolean operations

The operands must not necessarily be the data type BOOL.
Boolean operations:
Symbol
NOT
AND
OR
XOR
Binary negation
Logical AND
Logical OR
Exclusive OR
ep
Logical operation Examples
a := NOT b;
a := b AND c;
a := b OR c;
a := b XOR c;
rr
Truth table:
Input AND OR XOR

0 0 0 0 0
t fo
0 1 0 1 1
1 0 0 1 1
1 1 1 1 0
These operators can be used to formulate logical expressions, or they can

be used to represent conditions. The result is always TRUE (logical 1) or
FALSE (logical 0).
no

Command Groups
Example: Boolean operation
t
rin
Fig. 9 AND operation
Fig. 10 Source code for AND operation
ST allows any number of parenthesis.
Task: Light control ep

The output "DoLight" should be ON when the button "BtnLigntOn" is
rr
pressed. It should remain ON until the button "BtnLightOff" is pressed.
Create a solution for this task using boolean operations.

t fo
Fig. 12 Light control

no

Command Groups
4.2 Arithmetic operations

A key factor in favor of using a high level language is the accessibility of
arithmetic operations.
t
4.2.1 Basic arithmetic operations
rin
ST provides basic arithmetic operations for your operation:
Symbol Arithmetic operation Example

:= Assignment a := b;
+ Addition a := b + c;
- Subtraction a := b - c;
ep
* Multiplication a := b * c;
/ Division a := b / c;
MOD Modulo (display division a := b mod c;
remainder)
The data type is a very important factor. Note the following table:
Syntax Data types Result

rr
Res Op 1 Op 2
Res := 8 / 3; INT INT INT 2
Res := 8 / 3; REAL INT INT 2.0
Res := 8.0 / 3; REAL REAL INT 2.6667
Res := 8.0 / 3; INT REAL INT Error
t fo
* Compiler error message: Type mismatch: Cannot convert REAL to INT.
You can see the that the result is dependent of the syntax as well as the
data types used.
Note:
Left data type := right data type;
no

Command Groups
4.2.2 Implicit data type conversion

This type of conversion is done by the compiler. It automatically converts
the smaller data types to the larger one used in the expression. If an
expression contains one or more operators with different data types, they
t
are all converted to the same data type before the expression is resolved.
rin
Data BOOL SINT INT DINT USINT UINT UDINT REAL
type
BOOL BOOL x x x x x x x
SINT x INT DINT USINT UINT UDINT REAL
INT x INT DINT INT UINT UDINT REAL
DINT x DINT DINT DINT DINT UDINT REAL
USINT
UINT
UDINT
REAL
x
x
USINT
UINT
UDINT
REAL
ep INT
UINT
UDINT
REAL
DINT
DINT
UDINT
REAL
UINT
UDINT
REAL
UINT
UDINT
REAL
UDINT
UDINT
REAL
REAL
REAL
REAL
rr
t fo
Fig. 13 Implicit data type conversion by the compiler
Example: Data conversion

no
Fig. 14 Implicit data type conversion
SINT_Var2 is converted to INT, then added, then assigned to the result

variable (INT_Result).

Command Groups
4.2.3 Explicit data type conversion

Explicit data type conversion is also known simply as type conversion or as
Typecast. As you already know, the expression should have the same data
type on both sides, but there is something else to remember.
t
rin
Example: Overflow?!
At first sight, everything looks OK. However, the sum (INT_Weight1 +

INT_Weight2) can be larger than can be stored as data type INT. In this
case, an explicit data type conversion must be carried out.
ep
Example: Overflow taken into consideration.
The variable DINT_TotalWeight must be the data type DINT. At least one
rr
variable on the right side of the expression must be converted to the data
type DINT. The conversions functions are found in the OPERATOR library.
t fo
no

Command Groups
Task: Aquarium
t
The temperature of an aquarium is measured at two different places. Create a
program that calculates the average temperature and displays it at an analog
rin
output.
Don't forget that analog inputs and outputs must be data type INT.
ep
rr
t fo
Fig. 15 Aquarium
no

Command Groups
4.3 Comparison operators

In high level languages like ST, simple constructs can be used to compare
variables. These return either the value TRUE or FALSE.
t
Symbol Logical comparison Example
expression
rin
= Equal to IF a = b THEN
<> Not equal to IF a <> b THEN
> Greater than IF a > b THEN
>= Greater than or equal to IF a >= b THEN
< Less than IF a < b THEN
<= Less than or equal to IF a <= b THEN
Note:
ep
The comparison operations and logical operations are mainly used as
logical conditions for IF, ELSEIF, WHILE and UNTIL statements.
( IF (a > b) AND (d >= e) THEN )
rr
4.4 Decisions
The IF statement is used to create decisions in the program. You are
already familiar with the comparison operators, and they can be used here.
t fo
There are several types of IF statements:
• Simple IF statement
• IF – ELSE statement
• IF – ELSIF statement
• Nested IF
Decision Syntax Description

no
IF THEN IF a > b THEN 1. Comparison

Result := 1; 1. Statement(s)
ELSIF THEN ELSIF a > c THEN 2. Comparison (optional)
ELSE ELSE Above IF statments are not TRUE (optional)
END_IF END_IF End of decision

Command Groups
4.4.1 IF
This is the most simple IF statment.
t
rin
ep
Fig. 16 Simple IF statement
Fig. 17 Simple IF statement in a program
The IF statement is tested for the result TRUE. If the result is FALSE, the
rr
program advances to the line after the END_IF statement. The function of
the IF statement can be a single comparison, but it can also be multiple
comparisons connected by AND, OR, etc..
t fo
Example: IF statement with multiple comparisons
Fig. 18 Statement with multiple comparisons

no

Command Groups
4.4.2 ELSE
The ELSE statement is an extension of the simple IF statement. Only one
ELSE statment can be used per IF statement.
t
rin
Fig. 19 IF – ELSE statment
ep Fig. 20 IF – ELSE in a program
rr
If the IF meets condition A, then the A instruction(s) are executed. If the IF
does not meet condition A, then the B instruction(s) are executed.
t fo
no

Command Groups
4.4.3 ELSIF
One or more ELSE_IF statements allow you to test a number of conditions
without creating a confusing software structure with many simple IF
statements.
t
rin
ep
rr
t fo
Fig. 21 IF-ELSIF-ELSE statement

no
Fig. 22 IF-ELSIF-ELSE in a program
At runtime the decisions are processed from top to bottom. If the result of
a decision is TRUE, the corresponding statements are executed. Then the
program continues from after the END_IF. Only those decisions that

Command Groups
correspond to the first TRUE decision are executed, even if subsequent

decisions are also TRUE. If none of the IF or ELSE_IF decisions is TRUE, the
statement in the ELSE branch is executed.
Task: Weather station - Part I
t
rin
A temperature sensor measures the outside temperature. The
temperature is read via an analog input (1°=10), and should be
displayed inside the house in text form.
• If the temperature is under 18°C, the display should read "Cold".
• If the temperature is between 18°C and 25°C, the display should
read "Opt".
•
ep
If the temperature is over 25°C, the display should read "Hot".
Create a solution using IF, ELSEIF, and ELSE statements.

rr
t fo
Fig. 23 Thermometer
no
Note:
In ST, text is assigned to a string variable as follows:

StringVar := ’COLD’

Command Groups
4.4.4 Nested IF statement

A nested IF statement is tested only if previous condidions have been met.
Every IF requires its own END_IF so that the order of conditions is correct.
t
rin
ep
rr
Fig. 25 Nested IF statement in a program
Fig. 24 Nested IF statement

t fo
It is helpful to indent every nested IF statement and the corresponding

expressions. As many IF statments can be nested as needed. It is possible,
however, that the compiler will run out of memory after the 40th level. Also,
that kind of extensive nesting is evidence of poor programming style. It
becomes nearly impossible to get a clear overview of the code.
After three nesting levels, it is better to find another way to structure the
program.
no

Command Groups
Task: Weather station - Part II
Evaluate the temperature and the humidity.

The text "OPT" should only appear when the humidity is between 40 and
t
75% and the temperature is between 18 and 25°C. Otherwise "Temp.
OK" should be displayed.
rin
Solve this task using a nested IF statement.
ep
rr
t fo
no

Command Groups
Two simple IF statements produce nearly the same effect as one nested IF
statement. A marker variable, or flag, can be requested in multiple
statements. The first IF statment describes the flag, which is then utilized
by other IF statements.
t
rin
ep
rr
Fig. 27 Two IF statements
t fo
Fig. 26 Two IF statements
In this case, both IF statements have the same priority. If both IF

statements evaluate the same variable for different values, you should use
no
a CASE statement.
The CASE statement should be used when:
• IF constructs require too many levels

• Too many ELSE_IF statments are used
The CASE statement is much easier to read in these cases.

Command Groups
In comparison to the IF statment, the CASE statment also has the

advantage that comparisons are only made once, which makes the
program code more effective.
t
rin
ep
rr
t fo
no

Command Groups
4.5 Case statements

The CASE statement compares a step variable with multiple values. If one
of these comparisons is a match, the steps that compare to that step are
executed. If none of the comparisons is a match, there is an ELSE branch
t
similar to an IF statement that is then executed.
rin
After the statements have been executed, the program continues from after
the END_CASE statement.
Keywords Syntax Description

CASE OF CASE step variable OF Beginning of CASE
1,5: Display := MATERIAL For 1 and 5
2: Display := TEMP For 2
END_CASE END_CASE
ep
3,4,6..10: Display := OPERATION For 3,4,6,7,8,9,10
End of CASE
rr
t fo
no
Fig. 28 CASE statement

Command Groups
Only one step of the CASE statement is processed per program cycle.
t
rin
ep
Fig. 29 CASE statement in a program
rr
Note:
Constants can be used instead of numbers for the steps in a CASE

statement. This makes the program much easier to read.
t fo
Syntax of the CASE statement:
• A CASE statement begins with CASE and is terminated with

END_CASE. Each of these key words must occupy its own line.
• The variable between CASE and OF must be a UINT variable.
• Only whole number numerical expressions can be used for the
definition of the individual steps in the CASE statement.
no
• The ranges and values of the step variable(s) may not overlap each
other.

Command Groups
Task: Brewing tank
The fill level of a brewing tank is monitored for low, ok, and high levels.
t
Use an output for each of the low, ok, and high levels.
rin
The level of liquid in the tank is read as an analog value and is internally
converted to 0-100%. If the contents sink below 1%, a warning tone
should be triggered.
Create a solution using the CASE statement.
ep
rr
t fo
no
Fig. 30 Brewing tank

Command Groups
4.6 Loops
In many applications, it is necessary for sections of code to be executed
multiple times during a cycle. This type of processing is also referred to as
a loop. The code in the loop is executed until a defined termination
t
condition is met.
rin
Loops help make programs shorter and easier to follow. Program
expandability is also an issue here. Loops can be nested.
Depending on the structure of a program, it is possible for an error in the

program to cause the processing gets stuck repeating the loop until the
time monitor in the central unit responds with an error.
To prevent such endless loops from occuring, one should almost always
include in the programming a way for the loop to be aborted after a
•
Limited
• FOR
Unlimited
ep
defined number of repetitions or to run to a certain limit.
ST offers several types of loops to choose from:
•
rr
• WHILE
• REPEAT
t fo
no

Command Groups
4.6.1 FOR
The FOR statement is used to run a program section for a limited number
of repetitions. For all other applications, WHILE or REPEAT loops are used.
t
Key words Syntax Description
FOR TO BY DO FOR i:=StartVal TO StopVal {BY Step} DO The section in {}
rin
is optional.
Res := value + 1; Loop body
statement(s)
END_FOR END_FOR End of FOR
ep Fig. 1 FOR statement in a program

rr
The statements in the FOR loop are
repeated. At every repetition, the loop
counter is raised by "StepVal". The
two control variables "StartVal" and
"EndVal" determine the start value and
end value of the loop counter. After
t fo
the end value is reached, the program

continues from after the END_FOR
statement. The control variables must
both be the same data type and
cannot be described by any of the
statements in the loop body.
no
Fig. 31 FOR statement
The FOR statement raises or lowers the loop counter until it reaches the
end value. The step size is always 1, unless otherwise specified with "BY".
The termination condition, the loop counter, is evaluated with every

repetition of the loop.

Command Groups
Task: Crane
5 separate loads are suspended from a crane. In order to determine the

total load, you have to add the individual loads together.
t
rin
Fig. 32 Crane
ep
Create a solution for this task using a FOR loop.
rr
t fo
no

Command Groups
4.6.2 WHILE
The WHILE loop can be used in the same way as the FOR loop, except that
the condition can be any boolean expression. If the condition is met, then
the loop is executed. The WHILE loop is used to repeat statements as long
t
as a particular condition remains TRUE.
rin
WHILE DO WHILE i<4 DO Boolean condition
Res := value + 1; Statement
i := i + 1; Statement
END_ WHILE END_ WHILE End of WHILE
ep
rr
t fo
Fig. 2 WHILE statement in a program
Fig. 33 WHILE statement
The instructions are executed repeatedly for as long as the condition

returns TRUE. If the condition returns FALSE during the first evaluation, the
no
instructions are never executed.
Note:
If the condition never assumes the value FALSE, the statements are
repeated endlessly, resulting in a runtime error.

Command Groups
4.6.3 REPEAT
The REPEAT loop differs from the WHILE loop in that the termination
condition is only checked once the loop has been executed. This means
that the loop runs at least once, regardless of the termination condition.
t
rin
REPEAT REPEAT Start loop
Res := value + 1; Statement
i := i + 1; Statement
UNTIL UNTIL i > 4 Termination condition
END_ REPEAT END_ REPEAT End loop
ep
rr
t fo
Fig. 35 REPEAT statement in a program
Fig. 34 REPEAT statement
The statements are executed repeatedly until the UNTIL condition is TRUE.
no
If the UNTIL condition is true from the beginning, the statements are only
executed once.
Note:
If the UNTIL condition never assumes the value TRUE, the statements
are repeated endlessly, resulting in a runtime error.

Command Groups
4.6.4 EXIT
The EXIT statement can be used with all types of loops before their
termination condition occurs.
t
rin
Fig. 36 EXIT statement
ep Fig. 37 EXIT statement in a program
rr
t fo
Fig. 39 EXIT statement in a nested FOR statement in a

program
no
If the EXIT statement is used in a nested

loop, only the loop in which the EXIT
statement is located is ended. After the
loop is ended, the program continues
from after the END_ statement.
Fig. 38 EXIT statement in a nested FOR
statment

Command Groups
4.7 Calling function blocks

In ST, a function block is called a function block instance, and the
necessary transfer parameters are placed in parentheses.
t
rin
Fig. 40 Calling a function block
ep
Fig. 41 Calling a function block in a program
rr
Before a function block is called, one must describe the variables that are
to be used as input parameters. The code for calling a function block
occupies one line. Then the outputs of the function block can be read.
t fo
no

Command Groups
Function block call in detail:
t
rin
Fig. 42 Detail view of a function block call
ep
First the function block name is entered, then the transfer parameters are
assigned in parentheses, separated by commas. The code for calling a
function block is closed with a semicolon.
rr
t fo
no

Command Groups
Task: Bottle counter
Create a program that counts the bottles on a conveyor belt. Use the CTU
(up counter) function block found in the STANDARD library.
t
rin
Fig. 43 Bottle counter
Note:
ep
The Automation Studio online help comes in handy when working with
rr
function blocks.
t fo
no

Command Groups
4.8 Pointers and dynamic variables

B&R offers the option of using pointers in ST.
A dynamic variable can be assigned a memory address during runtime.
t
This procedure is referred to as the referencing or initialization of a
dynamic variable.
rin
As soon as the dynamic variable is initialized, it can be used to access the
memory content to which it now "points".
ep
Fig. 44 Referencing a dynamic variable
As you can see, the operator ADR() is used. It returns the memory address
of the variable in parentheses. The data type of this address is UDINT. The
statement is then closed with a semicolon.
rr
t fo
no

Summary
5. SUMMARY
Structured Text is a high level language that offers a wide range of
functionality. It contains all the tools necessary for an application.
t
rin
ep
rr
Fig. 45 Book printing: then and now
After completing this training module, you are ready to program your own
t fo
ST tasks. You can always use the module as a reference.

This programming language is especially powerful when using arithmetic
functions and formulating mathematical calculations.
no

Exercises
6. EXERCISES
Task: Box lift
t
Two conveyor belts (doConvTop, doConvBottom) transport boxes to a
lift.
rin
If the photocell is (diConvTop, diConvBottom) is activated, the
corresponding conveyor belt is stopped and the lift is called.
If the lift has not been called, it returns to the appropriate position
(doLiftTop, doLiftBottom).
When the lift is in the correct position (diLiftTop, diLiftBottom), the lift
ep
conveyer belt (doConvLift) is turned on until the box is completely on
the lift (diBoxLift).
Then the lift moves to the unloading position (doLiftUnload). When it

reaches this position (diLiftUnload), the box is moved to the unloading
belt.
As soon as the box has left the lift, the lift is free for the next request.
rr
t fo
Fig. 46 Box lift

no

Appendix
7. APPENDIX
7.1 Keywords
Key words are commands that can be used in ST. In the Automation Studio
Editor, these are displayed in blue. You are already familiar with many of
t
them; here is a list of more. Key words may not be used as variable names.
rin
Keyword Description
ACCESS Assignment of an address to a dynamic variable.
BIT_CLR A := BIT_CLR(IN, POS) A is the value of the variable IN that
results when the bit at position POS is deleted. IN remains
unchanged.
BIT_SET A := BIT_CLR(IN, POS) A is the value of the variable IN that
ep
results when the bit at position POS is set. The IN operand
remains unchanged.
BIT_TST Determination of a bit within a value. A is the state of the bit of
the IN value that is at position POS.
BY See FOR statement.
CASE See CASE statement.
DO See WHILE statement.
rr
EDGE Determines the negative and positive edges of a bit.
EDGENEG Determines the negative edge of a bit.
EDGEPOS Determines the positive edge of a bit.
ELSE See IF statement.
ELSIF See IF statement.
t fo
END_CASE See CASE statement.

END_FOR See FOR statement.
END_IF See IF statement.
END_REPEAT See REPEAT statement.
END_WHILE See WHILE statement.
EXIT See EXIT statement.
FOR See FOR statement.
no
IF See IF statement.
REPEAT See REPEAT statement.
RETURN Can be used to end a function.
THEN See IF statement.
TO See FOR statement.
UNTIL See REPEAT statement.
WHILE See WHILE statement.

Appendix
7.2 Functions
There are some functions that can be used in ST that do not require you to
insert a library into the project. In the Automation Studio Editor, these
function calls are displayed in blue. You are already familiar with some of
them. More are listed here.
t
Function Example
rin
ABS Returns the absolute value of a number. ABS(-2) returns 2.
ACOS Returns the cosine of a number. (inverted cosine function).
ADR Returns a variable's address.
AND Logical AND for bit operations.
ASIN Returns the arc sine of a number (inverse function of sine).
ASR
ATAN
COS
EXP
EXPT
ep
Arithmetic shifting of an operand to the right: A := ASR (IN, N) IN is
shifted N bits to the right, the left is filled with the sign bit.
Returns the arc tangent of a number (inverse function of tangent).
Returns the cosine of a number.
Exponential function: A := EXP (IN).
One operand raised to the power of another operand:
A := EXPT (IN1, IN2).
rr
LIMIT Limitation: A = LIMIT (MIN, IN, MAX) MIN is the lower limit, MAX is
the upper limit for the result. If IN is less than MIN, then the MIN
result is returned. If IN is greater than MAX, then the MAX result is
returned. Otherwise, the IN result is returned.
LN Returns the natural logarithm of a number.
LOG Returns the base-10 logarithm of a number.
t fo
MAX Maximum function. Returns the larger of two values.

MIN Minimum function. Returns the lesser of two values.
MOD Modulo division of a USINT, SINT, INT, UINT, UDINT, DINT type
variable by another variable of one of these types.
MOVE The contents of the input variable are copied to the output variable.
The := symbol is used as the assignment operator.
"A := B;" is the same as "A := MOVE (B);"

no
MUX Selection: A = MUX (CHOICE, IN1, IN2, ... INX);

CHOICE specifies which of the operators IN1, IN2, ... INX is returned
as a result.
NOT Negation of a bit operand by bit.
OR Logical OR operation by bit.
ROL Rotates an operand's bits to the left: A := ROL(IN, N); The bits in IN
are shifted N times to the left, the far left bit being pushed in again
from the right.

Appendix
ROR Rotates an operand's bits to the right: A := ROR (IN, N); The bits in
IN are shifted N times to the right, the far right bit being pushed in
again from the left.
SEL Binary selection: A := SEL (CHOICE, IN1, IN2) CHOICE must be type
BOOL. If CHOICE is FALSE, then IN1 is returned. Otherwise, IN2 is
t
returned.
SHL Shifts an operand's bits to the left: A := SHL (IN, N); IN is shifted N
rin
bits to the left, the right side is filled with zeroes.
SHR Shifts an operand's bits to the right: A := SHR (IN, N); IN is shifted N
bits to the right, the left side is filled with zeroes.
SIN Returns the sine of a number.
sizeof This function returns the number of bytes required by the specified
variable.
SQRT Returns the square root of a number.
TAN
TRUNC
XOR
ep
Returns the tangent of a number.
Returns the integer part of a number.
Logical EXCLUSIVE OR operation by bit.
rr
t fo
no

Appendix
7.3 Solutions
Task: Light control
t
rin
Task: Aquarium
Task: Weather station - Part I
ep
rr
Task: Weather station - Part II
t fo
no

Appendix
Task: Brewing tank
t
rin
ep
rr
Task: Crane
t fo
Task: Bottle counter

no

Appendix
Task: Box lift
t
rin
ep
rr
t fo
no

Appendix
Notes
t
rin
ep
rr
t fo
no

Appendix
t
rin
ep
rr
Overview of training modules
TM210 – The Basics of Automation Studio TM600 – The Basics of Visualization

TM211 – Automation Studio Online Communication TM610 – The Basics of ASiV
t fo
TM213 – Automation Runtime TM630 – Visualization Programming Guide

TM220 – The Service Technician on the Job TM640 – ASiV Alarm System, Trend and Diagnostic
TM223 – Automation Studio Diagnostics TM670 – ASiV Advanced
TM230 – Structured Software Generation
TM240 – Ladder Diagram (LAD) TM700 – Automation Net PVI
TM241 – Function Block Diagram (FBD) TM710 – PVI Communication
TM246 – Structured Text (ST) TM711 – PVI DLL Programming
TM250 – Memory Management and Data Storage TM712 – PVIServices
TM261 – Closed Loop Control with LOOPCONR TM730 – PVI OPC
TM400 – The Basics of Motion Control TM800 – APROL System Concept

TM410 – The Basics of ASiM TM810 – APROL Setup, Configuration and Recovery
TM440 – ASiM Basic Functions TM811 – APROL Runtime System
no
TM441 – ASiM Multi-Axis Functions TM812 – APROL Operator Management

TM445 – ACOPOS ACP10 Software TM813 – APROL XML Queries and Audit Trail
TM446 – ACOPOS Smart Process Technology TM830 – APROL Project Engineering
TM450 – ACOPOS Control Concept and Adjustment TM840 – APROL Parameter Management and Recipes
TM460 – Starting up Motors TM850 – APROL Controller Configuration and INA
TM480 – Hydraulic Drive Control TM860 – APROL Library Engineering
TM865 – APROL Library Guide Book
TM500 – The Basics of Integrated Safety Technology TM870 – APROL Python Programming
TM510 – ASiST SafeDESIGNER TM890 – The Basics of LINUX
TM540 – ASiST SafeMC

50
Appendix
TM246
Weblink
Internationality
no
Structured Text (ST)

Copyright – Model Number
t fo
rr
ep
rin
t
TM246TRE.00-ENG 0907
©2007 by B&R. All rights reserved.
All trademarks presented are the property of their respective company.
We reserve the right to make technical changes.

Tm246tre 00-Eng PDF

Uploaded by

Copyright:

Available Formats

Tm246tre 00-Eng PDF

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Tm246tre 00-Eng PDF

Uploaded by

Copyright:

Available Formats

What are the main features of Structured Text?

What are the main features of Structured Text?

What are the basic elements of Structured Text?

What are the basic elements of Structured Text?

t

Training modules: TM210 – The Basics of Automation Studio

TM211 – Automation Studio Online Communication

TM213 – Automation Runtime

TM223 – Automation Studio Diagnostics

2 TM246 Structured Text (ST)

3. THE BASICS OF STRUCTURED TEXT 8

4.7 Calling function blocks 36

Structured Text (ST) TM246 3

4 TM246 Structured Text (ST)

Structured Text (ST) TM246 5

2. STRUCTURED TEXT FEATURES

2.1 General information

So, what is Structured Text? The "Structured" refers to the qualities of a

6 TM246 Structured Text (ST)

• High-level text language

• Digital and analog inputs and outputs

Structured Text (ST) TM246 7

3. THE BASICS OF STRUCTURED TEXT

8 TM246 Structured Text (ST)

Fig. 5 One-line comment

Structured Text (ST) TM246 9

3.4 Operator priorities

Operator Symbol / Syntax:

Function call Call argument(s)

Boolean exclusive OR XOR

Boolean OR OR Lowest priority

10 TM246 Structured Text (ST)

The order of execution at runtime:

Example: Operator priorities without parentheses

Multiplication is executed first, then addition, and finally subtraction.

As shown in the following figure, the use of parentheses influences the

The expression is executed from left to right. The operations in

parentheses are executed first, then the multiplication, since the

Structured Text (ST) TM246 11

4.1 Boolean operations

Input AND OR XOR

These operators can be used to formulate logical expressions, or they can

12 TM246 Structured Text (ST)

Example: Boolean operation

Fig. 10 Source code for AND operation

ST allows any number of parenthesis.

Task: Light control ep

Create a solution for this task using boolean operations.

Fig. 12 Light control

Structured Text (ST) TM246 13

4.2 Arithmetic operations

Symbol Arithmetic operation Example

Syntax Data types Result

* Compiler error message: Type mismatch: Cannot convert REAL to INT.

14 TM246 Structured Text (ST)

4.2.2 Implicit data type conversion

SINT x INT DINT USINT UINT UDINT REAL

INT x INT DINT INT UINT UDINT REAL

DINT x DINT DINT DINT DINT UDINT REAL