ruby-amt 0.1.0

data/lib/amt/service/hardware_asset/memory_module.rb

@@ -0,0 +1,91 @@
+# -*- coding: utf-8 -*-
+
+require 'amt/utility'
+require 'amt/service/hardware_asset'
+
+module AMT
+  module Service
+    class HardwareAsset
+
+      # Represents a single physical memory module of the system managed by the AMT device.
+      #
+      # There is at most one instance of this class for every physical memory module in the hardware
+      # asset inventory of each AMT device.
+      #
+      # Available fields:
+      #
+      # [+size+] The size of the memory device. If the value is +0+, then no memory module is
+      #          installed in this socket. If the value is +FFFFh+, then the size is unknown. Also
+      #          see #installed?
+      # [+form_factor+] The implementation form factor for this memory module (an instance of
+      #                 FormFactor).
+      # [+type+] The type of memory used in the module (an instance of Type).
+      # [+type_detail+] Additional detail on the memory module (an instance of TypeDetail).
+      # [+speed+] The speed of the memory module in MHz. If the value is +0+, then the value is
+      #           unknown.
+      # [+manufacturer+] The name of the memory module manufacturer.
+      # [+serial_number+] The serial number of the memory module.
+      # [+asset_tag+] The asset tag of the memory module.
+      # [+part_number+] The part number of the memory module.
+      class MemoryModule < Asset
+
+        # The implementation form factor enumeration.
+        class FormFactor < AMT::Utility::Enum
+          multi_add(1 => "Other", 2 => "Unknown", 3 => "SIMM", 4 => "SIP",
+                    5 => "Chip", 6 => "DIP", 7 => "ZIP", 8 => "Proprietary Card",
+                    9 => "DIMM", 10 => "TSOP", 11 => "Row of chips", 12 => "RIMM",
+                    13 => "SODIMM", 14 => "SRIMM", 15 => "FB-DIMM")
+        end
+
+        # The memory type enumeration.
+        class Type < AMT::Utility::Enum
+          multi_add(1 => "Other", 2 => "Unknown", 3 => "DRAM", 4 => "EDRAM", 5 => "VRAM",
+                    6 => "SRAM", 7 => "RAM", 8 => "ROM", 9 => "FLASH", 10 => "EEPROM",
+                    11 => "FEPROM", 12 => "EPROM", 13 => "CDRAM", 14 => "3DRAM",
+                    15 => "SDRAM", 16 => "SGRAM", 17 => "RDRAM", 18 => "DDR",
+                    19 => "DDR2", 20 => "DDR2 FB-DIMM", 24 => "DDR3", 25 => "FBD2")
+        end
+
+        # The additional available details on the memory module.
+        class TypeDetail < AMT::Utility::BitStruct
+          boolean 1, :other,         'Other'
+          boolean 2, :unknown,       'Unknown'
+          boolean 3, :fast_paged,    'Fast-paged'
+          boolean 4, :static_column, 'Static column'
+          boolean 5, :pseudo_static, 'Pseudo-static'
+          boolean 6, :rambus,        'RAMBUS'
+          boolean 7, :synchronous,   'Synchronous'
+          boolean 8, :cmos,          'CMOS'
+          boolean 9, :edo,           'EDO'
+          boolean 10, :window_dram,  'Window DRAM'
+          boolean 11, :cache_dram,   'Cache DRAM'
+          boolean 12, :non_volatile, 'Non-volatile'
+        end
+
+
+        set_unpack_data "ISCCSSZ65Z65Z65Z65", 272, [[:size, lambda {|d|
+                                                       if d == 0 then 0
+                                                       elsif d == 0xffff then -1
+                                                       else
+                                                         (d & 0x8000 == 0x8000 ? d & 0x7fff : (d & 0x7fff) * 1024)
+                                                       end
+                                                     }],
+                                                    [:form_factor, :enum, FormFactor],
+                                                    [:type, :enum, Type],
+                                                    [:type_detail, :struct, TypeDetail],
+                                                    :speed, :manufacturer, :serial_number, :asset_tag, :part_number]
+
+        # Return +true+ if the memory module is installed in the socket.
+        def installed?
+          @size != 0
+        end
+
+        def inspect # :nodoc:
+          installed? ? super : "#<#{self.class.name} not installed>"
+        end
+
+      end
+
+    end
+  end
+end

data/lib/amt/service/hardware_asset/portable_battery.rb

@@ -0,0 +1,80 @@
+# -*- coding: utf-8 -*-
+
+require 'amt/utility'
+require 'amt/service/hardware_asset'
+
+module AMT
+  module Service
+    class HardwareAsset
+
+      # Represents a portable battery of the system managed by the AMT device.
+      #
+      # There is at most one instance of this class for every physical portable battery in the
+      # hardware asset inventory of each AMT device.
+      #
+      # Available fields:
+      #
+      # [+oem_specific+] Contains OEM- or BIOS vendor-specific information.
+      # [+manufacturer+] The name of the company that manufactured the battery.
+      # [+manufacture_date+] The date the battery was manufactured.
+      # [+design_capacity+] The design capacity of the battery in mWatt-hours. If the value is +0+,
+      #                     then the capacity is unknown.
+      # [+design_voltage+] The design voltage of the battery in mVolts. If the value is +0+, then
+      #                    the voltage is unknown.
+      # [+serial_number+] The serial number of the battery.
+      # [+device_chemistry+] Identifies the battery chemistry (an instance of DeviceChemistry).
+      # [+maximum_error_in_battery_data+] The maximum error (as a percentage in the range 0 to 100)
+      #                                   in the Watt-hour data reported by the battery, indicating
+      #                                   an upper bound on how much additional energy the battery
+      #                                   might have above the energy it reports having. If the
+      #                                   value is +FFh+, then the maximum error is unknown.
+      # [+sbds_version_number+] The Smart Battery Data Specification version number supported by
+      #                         this battery. If the string is empty, then the battery does not
+      #                         support the function.
+      # [+location+] The location of the battery.
+      # [+device_name+] The name of the battery.
+      class PortableBattery < Asset
+
+        # Device chemistry enumeration.
+        class DeviceChemistry < AMT::Utility::Enum
+          multi_add(1 => 'Other', 2 => 'Unknown', 3 => 'Lead Acid',
+                    4 => 'Nickel Cadmium', 5 => 'Nickel metal hydride',
+                    6 => 'Lithium-ion', 7 => 'Zinc air', 8 => 'Lithium Polymer')
+        end
+
+        set_unpack_data "IIISSSCCCA65A65A65A65A65A65A65", 476
+
+        attr_reader :oem_specific, :manufacture_date, :design_capacity, :design_voltage, :serial_number, :device_chemistry # :nodoc:
+        attr_reader :maximum_error_in_battery_data, :sbds_version_number, :location, :manufacturer, :device_name # :nodoc:
+
+        def init_data(data) # :nodoc:
+          @oem_specific = data[0]
+          @sbds_version_number = data[9].strip
+          if data[12].strip.empty?
+            @manufacture_date = Date.new(1980 + (data[1] & 0x0000f1000), data[1] & 0x00001e000, data[1] & 0x0000001f)
+          else
+            @manufacture_date = data[12].strip
+          end
+          @design_capacity = data[2] * data[5]
+          @design_voltage = data[3]
+          if data[8].strip.empty?
+            @serial_number = data[4]
+          else
+            @serial_number = data[8].strip
+          end
+          @device_chemistry = as_enum(data[6], DeviceChemistry).first
+          if @device_chemistry == 'Unknown' && !@sbds_version_number.empty?
+            @device_chemistry = data[14].strip
+          end
+          @maximum_error_in_battery_data = data[7]
+          @location = data[10].strip
+          @manufacturer = data[11].strip
+          @device_name = data[13].strip
+        end
+        private :init_data
+
+      end
+
+    end
+  end
+end

data/lib/amt/service/hardware_asset/processor.rb

@@ -0,0 +1,123 @@
+# -*- coding: utf-8 -*-
+
+require 'amt/utility'
+require 'amt/service/hardware_asset'
+
+module AMT
+  module Service
+    class HardwareAsset
+
+      # Represents a physical processor of the system managed by the AMT device.
+      #
+      # There is at most one instance of this class for every physical processor in the hardware
+      # asset inventory of each AMT device.
+      #
+      # Available fields:
+      #
+      # [+manufacturer+] The name of the processor manufacturer.
+      # [+version+] The version of the processor.
+      # [+socket_designation+] The reference designation for the processor socket.
+      # [+id+] Contains processor-specific information that describes the processor's features
+      #        (returned as string).
+      # [+max_socket_speed+] The maximum processor speed supported by the system for this processor
+      #                      socket in MHz. If equal to +0+, then the value is unknown.
+      # [+current_speed+] The current speed of the processor in MHz.
+      # [+status+] Indicates the status of the processor (an instance of Status).
+      # [+type+] Specifies the type of the processor (an instance of Type).
+      # [+family+] Specifies the processor family (an instance of Family).
+      # [+upgrade_information+] Specifies the processor upgrade method (an instance of
+      #                         UpgradeInformation).
+      # [+socket_populated+] If the processor socket is populated, then +true+, else +false+.
+      class Processor < Asset
+
+        # The processor type enumeration.
+        class Type < AMT::Utility::Enum
+          multi_add(1 => 'Other', 2 => 'Unknown', 3 => 'Central Processor',
+                    4 => 'Math Processor', 5 => 'DSP Processor', 6 => 'Video Processor')
+        end
+
+        # The processor family enumeration.
+        #
+        # Taken from the SMBIOS Reference Specification DSP 0134. Since I don't know all possible
+        # values, I just excluded the impossible ones (since AMT works only on newer generation
+        # processors from Intel) sothat the list gets shorter.
+        class Family < AMT::Utility::Enum
+          multi_add(1 => "Other", 2 => "Unknown",
+                    20 => "Intel(R) Celeron(R) M processor",
+                    21 => "Intel(R) Pentium(R) 4 HT processor",
+                    40 => "Intel(R) Core(TM) Duo processor",
+                    41 => "Intel(R) Core(TM) Duo mobile processor",
+                    42 => "Intel(R) Core(TM) Solo mobile processor",
+                    43 => "Intel(R) Atom(TM) processor",
+                    161 => "Quad-Core Intel(R) Xeon(R) processor 3200 Series",
+                    162 => "Dual-Core Intel(R) Xeon(R) processor 3000 Series",
+                    163 => "Quad-Core Intel(R) Xeon(R) processor 5300 Series",
+                    164 => "Dual-Core Intel(R) Xeon(R) processor 5100 Series",
+                    165 => "Dual-Core Intel(R) Xeon(R) processor 5000 Series",
+                    166 => "Dual-Core Intel(R) Xeon(R) processor LV",
+                    167 => "Dual-Core Intel(R) Xeon(R) processor ULV",
+                    168 => "Dual-Core Intel(R) Xeon(R) processor 7100 Series",
+                    169 => "Quad-Core Intel(R) Xeon(R) processor 5400 Series",
+                    170 => "Quad-Core Intel(R) Xeon(R) processor",
+                    171 => "Dual-Core Intel(R) Xeon(R) processor 5200 Series",
+                    172 => "Dual-Core Intel(R) Xeon(R) processor 7200 Series",
+                    173 => "Quad-Core Intel(R) Xeon(R) processor 7300 Series",
+                    174 => "Quad-Core Intel(R) Xeon(R) processor 7400 Series",
+                    175 => "Multi-Core Intel(R) Xeon(R) processor 7400 Series",
+                    184 => "Intel® Itanium® 2 processor",
+                    185 => "Intel® Pentium® M processor",
+                    186 => "Intel® Celeron® D processor",
+                    187 => "Intel® Pentium® D processor",
+                    188 => "Intel® Pentium® Processor Extreme Edition",
+                    189 => "Intel(R) Core(TM) Solo Processor",
+                    190 => "Intel(R) Core(TM)2 Duo Processor",
+                    191 => "Intel(R) Core(TM) 2 Duo Processor",
+                    192 => "Intel(R) Core(TM)2 Solo processor",
+                    193 => "Intel(R) Core(TM)2 Extreme processor",
+                    194 => "Intel(R) Core(TM)2 Quad processor",
+                    195 => "Intel(R) Core(TM)2 Extreme mobile processor",
+                    196 => "Intel(R) Core(TM)2 Duo mobile processor",
+                    197 => "Intel(R) Core(TM)2 Solo mobile processor",
+                    198 => "Intel(R) Core(TM) i7 processor",
+                    199 => "Dual-Core Intel(R) Celeron(R) processor",
+                    214 => "Multi-Core Intel(R) Xeon(R) processor",
+                    215 => "Dual-Core Intel(R) Xeon(R) processor 3xxx Series",
+                    216 => "Quad-Core Intel(R) Xeon(R) processor 3xxx Series",
+                    218 => "Dual-Core Intel(R) Xeon(R) processor 5xxx Series",
+                    219 => "Quad-Core Intel(R) Xeon(R)  processor 5xxx Series",
+                    221 => "Dual-Core Intel(R) Xeon(R) processor 7xxx Series",
+                    222 => "Quad-Core Intel(R) Xeon(R) processor 7xxx Series",
+                    223 => "Multi-Core Intel(R) Xeon(R) processor 7xxx Series")
+        end
+
+        # The processor status enumeration (a subclass of AMT::Utility::Enum).
+        class Status < AMT::Utility::Enum
+          multi_add(0 => 'Unknown', 1 => 'Enabled', 2 => 'Disabled by user via BIOS setup',
+                    3 => 'Disabled by BIOS (POST Error)', 4 => 'Idle, waiting to be enabled', 7 => 'Other')
+        end
+
+        # The processor upgrade method enumeration.
+        class UpgradeInformation < AMT::Utility::Enum
+          multi_add(1 => 'Other', 2 => 'Unknown', 3 => 'Daughter Board', 4 => 'ZIF Socket',
+                    5 => 'Replaceable Piggy Back', 6 => 'None', 7 => 'LIF Socket', 8 => 'Slot 1',
+                    9 => 'Slot 2', 10 => '370-pin socket', 11 => 'Slot A', 12 => 'Slot M',
+                    13 => 'Socket 423', 14 => 'Socket A (Socket 462)', 15 => 'Socket 478',
+                    16 => 'Socket 754', 17 => 'Socket 940', 18 => 'Socket 939',
+                    19 => 'Socket mPGA604', 20 => 'Socket LGA771', 21 => 'Socket LGA775',
+                    22 => 'Socket S1', 23 => 'Socket AM2', 24 => 'Socket F (1207)', 25 => 'Socket LGA1366')
+        end
+
+
+        set_unpack_data "Ia8SSCCCCCZ65Z65Z65", 216, [[:id, :raw], :max_socket_speed, :current_speed,
+                                                     [:status, :enum, Status],
+                                                     [:type, :enum, Type],
+                                                     [:family, :enum, Family],
+                                                     [:upgrade_information, :enum, UpgradeInformation],
+                                                     [:socket_populated, :boolean],
+                                                     :socket_designation, :manufacturer, :version]
+
+      end
+
+    end
+  end
+end

data/lib/amt/service/hardware_asset/vpro_verification_table.rb

@@ -0,0 +1,120 @@
+# -*- coding: utf-8 -*-
+
+require 'amt/utility'
+require 'amt/service/hardware_asset'
+
+module AMT
+  module Service
+    class HardwareAsset
+
+      # Represents a structure with information about vPro capabilities.
+      #
+      # Available fields:
+      #
+      # [+cpu_capabilities+] Capabilities supported by the CPU (an instance of CpuCapabilities.)
+      # [+mch_capabilities+] Capabilities supported by the Mch (an instance of MchCapabilities).
+      # [+ich_capabilities+] Capabilities supported by the Ich (an instance of IchCapabilities).
+      # [+me_capabilities+] Capabilities supported by the ME (an instance of MeCapabilities).
+      # [+tpm_capabilities+] Capabilities supported by the TPM (an instance of TpmCapabilities).
+      # [+network_device+] Information about the vPro network device (an instance of NetworkDevice).
+      # [+bios_capabilities+] Capabilities supported by the BIOS (an instance of BiosCapabilities).
+      class VproVerificationTable < Asset
+
+        # Defines a set of bit flags that indicate the features the CPU supports.
+        class CpuCapabilities < AMT::Utility::BitStruct
+          boolean 0, :vmx_enabled,    'VMX enabled'
+          boolean 1, :smx_enabled,    'SMX enabled'
+          boolean 2, :lt_txt_capable, 'LT/TXT capable'
+          boolean 3, :lt_txt_enabled, 'LT/TXT enabled'
+          boolean 4, :vt_x_capable,   'VT-x capable'
+          boolean 5, :vt_x_enabled,   'VT-x enabled'
+        end
+
+        # Defines a set of bit flags that indicate the features of the Mch device and some values
+        # that identify it.
+        class MchCapabilities < AMT::Utility::BitStruct
+          unsigned 0..2, :function_number, 'Function Number of PCI Device'
+          unsigned 3..7, :device_number,   'Device Number of PCI Device'
+          unsigned 8..15, :bus_number,     'Bus Number of PCI Device'
+          unsigned 16..31, :did,           'Device Identification Number'
+          boolean 32, :vt_d_capable,       'VT-d capable'
+          boolean 33, :vt_d_enabled,       'VT-d enabled'
+          boolean 34, :txt_capable,        'TXT capable'
+          boolean 35, :txt_enabled,        'TXT enabled'
+        end
+
+        # Defines some values that identify the Mch device.
+        class IchCapabilities < AMT::Utility::BitStruct
+          unsigned 0..2, :function_number, 'Function Number of PCI Device'
+          unsigned 3..7, :device_number,   'Device Number of PCI Device'
+          unsigned 8..15, :bus_number,     'Bus Number of PCI Device'
+          unsigned 16..31, :did,           'Device Identification Number'
+        end
+
+        # Defines a set of bit flags that indicate the features the Management Engine supports and
+        # provides information about the ME firmware version.
+        class MeCapabilities < AMT::Utility::BitStruct
+          boolean 0, :me_enabled,                'ME enabled'
+          boolean 1, :intel_qst_fw_support,      'Intel QST FW support'
+          boolean 2, :intel_asf_fw_support,      'Intel ASF FW support'
+          boolean 3, :intel_amt_fw_support,      'Intel AMT FW support'
+          unsigned 32..47, :me_fw_minor_version, 'ME FW Minor Version'
+          unsigned 48..63, :me_fw_major_version, 'ME FW Major Version'
+          unsigned 64..79, :me_fw_build_number,  'ME FW Build Number'
+          unsigned 80..95, :me_fw_hotfix_number, 'ME FW Hotfix Number'
+        end
+
+        # Defines a set of bit flags that indicate the features the TPM device supports and which
+        # TCG spec is supported.
+        class TpmCapabilities < AMT::Utility::BitStruct
+          boolean 0, :supported, 'Supports TPM on board'
+          boolean 1, :enabled,   'TPM enabled'
+          unsigned 16..23, :tcg_spec_major_version, 'TCG spec major version'
+          unsigned 24..31, :tcg_spec_minor_version, 'TCG spec minor version'
+        end
+
+        # Defines some values that identify the network device used by vPro.
+        class NetworkDevice < AMT::Utility::BitStruct
+          unsigned 0..2, :function_number, 'Function Number'
+          unsigned 3..7, :device_number,   'Device Number'
+          unsigned 8..15, :bus_number,     'Bus Number'
+          unsigned 16..31, :did,           'Device Identification Number'
+        end
+
+        # Defines a set of bit flags that indicate the features the BIOS supports regarding vPro.
+        class BiosCapabilities < AMT::Utility::BitStruct
+          boolean 0, :vt_x_supported,                          'BIOS supports VT-x in BIOS setup screen'
+          boolean 1, :vt_d_supported,                          'BIOS supports VT-d in BIOS setup screen'
+          boolean 2, :txt_supported,                           'BIOS supports TXT in BIOS setup screen'
+          boolean 3, :tpm_supported,                           'BIOS supports TPM in BIOS setup screen'
+          boolean 4, :me_supported,                            'BIOS supports ME in BIOS setup screen'
+          boolean 5, :va_extension_supported,                  'BIOS supports VA extension'
+          boolean 6, :spi_flash_platform_data_region_reserved, 'SPI Flash has Platform Data region reserved'
+          unsigned 7..9, :maximum_va_version,                  'BIOS supported maximum VA version'
+        end
+
+        set_unpack_data "IIa8a8a12Ia12IIx4", 64
+
+        attr_reader :cpu_capabilities, :mch_capabilities, :ich_capabilities, :me_capabilities #:nodoc:
+        attr_reader :tpm_capabilities, :network_device, :bios_capabilities #:nodoc:
+
+        def init_data(data) #:nodoc:
+          @cpu_capabilities = CpuCapabilities.new(data[0])
+          first, last = *data[1].unpack("II")
+          @mch_capabilities = MchCapabilities.new((first << 32) + last)
+          first, last = *data[2].unpack("II")
+          @ich_capabilities = IchCapabilities.new((first << 32) + last)
+          first, second, last = *data[3].unpack("III")
+          @me_capabilities = MeCapabilities.new((first << 64) + (second << 32) + last)
+          @tpm_capabilities = TpmCapabilities.new(data[4])
+          first, second, last = *data[5].unpack("III")
+          @network_device = NetworkDevice.new((first << 64) + (second << 32) + last)
+          @bios_capabilities = BiosCapabilities.new(data[6])
+        end
+        private :init_data
+
+      end
+
+    end
+  end
+end

data/lib/amt/service/network_administration.rb

@@ -0,0 +1,181 @@
+# -*- coding: utf-8 -*-
+
+require 'ipaddr'
+require 'amt/service/basic'
+
+module AMT
+
+  module Service
+
+    # The Network Administration Service enables administrators to configure network parameters.
+    # This service implements all AMT 5.0 methods sans 802.1x related ones.
+    class NetworkAdministration < Basic
+
+      require 'amt/service/network_administration/structures'
+
+
+      # Set the host name of the AMT device to +name+.
+      #
+      # *Note*: You also need to call SecurityAdministration#commit_changes for the changes to
+      # actually take effect.
+      #
+      # Supported by AMT 1.0 and later.
+      def set_host_name(name)
+        soap_call('SetHostName') {|msg| msg.add('ns:HostName', name)}.process
+      end
+
+
+      # Return the host name of the AMT device.
+      #
+      # Supported by AMT 1.0 and later.
+      def get_host_name
+        soap_call('GetHostName').process {|node| node.xpath('./ns:HostName/text()').to_s}
+      end
+
+
+      # Set the domain name of the AMT device to +name+.
+      #
+      # *Note*: You also need to call SecurityAdministration#commit_changes for the changes to
+      # actually take effect.
+      #
+      # Supported by AMT 2.0 and later.
+      def set_domain_name(name)
+        soap_call('SetDomainName') {|msg| msg.add('ns:DomainName', name)}.process
+      end
+
+
+      # Return the domain name of the AMT device.
+      #
+      # Supported by AMT 2.0 and later.
+      def get_domain_name
+        soap_call('GetDomainName').process {|node| node.xpath('./ns:DomainName/text()').to_s}
+      end
+
+
+      # Set VLAN parameters (mode and vlan tag).
+      #
+      # [+enabled+] Boolean defining whether the VLAN support should be enabled on the AMT device.
+      # [+tag+] The VLAN tag (VLAN ID) to be set.
+      # [+interface_handle+] An optional interface handle for specifying the LAN interface to which
+      #                      the VLAN parameters should be applied.
+      #
+      # *Note*: You also need to call SecurityAdministration#commit_changes for the changes to
+      # actually take effect.
+      #
+      # Supported by AMT 1.0 and later. Not supported in 2.5, 2.6 and 4.0.
+      def set_vlan_parameters(enabled, tag, interface_handle = nil)
+        soap_call('SetVlanParameters') do |msg|
+          msg.add('ns:InterfaceHandle', interface_handle) if interface_handle
+          msg.add('ns:VlanMode', enabled)
+          msg.add('ns:VlanTag', tag)
+        end.process
+      end
+
+
+      # Return the VLAN parameters of the default interface or the one specified by
+      # +interface_handle+ as instance of the VlanParameters class.
+      #
+      # Supported by AMT 1.0 and later. Not supported in 2.5, 2.6 and 4.0.
+      def get_vlan_parameters(interface_handle = nil)
+        soap_call('GetVlanParameters') do |msg|
+          msg.add('ns:InterfaceHandle', interface_handle) if interface_handle
+        end.process do |node|
+          vp = VlanParameters.new
+          vp.enabled = node.xpath('./ns:VlanMode/text()').to_boolean
+          vp.tag = node.xpath('./ns:VlanTag/text()').to_i if vp.enabled
+          vp
+        end
+      end
+
+
+      # Set the behaviour of the AMT device regarding ICMP ping responses. If +enabled+ is +true+,
+      # ping responses will be enabled and else disabled.
+      #
+      # Supported by AMT 1.0 and later.
+      def set_ping_response(enabled)
+        soap_call('SetPingResponse') {|msg| msg.add('ns:enabled', enabled)}.process
+      end
+
+
+      # Return whether ICMP ping responses are enabled on the AMT device.
+      #
+      # Supported by AMT 1.0 and later.
+      def get_ping_response
+        soap_call('GetPingResponse').process {|node| node.xpath('./ns:enabled/text()').to_boolean}
+      end
+
+
+      # Return an array of handles (integers) to all known interfaces of the AMT device.
+      #
+      # Supported by AMT 2.5 and later.
+      def enumerate_interfaces
+        soap_call('EnumerateInterfaces').process do |node|
+          node.xpath('./ns:InterfaceHandles/text()').collect {|n| n.to_i }
+        end
+      end
+
+
+      # Return the settings of the interface specified by +interface_handle+ as an instance of
+      # +InterfaceDescriptor+.
+      #
+      # Supported by AMT 2.5 and later.
+      def get_interface_settings(interface_handle)
+        soap_call('GetInterfaceSettings') do |msg|
+          msg.add('ns:InterfaceHandle', interface_handle)
+        end.process do |node|
+          result = InterfaceDescriptor.new
+          result.hardware_description = node.xpath('./ns:InterfaceDescriptor/ns:HardwareAddressDescription/text()').to_s
+          result.mac = node.xpath('./ns:InterfaceDescriptor/ns:MACAddress/text()').to_s.gsub('-', ':').upcase
+          result.interface_mode = node.xpath('./ns:InterfaceDescriptor/ns:InterfaceMode/text()').to_s
+          result.link_policy = LinkPolicy.new(node.xpath('./ns:InterfaceDescriptor/ns:LinkPolicy/text()').to_i)
+          result.dhcp_enabled = node.xpath('./ns:InterfaceDescriptor/ns:DhcpEnabled/text()').to_boolean
+          if node.xpath('./ns:InterfaceDescriptor/ns:IPv4Parameters')
+            ipp = result.ip_parameters = IPParameters.new
+            ipp.ip = IPAddr.new(node.xpath('./ns:InterfaceDescriptor/ns:IPv4Parameters/ns:LocalAddress/text()').to_i, Socket::AF_INET)
+            ipp.mask = IPAddr.new(node.xpath('./ns:InterfaceDescriptor/ns:IPv4Parameters/ns:SubnetMask/text()').to_i, Socket::AF_INET)
+            ipp.gateway = IPAddr.new(node.xpath('./ns:InterfaceDescriptor/ns:IPv4Parameters/ns:DefaultGatewayAddress/text()').to_i, Socket::AF_INET)
+            ipp.primary_dns = IPAddr.new(node.xpath('./ns:InterfaceDescriptor/ns:IPv4Parameters/ns:PrimaryDnsAddress/text()').to_i, Socket::AF_INET)
+            ipp.secondary_dns = IPAddr.new(node.xpath('./ns:InterfaceDescriptor/ns:IPv4Parameters/ns:SecondaryDnsAddress/text()').to_i, Socket::AF_INET)
+          end
+          result
+        end
+      end
+
+
+      # Set the interface parameters for the network interface identified by +interface_handle+.
+      #
+      # [+interface_handle+] The handle to the network interface that should be configured.
+      # [+interface_mode+] Has to be either +SEPARATE_MAC_ADDRESS+ or +SHARED_MAC_ADDRESS+.
+      # [+link_policy+] The link policy (an instance of LinkPolicy) that should be set.
+      # [+ip_parameters+] If not specified (ie. +nil+), the interface is configured via DHCP.
+      #                   Otherwise this needs to be an instance of IPParameters.
+      #
+      # *Note*: You also need to call SecurityAdministration#commit_changes for the changes to
+      # actually take effect.
+      #
+      # Supported by AMT 2.5 and later.
+      def set_interface_settings(interface_handle, interface_mode, link_policy, ip_parameters = nil)
+        unless interface_mode == 'SEPARATE_MAC_ADDRESS' || interface_mode == 'SHARED_MAC_ADDRESS'
+          raise ArgumentError, "interface_mode is invalid: #{interface_mode}"
+        end
+        soap_call('SetInterfaceSettings') do |msg|
+          msg.add('ns:InterfaceHandle', interface_handle)
+          msg.add('ns:InterfaceDescriptor') do |ifd|
+            ifd.add('ns:InterfaceMode', interface_mode)
+            ifd.add('ns:LinkPolicy', link_policy.value)
+            ifd.add('ns:IPv4Parameters') do |ipp|
+              ipp.add('ns:LocalAddress', ip_parameters.ip.to_i)
+              ipp.add('ns:SubnetMask', ip_parameters.mask.to_i)
+              ipp.add('ns:DefaultGatewayAddress', ip_parameters.gateway.to_i)
+              ipp.add('ns:PrimaryDnsAddress', ip_parameters.primary_dns.to_i)
+              ipp.add('ns:SecondaryDnsAddress', ip_parameters.secondary_dns.to_i)
+            end if ip_parameters
+          end
+        end.process
+      end
+
+    end
+
+  end
+
+end