The "SmartDocs" bar can customize this page to show only the features present on a particular Zebra device.
OSX, MX and Android version information for a device can be found in the Android Settings panel or by querying the device through ADB, EMDK or the MX CSP. More info.
The ComponentMgr is used to configure the state and usage of subsystems such as Ethernet on the device. The state defines whether a subsystem is On (active) or Off (inactive). Usage enables or disables the subsystem and controls whether its state can be changed (turned On or Off) by the device user through the System Settings Menu or programmatically using the ComponentMgr. If an attempt is made to use the ComponentMgr to control the state of a subsystem for which usage is currently disabled, an error will be returned in the Result XML document.
Note: Not every device supports every subsystem. For example, some devices have no support for Ethernet. Attempts to use the ComponentMgr to control the state or usage of a subsystem that is not supported on a given device causes an error to be returned in the Result XML document.
Controls whether the state of the Ethernet Option can be changed. If the usage of Ethernet is Disabled and then Enabled, the state of Ethernet, either On or Off, will be the same as it was before it was Disabled.
Parm Name: EthernetUsage
| 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 settings, any previously selected setting is retained. |
OSX: 4.4+ MX: 4.4+ |
||
| 1 | Enable | Allows the state of the Ethernet Option to be changed by the device user or by the ComponentMgr. |
OSX: 4.4+ MX: 4.4+ |
||
| 2 | Disable | Prevents the state of the Ethernet Option to be changed by the device user or by the ComponentMgr. |
OSX: 4.4+ MX: 4.4+ |
Used to change the state of the Ethernet option.
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 Ethernet settings; any previously selected setting is retained. |
OSX: 4.4+ MX: 4.4+ |
||
| 1 | Turn on | Tturns on the Ethernet Option to be turned On, allowing the use of an Ethernet connection on the device. |
OSX: 4.4+ MX: 4.4+ |
||
| 2 | Turn off | turns off Ethernet Option, disallowing the use of an Ethernet connection on the device. |
OSX: 4.4+ MX: 4.4+ |
<wap-provisioningdoc>
<characteristic type="ComponentMgr" version="4.4">
<parm name="EthernetUsage" value="1"/>
<parm name="EthernetState" value="1"/>
</characteristic>
</wap-provisioningdoc>
The following XML is an example of an error that is returned when trying to set Ethernet features on a device that does not support Ethernet functionality.
<wap-provisioningdoc>
<characteristic-error desc="exception" type="ComponentMgr" version="4.4" >
<parm-error name="EthernetUsage" desc="Error in enabling Ethernet UI" value="1" />
<parm-error name="EthernetState" desc="Failed to Turn On. Ethernet is disabled by admin" value="1" />
</characteristic-error>
</wap-provisioningdoc>
Queries are not supported on Zebra devices running Android 11 or later.
This query will indicate if the state of the Ethernet Option can be changed.
<wap-provisioningdoc>
<characteristic type="ComponentMgr">
<parm-query name="EthernetUsage"/>
</characteristic>
</wap-provisioningdoc>
<wap-provisioningdoc>
<characteristic type="ComponentMgr" version="4.4">
<parm name="EthernetUsage" value="1"/>
</characteristic>
</wap-provisioningdoc>
This query will indicate if the Ethernet State of the device is currently set to On or Off.
<wap-provisioningdoc>
<characteristic type="ComponentMgr">
<parm-query name="EthernetState"/>
</characteristic>
</wap-provisioningdoc>
<wap-provisioningdoc>
<characteristic type="ComponentMgr" version="4.4">
<parm name="EthernetState" value="1"/>
</characteristic>
</wap-provisioningdoc>