The TCP/IP Interface Object provides the mechanisms to configure a device's TCP/IP network interface. Example of configurable items include the device's IP Address, Network Mask, and Gateway Address.
The underlying physical communications interface associated with the TCP/IP Interface Object shall be any interface that supports the TCP/IP protocol. For example, a TCP/IP Interface Object may be associated with any of the following: an IEEE 802.3 interface, an ATM interface, a serial port running SLIP, a serial port running PPP, etc. The TCP/IP Interface Object provides an attribute that identifies the link-specific object for the associated physical communications interface. The link-specific object is generally expected to provide link-specific counters as well as any link-specific configuration attributes.
Each device shall support exactly one instance of the TCP/IP Interface Object for each TCP/IP-capable communications interface on the module.
Attribute ID | Access Rule | NV | Name | Data Type | Value | Description | |
---|---|---|---|---|---|---|---|
3 | Get, Set ¹ | NV | Configuration Control | DWORD | Bit | Content | Interface control flags |
0..3: | 0..2 | Configuration Method Determines how the device shall obtain its IP-related configuration
| |||||
4: | 0/1 | DNS Enable If 1 (TRUE), the device shall resolve host names by querying a DNS server. | |||||
5..31: | 0 | reserved Reserved for future and shall be set to 0 . | |||||
5 | Get, Set ¹ | NV when Configuration Method is 0. V when obtained via DHCP. | Interface Configuration | STRUCT of: | — | TCP/IP network interface configuration If configured to use a static IP address (Configuration Method value is 0), the Interface Configuration values shall be those which have been statically assigned and stored in NV storage. If configured to use DHCP (Configuration Method value is 2), the Interface Configuration values shall contain the configuration obtained from the DHCP server. The Interface Configuration attribute shall be 0 until the DHCP reply is received. Some devices optionally provide additional, non-CIP mechanisms for setting IP-related configuration (e.g. a web server interface, rotary switch for configuring IP addresses, etc.) When such a mechanism is used, the Interface Configuration attribute shall reflect the IP configuration values in use. | |
IP Address | UDINT | <IP address> | The device's IP address Value of 0 indicates no IP address has been configured.Otherwise, the IP address shall be set to a valid Class A, B or C address and shall not be set to the loopback address (127.0.0.1). | ||||
Network Mask | UDINT | <network mask> | The device's network mask Value of 0 indicates no network mask address has been configured. | ||||
Gateway Address | UDINT | <IP address> | Default gateway address Value of 0 indicates no IP address has been configured.Otherwise, the IP address shall be set to a valid Class A, B or C address and shall not be set to the loopback address (127.0.0.1). | ||||
Name Server | UDINT | <server address> | Primary name server Value of 0 indicates no name server address has been configured.Otherwise, the name server address shall be set to a valid Class A, B or C address. | ||||
Name Server 2 | UDINT | <server address> | Secondary name server Value of 0 indicates no secondary name server address has been configured.Otherwise, the name server address shall be set to a valid Class A, B or C address. | ||||
Domain Name | STRING | <domain name> | Default domain name ASCII characters. Maximum length is 48 characters. Shall be padded to an even number of characters (pad not included in length). A length of 0 shall indicate no Domain Name is configured. | ||||
6 | Get, Set ¹ | NV | Host Name | STRING | <host name> | ASCII characters Maximum length is 64 characters Shall be padded to an even number of characters (pad not included in length). A length of 0 shall indicate no Host Name is configured. | |
8 | Get, Set ¹ | NV | TTL Value | USINT | 1..255 | Time-to-Live (TTL) value for EtherNet/IP multicast packets
| |
9 | Get, Set ¹ | NV | Mcast Config | STRUCT of: | <multicast address> | IP multicast address configuration The Mcast Config attribute contains the configuration of the device's IP multicast addresses to be used for EtherNet/IP multicast packets. There are three elements to the Mcast Config structure:
| |
Alloc Control | USINT | 0..2 | Multicast address allocation control word Determines whether multicast addresses are generated via algorithm or are explicitly set.
| ||||
Reserved | USINT | 0 | Shall be 0. | ||||
Num Mcast | UINT | <number> | Number of IP multicast addresses to allocate for EtherNet/IP The number of IP multicast addresses allocated, starting at Mcast Start Addr. Maximum value is device specific, however shall not exceed the number of EtherNet/IP multicast connections supported by the device. | ||||
Mcast Start Addr | UDINT | <start address> | Starting multicast address from which to begin allocation IP multicast address (Class D). A block of "Num Mcast" addresses is allocated starting with this address. | ||||
10 | Get ², Set | NV | SelectAcd | BOOL | 0/1 | Activates the use od ACD.
| |
11 | Get ², Set | NV | LastConflictDetected | STRUCT of: | — | Structure containing information related to the last IP Address conflict detected This attribute shall be updated by the device whenever an incoming ARP packet is received that represents a conflict with the device's IP address as described in IETF RFC 5227. To reset this attribute the Set_Attribute_Single service is invoked with an attribute value of all 0. Values other than 0 shall result in an error response (status code 0x09, Invalid Attribute Value). | |
AcdActivity | USINT | 0..3 | State of ACD activity when last conflict detected
| ||||
RemoteMAC | Array of 6 USINT | <MAC address> | MAC Address of remote node from the ARP PDU in which a conflict was detected The IEEE 802.3 source MAC address from the header of the received Ethernet packet which was sent by a device reporting a conflict. | ||||
ArpPdu | Array of 28 USINT | <ARP response PDU bytes> | Copy of the raw ARP PDU in which a conflict was detected ARP Response PDU in binary format
| ||||
13 | Get, Set ¹ | NV | Encapsulation Inactivity Timeout | UINT | 0, 1..3600 | Number of seconds of inactivity before TCP connection is closed
When set, the Encapsulation Inactivity Timeout attribute shall be saved in non-volatile memory and applied to all subsequently-opened connections. Devices should also, if feasible, apply Encapsulation Inactivity Timeout changes to all currently-opened connections. |
Table Footnotes:
¹ Set access only with application's Set function
² Get access only with application's Get function