Structures
eth32cfg_ip Structure

The eth32cfg_ip structure holds an IP address in binary form. It is used to represent IP address information in the ETH32 device configuration structure, to specify the broadcast address, and to retrieve IP address information about the PC's network interfaces.

Public Type eth32cfg_ip
    buf(3) As Byte
End Type
        

  • buf - Array containing individual octets of the IP address. Index 0 contains the most significant, e.g. 192 from the address 192.168.1.100

eth32cfg_mac Structure

The eth32cfg_mac structure holds a MAC address in binary form. It is used within the ETH32 device configuration structure.

Public Type eth32cfg_mac
    buf(5) As Byte
End Type
        

  • buf - Array containing individual octets of the MAC address. Index 0 contains the first and most significant octet.

eth32cfg_data Structure

The eth32cfg_data structure holds all of the network configuration and device information data for a particular ETH32 device. It is provided to your application when retrieving information about detected devices. Your application can also fill in or modify the information and provide it to the API to store new configuration into a device.

Public Type eth32cfg_data
    product_id As Byte
    firmware_major As Byte
    firmware_minor As Byte
    config_enable As Byte
    mac As eth32cfg_mac
    pad1 As Byte
    pad2 As Byte
    serialnum_batch As Integer
    serialnum_unit As Integer
    config_ip As eth32cfg_ip
    config_gateway As eth32cfg_ip
    config_netmask As eth32cfg_ip
    active_ip As eth32cfg_ip
    active_gateway As eth32cfg_ip
    active_netmask As eth32cfg_ip
    dhcp As Byte
End Type
        

  • product_id - Contains the product ID code for the device. This will be 105 for ETH32 devices. This makes up a portion of the serial number.

  • firmware_major - Contains the major portion of the firmware version, e.g. 3 from 3.000

  • firmware_minor - Contains the minor portion of the firmware version, e.g. 0 from 3.000

  • config_enable - Nonzero if the device's Allow Config switch is set to Yes

  • mac - The MAC address of the device

  • pad1 - Reserved. Padding byte for proper structure alignment

  • pad2 - Reserved. Padding byte for proper structure alignment

  • serialnum_batch - The batch number portion of the device's serial number

  • serialnum_unit - The unit number portion of the device's serial number

  • config_ip - The static IP address stored in the device. This is ignored if DHCP is active.

  • config_gateway - The static gateway IP address stored in the device. This is ignored if DHCP is active.

  • config_netmask - The static network mask stored in the device. This is ignored if DHCP is active.

  • active_ip - The IP address being used by the device, whether it was provided by DHCP or statically configured.

  • active_gateway - The gateway IP address being used by the device, whether it was provided by DHCP or statically configured.

  • active_netmask - The network mask being used by the device, whether it was provided by DHCP or statically configured.

  • dhcp - Nonzero if DHCP is being used by the device, or zero if the static settings (config_ip, etc) are being used.

If a device is using DHCP, then active_ip will most likely be different than the static (stored) config_ip, and so on for the gateway and netmask. If DHCP is not being used, then active_ip will be the same as config_ip, and so on for the gateway and netmask.

When using this structure with the SetConfig Method, you may modify the config_ip, config_gateway, config_netmask, and dhcp members in order to update the corresponding settings within the ETH32 device. The other members of the structure should not be modified, since they will either be ignored, or are required for the new configuration to be accepted by the device. Specifically, the MAC address and serial number information must match the device's information, or the device will ignore the new configuration data.

Eth32ConfigPluginInterface Structure

The Eth32ConfigPluginInterface structure holds information about a network interface card of the PC. This information can be provided by a plugin loaded into the ETH32 API.

Public Type Eth32ConfigPluginInterface
    Ip As eth32cfg_ip
    Netmask As eth32cfg_ip
    InterfaceType As Eth32ConfigInterfaceType
    StandardName As String
    FriendlyName As String
    Description As String
End Type
        

  • Ip - The IP address of the network interface

  • Netmask - The network mask of the network interface

  • InterfaceType - The type of network that this network interface is for. This can be one of these values:

    • ETH32CFG_IFTYPE_NONE - This is used if the current plugin doesn't provide information about the network interface type.

    • ETH32CFG_IFTYPE_OTHER - This is used if the plugin provides information about the interface type, but it isn't one of the predefined constants.

    • ETH32CFG_IFTYPE_ETHERNET - Ethernet interface

    • ETH32CFG_IFTYPE_TOKENRING - Token Ring interface

    • ETH32CFG_IFTYPE_FDDI - FDDI (Fiber Distributed Data Interface) interface

    • ETH32CFG_IFTYPE_PPP - PPP (Point-to-Point Protocol) interface

    • ETH32CFG_IFTYPE_LOOPBACK - Local loopback interface (e.g. 127.0.0.1)

    • ETH32CFG_IFTYPE_SLIP - SLIP (Serial Line Internet Protocol) interface

  • StandardName - This is typically an internal identifier string that identifies the interface, but is not very human-readable. The exact value depends on the plugin being used.

  • FriendlyName - The human-readable name for the interface. For example, Local Area Connection. This member will be empty when the WinPcap plugin is being used.

  • Description - A description of the interface. The value of this member depends on the plugin being used, but typically includes the manufacturer or model of the card. This member will be available when using the System plugin or when using the WinPcap plugin.