Omron CX-PROGRAMMER V8.1 User manual

OPERATION MANUAL
Function Blocks/
Structured Text
Cat. No. W447-E1-08
SYSMAC
CX-Programmer
Ver. 8.1
WS02-CXPC1-V8

CX-Programmer
Ver. 8.1
WS02-CXPC1-V8
Operation Manual
Function Blocks/Structured Text
Revised February 2009

iv

v
Notice:
OMRON products are manufactured for use according to proper procedures by a qualified operator
and only for the purposes described in this manual.
The following conventions are used to indicate and classify precautions in this manual. Always heed
the information provided with them. Failure to heed precautions can result in injury to people or dam-
age to property.
!DANGER Indicates an imminently hazardous situation which, if not avoided, will result in death or
serious injury. Additionally, there may be severe property damage.
!WARNING Indicates a potentially hazardous situation which, if not avoided, could result in death or
serious injury. Additionally, there may be severe property damage.
!Caution Indicates a potentially hazardous situation which, if not avoided, may result in minor or
moderate injury, or property damage.
OMRON Product References
All OMRON products are capitalized in this manual. The word “Unit” is also capitalized when it refers to
an OMRON product, regardless of whether or not it appears in the proper name of the product.
The abbreviation “Ch,” which appears in some displays and on some OMRON products, often means
“word” and is abbreviated “Wd” in documentation in this sense.
The abbreviation “PLC” means Programmable Controller. “PC” is used, however, in some Program-
ming Device displays to mean Programmable Controller.
Visual Aids
The following headings appear in the left column of the manual to help you locate different types of
information.
Note Indicates information of particular interest for efficient and convenient opera-
tion of the product.
1,2,3... 1. Indicates lists of one sort or another, such as procedures, checklists, etc.
OMRON, 2008
All rights reserved. No part of this publication may be reproduced, stored in a retrieval system, or transmitted, in any form, o
r
by any means, mechanical, electronic, photocopying, recording, or otherwise, without the prior written permission o
f
OMRON.
No patent liability is assumed with respect to the use of the information contained herein. Moreover, because OMRON is con-
stantly striving to improve its high-quality products, the information contained in this manual is subject to change without
notice. Every precaution has been taken in the preparation of this manual. Nevertheless, OMRON assumes no responsibility
for errors or omissions. Neither is any liability assumed for damages resulting from the use of the information contained in
this publication.

vi

Part 1: Function Block
Part 2: Structured Text
SECTION 1 Introduction to Function Blocks
SECTION 2 Function Block Specifications
SECTION 3 Creating Function Blocks
SECTION 4 Introduction to Structured Text
SECTION 5 Structured Text (ST) Language Specifica-
tions
SECTION 6 Creating ST Programs
Appendices

ix
TABLE OF CONTENTS
PRECAUTIONS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxi
1 Intended Audience. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxii
2 General Precautions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxii
3 Safety Precautions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxii
4 Application Precautions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxiii
Part 1:
Function Blocks
SECTION 1
Introduction to Function Blocks . . . . . . . . . . . . . . . . . . . . . . 3
1-1 Introducing the Function Blocks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
1-2 Function Blocks. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
1-3 Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
1-4 Converting Function Block Definitions to Library Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
1-5 Usage Procedures. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
1-6 Version Upgrade Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
SECTION 2
Function Block Specifications . . . . . . . . . . . . . . . . . . . . . . . . 29
2-1 Function Block Specifications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
2-2 Data Types Supported in Function Blocks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
2-3 Instance Specifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
2-4 Programming Restrictions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .51
2-5 Function Block Applications Guidelines. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
2-6 Precautions for Instructions with Operands Specifying the First or Last of Multiple Words 65
2-7 Instruction Support and Operand Restrictions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
2-8 CPU Unit Function Block Specifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
2-9 Number of Function Block Program Steps and Instance Execution Time . . . . . . . . . . . . . . 76
SECTION 3
Creating Function Blocks. . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
3-1 Procedural Flow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
3-2 Procedures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82

x
TABLE OF CONTENTS
Part 2:
Structured Text (ST)
SECTION 4
Introduction to Structured Text . . . . . . . . . . . . . . . . . . . . . . 131
4-1 ST Language . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
4-2 CX-Programmer Specifications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
SECTION 5
Structured Text (ST) Language Specifications . . . . . . . . . . 135
5-1 Structured Text Language Specifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
5-2 Data Types Used in ST Programs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
5-3 Inputting ST Programs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
5-4 ST Language Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
5-5 Statement Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
5-6 ST-language Program Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
5-7 Restrictions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
SECTION 6
Creating ST Programs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
6-1 Procedures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
Appendices
A System-defined external variables supported in function blocks . . . . . . . . . . . . . . . . . . . . . 181
B Structured Text Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183
C Function Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187
Index. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201
Revision History . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203

xi
About this Manual:
This manual describes the CX-Programmer operations that are related to the function block functions
and Structured Text (ST) functions. The function block and structure text functionality of CX-Program-
mer Ver. 8.1 is supported by CJ2H CPU Units, by CS1-H, CJ1-H, and CJ1M CPU Units with unit ver-
sion 3.0 or later, by CP-series CPU Units, and by NSJ-series and FQM1-series Controllers.
Some function block and structure text functionality, however, is supported only by CJ2H CPU Units, by
CS1-H, CJ1-H, and CJ1M CPU Units with unit version 4.0 or later.
For details, refer to 1-6 Version Upgrade Information.
For information on functionality other than function blocks and structure text, refer to the following man-
uals.
• CX-Programmer
: CX-Programmer Operation Manual (W446) and CX-Programmer Operation Manual: SFC (W469)
• CPU Unit
: The operation manuals for the CS-series, CJ-series, CP-series, and NSJ-series Controllers
CX-Programmer Ver. 8.1 Manuals
Name Cat. No. Contents
SYSMAC WS02-CXPC1-V8
CX-Programmer Ver. 8.1 Operation Manual
Function Blocks/Structured Text
W447
(this
manual)
Explains how to use the CX-Programmer Ver. 8.1 software’s
function block and structured text functions. For explanations
of other shared CX-Programmer functions, refer to the CX-
Programmer Operation Manual (W446).
SYSMAC WS02-CXPC1-V8
CX-Programmer Operation Manual
W446 Provides information on how to use the CX-Programmer for
all functionality except for function blocks.
SYSMAC WS02-CXPC1-V8
CX-Programmer Operation Manual: SFC
W469 Explains how to use the SFC programming functions. For
explanations of other shared CX-Programmer functions, refer
to the CX-Programmer Operation Manual (W446).
CX-Net Operation Manual W362 Information on setting up networks, such as setting data links,
routing tables, and unit settings.
SYSMAC CXONE-AL@@C-V3
SYSMAC CXONE-AL@@D-V3
CX-Integrator Operation Manual
W445 Describes the operating procedures for the CX-Integrator.

xii
CS1-H, CJ1-H, and CJ1M CPU Unit Manuals
Name Cat. No. Contents
SYSMAC CJ Series
CJ2H-CPU6@-EIP, CJ2H-CPU6@
Programmable Controllers
Hardware User's Manual
W472 Provides an outline of and describes the design, installation,
maintenance, and other basic operations for the CJ-series
CJ2 CPU Units.
The following information is included:
Overview and features
System configuration
Installation and wiring
Troubleshooting
Use this manual together with the W473.
SYSMAC CJ Series
CJ2H-CPU6@-EIP, CJ2H-CPU6@
Programmable Controllers
Software User's Manual
W473 Describes programming and other methods to use the func-
tions of the CJ2 CPU Units.
The following information is included:
CPU Unit operation
Internal memory areas
Programming
Tasks
CPU Unit built-in functions
Use this manual together with the W472.
SYSMAC CS/CJ Series
CS1G/H-CPU@@ -EV1, CS1G/H-CPU@@H,
CS1D-CPU@@H, CS1D-CPU@@S,
CJ2H-CPU6@-EIP, CJ2H-CPU6@,
CJ1H-CPU@@H-R
CJ1G-CPU@@, CJ1G/H-CPU@@H,
CJ1G-CPU@@P, C J 1 M - C P U @@
SYSMAC One NSJ Series
NSJ@-@@@@(B)-G5D
NSJ@-@@@@(B)-M3D
Programmable Controllers
Instructions Reference Manual
W474 Describes the ladder diagram programming instructions sup-
ported by CS/CJ-series or NSJ-series PLCs.
When programming, use this manual together with the Oper-
ation Manual or Hardware User's Manual (CS1: W339, CJ1:
W393,or CJ2:W472) and Programming Manual or Software
User's Manual (CS1/CJ1:W394 or CJ2:W473).
SYSMAC CS Series
CS1G/H-CPU@@-EV1, CS1G/H-CPU@@H
Programmable Controllers
Operation Manual
W339 Provides an outline of and describes the design, installation,
maintenance, and other basic operations for the CS-series
PLCs.
The following information is included:
An overview and features
The system configuration
Installation and wiring
I/O memory allocation
Troubleshooting
Use this manual together with the W394.
SYSMAC CJ Series
CJ1G-CPU@@, CJ1G/H-CPU@@H,
CJ1H-CPU@@H-R, CJ1G-CPU@@P,
CJ1M-CPU@@
Programmable Controllers
Operation Manual
W393 Provides an outline of and describes the design, installation,
maintenance, and other basic operations for the CJ-series
PLCs.
The following information is included:
An overview and features
The system configuration
Installation and wiring
I/O memory allocation
Troubleshooting
Use this manual together with the W394.

xiii
NSJ-series NSJ Controller Manual
Refer to the following manual for NSJ-series NSJ Controller specifications and handling methods not
given in this manual.
SYSMAC CS/CJ Series
CS1G/H-CPU@@-EV1, CS1G/H-CPU@@H,
CJ1G-CPU@@, CJ1G/H-CPU@@H,
CJ1H-CPU@@H-R, CJ1G-CPU@@P,
CJ1M-CPU@@, NSJ@-@@@@(B)-G5D,
NSJ@-@@@@(B)-M3D
Programmable Controllers
Programming Manual
W394 Describes programming and other methods to use the func-
tions of the CS/CJ-series and NSJ-series PLCs.
The following information is included:
Programming
Tasks
File memory
Other functions
Use this manual together with the W339 or W393.
SYSMAC CS/CJ Series
CS1G/H-CPU@@-EV1, CS1G/H-CPU@@H,
CJ1G-CPU@@, CJ1G/H-CPU@@H,
CJ1H-CPU@@H-R, CJ1G-CPU@@P,
CJ1M-CPU@@, NSJ@-@@@@(B)-G5D,
NSJ@-@@@@(B)-M3D
Programmable Controllers
Instructions Reference Manual
W340 Describes the ladder diagram programming instructions sup-
ported by CS/CJ-series and NSJ-series PLCs.
When programming, use this manual together with the Oper-
ation Manual (CS1: W339 or CJ1: W393) and Programming
Manual (W394).
CS1G/H-CPU@@-EV1
CS1G/H-CPU@@H
CS1W-SCB21-V1/41-V1
CS1W-SCU21/41
CJ2H-CPU6@-EIP, CJ2H-CPU6@
CJ1G-CPU@@
CJ1G/H-CPU@@H
CJ1G-CPU@@P
CJ1M-CPU@@
CJ1W-SCU21-V1/41-V1
CP1H-X@@@@-@
CP1H-XA@@@@-@
CP1H-Y@@@@-@
NSJ@-@@@@(B)-G5D
NSJ@-@@@@(B)-M3D
SYSMAC CS/CJ Series Communications
Commands Reference Manual
W342 Describes the communications commands that can be
addressed to CS/CJ-series CPU Units.
The following information is included:
C-series (Host Link) commands
FINS commands
Note: This manual describes commands that can be sent to
the CPU Unit without regard for the communications path,
which can be through a serial communications port on the
CPU Unit, a communications port on a Serial Communica-
tions Unit/Board, or a port on any other Communications
Unit.
Cat. No. Models Name Description
W452 NSJ5-TQ@@(B)-G5D
NSJ5-SQ@@(B)-G5D
NSJ8-TV@@(B)-G5D
NSJ10-TV@@(B)-G5D
NSJ12-TS@@(B)-G5D
NSJ Series
Operation
Manual
Provides the following information about the NSJ-series NSJ Con-
trollers:
Overview and features
Designing the system configuration
Installation and wiring
I/O memory allocations
Troubleshooting and maintenance
Use this manual in combination with the following manuals: SYS-
MAC CS Series Operation Manual (W339), SYSMAC CJ Series
Operation Manual (W393), SYSMAC CS/CJ Series Programming
Manual (W394), and NS-V1/-V2 Series Setup Manual (V083)
Name Cat. No. Contents

xiv
FQM1 Series Manuals (Unit Version 3.0 or Later)
Refer to the following manuals for specifications and handling methods not given in this manual for
FQM1 Series unit version 3.0 (FQM1-CM002/MMP22/MMA22).
CP-series PLC Unit Manuals
Refer to the following manuals for specifications and handling methods not given in this manual for CP-
series CPU Units.
Installation from CX-One
For details on procedures for installing the CX-Programmer from CX-One FA Integrated Tool Package,
refer to the CX-One Ver. 3.0 Setup Manual provided with CX-One.
Cat. No. Models Name Description
O012 FQM1-CM002
FQM1-MMP22
FQM1-MMA22
FQM1 Series
Operation Manual
Provides the following information about the FQM1-series Modules
(unit version 3.0):
Overview and features
Designing the system configuration
Installation and wiring
I/O memory allocations
Troubleshooting and maintenance
O013 FQM1-CM002
FQM1-MMP22
FQM1-MMA22
FQM1 Series
Instructions
Reference Manual
Individually describes the instructions used to program the FQM1.
Use this manual in combination with the FQM1 Series
Operation Manual (O012) when programming.
Cat. No. Models Name Description
W450 CP1H-X@@@@-@
CP1H-XA@@@@-@
CP1H-Y@@@@-@
SYSMAC CP Series
CP1H CPU Unit
Operation Manual
Provides the following information on the CP-series CP1H PLCs:
• Overview/Features
• System configuration
• Mounting and wiring
• I/O memory allocation
• Troubleshooting
Use this manual together with the CP1H/CP1L Programmable
Controllers Programming Manual (W451).
W462 CP1L-M@@@@-@
CP1L-L@@@@-@SYSMAC CP Series CP1L CPU Unit Oper-
ation Manual
Provides the following information on the CP-series CP1L PLCs:
• Overview/Features
• System configuration
• Mounting and wiring
• I/O memory allocation
• Troubleshooting
Use this manual together with the CP1H Programmable Control-
lers Programming Manual (W451).
W451 CP1H-X@@@@-@
CP1H-XA@@@@-@
CP1H-Y@@@@-@
CP1L-M@@@@-@
CP1L-L@@@@-@
SYSMAC CP Series
CP1H/CP1L CPU
Unit Programming
Manual
Provides the following information on the CP-series CP1H and
CP1L PLCs:
• Programming instructions
• Programming methods
• Tasks
Use this manual together with the CP1H/CP1L Programmable
Controllers Operation Manual (W450).
Cat. No. Model Manual name Contents
W463 CXONE-AL@@C-V3/
AL@@D-V3
CX-One Setup Manual Installation and overview of CX-One FA
Integrated Tool Package.

xv
Overview of Contents
Precautions provides general precautions for using the CX-Programmer Ver. 8.1.
Part 1
Part 1 contains the following sections.
Section 1 introduces the function block functionality of the CX-Programmer and explains the features
that are not contained in the non-function block version of CX-Programmer.
Section 2 provides specifications for reference when using function blocks, including specifications on
function blocks, instances, and compatible PLCs, as well as usage precautions and guidelines.
Section 3 describes the procedures for creating function blocks on the CX-Programmer.
Part 2
Part 2 contains the following sections.
Section 4 introduces the structure text programming functionality of the CX-Programmer and explains
the features that are not contained in the non-structured text version of CX-Programmer.
Section 5 provides specifications for reference when using structured text programming, as well as
programming examples and restrictions.
Section 6 explains how to create ST programs.
Appendices provide information on structured text errors and ST function descriptions.
!WARNING Failure to read and understand the information provided in this manual may result in per-
sonal injury or death, damage to the product, or product failure. Please read each section
in its entirety and be sure you understand the information provided in the section and
related sections before attempting any of the procedures or operations given.

xvi

xvii
Read and Understand this Manual
Please read and understand this manual before using the product. Please consult your OMRON
representative if you have any questions or comments.
Warranty and Limitations of Liability
WARRANTY
(1) The warranty period for the Software is one year from either the date of purchase or the date on which
the Software is delivered to the specified location.
(2) If the User discovers a defect in the Software (i.e., substantial non-conformity with the manual), and
returns it to OMRON within the above warranty period, OMRON will replace the Software without charge
by offering media or downloading services from the Internet. And if the User discovers a defect in the
media which is attributable to OMRON and returns the Software to OMRON within the above warranty
period, OMRON will replace the defective media without charge. If OMRON is unable to replace the
defective media or correct the Software, the liability of OMRON and the User's remedy shall be limited to
a refund of the license fee paid to OMRON for the Software.
LIMITATIONS OF LIABILITY
(1) THE ABOVE WARRANTY SHALL CONSTITUTE THE USER'S SOLE AND EXCLUSIVE REMEDIES
AGAINST OMRON AND THERE ARE NO OTHER WARRANTIES, EXPRESSED OR IMPLIED,
INCLUDING BUT NOT LIMITED TO, WARRANTY OF MERCHANTABILITY OR FITNESS FOR A
PARTICULAR PURPOSE. IN NO EVENT WILL OMRON BE LIABLE FOR ANY LOST PROFITS OR
OTHER INDIRECT, INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES ARISING OUT OF
USE OF THE SOFTWARE.
(2) OMRON SHALL ASSUME NO LIABILITY FOR DEFECTS IN THE SOFTWARE BASED ON
MODIFICATION OR ALTERATION OF THE SOFTWARE BY THE USER OR ANY THIRD PARTY.
(3) OMRON SHALL ASSUME NO LIABILITY FOR SOFTWARE DEVELOPED BY THE USER OR ANY
THIRD PARTY BASED ON THE SOFTWARE OR ANY CONSEQUENCE THEREOF.

xviii
Application Considerations
SUITABILITY FOR USE
THE USER SHALL NOT USE THE SOFTWARE FOR A PURPOSE THAT IS NOT DESCRIBED IN THE
ATTACHED USER MANUAL.

xix
Disclaimers
CHANGE IN SPECIFICATIONS
The software specifications and accessories may be changed at any time based on improvements or for
other reasons.
EXTENT OF SERVICE
The license fee of the Software does not include service costs, such as dispatching technical staff.
ERRORS AND OMISSIONS
The information in this manual has been carefully checked and is believed to be accurate; however, no
responsibility is assumed for clerical, typographical, or proofreading errors, or omissions.

xx

xxi
PRECAUTIONS
This section provides general precautions for using the CX-Programmer and the Programmable Logic Controller.
The information contained in this section is important for the safe and reliable application of the CX-Programmer
and Programmable Controller. You must read this section and understand the information contained before
attempting to set up or operate the CX-Programmer and Programmable Controller.
1 Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxii
2 General Precautions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxii
3 Safety Precautions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxii
4 Application Precautions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxiii