Structured Text Tutorial
Structured Text Tutorial
Another advantage is that you can combine the different programming languages.
You can even have function blocks containing functions written in Structured Text.
But on the other hand, if you have never seen a high-level programming language,
Structured Text can be a great introduction to those languages and the syntax used.
Before you read this tutorial I recommend that you take a brief look at this PLC
program written in Structured Text. Try to see if you can understand the function of
this program. Does Structured Text look familiar to you?
PROGRAM stexample
VAR
x : BOOL;
END_VAR
x := TRUE;
REPEAT
x := FALSE;
UNTIL x := FALSE;
END_REPEAT;
END_PROGRAM;
The Flow of Structured Text
The first thing you should learn is the structure or the syntax of Structured Text. When
you understand the structure, you will understand how the flow of your program
works.
Starting with the example above, you can see that the whole program begins with
PROGRAM and ends with
END_PROGRAM . Everything in between is your PLC
program. These two words are the delimiting keywords for program declarations.
More on keywords later.
Don't be confused about the END_PROGRAM, because your program won't end
completely here. When the PLC reaches the END_PROGRAM thePLC scan cycle
will
start over again, and your program will repeat itself.
This is just like ladder logic or any other PLC programming language - it will run over
and over again. And if you are used to programming microcontrollers, the
PROGRAM/END_PROGRAM will be similar to the infinite loop in C.
One thing to add here is that, when you are programming in Structured Text, you will
often not use the PROGRAM/END_PROGRAM construct. It will already be done by the
PLC programming software, and the code you have to write, is what you want inside
that construct.
The flow control of PLC programs written in Structured Text is the same as in ladder
logic:
execute one line at a time
.
Starting with the Syntax of Structured Text
The
syntax of a programming language
is the definition of how it is written. To be
more precise, what symbols is used to give the language its form and meaning.
As you can see in the example, Structured Text is full of colons, semicolons and other
symbols. All these symbols has a meaning and is used to represent something. Some
of them are operators, some are functions, statements or variables.
All the details of the syntax will be explained as you move through this tutorial. But
there are some general rules for the syntax of Structured Text you should know
about.
You don't have to memorize all the syntax
rules for now, as you will when you get
your hands into the programming:
What's really important to understand here is that, when you write a PLC program in
Structured Text, your computer will translate that to a language the PLC can
understand.
When you upload the Structured Text PLC program to your PLC, the programming
software you use will
compile
your program. This means that it will translate the code
to a sort of
machine code
which can be executed by the PLC.
The compiler uses the syntax of the programming language to understand your
program.
For example: Each time the compiler sees a
semicolon , it will know that the
end of
the current statement is reached. The compiler will read everything until it reaches
a semicolon, and then execute that statement.
Comment Syntax
In textual programming languages you have the ability to write text that doesn't get
executed. This feature is used to make comments in your code.
Comments are good, and as a beginner you should always comment your code. It
makes it easier to understand your code later.
In Structured Text you can make either one line comments or multiple line comments.
Although this might be put on the edge, you should always write your code so it is as
easy as possible to understand. Even without comments. You start doing this by
simply making the code easy to read with spaces.
But for now, you should not worry about comments. Make as many as you want while
you are still a beginner.
Making Statements with Structured Text
So, Structured Text consists of
statements
. But what is statements?
You probably know statements as something coming from humans. You can make a
statement, a president or even a company can make a statement. And in PLC
programming, statements are almost the same.
A
statement
is you telling the PLC what to do.
X : BOOL;
In
this
statement you are telling the PLC to
create a variable
called
X
and that
variable should be a
BOOL type.
Using Variables in Structured Text
Before we dig deeper into the statement, let me get back to the keywords i mentioned
before. As you can see, the variable X is defined in between two other keywords -
VAR
and
END_VAR .
All the four are called keywords, because they are reserved words. You can't use those
words for anything else when you are programming in Structured Text. The name of
your program cannot be PROGRAM or even program (STL is not case sensitive),
because that word can only be used to make a construct to delimit your PLC program.
Back to
variables
...
If you know other programming languages, chances are that you know about
variables already.
But if you don't, here's an introduction to variables you probably will like:
Depending on what type of data you want to store, there are several data types
available. The different kinds of data are called data types. For example, if you have a
variable where you want to store either TRUE or
FALSE, you can declare it as a
BOOL
type.
The BOOL type is a boolean data type which means that it can contain a boolean
value (TRUE or FALSE).
Now, that was two thing about variables. They have a certain data type, and they
contain a value of that data type. But there's one more thing you can control in your
variables. The name of the variable.
To make it easy for you to use your variables throughout your PLC program, they all
have names. When you define a variable in the VAR construct, you start by giving the
variable its name:
X : BOOL;
This statement will create a variable called X, with a BOOL data type.
Be aware, that when you are programming with some PLC software like Siemens STEP
7 or Rockwell you won't use the VAR/END_VAR til declare variables. Instead variables
are often called tags or symbols, and even though you are programming in Structured
Text, you declare them visually (like in the image below) or in a function block.
But no matter what variables are called, they always have the same function. And with
IEC 61131-3 Programming software like STEP 7, Codesys or Studio 5000, the standard
data types will always be available.
All the standard data types are defined by the PLCOpen Organization and they are
part of the PLC programming languages. Every PLC programming software with
Structured Text has these data types included. In the IEC standard the data types are
divided into two categories:
Elementary data types and derived data types .
Elementary data types
● Integers
● Floating points
● Time
● Strings
● Bit strings
Integers:
IEC Data Format Range
Type
Floating points:
IEC Data Format Range
Type
Time:
IEC Data Type Format Use
TIME Duration of time after T#10d4h38m57s12ms
an event TIME#10d4h38m
Strings:
IEC Data Format Range
Type
Bit strings:
IEC Data Format Rang
Type e
WORD Word 16
bits
DWORD Double 32
Word bits
The derived data types are your own custom data types . All the derived data types
are built by making a construction of the keywords
TYPE and END_TYPE . In between
the keywords is the kind of derived data type you want to declare.
All these different data types might seem a little overwhelming for now. Especially if
you haven't used a textual programming language before. But there's no need to
worry.
For now, you only have to remember a few of them to get started programming with
Structured Text. As you get better and your programs more complicated, you will
gradually learn about more data types as you use them. What's important here is that
you don't move ahead too fast . You want to get the basics right.
As you can see the different data types can hold different data formats and thereby
different values.
But how do you put the values in the variables? And how do you use the variables?
With statements and operators.
Operators and Expressions in STL
The next thing you should know about is operators
. Operators are used to
manipulate data and is a part of almost any programming language. This leads us to
the second thing you should know about - expressions.
This means that when the compiler compiles an expression, it will evaluate the
expression and replace the statement with the result.
A+B
An
expression
are composed of
operators
and
operands
.
Since, you just saw an example of an expression, you just saw both an operator and
two operands. A and B are both operands and the + is an operator.
Operators
There are several operators available in Structured Text. Again, IEC 61131-3 describes
all the standard operators in the Structured Text language:
Function MAX(A,B)
Evaluation
Negation -
Complement NOT
Exponentiatio **
n
Multiply *
Divide /
Modulo MOD
Add +
Subtract -
Equality =
Inequality <>
Boolean XOR
Exclusive OR
Boolean OR OR Lowest
A + B * MAX(C, D)
As you can see in the table of operators the operator with the highest precedence is
parenthesis. This means that the first thing, that will be evaluated, is everything in
parenthesizes - in this example: (C, D).
But since MAX(C, D) is actually a function, we can jump one row down in the table to
function evaluation.
So, in the above expression, the first thing that will be evaluated is the function:
MAX(C, D). The function will yield (replace the function) with the answer. Which in this
case is the highest of the two variables C and D.
Let's image C is the result. The expression will now look like this:
A+B*C
Now, you can go down through the table, until you reach a row with the next operator
used in this expression.
There are two operations left: multiply and addition. But since multiply has a higher
precedence, that will be the first to be evaluated.
B * C comes first and then the result is added to A.
Every time an expression is evaluated, the evaluation follows the order of precedence
as in the table above.
Arithmetic Operators
All the
arithmetic operatorsare often just called mathematical operators because
they represent math. The result will always be the mathematical result of the
expression.
● +
(add)
● -
(subtract/negate)
● *(multiply)
● **(exponent)
● /
(divide)
● MOD (modulo divide)
Example:
15 MOD 4
Result:
3
Relational Operators
To compare or find a relation between two values you can use one of the relational
operators . They are used for comparison and the result will be a boolean value
(BOOL type), either TRUE or FALSE.
● = (equal)
● < (less than)
● <= (less than or equal)
● > (greater than)
● >= (greater than or equal)
● <> (not equal)
Example:
TEMPERATURE := 93.9;
TEMPERATURE >= 100.0
Result:
FALSE
Logical Operators
If you want to compare boolean values (BOOL) and make some logic out of it, you
have to use logical operators. These operators also yields a boolean value of TRUE or
FALSE as a result of the expression.
● & or
AND
● OR
● XOR
● NOT
Example:
LIMIT_SWITCH1 := TRUE;
LIMIT_SWITCH2 := FALSE;
LIMIT_SWITCH1 OR LIMIT_SWITCH2
Result:
TRUE
Bitwise Operators
The last group of operators are called
bitwise operators because the operations are
performed bitwise. It simply means that a logic operation is performed for each bit of
two numbers. The result is a new number - the total result of the bitwise operations.
● & or
AND
● OR
● XOR
● NOT
Example:
15 AND 8
Result:
15
Since this operation is bitwise the calculation will be per bit. So to understand what's
going on here, you have to convert the numbers to binary values:
15 = 1111
8 = 1000
Now each bit in the number 1111 (15) can be used in a logical operation with the
other number 1000 (8):
0 1 1 1
1 1 0 0
2 1 0 0
3 1 0 0
Operators and Statements
So, in the previous section you learned that
expressions evaluate . Meaning that all
expressions will yield the result and the compiler will replace the expression with the
result.
But what if you want the PLC (compiler) not to evaluate something, but to DO
something?
Statements are the answer.
As I mentioned previously in this article, statements are you telling the PLC what to
do. It's the instruction you give the PLC to take action.
If you make an expression that yields a result, that won't do much. Expressions are all
the calculations and if you don't use the results of those expressions in some actions
(statements), it will be like buying groceries but not cooking.
Let's take a look at the actions or statements that you can make in Structured Text.
Beginning with actions, the most fundamental statement in Structured Text is the
assignment statement. Statements are also described in the IEC standard developed
by PLCOpen, and the first one they list is the assignment statement.
A := B;
To take the
value
of the variable
B
and put it in the variable
A
.
The PLC is
assigning
a value to a variable. Here's an even simpler example:
A := 10;
This statement will take the value 10 and put it into the variable A. Or said in another
way - the variable A will be assigned the value 10.
Since the value of A is now 10, we can make another statement, but this time with an
expression:
B := A + 2;
When this line of code is compiled, the expression A + 2 will be evaluated to 12. The
compiler will replace the expression with the result 12. The statement will now look
like this to the compiler:
B := 12;
What will happen now, is that the compiler will assign the value 12 to the variable B.
A common mistake is to use the equality operator (=) instead of the assignment
operator (:=). But even though they look like each other there's a huge difference.
A=B
A := B;
The first line is an expression. Since this is an expression, the operator will be used to
evaluate the line. The equality operator evaluates in the following way:
If the right side and the left side is equal it evaluates to TRUE or 1. If not, it will
evaluate to FALSE or 0.
With some other operators, the equality operator is a relational operator
. All the
relational operators will evaluate to either TRUE or FALSE.
On the second line you'll see a statement. This time the operator will be used for an
action instead of an evaluation. Assignment is the action, and here the value of A will
be given the value of B.
At last, you can always identify a statement by the semi colon. Once again, the
semicolon is how the compiler knows when the end of a statement is reached.
You can have all sorts of expressions in your assignment statements, from simple
values like numbers to variables and functions. Because all expressions will be
evaluated first, and then, the result of that evaluation will be used in the assignment
statement.
Conditional Statements
Well, the assignment statement was pretty simple: Take the value of the right side and
store it in what's on the left side.
But let's zoom out a bit and think about PLC programs. A PLC program is a piece of
logic (I call it
PLC logic
) and therefore has to make some decisions. That's why we use
a PLC or any other controller. To decide and act on the current state.
Simplified: The PLC will look at the states of all the inputs and use your PLC program
to decide what outputs to set.
So in your PLC program you need a way to make decisions. This brings us to
conditional statements.
IF Statements
I think Bill Gates is better at explaining the IF statement than I am. At least he can
explain it in just over 1 minute in this great video from code.org. You can skip the
video if you are familiar with IF statements, although I would recommend that you
watch it.
YOUTUBE
But even though IF-statements are quite simple to understand, you still have to know
how to give the PLC the conditional statements. This brings us back to the syntax.
There's a special syntax for IF statements. This means, that you have to write it in a
certain way for the compiler to understand it. Because just like semi colons are used
to end statements, there are special keywords to make an IF statement.
1=1
This expression will evaluate to or yield TRUE. A boolean expression could also look
like this:
1>2
But this time the boolean expression will evaluate to FALSE, since 1 is not larger than
2.
Numeric expressions evaluates to an integer or a floating point number.
13.2 + 19.8
This expression will evaluate to the floating point number 33.0, and therefore is a
numeric expression.
The PLC will only execute the statements after the keyword THEN, if the expression
evaluates to TRUE. This is illustrated by the following example:
A := 0;
IF A = 0 THEN
B := 0;
END_IF;
Line number 3 will only be executed if A is equal to 0. In this case it will. A 0 is assigned
to the variable A in a statement right before the IF statement.
Let's say you want to make a program that sets a PLC output depending on the state
of an input. With a simple IF statement you can do that in Structured Text:
IF INPUT1=TRUE THEN
OUTPUT1 := TRUE;
END_IF;
Although this example is just a piece of a bigger program (the variable INPUT1
represents an input and OUTPUT1 an output) it illustrates how the decision for a PLC
output can be made. The OUTPUT1 variable will only be set to TRUE IF the INPUT1
variable is TRUE.
Since, both the INPUT1 and OUTPUT1 variables are of the type BOOL, the first line in
the statement could also look like this:
IF INPUT1 THEN
Just writing the expression as "INPUT1" will still evaluate as TRUE, when the variable is
TRUE.
Of course you could write this as multiple individual IF statements. But Structured
Text has more options to the IF statements.
Just like most other programming languages you can use the ELSIFand ELSE
keywords for multiple conditions in the same IF statement.
Both ELSIF and ELSE are optional in IF statements, but this is how the syntax looks
like:
If the boolean expression on line 1 is FALSE, the statements below will simply not be
executed. Instead the compiler will check the boolean expression after the ELSIF
keyword.
Here it works just like with the IF keyword: If the boolean expression after the
keyword is true, the following statements will be executed.
At last is the
ELSE
keyword. It works as a default option for your IF statement. If all the
IF and ELSIF boolean expressions are evaluated to FALSE, the statements after the
ELSE keyword will be executed.
CASE Statements
The second way of making decisions in Structured Text is with CASE statements.
Essentially, CASE statements and IF statements are the same. But CASE statements
use numeric expressions instead of boolean expressions. CASE statements also have
a slightly different syntax, that makes it more suitable for certain purposes.
This is how the syntax for CASE statements looks like in Structured Text:
In CASE statements there are only 1 expression. The result of that expression is then
used to decide which statements that are executed.
As a default option, CASE statements also have an ELSE keyword. The statements after
that keyword are executed only if none of the results (or cases) matches the result of
the numeric expression.
Here's a very simple example:
PROGRAM_STEP := 3;
CASE PROGRAM_STEP OF
1: PROGRAM_STEP := PROGRAM_STEP+1;
2: PROGRAM_STEP := PROGRAM_STEP+2;
3: PROGRAM_STEP := PROGRAM_STEP+3;
ELSE
PROGRAM_STEP := PROGRAM_STEP+10;
END_CASE;
Although this is a very simple example (the variable has a fixed value) the example
shows you how to make a decision depending on the result of a numeric expression.
In this example the numeric expression is simply just the value of the variable, 3. If
could be any expression that evaluates to an integer or a floating point value.
Iteration with Repeating Loops
Probably one of the most powerful features in Structured Text is the ability to make
loops that repeat lines of code.
Once again,Code.org
has made one of the best introductions to repeating loops. This
time, Facebook founder, Mark Zuckerberg uses a little more than a minute to explain
repeating loops.
YOUTUBE
In relation to PLC programming loops can be used for many different purposes. You
might have a function or a set of statements that you want to execute a certain
amount of times or until something stops the loop.
Common for all the types of loops is that they have a condition for either repeating or
stopping the loop. The condition in FORand
WHILE loops decides whether the loop
should repeat or not. But for the
REPEAT loopthe condition is an
UNTIL condition ,
and it will decide whether the loop should
stop or not.
FOR Loops
The first loop is the FOR loop and is used to repeat a specific number of times. FOR
loops has some other keywords. TO, BY, DO and END_FOR.
At first sight the first line looks a bit complicated, but it isn't if you divide it in chunks:
FOR
Keyword that starts the FOR loop statement.
count := initial_value
This assignment operation is where you set the initial value you want to count from.
Count is the variable name and initial_value is the value you want to start counting
from.
TO
Keyword before the value to count up to.
final_value
This is the value you want to count to. Place 100 here and your loop will count up to
100.
BY
Keyword to use custom incremental value.
increment
The value of which you want to increase the count for every time the loop runs. If you
set the increment to 10 and the count to 100, the loop will run 10 times.
DO
<statement>;
END_FOR;
This last part between the keyword DO and END_FOR is the statements you want to
execute each time your loop runs. These statements will be executed as many times
as the loops repeats.
Since FOR loops can only have a preset amount of time they will repeat, that is what
they are used for. In PLC programming this could be something as simple as an item
that has to be painted/dried four times. A FOR loop that counts to four will work just
fine here.
WHILE Loops
The while loop is a little different from the FOR loop, because it is used to repeat the
loop as long as some conditions are TRUE. A WHILE loop will repeat as long as a
boolean expression evaluates to TRUE.
Between the WHILE and DO keywords are the boolean expression. If that boolean
expression evaluates to TRUE, all the statements until the END_WHILE keyword will be
executed.
When END_WHILE is reached, the boolean expression will be evaluated again. This will
happen over and over again until the expression doesn't evaluate to TRUE. But to
make the loop stop at one point, you have to change a value in the boolean
expression. Only in that way can the boolean expression go from TRUE to FALSE.
counter := 0;
WHILE counter < 10 DO
counter := counter + 1;
machine_status := counter * 10;
END_WHILE;
If you look at the third line you will see how the loop will eventually stop repeating.
The boolean expression uses the counter variable and checks if its value is less than
or equal to 10. But since the value of counter is set to 0 right before the WHILE loop,
the boolean expression will be TRUE unless counter is changed.
That is what's happening in line 3. This is the first statement in the WHILE loop, and
with the other statements, are executed each time the loop repeats. In the third line
the value of the counter variable is increased by 1. You can say that the incremental
value is 1.
In the example above, the loop will repeat 10 times. When the value of count reaches
10, the boolean expression will be evaluated to FALSE (because 10 is not less than 10)
and the loop will stop.
You can also use the EXIT keyword in the WHILE loop to stop repeating the loop
before the boolean expression is FALSE. The syntax is an IF statement with the EXIT
keyword in. Place it anywhere between DO and END_WHILE keywords.
REPEAT Loops
The last type of repeating loop in Structured Text is the REPEAT loop. It works the
opposite way of the WHILE loop. This loop will stop repeating when a boolean
expression is TRUE.
REPEAT
<statement>;
UNTIL [boolean expression]
END_REPEAT;
Notice here that since the boolean expression in this type of loop is after the
statements, the statements will always be executed at least one time. This is useful if
you want an action to happen one time and then, with a condition, decide if that
action should happen again.
Just as with the WHILE loops you have to change a value in the boolean expression
along the way, to make the loop stop repeating. This can be done by incrementing the
value of a variable (to count), or it can be done with a conditional statement like an IF
statement inside the loop.
Structured Text Programming Software
Now, even if you have read this article in detail, you've only started learning
Structured Text. What you should do now is get your hands in the dirt and start using
Structured Text.
You should write some PLC programs. Because that is the way to really learn
Structured Text and master the programming language.
Beckhoff TwinCat 3
One of the best pieces of PLC programming software when you want to learn
Structured Text is
Beckhoff TwinCat 3
. The programming software from Beckhoff is
fully compatible with all the IEC 61131-3 PLC programming languages including
Ladder Diagram (LD) and Structured Text (ST).
For learners, the biggest advantage of TwinCat 3 is that it has a simulator included.
You don't need to buy a PLC, you just use the
soft PLC.
YOUTUBE
Codesys
You may have heard of Codesys before. It is an open source software environment for
IEC 61131-3 PLC programming. Open source just means that it is free for download,
which makes it perfect for students.
Although there are not many great resources on how to use Codesys for beginners,
Brian Hobbyhas made some amazing tutorial videos.
The first video shows you how to create a new project in Codesys. A little Ladder Logic
is also included in the video.
YOUTUBE
The second video helps you program in Structured Text with Codesys.
YOUTUBE
Conclusion
Learning a new programming language can be quite a challenge. But for beginners
there are some very basic things you should always keep in mind:
● Learning takes time
● You just started out. Give yourself some time to learn the language (syntax,
functions, ...)
● Practice as much as possible
● Try to make as many PLC programs and solutions in Structured Text as
possible.
● Learn from your failures
● Every time you make a mistake, don't get sad. Learn from it, and become a
better programmer.
● Keep learning
● Never stop reading, watching tutorials and other learning materials.
● Talk to other PLC programmers
● The last but not least is discussing in forums and asking questions. Get
involved and learn from other PLC programmers.
I think, that the last part is the most important part. Learning from others with
experience can be the most effective way to learn, not just about the programming
language, but how to use it.