# Ethernet Adapter Schema

The adapter schema is used to model the various configurable Intel® PROSet Ethernet Adapters. This schema is based on the CIM v2.6 schema.

## Schema Diagram

## IANet_PhysicalEthernetAdapter

### Purpose

IANet_PhysicalEthernetAdapter defines the capabilities and status of all the installed network adapters. The class is derived from the abstract class IANet_EthernetAdapter. IANet_EthernetAdapter is derived from CIM_EthernetAdapter superclass defined in CIMv2.5. CIM_EthernetAdapter is derived from CIM_NetworkAdapter, an Abstract class defining general networking hardware concepts such as PermanentAddress, CurrentAddress, Speed of operation, etc.

### Instances

Instances of this class will exist for supported and installed Intel NICs.

### Creating Instances

The user cannot create instances of IANet_PhysicalEthernetAdapter.

### Removing Instances

Deleting an instance of IANet_PhysicalEthernetAdapter will uninstall physical adapters. A client handle is required for this operation.

### Modifying Properties

There are no user-modifiable properties for this class.

### Local Properties

This class implements the following local attributes:

- AdapterStatus : specifies the current status of the adapter
- ControllerID : identification of the adapter controller
- EEPROMVersion : contains device EEPROM version
- ExpressTeaming : indicates if Express Teaming is enabled
- HardwareStatus : specifies current status of device
- MediaType : the media which interfaces to this device
- OriginalDisplayName : original name value will show if Express Teaming is enabled
- OtherCapabilityDescriptions : an array of descriptions of OtherEnabledCapabilities of the adapter
- OtherEnabledCapabilities : used to state Other Capabilities of the adapter
- OtherEnabledCapabilityIDs : an unmapped value list of IDs of Other Capabilities
- OtherMediaType : shows media type if MediaType value is ‘Other’
- OtherPhyDevice : shows name of device if PHYDevice value is ‘Other’
- PartNumber : the PBA manufacturing part number
- PHYDevice : PHY used on this adapter
- SlotID : value that correlates the physical attributes to the logical access method

### Unsupported Attributes

The following attributes are not required for Intel PROSet and are, therefore, not supported:

AlignmentErrors, AutoSense, CarrierSenseErrors, DeferredTransmissions, EnabledCapabilities ErrorCleared, ErrorDescription, ExcessiveCollisions, FCSErrors, FrameTooLongs, FullDuplex, IdentifyingDescriptions, InstallDate, InternalMACReceiveErrors, InternalMACTransmitErrors, LastErrorCode, LateCollisions, MaxDataSize, MaxQuiesceTime, MultipleCollisionFrames, OctetsReceived, OctetsTransmitted, OtherIdentifyingInfo, PowerManagementCapabilities (this is exposed as a method), PowerManagementSupported (this is exposed as a method), PowerOnHours, SingleCollisionFrames, SymbolErrors, SQETestErrors, SymbolErrors, TotalPacketsReceived, TotalPacketsTransmitted, TotalPowerOnHours.

### Methods

This class instance supports following methods:

uint32 AdvancedCableTest ([OUT] boolean, [OUT] array[string], [OUT] array[string]); | Performs a set of advanced cable tests on supported adapters.
uint32 ExpressTeam( [IN Boolean]); | Creates/Removes the express team.
uint32 GetExpressTeamInfo ([OUT] boolean, [OUT], uint16, [OUT] uint32); | Gets the express team information.
uint32 GetPowerUsageOptions ([OUT] uint32, [OUT] uint32, [OUT] uint32, [OUT] uint32); | Detects any optional power usage settings (e.g., power usage for standby, battery operation, etc.).
uint32 IdentifyAdapter ([IN uint16]); | Identifies adapter by flashing the light on the adapter for a few seconds. This method will only work for physical adapters.
uint32 SetPowerUsageOptions ([IN] uint32, [IN] uint32, [IN] uint32, [IN] uint32); | Changes power usage options (e.g., method can be used to reduce power usage for standby, battery operation, etc.) Note: Power usage settings are stored and used for subsequent reboots.
uint32 TestCable ([OUT] array[string], [OUT] array[string], [OUT] array[string]); | Analyzes the network cable connected to adapter and reports aspects of the cable such as length, quality and signal quality
unit32 TestLinkSpeed ( [OUT] uint32, [OUT] string); | Determines whether the adapter is running at full speed

### Unsupported Methods

The following methods are not required for Intel PROSet and are, therefore, not supported:

EnableDevice, OnlineDevice, QuiesceDevice, Reset, RestoreProperties, SaveProperties, SetPowerState.

### Associations

- IANet_DiagTestForMSE is used to associate an IANet_DiagTest with IANet_PhysicalEthernetAdapter
- IANet_DiagResultForMSE is used to associate an IANet_DiagResult with IANet_PhysicalEthernetAdapter
- IANet_DeviceBootServiceImplementation is used to associate a IANet_BootAgent with a IANet_PhysicalEthernetAdapter
- IANet_AdapterToSettingAssoc is used to associate an IANet_AdapterSetting with a IANet_PhysicalEthernetAdapter
- IANet_TeamedMemberAdapter is used to associate a IANet_TeamOfAdapters with a IANet_PhysicalEthernetAdapter

## IANet_BootAgent

### Purpose

This class is used to capture the information about the network boot capabilities of an adapter. (e.g., settings for the PXE Boot Agent supported by some Intel adapters). This class is derived from CIM_BootService.

### Instances

An IANet_BootAgent instance exists for each adapter that supports boot agent capabilities, even if the boot agent is not currently installed.

### Creating Instances

The user cannot create instances of IANet_BootAgent. An instance exists only if the adapter supports boot agent functionality.

### Removing Instances

The user cannot remove instances of IANet_BootAgent.

### Modifying Properties

There are no user-modifiable properties of this class.

### Associations

- IANet_DeviceBootServiceImplementation is used to associate an IANet_PhysicalEthernetAdapter with an IANet_BootAgent, if the adapter supports it.
- IANet_BootAgentToBootAgentSettingAssoc is used to associate an IANet_BootAgentSetting with a IANet_BootAgent

### Local Properties

The following read only attributes are required by Intel® PROSet:

- FlashImageType : the boot agent flash image type
- InvalidImageSignature : Boolean value denoting corrupted flash image
- UpdateAvailable : indicates if install or upgrade to boot agent software is available
- Version : string value of boot agent version
- VersionNumber : unsigned integer value of boot agent version

### Unsupported Properties

The following properties are not required by Intel® PROSet and are, therefore, not supported:

Caption, Description, InstallDate, Started, StartMode, Status.

### Methods

There are two methods on this class that can be used to update the Flash ROM on the NIC:

uint32 ProgramFlash ([IN] uint32, [IN] array[uint8] [OUT] uint32); | This method is used to update the Flash ROM on the NIC. This will cause the NIC to stop communicating with the network while the flash is updated.
uint32 ReadFlash( [OUT] array [uint8] ); | This method reads the Flash ROM on the NIC.

### Unsupported Methods

StartService, StopService

Home

Copyright© 2004 Intel Corporation. Legal Information