Ethernet Link Object (Class Code: 0xF6)

Overview

The Ethernet Link Object maintains link-specific counters and status information for an IEEE 802.3 communications interface. Each device supports exactly one instance of the Ethernet Link Object for each communications interface on the module.

Instance attributes with application access

Attribute ID	Access Rule	NV	Name	Data Type	Value		Description
3	Get, Set ¹	NV	Physical Address	ARRAY of 6 USINTs	<MAC layer address>		The Physical Address attribute contains the interface's MAC layer address. The Physical address is an array of octets. The recommended display format is XX-XX-XX-XX-XX-XX, starting with the first octet. NOTE: The Ethernet address shall be assigned by the manufacturer, and shall be unique per IEEE 802.3 requirements. Devices with multiple ports but a single MAC interface (e.g. a device with a embedded switch technology) may use the same value for this attribute in each instance of the Ethernet Link Object. The general requirement is that the value of this attribute shall be the MAC address used for packets to and from the device's own MAC interface over this physical port.
6	Get ², Set	NV	Interface Control	STRUCT of:	Bit	Content	Configuration for physical interface
			Control Bits	UINT	0:	0/1	Auto-negotiate 0: indicates 802.3 link auto-negotiation is disabled 1: indicates auto-negotiation is enabled NOTE: If auto negotiation is disabled, then the device shall use the settings indicated by the Forced Duplex Mode and Forced Interface Speed bits.
					1:	0/1	Forced Duplex Mode Auto-negotiate bit = 0: The forced Duplex Mode bit indicates whether the interface shall operate in full or half duplex mode. 0: interface duplex should be half duplex 1: interface duplex should be full duplex Interfaces not supporting the required duplex shall return status code 0x09 (Invalid Attribute Value). Auto-negotiate bit = 1: If auto-negotiation is enabled, attempting to set the Forced Duplex Mode bit shall result in status code 0x0C (Object State Conflict).
					2..15:	0	reserved Shall be set to 0.
			Forced Interface Speed	WORD	<speed value>		Speed in Mbps (10, 100, 1000, etc.)

Table Footnotes:
¹ Set access only with application's Set function

² Get access only with application's Get function

Functions
uint32_t	EI_API_ADP_getPortState (T *pAdp_p, EI_API_ADP_EPortNo_t portNo_p, EI_API_ADP_SPortState_t *portState_p)
	Return Interface Speed and Interface Attributes for a given Ethernet port (Instance Attribute IDs: 1, 2).
uint32_t	EI_API_ADP_getMacAddr (T *pAdp_p, EI_API_ADP_SParam_t *pMacAddr_p)
	Get the adapter MAC address (Instance Attribute ID: 3).
uint32_t	EI_API_ADP_getIntfConfig (T *pAdp_p, uint8_t intfId_p, EI_API_ADP_UIntfConf_t *pIntfConf_p)
	Get the current adapter configuration of interface with the specified ID (Instance Attribute ID: 6).
uint32_t	EI_API_ADP_setIntfConfig (T *pAdp_p, uint8_t intfId_p, EI_API_ADP_UIntfConf_t intfConf_p)
	Set the adapter Ethernet interface configuration (Instance Attribute ID: 6).