1756 Rm084 en PImport Export
1756 Rm084 en PImport Export
1756 Rm084 en PImport Export
WARNING: Identifies information about practices or circumstances that can cause an explosion in a hazardous environment, which may lead to
personal injury or death, property damage, or economic loss.
ATTENTION: Identifies information about practices or circumstances that can lead to personal injury or death, property damage, or economic
loss. Attentions help you identify a hazard, avoid a hazard, and recognize the consequence
Important:
Identifies information that is critical for successful application and understanding of the product.
SHOCK HAZARD: Labels may be on or inside the equipment, for example, a drive or motor, to alert people that dangerous voltage may be
present.
BURN HAZARD: Labels may be on or inside the equipment, for example, a drive or motor, to alert people that surfaces may reach dangerous
temperatures.
ARC FLASH HAZARD: Labels may be on or inside the equipment, for example, a motor control center, to alert people to potential Arc Flash. Arc
Flash will cause severe injury or death. Wear proper Personal Protective Equipment (PPE). Follow ALL Regulatory requirements for safe work
practices and for Personal Protective Equipment (PPE).
Allen-Bradley, Rockwell Software, Rockwell Automation, and TechConnect are trademarks of Rockwell Automation, Inc.
Trademarks not belonging to Rockwell Automation are property of their respective companies.
Summary of changes
This manual contains new and updated information. This table contains the
changes made to this revision.
Change
Topic
Table of contents
Preface
Chapter 1
Import and export files
Introduction ............................................................................................................ 23
Export a Project to an .L5K Text File ................................................................ 23
Import an .L5K text file......................................................................................... 24
Export a Project to an .L5X XML File............................................................... 26
Import an .L5X XML File .................................................................................... 27
Export to a .CSV or .TXT file.............................................................................. 28
Import a .CSV or .TXT file .................................................................................. 30
Export source-protected logic .............................................................................. 33
Export in a Cleartext Format ........................................................................ 33
Maintaining controller access............................................................................... 36
.L5X file structure ................................................................................................... 37
.L5X file conventions ............................................................................................. 40
Internal file comments ................................................................................... 40
Component Descriptions .............................................................................. 40
Boolean attribute values ................................................................................. 41
Data display style ............................................................................................. 41
Data formats ..................................................................................................... 41
.L5K file structure ................................................................................................... 46
.L5K file conventions ............................................................................................. 47
Internal file comments ................................................................................... 47
Component descriptions ............................................................................... 48
Display style ...................................................................................................... 48
Project documentation .......................................................................................... 49
Chapter 2
Define a controller
component
Introduction ............................................................................................................ 51
Controller component .......................................................................................... 51
L5X controller structure ................................................................................ 51
L5K CONTROLLER structure .................................................................. 52
Controller elements ........................................................................................ 53
Controller attributes ....................................................................................... 54
Controller attributes in a safety controller system .......................................... 56
Rockwell Automation Publication 1756-RM084U-EN-P - November 2015
Table of contents
Chapter 3
Define a Datatype
component
Introduction ............................................................................................................ 65
Datatype component ............................................................................................. 65
L5X datatype structure .................................................................................. 65
L5K datatype structure................................................................................... 65
Datatype elements ........................................................................................... 65
Datatype attributes.......................................................................................... 66
Datatype member ................................................................................................... 66
L5X datatype member structure .................................................................. 66
L5K datatype member structure .................................................................. 67
Datatype member elements ........................................................................... 67
Datatype member attributes ......................................................................... 67
Bit members ...................................................................................................... 68
Datatype guidelines ................................................................................................ 69
Examples ................................................................................................................... 70
Chapter 4
Define a module component
Introduction ............................................................................................................ 71
Module component ................................................................................................ 71
L5X module structure .................................................................................... 71
L5K MODULE structure ............................................................................. 71
Module elements ............................................................................................. 72
Module attributes ............................................................................................ 72
Module attributes in a safety controller system................................................ 75
Module connection ................................................................................................ 76
L5X connection structure ............................................................................. 76
L5K CONNECTION structure ................................................................. 76
Connection elements...................................................................................... 77
Module connection attributes ...................................................................... 77
Module connection attributes in a safety controller system .................. 78
Module guidelines................................................................................................... 79
Examples ................................................................................................................... 79
Table of contents
Chapter 5
Define an Add-On Instruction
component
Introduction ............................................................................................................ 87
Add-On Instruction component ........................................................................ 87
L5X AddOnInstructionDefinition Structure .......................................... 87
L5K ADD_ON_INSTRUCTION_DEFINITION structure........... 88
Add-On Instruction elements ...................................................................... 88
Add-On Instruction attributes..................................................................... 88
Routines in Add-On Instructions ............................................................... 89
Parameters ................................................................................................................ 90
L5X parameters structure .............................................................................. 90
L5K parameters structure .............................................................................. 91
Parameter elements ......................................................................................... 92
Parameters attributes ...................................................................................... 93
Signature history ..................................................................................................... 94
L5X SignatureHistory structure .................................................................. 95
L5K HISTORY_ENTRY structure ........................................................... 95
History entry attributes.................................................................................. 95
Local tags................................................................................................................... 95
L5X LocalTags structure ............................................................................... 95
L5K LOCAL_TAGS structure ................................................................... 96
Local tag attributes .......................................................................................... 96
Encoded/Unencoded Add-On Instructions .................................................... 97
L5X EncodedData Structure ........................................................................ 97
L5K ENCODED_DATA Structure .......................................................... 97
Encoded data attributes ................................................................................. 98
L5X Encoded Add-On Instruction example............................................. 99
L5K Encoded Add-On instruction example ........................................... 100
Add-On Instruction Guidelines ........................................................................ 100
L5X unencoded AddOnInstruction definition example ..................... 101
Add-On Instruction Example, Continued .............................................. 102
L5K unencoded ADD_ON_INSTRUCTION _DEFINITION
example ............................................................................................................ 102
L5X unencoded safety AddOnInstruction definition example .......... 105
L5K unencoded safety ADD_ON_INSTRUCTION _DEFINITION
example ............................................................................................................ 105
Chapter 6
Define a tag component
Table of contents
Table of contents
Chapter 7
Define a program component
Chapter 8
Define a ladder logic routine
Table of contents
Chapter 9
Define a function block
diagram routine
10
Table of contents
Chapter 10
Define a sequential function
chart routine
11
Table of contents
Table of contents
Chapter 11
Define a structured text
routine
Chapter 12
Define an Equipment
Sequence routine
13
Table of contents
Chapter 13
Define a task component
14
Table of contents
Chapter 14
Define a parameter
connection component
Chapter 15
Define a trend component
Chapter 16
Define a watch list
component
15
Table of contents
Chapter 17
Define controller
configuration objects
Chapter 18
Define custom properties
Chapter 19
Structure Tags and
Comments in an
Import/Export File
16
Table of contents
Appendix A
Considerations for using
Microsoft Excel to edit a .CSV
file
Appendix B
Import/Export revision
history
Index
17
Preface
This manual details how to import and export controller projects. You should be
familiar with how the Logix-based controller stores and processes data. This
manual is one of a set of related manuals that show common procedures for
programming and operating Logix5000 controllers.
For a complete list of common procedures manuals, refer to the Logix5000
Controllers Common Procedures Programming Manual, publication 1756PM001.
The term Logix5000 controller refers to any controller that is based on the
Logix5000 operating system.
Supported controllers
1756-L71
1756-L71S
1756-L72
19
Preface
20
1756-L72S
1756-L73
1756-L73S
1756-L74
1756-L75
1756-L83E
1756-L85E
1769-L16ER-BB1B
1769-L18ER-BB1B
1769-L18ERM-BB1B
1769-L19ERM-BB1B
1769-L24ER-QB1B
1769-L24ER-QBFC1B
1769-L27ERM-QBFC1B
1769-L30ER
1769-L30ERM
1769-L30ERMS
1769-L30ER-NSE
1769-L33ER
1769-L33ERM
1769-L33ERMS
1769-L36ERM
1769-L36ERMS
5069-L320ER
5069-L340ERM
Emulator
Preface
Additional resources
Description
Legal Notices
Copyright Notice
2015 Rockwell Automation, Inc. All rights reserved. Printed in USA.
This document and any accompanying Rockwell Software products are
copyrighted by Rockwell Automation, Inc. Any reproduction and/or distribution
without prior written consent from Rockwell Automation, Inc. is strictly
prohibited. Please refer to the license agreement for details.
End User License Agreement (EULA)
You can view the Rockwell Automation End-User License Agreement ("EULA")
by opening the License.rtf file located in your product's install folder on your hard
drive.
Trademark Notices
Allen-Bradley, Rockwell Automation, Studio 5000, Compact GuardLogix,
CompactLogix, ControlLogix, DriveLogix, FactoryTalk, FactoryTalk
Administration Console, FactoryTalk Batch, FactoryTalk Directory,
FactoryTalk Integrator, FactoryTalk Batch, FactoryTalk Security, FactoryTalk
Services Platform, FactoryTalk View Machine Edition, FactoryTalk View SE,
GuardLogix, Logix5000, Logix Designer, SoftLogix5800, FlexLogix, and
TechConnect are trademarks of Rockwell Automation, Inc.
Any Rockwell Automation software or hardware not mentioned here is also a
trademark, registered or otherwise, of Rockwell Automation, Inc.
Other Trademarks
Microsoft is a registered trademark of Microsoft Corporation in the United States
and/or other countries. ControlNet is a trademark of ControlNet International.
Rockwell Automation Publication 1756-RM084U-EN-P - November 2015
21
Preface
22
Chapter 1
Introduction
This document describes how to use the import/export feature that is included
with the Logix Designer application.
With a Logix controller, you can import and export an entire project or import
and export parts of a project. Select the import/export format based on what you
want from the content.
If you want:
L5K or L5X
L5X
CSV or TXT
You can export a project to a text file and use any text editor that supports UTF8
file format to modify the project. The exported file will be an .L5K format.
Do these steps to export a project to an .L5K text file.
1. Make sure the project you want to export is open.
2. In the Logix Designer application, click File > Save As.
23
Chapter 1
The application automatically saves any unsaved edits when you click OK.
Import controller information from a saved text file that has an .L5K extension.
This lets you use any text editor to create a project.
Do these steps to import an .L5K text file into a project.
1. In the Logix Designer application, from the File menu, choose Open.
24
Chapter 1
2. Select the .L5K text file you want to import and click Open.
The Save Imported Project As dialog box opens.
25
Chapter 1
4. In the File name box, type the name for the imported project and click
Import.
Important:
If you import a project that has forces, the project defaults to Forces Disabled, even if the
project was exported with Forces Enabled.
When you import an .L5K file, the project changes so that you cannot go online and access a
previously downloaded controller. You must first upload from or download to the controller. See
Maintaining Controller Access on page 36.
You can export a project to an XML file and use a text or XML editor to modify
the project. The exported file will be an .L5X format.
Do these steps to export from a project to an .L5X XML file.
1. Make sure the project you want to export from is already open.
2. In the Logix Designer application, click File > Save As.
26
Chapter 1
The application automatically saves any unsaved edits when you click OK.
Import controller information from a saved XML file that has an .L5X extension
and is a full controller export. This lets you use any editor to create a project.
Do these steps to import a controller .L5X XML file into a project.
1. In the Logix Designer application, click File > Open.
2. In the File name box, select the .L5X controller file you want to import and
click Open.
27
Chapter 1
If you import a project that has forces, the project defaults to Forces Disabled, even if the
project was exported with Forces Enabled.
When you import an .L5X file, the project changes so that you cannot go online and access a
previously downloaded controller. You must first upload from or download to the controller. See
Maintaining Controller Access on page 36.
When you have a project open, you can export tags and logic comments to a
structured file that separates values with commas (.CSV file) or that separates
values with tabs (.TXT Unicode file). You can then use other applications, such as
Microsoft Excelor Notepad, to edit the tags and logic comments.
Do these steps to export tags and logic comments to a structured file.
1. Make sure the project from which you want to export tags and comments is
already open.
28
Chapter 1
2. In the Logix Designer application, click Tools > Export > Tags and Logic
Comments.
3. In the File name box, type the name of the file to be exported.
4. From the Save as type list, click .CSV or .TXT format.
29
Chapter 1
6. Click Export.
Scope
Exported Material
All
All the tags (controller-scope, program-scope, equipment phase, and Add-On Instruction) or logic comments in the
project
Controller
All Programs/Phases
Programs
Equipment Phases
Add-On Instructions
The tags or logic comments of a specific program, equipment phase, or Add-On Instruction
When you are offline and have a project open, you can import tags and logic
comments from a saved .CSV file or .TXT file. This lets you use other
applications, such as Microsoft Excel or Notepad, to create and edit tags
and logic comments.
Do these steps to import tags and logic comments from a saved .CSV file or .TXT
file into a project.
30
Chapter 1
1. In the Logix Designer application, click Tools > Import > Tags and Logic
Comments.
2. In the File name box, select the .CSV or .TXT file you want to import.
3. From the File of type list, select .CSV or .TXT format.
Tip:
Use the File of type list to filter .CSV or .TXT files in the Import dialog box.
4. From the Tags lists, specify how you want to handle tag collisions.
31
Chapter 1
Important:
When you import tags, the tags in the import file may have the same
name as tags that are already in the open project. This condition is a
collision.
Replace tags in the project with tags from the import file, in addition to
adding any new tags from the import file
Keep tags that are in the project and discard colliding tags in the import
file, in addition to adding any new tags from the import file
Replace tags in the project with tags from the import file, but do not add Create New Tags & Overwrite Existing Tags
any new tags from the import file
Important:
If you delete tags from the .CSV or .TXT file and import the file, the process
does not delete the tags from the controller project. Use the programming
software to delete tags from the controller project.
5. From the Logic Comments list, specify how you want to handle logic
comment collisions.
Important:
When you import logic comments, the possibility exists for the comments in the import file to
differ from the comments in the open project when both are matched to the same logic.
Then:
The next rung that has the instruction, as specified Make sure that the Leave the Match all ladder diagram
in the Owning Element, as its last instruction on the rung comments by rung only check box is cleared.
rung
This is the default and recommended option.
The Location element is ignored.
The rung number specified in the Location element Select the Match all ladder diagram rung comments by
rung only check box.
This overrides the default and recommended option.
The Owning Element is ignored.
32
Export source-protected
logic
Chapter 1
Then:
If a .CSV file or .TXT file contains changes to tags, including aliases, when you import the file that
the project changes such that you cannot go online and access a previously downloaded
controller. You must first upload from or download to the controller.
If you only modify comments or descriptions before you import a .CSV file or .TXT file, you can go
online with the controller.
Starting with version 20, you can configure how source-protected content is
exported in .L5K and .L5X files.
By default, source-protected content is now exported in an encrypted format to
prevent viewing or modifying components in the system. A check box option on
the Workstation Options dialog box enables Add-On Instructions and routines
to be exported in a readable, cleartext format if the source keys for those
components are present in the sk.dat file. This lets you modify protected content
in a third-party tool, such as an XML editor.
Important:
You must enable your workstation for source protection to use the cleartext option on the Workstation Option dialog box. Otherwise, the check box, is not
available and source-protected content is exported in an encrypted format.
The sk. dat file has been specified and it contains the source key (password)
for the content. For details, see the Logix5000 Controllers Security
Programming Manual, publication 1756-PM016.
33
Chapter 1
The Workstation Options dialog box opens with the export check box
option if your personal computer is enabled for source protection.
You cannot copy source-protected content from version 21 of the application and paste into
earlier software versions. The pasting function is disabled in previous software versions when
source-protected content is placed on the clipboard.
4. Click OK.
34
Chapter 1
7. From the Save as type list, select the .L5K or .L5X option, depending on
your file type.
The Encode Source Protected Content check box is available when you
choose the .L5K or .L5X option.
35
Chapter 1
Important:
The Encode Source Protected Content check box is only enabled when the Always Encode
Source Protected Content on Export check box in the Workstation Options dialog box is
cleared.
The Encode Source Protected Content check box also appears on the component dialog box.
Maintaining controller
access
The controller manages project status to provide Logix Designer application with
the information to decide whether you can go online with a controller.
Information
Description
Creation Stamp
The controller creates a creation stamp when you create, and import, a project and download the project to the
controller. The creation stamp in the controller and the project file must match to enable Logix Designer application
to go online with a controller.
If a project is exported to an .L5K file and then imported, the resulting project .ACD file gets a new creation stamp.
This means that the Logix Designer application views the imported project as different from the file that was
exported. The result is that you cannot use the new, imported project file to access a controller that was downloaded
with the original file, before it was exported. At this point, your only options are to download again from the
imported project file or to upload the controller contents to another project .ACD file and merge with the
documentation from one of the older project .ACD files.
Download Stamp
The controller creates a download stamp on each download and stores this stamp in both the project and the
controller. When the creation stamp and the download stamp in the controller match those in the project file, Logix
Designer application can use the project to let you access the controller online.
If you change a project file when offline, that also clears the download stamp. This can occur when you import from
an .L5X file or if you import a .CSV file that creates a new tag or modifies a tag data type. When you reset the
download stamp, you can either download the project to the controller or upload the contents from the controller. If
you choose to upload, you lose any changes made through import. Note that description and rung comment changes
in a .CSV file do not reset the download stamp, so you can perform some .CSV file imports and still maintain access to
the controller.
Change Log
Each time you change a controller online, the controller stores details about the change in a change log. If there are
more than 1000 changes made to the project file since you last went online with the controller, you must either
download the project to the controller or upload the contents from the controller. If you choose to upload, you lose
any changes made through import.
Given this status information, these situations prevent you from going online with
a controller.
36
Chapter 1
Possible Recovery
Changes were made to the offline project, excluding documentation and tag value changes.
A controller nonvolatile storage load occurred and the loaded image has the same creation stamp but a
different download stamp.
A controller nonvolatile storage load occurred and the loaded image has the same creation and download
stamps but the change log is dated earlier than the project file.
The project was exported and then reimported. In this case, the software considers it a different project and Full download to the controller
it has its own unique stamps.
Upload from the controller to a new project.
A different project, with different stamps, was downloaded.
A controller nonvolatile storage load occurred, and the image was generated from a completely different
project file, with different stamps.
The .L5X import/export file consists of the components listed in the table. The
.L5X format for each component is described in subsequent chapters of this
reference manual.
Component
Description
Chapter
<RSLogix5000Content>
<Controller>
The controller
<DataTypes>
<Modules>
<AddOnInstructionDefinitions>
Add-On Instructions
<Tags>
Controller-scope tags
<Programs>
Programs
<Routines>
<Tasks>
Controller tasks
<ParameterConnection>
Parameter connections
<ParameterConnections>
<Trends>
<QuickWatchLists>
All quick watch lists configured in the controller project Chapter 16 Defining a Watch List Component on page 247
37
Chapter 1
Description
<component_type>
attribute_list
body
Internet
Explorer</component_type>Internet
ExplorerInternet Explorer
The .L5X file is an ASCII file that is structured by using Extensible Markup
Language (XML). In addition to being able to open and modify the .L5X file in a
text editor, such as Notepad, you can also view the contents of the file in Internet
Explorer and other tools that work with .XML files.
38
If you use:
Chapter 1
You see:
In the Internet browser, you can view only the file. Click the plus (+) and minus (-) to expand and collapse the viewable content. To edit the file,
open the file in a text editor.
39
Chapter 1
Component Descriptions
Descriptions of components are optional. Unlike internal file comments,
descriptions of components are imported. To add a description to a component,
add a <Description> start tag element as the first sub-element of the component
and then the description as a CDATA element in the body of the <Description>
element.
Component descriptions are brought into the project without being processed by
the XML parser for markup language. The description text is contained in a
CDATA element, a standard in the XML specification. A CDATA element
begins with the character sequence <![CDATA[ and ends with the character
sequence ]]>. None of the text within the CDATA element is interpreted by the
XML parser. The CDATA element preserves formatting so there is no need to use
control characters to enter formatted descriptions.
<Task Name="Task1" Type="PERIODIC" Rate="1000" Priority="10"
Watchdog="500" DisableUpdateOutputs="false"
InhibitTask="false">
<Description>
40
Chapter 1
<![CDATA[
This is a task description with
a line feed and a quote.
]]>
</Description>
</Task>
2#0000_0000_0000_1111
8#000_017
Decimal
15
16#000F
Ascii
$00$0F
Exponential
1.5000000e+01
Float
15.0
Data formats
The Logix Designer application imports the data in tags, modules, and data
structures (default values) with a <Data> element. You can import the <Data>
element in three different formats from the .L5X file: raw, L5K, and decorated
format. The format is indicated by a Format attribute.
<Tag Name="bINTtag" TagType="Base" DataType="INT"
Radix="Decimal">
<Data>05 00</Data>
<Data Format="L5K">
<![CDATA[5 ]]>
</Data>
Rockwell Automation Publication 1756-RM084U-EN-P - November 2015
41
Chapter 1
<Data Format="Decorated">
<DataValue DataType="INT" Radix="Decimal" Value="5"/>
</Data>
</Tag>
The application exports all data values in both raw and decorated data format to
the .L5X export file, with the exception that the InputTag under a module
connection does not have the raw data format exported.
If multiple formats are present in the .L5X file, they must appear in the order of
raw, L5K (if present), and decorated format. The data overwrites previous values if
different. For example, if the decorated data is manipulated in the .L5X file, the
decorated data values overwrite the raw data on import.
Raw data format
Raw data format is a hex dump of the data and includes hidden (config) data. It is
not intended to be readable. It is exported in the same format for all types of data
types. The raw data format is the default format. A format attribute is not present
if the <Data> element is in raw format.
Data Type
Atomic
42
Data Type
Atomic
Chapter 1
Atomic
43
Chapter 1
Data Type
44
Data Type
Tip:
Chapter 1
If the decorated data for a tag exceeds 16 KB, the decorated data format will not be exported. In this case, the raw data format will preserve the data values of the tag.
Force Values
Force values are indicated with an additional <ForceData> XML tag element for
both raw and L5K data formats. However, for decorated data, force values are
indicated with ForceValue attribute in the <DataValue> XML tag element of the
decorated data format.
Rockwell Automation Publication 1756-RM084U-EN-P - November 2015
45
Chapter 1
The .L5K import/export file contains these components. The L5K format for
each component is described in subsequent chapters of this reference manual.
Component
Description
See Chapter
CONTROLLER
The controller
DATATYPE
MODULE
ADD_ON_INSTRUCTION_
DEFINITION
Add-On Instructions
TAG
Controller-scope tags
PROGRAM
Program files
ROUTINE
FBD_ROUTINE
SFC_ROUTINE
ST_ROUTINE
TASK
Controller tasks
PARAMETER_CONNECTION
TREND
WATCH_LIST
CONFIG
Configuration information
Chapter 1
The header remarks (optional) and the version statement come before the
CONTROLLER component.
Import-Export
Version := RSLogix 5000 16.00
Owner
:= User Name, Rockwell Automation
Exported := Tue May 13 08:39:40 2014
IE_VER := 2.17;
Item
Description
Component_Type
The component.
component_name
Attributes
body
END_Component_Type
The import/export feature L5K format described in this document is based on the
formats specified by the IEC 1131-3 specification.
Convention
Description
< >
[ ]
user_value
LITERAL
"["
White space characters include spaces, tabs, carriage returns, new line, and form
feeds. These characters can occur anywhere in an import/export file, except in
keywords or names. If white space characters occur outside of descriptions, they
are ignored.
47
Chapter 1
and descriptions. Enter comments by starting the line (record) with REMARK
and a comma.
Component descriptions
Descriptions of components are optional. Unlike internal file comments,
descriptions are imported. The description of a component is added as an attribute
of the component in the L5K format. Place the description within double quotes.
See this example.
TASK Task1 (Description := "Hello World",
Type := PERIODIC, Rate := 1000,
Priority := 10, Watchdog := 500,
DisableUpdateOutputs := No)
END_TASK
To enter control characters in the description, precede the character with a dollar
sign ($). This table shows how to enter the supported control characters in a
description.
Character
Required Entry
$$
"
$Q
10 (line feed)
$L or $l
$N or $n
12 (form feed)
$P or $p
13 (carriage return)
$R or $r
9 (tab)
$T or $t
$xxxx
Display style
Tags and data types support a radix attribute that specifies how to display the
associated numerical information in the Logix Designer application.
48
2#0000_0000_0000_1111
8#000_017
Decimal
15
Project documentation
16#000F
Ascii
$00$0F
Exponential
1.5000000e+01
Float
15.0
Chapter 1
Trends
Controllers
Tasks
49
Chapter 1
The localized comments are exported in all formats, L5K, L5X, CSV, and TXT.
For more information on enabling a project to support multiple translations of
project documentation, see the online help.
50
Chapter 2
Introduction
Controller component
51
Chapter 2
[addoninstructiondefinition]
</AddOnInstructionDefinitions>
<Tags>
[tag]
</Tags>
<Programs>
[program]
</Programs>
<Tasks>
[task]
</Tasks>
<ParameterConnections>
[parameter_connection]
</ParameterConnections>
<CommPorts>
[commport]
</CommPorts>
<CST [attribute_list] />
<WallClockTime [attribute_list] />
<Trends>
[trend]
</Trends>
<QuickWatchLists>s
[watch_list]
</QuickWatchLists>
< InternetProtocol [Internet_Protocol_Attributes] />
<EthernetPorts>
<EthernetPort [Ethernet_Port_Attributes] />
<EthernetPort [Ethernet_Port_Attributes] />
</EthernetPorts>
<EthernetNetwork [Ethernet_Network_Attributes] />
</Controller>
Tip:
The L5X controller structure must be contained within an RSLogix5000Content root element begin tag (<RSLogix5000Content>) and end tag
(</RSLogix5000Content>). See the .L5X File Structure on page 37 in Chapter 1 for more information.
Chapter 2
[<PROGRAM declaration>]
[<TASK declaration>]
[PARAMETER_CONNECTION declaration]
[<TREND declaration>]
[<QUICK_WATCH declaration>]
PRIMARY_ACTION_SET <permission_set_name>
(IsPermissionSet := Yes) :=
encoded_cached_permissions;
END_PRIMARY_ACTION_SET
[<CONFIG controller objects declaration>]
END_CONTROLLER
Controller elements
The table describes the elements comprising a controller.
L5X Item
L5K Item
Description
N/A
controller_name
Description
Description
RedundancyInfo
N/A
Security
N/A
SafetyInfo
N/A
DataTypes
DATATYPE
Modules
MODULE
AddOnInstructionDefinitions
ADD_ON_INSTRUCTION_
DEFINITION
Add-On instructions
Tags
TAG
Controller-scope tags
Programs
PROGRAM
Programs
Tasks
TASK
Tasks
ParameterConnections
PARAMETER_CONNECTIONS
Trends
TREND
Controller trends
QuickWatchLists
QUICK_WATCH
CONFIG
PrimaryActionSet
PRIMARY_ACTION_SET
Cache of permissions for the Guest Users group that are associated with the specified logical
name or permission set.
53
Chapter 2
Controller attributes
Attribute
Description
Use
Name
ProcessorType
Specify the type of controller. (1756-L71, 1756-L71S, 1756-L72, 1756-L72S, 1756-L73, 1756-L73S,
1756-L74, 1756-L75, 1769-L16ER-BB1B, 1769-L18ER-BB1B, 1769-L18ERM-BB1B, 1769-L24ERQB1B, 1769-L24ER-QBFC1B, 1769-L27ERM-QBFC1B, 1769-L30ER, 1769-L30ERM, 1769-L30ER-NSE,
1769-L33ER, 1769-L33ERM, 1769-L36ERM, Emulator)
Major
L5K only. Specify the major revision number (1...127) of the controller.
MajorRev
L5X only. Specify the major revision number (1...127) of the controller.
MinorRev
L5X only. Specify the minor revision number (1...127) of the controller.
TimeSlice
ShareUnusedTimeSlice
Specify whether to share an unused timeslice or not. Type a 0 to not share; type a 1 to share.
PowerLossProgram
MajorFaultProgram
CommPath
Specify the devices in the communication path. The communication path ends with the controller
(\Backplane\1). This is exported only if you select manual configuration of the communication path
in RSLinx software.
CommDriver
Specify the type of communication driver. This is the name of the selected driver in RSLinx
software. This is exported only if you select manual configuration of the communication driver in
RSLinx software.
RedundancyEnabled
L5K only. Specify whether redundancy is used or not. Type a 0 to disable redundancy; type a 1 to
enable redundancy.
Enabled
KeepTestEditsOnSwitchOver
Specify whether to keep test edits on when a switchover occurs in a redundant system. Type a 0
not to keep test edits on; type a 1 to keep test edits on.
For L5X, this attribute is on the <RedundancyInfo> tag element. Type false or true.
IOMemoryPadPercentage
Specify the percentage (0...100) of I/O memory that is available to the system after the download
when configured for redundancy.
For L5X, this attribute is on the <RedundancyInfo> tag element.
DataTablePadPercentage
Specify the percentage (0...100) of the data table to reserve. If redundancy is not enabled, type 0. If
redundancy is enabled, type 50.
For L5X, this attribute is on the <RedundancyInfo> tag element.
SecurityCode
L5K only. Specify whether the RSI Security Server is enabled for the controller. Type 0 if the
controller is unsecured; type a 10-digit, non-zero value if the controller is secured.
Code
L5X only. Specify whether the RSI Security Server is enabled for the controller. Type 0 if the
controller is unsecured; type a 10-digit, non-zero value if the controller is secured.
This attribute is on the <Security> tag element.
54
Chapter 2
Attribute
Description
SFCExecutionControl
Specify whether the SFC executes the current active steps before returning control (CurrentActive)
or whether the SFC executes all threads until reaching a false transition (UntilFalse).
SFCRestartPosition
Specify whether the SFC restarts at the most recently executed step (MostRecent) or at the initial
step (InitialStep).
SFCLastScan
Specify how the SFC manages its state on a last scan. Select AutomaticReset, ProgrammaticReset,
or DontScan.
SerialNumber
L5K only. Specify the serial number of the controller. If a serial number is specified, it is imported
into the project regardless of the MatchProjectToController setting. Type a 32-bit, hexadecimal
number with the 16# prefix, such as 16#0012_E2BC.
ProjectSN
L5X only. Specify the serial number of the controller. If a serial number is specified, it is imported
into the project regardless of the MatchProjectToController setting. Type a 32-bit, hexadecimal
number with the 16# prefix, such as 16#0012_E2BC.
MatchProjectToController
Specify whether to be sure that the project matches the controller or not. Type Yes or No.
InhibitAutomaticFirmwareUpdate
Specify whether to inhibit the automatic update of controller firmware. Type a 0 to not inhibit;
type a 1 to inhibit.
CurrentProjectLanguage
DefaultProjectLanguage
ControllerLanguage
CanUseRPIFromController
Specify whether the consumed tags in the controller can connect to the producer with an RPI
provided by the producer (true or false).
SecurityAuthorityID
SecurityAuthorityURI
PermissionSet
Name of the set of permissions, configured in FactoryTalk Security, to apply to this object.
For L5X only, this attribute is on the <Security> tag element.
ChangesToDetect
Mask that specifies the controller events that you wish to track.
For L5X only, this attribute is on the <Security> tag element.
TrustedSlots
Mask defining the slots through which the trusted communication is permitted to the controller.
For L5X only, this attribute is on the <Security> tag element
PassThroughConfiguration
For L5K and L5X. Indicates the pass through state of documentation for the project.
Type Disabled, Enabled, or EnabledWithAppend
DownloadProjectDocumentationAndExtendedProperties
For L5K and L5X. Indicates the download project documentation configuration setting of the
project.
DownloadCustomProperties
For L5K and L5X. Indicates the download custom properties configuration setting of the project.
Only applies if the project is already configured to DownloadProjectDocumentation.
Rockwell recommends setting this attribute to false only during startup testing to improve
download speeds during commissioning testing. It should be set to true for the normal operating
state of a system. For L5X, the setting is true or false. For L5K, the setting is 1 (true) or 0
(false).
55
Chapter 2
For safety controllers, specify these attributes for the Controller component, in
addition to those previously described.
Controller attributes in a
safety controller system
Attribute
Description
SafetySignature
Specifies the safety signature control as defined in the controller properties. This value is exported only; it is ignored on import.
For L5X, this attribute is on the <SafetyInfo> tag element.
SafetyLocked
Displays whether the safety controller is locked or not. This value is exported only; it is ignored on import. This value will be Yes or No.
For L5X, this attribute is on the <SafetyInfo> tag element. Type true or false.
SafetyLockPassword
Specifies the lock password in the controller. This value is encrypted on export.
For L5X, this attribute is on the <SafetyInfo> tag element.
SafetyUnlockPassword
Specifies the unlock password in the controller. This value is encrypted on export.
For L5X, this attribute is on the <SafetyInfo> tag element.
SafetyTagMap
L5K only as an attribute. Specify the tags in the safety tag map. Place double quotes around the tags. Each entry must end with a comma
and carriage return. This is an example.
"StdTag1=SafeTag1,
StdTag2=SafTag2"
For L5X, a <SafetyTagMap> element is a subelement under the <SafeyInfo> element. Specify the tags in the safety tag map in the body
of the <SafetyTagMap> element Do not use quotes. Separate mappings with a comma and a space.
ConfigureSafetyIOAlways
Specify whether to configure safety I/O when replacing safety I/O. Type Yes or No.
For L5X, this attribute is on the <SafetyInfo> tag element. Type true or false.
SignatureRunModeProtect
Indicates whether you can modify the safety signature when in Run mode.
For L5X only, this attribute is on the <SafetyInfo> tag element.
Controller guidelines
56
Examples
Controller
ControlLogix
32
SoftLogix 5800
32
FlexLogix
CompactLogix
DriveLogix
Chapter 2
57
Chapter 2
Chapter 2
RedundancyEnabled := 0,
KeepTestEditsOnSwitchOver := 0,
DataTablePadPercentage := 50,
SecurityCode := 0,
ChangesToDetect := 16#ffff_ffff_ffff_ffff,
SFCExecutionControl := "CurrentActive",
SFCRestartPosition := "MostRecent",
SFCLastScan := "DontScan",
SerialNumber := 16#0000_0000,
MatchProjectToController := No,
CanUseRPIFromProducer := No,
InhibitAutomaticFirmwareUpdate := 0,
PassThroughConfiguration := EnabledWithAppend,
DownloadProjectDocumentationAndExtendedProperties := Yes)
MODULE Local (Parent := "Local",
ParentModPortId := 1,
CatalogNumber := "1756-L73",
Vendor := 1,
ProductType := 14,
ProductCode := 94,
Major := 22,
Minor := 1,
PortLabel := "RxBACKPLANE",
ChassisSize := 7,
Slot := 0,
Mode := 2#0000_0000_0000_0001,
CompatibleModule := 0,
KeyMask := 2#0000_0000_0001_1111)
END_MODULE
TAG
END_TAG
PROGRAM MainProgram (MAIN := "MainRoutine",
MODE := 0, DisableFlag := 0)
TAG
END_TAG
ROUTINE MainRoutine
END_ROUTINE
END_PROGRAM
TASK MainTask (Type := CONTINUOUS,
Rate := 10, Priority := 10, Watchdog := 500,
DisableUpdateOutputs := No, InhibitTask := No)
MainProgram;
END_TASK
PARAMETER_CONNECTION
END_PARAMETER_CONNECTION
Rockwell Automation Publication 1756-RM084U-EN-P - November 2015
59
Chapter 2
CONFIG ASCII(XONXOFFEnable := 0,
DeleteMode := 0, EchoMode := 0,
TerminationChars := 65293, AppendChars := 2573,
BufferSize := 82)
END_CONFIG
CONFIG ControllerDevice END_CONFIG
CONFIG CST(SystemTimeMasterID := 0) END_CONFIG
CONFIG DF1(DuplicateDetection := 1,
ErrorDetection := BCC Error, EmbeddedResponseEnable := 0,
DF1Mode := Pt to Pt, ACKTimeout := 50,
NAKReceiveLimit := 3, ENQTransmitLimit := 3,
TransmitRetries := 3, StationAddress := 0,
ReplyMessageWait := 5, PollingMode := 1,
MasterMessageTransmit := 0, NormalPollNodeFile := "<NA>",
NormalPollGroupSize := 0, PriorityPollNodeFile := "<NA>",
ActiveStationFile := "<NA>", SlavePollTimeout := 3000,
EOTSuppression := 0, MaxStationAddress := 31,
TokenHoldFactor := 1, EnableStoreFwd := 0,
StoreFwdFile := "<NA>")
END_CONFIG
CONFIG FileManager END_CONFIG
CONFIG SerialPort(BaudRate := 19200,
Parity := No Parity, DataBits := 8 Bits of Data,
StopBits := 1 Stop Bit, ComDriverId := DF1,
PendingComDriverId := DF1, RTSOffDelay := 0,
RTSSendDelay := 0, ControlLine := No Handshake,
PendingControlLine := No Handshake,
RemoteModeChangeFlag := 0,
PendingRemoteModeChangeFlag := 0,
ModeChangeAttentionChar := 27,
PendingModeChangeAttentionChar := 27,
SystemModeCharacter := 83,
PendingSystemModeCharacter := 83,
UserModeCharacter := 85,
PendingUserModeCharacter := 85,
DCDWaitDelay := 0)
END_CONFIG
CONFIG WallClockTime(LocalTimeAdjustment := 0, TimeZone := 0)
CONFIG InternetProtocol [(Internet_Protocol_Attributes)]
END_ CONFIG
CONFIG EthernetPort1 [(Internet_Protocol_Attributes)]
60
Chapter 2
END_ CONFIG
CONFIG EthernetPort2 [(Internet_Protocol_Attributes)]
CONFIG EthernetNetwork [(Ethernet_Network_Attributes)]
END_CONFIG
END_CONTROLLER
L5K Safety CONTROLLER Example
CONTROLLER example_safety_controller (Description := "Safety
Project",
ProcessorType := "1756-L73S",
Major := 22,
TimeSlice := 20,
ShareUnusedTimeSlice := 1,
RedundancyEnabled := 0,
KeepTestEditsOnSwitchOver := 0,
DataTablePadPercentage := 50,
SecurityCode := 0,
ChangesToDetect := 16#ffff_ffff_ffff_ffff,
SFCExecutionControl := "CurrentActive",
SFCRestartPosition := "MostRecent",
SFCLastScan := "DontScan",
SerialNumber := 16#0000_0000,
MatchProjectToController := No,
CanUseRPIFromProducer := No,
SafetyLocked := No,
SignatureRunModeProtect := No,
ConfigureSafetyIOAlways := No,
InhibitAutomaticFirmwareUpdate := 0,
PassThroughConfiguration := EnabledWithAppend,
DownloadProjectDocumentationAndExtendedProperties := Yes)
MODULE Local (Parent := "Local",
ParentModPortId := 1,
CatalogNumber := "1756-L73S",
Vendor := 1,
ProductType := 14,
ProductCode := 148,
Major := 22,
Minor := 1,
PortLabel := "RxBACKPLANE",
ChassisSize := 7,
Slot := 0,
Mode := 2#0000_0000_0000_0001,
CompatibleModule := 0,
KeyMask := 2#0000_0000_0001_1111,
SafetyNetwork := 16#0000_3c77_0315_5105)
END_MODULE
MODULE example_safety_controller:Partner
Rockwell Automation Publication 1756-RM084U-EN-P - November 2015
61
Chapter 2
Chapter 2
END_TASK
PARAMETER_CONNECTION
END_PARAMETER_CONNECTION
CONFIG ASCII(XONXOFFEnable := 0,
DeleteMode := 0, EchoMode := 0,
TerminationChars := 65293,
AppendChars := 2573, BufferSize := 82)
END_CONFIG
CONFIG ControllerDevice END_CONFIG
CONFIG CST(SystemTimeMasterID := 0) END_CONFIG
CONFIG DF1(DuplicateDetection := 1,
ErrorDetection := BCC Error,
EmbeddedResponseEnable := 0,
DF1Mode := Pt to Pt, ACKTimeout := 50,
NAKReceiveLimit := 3, ENQTransmitLimit := 3,
TransmitRetries := 3, StationAddress := 0,
ReplyMessageWait := 5, PollingMode := 1,
MasterMessageTransmit := 0,
NormalPollNodeFile := "<NA>",
NormalPollGroupSize := 0,
PriorityPollNodeFile := "<NA>",
ActiveStationFile := "<NA>",
SlavePollTimeout := 3000, EOTSuppression := 0,
MaxStationAddress := 31, TokenHoldFactor := 1,
EnableStoreFwd := 0, StoreFwdFile := "<NA>")
END_CONFIG
CONFIG FileManager END_CONFIG
CONFIG SerialPort(BaudRate := 19200,
Parity := No Parity, DataBits := 8 Bits of Data,
StopBits := 1 Stop Bit, ComDriverId := DF1,
PendingComDriverId := DF1, RTSOffDelay := 0,
RTSSendDelay := 0, ControlLine := No Handshake,
PendingControlLine := No Handshake,
RemoteModeChangeFlag := 0,
PendingRemoteModeChangeFlag := 0,
ModeChangeAttentionChar := 27,
PendingModeChangeAttentionChar := 27,
SystemModeCharacter := 83,
PendingSystemModeCharacter := 83,
UserModeCharacter := 85,
PendingUserModeCharacter := 85, DCDWaitDelay := 0)
END_CONFIG
Rockwell Automation Publication 1756-RM084U-EN-P - November 2015
63
Chapter 2
CONFIG WallClockTime(LocalTimeAdjustment := 0,
TimeZone := 0)
CONFIG InternetProtocol [(Internet_Protocol_Attributes)]
END_ CONFIG
CONFIG EthernetPort1 [(Internet_Protocol_Attributes)]
END_ CONFIG
CONFIG EthernetPort2 [(Internet_Protocol_Attributes)]
CONFIG EthernetNetwork [(Ethernet_Network_Attributes)]
END_CONFIG
END_CONTROLLER
64
Chapter 3
Introduction
Datatype component
Datatype components define the data types used in the logic you export.
Datatype elements
L5X Item
L5K Item
Description
N/A
DataType_name
Description
Description
65
Chapter 3
L5X Item
L5K Item
Description
EngineeringUnit
EngineeringUnit
(optional) User-specified description of the unit of the value, such as feet, gallons, and kilos.
Members
member_definitions
Datatype attributes
Attribute
Description
Name
Family (L5X)
FamilyType (L5K)
Class
Datatype member
Chapter 3
L5K Item
Description
N/A
TypeName
N/A
MemberName
Description
Description
EngineeringUnit
EngineeringUnit
(optional) User-specified description of the unit of the value, such as feet, gallons, and kilos.
State0
State0
(optional) For Boolean member only. User-specified description of what the Zero state of the
Boolean value is.
State1
State1
(optional) For Boolean member only. User-specified description of what the One state of the
Boolean value is.
N/A
BitName
N/A
HostMemberName
N/A
BitPosition
Description
Name
Dimension
L5X only. Specify the dimensions of the member. Type 0 if atomic or a non-zero value for an array.
Radix
Hidden
Specify if the member is a hidden member of the structure. Type 1 or 0 (or true or false for L5X)
Rockwell Automation Publication 1756-RM084U-EN-P - November 2015
67
Chapter 3
Attribute
Description
Target
BitNumber
Max
(optional) User-specified maximum value for the member. Only valid for members with non-Boolean atomic datatypes.
Min
(optional) User-specified minimum value for the member. Only valid for members with non-Boolean atomic datatypes.
External Access
Specify the external access outside of the controller to the member. Specify Read/Write, Read Only, or None.
Bit members
All data types are allocated in 8-bit boundaries. A single bit of storage is not
allowed, so a member cannot be a BOOL data type. To access a single bit, use the
BIT declaration. BIT allows access to a single bit within a host member
(a non-bit member).
For example, create a user-defined datatype called MyBits and a tag called MyTag
of type MyBits
68
Chapter 3
Bit members cannot be defined before their host members. Note that BitPosition
zero is the least significant bit.
This is the datatype syntax for this example in the L5K format.
DATATYPE MyBits (FamilyType := NoFamily)
SINT ZZZZZZZZZZMyBits0 (Hidden := 1);
BIT MyBit0 ZZZZZZZZZZMyBits0 : 0 (Radix := Binary);
BIT MyBit1 ZZZZZZZZZZMyBits0 : 1 (Radix := Binary);
END_DATATYPE
Important:
There must be a space between the host member name, colon, and the bit
position because type names can contain a colon (for example, I/O structures). The
space indicates where the type name ends.
This is the datatype syntax for this example in the L5X format.
Datatype guidelines
69
Chapter 3
Examples
ALARM_ANALOG
ALARM_DIGITAL
AXIS types
COORDINATE_SYSTEM
MOTION_GROUP
MESSAGE
MODULE
70
Chapter 4
Introduction
Module component
A module component defines any modules used by logic you export. For example,
the module component can contain I/O modules referenced by I/O tags, modules
accessed by GSV/SSV instructions, or controllers referenced in consumed tags.
71
Chapter 4
Module_Attributes)]
[ConfigData := <initial_value>;]
[ConfigScript:=<initial_value>;]
[ExtendedProp := <text>]
[connection_list]
END_MODULE
Module elements
L5X Item
L5K Item
Description
N/A
device_name
Description
Description
EKey
N/A
Ports
N/A
Port information for the module, which is the physical connector for the module that
attaches the module to the bus. Each module has at least one port.
ConfigTag or ConfigData
ConfigData
ExtendedProperties
ExtendedProp
connections
connection_list
(zero or more CONNECTION entries)
Module attributes
Attribute
Description
Name
Parent
L5K only. If this module is a child to another module, specify the name of the parent module. The parent module must be defined
before any child module.
ParentModule
L5X only. If this module is a child to another module, specify the name of the parent module. The parent module must be defined
before any child module.
ParentModPortID (L5K)
ParentModPortID (L5X)
If this module is a child to another module, specify the number of the port on the parent module that connects to this child module.
The parent module must be defined before any child module.
CatalogNumber
72
Attribute
Description
Vendor
Chapter 4
For L5X, this attribute is on the <EKey> element if the State attribute has a value of Custom.
ProductType
ProductCode
Major
Minor
For L5X, this attribute is on the <EKey> element if the State attribute has a value of Custom.
For L5X this attribute is on the <EKey> element if the State attribute has a value of Custom.
UserDefinedVendor
Specify the vendor of a non-Allen-Bradley module. Type a number to indicate the vendor.
UserDefinedProductType
UserDefinedProductCode
UserDefinedMajor
UserDefinedMinor
PortLabel
L5K only. Specify the port used to reach this module. The port label is either RxBACKPLANE for modules in a chassis or a text string for
modules on a network.
ChassisSize
Slot
L5K only. Specify the slot number where the module is in the chassis.
For L5X, use the Address attribute on the <Port> element.
NodeAddress
L5K only. Specify the node address (1...99) on the network with the Ethernet IP address or host name).
For L5X, use the Address attribute on the <Port> element.
Group
L5K only. If the module is a remote I/O module, specify the starting group (0...7). For a block-transfer module, this is the module group
number under the remote I/O adapter.
CommMethod
ConfigMethod
Mode
For:
Do not inhibit the module and a fault in the module does not cause a major fault in the controller
Both inhibit the module and a fault in the module causes a major fault in the controller
73
Chapter 4
Attribute
Description
CompatibleModule
L5K only. Specify whether to connect to a compatible module based on the minor revision (value = 1) or an exact match or disabled
keying of the module (value = 0).
If you specify exact for KeyMask, set CompatibleModule to 0.
If you specify compatible for KeyMask, set CompatibleModule to 1.
KeyMask
L5K only. Specify whether to connect to the exact module that matches the electronic keying information of vendor, product code,
product type, major revision, and minor revision. No keying will connect to any module.
Specify
To:
2#0000_0000_0000_0000
Disable keying
2#0000_0000_0001_1111
2#0000_0000_0001_1111
The values for compatible module and for exact match are the same because this attribute is used in conjunction with
CompatibleModule to distinguish between compatible module or exact match.
State
L5X only. This attribute is on the <EKey> element. Type CompatibleModule, ExactMatch, Disabled, or Custom.
PrimCxnInputSize
Specify the size of the input data associated with the primary connection (0...500 bytes).
For L5X, this attribute is on the <Communications> element.
PrimCxnOutputSize
Specify the size of the output data associated with the primary connection (0...496 bytes).
For L5X, this attribute is on the <Communications> element.
SecCxnInputSize
Specify the size of the input data associated with the secondary connection (0...500 bytes). Typically, there is one I/O connection on a
module (primary connection). If there are two, the second connection is the secondary connection.
For L5X, this attribute is on the <Communications> element.
SecCxnOutputSize
Specify the size of the output data associated with the secondary connection (0...496 bytes). Typically, there is one I/O connection on a
module that is the primary connection. If there are two, the second connection is the secondary connection.
For L5X, this attribute is on the <Communications> element.
ChABaud
L5K only. For a 1756-DHRIO module, specify the baud rate for channel A. Type 57.6, 115.2, or 230.4.
For L5X, use the Baud attribute on the <Bus> element.
ChBBaud
L5K only. For a 1756-DHRIO module, specify the baud rate for channel B. Type 57.6, 115.2, or 230.4.
For L5X, use the Baud attribute on the <BusControlNet> elemEtherNet/IPent.
DtlsFileName
Specify the file name associated with a DriveExecutive project. DriveExecutive configures drives on ControlNet and EtherNet/IP
networks.
ConfigCode
Specify the value that represents the drive rating of the drive. Select this rating on the Power tab in a DriveExecutive project for drives
on ControlNet and EtherNet/IPnetworks.
ControlNetSignature
This value (hexadecimal) is exported only for the purpose of doing a file compare. This value is ignored on import.
SafetyNetwork
If the module is in a safety controller system, specify the 6-byte hexadecimal number of the safety network.
SafetyEnabled
A flag only in modules that can be configured as safety or standard. Type true if the module is a safety module.
RSNetWorxFileName
L5K only. Specify the file name of an associated RSNetWorx project file.
Inhibited
L5X only. If the module is inhibited, type true. If the module is not inhibited, type false.
74
Chapter 4
Attribute
Description
MajorFault
L5X only. Specify if the controller generates a major fault if the connection to the module is lost in run mode (true or false).
ConfigSize
L5X only. This attribute is on the <ConfigTag> or <ConfigData> element. Specify the size of the Config Tag or Config Data.
Id
L5X only. This attribute is on the <Port> element. It uniquely identifies the port.
Address
L5X only. This attribute is on the <Port> element. Specify the node number, slot number, or IP address/host name.
Type
L5X only. This attribute is on the <Port> element. Defines the type of the module
Upstream
L5X only. This attribute is on the <Port> element. It is determined by the I/O topology of the module. Specify true for Upstream or
false for downstream.
NATActualAddress
The IP address of a safety I/O module or controller specified by the user as the actual address on the network of the module.
For L5X, this attribute is on the <Port> element.
ConnectorOffset
Width
Size
L5X only. This attribute is on the <Bus> element. For a sizable chassis, specify the chassis size.
In L5K, this attribute is the ChassisSize attribute on the MODULE.
Baud
L5X only. This attribute is on the <Bus> element. Specify the baud rate (57.6, 115.2, or 230.4).
In L5K, this attribute is the ChABaud or ChBBaud attribute on the MODULE.
ShutdownParentOnFault
Indicates the parent device is shut down when this module faults.
DrivesADCMode
DrivesADCEnabled
UserDefinedCatalogNumber
Constant
Specify whether the value is a constant value or a dynamic value. For L5K, specify yes for a constant value or no for a dynamic value.
For L5X, specify true or false.
PermissionSet
Name of the set of permissions, configured in FactoryTalk Security, to apply to this object.
Module attributes in a
safety controller system
In a safety controller system, the module component for the safety partner follows
the module component for the primary safety controller. All of the attributes of
the safety partner are determined based on those of the primary safety controller.
The module component for the primary safety controller follows the structure
previously described. The safety partner module uses these attributes:
75
Chapter 4
Parent
PortLabel
ParentModPortID
Slot
CatalogNumber (1756-LSP)
CompatibleModule
Vendor
Key
ProductType
Mask
ProductCode
SafetyNetwork
Major
SafetyEnabled
Minor
NATActualAddress
Mode
Module connection
76
Chapter 4
Connection elements
L5X Item
L5K Item
Description
N/A
connection_name
InputTag or InputData
InputData
InputTag or InputData
InputForceData
OutputTag or OutputData
OutputData
OutputTag or OutputData
OutputForceData
For details on the data in the connection list, see the user manual for the I/O
module. The connection list data depends on the I/O module and the
configuration for that module.
In L5K format, forces appear as arrays of bytes under the InputForceData and
OutputForceData attributes of the connection list. In L5X format, forces appear
as arrays of bytes under the <ForceData> elements in the <InputTag> and
<OutputTag> elements.
Important:
Description
Name
Rate
L5K only. Specify the requested packet interval (RPI) rate in microseconds.
RPI
InputCxnPoint
Specify the input connection point for the primary connection (0...255).
Rockwell Automation Publication 1756-RM084U-EN-P - November 2015
77
Chapter 4
Attribute
Description
InputSize
OutputCxnPoint
Specify the output connection point for the primary connection (0...255).
OutputSize
Unicast
Specify if the EtherNet/IP connection is unicast. For L5K, specify yes for unicast or no to remain multicast.
For L5X, specify true or false.
On export, only appears if the path to the unicast supported I/O module crosses an EtherNet/IP network.
EventID
ControlNetScheduled
Specify how the connection is scheduled. Specify yes to schedule over ControlNet or no to connect
unscheduled. This attribute is only used if the path from the module to the controller uses ControlNet. For
L5X format specify true or false.
Type
L5X only. Specify the type of connection: Input, Output, MotionSync, MotionAsync, MotionEvent,
SafetyInput, or SafetyOutput.
Priority
InputConnectionType
InputProductionTrigger
ConnectionPath
InputTagSuffix
OutputTagSuffix
Constant
Specify whether the value for an Input or an Output parameter is a constant value or it can change. For
L5K, specify yes for a constant value or no for a dynamic value. For L5X, specify true or false.
PermissionSet
Name of the set of permissions, configured in FactoryTalk Security, to apply to this Input/Output Tag.
Description
TimeoutMultiplier
Specify the timeout multiplier (default = 2) for a safety controller system. This value determines the RPIs of time to wait
for a packet before declaring a time out. This translates into the number of messages that may be lost before declaring a
connection error. A Timeout Multiplier of 1 indicates that no messages may be lost; that is, there must be a packet every
RPI. A Timeout Multiplier of 2 indicates that 1 message may be lost; that is, as long as a packet is seen in 2 times the RPI,
no time-out will occur. Type a number from 1...4.
78
Chapter 4
Attribute
Description
NetworkDelayMultiplier
Specify the network delay multiplier (default = 100%) for a safety controller control system. This value lets you reduce
or increase the connection reaction time limit in cases where the transport time of the message is significantly less or
more than the RPI. This may be the case when the RPI of an output connection is the same as a lengthy task period. Type
a percentage from 10...600.
ReactionTimeLimit
Specify the connection reaction time limit (0...5500032) for a safety controller system. The Logix Designer application
calculates the connection reaction time limit as a function of the RPI, timeout multiplier, and network delay multiplier.
The connection reaction time limit is automatically recalculated if any of the values change.
MaxObservedNetworkDelay
L5X only. The MaxObservedNetworkDelay is a measure of the longest time data for a safety connection is delayed from
transporting the safety packets over the network. This attribute is exported for informational purposes only and is
ignored on import.
Module guidelines
Examples
79
Chapter 4
80
Chapter 4
81
Chapter 4
82
Chapter 4
83
Chapter 4
84
Chapter 4
85
Chapter 5
Introduction
This chapter explains the overall structure of the Add-On Instruction component.
Add-On Instruction
component
87
Chapter 5
</AddOnInstructionDefintion>
</AddOnInstructionDefinitions>
L5K Item
Description
N/A
name
Description
Description
SignatureHistory
HISTORY_ENTRY
AdditionalHelpText
N/A
For L5X, specify help text for the user help on the Add-On Instruction.
Parameters
PARAMETERS
LocalTags
LOCAL_TAGS
Routines
add_on_instruction_
routines
Logic that comprises the Add-On Instruction. Logic can be relay ladder, function block, or
structured text.
ScanModeRoutine
SCAN_MODE_ROUTINE
Optional element that has the logic for a Prescan routine, Postscan routine, or EnableInFalse
routine.
Description
Name
Class
Specify the class of the Add-On Instruction. This attribute applies only to safety projects. Type Standard or Safety.
88
Chapter 5
Attribute
Description
Revision
Specify the revision of the Add-On Instruction, in the form of MajorRevision.MinorRevision. Each revision number can be
1...65,535. If there is no period, the number is treated as a major revision only.
RevisionExtension
RevisionNote
Vendor
Specify the name of the vendor (40 characters maximum) of the Add-On Instruction.
ExecutePrescan
Specify whether to execute the Prescan routine after the Logic is prescanned. Type 1 for yes; type 0 for no. The default is
1 if a Prescan routine exists.
ExecutePostscan
Specify whether to execute the Postscan routine after the Logic is postscanned. Type 1 for yes; type 0 for no. The default
is 1 if a Postscan routine exists.
ExecuteEnableInFalse
Specify whether to execute the EnableInFalse routine when enable is false. Type 1 for yes; type 0 for no. The default is 1
if an EnableInFalse routine exists.
CreatedDate
CreatedBy
EditedDate
EditedBy
SoftwareRevision
Specify the revision of the application last used to edit the Add-On Instruction. The default is the currently open version
of the application.
AdditionalHelpText
PermissionSet
Name of the set of permissions, configured in FactoryTalk Security, to apply to this object.
Description
Logic
Prescan
Postscan
EnableInFalse
For example, this structure for an Add-On Instruction uses all four routines.
ADD_ON_INSTRUCTION_DEFINITION Example (attributes)
PARAMETERS
Rockwell Automation Publication 1756-RM084U-EN-P - November 2015
89
Chapter 5
add_on_instruction_parameters
END_PARAMETERS
LOCAL_TAGS
add_on_instruction_local_tags
END_LOCAL_TAGS
FBD_ROUTINE Logic (attributes)
function_block_routine_logic
END_FBD_ROUTINE
ST_ROUTINE Prescan (attributes)
structured_text_routine_logic
END_ST_ROUTINE
ROUTINE Postscan (attributes)
ladder_logic_routine_logic
END_ROUTINE
FBD_ROUTINE EnableInFalse (attributes)
function_block_routine_logic
END_FBD_ROUTINE
END_ADD_ON_INSTRUCTION_DEFINITION
Parameters
The parameter component defines Input, Output, and InOut type parameters in
the Add-On Instruction. For L5X format, the default data for the local tag is
defined with a <DefaultData>. The <DefaultData> element is defined the same
as a <Data> element. See Chapter 1 Data Formats on page 41 for more
information on the <Data> element format.
The system defined EnableIn input parameter and EnableOut output parameter
are defined in the export format so the description may be modified in a .L5K or
.L5X format file. The rest of the attributes for the EnableIn and EnableOut
parameters that are system defined will be ignored by import even though they are
present in the import file.
Chapter 5
<Comments>
<Comment Operand="specifier">
<![CDATA[ comment_text ]]>
</Comment>
</Comments>
<EngineeringUnits>
<EngineeringUnit Operand="specifier">
<![CDATA[ engineering_unit_text ]]>
</EngineeringUnit>
</EngineeringUnits>
<Mins>
<Min Operand="specifier"> min_value </Min>
</Mins>
<Maxes>
<Max Operand="specifier"> max_value </Max>
</Maxes>
<State0s>
<State0 Operand="specifier">
<![CDATA[ state0_text ]]>
</State0>
</State0s>
<State1s>
<State1 Operand="specifier">
<![CDATA[ state1_text ]]>
</State1>
</State1s>
<DefaultData [DefaultData_Attributes]>
data
</DefaultData>
</Parameter>
</Parameters>
91
Chapter 5
Parameter elements
L5X Item
L5K Item
Description
N/A
name
N/A
datatype
N/A
array_specification
Description
DefaultData
N/A
Comment
Comment
EngineeringUnit
EngineeringUnit
(optional) User specified description of what the unit of the value is (that is, feet, gallons,
kilos).
Can specify EngineeringUnit <specifier>
Where the specifier is:
.bitnumber - for a bit in the parameter
[element] - for an array element of the parameter
.membername - for a structure member of the parameter
There can be multiple engineering unit elements.
Max
Max
(optional) User specified maximum value about qualified sub-regions of the parameter.
Only valid for a parameters sub-regions, which is a non-Boolean atomic datatypes.
Can specify Max <specifier>
Where the specifier is:
.bitnumber - for a bit in the parameter
[element] - for an array element of the parameter
.membername - for a structure member of the parameter
There can be multiple max elements.
92
Chapter 5
L5X Item
L5K Item
Description
Min
Min
(optional) User specified minimum value about qualified sub-regions of the parameter. Only
valid for a parameters sub-regions, which is a non-Boolean atomic datatypes.
Can specify Min <specifier>
Where the specifier is:
.bitnumber - for a bit in the parameter
[element] - for an array element of the parameter
.membername - for a structure member of the parameter
There can be multiple min elements.
State0
State0
(optional) for Boolean parameters or sub-regions only. User specified description of what
the Zero state of the Boolean value is.
Can specify State0 <specifier>
Where the specifier is:
.bitnumber - for a bit in the parameter
[element] - for an array element of the parameter
.membername - for a structure member of the parameter
There can be multiple state0 elements.
State1
State1
(optional) for Boolean parameters or sub-regions only. User specified description of what
the One state of the Boolean value is.
Can specify State1 <specifier>
Where the specifier is:
.bitnumber - for a bit in the parameter
[element] - for an array element of the parameter
.membername - for a structure member of the parameter
There can be multiple state1 elements.
Parameters attributes
Attribute
Description
Name
DataType
TagType
93
Chapter 5
Attribute
Description
AliasFor
L5X only. Name of the base tag that the alias parameter references.
Specify LocaTag<specifier>
Where the specifier is a bit (.bitnumber), array element ([element]), or structure member (.membername) of the tag, or
any combination such as [7].Input.0.
Dimensions
Usage
Radix
Required
Specify whether the parameter is required. Type 1 if the parameter is required; type 0 if the parameter is optional.
Constant
Specify whether the value for an Input or an Output parameter is a constant value or it can change. For L5K, specify yes
for a constant value or no for a dynamic value. For L5X, specify true or false.
ExternalAccess
Specify the external access, outside of the controller, to the parameter. Specify Read/Write, Read Only, or None.
Max
(optional) User specified maximum value for the parameter. Only valid for parameter with non-Boolean atomic
datatype.
Min
(optional) User specified minimum value for the parameter. Only valid for parameter with non-Boolean atomic datatype.
Visible
Specify whether the parameter is visible on the display for the instructions. Type 1 if the parameter is visible; type 0 if
the parameter is not visible.
DefaultData
L5K only. Specify a default value for the parameter. This attribute is not available if you specify Usage as InOut.
In L5X, the parameter default data is an element of the L5X structure.
Signature history
The Signature History stores history entries for an Add-On Instruction. There
can be 06 entries that are exported in the order they are created. The order in
the file is used during import to store them. If you edit the file manually, that
order is maintained.
94
Chapter 5
Description
User
Timestamp
Specifies the timestamp when the entry was created. The value is a UTC date time, such as 2009-04-01T12:08:00.000Z.
SignatureID
Specifies the signature ID for the Add-On Instruction when the entry was created. The value is an 8-digit uppercase hex number, such as 8F44EBA3.
Description
Local tags
The local tags component defines local tags in the Add-On Instruction. The L5K
format for defining a local tag is the same format for defining a tag in a program or
at controller scope For more details on defining a tag, see Chapter 6 Defining a
Tag Component on page 107. For L5X format, you specify the default data for the
local tag with a <DefaultData> element. Define the <DefaultData> element the
same as a <Data> element. See Chapter 1 Data Formats on page 41 for more
information on the <Data> element format.
95
Chapter 5
<Comment Operand="specifier">
<![CDATA[ comment_text ]]>
</Comment>
</Comments>
<EngineeringUnits>
<EngineeringUnit Operand="specifier">
<![CDATA[ engineering_unit_text ]]>
</EngineeringUnit>
</EngineeringUnits>
<Mins>
<Min Operand="specifier"> min_value </Min>
</Mins>
<Maxes>
<Max Operand="specifier"> max_value </Max>
</Maxes>
<State0s>
<State0 Operand="specifier">
<![CDATA[ state0_text ]]>
</State0>
</State0s>
<State1s>
<State1 Operand="specifier">
<![CDATA[ state1_text ]]>
</State1>
</State1s>
<DefaultData [DefaultData_Attributes]>
data
</DefaultData>
</LocalTag>
</LocalTags>
Description
Name
96
Chapter 5
Attribute
Description
DataType
Dimensions
Radix
ExternalAccess
Specify the external access, outside of the controller, to the local tag. Specify Read/Write, Read Only, or None.
Max
(optional) User specified maximum value for the local tag. Only valid for local tag with non-Boolean atomic datatype.
Min
(optional) User specified minimum value for the local tag. Only valid for local tag with non-Boolean atomic datatype.
DefaultData
These examples are for protected (encoded) and unprotected (clear text) codes for
Add-On Instructions.
If the project contains high-integrity Add-On Instructions, those Add-On
Instructions always appear as encoded data components when you export
the project.
See Exporting Source-protected Logic on page 28 on page 33 for procedures.
97
Chapter 5
L5K Item
Description
type
type
name
name
SignatureID
SignatureID
SignatureTimestamp
SignatureTimestamp
SafetySignatureID
SafetySignatureID
N/A
other_attributes
Attributes of the Add-On Instruction that are not protected during export.
N/A
encoded_data
Important:
98
When the Add-On Instruction is source-protected, the encoded_data information is encrypted. If you
modify this encrypted information, you cannot re-import the Add-On Instruction.
Chapter 5
99
Chapter 5
Add-On Instruction
Guidelines
100
If the operand is not a qualified tag or literal value, the Add-On Instruction
is not verified.
The X and Y grid locations are a relative position from the upper-left corner
of the sheet. X is the horizontal position; Y is the vertical position.
Chapter 5
101
Chapter 5
Chapter 5
103
Chapter 5
104
Chapter 5
105
Chapter 5
106
Chapter 6
Introduction
Tag component
The tag component defines the tags associated with the logic you selected or
within the program you selected. Within a tag list in the L5K format, message and
motion tags must follow all non-motion tags, and axis tags must follow motion
group tag. Tags may appear in any order in the L5X format.
Important:
For detailed information about atomic and structure tags and their
supported attributes and ranges, see the Logix5000 Controller Common
Procedures Programming Manual, publication 1756-PM001.
107
Chapter 6
Tag elements
L5X Item
L5K Item
Description
N/A
tag_name
N/A
alias
Specify tag<specifier>
Where the specifier is a bit (.bitnumber), array element ([element]), or structure member
(.membername) of the tag.
In L5X, use an AliasFor attribute on the <Tag> element.
108
L5X Item
L5K Item
Description
N/A
x, y, z
Chapter 6
In an L5K array tag, there cannot be any white space between the type and array definition.
There must be a space between the tag name and the colon and another space between
that same colon and the type name.
In L5X, use a Dimension attribute on the <Tag> element.
ConsumeInfo
N/A
ProduceInfo
N/A
Description
Description
Comment
Comment
Data
Tag data.
value
In L5X, this element can also contain additional attributes for other tag types.
EngineeringUnit
EngineeringUnit
(optional) User-specified description of what the unit of the value is, in feet, gallons, or
kilos.
Can specify EngineeringUnit <specifier>
Where the specifier is:
.bitnumber - for a bit in the tag
[element] - for an array element of the tag
.membername - for a structure member of the tag
There can be multiple engineering unit elements.
Max
Max
109
Chapter 6
L5X Item
L5K Item
Description
Min
Min
State0
State0
State1
State1
(optional) For Boolean parameters (or sub-regions) only. User-specified description of what
the One state of the Boolean value is.
Can specify EngineeringUnit <specifier>
Where the specifier is:
.bitnumber - for a bit in the tag
[element] - for an array element of the tag
.membername - for a structure member of the tag
There can be multiple state1 elements.
ForceData
tag_force_data
Tag attributes
Attribute
Description
Name
TagType
110
Chapter 6
Attribute
Description
DataType
Type of tag.
Atomic types: BOOL, SINT, INT, DINT, LINT, REAL
String types: STRING
Predefined types such as: AXIS_CONSUMED, AXIS_GENERIC_DRIVE, AXIS_SERVO, AXIS_SERVO_DRIVE, AXIS_VIRTUAL,
CAM, CAM_PROFILE, CONTROL, COORDINATE_SYSTEM, COUNTER, MESSAGE, MOTION_GROUP
Equipment phase types: PHASE, PHASE_INSTRUCTION
Safety types: CONNECTION_STATUS and unique types for each safety instruction
Function block types: unique type for each function block
Sequential function chart: SFC_ACTION, SFC_STEP, SFC_STOP
User-defined data types.
Add-On Instruction defined data types.
Module-defined data types.
AliasFor
L5X only. Name of the base tag that the alias tag references.
Specify tag<specifier>
Where the specifier is a bit (.bitnumber), array element ([element]), or structure member (.membername) of the tag, or
any combination such as [7].Input.0.
Dimensions
Class
Specify the class of the tag. This attribute applies only to safety controller projects. Type Standard or Safety.
Radix
Specify the display style as decimal, hex, octal, binary, exponential, float, ASCII, or date/time. (LINT only).
PLCMappingFile
If this tag is mapped to a PLC controller, specify the file number, which can be any positive number.
For L5X, this attribute is on the <ProduceInfo> element.
PLC2Mapping
If this tag is mapped to a PLC-2 file, set this attribute to 1. If this tag is not mapped to a PLC-2 file, set this attribute to 0.
ProgrammaticallySend
EventTrigger
If the project programmatically sends an event trigger, set this attribute to 1. Otherwise, set this attribute to 0.
UnicastPermitted
Usage
Specify how an Equipment Phase program uses a tag. This attribute applies only to tags that are program-scoped to
an Equipment Phase program. Type Input, Output, or Normal.
Specify how a parameter is used. Type Input, Output, InOut, or Public.
Sequencing
Specify if the parameter can be seen by the FactoryTalk Batch Server. Only Input and Output parameters can be used by a
sequence. Usage is Input or Output.
ExternalAccess
Specify the external access, outside of the controller, to the tag. Specify Read/Write, Read Only, or None.
Max
(optional) User specified maximum value for the tag. Only valid for tag with non-Boolean atomic datatype.
Min
(optional) User specified minimum value for the tag. Only valid for tag with non-Boolean atomic datatype.
Constant
Specify whether the tag value is a constant value or it can change. For L5K, specify yes for a constant value or no for a
dynamic value. For L5X, specify true or false.
111
Chapter 6
Attribute
Description
PermissionSet
Name of the set of permissions, configured in FactoryTalk Security, to apply to this object.
Description
ProduceCount
MinimumRPI
Specify the smallest and fastest packet interval at which consumers may consume data from the tag (0.196...536870.911
and 1...536870.911 for CompactLogix).
MaximumRPI
Specify the largest and slowest packet interval at which consumers may consume data from the tag
(0.196...536870.911).
DefaultRPI
Specify a default RPI that the produced tag provides value to consumers that attempt to connect with an out-of-range
RPI (0.196...536870.911).
If consumed information is provided on an alias tag, the alias tag is converted to a base tag before it can consume data.
Attribute
Description
Producer
If the controller consumes this tag, specify the name of the remote controller that produces this tag. You must also specify RemoteTag and RPI
attributes.
RemoteTag
If the controller consumes this tag from a controller that supports tag names, specify the name of the tag on the remote controller. You must also
specify Producer and RPI attributes.
If the controller consumes this tag from a PLC-5 controller, specify the PLC-5 file number, as any positive number, on the PLC-5 controller. You must
also specify Producer and RPI attributes.
In L5X, this attribute is on the <ConsumeInfo> element.
112
Chapter 6
Attribute
Description
RPI
If the controller consumes this tag, specify the RPI value in milliseconds, as any positive number. You must also specify Producer and RemoteTag
attributes.
In L5X, this attribute is on the <ConsumeInfo> element.
ALARM_ANALOG tag
Description
EnableIn
Specify whether to enable the alarm tag. Type 0 to disable the tag; type 1 to enable the tag.
InFault
Specify the quality of the input fault data. Type 1 for bad quality; type 0 for good quality.
HHEnabled
Specify the whether the alarm monitors for a high-high limit. Type 1 to enable; type 0 to disable.
HEnabled
Specify the whether the alarms monitors for a high limit. Type 1 to enable; type 0 to disable.
LEnabled
Specify the whether the alarm monitors for a low limit. Type 1 to enable; type 0 to disable.
LLEnabled
Specify the whether the alarms monitors for a low-low limit. Type 1 to enable; type 0 to disable.
AckRequired
Specify whether the alarms requires acknowledgment. Type 1 to enable; type 0 to disable.
ProgAckAll
Specify whether the program acknowledges all alarm conditions. Type 1 to enable; type 0 to disable.
OperAckAll
Specify whether an operator acknowledges all alarm conditions. Type 1 to enable; type 0 to disable.
Rockwell Automation Publication 1756-RM084U-EN-P - November 2015
113
Chapter 6
Attribute
Description
HHProgAck
Specify whether the program acknowledges a high-high condition. Type 1 to enable; type 0 to disable.
HHOperAck
Specify whether an operator acknowledges a high-high condition. Type 1 to enable; type 0 to disable.
HProgAck
Specify whether the program acknowledges a high condition. Type 1 to enable; type 0 to disable.
HOperAck
Specify whether an operator acknowledges a high condition. Type 1 to enable; type 0 to disable.
LProgAck
Specify whether the program acknowledges a low condition. Type 1 to enable; type 0 to disable.
LOperAck
Specify whether an operator acknowledges a low condition. Type 1 to enable; type 0 to disable.
LLProgAck
Specify whether the program acknowledges a low-low condition. Type 1 to enable; type 0 to disable.
LLOperAck
Specify whether an operator acknowledges a low-low condition. Type 1 for enabled; type 0 for disabled.
HHOperShelve
HOperShelve
LOperShelve
LLOperShelve
ROCPosProgAck
Specify whether the program acknowledges a positive (increasing), rate-of-change condition. Type 1 to enable; type 0 to disable.
ROCPosOperAck
Specify whether an operator acknowledges a positive (increasing), rate-of-change condition. Type 1 to enable; type 0 to disable.
ROCPNegProgAck
Specify whether the program acknowledges a negative (decreasing), rate-of-change condition. Type 1 to enable; type 0 to disable.
ROCPNegOperAck
Specify whether an operator acknowledges a negative (decreasing), rate-of-change condition. Type 1 to enable; type 0 to disable.
ROCPosOperShelve
ROCNegOperShelve
ProgSuppress
Specify whether the program can suppress an alarm. Type 1 to enable; type 0 to disable.
OperSuppress
Specify whether an operator can suppress an alarm. Type 1 to enable; type 0 to disable.
ProgUnsuppress
Specify whether the program can unsuppress an alarm. Type 1 to enable; type 0 to disable.
OperUnsuppress
Specify whether an operator can unsuppress an alarm. Type 1 to enable; type 0 to disable.
ProgDisable
Specify whether the program disables an alarm. Type 1 to enable; type 0 to disable.
OperDisable
ProgEnable
Specify whether the program enables an alarm. Type 1 to enable; Type 0 to disable.
OperEnable
ProgUnshelveAll
AlarmCountReset
Specify whether to reset the alarm count. Type 1 to reset; type 0 to not reset.
In
HHLimit
HHSeverity
HLimit
HSeverity
LLimit
LSeverity
LLLimit
LLSeverity
HHOperUnshelve
HOperUnshelve
114
Attribute
Description
LOperUnshelve
LLOperUnshelve
MinDurationPRE
Specify the minimum time (DINT) an alarm condition to remain true for the alarm to be considered active.
HHMinDurationEnable
Set to enable minimum duration timer when detecting the high-high condition.
HMinDurationEnable
Set to enable minimum duration timer when detecting the high condition.
LMinDurationEnable
Set to enable minimum duration timer when detecting the low condition.
LLMinDurationEnable
Set to enable minimum duration timer when detecting the low-low condition.
Deadband
Specify the deadband (REAL) for the high-high, high, low, and low-low levels.
ROCPosLimit
Specify the positive rate-of-change limit (REAL) for the alarm condition.
ROCPosSeverity
ROCNegLimit
Specify the negative rate-of-change limit (REAL) for the alarm condition.
ROCNegSeverity
ROCPeriod
ROCPosOperUnshelve
ROCNegOperUnshelve
ShelveDuration
Time duration for which a shelved alarm will be shelved, between 1 and MaxShelveDuration.
MaxShelveDuration
AssocTag1
AssocTag2
AssocTag3
AssocTag4
AlarmClass
Chapter 6
ALARM_DIGITAL tag
115
Chapter 6
</Data>
Description
EnableIn
Specify whether to enable the alarm tag. Type 1 to enable the tag; type 0 to disable the tag
In
InFault
Specify the quality of the input fault data. Type 1 for bad quality; type 0 for good quality.
Condition
Specify whether the alarm condition exists. Type 1 for yes; type 0 for no.
AckRequired
Specify whether the alarms require acknowledgment. Type 1 to enable; type 0 to disable.
Latched
Specify whether the alarm output is latched. Type 1 for yes; type 0 for no.
ProgAck
Specify whether the program acknowledges the alarm condition. Type 1 to enable; type 0 to disable.
OperAck
Specify whether an operator acknowledges the alarm condition. Type 1 to enable; type 0 to disable.
ProgReset
Specify whether the program resets the alarm condition. Type 1 to enable; type 0 to disable.
OperReset
Specify whether an operator resets the alarm condition. Type 1 to enable; type 0 to disable.
ProgSuppress
Specify whether the program can suppress an alarm. Type 1 to enable; type 0 to disable.
OperSuppress
Specify whether an operator can suppress an alarm. Type 1 to enable; type 0 to disable.
ProgUnsuppress
Specify whether the program can unsuppress an alarm. Type 1 to enable; type 0 to disable.
OperUnsuppress
Specify whether an operator can unsuppress an alarm. Type 1 to enable; type 0 to disable.
ProgDisable
Specify whether the program disables an alarm. Type 1 to enable; type 0 to disable.
OperDisable
ProgEnable
Specify whether the program enables an alarm. Type 1 to enable; type 0 to disable.
OperEnable
AlarmCountReset
Specify whether to reset the alarm count. Type 1 to reset; type 0 to not reset.
UseProgTime
Specify how to timestamp alarm events. Type 1 for programmatic timestamp; type 0 for controller timestamp.
ProgTime
Severity
MinDurationPRE
Specify the minimum time (DINT) an alarm condition remains true for the alarm to be considered active.
OperShelve
ProgUnshelve
OperUnshelve
116
Attribute
Description
ShelveDuration
Time duration for which a shelved alarm is shelved, between 1 and MaxShelveDuration.
MaxShelveDuration
AssocTag1
AssocTag2
AssocTag3
AssocTag4
AlarmClass
Chapter 6
In an .L5X file, the AlarmConfig element contains the alarm message text alarm
class, and HMI command.
<AlarmConfig>
<Messages>
<Message Type="type">
<Text Lang="language">
<![CDATA[ message_text ]]>
</Text>
</Message>
/Messages>
<AlarmClass>
<![CDATA[ class_text ]]>
</AlarmClass>
<HMICommand>
<![CDATA[ command_text ]]>
</HMICommand>
</AlarmConfig>
117
Chapter 6
AlarmConfig elements
L5X Item
Description
Message
Each message element contains a separate message. Specify a Type attribute for the analog
alarm type.
Specify
For
HH
high-high alarm
H
high alarm
L
low alarm
LL
low-low alarm
POS
rate-of-change positive alarm
NEG
rate-of change negative alarm
Text
The text of the message. Specify a Lang attribute for the language: EN-US (United States
English), DE (Germany German), ES (Spain Spanish), FR (France French), IT (Italian), PT
(Brazil Portuguese), JA (Japanese), KO (Korean), ZH (Chinese).
AlarmClass
HMICommand
ALMMSG elements
L5K Item
Description
alarm_type
118
language
message_text
Alarm message.
Enclose the message in double quotes (" "). This is a unicode string.
MESSAGE tag
Chapter 6
Description
MessageType
Type Block Transfer Read, Block Transfer Write, CIP Data Table Read, CIP Data Table Write, CIP Generic, PLC2
Unprotected Read, PLC2 Unprotected Write, PLC3 Typed Read, PLC3 Typed Write, PLC3 Word Range Read,
PLC3 Word Range Write, PLC5 Typed Read, PLC5 Typed Write, PLC5 Word Range Read, PLC5 Word Range
Write, SERCOS IDN Read, SERCOS IDN Write, SLC Typed Read, SLC Typed Write, Unconfigured, or Module
Reconfigure.
RemoteElement
Specify the address or tag name of the element in the remote device. This is the source element of a read instruction or
the destination element of a write instruction.
RequestedLength
ConnectedFlag
Specify whether the CIP generic message requires a connection or not. Type 1 for connected, or 0 for not connected.
ConnectionPath
CommTypeCode
DH+
ServiceCode
If the message type is CIP Generic, specify the service code (0...32,767 hexadecimal).
ObjectType
If the message type is CIP Generic, specify the object type (0...32,767 hexadecimal). The ObjectType attribute is the same
as the Class field on the MSG configuration dialog box.
TargetObject
If the message type is CIP Generic, specify the target object (0...32,767 decimal). The TargetObject attribute is the same
as the Instance field on the MSG configuration dialog box.
Rockwell Automation Publication 1756-RM084U-EN-P - November 2015
119
Chapter 6
Attribute
Description
AttributeNumber
If the message type is CIP Generic, specify the attribute number (0...65,535 hexadecimal).
Channel
SourceLink
If the communication method uses DH+, specify the source link (0...199).
DestinationLink
If the communication method uses DH+, specify the destination link (0...199).
DestinationNode
If the communication method uses DH+, specify the destination node number (0...77 octal).
Rack
For a DH+ or block transfer message, type the rack number (0...77 octal) of the target device.
Group
For a DH+ or block transfer message, type the group number (0...7) of the target device.
Slot
For a DH+ or block transfer message, type the slot number (0...15) of the target device.
LocalIndex
RemoteIndex
LocalElement
Specify the tag name of the element in the local controller. This is the destination element of a read instruction or the
source element of a write instruction.
DestinationTag
CacheConnections
If the message is to cache connections, type TRUE. If the message is not to cache connections, type FALSE.
LargePacketUsage
CIP Generic type messages with a cached connection can be configured to use either a standard or large size packet.
True makes use of the large packet size.
AXIS_CIP_DRIVE,
AXIS_CONSUMED,
AXIS_GENERIC_DRIVE,
AXIS_SERVO,
AXIS_SERVO_DRIVE, or
AXIS_VIRTUAL Tag
120
Chapter 6
For information about attributes for AXIS_CIP_DRIVE tags, see the Integrated
Motion on the Ethernet/IP Network Configuration and Startup User Manual
publication MOTION-UM003.
Attribute
Description
MotionGroup
MotionModule
MotorCatalogNumber
Specify the catalog number of the motor that this axis is connected or type NONE.
RotationalPosResolution
ConversionConstant
Specify the number of feedback counts per position unit. Type a real number from 1.0...1.0e9.
OutputCamExecutionTargets
Specify the number of output cam execution targets (any positive number).
AxisState
Type Axis-Ready, Direct Drive Control, Servo Control, Axis Faulted, or Axis Shutdown.
PositionUnits
AverageVelocityTimebase
Specify the time in seconds for calculating the average velocity of the axis (any positive number).
RotaryAxis
PositionUnwind
For a rotary axis, specify the distance, in feedback counts, used to perform electronic unwind (any positive number).
HomeMode
HomeDirection
For active homing sequences, except for the immediate sequence type, specify the desired homing direction. Type Unidirectional Forward, Bi-directional Forward, Uni-directional Reverse, or Bi-directional Reverse.
HomeSequence
Specify the event that will cause the home position to be set. Type Immediate, Switch, Marker, Switch-Marker, Torque
Level, or Torque Level-Marker.
HomeConfigurationBits
HomePosition
Specify the desired absolute position, in positioning units, for the axis after the homing sequence is complete (any positive
number).
HomeOffset
Specify the desired offset (any positive number) in position units the axis is to move, upon completion of the homing sequence,
to reach the home position. In most cases, this value will be zero.
HomeSpeed
Specify the speed of the jog profile used in the first leg of the homing sequence (any positive number). The homing speed
should be less than the maximum speed, and greater than zero.
HomeReturnSpeed
Specify speed of the jog profile used in the return leg(s) of an active homing sequence (any positive number). The return speed
should be less than the maximum speed, and greater than zero.
MaximumSpeed
MaximumAcceleration
Specify the maximum acceleration rate of the axis in position units/second (any positive number).
MaximumDeceleration
Specify the maximum deceleration rate of the axis in position units/second (any positive number).
ProgrammedStopMode
Specify how a specific axis stops when the controller changes mode, or a motion group stop (MGS) instruction is executed. Type
Fast Disable, Fast Stop, Fast Shutdown, Hard Disable, or Hard Shutdown.
MasterInputConfigurationBits
MasterPositionFilterBandwidth
AxisType
Specify the intended use of the axis. Type Servo or Feedback Only.
ServoLoopConfiguration
Specify the configuration of the loop. Type Custom, Position Servo, Aux Position Servo, Dual Position Servo, Aux
Command Servo, Dual Command Servo, Velocity Servo, or Torque Servo.
Rockwell Automation Publication 1756-RM084U-EN-P - November 2015
121
Chapter 6
Attribute
Description
ExternalDriveType
FaultConfigurationBits
AxisInfoSelect1
Specify an axis attribute to transmit, and the actual position data, to the controller.
The options include:
<none>
Position Command
Position Feedback
Aux Position Feedback
Position Error
Position Int.
Error
Velocity Command
Velocity Feedback
Velocity Error
Velocity Int. Error
Accel. Command
Accel. Feedback
Servo Output Level
Marker Distance
Torque Command
Torque Feedback
Positive Dynamic Torque Limit
Negative Dynamic Torque Limit
Motor Capacity, Drive Capacity
Power Capacity
Bus Regulator Capacity
Motor Electrical Angle
Torque Limit Source
DC Bus Voltage
Absolute Offset
Analog Input 1
Analog Input 2
Guard Status
Guard Faults
122
Attribute
Description
AxisInfoSelect2
Specify a second axis attribute to transmit, and the actual position data, to the controller.
The options include:
<none>
Chapter 6
Position Command
Position Feedback
Aux Position Feedback
Position Error
Position Int. Error
Velocity Command
Velocity Feedback
Velocity Error
Velocity Int. Error
Accel. Command
Accel. Feedback
Servo Output Level
Marker Distance
Torque Command
Torque Feedback
Positive Dynamic Torque Limit
Negative Dynamic Torque Limit
Motor Capacity
Drive Capacity
Power Capacity
Bus Regulator Capacity
Motor Electrical Angle
Torque Limit Source
DC Bus Voltage
Absolute Offset
Analog Input 1 or Analog Input 2
Absolute Offset
Analog Input 1
Analog Input 2
Guard Status
Guard Faults.
LDTType
Specify the LDT device type. Type PWM, Start/Stop Rising, or Start/Stop Falling.
LDTRecirculations
Only use this field if you specified PWM for LDTType. Specify the number of recirculations that the transducer is configured for
so the 1756-HYD02 module knows how the LDT is configured.
LDTCalibrationConstant
Specify the calibration constant (also called gradient on some LDTs). This number is engraved on each LDT by the
manufacturer. It specifies the characteristics of that individual transducer.
LDTCalibrationConstantUnits
LDTScaling
Define the relationship between the unit of measurement of the transducer and the system. This is necessary for calculating
the conversion constant. The LDT length is used with the number of recirculations to calculate the minimum servo update
period.
123
Chapter 6
Attribute
Description
LDTScalingUnits
LDTLength
LDTLengthUnits
SSICodeType
Specify the encoding on the data sent from an SSI transducer. Type Binary or Grey.
SSIDataLength
Specify the data length (8...32 bits) of the SSI transducer. The default value is 13.
SSIClockFrequency
Specify the SSI clock frequency (in kHz). Valid values are 208 (default) or 650.
AbsoluteFeedbackEnable
Specify whether to enable absolute feedback. Type 1 to enable absolute feedback. Otherwise, type 0. Absolute feedback is
always enabled for LDT.
AbsoluteFeedbackOffset
Specify the absolute offset that is used to place the machine zero point at the desired location relative to the zero point of the
LDT.
ServoFeedbackType
Specify the type of feedback device. Type LDT (linear displacement transducer),
AQB (A quadrature B), or SSI (synchronous serial interface)
ServoPolarityBits
VelocityFeedforwardGain
AccelerationFeedforwardGain
PositionProportionalGain
PositionIntegralGain
VelocityProportionalGain
VelocityIntegralGain
VelocityScaling
Specify the velocity scaling attribute that is used to convert the output of the servo loop into equivalent voltage to an external
velocity servo drive.
TorqueScaling
Specify the torque scaling attribute that is used to convert the acceleration of the servo loop into equivalent % rated torque to
the motor.
OutputLPFilterBandwidth
Specify the bandwidth in Hertz of the servo low-pass digital output filter.
IntegratorHoldEnable
PositionDifferentialGain
Specify a position differential gain (PosD) to help predict a large overshoot ahead of time and attempt to correct before the
overshoot actually occurs.
DirectionalScalingRatio
Specify the ratio between the extend direction gain and the retract direction gain.
MaximumPositiveTravel
Specify the maximum positive position (any positive number) to be used for software overtravel checking in position units.
MaximumNegativeTravel
Specify the maximum negative position (any positive number) to be used for software overtravel checking, in position units.
PositionErrorTolerance
Specify the how position error the servo module tolerates (any positive number) before it issues a position error fault.
PositionLockTolerance
Specify the maximum position error the servo module accepts (any positive number) to indicate that the position lock status
bit is set.
OutputLimit
Specify the maximum servo output voltage of a physical axis (any positive number).
DirectDriveRampRate
Specify the rate at which the analog output changes from the current value to the requested value when an MDO command is
given (if ramp control is enabled). The ramp rate is specified in Volts per second.
OutputOffset
Specify a fixed voltage value (-10...10V) to add to the servo output value to correct axis drift.
VelocityOffset
Specify a dynamic velocity correction to the output of the position servo loop, in position units/second (any positive number).
TorqueOffset
Specify a dynamic torque command correction to the output of the velocity servo loop as a percentage of the velocity servo
loop output (-100...100).
124
Chapter 6
Attribute
Description
FrictionCompensation
Specify the percentage (0...100) of output level added to a positive current servo output value, or subtracted from a negative
current servo output value to move an axis stuck in place from static friction.
FrictionCompensationWindow
BacklashStabilizationWindow
The window controls the backlash stabilization feature in the servo control loop. Mechanical backlash is a common problem in
applications that use mechanical gearboxes.
BacklashReversalOffset
Specify the backlash reversal error to compensate for positional inaccuracy introduced by mechanical backlash.
HardOvertravelFaultAction
Specify the fault action taken when a hardware overtravel error occurs. Type Shutdown, Disable Drive, Stop Motion, or
Status Only.
SoftOvertravelFaultAction
Specify the fault action taken when a software overtravel error occurs. Type Shutdown, Disable Drive, Stop Motion, or
Status Only.
PositionErrorFaultAction
FeedbackFaultAction
Specify the fault action to be taken when a feedback loss condition is detected. Type Shutdown, Disable Drive, Stop
Motion, or Status Only.
FeedbackNoiseFaultAction
Specify the fault action to be taken when excessive feedback noise is detected. Type Shutdown, Disable Drive, Stop
Motion, or Status Only.
DriveFaultAction
Specify the fault action to be taken when a drive fault condition is detected. Type Shutdown, Disable Drive, Stop Motion,
or Status Only.
TestIncrement
Specify the amount of distance traversed by the axis when executing the output and feedback test (any positive number).
TuningTravelLimit
TuningSpeed
Specify the tuning speed in revolutions per second (any positive number).
TuningTorque
DampingFactor
DriveModelTimeConstant
PositionServoBandwidth
Specify the maximum allowable value for position bandwidth (0.001F...1000), given the damping factor. This parameter is
disabled if the loop configuration is set to velocity.
VelocityServoBandwidth
Specify the unity gain bandwidth that is to be used to calculate the subsequent gains for a motion apply axis tuning (MAAT)
instruction (0.001F...1000).
TuningConfigurationBits
TorqueLimitSource
Type Not Limited, Negative Limit, Positive Limit, Bridge Limit, I(t) Limit, or Motor Limit.
DriveUnit
PositionDataScaling
PositionDataScalingFactor
Specify the scaling factor for all position data in a drive (1...65535).
PositionDataScalingExp
Specify the scaling exponent for all position data in a drive (-32768...32767).
VelocityDataScaling
Specify the scaling method to use for all velocity values (0...127).
VelocityDataScalingFactor
VelocityDataScalingExp
AccelerationDataScaling
AccelerationData
ScalingFactor
125
Chapter 6
Attribute
Description
AccelerationDataScalingExp
TorqueDataScaling
TorqueDataScalingFactor
TorqueDataScalingExp
DrivePolarity
Specify the polarity of the servo loop of the drive. Type Custom, Positive, or Negative.
MotorFeedbackType
Specify the type of motor associated with the selected motor (MotorCatalogNumber). If you specify NONE for the motor, you
must specify a feedback type.
MotorFeedbackResolution
AuxFeedbackType
AuxFeedbackResolution
MotorFeedbackUnit
Specify the units for motor feedback. Type Rev, Inch, or Millimeter.
AuxFeedbackUnit
Specify the units for auxiliary feedback. Type Rev, Inch, or Millimeter.
OutputNotchFilterFrequency
Specify the frequency of the digital notch filer of the drive (0...10,000.0).
VelocityDroop
VelocityLimitBipolar
Specify the velocity limit symmetrically in both directions (any positive number).
AccelerationLimitBipolar
Specify the acceleration and deceleration limits for the drive (any positive number).
TorqueLimitBipolar
VelocityLimitPositive
Specify the maximum allowable velocity in the positive direction (any positive number).
VelocityLimitNegative
Specify the maximum allowable velocity in the negative direction (any positive number).
VelocityThreshold
VelocityWindow
VelocityStandstillWindow
Specify the velocity limit for the standstill window (any positive number).
AccelerationLimitPositive
Specify the maximum acceleration ability of the drive (any positive number).
AccelerationLimitNegative
Specify the maximum acceleration ability of the drive (any negative number).
TorqueLimitPositive
TorqueLimitNegative
TorqueThreshold
DriveThermalFaultAction
Specify the fault action to be taken when a drive thermal fault is detected. Type Shutdown, Disable Drive, Stop Motion, or
Status Only.
MotorThermalFaultAction
Specify the fault action to be taken when a motor thermal fault is detected. Type Shutdown, Disable Drive, Stop Motion, or
Status Only.
DriveEnableInputFaultAction
Specify the fault action to be taken when a drive enable input fault is detected. Type Shutdown, Disable Drive, Stop
Motion, or Status Only.
StoppingTorque
StoppingTimeLimit
Specify the maximum amount of time that the drive amplifier will remain enabled while trying to stop (0...6553.5).
BrakeEngageDelayTime
Specify the amount of time that the drive maintains torque when the servo axis is disabled, and the drive decelerates to a
minimum speed (0...6.5535).
BrakeReleaseDelayTime
Specify amount of time that the drive ignores command values from the controller when the servo axis is enabled, and the
drive activates the torque (0...6.5535).
PowerSupplyID
BusRegulatorID
126
Attribute
Description
PWMFrequencySelect
Chapter 6
LoadInertiaRatio
AmplifierCatalogNumber
Specify the catalog number of the amplifier to which this axis is connected.
AuxFeedbackRatio
ContinuousTorqueLimit
ResistiveBrakeContactDelay
ConfigurationProfile
RegistrationInputs
Specify the number of drive-resident (probe) inputs. Up to two registration inputs per axis.
MaximumAccelerationJerk
Specify the value motion instructions used to determine the maximum acceleration jerk rate to apply to the axis when
acceleration jerk is specified as a percent of the maximum. This value is only used by a S-curve profile.
MaximumDecelerationJerk
Specify the value motion instructions used to determine the maximum deceleration jerk rate to apply to the axis when
deceleration jerk is specified as a percent of the maximum. This value is only used by a S-curve profile.
DynamicsConfigurationBits
PhaseLossFaultAction
Specify how the axis responds to a drive fault. The default is 1 (disable drive).
Specify: To:
0
Shutdown
1
Disable drive
2
Stop command
3
Status only
HomeTorqueLevel
Specify the torque limit when using one of the torque homing modes. Type the percent (0...TorqueLimitPositive) of continuous
torque. The default is 0%.
InputPowerPhase
Specify the power phase operation of a Kinetix 2000 drive. Type 0 for three-phase power; type 1 for single-phase power.
MotorRatedContinuousCurrent
The nameplate AC continuous current rating of the motor (any positive number). This is a database number and should not be
changed.
MotorRatedPeakCurrent
The peak or intermittent current rating of the motor (any positive number). This is a database number and should not be
changed.
RotaryMotorInertia
RotaryMotorRatedSpeed
The nameplate rated speed of a rotary motor (any positive number). This is a database number and should not be changed.
LinearMotorRatedSpeed
The nameplate rated speed of a linear motor (any positive number). This is a database number and should not be changed.
LinearMotorMass
The unloaded moving mass of a linear motor (any positive number). This is a database number and should not be changed.
MotorData
The motor data associated with the currently selected catalog number. This should not be changed.
AdditionalBusCapacitance
InterpolatedPositionConfiguration
127
Chapter 6
Attribute
Description
AxisUpdateSchedule
Specify an enumeration that indicates which update rate, the Base, Alternate 1 or Alternate 2 update period, to use to update
the Axis.
COORDINATE_SYSTEM tag
Description
MotionGroupInstance
SystemType
Specify the coordinate system type. Type Cartesian, Articulated Dependent, Articulated Independent, Delta,
SCARA Delta, or SCARA Independent.
Dimension
Specify the number of axes that this coordinated system supports. Type 1, 2, or 3.
Axes
CoordinationMode
CoordinationUnits
Specify units to be used for measuring and calculating motion related values such as position, velocity. Type units that
are relevant to your application.
ConversionRatioNumerator
The conversion ratio defines the relationship of axis position units to coordination units for each axis. Type the numerator
as a float or an integer.
ConversionRatioDenominator
The conversion ratio defines the relationship of axis position units to coordination units for each axis. Type the
denominator as an integer.
CoordinateSystemAutoTagUpdate
Specify whether or not the actual position values of the current coordinated system are automatically updated during
operation. To enable auto tag update, type 1. Otherwise, type 0.
MaximumSpeed
Specify the maximum speed to be used by the coordinated motion instructions in calculating vector speed when speed is
expressed as a percent of maximum.
128
Chapter 6
Attribute
Description
MaximumAcceleration
Specify the value for maximum acceleration to be used by the coordinated motion instructions to determine the
acceleration rate to apply to the coordinate system vector when acceleration is expressed as a percent of maximum.
MaximumDeceleration
Specify the value for maximum deceleration to be used by the coordinated motion instructions to determine the
deceleration rate to apply to the coordinate system vector when deceleration is expressed as a percent of maximum.
ActualPositionTolerance
Specify the value in coordination units, for actual position to be used by coordinated motion instructions when they have
a termination type of actual tolerance.
CommandPositionTolerance
Specify the value in coordination units, for command position to be used by coordinated motion instructions when they
have a termination type of command tolerance.
TransformDimension
JointRatioNumerator
JointRatioDenominator
LinkLength1
LinkLength2
ZeroAngleOffset1
Specify the rotational angular offset of joint axes 1 in degrees. This is used to shift the 0 degree position of the joint.
ZeroAngleOffset2
Specify the rotational angular offset of joint axes 2 in degrees. This is used to shift the 0 degree position of the joint.
ZeroAngleOffset3
Specify the rotational angular offset of joint axes 3 in degrees. This is used to shift the 0 degree position of the joint.
BaseOffset1
Specify the difference for the first axis between the origin of the robot at the first joint of the robotic arm, as determined
by the applications Kinematics internal equations, and the origin defined by the robot manufacturer.
BaseOffset2
Specify the difference for the second axis between the origin of the robot at the first joint of the robotic arm, as
determined by the applications Kinematics internal equations, and the origin defined by the robot manufacturer.
BaseOffset3
Specify the difference for the third axis between the origin of the robot at the first joint of the robotic arm, as determined
by the applications Kinematics internal equations, and the origin defined by the robot manufacturer.
EndEffectorOffset1
Specify the end effector offset value, which is the distance between the end of the robot arm L2 and the end of the end
effector in the x1 dimension.
EndEffectorOffset2
Specify the end effector offset value, which is the distance between the end of the robot arm L2 and the end of the end
effector in the x2 dimension.
EndEffectorOffset3
Specify the end effector offset value, which is the distance between the end of the robot arm L2 and the end of the end
effector in the x3 dimension.
MaximumAccelerationJerk
Specify the value for maximum acceleration jerk to be used by the coordinated motion instructions to determine the
acceleration jerk rate to apply to the coordinate system vector when acceleration jerk is expressed as a percent of
maximum.
MaximumDecelerationJerk
Specify the value for maximum deceleration jerk to be used by the coordinated motion instructions to determine the
deceleration jerk rate to apply to the coordinate system vector when deceleration jerk is expressed as a percent of
maximum
MasterInputConfigurationBits
MasterPositionFilterBandwidth
MOTION_GROUP Tag
129
Chapter 6
<Data Format="MotionGroup">
<MotionGroupParameters [Motion_Group_Attributes]/>
</Data>
Description
GroupType
Specify the type of motion group. Type Warning Enabled or Warning Disabled.
CourseUpdatePeriod
PhaseShift
GeneralFaultType
Specify whether an error generates a major fault or a non-major fault. Type Major Fault or Non Major Fault.
AutoTagUpdate
Alternate1UpdateMultiplier
Specify the value that is multiplied by the Base Update Period, which was previously called the Coarse Update Period. The result is displayed
as the Alternate 1 Update Period.
Alternate2UpdateMultiplier
Specify the value that is multiplied by the Base Update Period, which was previously called the Coarse Update Period. The result is
displayed as the Alternate 2 Update Period.
HMIBC tag
Chapter 6
HMIBC attributes
SAFETY tag
L5X Item
L5K Item
Description
EnableIn
EnableIn
Relay Ladder: Corresponds to the rung state. Does not affect processing.
Function Block: If cleared, the instruction does not execute and outputs are not
updated. If set, the instruction executes. Default is set.
Structured Text: No effect. The instruction always executes.
Value: true or false
ProgFB
ProgFB
Program Feedback. For use by the user program. Not used by the instruction.
Value: true or false
BitIndex
TerminalCount
131
Chapter 6
Attribute
Description
TimeoutMultiplier
Specify the timeout multiplier (default = 2) for a safety controller system. This value determines the RPIs of time to wait
for a packet before declaring a time out. This translates into the number of messages that may be lost before declaring a
connection error. A Timeout Multiplier of 1 indicates that no messages may be lost, which means there must be a packet
every RPI interval. A Timeout Multiplier of 2 indicates that 1 message may be lost, which means as long as a packet is
seen in 2 times the RPI, no time-out will occur. Type a number from 1...4, inclusive.
This attribute applies only to safety consumed tags.
For L5X, this attribute is on the <ConsumeInfo> element.
NetworkDelayMultiplier
Specify the network delay multiplier (default = 100%) for a safety controller system. This value lets you reduce or
increase the connection reaction time limit in cases where the transport time of the message is significantly less or more
than the RPI. This may be the case when the RPI of an output connection is the same as that of a lengthy task period.
Type a percentage from 10...300, inclusive.
This attribute applies only to safety consumed tags.
For L5X, this attribute is on the <ConsumeInfo> element.
ReactionTimeLimit
Specify the connection reaction time limit for a safety controller system. The Logix Designer application calculates the
connection reaction time limit as a function of the RPI, timeout multiplier, and network delay multiplier. The connection
reaction time limit is automatically recalculated if any of the above values change.
This attribute applies only to safety consumed tags.
For L5X, this attribute is on the <ConsumeInfo> element.
MaxObservedNetworkDelay
L5X only. MaxObservedNetworkDelay is a measure of the longest time the data of a safety connection is delayed from
transporting the safety packets over the network. This attribute is exported for informational purposes only and is
ignored on import.
This attribute is on the <ConsumeInfo> element.
Unicast
For a safety consumed tag, specify if the EtherNet/IP connection is unicast. Specify yes for unicast or no to remain
multicast. For L5X format, specify true or false.
On export, only appears if the path to the producing module crosses an EtherNet/IP network and the producing module
supports unicast.
UnicastPermitted
For a safety produced tag, specify whether let the EtherNet/IP connection be unicast. Specify yes for unicast or no to
remain multicast. For L5X format, specify true or false.
Chapter 6
</Data>
In L5X format, the string is padded with zeros (00) to fill its maximum of
82 characters.
133
Chapter 6
The L5K representation of an Add-On Instruction type tag containing the example values is: [-2147483643, 101, 102.0, 103,
202, 204, [201.1, 201.2, 201.3], 2, 203].
Tag guidelines
The <unused2> memory area pads the Add-On Instruction type tag such
that the byte length is a multiple of 4.
Unused data is not included in the L5K format. Unused data is included in
the L5X format.
The simplest way to guarantee that the order of the parameters and local
tags in the L5K Add-On Instruction definition matches the order of data
values in the L5K Add-On Instruction type tag is to order the tags in the
LOCAL_TAGS section such that all SINTs are first, followed by all INTs,
and everything else.
134
Tags must be defined after modules and add-on instructions. If there are no
modules or add-on instructions, then the tags must be defined after the data
types within the controller body.
Examples
Chapter 6
Base tags and aliases can be defined out of order within a tag block.
The initial values must comply with the tag type and dimensions.
Whitespace cannot occur within the initial values in L5K format or within
the type/dimension specifier.
135
Chapter 6
END_TAG
L5X safety tag example
Chapter 6
NetworkDelayMultiplier := 100,
ReactionTimeLimit := 29.952) := [[2],[0,0,0]],
TagForceData :=
[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0];
137
Chapter 6
138
Chapter 6
139
Chapter 7
Introduction
Program component
The Program component defines the programs used in the logic you export.
The maximum number of programs depends on the type of controller.
Controller
ControlLogix
1000
(32 in firmware revisions prior to 15)
SoftLogix 5800
100
(32 in firmware revisions prior to 15)
FlexLogix
32
CompactLogix
32
DriveLogix
32
>
141
Chapter 7
Program elements
L5X Item
L5K Item
Description
Not applicable
program_name
Description
Description
tags
TAG
Program-scoped tags.
Follows same format as controller-scoped tags.
For more details on defining a tag, see Chapter 6 Defining a Tag Component on page 107.
routines
ROUTINE
FBD_ROUTINE
ST_ROUTINE
SFC_ROUTINE
ChildPrograms
142
CHILD_PROGRAMS
Child programs of the parent program. The child-parent relationship is visible in only the
Logical Organizer in the Logix Designer application, and not in the Controller Organizer.
Chapter 7
Program attributes
Attribute
Description
Name
Type
Specify the type of program. If this program is a Equipment Phase program, type EquipmentPhase. If this program is a
Sequence program, type Sequence. Otherwise, type Normal.
Class
Specify the class of the program. This attribute applies only to safety controller projects. Type Standard or Safety. Do
not use this attribute if the program is an Equipment Phase program.
(Type = EquipmentPhase).
Main (L5K)
MainRoutineName (L5X)
Specify the name of the main routine of the program (40 characters maximum).
Fault (L5K)
FaultRoutineName (L5X)
L5K only. Specify the name of the program fault routine, if any (40 characters maximum).
Mode
L5K only. Type 0 for not testing edits; type 1 for testing edits.
TestEdits
L5X only. Type false for not testing edits; type true for testing edits.
DisableFlag
L5K only. Type 1 to disable the program; type 0 to enable the program.
Disabled
L5X only. Type true to disable the program; type false to enable the program.
SynchronizeRedundancyData
AfterExecution
Type 1 to synchronize data after the program scan in a redundant system; type 0 to not synchronize data after the
program scan.
UseAsFolder
Type 1 to use the program as a folder. Logix Designer application does not execute any routines or update any
parameters in a program that is used as a folder.
Description
PreState (L5K)
PreStateRoutineName (L5X)
L5K only. Specify the name of the prestate routine (40 characters maximum).
InitialStepIndex
Specify an integer value for the initial step index of the phase.
InitialState
Specify state of the phase. Type Aborted, Completed, Stopped, or Idle (default).
CompleteStateIfNotImpl
If the phase does not implement all the expected states, enter StateComplete (default) so the program
can continue to execute when it expects a state that was omitted. The program ignores the omitted
state and continues to the next state. Otherwise, enter NoAction.
LossOfCommCmd
If the phase uses an external sequencer, such as FactoryTalk Batch software, specify that appropriate
action to take if communication fails between the controller and the external sequencer. Type Abort,
Hold, Stop, or none (default).
143
Chapter 7
Attribute
Description
ExternalRequestAction
Specify how to handle an external request (PXRQ instruction) that is in process when the phase receives
the command to go to a Holding state. Type Clear to abort outstanding external requests. Otherwise,
type none (default).
EquipmentId
The FactoryTalk Batch equipment identifier for the Equipment Phase. This value is set by the FactoryTalk
Batch software when you synchronize with a project file. Do not modify this value.
RecipePhaseNames
The FactoryTalk Batch recipe phases for the Equipment Phase. This value is set by the FactoryTalk Batch
software when you synchronize with a project file. Do not modify this value.
AutoValueAssignStepToPhase
Specify whether the value of sequence step inputs are automatically assigned to phase inputs when a
sequence step starts the phase and the phase is used in a sequence.
In L5K, type Yes or No. In L5X, type true or false.
AutoValueAssignPhaseToStepOnComplete
Specify whether the value of phase outputs are automatically assigned to step outputs when the phase
is completed and the phase is used in a sequence.
In L5K, type Yes or No. In L5X, type true or false.
AutoValueAssignPhaseToStepOnStopped
Specify whether the value of phase outputs are automatically assigned to step outputs when the phase
is stopped and the phase is used in a sequence.
In L5K, type Yes or No. In L5X, type true or false.
AutoValueAssignPhaseToStepOnAborted
Specify whether the value of phase outputs are automatically assigned to step outputs when the phase
is stopped and the phase is used in a sequence.
In L5K, type Yes or No. In L5X, type true or false.
Description
Revision
Revision number for the program, consisting of major and minor revision.
RevisionExtension
UnitID
RetainSequenceIDOnReset
GenerateSequenceEvents
144
ValuesToUseOnStart
Chapter 7
Specify the values of sequence parameters and step tags that are used when starting the sequence.
Use Initial Values Copy the initial values to the current values when starting the sequence.
Retain Current Values Use the current values of sequence parameters and step tags when
starting the sequence.
ValuesToUseOnReset
Specify the how the values of sequence parameters and step tags are set when the sequence
resets.
Use Initial Values Restore the current values of sequence parameters and step tags to the
initial values when resetting the sequence.
Retain Current Values Maintain the current values of sequence parameters and step tags
when resetting the sequence.
RevisionNote
The Child Program component defines the child programs used in the logic you
export. A child program is a program defined as the logical child of another
program in the Logical Organizer in the Logix Designer.
>
145
Chapter 7
</Routines>
<ChildPrograms>
child_programs
</ChildPrograms>
</Program>
</Programs>
Description
child_program_name
Encoded/Unencoded
routines
Since child programs are a way to organize existing programs, adding a child
program component does not add to the number of programs.
These examples are for protected (encoded) and unprotected (clear text) codes for
routines.
If the project contains a source-protected routine, the routine appears within an
encoded data component in the program. See Exporting Source-protected Logic
on page 28 on page 33 for procedures.
146
Chapter 7
L5K Item
Description
type
type
name
name
routinetype
routinetype
other_attributes
other_attributes
encoded_data
encoded_data
Important:
When the routine is source protected, the encoded_data information is encrypted. If you modify this encrypted information, you will not be able to re-import
the routine.
147
Chapter 7
Program guidelines
Examples
148
You must put the tag declaration block before the routine block.
Chapter 7
149
Chapter 7
150
Chapter 8
Introduction
>
L5K Item
Description
N/A
routine_name
Description
Description
RLLContent
ladder_rungs
Rung logic.
151
Chapter 8
Description
Name
Type
PermissionSet
Name of the set of permissions, configured in FactoryTalk Security, to apply to this object.
Rung logic
Rung elements
L5X Item
L5K Item
Description
N/A
RungType
Comment
RC
Rung comment.
In a L5K file, a rung comment must be followed by a rung.
Text
152
rung_neutral_text
The logic.
Chapter 8
Identifies
Normal
Insert
Delete
IR
rR
Pending replace IR
Replace
rI
Pending replace I
rN
Pending replace N
er
Rung attributes
Attribute
Description
Number
Type
Rung guidelines
Branches
Rungs are specified by using neutral language. See Neutral Text for Ladder
Instructions on page 156 on page 155 for the format for the supported
instructions.
153
Chapter 8
</Branch>
L5X Examples
L5K examples
154
Chapter 8
ROUTINE Ladder_example
RC: "This is a rung comment for the first rung.";
N: XIC(input1)XIC(input2)OTE(output1)OTE(output2);
RC: "This is a rung comment for the second rung.";
N: XIC(input3)OTE(output3);
END_ROUTINE
Example with a single branch
N: XIC(conveyor_a)[,XIC(input_1) XIO(input_2) ]OTE(light_1);
Example with two simultaneous branches
N: XIC(conveyor_b)[,XIC(input_1) XIO(input_2) ,XIC(input_a)
XIO(input_b) ]OTE(light_2);
These tables lists each ladder instruction and its neutral text format. For details
about a specific instruction, see the listed reference manuals.
Ladder Logic Instruction Reference Manuals
Instruction Type
Resource
Logix5000 Controllers Advanced Process Control and Drives Instruction Set Reference Manual, publication 1756-RM006.
Motion instruction
ABL
ABL(channel,serial_port_control,character_count);
ABS
ABS(source,destination);
ACB
ACB(channel,serial_port_control,character_count);
ACL
ACL(channel,clear_serial_port_read,clear_serial_port_write);
ACS
ACS(source,destination);
ADD
ADD(source_A,source_B,destination);
AFI
AFI();
AHL
AHL(channel,ANDMask,ORMask,serial_port_control,channel_status);
ALMA
ALMA (alma_tag,in,program_acknowledge_all,program_disable,program_enable);
ALMD
ALMD (almd_tag,program_acknowledge,program_reset,program_disable,
program_enable);
AND
AND(source_A,source_B,destination);
ARD
ARD(channel,destination,serial_port_control,string_length,
characters_read);
ARL
ARL(channel,destination,serial_port_control,string_length,
characters_read);
ASN
ASN(source,destination);
ATN
ATN(source,destination);
155
Chapter 8
Instruction
AVC
AVC(avc_tag,feedback_type,feedback_reation_time,delay_type,delay_time,
output_follows_actuate,actuate,delay_enable,feedback_1,input_status,
output_status,reset);
AVE
AVE(array,dim_to_vary,destination,control,length,position);
AWA
AWA(channel,source,serial_port_control,string_length,characters_sent);
AWT
AWT(channel,source,serial_port_control,string_length,characters_sent);
BRK
BRK();
BSL
BSL(array,control,source_bit,length);
BSR
BSR(array,control,source_bit,length);
BTD
BTD(source,source_bit,destination,destination_bit,length);
CBCM
CBCM(cbcm_tag,ack_type,mode,takeover_mode,enable,safety_enable,
standard_enable,arm_continuous,start,stop_at_top,press_in_motion,
motion_monitor_fault,slide_zone,safety_enable_ack)
CBIM
CBIM(cbim_tag,ack_type,inch_time,enable,safety_enable,standard_enable,
start,press_in_motion,motion_monitor_fault,slide_zone,safety_enable_ack);
CBSSM
CBSSM(cbssm_tag,ack_type,takeover_mode,enable,safety_enable,
standard_enable,start,press_in_motion,motion_monitor_fault,slide_zone,
saefty_enable_ack);
CLR
CLR(destination);
CMP
CMP(expression);
CONCAT
CONCAT(sourceA,sourceB,destination)
COP
COP(source,destination,length);
COS
COS(source,destination);
CPM
CPM(cpm_tag,cam_profile,enable,brake_cam,takeover_cam,dynamic_cam,
input_status,reverse,press_motion_status,reset);
CPS
CPS(source,destination,length);
CPT
CPT(destination,expression);
CROUT
CROUT(crout_tag,feedback_type,feedback_reaction_time,actuate,feedback_1,
feedback_2,input_status,output_status,reset);
CSM
CSM(csm_tag,mechanical_delay_timer,max_pulse_period,motion_request,
channel_A,channel_B,input_status,reset);
CTD
CTD(counter,preset,accum);
CTU
CTU(counter,preset,accum);
DCM
DCM(dcm_tag,safety_function,input_type,descrepancy_time,channel_A,
channel_B,input_status,reset);
DCS
DCS(dcs_tag,safety_function,input_type,discrepancy_time,restart_type,
cold_start_type,channel_A,channel_B,input_status,reset);
DCSRT
DCSRT(dcsrt_tag,safety_function,input_type,discrepancy_time,enable,
channel_A,channel_B,input_status,reset);
DCST
DCST(dcst_tag,safety_function,input_type,discrepancy_time,restart_type,
cold_start_type,channel_A,channel_B,test_request,input_status,reset);
DCSTM
DCSTM(dcstm_tag,safety_function,input_type,discrepancy_time,restart_type,
cold_start_type,test_type,test_time,channel_A,channel_B,test_request,mute,
muting_lamp_status,input_status,reset);
156
Instruction
DCSTL
DCSTL(dcstl_tag,safety_function,input_type,discrepancy_time,restart_type,
cold_start_type,channel_A,channel_B,test_request,unlock_request,
lock_feedback,hazard_stopped,input_status,reset);
DDT
DDT(source,reference,result,cmp_control,length,position,result_control,
length,position);
DEG
DEG(source,destination);
DELETE
DELETE(source,quantity,start,destination);
DIN
DIN(din_tag,reset_type,channel_A,channel_B,circuit_reset,fault_reset);
DIV
DIV(source_A,source_B,destination);
DTOS
DTOS(source,destination);
DTR
DTR(source,mask,reference);
ENPEN
ENPEN(enpen_tag,reset_type,channel_A,channel_B,circuit_reset,fault_reset);
EOT
EOT(data_bit);
EPMS
EPMS(epms_tag,input_1,input_2,input_3,input_4,input_5,input_6,input_7,
input_8,input_status,lock,reset);
EQU
EQU(source_A,source_B);
ESTOP
ESTOP(estop_tag,reset_type,channel_A,channel_B,circuit_reset,fault_reset);
EVENT
EVENT(task);
FAL
FAL(control,length,position,mode,destination,expression);
FBC
FBC(source,reference,result,cmp_control,length,position,result_control,
length,position);
FFL
FFL(source,FIFO,control,length,position);
FFU
FFU(FIFO,destination,control,length,position);
FIND
FIND(source,search,start,result);
FLL
FLL(source,destination,length);
FOR
FOR(routine_name,index,initial_value,terminal_value,step_size);
FPMS
FPMS(fpms_tag,input_1,input_2,input_3,input_4,input_5,fault_reset);
FRD
FRD(source,destination);
FSBM
FSBM(fsbm_tag,restart_type,S1-S2_time,S2-LC_time,LC-S3_time,S3-S4_time,
maximum_mute_time,maximum_override_time,direction,light_curtain,sensor_1,
sensor_2,sensor_3,sensor_4,enable_mute,override,input_status,
muting_lamp_status,reset);
FSC
FSC(control,length,position,mode,expression);
GEQ
GEQ(source_A,source_B);
GRT
GRT(source_A,source_B);
GSV
GSV(class_name,instance_name,attribute_name,destination);
INSERT
INSERT(sourceA,sourceB,start,destination);
IOT
IOT(output_tag);
JMP
JMP(label_name);
JSR
JSR(routine_name,input_1,...input_n,return_1,..return_n);
JXR
JXR(external_routine_name,external_routine_control,parameter,
return_parameter);
Chapter 8
157
Chapter 8
Instruction
LBL
LBL(label_name);
LC
LC(lc_tag,reset_type,channel_A,channel_B,input_filter_time,
mute_light_curtain,circuit_reset,fault_reset);
LEQ
LEQ(source_A,source_B);
LES
LES(source_A,source_B);
LFL
LFL(source,LIFO,control,length,position);
LFU
LFU(LIFO,destination,control,length,position);
LIM
LIM(low_limit,test,high_limit);
LN
LN(source,destination);
LOG
LOG(source,destination);
LOWER
LOWER(source,destination);
MAAT
MAAT(axis,motion_control);
MAFR
MAFR(axis,motion_control);
MAG
MAG(slave_axis,master_axis,motion_control,direction,ratio,slave_counts,master_counts,master_reference,ratio_format,clutch,accel_rate,accel_
units);
MAH
MAH(axis,motion_control);
MAHD
MAHD(axis,motion_control,diagnostic_test,observed_direction);
MAJ
MAJ(axis,motion_control,direction,speed,speed_units,accel_rate,
accel_units,decel_rate,decel_units,profile,merge,merge_speed);
MAM
MAM(axis,motion_control,move_type,position,speed,speed_units,accel_rate, accel_units,decel_rate,decel_units,profile,merge,merge_speed);
MAOC
MAOC(axis,execution_target,motion_control,output,input,output_cam,
cam_start_position,cam_end_position,output_compensation,execution_mode,
execution_schedule,axis_arm_position,cam_arm_position,reference);
MAPC
MAPC(slave_axis,master_axis,motion_control,direction,cam_profile,
slave_scaling,master_scaling,execution_mode,execution_schedule,
master_lock_position,cam_lock_position,master_reference,
master_direction);
MAR
MAR(axis,motion_control,trigger_condition,windowed_registration,
minimum_position,maximum_position);
MAS
MAS(axis,motion_control,stop_type,change_decel,decel_rate,decel_units);
MASD
MASD(axis,motion_control);
MASR
MASR(axis,motion_control);
MATC
MATC(axis,motion_control,direction,cam_profile,distance_scaling,
time_scaling,execution_mode,execution_schedule);
MAW
MAW(axis,motion_control,trigger_condition,position);
MCCD
MCCD(coordinate_system,motion_control,motion_type,change_speed,speed,
speed_units,change_accel,accel_rate,accel_units,change_decel,decel_rate, decel_units,scope);
MCCM
MCCM(coordinate_system,motion_control,move_type,position,circle_type,
via/center/radius,direction,speed,speed_units,accel_rate,accel_units,
decel_rate,decel_units,profile,termination_type,merge,merge_speed);
MCCP
MCCP(motion_control,cam,length,start_slope,end_slope,cam_profile);
MCLM
MCLM(coordinate_system,motion_control,move_type,position,speed,
speed_units,accel_rate,accel_units,decel_rate,decel_units,profile, termination_type,merge,merge_speed);
158
Instruction
MCD
MCD(axis,motion_control,motion_type,change_speed,speed,change_accel,
accel_rate,change_decel,decel_rate,speed_units,accel_units,
decel_units);
MCR
MCR();
MCS
MCS(coordinate_system,motion_control,stop_type,change_decel,decel_rate, decel_units);
MCSD
MCSD(coordinate_system,motion_control);
MCSR
MCSR(coordinate_system,motion_control);
MCSV
MCSV(motion_control,cam_profile,master_value,slave_value,slope_value,
slope_derivative);
MCT
MCT(source_system,target_system,motion_control,orientation,translation);
MCTP
MCTP(source_system,target_system,motion_control,orientation,translation,
transform_direction,reference_position,transform_position);
MDF
MDF(axis,motion_control);
MDO
MDO(axis,motion_control,drive_output,drive_units);
MDOC
MDOC(axis,execution_target,motion_control,disarm_type);
MDR
MDR(axis,motion_control);
MDW
MDW(axis,motion_control);
MEQ
MEQ(source,mask,compare);
MGS
MGS(group,motion_control,stop_mode);
MGSD
MGSD(group,motion_control);
MGSP
MGSP(group,motion_control);
MGSR
MGSR(group,motion_control);
MID
MID(source,quantity,start,destination);
MMVC
MMVC(mmvc_tag,enable,keyswitch,bottom,flywheel_stopped,safety_enable,
actuate,input_status,output_status,reset);
MOD
MOD(source_A,source_B,destination);
MOV
MOV(source,destination);
MRAT
MRAT(axis,motion_control);
MRHD
MRHD(axis,motion_control,diagnostic_test);
MRP
MRP(axis,motion_control,type,position_select,position);
MSF
MSF(axis,motion_control);
MSG
MSG(message_control);
MSO
MSO(axis,motion_control);
MUL
MUL(source_A,source_B,destination);
MVC
MVC(mvc_tag,feedback_type,feedback_reaction_time,actuate,feedback_1,
feedback_2,input_status,output_status,reset);
MVM
MVM(source,mask,destination);
NEG
NEG(source,destination);
NEQ
NEQ(source_A,source_B);
NOP
NOP();
NOT
NOT(source,destination);
Chapter 8
159
Chapter 8
Instruction
ONS
ONS(storage_bit);
OR
OR(source_A,source_B,destination);
OSF
OSF(storage_bit,output_bit);
OSR
OSR(storage_bit,output_bit);
OTE
OTE(data_bit);
OTL
OTL(data_bit);
OTU
OTU(data_bit);
PATT
PATT(phase_name,result);
PCLF
PCLF(phase_name);
PCMD
PCMD(phase_name,command,result);
PDET
PDET(phase_name);
PFL
PFL(source);
PID
PID(PID,process_variable,tieback,control_variable,pid_master_loop,
inhold_bit,inhold_value);
POVR
POVR(phase_name,command,result);
PPD
PPD();
PRNP
PRNP();
PSC
PSC();
PXRQ
PXRQ(phase_instruction,external_request,data_value);
RAD
RAD(source,destination);
RES
RES(structure);
RET
RET(return_1,...return_n);
RIN
RIN(rin_tag,reset_type,channel_A,channel_B,circuit_reset,fault_reset);
ROUT
ROUT(rout_tag,feedback_type,enable,feedback_1,feedback_2,fault_reset);
RTO
RTO(timer,preset,accum);
RTOS
RTOS(source,destination)
SBR
SBR(routine_name,input_1,...input_n);
SFP
SFP(SFC_routine_name,target_state);
SFR
SFR(SFC_routine_name,step_name);
SIN
SIN(source,destination);
SIZE
SIZE(souce,dimension_to_vary,size);
SMAT
SMAT(smat_tag,restart_type,short_circuit_detect_delay_time,channel_A,
channel_B,input_status,reset);
SQI
SQI(array,mask,source,control,length,position);
SQL
SQL(array,source,control,length,position);
SQO
SQO(array,mask,destination,control,length,position);
SQR
SQR(source,destination);
SRT
SRT(array,dim_to_vary,control,length,position);
SSV
SSV(class_name,instance_name,attribute_name,source);
STD
STD(array,dim_to_vary,destination,control,length,position);
160
Instruction
STOD
STOD(source,destination)
STOR
STOR(source,destination)
SUB
SUB(source_A,source_B,destination);
SWPB
SWPB(source,order_mode,destination);
TAN
TAN(source,destination);
THRS
THRS(thrs_tag,active_pin_type,active_pin,right_button_normally_open,
right_button_normally_closed,left_button_normally_open,
left_button_normally_closed,fault_reset);
THRSE
THRSE(thrse_tag,discprepancy_time,enable,disconnected,
right_button_normally_open,right_button_normally_closed,
left_button_normally_open,left_button_normally_closed,input_status,resest);
TND
TND();
TOD
TOD(source,destination);
TOF
TOF(timer,preset,accum);
TON
TON(timer,preset,accum);
TRN
TRN(source,destination);
TSAM
TSAM(tsam_tag,restart_type,S1-S2_time,S2-LC_time,maximum_mute_time,
maximum_override_time,light_curtain,sensor_1,sensor_2,enable_mute,
override,input_status,muting_lamp_status,reset);
TSSM
TSSM(tssm_tag,restart_type,S1-S2_discrepancy_time,S1_S2-LC_minimum_time,
S1_S2-LC_maximum_time,maximum_mute_time,maximum_override_time,
light_curtain,sensor_1,sensor_2,enable_mute,override,input_status,
muting_lamp_status,reset);
UID
UID();
UIE
UIE();
UPPER
UPPER(source,destination);
XIC
XIC(data_bit);
XIO
XIO(data_bit);
XOR
XOR(source_A,source_B,destination);
XPY
XPY(source_A,source_B,destination);
Chapter 8
161
Chapter 9
Introduction
This chapter explains how to enter function block diagram logic in a complete
import/export file.
Function BlockDiagram
Routine
L5K Item
Identifies
N/A
routine_name
Description
Description
FBDContent
163
Chapter 9
FBD_routine attributes
Attribute
Description
Name
Type
SheetSize
SheetOrientation
OnlineEditType
L5X only. Specify the online edit logic type (Original, PendingEdits, or TestEdits). This attribute is not
specified if there are no edits.
PermissionSet
Name of the set of permissions, configured in FactoryTalk Security, to apply to this object.
Sheet
Enter the function block diagram logic in sheets within a routine component in an
import/export file.
Chapter 9
<AddOnInstruction [AddOnInstruction_Attributes]/>
<JSR [JSR_Attributes]/>
<SBR [SBR_Attributes]/>
<RET [RET_Attributes]/>
<Wire [Wire_Attributes]/>
<FeedbackWire [FeedbackWire_Attributes]/>
<TextBox [TextBox_Attributes]>
text
</TextBox>
<Attachment [Attachment_Attributes]/>
</Sheet>
Sheet elements
L5X Item
L5K Item
Identifies
IRef
IREF
Input references.
ORef
OREF
Output references.
ICon
ICON
OCon
OCON
Block
mnemonic_BLOCK
AddOnInstruction
ADD_ON_INSTRUCTION
Add-On Instructions
JSR
JSR
SBR
SBR
Subroutine instructions.
RET
RET
Return instructions.
Wire
WIRE
FeedbackWire
FEEDBACK_WIRE
165
Chapter 9
L5X Item
L5K Item
Identifies
TextBox
TEXT_BOX
Attachment
ATTACHMENT
Sheet attributes
Attribute
Description
Number
Name
Sheet guidelines
Use these sheet guidelines in your import/export files:
166
The sheets in the routine appear in order in the export file. Each sheet
section contains all the drawing elements and wires for that sheet.
On import, sheet numbers are assigned based on order in the file, not on the
number attribute on the sheet.
Wire and feedback wire statements must appear after all the other
components.
Chapter 9
If you export function block logic that contains online edits, the export file
exports LOGIC blocks, in L5K format, or additional <FBDContent> elements,
in L5X format, to indicate the original, test edits, and pending edits states. If there
are no online edits, these LOGIC blocks or additional <FBDContent> elements
are not shown.
167
Chapter 9
Identifies
Online_Edit_Type
If online edits exist when the logic is exported, there will be a LOGIC block for Online_Edit_Type := Orig and the appropriate LOGIC block
for the existing edits. Online_Edit_Type : = Pend indicates pending edits. Online_Edit_Type := Test indicates test edits.
If there are no online edits when the logic is exported, there are no LOGIC blocks and the main components in the routine are SHEET
components.
Input and output references have similar formats and identical attributes.
Reference attributes
L5X Item
L5K Item
Identifies
ID
ID
Operand
Operand
168
L5X Item
L5K Item
Identifies
HideDesc
HideDescription
Chapter 9
Reference guidelines
Use these reference guidelines for function blocks:
If the operand is not a qualified tag or literal value, the reference is not
verified.
The X and Y grid locations are a relative position from the upper-left corner
of the sheet. X is the horizontal position; Y is the vertical position.
Input and output wire connectors have similar formats and identical attributes.
Connector attributes
L5X Item
L5K Item
Identifies
ID
ID
Name
Name
169
Chapter 9
Connector guidelines
Use these connector guidelines for function blocks:
Blocks
Multiple input connector names can reference the same output connector
name.
The X and Y grid locations are a relative position from the upper-left corner
of the sheet. X is the horizontal position; Y is the vertical position.
Block attributes
L5X Item
L5K Item
Identifies
Type
mnemonic
L5X only. The type of Block. Specify the mnemonic name for the block (for example DEDT).
ID
ID
Operand
Operand
170
Chapter 9
L5X Item
L5K Item
Identifies
Name
ArrayName
VisiblePins
VisiblePins
List of the names of all the parameters with pins visible for wiring. The names match the
member names on the block tag.
In an .L5X file, separate pin names with spaces.
In an .L5K file, separate pin names with commas.
AutotuneTag
AutotuneTag
HideDesc
HideDescription
Block guidelines
Use these block guidelines with function blocks:
If the operand is not a qualified tag of the correct data type, the blocks are
not verified.
Some function block instructions require specific arrays. The table lists the
valid array name for each of these instructions.
Add-On instructions
Instruction
Array Name
DEDT
Storage (required)
FGEN
X1 (required)
Y1 (required)
X2 (optional)
Y2 (optional)
MAVE
Storage (required)
Weight (optional)
RMPS
RampValue (required)
SoakValue (required)
SoakTime (required)
The X and Y grid locations are in a relative position from the upper-left
corner of the sheet. X is the horizontal position; Y is the vertical position.
171
Chapter 9
L5K Item
Identifies
Name
name
ID
ID
Operand
Operand
VisiblePins
VisiblePins
List of the names of all the parameters with pins visible for wiring.
In an .L5X file, separate pin names with spaces.
In an .L5K file, separate pin names with commas.
Name
N/A
L5X only. Specify the tag name for the InOut Parameter on the Add-On Instruction
For L5X, this attribute is on the <InOutParameter> element.
For L5K, the InOut Parameter name is one of the attribute names on the FBD_PARAMETERS
statement.
Argument
N/A
172
Chapter 9
If the operand is not a qualified tag or literal value, the Add-On Instruction
is not verified.
The X and Y grid locations are a relative position from the upper-left corner
of the sheet. X is the horizontal position; Y is the vertical position.
JSR
L5X JSR structure
<JSR [JSR_Attributes]>
</JSR>
JSR attributes
L5X Item
L5K Item
Identifies
ID
ID
Routine
Routine
In
In
Ret
Ret
JSR guidelines
The X and Y grid locations are a relative position from the upper-left corner of the
sheet. X is the horizontal position; Y is the vertical position.
Rockwell Automation Publication 1756-RM084U-EN-P - November 2015
173
Chapter 9
SBR
<SBR [SBR_Attributes]>
</SBR>
SBR attributes
L5X Item
L5K Item
Identifies
ID
ID
Routine
Routine
Ret
Ret
SBR guidelines
The X and Y grid locations are a relative position from the upper-left corner of the
sheet. X is the horizontal position; Y is the vertical position.
RET
174
Chapter 9
RET attributes
L5X Item
L5K Item
Identifies
ID
ID
Routine
Routine
In
In
RET guidelines
The X and Y grid locations are a relative position from the upper-left corner of the
sheet. X is the horizontal position; Y is the vertical position.
The wire and feedback wire formats describe a wire by specifying what it is
attached to at each end, which is always a pin on another drawing element.
175
Chapter 9
Wire attributes
L5X Item
L5K Item
Identifies
FromID
FromElementID
FromParam
FromParameter
Type:
Parameter name
In
In
ToID
ToElementID
ToParam
ToParameter
Type:
Parameter name
Out
Out
Wire guidelines
Use these wire guidelines:
Text boxes
A feedback wire follows the same format as a wire. Just connect the Source
and Destination elements to form a feedback wire.
The text box blocks in an SFC routine hold descriptions about SFC components.
Chapter 9
L5K Item
Identifies
ID
ID
Width
Width
This attribute is not currently used; it is there for future use. Type 0.
Text
Text
Attachments
All text box blocks must come after all block sections.
The attachment blocks identify the attachments from text boxes to other function
block elements.
Attachment attributes
L5X Item
L5K Item
Identifies
FromID
FromElementID
ToID
ToElementID
The ID of the object that the FromID object is attached to. Type an
unsigned, 32-bit integer value.
177
Chapter 9
Attachment guidelines
Use these guidelines for attachments:
178
All attachment blocks must come after all text box blocks.
Examples
Chapter 9
179
Chapter 9
(ID := 5,
X := 520,
Y := 320,
Operand := Output_Tag)
END_OREF
ICON
(ID := 4,
X := 160,
Y := 320,
Name := ConnectorName)
END_ICON
OCON
(ID := 6,
X := 680,
Y := 100,
Name := ConnectorName)
END_OCON
MUL_BLOCK
(ID := 0,
X := 440,
Y := 60,
Operand := MUL_01,
VisiblePins := "SourceA, SourceB,
Dest")
END_MUL_BLOCK
SCL_BLOCK
(ID := 1,
X := 240,
Y := 60,
Operand := SCL_01,
VisiblePins := "In, InEUMax, Out,
MaxAlarm")
END_SCL_BLOCK
PI_BLOCK
180
(ID := 2,
X := 260,
Y := 260,
Operand := PI_01,
VisiblePins := "In, Initialize,
Chapter 9
(FromElementID := 3,
FromParameter := "",
ToElementID := 1,
ToParameter := In)
END_WIRE
WIRE
(FromElementID := 4,
FromParameter := "",
ToElementID := 2,
ToParameter := In)
END_WIRE
WIRE
(FromElementID := 0,
FromParameter := Dest,
ToElementID := 6,
ToParameter := "")
END_WIRE
WIRE
(FromElementID := 1,
FromParameter := Out,
ToElementID := 0,
ToParameter := SourceA)
END_WIRE
WIRE
(FromElementID := 2,
FromParameter := Out,
ToElementID := 5,
ToParameter := "")
END_WIRE
FEEDBACK_WIRE
(FromElementID := 0,
FromParameter := Dest,
ToElementID := 0,
ToParameter := SourceB)
END_FEEDBACK_WIRE
END_SHEET
END_FBD_ROUTINE
These tables list each function block instruction and its format in the Block
component of an import/export file. For details about a specific instruction, see
the listed reference manuals.
181
Chapter 9
Resource
Logix5000 Controllers Advanced Process Control and Drives Instruction Set Reference Manual, publication1756-RM006.
Motion instruction
Default Operand and VisiblePins formats (components within the Block structure)
ABS
Operand := ABS_01,
VisiblePins := "Source, Destination")
ACS
Operand := ACS_01,
VisiblePins := "Source, Destination")
ADD
Operand := ADD_01,
VisiblePins := "SourceA, SourceB, Destination")
ALM
Operand := ALM_01,
VisiblePins := "In, HHAlarm, HAlarm, LAlarm, LLAlarm, ROCPosAlarm, ROCNegAlarm")
ALMA
Operand := ALMA_01,
VisiblePins := "In, HHInAlarm, HInAlarm, LInAlarm, LLInAlarm, ROCPosInAlarm, ROCNegInAlarm, HHAcked, HAcked, LAcked, LLAcked, ROCPosAcked,
ROCNegAcked, Suppressed, Disabled")
ALMD
Operand := ALMD_01,
VisiblePins := "In, InAlarm, Acked, Suppressed, Disabled")
AND
Operand := AND_01,
VisiblePins := "SourceA, SourceB, Destination")
ASN
Operand := ASN_01,
VisiblePins := "Source, Destination")
ATN
Operand := ATN_01,
VisiblePins := "Source, Destination")
BAND
Operand := BAND_01,
VisiblePins := "In1, In2, In3, In4, Out")
BNOT
Operand := BNOT_01,
VisiblePins := "In, Out")
BOR
Operand := BOR_01,
VisiblePins := "In1, In2, In3, In4, Out")
BTDT
Operand := BTDT_01,
VisiblePins := "Source, SourceBit, Length, DestBit, Target, Dest")
BXOR
Operand := BXOR_01,
VisiblePins := "In1, In2, Out")
COS
Operand := COS_01,
VisiblePins := "Source, Dest")
CTUD
Operand := CTUD_01,
VisiblePins := "CUEnable, CDEnable, PRE, Reset, ACC, DN")
182
Chapter 9
Instruction
Default Operand and VisiblePins formats (components within the Block structure)
D2SD
Operand := D2SD_01,
VisiblePins := "ProgCommand, State0Perm, State1Perm, FB0, FB1, HandFB, ProgProgReq, ProgOperReq, ProgOverrideReq, ProgHandReq, Out,
Device0State, Device1State, CommandStatus, FaultAlarm, ModeAlarm, ProgOper, Override, Hand")
D3SD
Operand := D3SD_01,
VisiblePins := "Prog0Command, Prog1Command, Prog2Command, State0Perm, State1Perm, State2Perm, FB0, FB1, FB2, FB3, HandFB0, HandFB1,
HandFB2, ProgProgReq, ProgOperReq, ProgOverrideReq, ProgHandReq, Out0, Out1, Out2, Device0State, Device1State, Device2State,
Command0Status, Command1Status, Command2Status, FaultAlarm, ModeAlarm, ProgOper, Override, Hand")
DEDT
Operand := DEDT_01,
VisiblePins := "In, Out",
Storage := array_name)
DEG
Operand := DEG_01,
VisiblePins := "Source, Dest")
DERV
Operand := DERV_01,
VisiblePins := "In, ByPass, Out")
DFF
Operand := DFF_01,
VisiblePins := "D, Clear, Clock, Q, QNot")
DIV
Operand := DIV_01,
VisiblePins := "SourceA, SourceB, Dest")
ESEL
Operand := ESEL_01,
VisiblePins := "In1, In2, In3, In4, In5, In6, ProgSelector, ProgProgReq, ProgOperReq, ProgOverrideReq, Out, SelectedIn, ProgOper, Override")
EQU
Operand := EQU_01,
VisiblePins := "SourceA, SourceB")
FGEN
Operand := FGEN_01,
VisiblePins := "In, Out",
X1 := array_name,
X2 := array_name,
Y2 := array_name,
Y2 := array_name)
FRD
Operand := FRD_01,
VisiblePins := "Source, Dest")
GEQ
Operand := GEQ_01,
VisiblePins := "SourceA, SourceB")
GRT
Operand := GRT_01,
VisiblePins := "SourceA, SourceB")
HLL
Operand := HLL_01,
VisiblePins := "In, Out, HighAlarm, LowAlarm")
HPF
Operand := HPF_01,
VisiblePins := "In, Out")
INTG
Operand := INTG_01,
VisiblePins := "In, Out")
JKFF
Operand := JKFF_01,
VisiblePins := "Clear, Clock, Q, QNot")
LEQ
Operand := LEQ_01,
VisiblePins := "SourceA, SourceB")
183
Chapter 9
Instruction
Default Operand and VisiblePins formats (components within the Block structure)
LES
Operand := LES_01,
VisiblePins := "SourceA, SourceB")
LIM
Operand := LIM_01,
VisiblePins := "LowLlimit, Test, HighLimit")
LN
Operand := LN_01,
VisiblePins := "Source, Dest")
LOG
Operand := LOG_01,
VisiblePins := "Source, Dest")
LPF
Operand := LPF_01,
VisiblePins := "In, Out")
MAVE
Operand := MAVE_01,
VisiblePins := "In, Out",
Storage := array_name,
Weight := array_name)
MAXC
Operand := MAXC_01,
VisiblePins := "In, Reset, ResetValue, Out")
MEQ
Operand := MEQ_01,
VisiblePins := "Source, Mask, Compare")
MINC
Operand := MINC_01,
VisiblePins := "In, Reset, ResetValue, Out")
MOD
Operand := MOD_01,
VisiblePins := "SourceA, SourceB, Dest")
MSTD
Operand := MSTD_01,
VisiblePins := "In, SampleEnable, Out",
Storage := array_name)
MUL
Operand := MUL_01,
VisiblePins := "SourceA, SourceB, Dest")
MUX
Operand := MUX_01,
VisiblePins := "In1, In2, In3, In4, In5, In6, In7, In8, Selector, Out")
MVMT
Operand := MVMT_01,
VisiblePins := "Source, Mask, Target, Dest")
NEG
Operand := NEG_01,
VisiblePins := "Source, Dest")
NEQ
Operand := NEQ_01,
VisiblePins := "SourceA, SourceB")
NOT
Operand := NOT_01,
VisiblePins := "Source, Dest")
NTCH
Operand := NTCH_01,
VisiblePins := "In, Out")
OR
Operand := OR_01,
VisiblePins := "SourceA, SourceB, Dest")
OSFI
Operand := OSFI_01,
VisiblePins := "InputBit, OutputBit")
184
Chapter 9
Instruction
Default Operand and VisiblePins formats (components within the Block structure)
OSRI
Operand := OSRI_01,
VisiblePins := "InputBit, OutputBit")
PI
Operand := PI_01,
VisiblePins := "In, Out")
PIDE
Operand := PIDE_01,
VisiblePins := "PV, SPProg, SPCascade, RatioProg, CVProg, FF, HandFB, ProgProgReq, ProgOperReq, ProgCasRatReq, ProgAutoReq, ProgManuaReq,
ProgOverrideReq, ProgHandReq, CVEU, SP, PVHHAlarm, PVHAlarm, PVLAlarm, PVLLAlarm, PVROCPosAlarm, PVROCNegAlarm, DevHHAlarm,
DevHAlarm, DevLAlarm, DevLLAlarm, ProgOper, CasRat, Auto, Manual, Override, Hand")
PMUL
Operand := PMUL_01,
VisiblePins := "In, Multipler, Out")
POSP
Operand := POSP_01,
VisiblePins := "SP, Position, OpenedFB, ClosedFB, OpenOut, CloseOut")
RAD
Operand := RAD_01,
VisiblePins := "Source, Dest")
RESD
Operand := RESD_01,
VisiblePins := "Set, Reset, Out, OutNot")
RLIM
Operand := RLIM_01,
VisiblePins := "In, ByPass, Out")
RMPS
Operand := RMPS_01,
VisiblePins := "PV, CurrentSegProg, OutProg, SoakTimeProg, ProgProgReq, ProgOperReq, ProgAutoReq, ProgManualReq, ProgHoldReq, Out,
CurrentSeg, SoakTimeLeft, GuarRampOn, GuarSoakOn, ProgOper, Auto, Manual, Hold",
RampValue := array_name,
SoakValue := array_name,
SoakTime := array_name)
RTOR
Operand := RTOR_01,
VisiblePins := TimerEnable, PRE, Reset, ACC, DN")
SCL
Operand := SCL_01,
VisiblePins := "In, Out")
SCRV
Operand := SCRV_01,
VisiblePins := "In, Out")
SEL
Operand := SEL_01,
VisiblePins := "In1, In2, SelectorIn, Out")
SETD
Operand := SETD_01,
VisiblePins := "Set, Reset, Out, OutNot")
SIN
Operand := SIN_01,
VisiblePins := SIN(source,destination);
SNEG
Operand := SNEG_01,
VisiblePins := "In, NegateEnable, Out")
SOC
Operand := SOC_01,
VisiblePins := "In, Out")
SQR
Operand := SQR_01,
VisiblePins := "Source, Dest")
SRTP
Operand := SRTP_01,
VisiblePins := "In, HeatOut, CoolOut, HeatTimePercent, CoolTimePercent")
185
Chapter 9
Instruction
Default Operand and VisiblePins formats (components within the Block structure)
SSUM
Operand := SSUM_01,
VisiblePins := "In1, Select1, In2, Select2, In3, Select3, In4, Select4, Out")
SUB
Operand := SUB_01,
VisiblePins := "SourceA, SourceB, Dest")
TAN
Operand := TAN_01,
VisiblePins := "Source, Dest")
TOD
Operand := TOD_01,
VisiblePins := "Source, Dest")
TOFR
Operand := TOFR_01,
VisiblePins := "TimerEnable, PRE, Reset, ACC, DN")
TONR
Operand := TONR_01,
VisiblePins := "TimerEnable, PRE, Reset, ACC, DN")
TOT
Operand := TOT_01,
VisiblePins := "In, ProgProgReq, ProgOperReq, ProgStartReq, ProgStopReq, ProgResetReq, Total, OldTotal, ProgOper, RunStop, ProgResetDone,
TargetFlag, TargetDev1Flag, TargetDev2Flag")
TRN
Operand := TRN_01,
VisiblePins := "Source, Dest")
UPDN
Operand := UPDN_01,
VisiblePins := "InPlus, InMinus, Out")
XOR
Operand := XOR_01,
VisiblePins := "SourceA, SourceB, Dest")
XPY
Operand := XPY_01,
VisiblePins := "SourceA, SourceB, Dest")
186
Chapter 10
Introduction
This chapter explains how to enter sequential function chart logic in a complete
import/export file.
For more information on creating sequential function charts and correct syntax,
see the Logix5000 Controller Common Procedures Programming Manual,
publication 1756-PM001.
187
Chapter 10
<BRANCH declaration>
<SBR_RET declaration>
<STOP declaration>
<BRANCH declaration>
<DIRECTED_LINK declaration>
<TEXT_BOX declaration)
<ATTACHMENT declaration>
END_SFC_ROUTINE
L5K Item
Identifies
N/A
routine_name
Description
Description
SFCContent
N/A
SFC_Routine attributes
Attribute
Description
Name
Type
SheetSize
SheetOrientation
188
Attribute
Chapter 10
Description
StepName
The prefix for the name of the step blocks within this SFC routine. The
Logix Designer application uses this prefix when it automatically
generates an SFC_STEP tag.
In L5X, this attribute is on the <SFCContent> element.
TransitionName
The prefix for the name of the transition blocks with this SFC routine. The Logix Designer application uses this
prefix when it automatically generates a transition tag.
ActionName
The prefix for the name of the action blocks in this SFC routine. The Logix Designer application uses this prefix
when it automatically generates an SFC_ACTION tag.
The prefix for the name of the stop blocks in this SFC routine. The Logix Designer application uses this prefix
when it automatically generates an SFC_STOP tag.
In L5X, this attribute is on the <SFCContent> element.
OnlineEditType
L5X only. Specify the online edit logic type (Original, PendingEdits, or TestEdits). This attribute is not
specified if there are no edits.
In L5X, this attribute is on the <SFCContent> element.
PermissionSet
Name of the set of permissions, configured in FactoryTalk Security, to apply to this object.
If you export sequential function chart logic that contains online edits, the export
file exports LOGIC blocks (in L5K format) or additional <SFCContent>
elements (in L5X format) to indicate the original, test edits, and pending edits
states. If there are no online edits, you will not see these LOGIC blocks or
additional <SFCContent> elements.
L5X Example: Test edits and pending edits exist
189
Chapter 10
Identifies
Online_Edit_Type
Steps
190
Chapter 10
Step elements
L5X Item
L5K Item
Identifies
Preset
PRESET
A structured text expression that specifies the preset time in milliseconds for the step timer.
If the PresetUsesExpression attribute (above) is Yes, type preset logic.
LimitHigh
LIMIT_HIGH
A structured text expression that specifies the preset time in milliseconds for a limit
high alarm. If the LimitHighUsesExpression attribute (above) is Yes, type limit high logic.
LimitLow
LIMIT_LOW
A structured text expression that specifies the preset time in milliseconds for a limit
low alarm. If the LimitLowUsesExpression attribute (above) is Yes, type limit low logic.
ActionList
ACTION_LIST
Step attributes
L5X Item
L5K Item
Identifies
ID
ID
The step identifier. This ID uniquely identifies this step from all other blocks. Type an
unsigned, 32-bit integer value.
Rockwell Automation Publication 1756-RM084U-EN-P - November 2015
191
Chapter 10
L5X Item
L5K Item
Identifies
Operand
Operand
The step tag. Type a tag of datatype SFC_STEP. The import process uses this tag name to
name the step.
HideDesc
HideDescription
DescX
DescriptionX
X-coordinate on internal grid of the description box. Type an unsigned, 32-bit integer value.
DescY
DescriptionY
Y-coordinate on internal grid of the description box. Type unsigned, 32-bit integer value.
DescWidth
DescriptionWidth
This attribute is not currently used; it is there for future use. Type 0.
InitialStep
InitialStep
Whether this step is the initial step of the routine. Type Yes or No.
If you have multiple steps identified as the initial step, which is incorrect syntax, the import
process designates the last initial step it encounters as the initial step and removes the
initial step indicators from any other steps.
PresetUsesExpr
PresetUsesExpression
Whether the preset for the step timer is a structured text expression. Type Yes if you plan to
enter an expression in a preset element, otherwise, type No.
LimitHighUsesExpr
LimitHighUsesExpression
Whether the preset for the limit high alarm is a structured text expression. Type Yes if you
plan to enter an expression in a limit high element, otherwise, type No.
LimitLowUsesExpr
LimitLowUsesExpression
Whether the preset for the limit low alarm is a structured text expression. Type Yes if you
plan to enter an expression in a limit low element, otherwise, type No.
ShowActions
ShowActions
Preset
The preset component contains a structured text expression that specifies the
preset time in milliseconds for the step timer.
Chapter 10
Each line of L5K structured text begins with a single quote ().
Limit high
The limit high component contains a structured text expression that specifies the
preset time in milliseconds for a limit high alarm.
Each line of L5K structured text begins with a single quote ().
Limit low
The limit low component contains a structured text expression that specifies the
preset time in milliseconds for a limit low alarm.
Each line of L5K structured text begins with a single quote ().
193
Chapter 10
Action list
Action attributes
L5X Item
L5K Item
Identifies
ID
ID
The action identifier. This ID uniquely identifies this action from all other blocks. Enter an
unsigned, 32-bit integer value.
Operand
Operand
The action tag. Enter a tag of datatype SFC_ACTION. The import process uses this tag name
to name the action.
Qualifier
Qualifier
Description
non-stored
reset
stored
time limited
time delayed
pulse
pulse (rising edge)
pulse (falling edge)
stored and time limited
stored and time delayed
time delayed and stored
IsBoolean
IsBoolean
PresetUsesExpr
PresetUsesExpression
Whether the preset for the action timer is a structured text expression. Enter Yes if you plan
to enter an expression in a PRESET block, otherwise, enter No.
194
L5X Item
L5K Item
Identifies
IndicatorTag
IndicatorTag
Chapter 10
Transitions
Transition elements
L5X Item
L5K Item
Identifies
Condition
CONDITION
Transition attributes
L5X Item
L5K Item
Identifies
ID
ID
The step identifier. This ID uniquely identifies this step from all other blocks. Type an
unsigned, 32-bit integer value.
Operand
Operand
The step tag. Type a tag of datatype SFC_STEP. The import process uses this tag name to
name the step.
HideDesc
HideDescription
DescX
DescriptionX
X-coordinate on internal grid of the description box. Type an unsigned, 32-bit integer value.
DescY
DescriptionY
Y-coordinate on internal grid of the description box. Type unsigned, 32-bit integer value.
195
Chapter 10
L5X Item
L5K Item
Identifies
DescWidth
DescriptionWidth
This attribute is not currently used; it is there for future use. Type 0.
Force
Force
The transition is forced. Type true for forced true (set) or type false for forced false
(cleared). If the transition is not forced, do not enter this attribute.
Condition
Each line of L5K structured text begins with a single quote ().
Subroutine calls
Subroutine calls pass values into and out of the SFC routine.
196
Chapter 10
Subroutine attributes
L5X Item
L5K Item
Identifies
ID
ID
The SBR_RET identifier. This ID uniquely identifies this subroutine call from all other blocks.
Type an unsigned, 32-bit integer value.
In
In
List of values to receive from the calling routine. Type list of tags or literal values and
separate each entry by a comma (,). Enter empty quotes if there are no values to receive.
Ret
Out
List of values to pass to the calling routine. Type list of tags or literal values and separate
each entry by a comma (,). Enter empty quotes if there are no values to pass.
Stops
Stop attributes
L5X Item
L5K Item
Identifies
ID
ID
The stop identifier. This ID uniquely identifies this stop from all other blocks. Type an
unsigned, 32-bit integer value.
Operand
Operand
The stop tag. Type a tag of datatype SFC_STOP. The import process uses this tag name to
name the stop.
HideDesc
HideDescription
DescX
DescriptionX
X-coordinate on internal grid of the description box. Type an unsigned, 32-bit integer value.
DescY
DescriptionY
Y-coordinate on internal grid of the description box. Type unsigned, 32-bit integer value.
DescWidth
DescriptionWidth
This attribute is not currently used; it is there for future use. Type 0.
197
Chapter 10
Branches
Branch attributes
L5X Item
L5K Item
Identifies
ID
ID
The branch identifier. This ID uniquely identifies this branch from all other blocks. Type an
unsigned, 32-bit integer value.
BranchType
BranchType
BranchFlow
BranchFlow
Priority
Priority
Whether the priority of a divergent selection branch is defined by the user. This attribute
applies only to divergent selection branches. Type Default or UserDefined.
Leg attributes
L5X Item
L5K Item
Identifies
ID
ID
The leg identifier. This ID uniquely identifies this leg from all other blocks. Type an unsigned,
32-bit integer value.
Force
Force
Whether the leg is forced or not. You can force only a leg in a simultaneous branch. Omit this
attribute, for no forces, or type false to force the leg false.
198
Chapter 10
The directed link blocks in an SFC routine identify the links between SFC
components.
Directed links
[DirectedLinkAttributes]/>
L5K Item
Identifies
FromID
FromElementID
ToID
ToElementID
The ID of the object that the FromID object is attached to. Type an unsigned, 32-bit
integer value.
Show
ShowLink
Text boxes
All directed link blocks must come after all step, transition, stop, and branch
blocks.
The text box blocks in an SFC routine hold descriptions about SFC components.
199
Chapter 10
L5K Item
Identifies
ID
ID
Width
Width
This attribute is not currently used; it is there for future use. Type 0.
Text
Text
Attachments
All text box blocks must come after all directed link blocks.
The attachment blocks in an SFC routine identify the attachments from text
boxes to other SFC elements.
200
Chapter 10
Attachment attributes
L5X Item
L5K Item
Identifies
FromID
FromElementID
ToID
ToElementID
The ID of the object that the FromID object is attached to. Type an
unsigned, 32-bit integer value.
Attachment guidelines
Use these guidelines for attachments:
Examples
All attachment blocks must come after all text box blocks.
201
Chapter 10
202
Chapter 10
203
Chapter 10
Chapter 10
205
Chapter 10
'TempTag > 0
END_CONDITION
END_TRANSITION
DIRECTED_LINK (FromElementID
ShowLink := True)
END_DIRECTED_LINK
DIRECTED_LINK (FromElementID
ShowLink := True)
END_DIRECTED_LINK
DIRECTED_LINK (FromElementID
ShowLink := True)
END_DIRECTED_LINK
DIRECTED_LINK (FromElementID
ShowLink := True)
END_DIRECTED_LINK
DIRECTED_LINK (FromElementID
ShowLink := True)
END_DIRECTED_LINK
DIRECTED_LINK (FromElementID
ShowLink := True)
END_DIRECTED_LINK
DIRECTED_LINK (FromElementID
ShowLink := True)
END_DIRECTED_LINK
DIRECTED_LINK (FromElementID
ShowLink := True)
END_DIRECTED_LINK
DIRECTED_LINK (FromElementID
ShowLink := True)
END_DIRECTED_LINK
DIRECTED_LINK (FromElementID
ShowLink := True)
END_DIRECTED_LINK
DIRECTED_LINK (FromElementID
ShowLink := True)
END_DIRECTED_LINK
DIRECTED_LINK (FromElementID
ShowLink := True)
END_DIRECTED_LINK
DIRECTED_LINK (FromElementID
ShowLink := True)
END_DIRECTED_LINK
DIRECTED_LINK (FromElementID
ShowLink := True)
END_DIRECTED_LINK
Chapter 10
:= 3, ToElementID := 37,
:= 5, ToElementID := 31,
:= 6, ToElementID := 2,
:= 22, ToElementID := 6,
:= 16, ToElementID := 0,
:= 4, ToElementID := 8,
207
Chapter 10
208
Chapter 11
Introduction
L5K Item
Description
N/A
routine_name
Description
Description
STContent
statements
N/At
comment_text
209
Chapter 11
ST_Routine attributes
Attribute
Description
Name
Type
OnlineEditType
Name of the set of permissions, configured in FactoryTalk Security, to apply to this object.
Term
Definition
Examples
Assignment
tag := expression;
Expression
Tags
A named area of the memory where data is stored (BOOL, SINT, INT,
DINT, REAL, string).
value1
Immediates
A constant value.
Operators
tag1 + tag2
tag1 >= value1
Functions
function(tag1)
210
Term
Definition
Examples
Instruction
instruction();
Chapter 11
instruction(operand);
instruction(operand1,
operand2,operand3);
IF...THEN
CASE
FOR...DO
WHILE...DO
REPEAT...UNTIL
EXIT
Comment
//comment
If you export structured text logic that contains online edits, the export file
exports LOGIC blocks (in L5K format) or additional <STContent> elements (in
L5X format) to indicate the original test edits and pending edits states. If there are
no online edits, you will not see these LOGIC blocks or additional <STContent>
elements.
Item
Identifies
Online_Edit_Type
211
Chapter 11
Examples
212
Chapter 11
myInteger := myInteger + 3;
myTmpVar := myTmpVar - 1;
END_WHILE;
END_IF;
ND_ST_ROUTINE
Structured text
These tables list each structured text instruction and function. For more details,
see these reference manuals.
213
Chapter 11
Instruction Type
Resource
Logix5000 Controllers Advanced Process Control and Drives Instruction Set Reference Manual, publication1756-RM006.
Motion instruction
ABL
ABL(Channel,SerialPortControl);
ABS
dest := ABS(source);
ACB
ACB(Channel,SerialPortControl);
ACL
ACL(Channel,ClearSerialPortRead,ClearSerialPortWrite);
ACOS
dest := ACOS(source);
ADD
AHL
AHL(Channel,ANDMask,ORMask,SerialPortControl);
ALM
ALM(ALM_tag);
ALMA
ALMA (ALMA_tag,In,ProgAckAll,ProgramDisable,ProgEnable);
ALMD
ALMD (ALMD_tag,In,ProgAck,ProgReset,ProgDisable,ProgEnable);
AND
ARD
ARD(Channel,Destination,SerialPortControl);
ARL
ARL(Channel,Destination,SerialPortControl);
ASIN
dest := ASIN(source);
ATAN
dest := ATAN(source);
AWA
AWA(Channel,Source,SerialPortControl);
AWT
AWT(Channel,Source,SerialPortControl);
BAND
BNOT
BOR
BTDT
BTD(BTDT_tag);
BXOR
214
Instruction
CASE...OF
CASE numeric_expression OF
Chapter 11
selector1: statement;
selectorN: statement;
ELSE
statement;
END_CASE;
CLR
dest := 0;
CONCAT
CONCAT(SourceA,SourceB,Dest)
COP
COP(Source,Dest,Length);
COS
dest := COS(source);
CPS
CPS(Source,Dest,Length)
CTUD
CTUD(CTUD_tag);
D2SD
D2SD(D2SD_tag);
D3SD
D3SD(D3SD_tag);
DEDT
DEDT(DEDT_tag,storage);
DEG
dest := DEG(source);
DELETE
DELETE(Source,Qty,Start,Dest);
DERV
DERV(DERV_tag);
DFF
DFF(DFF_tag);
DIV
DTOS
DTOS(Source,Dest);
EOT
EOT(DataBit);
EQU
ESEL
ESEL(ESEL_tag);
EVENT
EVENT(task);
FGEN
FGEN(FGEN_tag,X1,Y1,X2,Y2);
FIND
FIND(Source,Search,Start,Result)
FOR...DO
GEQ
215
Chapter 11
Instruction
GRT
GSV
GSV(ClassName,InstanceName,AttributeName,Dest);
HLL
HLL(HLL_tag);
HPF
HPF(HPF_tag);
IF...THEN
IF bool_expression THEN
<statement>;
END_IF;
INSERT
INSERT(SourceA,SourceB,Start,Dest);
INTG
INTG(INTG_tag);
IOT
IOT(output_tag);
JKFF
JKFF(JKFF_tag);
JSR
JSR(RoutineName,InputCount,InputPar,ReturnPar);
LDL2
LDL2(LDL2_tag);
LDLG
LDLG(LDLG_tag);
LEQ
LES
LN
dest := LN(source);
LOG
dest := LOG(source);
LOWER
LOWER(Source,Dest);
LPF
LPF(LPF_tag);
MAAT
MAAT(Axis,MotionControl);
MAFR
MAFR(Axis,MotionControl);
MAG
MAG(SlaveAxis,MasterAxis,MotionControl,Direction,Ratio,SlaveCounts,
MasterCounts,MasterReference,RatioFormat,Clutch,AccelRate,AccelUnits);
MAH
MAH(Axis,MotionControl);
MAHD
MAHD(Axis,MotionControl,DiagnosticTest,ObservedDirection);
MAJ
MAJ(Axis,MotionControl,Direction,Speed,SpeedUnits,AccelRate,AccelUnits,
DecelRate,DecelUnits,Profile,Merge,MergeSpeed);
MAM
MAM(Axis,MotionControl,MoveType,Position,Speed,SpeedUnits,AccelRate,
AccelUnits,DecelRate,DecelUnits,Profile,Merge,MergeSpeed);
MAOC
MAOC(Axis,ExecutionTarget,MotionControl,Output,Input,OutputCam,
CamStartPosition,CamEndPosition,OutputCompensation,ExecutionMode,
ExecutionSchedule,AxisArmPosition,CamArmPosition,Reference);
216
Chapter 11
Instruction
MAPC
MAPC(SlaveAxis,MasterAxis,MotionControl,Direction,CamProfile,
SlaveScaling,MasterScaling,ExecutionMode,ExecutionSchedule,
MasterLockPosition,CamLockPosition,MasterReference,MasterDirection);
MAR
MAR(Axis,MotionControl,TriggerCondition,WindowedRegistration,
MinimumPosition,MaximumPosition);
MAS
MAS(Axis,MotionControl,StopType,ChangeDecel,DecelRate,DecelUnits);
MASD
MASD(Axis,MotionControl);
MASR
MASR(Axis,MotionControl);
MATC
MATC(Axis,MotionControl,Direction,CamProfile,DistanceScaling,
TimeScaling,ExecutionMode,ExecutionSchedule);
MAVE
MAVE(MAVE_tag,storage,weight);
MAW
MAW(Axis,MotionControl,TriggerCondition,Position);
MAXC
MAXC(MAXC_tag);
MCCD
MCCD(Coordinate_system,MotionControl,MotionType,ChangeSpeed,Speed,
SpeedUnits,ChangeAccel,AccelRate,AccelUnits,ChangeDecel,DecelRate,
DecelUnits,Scope);
MCCM
MCCM(CoordinateSystem,MotionControl,MoveType,Position,CircleType,
Via/Center/Radius,Direction,Speed,SpeedUnits,AccelRate,AccelUnits,
DecelRate,DecelUnits,Profile,TerminationType,Merge,MergeSpeed);
MCCP
MCCP(MotionControl,Cam,Length,StartSlope,EndSlope,CamProfile);
MCD
MCD(Axis,MotionControl,MotionType,ChangeSpeed,Speed,ChangeAccel,
AccelRate,ChangeDecel,DecelRate,SpeedUnits,AccelUnits,DecelUnits);
MCLM
MCLM(CoordinateSystem,MotionControl,MoveType,Position,Speed,SpeedUnits,
AccelRate,AccelUnits,DecelRate,DecelUnits,Profile,TerminationType,Merge,
MergeSpeed);
MCS
MCS(CoordinateSystem,MotionControl,StopType,ChangeDecel,DecelRate,
DecelUnits);
MCSD
MCSD(CoordinateSystem,MotionControl);
MCSR
MCSR(CoordinateSystem,MotionControl);
MCSV
MCSV(MotionControl,CamProfile,MasterValue,SlaveValue,SlopeValue,
SlopeDerivative);
MCT
MCT(SourceSystem,TargetSystem,MotionControl,Orientation,Translation);
MCTP
MCTP(SourceSystem,TargetSystem,MotionControl,Orientation,Translation,
TransformDirection,ReferencePosition,TransformPosition);
MDF
MDF(Axis,MotionControl);
MDO
MDO(Axis,MotionControl,DriveOutput,DriveUnits);
MDOC
MDOC(Axis,ExecutionTarget,MotionControl,DisarmType);
MDR
MDR(Axis,MotionControl);
MDW
MDW(Axis,MotionControl);
MEQ
217
Chapter 11
Instruction
MGS
MGS(Group,MotionControl,StopMode);
MGSD
MGSD(Group,MotionControl);
MGSP
MGSP(Group,MotionControl);
MGSR
MGSR(Group,MotionControl);
MID
MID(Source,Qty,Start,Dest);
MINC
MINC(MINC_tag);
MOD
MRAT
MRAT(Axis,MotionControl);
MRHD
MRHD(Axis,MotionControl,DiagnosticTest);
MRP
MRP(Axis,MotionControl,Type,PositionSelect,Position);
MSF
MSF(Axis,MotionControl);
MSG
MSG(MessageControl);
MSO
MSO(Axis,MotionControl);
MUL
MVMT
MVMT(MVMT_tag);
NEG
dest := -source;
NEQ
NOT
OR
OSFI
OSFI(OSFI_tag);
OSRI
OSRI(OSRI_tag);
OTE
OTL
IF BOOL_expression THEN
data_bit := 1;
END_IF;
OTU
IF BOOL_expression THEN
data_bit := 0;
END_IF;
PATT
PATT(PhaseName,Result);
PCLF
PCLF(PhaseName);
PCMD
PCMD(PhaseName,Command,Result);
PDET
PDET(PhaseName);
PFL
PFL(Source);
PI
PI(PI_tag);
218
Chapter 11
Instruction
PID
PID(PID,ProcessVariable,Tieback,ControlVariable,PIDMasterLoop,InholdBit,
InholdValue);
PIDE
PIDE(PIDE_tag);
PMUL
PMUL(PMUL_tag);
POSP
POSP(POSP_tag);
POVR
POVR(PhaseName,Command,Result);
PPD
PPD();
PRNP
PRNP();
PSC
PSC();
PXRQ
PXRQ(PhaseInstruction,ExternalRequest,DataValue);
RAD
dest := RAD(source);
REPEAT...UNTIL
REPEAT
<statement>;
UNTIL bool_expression
END_REPEAT;
RESD
RESD(RESD_tag);
RET
RET(ReturnPar);
RLIM
RLIM(RLIM_tag);
RMPS
RMPS(RMPS_tag,RampValue,SoakValue,SoakTime);
RTOR
RTOR(RTOR_tag);
RTOS
RTOS(Source,Dest)
SBR
SBR(InputPar);
SCRV
SCRV(SCRV_tag);
SETD
SETD(SETD_tag);
SFP
SFP(SFCRoutineName,TargetState);
SFR
SFR(SFCRoutineName,StepName);
SIN
dest := SIN(source);
SIZE
SIZE(Souce,Dimensiontovary,Size);
SNEG
SNEG(SNEG_tag);
SOC
SOC(SOC_tag);
SQRT
dest := SQRT(source);
SRT
SRT(Array,Dimtovary,Control);
SRTP
SRTP(SRTP_tag);
SSUM
SSUM(SSUM_tag);
SSV
SSV(ClassName,InstanceName,AttributeName,Source);
219
Chapter 11
Instruction
STOD
STOD(Source,Dest)
STOR
STOR(Source,Dest)
SUB
SWPB
SWPB(Source,OrderMode,Dest);
TAN
dest := TAN(source);
TOFR
TOFR(TOFR_tag);
TONR
TONR(TONR_tag);
TOT
TOT(TOT_tag);
TRUNC
dest := TRUNC(source);
UID
UID();
UIE
UIE();
UPDN
UPDN(UPDN_tag);
UPPER
UPPER(Source,Destination);
WHILE...DO
WHILE bool_expression DO
<statement>;
END_WHILE;
XIC
IF data_bit THEN
<statement>;
END_IF;
XIO
XOR
XPY
220
Chapter 12
Introduction
Equipment Sequence
Routine
221
Chapter 12
</TagConfigurations/>
</SEQContent>
</Routine>
</Routines>
L5K Item
Identifies
N/A
routine_name
Description
Description
SEQContent
N/A
222
Chapter 12
ESQ_Routine attributes
Attribute
Description
Name
Type
SheetSize
SheetOrientation
Name of the set of permissions, configured in FactoryTalk Security, to apply to this object.
Steps
Step attributes
L5X Item
L5K Item
Identifies
ID
ID
The step identifier. This ID uniquely identifies this step from all
other blocks. Type an unsigned, 32-bit integer value.
223
Chapter 12
L5X Item
L5K Item
Identifies
Operand
Operand
HideDesc
HideDescription
DescX
DescriptionX
DescY
DescriptionY
DescWidth
DescriptionWidth
This attribute is not currently used; it is there for future use. Type
0.
InitialStep
InitialStep
Whether this step is the initial step of the routine. Type Yes or No.
If you have multiple steps identified as the initial step, which is
incorrect syntax, the import process designates the last initial step
it encounters as the initial step and removes the initial step
indicators from any other steps.
NoPhaseStep
NoPhaseStep
PhaseName
PhaseName
The name of the Phase associated with the step. Can be an empty
string.
TransferOfControlSource
TransferOfControlSource
TransferOfControlTarget
TransferOfControlTarget
Specifies whether this step will accept the transfer control of its
equipment phase from an immediately preceding step without
starting the phase. The phase logic is expected to be executing a
state routine. The executing routine is notified of the transfer of
control and can request new input parameters, if programmed to
do so, from the target step.
L5K: Yes/No, L5X: true/false.
Transitions
Chapter 12
logic
</Condition>
</Transition>
Transition elements
L5X Item
L5K Item
Identifies
Condition
CONDITION
Transition attributes
L5X Item
L5K Item
Identifies
ID
ID
The step identifier. This ID uniquely identifies this step from all other blocks. Type an
unsigned, 32-bit integer value.
Operand
Operand
The step tag. Type a tag of datatype SFC_STEP. The import process uses this tag name to
name the step.
HideDesc
HideDescription
DescX
DescriptionX
X-coordinate on internal grid of the description box. Type an unsigned, 32-bit integer value.
DescY
DescriptionY
Y-coordinate on internal grid of the description box. Type unsigned, 32-bit integer value.
DescWidth
DescriptionWidth
This attribute is not currently used; it is there for future use. Type 0.
Force
Force
The transition is forced. Type true for forced true (set) or type false for forced false
(cleared). If the transition is not forced, do not enter this attribute.
Stops
225
Chapter 12
Stop attributes
L5X Item
L5K Item
Identifies
ID
ID
The stop identifier. This ID uniquely identifies this stop from all other blocks. Type an
unsigned, 32-bit integer value.
Operand
Operand
The stop tag. Type a tag of datatype SFC_STOP. The import process uses this tag name to
name the stop.
HideDesc
HideDescription
DescX
DescriptionX
X-coordinate on internal grid of the description box. Type an unsigned, 32-bit integer value.
DescY
DescriptionY
Y-coordinate on internal grid of the description box. Type unsigned, 32-bit integer value.
DescWidth
DescriptionWidth
This attribute is not currently used; it is there for future use. Type 0.
Branches
226
Chapter 12
Branch attributes
L5X Item
L5K Item
Identifies
ID
ID
The branch identifier. This ID uniquely identifies this branch from all other blocks. Type an
unsigned, 32-bit integer value.
BranchType
BranchType
BranchFlow
BranchFlow
Priority
Priority
Whether the priority of a divergent selection branch is defined by the user. This attribute
applies only to divergent selection branches. Type Default or UserDefined.
Leg attributes
L5X Item
L5K Item
Identifies
ID
ID
The leg identifier. This ID uniquely identifies this leg from all other blocks. Type an unsigned,
32-bit integer value.
Force
Force
Whether the leg is forced or not. You can force only a leg in a simultaneous branch. Omit this
attribute, for no forces, or type false to force the leg false.
The directed link blocks in an Equipment Sequence routine identify the links
between Equipment Sequence components.
Directed links
[DirectedLinkAttributes]/>
L5K Item
Identifies
FromID
FromElementID
227
Chapter 12
L5X Item
L5K Item
Identifies
ToID
ToElementID
The ID of the object that the FromID object is attached to. Type an unsigned, 32-bit
integer value.
Show
ShowLink
Attachments
All directed link blocks must come after all step, transition, stop, and branch
blocks.
Attachment attributes
L5X Item
L5K Item
Identifies
FromID
FromElementID
ToID
ToElementID
The ID of the object that the FromID object is attached to. Type an
unsigned, 32-bit integer value.
Attachment guidelines
Use these guidelines for attachments:
228
Tag configuration
Chapter 12
All attachment blocks must come after all text box blocks.
Expression component
L5X Item
L5K Item
Description
Expression
EXPRESSION
229
Chapter 12
Tip:
Each line of L5K structured text begins with a single quote ().
230
Chapter 13
Introduction
Task component
A task component defines a task in the controller project. The maximum number
of tasks depends on the type of controller.
Controller
ControlLogix
32
SoftLogix5800
32
FlexLogix
CompactLogix
1768-L30x
1769-L36x
32
32
23
DriveLogix
1769-L33x
231
Chapter 13
Task elements
L5X Item
L5K Item
Description
N/A
task_name
Description
Description
EventInfo
N/A
ScheduledProgram
program_name
Task attributes
Attribute
Description
Name
Type
Specify whether the type of task is Continuous, Periodic, or Event. There can be only one continuous task.
Class
Specify the class of the task. This attribute applies only to safety controller projects. Type Standard or Safety.
Rate
If the task is a periodic task, specify how often to run the task (1.000...2,000,000.000 s).
Priority
Watchdog
EventTrigger
EventTag
Only used for event tasks with a Consumed Tag trigger or a Module Input Data State Change trigger.
Specify the tag to consume.
In L5X, this attribute is on the <EventInfo> element.
EnableTimeout
Type Yes to enable timeouts for the task. Otherwise type No.
In L5X, this attribute is on the <EventInfo> element.
DisableUpdateOutputs
Type Yes to disable updates to outputs while the task executes. Otherwise type No. The default for a periodic or
continuous task is No. The default for an event task is yes.
InihibitTask
232
Task guidelines
Examples
Chapter 13
You can define the task attributes (Type, Priority, Rate, and Watchdog) in any
order. The list of programs scheduled for a task are listed in the task declarations
block, as shown above. The programs are executed in the order they are specified.
L5K Safety TASK Example
TASK SafetyTask (Type := PERIODIC,
Class := Safety,
Rate := 10,
Priority := 10,
Watchdog := 10,
DisableUpdateOutputs := No,
InhibitTask := No)
SafetyProgram;
END_TASK
233
Chapter 14
Introduction
Parameter connection
component
Description
EndPoint1
EndPoint2
235
Chapter 14
Parameter connection
guidelines
Examples
Chapter 14
237
Chapter 14
EndPoint2 :=
\MainProgram.Input_ParameterMain)
END_PARAMETER_CONNECTION
PARAMETER_CONNECTION (EndPoint1 :=
\SubProgram.Output_ParameterSub,
EndPoint2 :=
\SecondProgram.Input_ParameterFromMain)
END_PARAMETER_CONNECTION
CONFIG CST(SystemTimeMasterID := 0) END_CONFIG
238
Chapter 15
Introduction
Trend component
A trend component defines a controller trend. Trend objects are optional. You
can have as many as 32 trends per import/export file.
Trend elements
L5X Item
L5K Item
Description
N/A
trend_name
Description
Description
Template
template_data
239
Chapter 15
L5X Item
L5K Item
Description
Pens
PEN
Trend attributes
Attribute
Description
Name
SamplePeriod
Specify how often trending tags are collected in msec (1 msec...30 minutes).
NumberOfCaptures
CaptureSizeType
Define how the capture size is specified. Type Samples, TimePeriod, or NoLimit.
CaptureSize
Specify the number of samples for each capture. The maximum number of samples is 2-hours worth of data samples or
1000 samples, whichever is greater. If the CaptureSizeType is Samples, the range is 1...(2 hours/SamplePeriod) or 1000
samples, whichever is greater. If the CaptureSizeType is TimePeriod, the range is SamplePeriod...2 hours or
(SamplePeriod * 1000), whichever is greater.
StartTriggerType
StartTriggerTag1
Specify the tag name of the first start trigger. The name must be one of the pen names.
StartTriggerOperation1
StartTriggerTargetType1
Specify the type of the first start trigger target. Type TargetValue or TargetTag. If you type TargetValue,
StartTriggerTargetValue1 is expected. Otherwise, StartTriggerTargetTag1 is expected.
StartTriggerTargetValue1
Specify a target value if the StartTriggerTargetType1 is TargetValue. Type a binary, octal, decimal, or hexadecimal
integer number or type a floating point number.
StartTriggerTargetTag1
Specify a target tag if the StartTriggerTargetType is TargetTag. The tag must be one of the pen names.
StartTriggerLogicalOperation
Specify a logical operation (AND or OR) that is performed on StartTriggerxxx1 and StartTriggerxxx2. StartTriggerxxx1
consists of StartTriggerTag1, StartTriggerOperation1, StartTriggerTargetType1, and StartTriggerTargetValue1 or
StartTriggerTargetTag1. StartTriggerxxx2 consists of StartTriggerTag2, StartTriggerOperation2,
StartTriggerTargetType2, and StartTriggerTargetValue2 or StartTriggerTargetTag2.
StartTriggerTag2
Specify the tag name of the second start trigger. The name must be one of the pen names.
240
Chapter 15
Attribute
Description
StartTriggerOperation2
StartTriggerTargetType2
Specify the type of the second start trigger target. Type TargetValue or TargetTag. If you type TargetValue,
StartTriggerTargetValue2 is expected. Otherwise, StartTriggerTargetTag2 is expected.
StartTriggerTargetValue2
Specify a target value if the StartTriggerTargetType2 is TargetValue. Type a binary, octal, decimal, or hexadecimal
integer number or type a floating point number.
StartTriggerTargetTag2
Specify a target tag if the StartTriggerTargetType is TargetTag. The tag must be one of the pen names.
PreSampleType
PreSamples
Specify the number of pre-samples (0...1000) if the PreSampleType is Samples. Specify a time period (0...(SamplePeriod
1000)) that covers pre-samples if the PreSampleType is TimePeriod.
StopTriggerType
Specify the type of the stop trigger. Type NoTrigger or Event Trigger.
StopTriggerTag1
Specify the tag name of the first trigger. The name must be one of the pen names.
StopTriggerOperation1
StopTriggerTargetType1
Specify the type of the first stop trigger target. Type TargetValue or TargetTag. If you specify TargetValue,
StopTriggerTargetValue1 is expected. Otherwise, StopTriggerTargetTag1 is expected.
StopTriggerTargetValue1
Specify a target value if the StopTriggerTargetType1 is TargetValue. Type a binary, octal, decimal, or hexadecimal
integer number or type a floating point number.
StopTriggerTargetTag1
Specify a target tag if the StopTriggerTargetType is TargetTag. The name must be one of the pen names.
241
Chapter 15
Attribute
Description
StopTriggerLogicalOperation
Specify a logical operation (AND or OR) that is performed on StopTriggerxxx1 and StopTriggerxxx2. StopTriggerxxx1
consists of StopTriggerTag1, StopTriggerOperation1, StopTriggerTargetType1, and StopTriggerTargetValue1 or
StopTriggerTargetTag1. StopTriggerxxx2 consists of StopTriggerTag2, StopTriggerOperation2, StopTriggerTargetType2,
and StopTriggerTargetValue2 or StopTriggerTargetTag2.
StopTriggerTag2
Specify the tag name of the second trigger. The name must be one of the pen names.
StopTriggerOperation2
StopTriggerTargetType2
Specify the type of the second stop trigger target. Type TargetValue or TargetTag. If you specify TargetValue,
StopTriggerTargetValue2 is expected. Otherwise, StopTriggerTargetTag2 is expected.
StopTriggerTargetValue2
Specify a target value if the StopTriggerTargetType2 is TargetValue. Type a binary, octal, decimal, or hexadecimal
integer number or type a floating point number.
StopTriggerTargetTag2
Specify a target tag if the StopTriggerTargetType is TargetTag. The name must be one of the pen names.
PostSampleType
PostSamples
Specify the number of post-samples (0...1000) if the PostSampleType is Samples. Specify a time period
(0...(SamplePeriod 1000)) that covers post-samples if the PostSampleType is TimePeriod.
TrendxVersion
Pen declaration
A trend object can have as many as eight pen declarations. A pen declaration
follows this structure.
242
Chapter 15
Pen elements
L5X Item
L5K Item
Description
N/A
pen_name
Description
Description
Pen attributes
Attribute
Description
Name
Color
Specify the color of the line in RGB format. Type the hex number for the color (16#0000_0000 16#00FF_FFFF).
Visible
Specify whether or not the line should be visible. Type TRUE or FALSE.
Width
Type
Style
Marker
Min
Specify the minimum value for the pen. The minimum cannot be greater than or equal to the maximum.
Max
Specify the maximum value for the pen. The maximum cannot be less than or equal to the minimum.
EngUnits
Specify engineering units. For example, rpm, gallon, fps, and degrees.
243
Chapter 15
Trend guidelines
Examples
Chapter 15
END_PEN
PEN Local:1:I.CHB_Status (Color := 16#0000_ff00,
Visible := 1,
Width := 1,
Type := Analog,
Style := 0,
Marker := 0,
Min := 0.0,
Max := 100.0)
END_PEN
END_TREND
245
Chapter 16
Introduction
This chapter explains the overall structure of the watch list component.
The quick watch list component defines a collection of tags that you need to
monitor on the fly or for a period of time. A quick watch list is optional. You can
have multiple watch lists; each watch list can have multiple tags.
L5K Item
Description
QuickWatchLists
N/A
QuickWatchList
QUICK_WATCH
WatchTag
WATCH_TAG
Description
Name
247
Chapter 16
Description
Specifier
Scope
Specify the name of program, equipment phase, or Add-On Instruction that contains the watch tag.
For L5X, the value is empty if the tag is controller scope.
For L5K, the attribute is omitted if the tag is controller scope.
Examples
WATCH_TAG
WATCH_TAG
WATCH_TAG
WATCH_TAG
MyProgram);
END_QUICK_WATCH
(Specifier
(Specifier
(Specifier
(Specifier
:=
:=
:=
:=
Chapter 16
MyDint);
MySint, Scope := My_Program);
MyAOI, Scope := My_Program);
MyAOI.MyString, Scope :=
249
Chapter 17
Introduction
Controller objects
Object elements
L5X Item
L5K Item
Description
N/A
object_name
Controller objects are optional. There can be only one of each controller object in
an import/export file. Controller objects appear at the end of the import/export
file.
251
Chapter 17
Config attributes
The attributes depend on the type on the object. Some objects do not have any
attributes.
Object
Attribute
Description
ASCII
XONXOFFEnable
Specify whether to regulate the flow of incoming data. Type 0 to disable XON/XOFF; type
1 to enable XON/XOFF.
DeleteMode
Specify the delete mode. Type 0 for Ignore; type 1 for CRT; or type 2 for Printer.
EchoMode
Specify whether to echo data back to the device from which it was sent. Type 0 to
disable; type 1 to enable.
TerminationChars
AppendChars
BufferSize
Specify the maximum size of the data array (1...65535 bytes) to send and receive.
CST
SystemTimeMasterIDn (L5K)
MasterID (L5X)
Specify whether the controller is the coordinated system time master. Type 16#0000 if
the controller is not the CST master; type 16#0001 if the controller is the CST master.
DF1
DuplicateDetection
ErrorDetection
Specify the error detection method. Type BCC Error or CRC Error.
EnbeddedResponseEnable
DF1Mode
ACKTimeout
NAKReceiveLimit
Specify the number of NAKS (0...127) the controller can receive in response to a message
before stopping transmission.
ENQTransmit
Specify the number of inquiries (0...127) the controller sends after an ACK timeout.
TransmitRetries
StationAddress
ReplyMessageWait
Specify the time the master waits after receiving an acknowledgment to a masterinitiated message before polling the slave for a response. Type an increment of 20 ms
(0...65535).
PollingMode
252
MasterMessageTransmit
Specify when the master transmits. Type 0 to transmit between station polls; type 1 to
transmit in poll sequence.
NormalPollNodeFile
Specify the tag name of the structure that contains the normal poll node list, or type
<NA>. The tag must specify Class = Standard.
NormalPollGroupSize
Specify the total number (0...255) of active stations polled from the poll list.
PriorityPollNodeFile
Specify the tag name of the structure that contains the priority poll node list, or type
<NA>. The tag must specify Class = Standard.
Chapter 17
Object
Attribute
Description
DF1
ActiveStationFile
Specify the tag name of the structure that contains the status (active or non-active) of
each node, or type <NA>. The tag must specify Class = Standard.
SlavePollTimeout
Specify the amount of time the master waits for an acknowledgment to a message sent
to a slave. Type an increment of 20 ms (0...65535).
EOTSuppression
MaxStationAddress
TokenHoldFactor
EnableStoreFwd
For DF1 radio modem, specify whether to enable the store and forward feature. Type 0 to
disable; type 1 to enable.
StoreFwdFile
Specify the INT tag that holds the store and forward table.
BaudRate
Specify the communication rate for the serial port. Type 110, 300 600, 1200, 2400,
4800, 9600, 19200, or 38400.
Parity
Specify the parity setting for the serial port. Parity provides additional message-packet
error detection. Type None Parity, Even Parity, or Odd Parity.
DataBits
Specify the number of bits per message packet. Type 7 Data Bits or 8 Data Bits.
StopBits
Specify the number of stop bits to the device with which the controller is communicating.
Type 1 Stop Bit or 2 Stop Bit.
ComDriverId
PendingComDriverId
RTSOffDelay
Specify a time delay to make sure the modem successfully transmits the entire message.
Type an increment of 20 ms (0...32767). Normally leave at zero.
RTSSendDelay
Specify a time delay to let the modem prepare to transmit a message. Type an increment
of 20 ms (0...32767).
ControlLine
Specify the mode in which the serial driver operates. Type No Handshake, Full Duplex,
Half Duplex without Continuous Carrier, or Half Duplex with Continuous
Carrier.
PendingControlLine
L5K only. Specify the mode in which the serial driver operates. Type No Handshake,
Full Duplex, Half Duplex without Continuous Carrier, or Half Duplex with
Continuous Carrier.
RemoteModeChangeFlag
PendingRemoteModeChangeFlag
ModeChangeAttentionChar
PendingModeChangeAttentionChar
SystemModeCharacter
PendingSystemModeCharacter
SerialPort
SerialPort
UserModeCharacter
PendingSystemModeCharacter
DCDWaitDelay
For DF1 radio modem, specify the delay in seconds (0...255). Specify this value if
ControlLine is Half-Duplex and ContinuousCarrier is disabled.
WallClockTime
LocalTimeAdjustment
TimeZone
253
Chapter 17
Object
Attribute
Description
Internet Protocol
ConfigType
Ethernet Port
IPAddress
SubnetMask
Gateway
PrimaryDNS
SecondaryDNS
DomainName
HostName
Port
PortEnabled
AutoNegotiateEnabled
InterfaceSpeed
DuplexMode
Ethernet Network
SupervisorModeEnabled
SupervisorPrecedence
BeaconInterval
BeaconTimeout
VLANID
254
Examples
Chapter 17
255
Chapter 17
RemoteModeChangeFlag := 0,
ModeChangeAttentionChar := 27,
SystemModeCharacter := 83,
UserModeCharacter := 85)
END_CONFIG
256
Chapter 18
Introduction
257
Chapter 18
</Provider>
</CustomProperties>
(the rest of the ParentObjects child elements)
</ParentXmlObject >
Description
CustomProperties
Provider
Unique element that wraps the users custom property XML. The XML between this
beginning and end element must be well-formed.
Example
Attribute
Description
ID
The provider attribute which identifies the owner of this custom property data. This is a free-form
string. It could identify your company, or it might come from a third party (OEM) component or tool
that you are using.
Ext
(Optional) This extension attribute flags custom property data when you need to break it into
multiple Provider sections. This is a free-form string. An attribute with an empty string is the same
as not having the attribute.
258
Chapter 19
Introduction
This chapter explains how to structure the import/export file by using commas (in
a CSV text file) or tabs (in a TXT Unicode text file) to separate values in the file.
The structured import/export file contains these components for comments and
other information.
Item
Identifies
Remark
TAG
Tag.
RCOMMENT
Rung comment.
TEXTBOX
Each tag record defines a tag within a controller project. A tag record includes this
information.
Item
Identifies
Type
Scope
Name
Description
259
Chapter 19
Item
Identifies
Datatype
Specifier
Optional
An alias, specifies base tag.
A tag comment, specifies the tag name and member or bit.
Attributes
"Description"
260
To specify:
Type:
1 dimension
[a]
2 dimensions
[a,b]
3 dimensions
[a,b,c]
"Datatype"
"Specifier"
Chapter 19
"Datatype"
261
Chapter 19
Each comment record defines a rung comment or text box in the controller
project. This is different than the comment type that defines a comment about a
tag component. A comment record includes this information.
Item
Identifies
Type
Scope
Routine
Comment
Owning Element
For RCOMMENT entries, neutral text for the last instruction on the rung that owns the comment.
If there is no element on the rung, the Owning Element is a semi-colon (;).
By default, the Owning Element is used to match the comment to a rung on import.
For a TEXTBOX entry of an attached text box, neutral text identifies the element attached to the the text box. The
Owning Element contains the backing tag name and the full specifier of the element, including the absolute location
of the element.
Owning Element.
For a TEXTBOX entry of a free-floating text box, this entry is blank.
Location
For RCOMMENT entries, the rung number of comment. The rung number in the Location column is used to match the
comment to a rung if the Owning Element is blank for that comment or if you override the import default by selecting
Match all RLL rung comments by rung number only.
For TEXTBOX entries, the absolute location of free-floating text boxes or the relative location from the owning element
of attached text boxes. For absolute locations, the location contains both the sheet number and the X and Y
coordinates of the text box. For relative locations, the location contains only the X and Y coordinates.
RCOMMENT
"Location"
"Scope"
"Routine"
"Comment"
"Owning
Chapter 19
TEXTBOX
"Location"
"Scope"
"Routine"
"Comment"
"Owning
An alarm tag can have several alarm message strings for different alarm conditions
in different languages. An alarm message record includes this information.
Item
Identifies
Type
Scope
Name
Description
Datatype
263
Chapter 19
Item
Identifies
Specifier
ALMMSG:language
"Specifier"
"Scope"
"Name"
264
"Description"
Examples
Chapter 19
265
Chapter 19
266
Chapter 19
These examples use the Motor_Starter_Program program file and exports the
program parameters and local tags.
267
Chapter 19
268
Appendix A
Introduction
Important:
This appendix describes how using Windows or Excel to edit a .CSV file can affect
the file.
To edit the .CSV file, it is recommended that you use a database program tool, such as Access, or a raw text editor. Many other desktop tools, such as Windows
or Excel, might change the structure of the .CSV file and cause an import of the file to fail.
Recommendations
"
$Q
newline
$N$L
tab
$T
$$
269
Appendix A
When you open the exported .CSV file in Excel, Excel makes these conversions.
Content After
Opening in Excel
.0
".0"
=2
"=2"
If you enter this as an entire comment, you lose any preceding equal sign
(=). If you enter any text before or after this, Excel maintains the content.
+2
"+2"
If you enter this as an entire comment, you lose any preceding plus sign (+).
If you enter any text before or after this, Excel maintains the content.
002
"002"
If you enter this as an entire comment, you lose any preceding zeros. If you
enter any text before or after this, Excel maintains the content.
test string
"test string"
test string
test string
Excel puts quotes around cell contents only if there is an embedded comma.
Logix Designer always places double quotes around text. But Logix Designer
still can handle the description without quotes.
"test string"
"$"test string$""
$test string$""
"$test string$"""""
Excel and Logix Designer alter content when it includes a dollar sign ($).
Excel and Logix Designer alter content when it includes a dollar sign ($).
+text
"+text"
?
#NAME
?
#NAME
-text
"-text"
?
#NAME
?
#NAME
=text
"=text"
?
#NAME
?
#NAME
270
Appendix B
Introduction
28.xx
2.19
27.xx
2.18
26.xx
2.17
24.XX
2.15
23.xx
2.14
21.xx
2.12
20.xx
2.11
19.xx
2.10
18.xx
2.9
17.xx
2.8
16.xx
2.7
15.xx
2.6
13.xx
2.4
12.xx
2.3
11.xx
2.2
10.xx
2.1
9.00
2.0
5.02
1.2
1.1
1.23, 1.21
1.0
1.11, 1.10
0.4
271
Appendix B
Backward compatibility
Important:
Use caution when copying and pasting components between different versions of the application. The Logix Designer only supports pasting to the same version
or newer version of the application. Pasting to a prior version of RSLogix 5000 software is not supported. When pasting to a prior version, the paste action may
succeed, but the results may not be what you expect.
272
Version 2.19 of the Import/Export feature that is included with the Logix
Designer application, version 28, includes these major enhancements:
Version 2.18 of the Import/Export feature that is included with the Logix
Designer application, version 27, includes these major enhancements:
Appendix B
Version 2.17, major revision 2, minor revision 17, of the Import/Export feature
that is included with the Logix Designer application, does not include any major
enhancements.
Version 2.15, major revision 2, minor revision 15, of the Import/Export feature
that is included with the Logix Designer application, version 24 includes these
major enhancements:
There were no feature changes for the Import/Export feature for version 2.14,
major revision 2, minor revision 14, included with the Logix Designer application,
version 23.
Version 2.12, major revision 2, minor revision 12, of the Import/Export feature
included with Logix Designer application, version 21 includes these major
enhancements:
273
Appendix B
Version 2.11, major revision 2, minor revision 11, of the import/export feature
included with Logix Designer, version 20 includes these major enhancements:
ConfigScript sub section added to the L5K and L5X formats of the module
component.
Version 2.10 (major revision 2, minor revision 10) of the import/export feature
included with Logix Designer, version 19 includes these major enhancements:
274
Appendix B
275
Appendix B
The L5X format for rung export has been modified such that rung UIDs are
no longer included in the export format.
Add-On Instructions.
Alarms
276
New instructions
Additional attributes and valid values for existing attributes to AXIS tags.
Appendix B
New export TXT format for rungs and logic comments that uses tabs to
separate values. This format is similar to the CSV format that uses commas
to separate values.
The CSV and TXT formats also include text box comments from function
block and sequential function chart logic.
Equipment Phase program type and its relay ladder and structured text
instructions.
New SERCOS IDN Read and SERCOS IDN Write message types.
277
Appendix B
278
Online editing support for structured text and sequential function chart
logic.
New L5X format for partial import/export of ladder rungs, tags, and trends.
New EVENT, IOT, MCCD, MCCM, MCLM, MCS, MCSD, and MCSR
instructions in ladder logic and structured text.
Appendix B
Addition of EOT, SFR, and SFP instructions to relay ladder and structured
text.
Beginning with version 2.2, multi-line rung comments with hard returns are no
longer exported as one long string in double-quotes. Instead, each line of a multiline rung comment is on a separate line in the .L5K file with double-quotes around
each line. When imported, the multiple quoted strings are concatenated to form
the rung comment. This improves the readability of the .L5K text file by using the
existing multiple-string capability of the rung comment syntax. Older formats still
work on import.
Enhancements to the Message tag structure. See page 264 on page 279.
279
Appendix B
significant changes to the MESSAGE tag. For reference, this table shows the
MESSAGE tag structure of the previous import/export release.
MESSAGE Tag Structure (Version 2.0)
280
Attribute
Description
Description
Comment
MessageType
Type Block Transfer Read, Block Transfer Write, CIP Data Table Read, CIP Data Table Write, CIP Generic,
PLC2 Unprotected Read, PLC2 Unprotected Write, PLC3 Typed Read, PLC3 Typed Write, PLC3 Word Range
Read, PLC3 Word Range Write, PLC5 Typed Read, PLC5 Typed Write, PLC5 Word Range Read, PLC5 Word
Range Write, SLC Typed Read, or SLC Typed Write.
Specify MessageType := text
RequestedLength
ConnectionPath
DF1DHFlag
If the communication method uses DH+, type 1. If the communication method does not use DH+, type 0.
Specify DF1DHFlag := value
LocalTag
RemoteElement
DHPlusSourceLink
If the communication method uses DH+, specify the source link (0...65,535).
Specify DHPlusSourceLink := value
DHPlusDestinationLink
If the communication method uses DH+, specify the destination link (0...65,535).
Specify DHPlusDestinationLink := value
DHPlusDestinationNode
If the communication method uses DH+, specify the destination node number (0...63 octal).
Specify DHPlusDestinationNode := value
DHPlusChannel
If the communication method uses DH+, specify the DH+ channel. Type A or B.
Specify DHPlusChannel := letter
CacheConnections
If the message is to cache connections, type TRUE. If the message is not to cache connections, type FALSE.
Specify CacheConnections := text
ServiceCode
If the message type is CIP Generic, specify the service code (0...255 hexadecimal).
Specify ServiceCode := #16value
ObjectType
If the message type is CIP Generic, specify the object type (0...65,535 hexadecimal).
Specify ObjectType := 16#value
TargetObject
If the message type is CIP Generic, specify the target object (0...65,535 decimal).
Specify TargetObject := value
Attribute
Description
AttributeNumber
If the message type is CIP Generic, specify the attribute number (0...65,535 hexadecimal).
Specify AttributeNumber := 16#value
DestinationTag
Important:
Appendix B
For any attribute that you can specify a not applicable state, type <NA>,
rather than NA.
It Converts to:
Unused
AXIS_SERVO
Position only
AXIS_SERVO
281
Appendix B
It Converts to:
Servo
AXIS_SERVO
Consumed
AXIS_CONSUMED
Virtual
AXIS_VIRTUAL
Description
Description
Comment
GroupType
CoarseUpdateMultiplier
ServoUpdatePeriod
PhaseShift
GeneralFaultType
Specify whether an error generates a major fault or a non-major fault. Type Major Fault or Non Major Fault.
Specify GeneralFaultType := text
Description
Description
282
Attribute
Description
Comment
MotionGroup
MotionModule
AxisState
Type Axis-Ready, Direct Drive Control, Servo Control, Axis Faulted, or Axis Shutdown.
Specify AxisState := text
PositionUnits
TimeUnits
InstructionSpeedUnits
InstructionAccelDecelUnits
InstructionMoveProfile
InstructionJogProfile
ConversionConstant
HomeMode
HomeSequenceType
Type Immediate Home, Home To Switch, Home To Marker Only, or Home To Switch With Marker.
Specify HomeSequenceType := text
HomePosition
HomeSpeed
HomeReturnSpeed
MaximumSpeed
MaximumAcceleration
MaximumDeceleration
ProgrammedStopMode
Appendix B
283
Appendix B
Attribute
Description
AverageVelocityTimebase
ServoStatusUpdateBits
MotionConfigurationBits
AxisType
PositionUnwind
MaximumPositiveTravel
MaximumNegativeTravel
PositionErrorTolerance
PositionLockTolerance
PositionProportionalGain
PositionIntegralGain
VelocityFeedforwardGain
AcclerationFeedforwardGain
VelocityProportionalGain
VelocityIntegralGain
OutputFilterBandwidth
OutputScaling
OutputLimit
OutputOffset
FrictionCompensation
SoftOvertravelFaultAction
PositionErrorFaultAction
284
Attribute
Description
EncoderLossFaultAction
EncoderNoiseFaultAction
DriveFaultAction
ServoConfigurationBits
MotorEncoderTestIncrement
TuningTravelLimit
TuningSpeed
DampingFactor
PositionServoBandwidth
TuningConfigurationBits
Appendix B
ASCII instructions.
285
Index
A
action
attributes 197
L5K structure 196
L5X structure 196
Add-On Instruction
attributes 174
attributes in FBD 174
component 85
encoded data 96
guidelines 98
in a function block diagram routine 173
in FBD guidelines 98
L5K example 98
L5K source-protected example 98
L5K structure 86
L5K structure in FBD 174
L5X example 98
L5X source-protected example 97
L5X structure 85
L5X structure in FBD 173
local tag 94, 95
local tag attributes 95
parameter 89, 93
parameter attributes 92, 93
routines 87
source-protection 96
tag values 132
alarm analog tag
attributes 112
L5K example 134
L5K structure 111
L5X example 134
L5X structure 111
alarm digital tag
attributes 114
L5K example 134
L5K structure 114
L5X example 134
L5X structure 114
AlarmConfig
L5X structure 116
ALMMSG
record 267
287
Index
ret 177
rung 155
safety controller 54, 79
safety module 76
safety tag 131
sbr 176
sbrret 199
sequential function chart routine 190
sheet 168
step 194
stop 200
structured text routine 214
tag 109
task 236
text box 179
transition 198
trend 244
watch tag 252
wire 178
axis tag
L5K structure 119
L5X structure 119
B
backward compatibility 276
block
attributes 172
guidelines 173
L5K structure 172
L5X structure 172
boolean values
L5X format 39
branch
attributes 201
L5K structure 156
L5X structure 155
C
child programs
attributes 146
components 145
guidelines 146
L5K example 148
L5K structure 145
288
Index
attributes 52
guidelines 55
L5K example 55
L5K safety example 55
L5K structure 50
L5X example 55
L5X safety example 55
L5X structure 49
safety attributes 54
controller config objects 255
attributes 256
L5K examples 256
L5X examples 256
coordinate system tag
attributes 127
L5K structure 127
L5X structure 127
CSV
ALMMSG 267
comment record 265
exporting 26
importing 28
TAG 263
CSV format 263, 273
examples 267
D
data formats
L5X format 39
datatype
attributes 66
bit members 68
component 65
guidelines 69
L5K example 69
L5K structure 65
L5X example 69
L5X structure 65
member attributes 67
members 66, 67
datatype member
attributes 67
bit members 68
L5K structure 67
L5X structure 66
descriptions
L5K format 46
L5X format 46
directed link
attributes 202
guidelines 202
L5K structure 201
L5X structure 201
display style
L5K format 47
L5X format 39
E
encoded data
L5K example 98, 147
L5K structure 96
L5X example 97, 148
L5X structure 96
equipment phase
attributes 143
L5K example 148
L5X example 148
examples
CSV files 267
L5K ADD_ON_INSTRUCTION_DEFINITION 98
L5K ALARM_ANALOG tag 134
L5K ALARM_DIGITAL tag 134
L5K CHILD_PROGRAMS 148
L5K CONFIG 256
L5K CONTROLLER 55
L5K DATATYPE 69
L5K ENCODED_DATA 98, 147
L5K equipment phase PROGRAM 148
L5K FBD_ROUTINE 180
L5K LOGIC 169, 191, 215
L5K MODULE 79
L5K PROGRAM 148
L5K QUICK_WATCH_LIST 252
L5K ROUTINE 156
L5K safety CONTROLLER 55
L5K safety partner MODULE 79
L5K safety TAG 134
L5K safety TASK 237
L5K SFC_ROUTINE 180
L5K source-protected Add-On Instruction 98
Rockwell Automation Publication 1756-RM084U-EN-P - November 2015
289
Index
F
format
CSV 263
TXT Unicode 263
function block diagram
instructions 183
neutral text 183
function block diagram routine
Add-On Instruction attributes 174
attachment attributes 179
attributes 166
component 165
FBDContent 169
jsr attributes 175
L5K example 169, 180
L5K online edits example 169
L5K sheet structure 167
L5K structure 165
L5X example 169, 180
L5X online edits example 169
L5X sheet structure 166
L5X structure 165
LOGIC 169
online edits 169
ret attributes 177
sbr attributes 176
sheet attributes 168
sheet guidelines 168
text box attributes 179
wire attributes 178
function block routine
block attributes 172
icon attributes 171
iref attributes 170
ocon attributes 171
oref attributes 170
G
guidelines
Add-On Instruction 98
Add-On Instruction in FBD 98
attachment 180
block 173
child programs 146
Index
controller 55
datatype 69
directed link 202
icon 172
iref 171
jsr 175
module 79
ocon 172
oref 171
parameter connections 240
program 148
ret 177
rung 155
sbr 176
sheet 168
tag 134
task 237
text box 203
trend 248
wire 178
H
history, import/export feature 275
I
icon
attributes 171
guidelines 172
L5K structure 171
L5X structure 171
importing
comments 28
complete project 22, 25
CSV format 28
L5K format 22
L5X format 25
project 22, 25
tags 28
text boxes 28
TXT format 28
initial values 132
Add-On Instruction 132
L5K structure 132
L5X structure 132
instructions
function block diagram 183
ladder logic 157
structured text 217
internal file comments 46
iref
attributes 170
guidelines 171
L5K structure 170
L5X structure 170
J
jsr
attributes 175
guidelines 175
L5K structure 175
L5X structure 175
L
L5K
exporting 21
file conventions 45
file structure 44
importing 22
internal file comments 46
L5K structure
action 196
Add-On Instruction 86
Add-On Instruction in FBD 174
alarm analog tag 111
alarm digital tag 114
analog alarm message 116
attachment 179
axis tag 119
block 172
branch 156
child programs 145
condition 199
config objects 255
controller 50
coordinate system tag 127
datatype 65
datatype member 67
directed link 201
Rockwell Automation Publication 1756-RM084U-EN-P - November 2015
291
Index
encoded data 96
function block diagram routine 165
icon 171
iref 170
jsr 175
ladder logic routine 153
limithigh 195
limitlow 195
local tag 95
message tag 117
module 71
module connection 76
motion group tag 129
ocon 171
oref 170
parameter 89, 93
parameter connections 239
pen 247
preset 195
program 142
quick watch list 251
ret 176
rung 154
rung branch 156
safety tag 131
sbr 176
sbrret 199
sequential function chart routine 190
sheet 167
source-protected Add-On Instruction 96
source-protected routine 96
step 193
stop 200
structured text routine 213
tag 106
tag initial values 132
task 235
text box 178
transition 197
trend 243
wire 177
L5X
boolean attribute values 39
data formats 39
exporting 24
file conventions 38
292
file structure 35
importing 25
internal file comments 46
L5X structure
action 196
Add-On Instruction 85
Add-On Instruction in FBD 173
alarm analog tag 111
alarm digital tag 114
AlarmConfig 116
attachment 179
axis tag 119
block 172
branch 155
child programs 146
condition 198
config objects 255
controller 49
coordinate system tag 127
datatype 65
datatype member 66
directed link 201
encoded data 96
function block diagram routine 165
icon 171
iref 170
jsr 175
ladder logic routine 153
limithigh 195
limitlow 196
local tag 94
message tag 117
module 71
module connection 76
motion group tag 129
ocon 171
oref 170
parameter 89, 93
parameter connections 239
pen 247
preset 195
program 141
quick watch list 251
ret 176
rung 154
rung branch 155
Index
M
message tag
attributes 118
L5K structure 117
L5X structure 117
Microsoft Excel 273
module
attributes 72
component 71
guidelines 79
L5K example 79
L5K safety partner example 79
L5K structure 71
L5X example 79
L5X safety example 79
L5X structure 71
safety attributes 76
module connection
attributes 78
L5K structure 76
L5X structure 76
safety attributes 79
motion group tag
attributes 129
L5K structure 129
L5X structure 129
N
neutral text
function block diagram 183
ladder logic 157
structured text 217
O
objects 255
ocon
attributes 171
guidelines 172
L5K structure 171
L5X structure 171
online edits 169, 191, 215
oref
attributes 170
293
Index
guidelines 171
L5K structure 170
L5X structure 170
P
parameter
attributes 92, 93
L5K structure 89, 93
L5X structure 89, 93
parameter connections
attributes 239
components 239
guidelines 240
L5K example 240
L5K structure 239
L5X example 240
L5X structure 239
pen
attributes 248
L5K structure 247
L5X structure 247
preset
L5K structure 195
L5X structure 195
produced tag
attributes 110
program
attributes 143
component 141
equipment phase attributes 143
guidelines 148
L5K equipment phase example 148
L5K example 148
L5K structure 142
L5X equipment phase example 148
L5X example 148
L5X structure 141
routine encoded data 96
source-protected routine 96
projects 21, 22, 24, 25
Q
quick watch list
attributes 251
294
component 251
L5K example 252
L5K structure 251
L5X example 252
L5X structure 251
watch tag attributes 252
R
RCOMMENT 263
record 265
Remark 263
ret
attributes 177
guidelines 177
L5K structure 176
L5X structure 176
routine
component 153, 165, 189, 213
encoded data 96
in Add-On Instruction 87
L5K example 156, 180
L5K source-protected example 147
L5X example 156, 180, 215
L5X source-protected example 148
source-protection 96
rung
attributes 155
guidelines 155
L5K structure 154
L5X structure 154
rung branch
L5K structure 156
L5X structure 155
S
safety controller
attributes 54, 79
L5K example 55
L5K module example 79
L5K safety example 237
L5K tag example 134
L5X example 55
L5X module example 79
L5X tag example 134
Rockwell Automation Publication 1756-RM084U-EN-P - November 2015
Index
module attributes 76
safety partner module
L5K example 79
L5X example 79
safety tag
attributes 131
L5K example 134
L5K structure 131
L5X example 134
L5X structure 130
sbr
attributes 176
guidelines 176
L5K structure 176
L5X structure 176
sbrret
attributes 199
L5K structure 199
L5X structure 199
sequential function block routine
L5K example 191
L5K online edits example 191
sequential function chart
attachment attributes 179
attachment guidelines 180
directed link guidelines 202
text box attributes 179
text box guidelines 203
sequential function chart routine
action attributes 197
attributes 190
branch attributes 201
component 189
directed link attributes 202
L5K action structure 196
L5K attachment structure 179
L5K branch structure 156
L5K condition structure 199
L5K directed link structure 201
L5K example 180
L5K limithigh structure 195
L5K limitlow structure 195
L5K preset structure 195
L5K sbrret structure 199
L5K step structure 193
L5K stop structure 200
295
Index
T
tag 263
alarm analog attributes 112
alarm digital attributes 114
attributes 109
component 105
consumed attributes 110
coordinate system attributes 127
guidelines 134
initial values 132
L5K alarm analog example 134
L5K alarm analog structure 111
L5K alarm digital example 134
L5K alarm digital structure 114
L5K axis structure 119
L5K coordinate system structure 127
L5K example 134
L5K initial values structure 132
L5K message structure 117
L5K motion group structure 129
L5K safety example 134
L5K safety structure 131
L5K structure 106
L5X alarm analog example 134
L5X alarm analog structure 111
L5X alarm digital example 134
L5X alarm digital structure 114
L5X axis structure 119
L5X coordinate system structure 127
L5X example 134
L5X initial values structure 132
L5X message structure 117
L5X motion group structure 129
L5X safety example 134
L5X safety structure 130
296
Index
examples 267
U
Unicode TXT format 263
W
watch list 251
watch tag 252
wire
attributes 178
guidelines 178
L5K structure 177
L5X structure 177
X
XML file 24
297
Installation assistance
If you experience a problem within the first 24 hours of installation, review the information that is contained in this manual. You can contact
Customer Support for initial help in getting your product up and running.
United States or Canada
1.440.646.3434
Use the Worldwide Locator available at http://www.rockwellautomation.com/locations, or contact your local Rockwell
Automation representative.
Contact your distributor. You must provide a Customer Support case number (call the phone number above to obtain one) to
your distributor to complete the return process.
Please contact your local Rockwell Automation representative for the return procedure.
Documentation feedback
Your comments will help us serve your documentation needs better. If you have any suggestions on how to improve this document, complete the
feedback form, publication RA-DU002.
Copyright 2015 Rockwell Automation, Inc. All rights reserved. Printed in the U.S.A.