Ethernet Manager

EMDK for Xamarin - 2.5

Overview

Ethernet Manager is used to administer settings for devices connected to a network through an Ethernet-equipped cradle. This CSP has no effect on Wi-Fi communications or wireless Ethernet adapter settings, which are controlled through the Wi-Fi Manager.

Main Functionality

  • Enable/Disable network connection through an Ethernet-equipped cradle
  • Configure the cradle to use DHCP
  • Manually set IP address settings for the cradle
  • Enable/Disable use of a Proxy
  • Set the Proxy Port and Proxy Host Name
  • Specify Host Name(s) and/or IP address(es) that bypass the Proxy

Ethernet Enable/Disable

This is the On/Off switch for the ability of a device to connect with a network via Ethernet when it is placed in an Ethernet-equipped cradle.

This parameter has no effect on Wi-Fi communications or wireless Ethernet adapter settings.

Parm Name: EthernetState

Option Name Description Requires
0 Do not change This value (or the absence of this parm from the XML) will cause no changes to the Ethernet state; any previously selected setting will be retained.

OSX: 6.2+

MX: 6.2+

Android API Level: 23+

1 Turn On Enables network connectivity through an Ethernet cradle port.

OSX: 6.2+

MX: 6.2+

Android API Level: 23+

2 Turn Off Disables network connectivity through an Ethernet cradle port.

OSX: 6.2+

MX: 6.2+

Android API Level: 23+

Configure IP Address (checkbox)

Controls whether an IP address can be assigned to the Ethernet-equipped cradle. When enabled (value=1), an IP address can be obtained automatically from a DHCP server (the default setting) or assigned manually by an administrator using the relevant parameters.

Parm Name: ConfigIpAddr

Option Name Description Requires
0 (unchecked) Prevents an IP address from being assigned manually or through DHCP.

OSX: 6.2+

MX: 6.2+

Android API Level: 23+

1 (checked) Allows an IP address to be assigned manually or through DHCP.

OSX: 6.2+

MX: 6.2+

Android API Level: 23+

Use DHCP (checkbox)

Controls whether the Ethernet-equipped cradle will obtain its IP settings automatically using DHCP or manually by an administrator using the relevant parameters. When disabled (value=0), the IP addresses for the device, default gateway, subnet mask and at least one DNS server must be specified using the relevant parameters below.

Shown if: ConfigIPAddress is "checked"

Parm Name: UseDHCP

Option Name Description Requires
0 (unchecked) Allows IP address settings to be configured manually.

OSX: 6.2+

MX: 6.2+

Android API Level: 23+

1 (checked) Sets the device to obtain IP settings from a DHCP server.

OSX: 6.2+

MX: 6.2+

Android API Level: 23+

Set IP Address

Used to specify the IP address of the Ethernet Cradle. Must be an address that is unique to the network on which the cradle will operate.

Parm value input rules:

  • String containing a valid IPv4 address. For example: "192.168.0.100"

Shown if: The "Configure IP Address" box is checked and "Use DHCP" box is unchecked

Parm Name: IpAddress

Requires:

  • OSX: 6.2+
  • MX: 6.2+
  • Android API Level: 23+

Set Default Gateway

Used to specify the IP address of the default gateway for the Ethernet Cradle, through which packets to and from outside networks are routed. This parameter is required only if the device must have access to (or from) networks beyond its local subnet.

Parm value input rules:

  • String containing a valid IPv4 address. For example: "192.168.0.1"

Shown if: The "Configure IP Address" box is checked and "Use DHCP" box is unchecked

Parm Name: Gateway

Requires:

  • OSX: 6.2+
  • MX: 6.2+
  • Android API Level: 23+

Set Subnet Mask

Used to specify the subnet mask for the Ethernet Cradle, which defines the network subdivision on which the device will operate.

Parm value input rules:

  • String containing a valid IPv4 address. For example: "255.255.255.0"

Shown if: The "Configure IP Address" box is checked and "Use DHCP" box is unchecked

Parm Name: NetMask

Requires:

  • OSX: 6.2+
  • MX: 6.2+
  • Android API Level: 23+

Set Primary DNS

Used to specify the primary domain name server for the Ethernet Cradle.

Parm value input rules:

  • String containing a valid IPv4 address. For example: "8.8.8.8"

Shown if: The "Configure IP Address" box is checked and "Use DHCP" box is unchecked

Parm Name: DNS1

Requires:

  • OSX: 6.2+
  • MX: 6.2+
  • Android API Level: 23+

Set Secondary DNS

Used to specify the secondary domain name server for the Ethernet Cradle.

Parm value input rules:

  • String containing a valid IPv4 address. For example: "8.8.4.4"

Shown if: The "Configure IP Address" box is checked and "Use DHCP" box is unchecked

Parm Name: DNS2

Requires:

  • OSX: 6.2+
  • MX: 6.2+
  • Android API Level: 23+

Ethernet Proxy Enable/Disable

Controls whether an Ethernet Proxy will be used by the device when connecting to a network through an Ethernet-equipped cradle. When "None" is selected (value=1), all Ethernet transactions are conducted directly from the device. When "Manual" is selected (value=2), a Proxy Host Name and Proxy Host Port must be specified, and transactions will be routed through that server.

Parm Name: SetEthernetProxySettings

Option Name Description Requires
0 Do not change This value (or the absence of this parm from the XML) will cause no changes to Ethernet Proxy settings; any previously selected setting will be retained.

OSX: 6.2+

MX: 6.2+

Android API Level: 23+

1 None Disables the use of an Ethernet Proxy.

OSX: 6.2+

MX: 6.2+

Android API Level: 23+

2 Manual Enables the use of an Ethernet Proxy.

OSX: 6.2+

MX: 6.2+

Android API Level: 23+

Set Proxy Host Name

Used to specify the Host Name of the Proxy server through which network communications will pass.

Parm value input rules:

  • String from 1-64 characters specifying the Proxy Host Name. For example: "www.MyProxyHostServer.com"

Shown if: Ethernet Proxy Setting is "Manual"

Parm Name: ProxyHostName

Requires:

  • OSX: 6.2+
  • MX: 6.2+
  • Android API Level: 23+

Set Proxy Port

Used to specify the two-digit Port number for accessing the Proxy server through which network communications will pass.

Parm value input rules:

  • Integer specifying the two-digit Port number of the Proxy server being used

Shown if: Ethernet Proxy Setting is "Manual"

Parm Name: ProxyPort

Requires:

  • OSX: 6.2+
  • MX: 6.2+
  • Android API Level: 23+

Set Bypass Proxy

Used to specify the host name(s) and/or IP address(es) for direct access by a device, bypassing the Proxy server specified in the Proxy Host Name parameter. Multiple names and/or IP addresses can be specified in any combination, separated by commas. Generally used for specifying internal servers and/or as a means to prevent traffic overload on the specified Proxy server. Traffic bound for any host not specifically excluded using this parameter will be routed through the specified Proxy server.

Zebra recommends testing bypass-proxy settings on a working device before general deployment.

Parm value input rules:

  • String from 1-256 characters specifying one or more host names and/or IP addresses separated by commas. For example: "www.MyBypassProxy.com,192.168.1.100, our.internalServer"

Shown if: Ethernet Proxy Setting is "Manual"

Parm Name: BypassProxy

Requires:

  • OSX: 6.2+
  • MX: 6.2+
  • Android API Level: 23+