Ethernet Manager

To display only the features present on a particular device, select one or more filters from the SmartDocs bar below.

Input fields accept ENGLISH ONLY.

Queries from MX are not supported on Zebra devices running Android 11 or later. See alternative method.

EMDK for Xamarin - 9.0

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
  • Enter Host Name(s) and/or IP address(es) that bypass the Proxy
  • Select the authentication method used for access to a network
  • Set the username and password for connecting to a network
  • Enter a client certificate for connecting to a network
  • Enter an optional server certificate for connecting to a network
  • Enter the domain name of a network to be joined

Some features are available only on Zebra 6490-platform devices. See platform-device list.

Ethernet Enable/Disable

Used to control 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 Note Status 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: 23+

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

OSX: 6.2+

MX: 6.2+

Android API: 23+

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

OSX: 6.2+

MX: 6.2+

Android API: 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 (below).

Parm Name: ConfigIpAddr

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

OSX: 6.2+

MX: 6.2+

Android API: 23+

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

OSX: 6.2+

MX: 6.2+

Android API: 23+

Use DHCP (checkbox)

Controls whether the Ethernet-equipped cradle obtains an IP settings automatically using DHCP or manually by an administrator. 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 Note Status Requires
0 (unchecked) Allows IP address settings to be configured manually.

OSX: 6.2+

MX: 6.2+

Android API: 23+

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

OSX: 6.2+

MX: 6.2+

Android API: 23+

Set IP Address

Used to enter 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 (e.g. 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: 23+

Set Default Gateway

Used to enter 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 (e.g. 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: 23+

Set Subnet Mask

Used to enter 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 (e.g. 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: 23+

Set Primary DNS

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

Parm value input rules:

  • String containing a valid IPv4 address (e.g. 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: 23+

Set Secondary DNS

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

Parm value input rules:

  • String containing a valid IPv4 address (e.g. 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: 23+

Ethernet Proxy Enable/Disable

Controls whether an Ethernet Proxy is 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 traffic is routed through that server.

Parm Name: SetEthernetProxySettings

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

OSX: 6.2+

MX: 6.2+

Android API: 23+

1 None Disables the use of an Ethernet Proxy.

OSX: 6.2+

MX: 6.2+

Android API: 23+

2 Manual Enables the use of an Ethernet Proxy.

OSX: 6.2+

MX: 6.2+

Android API: 23+

Set Proxy Host Name

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

Parm value input rules:

  • String from 1–64 characters containing the Proxy Host Name (e.g. www.MyProxyHostServer.com)

Shown if: Ethernet Proxy Setting is "Manual"

Parm Name: ProxyHostName

Requires:

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

Set Proxy Port

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

Parm value input rules:

  • Integer containing 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: 23+

Set Bypass Proxy

Used to enter 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 entering 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 entering one or more host names and/or IP addresses separated by commas. For example: "www.MyBypassProxy.com,192.168.1.100,our.internalServer.lan"

Shown if: Ethernet Proxy Setting is "Manual"

Parm Name: BypassProxy

Requires:

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

Authentication Type

Used to select the type of authentication required for connecting to a network.

Note: This feature is supported only on Zebra 6490-platform devices.

Parm Name: Authentication

Option Name Description Note Status Requires
99 Do not change This value (or the absence of this parm from the XML) causes no change to device settings; any previously selected setting is retained.

MX: 13.3+

Android API: 33+

0 Disable Sets the authentication type to 'NONE'

MX: 13.3+

Android API: 33+

1 EAP-TLS Sets authentication to 802.1x Extensible Authentication Protocol - Transport Layer Security (EAP-TLS).

MX: 13.3+

Android API: 33+

Identity

Used to enter the user name for authentication on a network.

Parm value input rules:

  • String from 0–64 characters containing the network user name

Note: This feature is supported only on Zebra 6490-platform devices.

Shown if: Authentication is set to "EAP-TLS" or "PEAP-MSCHAPV2"

Parm Name: Identity

Requires:

  • MX: 13.3+
  • Android API: 33+

Password

Used to enter the password corresponding to the user name entered in the Identity field.

Parm value input rules:

  • String from 0–64 characters containing the relevant password

Note: This feature is supported only on Zebra 6490-platform devices.

Shown if: Authentication is set to "PEAP-MSCHAPV2"

Parm Name: Password

Requires:

  • MX: 13.3+
  • Android API: 33+

Domain Name

Used to enter the domain name of the network to be joined.

Parm value input rules:

  • String from 0–64 characters containing a valid domain name (e.g. myCompanyDomain.com)

Note: This feature is supported only on Zebra 6490-platform devices.

Parm Name: DomainName

Requires:

  • MX: 13.3+
  • Android API: 33+

Mandatory Client Certificate

Used to enter the name of the certificate to validate a user on a network.

Parm value input rules:

  • String from 1–64 characters containing a client certificate

Note: This feature is supported only on Zebra 6490-platform devices.

Shown if: Authentication is set to "EAP-TLS"

Parm Name: MandatoryClientCertificate

Requires:

  • MX: 13.3+
  • Android API: 33+

Optional CA Certificate

Used to enter the name of the optional certificate (if used) to validate a server on a network.

Parm value input rules:

  • String from 0–64 characters containing a CA server certificate

Note: This feature is supported only on Zebra 6490-platform devices.

Shown if: Authentication is set to "EAP-TLS" or "PEAP-MSCHAPV2"

Parm Name: OptionalCACertificate

Requires:

  • MX: 13.3+
  • Android API: 33+