Allen-Bradley ControlLogix Ethernet Driver
Allen-Bradley ControlLogix Ethernet Driver
Allen-Bradley ControlLogix Ethernet Driver
Driver
Table of Contents
Allen-Bradley ControlLogix Ethernet Driver 1
Table of Contents 2
Overview 12
Setup 14
Channel Setup 16
Channel Properties - General 16
Channel Properties - Ethernet Communications 17
Channel Properties - Write Optimizations 17
Channel Properties - Advanced 18
Device Setup 20
Device Properties - Identification 20
Device Properties - Operating Mode 20
Device Properties - Scan Mode 21
Device Properties - Timing 22
Device Properties - Auto-Demotion 23
Device Properties - Tag Generation 24
Device Properties - Logix Communications Parameters 25
Device Properties - Logix Options 26
Device Properties - Logix Database Settings 28
Device Properties - ENI DF1/DH+/CN Gateway Communications Parameters 29
Block Writes 30
Device Properties - SLC 500 Slot Configuration 31
Device Properties - Redundancy 32
SLC 500 Modular I/O Selection Guide 32
Performance Optimizations 35
Optimizing Communications 35
Address Descriptions 53
Logix Addressing 54
MicroLogix Addressing 55
www. ptc.com
3 Allen-Bradley ControlLogix Ethernet Driver
File Listing 82
Output Files 83
Input Files 86
Status Files 90
Binary Files 91
Timer Files 91
Counter Files 92
Control Files 93
Integer Files 94
Float Files 95
ASCII Files 95
String Files 96
BCD Files 97
Long Files 97
MicroLogix PID Files 98
PID Files 99
MicroLogix Message Files 101
Message Files 102
Block Transfer Files 103
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 4
www. ptc.com
5 Allen-Bradley ControlLogix Ethernet Driver
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 6
Unable to read block. | Block size = <number> (elements), Block start address = '<address>', CIP
error = <code>, Extended error = <code>. 127
Unable to read block. | Block size = <number> (bytes), Tag name = '<tag>', CIP error = <code>,
Extended error = <code>. 128
Unable to write to tag. Controller tag data type unknown. | Tag address = '<address>', Data type
= <type>. 128
Unable to read tag. Controller tag data type unknown. Tag deactivated. | Tag address =
'<address>', Data type = <type>. 128
Unable to read block. Controller tag data type unknown. Block deactivated. | Block size =
<number> (elements), Block start address = '<address>', Data type = <type>. 128
Unable to write to tag. Data type not supported. | Tag address = '<address>', Data type =
'<type>'. 129
Unable to read tag. Data type not supported. Tag deactivated. | Tag address = '<address>', Data
type = '<type>'. 129
Unable to read block. Data type not supported. Block deactivated. | Block size = <number>
(elements), Block start address = '<address>', Data type = '<type>'. 129
Unable to write to tag. Data type is illegal for this tag. | Tag address = '<address>', Data type =
'<type>'. 130
Unable to read tag. Data type is illegal for this tag. Tag deactivated | Tag address = '<address>',
Data type = '<type>'. 130
Unable to read block. Data type is illegal for this block. Block deactivated. | Block size =
<number> (elements), Block start address = '<address>', Data type = '<type>'. 130
Unable to write to tag. Tag does not support multi-element arrays. | Tag address = '<address>'. 131
Unable to read tag. Tag does not support multi-element arrays. Tag deactivated. | Tag address
= '<address>'. 131
Unable to read block. Block does not support multi-element arrays. Block deactivated. | Block
size = <number> (elements), Block start address = '<address>'. 131
Unable to write to tag. Native tag size mismatch. | Tag address = '<address>'. 132
Unable to read tag. Native tag size mismatch. | Tag address = '<address>'. 132
Unable to read block. Native tag size mismatch. | Block size = <number> (elements), Block start
address = '<address>'. 132
Unable to read block. Native tag size mismatch. | Block size = <number> (bytes), Block name =
'<name>'. 133
Unable to write to tag. | Tag address = '<address>'. 133
Unable to read tag. Tag deactivated. | Tag address = '<address>'. 133
Unable to read block. Block deactivated. | Block size = <number> (elements), Block start
address = '<address>'. 134
Unable to read block. Block deactivated. | Block size = <number> (bytes), Tag name = '<tag>'. 134
Error occurred during a request to device. | CIP error = <code>, Extended error = <code>. 135
Encapsulation error occurred during a request to device. | Encapsulation error = <code>. 135
Memory could not be allocated for tag. | Tag address = '<address>'. 135
Unable to read block. Frame received contains errors. | Block size = <number> (elements),
Starting address = '<address>'. 136
www. ptc.com
7 Allen-Bradley ControlLogix Ethernet Driver
Unable to read function file from device. Frame received contains errors. | Function file =
'<name>'. 136
Unable to read block. Tag(s) deactivated. | Block size = <number> (elements), Starting address
= '<address>', DF1 status = <code>, Extended status = <code>. 136
Unable to read function file from device. Tag(s) deactivated. | Function file = '<name>', DF1
status = <code>, Extended status = <code>. 137
Unable to write to address. Frame received contains errors. | Address = '<address>'. 137
Unable to write to function file. Frame received contains errors. | Function file = '<name>'. 137
Unable to read block. | Block size = <number> (elements), Starting address = '<address>', DF1
status = <code>, Extended status = <code>. 137
Unable to read function file. | Function file = '<name>', DF1 status = <code>, Extended status =
<code>. 138
Unable to read block. Tag(s) deactivated. | Block size = <number> (elements), Starting address
= '<address>', DF1 status = <code>, Extended status = <code>. 138
Unable to read function file. Tag(s) deactivated. | Function file = '<name>', DF1 status = <code>. 139
Unable to write to address. | Address = '<address>', DF1 status = <code>, Extended status =
<code>. 139
Unable to write to function file. | Function file = '<name>', DF1 status = <code>, Extended status
= <code>. 140
Unable to read block. | Block size = <number> (elements), Starting address = '<address>', DF1
status = <code>. 140
Unable to read function file. | Function file = '<name>', DF1 status = <code>. 141
Unable to write to address. | Address = '<address>', DF1 status = <code>. 141
Unable to write to function file. | Function file = '<name>', DF1 status = <code>. 141
Unable to read tag. Internal memory is invalid. | Tag address = '<address>'. 142
Unable to read tag. Data type is illegal for this tag. | Tag address = '<address>', Data type =
'<type>'. 142
Unable to read block. Internal memory is invalid. Tag deactivated. | Tag address = '<address>'. 142
Unable to read block. Internal memory is invalid. Block deactivated. | Block size = <number>
(elements), Block start address = '<address>'. 143
Unable to write to address. Internal memory is invalid. | Tag address = '<address>'. 143
Unable to read block. Block deactivated. | Block size = <number> (elements), Block start
address = '<address>', CIP error = <code>, Extended error = <code>. 143
Device not responding. Local node responded with error. | DF1 status = <code>. 143
Unable to write to function file. Local node responded with error. | Function file = '<name>', DF1
status = <code>. 143
Unable to write to address. Local node responded with error. | Function file = '<name>', DF1
status = <code>. 144
Unexpected offset encountered for tag. Tag will use Symbolic protocol. | Tag address =
'<address>'. 144
Unexpected offset encountered for tag. | Tag address = '<address>'. 144
Unexpected offset/span encountered for tag. | Tag address = '<address>'. 144
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 8
www. ptc.com
9 Allen-Bradley ControlLogix Ethernet Driver
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 10
Glossary 171
Index 173
www. ptc.com
11 Allen-Bradley ControlLogix Ethernet Driver
CONTENTS
Overview
What is the Allen-Bradley ControlLogix Ethernet Driver?
Device Setup
How do I configure a device for use with this driver?
Communications Routing
How do I communicate with a remote ControlLogix 5000 processor or 1756-DHRIO/1756-CNB Interface
Module?
Performance Optimizations
How do I get the best performance from the Allen-Bradley ControlLogix Ethernet Driver?
Address Descriptions
How do I address a tag on a Allen-Bradley ControlLogix Ethernet device?
Error Codes
What are the Allen-Bradley ControlLogix Ethernet error codes?
Reference Material
Where can I find additional information relating to the Allen-Bradley ControlLogix Ethernet Driver?
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 12
Overview
The Allen-Bradley ControlLogix Ethernet Driver provides an easy and reliable way to connect Allen-Bradley
ControlLogix Ethernet controllers to OPC client applications, including HMI, SCADA, Historian, MES, ERP, and
countless custom applications.
SoftLogix 5800
The driver supports the Allen-Bradley SoftLogix 5800 Series Controller and requires an Ethernet card in the
SoftLogix PC.
ControlNet Gateway
The driver supports the PLC-5C Series. This is accomplished through a ControlNet gateway and requires the
aforementioned PLC, an EtherNet/IP communication module, and a 1756-CNB/CNBR interface module (both
residing in the ControlLogix rack).
1761-NET-ENI
The driver supports communications with the 1761-NET-ENI device. The ENI device adds extra flexibility in
device networking and communications by providing an Ethernet-to-serial interface for both Full Duplex DF1
controllers and Logix controllers. In conjunction with the ENI device, this driver supports the following:
www. ptc.com
13 Allen-Bradley ControlLogix Ethernet Driver
MicroLogix 1100
The driver supports communications with the MicroLogix 1100 (CH1 Ethernet) using EtherNet/IP.
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 14
Setup
Supported Devices
Device Family Communications
Via 1756-ENBT / ENET / EN2F / EN2T / EN2TR /
EN3TR / EWEB / EN2TXT Ethernet module
ControlLogix 5550 / 5553 / 5555 / 5561 / 5562 /
5563 / 5564 / 5565 / 5571 / 5572 / 5573 / 5574 / Via Serial Gateway
5575 / 5580 processors
Via 1761-NET-ENI Series B or higher using Channel
0 (serial)
Built-in Ethernet/IP port on processors with E
suffix*
www. ptc.com
15 Allen-Bradley ControlLogix Ethernet Driver
Via 1761-NET-ENI
Firmware Versions
Device Family Version
ControlLogix 5550 (1756-L1) 11.35 - 13.34
ControlLogix 5553 (1756-L53) 11.28
ControlLogix 5555 (1756-L55) 11.32 - 16.04
ControlLogix 5561 (1756-L61) 12.31 - 20.11
ControlLogix 5562 (1756-L62) 12.31 - 20.11
ControlLogix 5563 (1756-L63) 11.26 - 20.11
ControlLogix 5564 (1756-L64) 16.03 - 20.11
ControlLogix 5565 (1756-L65) 16.03 - 20.11
ControlLogix 5571 (1756-L71) 20.11 - 30.11
ControlLogix 5572 (1756-L72) 19.11 - 30.11
ControlLogix 5573 (1756-L73) 18.12 - 30.11
ControlLogix 5574 (1756-L74) 19.11 - 30.011
ControlLogix 5575 (1756-L75) 18.12 - 30.11
ControlLogix 5580 (1756-L8) 28.011 - 30.11
CompactLogix 5370 (1769-L1) 20.11 - 30.11
CompactLogix 5370 (1769-L2) 20.11 - 30.11
CompactLogix 5370 (1769-L3) 20.11 - 30.11
CompactLogix 5320 (1769-L20) 11.27 - 13.18
CompactLogix 5323 (1769-L23) 17.05 - 20.11
CompactLogix 5330 (1769-L30) 11.27 - 13.18
CompactLogix 5331 (1769-L31) 16.22 - 20.11
CompactLogix 5332 (1769-L32) 16.22 - 20.11
CompactLogix 5335 (1769-L35) 16.22 - 20.11
CompactLogix 5343 (1768-L43) 15.07 - 20.11
CompactLogix 5345 (1768-L45) 16.24 - 20.11
CompactLogix 5380 (5069-L3) 28.011 - 30.11
FlexLogix 5433 (1794-L33) 11.25 - 13.33
FlexLogix 5434 (1794-L34) 11.25 - 16.02
SoftLogix 5800 (1789-L60) 16.00 - 20.01
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 16
Communication Protocol
The Communications Protocol is EtherNet/IP (CIP over Ethernet) using TCP/IP.
l Connected Messaging
l Symbolic Reads
l Symbolic Writes
l Symbol Instance Reads (V21 or higher)
l Physical (DMA) Reads (V20 or lower)
l Symbol Instance Writes
ENI Models
ENImodels support unconnected messaging.
See Also:
Channel Setup
Device Setup
Channel Setup
The maximum number of channels supported is 1024.
www. ptc.com
17 Allen-Bradley ControlLogix Ethernet Driver
Identification
Name:User-defined identity of this channel. In each server project, each channel name must be unique.
Although names can be up to 256 characters, some client applications have a limited display window when
browsing the OPCserver's tag space. The channel name is part of the OPC browser information.
For information on reserved characters, refer to "How To... Properly Name a Channel, Device, Tag, and Tag
Group" in the server help.
Driver:Selected protocol / driver for this channel. This property specifies the device driver that was selected
during channel creation. It is a disabled setting in the channel properties.
Note: With the server's online full-time operation, these properties can be changed at any time. This
includes changing the channel name to prevent clients from registering data with the server. If a client has
already acquired an item from the server before the channel name is changed, the items are unaffected. If,
after the channel name has been changed, the client application releases the item and attempts to re-
acquire using the old channel name, the item is not accepted. With this in mind, changes to the properties
should not be made once a large client application has been developed. Utilize the User Manager to prevent
operators from changing properties and restrict access rights to server features.
Diagnostics
Diagnostics Capture: When enabled, this option makes the channel's diagnostic information available to
OPC applications. Because the server's diagnostic features require a minimal amount of overhead
processing, it is recommended that they be utilized when needed and disabled when not. The default is
disabled.
Note:This property is disabled if the driver does not support diagnostics.
For more information, refer to "Communication Diagnostics" in the server help.
Ethernet Settings
Network Adapter:Specify the network adapter to bind. When Default is selected, the operating system
selects the default adapter.
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 18
this goal, the server provides optimization properties that can be used to meet specific needs or improve
application responsiveness.
Write Optimizations
OptimizationMethod: controls how write data is passed to the underlying communications driver. The
options are:
l Write All Values for All Tags:This option forces the server to attempt to write every value to the
controller. In this mode, the server continues to gather write requests and add them to the server's
internal write queue. The server processes the write queue and attempts to empty it by writing data
to the device as quickly as possible. This mode ensures that everything written from the client
applications is sent to the target device. This mode should be selected if the write operation order or
the write item's content must uniquely be seen at the target device.
l Write Only Latest Value for Non-Boolean Tags: Many consecutive writes to the same value can
accumulate in the write queue due to the time required to actually send the data to the device. If the
server updates a write value that has already been placed in the write queue, far fewer writes are
needed to reach the same final output value. In this way, no extra writes accumulate in the server's
queue. When the user stops moving the slide switch, the value in the device is at the correct value at
virtually the same time. As the mode states, any value that is not a Boolean value is updated in the
server's internal write queue and sent to the device at the next possible opportunity. This can greatly
improve the application performance.
Note: This option does not attempt to optimize writes to Boolean values. It allows users to
optimize the operation of HMI data without causing problems with Boolean operations, such as a
momentary push button.
l Write Only Latest Value for All Tags:This option takes the theory behind the second optimization
mode and applies it to all tags. It is especially useful if the application only needs to send the latest
value to the device. This mode optimizes all writes by updating the tags currently in the write queue
before they are sent. This is the default mode.
Duty Cycle: is used to control the ratio of write to read operations. The ratio is always based on one read for
every one to ten writes. The duty cycle is set to ten by default, meaning that ten writes occur for each read
operation. Although the application is performing a large number of continuous writes, it must be ensured
that read data is still given time to process. A setting of one results in one read operation for every write
operation. If there are no write operations to perform, reads are processed continuously. This allows
optimization for applications with continuous writes versus a more balanced back and forth data flow.
Note: It is recommended that the application be characterized for compatibility with the write
optimization enhancements before being used in a production environment.
www. ptc.com
19 Allen-Bradley ControlLogix Ethernet Driver
Non-Normalized Float Handling: Non-normalized float handling allows users to specify how a driver
handles non-normalized IEEE-754 floating point data. A non-normalized value is defined as Infinity, Not-a-
Number (NaN), or as a Denormalized Number. The default is Replace with Zero. Drivers that have native
float handling may default to Unmodified. Descriptions of the options are as follows:
l Replace with Zero:This option allows a driver to replace non-normalized IEEE-754 floating point
values with zero before being transferred to clients.
l Unmodified:This option allows a driver to transfer IEEE-754 denormalized, normalized, non-
number, and infinity values to clients without any conversion or changes.
Note:This property is disabled if the driver does not support floating point values or if it only supports the
option that is displayed. According to the channel's float normalization setting, only real-time driver tags
(such as values and arrays) are subject to float normalization. For example, EFM data is not affected by this
setting.
For more information on the floating point values, refer to "How To ... Work with Non-Normalized Floating
Point Values" in the server help.
Inter-Device Delay: Specify the amount of time the communications channel waits to send new requests to
the next device after data is received from the current device on the same channel. Zero (0) disables the
delay.
Note:This property is not available for all drivers, models, and dependent settings.
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 20
Device Setup
Device setup includes configuration of the following property groups:
General - Identification
General - Operating Mode
Scan Mode
Timing
Auto Demotion
Tag Generation
Logix Communications Parameters
Logix Options
Logix Database Settings
ENI DF1/DH+/CN Gateway Communications Parameters
Redundancy
Channel Assignment:User-defined name of the channel to which this device currently belongs.
ID: Enter the unique network address of the device, typically in the format of <IP or hostname>,1, <routing
path>,<slot>.
The conventions for addressing vary by model and routing. For more information, refer to the model-specific
addressing topics under Reference Material.
www. ptc.com
21 Allen-Bradley ControlLogix Ethernet Driver
Data Collection:This property controls the device's active state. Although device communications are
enabled by default, this property can be used to disable a physical device. Communications are not
attempted when a device is disabled. From a client standpoint, the data is marked as invalid and write
operations are not accepted. This property can be changed at any time through this property or the device
system tags.
Simulated:This option places the device into Simulation Mode. In this mode, the driver does not attempt to
communicate with the physical device, but the server continues to return valid OPC data. Simulated stops
physical communications with the device, but allows OPC data to be returned to the OPC client as valid data.
While in Simulation Mode, the server treats all device data as reflective: whatever is written to the simulated
device is read back and each OPC item is treated individually. The item's memory map is based on the group
Update Rate. The data is not saved if the server removes the item (such as when the server is reinitialized).
The default is No.
Notes:
1. This System tag (_Simulated) is read only and cannot be written to for runtime protection. The System
tag allows this property to be monitored from the client.
2. In Simulation mode, the item's memory map is based on client update rate(s) (Group Update Rate for
OPC clients or Scan Rate for native and DDE interfaces). This means that two clients that reference
the same item with different update rates return different data.
Simulation Mode is for test and simulation purposes only. It should never be used in a production
environment.
Scan Mode: specifies how tags in the device are scanned for updates sent to subscribed clients.
Descriptions of the options are:
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 22
l Respect Client-Specified Scan Rate:This mode uses the scan rate requested by the client.
l Request Data No Faster than Scan Rate:This mode specifies the maximum scan rate to be used.
The valid range is 10 to 99999990 milliseconds. The default is 1000 milliseconds.
Note:When the server has an active client and items for the device and the scan rate value is
increased, the changes take effect immediately. When the scan rate value is decreased, the changes
do not take effect until all client applications have been disconnected.
l Request All Data at Scan Rate:This mode forces tags to be scanned at the specified rate for
subscribed clients. The valid range is 10 to 99999990 milliseconds. The default is 1000 milliseconds.
l Do Not Scan, Demand Poll Only:This mode does not periodically poll tags that belong to the
device nor perform a read to get an item's initial value once it becomes active. It is the client's
responsibility to poll for updates, either by writing to the _DemandPoll tag or by issuing explicit device
reads for individual items. For more information, refer to "Device Demand Poll" in server help.
l Respect Tag-Specified Scan Rate:This mode forces static tags to be scanned at the rate specified
in their static configuration tag properties. Dynamic tags are scanned at the client-specified scan
rate.
Initial Updates from Cache: When enabled, this option allows the server to provide the first updates for
newly activated tag references from stored (cached) data. Cache updates can only be provided when the
new item reference shares the same address, scan rate, data type, client access, and scaling properties. A
device read is used for the initial update for the first client reference only. The default is disabled; any time a
client activates a tag reference the server attempts to read the initial value from the device.
Communications Timeouts
Connect Timeout:This property (which is used primarily by Ethernet based drivers) controls the amount of
time required to establish a socket connection to a remote device. The device's connection time often takes
longer than normal communications requests to that same device. The valid range is 1 to 30 seconds. The
default is typically 3 seconds, but can vary depending on the driver's specific nature. If this setting is not
supported by the driver, it is disabled.
Note: Due to the nature of UDP connections, the connection timeout setting is not applicable when
communicating via UDP.
Request Timeout:This property specifies an interval used by all drivers to determine how long the driver
waits for a response from the target device to complete. The valid range is 50 to 9,999,999 milliseconds
(167.6667 minutes). The default is usually 1000 milliseconds, but can vary depending on the driver. The
www. ptc.com
23 Allen-Bradley ControlLogix Ethernet Driver
default timeout for most serial drivers is based on a baud rate of 9600 baud or better. When using a driver
at lower baud rates, increase the timeout to compensate for the increased time required to acquire data.
Retry Attempts:This property specifies how many times the driver retries a communications request
before considering the request to have failed and the device to be in error. The valid range is 1 to 10. The
default is typically 3, but can vary depending on the driver's specific nature. The number of retries
configured for an application depends largely on the communications environment.
Timing
Inter-Request Delay:This property specifies how long the driver waits before sending the next request to
the target device. It overrides the normal polling frequency of tags associated with the device, as well as
one-time reads and writes. This delay can be useful when dealing with devices with slow turnaround times
and in cases where network load is a concern. Configuring a delay for a device affects communications with
all other devices on the channel. It is recommended that users separate any device that requires an inter-
request delay to a separate channel if possible. Other communications properties (such as communication
serialization) can extend this delay. The valid range is 0 to 300,000 milliseconds; however, some drivers may
limit the maximum value due to a function of their particular design. The default is 0, which indicates no
delay between requests with the target device.
Note: Not all drivers support Inter-Request Delay. This setting does not appear if it is not available.
Demote on Failure: When enabled, the device is automatically taken off-scan until it is responding again.
Tip: Determine when a device is off-scan by monitoring its demoted state using the _AutoDemoted
system tag.
Timeouts to Demote: Specify how many successive cycles of request timeouts and retries occur before the
device is placed off-scan. The valid range is 1 to 30 successive failures. The default is 3.
Demotion Period: Indicate how long the device should be placed off-scan when the timeouts value is
reached. During this period, no read requests are sent to the device and all data associated with the read
requests are set to bad quality. When this period expires, the driver places the device on-scan and allows for
another attempt at communications. The valid range is 100 to 3600000 milliseconds. The default is 10000
milliseconds.
Discard Requests when Demoted: Select whether or not write requests should be attempted during the
off-scan period. Disable to always send write requests regardless of the demotion period. Enable to discard
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 24
writes; the server automatically fails any write request received from a client and does not post a message
to the Event Log.
If the target device supports its own local tag database, the driver reads the device's tag information and
uses the data to generate tags within the server. If the device does not natively support named tags, the
driver creates a list of tags based on driver-specific information. An example of these two conditions is as
follows:
1. If a data acquisition system supports its own local tag database, the communications driver uses the
tag names found in the device to build the server's tags.
2. If an Ethernet I/O system supports detection of its own available I/O module types, the
communications driver automatically generates tags in the server that are based on the types of I/O
modules plugged into the Ethernet I/O rack.
Note: Automatic tag database generation's mode of operation is completely configurable. For more
information, refer to the property descriptions below.
On Device Startup
This property specifies when OPC tags are automatically generated. Descriptions of the options are as
follows:
l Do Not Generate on Startup:This option prevents the driver from adding any OPC tags to the tag
space of the server. This is the default setting.
l Always Generate on Startup:This option causes the driver to evaluate the device for tag
information. It also adds tags to the tag space of the server every time the server is launched.
l Generate on First Startup:This option causes the driver to evaluate the target device for tag
information the first time the project is run. It also adds any OPC tags to the server tag space as
needed.
Note: When the option to automatically generate OPC tags is selected, any tags that are added to the
server's tag space must be saved with the project. Users can configure the project to automatically save
from the Tools | Options menu.
On Duplicate Tag
When automatic tag database generation is enabled, the server needs to know what to do with the tags that
it may have previously added or with tags that have been added or modified after the communications
driver since their original creation. This setting controls how the server handles OPC tags that were
www. ptc.com
25 Allen-Bradley ControlLogix Ethernet Driver
automatically generated and currently exist in the project. It also prevents automatically generated tags
from accumulating in the server.
For example, if a user changes the I/O modules in the rack with the server configured to Always Generate
on Startup, new tags would be added to the server every time the communications driver detected a new
I/O module. If the old tags were not removed, many unused tags could accumulate in the server's tag space.
The options are:
l Delete on Create:This option deletes any tags that were previously added to the tag space before
any new tags are added. This is the default setting.
l Overwrite as Necessary:This option instructs the server to only remove the tags that the
communications driver is replacing with new tags. Any tags that are not being overwritten remain in
the server's tag space.
l Do not Overwrite:This option prevents the server from removing any tags that were previously
generated or already existed in the server. The communications driver can only add tags that are
completely new.
l Do not Overwrite, Log Error:This option has the same effect as the prior option, and also posts an
error message to the server's Event Log when a tag overwrite would have occurred.
Note: Removing OPC tags affects tags that have been automatically generated by the
communications driver as well as any tags that have been added using names that match generated
tags. Users should avoid adding tags to the server using names that may match tags that are
automatically generated by the driver.
Parent Group:This property keeps automatically generated tags from mixing with tags that have been
entered manually by specifying a group to be used for automatically generated tags. The name of the group
can be up to 256 characters. This parent group provides a root branch to which all automatically generated
tags are added.
Allow Automatically Generated Subgroups:This property controls whether the server automatically
creates subgroups for the automatically generated tags. This is the default setting. If disabled, the server
generates the device's tags in a flat list without any grouping. In the server project, the resulting tags are
named with the address value. For example, the tag names are not retained during the generation process.
Note: If, as the server is generating tags, a tag is assigned the same name as an existing tag, the system
automatically increments to the next highest number so that the tag name is not duplicated. For example, if
the generation process creates a tag named "AI22" that already exists, it creates the tag as "AI23" instead.
Create: Initiates the creation of automatically generated OPC tags. If the device's configuration has been
modified, Create tags forces the driver to reevaluate the device for possible tag changes. Its ability to be
accessed from the System tags allows a client application to initiate tag database creation.
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 26
EtherNet/IP
TCP/IP Port: Specifies the TCP/IP port number that the device is configured to use. The default is 44818.
CIP
Connection Size: Specify the number of bytes available on the CIP connection for data requests and
responses. The valid range is 500 to 4000 bytes. The default is 500 bytes.
Note: Only the ControlLogix 5500 and CompactLogix 5300 device models support this feature. To support
connection sizes greater than 500 bytes, the device must support Firmware version 20 or later controllers
and Ethernet bridge EN3x, EN2x, or EN5.x. Older Ethernet modules like ENBT and ENET do not support this
feature. Devices that do not meet the necessary requirements automatically fall back to the default setting
of 500 bytes, although the requested size is re-attempted after communications failure.
The Connection Size value may also be requested through the System tag "_CIPConnectionSizeRequested." For
more information, refer to Internal Tags.
Inactivity Watchdog: Specify the amount of time, in seconds, a connection remains idle (without read/write
transactions) before being closed by the controller. The larger the value, the more time it takes for
connection resources to be released by the controller and vice versa. The default is 32 seconds.
Note: If an error about the CIP connection timing out while uploading a project occurs frequently, increase
the Inactivity Watchdog value. Otherwise, the default value is suggested.
Logix
Array Block Size: This property specifies the maximum number of array elements to read in a single
transaction. The value is adjustable and ranges from 30 to 3840 elements. The default is 120 elements.
Tip: For Boolean arrays, a single element is considered a 32-element bit array. Setting the block size to 30
elements translates to 960 bit elements, whereas 3840 elements translate to 122880 bit elements.
www. ptc.com
27 Allen-Bradley ControlLogix Ethernet Driver
Protocol Options
Protocol Mode: Select how Logix tag data is read from the controller: Logical Non-Blocking, Logical Blocking,
and Symbolic. The default is Logical Non-Blocking. This option should only be changed by advanced users
looking to increase client/server tag update performance.
For more information, refer to Choosing a Protocol Mode.
Note: Logical Non-Blocking and Logical Blocking are not available to Serial Gateway models.
Synchronize After Online Edits: When enabled, the driver synchronizes its project image with that of the
controller project when an online project edit (or project download from RSLogix/Studio5000) is detected.
This option prevents unnecessary errors from occurring during a project change. It is only available when
the selected Protocol Mode is Logical Non-Blocking or Logical Blocking. The default is Yes.
Synchronize After Offline Edits: When enabled, the driver synchronizes its own project image with that of
the controller project when an offline project edit (or project download from RSLogix/Studio5000) is
detected. This option prevents unnecessary errors from occurring during a project change. It is only
available when the selected protocol is Logical Non-Blocking or Logical Blocking. The default is Yes.
Failure to synchronize with project changes can lead to reading from and writing to the wrong Native tag
address.
Terminate String Data at LEN: When enabled, the driver automatically reads the LEN member of the
STRING structure whenever the DATA member is read. The DATA string is terminated at the first null
character encountered, the character whose position equals the value of LEN, or the maximum string length
of DATA (whichever occurs first). When disabled, the driver bypasses the LEN member read and terminates
the DATA string at either the first null character encountered or the maximum string length of DATA
(whichever occurs first). Therefore, if LEN is reduced by an external source without modification to DATA,
the driver does not terminate DATA according to this reduced length. The default is Enable.
Project Options
Default Data Type: Select the data type assigned to a client/server tag when the default type is selected
during tag addition, modification, or import. The default is Default.
For more information, refer to Default Data Type Conditions.
Performance Statistics: The Allen-Bradley ControlLogix Ethernet Driver has the ability to gather
communication statistics to help determine the driver's performance. When enabled, this option is enabled.
The driver tracks the number and types of client/server tag updates. On restart of the server application, the
results are displayed in the server's Event Log. The default is No.
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 28
Note: Once a project configuration is designed for optimal performance, it is recommended that users
disable Performance Statistics. Because the statistics are written to the Event Log on shutdown, the server
must be re-launched to view the results.
See Also: Detecting a Change in the Controller Project
Database Import Method: Select how the tag database should be populated:
l Create from Device: retrieves tags directly from the controller over the same Ethernet connection
that is used for data access, which is fast and imports most tags, but requires access to the
controller and does not import descriptions. Tags that are not imported include Add-On Instruction
(AOI) InOut properties.
Note: This feature is not available to Serial Gateway models.
l Create from Import File: retrieves tags from a selected RSLogix L5K/L5X file. Controller access is
not necessary, descriptions are imported, and users can work offline; however, this option is slower
and does not import all the tags in the controller. Tags that are not imported include:
l I/O tags
l Add-On Instruction (AOI) InOut properties
l AOI properties that alias other properties
l Equipment Phase properties that alias properties from another Equipment Phase or
Program
l Program properties that alias properties from another Program or Equipment Phase
l Timer/Counter CTL bits
Tag Import File: Click the browse (...) button to locate and select the L5K/L5X file from which tags are to be
imported. This file is used when Automatic Tag Database Generation is instructed to create the tag
database. All tags, including Global and Program, are imported and expanded according to their respective
data types.
Tag Descriptions: Choose Enable to import tag descriptions for non-structure, non-array tags. If necessary,
a description is given to tags with long names stating the original tag name.
www. ptc.com
29 Allen-Bradley ControlLogix Ethernet Driver
Limit Name Length: Select Enable to constrain the tag and group names to 31 characters. The default is
Disable.
1. Before OPC server version 4.70, tag and group name lengths were restricted to 31 characters. The
current length restriction of 256 characters can fit Logix 40-character Logix Tag names.
2. If an older server version was used to import tags via L5K/L5X import, inspect the Event Log or scan
the server project to see if any tags were truncated due to the character limit. If so, Enable this
property to preserve the server tag names. OPC client tag references are not affected. If disabled,
longer tag names are created and clients referencing the clipped tag must be changed to reference
the new tag name.
3. If an older OPC server version was used to import tags via L5K/L5X import and no tags were
truncated due to the 31-character limit, leave this options disabled.
4. If tags were imported via L5K/L5X with server version 4.70 or above, leave this options disabled.
See Also: Controller-to-Server Name Conversions
Tag Hierarchy: This property specifies the tree organization of the tag hierarchy. When Condensed, the
server tags created by automatic tag generation follow a group/tag hierarchy consistent with the tag's
address. Groups are created for every segment preceding the period. When Expanded, the server tags
created by automatic tag generation follow a group/tag hierarchy consistent with the tag hierarchy in
RSLogix 5000. Groups are created for every segment preceding the period and to represent logical
groupings. To use this functionality, enable Allow Sub Groups in Tag Generation properties.
For more information on the groups created, refer to Tag Hierarchy.
Impose Array Limit: Select Enable to constrain the number of array elements. Tags in the controller can be
declared with very large array dimensions. By default, arrays are completely expanded during the tag
generation process, which becomes time consuming for large arrays. By imposing a limit, only a specified
number of elements from each dimension are generated. Limits only takes effect when the array dimension
size exceeds the limit. The default is Disable.
Array Count Limit: Specify the array count limit. The default is 2000.
TCP/IP Port: Specify the port number that the remote device is configured to use (such as 1756-ENBT). The
default is 44818.
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 30
Request Size: Select the number of bytes that may be requested from a device at one time to refine
performance. Options are 32, 64, 128, or 232. The default is 232 bytes.
Allow Function File Block Writes: Function files are structure-based files (much like PD and MG data files)
and are unique to the MicroLogix 1100, 1200, and 1500. For applicable function files, data can be written to
the device in a single operation. By default, when data is written to a function file sub element (field within
the function file structure), a write operation occurs immediately for that tag. For such files as the RTC file,
whose sub elements include hour (HR), minute (MIN), and second (SEC), individual writes are not always
acceptable. With such sub elements relying solely on time, values must be written in one operation to avoid
time elapsing between sub elements writes. For this reason, there is the option to block write these sub
elements. The default is disabled.
Block Writes
Block writing involves writing to the device the values of every read/write sub element in the function file in a
single write operation. It is not necessary to write to every sub element before performing a block write. Sub
elements that are not affected (written to) have their current value written back to them. For example, if the
current (last read) date and time is 1/1/2001, 12:00.00, DOW = 3 and the hour is changed to 1 o'clock, the
values written to the device are 1/1/2001, 1:00.00, DOW = 3. For more information, refer to the instructions
below.
2. Enable Allow Function Files Block Writes to notify the driver to utilize block writes on function files
that support block writes.
3. Clicking OK or Apply.
4. Write the desired value to the sub element tag in question. The sub element tag immediately takes
on the value written to it.
Note: After a sub element is written to at least once in block write mode, the tag's value does not
originate from the controller, but instead from the driver's write cache. After the block write is done,
all sub element tag values originate from the controller.
5. Once the entire desired sub elements are written, perform the block write that sends these values to
the controller. To instantiate a block write, reference tag address RTC:<element>._SET. Setting this
tag's value to 'true' causes a block write to occur based on the current (last read) sub elements and
the sub elements affected (written to). Immediately after setting the tag to 'true', it is automatically
reset to "false." This is the default state and performs no action.
www. ptc.com
31 Allen-Bradley ControlLogix Ethernet Driver
RTC
Second SEC
Slot n: the physical slot being configured. Use the plus icon to expand the properties.
Module: Select the type of module in the slot from the options available in the drop-down list.
Input Words: If required by the module selected, enter the maximum number of Input Words for this
module.
Output Words: If required by the module selected, enter the maximum number of Output Words for this
module.
1. Select the slot to be configured by clicking on the row in the module list box.
4. To remove a slot / module, select No Module from the available modules drop-down list.
Tips:
l Use the 0000-Generic Module to configure I/O that is not contained in the list of Available Modules.
l The module selections available are the same as those in the Allen Bradley APS software.
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 32
Note: It is common to have open slots in the rack that do not contain a physical module. To correctly
access data for the various slots that do contain a module, the preceding module(s) must have the correct
number of words mapped. For example, if only interested in the I/O in slot 3, but slots 1 and 2 contain I/O
modules, the correct modules must be selected for slots 1, 2, and 3 from this slot configuration group.
0000-Generic Module
Use the Generic Module to map Input and Output words for modules that are not represented in the list of
available modules. To correctly use the Generic Module, users must know the number of Input and Output
words required for each module.
Consult Allen-Bradley I/O user manual documentation to confirm Input and Output requirements and be
aware that requirements may be different based on Class 1 or Class 3 operation.
For information on the number of input and output words available for each I/O module, refer to Modular
I/O Selection Guide.
Consult the website, a sales representative, or the user manual for more information.
www. ptc.com
33 Allen-Bradley ControlLogix Ethernet Driver
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 34
www. ptc.com
35 Allen-Bradley ControlLogix Ethernet Driver
Performance Optimizations
For more information on optimization at the communication and application levels, select a link from the list
below.
Optimizing Communications
Optimizing Application
Performance Statistics and Tuning
Performance Tuning Example
Optimizing Communications
As with any programmable controller, there are a variety of ways to enhance the performance and system
communications.
Protocol Mode
The Protocol Mode determines how Logix tag data is accessed from the controller. There are three types of
protocol modes: Symbolic, Logical Non-Blocking and Logical Blocking. Descriptions are as follows:
l Symbolic Mode: Each client/server tag address is represented in the packet by its ASCII character
name.
l Logical Non-Blocking Mode: Each client/server tag is represented by its logical memory address in
the PLC.
l Logical Blocking Mode: The Logix tag is accessed as a single chunk of data. Each client/server tag
(such as MYTIMER.ACC) has a corresponding Logix tag (MYTIMER). Many client/server tags can
belong to the same Logix tag, as in the case of structures. On every read cycle, the Logix tag is read,
its block is updated in the driver cache and all client/server tags are updated from this cache.
Logical Non-Blocking Mode is generally recommended because it is the most efficient mode for gathering
and processing Logix tag data. Symbolic Mode is recommended for backward compatibility, whereas Logical
Non-Blocking Mode is recommended for projects containing a small number of references to UDT and/or
predefined structure Logix tags. Although Logical Blocking Mode can be efficient, it can also hurt
performance if used incorrectly. For more information on each mode's benefits and detriments, refer to
Choosing a Protocol Mode.
1. Assign server tags referencing Atomic Logix tags (array or non-array) to the Logical Non-Blocking
device.
2. Assign server tags referencing a Structure Logix tag composed of one-third* or less of the Structure
tag to the Logical Non-Blocking device(s). For example, if there are 55** or less member tags
referencing a PID_ENHANCED Logix tag, all these tags should be assigned to the Logical Non-
Blocking device.
3. Assign server tags referencing a Structure Logix tag composed of one-third* or more of the
Structure tag to the Logical Blocking device(s). For example, if there are more than 55** member
tags referencing a PID_ENHANCED Logix tag, all of those tags should be assigned to the Logical
Blocking device.
*One-third is not an exact limit, but rather a figure that has held true in a number of studies.
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 36
Connection Size
Increasing the ConnectionSize allows more read/write requests per data packet, which provides greater
throughput. Although it also increases the CPU load and response turnaround time, it significantly improves
performance. The Connection Size property may be modified in the ControlLogix 5500 and CompactLogix
5300 device models only. For more information, refer to Logix Communications Parameters.
1. Create an alias of the substructure in RSLogix 5000. Then, assign server tags referencing the rest of
the UDT substructure to a Logical Blocking device.
2. Next, assign the server tags referencing the rest of the UDT (but not the substructure) to a Logical
Non-Blocking device.
Multi-Request Packets
The Allen-Bradley ControlLogix Ethernet Driver has been designed to optimize reads and writes. For non-
array, non-string tags (which only request one element), requests are blocked into a single transaction. This
provides drastic improvement in performance over single tag transactions. The only limitation is the number
of data bytes that can fit in a single transaction.
Important: In Symbolic Mode, each tag's ASCII string value is inserted into the request packet until no
more tag requests fit. For optimum performance, users should keep the tag names' size to a minimum. The
smaller the tag name, the more tags that fit in a single transaction and the fewer transactions needed to
process all tags.
Block sizes are specified as an element count. A block size of 120 elements means that a maximum of 120
array elements are read in one request. The maximum block size is 3840 elements. Boolean arrays are
treated differently: in protocol, a Boolean array is a 32-bit array. Thus, requesting element 0 is requesting
bits 0 through 31. To maintain consistency in discussion, a Boolean array element is considered a single bit.
In summary, the maximum number of array elements (based on block size of 3840) that can be requested is
as follows: 122880 BOOL, 3840 SINT, 3840 INT, 3840 DINT and 3840 REAL.
www. ptc.com
37 Allen-Bradley ControlLogix Ethernet Driver
As discussed in Logix Communication Parameters, the block size is adjustable and should be chosen
based on the project at hand. For example, if array elements 0-26 and element 3839 are tags to be read,
then using a block size of 3840 is not only overkill, but detrimental to the driver's performance. This is
because all elements between 0 and 3839 are read on each request, even though only 28 of those elements
are of importance. In this case, a block size of 30 is more appropriate. Elements 0-26 would be serviced in
one request and element 3839 would be serviced on the next.
Optimizing Strings
In the Logical Addressing modes, a write to STRING.DATA also writes to STRING.LEN with the proper length
value.
For more information on the "Automatically Read String Length" option, refer to Logix Options.
The server refers to communications protocols like Allen-Bradley ControlLogix Ethernet as a channel. Each
channel defined in the application represents a separate path of execution in the server. Once a channel has
been defined, a series of devices must then be defined under that channel. Each of these devices represents
a single Allen-Bradley Logix CPU from which data is collected. While this approach to defining the application
provides a high level of performance, it doesn't take full advantage of the Allen-Bradley ControlLogix
Ethernet Driver or the network. An example of how the application may appear when configured using a
single channel is shown below.
If the driver could only define a single channel, the example above would be the only option available;
however, the driver can define up to 1024 channels. Using multiple channels distributes the data collection
workload by simultaneously issuing multiple requests to the network. An example of how the same
application may appear when configured using multiple channels to improve performance is shown below.
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 38
Each device has now been defined under its own channel. In this new configuration, a
single path of execution is dedicated to the task of gathering data from each device. If
the application has fewer devices, it can be optimized as shown here.
The performance improves even if the application has more devices. While fewer
devices may be ideal, the application still benefits from additional channels. Although
by spreading the device load across all channels causes the server to move from
device to device again, it can now do so with far less devices to process on a single
channel.
l Device: These statistics provide the data access performance on a particular device.
l Channel: These statistics provide the average data access performance for all the devices under a
given channel with Performance Statistics enabled.
l Driver: These statistics provide the average data access performance for all devices using the Allen-
Bradley ControlLogix Ethernet Driver with Performance Statistics enabled.
Locating Statistics
Server statistics are output to the server's Event Log on shutdown. To view the results, shut down the server
and restart it.
1. Server tags referencing Atomic Logix tags (array or non-array) should be assigned to Logical Non-
Blocking devices.
www. ptc.com
39 Allen-Bradley ControlLogix Ethernet Driver
2. Server tags referencing a Structure Logix tag composed of one-third or less of the Structure tag
should be assigned to Logical Non-Blocking devices.
3. Server tags referencing a Structure Logix tag composed of one-third or more of the Structure tag
should be assigned to Logical Blocking devices.
6. Only the necessary amount of System Overhead Time Slice for Ladder Logic/FBD should allocated to
leave the rest for driver communications.
7. For projects that read a large number of string tags in Logical Mode, disable the "Automatically Read
String Length" option located under Logix Options in Device Properties.
For information on increasing driver statistic results, refer to the instructions below. For more information,
refer to Optimizing Application.
1. Devices should be spread across channels. More than one device should not be put on a channel
unless necessary.
2. Load should be spread evenly across devices. A single device should not be overloaded unless
necessary.
3. The same Logix tag should not be referenced across different devices.
Note: Although these general rules can help optimize performance, it ultimately depends on the
application. The scan rate can obscure results: if tag requests are light, read and write transactions can
complete before the next request comes in. In this case, Logical Blocking and Logical Non-Blocking will have
the same Performance Statistics results. If tag requests are high (many tags or high scan rates), transaction
completion time may take longer. This is when the strengths and weaknesses of Logical Blocking and Logical
Non-Blocking become apparent. Performance Statistics can help tune the application for maximum
performance. For an example, refer to Performance Tuning Example.
The statistics gathered are relative. Users should start with a server project layout, gather the statistics, and
then tune. It is recommended that more than one trial be used to properly assess the results for a given
layout. Once the most efficient layout is determined, the client application can be built with reassurance that
the server is optimal.
Performance results obtained using the Quick Client do not equate to performance results obtained using
a client application:several factors produce discrepancies. Although performance tuning with the client
application is more accurate than with the Quick Client, the tuning required not only affects the server
project, but the client application as well. It is recommended that the Quick Client be used to tune the
application before the client application is developed.
Note: The tuning process described below assumes that all tags are being read at a fast scan rate. Writes
hinder the performance.
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 40
2 Atomics
1 Atomic Array
1 UDT
1 UDT Array
1 Pre-Defined Type
2. After performing Automatic Tag Database Generation from this controller, the server produces the
following project.
3. To illustrate the benefits of tag division, this example does not reference all tags. More than one-third
of the ProcessPID tags, less than one-third of the FlowRates tags, and all other tags are referenced.
As such, the new tag count is 105.
4. Prepare the client for the test. To do so, launch the Quick Client from the server application by
clicking on the QuickClient icon.
5. Once the project is loaded, remove all groups except those containing tags of interest. Statistics and
System tags, for example, are not needed.
Note: For small projects, set the group Update Rate to 0-10 ms. For large projects, set the rate to
10-50 ms.
www. ptc.com
41 Allen-Bradley ControlLogix Ethernet Driver
7. Enable Test 8. Activate items on start. Deactivate items on stop and then set a test interval.
Note: Since this project is fairly small, the interval has been set to 2 minutes. For larger projects,
the interval should be increased to get a more accurate reading.
8. Return to Tools | Test Mode and disable test mode. All tags should be deactivated.
11. Launch the server and set the Protocol Mode to Logical Blocking under device properties.
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 42
13. Connect to the server using the Quick Client. Select Tools | Test Mode. Enable Test Mode.
Note: Data reading begins. When the test interval expires, all tags are deactivated and the driver
ceases statistics gathering. The results can then be viewed.
14. Disconnect the Quick Client from the server and then shutdown the server.
15. Re-launch the server and search its Event Log for statistics. The image below displays the first trial
utilizing Logical Blocking for the device.
Note: The image below displays the first trial utilizing Logical Blocking for the channel and driver.
www. ptc.com
43 Allen-Bradley ControlLogix Ethernet Driver
17. Connect to the server using Quick Client. Select Tools | Test Mode and enable test mode.
Note: Data reading begins. When the test interval expires, all tags are deactivated and the driver
ceases statistics gathering. The results can then be viewed.
18. Disconnect the Quick Client from the server and then shutdown the server.
19. Re-launch the server and then search its Event Log for statistics. The image below displays the
second trial utilizing Logical Non-Blocking for the device.
Note: The image below displays the second trial utilizing Logical Non-Blocking for the channel and
driver.
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 44
20. From the server, set the Protocol Mode to Symbolic to see how the performance fared prior to
Allen-Bradley ControlLogix Ethernet Driver version 4.6.0.xx.
21. Connect to the server using the Quick Client. Then, click Tools | Test Mode and enable test mode.
Note: Data reading begins. When the test interval expires, all tags are deactivated and the driver
ceases statistics gathering. The results can then be viewed.
22. Disconnect the Quick Client from the server and then shutdown the server.
23. Re-launch the server and search its Event Log for statistics. The image below displays the third trial
utilizing Symbolic for the device.
The image below displays the third trial utilizing Symbolic for the channel and driver.
www. ptc.com
45 Allen-Bradley ControlLogix Ethernet Driver
Note: It appears that Logical Blocking is most optimal for the given application.
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 46
1. Repeat Steps 4 through 15. In Step 11, make sure that Device 1 is Logical Blocking and Device 2 is
Logical Non-Blocking.
2. Launch the server and search the server Event Log for statistics. The image below displays the fourth
trial utilizing tag division for the device.
Note:The image below displays the fourth trial utilizing tag division for the channel and driver.
www. ptc.com
47 Allen-Bradley ControlLogix Ethernet Driver
Note: The individual device statistics do not look impressive because the two devices are running on
separate statistic counters. The key to this test is that the channel and driver statistics are better (6126) than
using one channel/one device with either Logical Blocking (5972) or Logical Non-Blocking (3705).
Optimize Application
The application can be optimized by moving Device 1 to one channel and Device 2 to another.
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 48
1. Repeat Steps 4 through 15. In Step 11, make sure Channel1.Device 1 is Logical Blocking and
Channel2.Device 2 is Logical Non-Blocking.
2. Launch the server and search the server Event Log for statistics. The image below displays the fifth
trial utilizing Logix tag coupled with multiple channels for Channel 1.Device1.
Note: The image below displays the fourth trial utilizing Logix tag for Channel2.Device2.
www. ptc.com
49 Allen-Bradley ControlLogix Ethernet Driver
Note: The image below displays the fourth trial utilizing tag division for the driver.
Results
Driver Performance Improvement Over
Server Project Layout
(Reads/Second) Symbolic
Single Channel
Single Device with Logical 5972 768%
Blocking
Single Channel
Single Device with Logical Non- 3705 476%
Blocking
Single Channel
777 N/A
Single Device with Symbolic
Single Channel
6126 788%
Multiple Devices with Tag Division
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 50
Conclusions
The project began with a single channel and a single device, which is the default behavior for a single
controller. All tags were imported from this controller to this channel.device. All three protocol modes were
then tested to see which would provide the best performance. In this case, Logical Blocking Protocol was the
best. The best protocol depends on the application at hand. When performance is crucial, it is worth
performing Logical Blocking and Logical Non-Blocking trials to determine which is the best protocol mode for
the application. Symbolic protocol is not necessary because it never meets the performance caliber of either
of the other protocol modes. It is shown here for the sake of the example.
Measures were taken to optimize communications using the tips outlined in Optimizing Communications.
Most notably, tag division was used to place the Logical Blocking type tags in a device assigned Logical
Blocking and the Logical Non-Blocking type tags in a device assigned Logical Non-Blocking. Furthermore,
both devices resided on the same channel. The results show an improvement over using Logical Blocking on
a single device. This is because some tags lend themselves better to one protocol mode over another. For
example, reading an entire COUNTER benefits from Logical Blocking over Logical Non-Blocking since it's
much faster reading the COUNTER as a block then as individual members.
Measures were also taken to optimize the application by placing devices on their own channel. Using the
devices created in the previous trial, a Logical Blocking device was placed on one channel and a Logical Non-
Blocking device on another. The results show improvement over the single channel / multiple devices
scenario from the previous trial. This reinforces the idea that performance is improved by having as few
devices per channel and as many channels as necessary.
After using these three optimization methods, the project has an 827% performance increase over Allen-
Bradley ControlLogix Ethernet Driver version earlier than 4.6.0.xx. Tag division and multiple channels
improved the performance by 107%. The performance increase is more apparent with larger projects.
www. ptc.com
51 Allen-Bradley ControlLogix Ethernet Driver
For a description of Logix platform-specific data types, refer to Logix Advanced Addressing.
For specifics about changes to the Boolean arrays in firmware V30, see this Knowledge Base article.
1. A dynamic tag is created in the client with Native as its assigned data type.
2. A static tag is created in the server with Default as its assigned data type.
3. In offline automatic tag generation, when an unknown data type is encountered in the L5K/L5X file for
UDTmembers and alias tags.
4. In offline automatic tag generation, when an alias of the following type is encountered in the L5K/L5X:
a. Alias of an alias.
b. Alias of non bit-within-Word/DWord I/O module tag. For example, if tag "AliasTag"
references I/O module tag "Local:5:C.ProgToFaultEn" @ BOOL, the data type for "AliasTag"
cannot be resolved, so this default type is assigned to it. On the other hand, if "AliasTag"
references I/O module tag "Local:5:C.Ch0Config.RangeType.0" @ BOOL, the data type can be
resolved because of the . (dot) BIT that defines it as a bit-within-Word/DWord. Aliases of bit-
within-Word/DWord I/O module tags are automatically assigned the Boolean data type.
Notes:
1. If Default is selected, the driver retrieves the Logix tag's data type from the controller when a
client is accessing a tag dynamically and does not explicitly assign a data type to the item. For
example, a tag exists in the controller that is called "MyTag" with a data type of REAL. The
corresponding client item is specified as "Channel1.Device1.MyTag" with no data type assigned.
With Default selected as the default data type in the server, the driver reads "MyTag" from the
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 52
controller and determine that it is a REAL in the response, providing the client a data type of
Float.
2. Since the majority of I/O module tags are not bit-within-Word/DWord tags, it is advised that the
default type be set to the majority data type as observed in the .ACD project. For example, if 75%
of alias I/O module tags are INT tags, set the default type to INT.
www. ptc.com
53 Allen-Bradley ControlLogix Ethernet Driver
Address Descriptions
Address specifications vary depending on the model in use. For the model of interest's address information,
refer to the table below.
Model
MicroLogix X X X X X X X X X X X X X X
PLC5 X X X X X X X X X X X X X X X
SLC5/05 X X X X X X X X X X X
See also:
Logix Addressing
MIcroLogix Addressing
PLC-5 Series Addressing
SLC 500 Modular I/O Addressing
Protocol
Models Help Link
Class
ControlLogix 5500 Ethernet, CompactLogix 5300 Ethernet,
Logix-Ethernet Logix Addressing
FlexLogix 5400 Ethernet, SoftLogix 5800
PLC-5 Series
Addressing
DH+ Gateway DH+ Gateway: PLC-5 DH+ Gateway: SLC 5/04
SLC 500 Modular
I/O Addressing
ControlNet PLC-5 Series
ControlNet Gateway: PLC-5C
Gateway Addressing
Logix Addressing
ENI: ControlLogix 5500 MicroLogix
ENI: CompactLogix 5300 Addressing
ENI: FlexLogix 5400 SLC 500 Fixed I/O
1761-NET-ENI ENI: MicroLogix Addressing
ENI: SLC 500 Fixed I/O SLC 500 Modular
ENI: SLC 500 Modular I/O I/O Addressing
ENI: PLC-5 PLC-5 Series
Addressing
MicroLogix MicroLogix
MicroLogix 1100
1100 Ethernet Addressing
MicroLogix MicroLogix
MicroLogix 1400
1400 Ethernet Addressing
Note: For more information on the controller's pre-defined data types, refer to the device's
documentation.
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 54
Logix Addressing
For more information on these models' tag-based addressing and relationship to the Allen-Bradley
ControlLogix Ethernet Driver, refer to Logix Tag-Based Addressing.
www. ptc.com
55 Allen-Bradley ControlLogix Ethernet Driver
MicroLogix Addressing
MicroLogix Addressing for EtherNet/IP Gateway
The actual number of addresses available depends on the model of the PLC. The ranges have been opened
up to allow for maximum flexibility with future models. If the driver finds at Runtime that an address is not
present in the device, it posts an error message and then removes the tag from its scan list. For more
information on file-specific addressing, select a link from the list below.
Output Files
Input Files
Status Files
Binary Files
Timer Files
Counter Files
Control Files
Integer Files
Float Files
ASCIIFiles
String Files
Long Files
MicroLogix PID Files
MicroLogix Message Files
For information on function files, select a link from the list below.
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 56
Output Files
Input Files
Status Files
Binary Files
Timer Files
Counter Files
Control Files
Integer Files
Float Files
ASCIIFiles
String Files
Long Files
MicroLogix PID Files
MicroLogix Message Files
For information on function files, select a link from the list below.
Output Files
Input Files
Status Files
Binary Files
Timer Files
Counter Files
Control Files
Integer Files
Float Files
String Files
Long Files
MicroLogix PID Files
MicroLogix Message Files
For information on function files, select a link from the list below.
www. ptc.com
57 Allen-Bradley ControlLogix Ethernet Driver
Output Files
Input Files
Status Files
Binary Files
Timer Files
Counter Files
Control Files
Integer Files
Float Files
ASCII Files
String Files
Long Files
MicroLogix PID Files
MicroLogix Message Files
For information on function files, select a link from the list below.
Output Files
Input Files
Status Files
Binary Files
Timer Files
Counter Files
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 58
Control Files
Integer Files
Output Files
Input Files
Status Files
Binary Files
Timer Files
Counter Files
Control Files
Integer Files
Output Files
Input Files
Status Files
Binary Files
Timer Files
Counter Files
Control Files
Integer Files
Float Files
ASCII Files
String Files
Output Files
Input Files
Status Files
Binary Files
Timer Files
Counter Files
www. ptc.com
59 Allen-Bradley ControlLogix Ethernet Driver
Control Files
Integer Files
Float Files
ASCII Files
String Files
Output Files
Input Files
Status Files
Binary Files
Timer Files
Counter Files
Control Files
Integer Files
Float Files
ASCII Files
String Files
Output Files
Input Files
Status Files
Binary Files
Timer Files
Counter Files
Control Files
Integer Files
Float Files
ASCII Files
String Files
BCD Files
PID Files
Message Files
Block Transfer Files
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 60
For more information on file-specific addressing, select a link from the list below.
Output Files
Input Files
Status Files
Binary Files
Timer Files
Counter Files
Control Files
Integer Files
Float Files
ASCII Files
String Files
BCD Files
PID Files
Message Files
Block Transfer Files
Output Files
Input Files
Status Files
Binary Files
Timer Files
Counter Files
Control Files
Integer Files
Float Files
ASCII Files
String Files
BCD Files
PID Files
Message Files
Block Transfer Files
Output Files
Input Files
Status Files
Binary Files
Timer Files
www. ptc.com
61 Allen-Bradley ControlLogix Ethernet Driver
Counter Files
Control Files
Integer Files
Float Files
ASCII Files
String Files
BCD Files
PID Files
Message Files
Block Transfer Files
Note: Throughout this help file, Logix tags are assumed to be global in nature unless specified otherwise.
The Allen-Bradley ControlLogix Ethernet Driver allows users to access the controller's atomic data types:
BOOL, SINT, INT, DINT, LINT, and REAL. Although some of the pre-defined types are structures, they are
ultimately based on these atomic data types. Thus, all non-structure (atomic) members of a structure are
accessible. For example, a TIMER cannot be assigned to a server tag but an atomic member of the TIMER
can be assigned to the tag (such as TIMER.EN, TIMER.ACC, and so forth). If a structure member is a structure
itself, both structures would have to be expanded to access an atomic member of the substructure. This is
more common with user and module-defined types and is not found in any of the pre-defined types.
Atomic Data
Description Range
Type
VT_
BOOL Single-bit value 0, 1
BOOL
SINT Signed 8-bit value VT_UI1 -128 to 127
INT Signed 16-bit value VT_I2 -32,768 to 32,767
DINT Signed 32-bit value VT_I4 -2,147,483,648 to 2,147,483,647
9,223,372,036,854,775,808 to
LINT Signed 64-bit value VT_I8
9,223,372,036,854,775,807
32-bit IEEE floating
REAL VT_R4 1.1755 E-38 to 3.403E38, 0, -3.403E-38 to -1.1755
point
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 62
Note: Logix tag names should be kept to a minimum in size for optimum performance. The smaller the
name, the more requests that are able fit in a single transaction.
Symbolic Mode users should keep the client/server tag addresses below 400 characters. For example,
tagarray[1,2,4].somestruct.substruct_array[3].basetag.[4] is 57 characters in length. Since a packet can only
hold 500 data bytes, any overhead bytes that need to be added to the packet can greatly diminish the room
available to the characters themselves. By keeping the address below 400, the tag request remains
complete and valid.
Address Formats
There are several ways to address a Logix tag statically in the server or dynamically from a client. The
format used depends on the type and usage of the tag. For example, the bit format would be used when
accessing a bit within a SINT-type tag. For information on address format and syntax, refer to the table
below.
Note: All formats except for Array and String are native to RSLogix5000. Therefore, when referencing an
atomic data type, an RSLogix 5000 tag name can be copied and pasted into the server's tag address field
and be valid.
www. ptc.com
63 Allen-Bradley ControlLogix Ethernet Driver
*Since this format may request more than one element, the order in which array data is passed depends on
the dimension of the Logix Array tag. For example, if rows times cols = 4 and the Controller tag is a 3X3
element array, then the elements that are being referenced are array_tag [0,0], array_tag [0,1], array_tag
[0,2], and array_tag [1,0] in that exact order. The results would be different if the Controller tag were a 2X10
element array.
Note: For more information on how elements are referenced for 1, 2 and 3 dimensional arrays, refer to
Ordering of Array Data.
Tag Scope
Global Tags
Global tags are Logix tags that have global scope in the controller. Any program or task can access Global
tags; however, the number of ways a Global tag can be referenced depends on its Logix data type and the
address format being used.
Program Tags
Program tags are identical to Global tags except that a Program tag's scope is local to the program in which
it is defined. Program tags follow the same addressing rules and limitations as Global tags, but are prefixed
with the following notation:
For example, Logix tag "tag_1" in program "prog_1" would be addressed as "Program:prog_1.tag_1" in a
client/server tag address.
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 64
<structure name> . <substructure array name> [dim1, dim2, dim3] . <atomic-type tag>
Note: The examples above are only a few of the addressing possibilities that involve structures, and are
displayed to provide an introduction to structure addressing. For more information, refer to Allen-Bradley or
Rockwell documentation.
Internal Tags
Internal tags are not visible in the server configuration, but can be browsed by the OPC client and found
under the <Channel Name>.<Device Name> group. The _CIPConnectionSizeRequested tag reflects the CIP
connection size that was requested. The _CIPConnectionSizeActual tag reflects the actual CIP connection
size that is in use. Its value differs from the _CIPConnectionSizeRequested tag if the value requested is not
supported by the device. For more information on the connection size, refer to Logix Communications
Parameters.
Note: The tags described in the table below are only valid for the ControlLogix 5500 and CompactLogix
5300 device models.
www. ptc.com
65 Allen-Bradley ControlLogix Ethernet Driver
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 66
Logix Tag
MyTimer @ TIMER
Client/Server Tag
1. Invalid
2. Valid
TimerTag address = MyTimer.ACC
TimerTag data type = DWord
Because LEN and DATA are atomic members, they must be referenced independently from a client/server.
The syntax is as shown below.
www. ptc.com
67 Allen-Bradley ControlLogix Ethernet Driver
Reads
The STRING read from DATA is terminated by the following:
Example
MYSTRING.DATA contains "Hello World" in the PLC, but LEN is manually set to 5. A read of
MYSTRING.DATA/82 displays "Hello". If LEN is set to 20, MYSTRING.DATA/82 displays "Hello World".
Writes
When a STRING value is written to DATA, the driver also writes to LEN with the length of DATA written. If the
write to LEN fails for any reason, the write operation to DATA is considered failed as well (despite the fact
that the DATA write to the controller succeeded).
Note: This behavior was designed specifically for Logix tags of type STRING or a custom derivative of it.
The following precautions apply to users who wish to implement their own STRING in UDTs.
l If a UDT exists that has a DATA member referenced as a STRING and a LEN member referenced as a
DINT, the write to LEN succeeds regardless of the intentions of LEN for the given UDT. Care must be
taken when designing UDTs to avoid this possibility if LEN is not intended to be the length of DATA.
l If a UDT exists that has a DATA member referenced as a STRING but does not have a LEN member,
the write to LEN fails silently without consequence to DATA.
Example
MYSTRING.DATA/82 holds the value "Hello World." MYSTRING.LEN holds 11. If the value "Alarm Triggered"
is written to MYSTRING.DATA/82, 15 is written to MYSTRING.LEN. If the write to MYSTRING.LEN fails,
MYSTRING.LEN holds its previous value of 11 while MYSTRING.DATA/82 displays the first 11 characters
("Alarm Trigg"). If the write to MYSTRING.DATA/82 fails, neither tag is affected.
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 68
array [0, 0]
array [0, 1]
array [0, 2]
array [1, 0]
array [1, 1]
array [1, 2]
array [2, 0]
array [2, 1]
array [2, 2]
BOOL
SINT
INT
www. ptc.com
69 Allen-Bradley ControlLogix Ethernet Driver
DINT
LINT
REAL
*The float value equals the face value of the Controller tag in float form (non-IEEE floating-point number).
Examples
Examples highlighted signify common use cases.
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 70
www. ptc.com
71 Allen-Bradley ControlLogix Ethernet Driver
Examples
Examples highlightedsignify common use cases.
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 72
www. ptc.com
73 Allen-Bradley ControlLogix Ethernet Driver
Data
Server Tag Address Format Notes
Type
{8} Offset
sintarraytag / 1 String String Value = "S"
sintarraytag / 4 String String Value = "SINT"
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 74
Examples
Examples highlighted signify common use cases.
www. ptc.com
75 Allen-Bradley ControlLogix Ethernet Driver
Data
Server Tag Address Class Notes
Type
intarraytag Standard Byte Invalid: Tag cannot be an array.
intarraytag Standard Word Invalid: Tag cannot be an array.
intarraytag Standard DWord Invalid: Tag cannot be an array.
intarraytag Standard Float Invalid: Tag cannot be an array.
intarraytag [3] Array Element Word Invalid: Server tag missing dimension 2 address.
intarraytag [1,3] Array Element Boolean Invalid: Boolean not allowed for array elements.
intarraytag [1,3] Array Element Word Value = 259
Array w/o
intarraytag {10} Byte Value = [73,78,84,255,255,255,255,255,9,10]
Offset
Array w/o
intarraytag {2} {5} Word Value = [73,78,84,255,256] [257,258,259,9,10]
Offset
Array w/o
intarraytag {1} Word Value = 73
Offset
Array w/o
intarraytag {1} Boolean Invalid: Bad data type.
Offset
intarraytag [1,3] {4} Array w/ Offset Word Value = [259,9,10,11]
intarraytag . 3 Bit Boolean Invalid: Tag must reference atomic location.
intarraytag [1,3] . 3 Bit Boolean Value = 0
intarraytag [1,3] . 0 Array w/o Boolean Value = [1,1,0,0,0,0,0,0,1,0,0,0,0,0,0,0]
{16} Offset Bit value for 259
intarraytag / 1 String String Value = "I"
intarraytag / 3 String String Value = "INT"
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 76
Examples
Examples highlighted signify common use cases.
www. ptc.com
77 Allen-Bradley ControlLogix Ethernet Driver
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 78
Supported Data
Format Notes
Types
Standard Double*, Date** None
Array
Double*, Date** The Controller tag must be an array.
Element
Array w/o If accessing more than a single element, the Controller tag must
Double, Array*
Offset be an array.
Array w/
Double, Array* The Controller tag must be an array.
Offset
Bit N/A Not supported.
String N/A Not supported.
*Double value equals face value of Controller tag in float form (non-IEEE floating-point number).
**Date values are in universal time (UTC), not localized time.
Examples
Examples highlighted signify common use cases.
www. ptc.com
79 Allen-Bradley ControlLogix Ethernet Driver
Array
Note: This is not an array of REALs in Boolean
w/o Boolean Array
notation.
Offset
2. Applies to bit-within-REAL only. Example: tag_1.0{32}.
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 80
Examples
Examples highlighted signify common use cases.
www. ptc.com
81 Allen-Bradley ControlLogix Ethernet Driver
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 82
File Listing
Select a link from the list below for information on a specific file supported by various device models.
Output Files
Input Files
Status Files
Binary Files
Timer Files
Counter Files
Control Files
Integer Files
Float Files
ASCII Files
String Files
BCD Files
Long Files
MicroLogix PID Files
PID Files
MicroLogix Message Files
Message Files
Block Transfer Files
Note: For more information on device models and their supported files, refer to Address Descriptions.
www. ptc.com
83 Allen-Bradley ControlLogix Ethernet Driver
Output Files
The syntax for accessing data in the output file differs depending on the PLC model. Arrays are not
supported for output files. The default data types are shown in bold.
PLC-5 Syntax
Syntax Data Type Access
O:<word> Short, Word, BCD Read/Write
O:<word>/<bit> Boolean Read/Write
O/bit Boolean Read/Write
Note: Word and bit address information is in octal for PLC-5 models. This follows the convention of the
programming software.
MicroLogix Syntax
Syntax Data Type Access
O:<word> Short, Word, BCD Read/Write
O:<word>/<bit> Boolean Read/Write
O/bit Boolean Read/Write
MicroLogix models have two types of I/O: embedded I/O and expansion I/O (not applicable for MicroLogix
1000). Embedded I/O resides with the CPU base unit while Expansion I/O plugs into the CPU base unit. The
table below lists the I/O capabilities of each MicroLogix model.
The address syntax for MicroLogix I/O references a zero-based word offset, not a slot. Users must
determine the word offset to a particular slot. This requires knowledge of the modules and their respective
size in words. The table below specifies the size of some available modules; however, it is recommended
that users consult both the MicroLogix documentation and the controller project to determine the module's
true word size.
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 84
www. ptc.com
85 Allen-Bradley ControlLogix Ethernet Driver
Calculation
Output Word Offset for slot x = # Output Words in slot 0 through slot (x-1).
Notes:
1. The Embedded I/O needs to be taken into account when offsetting to Expansion I/O.
2. The number of Input words does not factor into the calculation for Output Word Offset.
I/O Example
Let
Slot 0 = MicroLogix 1500 LRP Series C = 4 Output Words
Slot 1 = 1769-OF2 = 2 Output Words
Slot 2 = 1769-OW8 = 1 Output Word
Slot 3 = 1769-IA16 = 0 Output Word
Slot 4 = 1769-OF8V = 9 Output Word
Bit 5 of Slot 4 = 4 + 2 + 1 = 7 words = O:7/5
Ranges
PLC Model Min. Slot Max. Slot Max. Word
MicroLogix N/A N/A 2047
SLC 500 Fixed I/O N/A N/A 1
SLC 500 Modular I/O 1 30 *
PLC-5 Series N/A N/A 277 (octal)
*The number of Input or Output words available for each I/O module can be found in the SLC 500 Modular
I/O Selection Guide. For slot configuration help, refer to Device Setup.
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 86
Examples
MicroLogix Description
O:0 word 0
O/2 bit 2
O:0/5 bit 5
PLC5* Description
O:0 word 0
O:37 word 31 (37 octal = 31 decimal)
O/42 bit 34 (42 octal = 34 decimal)
O:2/2 bit 2 word 2 (same as O/42)
Input Files
The syntax for accessing data in the input file differs depending on the PLC model. Arrays are not supported
for input files. The default data types are shown in bold.
PLC-5 Syntax
Syntax Data Type Access
I:<word> Short, Word, BCD Read/Write
I:<word>/<bit> Boolean Read/Write
I/bit Boolean Read/Write
Note: Word and bit address information is in octal for PLC-5 models. This follows the convention of the
programming software.
www. ptc.com
87 Allen-Bradley ControlLogix Ethernet Driver
MicroLogix Syntax
Syntax Data Type Access
I:<word> Short, Word, BCD Read/Write
I:<word>/<bit> Boolean Read/Write
I/bit Boolean Read/Write
MicroLogix models have two types of I/O: embedded I/O and expansion I/O (not applicable for MicroLogix
1000). Embedded I/O resides with the CPU base unit while Expansion I/O plugs into the CPU base unit. The
table below lists the I/O capabilities of each MicroLogix model.
The address syntax for MicroLogix I/O references a zero-based word offset, not a slot. Users must
determine the word offset to a particular slot. This requires knowledge of the modules and their respective
size in words. The table below specifies the size of some available modules; however, it is recommended
that the MicroLogix documentation and controller project be consulted to determine a module's true word
size.
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 88
Calculation
Input Word Offset for slot x = # Input Words in slot 0 through slot (x-1).
Notes:
www. ptc.com
89 Allen-Bradley ControlLogix Ethernet Driver
1. The Embedded I/O needs to be taken into account when offsetting to Expansion I/O.
2. The number of Output words does not factor into the calculation for Input Word Offset.
I/O Example
Let
Slot 0 = MicroLogix 1500 LRP Series C = 4 Input Words
Slot 1 = 1769-OF2 = 2 Input Words
Slot 2 = 1769-OW8 = 0 Input Word
Slot 3 = 1769-IA16 = 1 Input Word
Slot 4 = 1769-OF8V = 11 Input Word
Bit 5 of Slot 3 = 4 + 2 = 6 words = I:6/5
Ranges
PLC Model Min. Slot Max. Slot Max. Word
MicroLogix N/A N/A 2047
SLC 500 Fixed I/O N/A N/A 1
SLC 500 Modular I/O 1 30 *
PLC-5 Series N/A N/A 277 (octal)
*The number of Input or Output words available for each I/O module can be found in the SLC 500 Modular
I/O Selection Guide. For slot configuration help, refer to Device Setup.
Examples
MicroLogix Description
I:0 Word 0
I/2 Bit 2
I:1/5 Bit 5 word 1
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 90
PLC5* Description
I:0 Word 0
I:10 Word 8 (10 octal = 8 decimal)
I/20 Bit 16 (20 octal = 16 decimal)
I:1/0 Bit 0 word 1 (same as I/20)
Status Files
To access status files, specify a word and an optional bit in the word. The default data types are shown in
bold.
The number of array elements (in bytes) cannot exceed the block request size specified. This means that the
array size cannot exceed 16 words given a block request size of 32 bytes.
Ranges
PLC Model Max. Word
MicroLogix 999
SLC 500 Fixed I/O 96
SLC 500 Modular I/O 999
PLC-5 Series 999
The maximum word location is one less when accessing as a 32-bit data type (such as Long, DWord, or Long
BCD).
Examples
www. ptc.com
91 Allen-Bradley ControlLogix Ethernet Driver
Example Description
S:0 Word 0
S/26 Bit 26
S:4/15 Bit 15 word 4
S:10 [16] 16 element array starting at word 10
S:0 [4] [8] 4 by 8 element array starting at word 0
Binary Files
To access binary files, specify a file number, a word and optional bit in the word. The default data types are
shown in bold.
The number of array elements (in bytes) cannot exceed the block request size specified. This means that
array size cannot exceed 16 words given a block request size of 32 bytes.
Ranges
PLC Model File Number Max. Word
MicroLogix 3, 9-999 999
SLC 500 Fixed I/O 3, 9-255 255
SLC 500 Modular I/O 3, 9-999 999
PLC-5 Series 3-999 1999
The maximum word location is one less when accessing as a 32-bit data type (such as Long, DWord, or Long
BCD).
Examples
Example Description
B3:0 Word 0
B3/26 Bit 26
B12:4/15 Bit 15 word 4
B3:10 [20] 20 element array starting at word 10
B15:0 [6] [6] 6 by 6 element array starting at word 0
Timer Files
Timer files are a structured type whose data is accessed by specifying a file number, an element and a field.
The default data types are shown in bold.
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 92
The following fields are allowed for each element. For the meaning of each field, refer to the PLC's
documentation.
Ranges
PLC Model File Number Max. Element
MicroLogix 4, 9-999 999
SLC 500 Fixed I/O 4, 9-255 255
SLC 500 Modular I/O 4, 9-999 999
PLC-5 Series 3-999 1999
Examples
Example Description
T4:0.ACC Accumulator of timer 0 file 4
T4:10.DN Done bit of timer 10 file 4
T15:0.PRE Preset of timer 0 file 15
Counter Files
Counter files are a structured type whose data is accessed by specifying a file number, an element, and a
field. The default data types are shown in bold.
The following fields are allowed for each element. For the meaning of each field, refer to the PLC's
documentation.
www. ptc.com
93 Allen-Bradley ControlLogix Ethernet Driver
Ranges
PLC Model File Number Max. Element
MicroLogix 5, 9-999 999
SLC 500 Fixed I/O 5, 9-255 255
SLC 500 Modular I/O 5, 9-999 999
PLC-5 Series 3-999 1999
Examples
Example Description
C5:0.ACC Accumulator of counter 0 file 5
C5:10.DN Done bit of counter 10 file 5
C15:0.PRE Preset of counter 0 file 15
Control Files
Control files are a structured type whose data is accessed by specifying a file number, an element, and a
field. The default data types are shown in bold.
The following fields are allowed for each element. For the meaning of each field, refer to the PLC's
documentation.
Ranges
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 94
Examples
Example Description
R6:0.LEN Length field of control 0 file 6
R6:10.DN Done bit of control 10 file 6
R15:18.POS Position field of control 18 file 15
Integer Files
To access integer files, specify a file number, a word, and an optional bit in the word. The default data types
are shown in bold.
The number of array elements (in bytes) cannot exceed the block request size specified. This means that
array size cannot exceed 16 words given a block request size of 32 bytes.
Ranges
PLC Model File Number Max. Word
MicroLogix 7, 9-999 999
SLC 500 Fixed I/O 7, 9-255 255
SLC 500 Modular I/O 7, 9-999 999
PLC-5 Series 3-999 1999
The maximum word location is one less when accessing as a 32-bit data type (such as Long, DWord, or Long
BCD).
Examples
Example Description
N7:0 Word 0
N7/26 Bit 26
N12:4/15 Bit 15 word 4
N7:10 [8] 8 element array starting at word 10
www. ptc.com
95 Allen-Bradley ControlLogix Ethernet Driver
Example Description
N15:0 [4] [5] 4 by 5 element array starting at word 0
Float Files
To access float files, specify a file number and an element. The default data types are shown in bold.
The number of array elements (in bytes) cannot exceed the block request size specified. This means that
array size cannot exceed 8 floats given a block request size of 32 bytes.
Ranges
PLC Model File Number Max. Word
MicroLogix 8-999 999
SLC 500 Fixed I/O N/A N/A
SLC 500 Modular I/O 8-999 999
PLC-5 Series 3-999 1999
Examples
Example Description
F8:0 Float 0
F8:10 [16] 16 element array starting at word 10
F15:0 [4] [4] 16 element array starting at word 0
ASCII Files
To access ASCII file data, specify a file number and a character location. The default data types are shown in
bold.
*The number of array elements cannot exceed the block request size specified. Internally, the PLC packs two
characters per word in the file, with the high byte containing the first character and the low byte containing
the second character. The PLC programming software allows access at the word level or two-character
level. TheAllen-Bradley ControlLogix Ethernet Driver allows accessing to the character level.
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 96
Using the programming software, "A10:0 = AB," would result in 'A' being stored in the high byte of A10:0 and
'B' being stored in the low byte. Using the Allen-Bradley ControlLogix Ethernet Driver, two assignments
would be made: "A10:0 = A" and "A10:1 = B." This would result in the same data being stored in the PLC
memory.
**Referencing this file as string data allows access to data at word boundaries like the programming
software. The length can be up to 232 characters. If a string that is sent to the device is smaller in length
than the length specified by the address, the driver null terminates the string before sending it down to the
controller.
Ranges
PLC Model File Number Max. Character
MicroLogix 3-255 511
SLC 500 Fixed I/O N/A N/A
SLC 500 Modular I/O 9-999 1999
PLC-5 Series 3-999 1999
Note: Not all MicroLogix and SLC 500 PLC devices support ASCII file types. For more information, refer to
the PLC's documentation.
Examples
Example Description
A9:0 character 0 (high byte of word 0)
A27:10 [80] 80 character array starting at character 10
A15:0 [4] [16] 4 by 16 character array starting at character 0
A62:0/32 32 character string starting at word offset 0
String Files
To access string files, specify a file number and an element. Strings are 82 character null terminated arrays.
The driver places the null terminator based on the string length returned by the PLC. The default data types
are shown in bold.
Ranges
PLC Model File Number Max. Word
MicroLogix 9-999 999
SLC 500 Fixed I/O N/A N/A
SLC 500 Modular I/O 9-999 999
PLC-5 Series 3-999 999
Examples
www. ptc.com
97 Allen-Bradley ControlLogix Ethernet Driver
Example Description
ST9:0 String 0
ST18:10 String 10
BCD Files
To access BCD files, specify a file number and a word. The default data types are shown in bold.
PLC-5 Syntax
Syntax Data Type Access
D<file>:<word> BCD, LBCD Read/Write
D<file>:<word> [rows][cols] BCD, LBCD (array type) Read/Write
D<file>:<word> [cols] BCD, LBCD (array type) Read/Write
The number of array elements (in bytes) cannot exceed the block request size specified. This means that
array size cannot exceed 16 BCD, given a block request size of 32 bytes.
Ranges
PLC Model File Number Max. Word
MicroLogix N/A N/A
SLC 500 Fixed I/O N/A N/A
SLC 500 Modular I/O N/A N/A
PLC-5 Series 3-999 999
Examples
Example Description
D9:0 word 0
D27:10 [16] 16 element array starting at word 10
D15:0 [4][8] 32 element array starting at word 0
Long Files
To access long integer files, specify a file number and an element. The default data types are shown in bold.
The number of array elements (in bytes) cannot exceed the block request size specified. This means that
array size cannot exceed 8 longs given a block request size of 32 bytes.
Ranges
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 98
Examples
Example Description
L9:0 word 0
L9:10 [8] 8 element array starting at word 10
L15:0 [4] [5] 4 by 5 element array starting at word 0
The following fields are allowed for each element. For the meaning of each field, refer to the PLC's
documentation for the meaning of each field.
www. ptc.com
99 Allen-Bradley ControlLogix Ethernet Driver
Ranges
PLC Model File Number Max. Element
MicroLogix 3-255 255
All SLC N/A N/A
PLC-5 PID Files PID Files
Examples
Example Description
PD14:0.KC Proportional gain of PD 0 file 14
PD18:6.EN PID enable bit of PD 6 file 18
PID Files
PID files are a structured type whose data is accessed by specifying a file number, an element, and a field.
The default data types are shown in bold.
PLC-5 Syntax
Syntax Data Type Access
PD<file>:<element>.<field> Depends on field Depends on field
The following fields are allowed for each element. For the meaning of each field, refer to the PLC's
documentation.
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 100
Ranges
www. ptc.com
101 Allen-Bradley ControlLogix Ethernet Driver
Examples
Example Description
PD14:0.SP Set point field of PD 0 file 14
PD18:6.EN Status enable bit of PD 6 file 18
The following fields are allowed for each element. For the meaning of each field, refer to the PLC's
documentation.
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 102
Ranges
PLC Model File Number Max. Element
MicroLogix 3-255 255
All SLC N/A N/A
PLC5 Message Files Message Files
Examples
Example Description
MG14:0.TO Time out bit for MSG element 0 in data file 14
MG18:6.CO Continue bit for MSG element 6 in data file 18
Message Files
Message files are a structured type whose data is accessed by specifying a file number, an element, and a
field. The default data types are shown in bold.
PLC-5 Syntax
Syntax Data Type Access
MG<file>:<element>.<field> Depends on field Depends on field
The following fields are allowed for each element. For the meaning of each field, refer to the PLC's
documentation.
Ranges
www. ptc.com
103 Allen-Bradley ControlLogix Ethernet Driver
Examples
Example Description
MG14:0.RLEN Requested length field of MG 0 file 14
MG18:6.CO Continue bit of MG 6 file 18
PLC-5 Syntax
Syntax Data Type Access
BT<file>:<element>.<field> Depends on field Depends on field
The following fields are allowed for each element. For more information on the meaning of each field, refer
to the PLC's documentation.
Ranges
PLC Model File Number Max. Element
MicroLogix N/A N/A
SLC 500 Fixed I/O N/A N/A
SLC 500 Modular I/O N/A N/A
PLC-5 Series 3-999 1999
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 104
Examples
Example Description
BT14:0.RLEN Requested length field of BT 0 file 14
BT18:6.CO Continue bit of BT 6 file 18
Function Files
For information on the files supported by the ENI MicroLogix and MicroLogix 1100 device models, select a
link from the list below.
For more information on device models and their supported files, refer to Address Descriptions.
The following fields are allowed for each element. For the meaning of each field, refer to the PLC's
documentation.
www. ptc.com
105 Allen-Bradley ControlLogix Ethernet Driver
Ranges
PLC Model File Number Max. Element
MicroLogix N/A 254
All SLC N/A N/A
PLC5 N/A N/A
Examples
Example Description
HSC:0.OMB Output mask setting for high-speed counter 0.
HSC:1.ED Error detected indicator for high-speed counter 1.
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 106
The following fields are allowed for each element. For the meaning of each field, refer to the PLC's
documentation.
Ranges
PLC Model File Number Max. Element
MicroLogix N/A 254
All SLC N/A N/A
PLC5 N/A N/A
Examples
Example Description
RTC:0.YR Year setting for real-time clock 0.
RTC:0.BL Battery low indicator for real-time clock 0.
Ranges
www. ptc.com
107 Allen-Bradley ControlLogix Ethernet Driver
Examples
Example Description
CS0:0 Word 0.
CS0:4/2 Bit 2 word 4 = MCP.
For more information on CS0 words/bit meanings, refer to the Rockwell documentation.
Ranges
PLC Model File Number Max. Element
MicroLogix N/A 254
All SLC N/A N/A
PLC5 N/A N/A
Examples
Example Description
CS1:0 Word 0.
CS1:4/2 Bit 2 word 4 = MCP.
For more information on CS1 words/bit meanings, refer to the Rockwell documentation.
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 108
Ranges
PLC Model File Number Max. Element
MicroLogix N/A 254
All SLC N/A N/A
PLC5 N/A N/A
Examples
Example Description
IOS:0 Word 0.
IOS:4/2 Bit 2 word 4.
Note: For a listing of 1769 expansion I/O status codes, refer to the instruction manual.
www. ptc.com
109 Allen-Bradley ControlLogix Ethernet Driver
Note: ENI/DH+, ControlNet Gateway, and MicroLogix 1100 models do not support automatic tag database
generation: only ENI ControlLogix, CompactLogix, and FlexLogix models do.
Note: For more information on the Database Creation settings, refer to the server help file.
Tag Hierarchy
The server tags created by automatic tag generation can follow one of two hierarchies: Expanded or
Condensed. To use this functionality, enable Allow Sub Groups in device properties.
Expanded Mode
When Expanded, the server tags created by automatic tag generation follow a group / tag hierarchy
consistent with the tag hierarchy in RSLogix 5000. Groups are created for every segment preceding the
period as when Condensed, but are also created in logical groupings. Groups created include the following:
The root-level groups (or subgroup levels of the group specified in Parent Group) are "Prgm_<program
name>" and "Global". Each program in the controller has its own "Prgm_<program name>" group. The
driver recognizes this as the first group level.
Basic Global Tags (or non-structure, non-array tags) are placed under the Global group; basic Program tags
are placed under their respective program group. Each structure and array tag is provided in its own
subgroup of the parent group. By organizing the data in this fashion, the server's tag view mimics
RSLogix5000.
The name of the structure / array subgroup also provides a description of the structure / array. For instance,
an array tag1[1,6] defined in the controller would have a subgroup name "tag1_x_y"; x signifies dimension 1
exists, and y signifies dimension 2 exists. The tags within an array subgroup are all the elements of that
array (unless explicitly limited). The tags within a structure subgroup are the structure members
themselves. If a structure contains an array, an array subgroup of the structure group is created as well.
With a complex project, the tag hierarchy can require a number of group levels. The maximum number of
group levels created by automatic tag generation is seven. This does not include the group specified in "Add
generated tags to the following group". When more than seven levels are required, the tags are placed in
the seventh group (causing the hierarchy to plateau).
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 110
Array Tags
A group is created for each array that contains the array's elements. Group names have the notation: <array
name>_x_y_z where:
Array tags have the notation: <tag element>_XXXXX_YYYYY_ZZZZZ. For example, element tag1[12,2,987] would
have the tag name "tag1_12_2_987".
Simple Example
Complex Example
A Logix tag is defined with the address "Local:1:O.Slot[9].Data". This would be represented in the groups
"Global" - "Local_1_O" - "Slot_x" - "Slot_09". Within the last group would be the tag "Data".
Condensed Mode
In Condensed Mode, the server tags created by automatic tag generation follow a group/tag hierarchy
consistent with the tag's address. Groups are created for every segment preceding the period. Groups
created include the following:
l Program scope
l Structures and substructures
www. ptc.com
111 Allen-Bradley ControlLogix Ethernet Driver
With a complex project, it is easy to see how the tag hierarchy can require a number of group levels. The
maximum number of group levels created by automatic tag generation is seven. This does not include the
group specified in "Add generated tags to the following group". When more than seven levels are required,
the tags are placed in the seventh group (causing the hierarchy to plateau).
Note: Tag or structure member names leading off with an underscore is converted to "U_". This is
required because the server does not support leading underscores. For more information, refer to
Controller-to-Server Name Conversion.
Simple Example
Complex Example
Logix tag is defined with address "Local:1:O.Slot[9].Data". This would be represented in the groups
"Local:1:O" -> "Slot[9]". Within the last group would be the tag "Data".
Note: I/O module tags cannot be directly imported in Offline mode. Since aliases can be imported, it is
recommended that they be created for I/O module tags of interest in RSLogix5000.
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 112
Non-Array
Array
Long program names are clipped in the same manner as long non-array tag names. For every tag or
program name that is clipped, the unique ID is incremented. Array tag names (elements) of a clipped array
name have the same unique ID. This provides for 100000 unique tag/program names.
Note: If Limit Name Length is enabled, the rules apply even if the 256-character names are supported.
For more information, refer to Logix Database Settings.
Online
It is recommended that all communications to the Logix CPU of interest cease during the database creation
process.
In RSLogix5000
Set the project OFFLINE.
In the server
1. Open the device properties of the device for which tags will be generated.
2. Select Logix Database Settings and select Create from Device for Database Import Method.
3. In Logix Database Options, make any desired changes and click OK.
4. In Logix Database Filtering, make any desired changes and click OK.
5. Select Tag Generation and, under Create, click the blue link to Create tags.
www. ptc.com
113 Allen-Bradley ControlLogix Ethernet Driver
Note: In Logix Options, set Protocol Mode to Symbolic and Default Data Type to Default so that the
tags are imported with the data types used in the controller.
Offline
The Allen-Bradley ControlLogix Ethernet Driver uses a file generated from RSLogix5000 called an L5K/L5X
import/export file to generate the tag database.
In RSLogix5000
1. Open the project containing the tags that to be ported over to the OPC server.
3. Select L5K/L5X Import/Export File and then specify a name. RSLogix will export the project's
contents into this L5K/L5X file.
1. Open the device properties of the device for which tags will be generated.
2. Select Logix Database Settings and select Create from Import File for Database Import
Method.
4. In Logix Database Options, make any desired changes and click OK.
5. In Logix Database Filtering, make any desired changes and click OK.
6. Select Tag Generation and, under Create, click the blue link to Create tags.
Note: Imported pre-defined tag types are based on the latest version supported by the driver. For more
information, refer to Firmware Versions.
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 114
Error Codes
The following sections define error codes that may be encountered in the server's Event Log. For more
information on a specific error code type, select a link from the list below.
www. ptc.com
115 Allen-Bradley ControlLogix Ethernet Driver
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 116
www. ptc.com
117 Allen-Bradley ControlLogix Ethernet Driver
Possible Cause:
An invalid or corrupt controller project was detected during synchronization.
Possible Solution:
No action is required. The driver attempts synchronization again after 30 seconds.
Note:
Project synchronization is required for the Logical Addressing Modes.
Possible Cause:
A project download was attempted while the device was synchronizing with the controller project.
Possible Solution:
No action is required. The driver attempts synchronization again after 30 seconds.
Note:
Project synchronization is required for the Logical Addressing Modes.
Database error. Data type for reference tag unknown. Setting alias tag
data type to default. | Reference tag = '<tag>', Alias tag = '<tag>', Default
data type = '<type>'.
Error Type:
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 118
Error
Possible Cause:
The data type of the "Alias For" tag referenced in the alias tag declaration could not found in the tag import
file. This data type is necessary to generate the alias tag correctly.
Possible Solution:
The Alias tag assumes the data type specified as the Default Type.
Note:
In RSLogix5000, there is an "Alias For" column in the tag view under the Edit Tags tab where the reference to
the tag, structure tag member, or bit that the alias tag will represent is entered.
See Also:
Logix Options
Database error. Member data type not found in tag import file. Setting
data type to default. | Member data type = '<type>', UDT = '<type>',
Default data type '<type>'.
Error Type:
Error
Possible Cause:
The definition of the data type for a member in the user-defined type could not be found in the tag import
file. The member takes the default type specified in the Device Properties.
Possible Solution:
Verify or correct the definition of the user-defined data types for the specified tags and retry the import.
See Also:
Logix Options
Database error. Data type not found in tag import file. Tag not added. |
Data type = '<type>', Tag name = '<tag>'.
Error Type:
Error
Possible Cause:
The definition of the data type for the specified tag could not be found in the tag import file. Tag is not added
to the database.
Possible Solution:
Verify or correct the definition of the data types for the specified tags and retry the import.
Database error. Error occurred processing alias tag. Tag not added. | Alias
tag = '<tag>'.
Error Type:
www. ptc.com
119 Allen-Bradley ControlLogix Ethernet Driver
Error
Possible Cause:
An internal error occurred processing alias tag. Alias tag could not be generated.
Possible Solution:
Verify or correct the definition of the data types for the specified tags and retry the import.
Possible Cause:
The device returned an error within the Encapsulation portion of the Ethernet/IP packet during a request. All
reads and writes within the request failed.
Possible Solution:
The driver attempts to recover from such an error. If the problem persists, contact Technical Support. This
excludes error 0x02, which is device-related, not driver-related.
See Also:
Encapsulation Error Codes
Database error. Error occurred during forward open request. | CIP error =
<code>, Extended error = <code>.
Error Type:
Error
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 120
Error
Possible Cause:
The device returned an error within the encapsulation portion of the Ethernet/IP packet while uploading the
controller project.
Possible Solution:
The solution depends on the error code returned. If the problem persists, contact Technical Support.
Note:
A project upload is required for the Logical Addressing Modes.
See Also:
Encapsulation Error Codes
Possible Cause:
The device returned an error within the CIP portion of the Ethernet/IP packet while uploading the controller
project.
Possible Solution:
The solution depends on the error code returned. If the problem persists, contact Technical Support.
Note:
A project upload is required for the Logical Addressing Modes.
See Also:
CIP Error Codes
Possible Cause:
1. The packets are misaligned (due to connection/disconnection between the PC and device).
Possible Solution:
1. Place the device on a less noisy network.
www. ptc.com
121 Allen-Bradley ControlLogix Ethernet Driver
Note:
A project upload is required for the Logical Addressing Modes.
Possible Cause:
The device returned an error within the encapsulation portion of the Ethernet/IP packet while uploading the
controller project.
Possible Solution:
The solution depends on the error code returned. If the problem persists, contact Technical Support.
Note:
A project upload is required for the Logical Addressing Modes.
See Also:
Encapsulation Error Codes
Possible Cause:
The device returned an error within the CIP portion of the Ethernet/IP packet while uploading the controller
project.
Possible Solution:
The solution depends on the error code that is returned. If the problem persists, contact Technical Support.
Note:
A project upload is required for the Logical Addressing Modes.
See Also:
CIP Error Codes
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 122
Possible Cause:
1. The packets are misaligned (due to connection/disconnection between the PC and device).
Possible Solution:
1. Place the device on a less noisy network.
Note:
A project upload is required for the Logical Addressing Modes.
Database error. Unable to resolve CIP data type for tag. Setting to default
type. | CIP data type = <type>, Tag name = '<tag>', Default data type =
'<type>'.
Error Type:
Error
Possible Cause:
1. The CIP data type in the import file is unknown.
Possible Solution:
Resolve any errors in RSLogix, then retry the tag export process to produce a new tag import file.
See Also:
Preparing for Automatic Tag Database Generation
Possible Cause:
The device returned an error within the encapsulation portion of the Ethernet/IP packet while uploading the
controller project.
www. ptc.com
123 Allen-Bradley ControlLogix Ethernet Driver
Possible Solution:
The solution depends on the error code returned. If the problem persists, contact Technical Support.
Note:
A project upload is required for the Logical Addressing Modes.
See Also:
Encapsulation Error Codes
Possible Cause:
The device returned an error within the CIP portion of the Ethernet/IP packet while uploading the controller
project.
Possible Solution:
The solution depends on the error code that is returned. If the problem persists, contact Technical Support.
Note:
A project upload is required for the Logical Addressing Modes.
See Also:
CIP Error Codes
Possible Cause:
1. The packets are misaligned (due to connection/disconnection between the PC and device).
Possible Solution:
1. Place the device on a less noisy network.
Note:
A project upload is required for the Logical Addressing Modes.
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 124
Possible Cause:
The Inactivity Watchdog is set too low to allow the project to load.
Possible Solution:
Increase the Inactivity Watchdog value and try again.
www. ptc.com
125 Allen-Bradley ControlLogix Ethernet Driver
Possible Cause:
The Inactivity Watchdog is set too low to allow the project to load.
Possible Solution:
Increase the Inactivity Watchdog value and try again.
Possible Cause:
1. The packets are misaligned due to connection and/or disconnection between the PC and device.
Possible Solution:
1. Place the device on less noisy network.
Possible Cause:
1. There is an incorrect request service code.
3. If this error occurs frequently, there may be an issue with the cabling or device.
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 126
Possible Solution:
1. Increase the retry attempts to allow the driver to recover from this error.
Read request for tag failed due to a framing error. | Tag address =
'<address>'.
Error Type:
Warning
Possible Cause:
1. There is an incorrect request service code.
3. If this error occurs frequently, there may be an issue with the cabling or device.
Possible Solution:
1. Increase the retry attempts to allow the driver to recover from this error.
Block read request failed due to a framing error. | Block size = <number>
(elements), Block start address = '<address>'.
Error Type:
Warning
Possible Cause:
1. The Ethernet connection between the device and the host PC is broken.
Possible Solution:
1. Verify the cabling between the PC and the device.
2. Verify that the correct port has been specified for the named device.
3. Verify that the IP address given to the named device matches that of the actual device.
Block read request failed due to a framing error. | Block size = <number>
(bytes), Block name = '<name>'.
Error Type:
Warning
www. ptc.com
127 Allen-Bradley ControlLogix Ethernet Driver
Possible Cause:
1. There is an incorrect request service code.
3. If this error occurs frequently, there may be an issue with the cabling or device.
Possible Solution:
1. Increase the retry attempts to allow the driver to recover from this error.
Possible Cause:
The device returned an error within the CIP portion of the Ethernet/IP packet during a write request for the
specified tag.
Possible Solution:
The solution depends on the error code(s) returned.
See Also:
CIP Error Codes
Possible Cause:
The device returned an error within the CIP portion of the Ethernet/IP packet during a read request for the
specified tag.
Possible Solution:
The solution depends on the error code(s) returned.
See Also:
CIP Error Codes
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 128
Warning
Unable to read block. | Block size = <number> (bytes), Tag name = '<tag>',
CIP error = <code>, Extended error = <code>.
Error Type:
Warning
Unable to write to tag. Controller tag data type unknown. | Tag address =
'<address>', Data type = <type>.
Error Type:
Warning
Possible Cause:
A write request for the specified tag failed because the controller tag data type is not supported.
Possible Solution:
Contact Technical Support so that support may be added for this type.
See Also:
Addressing Atomic Data Types
Unable to read tag. Controller tag data type unknown. Tag deactivated. |
Tag address = '<address>', Data type = <type>.
Error Type:
Warning
Possible Cause:
A read request for the specified tag failed because the controller tag data type is not supported.
Possible Solution:
Contact Technical Support so that support may be added for this type.
See Also:
Addressing Atomic Data Types
Possible Cause:
A read request for the specified block failed because a controller tag data type within the block is not
supported.
Possible Solution:
www. ptc.com
129 Allen-Bradley ControlLogix Ethernet Driver
Contact Technical Support so that support may be added for this type.
See Also:
Addressing Atomic Data Types
Possible Cause:
A write request for the specified tag failed because the client tag data type is not supported.
Possible Solution:
Change the tag data type to one that is supported.
See Also:
Addressing Atomic Data Types
Unable to read tag. Data type not supported. Tag deactivated. | Tag
address = '<address>', Data type = '<type>'.
Error Type:
Warning
Possible Cause:
A read request for the specified tag failed because the controller tag data type is not supported.
Possible Solution:
Contact Technical Support so that support may be added for this type.
See Also:
Addressing Atomic Data Types
Unable to read block. Data type not supported. Block deactivated. | Block
size = <number> (elements), Block start address = '<address>', Data type =
'<type>'.
Error Type:
Warning
Possible Cause:
A read request for the specified block failed because a controller tag data type within the block is not
supported.
Possible Solution:
Contact Technical Support so that support may be added for this type.
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 130
See Also:
Addressing Atomic Data Types
Unable to write to tag. Data type is illegal for this tag. | Tag address =
'<address>', Data type = '<type>'.
Error Type:
Warning
Possible Cause:
A write request for the specified tag failed because the client tag data type is illegal for the given controller
tag.
Possible Solution:
Change the tag data type to one that is supported. For example, data type Short is illegal for a BOOL array
controller tag. Changing the data type to Boolean would remedy this problem.
See Also:
Addressing Atomic Data Types
Unable to read tag. Data type is illegal for this tag. Tag deactivated | Tag
address = '<address>', Data type = '<type>'.
Error Type:
Warning
Possible Cause:
A read request for the specified tag failed because the client tag data type is illegal for the given controller
tag.
Possible Solution:
Change the tag data type to one that is supported. For example, data type Short is illegal for a BOOL array
Controller tag. Changing the data type to Boolean can remedy the problem.
See Also:
Addressing Atomic Data Types
Unable to read block. Data type is illegal for this block. Block deactivated.
| Block size = <number> (elements), Block start address = '<address>',
Data type = '<type>'.
Error Type:
Warning
Possible Cause:
A read request for block failed because the client tag data type is illegal for the given controller tag.
Possible Solution:
www. ptc.com
131 Allen-Bradley ControlLogix Ethernet Driver
Change the data type for tags within this block to supported types. For example, data type Short is illegal for
a BOOL array Controller tag. Changing the data type to Boolean would remedy this problem.
See Also:
Addressing Atomic Data Types
Unable to write to tag. Tag does not support multi-element arrays. | Tag
address = '<address>'.
Error Type:
Warning
Possible Cause:
A read request for the specified tag failed because the driver does not support multi-element array access
to the given controller tag.
Possible Solution:
Change the tag data type or address to one that is supported.
See Also:
Addressing Atomic Data Types
Unable to read tag. Tag does not support multi-element arrays. Tag
deactivated. | Tag address = '<address>'.
Error Type:
Warning
Possible Cause:
A read request for the specified tag failed because the driver does not support multi-element array access
to the given controller tag.
Possible Solution:
Change the tag data type or address to one that is supported. In response to this error, the tag is
deactivated and not processed again.
See Also:
Addressing Atomic Data Types
Unable to read block. Block does not support multi-element arrays. Block
deactivated. | Block size = <number> (elements), Block start address =
'<address>'.
Error Type:
Warning
Possible Cause:
A read request for tags in this block failed because the driver does not support multi-element array access
to the given controller tag.
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 132
Possible Solution:
Change the data type or address for tags within this block to supported types. In response to this error,
<count> elements of the block are deactivated and not processed again.
See Also:
Addressing Atomic Data Types
Possible Cause:
The Native tag's size (footprint) does not match the expected size that was determined from the project
upload.
Possible Solution:
1. Change the Protocol Mode to Symbolic Mode and try again.
Unable to read tag. Native tag size mismatch. | Tag address = '<address>'.
Error Type:
Warning
Possible Cause:
The Native tag's size (footprint) does not match the expected size determined from the project upload.
Possible Solution:
1. Change the Protocol Mode to Symbolic Mode and try again.
Unable to read block. Native tag size mismatch. | Block size = <number>
(elements), Block start address = '<address>'.
Error Type:
Warning
Possible Cause:
The block of Native tag's size (footprint) does not match the expected size determined from the project
upload.
Possible Solution:
www. ptc.com
133 Allen-Bradley ControlLogix Ethernet Driver
Unable to read block. Native tag size mismatch. | Block size = <number>
(bytes), Block name = '<name>'.
Error Type:
Warning
Possible Cause:
The block of Native tag's size (footprint) does not match the expected size determined from the project
upload.
Possible Solution:
1. Change the Protocol Mode to Symbolic Mode and try again.
Possible Cause:
1. The Ethernet connection between the device and the host PC is broken.
Possible Solution:
1. Verify the cabling between the PC and the device.
2. Verify that the correct port has been specified for the named device.
3. Verify that the IP address given to the named device matches that of the actual device.
Possible Cause:
1. The Ethernet connection between the device and the host PC is broken.
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 134
Possible Solution:
1. Verify the cabling between the PC and the device.
2. Verify that the correct port has been specified for the named device.
3. Verify that the IP address given to the named device matches that of the actual device.
Note:
In response to this error, the tag is deactivated and not processed again.
Possible Cause:
1. The Ethernet connection between the device and the host PC is broken.
Possible Solution:
1. Verify the cabling between the PC and the device.
2. Verify that the correct port has been specified for the named device.
3. Verify that the IP address given to the named device matches that of the actual device.
Note:
In response to this error, elements of the block is deactivated and not processed again.
Possible Cause:
1. The Ethernet connection between the device and the host PC is broken.
Possible Solution:
www. ptc.com
135 Allen-Bradley ControlLogix Ethernet Driver
2. Verify that the correct port has been specified for the named device.
3. Verify that the IP address given to the named device matches that of the actual device.
Note:
In response to this error, elements of the block is deactivated and not processed again.
Possible Cause:
The device returned an error within the CIP portion of the Ethernet/IP packet during a request. All reads and
writes within the request failed.
Possible Solution:
The solution depends on the error code(s) returned.
See Also:
CIP Error Codes
Possible Cause:
The device returned an error within the encapsulation portion of the Ethernet/IP packet during a request. All
reads and writes within the request failed.
Possible Solution:
The driver attempts to recover from such an error. If the problem persists, contact Technical Support. This
excludes error 0x02, which is device-related, not driver-related.
See Also:
Encapsulation Error Codes
Possible Cause:
Resources needed to build a tag could not be allocated. The tag is not added to the project.
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 136
Possible Solution:
Close any unused applications and/or increase the amount of virtual memory and try again.
Possible Cause:
1. There is an incorrect request service code.
Possible Solution:
1. Increase the request attempts to allow the driver to recover from this error.
2. If this error occurs frequently, there may be an issue with the cabling or the device itself. If the error
occurs frequently for a specific tag, contact Technical Support.
Unable to read function file from device. Frame received contains errors. |
Function file = '<name>'.
Error Type:
Warning
Possible Cause:
The address does not exist in the PLC.
Possible Solution:
Check the status and extended status codes returned by the PLC. Extended status codes may not always be
returned and the error information is contained within the status code. The codes are displayed in
hexadecimal.
Note:
Status code errors in the low nibble of the status code indicate errors found by the local node. Errors found
by the local node occur when the KF module cannot see the destination PLC on the network for some reason.
Status code errors in the high nibble of the status code indicate errors found by the PLC. These errors are
generated when the data location is not available in the PLC or not writeable.
See Also:
www. ptc.com
137 Allen-Bradley ControlLogix Ethernet Driver
Possible Cause:
The address does not exist in the PLC.
Possible Solution:
Check the status and extended status codes returned by the PLC. Extended status codes may not always be
returned and the error information is contained within the status code. The codes are displayed in
hexadecimal.
Note:
Status code errors in the low nibble of the status code indicate errors found by the local node. Errors found
by the local node occur when the KF module cannot see the destination PLC on the network for some reason.
Status code errors in the high nibble of the status code indicate errors found by the PLC. These errors are
generated when the data location is not available in the PLC or not writeable.
See Also:
Allen-Bradley documentation for error code definitions
Possible Cause:
An address does not exist in the PLC.
Possible Solution:
Check the status and extended status codes returned by the PLC. Extended status codes may not always be
returned and the error information is contained within the status code. The codes are displayed in
hexadecimal.
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 138
Note:
Status code errors in the low nibble of the status code indicate errors found by the local node. Errors found
by the local node occur when the KF module cannot see the destination PLC on the network for some reason.
Status code errors in the high nibble of the status code indicate errors found by the PLC. These errors are
generated when the data location is not available in the PLC or not writeable.
See Also:
Allen-Bradley documentation for error code definitions
Possible Cause:
The address does not exist in the PLC.
Possible Solution:
Check the status and extended status codes returned by the PLC. Extended status codes may not always be
returned and the error information is contained within the status code. The codes are displayed in
hexadecimal.
Note:
Status code errors in the low nibble of the status code indicate errors found by the local node. Errors found
by the local node occur when the KF module cannot see the destination PLC on the network for some reason.
Status code errors in the high nibble of the status code indicate errors found by the PLC. These errors are
generated when the data location is not available in the PLC or not writeable.
See Also:
Allen-Bradley documentation for error code definitions
Possible Cause:
The address does not exist in the PLC.
Possible Solution:
Check the status and extended status codes returned by the PLC. Extended status codes may not always be
returned and the error information is contained within the status code. The codes are displayed in
hexadecimal.
Note:
www. ptc.com
139 Allen-Bradley ControlLogix Ethernet Driver
Status code errors in the low nibble of the status code indicate errors found by the local node. Errors found
by the local node occur when the KF module cannot see the destination PLC on the network for some reason.
Status code errors in the high nibble of the status code indicate errors found by the PLC. These errors are
generated when the data location is not available in the PLC or not writeable.
See Also:
Allen-Bradley documentation for error code definitions
Possible Cause:
The address does not exist in the PLC.
Possible Solution:
Check the status and extended status codes returned by the PLC. Extended status codes may not always be
returned and the error information is contained within the status code. The codes are displayed in
hexadecimal.
Note:
Status code errors in the low nibble of the status code indicate errors found by the local node. Errors found
by the local node occur when the KF module cannot see the destination PLC on the network for some reason.
Status code errors in the high nibble of the status code indicate errors found by the PLC. These errors are
generated when the data location is not available in the PLC or not writeable.
See Also:
Allen-Bradley documentation for error code definitions
Possible Cause:
The address does not exist in the PLC.
Possible Solution:
Check the status and extended status codes returned by the PLC. Extended status codes may not always be
returned and the error information is contained within the status code. The codes are displayed in
hexadecimal.
Note:
Status code errors in the low nibble of the status code indicate errors found by the local node. Errors found
by the local node occur when the KF module cannot see the destination PLC on the network for some reason.
Status code errors in the high nibble of the status code indicate errors found by the PLC. These errors are
generated when the data location is not available in the PLC or not writeable.
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 140
See Also:
Allen-Bradley documentation for error code definitions
Possible Cause:
The address does not exist in the PLC.
Possible Solution:
Check the status and extended status codes returned by the PLC. Extended status codes may not always be
returned and the error information is contained within the status code. The codes are displayed in
hexadecimal.
Note:
Status code errors in the low nibble of the status code indicate errors found by the local node. Errors found
by the local node occur when the KF module cannot see the destination PLC on the network for some reason.
Status code errors in the high nibble of the status code indicate errors found by the PLC. These errors are
generated when the data location is not available in the PLC or not writeable.
See Also:
Allen-Bradley documentation for error code definitions
Possible Cause:
The address does not exist in the PLC.
Possible Solution:
Check the status and extended status codes returned by the PLC. Extended status codes may not always be
returned and the error information is contained within the status code. The codes are displayed in
hexadecimal.
Note:
Status code errors in the low nibble of the status code indicate errors found by the local node. Errors found
by the local node occur when the KF module cannot see the destination PLC on the network for some reason.
Status code errors in the high nibble of the status code indicate errors found by the PLC. These errors are
generated when the data location is not available in the PLC or not writeable.
See Also:
Allen-Bradley documentation for error code definitions
www. ptc.com
141 Allen-Bradley ControlLogix Ethernet Driver
Possible Cause:
The address does not exist in the PLC.
Possible Solution:
Check the status and extended status codes returned by the PLC. Extended status codes may not always be
returned and the error information is contained within the status code. The codes are displayed in
hexadecimal.
Note:
Status code errors in the low nibble of the status code indicate errors found by the local node. Errors found
by the local node occur when the KF module cannot see the destination PLC on the network for some reason.
Status code errors in the high nibble of the status code indicate errors found by the PLC. These errors are
generated when the data location is not available in the PLC or not writeable.
See Also:
Allen-Bradley documentation for error code definitions
Possible Cause:
The address does not exist in the PLC.
Possible Solution:
Check the status and extended status codes returned by the PLC. Extended status codes may not always be
returned and the error information is contained within the status code. The codes are displayed in
hexadecimal.
Note:
Status code errors in the low nibble of the status code indicate errors found by the local node. Errors found
by the local node occur when the KF module cannot see the destination PLC on the network for some reason.
Status code errors in the high nibble of the status code indicate errors found by the PLC. These errors are
generated when the data location is not available in the PLC or not writeable.
See Also:
Allen-Bradley documentation for error code definitions
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 142
Possible Cause:
The address does not exist in the PLC.
Possible Solution:
Check the status and extended status codes returned by the PLC. Extended status codes may not always be
returned and the error information is contained within the status code. The codes are displayed in
hexadecimal.
Note:
Status code errors in the low nibble of the status code indicate errors found by the local node. Errors found
by the local node occur when the KF module cannot see the destination PLC on the network for some reason.
Status code errors in the high nibble of the status code indicate errors found by the PLC. These errors are
generated when the data location is not available in the PLC or not writeable.
See Also:
Allen-Bradley documentation for error code definitions
Unable to read tag. Data type is illegal for this tag. | Tag address =
'<address>', Data type = '<type>'.
Error Type:
Warning
Possible Cause:
A read request for the specified tag failed because the client tag data type is illegal for the given controller
tag.
Possible Solution:
Change the tag data type to one that is supported. For example, data type Short is illegal for a BOOL array
Controller tag. Changing the data type to Boolean can remedy the problem.
See Also:
Addressing Atomic Data Types
www. ptc.com
143 Allen-Bradley ControlLogix Ethernet Driver
Possible Cause:
The device returned an error within the CIP portion of the Ethernet/IP packet during a read request for the
specified block.
Possible Solution:
The solution depends on the error code(s) returned.
See Also:
CIP Error Codes
Device not responding. Local node responded with error. | DF1 status =
<code>.
Error Type:
Warning
Possible Cause:
The PLC did not respond to the request from the local node. A local node could be an intermediate node like
1756-DHRIO, 1756-CNB, 1761-NET-ENI, and so forth.
Possible Solution:
Refer Allen-Bradley documentation for error code definitions. For example, if STS code '0x02'(hex) is
returned, verify the cabling between the remote node (PLC) and the local node.
See Also:
Allen-Bradley documentation for error code definitions
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 144
Warning
Possible Cause:
This error means that the PLC did not respond to the write request from the local node. A local node could
be an intermediate node like 1756-DHRIO, 1756-CNB, 1761-NET-ENI, and so forth.
Possible Solution:
Refer to Allen-Bradley documentation for STS error code definitions. For example, if the STS code '0x02'(hex)
is returned, verify the cabling between the remote node (PLC) and the local node.
See Also:
Allen-Bradley documentation for error code definitions
Possible Cause:
This error means that the PLC did not respond to the write request from the local node. A local node could
be an intermediate node like 1756-DHRIO, 1756-CNB, 1761-NET-ENI, and so forth.
Possible Solution:
Refer to Allen-Bradley documentation for STS error code definitions. For example, if the STS code '0x02'(hex)
is returned, verify the cabling between the remote node (PLC) and the local node.
See Also:
Allen-Bradley documentation for error code definitions
Unexpected offset encountered for tag. Tag will use Symbolic protocol. |
Tag address = '<address>'.
Error Type:
Warning
www. ptc.com
145 Allen-Bradley ControlLogix Ethernet Driver
Unable to retrieve the identity for device. All tags will use Symbolic
Protocol. | Encapsulation error = <code>.
Error Type:
Warning
Possible Cause:
The device returned an error within the encapsulation portion of the Ethernet/IP packet during a request.
Devices set to a Logical Mode revert to Symbolic Mode until the issue is resolved.
Possible Solution:
The driver attempts to recover from such an error. If the problem persists, contact Technical Support. This
excludes error 0x02, which is device-related, not driver-related.
See Also:
Encapsulation Error Codes
Unable to retrieve the identity for device. All tags will use Symbolic
Protocol. | CIP error = <code>, Extended error = <code>.
Error Type:
Warning
Possible Cause:
The device returned an error within the CIP portion of the Ethernet/IP packet during a request. Devices set to
a Logical Mode revert to Symbolic Mode until the issue is resolved.
Possible Solution:
The solution depends on the error code that is returned. If the problem persists, contact Technical Support.
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 146
See Also:
CIP Error Codes
Unable to retrieve the identity for device. Frame received contains errors.
All tags will use Symbolic Protocol.
Error Type:
Warning
Possible Cause:
1. The packets are misaligned due to connection and/or disconnection between the PC and device.
Possible Solution:
1. The driver recovers from this error without intervention. If this error occurs frequently; there may be
an issue with the cabling, the network, or the device itself.
Possible Cause:
The requested CIP connection size is not supported by the device.
Possible Solution:
Change the CIP connection size to one that is supported by the device.
See Also:
Logix Communications Parameters
www. ptc.com
147 Allen-Bradley ControlLogix Ethernet Driver
Database status. Building tag project(s), please wait. | Tag project count =
<number>.
Error Type:
Informational
Database error. Array tags renamed because they exceed max. character
length. | Array tags = '<tags>', Max. length = <number>, New array tags =
'<tags>'.
Error Type:
Informational
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 148
www. ptc.com
149 Allen-Bradley ControlLogix Ethernet Driver
Informational
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 150
www. ptc.com
151 Allen-Bradley ControlLogix Ethernet Driver
Error Type:
Informational
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 152
www. ptc.com
153 Allen-Bradley ControlLogix Ethernet Driver
Reference Material
Select a link from the list below for more information on a specific topic.
Logix Setup
1761-NET-ENI Setup
Data Highway Plus Gateway Setup
Communications Routing
Serial Gateway Setup
Data Highway Plus Gateway
ControlNet Gateway
EtherNet/IP Gateway Setup
Micrologix 1100 Setup
Choosing a Protocol Mode
Detecting a Change in the Controller Project
SoftLogix 5800 Connection Notes
Glossary
Designator
Designator Description Formats Range
Type*
IP/Host
N/A IP Address or host name. Decimal 0-255
Name
1 Port ID Port to backplane. Decimal 1
Optional Multiple Link, Specifies a way out of the EtherNet/IP interface
Decimal *
Routing Path port pairs module and must equal 1 (port to the backplane).
CPUSlot Link Address Slot number of the ControlLogix processor. Decimal 0-255
Example
123.123.123.123,1,0
This equates to an Ethernet/IP of 123.123.123.123. The port ID is 1 and the CPU resides in slot 0.
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 154
Designator
Designator Description Formats Range
Type*
IP/Host
N/A CompactLogix Ethernet IP Address or host name. Decimal 0-255
Name
1 Port ID Port to backplane. Decimal 1
Optional Multiple Link, Specifies a way out of the Ethernet port and must
Decimal *
Routing Path port pairs equal 1 (port to the backplane).
CPUSlot Link Address Slot number of the CompactLogix processor. Decimal 0-255
Example
123.123.123.123,1,0
This equates to CompactLogix IP of 123.123.123.123. The port ID is 1 and the CPU resides in slot 0.
Designator
Designator Description Formats Range
Type*
IP/Host
N/A 1788-ENBT IP Address or host name. Decimal 0-255
Name
1 Port ID Port to backplane. Decimal 1
Optional Multiple Link, Specifies a way out of the 1788-ENBT interface
Decimal *
Routing Path port pairs module and must equal 1 (port to the backplane).
CPUSlot Link Address Slot number of the FlexLogix processor. Decimal 0-255
Example
123.123.123.123,1,0
This equates to 1788-ENBT IP of 123.123.123.123. The port ID is 1 and the CPU resides in slot 0.
www. ptc.com
155 Allen-Bradley ControlLogix Ethernet Driver
Designator
Designator Description Formats Range
Type*
IP/Host
N/A SoftLogix PC NIC IP Address or host name. Decimal 0-255
Name
1 Port ID Port to backplane. Decimal 1
Specifies a way out of the EtherNet/IP Messaging
Optional Multiple Link,
module and must equal 1 (port to the virtual Decimal *
Routing Path port pairs
backplane).
Slot number of the SoftLogix processor in the virtual
CPUSlot Link Address Decimal 0-255
backplane.
Example
123.123.123.123,1,1
This equates to SoftLogix PC IP Address of 123.123.123.123. The port ID is 1 and the CPU resides in slot 1.
For information on supplementing a device ID with a routing path to a remote backplane, refer to
Communications Routing.
1761-NET-ENI Setup
1761-NET-ENI provides a means of communicating with ControlLogix, CompactLogix, FlexLogix, MicroLogix,
SLC 500, and PLC-5 Series PLCs on Ethernet with the Allen-Bradley ControlLogix Ethernet Driver.
Requirements
MicroLogix, SLC 500, or PLC-5 series PLC supporting Full Duplex DF1 utilizing the CH0 RS232 channel.
1761-NET-ENI Device Series A, B, C, or D.
Notes:
1. For communications parameters, database settings, and project/protocol options, ENI ControlLogix,
CompactLogix, and FlexLogix users should refer to the "Logix Setup" book in the Table of Contents.
2. To turn on the CompactLogix Routing option (located in the utility's ENI IP Addr tab), use the ENI /
ENIW utility supplied by Allen-Bradley. This was tested on an ENI module with Firmware revision 2.31.
The ENI module has a limited number of TCP connections. As such, users should avoid applications that
communicate with the module (such as RSLinx/RSWho) so that connections are available for the driver.
ENI Device ID
The device ID specifies the IP address of the 1761-NET-ENI. Device IDs are specified as the following:
<IP Address>
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 156
Example
123.123.123.123
This equates to an ENI IP of 123.123.123.123. Since the device only supports Full Duplex DF1, a node ID is not
required.
Requirements
EtherNet/IP Interface module.
1756-DHRIO Interface Module with appropriate channel configured for DH+.
SLC500 or PLC-5 series PLC on DH+ network.
Note: DH+ Gateway models do not support automatic tag database generation.
Designator
Designator Description Formats Range
Type*
IP/Host
N/A IP Address or host name. Decimal 0-255
Name
1 Port ID Port to backplane. Decimal 1
Optional Multiple Link, Specifies a way out of the EtherNet/IP interface
Decimal *
Routing Path port pairs module and must equal 1 (port to the backplane).
DHRIOSlot Link Address Slot number of the 1756-DHRIO interface module. Decimal 0-255
DHRIO A and
DH+ channel to use. Alpha
Channel B
DH+ Node ID DH+ node ID of target PLC in Decimal Format.** Decimal 0-99
Example
123.123.123.123,1,2.A.3
This equates to an Ethernet/IP of 123.123.123.123. The DH+ card resides in slot 2: use DH+ channel A and
addressing target DH+ Node ID 3 (dec).
www. ptc.com
157 Allen-Bradley ControlLogix Ethernet Driver
Example
DH+ Node 10 (octal) in RSWho = DH+ Node 8 (decimal) in DH+ Gateway device ID.
It is important to verify communications with the proper controller. In the example above, if 10 was entered
as the DH+ node ID in the DH+ Gateway device ID, then communications would take place with Node 12
(octal equivalent of 10 decimal) and not Node 10 (octal). If Node 12 (octal) does not exist, then the DHRIO
module would return DF1 STS 0x02. This means that the link layer cannot guarantee delivery of the packet.
In short, the DH+ node cannot be located on the DH+ network.
For information on supplementing a device ID with a routing path to a remote DH+ node, refer to
Communications Routing.
For more information on communications parameters, refer to ENI DF1/DH+/ControlNet Gateway
Communications Parameters.
Requirements
EtherNet/IP Interface Module.
1756-CNB or 1756-CNBR Interface Module.
PLC-5C series PLC on ControlNet network.
Note: ControlNet Gateway models do not support automatic tag database generation.
Designator
Designator Description Formats Range
Type*
IP/Host
N/A IP Address or host name. Decimal 0-255
Name
1 Port ID Port to backplane. Decimal 1
Optional Multiple Link, Specifies a way out of the EtherNet/IP communication
Decimal *
Routing Path port pairs module and must equal 1 (port to the backplane).
CNBSlot Link Address Slot Number of the 1756-CNB/CNBR interface module. Decimal 0-255
CNB A and
Port ID The ControlNet channel to use. Alpha
Channel B
ControlNet
Link Address ControlNet node ID of target PLC in decimal format.** Decimal 0-99
Node ID
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 158
Example
123.123.123.123,1,2.A.3
This equates to an Ethernet/IP of 123.123.123.123. The ControlNet card resides in slot 2: use ControlNet
channel A and addressing target ControlNet Node ID 3.
Example
CN node 10 (octal) in RSWho = CN node 8 (decimal) in ControlNet Gateway device ID.
It is important to verify communications with the proper controller. In the example above, if 10 was entered
as the ControlNet node ID in the ControlNet Gateway device ID, communications take place with Node 12
(octal equivalent of 10 decimal), not Node 10 (octal). If Node 12 (octal) does not exist, the CNB module
returns DF1 STS 0x02. This means that the link layer could not guarantee delivery of the packet. In short, the
ControlNet node could not be located on the ControlNet network.
Notes:
1. For more information on supplementing a device ID with a routing path to remote ControlNet node,
refer to Communications Routing.
Requirements
2 or more EtherNet/IP Interface modules (such as 1756-ENBT).
MicroLogix, SLC500, or PLC-5 series PLC with EtherNet/IPconnectivity.
Note: EthernetIP Gateway models do not support automatic tag database generation.
Designator
Designator Description Formats Range
Type*
IP/Host Name N/A IP Address or host name of the local EtherNet/IP Decimal 0-255
www. ptc.com
159 Allen-Bradley ControlLogix Ethernet Driver
Designator
Designator Description Formats Range
Type*
interface module.
1 Port ID Port to backplane. Decimal 1
Optional Multiple Link, Specifies a way out of the EtherNet/IP interface
Decimal *
Routing Path port pairs module and must equal 1 (port to the backplane).
The slot number of the second EtherNet/IP interface
ENBTSlot Link Address Decimal 0-255
module.
A and
ENBTChannel Port ID The Ethernet/IP port to use. Alpha
B
Remote
Link Address The remote IPaddress of the target PLC. Decimal 0-255
IPAddress
Example
123.123.123.123,1,2.A.192.168.1.10
This equates to a local IP of 123.123.123.123. The second Ethernet/IP card resides in slot 2: use port A and
addressing target device with IP 192.168.1.10.
Notes:
1. For information on supplementing a device ID with a routing path to a remote Ethernet/IP device,
refer to Communications Routing.
3. When configuring the device ID, users should verify that the device can be detected using the same
route through RSLinx.
Requirements
EtherNet/IP Interface module.
Local CPU with a serial port.
Remote ControlLogix, CompactLogix, FlexLogix, or SoftLogix CPU with a serial port.
Notes:
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 160
Designator
Designator Description Formats Range
Type*
IP/Host
N/A IP address or host name. Decimal 0-255
Name
1 Port ID Port to backplane. Decimal 1
Optional Multiple Link, Specifies a way out of the EtherNet/IP interface
Decimal *
Routing Path port pairs module and must equal 1 (port to the backplane).
Slot number of the CPU module that contains the
CPUSlot Link Address Decimal 0-255
serial port used for communications.
Serial Port A and
Serial port channel to use. Alpha
Channel B
Station ID DF1 station ID of target PLC in Decimal Format.** Decimal 0-255
Example
123.123.123.123,1,0.A.3
This equates to an Ethernet/IP of 123.123.123.123. The CPU card resides in slot 0: use Channel A (serial
port) and addressing target station ID 3 (dec).
Notes:
1. For information on supplementing a Device ID with a routing path to a remote serial node, refer to
Communications Routing.
3. When configuring the Device ID, users should verify that the device can be detected using the same
route through RSLinx.
<IP or hostname>
Example
123.123.123.123
www. ptc.com
161 Allen-Bradley ControlLogix Ethernet Driver
Communications Routing
Routing provides a way to communicate with a remote device over various networks. It can be thought of as
a bridge between the local device and a remote device even if they are on two different field bus networks.
Access to a remote (destination) backplane allows for direct communication with the supported modules
located on this backplane. Supported modules include the following:
A routing path is a series of backplane hops, whose last hop points to the destination backplane. Each hop
requires a Logix backplane (not a Logix processor). An individual hop can utilize one of the following
networks as its medium:
l ControlNet
l DH+
l TCP/IP (Ethernet/IP)
Important: Routing is not supported for ENI and MicroLogix 1100 models.
The routing path specification begins and ends with the left and right bracket respectively ([ ]). The path itself
is a series of port/link address pairs, identical to the communication path syntax in RSLogix 5000 Message
Configuration dialog.
Designator
Description Formats Range
Type
0-
Port ID Specifies a way out of the interface module in question.* Decimal
65535
If the corresponding port is the backplane, the link address is the slot
number of the interface module that goes out.
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 162
Single Hop
IP Address, Port ID0, [Link Address0, Port ID1, Link Address1, Port ID2], Link Address2.
Multi-Hop (N Hops)
IP Address, Port ID0, [Link Address0, Port ID1, Link Address1, Port ID2, Link Address2, ... Port ID(N+1), Link
Address(N+1), Port ID(N+2)], Link Address(N+2).
Notes:
1. The last port ID in the path (Port ID2 and Port ID(N+2) for single-hop and multi-hop respectively) must
be 1 (port for backplane).
2. Port ID0 must be 1 (port for backplane). Link Address2 and Link Address (N+2) are the slot numbers
of the remote Logix processor/1756-DHRIO module/1756-CNB module.
Port Reference
Interface Module Port 1 Port 2 Port 3
EtherNet/IP Communication Module Backplane Ethernet Network N/A
SoftLogix EtherNet/IP Messaging Virtual Ethernet Network N/A
Module Backplane
1756-DHRIO Backplane DH+ Network on Ch. DH+ Network on Ch.
A B
1756-CNB Backplane ControlNet Network N/A
Application Notes
1. Messages cannot be routed in or out of the same interface module channel more than once within
the path. Doing so results in CIP error 0x01 Ext. error 0x100B.
2. For multiple channel interface modules, messages cannot be routed into and then immediately out of
that same module (using different channels), regardless of whether the message is directed to the
backplane first or avoids the backplane all together. As previously mentioned, the latter is not
supported since each hop requires a ControlLogix backplane. An example would be to route a DH+
message from one DH+ link (such as Channel A of 1756-DHRIO) to another DH+ link (such as
Channel B of same 1756-DHRIO) through one 1756-DHRIO-interface module. This is commonly
referred to as Remote DH+ messaging and is not supported.
Routing Examples
The routing examples below include the entire device ID minus the IP of the local 1756-ENBT. The
perspective of the device ID/routing path is from the local 1756-ENBT Module. Hop descriptions are in the
following form:
For more information, refer to Connection Path Specification. For further details on building a
connection/routing path, refer to Allen-Bradley Publication 1756-6.5.14, pp. 4-5 through 4-8.
In the illustration below, all DH+/ControlNet node IDs are specified in Decimal format. The node ID specified
in the PLC and displayed in RSWho is in Octal format. Descriptions of the colors are as follows:
www. ptc.com
163 Allen-Bradley ControlLogix Ethernet Driver
l Green = Ethernet
l Blue = DH+
l Orange = ControlNet
For more information, refer to Data Highway PlusGateway Setup and ControlNet Gateway Setup.
Example 1
Logix5550 to PLC-5 via DH+ Gateway.
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 164
Example 2
Logix5550 to PLC-5C via CN Gateway.
Example 3
Logix5550 to Logix5550 via routing over DH+.
Example 4
Logix5550 to PLC-5C via CN Gateway, routing over DH+.
Example 5
Logix5550 to Logix5550 via routing over DH+, ControlNet
Example 6
www. ptc.com
165 Allen-Bradley ControlLogix Ethernet Driver
Example 7
Logix5550 to Logix5550 via routing over DH+, ControlNet, Ethernet.
Benefits Detriments
1. All the information needed to make a data
request lies in the client/server tag's address. 1. High device turnaround time when
processing the symbolic addresses.
2. Only the data that is being accessed in the
client/server tags are requested from the PLC. 2. Less requests per multi-request packet
because the size of each request varies.
3. Backward compatible.
Notes:
1. To take advantage of the multi-request packet optimization, as many tags should be represented in a
single packet as possible. Since tag addresses are represented by their ASCII character name in the
packet, the tag addresses should be as short as possible. For example, "MyTag" is preferred over
"MyVeryLongTagNameThatContains36Chars."
2. When the default data type property is set to "Default," automatic tag generation creates tags with a
data type that matches the type in the controller.
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 166
Logical Modes
Logical Non-Blocking and Logical Blocking encapsulate two read protocols. The protocol used is
automatically determined by the driver and is based on the controller revision. The table below summarizes
the modes and the protocols to which they map.
*Deprecated in V21.
The information necessary to perform Logical reads is retrieved in a controller project upload sequence
performed automatically by the driver. For the sake of brevity, the term "Logical Address" represents the
Symbol Instance ID or Physical Address, depending on the protocol used. The Logical Modes avoid the time-
consuming address parsing and lookups that are required for every symbolic request.
Note: These Logical Modes are not available to Serial Gateway models.
Benefits Detriments
1. Contains the maximum request per multi-request
packet because each request is a fixed size.
Note: This mode is preferred when the minority of Structure tag members are referenced by a
client/server.
Benefits Detriments
1. Contents are retrieved on 1. Initialization overhead when uploading the project to
every read. determine the logical addresses.
www. ptc.com
167 Allen-Bradley ControlLogix Ethernet Driver
Benefits Detriments
2. Low device turnaround time
because the client/server tags
are specified in the packet with 2. If the minority of Logix tags are referenced, it is slower
the logical address. than Logical Non-Blocking Mode (because more data is
3. Contains the maximum request being accessed from the PLC than referenced in the
per multi-request packet client/server tags).
because each request is a fixed
size.
Note: This mode is preferred when the majority of Structure tag members are referenced by a
client/server.
Physical reads are CIP requests wherein the DMA address is used to specify a Native tag in a read request.
In Non-Blocking Mode, the byte offset may be required to fully qualify the path to structure members and
array element. For example, the starting DMA address would represent the structure whereas the byte
offset represents the member within the structure. Ultimately the start + offset is the DMA address specified
in the request: all requests are fixed in size (unlike Symbol Instance reads). No matter how deep structures
are nested, the request is the same size in the packet. Physical reads have been deprecated as of FRN V21.
l Downloads in Progress: The driver monitors for both online and offline edits in every request. It
detects if a download occurs while actively reading or writing to Native tags, then follows a project-
change procedure depending on its mode. To enable this synchronization, right-click on the device
and select Properties. In the Logix Options, locate either Online Edits or Offline Edits and select
Yes.
l Online Edits: The driver monitors for online edits in every request. It detects if an online edit occurs
with the controller on the following read or write operation, then follows a project-change procedure
depending on its mode. To enable this synchronization, right-click on the device and select
Properties. In Logix Options, locate Online Edits and select Yes.
l Offline Edits:The driver monitors for offline edits in every request. It detects if an offline edit occurs
with the controller on the following read or write operation, then follows a project-change procedure
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 168
depending on its mode. To enable this synchronization, right-click on the device and select
Properties. In Logix Options, locate Offline Edits and select Yes.
l The controller is polled every 2 seconds to monitor for project change completion.
l A message is posted to the Event Log indicating that a change is no longer detected.
4. During project change, the scenario for online and offline edits is as follows:
l The controller is polled every 2 seconds to monitor for project change completion.
l A message is posted to the Event Log indicating that the change is no longer detected.
4. During project change, the scenario for online and offline edits is as follows:
l After 30 seconds of Symbolic Mode, the driver uploads (synchronizes) the project from the
controller.
l The reads and writes resume using Logical Mode with the new logical addresses.
7. If the Synchronize with Controller options are disabled, the reads and writes resume using Logical
Mode with the old logical addresses.
www. ptc.com
169 Allen-Bradley ControlLogix Ethernet Driver
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 170
1. Ensure that there are no Ethernet-based drivers currently running in RSLinx on the PC.
2. Verify that the EtherNet/IP Message Module is installed in the SoftLogix virtual chassis.
3. Open the Device Properties| General group, locate the device ID value. It should not be "127.0.0.1,
1, <PLC_CPU_slot>". The Device ID should be set to "<specific_IP_address_of_PC>, 1, <PLC_CPU_slot>".
For example, if the PC's IP address is 192.168.3.4 and the SoftLogix CPU is in slot 2 of the virtual
chassis, then the correct device ID would be "192.168.3.4, 1, 2".
www. ptc.com
171 Allen-Bradley ControlLogix Ethernet Driver
Glossary
Term Definition
The means by which Controller tag addresses are specified in data access
Protocol Mode
communication packets.
Due to the symbolic nature of Logix tag-Based Addressing, tags can be of any data
type. This is in contrast to DF1 where file access (such as N7:0) is always a given set of
data types (Word, Short). Because of this flexibility, there needs to be a data type that
tags default to when no data type is explicitly set. This is the case when a tag is created
Default Type
in a client and assigned the data type "Native" or created in the server and assigned
the data type "Default". In these cases, the tag in question is assigned the data type set
as the default type. There are also cases in Automatic Tag Database Generation where
the default type is used to set a server tag's data type.
Utilizing an EtherNet/IP communication module to obtain access to a DH+ or
Gateway ControlNet network from the same backplane. Rack must contain an EtherNet/IP
communication module and a DHRIO or CNB module.
Link Address Unique identifier for an interface module (such as node ID, IP address and so forth).
Stream of data bytes on the wire representing the request(s) being made. Packets are
Packet
limited in size.
A Protocol Mode in which Controller tag addresses are specified by their logical
address in the controller. This provides a performance increase over Symbolic Mode
but requires a project upload to gather the logical addresses. There are two logical
addresses that can be used. If the controller revision is V20 or lower, the logical
address is the Physical (DMA) address. If the controller revision is V21 or higher, the
logical address is the Symbol Instance ID.
Logical Mode
Non-Blocking: Each client/server tag is requested individually from the device. Similar
to Symbolic in nature but much faster in performance.
Blocking: Each Controller tag is requested as a single block of data. Each client/server
tag is updated via cache storage of this data in the server. Much faster performance
over Symbolic Mode.
Port ID Specifies a way out of the interface module in question (such as channel).
Project Synchronization of the driver's project image with that of the controller project. This is
Synchronization required for the Logical Protocol modes.
Routing Utilizing one or more Logix racks to hop to another Logix rack.
A Protocol Mode in which Controller tag addresses are specified by their ASCII
character equivalent. Each client/server tag is requested individually. This provides
immediate access to controller data without a project upload but is overall slower in
Symbolic Mode
performance when compared to any of the Logical Modes. When the default data type
is set to Default, the tag data types are returned from the controller during automatic
tag database generation.
Special assignment of tags to devices whose Protocol Mode is set for Logical Blocking
Tag Division or Logical Non-Blocking Mode. Assignment is based on rules that maximize the
performance of access to these tags.*
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 172
*For more information on tag division, refer to Performance Statistics and Tuning and Optimizing
Communications.
www. ptc.com
173 Allen-Bradley ControlLogix Ethernet Driver
Index
0000-Generic Module 32
0x0001 Extended Error Codes 115
0x001F Extended Error Codes 116
0x00FF Extended Error Codes 116
0x01 114
0x02 114
0x03 114
0x04 114
0x05 114
0x06 114
0x07 114
0x08 114
0x09 114
0x0A 114
0x0B 114
0x0C 114
0x0D 114
0x0E 114
0x0F 114
0x10 114
0x11 114
0x12 114
0x13 114
0x14 115
0x15 115
0x1A 115
0x1B 115
0x1C 115
0x1D 115
0x1E 115
0x1F 115
0x22 115
0x25 115
0x26 115
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 174
0x27 115
1761-NET-ENI 155
Address Descriptions 53
Address Formats 62
Addressing Atomic Data Types 65
Addressing STRING Data Type 66
Addressing Structure Data Types 66
Advanced Addressing: BOOL 69
Advanced Addressing: DINT 75
Advanced Addressing: INT 73
Advanced Addressing: LINT 78
Advanced Addressing: SINT 70
Advanced Addressing:REAL 79
Advanced Channel Properties 18
Allow Function File Block Writes 30
Allow Sub Groups 25
Array Block Size 26
Array Count Limit 29
Array Tags 62, 109
ASCII Files 95
Automatic Tag Database Generation 109
Avg. packets received/sec = <number>. 150
Avg. packets sent/sec = <number>. 150
Avg. tag reads/sec = <number>. 150
Avg. tags/transaction = <number>. 150
BCD 51
BCD Files 97
Binary Files 91
Block read request failed due to a framing error. | Block size = <number> (bytes), Block name =
www. ptc.com
175 Allen-Bradley ControlLogix Ethernet Driver
'<name>'. 126
Block read request failed due to a framing error. | Block size = <number> (elements), Block start address
= '<address>'. 126
Block Transfer Files 103
Boolean 51
Byte 51
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 176
Data Collection 21
Data Types Description 51
Database error. Array tags renamed because they exceed max. character length. | Array tags = '<tags>',
Max. length = <number>, New array tags = '<tags>'. 147
Database error. CIP connection timed out while uploading project information. 124
Database error. Data type for reference tag unknown. Setting alias tag data type to default. | Reference
tag = '<tag>', Alias tag = '<tag>', Default data type = '<type>'. 117
Database error. Data type not found in tag import file. Tag not added. | Data type = '<type>', Tag name =
'<tag>'. 118
Database error. Encapsulation error occurred during fwd. open request. | Encapsulation error =
<code>. 119
Database error. Encapsulation error occurred during register session request. | Encapsulation error =
<code>. 119
Database error. Encapsulation error occurred while uploading program information. | Program name =
'<name>', Encapsulation error = <code>. 121
Database error. Encapsulation error occurred while uploading project information. | Encapsulation error
= <code>. 119
Database error. Error occurred during forward open request. | CIP error = <code>, Extended error =
<code>. 119
Database error. Error occurred processing alias tag. Tag not added. | Alias tag = '<tag>'. 118
Database error. Error occurred while uploading program information. | Program name = '<name>', CIP
error = <code>, Extended error = <code>. 121
Database error. Error occurred while uploading project information. | CIP error = <code>, Extended error
= <code>. 120
Database error. Framing error occurred during forward open request. 119
Database error. Framing error occurred during register session request. 119
Database error. Framing error occurred while uploading program information. | Program name =
'<name>'. 122
Database error. Framing error occurred while uploading project information. 120
Database error. Internal error occurred. 121
www. ptc.com
177 Allen-Bradley ControlLogix Ethernet Driver
Database error. Member data type not found in tag import file. Setting data type to default. | Member
data type = '<type>', UDT = '<type>', Default data type '<type>'. 118
Database error. No more connections available for fwd. open request. 125
Database error. PLC5/SLC/MicroLogix devices do not support this function. 151
Database error. Program group name exceeds max. character length. Program group renamed. | Group
name = '<name>', Max. length = <number>, New group name = '<name>'. 147
Database error. Tag renamed because it exceeds max. character length. | Tag name = '<tag>', Max.
length = <number>, New tag name = '<tag>'. 147
Database error. Unable to resolve CIP data type for tag. Setting to default type. | CIP data type = <type>,
Tag name = '<tag>', Default data type = '<type>'. 122
Database Import Method 28
Database status. | Program count = <number>, Data type count = <number>, Imported tag count =
<number>. 147
Database status. Building tag project(s), please wait. | Tag project count = <number>. 147
Database status. Generating OPC tags. 147
Database status. Importing alias tags. 147
Database status. Importing non-alias tags. 146
Database status. Importing tags from .L5X file. | Schema revision = '<value>', Software revision =
'<value>'. 148
Database status. Retrieving controller project. 147
DataHighwayPlus (TM) Gateway Setup 156
Date 51
Default Data Type Conditions 51
Delete 25
Demote on Failure 23
Demotion Period 23
Details. | IP = '<address>', Vendor ID = <vendor>, Product type = <type>, Product code = <code>,
Revision= <value>, Product name = '<name>', Product S/N = <number>. 148
Detecting a Change in the Controller Project 167
Device not responding. Local node responded with error. | DF1 status = <code>. 143
Device Properties - Auto-Demotion 23
Device Properties - Tag Generation 24
Device Setup 20
Device tag import aborted. 150
DH+ Gateway Device ID 156, 158
Diagnostics 17
Discard Requests when Demoted 23
Display Descriptions 28
Do Not Scan, Demand Poll Only 22
Double 51
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 178
Driver 17, 20
Duty Cycle 18
DWord 51
File Listing 82
Filtering 29
FlexLogix 5400 Addressing for Serial Gateway 54
FlexLogix 5400 Addressing for ENI 54
FlexLogix 5400 Addressing for Ethernet 54
Float 51, 95
Float Files 95
Frame received from device contains errors. 125
Framing error occurred while uploading controller program information. 124
www. ptc.com
179 Allen-Bradley ControlLogix Ethernet Driver
Framing error occurred while uploading program information. | Program name = '<name>'. 124
Framing error occurred while uploading project information. 123
Function Files 104
Generate 24
Global Tags 63
Glossary 171
Help Contents 11
High-Speed Counter File (HSC) 104
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 180
Memory could not be allocated for tag. | Tag address = '<address>'. 135
Message Files 102
Micrologix 1100 Device ID 160
MicroLogix 1100 Setup 160
Micrologix Addressing 55
Micrologix Addressing for ENI 55
Micrologix Addressing for EtherNet/IP Gateway 55
MicroLogix Message Files 101
MicroLogix PID Files 98
Model 20
Module 31
Network Adapter 17
Non-Normalized Float Handling 19
www. ptc.com
181 Allen-Bradley ControlLogix Ethernet Driver
On Device Startup 24
On Duplicate Tag 24
Operating Mode 20
Optimization Method 18
Optimizing Communications 35
Optimizing the Application 37
Ordering of Logix Array Data 67
Output Files 83
Output Words 31
Overview 12
Overwrite 25
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 182
Read request for tag failed due to a framing error. | Tag address = '<address>'. 126
Read/Write transactions = <number>. 150
Real-Time Clock File (RTC) 105
Redundancy 32
Reference Material 153
Request All Data at Scan Rate 22
Request Data No Faster than Scan Rate 22
Request Size 30
Request Timeout 22
Requested CIP connection size is not supported by this device. Automatically falling back to max. size. |
Requested size = <number> (bytes), Max. size = <number> (bytes). 146
Respect Client-Specified Scan Rate 22
Respect Tag-Specified Scan Rate 22
Retry Attempts 23
Routing Examples 162
Scan Mode 21
Serial Gateway Device ID 159
Serial Gateway Setup 159
Setup 14
Short 51
Simulated 21
SLC 500 Fixed I/O Addressing 57
SLC 500 Fixed I/O Addressing for ENI 58
SLC 500 Fixed I/O Addressing for EtherNet/IP Gateway 57
SLC 500 Modular I/O Addressing 58
SLC 500 Modular I/O Addressing for DH+ 58
www. ptc.com
183 Allen-Bradley ControlLogix Ethernet Driver
Tag Generation 24
Tag Hierarchy 109
Tag Import File 28
Tag Scope 63
Tags read = <number>. 149
TCP/IP Port 26, 29
Terminate String Data at LEN 27
The following error(s) occurred uploading controller project from device. Resorting to symbolic
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 184
protocol. 145
The following error(s) occurred uploading controller project from device. Resorting to Symbolic
Protocol. 117
Timeouts to Demote 23
Timer Files 91
Unable to read block. | Block size = <number> (bytes), Tag name = '<tag>', CIP error = <code>, Extended
error = <code>. 128
Unable to read block. | Block size = <number> (elements), Block start address = '<address>', CIP error =
<code>, Extended error = <code>. 127
Unable to read block. | Block size = <number> (elements), Starting address = '<address>', DF1 status =
<code>, Extended status = <code>. 137
Unable to read block. | Block size = <number> (elements), Starting address = '<address>', DF1 status =
<code>. 140
Unable to read block. Block deactivated. | Block size = <number> (bytes), Tag name = '<tag>'. 134
Unable to read block. Block deactivated. | Block size = <number> (elements), Block start address =
'<address>', CIP error = <code>, Extended error = <code>. 143
Unable to read block. Block deactivated. | Block size = <number> (elements), Block start address =
'<address>'. 134
Unable to read block. Block does not support multi-element arrays. Block deactivated. | Block size =
<number> (elements), Block start address = '<address>'. 131
Unable to read block. Controller tag data type unknown. Block deactivated. | Block size = <number>
(elements), Block start address = '<address>', Data type = <type>. 128
Unable to read block. Data type is illegal for this block. Block deactivated. | Block size = <number>
(elements), Block start address = '<address>', Data type = '<type>'. 130
Unable to read block. Data type not supported. Block deactivated. | Block size = <number> (elements),
Block start address = '<address>', Data type = '<type>'. 129
Unable to read block. Frame received contains errors. | Block size = <number> (elements), Starting
address = '<address>'. 136
Unable to read block. Internal memory is invalid. Block deactivated. | Block size = <number> (elements),
Block start address = '<address>'. 143
Unable to read block. Internal memory is invalid. Tag deactivated. | Tag address = '<address>'. 142
Unable to read block. Native tag size mismatch. | Block size = <number> (bytes), Block name =
'<name>'. 133
Unable to read block. Native tag size mismatch. | Block size = <number> (elements), Block start address
= '<address>'. 132
Unable to read block. Tag(s) deactivated. | Block size = <number> (elements), Starting address =
'<address>', DF1 status = <code>, Extended status = <code>. 136, 138
Unable to read function file from device. Frame received contains errors. | Function file = '<name>'. 136
Unable to read function file from device. Tag(s) deactivated. | Function file = '<name>', DF1 status =
www. ptc.com
185 Allen-Bradley ControlLogix Ethernet Driver
www. ptc.com
Allen-Bradley ControlLogix Ethernet Driver 186
Unable to write to tag. Data type is illegal for this tag. | Tag address = '<address>', Data type =
'<type>'. 130
Unable to write to tag. Data type not supported. | Tag address = '<address>', Data type = '<type>'. 129
Unable to write to tag. Native tag size mismatch. | Tag address = '<address>'. 132
Unable to write to tag. Tag does not support multi-element arrays. | Tag address = '<address>'. 131
Unexpected offset encountered for tag. | Tag address = '<address>'. 144
Unexpected offset encountered for tag. Tag will use Symbolic protocol. | Tag address = '<address>'. 144
Unexpected offset/span encountered for tag. | Tag address = '<address>'. 144
Unknown error occurred. 148, 151
Value not supported for an XML element on this model. Automatically setting to new value. | Value =
'<value>', XML element = '{<namespace>}<element>', Model = '<model>', New value =
'<value>'. 151
Word 51
Write All Values for All Tags 18
Write Only Latest Value for All Tags 18
Write Only Latest Value for Non-Boolean Tags 18
Write Optimizations 18
Write request failed due to a framing error. | Tag address = '<address>'. 125
XML element failed post-schema validation. Importing tags from device is not supported for model. Use
alternative element. | XML element = '{<namespace>}<element>', Unsupported model =
'<model>', Alternative XML element = '{<namespace>}<element>'. 151
www. ptc.com