Rockwell Automation Logix 5000 Programming Manual
Programming Manual
Original Instructions
Logix 5000 Controllers Program Parameters
1756 ControlLogix, 1756 GuardLogix, 1769 CompactLogix,
1769 Compact GuardLogix, 1789 SoftLogix, 5069
CompactLogix, 5069 Compact GuardLogix, Studio 5000
Logix Emulate
Logix 5000 Controllers Program Parameters
personal injury or death, property damage, or economic loss.
Attentions help you identify a hazard, avoid a hazard, and recognize the consequence.
IMPORTANT
SHOCK HAZARD: Labels may be on or inside the equipment, for example, a drive or motor, to alert people that dangerous voltage may be present.
temperatures.
for Personal Protective Equipment (PPE).
Important User Information
Read this document and the documents listed in the additional resources section about installation, configuration, and
operation of this equipment before you install, configure, operate, or maintain this product. Users are required to familiarize
themselves with installation and wiring instructions in addition to requirements of all applicable codes, laws, and standards.
Activities including installation, adjustments, putting into service, use, assembly, disassembly, and maintenance are required to
be carried out by suitably trained personnel in accordance with applicable code of practice.
If this equipment is used in a manner not specified by the manufacturer, the protection provided by the equipment may be
impaired.
In no event will Rockwell Automation, Inc. be responsible or liable for indirect or consequential damages resulting from the use
or application of this equipment.
The examples and diagrams in this manual are included solely for illustrative purposes. Because of the many variables and
requirements associated with any particular installation, Rockwell Automation, Inc. cannot assume responsibility or liability for
actual use based on the examples and diagrams.
No patent liability is assumed by Rockwell Automation, Inc. with respect to use of information, circuits, equipment, or software
described in this manual.
Reproduction of the contents of this manual, in whole or in part, without written permission of Rockwell Automation, Inc., is
prohibited.
Throughout this manual, when necessary, we use notes to make you aware of safety considerations.
WARNING: Identifies information about practices or circumstances that can cause an explosion in a hazardous environment, which may lead to
ATTENTION: Identifies information about practices or circumstances that can lead to personal injury or death, property damage, or economic loss.
Identifies information that is critical for successful application and understanding of the product.
Labels may also be on or inside the equipment to provide specific precautions.
BURN HAZARD: Labels may be on or inside the equipment, for example, a drive or motor, to alert people that surfaces may reach dangerous
ARC FLASH HAZARD:
will cause severe injury or death. Wear proper Personal Protective Equipment (PPE). Follow ALL Regulatory requirements for safe work practices and
Labels may be on or inside the equipment, for example, a motor control center, to alert people to potential Arc Flash. Arc Flash
2 Rockwell Automation Publication 1756-PM021D-EN-P - September 2020
Change
Topic
Updated branding.
Throughout
Summary of changes
This manual includes new and updated information. Use these reference tables to locate changed information.
Grammatical and editorial style changes are not included in this summary.
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.
Updated Legal notices. Legal notices on page 9
New or enhanced features
None in this version.
Rockwell Automation Publication 1756-PM021D-EN-P - September 2020 3
Summary of changes
Connecting program
Directly accessing
program parameters
Table of Contents
Preface
parameters
Studio 5000 environment .......................................................................... 7
Additional resources ................................................................................... 7
Important terminology .............................................................................. 8
Legal notices ................................................................................................ 9
Chapter 1
Introduction ............................................................................................... 11
Program parameters .................................................................................. 11
Program parameter connection methods .......................................... 11
Program parameter connection syntax.............................................. 14
User-defined type sub-element connection considerations............. 14
Input parameters ....................................................................................... 15
Input parameter connection types and uses ..................................... 15
General rules for using Input parameters ......................................... 15
Connect an Input parameter to a controller scope tag ..................... 15
Output parameters ..................................................................................... 17
Output parameter connection types and uses ................................... 18
General rules for using Output parameters ....................................... 18
Connect an Output parameter to a controller scope tag ................... 18
Connect an Output parameter to another program.......................... 19
InOut parameters ....................................................................................... 21
InOut parameter connection types and uses ..................................... 21
General rules for using InOut parameters ........................................ 22
Connect an InOut parameter to a controller scope tag.................... 22
Public parameters.......................................................................................23
Public parameter connection types and uses ....................................23
General rules for using Public parameters ....................................... 24
Connect a Public parameter to another program ............................. 24
Safety program parameters ...................................................................... 26
General rules for connecting parameters for safety programs ....... 26
Program parameter connection rules...................................................... 26
Standard program to standard program connection rules ............. 27
Safety program to safety program connection rules ........................ 27
Safety program to standard program connection rules .................. 28
Rockwell Automation Publication 1756-PM021D-EN-P - September 2020 5
Chapter 2
Introduction .............................................................................................. 29
Direct access .............................................................................................. 29
Behavior of direct access in logic ....................................................... 29
Access program parameters when editing ladder logic ................... 29
Table of Contents
Index
6 Rockwell Automation Publication 1756-PM021D-EN-P - September 2020
Resource
Description
Product Certifications webpage, available
Provides declarations of conformity, certificates,
Studio 5000 environment
Additional resources
Preface
This manual shows how to create and configure program parameters. This manual is one of a
set of related manuals that show common procedures for programming and operating Logix
5000 controllers.
For a complete list of common procedures manuals, refer to the
Logix 5000 Controllers
Common Procedures Programming Manual, publication 1756-PM001.
The term Logix 5000 controller refers to any controller based on the Logix 5000 operating
system.
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.
Rockwell Automation Publication 1756-PM021D-EN-P - September 2020 7
The Studio 5000® environment is the foundation for the future of Rockwell Automation®
engineering design tools and capabilities. The Studio 5000 environment is the one place for
design engineers to develop all elements of their control system.
These documents contain additional information concerning related Rockwell Automation
products.
Industrial Automation Wiring and Grounding
Guidelines, publication 1770-4.1
at http://ab.rockwellautomation.com
Provides general guidelines for installing a Rockwell
Automation industrial system.
and other certification details.
View or download publications at http://www.rockwellautomation.com/literature. To order
paper copies of technical documentation, contact the local Rockwell Automation distributor
or sales representative.
Preface
Term
Definition
structure, this behavior may be necessary.
change the value during execution of a program.
not change from external code or HMI interaction.
Important terminology
This table defines the terms that are important to understanding the concepts described in
this manual.
Argument An argument is assigned to a parameter and contains
the specification of the data used by an instruction in a
user program. An argument can contain the following:
• A simple tag (for example, L101)
• A literal value (for example, 5)
• A tag structure reference (for example,
Recipe.Temperature)
• A direct array reference (for example, Buffer[1])
• An indirect array reference (for example,
Buffer[Index+1])
•
A combination (for example, Buffer[Index+1].Delay)
InOut parameter An InOut parameter is a special usage program
parameter that represents a reference to data that can
be used both as input and output during the execution
of a program. Because InOut parameters pass by
reference rather than by value, they are merely a pointer
to the original data and closely resemble the behavior of
an alias tag. With that in mind, it is possible that the
InOut parameter values could change during the
execution of a program. Depending on your task
Input parameter An Input parameter is a parameter that defines the data
that is passed by value into an executing program. Since
Input parameters are passed by value, their values
cannot change from external sources during the
execution of the program. An Input parameter supports
a maximum of one sourcing connection.
Output parameter
An Output parameter is a parameter that
defines the data that is produced as a direct
result of executing a program. Since Output
parameters are always passed by value, their
values only change at the end of the scan of a
program when the copy of the parameters has
executed.
Tip: If using direct access another program
can be a source for an Output parameter.
Passed by reference When an argument is passed to a parameter by
reference, the logic directly reads or writes the value
that the tag uses in controller memory. External code or
HMI interaction that changes the argument’s value can
Passed by value When an argument is passed to a parameter by value,
the value is copied in or out of the parameter during
execution of a program. The value of the argument does
8 Rockwell Automation Publication 1756-PM021D-EN-P - September 2020
Legal notices
Public parameter A Public parameter is an encapsulated version of a
controller scope tag, and typically it is used for large
data structures that need to be shared among programs.
Preface
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.
End User License Agreement (EULA)
You can view the Rockwell Automation End User License Agreement (EULA) by opening the
license.rtf file located in your product's install folder on your hard drive.
The default location of this file is:
C:\Program Files (x86)\Common Files\Rockwell\license.rtf.
Open Source Software Licenses
The software included in this product contains copyrighted software that is licensed under
one or more open source licenses.
You can view a full list of all open source software used in this product and their
corresponding licenses by opening the oss_license.txt file located your product's
OPENSOURCE folder on your hard drive. This file is divided into these sections:
• Components
Includes the name of the open source component, its version number,
and the type of license.
• Copyright Text
Includes the name of the open source component, its version number,
and the copyright declaration.
• Licenses
Includes the name of the license, the list of open source components
citing the license, and the terms of the license.
The default location of this file is:
C:\Program Files (x86)\Common Files\Rockwell\Help\<product
name>\Release Notes\OPENSOURCE\oss_licenses.txt.
Rockwell Automation Publication 1756-PM021D-EN-P - September 2020 9
You may obtain Corresponding Source code for open source packages included in this
product from their respective project web site(s). Alternatively, you may obtain complete
Corresponding Source code by contacting Rockwell Automation via the Contact form on the
Rockwell Automation website:
http://www.rockwellautomation.com/global/about-
us/contact/contact.page. Please include "Open Source" as part of the request text.
Preface
10 Rockwell Automation Publication 1756-PM021D-EN-P - September 2020
Loading...