User manual INTEL 82541ER GIGABIT ETHERNET CONTROLLER

[. . . ] Intel PROSet For Windows* Device Manager WMI Provider User‟s Guide White Paper Revision 1. 7 White Paper - Intel PROSet for Windows* Device Manager WMI User‟s Guide Introduction Intel® PROSet for Windows* Device Manager deploys Network Configuration Services version 2. 0, an easy to use solution for deploying and managing all Intel end-station networking technologies using industry standard methods. The NCS2 architecture works closely with the Windows Management Instrumentation (WMI) service to provide remote management of Intel network devices. This document describes the WMI classes and providers supplied by Intel® PROSet for Windows* Device Manager. This document is divided into several sections Technology overview – an overview of WMI technology. [. . . ] If teaming is enabled on this adapter OriginalDisplayName will contain the original display name of the adapter. PHYDevice indicates the particular PHY used on this NIC. 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 50 60 70 No PHY detected Intel 82553 (PHY 100) A or B step Intel 82553 (PHY 100) C step Intel 82503 10Mps National DP83840A Seeq 80C240 - 100BASE-T4 Seeq 80C24 - 10Mps Intel 82555 100Base-TX PHY Microlinear 10Mps Level One 10Mbps National DP83840 100Base-TX, C step ICS 100Base-TX PHY Gilad Kinnereth Kinnereth Plus Other Unknown Intel 82562 EH Phoneline PLC Intel 82562 ET 100 Base-TX PHY Intel 82562 EM 100 Base-TX PHY 0 1 2 3 A B C D PortNumber uint16 PortNumber indicates the port number on PCIe Quad port adapters. Any other value indicates this field is not applicable to the adapter. SlotID Speed Status string uint64 string SlotID field of the System Slot structure provides a mechanism to correlate the physical attributes of the slot to its logical access method. This is an inherited property; refer to parent class CIM definition. 26 White Paper - Intel PROSet for Windows* Device Manager WMI User‟s Guide StatusInfo uint16 This is an inherited property; refer to parent class CIM definition. No other properties are supported. There are no user modifiable properties. Methods Method GetAdapterFanStatus GetNDISVersion Returns uint32 uint32 Parameters [OUT] uint32 dwAdapterStatus [OUT] uint32 dwMajorVersion dwMinorVersion [OUT] uint32 AutoPowerSaveEnabled ReduceSpeedOnPowerDown SmartPowerDown SavePowerNowEnabled EnhancedASPMPowerSaver ACBSMode LinkSpeedBatterySaver [IN] uint32 WakeFromPoweroff WakeOnLink WakeOnMagicPacket WakeOnDirectedPacket Detail Returns status of adapter fans. This method can be used to get the NDIS version Detects any optional power usage settings (e. g. , power usage for standby, battery operation, etc. ). For all return uint32 values: 0 = Off 1 = On GetPowerUsageOptions uint32 GetWakeOnLanPowerOptions uint32 GetWakeOnLanPowerOptions returns WakeOnLan power settings. If an adapter does not support this feature, the returned structure will be empty. Values to pass in: 0 = Off 1 = On IdentifyAdapter uint32 [IN] uint16 nSeconds Identifies adapter by flashing the light on the adapter for a few seconds. iSCSIStatus 0 – Unavailable 1 – Disabled 2 – Primary 3 - Secondary IsISCSIEnabled uint32 [OUT] uint32 iSCSIStatus IsiSCSISupported uint32 [OUT] boolean bIsiSCSIOS bIsISCSIPatch bIsISCSIHotFix [OUT] boolean bIsSetRequired This method can be used to check if iSCSI is supported by the OS and iSCSI patch and hot fix are installed. The “hot fix” is also known as the Microsoft iSCSI initiator. This method can be used to check if SetPowerMgmt-Capabilities() needs to be called. IsSetPowerMgmtCapabilitiesReq uint32 SetPowerMgmtCapabilities uint32 This method is used to makes changes to the Power management capabilities during NCS2 install so that any upgrade scenarios from earlier releases will have the right options for all the WakeOnLan options and NCS2 will not have reinterpret them dynamically. [IN] uint32 Changes power usage options (e. g. , SetPowerUsageOptions uint32 27 White Paper - Intel PROSet for Windows* Device Manager WMI User‟s Guide AutoPowerSaveModeEnabled ReduceSpeedOnPowerDown SmartPowerDown SavePowerNowEnabled EnchancedASPM-PowerSaver ACBSMode LinkBatterySaver SetWakeOnLanPowerOptions uint32 [IN] uint32 WakeFromPoweroff WakeOnLink WakeOnMagicPacket WakeOnDirected-Packet method can be used to reduce power usage for standby, battery operation, etc. ) Note: Power usage settings are stored and used for subsequent reboots. Values to pass in: 0 = Off 1 = On This method can be used to makes changes to the WakeOnLan options. For example, this method could be used to set options like wakefromPoweroff, wakeOnlink, WakeOn-MagicPacket, WakeOnDirectedPacket etc. Note WakeOnLan settings are stored and used for every boot. 0 = Off 1 = On ValidateSettingOnNewTeam There are no other supported methods. Internal use only. Associations Association Class IANet_Device802dot1QVLANServiceImplementation IANet_DiagTestForMSE IANet_DiagResultForMSE IANet_DeviceBootServiceImplementation IANet_AdapterToSettingAssoc IANet_TeamedMemberAdapter Association Partner IANet_802dot1QVLANService IANet_DiagTest IANet_DiagResult IANet_BootAgent IANet_AdapterSetting IANet_TeamOfAdapters IANet_Setting This is an abstract super class for a set of concrete classes of different types. This set of classes allows open ended usage of a variable number of settings. These will be different between adapters, teams, or VLANs and it may not always be possible to predict what parameters are required. Between the setting categories, this class groups the most common parameters for inheritance. Instances There will be one instance for every setting. Properties Name Caption Description ExposeLevel Grouped GroupId MiniHelp ParentId ParentType Type string string uint32 boolean uint16 string string string Description This is an inherited property; refer to parent class CIM definition. Internal use only Internal use only Internal use only Description of the setting The unique identifier (GUID) of the parent device Name of the parent (NIC, Team, VLAN) 28 White Paper - Intel PROSet for Windows* Device Manager WMI User‟s Guide Writable boolean Whether the value can be changed All other properties are not supported. Methods There are no supported methods. Associations There are no associations. IANet_TeamedMemberAdapter This class is used to associate the adapter with the team, determine the function of the adapter in the team, and establish that the adapter is currently active in the team. To add an adapter to a team, create an instance of IANet_TeamedMemberAdapter to associate the adapter with the team. To remove an adapter from the team, remove the instance of IANet_ TeamedMemberAdapter. [. . . ] The parent result will have its IsPackage parameter set to “Yes” and will have a IANet_DiagResultInPackage association to any packaged results. Type Parent Result Packaged Result Packaged Result Packaged Result Packaged Result Packaged Result DiagnosticName 37@{66DFCDDC-A535-4265-99CB-21B03561497A} 37. 1@{66DFCDDC-A535-4265-99CB-21B03561497A} 37. 2@{66DFCDDC-A535-4265-99CB-21B03561497A} 37. 3@{66DFCDDC-A535-4265-99CB-21B03561497A} 37. 4@{66DFCDDC-A535-4265-99CB-21B03561497A} 37. 5@{66DFCDDC-A535-4265-99CB-21B03561497A} IsPackage Yes iSCSI Settings The iSCSI settings of an Intel network card can be manipulated through the WMI interface. Only operating systems which support iSCSI will have these settings available. Working with iSCSI configurations requires additional information which is not readily available in the class descriptions. Getting iSCSI Status To retrieve the iSCSI status of a network card, enumerate instances of the IANet_BootAgent_iSCSI_Adapters class. This will indicate the current state of an iSCSI enabled adapter. Setting iSCSI Status The iSCSI state of the adapter is manipulated through the SetiSCSI_Status method of the IANet_BootAgent_iSCSI_Adapters class. [. . . ]