Disclaimer Portions of this document are intended solely as an outline of CIP™ methodologies to
be followed during the maintenance and operation of N-Tron® Series NT24k®
equipment. It is not intended as a step-by-step guide or a complete set of all
procedures necessary and sufficient to complete all operations.
While every effort has been made to ensure that this document is complete and
accurate at the time of release, the information that it contains is subject to change.
Red Lion is not responsible for any additions to or alterations of the original document.
Industrial networks vary widely in their configurations, topologies, and traffic
conditions. This document is intended as a general guide only. It has not been tested
for all possible applications, and it may not be complete or accurate for some
situations.
Purpose This manual gives specific information on how to apply and use the CIP functions on
the N-Tron series NT24k switches.
Audience The manual is intended for use by personnel who are responsible for operating and
maintaining network equipment; consequently, it assumes a basic working knowledge
of general switch functions and the Industrial Protocol (IP).
Trademark
Acknowledgments
Red Lion Controls acknowledges and recognizes ownership of the following
trademarked terms used in this document.
•Ethernet™ is a registered trademark of Xerox Corporation
•EtherNet IP™and CIP™ are registered trademarks of ODVA™
•All other company and product names are trademarks of their respective
owners
Certifications Red Lion Controls, Inc. ensures that this device meets all the ODVA technology and
standards guidelines for the Common Industrial Protocol (CIP) for industrial
automation.
Conventions The following conventions are used throughout this manual to show information:
Note: Emphasizes important information or calls your attention to related
features or instructions.
N-Tron® Series NT24k CIP™ Manual- i -
PREFACEREVISED 2017-03-15
D
RAWING NO. LP0990-B
Related Publications
and Document
Updates
This document is revised only at major releases and therefore, may not always
contain the latest product information. As needed, Tech Notes and or other product
documentation can be provided between major releases to describe any new
information or document changes.
Also, as part of the NT24k software, there is an online web-based help that describes
all management related features.
The latest online version of this document and all product updates can be accessed at
the Technical Resources page on the Red Lion web site
- ii -N-Tron® Series NT24k CIP™ Manual
PREFACE REVISED 2017-03-15
D
RAWING NO. LP0990-B
Revision History The following information lists the release history of this document.
Issue / Revision DateContent Description
July 2013Initial version with support for switches in the NT24k product line.
August 23, 2013Added missing documentation for the Power Configuration attribute
of the N-Tron object.
October 2013Added faceplate installation instructions and quick reference guide.
March 2014Added a description of the faceplate error messages.
October 2014Added support for NT24k-8TX, NT24k-8TX-POE, and NT24k-16TX
switches.
November 2014Added 802.1X port role.
March 2015Revised face plates for NT24k-8TX, NT24k-8TX-POE, NT24k-16TX
INTRODUCTION TO CIP™ COMPONENTSREVISED 2017-03-15
CIP™ C
OMPONENTSDRAWING NO. LP0990-B
CHAPTER 1
INTRODUCTION TO CIP™ COMPONENTS
EtherNet/IP™, better known as the Common Industrial Protocol (CIP™), was
designed for use in process control and industrial automation applications. CIP was
designed to provide consistent device access to eliminate the need for vendor specific
software for configuration and monitoring of individual devices.
Red Lion Controls N-Tron® series NT24k® switches with CIP support can be used to
communicate with other industrial devices, such as Rockwell controllers.
1.1CIP™ Components
The following CIP components are available with Red Lion Controls N-Tron series
NT24k CIP enabled switches.
1.1.1Electronic Data Sheets
An electronic data sheet for each NT24k switch is provided.
In a Rockwell environment EDS files are installed using the “EDS Hardware
Installation Tool”. This allows NT24k switches to be recognized in an RSLinx
environment.
EDS and associated Icon files for each NT24k switch are included in the
Installation Kit
file in the subdirectory “Cip”.
CIP
1.1.2CIP Objects
“Objects” are used to organize various information about the switch. There are four
types of objects provided. Three are specified by the ODVA™, and one is N-Tron
series specific:
•Identity object
•TCP/IP Interface object
•Ethernet Link object
•N-Tron switch object
Standard “services” are associated with objects. Services exist for reading an attribute,
setting an attribute, resetting a device, etc. See references [1] and [2] for specific
details.
The following sections describe the attributes associated with each object type, such
as attribute Id number and data format. All attributes can be read, but only some can
be set, as shown by the “Set” column.
N-Tron® Series NT24k® CIP™ Manual- 1 -
INTRODUCTION TO CIP COMPONENTSREVISED 2017-03-15
CIP™ C
OMPONENTSDRAWING NO. LP0990-B
1.1.2.1Identity Object
The identity object class (Class code = 0x01) and instance attributes are implemented
as defined by CIP Vol 1, 5-2 [1]. There is one instance (1) of this object. Service code
(0x32) will get all attributes, including optional attributes. Table 1-1 summarizes the
attributes in the Identity object.
Table 1-1 Identity Object Attributes
IDNameSetFormatDescription
1Vendor IDUINT (16)1006. This is N-Tron’s ODVA EtherNet/
2Device TypeUINT (16)0x0C. Communications Adapter
3Product CodeUINT (16)Switch product code:
4Major RevisionUSINT (8)Major version of CIP implementation
Minor RevisionUSINT (8)Minor version of CIP implementation
INTRODUCTION TO CIP™ COMPONENTSREVISED 2017-03-15
CIP™ C
OMPONENTSDRAWING NO. LP0990-B
IDNameSetFormatDescription
5StatusWORD (16)Summary status of device. Bits:
Bit 0: if set, device has an owner
Bit 1: reserved
Bit 2: if set, device has non-default
configuration
Bit 3: reserved
Bits 4-7: Extended device status – not
used
Bit 8: Minor recoverable fault
Bit 9: Minor unrecoverable fault
Bit 10: Major recoverable fault
Bit 11: Major unrecoverable fault
Bits 12-15: reserved (see Table 1-2)
(see Identity Object Fault Table 1-2)
6Serial NumberUDINT (32)Serial number of the device. This is the
last 4 octets of the base switch MAC
7Product NameSHORT_STRINGSwitch Model Name.
EX: NT24k
15 Assigned_NameSet STRINGIThis is the user assigned switch name
17 Geographic_Location Set STRINGIThis is the user assigned switch
location
Table 1-2 defines fault bits within the Status attribute of the Identity Object.
Table 1-2 Identity Object Fault Bit Definitions
BitCalledDefinition
8Minor Recoverable Fault Power supply 1, Power supply 2, N-Ring Full, System, Port
utilization, Temperature, N-Link partner is down, N-Link
integrity fault
Configuration device error
managers, Boot loader version, N-Link partner port
unknown, N-Link multiple masters, N-Link control fault, NLink configuration fault, Settings fault
none
1.1.2.2TCP/IP Interface Object
The TCP/IP Interface object class (Class code = 0xF5) and instance attributes are
implemented as defined by CIP Vol 2, 5-3 [2]. There is only one instance (1) of this
object. Table 1-3 summarizes the attributes in the TCP/IP Interface object.
N-Tron® Series NT24k® CIP™ Manual- 3 -
INTRODUCTION TO CIP COMPONENTSREVISED 2017-03-15
CIP™ C
OMPONENTSDRAWING NO. LP0990-B
Table 1-3 TCP/IP Interface Object Attributes
IDNameSetFormatDescription
1StatusDWORD (32)Interface status
Bit 0: interface configuration attrib not
configured
Bit 1: interface configuration attrib is
valid
2Configuration
Capability
3Configuration
Control
4Physical Link ObjectSTRUCT of:
Path SizeUINT (16)Size of Path
PathPadded EPATHLogical segments identifying the
5Interface
Configuration
IP AddressSetUDINT (32)The device’s IP address
Network MaskSetUDINT (32)The device’s network mask
Gateway AddressSetUDINT (32)Default gateway address
Name ServerSetUDINT (32)Primary name server
Name Server 2SetUDINT (32)Secondary name server
Domain NameSetSTRINGDefault domain name
6Host NameSetSTRINGHost name
8TTL ValueUSINTTTL Value for EtherNet/IP multicast
9Mcast ConfigSTRUCT of:IP multicast configuration
Alloc ControlUSINTMulticast address allocation control
ReservedUSINTReserved for future use. Shall be 0
Num McastUINTNumber of IP multicast addresses to
Mcast Start AddrUSDINTStarting multicast address from which
13 Encapsulation
Inactivity Timeout
DWORD (32)Interface capability flags. Bits:
Bit 0: BOOTP client capable
Bit 1: DNS client capable
Bit 2: DHCP client capable
Bit 3: DHCP-DNS update capable
Bit 4: configuration is settable
Bit 5: through Bit 31 reserved
SetDWORD (32)Interface control flags
Bits 0-3:
0: use interface configuration
previously stored
1: get interface configuration via
BOOTP
2: get interface configuration via
DHCP
3: through Bit 15 reserved
4 =1 device shall resolve host
names by querying a DNS
server
physical link object
STRUCT of:
packets. Default is 1. Range is 1-255
word. Determines how addresses are
allocated
allocate for EtherNet/IP
to begin allocation
SetUINTNumber of seconds of inactivity before
TCP connection is closed. 0 = Disable,
1-3600 = timeout in seconds, Default =
120
- 4 -N-Tron® Series NT24k® CIP™ Manual
INTRODUCTION TO CIP™ COMPONENTSREVISED 2017-03-15
CIP™ C
OMPONENTSDRAWING NO. LP0990-B
1.1.2.3Ethernet Link Object
The Ethernet Link object class (Class code = 0xF6) and instance attributes are
implemented as defined by CIP Vol 2, 5-4 [2].There is one instance of this object per
switch port where instance 1 = port 1, instance 2 = port 2, etc. As per the CIP
specification, the get all service code (0x01) will get all attributes, excluding vendor
extensions. Service code (0x32) will get all attributes, including the N-Tron vendor
extensions. Table 1-4 summarizes the attributes in the Ethernet
Table 1-4 Ethernet Link Object Attributes
IDNameSetFormatDescription
1Interface SpeedUDINT (32)Interface speed currently in use.
2Interface FlagsDWORD (32)Interface status flags Bit map of
3Physical AddressARRAY of 6
USINTs (8)
4Interface CountersSTRUCT of:
In OctetsUDINT (32)Octets received on the interface
In Ucast PacketsUDINT (32)Unicast packets received on the
In Nucast PacketsUDINT (32)Non-unicast packets received on the
In DiscardsUDINT (32)Inbound packets received on the
In ErrorsUDINT (32)= 0. Not available.
In Unknown ProtosUDINT (32)= 0. Not available.
Out OctetsUDINT (32)Octets sent on the interface
Out Ucast PacketsUDINT (32)Unicast packets sent on the interface
Out Nucast PacketsUDINT (32)Non-unicast packets sent on the
Out DiscardsUDINT (32)Outbound packets discarded
Out ErrorsUDINT (32)= 0. Not available.
5Media CountersSTRUCT of:
Alignment ErrorsUDINT (32)Frames received that are not an
FCS ErrorsUDINT (32)Frames received that do not pass the
Single CollisionsUDINT (32)Successfully transmitted frames which
Multiple CollisionsUDINT (32)Successfully transmitted frames which
SQE Test ErrorsUDINT (32)= 0. Not available.
Speed in Mbps (e.g., 0, 10, 100, 1000,
etc.)
interface flags. See section 5-4.3.2.1.
Includes Link status, duplex mode,
auto-negotiation status, etc
MAC address of switch port
interface
interface
interface but
Inbound packets that contain errors
(does not
Inbound packets with unknown protocol
interface
Outbound packets that contain errors
integral number
FCS check
experienced exactly one collision
experienced more than one collision
Number of times SQE test error
message is
Link object.
discarded
include In Discards)
of octets in length
generated
N-Tron® Series NT24k® CIP™ Manual- 5 -
INTRODUCTION TO CIP COMPONENTSREVISED 2017-03-15
CIP™ C
OMPONENTSDRAWING NO. LP0990-B
IDNameSetFormatDescription
Deferred
Transmissions
UDINT (32)Frames for which first transmission
attempt is delayed because the
medium is busy
Late CollisionsUDINT (32)Number of times a collision is detected
than 512 bit times into the
later
transmission of a packet
Excessive CollisionsUDINT (32)Frames for which transmission fails due
excessive collisions
to
MAC Transmit ErrorsUDINT (32)= 0. Not available.
Frames for which transmission fails
due to an
internal MAC sub layer
transmit error
Carrier Sense ErrorsUDINT (32)= 0. Not available.
Times that the carrier sense condition
was lost
or never asserted when
attempting to transmit a frame
Frame Too LongUDINT (32)Frames received that exceed the
maximum
permitted frame size
MAC Receive ErrorsUDINT (32)= 0. Not available.
Frames for which reception on an
interface fails
due to an internal MAC
sub layer receive error
6Interface ControlSTRUCT of:
Control BitsSet WORD (16)Interface Control Bits. Includes auto-
negotiation and duplex settings.
Forced Interface
Speed
SetUINT (16)Speed at which the interface shall be
forced to
operate. Speed in Mbps (10,
100, 1000, etc.)
7Interface TypeUSINT (8)Type of interface: twisted pair, fiber,
internal,
etc
8Interface StateUSINT (8)Current state of the interface:
INTRODUCTION TO CIP™ COMPONENTSREVISED 2017-03-15
CIP™ C
OMPONENTSDRAWING NO. LP0990-B
IDNameSetFormatDescription
108 RX Multicast Packet
Rate
109 TX Broadcast Packet
Rate
110 RX Broadcast Packet
Rate
111 TX Multicast PacketsUDINT32Total number of TX multicast packets
112 RX Multicast PacketsUDINT32Total number of RX multicast packets
113 TX Broadcast
Packets
114 RX Broadcast
Packets
115 Port RoleUDINT32Bit mask of port roles
UDINT32Number of RX multicast packets per
UDINT32Number of TX broadcast packets per
UDINT32Number of RX broadcast packets per
UDINT32Total number of TX broadcast packets
UDINT32Total number of RX broadcast packets
second
second
second
Bit 0: RSTP
Bit 1: N-Ring
Bit 2: N-Link Control
Bit 3: N-Link Partner
Bit
4: N-Link Coupler
Bit 5: 802.1X
1.1.2.4NT24k® Object
The N-Tron object (Class code = 0xC0) is a vendor specific object and is implemented
as defined by CIP Vol 1, 4 [1]. There is only one instance (1) of this object. Table 1-5
summarizes the attributes of the N-Tron object.
Table 1-5 N-Tron Object Attributes
IDNameSetFormatDescription
1Device Up TimeUDINT (32)Number of seconds since device was
2Port CountUDINT (32)Total port count
3Valid PortsLWORD (64)
DINT[2]
4Global Admin StatusLWORD (64)
DINT[2]
5Global Link StatusLWORD (64)
DINT[2]
6System FaultsDWORD (32)Bit 00: Power Supply 1
powered up
AB:
0 = Invalid Port, 1=Port Exists on device
Bit 0: Port 1
Bit 1: Port 2 etc
AB:
0 = Port Disabled, 1 = Port Enabled
Bit 0: Port 1
Bit 1: Port 2 etc
AB:
0 = Link Down, 1 = Link Up
Bit 0: Port 1
Bit 1: Port 2 etc
Bit 01: Power Supply 2
Bit 02: N-Ring Fault (complete)
Bit 03: N-Ring Partial Fault (low port)
Bit 04: N-Ring Partial Fault (high port)
Bit 05: N-Ring Multiple Managers
Bit 06: System error
Bit 07: the configuration on an installed
configuration device is invalid
Bit 08: N-Link Fault
Bit 09: Boot loader version mismatch
Bit 10: Port Utilization Alarm
Bit 11: Temperature Alarm
Bit 12: Settings fault
N-Tron® Series NT24k® CIP™ Manual- 7 -
INTRODUCTION TO CIP COMPONENTSREVISED 2017-03-15
CIP™ C
OMPONENTSDRAWING NO. LP0990-B
IDNameSetFormatDescription
7IGMP Querier StatusUSINT (8)Query Status:
0 = Disabled, 1 = Active (manual),
2 = Active (Auto), 3 = Backup (Auto)
[enabled but not active]
8IGMP VersionUSINT (8)IGMP Version (V1, V2, V3, etc.)
9IGMP
Resource Usage
USINT (8)Percent of maximum capacity. Takes
into account the number of groups used
per max groups and any other possible
resource limitations (0-100)
10 IGMP Active QuerierUDINT (32)IP of the active IGMP querier
11 CPU UsageUSINT (8)Percent of usage (0-100)
12 Class 1 ConnectionsUINT (16)Number of CIP EtherNet/IP class 1
(multicast) connections
13 Class 3 ConnectionsUINT (16)Number of CIP EtherNet/IP class 3
(unicast) connections
14 Temperature
Upper Threshold
15 Temperature
Lower Threshold
Alarm
Alarm
SetINT (16)Upper temperature (C) at which to
declare an alarm
SetINT (16)Lower temperature (C) at which to
declare an alarm
16 Contact StatusBYTE (8)2 Bits per contact. 00=Not Present,
01=Open, 10=Closed
17 Temperature_CINT (16)Temperature in degrees C. 0x7FFF =
Not Supported on
device
18 Temperature_FINT (16)Temperature in degrees F. 0x7FFF =
Not Supported on
device
19 Reset MIB CountsSetLWORD (64)Reset port MIB counters.
(1 bit per port to reset)
20 Device MAC
Address
ARRAY of 6
USINTs (8)
MAC address of device
21 Device RoleUDINT (32)Bit mask of device roles
Bit 0: N-Ring Manager
Bit 1: N-Ring Member
Bit 2: N-Ring AutoDetect
Bit 3: N-Link Master
Bit 4: N-Link Slave
Bit 5: N-Link Coupler
22 Config Device StatusBYTE (8)0 = Not Supported, 1 = Not Present,
2 = Present
23 System
Configuration
SetUDINT (32)Bit mask of system config. Bits=
Bit 0: GET: Changes have been made
that have not been
saved
SET: Save system configuration
to flash.
Bit 1: GET: Changes have been made
that require a reboot
to take
effect.
SET: Shutdown and reboot
device*
24 System Firmware
Version String
25 System Boot Loader
Version String
SHORT_STRI
SHORT_STRI
NG Human readable representation of
firmware version string.
NG Human readable representation of boot
loader version string
- 8 -N-Tron® Series NT24k® CIP™ Manual
INTRODUCTION TO CIP™ COMPONENTSREVISED 2017-03-15
CIP™ C
OMPONENTSDRAWING NO. LP0990-B
IDNameSetFormatDescription
26 System Fault StringSTRINGIHuman readable representation of error
status. May contain multiple errors.
Length is contained as part of the
STRINGI data type
27 Power ConfigurationUDINT (32)4 Bits per power supply
0000 = DC Power, 0001 = AC Power,
1111 = Unknown.
Power supply 1 configuration is in bits
0-3
Power supply 2 configuration is in bits
4-7
* ID 23 Bit 1 SET: This feature will be removed in a future release.
1.1.2.5CIP Services
Table 1-6 presents a summary of the supported services as defined by CIP Vol 1,
Appendix A: Explicit Messaging Services [1].
Table 1-6 Summary of Supported CIP Services
Service
Code
1Get_Attributes_Allyesyesyesyes
5ResetYes – reset
14Get_Attribute_Singleyesyesyesyes
16Set_Attribute_Single Attributes
Vendor
Specific
50Get_All_Attributes –
Object
Specific
76Get_And_ClearAttributes
Service DescriptionIdentityTCP/IPEthernet
switch or
restore
factory
configuration
15,17
yesyes
including vendor
defined attributes
Attributes
3,5
Link
Attributes
6,9, 102104
4,5
1.1.3Accessing Data
N-Tron
Attributes
14,15,19,23
1.1.3.1Explicit Messaging
Explicit messaging refers to a request/response form of communications over a CIP
(TCP/IP) connection. Applications can use explicit messaging, for example, to invoke
the “Get All Attributes” service and read all attributes of the Identity object.
N-Tron® Series NT24k® CIP™ Manual- 9 -
INTRODUCTION TO CIP COMPONENTSREVISED 2017-03-15
CIP™ C
OMPONENTSDRAWING NO. LP0990-B
1.1.3.2I/O Connections
I/O connections are used to send data (grouped in assemblies) between devices
periodically. The interval between sends is the “Requested Packet Interval”, or RPI.
The N-Tron Series switch assemblies (Input, Output, and Configuration)
are defined in
Table 1-7.
Table 1-7 Switch I/O and Configuration NT24k
SwitchAssembly NumberSize (bytes)
Input (to switch)*1014
Output (from switch)102104
Configuration*1030
* - not currently used
In an RSLogix 5000 environment, these assemblies are configured in the “Connection
Parameters” panel of the Generic Ethernet Module.
Note: Input and output assemblies are reversed.
More information is contained in Chapter 2 Rockwell RSLogix 5000 - AOI for
Add-On Instruction installation.
- 10 -N-Tron® Series NT24k® CIP™ Manual
ROCKWELL RSLOGIX 5000 - AOIREVISED 2017-03-15
ATERIAL PREREQUISITESDRAWING NO. LP0990-B
M
CHAPTER 2
ROCKWELL RSLOGIX 5000 - AOI
2.1Material Prerequisites
•N-Tron® series Switch
•RSLogix Add-On Instructions (AOI)
2.2Installation Instructions
2.2.1Software Installation Prerequisites
•RSLogix 5000 version 17 or later
•N-Tron switch with firmware version that includes CIP™ support
2.2.2Summary of Installation Steps
1. Import the Add-On Instruction (AOI)
2. Add your NT24k® switch to the I/O Configuration tree
3. Add an instance of the AOI in your application
4. Create and configure tags for the AOI
2.3Configuration of RSLogix Project
Note: The screen shots shown in the RSLogix5000 portion of this document
are taken from the RSLogix5000 demonstration project file “NTron_Demo.ACD” which is included in the CIP Installation Kit file
under the subdirectory “RSLogix5000”.
2.3.1Importing an Add-On Instruction
All NT24k® Add-On Instruction files are included in the CIP Installation Kit file in the
subdirectory “RSLogix5000\AOI_export”.
1. Open an RSLogix project.
2. Import the N-Tron Add-On Instruction (AOI).
3. In the controller organizer window, right click “Add-On Instructions” folder,
select “Import Add-On Instruction” and browse to the folder containing AOI_NTron_*.L5X files. Import an AOI for each switch type installed.