Professional Documents
Culture Documents
Import/Export
1756 ControlLogix®, 1756 GuardLogix®, 1769
CompactLogix™, 1769 Compact GuardLogix®, 1789
SoftLogix™, 5069 CompactLogix™, 5069 Compact
GuardLogix®, Studio 5000® Logix Emulate™
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.
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).
Rockwell Automation recognizes that some of the terms that are currently used in our industry and in this publication are not in
alignment with the movement toward inclusive language in technology. We are proactively collaborating with industry peers to
find alternatives to such terms and making changes to our products and content. Please excuse the use of such terms in our
content while we implement these changes.
Global changes
This table identifies changes that apply to all information about a subject in
the manual and the reason for the change. For example, the addition of new
supported hardware, a software design change, or additional reference
material would result in changes to all of the topics that deal with that subject.
Change Topic
New Studio 5000 Logix Designer® application branding Studio 5000® environment on page 17
Chapter 1
Import and export files Introduction ............................................................................................... 21
Export a project to an .L5K text file .......................................................... 21
Import an .L5K text file ............................................................................. 22
Export a Project to an .L5X XML File ....................................................... 24
Import an .L5X XML File .......................................................................... 25
Export to a .CSV or .TXT file..................................................................... 26
Import a .CSV or .TXT file ........................................................................ 28
Export source-protected logic .................................................................. 30
Export in a Cleartext Format............................................................... 31
Maintaining controller access ................................................................... 33
.L5X file structure .......................................................................................34
.L5X file conventions ..................................................................................36
Internal file comments ........................................................................36
Component Descriptions ....................................................................36
Boolean attribute values ...................................................................... 37
Data display style.................................................................................. 37
Data formats ......................................................................................... 37
.L5K file structure ...................................................................................... 42
.L5K file conventions ..................................................................................43
Internal file comments ........................................................................43
Component descriptions .................................................................... 44
Display style ......................................................................................... 44
Project documentation ............................................................................. 44
Chapter 2
Define a controller component Introduction ............................................................................................... 47
Controller component ............................................................................... 47
L5X controller structure ......................................................................47
L5K CONTROLLER structure ............................................................. 48
Controller elements ............................................................................ 49
Controller attributes ........................................................................... 49
Controller attributes in a safety controller system ................................. 52
Controller guidelines ................................................................................ 52
Examples ..................................................................................................... 53
Chapter 3
Define a Datatype component Introduction ............................................................................................... 61
Datatype component ................................................................................. 61
L5X datatype structure ........................................................................ 61
L5K datatype structure......................................................................... 61
Datatype elements ............................................................................... 61
Datatype attributes ............................................................................. 62
Datatype member ...................................................................................... 62
L5X datatype member structure ........................................................ 62
L5K datatype member structure ........................................................ 62
Datatype member elements ................................................................63
Datatype member attributes ...............................................................63
Bit members .........................................................................................63
Datatype guidelines....................................................................................65
Examples .................................................................................................... 66
Chapter 4
Define a module component Introduction ............................................................................................... 67
Module component .................................................................................... 67
L5X module structure ..........................................................................67
L5K MODULE structure.......................................................................67
Module elements ................................................................................. 68
Module attributes ................................................................................ 68
Module attributes in a safety controller system....................................... 71
Module connection..................................................................................... 71
L5X connection structure .................................................................... 71
L5K CONNECTION structure ............................................................ 72
Connection elements .......................................................................... 72
Module connection attributes ............................................................. 73
Module connection attributes in a safety controller system ............74
Module guidelines ......................................................................................74
Examples ..................................................................................................... 75
Chapter 5
Define an Add-On Instruction Introduction ............................................................................................... 81
component Add-On Instruction component ............................................................... 81
L5X AddOnInstructionDefinition Structure ..................................... 81
L5K ADD_ON_INSTRUCTION_DEFINITION structure................. 82
Add-On Instruction elements ............................................................ 82
Add-On Instruction attributes ........................................................... 82
Routines in Add-On Instructions ...................................................... 83
Parameters ................................................................................................. 84
Chapter 6
Define a tag component Introduction ............................................................................................... 99
Tag component .......................................................................................... 99
L5X tag structure ................................................................................. 99
L5K TAG structure ............................................................................. 100
Tag elements ...................................................................................... 100
Tag attributes .....................................................................................102
Produced tag attributes .....................................................................104
Consumed tag attributes ...................................................................104
ALARM_ANALOG tag ............................................................................... 105
L5X tag structure for ALARM_ANALOG tag .................................... 105
L5K tag structure for ALARM_ANALOG tag .................................... 105
Chapter 7
Define a tag-based alarm or Introduction .............................................................................................. 135
alarm definition Tag-based alarms ...................................................................................... 135
L5X Tag-based alarm structure .......................................................... 135
L5K Tag-based alarm structure ......................................................... 136
Tag-based alarm objects .................................................................... 139
Tag-based alarm definitions.................................................................... 142
L5X Tag-based alarm definition structure ....................................... 142
L5K Tag-based alarm definition structure ....................................... 143
Tag-based alarm definition objects .................................................. 144
Chapter 8
Define a program component Introduction ..............................................................................................147
Program component .................................................................................147
L5X program structure ...................................................................... 147
L5K PROGRAM structure .................................................................. 147
Program elements .............................................................................. 148
Program attributes............................................................................. 148
Program attributes for EquipmentPhase programs ....................... 149
Program attributes for Sequence programs .................................... 150
Child program component ...................................................................... 150
L5K CHILD_PROGRAM structure .................................................... 150
L5X child program structure ............................................................. 150
Child program attributes ................................................................... 151
Child program guidelines .................................................................. 151
Encoded/Unencoded routines ................................................................ 151
L5X EncodedData Structure.............................................................. 151
L5K ENCODED_DATA Structure...................................................... 152
Encoded Data Elements .................................................................... 152
Encoded Information elements ........................................................ 152
Encoded key attributes ...................................................................... 152
Encoded content attributes ............................................................... 153
L5K source protected routine example ............................................. 153
L5X source-protected routine examples........................................... 153
Program guidelines .................................................................................. 153
Examples ................................................................................................... 154
Chapter 9
Define a ladder logic routine Introduction .............................................................................................. 157
Ladder logic routine.................................................................................. 157
L5X ladder logic routine structure .................................................... 157
L5K Ladder Logic ROUTINE structure ............................................. 157
Chapter 10
Define a function block Introduction ..............................................................................................167
diagram routine Function BlockDiagram Routine .............................................................167
L5X function block diagram routine structure .................................167
L5K Function Block FBD_ROUTINE structure ................................ 167
Function block routine elements ...................................................... 167
FBD_routine attributes...................................................................... 168
Sheet .......................................................................................................... 168
L5X sheet structure ............................................................................ 168
L5K SHEET structure ......................................................................... 169
Sheet elements ................................................................................... 169
Sheet attributes .................................................................................. 170
Sheet guidelines ................................................................................. 170
Export function block logic while editing online ................................... 170
Input and output references ................................................................... 172
L5X IREFand OREF structure ........................................................... 172
L5K IREF and OREF structure .......................................................... 172
Reference attributes ........................................................................... 172
Reference guidelines .......................................................................... 172
Input and output connectors .................................................................. 172
L5X ICON and OCON structure........................................................ 172
L5K ICON and OCON structure ........................................................ 173
Connector attributes .......................................................................... 173
Connector guidelines ......................................................................... 173
Blocks ........................................................................................................ 173
L5X block structure ............................................................................ 173
L5K BLOCK structure ......................................................................... 173
Chapter 11
Define a sequential function Introduction ............................................................................................. 189
chart routine Sequential function chart routine .......................................................... 189
L5X sequential function chart structure .......................................... 189
L5K sequential function chart SFC_ROUTINE structure ............... 189
Sequential function chart elements .................................................190
SFC_Routine attributes .....................................................................190
Export sequential function chart logic while editing online ................ 191
Steps .......................................................................................................... 192
L5X step structure .............................................................................. 192
L5K STEP structure ............................................................................ 193
Step elements ..................................................................................... 193
Step attributes .................................................................................... 193
Preset ......................................................................................................... 194
L5X preset structure ........................................................................... 194
L5K PRESET structure ....................................................................... 194
Limit high.................................................................................................. 194
L5X limit high structure .................................................................... 194
L5K LIMITHIGH structure ................................................................ 194
Limit low ................................................................................................... 194
L5X limit low structure ...................................................................... 194
L5K LIMITHIGH structure ................................................................ 195
Action list .................................................................................................. 195
L5X Action Structure.......................................................................... 195
L5K ACTION structure ....................................................................... 195
Action attributes................................................................................. 195
Transitions ................................................................................................ 195
L5X transition structure .................................................................... 196
L5K TRANSITION structure .............................................................. 196
Transition elements ........................................................................... 196
Transition attributes .......................................................................... 196
Condition .................................................................................................. 196
L5X condition structure..................................................................... 196
L5K CONDITION structure ............................................................... 196
Subroutine calls ........................................................................................ 197
L5X SbrRet structure.......................................................................... 197
L5K SBR_RET structure ..................................................................... 197
Subroutine attributes ........................................................................ 197
Stops .......................................................................................................... 197
L5X stop structure .............................................................................. 197
Chapter 12
Define a structured text routine Introduction .............................................................................................209
Structured text routine............................................................................209
L5X structured text structure ........................................................... 209
L5K structured text ST_ROUTINE structure .................................. 209
Structured Text routine elements.................................................... 209
ST_Routine attributes........................................................................210
Structured text logic.................................................................................210
Export structured text logic while editing online .................................. 211
Examples ................................................................................................... 211
Structured text.......................................................................................... 213
Chapter 13
Define a task component Introduction ............................................................................................. 221
Task component ....................................................................................... 221
L5K TASK structure ............................................................................ 221
L5X task structure .............................................................................. 221
Task elements ..................................................................................... 221
Chapter 14
Define a parameter Introduction ............................................................................................. 225
connection component Parameter connection component ......................................................... 225
L5K PARAMETER_CONNECTION structure .................................. 225
L5X ParameterConnection structure .............................................. 225
Parameter connection attributes ..................................................... 225
Parameter connection guidelines .......................................................... 225
Examples .................................................................................................. 226
Chapter 15
Define a trend component Introduction ............................................................................................. 229
Trend component .................................................................................... 229
L5X trend structure ........................................................................... 229
L5K TREND structure ....................................................................... 229
Trend elements .................................................................................. 229
Trend attributes ................................................................................ 230
Pen declaration .........................................................................................232
L5X pen structure ...............................................................................232
L5K PEN structure..............................................................................232
Pen elements ...................................................................................... 233
Pen attributes ..................................................................................... 233
Trend guidelines ....................................................................................... 233
Examples ................................................................................................... 233
Chapter 16
Define a watch list component Introduction ............................................................................................. 235
Quick watch list component ................................................................... 235
L5X QuickWatchList structure.......................................................... 235
L5K QUICK_WATCH structure ......................................................... 235
Quick Watch elements ....................................................................... 235
Quick Watch List attributes .............................................................. 235
Watch tag attributes .......................................................................... 235
Examples ...................................................................................................236
Chapter 17
Define controller Introduction ............................................................................................. 237
configuration objects Controller objects ..................................................................................... 237
Chapter 18
Define custom properties Introduction ............................................................................................. 243
Custom properties data ........................................................................... 243
Custom properties structure .............................................................243
Custom properties elements .............................................................244
Custom properties attributes ............................................................244
Example.....................................................................................................244
Chapter 19
Structure Tags and Comments Introduction ............................................................................................. 245
in an Import/Export File Place information in a .CSV or .TXT file ................................................ 245
Internal file comments ...................................................................... 245
Specify a tag record ..................................................................................245
TAG type record ................................................................................. 246
ALIAS type record.............................................................................. 246
COMMENT type record .................................................................... 246
Specify a comment record .......................................................................247
RCOMMENT Structure with Commas.............................................247
RCOMMENT Structure with Tabs ....................................................247
TEXTBOX Structure with Commas................................................. 248
TEXTBOX Structure with Tabs ........................................................ 248
Specify an alarm message record ........................................................... 248
ALMMSG Structure with Commas .................................................. 248
ALMMSG Structure with Tabs ......................................................... 248
Examples .................................................................................................. 249
Appendix A
Considerations for using Introduction ............................................................................................. 253
Microsoft Excel to edit a Recommendations ................................................................................... 253
Logix Designer data transformations .................................................... 253
.CSV file
Microsoft Excel Data Transformation ................................................... 254
Appendix B
Import/Export revision history Introduction ............................................................................................. 255
Backward compatibility........................................................................... 255
Studio 5000 environment The Studio 5000 Automation Engineering & Design Environment® combines
engineering and design elements into a common environment. The first
element is the Studio 5000 Logix Designer® application. The Logix Designer
application is the rebranding of RSLogix 5000® software and will continue to
be the product to program Logix 5000™ controllers for discrete, process,
batch, motion, safety, and drive-based solutions.
Legal Notices Rockwell Automation publishes legal notices, such as privacy policies, license
agreements, trademark disclosures, and other terms and conditions on the
Legal Notices page of the Rockwell Automation website.
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: Then use this format:
The entire controller project L5K or L5X
Individual portions of the controller project L5X
Tags and logic comments CSV or TXT
Export a project to an 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
.L5K text file 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, select File > Save As.
Import an .L5K text file 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.
2. Select the .L5K text file you want to import and select Open.
The Save Imported Project As dialog box opens.
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..
See also
Maintaining Controller Access on page 33
Export a Project to an 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.
.L5X XML File
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, select File > Save As.
Import an .L5X XML File 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.
2. In the File name box, select the .L5X controller file you want to import
and select Open.
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.
See also
Maintaining Controller Access on page 33
Export to a .CSV or .TXT file 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® Excel® or 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.
3. In the File name box, type the name of the file to be exported.
4. From the Save as type list, select.CSV or .TXT format.
The .TXT import/export format supports double-byte characters, so
you can use this format for all languages, including Chinese, Japanese,
and Korean. The .CSV import/export format does not support
double-byte characters.
5. From the Tags and Logic Comments list, set the scope of the tags and
logic comments to be exported.
6. Select Export.
Import a .CSV or .TXT file 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.
2. In the File name box, select the .CSV or .TXT file 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.
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 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.
Keep comments that are in the project and Import New Comments & Preserve Existing Comments
discard colliding comments in the import file,
in addition to adding any new comments from
the import file
Replace comments in the project with Skip New Comments & Overwrite Existing Comments
comments from the import file, but do not add
any new comments from the import file
IMPORTANT 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.
Export source-protected Starting with version 20, you can configure how source-protected content is
exported in .L5K and .L5X files.
logic
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.
Export in a Use the same procedure for partial exporting a component or a full project in
readable text. Use these steps.
Cleartext Format
1. Open a project in the Logix Designer application that contains the
content that you want to export.
2. On the Menu bar, select Tools > Options.
The Workstation Options dialog box opens with the export check box
option if your personal computer is enabled for source protection.
4. Select OK.
5. Take one of these actions:
• To export a component, right-click the component and choose
Export Routine. The component Export dialog box opens. Clear the
Encode Source Protected Content check box. Select the Export
button.
• To save data for exporting as an .L5X or .L5K file, proceed to step 6.
6. On the Menu bar, select File > Save As.
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.
Given this status information, these situations prevent you from going online
with a controller.
Situations When You Cannot Go Online with a Controller Possible Recovery
• More than 1000 controller edits were made. • Full download to the controller
• A download of another project copy with identical creation stamps occurred. • Upload from the controller to a new project
• Changes were made to the offline project, excluding documentation and tag value changes. • Upload from the controller and merge with an existing
• A controller nonvolatile storage load occurred and the loaded image has the same creation stamp project.
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.
.L5X file structure 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> Describes version and export information This chapter, see example below
<Controller> The controller Chapter 2 Defining a Controller Component on page 47
<DataTypes> User-defined and I/O data structures Chapter 3 Defining a Datatype Component on page 61
<Modules> Modules in the controller organizer Chapter 4 Defining a Module Component on page 67
<AddOnInstructionDefinitions> Add-On Instructions Chapter 5 Defining an Add-On Instruction Component on page 81
<Tags> Controller-scope tags Chapter 6 Defining a Tag Component on page 99
<Programs> Programs Chapter 7 Defining a Program Component on page 147
<Routines> Ladder logic, function block diagram, sequential Chapter 8 Defining a Ladder Logic Routine on page 157
function chart, and structured text routines Chapter 9 Defining a Function Block Diagram Routine on page 167
Chapter 10 Defining a Sequential Function Chart Routine on page
189
Chapter 11 Defining a Structured Text Routine on page 209
<Tasks> Controller tasks Chapter 12 Defining a Task Component on page 221
<ParameterConnection> Parameter connections Chapter 13 Defining a Parameter Connection on page 225
<ParameterConnections> Program parameter connections Chapter 14 Defining a Parameter Connection on page 225
<Trends> Any trend configured for the controller project Chapter 15 Defining a Trend Component on page 229
<QuickWatchLists> All quick watch lists configured in the controller Chapter 16 Defining a Watch List Component on page 235
project
<CommPorts>, <CST>, and <WallClockTime> Controller configuration objects Chapter 17 Defining Controller Configuration Objects on page 237
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.
If you use: You see:
A text editor, such as A text file, such as:
Notepad
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.
.L5X file conventions The import/export feature L5X format is structured by using the Extensible
Markup Language (XML). The XML specification is an open standard and is
widely documented elsewhere. The only special convention used to describe
the L5X format in this document is that items shown in square brackets ([ ])
are optional.
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.
Internal file comments Enter internal file comments to document your .L5X import files by using the
XML commenting format. The import process ignores these comments. Place
comments anywhere in an import/export .L5X file except within XML tag
elements. You cannot next a comment within another comment.
An XML comment begins with the character sequence <!-- and ends with the
character sequence -->. The comment appears between the begin and end
character sequence. The character sequence -- may not appear within a
comment. The text of the comment is ignored by the XML parser. This is an
example.
<!-- This is a comment that includes an XML start tag
element, <mytag>. The start tag is ignored by the parser.
-->
Component Descriptions Descriptions of components are optional. Unlike internal file comments,
Boolean attribute values Many boolean attributes in the L5K format may have a value of 1 (enabled) or
0 (disabled). In the L5X format, these same attributes have a value of true
(enabled) or false (disabled). Throughout this manual, a value of true or false
should be specified in the L5X format for any attributes that indicate a value
of 1 or 0.
Data display style Tags and data types support a radix attribute that specifies how to display the
associated numerical information in the Logix Designer application.
Radix Display Option Example (based on 15 decimal)
Binary (uses a 2# prefix) 2#0000_0000_0000_1111
Octal (uses a 8# prefix) 8#000_017
Decimal 15
Hex (uses a 16# prefix) 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">
</Data>
<Data Format="Decorated">
</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 Raw Data Export Format
Atomic Example: an INT tag
<Data>05 00</Data>
Array of an Atomic Data Example: an array of 4 INT tags
Type <Data>02 00 03 00 04 00 05 00</Data>
Structure Data Type Example: a TIMER tag
<Data>00 00 00 00 01 00 00 00 05 00 00 00</Data>
Array of a Structure Data Example: an array of 3 TIMER tags
Type <Data>00 00 00 00 01 00 00 00 05 00 00 00 00 00 00 00 02 00 00 00
07 00 00 00 00 00 00 00 05 00 00 00 09 00 00 00</Data>
L5K Data Format
L5K data format is the same data format that appears in an .L5K file, wrapped
in a CDATA element. It is exported in the same format for all types of data
types. It is indicated by the Format="L5K" attribute in the <Data> start tag
element.
The L5K data format is not exported during a full project or component L5X
format. However, it is imported if present in an .L5X file. This format is
provided to enable customers to leverage the L5K data format as they convert
their auto generation tools from L5K to L5X format.
Data Type L5K Data Export Format
Atomic Example: an INT tag
<Data Format="L5K">
<![CDATA[5 ]]>
</Data>
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.
<Tag Name="aDINTTag" TagType="Produced"
DataType="DINT" Radix="Decimal">
<ProduceInfo ProduceCount="1"
ProgrammaticallySendEventTrigger="false"
UnicastPermitted="false"/>
<Data>03 00 00 00</Data>
<ForceData>00 00 00 00 FF FF FF FF 07 00 00
00
</ForceData>
<Data Format="L5K">
<![CDATA[3 ]]>
</Data>
<ForceData Format="L5K">
<![CDATA[[0,0,0,0,-1,-1,-1,-1,7,0,0,0] ]]>
</ForceData>
<Data Format="Decorated"><DataValue
DataType="DINT" Radix="Decimal" Value="3"
ForceValue="7"/>
</Data>
</Tag>
.L5K file structure 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 Chapter 2 Define a Controller Component on page 47
DATATYPE User-defined and I/O data structures Chapter 3 Define a Datatype Component on page 61
MODULE Modules in the controller organizer Chapter 4 Define a Module Component on page 67
ADD_ON_INSTRUCTION_ Add-On Instructions Chapter 5 Define an Add-On Instruction Component on page 81
DEFINITION
TAG Controller-scope tags Chapter 6 Define a Tag Component on page 99
PROGRAM Program files Chapter 7 Define a Program Component on page 147
ROUTINE Ladder logic routines Chapter 8 Define a Ladder Logic Routine on page 157
FBD_ROUTINE Function block diagram routines Chapter 9 Define a Function Block Diagram Routine on page 167
SFC_ROUTINE Sequential function chart routine Chapter 10 Define a Sequential Function Chart Routine on page 189
ST_ROUTINE Structured text routine Chapter 11 Define a Structured Text Routine on page 209
.L5K file conventions The import/export feature L5K format described in this document is based on
the formats specified by the IEC 1131-3 specification.
Convention Description
< > Items shown in angle brackets are required.
[ ] Items shown in square brackets are optional.
user_value Items in italics indicate user-supplied information.
LITERAL Items in all uppercase indicate a required keyword or symbol
that must be entered as shown.
"[" Items in double quotes are required characters.
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.
Internal file comments Enter comments to document import files. The import process ignores these
comments. Place comments anywhere in an import/export file, except in
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
13,10 (carriage return, line feed) $N or $n
12 (form feed) $P or $p
13 (carriage return) $R or $r
9 (tab) $T or $t
xxxx (4-digit character code that represents a $xxxx
hexadecimal value)
Display style Tags and data types support a radix attribute that specifies how to display the
associated numerical information in the Logix Designer application.
Radix Display Option Example (based on 15 decimal)
Binary (uses a 2# prefix) 2#0000_0000_0000_1111
Octal (uses a 8# prefix) 8#000_017
Decimal 15
Hex (uses a 16# prefix) 16#000F
Ascii ‘$00$0F’
Exponential 1.5000000e+01
Float 15.0
Project documentation Starting with version 17 of the application, you can display project
documentation, such as tag descriptions and rung comments for any
supported localized language. You can store project documentation for
multiple languages in a single project file rather than in language-specific
project files. Define all the localized languages that the project will support
and set the current, default, and optional custom localized language. The
Introduction This chapter explains the overall structure of the controller component.
Controller component The controller component contains the overall structure of a project to be
executed on one controller. It contains the configuration information and
logic that you download to one controller.
<Controller [controller_attributes]>
L5X controller structure <Description>
<![CDATA[ text ]]>
</Description>
<RedundancyInfo [redundancyinfo_attributes]/>
<Security [security_attributes]/>
<PrimaryActionSets>
<PrimaryActionSet
PermissionSet=”PermissionSetName1”
IsPermissionSet=”true”>
<![CDATA[
encoded_cached_permissions ]]>
</PrimaryActionSet>
<PrimaryActionSet
PermissionSet=”PermissionSetName2”
IsPermissionSet=”false”>
<![CDATA[
encoded_cached_permissions ]]>
</PrimaryActionSet>
…
</ PrimaryActionSets >
</Security>
<SafetyInfo [safetyinfo_attributes]>
<SafetyTagMap>
[comma separated safety tag map]
</SafetyTagMap>
</SafetyInfo>
<DataTypes>
[datatype]
</DataTypes>
<Modules>
[module]
</Modules>
<AddOnInstructionDefinitions>
[addoninstructiondefinition]
Controller attributes See the table for controller attributes and descriptions.
Attribute Description
Use L5X only. Specify context or target.
Name L5X only. Specify the name of the controller component.
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.
Rockwell Automation® 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).
EtherNetIPMode The EtherNet/IP™ Mode describes the relationship between the CIP™ EtherNet/IP™ ports
and the physical Ethernet ports. The CIP™ EtherNet/IP™ port can be configured as one of
two modes:
• Dual-IP
• Linear/DLR
Controller attributes in a For safety controllers, specify these attributes for the Controller component,
in addition to those previously described.
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. Type true or false.
SafetyLockPassword Specifies the lock password in the controller. This value is encrypted on export.
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.
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
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
CONFIG ASCII(XONXOFFEnable := 0,
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
END_CONTROLLER
MODULE example_safety_controller:Partner
(Parent := "Local", ParentModPortId := 1,
CatalogNumber := "1756-L7SP", Vendor := 1,
ProductType := 14, ProductCode := 146,
Major := 22, Minor := 1,
PortLabel := "RxBACKPLANE", Slot := 1,
Mode := 2#0000_0000_0000_0000,
CompatibleModule := 0,
KeyMask := 2#0000_0000_0001_1111,
SafetyNetwork := 16#0000_0000_0000_0000)
END_MODULE
TAG
END_TAG
ROUTINE MainRoutine
END_ROUTINE
END_PROGRAM
ROUTINE MainRoutine
END_ROUTINE
END_PROGRAM
PARAMETER_CONNECTION
END_PARAMETER_CONNECTION
CONFIG ASCII(XONXOFFEnable := 0,
DeleteMode := 0, EchoMode := 0,
TerminationChars := 65293,
AppendChars := 2573, BufferSize := 82)
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 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
Introduction This chapter explains the overall structure of the datatype component.
Datatype component Datatype components define the data types used in the logic you export.
<DataTypes>
L5X datatype structure <DataType [DataType_Attributes]>
<Description>
<![CDATA[ text ]]>
</Description>
<EngineeringUnit>
<![CDATA[ engineering_unit_text ]]>
</EngineeringUnit>
<Members>
[member_list]
</Members>
</Datatype
</DataTypes>
Datatype elements See the table for .L5X and .L5K datatype element items and descriptions.
Datatype attributes See the table for datatype attributes and descriptions.
Attribute Description
Name L5X only. Specify the name of the data type.
Datatype member elements This table contains .L5X and .L5K datatype member elements and their
descriptions.
Datatype member See the table for datatype member attributes and descriptions.
attributes
Attribute Description
Name L5X only. Specify the name of the member.
In L5K, the member name is an element of the member statement.
Dimension L5X only. Specify the dimensions of the member. Type 0 if atomic or a non-zero value for an array.
Radix Specify decimal, hex, octal, binary, exponential, float, ASCII, or date/time.
Hidden Specify if the member is a hidden member of the structure. Type 1 or 0 (or true or false for L5X)
Target The name of the hidden host member.
BitNumber The bit position in the host member.
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).
Introduction This chapter explains the overall structure of the module component.
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.
<Modules>
L5X module structure <Module [Module_Attributes]>
<Description>
<![CDATA[ text ]]>
</Description>
<EKey [Ekey_Attributes]/>
<Ports>
<Port [Port_Attributes]
<Bus [Bus_Attributes]/>
</Port>
</Ports>
<Communications [Communications_Attributes]>
<ConfigTag [ConfigTag_Attributes]>
[data]
</ConfigTag>
<ConfigScript [ConfigScript_Attributes]>
[data]
</ConfigScript>
[connections]
</Communications>
<ExtendedProperties
[ExtendedProperties_Attributes]>
[extendedpropertiesdata]
</ExtendedProperties>
</Module>
</Modules>
Module elements
In L5X, the data for the tag is defined with <Data> elements. See Chapter 1 Data
Formats on page 37 for more information.
ExtendedProperties ExtendedProp Additional profile data stored in the controller in an XML format.
connections connection_list Connection characteristics for the module.
(zero or more CONNECTION entries)
Module attributes
Attribute Description
Name L5X only. Specify the name of the module.
For L5X, this attribute is on the <EKey> element if the State attribute has a value of Custom.
ProductType Specify the product type of the module.
For L5X, this attribute is on the <EKey> element if the State attribute has a value of Custom.
ProductCode Specify the product code of the module.
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.
Minor Specify the minor revision number (1...255) of the module.
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 Specify the product type of a non-Allen-Bradley module.
UserDefinedProductCode Specify the product code of a non-Allen-Bradley module.
UserDefinedMajor Specify the major revision number (1...127) of a non-Allen-Bradley module.
UserDefinedMinor Specify the minor revision number (1...255) of a non-Allen-Bradley module.
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 L5K only. Specify the number of slots in the chassis.
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.
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.
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 L5X only. This attribute is on the <Port> element.
Width L5X only. This attribute is on the <Port> element.
Size L5X only. This attribute is on the <Bus> element. For a sizable chassis, specify the chassis size.
Module attributes in a In a safety controller system, the module component for the safety partner
follows the module component for the primary safety controller. All of the
safety controller system 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:
• Parent • PortLabel
• ParentModPortID • Slot
• CatalogNumber (1756-LSP) • CompatibleModule
• Vendor • Key
• ProductType • Mask
• ProductCode • SafetyNetwork
• Major • SafetyEnabled
• Minor • NATActualAddress
• Mode
<Connections>
Module connection <Connection [Connection_Attributes]>
Connection elements See the table for .L5X and .L5K items and descriptions.
In L5X, the data for the input tag is defined with <Data> elements. See Chapter 1
Data Formats on page 37 for more information.
InputTag or InputData InputForceData Forcing information for the input channel.
In L5X, the force data for the input tag is defined with <ForceData> elements. See
Chapter 1 Data Formats on page 37 for more information.
OutputTag or OutputData OutputData Output channel data.
In L5X, the data for the output tag is defined with <Data> elements. See Chapter 1,
Data Formats on page 37 for more information.
OutputTag or OutputData OutputForceData Forcing information for the output channel.
In L5X, the force data for the output tag is defined with <ForceData> elements. See
Chapter 1 Data Formats on page 37 for more information.
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 Do not modify forces in the import/export file. Use the programming software to enter
and enable forces.
Module connection
attributes
Attribute Description
Name L5X only. Specify the name of the connection.
Module connection A module connection in a safety controller system has these attributes, in
addition to the module connection attributes previously described.
attributes in a safety
controller system
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; 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.
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.
Introduction This chapter explains the overall structure of the Add-On Instruction
component.
component IMPORTANT The EditedDate attribute of an Add-On Instruction must be updated if the Add-On
Instruction is modified by editing an .L5K or .L5X file.
When you change an Add-On Instruction by manually editing an .L5X file using a text
editor and you do not change the EditedDate attribute, the application does not
overwrite the Add-On Instruction when you import the file.
<AddOnInstructionDefinitions>
L5X <AddOnInstructionDefinition
AddOnInstructionDefinition [AddOnInstructionDefinition_Attributes]>
<Description>
Structure <![CDATA[ text ]]>
</Description>
<AdditionalHelpText>
<![CDATA[ text ]]>
</AdditionalHelpText>
<SignatureHistory>
[history]
</SignatureHistory>
<Parameters>
[parameter]
</Parameters>
<LocalTags>
[local_tag]
</LocalTags>
<Routines>
[routine]
</Routine>
<ScanModeRoutine>
[routine]
</ScanModeRoutine>
</AddOnInstructionDefintion>
</AddOnInstructionDefinitions>
Add-On Instruction This table contains Add-On Instruction elements nd descriptions for L5X and
L5K items.
elements
L5X Item L5K Item Description
N/A name In L5K, the name of the Add-On Instruction.
For L5X, specify help text for the user help on the Add-On Instruction.
Parameters PARAMETERS Parameters of the Add-On Instruction.
LocalTags LOCAL_TAGS Local tags of the Add-On Instruction.
Routines add_on_instruction_ Logic that comprises the Add-On Instruction. Logic can be relay ladder, function
routines block, or structured text.
ScanModeRoutine SCAN_MODE_ROUTINE Optional element that has the logic for a Prescan routine, Postscan routine, or
EnableInFalse routine.
EncryptionInfo ENCRYPTION_INFO Details of the license based source protection for the lockable object. Only exists for
protected Add-On Instructions exported in plain text.
EncryptedAOIContent N/A Source-protected and locked Add-On Instruction content. Only exists for locked
Add-On Instructions exported in plain text.
Attribute Description
Name L5X only. Specify the name of the Add-On Instruction component.
In L5K, the name is an element of the statement.
Class Specify the class of the Add-On Instruction. This attribute applies only to safety projects. Type Standard or Safety.
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 Provide additional information about the revision (40 characters maximum).
RevisionNote Provide information about the revision (128 characters maximum).
Vendor Specify the name of the vendor (40 characters maximum) of the Add-On Instruction.
IsEncrypted Indicates whether the Add-On Instruction is protected with license-based Source Protection and locked.
TrackingGroups The group of tracked objects to which this item belongs. Components can be marked for tracking to determine whether they have
been changed. Version 30 of the Logix Designer application supports only one tracking group.
Routines in Add-On Enter routines in an Add-On Instruction the same as logic routines. The logic
in a single routine must all be in the same programming language, but each
Instructions
routine can be in a different programming language. Program the routines in
ladder logic (ROUTINE), function block (FBD_ROUTINE), or structured text
(ST_ROUTINE) languages. The Add-On Instruction has predefined routine
names that you must use and cannot change.
Routine Name Description
Logic Defines the logic for the Add-On Instruction.
At the minimum, every Add-On Instruction must have a Logic routine.
Prescan Defines logic to execute during prescan.
Postscan Defines logic to execute during postscan.
EnableInFalse Defines logic to execute when EnableIn is false.
For example, this structure for an Add-On Instruction uses all four routines.
ADD_ON_INSTRUCTION_DEFINITION Example (attributes)
PARAMETERS
add_on_instruction_parameters
END_PARAMETERS
LOCAL_TAGS
add_on_instruction_local_tags
END_LOCAL_TAGS
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 37 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.
<Parameters>
L5X parameters structure <Parameter [Parameter_Attributes]>
<Description>
<![CDATA[ text ]] >
</Description>
<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>
Parameter elements
Parameters attributes
Attribute Description
Name L5X only. Specify the name of the parameter.
Signature history The Signature History stores history entries for an Add-On Instruction. There
can be 0…6 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.
• L5K file—The Signature History is stored in the HISTORY_ENTRY
structure.
• L5X file—The Signature History is stored in the <SignatureHistory>
structure.
When an Add-On Instruction is sealed, the Signature History is protected and
hidden in the ENCODED_DATA section. See Encoded/UnencodedAdd-On
Instructions on page 90.
• L5K file—The ENCODED_DATA section is a separate section.
• L5X file—The <EncodedData> section is an element of
<AddOnInstructionDefinitions>.
<SignatureHistory>
L5X SignatureHistory <HistoryEntry [HistoryEntry_Attributes]>
structure <Description>
<![CDATA[ text ]] >
</Description>
</HistoryEntry>
</SignatureHistory>
Attribute Description
User Specifies the identity of the user that created the entry.
Timestamp Specifies the timestamp when the entry was created. The value is a UTC date time, such as 2009-04-01T12:08:00.000Z.
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 99. 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 37 for more information on the <Data> element format.
<LocalTags>
L5X LocalTags structure <LocalTag [LocalTag_Attributes]>
<Description>
<![CDATA[ text ]] >
</Description>
<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]>
Local tag attributes Specify these attributes for local tags in L5X format. See Chapter 6 Defining a
Tag Component on page 99 for attributes for local tags in L5K format.
Attribute Description
Name L5X only. Specify the name of the local tag.
Encoded/Unencoded These examples are for protected (encoded) and unprotected (clear text)
codes for Add-On Instructions.
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 30 for procedures.
<EncodedData EncodedType= "type", Name="name",
L5X EncodedData Structure Type="routinetype"
[,other_attributes]>
<Description>
<![CDATA[ text ]] >
</Description>
encoded_data
Encoded data attributes See the table for encoded data attributes for .L5X and .L5K items and their
descriptions.
L5X Item L5K Item Description
Encoded Information See the table for the encoded information element for the .L5X and .L5K item
and identifier.
elements
L5X Item L5K Item Identifies
EncryptionKey ENCRYPTION_KEY Identifies the options the user has chosen for protecting and locking their content.
Encoded key attributes See the table for encoded key attributes and their descriptions.
Attribute Description
Name Identifies the type of protection.
Encoded content attributes This table contains encoded content attributes and their descriptions.
Attribute Description
EncryptedType Indicates the underlying language of the routine for this encoded content (for example, RLL or Structured text).
OnlineEditType L5X only. Specify the online edit logic type (Original, PendingEdits, or TestEdits). This attribute is not specified if
there are no edits.
ENCODED_DATA (EncodedType :=
L5K Encoded Add-On ADD_ON_INSTRUCTION_DEFINITION,
instruction example Name := "Conveyor_Control",
Description := "This is the description",
Revision := "1.0",
Add-On Instruction Use these Add-On Instruction guidelines with function blocks:
Guidelines • 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.
L5X unencoded This L5X file shows a definition partial export example for an L5X Add-On
Instruction.
AddOnInstruction definition
example
Add-On Instruction
Example, Continued
PARAMETERS
Valve_Command : BOOL (Description := “0 - Close
valve$N1 - Open valve”,
Radix := Decimal, Required := Yes, Visible := Yes,
DefaultData := “1”);
Array_Parameter : REAL[5] (Type := InOut, Radix
:= Float, Required := Yes,
Visible := Yes); Valve_Out : DINT (Type := Output,
Radix := Decimal,
Required := No, Visible := Yes, DefaultData :=
“0”);
Reset : BOOL (Description := “Used by Prescan
routine to run Reset code”,
Type := Input, Radix := Decimal, Required := No,
Visible := No,
DefaultData := “1”);
END_PARAMETERS
LOCAL_TAGS
Valve_Type : DISCRETE_2STATE (Description :=
“The valve is a 2 state valve”,
DefaultData :=
“[49,0.00000000e+000,0,0,0.00000000e+000,0.00000000e+00
0,
0.00000000e+000,0.00000000e+000,0.00000000e+000,0.00
000000e+000]”);
END_LOCAL_TAGS
END_ADD_ON_INSTRUCTION_DEFINITION
Introduction This chapter explains the overall structure of the tag component.
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 Logix 5000™ Controller Common Procedures
Programming Manual, publication 1756-PM001.
<Tag [Tag_Attributes]>
L5X tag structure <ConsumeInfo [Consume_Attributes]/>
<ProduceInfo [Produce_Attributes]/>
<Description>
<![CDATA[ text ]]>
</Description>
<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>
Tag elements
Specify tag<specifier>
Where the specifier is a bit (.bitnumber), array element ([element]), or structure
member (.membername) of the tag.
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, 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.
Tag attributes
Attribute Description
Name The name of the tag.
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 L5X only. The number of elements within the array dimension.
For example [5, 10, 2].
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.
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.
PermissionSet Name of the set of permissions, configured in FactoryTalk® Security, to apply to this object.
Produced tag attributes A produced tag has these attributes, and those for a standard tag.
Attribute Description
ProduceCount Specify the number of consumers allowed with any positive number.
Consumed tag attributes A consumed tag also has these attributes, in addition to those for a standard
tag.
IMPORTANT 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.
ALARM_ANALOG tag In an .L5X file, tag attributes for an ALARM_ANALOG tag are in the Data
element.
L5X tag structure for <Data Format="Alarm">
L5K tag structure for In an .L5K file, tag attributes for an ALARM_ANALOG tag are in the tag
ALARM_ANALOG tag statement.
<tag_name> : <type>
[(Alarm_Analog_Attributes)]
ALARM_ANALOG tag See the table for ALARM_ANALOG tag attributes and their descriptions.
attributes
Attribute 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.
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 Set by the operator to shelve a high-high condition.
HOperShelve Set by the operator to shelve a high condition.
LOperShelve Set by the operator to shelve a low condition.
LLOperShelve Set by the operator to shelve a low-low condition.
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.
ALARM_DIGITAL tag In an .L5X file, tag attributes for an ALARM_DIGITAL tag are in the Data
element.
L5X tag structure for <Data Format="Alarm">
L5K tag structure for an In an .L5K file, tag attributes for an ALARM_DIGITAL tag are in the tag
ALARM_DIGITAL tag statement.
<tag_name> : <type>
[(Alarm_Digital_Attributes)] := value;
ALARM_DIGITAL tag See the table for ALARM_DIGITAL tag attributes and their descriptions.
attributes
Attribute Description
EnableIn Specify whether to enable the alarm tag. Type 1 to enable the tag; type 0 to disable the tag
In Specify the analog input to the alarm.
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 Specify whether an operator disables an alarm. Type 1 to enable; type 0 to disable.
ProgEnable Specify whether the program enables an alarm. Type 1 to enable; type 0 to disable.
OperEnable Specify whether an operator enables an alarm. Type 1 to enable; type 0 to disable.
L5X AlarmConfig structure 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>
AlarmConfig elements See the table for .L5X items and their descriptions.
L5K ANALOG_ALARM In an .L5K file, the ALMMSG statement contains the alarm message text.
ALMMSG.<alarm_type>:<language>:=<"message_text">
message structure L5K Item Description
alarm_type For an analog alarm type.
ALMMSG elements 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
L5X message structure In an .L5X file, message attributes are in the Data element.
<Data Format="Message">
<MessageParameters [Message_Attributes]/>
</Data>
L5K MESSAGE structure In an .L5K file, message attributes are in the tag statement.
Attribute Description
MessageType Type Block Transfer Read, Block Transfer Write, CIP™ Data Table Read, CIP™ Data Table Write, CIP™
Generic, PLC-2® Unprotected Read, PLC-2® Unprotected Write, PLC-3® Typed Read, PLC-3® Typed Write,
PLC-3® Word Range Read, PLC-3® Word Range Write, PLC-5® Typed Read, PLC-5® Typed Write, PLC-5®
Word Range Read, PLC-5® 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 Specify the number of elements to be transferred (0...32,767).
ConnectedFlag Specify whether the CIP™ generic message requires a connection or not. Type 1 for connected, or 0 for not
connected.
ConnectionPath Specify the connection path to the other device.
CommTypeCode Specify the type of communication method.
Type: For this communication method:
0 CIP™ (most messages use CIP™ communications)
1 DH+™
2 CIP™ with source ID
3 block transfer via universal remote I/O
4 block transfer via ControlNet®
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.
AttributeNumber If the message type is CIP™ Generic, specify the attribute number (0...65,535 hexadecimal).
Channel For a DH+™ or block transfer message, specify the channel. Type A or B.
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 Specify the index into the local element, typically 0.
RemoteIndex Specify the index into the remote element, typically 0.
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 Specify the tag name of the destination element.
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_CONSUMED,
AXIS_GENERIC_DRIVE,
AXIS_SERVO,
AXIS_SERVO_DRIVE, or
AXIS_VIRTUAL Tag
In an .L5X file, axis attributes are in the Data element.
L5X axis structure <Data Format="Axis">
<AxisParameters [Axis_Attributes]/>
</Data>
L5K AXIS TAG structure In an .L5K file, axis attributes are in the tag statement.
<tag_name> : <type>
[(Axis_Attributes)];
Axis tag attributes These attributes are for the AXIS_CONSUMED, AXIS_GENERIC_DRIVE,
AXIS_SERVO, AXIS_SERVO_DRIVE, and AXIS_VIRTUAL tags. 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 Type the name of the associated motion group, or type NA.
For L5X, if there is no Motion group, then the attribute is not present.
MotionModule Type the name of the associated motion module, or type NA.
For L5X, if there is no Motion module, then the attribute is not present.
MotorCatalogNumber Specify the catalog number of the motor that this axis is connected or type NONE.
RotationalPosResolution Specify the number of counts per motor revolution (1...[232-1]).
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 Specify user-defined engineering units, rather than feedback units.
AverageVelocityTimebase Specify the time in seconds for calculating the average velocity of the axis (any positive number).
RotaryAxis Specify the positioning mode for an axis. Type Rotary or Linear.
PositionUnwind For a rotary axis, specify the distance, in feedback counts, used to perform electronic unwind (any positive
number).
HomeMode Specify the homing mode. Type Passive, Active, or Absolute.
HomeDirection For active homing sequences, except for the immediate sequence type, specify the desired homing direction.
Type Uni-directional 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 Specify the home configuration bits. Type a hexadecimal number.
ConverterRegenerativePowerLimit Limits the amount of regenerative power allowed to transfer from the DC Bus to the converter. Since this is
regenerative power, the value of the limit is negative. Converter Rated is defined as the Converter Rated Input
Power attribute value.
ConverterOvertemperatureUserLimit Sets the user limit for the Converter Overtemperature UL exception.
ConverterThermalOverloadUserLimit Sets the user limit for the Converter Thermal Overload UL exception.
ConverterGroundCurrentUserLimit Sets the user limit for the Converter Ground Current UL exception.
CIPAxisExceptionAction2 A 64-element array of enumerated bytes that specifies the action for the associated extended standard
exception.
CIPAxisExceptionAction2-RA A 64-element array of enumerated bytes that specifies the action for the associated extended Rockwell
Automation specific axis exception.
SafetyFaultAction An enumerated value that specifies the action taken in the event of a safety fault condition reported by the
Safety Core.
BusObserverConfiguration Enumerated value that configures operation of the Bus Observer. The Bus Observer dynamically measures the
active current applied to the DC Bus for the purpose of bus impedance compensation. Selecting the Voltage
Estimate configures the observer to dynamically estimate voltage based on an internal model of the DC Bus.
When Voltage Estimate is selected, this signal is applied to the voltage loop to provide superior control loop
performance. The Voltage Estimate may be used in combination with the Bus Observer by selecting Bus
Observer with Voltage Estimate.
ExternalDCBusCapacitance Represents the combined capacitance of all the external devices that share the DC Bus output of the
regenerative converter.
ConverterModelTimeConstantBase Floating point value that represents the lumped model time constant associated with the regenerative
converter device for computing loop gains. This attribute stores the original Converter Model Time Constant
value for subsequent upload. The Converter Model Time Constant Base is computed based on the converter
current loop bandwidth, the bus voltage loop update time and the bus voltage feedback sample period
according to the following formula:
CMTC_Base = 2 * 1/(2*PI*Current Loop Bandwidth(Hz)) + Bus Voltage Loop Update Period
ConverterCurrentLoopBandwidthBase Floating point value that represents the default bandwidth for the active and reactive current loops for the
regenerative converter. This attribute stores the original default Converter Current Loop Bandwidth value that
was used to compute the Converter Model Time Constant that is the basis for tuning the converter.
ConverterRatedCurrent Floating point value that represents the continuous output current rating associated with the regenerative
converter and used to compute the System Capacitance scaling attribute value from the Total Capacitance of
the DC Bus. This attribute stores the original Converter Rated Current value for subsequent upload.
ConverterRatedPeakCurrent Floating point value that represents the peak output current rating associated with the regenerative converter
and used together with the Converter Rated Current to compute the default Converter Current Vector Limit
attribute value. This attribute stores the original Converter Rated Peak Current value for subsequent upload.
ConverterRatedVoltage Floating point value that represents the input voltage rating associated with the regenerative converter and
used to compute the Bus Voltage Set Point attribute value. This attribute stores the original Converter Rated
Voltage value for subsequent upload.
ConverterDCBusCapacitance Floating point value that represents the internal bus capacitance of the regenerative converter and is used to
compute the System Capacitance scaling attribute. This attribute stores the original Converter DC Bus
Capacitance value for subsequent upload.
ConverterConfiguration Attribute that determines the general control behavior of the regenerative or low harmonic AC/DC converter
axis instance.
This attribute sets the Converter Control Mode attributes according to the following table:
Converter Config Converter Control Mode
Bus Voltage Control Bus Voltage Control
Active Current Control Active Current Control
ConverterControlMode Determines the basic mode of operation for the Regenerative Converter.
When Bus Voltage Control is selected, the converter controls the DC bus voltage output of the converter. The
output of the DC bus control loop drives an inner Active AC Line current control loop to maintain the
commanded DC bus voltage level established by the Bus Voltage Set Point.
When Active Current Control is selected, the converter disables DC bus voltage regulation and directly controls
the Active AC Line current component based on the Active Current Command.
This value is derived by the controller from the Converter Configuration attribute value during initial
configuration.
BusVoltageReferenceSource Selects between Automatic and Manual source for the Bus Voltage Reference. Automatic (default) selection
allows converter to optimize the Bus Voltage Reference for best converter performance. With the Manual
selection, the converter uses the user-configured Bus Voltage Set Point value for the Bus Voltage Reference
signal.
BusVoltageLoopBandwidth Determines the proportional gain, Kbp, of the bus voltage loop that multiplies the Bus Voltage Error signal. This
value represents the unity gain bandwidth of the bus voltage loop.
BusVoltageIntegratorBandwidth Determines the bus voltage loop integral gain, Kbi, which together with the Kbp, multiplies the integrated Bus
Voltage Error signal. This value represents the bandwidth of the bus voltage integrator beyond which the
integrator is ineffective. A value of 0 for this attribute disables the integrator.
BusVoltageRateLimit Sets the DC Bus rate limit for the Bus Voltage Set Point that becomes the DC Bus Reference signal when the Bus
Voltage Reference Source is set to Manual.
BusVoltageErrorTolerance Determines the absolute maximum Bus Voltage Error value that can be tolerated without causing an Excessive
Bus Voltage Error exception.
BusVoltageErrorToleranceTime Determines the maximum amount of time that the Bus Voltage Error Tolerance can be exceeded without
generating an exception.
ReactivePowerSetPoint Sets the reference current used to actively regulate the AC Line Reactive Power of the converter when in the
Running state. Attribute units are expressed in percent for Converter Rated Output Power.
Positive value indicates lagging kVAR and negative value indicates leading kVAR.
ReactivePowerRateLimit Sets the active current rate limit for AC Line Reactive Power Set Point input. The output of the Reactive Power
Rate Limit function is the AC Line Reactive Power Reference signal. Attribute units are expressed in percent for
Converter Rated Output Power per second.
ACLineLowFreqUserLimit-Alternate Sets the low frequency limit as the difference from the nominal alternate AC line source frequency.
ConverterHeatsinkOvertemperatureUserLimit Sets a User Limit for the regenerative converter power structure heatsink temperature. Exceeding this value
generates a Converter Overtemperature UL exception.
ACLineOverloadUserLimit Sets a User Limit for thermal overload of Line 1, 2, and 3 components as a percent of their rated thermal
capacity. Exceeding this value generates a Converter Thermal Overload UL exception.
ConverterCurrentLoopTuningMethod Method used to configure the responsiveness of the active and reactive current loops.
With the Direct method, the current loop response is determined directly by the Converter Current Integrator
Bandwidth value that maps to the integral gain, Kci, of the converter’s current loop. When configured for the
Direct tuning method, the Converter Current Loop Damping attribute value has no effect on the current control
loops.
With the Calculated method, the loop response is determined by the Converter Current Loop Damping value.
The converter uses this value to calculate the appropriate internal current loop integral gain, Kci, based on the
Converter Current Loop Bandwidth and known load characteristics of the AC Line. When configured for the
Calculated tuning method, the Converter Current Loop Integrator Bandwidth attribute value has no effect on the
current control loops.
ConverterCurrentLoopDamping Damping factor that, together with the specified Converter Current Loop Bandwidth value, determines
responsiveness of the active and reactive AC line current loops. This attribute may be used as an alternative to
directly setting the Kci gain value for the current loops. A damping factor of 1 results in a critically damped
current loop.
ACLineContactorInputChecking Controls whether or not the AC/DC converter function checks for the presence and proper operation of the AC
Line Contactor using the AC Line Contactor OK input. If AC Line Contactor Checking is Enabled, the presence of
AC line voltage at the device when the AC Line Contactor OK input is Inactive shall cause the converter to
generate an AC Line Contactor exception. If AC Line Contactor Checking is Disabled then the device shall not
check the AC Line Contactor OK input.
COORDINATE_SYSTEM tag In an .L5X file, coordinate system attributes are in the Data element.
<Data Format="CoordinateSystem">
L5X CoordinateSystem <CoordinateSystemParameters
structure [Coordinate_System_Attributes]/>
</Data>
L5K COORDINATE_SYSTEM In an .L5K file, coordinate system attributes are in the tag statement.
structure <tag_name> : <type>
[(Coordinate_System_Attributes)]
Coordinate system tag This table contains coordinate system tag attributes and descriptions.
attributes
Attribute Description
MotionGroupInstance Type the name of the associated motion group or type NA.
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 Specify the name of the axes in this coordinated system.
CoordinationMode Specify coordination mode. Type Primary or Ancillary.
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.
MOTION_GROUP Tag In an .L5X file, motion group attributes are in the Data element.
<Data Format="MotionGroup">
L5X MotionGroup structure <MotionGroupParameters [Motion_Group_Attributes]/>
</Data>
L5K MOTION_GROUP In an .L5K file, motion group attributes are in the tag statement.
structure <tag_name> : <type>
[(Motion_Group_Attributes)];
Attribute Description
GroupType Specify the type of motion group. Type Warning Enabled or Warning Disabled.
CourseUpdatePeriod Specify the coarse update period in milliseconds (500...3200ms).
PhaseShift Specify the phase shift (0...65,535).
GeneralFaultType Specify whether an error generates a major fault or a non-major fault. Type Major Fault or Non Major Fault.
HMIBC tag In an .L5X file, HMIBC attributes are in the Data element.
<Tag Name="MyHMIBC" TagType="Base" DataType="HMIBC"
L5X HMIBC structure ExternalAccess="Read/Write">
<Data Format="HMIBC">
<HMIBCParameters EnableIn="false" ProgFB="false"
BitIndex="0" TerminalCount="0"/>
</Data>
</Tag>
HMIBC attributes
SAFETY tag In an .L5X file, safety attributes are in the Data element.
<Data Foamt="Safety">
L5X safety structure <SafetyParameters [Safety_Attributes]/>
</Data>
L5K SAFETY structure In an .L5K file, safety attributes are in the tag statement.
<tag_name> : <type>
[(Safety_Attributes)] := value;
Safety tag attributes A safety produced or safety consumed tag (Class = Safety) has these
attributes, and the attributes for a standard tag.
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.
Tag initial values In an .L5X file, place the initial value of the tag in the Data element. See
Chapter 1 Data Formats on page 37 for more information on Data elements.
L5X initial tag value <Data>
initial_value
</Data>
L5K initial TAG value In an .L5K file, place the initial value of the tag in the tag statement.
<tag_name> : <type> [(Attributes)][:= <initial_value>];
If the tag is a string tag, specify a STRING type.
Add-On Instruction The Logix Designer application optimizes user memory usage by minimizing
unused space in tags whose type is an Add-On Instruction data type.
tag values
The values for the Input & Output parameters are represented in the order as
they are listed in the Add-On Instruction definition. This rule applies to all
parameter data types except for BOOL. In order to reduce the data size of a
tag of Add-On Instruction type, BOOL parameters and BOOL local tags are
collected and packed in one or more hidden DINT members. Up to 32 BOOLs
are packed into each hidden DINT member. That is, the first BOOL is at bit 0,
Add-On Instruction tag This example demonstrates the tag memory layout of an Add-On Instruction
definition. The dashed lines show where the BOOL members are located in
values example memory. The solid lines indicate where a local member is repositioned to
minimize unused space.
Introduction This chapter describes the structure of tag-based alarms and alarm
definitions.
A tag-based alarm is similar to a digital alarm in that it monitors a tag value to
determine the alarm condition. However, a tag-based alarm is not part of the
logic program and does not increase the scan time for a project. Use the New
Alarm dialog box to implement a tag-based alarm. An alarm definition is
associated with an Add-On Instruction (AOI) or a defined data type. When a
tag is created using a data type or an AOI that has alarm definitions, alarms
are created automatically based on the alarm definitions.
Tag-based alarms The following sections describe the tag-based alarm structure, objects, and
attributes.
<Messages>
<Message Type="CAM">
</Messages>
<AlarmClass>
<![CDATA[Class]]>
</AlarmClass>
<HMIGroup>
<![CDATA[FT Group]]>
</HMIGroup>
<HMICmd>
<![CDATA[FT View command]]>
</HMICmd>
</AlarmConfig>
</AlarmCondition>
</AlarmConditions>
<Data Format="L5K">
<![CDATA[0]]>
</Data>
<Data Format="Decorated">
<DataValue DataType="DINT" Radix="Decimal" Value="0"/>
</Data>
</Tag>
</Tags>
L5K Tag-based Each alarm starts with ALARM_CONDITION and ends with
END_ALARM_CONDITION. The alarm definitions location in the L5K file will
alarm structure be after the tasks. The example below is an alarm that was based on an alarm
definition.
ALARM_CONDITION PVHH (Name := "PVHH",
AlarmConditionDefinition := "PVHH",
OnDelay := 500,
OffDelay := 1000,
DefaultShelveDuration := 0,
MaxShelveDuration := 0,
Deadband := 0.0,
Used := true,
InFault := false,
AckRequired := true,
Latched := false,
ProgAck := false,
OperAck := false,
ProgReset := false,
OperReset := false,
ProgSuppress := false,
OperSuppress := false,
ProgUnsuppress := false,
OperUnsuppress := false,
OperShelve := false,
ProgUnshelve := false,
OperUnshelve := false,
ProgDisable := false,
OperDisable := false,
ProgEnable := false,
OperEnable := false,
AlarmCountReset := false,
AlarmSetOperIncluded := false,
AlarmSetRollupIncluded := false,
EvaluationPeriod := 2,
END_ALARM_CONDITION
The following example is for an alarm that is not based on an alarm definition
and has one localized message.
Input := "\MainProgram.bool",
ConditionType := "TRIP",
Limit := 0.0,
Severity := 500,
OnDelay := 0,
OffDelay := 0,
DefaultShelveDuration := 0,
MaxShelveDuration := 0,
Deadband := 0.0,
Used := true,
InFault := false,
AckRequired := true,
Latched := false,
ProgAck := false,
OperAck := false,
ProgReset := false,
OperReset := false,
ProgSuppress := false,
OperSuppress := false,
ProgUnsuppress := false,
OperUnsuppress := false,
OperShelve := false,
ProgEnable := false,
OperEnable := false,
AlarmCountReset := false,
AlarmSetOperIncluded := true,
AlarmSetRollupIncluded := true,
EvaluationPeriod := 2,
Expression := 128,
AlarmClass := "aaa",
HMICmd := "ccc")
END_ALARM_CONDITION
Tag-based alarm objects This section describes tag-based alarm objects and their attributes.
Alarm Conditions
Alarm conditions are a collection of the alarms for a tag.
• AlarmCondition -- An alarm condition in this collection for this tag.
Alarm Condition
The alarm condition on a tag. The following table lists Alarm Condition
attributes.
Programmatic Name Attribute Description
Name The name of the alarm.
Input Fully qualified path of a Scalar Tag Item that has this alarm.
Condition The alarm condition type. See table below for values and the relation to the input data type.
AlarmConditionDefinition The alarm condition definition that this alarm is based on.
Evaluation Period How frequently the alarm limit will be evaluated.
There is only one evaluation period and it is 500.
Expression The expression for evaluating the condition compared to the limit. See the table below for the expression for the
various condition types.
Limit Alarm limit.
Default = 0.0.
AlarmConfig
Provides the following additional attributes:
• AlarmMessages -- Messages that are displayed when the alarm is
activated.
• AlarmClass -- String grouping together related alarms.
• HMICmd -- Command string that gets executed on the HMI when the
alarm is activated.
• HMIGroup -- String grouping together related alarm for the HMI.
AlarmMessages
Contains the messages for the alarm.
AlarmMessage
A message for the alarm. Includes the following attributes:
• Type -- Must be CAM.
• Text -- The text of the alarm message.
Text
The text of the alarm message in a language. Includes the following attributes:
• Lang -- Language for the alarm message.
• Value -- Content of the alarm message.
Tag-based alarm The following sections describe the tag-based alarm definition structure,
objects, and attributes.
definitions
L5X Tag-based alarm <AlarmDefinitions>
<![CDATA[Message]]>
</Text>
</Message>
</Messages>
<AlarmClass>
<![CDATA[Class]]>
</AlarmClass>
<HMIGroup>
<![CDATA[FT Group]]>
</HMIGroup>
<HMICmd>
<Tags>
Name := "PVHH",
Input := "PID_ENHANCED.PVFault",
ConditionType := "TRIP",
Limit := 0.0,
MaxShelveDuration := 0,
Deadband := 0.0,
Required := true,
InFault := false,
AckRequired := true,
Latched := false,
AlarmSetOperIncluded := false,
AlarmSetRollupIncluded := false,
EvaluationPeriod := 2,
Expression := 19,
AssocTag1 := "PID_ENHANCED.EnableIn",
AssocTag2 :=
"PID_ENHANCED.SPHLimit",
AssocTag3 := "PID_ENHANCED.SPLLimit",
AlarmClass := "My Class",
Tag-based alarm This section describes tag-based alarm definition objects and their attributes.
definition objects
AlarmDefinitions
The collection of all of the alarm definitions in the project.
• DatatypeAlarmDefinition -- The alarm definitions for a specific
datatype.
DataTypeAlarmDefinition
The collection of the alarm definitions for a specific datatype.
• Name -- The name of the datatype that these alarm definitions are for.
MemberAlarmDefinition
The alarm definition for a specific member of a datatype. The following table
describes the alarm definition attributes.
Programmatic Name Attribute Description
Name The name of the alarm definition.
Input Fully qualified path of a datatype member that this alarm definition is on.
ConditionType The alarm condition type.
Evaluation Period How frequently the alarm limit will be evaluated.
There is only one evaluation period and it is 500.
Expression The expression for evaluating the condition compared to the limit.
Limit Alarm limit.
Default = 0.0.
TargetTag Tag used to in the condition’s expression for input datatypes that are not BOOL or BIT.
AssocTag1 Up to four specified tags that contain pertinent data when alarm conditions occur. A snapshot of the values in these
AssocTag2 tags is stored whenever the status changes to the In Alarm state, or other alarm state changes occur. The stored
AssocTag3 values may also be embedded in the alarm Message.
AssocTag4
Severity Severity of the High alarm condition. This does not affect processing of alarms by the controller, but can be used for
sorting and filtering functions at the alarm subscriber.
Valid = 1...1000 (1000 = most severe; 1 = least severe).
Default = 500.
OnDelay Duration (milliseconds) for the alarm condition to remain true before the alarm is marked as InAlarm and alarm
notification is sent to clients. The controller collects alarm data as soon as the alarm condition is detected; so no
data is lost while waiting to meet the minimum duration.
Valid = 0...2147483647.
Default = 0.
OffDelay Duration (milliseconds) for the alarm condition to remain false before the alarm is marked as not InAlarm and alarm
notification is sent to clients. The controller collects alarm data as soon as the alarm condition is detected; so no
data is lost while waiting to meet the minimum duration.
Valid = 0...2147483647.
Default = 0.
ShelveDuration Time duration (in minutes) for which a shelved alarm will be shelved. Minimum time is one minute. Maximum time is
defined by MaxShelveDuration.
MaxShelveDuration Maximum time duration (in minutes) for which an alarm can be shelved.
Deadband Deadband for detecting when the alarm levels have returned to normal.
A non-zero Deadband can reduce alarm condition chattering if the In value is continually changing but remaining
near the level condition threshold. The Deadband value does not affect the transition to the InAlarm (active) state.
Default = 0.0.
AckRequired Specifies whether alarm acknowledgment is required. When set, acknowledgment is required. When cleared,
acknowledgment is not required and Acked is always set.
Default is set.
Latched Specifies whether the alarm is latched. Latched alarms remain InAlarm when the alarm condition becomes false,
until a Reset command is received. When set, the alarm is latched. When cleared, the alarm is unlatched.
Default is cleared.
A latched alarm can only be reset when the alarm condition is false.
Default is cleared.
Introduction This chapter explains the overall structure of the Program component.
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 Maximum Number of Programs
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
<Programs>
L5X program structure <Program [Program_Attributes]>
<Description>
<![CDATA[ text ]] >
</Description>
<Tags>
tags
</Tags>
<Routines>
routines
</Routines>
<ChildPrograms>
child_programs
</ChildPrograms>
</Program>
</Programs>
Program elements
Program attributes
Attribute Description
Name L5X only. Specify the name of the program.
Program attributes for In addition to the program connection attributes previously described, an
Equipment Phase program (Program Type = EquipmentPhase) has the
EquipmentPhase programs following attributes.
Attribute Description
PreState (L5K) L5K only. Specify the name of the prestate routine (40 characters maximum).
PreStateRoutineName (L5X)
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).
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.
Program attributes for In addition to the program connection attributes previously described, a
Sequence program (Program Type = Sequence) has the following attributes.
Sequence programs
Attribute Description
Revision Revision number for the program, consisting of major and minor revision.
RevisionExtension Additional revision information.
UnitID Numeric identifier to designate the equipment that the sequence is controlling.
Child program component 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.
Child program attributes See the table for the child program attribute and description.
Attribute Description
child_program_name L5X only. Specify the name of the child program.
Child program guidelines Observe these guidelines when defining a child program.
• Since child programs are a way to organize existing programs, adding
a child program component does not add to the number of programs.
Encoded/Unencoded These examples are for protected (encoded) and unprotected (clear text)
codes for routines.
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 30 for procedures.
<EncodedData EncodedType= "type", Name="name",
L5X EncodedData Structure Type="routinetype"
[,other_attributes]>
<Description>
<![CDATA[ text ]] >
</Description>
encoded_data
</EncodedData>
Encoded Data Elements See the table for routine encoded data attributes for .L5X and .L5K items and
their descriptions.
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.
Encoded Information See the table for the encoded information element for the .L5X and .L5K item
and identifier.
elements
L5X Item L5K Item Identifies
EncryptionKey ENCRYPTION_KEY Identifies the options the user has chosen for protecting and locking their content.
Encoded key attributes See the table for encoded key attributes and their descriptions.
Attribute Description
Name Identifies the type of protection.
Encoded content attributes This table contains encoded content attributes and their descriptions.
Attribute Description
EncryptedType Indicates the underlying language of the routine for this encoded content (for example, RLL or Structured text).
OnlineEditType L5X only. Specify the online edit logic type (Original, PendingEdits, or TestEdits). This attribute is not specified if
there are no edits.
L5X source-protected
routine examples
Introduction This chapter explains how to enter ladder diagram logic in a complete
import/export file.
Ladder logic routine These examples show the ladder logic routine structure.
<Routines>
L5X ladder logic routine <Routine [Routine_Attributes]>
structure <Description>
<![CDATA[ text ]] >
</Description>
<RLLContent>
logic
</RLLContent>
</Routine>
</Routines>
Attribute Description
Name L5X only. Specify the name of the routine.
Rung logic Enter rung logic within a routine component in an import/export file.
<RLLContent>
L5X rung structure <Rung [Rung_Attributes]>
<Comment>
<![CDATA[ comment_text ]] >
</Comment>
<Text >
<![CDATA[ rung_neutral_text; ] ] >
</Text>
</Rung>
</RLLContent>
Rung elements
Rung attributes
Attribute Description
Number L5X only. Specify the rung number within the routine.
In L5K, the rung number is defined by the order the rung appears in the L5K format.
Type L5X only. Specify RLL.
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
Neutral text for ladder These tables lists each ladder instruction and its neutral text format. For
details about a specific instruction, see the listed reference manuals.
instructions
Ladder Logic Instruction Reference Manuals
Introduction This chapter explains how to enter function block diagram logic in a complete
import/export file.
Function BlockDiagram These examples show the function block routine structure.
Routine <Routines>
L5X function block diagram <Routine [Routine_Attributes]>
<Description>
routine structure <![CDATA[ text ]]>
</Description>
<FBDContent [FBDContent_Attributes]>
<Sheet [Sheet_Attributes]>
logic
</Sheet>
</FBDContent>
</Routine>
</Routines>
FBD_routine attributes
Attribute Description
Name L5X only. Specify the name of the routine.
TrackingGroups The group of tracked objects to which this item belongs. Components can be marked for tracking to
determine whether they have been changed. Version 30 of the Logix Designer application supports
only one tracking group.
Sheet Enter the function block diagram logic in sheets within a routine component
in an import/export file.
<Sheet [Sheet_Attributes]>
L5X sheet structure <Description>
<![CDATA[ text ]]>
</Description>
<IRef [Iref_Attributes]/>
<ORef [Oref_Attributes]/>
<ICon [Icon_Attributes]/>
<OCon [Ocon_Attributes]/>
<Block [Block_Attributes]/>
<AddOnInstruction [AddOnInstruction_Attributes]/>
<JSR [JSR_Attributes]/>
<SBR [SBR_Attributes]/>
<RET [RET_Attributes]/>
<Wire [Wire_Attributes]/>
<FeedbackWire [FeedbackWire_Attributes]/>
Sheet elements
Sheet attributes
Attribute Description
Number L5X only. Specify the number of the sheet.
In L5K, the sheet number is determined by the order the SHEET statement appears in the L5K format.
Name L5K only. Specify the name of the sheet.
In L5X, the name of the sheet is specified in a <Description> element under the <Sheet> element.
Export function block logic If you export function block logic that contains online edits, the export file
exports LOGIC blocks, in L5K format, or additional <FBDContent> elements,
while editing online 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.
Item 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 Input and output references have similar formats and identical attributes.
<IRef [Reference_Attributes]/>
L5X IREFand OREF structure
<ORef [Reference_Attributes]/>
Reference attributes
Connector attributes See the table for .L5X and .L5K items and descriptions.
Block attributes See the table for .L5X and .L5K items and identifiers.
• 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.
Functions Function Block functions are similar to instructions but do not require
backing tags, require less memory, sometimes execute more quickly, and take
up less space in a function block diagram. Function Block functions are
available only on CompactLogix™ 5380, Compact GuardLogix® 5380,
CompactLogix™ 5480, ControlLogix® 5580, and GuardLogix® 5580 controllers.
<Function [Function_Attributes]/>
L5X function structure
FUNCTION (Function_Attributes)
L5K FUNCTION structure END_FUNCTION
Function attributes
Add-On instructions The Add-On Instruction elements in a function block diagram routine
structure represent the use of the Add-On Instruction in the routine, not the
definition of the Add-On Instruction.
Add-On Instruction This table contains Add-On Instruction attributes and their descriptions for
Attributes Function Block Diagram.
Attribute Description
Name L5X only. Specify the name of the Add-On Instruction component.
In L5K, the name is an element of the statement.
Class Specify the class of the Add-On Instruction. This attribute applies only to safety projects. Type Standard or
Safety.
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 Provide additional information about the revision (40 characters maximum).
RevisionNote Provide information about the revision (128 characters maximum).
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 Specify the date the Add-On Instruction was created.
CreatedBy Specify the developer that created the Add-On Instruction.
Add-On Instruction Use these Add-On Instruction guidelines with function blocks:
Guidelines • 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 <JSR [JSR_Attributes]>
JSR attributes
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.
L5K
L5X SBR structure SBR (SBR_Attributes)
END_SBR
SBR attributes
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 [RET_Attributes]>
L5X RET Structure </RET>
RET attributes
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.
Wires and feedback wires 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.
<Wire [Wire_Attributes]/>
L5X wire structure
<FeedbackWire [Wire_Attributes]/>
FEEDBAK_WIRE (Wire_Attributes)
END_FEEDBACK_WIRE
Wire attributes
For: Type:
Blocks Parameter name
Irefs In
Icons In
ToID ToElementID The destination drawing element.
Type an unsigned, 32-bit integer.
ToParam ToParameter The pin on the destination drawing element.
For: Type:
Blocks Parameter name
Orefs Out
Ocons Out
See the table for .L5X and .L5K items and identifiers.
Attachment attributes L5X Item L5K Item Identifies
FromID FromElementID The ID of the attached object. Type an unsigned, 32-bit integer
value.
ToID ToElementID The ID of the object that the FromID object is attached to. Type
an unsigned, 32-bit integer value.
OREF (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 (ID := 2,
X := 260,
Y := 260,
Operand := PI_01,
VisiblePins := "In, Initialize,
InitialValue, Out, HighAlarm, LowAlarm")
END_PI_BLOCK
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
Parameters for function These tables lists each function block instruction and its format in the Block
component of an import/export file. For details about a specific instruction,
block instructions see the listed reference manuals.
Function block instruction reference manuals
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")
D2SD Operand := D2SD_01,
VisiblePins := "ProgCommand, State0Perm, State1Perm, FB0, FB1, HandFB, ProgProgReq, ProgOperReq, ProgOverrideReq, ProgHandReq,
Out, Device0State, Device1State, CommandStatus, FaultAlarm, ModeAlarm, ProgOper, Override, Hand")
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 Logix 5000™ Controller Common Procedures Programming
Manual, publication 1756-PM001.
Sequential function chart These examples show sequential function chart structure.
routine
<Routines>
L5X sequential function <Routine [Routine_Attributes]>
chart structure <Description>
<![CDATA[ text ]]>
</Description>
<SFCContent [SFCContent_Attributes]>
<Step [Step_Attributes]/>
<Transition [Transition_Attributes]/>
<Branch [Branch_Attributes]/>
<SbrRet [SbrRet_Attributes]/>
<Stop [Stop_Attributes]/>
<Branch [Branch_Attributes]/>
<DirectedLink
[DirectedLink_Attributes]/>
<TextBox [TextBox_Attributes]>
text
</TextBox>
<Attachment [Attachment_Attributes]/>
</SFCContent>
</Routine>
</Routines>
SFC_Routine attributes
Attribute Description
Name L5X only. Specify the name of the routine.
Export sequential function If you export sequential function chart logic that contains online edits, the
export file exports LOGIC blocks (in L5K format) or additional <SFCContent>
chart logic while editing elements (in L5X format) to indicate the original, test edits, and pending edits
online states. If there are no online edits, you will not see these LOGIC blocks or
additional <SFCContent> elements.
Item Identifies
Online_Edit_Type When you export logic:
• If online edits exist, there is 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 you export the logic, there are no LOGIC blocks and the main components in the routine are SFC
logic components.
Step elements
Step attributes
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.
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 Whether to show or hide the step’s actions. Type Yes or No.
Preset The preset component contains a structured text expression that specifies the
preset time in milliseconds for the step timer.
<Preset>
L5X preset structure <STContent>
<Line Number="number">
<![CDATA[ structured_text; ]]>
</Line>
</STContent>
</Preset>
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.
<LimitHigh>
L5X limit high structure <STContent>
<Line Number="0">
<![CDATA[ structured_text; ]]>
</Line>
</STContent>
</LimitHigh>
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.
<LimitLow>
L5X limit low structure <STContent>
<Line Number="0">
<![CDATA[ structured_text; ]]>
</Line>
</STContent>
</LimitLow>
Each line of L5K structured text begins with a single quote (‘).
<Action [Action_Attributes]>
L5X Action Structure <Preset>
logic
</Preset>
<Body>
logic
</Body>
</Action>
Action attributes Use the table to view the action attributes for L5X and L5K items.
Transition elements
Transition attributes
Each line of L5K structured text begins with a single quote (‘).
Subroutine calls Subroutine calls pass values into and out of the SFC routine.
<SbrRet [Subroutine_Attributes]/>
L5X SbrRet structure
Subroutine attributes
Stop attributes
Branch attributes See the table for .L5X and .L5K items and identifiers.
Leg attributes
Directed links The directed link blocks in an SFC routine identify the links between SFC
components.
<DirectedLink [DirectedLinkAttributes]/>
L5X DirectedLink structure
Directed link attributes See the table for direct link attributes .L5X and .L5K items and identifiers.
Attachment attributes See the table for .L5X and .L5K items and identifiers.
L5X Item L5K Item Identifies
FromID FromElementID The ID of the attached object. Type an unsigned, 32-bit integer
value.
ToID ToElementID The ID of the object that the FromID object is attached to. Type
an unsigned, 32-bit integer value.
Introduction This chapter explains how to enter structured text logic in a complete
import/export file.
Structured text routine These examples show the structured text routine structure.
<Routines>
L5X structured text <Routine [Routine_Attributes]>
structure <Description>
<![CDATA[ text ]]>
</Description>
<STContent [StContent_Attributes]>
<Line Number="number">
<![CDATA[ structured_text ]]>
</Line>
</STContent>
</Routine>
</Routines>
ST_Routine attributes
Attribute Description
Name L5X only. Specify the name of the routine.
TrackingGroups The group of tracked objects to which this item belongs. Components can be marked for tracking to
determine whether they have been changed. Version 30 of the Logix Designer application supports
only one tracking group.
Structured text logic Enter the structured text logic within a routine component in an
import/export file. Each line of structured text must begin with a single
quote (‘).
Structured text is not case sensitive. Structured text can contain these
elements.
Term Definition Examples
Assignment Use an assignment statement to assign values to tags. tag := expression;
The := operator is the assignment operator.
Terminate the assignment with a semi colon ";".
Expression An expression is part of a complete assignment or construct statement. An expression
evaluates to a number (numerical expression) or to a true or false state (BOOL
expression).
Tags A named area of the memory where data is stored (BOOL, SINT, value1
INT, DINT, REAL, string).
Immediates A constant value. 4
Operators A symbol or mnemonic that specifies an operation within an tag1 + tag2
expression.
tag1 >= value1
Functions When executed, a function yields one value. Use parentheses to function(tag1)
contain the operand of a function.
/*start of comment . . .
end of comment*/
Export structured text logic If you export structured text logic that contains online edits, the export file
exports LOGIC blocks (in L5K format) or additional <STContent> elements (in
while editing online 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 When you export the logic:
• If online edits exist, there is 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 you export the logic, there are no LOGIC blocks and the main components in the routine are
structured text statements.
Structured text These tables list each structured text instruction and function. For more
details, see these reference manuals.
Instruction Type Resource
Basic, sequential instruction Logix 5000™ Controllers General Instructions Set Reference Manual, publication 1756-RM003.
Process control or drives Logix 5000™ Controllers Advanced Process Control and Drives Instruction Set Reference Manual, publication1756-RM006.
instruction
Motion instruction Logix 5000™ Controllers Motion Instructions Reference Manual, publication MOTION-RM002.
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 dest := sourceA / sourceB;
DTOS DTOS(Source,Dest);
EOT EOT(DataBit);
EQU IF sourceA = sourceB THEN
<statements>;
ENDIF;
ESEL ESEL(ESEL_tag);
EVENT EVENT(task);
FGEN FGEN(FGEN_tag,X1,Y1,X2,Y2);
<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);
<statement>;
END_WHILE;
XIC IF data_bit THEN
<statement>;
END_IF;
XIO IF NOT data_bit THEN
<statement>;
END_IF;
XOR dest := sourceA XOR sourceB;
XPY dest := sourceX XPY sourceY;
Introduction This chapter explains the overall structure of the task component.
Task component A task component defines a task in the controller project. The maximum
number of tasks depends on the type of controller.
Controller Maximum Number of Tasks
ControlLogix® 32
SoftLogix5800 32
FlexLogix™ 8
CompactLogix™
• 1768-L30x 32
• 1769-L33x 32
• 1769-L36x 23
DriveLogix™ 8
Task elements
Task attributes
Attribute Description
Name L5X only. Specify the name of the task.
Rate If the task is a periodic task, specify how often to run the task (1.000...2,000,000.000 µs).
Priority Specify the priority of a periodic task (1...15)
Watchdog Type the watchdog timeout for the task (1.000...2,000,000.000 µs).
EventTrigger Only used for event tasks.
Specify the trigger for the event task. Type Axis Home, Axis Watch, Axis Registration 1, Axis Registration 2,
Motion Group Execution, EVENT Instruction Only, Module Input Data State Change, Consumed Tag, or
Windows® Event.
Introduction This chapter explains the overall structure of the parameter connection
component.
PARAMETER_CONNECTION
L5K (EndPoint1:=<program.parameter_name>,
PARAMETER_CONNECTION EndPoint2:=<program.parameter_name>)
structure END_PARAMETER_CONNECTION
EndPoint2="program_name.parameter_name" />
</ParameterConnections>
Parameter connection
attributes
Attribute Description
EndPoint1 Specify the first end point of the parameter connection.
Introduction This chapter explains the overall structure of the trend component.
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.
<Trends>
L5X trend structure <Trend [Trend_Attributes]>
<Description>
<![CDATA[ text ]]>
</Description>
<Template>
template_data
</Template>
<Pens>
pen
</Pens>
</Trend>
</Trends>
Trend elements
Trend attributes
Attribute Description
Name L5X only. Specify the name of the trend.
Pen declaration A trend object can have as many as eight pen declarations. A pen declaration
follows this structure.
<Pen [Pen_Attributes]>
L5X pen structure <Description>
<![CDATA[ text ]]>
</Description>
</Pen>
Pen elements
Pen attributes
Attribute Description
Name L5X only. Specify the name of the pen.
Introduction This chapter explains the overall structure of the watch list component.
Quick 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.
<QuickWatchLists>
L5X QuickWatchList <QuickWatchList [QuickWatchListAttributes]>
structure <WatchTag [WatchTagAttributes] />>
</QuickWatchList>
</QuickWatchLists>
Attribute Description
Name Specify the name of the quick watch list.
Attribute Description
Specifier Specify the tag or part of a tag to watch.
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.
Introduction This chapter explains how to enter project and configuration information in a
complete import/export file.
Object elements
In L5X, each controller config object is specified with an element specific to that
object.
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.
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 Specify the characters that designate the end of a line.
AppendChars Specify the characters to append to the end of a line.
BufferSize Specify the maximum size of the data array (1...65535 bytes) to send and receive.
Introduction This chapter explains how to define custom properties in a controller project.
Custom properties can be used to store any additional information that
should persist with the project. This information is imported with the project,
downloaded to the controller, uploaded from the controller, and exported
with the project. Custom properties can be added to most XML elements in
the L5X format. For example, you can add it to the controller, data types,
data type members, modules, add-on instructions, tags, programs, routines,
rungs, sheets, various instructions, various collections, ST lines, trends, and
so on. However, you cannot add custom properties to custom properties.
Custom properties are compatible only with the L5X format.
Custom property data is well-formed XML limited to chunks of 65000 bytes.
To associate more thank 65K of data on a single parent object, break it into
multiple sections using the extension attribute. This optional attribute is a
free-form string, so you can organize custom properties information in any
way you need.
Custom properties data The following sections describe custom properties data.
Custom properties Custom Properties should be the first child xml element under the parent
element.
structure <ParentXmlObject … >
<CustomProperties>
<Provider ID="YourCompanyName" Ext="Part 1" >
<YourData YourAttrib="Your Value" />
<YourOtherData Attrib2="2" >
<YourChildElement Attrib3="3" />
</YourOtherData>
</Provider>
<Provider ID="YourCompanyName" Ext="Part 2" >
<![CDATA[ Your custom property data
wrapped in CData ]]>
</Provider>
<Provider ID="ToolMakerX" >
<ToolMakerData >Custom property data
from a tool you are using</ToolMakerData>
</Provider>
</CustomProperties>
… (the rest of the ParentObject’s child elements) …
Custom properties This table contains .L5X custom property elements and their descriptions.
elements L5X item Description
CustomProperties The collection of Provider elements.
Provider Unique element that wraps the user’s custom property XML. The XML between this
beginning and end element must be well-formed.
Custom properties This table contains custom properties attributes and descriptions.
Example The following example demonstrates adding custom properties for a tag:
<Tag Name="MyTag" TagType="Base" DataType="DINT"
Radix="Decimal" Constant="false"
ExternalAccess="Read/Write">
<CustomProperties>
<Provider ID="CompanyX" >
<CompanXTextData > Your Xml data as a
Text Node </CompanXTextData>
</Provider>
</CustomProperties>
<Data Format="L5K">
<![CDATA[42]]>
</Data>
<Data Format="Decorated">
<DataValue DataType="DINT" Radix="Decimal"
Value="42"/>
</Data>
</Tag>
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.
Place information in a .CSV The structured import/export file contains these components for comments
and other information.
or .TXT file
Item Identifies
Remark Comment within the file.
TAG Tag.
RCOMMENT Rung comment.
TEXTBOX Text box comment.
Internal file comments Enter comments to document import files. The import process ignores these
comments. Place comments anywhere in an import/export file, except in
names and descriptions. Enter comments by starting the line (record) with
REMARK and a comma.
Specify a tag record Each tag record defines a tag within a controller project. A tag record includes
this information.
Item Identifies
Type The type of tag.
TAG tag
ALIAS alias tag
COMMENT tag operand component
Scope The part of the project that owns the tag.
• If no scope is specified, the scope is controller.
• If a scope is specified, it identifies the program or equipment phase.
Name Name of the tag
Description Description of the tag (optional)
Datatype Datatype of the tag - use any valid datatype name
Specifier Optional
• An alias, specifies base tag.
• A tag comment, specifies the tag name and member or bit.
Attributes The attributes of the tag, as exported in the L5K format.
Define how the tag can be used and how it appears.
Attributes do not include tag values.
TAG type record Each TAG record defines a tag within a controller project.
TAG,"Scope","Name","Description","Datatype","Specifie
r","Attributes"
ALIAS type record Each ALIAS record defines an alias within a controller project.
ALIAS,"Scope","Name","Description","Datatype","Specif
ier","Attributes"
COMMENT type record Each COMMENT record defines a comment about a component of a tag, such
as a bit member, structure member, or an array element.
Specify a comment record 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 The type of comment.
RCOMMENT ladder rung comment
TEXTBOX function block or sequential function chart comment
Scope The part of the project that owns the comment.
A program or equipment phase must be specified.
Routine Name of the routine.
Comment Text of the 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.
Tabs
Specify an alarm message An alarm tag can have several alarm message strings for different alarm
conditions in different languages. An alarm message record includes this
record information.
Item Identifies
Type The alarm message and its associated language as: ALMMSG:language
Languages: 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)
Scope The part of the project that owns the comment.
A program or equipment phase must be specified.
Name Name of the associated alarm tag.
Description Text of the alarm message.
Datatype The type of alarm. Specify ALARM_DIGITAL or ALARM_ANALOG.
Specifier Specify the type of alarm.
Specify: For:
AM Digital alarm
HH High-high analog alarm
H High analog alarm
L Low analog alarm
LL Low-low analog alarm
POS Rate-of-change positive analog alarm
NEG Rate-of change negative analog alarm
These examples use the Motor_Starter_Program program file and exports the
program parameters and local tags.
Introduction This appendix describes how using Windows® or Excel® to edit a .CSV file can
affect the file.
IMPORTANT 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.
Microsoft Excel Data When you open the exported .CSV file in Excel®, Excel® makes these
conversions.
Transformation
Original Content Content in .CSV File Content After Content After Details
After Export Opening in Excel® Saving from Excel®
.0 ".0" 0 0 Logix Designer addresses this as the specifier for a tag.
If you enter this as an entire comment, you lose any preceding period
(.). If you enter any text before or after this, Excel® maintains the
content.
=2 "=2" 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" 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" 2 2 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
($).
has "quoted text" "has $"quoted text$" has $quoted text$" "has $quoted text $"" Excel® and Logix Designer alter content when it includes a dollar sign
within string within string" within string" within string""" ($).
this has ‘embedded’ this has this has this has Single quotes work in both software packages.
text $’embedded$’ text $’embedded$’ text $’embedded$’ text
+text "+text" #NAME? #NAME? Do not start a description or comment with a plus sign (+).
-text "-text" #NAME? #NAME? Do not start a description or comment with a minus sign (-).
=text "=text" #NAME? #NAME? Do not start a description or comment with an equal sign (=).
Backward compatibility The import/export feature supports backward compatibility for import
operations. Therefore, the application can import .L5K or .L5X files that are
generated by a previous version of the programming software. In some cases,
an older .L5K file might not correctly import into a newer version of the
application. The revision history in this appendix lists any conditions when
backward compatibility for an import operation does not work as expected.
Import/Export version 2.22 Version 2.22 of the Import/Export feature that is included with the Logix
Designer application, version 31, includes the following major enhancement:
Logix Designer application
• Added the new Alarm Condition type.
version 31
Import/Export version 2.21 Version 2.21 of the Import/Export feature that is included with the Logix
Designer application, version 30, includes the following major enhancements:
Logix Designer application
• Added the TrackingGroups attribute for routines, Add-On
version 30 Instructions, and tags.
• Added encryption elements and attributes for routines and Add-On
Instructions.
Import/Export version 2.20 Version 2.20 of the Import/Export feature that is included with the Logix
Designer application, version 29, includes the following major enhancement:
Logix Designer application
• Added the EtherNetIPMode controller attribute.
version 29
Import/Export version 2.18 Version 2.18 of the Import/Export feature that is included with the Logix
Designer application, version 27, includes these major enhancements:
Logix Designer application
• Added the custom properties functionality.
version 27 • Added the DownloadCustomProperties controller attribute.
• Added the HMI Button Control (HMIBC) instruction.
Import/Export version 2.17 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
Logix Designer application
major enhancements.
version 26
Import/Export version 2.15 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
Logix Designer application major enhancements:
version 24 • Removed support for the 1789-L60 controller.
• Added the ParameterConnections controller element with the
EndPoint1 and EndPoint2 attributes.
• Added the SafetyEnabled and NATActualAddress module attributes.
• Added the SignatureID, SignatureTimestamp, SafetySignatureID
Encoded Add-On Instruction attributes.
• Added the Sequencing tag attribute.
• Added the Alternate1UpdateMultiplier and
Alternate2UpdateMultiplier motion group tag attributes.
• Added the AxisUpdateSchedule axis tag attribute.
• Added the UseAsFolder program attribute.
• Added the ChildPrograms program element with the
child_program_name attribute.
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.
Import/Export version 2.12 Version 2.12, major revision 2, minor revision 12, of the Import/Export feature
included with Logix Designer application, version 21 includes these major
Logix Designer application enhancements:
version 21 • Removed support for the following controllers: 1756-L61, 1756-L61S,
1756-L62, 1756-L62S, 1756-L63, 1756-L63S, 1756-L64, 1756-L65, 1768-L43,
1768-L43S, 1768-L45, 1768-L45S, 1769-L23E-QBF1, 1769-L23E-QBFC1,
1769-L23-QBFC1, 1769-L31, 1769-L32C, 1769-L32E, 1769-L35CR, 1769-L35E
• Added the PassThroughConfiguration controller attribute.
• Added Engineering Unit, State0, State1, Max, and Min attributes to
datatype and tag components and Add-On Instructions parameters
and local tags.
• Added new attributes for analog alarm tags: HHOperShelve,
HOperShelve, LOperShelve, LLOperShelve, ROCPosOperShelve,
ROCNegOperShelve, ProgUnshelveAll, HHOperUnshelve,
Import/Export version 2.8 Version 2.8, major revision 2, minor revision 9, of the import/export feature
included with Logix Designer, version 18 includes these major enhancements:
Logix Designer version 18
• Addition of ControlLogix® 1756-L73 and 1756-L75 controller types and
Compact GuardLogix®1768-L43S and 1768-L45S controller types.
• Addition of CanUseRPIFromController attribute to the Controller
component.
Import/Export version 2.8 Version 2.8, major revision 2, minor revision 8, of the import/export feature
included with Logix Designer, version 17 includes these major enhancements:
Logix Designer version 17
• 1756-L63S GuardLogix® safety controller and safety relay ladder
instructions.
• 1756-L65, 1768-L45, 1769-L23E-QB1, 1769-L23E-QBFC1, 1769-L23-QBFC1
controllers.
• A tag IncludeConnectionStatus attribute is no longer exported.
• The L5X format for rung export has been modified such that rung
UIDs are no longer included in the export format.
Import/Export version 2.7 Version 2.7, major revision 2, minor revision 7, of the import/export feature
Logix Designer version 16 included with Logix Designer, version 16 includes these major enhancements:
• 1756-L61S and 1756-L62S GuardLogix® safety controllers and safety
relay ladder instructions.
• 1756-L64 ControlLogix® controller.
• Updated CONTROLLER example.
• Add-On Instructions.
• Alarms
• New alarm instructions: ALMA, ALMD.
• Digital and analog alarm tags.
• New instructions
• Motion instructions: MCT, MCTP.
Import/Export version 2.6 Version 2.6, major revision 2, minor revision 6, of the import/export feature
included with Logix Designer, version 15 includes these major enhancements:
Logix Designer version 15
• Support for the 1769-L32C, 1769-L32CR CompactLogix™ and 1768-L43
CompactLogix™ controllers.
This release also removed support for the 1756-L1 CompactLogix™,
1794-L33 FlexLogix™, 1769-L20 CompactLogix™, 1769-L30
CompactLogix™, and PowerFlex 700 S controllers.
• Equipment Phase program type and its relay ladder and structured
text instructions.
• ControlLogix® and SoftLogix™ controllers now support 100 programs
per task.
• Information about when an imported file modifies a project so that
you cannot go online and access a previously downloaded controller.
• Additional values for the Mode attribute of a MODULE component.
• New SERCOS IDN Read and SERCOS IDN Write message types.
• New motion AXIS_GENERIC_DRIVE type.
• Removal of the DescriptionWidth parameter from the STEP,
TRANSITION, and STOP components in SFC logic.
• Addition of an Attributes column to the CSV format for exported tags.
Import/Export version 2.4 Version 2.4, major revision 2, minor revision 4, of the import/export feature
included with Logix Designer, version 13 includes these major enhancements:
Logix Designer version 13
• Support for new controllers.
• ExtendedProp section to MODULE data.
• Support for new TAG attributes.
Attributes can be in any order in an import/export file. The order
shown in this document is the order the attributes export.
• Support for a TREND object in the import/export .L5K file.
• New MCSV instruction in ladder logic (chapter 4) and structured text.
• Online editing support for structured text and sequential function
chart logic.
• Updated CSV format now includes rung comments.
• New L5X format for partial import/export of ladder rungs, tags, and
trends.
Import/Export version 2.3 Version 2.3, major revision 2, minor revision 3, of the import/export feature
included with Logix Designer, version 12.01 includes these major
Logix Designer version 12
enhancements:
• The structured text component changed from STX_ROUTINE
to ST_ROUTINE. The LanguageType attribute in SFC routines for
embedded structured text also changed from STX to ST.
• Support for new controllers.
• Addition of the ControlNetSignature attribute to the MODULE
component.
• Addition of the ProgrammaticallySendEventTrigger attribute to the
TAG component.
• New COORDINATE_SYSTEM tag.
• Addition of several new attributes to the axis tag types.
• Addition of DisableFlag attribute to the PROGRAM component.
• Addition of EventTrigger and EventTag attributes to the TASK
component to support Event tasks.
• New EVENT, IOT, MCCD, MCCM, MCLM, MCS™, MCSD, and MCSR
instructions in ladder logic and structured text.
• Addition of information regarding the LOGIC block when exporting
online function block logic.
• Addition of new modules and their valid CommMethod and
ConfigMethod values.
Import/Export version 2.2 Version 2.2, major revision 2, minor revision 2, of the import/export feature
included with Logix Designer, version 11.10 includes these major
Logix Designer version 11
enhancements:
• Support for the 1756-L63 controller.
• New controller attributes to support sequential function charts.
• Corrected the DATATYPE attributes and added the FamilyType
attribute.
Import/Export version 2.1 Version 2.1, major revision 2, minor revision 1, of the import/export feature
included with Logix Designer, version 10.0 includes these major
Logix Designer version 10 enhancements:
• Removal of the characters when specifying a controller type.
• Addition of the SecurityCode attribute to the Controller object.
• Enhancements to the Message tag structure. See page 264 on page 262.
• The Program object now includes a Mode attribute.
• Correction to valid values for Watchdog and Rate attributes of the
Task object.
• Addition of MaxStationAddress and TokenHoldFactor attributes to the
Config DF1 object.
• Addition of new instructions: SIZE, SWPB, LOWER, and UPPER.
• The NumberOfAppendChars of the Config ASCII object is no longer
exported. If you have an import/export file with any of these attributes,
the file will correctly import into the software. This attributes will be
removed when you export the file.
Changes to support Version 2.1 (major revision 2, minor revision 1) of the import/export feature
MESSAGE tag enhancements that is included with Logix Designer 2 programming software, version 10.0
made 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)
Attribute Description
Description Provide information about the tag.
Specify Description := "text"
Import/Export version 2.0 Version 2.0 (major revision 2, minor revision 0) of the import/export feature
included with Logix Designer, version 9.0 includes these major
Logix Designer version 9 enhancements:
• Replaced the AXIS tag with AXIS_CONSUMED, AXIS_SERVO,
AXIS_SERVO_DRIVE, and AXIS_VIRTUAL tags.
Motion changes to support Version 2.0, major revision 2, minor revision 0, of the import/export feature
included with Logix Designer, version 9.0 includes significant changes to
the SERCOS Protocol motion-related tags to support the SERCOS protocol.
• CoarseUpdatePeriod and AutoTagUpdate parameters were added to
the MOTION_GROUP tag to support SERCOS. For reference, the
previous structure is described on page 267 on page 264.
• Earlier versions of the import/export feature supported one AXIS tag.
To support SERCOS, the import/export feature replaced AXIS with
four axis tags: AXIS_CONSUMED, AXIS_SERVO,
AXIS_SERVO_DRIVE, and AXIS_VIRTUAL. The previous AXIS tag is
incorporated into these new tags, but no longer exists as its own tag.
For reference, the AXIS structure is described on page 267 on page 265.
If you have a version 8.0 import/export file with AXIS tags that you
import into version 9.0 software, after changing the import/export
version line to 2.0), the AXIS tags convert to:
If the AXIS type is: It Converts to:
Unused AXIS_SERVO
Position only AXIS_SERVO
Servo AXIS_SERVO
Consumed AXIS_CONSUMED
Virtual AXIS_VIRTUAL
MOTION_GROUP tag
structure (version 1.1)
Attribute Description
Description Provide information about the tag.
Specify Description := "text"
Comment Provide information about a tag component.
Specify Comment<specifier> := "text"
Where the specifier is:
.bitnumberfor a bit in the tag
[element]for an array element of the tag
.membernamefor a structure member of the tag
GroupType Specify the type of motion group, such as Independent.
Specify GroupType := text
AXIS tag structure See the table for AXIS tag attributes (version 1.1).
(version 1.1)
Attribute Description
Description Provide information about the tag.
Specify Description := "text"
Comment Provide information about a tag component.
Specify Comment<specifier> := "text"
Where the specifier is:
.bitnumberfor a bit in the tag
[element]for an array element of the tag
.membernamefor a structure member of the tag
MotionGroup Type the name of the associated motion group, or type NA.
Specify MotionGroup := text
MotionModule Type the name of the associated motion module, or type NA.
Specify MotionModule := text
AxisState Type Axis-Ready, Direct Drive Control, Servo Control, Axis Faulted, or Axis Shutdown.
Specify AxisState := text
PositionUnits Specify the type of units.
Specify PositionUnits := text
TimeUnits Type Seconds or Minutes.
Specify TimeUnits := text
InstructionSpeedUnits Type Percentage or Engineering Units.
Specify InstructionSpeedUnits := text
InstructionAccelDecelUnits Type Percentage or Engineering Units.
Specify InstructionAccelDecelUnits := text
InstructionMoveProfile Type Trapezoidal or S-Curve.
Specify InstructionMoveProfile := text
InstructionJogProfile Specify Trapezoidal or S-Curve.
Specify InstructionJogProfile := text
ConversionConstant Specify the conversion constant. Type a real number from 1.0...1.0e9.
Specify ConversionConstant := value
HomeMode Type Passive or Active.
Specify HomeMode := text
HomeSequenceType Type Immediate Home, Home To Switch, Home To Marker Only, or Home To Switch With Marker.
Specify HomeSequenceType := text
HomePosition Specify the home position (any positive number).
Specify HomePosition := value
Import/Export version 1.1 Version 1.1, major revision 1, minor revision 1, of the import/export feature
included with Logix Designer, version 8.0 includes these major
Logix Designer version 8 enhancements:
• Function block instructions and routines.
• ASCII instructions.
• Verification of all instruction attributes and parameters.
H L5K structure
action 195
history, import/export feature 255 Add-On Instruction 82
Add-On Instruction in FBD 175
I alarm analog tag 105
alarm digital tag 107
icon
analog alarm message 109
attributes 173
attachment 179
guidelines 173
axis tag 111
L5K structure 173
block 173
L5X structure 172
branch 159
importing
child programs 150
comments 28 condition 196
complete project 22, 25 config objects 237
CSV format 28 controller 48
L5K format 22 coordinate system tag 123
L5X format 25 datatype 61
project 22, 25 datatype member 62
tags 28 directed link 198
text boxes 28 encoded data 91
TXT format 28 function block diagram routine 167
initial values 127 icon 173
Add-On Instruction 127 iref 172
L5K structure 127 jsr 176
L5X structure 127 ladder logic routine 157
instructions limithigh 194
function block diagram 183 limitlow 194
ladder logic 161 local tag 90
structured text 213 message tag 110
internal file comments 43 module 67
iref module connection 72
attributes 172 motion group tag 125
guidelines 172 ocon 173
L5K structure 172 oref 172
L5X structure 172 parameter 85, 88
parameter connections 225
J pen 232
preset 194
jsr
program 147
attributes 176 quick watch list 235
guidelines 176 ret 177
L5K structure 176 rung 158
L5X structure 176 rung branch 159
safety tag 126
L sbr 177
L5K sbrret 197
exporting 21 sequential function chart routine 189
file conventions 43 sheet 169
file structure 42 source-protected Add-On Instruction 91
importing 22 source-protected routine 91
internal file comments 43 step 193
objects 237 Q
ocon
quick watch list
attributes 173
guidelines 173 attributes 235
L5K structure 173 component 235
L5X structure 172 L5K example 235
L5K structure 235
online edits 170, 191, 211
L5X example 235
oref
U
Unicode TXT format 245
W
watch list 235
watch tag 235
wire
attributes 178
guidelines 178
L5K structure 178
L5X structure 178
X
XML file 24
Literature Library Find installation instructions, manuals, brochures, and technical data publications. rok.auto/literature
Product Compatibility and Download Center Get help determining how products interact, check features and capabilities, and rok.auto/pcdc
(PCDC) find associated firmware.
Documentation feedback
Your comments help us serve your documentation needs better. If you have any suggestions on how to improve our content, complete the form at
rok.auto/docfeedback.
Rockwell Automation maintains current product environmental information on its website at rok.auto/pec.
Allen-Bradley, expanding human possibility, Logix, Rockwell Automation, and Rockwell Software are trademarks of Rockwell Automation, Inc.
Trademarks not belonging to Rockwell Automation are property of their respective companies.
Rockwell Otomayson Ticaret A.Ş. Kar Plaza İş Merkezi E Blok Kat:6 34752, İçerenkÖy, İstanbul, Tel: +90 (216) 5698400 EEE YÖnetmeliğine Uygundur