Ethernet Link Object
Original instructions
Overview
The Ethernet Link object consists of the instances, attributes and services described below.
Class ID
F6 (hex), 246 (decimal)
Instance IDs
The Ethernet Link object presents the following instance values:
Attributes
The Ethernet Link object presents the following attributes:
Instance ID = 0 (class attributes):
Attribute ID
Description
GET
SET
01
Revision
X
02
Max Instance
X
03
Number of Instances
X
X = supported
— = not supported
Instance ID = 1...5 (instance attributes):
Attribute ID
Description
Type
GET
SET
Value
hex
dec
01
01
Interface Speed
UDINT
X
Valid values include:
0, 10000000, 100000000
02
02
Interface Flags
DWORD
X
Bit 0: Link Status
0 = Inactive
1 = Active
Bit 1: Duplex Mode
0 = half duplex
1 = full duplex
Bits 2—4: Negotiation Status
3 = successfully negotiated speed and duplex
4 = forced speed and link
Bit 5: Manual Setting Requires Reset
0 = automatic
1 = device need reset
Bit 6: Local Hardware Fault detected
0 = no event
1 = event detected
03
03
Physical Address
ARRAY of 6 USINT
X
Module MAC Address
04
04
Interface Counters
STRUCT
X
    In octets
UDINT
Octets received on the interface
    In Ucast Packets
UDINT
Unicast packets received on the interface
    In NUcast Packets
UDINT
Non-unicast packets received on the interface
    In Discards
UDINT
Inbound packets received on the interface, but discarded
    In Errors
UDINT
Inbound packets that contain detected errors (does not include In Discards)
    In Unknown Protos
UDINT
Inbound packets with unknown protocol
    Out Octets
UDINT
Octets sent on the interface
    Out Ucast Packets
UDINT
Unicast packets sent on the interface
    Out NUcast Packets
UDINT
Non-unicast packets sent on the interface
    Out Discards
UDINT
Outbound packets discarded
    Out Errors
UDINT
Outbound packets that contain detected errors
05
05
Media Counters
STRUCT
X
    Alignment Errors
UDINT
Frames that are not an integral number of octets in length
    FCS Errors
UDINT
CRC error detected—Frames received with a dtected FCS checksum error
    Single Collisions
UDINT
Successfully transmitted frames that experienced exactly one collision
    Multiple Collisions
UDINT
Successfully transmitted frames that experienced more than one collision
    SQE Test Errors
UDINT
Number of times the SQE test error is detected
    Deferred Transmissions
UDINT
Frames for which first transmission attempt is delayed because the medium is busy
    Late Collisions
UDINT
Number of times a collision is detected later than 512 bittimes into the transmission of a packet
    Excessive Collisions
UDINT
Frames for which transmission is not successful due to excessive collisions
    MAC Transmit Errors
UDINT
Frames for which transmission is not successful due to internal MAC sublayer transmit detected error
    Carrier Sense Errors
UDINT
Times that the carrier sense condition was lost or not asserted when attempting to transmit a frame
    Frame Too Long
UDINT
Frames received that exceed the maximum permitted frame size
    MAC Receive Errors
UDINT
Frames for which reception on an interface is not successful due to an internal MAC sublayer receive detected error
06
06
Interface Control
STRUCT
X
X
API of the connection
    Control Bits
WORD
Bit 0: Auto-negotiation
0 = Disabled
1 = Enabled
Note: When auto-negotiation is enabled, the detected error 0x0C (Object State Conflict) is returned when attempting to set either:
  • Forced Interface Speed, or
  • Forced Duplex Mode
Bit 1: Forced Duplex Mode (if auto-negotiation bit = 0)
0 = half duplex
1 = full duplex
    Forced Interface Speed
UINT
Valid values include:
10000000, 100000000
Note: Attempting to set any other value returns the detected error 0x09 (Invalid Attribute Value)
10
16
Interface Label
SHORT_STRING
X
A fixed textual string identifying the interface, that should include ‘internal’ for internal interfaces. Maximum number of characters is 64.
X = supported
— = not supported
Services
The Ethernet Link object performs the following services upon the listed object types:
Service ID
Description
Class
Instance
hex
dec
01
01
Get_Attributes_All
X
X
10
16
Set_Attribute_Single
X
0E
14
Get_Attribute_Single
X
X
4C
76
Get_and_Clear
X
X = supported
— = not supported