About this Guide
Type Styling
- Bold Italic type indicates values of a Managed Configuration such as On or Enable.
- Bold type indicates the name of an MC, Group, Sub-group, or Sub-array, such as the System Configuration Group, the Keyboard Configuration Sub-group, the Packages Sub-array, or the State Managed Configuration.
- Italic type is used for emphasis and for referencing Defined Terms, such as Sub-group and Instance. Defined terms are Capitalized to differentiate them from italics used solely for emphasis.
General Terms
- MC
See Managed Configuration.
- Managed Configuration
A Managed Configuration is a single configurable item, defined within the OemConfig Schema, that can be used, alone or in conjunction with other MCs, to change some aspect of device behavior.
- Group
See Managed Configuration Group.
- Managed Configuration Group
A Managed Configuration Group is a collection of Sub-groups or Sub-arrays that are defined to control multiple related aspects of device behavior (such as System Configuration or UI Configuration). A Group can include no more than one instance of any Sub-group or Sub-array that is defined for that Group.
- Sub-group
A Sub-group is a collection of MCs, Sub-groups, or Sub-arrays that can be used to control some sub-aspect of device behavior (such as the Clock Configuration Sub-group within the System Configuration Group). A Sub-group can include no more than one instance of any MC, Sub-group, or Sub-array defined for that Sub-group.
- Sub-array
A Sub-array is an ordered list of instances of a SINGLE Sub-group, each of which can contain anything that is defined for that Sub-group. The only time the same MC, Sub-group, or Sub-array can be included more than once into the same Sub-group is when it appears within different Instances of that Sub-group within a Sub-array.
Android Terms
- Android Package
An Android Package is how executable code is packaged for execution on Android devices. Android Packages can be built-into the Operating System image (OS), in which case they are referred to as being built-in, pre-loaded, or pre-installed. Android Packages that are not built-in can be added to an Android device by downloading and installing them, in which case they are referred to as post-loaded, post-installed, or installable. Each Android Package is identified by a unique Android Package Name and can contain one or more Android Activities and/or Android Services.
Android defines a series of standard behaviors that will generally be exhibited by Android Packages which may vary based on whether an Android Package is pre-loaded or post-loaded and based on whether the Android Package is Trusted or Untrusted. Most Android Packages will fall into one of the following basic types:
- Built-in System Application
A Built-in System Package is pre-loaded as part of the OS and is granted special System Permissions on the device. This makes it a Trusted Package and allows it to interact with system services and use System APIs that are not available to Non-Trusted Packages. Zebra carefully controls and vets all such Android Packages before building them into the OS to ensure that they are safe and contribute beneficially to the overall device experience without creating performance, security, or usability issues.
- Built-in Non-System Package
A Built-in Non-System Package is pre-loaded as part of the OS but is not granted any special System Permissions on the device. This makes it an Untrusted Package and allows it to interact with system services and to use System APIs that are not available to Non-Trusted Packages. Zebra carefully controls and vets all such Android Packages* before building them into the OS to ensure that they contribute beneficially to the overall device experience without creating performance or usability issues.
- Installable System Package
An Installable System Package must be post-loaded, since it is not part of the OS but is granted special System Permissions on the device. This makes it a Trusted Package and allows it to interact with system services and to useSystem APIs that are not available to Non-Trusted Packages. Only Zebra can provide such Android Packages* and Zebra carefully controls and vets all such Android Packages* it provides before they are published to ensure that they are safe and contribute beneficially to the overall device experience without creating performance, security, or usability issues. Ultimately, the decision of whether to install such an Android Package* on a device is the responsibility of the Device Administrator.
- Installable Non-System Package
An Installable Non-System Package must be post-loaded, since it is not part of the OS and is not granted any special System Permissions on the device. This makes it anUntrusted Package and prevents it from interacting with system services and from using System APIs that are not available to Non-Trusted Packages. Zebra carefully controls and vets all such Android Packages* before they are published to ensure that they contribute beneficially to the overall device experience without creating performance or usability issues. Zebra cannot and does not control or guarantee the suitability of such Android Packages* that it does not provide. Ultimately, evaluating such an Android Package* and deciding whether to install it on a device is the responsibility of the Device Administrator.
- Android Package Name
An Android Package Name is a string that uniquely identifies one or more versions of an Android Package.
- Android Application
An Android Application refers to an Android Package that contains at least one Android Activity and therefore has some in-device UI for interacting with the User to differentiate it from other Android Packages that may only have Android Services and therefore have no UI for interacting with the User.
- Android Status Bar
The Android Status Bar is an area at the top edge of the screen on an Android device where various status information can be displayed to the User.
- Android Notification Bar
The Android Notification Bar is an area at the bottom edge of the screen on an Android device where soft buttons are provided to allow the User to navigate within the UI of the device.
Additional Terms
The above terms have been defined here because they may be generally used throughout this document. Additional terms will be defined in subsequent sections of this document as needed to clarify concepts and usage specific to those sections.
Files Configuration
Use this Array to configure one or more special handlings for File(s)
Files are a fundamental unit of storage in Android, via which data is organized and stored within the storage areas of an Android device. The following terms can help understand how Files are used in Android:
- Device File System
Device File System is generically used to refer to any storage area in an Android device in which data, organized as files, can reside. This term can refer to Files that are built-into the device, but it is most commonly used to refer to Files that are stored in storage areas on the device that can be modified during normal device operation.
- Media Storage
Media Storage is generically used to refer to any storage area in an Android device in which common types of media data (such as pictures, video, audio, etc.), organized as files, can reside. This term is most commonly used to refer to storage where media files can be stored and shared by multiple applications.
- Application Sandbox
Application Sandbox is generically used to refer to any storage area in an Android device in which private application data, organized as files, can reside. This term can apply to private files stored in Primary Storage, Secondary Storage, or Portable Storage. The key criteria that applies to all Application Sandbox data, and that differentiates it from other data, is the fact that it is owned by and generally accessible only to the Android Package that created it.
- Shared Folders
Shared Folders is generically used to refer to any storage area in an Android device in which data, organized as files, can reside and be shared amongst multiple Android Packages. Android generally discourages the use of Shared Folders and has added more and more restrictions over time to limit their use. In particular, Scoped Storage is a recent addition to Android designed to severely restrict the use of Shared Folders to share data between Android Packages. Android provides other mechanisms, such as Intents, Content and File Providers, and the Storage Access Framework to enable sharing of data amongst Android Packages to be done in a more secure and controlled manner than could ever be achieved using Shared Folders. For the time being, many Zebra Android devices support the use of the following Shared Folders, but these are expected to be phased out over time to better comply with Android standard practice:
- /data/tmp/public
The folder /data/tmp/public is unique to Zebra Android devices and is commonly used for downloading Transient Files, such as Local Update Files for OS Updates.
- /enterprise/usr
The folder /enterprise/usr is unique to Zebra Android devices and is commonly used for downloading Persistent Files, such as Android Packages that might need to be re-installed following an Enterprise Reset.
Most Files stored in an Android device do NOT require any special handling. Most Files are created, read, updated, and deleted by the system and/or by applications on a device without any outside intervention. But some Files MAY require special handling, in which case this Array is used to identify which Files require special handling and what special handling each such File requires. The following classes of special handling might be required:
- Delete File
Delete File special handling would be appropriate when there was a need for a File to be Deleted (removed from the Device File System) for some reason NOT driven by device system or applications. For example, a File might be created by an application that neglects to delete it, resulting in a large amount of space being occupied. Deleting such a File, under the right conditions, could be quite beneficial.
- Download File
Download File special handling would be appropriate when there was a File that was created off-device that needed to be delivered to the device to support some system or application service that needed to consume that File. For example, a Local Update File used to initiate an OS Update would generally originate off-device and need to be Downloaded before it could be used to initiate such an OS Update.
- Upload File
Upload File special handling would be appropriate when there was a File that was created by the system and/or by applications on a device that needed to be Uploaded to somewhere off-device for its eventual consumption there. For example, a Log File might be uploaded to a server so it could be used for troubleshooting or analysis.
Special handling must be carefully defined to avoid the potential for repetition which could cause harm or negatively impact device performance. For example, repeatedly downloading the same file could have multiple negative effects, such as slowing down the device, clogging up the network, wearing out flash memory, etc.
This Array is used to specify which Files require special handling. Any File that does NOT require special handling should not have an element in this Array, indicating that NO special handling should be performed. Any File that DOES require special handling should not have an element in this Array that specifies ALL special handlings required for that File.
If this Array has never been specified (never included in the MCs sent), then no configuration of special handling will be configured for any Files.
If this Array is not specified (not included in the MCs sent), then no changes will be made to the configuration defined by any previously specified version of this Array.
If this Array is specified (included in the MCs sent), then the specified Array will entirely replace the configuration defined by any previously specified Array.
Note that it is NOT possible to specify an "empty" Array (with zero elements). Every Array must contain at least one element. Any element(s) in this Array where a blank (empty string) value is entered for Device Path And Name will be ignored. It is therefore possible to specify a "virtually empty" Array by entering a a blank (empty string) value for Device Path And Name in every element of the Array.
- If this Array is specified (included in the MCs sent), but that Array is "virtually empty", as described above, then all special handling previously configured by any previously specified Array will be removed, thus returning to a state equivalent to when no Array had ever been specified.
Detail Information:
Key = filesConfig
Type = bundle_array
File
Use this Sub-group to configure Device Path And Name, Delete Options, Download Options, Download Server URI, Upload Options, Upload File Selector, Upload Server URI, and Upload File Name Pattern.
Detail Information:
Key = filesConfigFile
Type = bundle
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Device Path And Name
Enter the Path and File Name of a single File in the Device File System for which special handling is required.
Every element in the Array Files Configuration must specify SOME value for this MC.
If a blank (empty string) value is entered, then the element of the Array will be ignored (not processed), producing the same result as if the element of the Array was not present.
If a non-blank (non-empty string) value is entered, then the element of the Array will be processed and the value must specify a File that DOES or COULD exist in the Device File System.
Detail Information:
Key = filesConfigDevicePathAndName
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Delete Options
Use this Sub-array to configure one or more Delete Option(s)
This Sub-array is used to specify that Delete File special handling is required for the File specified by the value in Device Path And Name in the element of the Array Files Configuration in which this Sub-array appears.
Detail Information:
Key = filesConfigDeleteOptions
Type = bundle_array
Delete Option
Use this Sub-group to configure Delete Option Type.
Detail Information:
Key = fileMgmtDeleteOption
Type = bundle
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Delete Option Type
Select the Type of a single Delete Option that defines a Delete File special handling to be performed for the File specified by the value in Device Path And Name in the element of the Array Files Configuration in which it appears.
Detail Information:
Key = fileMgmtDeleteOptionType
Type = string
UI Choice | JSON Value |
---|---|
Always | 1 |
After Reboot(s) | 2 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Download Options
Use this Sub-array to configure one or more Download Option(s).
Detail Information:
Key = filesConfigDownloadOptions
Type = bundle_array
Download Option
Use this Sub-group to configure Download Option Type.
Detail Information:
Key = fileMgmtDownloadOption
Type = bundle
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Download Option Type
Select the Type of a single Download Option to be to be applied when downloading a single File to the device.
Detail Information:
Key = fileMgmtDownloadOptionType
Type = string
UI Choice | JSON Value |
---|---|
On Server | 1 |
On Server but not on Device | 2 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Download Server URI
Enter the URI on a Server from which a single File to be managed in the Device File System can be Downloaded.
Detail Information:
Key = filesConfigDownloadServerUri
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Upload Options
Use this Sub-array to configure one or more Upload Option(s).
Detail Information:
Key = filesConfigUploadOptions
Type = bundle_array
Upload Option
Use this Sub-group to configure Upload Option Type.
Detail Information:
Key = fileMgmtUploadOption
Type = bundle
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Upload Option Type
Select the Type of a single Upload Option to be to be applied when managing a single File in the Device File System.
Detail Information:
Key = fileMgmtUploadOptionType
Type = string
UI Choice | JSON Value |
---|---|
Not on Server | 1 |
Sorted By Name | 3 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Upload File Selector
Enter a Source Path and File Name (with optional wildcard characters) that will be used to Select one or more Files in the Device File System that will be Uploaded to a Server.
Detail Information:
Key = filesConfigUploadFileSelector
Type = string
Upload Server URI
Enter the URI of a Server location to which File(s) in the Device File System will be uploaded.
Detail Information:
Key = filesConfigUploadServerURI
Type = string
Upload File Name Pattern
Enter a Pattern to be used to craft the File Names on a Server that should be used when Uploading Files Selected from the Device File System. The Pattern may contain any characters that are valid for use in a File Name on the Server, which may vary by Server but will generally include letters, digits, and a decimal point (dot) and may also contain one or more of the following:
- If the constant value %model% appears in the Pattern, then it will be replaced with the model name of the device.
- If the constant value %serial% appears in the Pattern, then it will be replaced with the serial number of the device.
- If the constant value %date% appears in the Pattern, then it will be replaced with the date the File was created in the Device File System.
- If the constant value %time% appears in the Pattern, then it will be replaced with the time the File was created in the Device File System.
For example, if the Pattern was Log-%model%-%serial%-%date%-%time%.zip, a File that is Uploaded to the Server might be assigned the File Name Log-TC51-123456789-041520-112300.zip, indicating that the File was a Log File that was Created on a TC51 device whose serial number was 123456789 and where the File was created in the Device File System at 11:23 AM on April 15, 2020.
Detail Information:
Key = filesConfigUploadFileNamePattern
Type = string
Keyboard Mappings
Use this Array to configure one or more Keyboard Mapping(s)
The following defined terms are important to understand:
- Key
Key refers to any physical switch that can be activated through manual pressure or any logical (e.g. On-Screen) button that can be activated using a touch panel or other pointing device.
- Keyboard
Keyboard refers to any input mechanism that utilizes Keys that can be pressed to enter data into a mobile device.
- Built-In Keyboard
Built-In Keyboard refers to a Keyboard that is physically integrated with and is generally inseparable from a mobile device and where Keys are generally activated by manual pressure.
- On-Screen Keyboard
On-Screen Keyboard refers to a Keyboard that is displayed on the screen and where Keys are generally activated by a touch panel or other pointing device. In Android devices, On-Screen Keyboards are typically implemented through the Soft Input Panel (SIP) mechanism.
- External Keyboard
External Keyboard refers to a Keyboard that is physically separate from a mobile device and that must be connected to the mobile device via some communications channel, such as Bluetooth or USB, and where Keys are generally activated by manual pressure.
- Key Behavior
Key Behavior refers to what will occur when a Key on a Keyboard is activated. Key Behavior for a Key may vary depending on the current Keyboard State of a Keyboard when the Key is activated on that Keyboard.
- Keyboard Mapping
Keyboard Mapping refers to configuration that alters the operation of a Keyboard by changing The Key Behavior for one or more Keys on that Keyboard.
- Keyboard State
Keyboard State refers to a logical state that a Keyboard can be in and which affects the Key Behavior of Keys that are pressed while in that state. Standard Keyboard States include Shift, Caps Lock, Control, and Alt. Built-In Keyboards on Zebra Android devices may also support non-standard Keyboard States, such as Function, Blue, Orange, etc.
- Mapping Table
Mapping Table refers to a table maintained in memory on a Zebra Android device that holds the Keyboard Mappings defined for a Keyboard that apply to a particular Keyboard State. For example, the Shift Mapping Table for a Keyboard would contain Keyboard Mappings that apply to Keys pressed only when that Keyboard is in the Shift Keyboard State. Consult the product documentation for a Zebra Android device to determine which Mapping Tables it supports.
- Key Identifier
Key Identifier refers to a value used to uniquely identify a Key on a Keyboard so the Key Behavior of that Key can be altered via a Keyboard Mapping for that Key. Key Identifiers are most commonly string values that match the label of a Key, for keys that are labelled. For example, the Key Identifier "A" would used to identify a Key that is labelled as having that function. In some cases, a Key may be labeled with a graphical symbol that cannot easily be represented through a direct text string. For example, the "Left Arrow" Key may be labeled with a graphical arrow symbol, in which the Key Identifier will attempt to describe that symbol (e.g. "Left"). In some cases, a Key may be unlabeled, in which case the Key Identifier will attempt to describe the Key using functional and/or positional information. For example, the "Volume Up" Key is unlabeled and will describe the function of the Key (e.g. "Volume Up") and the yellow "Scan" trigger Key on the left hand side of the device might be unlabeled and will describe the function and position of the Key (e.g. "Left Trigger").
- Key Code
Key Code refers to a value that is sent to the Android System when a key is activated to indicate how the key should be interpreted.
- Trigger Signal
Trigger Signal refers to a logical indication, on a Zebra Android device, that a Key has been activated that is configured to behave as a trigger. Various Zebra Value-Add services, such as Barcode Scanning, are designed to respond to Trigger Signals.
This Array allows Keyboard Mappings to be defined for Built-In Keyboards only.
Each element of this Array:
Defines a Keyboard Mapping for a single Key on the Built-In Keyboard, identified by the Key Identifier value specified in Key ID. By adding multiple elements to this Array, Keyboard Mappings for multiple Keys can be defined.
Can define the behavior of the identified Key in one or more Mapping Tables that are supported by the Built-In Keyboard on a Zebra Android device. .
Detail Information:
Key = keyboardMappings
Type = bundle_array
Keyboard Mapping
Use this Sub-group to configure Key ID and Behaviors for a single Key on the Built-In Keyboard.
Key ID must be specified to provide the Key Identifier of the Key whose Key Behaviors will be altered in one or more Keyboard States.
The Sub-array Behaviors must be specified to define the Key Behavior to be defined as the Keyboard Mapping for the Key identified by the Key Identifier. .
Detail Information:
Key = keyboardMapping
Type = bundle
Key ID
Select the Key Identifier value that uniquely identifies the Key on the Built-In Keyboard" whose *Key Behavior is to be changed in one or more Keyboard States.
Detail Information:
Key = keymappingKeyId
Type = string
UI Choice | JSON Value |
---|---|
0 | 0 |
1 | 1 |
2 | 2 |
3 | 3 |
4 | 4 |
5 | 5 |
6 | 6 |
7 | 7 |
8 | 8 |
9 | 9 |
A | A |
B | B |
C | C |
D | D |
E | E |
F | F |
G | G |
H | H |
I | I |
J | J |
K | K |
L | L |
M | M |
N | N |
O | O |
P | P |
Q | Q |
R | R |
S | S |
T | T |
U | U |
V | V |
W | W |
X | X |
Y | Y |
Z | Z |
. (Period) | DOT |
, (Comma) | COMMA |
* (Star) | STAR |
# (Pound) | POUND |
F1 | F1 |
F2 | F2 |
F3 | F3 |
F4 | F4 |
F5 | F5 |
F6 | F6 |
F7 | F7 |
F8 | F8 |
F9 | F9 |
F10 | F10 |
F11 | F11 |
F12 | F12 |
Enter | ENTER |
Up | UP |
Down | DOWN |
Left | LEFT |
Right | RIGHT |
NAV_OK | NAV_OK |
Escape | ESC |
Backspace | BACKSPACE |
Space | SPACE |
Return | RETURN |
Clear | CLR |
Field Exit | FIELD_EXIT |
Alt | ALT |
Control | CTRL |
Shift | SHIFT |
Func | FUNC |
Alpha | ALPHA |
CL | CL |
FN | FN |
Blue | BLUE |
Orange | ORANGE |
Grey | GREY |
Diamond | DIAMOND |
Green Dot | GREEN |
Red Dot | RED |
Volume Up | VOLUMEUP |
Volume Down | VOLUMEDOWN |
Scan | SCAN |
Grip Trigger | GRIP_TRIGGER |
Grip Trigger 2 | GRIP_TRIGGER_2 |
Button L1 | LEFT_TRIGGER_1 |
Button L2 | LEFT_TRIGGER_2 |
Button R1 | RIGHT_TRIGGER_1 |
Button R2 | RIGHT_TRIGGER_2 |
Left Trigger | LEFT_TRIGGER |
Right Trigger | RIGHT_TRIGGER |
Center Trigger | CENTER_TRIGGER |
Gun Trigger | GUN_TRIGGER |
Headset Button | HEADSET_HOOK |
Back | BACK |
Home | HOME |
Menu | MENU |
Recent | RECENT |
Search | SEARCH |
Keyboard Backlight | KEYLIGHT |
Display Backlight | LAMP |
Power | POWER |
P1 Button | P1 |
P2 Button | P2 |
P3 Button | P3 |
P4 Button | P4 |
P5 Button | P5 |
P6 Button | P6 |
W1 Button | W1 |
W2 Button | W2 |
Rear Button | REAR_BUTTON |
Left External Trigger | LEFT_EXTERNAL_TRIGGER |
Right External Trigger | RIGHT_EXTERNAL_TRIGGER |
Bluetooth Remote Trigger 1 | BLUETOOTH_REMOTE_TRIGGER_1 |
Bluetooth Remote Trigger 2 | BLUETOOTH_REMOTE_TRIGGER_2 |
Touch NAV_PAD | NAV_PAD |
Macro 1 | M1 |
Macro 2 | M2 |
Macro 3 | M3 |
Macro 4 | M4 |
Macro 5 | M5 |
Macro 6 | M6 |
Brightness Up | BRIGHTNESSUP |
Brightness Down | BRIGHTNESSDOWN |
Keyboard | KEYBOARD |
Keyboard Backlight Brightness Up | KEYLIGHTUP |
Keyboard Backlight Brightness Down | KEYLIGHTDOWN |
Rotate | ROTATE |
+ (Plus) | PLUS |
- (Minus) | MINUS |
Pause | PAUSE |
End | END |
Page Up | PAGEUP |
Page Down | PAGEDOWN |
Tab | TAB |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Behaviors
Use this Sub-array to configure one or more Key Behaviors for a Key on the Built-In Keyboard.
Detail Information:
Key = keymappingBehaviors
Type = bundle_array
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Behavior
Use this Sub-group to configure Table Name, Behavior Type, Send Key Code, Alt State, Ctrl State, Fn State, Shift State, Send Trigger, Send Intent, Intent Method, Intent Action, Intent Category, Intent Package Name, Intent Class, Intent Data URI, Intent MIME Type, Intent Extra Name, Intent Extra Value, Intent Flags, Send Intent - Intent Add Key Event, and Launch Application Name to define a single Key Behavior for a Key on the Built-In Keyboard.
Table Name must be specified to identify the Mapping Table into which the Key Behavior should be stored and which will thereby define the Keyboard State in which the Key must be activated in order for the Key Behavior to occur.
Behavior Type must be specified to identify the type of Key Behavior being defined.
Detail Information:
Key = keymappingBehavior
Type = bundle
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Table Name
Select the name of the Mapping Table into which the Key Behavior should be stored and which will thereby define the Keyboard State in which the Key must be activated in order for the Key Behavior to occur.
Each Mapping Table is associated with a Keyboard State and is generally named based on the state Key on the Built-in Keyboard that causes that Keyboard State to be set or cleared. Note that due to variations in the size, layout, and intended use cases of Built-In Keyboards on various Zebra Android devices, not all Keyboard States may be supported on any given device. Consult the product documentation for a device to determine the supported Keyboard States and Mapping Tables.
Some or all of the following values may be supported by a Zebra Android device:
If the value Base is selected, the Base Mapping Table will be selected. The Base Mapping Table is used to store the Key Behaviors that will be performed for Keys that are activated under conditions where no Keyboard States are set.
If the value Blue is selected, the Blue Mapping Table will be selected. The Blue Mapping Table is used to store the Key Behaviors that will be performed for Keys that are activated under conditions where the Blue Key has been used to set the Blue Keyboard State.
If the value Orange is selected, the Orange Mapping Table will be selected. The Orange Mapping Table is used to store the Key Behaviors that will be performed for Keys that are activated under conditions where the Orange Key has been used to set the Orange Keyboard State.
If the value Grey is selected, the Grey Mapping Table will be selected. The Grey Mapping Table is used to store the Key Behaviors that will be performed for Keys that are activated under conditions where the Grey Key has been used to set the Grey Keyboard State.
If the value Diamond is selected, the Diamond Mapping Table will be selected. The Diamond Mapping Table is used to store the Key Behaviors that will be performed for Keys that are activated under conditions where the Diamond Key has been used to set the Diamond Keyboard State.
If the value Shift is selected, the Shift Mapping Table will be selected. The Shift Mapping Table is used to store the Key Behaviors that will be performed for Keys that are activated under conditions where the Shift Key has been used to set the Shift Keyboard State.
If the value Control is selected, the Control Mapping Table will be selected. The Control Mapping Table is used to store the Key Behaviors that will be performed for Keys that are activated under conditions where the Control Key has been used to set the Control Keyboard State.
Detail Information:
Key = keymappingBehaviorTableName
Type = string
UI Choice | JSON Value |
---|---|
Base | Base |
Blue | Blue |
Orange | Orange |
Grey | Grey |
Diamond | Diamond |
Shift | Shift |
Control | Control |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Behavior Type
Select the type of Key Behavior that will be performed when a specified Key is activated while the Keyboard State associated with the specified Mapping Table is set.
The following values are supported:
- If the value Send Key Code is selected, the Key Behavior performed when the specified Key is activated while the Keyboard State associated with the specified Mapping Table is set will be to send a specified Key Code. This can be thought of as being “Classic Keyboard Remapping”, since it causes the standard Key Behavior of a Key, which is generally to send a standard Key Code to be altered to send a different Key Code, which may or may not be present on the Built-In Keyboard and hence might otherwise not been possible to send without using Key Mapping. You must also specify Send Key Code to provide the Key Code that will be sent.
- If the value Send Trigger is selected, the Key Behavior performed when the specified Key is activated while the Keyboard State associated with the specified Mapping Table is set will be to send a Trigger Signal. You must also specify Send Trigger to select which Trigger Signal will be sent,
- If the value Launch Application is selected, the Key Behavior performed when the specified Key is activated while the Keyboard State associated with the specified Mapping Table is set will be to launch an application. You must also specify Launch Application Name to provide the Friendly Name of the application to be launched. Note that this is NOT the Android Package Name. To launch an application by its Android Package Name, the value Send Intent should be select.
- If the value Send Intent is selected, the Key Behavior performed when the specified Key is activated while the Keyboard State associated with the specified Mapping Table is set will be to send an Android Intent, which might cause any number of possible results, depending on the nature of the intent configured to be sent. You must also specify some or all of the following to define the Android Intent to be sent:
- Intent Method
- Intent Action
- Intent Category
- Intent Package Name
- Intent Class
- Intent Data URI
- Intent Flags
- Intent MIME Type
- Intent Extra Name
- Intent Extra Value
Sending an Android Intent provides a very flexible way to specify the Key Behavior to be performed for a Key by invoking an application or service. As such, there are many options that control the nature of the intent that will be sent. It is generally recommended to fully understand the nature of the Android Intent to be sent before attempting to configure it as a Key Key Behavior. In many cases, the application or service to be invoked will define the nature of the intent it wishes to receive and that definition can be used to drive the configuration.
- If the value Suppress Key is selected, NO Key Behavior will be performed when the specified Key is activated while the Keyboard State associated with the specified Mapping Table is active. This provides a method to change a Key to do nothing (act as if it was Key has not been activated).
- If the value Reset To Default is selected, the Key Behavior performed when the specified Key is activated while the Keyboard State associated with the specified Mapping Table is active be reset back to its default. This will effectively remove any prior mapping of that Key in that Keyboard State and return the Key to its out-of-box Key Behavior in that Keyboard State.
Detail Information:
Key = keymappingBehaviorType
Type = string
UI Choice | JSON Value |
---|---|
Send Key Code | 2 |
Send Trigger | 1 |
Launch Application | 4 |
Send Intent | 3 |
Suppress Key | 5 |
Reset To Default | 7 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Send Key Code
Select the Key Code that will be sent as the Key Behavior for a specified Key when activated in a specified Keyboard State and when the value Send Key Code is selected for Behavior Type.
Detail Information:
Key = keymappingBehaviorTypeSendKeyCode
Type = string
UI Choice | JSON Value |
---|---|
0 | 7 |
1 | 8 |
2 | 9 |
3 | 10 |
4 | 11 |
5 | 12 |
6 | 13 |
7 | 14 |
8 | 15 |
9 | 16 |
+ (Plus) | 81 |
- (Minus) | 69 |
= (Equals) | 70 |
( (Left Bracket) | 71 |
) (Right Bracket) | 72 |
` (Grave) | 68 |
/ (Slash) | 76 |
\\\\ (Backslash) | 73 |
; (Semicolon) | 74 |
' (Apostrophe) | 75 |
, (Comma) | 55 |
. (Period) | 56 |
* (Star) | 17 |
# (Pound) | 18 |
@ (At) | 77 |
A | 29 |
B | 30 |
C | 31 |
D | 32 |
E | 33 |
F | 34 |
G | 35 |
H | 36 |
I | 37 |
J | 38 |
K | 39 |
L | 40 |
M | 41 |
N | 42 |
O | 43 |
P | 44 |
Q | 45 |
R | 46 |
S | 47 |
T | 48 |
U | 49 |
V | 50 |
W | 51 |
X | 52 |
Y | 53 |
Z | 54 |
Enter | 66 |
Tab | 61 |
Space | 62 |
Escape | 111 |
Delete | 67 |
F1 | 131 |
F2 | 132 |
F3 | 133 |
F4 | 134 |
F5 | 135 |
F6 | 136 |
F7 | 137 |
F8 | 138 |
F9 | 139 |
F10 | 140 |
F11 | 141 |
F12 | 142 |
NUMPAD 0 | 144 |
NUMPAD 1 | 145 |
NUMPAD 2 | 146 |
NUMPAD 3 | 147 |
NUMPAD 4 | 148 |
NUMPAD 5 | 149 |
NUMPAD 6 | 150 |
NUMPAD 7 | 151 |
NUMPAD 8 | 152 |
NUMPAD 9 | 153 |
NUMPAD / (NUMPAD Divide) | 154 |
NUMPAD * (NUMPAD Multiply) | 155 |
NUMPAD - (NUMPAD Subtract) | 156 |
NUMPAD + (NUMPAD Add) | 157 |
NUMPAD . (NUMPAD Period) | 158 |
NUMPAD , (NUMPAD Comma) | 159 |
NUMPAD Enter | 160 |
NUMPAD = (NUMPAD Equals) | 161 |
NUMPAD { (NUMPAD Left Parenthesis) | 162 |
NUMPAD } (NUMPAD Right Parenthesis) | 163 |
DPAD Up | 19 |
DPAD Down | 20 |
DPAD Left | 21 |
DPAD Right | 22 |
DPAD Center | 23 |
Move Home | 122 |
Move End | 123 |
Page Up | 92 |
Page Down | 93 |
Insert | 124 |
Forward Delete | 112 |
Clear | 28 |
Lamp | 10024 |
Do Nothing | 10026 |
Blue | 10027 |
Orange | 10028 |
Grey | 10029 |
Diamond | 10039 |
Alt | 10030 |
Control | 10031 |
Shift | 10032 |
Keyboard | 10034 |
Touch Calibrate | 10035 |
Scan | 10036 |
Search Key | 10037 |
None | 10038 |
KeyLight | 10025 |
Keylight Up | 10040 |
Keylight Down | 10041 |
Left Shift | 59 |
Right Shift | 60 |
Left Alt | 57 |
Right Alt | 58 |
Left Control | 113 |
Right Control | 114 |
Meta Left | 117 |
Meta Right | 118 |
Caps Lock | 115 |
Num Lock | 143 |
Scroll Lock | 116 |
SysRq | 120 |
Break | 121 |
Function | 119 |
Back | 4 |
Forward | 125 |
Home | 3 |
Menu | 82 |
Settings | 176 |
Application Switch | 187 |
Calculator | 210 |
Explorer | 64 |
Envelope | 65 |
Bookmark | 174 |
Music | 209 |
Call | 5 |
End Call | 6 |
Microphone Mute | 91 |
Camera | 27 |
Search | 84 |
Contacts | 207 |
Calendar | 208 |
Volume Up | 24 |
Volume Down | 25 |
Volume Mute | 164 |
Brightness Up | 221 |
Brightness Down | 220 |
Power | 26 |
Sleep | 223 |
Wakeup | 224 |
Headset | 79 |
Push-to-talk | 228 |
Camera Focus | 80 |
Media Play/Pause | 85 |
Media Stop | 86 |
Media Next | 87 |
Media Previous | 88 |
Media Rewind | 89 |
Media Fast-Forward | 90 |
Media Play | 126 |
Media Pause | 127 |
Media Close | 128 |
Media Eject | 129 |
Media Record | 130 |
Button L1 | 102 |
Button R1 | 103 |
Button L2 | 104 |
Button R2 | 105 |
Button A | 96 |
Button B | 97 |
Button C | 98 |
Button X | 99 |
Button Y | 100 |
Button Z | 101 |
Left Thumb Button | 106 |
Right Thumb Button | 107 |
Start Button | 108 |
Select Button | 109 |
Mode Button | 110 |
Gamepad Button 1 | 188 |
Gamepad Button 2 | 189 |
Gamepad Button 3 | 190 |
Gamepad Button 4 | 191 |
Gamepad Button 5 | 192 |
Gamepad Button 6 | 193 |
Gamepad Button 7 | 194 |
Gamepad Button 8 | 195 |
Gamepad Button 9 | 196 |
Gamepad Button 10 | 197 |
Gamepad Button 11 | 198 |
Gamepad Button 12 | 199 |
Gamepad Button 13 | 200 |
Gamepad Button 14 | 201 |
Gamepad Button 15 | 202 |
Gamepad Button 16 | 203 |
Zenkaku/Hankaku | 211 |
Eisu | 212 |
Muhenkan | 213 |
Henkan | 214 |
Katakana/Hiragana | 215 |
Ro | 217 |
Yen | 216 |
Kana | 218 |
Keyboard | 10034 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Alt State
Select whether the Key Code specified via Send Key Code will be sent with the Alt Keyboard State set when it is sent as the Key Behavior.
- If the value Off is selected, then when the Key Code is sent, it will NOT be sent with the Alt Keyboard State set. This will ensure that it will NOT interpreted as a Alt Key.
- If the value On is selected, then when the Key Code is sent, it WILL be sent with the Alt Keyboard State set. This will ensure that it WILL be interpreted as a Alt Key.
- If no value is specified, then when the Key Code is sent, it will be sent without modifying the Alt Keyboard State. This will ensure that it will be interpreted as a Alt or non-Alt Key depending on whatever Keyboard State the Keyboard is currently in..
Detail Information:
Key = keymappingBehaviorTypeSendKeyCodeAltState
Type = string
UI Choice | JSON Value |
---|---|
On | 1 |
Off | 0 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Ctrl State
Select whether the Key Code specified via Send Key Code will be sent with the Control Keyboard State set when it is sent as the Key Behavior.
- If the value Off is selected, then when the Key Code is sent, it will NOT be sent with the Control Keyboard State set. This will ensure that it will NOT interpreted as a Control Key.
- If the value On is selected, then when the Key Code is sent, it WILL be sent with the Control Keyboard State set. This will ensure that it WILL be interpreted as a Control Key.
- If no value is specified, then when the Key Code is sent, it will be sent without modifying the Control Keyboard State. This will ensure that it will be interpreted as a Control or non-Control Key depending on whatever Keyboard State the Keyboard is currently in..
Detail Information:
Key = keymappingBehaviorTypeSendKeyCodeCtrlState
Type = string
UI Choice | JSON Value |
---|---|
On | 1 |
Off | 0 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Fn State
Select whether the Key Code specified via Send Key Code will be sent with the Function Keyboard State set when it is sent as the Key Behavior.
- If the value Off is selected, then when the Key Code is sent, it will NOT be sent with the Function Keyboard State set. This will ensure that it will NOT interpreted as a Function Key.
- If the value On is selected, then when the Key Code is sent, it WILL be sent with the Function Keyboard State set. This will ensure that it WILL be interpreted as a Function Key.
- If no value is specified, then when the Key Code is sent, it will be sent without modifying the Function Keyboard State. This will ensure that it will be interpreted as a Function or non-Function Key depending on whatever Keyboard State the Keyboard is currently in..
Detail Information:
Key = keymappingBehaviorTypeSendKeyCodeFnState
Type = string
UI Choice | JSON Value |
---|---|
On | 1 |
Off | 0 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Shift State
Select whether the Key Code specified via Send Key Code will be sent with the Shift Keyboard State set when it is sent as the Key Behavior.
- If the value Off is selected, then when the Key Code is sent, it will NOT be sent with the Shift Keyboard State set. This will ensure that it will NOT interpreted as a Shifted Key.
- If the value On is selected, then when the Key Code is sent, it WILL be sent with the Shift Keyboard State* set. This will ensure that it WILL be interpreted as a Shifted Key.
- If no value is specified, then when the Key Code is sent, it will be sent without modifying the Shift Keyboard State. This will ensure that it will be interpreted as a Shifted or Unshifted Key depending on whatever Keyboard State the Keyboard is currently in..
Detail Information:
Key = keymappingBehaviorTypeSendKeyCodeShift
Type = string
UI Choice | JSON Value |
---|---|
On | 1 |
Off | 0 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Send Trigger
Select the Trigger Signal that will be sent as the Key Behavior for a specified Key when activated in a specified Keyboard State and when the value Send Trigger is selected for Behavior Type.
Eight possible Trigger Signals are defined, but not all may be supported on all devices. All devices generally support at least one Trigger Signal and generally default to using the first Trigger Signal to activate the Barcode Scanner. Some devices may support additional Trigger Signals and could be configured to use one or more Trigger Signals for some purpose(s) other than Barcode Scanning. Consult the product documentation for a device to determine which Trigger Signals are supported and how they are configured by default to be used.
Detail Information:
Key = keymappingBehaviorTypeSendTrigger
Type = string
UI Choice | JSON Value |
---|---|
Trigger 1 | 10016 |
Trigger 2 | 10017 |
Trigger 3 | 10018 |
Trigger 4 | 10019 |
Trigger 5 | 10020 |
Trigger 6 | 10021 |
Trigger 7 | 10022 |
Trigger 8 | 10023 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Send Intent
Select the circumstances when an Android Intent will be sent as the Key Behavior for a specified Key when activated in a specified Keyboard State and when the value Send Intent is selected for Behavior Type.
- If the value On Key Down is selected, the Android Intent will be sent when the Key is activated (pressed) but will NOT be sent again when the Key is deactivated (released).
- If the value On Key Up is selected, the Android Intent will be NOT be sent when the Key is activated (pressed) but will be sent when the Key is deactivated (released).
- If the value On Both Key Up and Down is selected, the Android Intent will be sent when the Key is activated (pressed) AND will be sent again when the Key is deactivated (released).
Detail Information:
Key = keymappingBehaviorTypeSendIntent
Type = string
UI Choice | JSON Value |
---|---|
On Key Down | 1 |
On Key Up | 2 |
On Both Key Up and Down | 3 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Intent Method
Select the method via which an Android Intent will be sent to invoke an application or service for a specified Key when activated in a specified Keyboard State and when the value Send Intent is selected for Behavior Type.
Depending on the application or service to be invoked, there is likely only one method that can be used to successfully invoke a desired function in that application or service. You will need to consult the documentation or developer of a given application or service to determine the method via which a particular Android Intent must be sent to produce the desired function.
If the value StartActivity is selected, the Android Intent will be sent using the Android startActivity() method. This method is suitable for invoking Android Activities, which are components that perform user interactions. If the function to be invoked involves interacting with the User, this method will most likely be the correct one to use.
If the value Broadcast is selected, the Android Intent will be sent using the Android sendBroadcast() method. This method is suitable for invoking Services, which are components that implement background operations. If the function to be invoked does not involve interacting with the User, this method will most likely be the correct one to use.
Detail Information:
Key = keymappingBehaviorTypeSendIntentMethod
Type = string
UI Choice | JSON Value |
---|---|
StartActivity | StartActivity |
Broadcast | Broadcast |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Intent Action
Enter an Android Intent Action Value for an Intent to be sent to invoke an application or service for a specified Key when activated in a specified Keyboard State and when the value Send Intent is selected for Behavior Type.
An Android Intent Action Value is NOT mandatory to specify when sending every Android Intent. An Android Intent Action Value is a commonly used method to identify the purpose of an Android Intent. This can be especially important when the application or service to be invoked supports multiple functions, in which case the Android Intent Action Value is commonly used to identify which function to perform when invoking that application or service. When sending an Implicit Intent, which does not specify an exact recipient application or service, it is also common to use the Android Intent Action Value to indicate the function to be performed by whatever application or service ultimately receives the intent. You should consult the documentation or developer of a given application or service to determine the intents it supports and whether a function you want to perform requires an Android Intent Action Value to be supplied.
Detail Information:
Key = keymappingBehaviorTypeSendIntentAction
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Intent Category
Enter an Android Intent Category Value for an Android Intent to be sent to invoke an application or service for a specified Key when activated in a specified Keyboard State and when the value Send Intent is selected for Behavior Type.
An Android Intent Category Value is NOT mandatory to specify when sending every Android Intent. An Android Intent Action Value is a commonly used method to help identify the purpose of an Android Intent. You should consult the documentation or developer of a given application or service to determine the intents it supports and whether a function you want to perform requires an Android Intent Category Value to be supplied.
Detail Information:
Key = keymappingBehaviorTypeSendIntentCategory
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Intent Package Name
Enter an Android Package Name Value that will be used to form an Android Component that identifies an application or service to invoke for a specified Key when activated in a specified Keyboard State and when the value Send Intent is selected for Behavior Type and Intent Class is specified.
An Android Package Name Value is NOT mandatory to specify when sending every Android Intent. An Android Package Name Value is a commonly used, together with an Android Class Name Value, to send an Explicit Intent, which uses an Android Component comprised of a Package Name and a Class name to specify the exact recipient application or service to which the intent will be delivered. Intent Class must also be specified to complete the definition of the Android Component.
Using an Explicit Intent can increase security and is often used when the intent being sent requires any sensitive data.. Using an Implicit Intent provides enhanced flexibility since it may be sent to any application or service that has registered its ability to handle that intent and is often used when the intent being sent requires no sensitive data and when it may be desirable to dynamically control which application or service is ultimately invoked to handle the intent.
Detail Information:
Key = keymappingBehaviorTypeSendIntentPackageName
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Intent Class
Enter an Android Class Name Value that will be used to form an Android Component that identifies an application or service to invoke for a specified Key when activated in a specified Keyboard State and when the value Send Intent is selected for Behavior Type and Intent Package Name is specified.
An Android Class Name Value is NOT mandatory to specify when sending every Android Intent. An Android Class Name Value is a commonly used, together with an Android Package Name Value, to send an Explicit Intent, which uses an Android Component comprised of a Package Name and a Class name to specify the exact recipient application or service to which the intent will be delivered. Intent Package Name must also be specified to complete the definition of the Android Component.
Using an Explicit Intent can increase security and is often used when the intent being sent requires any sensitive data.. Using an Implicit Intent provides enhanced flexibility since it may be sent to any application or service that has registered its ability to handle that intent and is often used when the intent being sent requires no sensitive data and when it may be desirable to dynamically control which application or service is ultimately invoked to handle the intent.
Detail Information:
Key = keymappingBehaviorTypeSendIntentClass
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Intent Data URI
Enter a Uniform Resource Identifier (URI) Value that identifies some data to be utilized by the application or service invoked by the intent for a specified Key when activated in a specified Keyboard State and when the value Send Intent is selected for Behavior Type. It is often advisable, and sometimes required, to specify Intent MIME Type to identify the type of data pointed to by the URI.
A URI Value is NOT mandatory to specify when sending every Android Intent. Whether the application or service that will receive the Intent expects a URI to be specified as part of the intent or not is up to that recipient and/or the definition of the intent that recipient is designed to consume. You should consult the documentation or developer of a given application or service to determine the intents it supports and whether a function you want to perform requires a URI, and possibly a MIME Type, to be supplied.
Detail Information:
Key = keymappingBehaviorTypeSendIntentDataUri
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Intent MIME Type
Enter a Multipurpose Internet Mail Extensions (MIME) Type Value to assist the application or service invoked by the intent for a specified Key when activated in a specified Keyboard State and when the value Send Intent is selected for Behavior Type and Intent Data URI is specified.
A MIME Type Value is NOT mandatory to specify when sending every Android Intent. Whether the application or service that will receive the Intent expects a MIME Type to be specified as part of the intent or not is up to that recipient and/or the definition of the intent that recipient is designed to consume. In some cases, the type may be assumed or may be inferred from the data itself. Setting a MIME Type explicitly, if supported by an application or service, could disable automatic type detection and and force handling according to the specified type. You should consult the documentation or developer of a given application or service to determine the intents it supports and whether a function you want to perform requires a MIME Type to be supplied along with a URI.
Detail Information:
Key = keymappingBehaviorTypeSendIntentMimeType
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Intent Extra Name
Enter the Name of a single String Extra to be attached to the Intent that will be utilized by the application or service invoked by the intent for a specified Key when activated in a specified Keyboard State and when the value Send Intent is selected for Behavior Type and when Intent Extra Value is specified.
Android allows a collection of named Extras, of various types, to be attached to any intent.
An Intent sent as a Key Behavior for a specified Key can optionally have a SINGLE Extra attached which, if used, MUST always be of type String.
This limitation of only attaching a SINGLE Extra of type String might prevent certain intents, those which require multiple Extras or Extras of type other than String, from being sent as a Key Behavior for a Key.
If specified, the SINGLE Extra of type String must be provided as a Name/Value pair specified via Intent Extra Name and Intent Extra Value.
You should consult the documentation or developer of a given application or service to determine the intents it supports and whether a function you want to perform requires any Extra(s) to be attached and, if so, of what type(s).
Detail Information:
Key = keymappingBehaviorTypeSendIntentExtraName
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Intent Extra Value
Enter the Value of a single String Extra to be attached to the Intent that will be utilized by the application or service invoked by the intent for a specified Key when activated in a specified Keyboard State and when the value Send Intent is selected for Behavior Type and when Intent Extra Name is specified.
Android allows a collection of named Extras, of various types, to be attached to any intent.
An Intent sent as a Key Behavior for a specified Key can optionally have a SINGLE Extra attached which, if used, MUST always be of type String.
This limitation of only attaching a SINGLE Extra of type String might prevent certain intents, those which require multiple Extras or Extras of type other than String, from being sent as a Key Behavior for a Key.
If specified, the SINGLE Extra of type String must be provided as a Name/Value pair specified via Intent Extra Name and Intent Extra Value.
You should consult the documentation or developer of a given application or service to determine the intents it supports and whether a function you want to perform requires any Extra(s) to be attached and, if so, of what type(s).
Detail Information:
Key = keymappingBehaviorTypeSendIntentExtraValue
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Intent Flags
Enter a value that encodes one or more Android Intent Flags to be set for the Intent to be sent to invoke an application or service for a specified Key when activated in a specified Keyboard State and when the value Send Intent is selected for Behavior Type.
Android Intent Flags control how an Intent is handled by Android and/or by the application or service that receives the Intent. Further:
Some Android Intent Flags are specific to the type of Android Component that will be invoked by the Intent (e.g. activity vs service).
Whether certain Android Intent Flags are needed to invoke a desired function is up to that recipient and/or the definition of the intent that recipient is designed to consume.
Android Intent Flags MUST be specified as a hexadecimal value with the appropriate bits set for any flag or flags desired.
Consult the Android documentation to translate intent flag names, when needed, into their appropriate hexadecimal values.
Detail Information:
Key = keymappingBehaviorTypeSendIntentFlags
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Send Intent - Intent Add Key Event
Select whether the information about the Key Event should be attached to Intent to be sent to invoke an application or service for a specified Key when activated in a specified Keyboard State and when the value Send Intent is selected for Behavior Type.
Mapping is performed by responding to Key Events that indicate when a Key is being activated (pressed) or deactivated (released). When sending an Intent as the Key Behavior for a Key, the Intent can be sent when the Key is activated (pressed), deactivated (released), or both. When the same Intent is sent for both activation and deactivation, it may be important to the Android Component that is receiving and consuming the Intent to differentiate the two cases.
If the value Attach is selected, the Android Intent sent will have the Key Event attached, allowing the consumer of the Intent to determine whether the Intent was sent as a result of the Key being activated (pressed) or deactivated (released).
If the value Don't Attach is selected, the Android Intent sent will NOT have the Key Event attached, preventing the consumer of the Intent from determining whether the Intent was sent as a result of the Key being activated (pressed) or deactivated (released).
Detail Information:
Key = keymappingBehaviorTypeSendIntentAddKeyEvent
Type = string
UI Choice | JSON Value |
---|---|
Attach | 1 |
Don't Attach | 0 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Launch Application Name
Enter the Application Friendly Name that identifies an application to be launched when the value Launch Application is selected for Behavior Type.
Note that the Application Friendly Name is NOT the same as the Android Package Name. The Application Friendly Name is generally the name by which the application is identified in in-device UI. Launching an application by its Application Friendly Name is generally simpler and hence may be more convenient for an administrator than launching that application by its Android Package Name.
To launch an application by its Application Friendly Name, all the administrator needs to supply is that name. the Application Friendly Name is easily discoverable in-device in a variety of ways, including:
The Application Friendly Name may be displayed in the Title Bar of the application's UI.
The Application Friendly Names of recently launched applications are typically displayed in the Recent Applications panel.
The Application Friendly Name is displayed in the AppInfo section of the Settings UI for an application.
To launch an application based on its Android Package Name, the value Send Intent should be selected for Behavior Type and much more information, including Android Package Name, which may be harder to discover, will need to be provided to send the right Intent to launch the application.
Detail Information:
Key = keymappingBehaviorTypeLaunchApplicationName
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
License Configuration
Use this Group to configure Licenses, Custom Servers, and Features.
Detail Information:
Key = licenseConfig
Type = bundle
Licenses
Use this Sub-array to configure one or more License(s) to Activate from Server(s) using AID(s) and/or to Activate from Local File(s).
Detail Information:
Key = licenses
Type = bundle_array
License
Use this Sub-group to configure Enterprise Reset Persistence, Local Server Partition Name, Source, Standard Server AID Value, Standard Server Standard Class, Custom Server Class, Custom Server URL, Standard Server Refresh Interval, Custom Server Friendly Name, Local File Path and Name, and Local File Source Server Class.
Detail Information:
Key = license
Type = bundle
Enterprise Reset Persistence
Enter the name of the partition on the local server from which to pull a license. Leave blank to pull from a non-partitioned license pool
Detail Information:
Key = licensePersistence
Type = string
UI Choice | JSON Value |
---|---|
Turn On | 1 |
Turn Off | 2 |
Support Information:
- Supported from: MX 11.2.
Local Server Partition Name
Enter the name of the partition on the local server from which to pull a license. Leave blank to pull from a non-partitioned license pool
Detail Information:
Key = licenseLocalServerPartitionName
Type = string
Support Information:
- Supported from: MX 11.2.
Source
Select the Source from which a License for a Zebra capability will be acquired.
If the value Standard Server is selected, a License for a Zebra capability will be acquired from a Standard Server (e.g. over the Internet).
If the value Custom Server is selected, a License for a Zebra capability will be acquired from a Custom Server (e.g. on a Local Network), which must be defined separately via Custom Servers and then referenced by name by specifying Server Friendly Name.
If the value Local File is selected, a License for a Zebra capability will be acquired from a a File, which must be separately acquired and sent to the device, then referenced by its Path and File Name in the Device File System by specifying Local File Path and Name.
Detail Information:
Key = licenseSource
Type = string
UI Choice | JSON Value |
---|---|
Standard Server | 1 |
Custom Server | 2 |
Local File | 3 |
Standard Server AID Value
Enter the Activation ID (AID) to be used when acquiring a License for a Zebra capability from a Server.
Detail Information:
Key = licenseStandardServerAidValue
Type = string
Standard Server Standard Class
Select the Class of Standard Server from which a License for a Zebra component will be acquired.
Detail Information:
Key = licenseStandardServerStandardClass
Type = string
UI Choice | JSON Value |
---|---|
Production Cloud Direct | 1 |
Test Cloud Direct | 2 |
Custom Server Class
Select the Class of Custom Server from a License for a Zebra capability will be acquired.
Detail Information:
Key = licenseCustomServerClass
Type = string
UI Choice | JSON Value |
---|---|
Production Cloud Proxy | 1 |
Test Cloud Proxy | 2 |
Local Direct | 3 |
Other | 4 |
Custom Server URL
Enter the URL of the specific Custom Server from which a License for a Zebra capability will be acquired.
Detail Information:
Key = licenseCustomServerUrl
Type = string
Standard Server Refresh Interval
Select the Interval after which a License acquired for a Zebra capability will be refreshed.
Detail Information:
Key = licenseStandardServerRefreshInterval
Type = string
UI Choice | JSON Value |
---|---|
Never | 0 |
Every Day | 1 |
Every Week | 7 |
Every Month | 28 |
Every Year | 365 |
Custom Server Friendly Name
Enter the Friendly Name to be associated with the Custom Server from which a License for a Zebra capability will be acquired.
Detail Information:
Key = licenseCustomServerFriendlyName
Type = string
Local File Path and Name
Enter the Path and Name of a local File in the Device File System from which a License for a Zebra capability will be acquired.
Detail Information:
Key = licenseLocalFilePathAndName
Type = string
Local File Source Server Class
Select the Class of Server from which a License for a Zebra capability that was applied from a local File was acquired.
Detail Information:
Key = licenseLocalFileSourceServerClass
Type = string
UI Choice | JSON Value |
---|---|
Production Cloud | 1 |
Test Cloud | 2 |
Custom Servers
Use this Sub-array to configure one or more Custom Server(s) from which License(s) can be Activated.
Detail Information:
Key = customServers
Type = bundle_array
Custom Server
Use this Sub-group to configure Server Friendly Name, Server URL, and Server Class.
Detail Information:
Key = customServer
Type = bundle
Server Friendly Name
Enter the Friendly Name of a Custom Server from which Licensing will be acquired.
Detail Information:
Key = licenseCustomFriendlyName
Type = string
Server URL
Enter the URL of a Custom Server from which Licensing will be acquired.
Detail Information:
Key = licenseCustomUrl
Type = string
Server Class
Select the Class of Custom Server from which Licensing will be acquired.
Detail Information:
Key = licenseCustomClass
Type = string
UI Choice | JSON Value |
---|---|
Production Cloud Proxy | 1 |
Test Cloud Proxy | 2 |
Local Direct | 3 |
Other | 4 |
Features
Use this Sub-array to configure one or more Feature(s) to be Acquired directly from Customer License Server Instance(s).
Detail Information:
Key = features
Type = bundle_array
Feature
Use this Sub-group to configure Name, Server URL, and Server Friendly Name.
Detail Information:
Key = feature
Type = bundle
Name
Enter the Name of the Zebra Feature for which licensing will be acquired.
Detail Information:
Key = licenseFeatureName
Type = string
Server URL
Enter the server URL from which licensing for a Zebra Feature will be acquired.
Detail Information:
Key = licenseFeatureServerUrl
Type = string
Server Friendly Name
Enter the Friendly Name to be assigned to the Server from which licensing for a Zebra Feature will be acquired.
Detail Information:
Key = licenseFeatureServerFriendlyName
Type = string
Package Configuration
Use this Array to configure one or more Package(s)
Each Android Package of the given type will generally exhibit the same standard behaviors unless explicitly overridden by an Administrator. Android Packages of different types may exhibit different standard behaviors unless explicitly overridden by an Administrator.
This Sub-array allows an Administrator to identify Android Packages, by their Android Package Names, whose exhibited behavior should deviate from the standard behaviors that would otherwise apply based on their types. Any Android Packages whose Android Package Names are not specified in this Sub-array will exhibit the standard behaviors appropriate to their type.
The following high-level behaviors could be altered using this Sub-array.:
- Allowed Services
Zebra Android devices implement a variety of System Services that are generally available for use only by Trusted Applications. In some cases, there may be a need to grant such access to otherwise Untrusted Applications. In such cases, the Administrator can use Allowed Services to grant an application that he trusts, access to use one or more selected System Services.
- Permissions
Zebra Android devices have a variety of System Permissions that control access to System APIs that are generally available for use only by Trusted Applications. In some cases, there may be a need to grant such permissions to otherwise Untrusted Applications. In such cases, the Administrator can use Permissions to grant an application that he trusts, permission to use one or more System APIs.
- Feature Variances
Zebra Android devices have a variety of standard application behaviors that an Administrator might want to adjust. In such cases, the Administrator can use one or more of the following Feature Variances to specify which of the available deviations from behaviors to use for an application. $$pkgConfig.packageFeatureVariances.packageFeatureVariance.packageVarianceType$$
This Sub-array is used to provide a list of Android Packages for which deviations from standard behaviors will be configured.
If this Sub-array has never been specified (never included in the MCs sent), then no configuration of deviation from standard behaviors will be made and hence all Android Packages will have standard behaviors.
If this Sub-array is not specified (not included in the MCs sent), then no changes will be made to the configuration defined by any previously specified Sub-array.
If this Sub-array is specified (included in the MCs sent), then the specified Sub-array will entirely replace the configuration defined by any previously specified Sub-array.
Note that it is NOT possible to specify an "empty" Sub-array (with zero elements). Every Sub-array must contain at least one element. Any element(s) in this Sub-array where a blank (empty string) value is entered for Package Name will be ignored. It is therefore possible to specify a "virtually empty" Sub-array by entering a a blank (empty string) value for Package Name in every element of the Sub-array.
- If this Sub-array is specified (included in the MCs sent), but that Sub-array is "virtually empty", as described above, then all deviation from standard behaviors previously configured by any previously specified Sub-array will be removed, thus returning all Android Packages to standard behaviors, returning to a state equivalent to when no Sub-array had ever been specified.
Detail Information:
Key = pkgConfig
Type = bundle_array
Package
Use this Sub-group to configure Package Name, Package Signing Certificate, Feature Variances, Permissions, and Allowed Services for a single Android Package.
Detail Information:
Key = package
Type = bundle
Package Name
Enter the Package Name of an Android Package for which one or more deviations from standard behaviors should be configured. z
If the Package Name is left blank (empty string), then the element of the Package Configuration Sub-array in which it appears will be ignored.
If the Package Name is non-blank (non-empty string), then the element of the Package Configuration Sub-array in which it appears will be processed and the entered Package Name will identify the Android Package for which this element of the Package Configuration Sub-array will define one or more deviations from standard behaviors should be configured.
Detail Information:
Key = packagePackageNameName
Type = string
Package Signing Certificate
Enter the Package Signing Certificate that will be used to verify that the Android Package identified by the Package Name entered for Package Name is a genuine instance of that Android Package for which one or more deviations from standard behaviors should be configured.
The value specified must be the Base 64 encoded string representing the exact binary contents of the DER-format (e.g, a .CRT file) public certificate file used to sign the Android Package. This value can be obtained in the proper format from an .APK file for an Android Package by using the Zebra App Signature Tool.
Note that not all deviations from standard behaviors require verification that the Android Package is genuine and hence the Package Signing Certificate can be left blank (empty string) when it is not required. The deviations from standard behaviors that require verification are the following that grant special privileges to the Android Package:
Allowed Services
Permissions
Detail Information:
Key = packagePackageSigningCertifcate
Type = string
Feature Variances
Use this Sub-array to configure one or more Feature Variance(s) (deviations from the standard behaviors of Android Packages) that should apply to Android Packages.
Detail Information:
Key = packageFeatureVariances
Type = bundle_array
Feature Variance
Use this Sub-group to configure Variance Type.
Detail Information:
Key = packageFeatureVariance
Type = bundle
Variance Type
Select a Type of Feature Variance that should be applied to an Android Package. The following Feature Variances are supported: $$appConfig.packages.package.packageFeatureVariances.packageFeatureVariance.packageVarianceType$$
Detail Information:
Key = packageVarianceType
Type = string
UI Choice | JSON Value |
---|---|
Disallow Background Data | 1 |
Exempt from Battery Optimization | 2 |
Disallow Launch | 3 |
Disallow Install and Launch | 4 |
Disallow User Access to App Info | 5 |
Use a Reserved UID | 6 |
Disallow App From Upgrade | 7 |
Hide Notifications | 8 |
Set as default browser | 9 |
Set as default dialer | 10 |
Support Information:
- Supported from: MX 9.3.
Permissions
Use this Sub-array to configure one or more Sensitive Android Permissions.
Detail Information:
Key = packagePermissions
Type = bundle_array
Permission
Use this Sub-group to configure Name and State for a single Sensitive Android Permission.
Detail Information:
Key = packagePermission
Type = bundle
Name
Select the name of a Sensitive Android Permission to be Granted to an Android Package. Select the name of a Sensitive Android Permission for which deviation from the standard behavior will be configured for an Android Package.
Detail Information:
Key = permissionName
Type = string
UI Choice | JSON Value |
---|---|
Access Notifications | android.permission.ACCESS_NOTIFICATIONS |
Package Usage Stats | android.permission.PACKAGE_USAGE_STATS |
System Alert Window | android.permission.SYSTEM_ALERT_WINDOW |
Get AppOps Stats | android.permission.GET_APP_OPS_STATS |
Battery Stats | android.permission.BATTERY_STATS |
Manage External Storage | android.permission.MANAGE_EXTERNAL_STORAGE |
State
Select the State to to configure deviation from the standard behavior for Sensitive Android Permission for an Android Package.
If the value Grant is selected, then a Sensitive Android Permission will be Granted to the Android Package.
If the value Deny is selected, then a Sensitive Android Permission will be Denied from the Android Package.
If the value Prompt User is selected, then the User will be presented with dialog asking for permission to the Sensitive Android Permission for the Android Package.
Note that since Prompt User is the standard behavior for all Sensitive Android Permissions, this value is not really required, since the same effect can be obtained by removing the Sensitive Android Permission from the Permissions Sub-array. This is because not explicitly specifying a deviation from the standard behavior for a Sensitive Android Permission will result in the standard behavior. Similarly, if the Package Name is removed from the Package Configuration Sub-array then all Sensitive Android Permissions will return to standard behavior for that Android Package. It is not necessary to explicitly assign the standard behavior.
Detail Information:
Key = permissionState
Type = string
UI Choice | JSON Value |
---|---|
Grant | 1 |
Deny | 2 |
Prompt User | 3 |
Allowed Services
Use this Sub-array to configure one or more System Service(s) that an application will is Allowed to use.
Detail Information:
Key = packageAllowedServices
Type = bundle_array
Allowed Service
Use this Sub-group to configure Service Identifier.
Detail Information:
Key = packageAllowedService
Type = bundle
Service Identifier
Enter the Service Identifier that identifies functionality of a System Service that an Android Package will be allowed to use.
A Service Identifier is a string value defined by the implementer of a System Service that identifies specific functionality within that System Service to which access will be controlled. A given System Service can choose to implement functionality that is NOT controlled by a Service Identifier and/or can defined multiple Service Identifiers to apply varying controls on different types of functionality. Consult the documentation for a given System Service to determine which, if any, Service Identifier(s) might be required to utilize the desired functionality of that System Service. Each Service Identifier that identifies functionality in a System Service to which usage will be allowed for a given Android Package must be configured through an element of the Permissions Sub-array for that Android Package.
Detail Information:
Key = packageAllowedServiceIdentifier
Type = string
Security and Privacy Configuration
Use this Group to configure Encryption and Screen Lock.
Detail Information:
Key = securityAndPrivacyConfig
Type = bundle
Encryption Configuration
Use this Sub-group to configure Encryption Keys and SD Card Encrypt Key Name.
Detail Information:
Key = encryptConfig
Type = bundle
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Encryption Keys
Use this Sub-array to configure one or more Encryption Key(s).
Detail Information:
Key = securityEncryptionKeys
Type = bundle_array
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Encryption Key
Use this Sub-group to configure Key Name and Key Value.
Detail Information:
Key = securityEncryptionKey
Type = bundle
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Key Name
Enter the Key Name of a Named Encryption Key.
You must also specify Key Value to provide the Key Value to be added for the specified Named Encryption Key.
Detail Information:
Key = securityKeyName
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Key Value
Enter the Key Value of a Named Encryption Key.
A Key Value must be a string value containing exactly 64 hexadecimal characters ("0-9" and/or "A-F" characters) that encode a 256 bit binary value for an AES encryption key.
The Key Value can be generated in any manner desired as long as it is a 256 bit binary value and is represented as 64 hexadecimal characters, although in most cases, best practice would be to randomly generate Key Values to maximize their effectiveness in protecting data.
Detail Information:
Key = securityKeyValue
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
SD Card Encrypt Key Name
Enter the Key Name of a Named Encryption Key to be used to encrypt the removable SD Card.
Detail Information:
Key = securitySDCardEncryptKeyName
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Screen Lock Configuration
Use this Sub-group to configure Instant Screen Lock on Power Key, Lock Screen Wallpaper, Custom Lock Screen Wallpaper, Screen Lock Type, Notifications on Lock Screen, Screen Lock Timeout, and User Selection of Secure Start-up.
Detail Information:
Key = screenLockConfig
Type = bundle
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Instant Screen Lock on Power Key
Select whether the device will Instantly Lock when the Power Key is used to turn the Display Off.
If the value Off is selected, the device will NOT Instantly Lock when the Power Key is used to turn the Display Off. This will produce behavior comparable to when the device times out and Automatically turns the Display Off.
If the Display remains off for longer than Duration set via Screen Lock Timeout, then the device will become Locked, requiring it to be Unlocked in the manner specified via Screen Lock Type.
If the Display remains off for less than Duration set via Screen Lock Timeout, then the device will NOT become Locked.
If the value On is selected, the device WILL Instantly Lock when the Power Key is used to turn the Display Off, requiring it to be Unlocked in the manner specified via Screen Lock Type.
Detail Information:
Key = securitySLPowerKeyInstantLock
Type = string
UI Choice | JSON Value |
---|---|
Off | Off |
On | On |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Lock Screen Wallpaper
Select the wallpaper to use on the lock screen of the device.
- If the value Restore to default is selected, the default lock screen wallpaper will be used.
- If the value Custom is selected, the custom wallpaper specified in %?securityAndPrivacyConfig.screenLockConfig.securitySLCustomLockWallpaper% will be used on the lock screen.
Detail Information:
Key = securitySLLockScreenWallpaper
Type = string
UI Choice | JSON Value |
---|---|
Restore to default | 1 |
Custom | 2 |
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 10.5.
Custom Lock Screen Wallpaper
Enter the path and file name of an image file on the device (.jpg or .png)
Detail Information:
Key = securitySLCustomLockWallpaper
Type = string
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 10.5.
Screen Lock Type
Select the type of lock that is used to protect the device from use by unauthorized persons.
- If the value None is selected, no lock will be applied and the device can be used by anyone.
- If the value Swipe is selected, unlocking will require only a simple swipe and the device can be used by anyone.
- If the value PIN is selected, unlocking will require entry of a PIN (personal identification number) and the device can only be unlocked by someone knowing the correct PIN value.
- If the value Password is selected, unlocking will require entry of a password and the device can only be unlocked by someone knowing the correct password value.
- If the value Pattern is selected, unlocking will require drawing a pattern on the screen using the touch panel and the device can only be unlocked by someone knowing the correct pattern.
Detail Information:
Key = securitySLScreenLockType
Type = string
UI Choice | JSON Value |
---|---|
None | 5 |
Swipe | 1 |
PIN | 3 |
Password | 4 |
Pattern | 2 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Notifications on Lock Screen
Select the types of notifications to show on the lock screen
- If the value Show all content is selected, all notifications will be shown.
- If the value Show only non-sensitive content is selected, only non-sensitive content will be shown.
- If the value Hide notifications is selected, all notifications will be hidden.
Detail Information:
Key = securitySLNotificationsOnLockScreen
Type = string
UI Choice | JSON Value |
---|---|
Show all content | 1 |
Show only non-sensitive content | 2 |
Hide notifications | 3 |
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 10.5.
Screen Lock Timeout
Select what happens when a device turns off as a result of a timeout.
- If the device stays off for at least the time specified, the device will be locked and an unlock will be required when the device is turned back on, if any lock was configured using Screen Lock Type.
- If the device stays off for less than the time specified, the device will NOT be locked and hence no unlock will be required when the device is turned back on, even if a lock was configured using Screen Lock Type.
Detail Information:
Key = securitySLScreenLockTimeout
Type = string
UI Choice | JSON Value |
---|---|
Immediately after Display Timeout | 1 |
5 seconds after Display Timeout | 5 |
15 seconds after Display Timeout | 15 |
30 seconds after Display Timeout | 30 |
1 minute after Display Timeout | 60 |
2 minutes after Display Timeout | 120 |
5 minutes after Display Timeout | 300 |
10 minutes after Display Timeout | 600 |
30 minutes after Display Timeout | 1800 |
User Selection of Secure Start-up
Select whether the User will be Allowed to Select (Turn On) Secure Start-up when changing pin/password/pattern.
Detail Information:
Key = securitySLSecureStartupDialog
Type = string
UI Choice | JSON Value |
---|---|
Enable the YES button | 1 |
Disable the YES button | 2 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
System Configuration
Use this Group to configure Analytics, Clock, Data Wipe, GMS, Lifeguard, Power, Remote Scanner Configurations, Wake-Up, Pass-Through Command, and Logs.
Detail Information:
Key = systemConfig
Type = bundle
Analytics Configuration
Use this Sub-group to configure Analytics State and User Control of Analytics State.
Detail Information:
Key = analyticsConfig
Type = bundle
Analytics State
Select whether the Analytics Client will collect machine data from the device and send it to Zebra.
The Analytics Client is turned on (enabled) by default on all devices:
- If the value Off is selected, the Analytics Client will NOT collect machine data from the device nor will it send such data to Zebra.
- If the value On is selected, the Analytics Client WILL collect machine data from the device and send such data to Zebra when connectivity is available.
On some devices, the ability to turn off (disable) the Analytics Client may not be supported.
Detail Information:
Key = sysAnalyticsState
Type = string
UI Choice | JSON Value |
---|---|
Off | 2 |
On | 1 |
User Control of Analytics State
Select whether the User will be Allowed to control whether the Analytics Client will collect machine data from the device and send it to Zebra.
The Analytics Client is turned on (enabled) by default on all devices:
- If the value Disallow is selected, the User will NOT be Allowed to control whether the Analytics Client will collect machine data from the device and send it to Zebra
- If the value Allow is selected, the User WILL be Allowed to control whether the Analytics Client will collect machine data from the device and send it to Zebra
Detail Information:
Key = sysAnalyticsUserControlState
Type = string
UI Choice | JSON Value |
---|---|
Disallow | 2 |
Allow | 1 |
Clock Configuration
Use this Sub-group to configure Time Format.
Detail Information:
Key = clockConfig
Type = bundle
Time Format
Select the Format in which Time will be displayed.
If the value 12 is selected, Time will be displayed in 12 hour (AM/PM) Format.
If the value 24 is selected, Time will be displayed in 24 hour (military) Format.
Detail Information:
Key = sysClockTimeFormat
Type = string
UI Choice | JSON Value |
---|---|
12 | 2 |
24 | 1 |
Data Wipe Configuration
Use this Sub-group to configure Data Wipe Options and Bypass SUW on Enterprise Reset
Sometimes it may become necessary or desirable to Wipe some or all device data. To understand when and why it might be appropriate to Wipe device data, it is important to understand the different types of device data that could exist, and which could be Wiped.
- Primary Storage
Primary Storage is flash memory that is allocated to hold data, organized as files, that is produced and stored while the device is running. Every Zebra Android device has some form of Primary Storage. although the size and utilization of it may vary from device to device. This is where standard Android folders, such as /sdcard and /data are located. Primary Storage is the "workhorse" storage of the device and is frequently read, written, and updated during normal device operation. All data stored in Primary Storage is encrypted by the system using device unique keys.
- Persistent Storage
Persistent Storage is flash memory that is allocated to hold data, which may or may not be organized as files, that needs to be more Persistent than Primary Storage. Every Zebra Android device has some form of Persistent Storage. although the size and methods required to access it may vary from device to device. This is where the Zebra-proprietary folder /enterprise, on devices that have it, is located. Persistent Storage is commonly used to store applications, configuration, and data that collectively define a "known good state" to which a device can be returned by Wiping Primary Storage but preserving Persistent Storage. Data stored in Persistent Storage is not necessarily encrypted by the system.
- Factory Reset Protection
Factory Reset Protection is flash memory that is allocated to hold data that is used to prevent devices from being stolen and reused. When a device that is protected by defining a Google Account is Wiped in an Untrusted manner, such as by using Zebra Recovery Mode, the device will be blocked from completing Setup until the Password associated with that Google Account can be successfully entered and verified. This prevents reuse of a device until the User can demonstrate that the device is in the possession of its actual owner. This data is stored encrypted and can only be erased by performing a Trusted Data Wipe.
- Portable Storage
Portable Storage is flash memory on a Removable Micro SD Card that is used to hold data, organized as files, that is physically removable from the device itself. Not every Zebra Android device supports Portable Storage, and among devices that do, the size(s) of cards supported may vary. Portable Storage may be used to import data into a device, export data from a device, share data amongst devices, etc. Over time, the types of data that can usefully be stored and accessed on Portable Storage has become more and more limited, and likely will be even more restricted in the future. Data stored in Portable Storage can optionally be encrypted. Any one Removable Micro SD Card can only be used for Portable Storage or Adopted Storage at any given time and switching between the two requires Wiping of all data from the card.
- Adopted Storage
Adopted Storage is flash memory on a Removable Micro SD Card that is used to extend Primary Storage. Even through the card is physically removable from the device, once adopted, it should not be removed since it can negatively impact the continuing operation of the device. Unlike Portable Storage, Adopted Storage CANNOT be used to import data into a device, export data from a device, share data amongst devices, etc. All data stored in Adopted Storage is encrypted in the same manner as the Primary Storage it extends. Wiping Primary Storage does NOT directly Wipe Adopted Storage but does render the data on the card unusable.
The following types of Data Wipe are supported:
- Enterprise Reset
Enterprise Reset causes Primary Storage to be Wiped, all data in Adopted Storage to be invalidated, and all data in Persistent Storage and Portable Storage to be preserved. When performing an Enterprise Reset, a flag is kept in Persistent Storage to indicate that it has been done. This flag is used to prevent repetition of Enterprise Reset from being performed if another request to Wipe Primary Storage is sent again after the Enterprise Reset. If another Enterprise Reset is later desired, the request to Wipe Persistent Storage must be removed, by removing the Primary Storage option. This will cause the flag to be removed and allow a subsequent Enterprise Reset to be performed once the Primary Storage is specified again. Enterprise Reset is typically used to return a device a previously stored "known good" state, based on applications, configurations, and data that were previously stored Persistently, and hence should be performed relatively infrequently.
- Factory Reset
Factory Reset is identical to Enterprise Reset with the exception that all data in Persistent Storage is also Wiped. Because Persistent Storage is also Wiped, the approach described above for storing a flag in Persistent Storage cannot be used to prevent repetition of Factory Reset from being performed if another request to Wipe Primary Storage is sent again after the Factory Reset. Factory Reset is typically used to forcibly terminate management of a device, either to enable repurposing of the device, to prepare for the device for servicing, etc. and hence should be performed very infrequently. When enrolling a device for management at a later time, following an earlier request to perform a Factory Reset, care should be taken to avoid resending the same options, since nothing will prevent Factory Reset from being performed again, if requested.
- Trusted Reset
An Enterprise Reset or a Factory Reset can be Trusted or Untrusted. A Trusted reset Wipes Factory Reset Protection and an Untrusted reset does not. Whether a reset is Trusted or Untrusted depends on how the reset is being initiated. If a reset is being initiated by a User that is Trusted or Untrusted, then the resulting reset will follow suit. If a reset is being performed using one or more Data Wipe Options, then a Trusted reset will be performed if option value Factory Reset Protection is specified, otherwise an Untrusted reset will be performed. In other words if you specify that Factory Reset Protection is to be Wiped, then the reset will be made Trusted so the correct result will occur.
Notes:
The data to be Wiped is requested by specifying one or more Data Wipe Option Types within Data Wipe Option Type Sub-groups as elements of this Sub-array.
Each Data Wipe Option Type specifies a specific storage area to be Wiped and the type of Wipe operation(s) to be performed is chosen to ensure that all requested data will be Wiped.
In some cases, it may not be possible to Wipe one storage area without also Wiping another storage area.
If the combination of storage areas requested to be Wiped cannot be performed without Wiping additional storage areas that are NOT requested, then NOTHING will be Wiped, since no data will be Wiped unless specifically requested. For example, if ONLY Factory Reset Protection is specified, the nothing will be Wiped since it is not possible to Wipe Factory Reset Protection without ALSO Wiping Primary Storage.
Detail Information:
Key = dataWipeConfig
Type = bundle
Data Wipe Options
Use this Sub-array to configure one or more Data Wipe Option(s) .
Detail Information:
Key = dataWipeDataWipeOptions
Type = bundle_array
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Data Wipe Option
Use this Sub-group to configure Data Wipe Option Type.
Detail Information:
Key = dataWipeDataWipeOption
Type = bundle
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Data Wipe Option Type
Select the Type for a single Data Wipe Option to request that a specified device storage area be Wiped.
If the value Primary Storage is selected, then Primary Storage will be Wiped, also invalidating Adopted Storage if it is being used. This value will result in either an Enterprise Reset or a Factory Reset being performed, depending on what other Data Wipe Option Type(s) are also specified in Data Wipe Options.
If the value Persistent Storage is selected, then Persistent Storage will be Wiped, but only if this value is specified in addition to value Primary Storage. Primary Storage must also be specified since it is only possible to Wipe Persistent Storage when also Wiping Primary Storage, by doing a Factory Reset, and all storage areas to be Wiped must be explicitly specified.
If the value Factory Reset Protection is selected, then Factory Reset Protection will be Wiped, but only if this value is specified in addition to value Primary Storage. Primary Storage must also be specified since it is only possible to Wipe Factory Reset Protection when also Wiping Primary Storage, by doing an Enterprise Reset or a Factory Reset, and only storage areas that are specifically specified will be Wiped. This value can optionally be used together with values Persistent Storage and/or Portable Storage.
If the value Portable Storage is selected, then Portable Storage will be Wiped, but only if this value is specified in addition to value Primary Storage. Primary Storage must also be specified since it is not possible to Wipe Portable Storage without also Wiping Primary Storage, by doing an Enterprise Reset or a Factory Reset, and only storage areas that are specifically specified will be Wiped. This value can optionally be used together with values Persistent Storage and/or Factory Reset Protection.
Detail Information:
Key = dataWipeDataWipeOptionType
Type = string
UI Choice | JSON Value |
---|---|
Primary Storage | 1 |
Persistent Storage | 2 |
Factory Reset Protection | 3 |
Portable Storage | 4 |
Bypass SUW on Enterprise Reset
Select whether the Google Setup Wizard (SUW) should be bypassed when an Enterprise Reset is performed as a Data Wipe when Primary Storage is included as a Data Wipe Option Type in a Data Wipe Option in Data Wipe Options.
If the value Yes is selected, then the Google Setup Wizard (SUW) will be bypassed each time an Enterprise Reset is performed as a Data Wipe.
If the value No is selected, then the Google Setup Wizard (SUW) will NOT be bypassed each time an Enterprise Reset is performed as a Data Wipe.
Detail Information:
Key = dataWipeBypassSUWonEnterpriseReset
Type = string
UI Choice | JSON Value |
---|---|
Yes | 1 |
No | 2 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
GMS Configuration
Use this Sub-group to configure GMS Feature Set and GMS Profile.
Detail Information:
Key = gmsConfig
Type = bundle
Support Information:
- NOT supported on Device(s): TC20 and TC25.
GMS Feature Set
Select the amount of functionality of Google Mobile Services (GMS) to enable.
If the value All - Full Set of GMS Features is selected, the the entire set of Google Mobile Services (GMS), will be enabled for use. Note that if Google Mobile Services are allowed to be used, may collect and send data to Google.
If the value Restricted - Fixed Minimal Set of GMS Features is selected, a limited (fixed) subset of Google Mobile Services (GMS), will be enabled for use. The subset will automatically be chosen to ensure that basic device functionality is not impaired, that all enabled Google Mobile Services operate usefully, and that no enabled Google Mobile Services send any data to Google.
If the value Profiled - Selected Subset of GMS Features is selected, a selected subset of Google Mobile Services (GMS) features will be enabled for use.
Detail Information:
Key = sysGmsFeatureSet
Type = string
UI Choice | JSON Value |
---|---|
All - Full Set of GMS Features | 1 |
Restricted - Fixed Minimal Set of GMS Features | 2 |
Profiled - Selected Subset of GMS Features | 3 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
GMS Profile
Select the Google Mobile Services (GMS) profile to enable.
If the value Chrome Browser is selected, Chrome Browser will be enabled for use.
If the value Google Maps is selected, Google Maps will be enabled for use.
If the value Firebase Cloud Messaging is selected, Firebase Cloud Messaging will be enabled for use.
If the value Combination of Chrome and Maps and FCM is selected, Combination of Chrome, Maps and FCM will be enabled for use.
Detail Information:
Key = sysGmsProfile
Type = string
UI Choice | JSON Value |
---|---|
Chrome Browser | 1 |
Google Maps | 2 |
Firebase Cloud Messaging | 3 |
Combination of Chrome and Maps and FCM | 4 |
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 8.3.
Lifeguard Configuration
Use this Sub-group to configure Update Mode, UI Control, Update Over Cellular, OTA Options, File-Based Update Source, File-Based Update Options, Auto Reboot, File-Based Update Local Path And Name, and Streaming
The following defined terms are important to understand:
- Zebra LifeGuard
Zebra LifeGuard is Zebra's branded offering for providing timely updates of Operating System (OS) software images to Zebra Android devices and is comprised of various components that can be used individually or in combination:
- OS Update
OS Update is the process or act of patching or replacing the Operating System (OS) software image of a Zebra Android device. Such an update could load a newer version of Android, new features, bug fixes, security patches, etc.
- OS Version
OS Version is a string, also sometimes referred to as a Build ID, that uniquely identifies a particular Operating System (OS) software image for a Zebra Android device. A successful OS Update will ALWAYS result in a change of the OS Version reported by the device.
- Zebra LifeGuard OTA Server
Zebra LifeGuard OTA Server is an Internet-hosted server that enables remote initiation of OS Updates on Internet-connected Zebra Android devices when using the Fully Automatic or EMM Controlled modes.
- Zebra LifeGuard OTA Service
Zebra LifeGuard OTA Service is a software component that is built-into Zebra Android devices and communicates with the Zebra LifeGuard OTA Server to allow it to remotely initiate OS Updates on the device. Use of this service requires the service to be enabled and requires device network connectivity over which the Zebra LifeGuard OTA Server on the Internet can be reached.
- Zebra LifeGuard Update Files
Zebra LifeGuard Update Files are ZIP-format files released by Zebra to the Zebra LifeGuard OTA Server, from where they can used to perform Fully Automatic or EMM Controlled OS Updates, and to the Internet, from where they can be downloaded and sent to a device and thereby used to perform File-Based Updates. Every Zebra LifeGuard Update File has a specific associated OS Version that will be reported by a device once that Zebra LifeGuard Update File has been successfully used to perform an OS Update of that device.
- Local Update Files
Local Update Files are Zebra LifeGuard Update Files that are downloaded in advance, using any available means, stored in the Device File System and then used to initiate File-Based Updates. Using Zebra Local Update Files can increase the reliability of OS Updates as well as allowing deferred initiation at a time when network connectivity may be unavailable, at the expense of occupying, at least temporarily, a potentially significant amount of Device File System space.
- Streamed Update Files
Streamed Update Files are Zebra LifeGuard Update Files that are downloaded on demand when File-Based Updates are initiated and never need to be stored in the Device File System. Using Streamed Update Files avoids the need to have sufficient Device File System space to hold potentially large files to initiate OS Updates, but increases the risk that network connectivity loss during the OS Update could cause the OS Update to fail. The use of Streamed Update Files is only allowed for Zebra LifeGuard Update Files that support A/B Mode due to the risks associated with failures due to network connectivity loss.
- A/B Mode
A/B Mode is a mode wherein an OS Update can be performed by installing the new OS into the B partition while the device is running in the A partition. This allows the OS Update to be performed safely while the device is in use because the current OS being run from the A partition is not affected. When the OS Update is completed successfully, a device reboot is required to activate the new OS in the B partition. If the new OS is successfully activated, then the partitions are swapped so the next OS Update in A/B Mode will replace the prior OS. If the new OS cannot be successfully activated, the current OS will be retained, preventing any loss of operability.
- Zebra StageNow
Zebra StageNow is Zebra's Android device Staging (configuration and deployment) solution, which simplifies the local initiation of OS Updates in File-Based Updates mode.
- Zebra Recovery Mode
Zebra Recovery Mode is a special mode into which Zebra Android devices can be booted that enables a User to remotely initiate OS Updates in File-Based Updates mode. Zebra Recovery Mode is also used when OS Updates are initiated using Zebra LifeGuard Update Files that DO NOT support A/B Mode. In such cases, the device will reboot into Zebra Recovery Mode when the OS Update is initiated, the OS Update will be performed in Zebra Recovery Mode, then the device will reboot into the new, updated, OS.
Detail Information:
Key = fotaConfig
Type = bundle
Update Mode
Select how OS Updates will be initiated on the device.
If the value Fully Automatic is selected, then Zebra LifeGuard OTA Service will be enabled and configured to automatically update the device whenever a suitable new Zebra LifeGuard Update File is published by Zebra to the Internet. Use of this mode requires device network connectivity over which the Zebra LifeGuard OTA Server on the Internet can be reached. Standard data rates apply for metered connections.
If the value EMM Controlled is selected, then Zebra LifeGuard OTA Service will be enabled but configured to NOT automatically update the OS even if a suitable new OS is published by Zebra to the Internet. A LifeGuard OTA-integrated EMM can be used to control when/if OS Updates are initiated remotely on devices and which Zebra LifeGuard Update Files are used. Use of this mode requires device network connectivity over which the EMM Server can be reached and over which Zebra LifeGuard OTA Server on the Internet can be reached. Standard data rates apply for metered connections.
If the value File-Based Updates is selected, then Zebra LifeGuard OTA Service will be disabled. File-Based Update Options can be specified to initiate OS Updates or OS Updates may be manually initiated on a device by the User using Zebra StageNow or Zebra Recovery Mode.
Detail Information:
Key = fotaUpdateMode
Type = string
UI Choice | JSON Value |
---|---|
Fully Automatic | 1 |
EMM Controlled | 2 |
File-Based Updates | 3 |
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 11.1.
UI Control
Select whether the User can change Zebra LifeGuard OTA Service settings.
If the value Allow is selected, the User will NOT be Allowed to use UI to modify Zebra LifeGuard OTA Service settings.
If the value Disallow is selected, the User WILL be Allowed to use UI to modify Zebra LifeGuard OTA Service settings.
Detail Information:
Key = fotaUserControlOfSettings
Type = string
UI Choice | JSON Value |
---|---|
Disallow | 2 |
Allow | 1 |
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 9.1.
Update Over Cellular
Select whether LifeGuard updates can occur over Cellular (metered) networks.
If the value On is selected, the User will use the cellular (metered) network to download the update.
If the value Off is selected, the User will use an unmetered network to download the update.
Detail Information:
Key = fotaUpdateOverCellular
Type = string
UI Choice | JSON Value |
---|---|
Off | 2 |
On | 1 |
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 11.1.
OTA Options
Enter one or more optional parameters to configure or adjust the behavior of the Zebra LifeGuard OTA Service.
Note: This feature is reserved for future use and no valid supported options currently exist. It is therefore recommended to leave this MC empty until future notice.
Detail Information:
Key = fotaOptions
Type = string
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: Future Use.
File-Based Update Source
Select the Source for the Zebra LifeGuard Update File to be used to initiate an OS Update when File-Based Updates is specified for Update Mode.
If the value Local Update File is selected, then an OS Update, if initiated, will use a Local Update File, whose path and file name must be specified in File-Based Update Local Path And Name, and which must already be present in the Device File System for the OS Update to occur.
If the value Streamed Update File is selected, then an * OS Update, if initiated, will use a *Streamed Update File, information about which must be specified in Streaming Configuration, and which must be present and reachable by the device over a suitable network for the OS Update to occur.
Detail Information:
Key = fotaConfigUpdateFileSource
Type = string
UI Choice | JSON Value |
---|---|
Local Update File | 1 |
Streamed Update File | 2 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
File-Based Update Options
Use this Sub-array to configure one or more File-Based Update Option(s) when File-Based Updates is specified for Update Mode.
To initiate File-Based Updates, one or more File-Based Update Options must be specified to identify the condition(s) under which OS Updates will be initiated. This is necessary because File-Based Updates could be initiated at any time and it would generally be undesirable to repeat the initiation of an OS Update that has already been successfully completed because it would put unnecessary load on the device and could negatively impact User workflow (e.g., by rebooting, etc.).
Note: It is allowable to use any combination of File-Based Update Options together, in which case an OS Update will ONLY be performed if the conditions associated with ALL specified options are met.
Detail Information:
Key = fotaUpdateOptions
Type = bundle_array
Support Information:
- NOT supported on Device(s): TC20 and TC25.
File-Based Update Option
Use this Sub-group to configure File-Based Update Option Type and Mismatch Version.
Detail Information:
Key = fotaUpdateOption
Type = bundle
Support Information:
- NOT supported on Device(s): TC20 and TC25.
File-Based Update Option Type
Select the Type of a single File-Based Update Option relating to how/when a Zebra LifeGuard Update File will be used to initiate an OS Update. when File-Based Updates is specified for Update Mode.
If the value Reboot Count Unchanged is selected, then an OS Update will be initiated when the value is set if the device has not rebooted since this value was first set and if the other requisite values for File Update are also specified. This Option assumes that a reboot will be performed as result of any OS Update (successful or unsuccessful) and hence that once the device has been rebooted, there would be no value in repeating the OS Update.
If the value Version Mismatch is selected, then an OS Update will be initiated when the value is set if the device reports a different OS Version for its current OS from that specified in Mismatch Version and if the other requisite values for File Update are also specified. This Option assumes that the administrator has properly determined the OS Version that will be present on the device once the Zebra LifeGuard Update File is applied and has accurately specified that OS Version value. The OS Version that will be present on the device once a Zebra LifeGuard Update File is applied to a device will be provided along with the Zebra LifeGuard Update File where it is posted by Zebra on the Internet. If an incorrect OS Version is specified, then it will likely never match the version reported by the device after performing the OS Update and could lead to repeated attempts to update the OS on the device.
Note: It is allowable to use any combination of File-Based Update Options together, in which case an OS Update will ONLY be performed if the conditions associated with ALL specified options are met.
Note: When using File-Based Update Options to perform an OS Update using a Zebra LifeGuard Update File, File-Based Update Source must also be specified to identify the Source from which the Zebra LifeGuard Update File will be acquired to perform the OS Update.
If the value Local Update File is selected for File-Based Update Source, then File-Based Update Local Path And Name must also be specified to provide the path and file name of the Local Update File, which must already be present in the Device File System, to be used to perform the OS Update.
If the value Streamed Update File is selected for File-Based Update Source, then Streaming Configuration must also be specified to provide the information required to Stream the Streamed Update File to perform the OS Update.
Detail Information:
Key = fotaUpdateOptionType
Type = string
UI Choice | JSON Value |
---|---|
Reboot Count Unchanged | 1 |
Version Mismatch | 2 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Mismatch Version
Enter the OS Version that will be reported by the device once the Zebra LifeGuard Update File is applied to the device. This is used to determine if the device current reports a different OS Version and hence needs to initiate an OS Update using the Zebra LifeGuard Update File to bring the device to the desired OS.
Detail Information:
Key = fotaUpdateOptionTypeMismatchVersion
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Auto Reboot
Select whether a device reboot should automatically be performed at the completion of a File-Based OS Update performed in A/B Mode.
If the value Yes is selected, whenever an OS Update is initiated in A/B Mode, while the OS is running, and the OS Update is successfully completed, the device will be rebooted automatically to activate the new OS. This might be done to ensure that the new OS, which might have new features or security fixes, is activated as soon as possible, even if it might disrupt User workflow.
If the value No is selected, whenever an OS Update is initiated in A/B Mode, while the OS is running, and the OS Update is successfully completed, the device will NOT be rebooted automatically to activate the new OS. The new OS will not be activated until a subsequent reboot. This might be done to avoid disrupting User workflow by deferring the activation of the new OS until some later time when the device is not being actively used.
Detail Information:
Key = fotaAutoReboot
Type = string
UI Choice | JSON Value |
---|---|
Yes | 1 |
No | 2 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
File-Based Update Local Path And Name
Enter the Path and File Name in the Device File System of a a Local Update File to use to initiate an OS Update, when the value File-Based Updates is selected for Update Mode.
Detail Information:
Key = fotaConfigLocalFilePathAndName
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Streaming Configuration
Use this Sub-group to configure Source URL, Authorization Type, Zebra Authentication Token, Username, Password, and Custom Authentication Header when File-Based Updates is specified for Update Mode and Streamed Update File is specified for File-Based Update Source.
To initiate an OS Update using File-Based Updates and a Streamed Update File, it is necessary to specify the source location from which the Streamed Update File will be acquired. It is also be necessary to specify information about the form of Authentication that will be used to authorize access to it. The following types of Authentication are supported when acquiring a Streamed Update File:
No Authorization is used when the URI specified for the source location from which the Streamed Update File will be acquired requires no authentication to authorize access.
Zebra Authentication Token is used when the URI specified for the source location from which the Streamed Update File is aZebra Internet Repository and therefore requires a Zebra Authentication Token issued by Zebra to be specified to authorize access.
Basic Authentication is used when the URI specified for the source location from which the Streamed Update File is a Repository that uses Basic Authentication and therefore requires a Username and Password to be specified to authorize access.
Custom Authorization Header is used when the URI specified for the source location from which the Streamed Update File is a Repository that uses some other form of Authentication and therefore requires a Custom Authentication Header to be specified to authorize access. .
Detail Information:
Key = fotaStreamingConfig
Type = bundle
Source URL
Enter a URL via which a Streamed Update File can be accessed, when needed, to initiate an OS Update. This could be an Internet or Intranet URL, and might require some form of Authentication" to authorize access to it. The *Authentication required to authorize access to the Streamed Update File must also be specified via Authorization Type.
Detail Information:
Key = fotaStreamingConfigSourcerUrl
Type = string
Authorization Type
Select the Type of Authentication required to authorize access to the Streamed Update File that will be used to initiate an OS Update.
If the value No Authorization is selected, no Authentication will be used to authorize access to the Streamed Update File and you do not need to specify any additional information.
If the value Zebra Authentication Token is selected, then Zebra Authentication will be used to authorize access to the Streamed Update File and therefore you must also specify Zebra Authentication Token.
If the value Basic Authentication is selected, then Basic Authentication will be used to authorize access to the Streamed Update File and therefore you must also specify Username and Password.
If the value Custom Authorization Header is selected, then Custom Authentication will be used to authorize access to the Streamed Update File and therefore you must also specify Custom Authentication Header.
Detail Information:
Key = fotaStreamingConfigAuthType
Type = string
UI Choice | JSON Value |
---|---|
No Authorization | 0 |
Zebra Authentication Token | 1 |
Basic Authentication | 2 |
Custom Authorization Header | 3 |
Zebra Authentication Token
Enter the Zebra-issued Authentication token required to authorize access to the Streamed Update File to be used to initiate an OS Update when Zebra Authentication Token is specified for Authorization Type.
Detail Information:
Key = fotaStreamingConfigZebraAuthToken
Type = string
Username
Enter the Username required to authorize access to the Streamed Update File to be used to initiate an OS Update when Basic Authentication is specified for Authorization Type.
Detail Information:
Key = fotaStreamingConfigUserName
Type = string
Password
Enter the Password required to authorize access to the Streamed Update File to be used to initiate an OS Update when Basic Authentication is specified for Authorization Type.
Detail Information:
Key = fotaStreamingConfigPassword
Type = string
Custom Authentication Header
Enter the Custom Authentication Header value required to authorize access to the Streamed Update File to be used to initiate an OS Update when Custom Authorization Header is specified for Authorization Type.
Detail Information:
Key = fotaStreamingConfigCustomAuthHeader
Type = string
Power Configuration
Use this Sub-group to configure Auto Control, Battery, Heaters, Ports Power, and Doze Mode State.
Detail Information:
Key = powerConfig
Type = bundle
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Auto Control Configuration
Use this Sub-group to configure Off Mode, Off Timeout, State, and On Mode.
Detail Information:
Key = autoControlConfig
Type = bundle
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Off Mode
Select whether and how device power will be automatically turned off as part of automatic power control when Auto Power Control is specified.
- If the value Never is selected, the device power will NOT automatically turn off when the ignition turns off.
- If the value When Ignition is Turned Off is selected, the device power will automatically turn off whenever the ignition turns off.
Detail Information:
Key = autoPowerOffMode
Type = string
UI Choice | JSON Value |
---|---|
Never | 0 |
When Ignition is Turned Off | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Off Timeout
Enter the timeout that will be in effect before device power is automatically turned off as part of automatic power control, when the value On is selected for Auto Power Control is specified and the value When Ignition is Turned Off is selected for Auto Power Off.
Detail Information:
Key = autoPowerOffTimeout
Type = integer
Support Information:
- NOT supported on Device(s): TC20 and TC25.
State
Select whether device power will be automatically controlled.
- If the value Off is selected, the device power will NOT be automatically controlled.
- If the value On is selected, the device power will be automatically controlled and you should also specify one or more of the following:
- Off Mode to specify whether/how device power will automatically be turned off.
- On Mode to specify whether/how device power will automatically be turned on.
Detail Information:
Key = autoPowerState
Type = string
UI Choice | JSON Value |
---|---|
Off | 0 |
On | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
On Mode
Select whether and how device power will be automatically turned on as part of automatic power control when Off Timeout is specified:
- If the value Never is selected, the device power will NOT automatically turn on when the ignition turns on.
- If the value When Ignition is Turned On is selected, the device power will automatically turn on whenever the ignition turns on.
Detail Information:
Key = autoPowerOnMode
Type = string
UI Choice | JSON Value |
---|---|
Never | 0 |
When Ignition is Turned On | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Battery Configuration
Use this Sub-group to configure Decommission Percentage Threshold, Decommission Usage Threshold, Critical Low Threshold, Saver Control Mode, Saver Mode Percentage Threshold, Saver State, and User Control of Saver.
Detail Information:
Key = batteryConfig
Type = bundle
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Decommission Percentage Threshold
Enter the percentage of remaining battery capacity below which the battery will be deemed ready for decommissioning.
Detail Information:
Key = batteryDecommissionPercentageThreshold
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Decommission Usage Threshold
Enter the amount of battery usage (e.g. charge/discharge cycles, coulombs in/out, etc.) that can occur before the battery will be deemed ready for Decommissioning.
Detail Information:
Key = batteryDecommissionUsageThreshold
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Critical Low Threshold
Enter the threshold battery level below which the battery is deemed to be critically low.
- The Default Value is 4, which causes the battery to be deemed critical low when the battery level dips below 4% remaining capacity.
- If the value 0 is selected, the currently configured critically low threshold will not be changed, which is functionally equivalent to not specifying value.
- If a value from 1 through 25 will cause the critically low threshold will be set to the specified value.
Detail Information:
Key = batteryCriticalLowThreshold
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Saver Control Mode
Select how Battery Saver Mode will be controlled.
If the value Manually is selected, the device will NOT Automatically, and will activate Battery Saver Mode only when specifically requested by the User or by specifying the value On for Saver State.
If the value Automatically is selected, the device WILL Automatically activate Battery Saver Mode and Saver Mode Percentage Threshold must also be specified to provide the threshold battery level percentage below which the device will Automatically activate Battery Saver Mode.
Detail Information:
Key = powerBatterySaverControlMode
Type = string
UI Choice | JSON Value |
---|---|
Manually | 2 |
Automatically | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Saver Mode Percentage Threshold
Enter the Battery Level percentage below which Battery Saver Mode will automatically turned On, when Automatically is specified for Saver Control Mode.
Detail Information:
Key = powerBatterySaverModePercentage
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Saver State
Select the Battery Saver State.
If the value Off is selected, Battery Saver State will be turned Of.
If the value On is selected, Battery Saver State will be turned On.
Detail Information:
Key = powerBatterySaverState
Type = string
UI Choice | JSON Value |
---|---|
Off | 2 |
On | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
User Control of Saver
Select whether the User will be allowed to control the State of Battery Saver Mode via UI on the device.
If the value Disable is selected, then the User will NOT be allowed to control the State of Battery Saver Mode via UI on the device.
If the value Enable is selected, then the User will be allowed to control the State of Battery Saver Mode via UI on the device.
Detail Information:
Key = powerBatteryUserControlSaver
Type = string
UI Choice | JSON Value |
---|---|
Disable | 2 |
Enable | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Heaters
Use this Sub-array to configure one or more Heater(s).
Detail Information:
Key = heaters
Type = bundle_array
Support Information:
Supported on Operating System(s): Oreo and Pie.
Supported on Device(s): VC80X and VC8300.
NOT supported on Device(s): TC20 and TC25.
Support discontinued from: MX 9.0.
Heater
Use this Sub-group to configure Type, Off Threshold, and On Threshold.
Detail Information:
Key = heater
Type = bundle
Support Information:
Supported on Operating System(s): Oreo and Pie.
Supported on Device(s): VC80X and VC8300.
NOT supported on Device(s): TC20 and TC25.
Support discontinued from: MX 9.0.
Type
Select the Type of Heater.
- If the value Serial I/O is selected, the Heater that warms the Serial I/O Port of the device will be selected.
- If the value USB I/O is selected, the Heater that warms the USB I/O Port of the device will be selected.
- If the value Battery is selected, the Heater that warms the Battery of the device will be selected.
- If the value Touch Panel is selected, the Heater that warms the Touch Panel of the device will be selected.
- If the value Keyboard is selected, the Heater that warms the Keyboard of the device will be selected.
- If the value Scanner Window is selected, the Heater that warms the Scanner Window of the device will be selected.
Detail Information:
Key = heaterType
Type = string
UI Choice | JSON Value |
---|---|
Serial I/O | 1 |
USB I/O | 2 |
Battery | 3 |
Touch Panel | 4 |
Keyboard | 5 |
Scanner Window | 6 |
Support Information:
Supported on Operating System(s): Oreo and Pie.
Supported on Device(s): VC80X and VC8300.
NOT supported on Device(s): TC20 and TC25.
Off Threshold
Select the temperature above which a specified Heater should automatically turn OFF.
Detail Information:
Key = heaterOffThreshold
Type = integer
Support Information:
Supported on Operating System(s): Oreo and Pie.
Supported on Device(s): VC80X and VC8300.
NOT supported on Device(s): TC20 and TC25.
On Threshold
Select the temperature below which a specified Heater should automatically turn ON.
Detail Information:
Key = heaterOnThreshold
Type = integer
Support Information:
Supported on Operating System(s): Oreo and Pie.
Supported on Device(s): VC80X and VC8300.
NOT supported on Device(s): TC20 and TC25.
Ports Power
Use this Sub-array to configure one or more Port Power(s).
Detail Information:
Key = portsPower
Type = bundle_array
Support Information:
Supported on Operating System(s): Oreo and Pie.
Supported on Device(s): VC80X and VC8300.
NOT supported on Device(s): TC20 and TC25.
Support discontinued from: MX 9.0.
Port Power
Use this Sub-group to configure Power Port Type.
Detail Information:
Key = portPower
Type = bundle
Support Information:
Supported on Operating System(s): Oreo and Pie.
Supported on Device(s): VC80X and VC8300.
NOT supported on Device(s): TC20 and TC25.
Support discontinued from: MX 9.0.
Power Port Type
Select a Port Type for which the Output Power State will be specified.
- If the value Serial Port 1 is selected, the the Output Power State will be specified for the first Serial Port.
- If the value Serial Port 2 is selected, the Output Power State will be specified for the second device Serial Port.
- If the value USB Port 2 is selected, the Output Power State will be specified for second device USB Port.
Detail Information:
Key = sysPowerPortType
Type = string
UI Choice | JSON Value |
---|---|
Serial Port 1 | 1 |
Serial Port 2 | 2 |
USB Port 2 | 3 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Doze Mode State
Select whether Doze Mode should be turned On or Off for the entire device.
If the value Off is selected, the device will never enter Doze Mode for any applications.
If the value On is selected, the device will will enter Doze Mode for various applications based on the normal Android rules for Doze Mode.
Detail Information:
Key = sysPowerDozeModeState
Type = string
UI Choice | JSON Value |
---|---|
Off | 2 |
On | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Remote Scanner Configurations
Use this Sub-group to configure Remote Scanner Configuration.
Detail Information:
Key = remoteScannerConfigs
Type = bundle
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Remote Scanner Configuration
Use this Sub-array to configure one or more Remote Scanner(s).
Detail Information:
Key = remoteScannerConfig
Type = bundle_array
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Remote Scanner
Use this Sub-group to configure Config File, Scanner Serial Number, and Update File.
Detail Information:
Key = remoteScanner
Type = bundle
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Config File
Enter the path and file name of a configuration file, which must exist at the specified location in the device file system, from which configuration should be applied to the specified Remote Scanner.
Detail Information:
Key = remoteScannerConfigFile
Type = string
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 5.2.
Scanner Serial Number
Enter the Serial Number of the Remote Scanner to be affected.
Detail Information:
Key = remoteScannerSerialNumber
Type = string
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 5.2.
Update File
Enter the path and file name of an Update File to be applied.
Detail Information:
Key = remoteScannerUpdateFile
Type = string
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 5.2.
Wake-Up Configuration
Use this Sub-group to configure Wake-Up All Sources State, Wake-Up Method, and Wake-Up Sources.
Detail Information:
Key = wakeupConfig
Type = bundle
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Wake-Up All Sources State
Select whether all Wake-Up Sources should be collectively turned On or Off.
If the value Off is selected, then all Wake-Up Sources will be turned Off (will NOT Wake-Up the Display).
If the value On is selected, then all Wake-Up Sources will be turned On (will Wake-Up the Display).
Detail Information:
Key = wakeupAllSourcesState
Type = string
UI Choice | JSON Value |
---|---|
Off | 2 |
On | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Wake-Up Method
Select the Method that will be used to identify Wake-up Sources to be controlled.
If the value Use Hardware Signals for Wake-Up is selected, Wake-Up Sources will be Key Identifiers for Hardware Signals related to Physical Keys.
If the value Use Software (Mappable Keycodes) for Wake-Up is selected, Wake-Up Sources will be Key Identifiers for Software Remappable Keys.
Detail Information:
Key = wakeupMethod
Type = string
UI Choice | JSON Value |
---|---|
Use Hardware Signals for Wake-Up | 1 |
Use Software (Mappable Keycodes) for Wake-Up | 2 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Wake-Up Sources
Use this Sub-array to configure one or more Wake-Up Source(s).
Detail Information:
Key = powerWakeupSources
Type = bundle_array
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Wake-Up Source
Use this Sub-group to configure Key Identifier and State.
Detail Information:
Key = wakeupSource
Type = bundle
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Key Identifier
Select the Key Identifier to be used to identify the Wake-Up Source to be controlled.
If the value L1 Button is selected, the First (Topmost) Button located on the Left side of the device will be the identified Wake-Up Source.
If the value L2 Button is selected, the Second (Down from the top) Button located on the Left side of the device will be the identified Wake-Up Source.
If the value R1 Button is selected, the First (Topmost) Button located on the Right side of the device will be the identified Wake-Up Source.
If the value R2 Button is selected, the Second (Down from the top) Button located on the Right side of the device will be the identified Wake-Up Source.
If the value Grip (Gun) Trigger is selected, the Trigger on the Grip (Gun Handle) will be the identified Wake-Up Source.
If the value Rear Button is selected, the Button located on the Rear of the device will be the identified Wake-Up Source.
If the value Custom is selected, a Custom Button will be the identified Wake-Up Source.
Detail Information:
Key = wakeupKeyId
Type = string
UI Choice | JSON Value |
---|---|
Button L1 | BUTTON_L1 |
Button L2 | BUTTON_L2 |
Button R1 | BUTTON_R1 |
Button R2 | BUTTON_R2 |
Grip (Gun) Trigger | GUN_TRIGGER |
Rear Button | REAR_BUTTON |
Custom | Custom |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
State
Select whether the identified Wake-up Source should be turned On (will Wake-Up the Display) or Off (will NOT Wake-Up the Display).
If the value Off is selected, the Wake-Up Source will be turned Off (will NOT Wake-Up the Display).
If the value On is selected, the Wake-Up Source will be turned On (will Wake-Up the Display).
Detail Information:
Key = wakeupState
Type = string
UI Choice | JSON Value |
---|---|
Off | 2 |
On | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Pass-Through Command
Enter Java Script to be Passed-Through by OemConfig to a lower-level processing module.
Detail Information:
Key = passThroughCommand
Type = string
Logs Configuration
Use this Sub-group to configure Background Collection State, Logging Level, Upload Snapshots URI, and Upload When Logging Turned Off.
Detail Information:
Key = logsConfig
Type = bundle
Background Collection State
Select the Log Action to be performed.
If the value Start Background Collection is selected, then the Log Management subsystem will Start Background Collection of Log Files. To ensure that Log File content required for troubleshooting is available, Background Collection of Log Files should be Started well before the occurrence of an event of interest to ensure that when the Log Files are acquired, they will contain information concerning that event.
If the value Stop Background Collection is selected, then the Log Management subsystem will Stop Background Collection of Log Files. Since Background Collection of Log Files can consume significant system resources, it is best to Stop Background Collection of Log Files when troubleshooting is completed and collection of Log Files is no longer required.
Detail Information:
Key = backgroundCollectionState
Type = string
UI Choice | JSON Value |
---|---|
Off | DISABLE |
On | ENABLE |
Logging Level
Select the Level of Logging to be performed.
If the value Basic is selected, then the Log Management subsystem will be configured to collect Kernel and Logcat log data.
If the value Basic+Qxdm is selected, then the Log Management subsystem will be configured to collect Kernel, Logcat and Qxdm log data. Qxdm log data is only supported on WAN (Cellular) devices.
If the value Basic+TCP Dump is selected, then the Log Management subsystem will be configured to collect Kernel, Logcat and TCP Dump log data.
Since Background Collection of Log Files can consume significant system resources, it is best to select the minimum level of Logcat logging that will serve the need. When unsure, it may be advisable to start with lowest level and work up to higher levels if needed.
Detail Information:
Key = logsCollectionConfigurationLogLevel
Type = string
UI Choice | JSON Value |
---|---|
Basic | [binary data] |
Basic+Qxdm | [binary data] |
Basic+TCP Dump | [binary data] |
Upload Snapshots URI
Enter the URI of a location on a Remote Server to which all Snapshot Files previously Created on-device, and which have not yet been Uploaded, will be Uploaded.
Snapshot Files will be Uploaded to the Remote Server in the order they were Created on-device (oldest to newest).
Each Snapshot File will be automatically deleted from the device once it has been successfully Uploaded to the Remote Server.
The specified URI MUST start with a Protocol Specification that indicates which file transfer protocol should be used to Upload the Snapshot File. The following are supported:
FTP:// - The (insecure) File Transfer Protocol (FTP) protocol will be used to Upload the Snapshot File.
FTPS:// - The (secure) File Transfer Protocol over SSL (FTPS) protocol will be used to Upload the Snapshot File.
The specified URI:
MAY contain authentication credentials that will be used to authenticate to the Remote Server before Uploading the Snapshot File.
MUST contain an IP address or domain name that identifies the Remote Server to which the Snapshot File will be Uploaded.
SHOULD typically contain path that identifies the location on the Remote Server, relative to the home folder of the default account or the account selected by the authentication credentials, to which the Snapshot File will be Uploaded.
MUST NOT contain a file name since the name of the file to which the Snapshot File will be Uploaded on the Remote Server will be automatically generated, as described below, to ensure that Snapshot Files from various devices, and created at various times, do not overwrite each other.
Each Snapshot File that is Uploaded to the Remote Server will be assigned an automatically generated unique file name of the format:
- model-serial-date-time.zip.
The above format enables files Uploaded to the same folder on the Remote Server to be differentiated by the models and serial numbers of the devices that Uploaded them and by the date and time when the files were created on those devices.
- For example: TC510K-17068522528997-01312020-132649.zip
Within the above example:
TC510K is the model identifier of the device that Uploaded the Snapshot File.
17068522528997 is the serial number of the device that Uploaded the Snapshot File.
01312020 is the date the Snapshot File was Created in the device, indicating January 31, 2020.
132649 is the time the Snapshot File was Created in the device, indicating 1:26:49 PM.
Detail Information:
Key = logsUploadSnapshotsUri
Type = string
Upload When Logging Turned Off
Select whether to upload logs to the specified URI when logging is turned off.
If the value No is selected, then when logging is turned off, no logs will be uploaded.
If the value Yes is selected, then when logging is turned off, logs will be sent to the URI defined in Upload Snapshots URI
Detail Information:
Key = logsCollectionConfigurationUploadWhenOff
Type = string
UI Choice | JSON Value |
---|---|
No | 0 |
Yes | 1 |
UI Configuration
Use this Group to configure Audio, Display, General UI, Keyboard, Settings UI, Touch Panel, and Volume UI Profiles.
Detail Information:
Key = uiConfig
Type = bundle
Audio Configuration
Use this Sub-group to configure Best Path Exclusions, Charging Sounds, Control Vibrate On Call Options, Replication, and Mute/Vibrate.
Detail Information:
Key = audioConfig
Type = bundle
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Best Path Exclusions
Use this Sub-array to configure one or more -Best Path Exclusion(s).
Detail Information:
Key = acBestPathExclusions
Type = bundle_array
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 11.1.
-Best Path Exclusion
Use this Sub-group to configure Device.
Detail Information:
Key = acBestPathExclusion
Type = bundle
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 11.3.
Device
Select the device to include on the Best Path Exclusion list
Detail Information:
Key = acBPEDevice
Type = string
UI Choice | JSON Value |
---|---|
Wired Headset (3.5 mm) | 2 |
USB Audio | 3 |
Bluetooth A2DP Audio | 4 |
HDMI Audio | 5 |
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 11.3.
Charging Sounds
Select whether a Sounds will be played when the Charging state of the device changes.
- If the value Do NOT Play is selected, no sound will be played when the Charging state of the device changes.
- If the value Play is selected, a chime will play when the Charging state of the device changes.
Detail Information:
Key = audioChargingSounds
Type = string
UI Choice | JSON Value |
---|---|
Do NOT Play | 2 |
Play | 1 |
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 9.3.
Control Vibrate On Call Options
Select whether the device will vibrate on call.
If the value Never Vibrate is selected, the device will never vibrate for incoming calls.
If the value Always Vibrate is selected, the device will always vibrate for incoming calls.
if the value Vibrate First Then Ring Gradually is selected, the device will vibrate first and then the ringer will gradually increase in volume.
Detail Information:
Key = audioSetVibrateOnCallsOption
Type = string
UI Choice | JSON Value |
---|---|
Never Vibrate | 1 |
Always Vibrate | 2 |
Vibrate First Then Ring Gradually | 3 |
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 11.1.
Replication
Select whether headset audio will be replicated to the built-in device speaker.
If the value Do not replicate headset audio on built-in speaker is selected, headset audio will NOT be replicated to the built-in device speaker. This might be desirable in a situation where the device is being used in an area where routing audio to the built-in device speaker could be disruptive to others in the area.
If the value Replicate headset audio on built-in speaker is selected, headset audio WILL be replicated to the built-in device speaker. This might be desirable in a situation where the User may walk away from a vehicle mounted device and leave his headset in the vehicle while performing some task nearby. If an audible alert is also routed to the built-in device speaker, the User might still hear it.
Detail Information:
Key = audioReplication
Type = string
UI Choice | JSON Value |
---|---|
Do not replicate headset audio on built-in speaker | 2 |
Replicate headset audio on built-in speaker | 1 |
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 7.2.
Mute/Vibrate
Select the mute and vibrate behavior of a device.
If the value Mute without Vibrate is selected, the volume will be muted (made silent) and the device will NOT vibrate, permitting neither audible nor tactile alerts.
If the value Mute with Vibrate is selected, the volume will be muted (made silent) and the device will vibrate, permitting tactile but NOT audible alerts.
If the value Unmute without Vibrate is selected, the volume will be unmuted (made audible) and the device will NOT vibrate, permitting audible but not tactile alerts.
Detail Information:
Key = audioMuteVibrate
Type = string
UI Choice | JSON Value |
---|---|
Mute without Vibrate | 1 |
Mute with Vibrate | 2 |
Unmute without Vibrate | 3 |
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 4.4.
Display Configuration
Use this Sub-group to configure Force Activities Resizable, Blanking, Power, Secondary Display, and Size and Rotation.
Detail Information:
Key = displayConfig
Type = bundle
Force Activities Resizable
Select whether the device display and secondary display will force activities to be treated as resizable even if not declared in the application manifest.
If All Activities Resizable is selected, all activities running on the device display and secondary display will be forced to be treated as resizable even if not declared in the application manifest.
Iif Follow Application Manifest is selected, activities will be treated as resizable only if declared to be resizable in the application manifest.
Detail Information:
Key = uiDisplayForceActivitiesResizable
Type = string
UI Choice | JSON Value |
---|---|
All Activities Resizable | 1 |
Follow Application Manifest | 2 |
Support Information:
- Supported from: MX 10.5.
Blanking Configuration
Use this Sub-group to configure Mode, Signal, Debounce Delay, and Polarity.
Detail Information:
Key = blankingConfig
Type = bundle
Mode
Select whether the device Display will be Allowed to automatically Blank (display nothing) on a device under certain conditions.
When a User is operating a motor vehicle with a vehicle-mounted device, it is often advisable, and sometimes mandatory, for safety or regulatory reasons, to prevent the User from interacting with the device or being distracted by the Display of the device, while the vehicle is in motion.
At present, this feature is supported ONLY on the Zebra VC80x vehicle-mounted Android device.
If the value Never Blank is selected, the device Display will NOT be Allowed to automatically Blank (display nothing).
If the value Blank When Triggered by Signal is selected, the device Display WILL be Allowed to automatically Blank (display nothing). The following must also be specified:
Signal to specify the signal that will be used to activate automatic Display Blanking.
Polarity to specify the polarity of the signal specified via Signal that will be used to activate automatic Blanking.
Debounce Delay to specify the time that will be used to debounce the signal specified via Signal.
Detail Information:
Key = blankingMode
Type = string
UI Choice | JSON Value |
---|---|
Never Blank | 1 |
Blank When Triggered by Signal | 2 |
Support Information:
- Supported on Device(s): VC8X.
Signal
Select the Signal that will be used to trigger automatic Display Blanking when the value Blank When Triggered by Signal is selected for Blanking Mode to turn on Display Blanking Mode.
- If the value Input 1 is selected, on the Zebra VC80x vehicle-mounted Android device the Clear To Send (CTS) input signal on Serial Port 1 will be used to trigger automatic Display Blanking.
- If the value Input 2 is selected, on the Zebra VC80x vehicle-mounted Android device the Clear To Send (CTS) input signal on Serial Port 2 will be used to trigger automatic Display Blanking.
A common configuration to support Display Blanking Mode would be to connect the Request to Send (RTS) output signal of the selected Serial Port to the Clear To Send (CTS) input signal on the same serial port, via a switch, such as one activated by the vehicle accelerator. When the switch is activated, the output RTS output signal would be fed back into the CTS input signal and detected to trigger automatic Display Blanking.
Detail Information:
Key = blankingModeSignal
Type = string
UI Choice | JSON Value |
---|---|
Input 1 | 1 |
Input 2 | 2 |
Support Information:
- Supported on Device(s): VC8X.
Debounce Delay
Enter the Debounce Delay that will be used for the Signal that will be used to trigger automatic Display Blanking when the value Blank When Triggered by Signal is selected for Blanking Mode to turn on Display Blanking Mode.
The value specified should be in milliseconds and will be used as a delay following a change in signal state for changing the state of Display Blanking. This is useful to avoid spurious or repetitive changes in Display Blanking state as a result of bounce or chatter on the signal used to trigger automatic Display Blanking. The value specified should be in the range of 250 milliseconds (one quarter of a second) to 32767 milliseconds (more than 32 seconds), which should be adequate to handle most situations.
Detail Information:
Key = blankingModeSignalDebounceDelay
Type = integer
Support Information:
- Supported on Device(s): VC8X.
Polarity
Select the Polarity of the Signal that will be used to trigger automatic Display Blanking when the value Blank When Triggered by Signal is selected for Blanking Mode to turn on Display Blanking Mode.
- If the value Blank screen when signal goes inactive (OFF) is selected, the automatic Display Blanking will occur when the specified signal is detected as going inactive (OFF). This choice would be used in specialized configurations where the signal to be used to trigger automatic Display Blanking has reverse polarity.
- If the value Blank screen when signal goes active (ON) is selected, , the automatic Display Blanking will occur when the specified signal is detected as going active (ON). This is the most common choice for the common configuration of connecting RTS and CTS via a switch.
Detail Information:
Key = blankingModeSignalPolarity
Type = string
UI Choice | JSON Value |
---|---|
Blank screen when signal goes inactive (OFF) | 2 |
Blank screen when signal goes active (ON) | 1 |
Support Information:
- Supported on Device(s): VC8X.
Power Configuration
Use this Sub-group to configure Timeout, Stay Awake, Mode, and Brightness.
Detail Information:
Key = displayPowerConfig
Type = bundle
Timeout
Enter the Duration of inactivity (in seconds), after which the Display Power State will Automatically be turned Off.
A given device may not support all available Duration values. In the event that a selected Durationvalue is not supported on a given device, the smallest larger value that is supported will be used or, if no larger value is supported, the largest smaller value that is supported will be used.
Detail Information:
Key = displayPowerTimeout
Type = string
UI Choice | JSON Value |
---|---|
15 seconds | 15 |
30 seconds | 30 |
1 minute | 60 |
2 minutes | 120 |
5 minutes | 300 |
10 minutes | 600 |
30 minutes | 1800 |
Stay Awake
Select whether the Display Power State will be forced to remain On whenever the device is connected to external power.
- If the value Stay Awake is selected, the Display Power State will NOT be forced to remain On whenever the device is connected to external power and hence the Display Power State MAY be Automatically turned Off, after a period of inactivity specified via Timeout.
- If the value Timeout is selected, the Display Power State WILL be forced to remain On whenever the device is connected to external power and hence the Display Power State will NOT be Automatically turned Off, even after a period of inactivity specified via Timeout.
When a device is used in a specialized environment, such as in a vehicle-mounted cradle or in a desktop docking station, the device may be continuously receiving power, rather than running off its own internal battery. In such situations, it may desirable to keep the device awake all the time since little would be gained from allowing the Display Power State to be Automatically turned Off.
Detail Information:
Key = displayPowerStayAwake
Type = string
UI Choice | JSON Value |
---|---|
Stay Awake | 2 |
Timeout | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Mode
Select how the Power State of the Display Backlight will be controlled.
If the value Manual is selected, the Power State of the Display Backlight will be controlled Manually by the User or by specifying Brightness.
If the value Automatic is selected, the Power State of the Display Backlight will be controlled Aautomatically, based on the Ambient Light Sensor.
Detail Information:
Key = displayPowerBrightnessMode
Type = string
UI Choice | JSON Value |
---|---|
Manual | 2 |
Automatic | 1 |
Brightness
Enter the Backlight Brightness when the value Manual is selected for Mode.
Detail Information:
Key = displayPowerBrightness
Type = integer
Secondary Display Configuration
Use this Sub-group to configure Resizable Windows, Secondary Display Mode, and Secondary Display Remote Control.
Detail Information:
Key = secondaryDisplayConfig
Type = bundle
Resizable Windows
Select whether the device display and secondary display will support resizable windows.
If Turn On is selected, the device display and secondary display will allow resizing of windows.
If Turn Off is selected, the device display and secondary display will NOT allow resizing of windows.
Detail Information:
Key = uisDCResizableWindows
Type = string
UI Choice | JSON Value |
---|---|
Turn On | 1 |
Turn Off | 2 |
Support Information:
- Supported from: MX 10.5.
Secondary Display Mode
Select the mode to use for the secondary display.
If Present Independent Desktop is selected, the secondary display will present a desktop that is independent from the device screen.
If Mirror Device Screen is selected, the secondary display will present a duplicate (mirror) of the device screen.
Detail Information:
Key = uisDCDisplayMode
Type = string
UI Choice | JSON Value |
---|---|
Present Independent Desktop | 1 |
Mirror Device Screen | 2 |
Support Information:
- Supported from: MX 10.5.
Secondary Display Remote Control
Select the display on which remote operations will be performed.
If Primary (Mobile) is selected, remote control operations will be performed on the primary (mobile) display
If Secondary (Desktop) is selected, remote control operations will be performed on the secondary (desktop) display
Detail Information:
Key = uisDCRemoteControl
Type = string
UI Choice | JSON Value |
---|---|
Primary (Mobile) | 0 |
Secondary (Desktop) | 1 |
Support Information:
- Supported from: MX 11.1.
Size and Rotation Configuration
Use this Sub-group to configure Allowed Orientations, Locked Orientation Positions, Rotation Mode, Auto-Landscape External Display, Display Size, Font Size, and Lock Override Button.
Detail Information:
Key = sizeAndRotationConfig
Type = bundle
Allowed Orientations
Select which orientations are permitted when auto rotation is active.
If All (0 90 180 270 degrees) is selected, all orientations are allowed.
If All except portrait inverted (180 degrees) is selected, all orientations except inverted portrait are allowed.
Detail Information:
Key = displayAllowedOrientations
Type = string
UI Choice | JSON Value |
---|---|
All (0 90 180 270 degrees) | 1 |
All except portrait inverted (180 degrees) | 2 |
Support Information:
- Supported from: MX 10.5.
Locked Orientation Positions
Select an orientation in which to lock the display when autorotation is turned off.
If Portrait (No rotation) is selected, portrait (no rotation) is locked.
If Landscape left (90 degrees) is selected, landscape left (90 degrees) is locked.
if Portrait inverted (180 degrees) is selected, portrait inverted (180 degrees) is locked.
if Landscape right (270 degrees) is selected, landscape right (270 degrees) is locked.
Detail Information:
Key = displayLockedOrientation
Type = string
UI Choice | JSON Value |
---|---|
Portrait (No rotation) | 0 |
Landscape left (90 degrees) | 1 |
Portrait inverted (180 degrees) | 2 |
Landscape right (270 degrees) | 3 |
Support Information:
- Supported from: MX 10.5.
Rotation Mode
Select how Display Rotation will be performed.
If the value Manual is selected, how Display Rotation will be performed Manually, by the User.
If the value Automatic is selected, how Display Rotation will be performed Automatically, based on the Accelerometer.
Detail Information:
Key = displayConfigRotationMode
Type = string
UI Choice | JSON Value |
---|---|
Manual | Manual |
Automatic | Auto |
Auto-Landscape External Display
Select whether the display will auto-rotate when the device is placed in a workstation cradle and display mirroring is used.
Detail Information:
Key = displayConfigAutoLandscape
Type = string
UI Choice | JSON Value |
---|---|
On | 1 |
Off | 2 |
Support Information:
Supported on Operating System(s): Pie.
NOT supported on Device(s): TC20 and TC25.
Display Size
Select the system display size
Detail Information:
Key = displayConfigDisplaySize
Type = string
UI Choice | JSON Value |
---|---|
Small | SMALL |
Default | DEFAULT |
Large | LARGE |
Larger | LARGER |
Largest | LARGEST |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Font Size
Select the system font size
Detail Information:
Key = displayConfigFontSize
Type = string
UI Choice | JSON Value |
---|---|
Small | 0.85 |
Default | 1.0 |
Large | 1.15 |
Largest | 1.3 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Lock Override Button
Select whether the User is allowed to override the locked screen orientation.
If Enable is selected, the User is allowed to override the locked screen orientation.
if Disable is selected, the User is not allowed to override the locked screen orientation.
Detail Information:
Key = displayLockOverrideButton
Type = string
UI Choice | JSON Value |
---|---|
Enable | 1 |
Disable | 2 |
Support Information:
- Supported from: MX 10.5.
General UI Configuration
Use this Sub-group to configure Feature Usage, Localization, and UI Element.
Detail Information:
Key = uiGeneralConfig
Type = bundle
Feature Usage Configuration
Use this Sub-group to configure Auto Correct, Clipboard, Sharing, Long Press on Home to Launch Google Assistant, Magnification Gestures, Notification Bar, Proximity Sensor, Access Clock from Date in Notification, and Battery Charging LED.
Detail Information:
Key = uiFeaturesConfig
Type = bundle
Auto Correct
Select whether the User will be presented with Automatic Correction suggestions to potential mistakes made during data entry.
If the value Off is selected, the User will NOT be presented with Automatic Correction suggestions to potential mistakes made during data entry.
If the value On is selected, the User MAY be presented with Automatic Correction suggestions to potential mistakes made during data entry.
Detail Information:
Key = uiFeatureAutoCorrect
Type = string
UI Choice | JSON Value |
---|---|
Off | 2 |
On | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Clipboard
Select whether the User will be Allowed to utilize the Clipboard cut, copy, and paste text between applications.
- If the value Allow is selected, the User will NOT be Allowed to utilize the Clipboard cut, copy, and paste text between applications.
- If the value Disallow is selected, the User WILL be Allowed to utilize the Clipboard cut, copy, and paste text between applications.
Detail Information:
Key = uiFeatureClipboard
Type = string
UI Choice | JSON Value |
---|---|
Disallow | 2 |
Allow | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Sharing
Select whether the User will be allowed to utilize the clipboard Sharing on a device to share the contents of the clipboard.
Detail Information:
Key = uiFeatureClipboardSharing
Type = string
UI Choice | JSON Value |
---|---|
Off | 2 |
On | 1 |
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 10.5.
Support discontinued from: MX 11.0.
Long Press on Home to Launch Google Assistant
Select whether a the User will be Allowed to use a long press on the Home Key to Launch the Google Assistant.
- If the value Disallow is selected, the User will NOT be Allowed to use a long press on the Home Key to Launch the Google Assistant.
- If the value Allow is selected, the User WILL be Allowed to use a long press on the Home Key to Launch the Google Assistant.
Detail Information:
Key = uiFeatureLongPressHomeToLaunchGoogleAssistant
Type = string
UI Choice | JSON Value |
---|---|
Disallow | 2 |
Allow | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Magnification Gestures
Select whether the User will be Allowed to Use Magnification Gestures.
- If the value Disallow is selected, the User will NOT be Allowed to Use Magnification Gestures.
- If the value Allow is selected, the User WILL be Allowed to Use Magnification Gestures.
Detail Information:
Key = uiFeatureMagnificationGestures
Type = string
UI Choice | JSON Value |
---|---|
Disallow | 2 |
Allow | 1 |
Notification Bar
Select whether the User will be Allowed to Pull Down the Notification Bar to interact with notifications in the Notifications Panel.
- If the value Disallow is selected, the User will NOT be Allowed to Pull Down the Notification Bar to interact with notifications in the Notifications Panel.
- If the value Allow is selected, the User WILL be Allowed to Pull Down the Notification Bar to interact with notifications in the Notifications Panel.
Detail Information:
Key = uiFeatureNotificationBar
Type = string
UI Choice | JSON Value |
---|---|
Disallow | 2 |
Allow | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Proximity Sensor
Select whether the proximity sensor will be used.
- If the value Disallow is selected, the proximity sensor will be used.
- If the value Allow is selected, the proximity sensor will not be used.
Detail Information:
Key = uiFeatureProximitySensor
Type = string
UI Choice | JSON Value |
---|---|
Disallow | 2 |
Allow | 1 |
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 11.5.
Access Clock from Date in Notification
Select whether the User will be Allowed to Access the Clock Application from the Date displayed in a Notification in the Notification Panel.
- If the value Allow is selected, the User will NOT be Allowed to Access the Clock Application from the Date displayed in a Notification in the Notification Panel.
- If the value Disallow is selected, the User WILL be Allowed to Access the Clock Application from the Date displayed in a Notification in the Notification Panel.
Detail Information:
Key = uiFeatureDateInNotificationAccessClock
Type = string
UI Choice | JSON Value |
---|---|
Allow | 1 |
Disallow | 2 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Battery Charging LED
Select whether the battery charging sub-system of the device will be allowed to use the battery charging LED to indicate the state of charging the device battery.
- If the value Disable is selected, the battery charging sub-system of the device will NOT be allowed to use the battery charging LED to indicate the state of charging the device battery. This could be used to help eliminate distractions, such as when the device is charging in a cradle in a darkened vehicle or when many devices are charging in close proximity resulting in many flashing LEDs.
- If the value Enable is selected, the battery charging sub-system of the device will NOT be allowed to use the battery charging LED to indicate the state of charging the device battery. This could be beneficial by allowing at-a-glance determination of the charging status of a device.
Detail Information:
Key = uiFeatureBatteryChargingLED
Type = string
UI Choice | JSON Value |
---|---|
Disable | 2 |
Enable | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Localization Configuration
Use this Sub-group to configure Locale and Launcher Package Name.
Detail Information:
Key = uiLocalizationConfig
Type = bundle
Locale
Select the Locale to be used.
A Locale identifies where a device is being used and adjusts UI elements to suit that location. A Locale is specified by selecting a mandatory Language (e.g. English) and may optionally specify a Region (e.g. the United States) where that Language is spoken.
When only a Language is specified, the value selected will be the name of the Language (e.g. CHINA).
When both a Language and a Region are specified, the value selected will be the name of the Region followed by the name of the Language, separated by an underscore (e.g. CANADA_FRENCH).
Detail Information:
Key = uiLocalizationLocale
Type = string
UI Choice | JSON Value |
---|---|
CANADA | en_CA |
CANADA_FRENCH | fr_CA |
CHINA | zh_CN |
CHINESE | zh |
ENGLISH | en |
FRANCE | fr_FR |
FRENCH | fr |
GERMAN | de |
GERMANY | de_DE |
ITALIAN | it |
ITALY | it_IT |
JAPAN | ja_JP |
JAPANESE | ja |
KOREA | ko_KR |
KOREAN | ko |
PRC | zh_CN |
SIMPLIFIED_CHINESE | zh_CN |
TAIWAN | zh_TW |
TRADITIONAL_CHINESE | zh_TW |
UK | en_GB |
US | en_US |
SPANISH | es_ES |
US_SPANISH | es_US |
BRAZIL_PORTUGUESE | pt_BR |
PORTUGUESE | pt_PT |
AUSTRALIA_ENGLISH | en_AU |
INDIA_ENGLISH | en_IN |
SWEDEN_SWEDISH | sv_SE |
NORWAY_NORWEGIAN-BOKMAL | nb_NO |
FINLAND_FINISH | fi_FI |
DENMARK_DANISH | da_DK |
Launcher Package Name
Enter the Android Package Name of the Android Application to be made the new Default Launcher/Home Screen.
This would typically be used when installing an new Launcher (Home Screen) Application as a replacement for the existing or default.
Detail Information:
Key = uiLocalizationLauncherPackageName
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
UI Element Configuration
Use this Sub-group to configure Battery Percentage, Battery Swap Popup, Navigation Bar, Status Bar, On-Screen Power Button, Airplane Mode in Power Key Menu, Touch Mode in Power Key Menu, App Info Icon on Long Press on Recent App Header, App Management Notifications, Control Dark Theme, Passwords, Power Off in Power Key Menu, Assistant App, Custom Assistant App, Home Screen Wallpaper, and Custom Home Screen Wallpaper.
Detail Information:
Key = uiElementConfig
Type = bundle
Battery Percentage
Select whether the remaining battery level percentage of the device will be displayed on the Android Status Bar to augment the icon indicating the battery level in bars.
If the value Hide is selected, the remaining battery level percentage of the device will NOT be displayed.
If the value Show is selected, the remaining battery level percentage of the device WILL be displayed.
Detail Information:
Key = uiElementBatteryPercentage
Type = string
UI Choice | JSON Value |
---|---|
Hide | 2 |
Show | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Battery Swap Popup
Select whether the User will be presented with a Battery Swap Popup UI to indicate the recommendation to swap the battery when the remaining battery level percentage of the device drops below a pre-defined, fixed threshold percentage.
If the value Disable is selected, the User will NOT be presented with a Battery Swap Popup UI.
If the value Enable is selected, the User MAY be presented with a Battery Swap Popup UI.
Detail Information:
Key = uiElementBatterySwapPopup
Type = string
UI Choice | JSON Value |
---|---|
Disable | 2 |
Enable | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Navigation Bar
Select whether the Android Navigation Bar will be displayed and hence whether it will take up screen real estate and can be used by the User to navigate the device UI.
If the value Hide is selected, the Android Navigation Bar will NOT be displayed.
If the value Show is selected, the Android Navigation Bar WILL be displayed.
Detail Information:
Key = uiElementNavigationBar
Type = string
UI Choice | JSON Value |
---|---|
Hide | 2 |
Show | 1 |
Status Bar
Select whether the Android Status Bar will be displayed.
- If the value Hide is selected, the Android Status Bar will NOT be displayed.
- If the value Show is selected, the Android Status Bar WILL be displayed.
Detail Information:
Key = uiElementStatusBar
Type = string
UI Choice | JSON Value |
---|---|
Hide | 2 |
Show | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
On-Screen Power Button
Select whether an on-screen power button will be displayed to allow the User to power the device fff.
If the value Disable is selected, an on-screen power button will NOT be displayed.
If the value Enable is selected, an on-screen power button WILL be displayed.
The on-screen power button behaves similarly to the physical power button and can be used to improve the user experience in cases where a physical power button is not present or is not convenient to use, such as when the User is wearing gloves.
Detail Information:
Key = uiElementOnScreenPowerButton
Type = string
UI Choice | JSON Value |
---|---|
Disable | 2 |
Enable | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Airplane Mode in Power Key Menu
Select whether the User will see an option to Control the State of Airplane Mode in the Menu presented when the power key is long pressed.
If the value Show is selected, the User WILL see an option to Control the State of Airplane Mode in the Menu presented when the power key is long pressed.
If the value Hide is selected, the User will NOT see an option to Control the State of Airplane Mode in the Menu presented when the power key is long pressed.
Detail Information:
Key = uiElementAirplaneModeInPwrKeyMenu
Type = string
UI Choice | JSON Value |
---|---|
Hide | 2 |
Show | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Touch Mode in Power Key Menu
Select whether the User will see an option to Control the Touch Mode in the Menu presented when the power key is long pressed.
If the value Show is selected, the User WILL see an option to Control the Touch Mode in the Menu presented when the power key is long pressed.
If the value Hide is selected, the User WILL NOT see an option to Control the Touch Mode in the Menu presented when the power key is long pressed.
Detail Information:
Key = uiElementTouchModeInPwrKeyMenu
Type = string
UI Choice | JSON Value |
---|---|
Hide | 2 |
Show | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
App Info Icon on Long Press on Recent App Header
Select whether the User will be Allowed to navigate to App Info Settings for an application by long pressing on the application icon in the Recent Apps list, and then clicking the (i) icon.
If the value Allow is selected, the User WILL be Allowed to navigate to App Info in this manner.
If the value Disallow is selected, User will NOT be Allowed to navigate to App Info in this manner.
Detail Information:
Key = uiElementAppInfoOnLongPressRecentAppHeader
Type = string
UI Choice | JSON Value |
---|---|
Allow | 1 |
Disallow | 2 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
App Management Notifications
Select whether the User will see notifications when the Device Owner installs, uninstalls or upgrades applications. Applies to Android 11 and later.
If the value Show is selected, notifications WILL be shown to the User when the Device Owner installs, uninstalls, or upgrades applications.
If the value Hide is selected, notifications will NOT be shown to the User when the Device Owner installs, uninstalls, or upgrades applications.
Detail Information:
Key = uiElementSilentAppInstall
Type = string
UI Choice | JSON Value |
---|---|
Show | 1 |
Hide | 2 |
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 10.5.
Control Dark Theme
Select whether dark theme is used on the device.
- If the value Off is selected, dark theme is not used.
- If the value On is selected, dark theme is used.
Detail Information:
Key = uiElementDarkTheme
Type = string
UI Choice | JSON Value |
---|---|
Off | 2 |
On | 1 |
Support Information:
- Supported from: MX 11.3.
Passwords
Select whether the User will be Allowed to see Passwords as they are entered.
- If the value Off is selected, the User will NOT be Allowed to see Passwords as they are entered (Password characters will be masked as they are entered).
- If the value On is selected, the User WILL be Allowed to see Passwords as they are entered (Password characters will be echoed as they are entered).
This can increase usability, by reducing the chance of data entry errors, but should be used with caution since it can also reduce security by allowing Passwords to be disclosed (e.g. Shoulder surfing).
Detail Information:
Key = uiElementPasswords
Type = string
UI Choice | JSON Value |
---|---|
Off | 2 |
On | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Power Off in Power Key Menu
Select whether the User will see an option to Power Off the Device in the Menu presented when the power key is long pressed.
If the value Show is selected, the User WILL see an option to Power Off the Device in the Menu presented when the power key is long pressed.
If the value Hide is selected, the User will NOT see an option to Power Off the Device in the Menu presented when the power key is long pressed.
Detail Information:
Key = uiElementPowerOffInPwrKeyMenu
Type = string
UI Choice | JSON Value |
---|---|
Hide | 2 |
Show | 1 |
Support Information:
- Supported from: MX 10.1.
Assistant App
Select the assistant to use on the device.
- If the value Google Digital Assistant is selected, the Google Digital Assistant will be used
- If the value Custom assistant app is selected, the custom assistant app specified in %?uiConfig.uiGeneralConfig.uiElementConfig.uiElementCustomAssistantApp% will be used.
- If the value None is selected, no assistant app will be used.
Detail Information:
Key = uiElementAssistantApp
Type = string
UI Choice | JSON Value |
---|---|
Google Digital Assistant | 1 |
Custom assistant app | 2 |
None | 3 |
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 10.5.
Custom Assistant App
Enter the package name of the assistant application to be used on the device.
Detail Information:
Key = uiElementCustomAssistantApp
Type = string
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 10.5.
Home Screen Wallpaper
Select the assistant to use on the device.
- If the value Restore to default is selected, the default wallpaper will be used.
- If the value Custom is selected, the custom wallpaper specified in %?uiConfig.uiGeneralConfig.uiElementConfig.uiElementCustomHomeWallpaper% will be used.
Detail Information:
Key = uiElementHomeScreenWallpaper
Type = string
UI Choice | JSON Value |
---|---|
Restore to default | 1 |
Custom | 2 |
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 10.5.
Custom Home Screen Wallpaper
Enter the path and file name of an image file on the device (.jpg or .png)
Detail Information:
Key = uiElementCustomHomeWallpaper
Type = string
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 10.5.
Keyboard Configuration
Use this Sub-group to configure Alert Button, Auto Trigger, External Keyboard, Use of Home, Use of Recent Apps, Virtual KB when Physical KB is Active, Double Trigger, Large Key Indicator, and User Control of Large Key Indicator.
Detail Information:
Key = keyboardConfig
Type = bundle
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Alert Button Configuration
Use this Sub-group to configure State, Key Identifier, Intent Action, Intent Package Name, Intent Class Name, Intent Category, Intent Data URI, Intent File, Intent MIME Type, Intent Extras, Keep Device Awake, and Method.
Detail Information:
Key = alertButtonConfig
Type = bundle
State
Select the state of the Alert Button on a device.
If the value On is selected, then an Intent will be scheduled to be sent each time the Key specified as the Alert Button via Key Identifier is long pressed. You must also specify some or all of the following to define the Intent to be sent (refer to the application receiving the intent for the values to use):
Intent Action
Intent Package Name
Intent Class Name
Intent Category
Intent Data URI
Intent File
Intent MIME Type
Intent Extras
If the value Off is selected, then the sending of any previously configured scheduled Intent will will be canceled.
Detail Information:
Key = uiAlertButtonState
Type = string
UI Choice | JSON Value |
---|---|
On | 2 |
Off | 3 |
Support Information:
- Supported from: MX 10.2.
Key Identifier
Select the Key Identifier of the Key that will be used as the Alert Button.
Detail Information:
Key = uiAlertButtonStateKeyIdentifier
Type = string
UI Choice | JSON Value |
---|---|
0 | 0 |
1 | 1 |
2 | 2 |
3 | 3 |
4 | 4 |
5 | 5 |
6 | 6 |
7 | 7 |
8 | 8 |
9 | 9 |
A | A |
B | B |
C | C |
D | D |
E | E |
F | F |
G | G |
H | H |
I | I |
J | J |
K | K |
L | L |
M | M |
N | N |
O | O |
P | P |
Q | Q |
R | R |
S | S |
T | T |
U | U |
V | V |
W | W |
X | X |
Y | Y |
Z | Z |
.(Period) | DOT |
, (Comma) | COMMA |
(Star) | STAR |
#(Pound) | POUND |
F1 | F1 |
F2 | F2 |
F3 | F3 |
F4 | F4 |
F5 | F5 |
F6 | F6 |
F7 | F7 |
F8 | F8 |
F9 | F9 |
F10 | F10 |
F11 | F11 |
F12 | F12 |
Enter | ENTER |
Up | UP |
Down | DOWN |
Left | LEFT |
Right | RIGHT |
Escape | ESC |
Backspace | BACKSPACE |
Space | SPACE |
Return | RETURN |
Clear | CLR |
Field Exit | FIELD_EXIT |
Alt | ALT |
Control | CTRL |
Shift | SHIFT |
Blue | BLUE |
Orange | ORANGE |
Diamond | DIAMOND |
Green Dot | GREEN |
Red Dot | RED |
Volume Up | VOLUMEUP |
Volume Down | VOLUMEDOWN |
Scan | SCAN |
Grip Trigger | GRIP_TRIGGER |
Grip Trigger 2 | GRIP_TRIGGER_2 |
Button L1 | LEFT_TRIGGER_1 |
Button L2 | LEFT_TRIGGER_2 |
Button R1 | RIGHT_TRIGGER_1 |
Button R2 | RIGHT_TRIGGER_2 |
Left Trigger | LEFT_TRIGGER |
Right Trigger | RIGHT_TRIGGER |
Center Trigger | CENTER_TRIGGER |
Gun Trigger | GUN_TRIGGER |
Headset Button | HEADSET_HOOK |
Back | BACK |
Home | HOME |
Menu | MENU |
Recent | RECENT |
Search | SEARCH |
Keyboard Backlight | KEYLIGHT |
Display Backlight | LAMP |
Power | POWER |
P1 Button | P1 |
P2 Button | P2 |
P3 Button | P3 |
P4 Button | P4 |
P5 Button | P5 |
P6 Button | P6 |
Rear Button | REAR_BUTTON |
Left External Trigger | LEFT_EXTERNAL_TRIGGER |
Right External Trigger | RIGHT_EXTERNAL_TRIGGER |
Touch NAV_PAD | NAV_PAD |
Macro 1 | M1 |
Macro 2 | M2 |
Macro 3 | M3 |
Macro 4 | M4 |
Macro 5 | M5 |
Macro 6 | M6 |
Brightness Up | BRIGHTNESSUP |
Brightness Down | BRIGHTNESSDOWN |
Keyboard | KEYBOARD |
Keyboard Backlight Brightness Up | KEYLIGHTUP |
Keyboard Backlight Brightness Down | KEYLIGHTDOWN |
Support Information:
- Supported from: MX 10.2.
Intent Action
Enter the Android Intent Action to be sent in the Intent that will be sent when the specified Alert Button is long pressed.
Detail Information:
Key = uiAlertButtonStateIntentAction
Type = string
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 10.2.
Intent Package Name
Enter the Android Package Name that identifies the Android Application to which an Intent will be sent when the specified Alert Button is long pressed.
Detail Information:
Key = uiAlertButtonStateIntentPackageName
Type = string
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 10.2.
Intent Class Name
Enter the Android Class to which an Intent will be sent when the specified Alert Button is long pressed.
Detail Information:
Key = uiAlertButtonStateIntentClassName
Type = string
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 10.2.
Intent Category
Enter an Android Intent Category for the Intent that will be sent when the specified Alert Button is long pressed.
A category value is NOT mandatory to specify for an Android Intent. But a category value is commonly used to help identify the purpose of an Android Intent. This can be especially when the application or service to be invoked supports many functions, in which case many action values may be used to identify those functions and it may be useful to categorize those functions. In some cases, the same action value might be supported in more than one category. You will need to consult the documentation or developer of a given application or service to determine whether a category value is needed and, if so, which value will invoke the desired behavior.
Detail Information:
Key = uiAlertButtonStateIntentCategory
Type = string
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 10.2.
Intent Data URI
Enter a Uniform Resource Identifier (URI) that for the Intent that will be sent when the specified Alert Button is long pressed.
The URI specified could reference a local device resource (e.g. a file in the Device File System) or a remote resource (e.g. available via a network).
Detail Information:
Key = uiAlertButtonStateIntentDataUri
Type = string
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 10.2.
Intent File
Enter a Path and File Name for a File stored in the Device File System for the Intent that will be sent when the specified Alert Button is long pressed.
Detail Information:
Key = uiAlertButtonStateIntentFile
Type = string
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 10.2.
Intent MIME Type
Enter a Multipurpose Internet Mail Extensions (MIME) Type for the Intent that will be sent when the specified Alert Button is long pressed.
Detail Information:
Key = uiAlertButtonStateIntentMimeType
Type = string
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 10.2.
Intent Extras
Use this Sub-group to configure Name#1, Type#1, Value#1, Name#2, Type#2, Value#2, Name#3, Type#3, Value#3, Name#4, Type#4, Value#4, Name#5, Type#5, and Value#5 .
Detail Information:
Key = uiAlertButtonStateIntentExtras
Type = bundle
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Name#1
Enter the name of a single extra to be attached to the intent to be sent.
Android allows a collection of extra named values, of various types, to be attached to an intent. When a name is specified, you must also specify Type#1 and Value#1 to provide the corresponding type and value of the extra to be attached to the intent.
Detail Information:
Key = alertButtonExtra1Name
Type = string
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 10.2.
Type#1
Select the type of a single extra to be attached to the intent to be sent.
Android allows a collection of extra named values, of various types, to be attached to an intent. When a type is specified, you must also specify Name#1 and Value#1 to provide the corresponding name and value of the extra to be attached to the intent.
Detail Information:
Key = alertButtonExtra1Type
Type = string
UI Choice | JSON Value |
---|---|
Standard Integer | int |
Character | char |
Character Sequence | charsequence |
Floating Point | float |
Long Integer | long |
Boolean | boolean |
Short | short |
Double Precision Floating Point | double |
String | string |
Single Byte Integer | byte |
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 10.2.
Value#1
Enter the value of a single extra to be attached to the intent to be sent.
Android allows a collection of extra named values, of various types, to be attached to an intent. When a value is specified, you must also specify Type#1 and Name#1 to provide the corresponding type and name of the extra to be attached to the intent.
Detail Information:
Key = alertButtonExtra1Value
Type = string
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 10.2.
Name#2
Enter the name of a single extra to be attached to the intent to be sent.
Android allows a collection of extra named values, of various types, to be attached to an intent. When a name is specified, you must also specify Type#2 and Value#2 to provide the corresponding type and value of the extra to be attached to the intent.
Detail Information:
Key = alertButtonExtra2Name
Type = string
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 10.2.
Type#2
Select the type of a single extra to be attached to the intent to be sent.
Android allows a collection of extra named values, of various types, to be attached to an intent. When a type is specified, you must also specify Name#2 and Value#2 to provide the corresponding name and value of the extra to be attached to the intent.
Detail Information:
Key = alertButtonExtra2Type
Type = string
UI Choice | JSON Value |
---|---|
Standard Integer | int |
Character | char |
Character Sequence | charsequence |
Floating Point | float |
Long Integer | long |
Boolean | boolean |
Short | short |
Double Precision Floating Point | double |
String | string |
Single Byte Integer | byte |
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 10.2.
Value#2
Enter the value of a single extra to be attached to the intent to be sent.
Android allows a collection of extra named values, of various types, to be attached to an intent. When a value is specified, you must also specify Type#2 and Name#2 to provide the corresponding type and name of the extra to be attached to the intent.
Detail Information:
Key = alertButtonExtra2Value
Type = string
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 10.2.
Name#3
Enter the name of a single extra to be attached to the intent to be sent.
Android allows a collection of extra named values, of various types, to be attached to an intent. When a name is specified, you must also specify Type#3 and Value#3 to provide the corresponding type and value of the extra to be attached to the intent.
Detail Information:
Key = alertButtonExtra3Name
Type = string
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 10.2.
Type#3
Select the type of a single extra to be attached to the intent to be sent.
Android allows a collection of extra named values, of various types, to be attached to an intent. When a type is specified, you must also specify Name#3 and Value#3 to provide the corresponding name and value of the extra to be attached to the intent.
Detail Information:
Key = alertButtonExtra3Type
Type = string
UI Choice | JSON Value |
---|---|
Standard Integer | int |
Character | char |
Character Sequence | charsequence |
Floating Point | float |
Long Integer | long |
Boolean | boolean |
Short | short |
Double Precision Floating Point | double |
String | string |
Single Byte Integer | byte |
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 10.2.
Value#3
Enter the value of a single extra to be attached to the intent to be sent.
Android allows a collection of extra named values, of various types, to be attached to an intent. When a value is specified, you must also specify Type#3 and Name#3 to provide the corresponding type and name of the extra to be attached to the intent.
Detail Information:
Key = alertButtonExtra3Value
Type = string
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 10.2.
Name#4
Enter the name of a single extra to be attached to the intent to be sent.
Android allows a collection of extra named values, of various types, to be attached to an intent. When a name is specified, you must also specify Type#4 and Value#4 to provide the corresponding type and value of the extra to be attached to the intent.
Detail Information:
Key = alertButtonExtra4Name
Type = string
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 10.2.
Type#4
Select the type of a single extra to be attached to the intent to be sent.
Android allows a collection of extra named values, of various types, to be attached to an intent. When a type is specified, you must also specify Name#4 and Value#4 to provide the corresponding name and value of the extra to be attached to the intent.
Detail Information:
Key = alertButtonExtra4Type
Type = string
UI Choice | JSON Value |
---|---|
Standard Integer | int |
Character | char |
Character Sequence | charsequence |
Floating Point | float |
Long Integer | long |
Boolean | boolean |
Short | short |
Double Precision Floating Point | double |
String | string |
Single Byte Integer | byte |
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 10.2.
Value#4
Enter the value of a single extra to be attached to the intent to be sent.
Android allows a collection of extra named values, of various types, to be attached to an intent. When a value is specified, you must also specify Type#4 and Name#4 to provide the corresponding type and name of the extra to be attached to the intent.
Detail Information:
Key = alertButtonExtra4Value
Type = string
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 10.2.
Name#5
Enter the name of a single extra to be attached to the intent to be sent.
Android allows a collection of extra named values, of various types, to be attached to an intent. When a name is specified, you must also specify Type#4 and Value#4 to provide the corresponding type and value of the extra to be attached to the intent.
Detail Information:
Key = alertButtonExtra5Name
Type = string
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 10.2.
Type#5
Select the type of a single extra to be attached to the intent to be sent.
Android allows a collection of extra named values, of various types, to be attached to an intent. When a type is specified, you must also specify Name#5 and Value#5 to provide the corresponding name and value of the extra to be attached to the intent.
Detail Information:
Key = alertButtonExtra5Type
Type = string
UI Choice | JSON Value |
---|---|
Standard Integer | int |
Character | char |
Character Sequence | charsequence |
Floating Point | float |
Long Integer | long |
Boolean | boolean |
Short | short |
Double Precision Floating Point | double |
String | string |
Single Byte Integer | byte |
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 10.2.
Value#5
Enter the value of a single extra to be attached to the intent to be sent.
Android allows a collection of extra named values, of various types, to be attached to an intent. When a value is specified, you must also specify Type#5 and Name#5 to provide the corresponding type and name of the extra to be attached to the intent.
Detail Information:
Key = alertButtonExtra5Value
Type = string
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 10.2.
Keep Device Awake
Select whether the device should stay awake when the Alert Button is configured.
Detail Information:
Key = uiAlertButtonStateKeepAwake
Type = boolean
Support Information:
- Supported from: MX 10.2.
Method
Select the Method by which the Intent will be sent when the Alert Button is pressed, when the value of On is selected for State.
Detail Information:
Key = uiAlertButtonStateMethod
Type = string
UI Choice | JSON Value |
---|---|
StartActivity | StartActivity |
StartService | StartService |
Broadcast | Broadcast |
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 10.2.
Auto Trigger Configuration
Use this Sub-group to configure State and Range.
Detail Information:
Key = autoTriggerConfig
Type = bundle
Support Information:
- NOT supported on Device(s): TC20 and TC25.
State
Select whether and how Automatic Triggering will occur.
If the value Off is selected, Automatic Triggering will never occur and the User will be required to manually initiate trigger-activated functions.
If the value Auto On is selected, Automatic Triggering may occur if the device is placed into a suitable holster, holder, or stand allowing the User to initiate trigger-activated functions simply by bringing an object within proximity to the device sensor.
If the value Always On is selected, automatic triggering can always occur automatically , whether the device is placed into a suitable holster, holder, or stand allowing the User to initiate trigger-activated functions simply by bringing an object within proximity to the device sensor.
Detail Information:
Key = uiAutoTriggerState
Type = string
UI Choice | JSON Value |
---|---|
Off | 0 |
Auto On | 1 |
Always On | 2 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Range
Select the range at which automatic triggering will detect the presence of an object and initiate automatic triggering.
If the value Near is selected, automatic triggering will occur only when an object is brought within near proximity to the device sensor. This may be desirable if the device is being worn in a holster and hence it is convenient to bring objects very close to the device sensor.
If the value Far is selected, automatic triggering will occur when an object is brought within less near proximity to the device sensor. This may be desirable if the device is located in a stand or holder and hence it is less convenient to have to bring objects very close to the device sensor.
Detail Information:
Key = uiAutoTriggerRange
Type = string
UI Choice | JSON Value |
---|---|
Near | 0 |
Far | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
External Keyboard Configuration
Use this Sub-group to configure Action, Add/Replace Keyboard Name, Keyboard Name, and Layout Name.
Detail Information:
Key = uiExternalKeyboardConfig
Type = bundle
Action
Select the External Keyboard Layout Mapping action to take.
- If the value Add/Replace Keyboard Layout Mapping is selected, the external keyboard layout specified in @@uiConfig.keyboardConfig.uiExternalKeyboardConfig.uiEKCLayout will be added or replaced for the keyboard name
- If the value Remove Keyboard Layout Mapping is selected, the external keyboard layout associated with the keyboard name specified via Keyboard Name will be removed.
- If the value Remove All Keyboard Layout Mappings is selected, all external keyboard layouts will be removed.
Detail Information:
Key = uiEKCAction
Type = string
UI Choice | JSON Value |
---|---|
Add/Replace Keyboard Layout Mapping | 1 |
Remove Keyboard Layout Mapping | 2 |
Remove All Keyboard Layout Mappings | 3 |
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 10.5.
Add/Replace Keyboard Name
Enter the external keyboard name to associate the layout being added or replaced. This item is optional.
Detail Information:
Key = uiEKCOptionalName
Type = string
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 10.5.
Keyboard Name
Select the keyboard name to associate the layout being defined.
Detail Information:
Key = uiEKCName
Type = string
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 10.5.
Layout Name
Select the keyboard layout name being defined.
Detail Information:
Key = uiEKCLayoutName
Type = string
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 10.5.
Use of Home
Select whether the User will be Allowed to utilize the Home Key on a device to leave the current context and return to the Home/Launcher screen.
- If the value Disallow is selected, the User will NOT be Allowed to utilize the Home Key.
- If the value Allow is selected, the User WILL be Allowed to utilize the Home Key.
Detail Information:
Key = keyboardUseOfHome
Type = string
UI Choice | JSON Value |
---|---|
Disallow | 2 |
Allow | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Use of Recent Apps
Select whether the User will be Allowed to Use the Recent Apps Key to access recently launched applications.
- If the value Disallow is selected, the User will NOT be Allowed to Use the Recent Apps Key to access recently launched applications.
- If the value Allow is selected, the User WILL be Allowed to Use the Recent Apps Key to access recently launched applications.
Detail Information:
Key = keyboardUseOfRecentApps
Type = string
UI Choice | JSON Value |
---|---|
Disallow | 2 |
Allow | 1 |
Virtual KB when Physical KB is Active
Select whether the on-screen Virtual Keyboard will be shown when the Physical Keyboard is Active.
- If the value Hide is selected, the on-screen Virtual Keyboard will NOT be shown when the Physical Keyboard is Active.
- If the value Show is selected, the on-screen Virtual Keyboard WILL be shown when the Physical Keyboard is Active.
This can help avoid the annoyance and confusion of using up screen real-estate to display an on-screen keyboard when the User is using a Physical Keyboard to enter data.
Detail Information:
Key = keyboardShowVirtualKbWhenPhysicalKbActive
Type = string
UI Choice | JSON Value |
---|---|
Hide | 2 |
Show | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Double Trigger
Use this Sub-group to configure Maximum Time Between Trigger Pulls, Mode, Alt State, Ctrl State, Fn State, Key Code, and Shift State.
Detail Information:
Key = doubleTrigger
Type = bundle
Maximum Time Between Trigger Pulls
Enter the maximum time allowed for a double trigger pull to be considered in milliseconds.
Detail Information:
Key = dtMaxTime
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Mode
Select whether a double trigger will send a key code.
- if Send a key-code is selected, a double trigger pull within the window specified by Maximum Time Between Trigger Pulls will cause the key code specified in Key Code to be sent.
- if Don't send a key-code is selected, a double trigger pull will not send a key code.
Detail Information:
Key = dtMode
Type = string
UI Choice | JSON Value |
---|---|
Send a key-code | 1 |
Don't send a key-code | 2 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Alt State
Select whether the Key Code specified via Key Code will be sent with the Alt keyboard state.
- If the value Off is selected, when the Key Code is sent, it will NOT be sent with the Alt keyboard state NOT set. This will ensure that the Key Code will NOT interpreted as an Alt key.
- If the value On is selected, when the Key Code is sent, it WILL be sent with the Alt keyboard state set. This will ensure that the Key Code WILL be interpreted as an Alt key.
- If no value is specified, when the Key Code is sent, it will be sent with the CURRENT Alt key state. This will cause the Key Code to be interpreted as an Alt key or not based on the current Alt key state.
Detail Information:
Key = dtAltState
Type = string
UI Choice | JSON Value |
---|---|
On | 1 |
Off | 0 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Ctrl State
Select whether the Key Code specified via Key Code will be sent with the Ctrl keyboard state when it is sent as the Behavior for a specified Key.
- If the value Off is selected, when the Key Code is sent, it will NOT be sent with the Ctrl keyboard state NOT set. This will ensure that the Key Code will NOT interpreted as an Ctrl key.
- If the value On is selected, when the Key Code is sent, it WILL be sent with the Ctrl keyboard state set. This will ensure that the Key Code WILL be interpreted as an Ctrl key.
- If no value is specified, when the Key Code is sent, it will be sent with the CURRENT Ctrl key state. This will cause the Key Code to be interpreted as an Ctrl key or not based on the current Ctrl key state.
Detail Information:
Key = dtCtrlState
Type = string
UI Choice | JSON Value |
---|---|
On | 1 |
Off | 0 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Fn State
Select whether the Key Code specified via Key Code will be sent with the Fn keyboard state when it is sent as the Behavior for a specified Key.
- If the value Off is selected, when the Key Code is sent, it will NOT be sent with the Fn keyboard state NOT set. This will ensure that the Key Code will NOT interpreted as an Fn key.
- If the value On is selected, when the Key Code is sent, it WILL be sent with the Fn keyboard state set. This will ensure that the Key Code WILL be interpreted as an Fn key.
- If no value is specified, when the Key Code is sent, it will be sent with the CURRENT Fn key state. This will cause the Key Code to be interpreted as an Fn key or not based on the current Fn key state.
Detail Information:
Key = dtFnState
Type = string
UI Choice | JSON Value |
---|---|
On | 1 |
Off | 0 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Key Code
Select the key code to send when Send a key-code is set to Mode and a double trigger is performed.
Detail Information:
Key = dtScanCode
Type = string
UI Choice | JSON Value |
---|---|
0 | 7 |
1 | 8 |
2 | 9 |
3 | 10 |
4 | 11 |
5 | 12 |
6 | 13 |
7 | 14 |
8 | 15 |
9 | 16 |
+ (Plus) | 81 |
- (Minus) | 69 |
= (Equals) | 70 |
( (Left Bracket) | 71 |
) (Right Bracket) | 72 |
` (Grave) | 68 |
/ (Slash) | 76 |
\\\\ (Backslash) | 73 |
; (Semicolon) | 74 |
' (Apostrophe) | 75 |
, (Comma) | 55 |
. (Period) | 56 |
(Star) | 17 |
# (Pound) | 18 |
@ (At) | 77 |
A | 29 |
B | 30 |
C | 31 |
D | 32 |
E | 33 |
F | 34 |
G | 35 |
H | 36 |
I | 37 |
J | 38 |
K | 39 |
L | 40 |
M | 41 |
N | 42 |
O | 43 |
P | 44 |
Q | 45 |
R | 46 |
S | 47 |
T | 48 |
U | 49 |
V | 50 |
W | 51 |
X | 52 |
Y | 53 |
Z | 54 |
Enter | 66 |
Tab | 61 |
Space | 62 |
Escape | 111 |
Delete | 67 |
F1 | 131 |
F2 | 132 |
F3 | 133 |
F4 | 134 |
F5 | 135 |
F6 | 136 |
F7 | 137 |
F8 | 138 |
F9 | 139 |
F10 | 140 |
F11 | 141 |
F12 | 142 |
NUMPAD 0 | 144 |
NUMPAD 1 | 145 |
NUMPAD 2 | 146 |
NUMPAD 3 | 147 |
NUMPAD 4 | 148 |
NUMPAD 5 | 149 |
NUMPAD 6 | 150 |
NUMPAD 7 | 151 |
NUMPAD 8 | 152 |
NUMPAD 9 | 153 |
NUMPAD / (NUMPAD Divide) | 154 |
NUMPAD * (NUMPAD Multiply) | 155 |
NUMPAD - (NUMPAD Subtract) | 156 |
NUMPAD + (NUMPAD Add) | 157 |
NUMPAD . (NUMPAD Period) | 158 |
NUMPAD , (NUMPAD Comma) | 159 |
NUMPAD Enter | 160 |
NUMPAD = (NUMPAD Equals) | 161 |
NUMPAD { (NUMPAD Left Parenthesis) | 162 |
NUMPAD } (NUMPAD Right Parenthesis) | 163 |
DPAD Up | 19 |
DPAD Down | 20 |
DPAD Left | 21 |
DPAD Right | 22 |
DPAD Center | 23 |
Move Home | 122 |
Move End | 123 |
Page Up | 92 |
Page Down | 93 |
Insert | 124 |
Forward Delete | 112 |
Clear | 28 |
Lamp | 10024 |
Do Nothing | 10026 |
Blue | 10027 |
Orange | 10028 |
Grey | 10029 |
Diamond | 10039 |
Alt | 10030 |
Control | 10031 |
Shift | 10032 |
Keyboard | 10034 |
Touch Calibrate | 10035 |
Scan | 10036 |
Search Key | 10037 |
None | 10038 |
KeyLight | 10025 |
Keylight Up | 10040 |
Keylight Down | 10041 |
Left Shift | 59 |
Right Shift | 60 |
Left Alt | 57 |
Right Alt | 58 |
Left Control | 113 |
Right Control | 114 |
Meta Left | 117 |
Meta Right | 118 |
Caps Lock | 115 |
Num Lock | 143 |
Scroll Lock | 116 |
SysRq | 120 |
Break | 121 |
Function | 119 |
Back | 4 |
Forward | 125 |
Home | 3 |
Menu | 82 |
Settings | 176 |
Application Switch | 187 |
Calculator | 210 |
Explorer | 64 |
Envelope | 65 |
Bookmark | 174 |
Music | 209 |
Call | 5 |
End Call | 6 |
Microphone Mute | 91 |
Camera | 27 |
Search | 84 |
Contacts | 207 |
Calendar | 208 |
Volume Up | 24 |
Volume Down | 25 |
Volume Mute | 164 |
Brightness Up | 221 |
Brightness Down | 220 |
Power | 26 |
Sleep | 223 |
Wakeup | 224 |
Headset | 79 |
Push-to-talk | 228 |
Camera Focus | 80 |
Media Play/Pause | 85 |
Media Stop | 86 |
Media Next | 87 |
Media Previous | 88 |
Media Rewind | 89 |
Media Fast-Forward | 90 |
Media Play | 126 |
Media Pause | 127 |
Media Close | 128 |
Media Eject | 129 |
Media Record | 130 |
Button L1 | 102 |
Button R1 | 103 |
Button L2 | 104 |
Button R2 | 105 |
Button A | 96 |
Button B | 97 |
Button C | 98 |
Button X | 99 |
Button Y | 100 |
Button Z | 101 |
Left Thumb Button | 106 |
Right Thumb Button | 107 |
Start Button | 108 |
Select Button | 109 |
Mode Button | 110 |
Gamepad Button 1 | 188 |
Gamepad Button 2 | 189 |
Gamepad Button 3 | 190 |
Gamepad Button 4 | 191 |
Gamepad Button 5 | 192 |
Gamepad Button 6 | 193 |
Gamepad Button 7 | 194 |
Gamepad Button 8 | 195 |
Gamepad Button 9 | 196 |
Gamepad Button 10 | 197 |
Gamepad Button 11 | 198 |
Gamepad Button 12 | 199 |
Gamepad Button 13 | 200 |
Gamepad Button 14 | 201 |
Gamepad Button 15 | 202 |
Gamepad Button 16 | 203 |
Zenkaku/Hankaku | 211 |
Eisu | 212 |
Muhenkan | 213 |
Henkan | 214 |
Katakana/Hiragana | 215 |
Ro | 217 |
Yen | 216 |
Kana | 218 |
Keyboard | 10034 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Shift State
Select whether the Key Code specified via Key Code will be sent with the Shift keyboard state when it is sent as the Behavior for a specified Key.
- If the value Off is selected, when the Key Code is sent, it will NOT be sent with the Shift keyboard state NOT set. This will ensure that the Key Code will NOT interpreted as an Shift key.
- If the value On is selected, when the Key Code is sent, it WILL be sent with the Shift keyboard state set. This will ensure that the Key Code WILL be interpreted as an Shift key.
- If no value is specified, when the Key Code is sent, it will be sent with the CURRENT Shift key state. This will cause the Key Code to be interpreted as an Shift key or not based on the current Shift key state.
Detail Information:
Key = dtShiftState
Type = string
UI Choice | JSON Value |
---|---|
On | 1 |
Off | 0 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Large Key Indicator
Select whether the Large Key Indicator will be displayed to indicate the state physical keypad.
- If the value Hide is selected, the Large Key Indicator will NOT be displayed.
- If the value Show is selected, the Large Key Indicator WILL be displayed.
This can assist the User in cases where multiple key sequences are required.
Detail Information:
Key = keyboardLargeKeyIndicator
Type = string
UI Choice | JSON Value |
---|---|
Hide | 2 |
Show | 1 |
User Control of Large Key Indicator
Select whether the User will be Allowed to control whether the Large Key Indicator will be displayed.
- If the value Enable is selected, the User will NOT be Allowed to control whether the Large Key Indicator will be displayed.
- If the value Disable is selected, the User WILL be Allowed to control whether the Large Key Indicator will be displayed.
Detail Information:
Key = keyboardUserControlOfLargeKeyIndicator
Type = string
UI Choice | JSON Value |
---|---|
Enable | 1 |
Disable | 2 |
Settings UI Configuration
Use this Sub-group to configure Quick Settings, User Access, User Control, Icon, and Settings Variant.
Detail Information:
Key = uiSettingsConfig
Type = bundle
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 4.3.
Quick Settings
Use this Sub-array to configure one or more Quick Setting(s).
Detail Information:
Key = uiQuickSettings
Type = bundle_array
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 11.2.
Quick Setting
Use this Sub-group to configure Quick Tile Custom Identifier, Quick Tile Identifier, and Quick Tile State.
Detail Information:
Key = uiQSQuickSetting
Type = bundle
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 11.2.
Quick Tile Custom Identifier
Enter the name of the custom Quick Setting tile to show/hide on the device
Detail Information:
Key = uiQSTileCustomIdentifier
Type = string
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 11.2.
Quick Tile Identifier
Select the action to show/hide a specific Quick Settings tile on the device.
If the value Airplane mode is selected, the Airplane mode Quick Settings Tile will be shown or hidden
If the value Auto-rotate is selected, the Auto-rotate Quick Settings Tile will be shown or hidden
If the value Battery Saver is selected, the Battery Saver Quick Settings Tile will be shown or hidden
If the value Bedtime mode is selected, the Bedtime mode Quick Settings Tile will be shown or hidden
If the value Bluetooth is selected, the Bluetooth Quick Settings Tile will be shown or hidden
If the value Dark theme is selected, the Dark theme Quick Settings Tile will be shown or hidden
If the value Data Saver is selected, the Data Saver Quick Settings Tile will be shown or hidden
If the value Do Not Disturb is selected, the Do Not Disturb Quick Settings Tile will be shown or hidden
If the value Dump SysUI Heap is selected, the Dump SysUI Heap Quick Settings Tile will be shown or hidden
If the value Flashlight is selected, the Flashlight Quick Settings Tile will be shown or hidden
If the value Focus mode is selected, the Focus mode Quick Settings Tile will be shown or hidden
If the value Hotspot is selected, the Hotspot Quick Settings Tile will be shown or hidden
If the value Invert colors is selected, the Invert colors Quick Settings Tile will be shown or hidden
If the value Location is selected, the Location Quick Settings Tile will be shown or hidden
If the value Mobile data is selected, the Mobile data Quick Settings Tile will be shown or hidden
If the value NFC is selected, the NFC Quick Settings Tile will be shown or hidden
If the value Nearby Share is selected, the Nearby Share Quick Settings Tile will be shown or hidden
If the value Night Light is selected, the Night Light Quick Settings Tile will be shown or hidden
If the value Screen Cast is selected, the Screen Cast Quick Settings Tile will be shown or hidden
If the value Screen Record is selected, the Screen Record Quick Settings Tile will be shown or hidden
If the value Wi-Fi is selected, the Wi-Fi Quick Settings Tile will be shown or hidden
If the value Custom is selected, a name of the custom Quick Settings Tile must be entered to be shown or hidden
Detail Information:
Key = uiQSTileIdentifier
Type = string
UI Choice | JSON Value |
---|---|
Airplane mode | Airplane mode |
Auto-rotate | Auto-rotate |
Battery Saver | Battery Saver |
Bedtime mode | Bedtime mode |
Bluetooth | Bluetooth |
Dark theme | Dark theme |
Data Saver | Data Saver |
Do Not Disturb | Do Not Disturb |
Dump SysUI Heap | Dump SysUI Heap |
Flashlight | Flashlight |
Focus mode | Focus mode |
Hotspot | Hotspot |
Invert colors | Invert colors |
Location | Location |
Mobile data | Mobile data |
NFC | NFC |
Nearby Share | Nearby Share |
Night Light | Night Light |
Screen Cast | Screen Cast |
Screen Record | Screen Record |
Wi-Fi | Wi-Fi |
Custom | Custom |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Quick Tile State
Select the action to show/hide Quick Settings tiles on the device.
If the value Hide is selected, an individual Quick Tile will be hidden in Quick Settings.
If the value Show is selected, an individual Quick Tile will be shown in Quick Settings.
Detail Information:
Key = uiQSTileState
Type = string
UI Choice | JSON Value |
---|---|
Show | 3 |
Hide | 4 |
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 11.2.
User Access Configuration
Use this Sub-group to configure Split Screen Mode, Multi User, App Info Section, Control Default Apps, Control Vibrate for Calls, Device Storage via USB, Notification Settings from Notification, Quick Settings, Settings Via Notification Icon, Settings via Slide Out Drawer, Tethering and Hotspot Section, and WLAN Section.
Detail Information:
Key = uiUserAccessConfig
Type = bundle
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Split Screen Mode
Select whether the User will be Allowed to Access Split Screen Mode.
- If the value Disallow is selected, the User will NOT be Allowed to Access Split Screen Mode.
- If the value Allow is selected, the User WILL be Allowed to Access Split Screen Mode.
Detail Information:
Key = uiUserAccessSplitScreenMode
Type = string
UI Choice | JSON Value |
---|---|
Disallow | 2 |
Allow | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Multi User
Select whether the Primary User will be Allowed to Access the Multi User Section of the Settings UI, which provides the ability to Create, Delete, and limit the actions of Secondary Users.
- If the value Disallow is selected, the Primary User will NOT be Allowed to Access the Multi User Section of the Settings UI.
- If the value Allow is selected, the Primary User WILL be Allowed to Access the Multi User Section of the Settings UI.
Detail Information:
Key = uiUserAccessMultiUser
Type = string
UI Choice | JSON Value |
---|---|
Disallow | 2 |
Allow | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
App Info Section
Select whether the User will be allowed to Access the App Info section of the Settings UI.
- If the value Disallow is selected, the User will NOT be allowed to Access the App Info section of the Settings UI.
- If the value Allow is selected, the User WILL be allowed to Access the App Info section of the Settings UI.
Detail Information:
Key = uiUserAccessAppInfoSection
Type = string
UI Choice | JSON Value |
---|---|
Disallow | 2 |
Allow | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Control Default Apps
Select whether the device user will be allowed to change the Default App used for standard functionality
- If the value Disable for Dialer is selected, the device user will not be allowed to change the default dialer.
- If the value Enable for Dialer is selected, the device user will be allowed to change the default dialer.
Detail Information:
Key = uiUserControlDefaultApps
Type = string
UI Choice | JSON Value |
---|---|
Enable for Dialer | 1 |
Disable for Dialer | 2 |
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 11.4.
Control Vibrate for Calls
Select whether the device user will be allowed to change the state of the vibrate for calls setting.
- If the value Disable is selected, the device user will not be allowed to change the state of vibrate for calls.
- If the value Enable is selected, the device user will be allowed to change the state of vibrate for calls.
Detail Information:
Key = uiUserControlVibrateForCallsUsage
Type = string
UI Choice | JSON Value |
---|---|
Enable | 1 |
Disable | 2 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Device Storage via USB
Select whether the User will be allowed to Access Device Storage via USB.
- If the value Disable is selected, the User will NOT be allowed to Access Device Storage via USB.
- If the value Enable is selected, the User WILL be allowed to Access Device Storage via USB.
Detail Information:
Key = uiUserAccessDeviceStorageViaUsb
Type = string
UI Choice | JSON Value |
---|---|
Disable | 2 |
Enable | 1 |
Notification Settings from Notification
Select whether the User will be permitted to Access Notification Settings via a Notification in the Notification Panel.
- If the value Disallow is selected, the User will NOT be Allowed to Access Notification Settings via a Notification in the Notification Panel.
- If the value Allow is selected, the User WILL be Allowed to Access Notification Settings via a Notification in the Notification Panel.
Detail Information:
Key = uiUserAccessNotificationSettingsFromNotification
Type = string
UI Choice | JSON Value |
---|---|
Disallow | 2 |
Allow | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Quick Settings
Select whether the User will be permitted to Access the Quick Settings UI.
If the value Disallow is selected, any attempt by the User to enter the Quick Settings Panel will be ignored.
If the value Allow is selected, attempts by the User to enter the Quick Settings Panel will be honored and the Quick Settings Panel UI will be presented on request.
Detail Information:
Key = uiUserAccessToQuickSettings
Type = string
UI Choice | JSON Value |
---|---|
Disallow | 2 |
Allow | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Settings Via Notification Icon
Select whether the User will be Allowed to Access the Settings UI via the Settings (Gear) Icon on the Notification Panel.
- If the value Disallow is selected, the User will NOT be Allowed to Access the Settings UI via the Settings (Gear) Icon on the Notification Panel.
- If the value Allow is selected, the User WILL be Allowed to Access the Settings UI via the Settings (Gear) Icon on the Notification Panel.
Detail Information:
Key = uiUserAccessSettingsViaNotificationIcon
Type = string
UI Choice | JSON Value |
---|---|
Disallow | 2 |
Allow | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Settings via Slide Out Drawer
Select whether the User will be Allowed to Access other Settings pages within the Settings UI via the Slide Out Drawer.
- If the value Disallow is selected, the User will NOT be Allowed to Access other Settings pages within the Settings UI via the Slide Out Drawer.
- If the value Allow is selected, the User WILL be Allowed to Access other Settings pages within the Settings UI via the Slide Out Drawer.
Detail Information:
Key = uiUserAccessSettingsViaSlideOutDrawer
Type = string
UI Choice | JSON Value |
---|---|
Disallow | 2 |
Allow | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Tethering and Hotspot Section
Select whether the User will be Allowed to Access Tethering and Hotspot Section of the Settings UI.
- If the value Disallow is selected, the User will NOT be Allowed to Access Tethering and Hotspot Section of the Settings UI.
- If the value Allow is selected, the User WILL be Allowed to Access Tethering and Hotspot Section of the Settings UI.
Detail Information:
Key = uiUserAccessTetheringAndPortableHotspot
Type = string
UI Choice | JSON Value |
---|---|
Disallow | 2 |
Allow | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
WLAN Section
Select whether the User will be Allowed to Access the WLAN section of the Settings UI.
- If the value Disallow is selected, the User will NOT be Allowed to Access the WLAN section of the Settings UI.
- If the value Allow is selected, the User WILL be Allowed to Access the WLAN section of the Settings UI.
Detail Information:
Key = uiUserAccessWlanSection
Type = string
UI Choice | JSON Value |
---|---|
Disallow | 2 |
Allow | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
User Control Configuration
Use this Sub-group to configure Do Not Disturb Mode, UI Configuration - Settings UI Configuration - Configure Default Client Mode, Airplane Mode, Background Data, Edit Quick Settings, Erase All Data, Ethernet State, Instant Lock, Unknown Sources, and USB State.
Detail Information:
Key = uiUserControlConfig
Type = bundle
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Do Not Disturb Mode
Select whether the User will be Allowed to Control the State of Do Not Disturb Mode.
- If the value Show is selected, the User will NOT be Allowed to Control the State of Do Not Disturb Mode.
- If the value Hide is selected, the User WILL be Allowed to Control the State of Do Not Disturb Mode.
Detail Information:
Key = uiUserControlDoNotDisturb
Type = string
UI Choice | JSON Value |
---|---|
Hide | 2 |
Show | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
UI Configuration - Settings UI Configuration - Configure Default Client Mode
Select the default configuration of an attached USB client.
- If the value Charging Only (no data transfer) is selected, "Charging Only" will be the default mode for client USB devices.
- If the value File Transfer is selected, "File Transfer" will be the default mode for client USB devices.
- If the value MIDI is selected, "MIDI" will be the default mode for client USB devices.
- If the value PTP is selected, "PTP" will be the default mode for client USB devices.
- If the value USB Tethering is selected, "USB Tethering" will be the default mode for client USB devices.
Detail Information:
Key = settingsUsbClientModeDefault
Type = string
UI Choice | JSON Value |
---|---|
Charging Only (no data transfer) | 0L |
File Transfer | 4L |
MIDI | 8L |
PTP | 16L |
USB Tethering | 32L |
Support Information:
- Supported from: MX 10.4.
Airplane Mode
Select whether the User will be Allowed to change the State of Airplane Mode.
- If the value Disallow is selected, the User will NOT be Allowed to change the State of Airplane Mode.
- If the value Allow is selected, the User WILL be Allowed to change the State of Airplane Mode.
Detail Information:
Key = uiUserControlOfAirplaneMode
Type = string
UI Choice | JSON Value |
---|---|
Disallow | 2 |
Allow | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Background Data
Select whether the User will be Allowed to change the usage of Background WWAN data.
- If the value Disallow is selected, the User will NOT be Allowed to change the usage of Background WWAN data.
- If the value Allow is selected, the User WILL be Allowed to change the usage of Background WWAN data.
Detail Information:
Key = uiUserControlBackgroundData
Type = string
UI Choice | JSON Value |
---|---|
Disallow | 2 |
Allow | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Edit Quick Settings
Select whether the User will be Allowed to edit the quick settings panel.
- If the value Disallow is selected, the User will NOT be Allowed to edit the Quick Settings Panel.
- If the value Allow is selected, the User WILL be Allowed to edit the Quick Settings Panel.
Detail Information:
Key = uiUserControlEditQuickSettings
Type = string
UI Choice | JSON Value |
---|---|
Disallow | 2 |
Allow | 1 |
Erase All Data
Select whether the User will be Allowed to Erase All Data (perform an Enterprise Reset) from the Settings UI.
- If the value Disallow is selected, the User will NOT be Allowed to Erase All Data (perform an Enterprise Reset) from the Settings UI.
- If the value Allow is selected, the User WILL be Allowed to Erase All Data (perform an Enterprise Reset) from the Settings UI.
Detail Information:
Key = uiUserControlEnterpriseReset
Type = string
UI Choice | JSON Value |
---|---|
Disallow | 2 |
Allow | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Ethernet State
Select whether the User will be Allowed to control the Ethernet State.
- If the value Disallow is selected, the User will NOT be Allowed to control the Ethernet State.
- If the value Allow is selected, the User WILL be Allowed to control the Ethernet State.
Detail Information:
Key = uiUserControlEthernet
Type = string
UI Choice | JSON Value |
---|---|
Disallow | 2 |
Allow | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Instant Lock
Select whether the User will be Allowed to control Instant Lock on Power Key.
- If the value Disallow is selected, the User will NOT be Allowed to control Instant Lock on Power Key.
- If the value Allow is selected, the User WILL be Allowed to control Instant Lock on Power Key.
Detail Information:
Key = uiUserControlInstantLock
Type = string
UI Choice | JSON Value |
---|---|
Disallow | 2 |
Allow | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Unknown Sources
Select whether the User will be Allowed to control Unknown Sources,
- If the value Disallow is selected, the User will NOT be Allowed to control Unknown Sources,
- If the value Allow is selected, the User WILL be Allowed to control Unknown Sources,
Detail Information:
Key = uiUserControlUnknownSources
Type = string
UI Choice | JSON Value |
---|---|
Disallow | 2 |
Allow | 1 |
Support Information:
Supported on Operating System(s): Nougat.
NOT supported on Device(s): TC20 and TC25.
Support discontinued from: MX 9.0.
USB State
Select whether the User will be Allowed to control the USB Power State.
- If the value Disallow is selected, the User will NOT be Allowed to control the USB Power State.
- If the value Allow is selected, the User WILL be Allowed to control the USB Power State.
Detail Information:
Key = uiUserControlUsbState
Type = string
UI Choice | JSON Value |
---|---|
Disallow | 2 |
Allow | 1 |
Icon
Select whether the Quick Settings Icon will be displayed to the User.
- If the value Hide is selected, the Quick Settings Icon will NOT be displayed to the User.
- If the value Show is selected, the Quick Settings Icon WILL be displayed to the User.
Detail Information:
Key = uiQuickSettingsIcon
Type = string
UI Choice | JSON Value |
---|---|
Hide | 2 |
Show | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Settings Variant
Select which variant of the Settings Ul (Reduced or Full) will be used.
- If the value Partial is selected, the Reduced variant of the Settings Ul will be used.
- If the value Full is selected, the Full variant of the Settings Ul will be used.
Detail Information:
Key = uiSettingsVariant
Type = string
UI Choice | JSON Value |
---|---|
Full | 1 |
Partial | 2 |
None | 3 |
Touch Panel Configuration
Use this Sub-group to configure Touch Mode and Screen Protector.
Detail Information:
Key = uiTouchPanelConfig
Type = bundle
Touch Mode
Select the Touch Panel to be used.
If the value Stylus or Finger is selected, the Touch Panel will be configured to optimize use with a Stylus or an ungloved Finger.
If the value Glove or Finger is selected, the Touch Panel will be configured to optimize use with a Gloved finger or an ungloved Finger.
If the value Finger Only is selected, the Touch Panel will be configured to optimize an ungloved Finger.
If the value Stylus or Glove or Finger is selected, the Touch Panel will be configured to optimize use with a Stylus, a Gloved finger, or an ungloved Finger.
If the value Finger and Wet is selected, the Touch Panel will be configured to optimize use with a finger on a wet touch panel
Not all devices support the ability to configure the Touch Panel mode and those that do may not support every mode.
An attempt to configure the Touch Panel mode on a device that does not support it will result in an error.
An attempt to configure a Touch Panel mode on a device that does not support that mode will result in an error.
Detail Information:
Key = touchMode
Type = string
UI Choice | JSON Value |
---|---|
Stylus or Finger | Stylus and Finger |
Glove or Finger | Glove and Finger |
Finger Only | Finger |
Stylus or Glove or Finger | Stylus and Glove and Finger |
Finger and Wet | Finger and Wet |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Screen Protector
Select whether the Touch Panel configuration will be optimized for use with a Screen Protector.
If selected, the Touch Panel configuration will NOT be optimized for use with a Screen Protector.
If unselected, the Touch Panel configuration WILL be optimized for use with a Screen Protector.
Not all devices support the ability to configure the Touch Panel to account for the use or a Screen Protector.
Detail Information:
Key = touchScreenProtector
Type = boolean
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Volume UI Profiles
Use this Sub-array to configure one or more Volume UI Profile(s).
Detail Information:
Key = zvcprofiles
Type = bundle_array
Volume UI Profile
Use this Sub-group to configure Profile Name, Make Current, Adjust Volume, and Stream.
Detail Information:
Key = zvcprofile
Type = bundle
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Profile Name
Enter the Profile Name for an Audio UI Profile in the Zebra Volume Control UI.
Detail Information:
Key = uiVolumeProfileName
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Make Current
Select whether a Profile should be made the current active Profile in the Zebra Volume Control UI.
Detail Information:
Key = uiVolumeMakeCurrent
Type = string
UI Choice | JSON Value |
---|---|
Make Current | 1 |
Do NOT Make Current | 2 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Adjust Volume
Select whether the current device Volume Settings will be adjusted to ensure that they fall within the range of Volume Settings defined by an Audio UI Profile being made the new current Audio UI Profile to be made the current active Audio UI Profile.
Detail Information:
Key = uiVolumeAdjustVolume
Type = string
UI Choice | JSON Value |
---|---|
Off | Off |
On | On |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Stream Configuration
Use this Sub-group to configure STREAM_MUSIC for HDMI Output, STREAM_MUSIC on Bluetooth Headset, STREAM_MUSIC on Speaker, STREAM_MUSIC on Wired Headset, STREAM_ALARM on Speaker/Wired and Bluetooth Headsets, STREAM_RING/STREAM_NOTIFICATION/STRING_SYSTEM on Speaker/Wired and Bluetooth Headsets, STREAM_VOICE_CALL on Bluetooth Headset, STREAM_VOICE_CALL on Receiver, STREAM_VOICE_CALL on Speaker, STREAM_VOICE_CALL on Wired Headset, Decode Beep on Speaker/Wired and Bluetooth Headsets, and Keyboard Feedback on Speaker/Wired and Bluetooth Headsets.
Detail Information:
Key = uiVolumeStream
Type = bundle
Support Information:
- NOT supported on Device(s): TC20 and TC25.
STREAM_MUSIC for HDMI Output
Enter volume levels for music stream on HDMI. Use comma separated integers for min,max,preset from 0-15, e.g. 1,15,12
Detail Information:
Key = uiVolumeSMHDMI
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
STREAM_MUSIC on Bluetooth Headset
Enter volume levels for music stream on Bluetooth Headset. Use comma separated integers for min,max,preset from 0-15, e.g. 1,15,12
Detail Information:
Key = uiVolumeSMBTHeadset
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
STREAM_MUSIC on Speaker
Enter volume levels for music stream on Speaker. Use comma separated integers for min,max,preset from 0-15, e.g. 1,15,12
Detail Information:
Key = uiVolumeSMSpeaker
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
STREAM_MUSIC on Wired Headset
Enter volume levels for music stream on Wired Headset. Use comma separated integers for min,max,preset from 0-15, e.g. 1,15,12
Detail Information:
Key = uiVolumeSMWiredHeadset
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
STREAM_ALARM on Speaker/Wired and Bluetooth Headsets
Enter volume levels for alarm stream on Speaker, Wired Headst and Bluetooth Headset. Use comma separated integers for min,max,preset from 1-7, e.g. 1,7,5
Detail Information:
Key = uiVolumeSASpkrWHBH
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
STREAM_RING/STREAM_NOTIFICATION/STRING_SYSTEM on Speaker/Wired and Bluetooth Headsets
Enter volume levels for ring/notification.system on Speaker, Wired or Bluetooth Headsets. Use comma separated integers for min,max,preset from 0-7, e.g. 1,7,5
Detail Information:
Key = uiVolumeSRSNSSSpkrWHBH
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
STREAM_VOICE_CALL on Bluetooth Headset
Enter volume levels for voice call stream on Bluetooth Headsets. Use comma separated integers for min,max,preset from 1-5, e.g. 1,5,4
Detail Information:
Key = uiVolumeSVCBTH
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
STREAM_VOICE_CALL on Receiver
Enter volume levels for voice call stream on Receiver. Use comma separated integers for min,max,preset from 1-5, e.g. 1,5,4
Detail Information:
Key = uiVolumeSVCRcvr
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
STREAM_VOICE_CALL on Speaker
Enter volume levels for voice call stream on Speaker. Use comma separated integers for min,max,preset from 1-5, e.g. 1,5,4
Detail Information:
Key = uiVolumeSVCSpkr
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
STREAM_VOICE_CALL on Wired Headset
Enter volume levels for voice call stream on Wired Headsets. Use comma separated integers for min,max,preset from 1-5, e.g. 1,5,4
Detail Information:
Key = uiVolumeSVCWH
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Decode Beep on Speaker/Wired and Bluetooth Headsets
Enter volume levels for decode beep virtual volume on Speaker, Wired and Bluetooth Headsets. Use comma separated integers for min,max,preset from 0-10, e.g. 1,10,8
Detail Information:
Key = uiVolumeDecodeBeepSpkrWHBTH
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Keyboard Feedback on Speaker/Wired and Bluetooth Headsets
Enter volume levels for keyboard feedback sound on Speaker, Wired and Bluetooth Headsets. Use comma separated integers for min,max,preset from 0-4, e.g. 1,4,2
Detail Information:
Key = uiVolumeKBFeedbackSpkrWHBTH
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Wireless and Network Configuration
Use this Group to configure Bluetooth, DHCP, Enterprise NFC, Ethernet, Host Name, RFID, Wireless General, Wireless LAN, Wireless WAN, and Worry Free WiFi.
Detail Information:
Key = wirelessAndNetworkConfig
Type = bundle
Bluetooth Configuration
Use this Sub-group to configure Discoverability, New Pairings, Pairing Rules, Silent Pairing, Single Pairing, Blocked BLE Channels, Blocked RF-Based BLE Channels, and Beacon.
Detail Information:
Key = bluetoothConfig
Type = bundle
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 5.1.
Discoverability
Select whether the device is Discoverable via Bluetooth.
Devices are NOT Discoverable via Bluetooth by default except when the Bluetooth Pairing screen of the Settings UI is active.
- If the value Off is selected, the default behavior will be in effect and the device will not be Discoverable via Bluetooth except when the Bluetooth Pairing screen of the Settings UI is active.
- If the value On is selected, the default behavior will be overridden and the device will be Discoverable via Bluetooth whenever Bluetooth is enabled (turned on).
Detail Information:
Key = btDiscoverability
Type = string
UI Choice | JSON Value |
---|---|
Off | 2 |
On | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
New Pairings
Select whether the device will be Allowed to Accept new Bluetooth Pairings.
- If the value Disallow is selected, the device will NOT be Allowed to Accept new Bluetooth Pairings.
- If the value Allow is selected, the device WILL be Allowed to Accept new Bluetooth Pairings.
Zebra devices are configured by default to Accept new Bluetooth Pairings.
Detail Information:
Key = btNewPairings
Type = string
UI Choice | JSON Value |
---|---|
Disallow | 2 |
Allow | 1 |
Pair only trusted devices | 3 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Pairing Rules
Use this Sub-array to configure one or more Pairing Rule(s) that define non-default Behavior for Pairing Bluetooth Devices.
Detail Information:
Key = btpRule
Type = bundle_array
Pairing Rule
Use this Sub-group to configure Name, Device Upper Address Part, MAC Address, Trusted Device Rule, Device Class, Silent Pairing Rule, Single Pairing Rule, Single Pairing Category, and Pairing PIN Code.
Detail Information:
Key = bluetoothRule
Type = bundle
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Name
Enter a name for a BlueTooth Rule.
Note that you can specify Name and/or MAC Address.
Detail Information:
Key = bluetoothRuleName
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Device Upper Address Part
Enter the Device Upper Address Part for a Bluetooth Rule.
When a Device Upper Address Part is specified for a rule, Bluetooth Silent Pairing will automatically complete new Bluetooth Pairings for Bluetooth devices that have the specified Device Upper Address Part in the upper part of their Bluetooth Address.
Detail Information:
Key = bluetoothRuleUpperAddressPart
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
MAC Address
Enter the Bluetooth MAC Address XX:XX:XX:XX:XX:XX for a Bluetooth Rule.
Note that you can specify Name and/or MAC Address.
Detail Information:
Key = bluetoothRuleMACAddress
Type = string
Support Information:
Supported on Operating System(s): Pie.
NOT supported on Device(s): TC20 and TC25.
Trusted Device Rule
Select whether this is a trusted device rule.
If set to Yes the defined rule will be considered a trusted device rule for pairing devices that satisfy the rule's parameters.
Detail Information:
Key = bluetoothRuleTrustedDevice
Type = string
UI Choice | JSON Value |
---|---|
No | 0 |
Yes | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Device Class
Enter the Device Class for a Bluetooth Rule.
When a Device Class is specified for a rule, Bluetooth Silent Pairing will automatically complete new Bluetooth Pairings for Bluetooth devices that have the specified Device Class.
Detail Information:
Key = bluetoothRuleDeviceClass
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Silent Pairing Rule
Select whether this is a silent pairing rule.
If set to Yes the defined rule will allow pairing without operator interaction.
Detail Information:
Key = bluetoothRuleSilentPairing
Type = string
UI Choice | JSON Value |
---|---|
No | 0 |
Yes | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Single Pairing Rule
Select whether this is a single pairing rule.
If set to Yes the defined rule will only allow one device of the selected category to pair.
Detail Information:
Key = bluetoothRuleSinglePairing
Type = string
UI Choice | JSON Value |
---|---|
No | 0 |
Yes | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Single Pairing Category
Select the class of Bluetooth peripheral for which only a single pairing will be allowed.
Only one peripheral of the specified class will be permitted to pair.
- If the value Headset is selected, only one Bluetooth headset will be permitted to pair at a time.
- If the value Scanner is selected, only one Bluetooth scanner will be permitted to pair at a time.
- If the value Printer is selected, only one Bluetooth printer will be permitted to pair at a time.
- If the value Payment is selected, only one Bluetooth payment will be permitted to pair at a time.
- If the value Dex is selected, only one Bluetooth Dex will be permitted to pair at a time.
Note that even when the device IS configured to permit only single Bluetooth Pairings, it WILL NOT do so unless Action is used to configure specific silent pairing rules that define how single pairing should occur.
Detail Information:
Key = bluetoothSinglePairingCategory
Type = string
UI Choice | JSON Value |
---|---|
Headset | 1 |
Scanner | 2 |
Printer | 3 |
Payment | 4 |
Dex | 5 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Pairing PIN Code
Enter the Pairing PIN Code for a Bluetooth Rule.
When a Pairing PIN Code is specified for a rule, and the device has a Bluetooth version prior to 2.1, Bluetooth Silent Pairing will automatically use the specified Pairing PIN Code to complete Bluetooth Silent Pairings enabled by the Silent Pairing Rule.
When the device has a Bluetooth version 2.1 or later, a Pairing PIN Code is not required to complete Bluetooth Silent Pairings enabled by the Silent Pairing Rule.
Detail Information:
Key = bluetoothRulePIN
Type = string
Support Information:
Supported on Operating System(s): Pie.
NOT supported on Device(s): TC20 and TC25.
Silent Pairing
Select whether the device will be Allowed to perform Bluetooth pairings silently.
- If the value Allow is selected, the device will NOT be Allowed to perform Bluetooth pairings silently.
- If the value Disallow is selected, the device WILL be Allowed to perform Bluetooth pairings silently.
Devices will silently perform Bluetooth Pairings by default.
Note that even when the device CAN silently perform Bluetooth Pairings, it WILL NOT do so unless Bluetooth Pairing Rules is used to configure specific silent pairing rules that define how silent pairing should occur.
Detail Information:
Key = btSilentPairingsState
Type = string
UI Choice | JSON Value |
---|---|
Allow | 1 |
Disallow | 2 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Single Pairing
Select whether only one remote device of a certain category will be paired at a time.
Devices will allow more than one pairing of a category of device at a time by default.
- If the value Allow is selected, the default behavior will be overridden and the device will only pair to one device of the specified category at a time.
- If the value Disallow is selected, the default behavior will be in effect and the device will pair to more than one device of any category at a time..
Note that even when the device CAN silently perform Bluetooth Pairings, it WILL NOT do so unless Bluetooth Pairing Rules is used to configure specific single pairing rules that define how single pairing should occur.
Detail Information:
Key = btSinglePairingsState
Type = string
UI Choice | JSON Value |
---|---|
Allow | 1 |
Disallow | 2 |
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 10.2.
Blocked BLE Channels
Enter the BLE channels to block separated by commas or high/low pairs separated by a dash. For example, 0-5,7,31-35.
Detail Information:
Key = btBLEBlockedChannels
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Blocked RF-Based BLE Channels
Enter the RF-Based BLE channels to block separated by commas or high/low pairs separated by a dash. For example, 2414-2418,2420,2431-2453
Detail Information:
Key = btBLEBlockedRFChannels
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Beacon Configuration
Use this Sub-group to configure Airplane Mode State, Beaconing On Battery Reinsert, State, Type, Explicit Beacon UUID, AltBeacon, Custom Beacon, Custom Transmit Power Level, Transmit Power Level, Custom Transmit Interval, and Transmit Power Interval.
Detail Information:
Key = btBeaconConfig
Type = bundle
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 10.2.
Airplane Mode State
Select whether the emitting of Beacons while the Device is Powered Off will be conditioned based on whether Airplane Mode was On at the time the Device was powered Off.
This is only relevant when On is specified for Airplane Mode State.
Detail Information:
Key = btBeaconAirplaneModeState
Type = string
UI Choice | JSON Value |
---|---|
Off | 2 |
On | 1 |
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 10.2.
Beaconing On Battery Reinsert
Select whether to emit beacon upon battery reinsertion while device is still powered off. By default, beacon will be emitted.
This is only relevant when On is specified for Airplane Mode State.
Detail Information:
Key = btBeaconingOnBatteryReinsert
Type = string
UI Choice | JSON Value |
---|---|
Off | 2 |
On | 1 |
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 10.2.
State
Select whether a beacon will be emitted (on) or not (off) while the device display is turned off.
- If the value Off is selected, a beacon will NOT be emitted when the device display is turned off.
- If the value On is selected, a beacon WILL be emitted when the device display is turned off.
Detail Information:
Key = btBeaconState
Type = string
UI Choice | JSON Value |
---|---|
Off | 2 |
On | 1 |
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 10.2.
Type
Select the Type of Beacon to be emitted.
- If the value AltBeacon is selected, an AltBeacon style Beacon will be emitted.
- If the value Custom is selected, a Custom style Beach will be emitted and Data must also be specified to define the Custom Beacon style.
Detail Information:
Key = btBeaconType
Type = string
UI Choice | JSON Value |
---|---|
AltBeacon | 2 |
Custom | 3 |
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 10.2.
Explicit Beacon UUID
Select whether an explicit UUID will be used for the beacon when AltBeacon is specified for Type.
Detail Information:
Key = btExplicitBeaconUUID
Type = string
UI Choice | JSON Value |
---|---|
Off | 0 |
On | 1 |
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 10.2.
AltBeacon Configuration
Use this Sub-group to configure UUID, ID1, ID2, Manufacturing Byte, and Reference RSSI.
Detail Information:
Key = btAltBeaconConfig
Type = bundle
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 10.2.
UUID
Enter the UUID to use when On is specified for UUID and AltBeacon is specified for Type.
Detail Information:
Key = btAltBeaconUUID
Type = string
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 10.2.
ID1
Enter the 4 hexadecimal characters to use for ID1 when AltBeacon is specified for Type. If nothing is entered, the value of EBEB will be used.
Detail Information:
Key = btAltBeaconMajorID
Type = string
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 10.2.
ID2
Enter the 4 hexadecimal characters to use for ID2 when AltBeacon is specified for Type. If nothing is entered, the value of ECDD will be used.
Detail Information:
Key = btAltBeaconMinorID
Type = string
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 10.2.
Manufacturing Byte
Enter the 2 hexadecimal characters to use for the manufacturing byte when AltBeacon is specified for Type. If no value is entered, the default value of 00 will be used.
Detail Information:
Key = btAltBeaconMfgByte
Type = string
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 10.2.
Reference RSSI
Enter the 2 hexadecimal characters to used for the reference RSSI when AltBeacon is specified for Type. If no value is entered, a calculated value will be used.
Detail Information:
Key = btAltBeaconRefRSSI
Type = string
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 10.2.
Custom Beacon Configuration
Use this Sub-group to configure Data.
Detail Information:
Key = btCustomBeaconConfig
Type = bundle
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 10.2.
Data
Enter the custom UUID/URL/DATA to use for the custom beacon type. Up to 56 hexadecimal characters that follow the Bluetooth SIG Advertising format may be used when Custom is specified for Type.
Detail Information:
Key = btCustomBeaconData
Type = string
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 10.2.
Custom Transmit Power Level
Enter the power level (in dBm) of the beacons that will be sent while the device is powered off. Valid range is between -127 and 1.
Detail Information:
Key = btCustomBeaconXmitPower
Type = string
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 10.2.
Transmit Power Level
Select the Power Level of the beacon that will be emitted while the device is powered off. If not selected, default value will be used (default values vary by device)
- If High (1dBm) is selected, the transmit power level of the beacon will be set to 1dBm (maximum power)
- If Medium (-7dBm) is selected, the transmit power level of the beacon will be set to -7dBm.
- If Low Power (-15dBm) is selected, the transmit power level of the beacon will be set to -15dBm
- If Ultra Low Power(-21dBm) is selected, the transmit power level of the beacon will be set to -21dBm
- If Custom is selected a value between -127 and +1 (dBm) must be entered for Transmit Power Level
Detail Information:
Key = btBeaconXmitPower
Type = string
UI Choice | JSON Value |
---|---|
High (1dBm) | 1 |
Medium (-7dBm) | 2 |
Low Power (-15dBm) | 3 |
Ultra Low Power(-21dBm) | 4 |
Custom | 5 |
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 10.2.
Custom Transmit Interval
Enter the Interval between beacons that will be sent while the device is powered off. The valid range of values is between 100 and 10240 msec.
Detail Information:
Key = btCustomBeaconXmitInterval
Type = string
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 10.2.
Transmit Power Interval
Select the Interval between beacons that will be sent while the device is powered off. If not selected, default value will be used (default values vary by device)
- If Low Latency (100 ms) is selected, the transmit interval between beacons will be set to 100msec (Low Latency)
- If Balanced (250 ms) is selected, the transmit interval between beacons will be set to 250msec (Balanced)
- If Low Power (1000 ms) is selected, the transmit interval between beacons will be set to 1000msec (Low Power)
- If Custom is selected, the transmit interval between beacons will be set to the value specified in Transmit Interval
Detail Information:
Key = btBeaconXmitInterval
Type = string
UI Choice | JSON Value |
---|---|
Low Latency (100 ms) | 1 |
Balanced (250 ms) | 2 |
Low Power (1000 ms) | 3 |
Custom | 4 |
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 10.2.
DHCP Configuration
Use this Sub-group to configure Request V4 Options and Send V4 Options.
Detail Information:
Key = dhcpConfig
Type = bundle
Request V4 Options
Use this Sub-array to configure one or more Request V4 Option(s).
Detail Information:
Key = dhcpRequestV4Options
Type = bundle_array
Request V4 Option
Use this Sub-group to configure Request V4 Type.
Detail Information:
Key = dhcpRequestV4Option
Type = bundle
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Request V4 Type
Select the Type of DHCP Option to be Requested from the DHCP Server by the DHCP Client.
Detail Information:
Key = dhcpRequestV4Type
Type = string
UI Choice | JSON Value |
---|---|
28 - Broadcast Address | 28 |
42 - NTP Server | 42 |
43 - Vendor Encapsulated Options | 43 |
66 - TFTP Server Address | 66 |
67 - Boot File Name | 67 |
119 - Domain Search List | 119 |
150 - TFTP Server Names | 150 |
186 - Vendor Specific Option#1 | 186 |
188 - Vendor Specific Option#2 | 188 |
230 - Vendor Specific Option#3 | 230 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Send V4 Options
Use this Sub-array to configure one or more Send V4 Option(s).
Detail Information:
Key = dhcpSendV4Options
Type = bundle_array
Send V4 Option
Use this Sub-group to configure Send V4 Flag Value, Send V4 Type, and Send V4 Value.
Detail Information:
Key = dhcpSendV4Option
Type = bundle
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Send V4 Flag Value
Enter the Flag Value to be attached to DHCP Option 81 Sent to the DHCP Server by the DHCP Client.
Detail Information:
Key = dhcpSendV4FlagValue
Type = string
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 6.3.
Send V4 Type
Select the Type of DHCP Option to be Sent to the DHCP Server by the DHCP Client.
Detail Information:
Key = dhcpSendV4Type
Type = string
UI Choice | JSON Value |
---|---|
12 - Host Name | 12 |
60 - Vendor Class | 60 |
61 - Client Identifier Value | 61 |
77 - User Class | 77 |
81 - FQDN Flag | 81 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Send V4 Value
Enter the Value to be attached to a DHCP Option to be Sent to the DHCP Server by the DHCP Client.
Detail Information:
Key = dhcpSendV4Value
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Enterprise NFC Configuration
Use this Sub-group to configure State, General NFC, and Tag.
Detail Information:
Key = nfcConfig
Type = bundle
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 8.3.
State
Select the Enterprise NFC State.
If the value Off is selected, Enterprise NFC will be turned Off.
If the value On is selected, Enterprise NFC will be turned On.
Detail Information:
Key = wirelessNfcState
Type = string
UI Choice | JSON Value |
---|---|
Off | 2 |
On | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
General NFC Configuration
Use this Sub-group to configure Reset to Defaults, Logging, NFC Data Exchange Format (NDEF), Polling Mode, CPU Boost, Peer to Peer Mode, Card Emulation Mode, and Use on Lock Screen.
Detail Information:
Key = nfcGeneralConfig
Type = bundle
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 8.3.
Reset to Defaults
Select whether the Enterprise NFC settings should all be reset to their default values.
Detail Information:
Key = wirelessNfcResetToDefaults
Type = string
UI Choice | JSON Value |
---|---|
Do Not Reset | false |
Reset | true |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Logging
Select whether logging should be used by Enterprise NFC
If the value Off is selected, Enterprise NFC will NOT capture logs.
If the value On is selected, Enterprise NFC will capture logs.
Detail Information:
Key = wirelessNfcDebugLoggingState
Type = string
UI Choice | JSON Value |
---|---|
Off | false |
On | true |
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 10.3.
NFC Data Exchange Format (NDEF)
Select whether the Enterprise NFC should use NFC Data Exchange Format (NDEF).
If the value Do Not Use is selected, Enterprise NFC will NOT attempt tp read NDEF formatted tags. This could increase the speed of reading non-NDEF tags by not spending unnecessary time trying to interpret tag data according to NDEF formatting rules.
If the value Use is selected, Enterprise NFC will attempt to read NDEF formatted tags. This may decrease speed somewhat, compared to reading unformatted tags, but increases flexibility by allowing applications to receive tag data interpreted according to NDEF formatting rules. Starting in Android 11, support for NFC Data Exchange Format (NDEF) is deprecated.
Detail Information:
Key = wirelessNfcUseNDEF
Type = string
UI Choice | JSON Value |
---|---|
Do Not Use | false |
Use | true |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Polling Mode
Select the Enterprise NFC Polling Mode that should be used.
If the value Hybrid is selected, Enterprise NFC will poll in a manner designed to strike a reasonable balance between polling speed and battery life.
If the value Standard is selected, then Enterprise NFC will poll in a manner designed to maximize polling speed. This may increase battery drain but will reduce tag detection time.
If the value Low Power is selected, Enterprise NFC will poll in a manner designed to minimize impact on battery life. This may increase the overall tag detection time, but will reduce battery drain.
Detail Information:
Key = wirelessNfcPollingMode
Type = string
UI Choice | JSON Value |
---|---|
Hybrid | 2 |
Standard | 1 |
Low Power | 0 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
CPU Boost
Select whether the Enterprise NFC should Boost CPU Speed during NFC transactions.
- If the value Do Not Boost is selected, Enterprise NFC will leave the CPU Speed unmodified during NFC transactions.
- If the value Boost is selected, Enterprise NFC will Boost the CPU Speed during NFC transactions to enhance performance of those transactions.
Detail Information:
Key = wirelessNfcCpuBoost
Type = string
UI Choice | JSON Value |
---|---|
Do Not Boost | false |
Boost | true |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Peer to Peer Mode
Select whether the Enterprise NFC should use Peer-to-Peer Mode. This is generally used when two NFC enabled devices want to communicate with each other to exchange data.
- If the value Do Not Use is selected, Enterprise NFC will NOT use Peer-to-Peer Mode and hence will operate only in Read/Write Mode, unless it is also configured to operated in Card Emulation Mode by via Card Emulation Mode.
- If the value Use is selected, Enterprise NFC will use Peer-to-Peer Mode and hence will operate in both Peer-to-Peer Mode and Read/Write Mode, and and optionally also in Card Emulation Mode, if configured via Card Emulation Mode. Starting in Android 11, support for Peer-to-Peer Mode is deprecated.
Detail Information:
Key = wirelessNfcPeerToPeerMode
Type = string
UI Choice | JSON Value |
---|---|
Do Not Use | false |
Use | true |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Card Emulation Mode
Select whether the Enterprise NFC should use Card Emulation Mode. This is generally used when an NFC enabled device wants to emulate a Smart Card.
- If the value Do Not Use is selected, Enterprise NFC will NOT use Card Emulation Mode and hence will operate only in Read/Write Mode, unless it is also configured to operated in Peer-to-Peer Mode by via Peer to Peer Mode.
- If the value Use is selected, Enterprise NFC will use Card Emulation Mode and hence will operate in both Card Emulation Mode and Read/Write Mode and optionally also in Peer-to-Peer Mode, if configured via Peer to Peer Mode.
Detail Information:
Key = wirelessNfcCardEmulationMode
Type = string
UI Choice | JSON Value |
---|---|
Do Not Use | false |
Use | true |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Use on Lock Screen
Select whether the User will be Allowed to Enterprise NFC from the Lock Screen.
If the value Disallow is selected, the User will NOT be Allowed to Enterprise NFC from the Lock Screen.
If the value Allow is selected, the User WILL be Allowed to Enterprise NFC from the Lock Screen.
Detail Information:
Key = wirelessNfcUseOnLockScreen
Type = string
UI Choice | JSON Value |
---|---|
Disallow | false |
Allow | true |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Tag Configuration
Use this Sub-group to configure Type A Tags, Type B Tags, Type F Tags, Type V Tags, Type A Tag Baud Rate, and Type B Tag Baud Rate.
Detail Information:
Key = nfcTagConfig
Type = bundle
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 8.3.
Type A Tags
Select whether the Enterprise NFC should read NFC Type A Tags.
If the value Do Not Read is selected, Enterprise NFC will NOT attempt to read NFC Type A Tags. This could increase the speed of reading other tag types in cases where Type A Tags are not used.
If the value Read is selected, Enterprise NFC will attempt to read NFC Type A Tags. This might decrease the speed of reading tags unless reading of other tag types is turned off.
Detail Information:
Key = wirelessNfcReadTypeATags
Type = string
UI Choice | JSON Value |
---|---|
Do Not Read | false |
Read | true |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Type B Tags
Select whether the Enterprise NFC should read NFC Type B Tags.
If the value Do Not Read is selected, Enterprise NFC will NOT attempt to read NFC Type B Tags. This could increase the speed of reading other tag types in cases where Type B Tags are not used.
If the value Read is selected, Enterprise NFC will attempt to read NFC Type B Tags. This might decrease the speed of reading tags unless reading of other tag types is turned off.
Detail Information:
Key = wirelessNfcReadTypeBTags
Type = string
UI Choice | JSON Value |
---|---|
Do Not Read | false |
Read | true |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Type F Tags
Select whether the Enterprise NFC should read NFC Type F Tags.
If the value Do Not Read is selected, Enterprise NFC will NOT attempt to read NFC Type F Tags. This could increase the speed of reading other tag types in cases where Type F Tags are not used.
If the value Read is selected, Enterprise NFC will attempt to read NFC Type F Tags. This might decrease the speed of reading tags unless reading of other tag types is turned off.
Detail Information:
Key = wirelessNfcReadTypeFTags
Type = string
UI Choice | JSON Value |
---|---|
Do Not Read | false |
Read | true |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Type V Tags
Select whether the Enterprise NFC should read NFC Type V Tags.
If the value Do Not Read is selected, Enterprise NFC will NOT attempt to read NFC Type V Tags. This could increase the speed of reading other tag types in cases where Type V Tags are not used.
If the value Read is selected, Enterprise NFC will attempt to read NFC Type V Tags. This might decrease the speed of reading tags unless reading of other tag types is turned off.
Detail Information:
Key = wirelessNfcReadTypeVTags
Type = string
UI Choice | JSON Value |
---|---|
Do Not Read | false |
Read | true |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Type A Tag Baud Rate
Select the Baud Rate that Enterprise NFC should use for Type A Tags.
- If the value 106 kbps is selected, Enterprise NFC will always communicate to Type A Tags using a Baud Rate of 106 kbps.
- If the value 212 kbps is selected, Enterprise NFC will communicate to Type A Tags using a Baud Rate of 106 kbps or 212 kbps, depending on the Baud Rate supported by the tag.
- If the value 424 kbps is selected, Enterprise NFC will communicate to Type A Tags using a Baud Rate of 106 kbps, 212 kbps, or 424 kbps, depending on the Baud Rate supported by the tag.
- If the value Any is selected, Enterprise NFC will communicate to Type A Tags using any available (automatically selected) Baud Rate supported by the tag.
Detail Information:
Key = wirelessNfcTypeABaudRate
Type = string
UI Choice | JSON Value |
---|---|
106 kbps | 1 |
212 kbps | 16 |
424 kbps | 32 |
Any | 2 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Type B Tag Baud Rate
Select the Baud Rate that Enterprise NFC should use for Type B Tags.
If the value 106 kbps is selected, Enterprise NFC will always communicate to Type B Tags using a Baud Rate of 106 kbps.
If the value 212 kbps is selected, Enterprise NFC will communicate to Type B Tags using a Baud Rate of 106 kbps or 212 kbps, depending on the Baud Rate supported by the tag.
If the value 424 kbps is selected, Enterprise NFC will communicate to Type B Tags using a Baud Rate of 106 kbps, 212 kbps, or 424 kbps, depending on the Baud Rate supported by the tag.
If the value Any is selected, Enterprise NFC will communicate to Type B Tags using any available (automatically selected) Baud Rate supported by the tag.
Detail Information:
Key = wirelessNfcTypeBBaudRate
Type = string
UI Choice | JSON Value |
---|---|
106 kbps | 4 |
212 kbps | 64 |
424 kbps | 128 |
Any | 2 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Ethernet Configuration
Use this Sub-group to configure State, User Control of State, IP Address, and Proxy.
Detail Information:
Key = ethernetConfig
Type = bundle
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 6.2.
State
Select whether Ethernet Power will be turned on or off.
A given device may or may not support an Ethernet Adapter. An attempt to configure the Ethernet Adapter on a device that does not have one will result in an error.
Detail Information:
Key = netEthernetState
Type = string
UI Choice | JSON Value |
---|---|
Off | 2 |
On | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
User Control of State
Select whether the User will be Allowed to control the Ethernet Power State.
- If the value Disallow is selected, the User will NOT be Allowed to control the Ethernet Power State.
- If the value Allow is selected, the User WILL be Allowed to control the Ethernet Power State.
A given device may or may not support an Ethernet Adapter. An attempt to configure the Ethernet Adapter on a device that does not have one will result in an error.
Detail Information:
Key = netEthernetStateControlByUser
Type = string
UI Choice | JSON Value |
---|---|
Disallow | 2 |
Allow | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
IP Address Configuration
Use this Sub-group to configure Type, Static IP Address, Static Gateway Address, Static Network Mask, Static Primary DNS, and Static Secondary DNS.
Detail Information:
Key = netEthernetIpAddrConfig
Type = bundle
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Type
Select how an IP Address will be assigned to the Ethernet adapter.
- If the value Static (Manual) is selected, an IP Address for the Ethernet adapter will be automatically acquired by the DHCP Client from the DHCP Server.
- If the value Dynamic (DHCP) is selected, an IP Address for the Ethernet adapter will be assigned based on the values selected for IP Address, Gateway Address, Network Mask, Primary DNS, and Secondary DNS, which you must also specify to provide the required values.
A given device may or may not support an Ethernet Adapter. An attempt to configure the Ethernet Adapter on a device that does not have one will result in an error.
Detail Information:
Key = netEthernetIpAddrType
Type = string
UI Choice | JSON Value |
---|---|
Dynamic (DHCP) | 1 |
Static (Manual) | 0 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Static IP Address
Enter the IP Address to be assigned to the Ethernet adapter.
A given device may or may not support an Ethernet Adapter. An attempt to configure the Ethernet Adapter on a device that does not have one will result in an error.
Detail Information:
Key = netEthernetIpStaticIpAddress
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Static Gateway Address
Enter the Gateway Address to be assigned to the Ethernet adapter.
A given device may or may not support an Ethernet Adapter. An attempt to configure the Ethernet Adapter on a device that does not have one will result in an error.
Detail Information:
Key = netEthernetIpStaticGatewayAddress
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Static Network Mask
Enter the Network Mask to be assigned to the Ethernet adapter.
A given device may or may not support an Ethernet Adapter. An attempt to configure the Ethernet Adapter on a device that does not have one will result in an error.
Detail Information:
Key = netEthernetIpStaticNetworkMask
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Static Primary DNS
Enter the Primary DNS Server Address to be assigned to the Ethernet adapter.
A given device may or may not support an Ethernet Adapter. An attempt to configure the Ethernet Adapter on a device that does not have one will result in an error.
Detail Information:
Key = netEthernetIpStaticDNS1
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Static Secondary DNS
Enter the Secondary DNS Server Address to be assigned to the Ethernet adapter.
A given device may or may not support an Ethernet Adapter. An attempt to configure the Ethernet Adapter on a device that does not have one will result in an error.
Detail Information:
Key = netEthernetIpStaticDNS2
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Proxy Configuration
Use this Sub-group to configure State, Port, Server, and Bypass List.
Detail Information:
Key = netEthernetProxyConfig
Type = bundle
Support Information:
- NOT supported on Device(s): TC20 and TC25.
State
Select whether a Proxy Server should be used to access the Internet from the network accessed via the Ethernet Adapter.
When specifying that a Proxy Server is to be used, you should specify Proxy Server, Port, and Bypass List together whenever Ethernet Proxy Server configuration is performed to help ensure that all three three values are properly synchronized.
A given device may or may not support an Ethernet Adapter. An attempt to configure the Ethernet Adapter on a device that does not have one will result in an error.
Detail Information:
Key = netEthernetProxyState
Type = string
UI Choice | JSON Value |
---|---|
Use a Proxy Server | 2 |
Do NOT Use a Proxy Server | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Port
Enter the Port that will be used to reach the Proxy Server to access the Internet from the network accessed via the Ethernet Adapter.
You should specify Proxy Server, Port, and Bypass List whenever Ethernet Proxy Server configuration is performed to help ensure that all three three values are properly synchronized.
A given device may or may not support an Ethernet Adapter. An attempt to configure the Ethernet Adapter on a device that does not have one will result in an error.
Detail Information:
Key = netEthernetProxyServerPort
Type = integer
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Server
Enter the Proxy Server used to access the Internet from the network accessed via the Ethernet Adapter.
While it is not mandatory, you should specify Proxy Server, Port, and Bypass List whenever Ethernet Proxy Server configuration is performed to help ensure that all three three values are properly synchronized.
A given device may or may not support an Ethernet Adapter. An attempt to configure the Ethernet Adapter on a device that does not have one will result in an error.
Detail Information:
Key = netEthernetProxyServer
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Bypass List
Enter the Proxy Server Bypass List which specifies addresses that should bypass the Proxy Server used to access the Internet from the network accessed via the Ethernet Adapter.
While it is not mandatory, you should specify Proxy Server, Port, and Bypass List whenever Ethernet Proxy Server configuration is performed to help ensure that all three three values are properly synchronized.
A given device may or may not support an Ethernet Adapter. An attempt to configure the Ethernet Adapter on a device that does not have one will result in an error.
Detail Information:
Key = netEthernetProxyServerBypassList
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Host Name Configuration
Use this Sub-group to configure Device Name.
Detail Information:
Key = hostConfig
Type = bundle
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 5.1.
Device Name
Enter the name by which a device will be known on the network.
Detail Information:
Key = netHostDeviceName
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
RFID Configuration
Use this Sub-group to configure Update Firmware File, Country of Operation, Channel Hopping, Channel Mask, Ukraine Region Power Mode, Query Select, Query Session, Query Target, and Transmit Power Level.
Detail Information:
Key = rfidConfig
Type = bundle
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Update Firmware File
Enter the path and file name of the file containing the firmware update to be applied when the value Update Firmware or the value Update Firmware and Reset Radio to Factory Defaults is selected for Action.
Detail Information:
Key = wirelessRfidUpdateFirmwareFile
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Country of Operation
Select the Country of Operation in which the RFID module will be used.
It is critical that the Country of Operation be set at least once, since the RFID module has no default Country of Operation and will not operate unless/until the Country of Operation is explicitly set, to ensure that country-specific regulator requirements are met.
In most cases, the Country of Operation will be set once and never changed, unless the device is physically relocated to a different country.
Detail Information:
Key = wirelessRfidCountryOfOperation
Type = string
UI Choice | JSON Value |
---|---|
ALBANIA | 1 |
ANDORRA | 2 |
ARGENTINA | 3 |
AUSTRALIA | 4 |
BANGLADESH | 5 |
BHUTAN | 6 |
BOLIVIA | 7 |
BOSNIA_HERZENGOVINA | 8 |
BRAZIL | 9 |
CANADA | 10 |
CAMBODIA | 11 |
CHILE | 12 |
CHINA | 13 |
COLOMBIA | 14 |
DOMINICAN_REPUBLIC | 15 |
ECUADOR | 16 |
EL_SALVADOR | 17 |
UNITED_KINGDOM | 18 |
GUATEMALA | 19 |
GUAM | 20 |
HONG_KONG | 21 |
INDIA | 22 |
INDONESIA | 23 |
JAPAN_1W_LBT | 24 |
JAPAN_250MW | 25 |
LAOS_EU | 26 |
LAOS_FCC | 27 |
MACAU | 28 |
MACEDONIA | 29 |
MALAYSIA | 30 |
MEXICO | 31 |
MONACO | 32 |
MOTENEGRO | 33 |
NEW_ZEALAND_FCC | 34 |
NEW_ZEALAND_EU | 35 |
PAKISTAN | 36 |
PANAMA | 37 |
PARAGUAY | 38 |
PERU | 39 |
PHILIPPINES | 40 |
PUERTO_RICO | 41 |
RUSSIA | 42 |
SAUDI_ARABIA | 43 |
SINGAPORE | 44 |
SOUTH_AFRICA | 45 |
SOUTH_KOREA | 46 |
SRI_LANKA | 47 |
TAIWAN | 48 |
THAILAND | 49 |
TURKEY | 50 |
UAE | 51 |
UNITED_STATES | 52 |
URUGUAY | 53 |
VENEZUELA | 54 |
VIETNAM | 55 |
VIRGINIA_ISLAND | 56 |
ETSI 302.208 compliant generic | 57 |
FCC Part-16 compliant generic | 58 |
ISRAEL | 59 |
ALGERIA | 60 |
ARMENIA | 61 |
AUSTRIA | 62 |
AZERBAIJAN | 63 |
BAHRAIN | 64 |
BELGIUM | 65 |
BULGARIA | 66 |
COSTA_RICA | 67 |
CROATIA | 68 |
CYPRUS | 69 |
CZECH_REPUBLIC | 70 |
DENMARK | 71 |
EGYPT | 72 |
ESTONIA | 73 |
FINLAND | 74 |
FRANCE | 75 |
GEORGIA | 76 |
GERMANY | 77 |
GREECE | 78 |
HUNGARY | 79 |
ICELAND | 80 |
IRELAND | 81 |
ITALY | 82 |
JORDAN | 83 |
KAZAKHSTAN | 84 |
KUWAIT | 85 |
LATVIA | 86 |
LITHUANIA | 87 |
LUXEMBOURG | 88 |
MALTA | 89 |
NETHERLANDS | 90 |
NORWAY | 91 |
OMAN | 92 |
POLAND | 93 |
PORTUGAL | 94 |
QATAR | 95 |
ROMANIA | 96 |
SERBIA | 97 |
SLOVAKIA | 98 |
SLOVENIA | 99 |
SPAIN | 100 |
SWEDEN | 101 |
SWITZERLAND | 102 |
TUNISIA | 103 |
UKRAINE | 104 |
ANGUILLA | 106 |
MOROCCO | 107 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Channel Hopping
Select whether Channel Hopping will be performed among the Channels that are used by the RFID module.
Detail Information:
Key = wirelessRfidCountryOfOperationChannelHopping
Type = string
UI Choice | JSON Value |
---|---|
Off | 0 |
On | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Channel Mask
Enter the Channel Mask that determines which of the Channels that are allowed, based on the currently selected Country of Operation, will be used by the RFID module.
- If no Channel Mask is specified, the RFID module will be free to use any or all Channels that are available based on the currently selected Country of Operation.
- If a Channel Mask is specified, the specified value must consist of one or more Channel Numbers, separated by commas if more than one is specified, which identify the Channels that can be used. The RFID module will limit itself to just the Channels that are allowed for the currently selected Country of Operation AND that are in the set of Channels specified.
Consult the product documentation for the device being used to obtain the set of allowable Channel Numbers.
Detail Information:
Key = wirelessRfidCountryOfOperationChannelMask
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Ukraine Region Power Mode
Select the Ukraine Region specific power mode to be used by the RFID module.
Detail Information:
Key = wirelessRfidCountryOfOperationUkraineRegionPowerMode
Type = string
UI Choice | JSON Value |
---|---|
License free 100MW power-mode | 0 |
Licensed 2W power-mode | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Query Select
Select which RFID tags should be operated upon by the RFID module during a Query Operation, based on the state of the SL flag.
- If the value Query applies to all tags is selected, when the RFID module performs a Query Operation, it will consider all RFID tags that are currently visible to the RFID module.
- If the value Query applies to tags with SL de-asserted is selected, when the RFID module performs a Query Operation, it will consider only those RFID tags that are currently visible to the RFID module AND that have SL flag de-asserted (i.e tags for which the SL flag has NOT been set using the Select command).
- If the value Query applies to tags with SL asserted is selected, when the RFID module performs a Query Operation, it will consider only those RFID tags that are currently visible to the RFID module AND that have SL flag asserted (i.e tags for which the SL flag HAS been set using the Select command).
Detail Information:
Key = wirelessRfidQuerySelect
Type = string
UI Choice | JSON Value |
---|---|
Query applies to all tags | 0 |
Query applies to tags with SL de-asserted | 2 |
Query applies to tags with SL asserted | 3 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Query Session
Select the Session that will be used by the RFID module to access RFID tags during a Query Operation.
Allowable values are SessionS0, SessionS1, SessionS2, and SessionS3.
Sessions provide options for how to count tags. For more information on the use of Sessions, consult the device product documentation.
Detail Information:
Key = wirelessRfidQuerySession
Type = string
UI Choice | JSON Value |
---|---|
SessionS0 | 0 |
SessionS1 | 1 |
SessionS2 | 2 |
SessionS3 | 3 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Query Target
Select how the A and B flags of RFID tags should be handled by the RFID module during a Query Operation.
- If the value Inventory Target Flag A is selected, when the RFID module performs a Query Operation, it will consider only those RFID tags that are currently visible to the RFID module AND that are in State A.
- If the value Inventory Target Flag B is selected, when the RFID module performs a Query Operation, it will consider only those RFID tags that are currently visible to the RFID module AND that are in State B.
- If the value AB Flip is selected, when the RFID module performs a Query Operation, it will consider only those RFID tags that are currently visible to the RFID module AND that are in either State A or State B and will Flip the State from A to B or B to A for the session.
Detail Information:
Key = wirelessRfidQueryTarget
Type = string
UI Choice | JSON Value |
---|---|
Inventory Target Flag A | 0 |
Inventory Target Flag B | 1 |
AB Flip | 2 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Transmit Power Level
Enter the RFID Power Level that should be used by the RFID module when transmitting.
The RFID Power Level should be specified in tenths of dBm in the range of 0 to 300, inclusive.
For example, to specify an RFID Power Level of 29.5 dBm, specify a value of 295.
Detail Information:
Key = wirelessRfidTransmitPowerLevel
Type = integer
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Wireless General Configuration
Use this Sub-group to configure Antenna Selection, Bluetooth Scanning State, GPS Power State, Location State, Network Monitored Popup, and Wi-Fi Scanning State.
Detail Information:
Key = wirelessConfig
Type = bundle
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Antenna Selection
Select which of multiple antennas should be used for wireless communications.
Detail Information:
Key = wirelessConfigAntennaSelection
Type = string
UI Choice | JSON Value |
---|---|
Internal | 1 |
External | 2 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Bluetooth Scanning State
Select whether Bluetooth scanning is to be used to improve location
- If the value Turn On is selected, system apps and services will detect Bluetooth devices and use them to improve location
- If the value Turn Off is selected, system apps and services will not detect Bluetooth devices and will not use them to improve location
Detail Information:
Key = wirelessConfigGpsBluetoothScanning
Type = string
UI Choice | JSON Value |
---|---|
Turn On | 1 |
Turn Off | 2 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
GPS Power State
Select whether the GPS radio state should be On or Off.
- If the value Off is selected, the GPS radio state will be turned off, preventing GPS-based location detection from being performed.
- If the value On is selected, the GPS radio state will be turned on, allowing GPS-based location detection to be performed, given satellite availability.
Detail Information:
Key = wirelessConfigGpsPowerState
Type = string
UI Choice | JSON Value |
---|---|
Off | 2 |
On | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Location State
Select whether to use location services.
- If the value Turn On is selected, location services will be active.
- If the value Turn Off is selected, location services will not be active.
Detail Information:
Key = wirelessConfigLocationState
Type = string
UI Choice | JSON Value |
---|---|
Turn On | 1 |
Turn Off | 2 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Network Monitored Popup
Select whether a Popup informing the User that their network may be monitored will be Allowed to be displayed.
- If the value Disallow is selected, a Popup informing the User that their network may be monitored will NOT be Allowed to be displayed.
- If the value Allow is selected, a Popup informing the User that their network may be monitored WILL be Allowed to be displayed.
Detail Information:
Key = wirelessConfigNetworkMayBeMonitoredPopup
Type = string
UI Choice | JSON Value |
---|---|
Disallow | 2 |
Allow | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Wi-Fi Scanning State
Select whether Wi-Fi scanning is to be used to improve location
- If the value Turn On is selected, system apps and services will detect Wi-Fi networks and use them to improve location
- If the value Turn Off is selected, system apps and services will not detect Wi-Fi networks and will not use them to improve location
Detail Information:
Key = wirelessConfigGpsWifiScanning
Type = string
UI Choice | JSON Value |
---|---|
Turn On | 1 |
Turn Off | 2 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Wireless LAN Configuration
Use this Sub-group to configure Auto Wakeup, Bands, Channels, Country, Verbose Logging, Hotspot, Advanced Options, Diagnostics Options, Fine Timing Measurement (FTM), and Network Notification.
Detail Information:
Key = wlanConfig
Type = bundle
Auto Wakeup
Select whether Wi-Fi (not the device) should Wake Up (turn on) automatically when the presence of a previously connected network is detected.
If the value Off is selected, automatic Wake Up will be turned OFF, preventing the device from detecting the presence of a previously connected network and automatically waking up to connect to it.
If the value On is selected, automatic Wake Up will be turned ON, allowing the device to periodically scan for and detect the presence of a previously connected network and automatically wake up to connect to it.
Detail Information:
Key = wlanAutoWakeup
Type = string
UI Choice | JSON Value |
---|---|
Off | 0 |
On | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Bands
Select the Frequency Bands on which the WLAN subsystem will operate.
- If the value 2.4GHz is selected, the WLAN subsystem will operate only on the 2.4 Gigahertz (Ghz) Frequency Band (used by 802.11b and 802.11g).
- If the value 5.0GHz is selected, the WLAN subsystem will operate only on the 5.0 Gigahertz (Ghz) Frequency Band (used by 802.11a).
- If the value Auto is selected, WLAN subsystem will Automatically determine the Frequency Bands on which to operate.
Detail Information:
Key = wlanBands
Type = string
UI Choice | JSON Value |
---|---|
2.4GHz | 2.4GHz |
5.0GHz | 5.0GHz |
Auto | Auto |
Channels
Enter the channels over which the WLAN subsystem will operate on a device.
The format of the value entered must be 64 characters or less and can specify one or more channels by separating values by commas and/or specifying ranges of values by separating the lower and upper range values with a dash (-). Some examples:
1,2,3
3,6,7-9,11-13
The actual channel that can specified depends on the value selected for Bands.
If the value 2.4GHz is selected for Bands, channels must be selected that are in the 2.4 Ghz band.
If the value 5.0GHz is selected for Bands, channels must be selected that are in the 5.0 Ghz band.
If the value Auto is selected Bands, channels may be selected that are in either band.
Note that individual countries may apply their own regulations regarding the channels that are allowable. Therefore, depending on the value selected for Country, not all channel values that could be specified for a given band may be allowable.
Detail Information:
Key = wlanChannels
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Country
Select the Country in which the WLAN subsystem will operate on a device:
- If the value Auto (Use 802.11d) is selected, the Country to be used will be determined automatically.
- When any other value is selected, the specified Country will be used.
Detail Information:
Key = wlanCountry
Type = string
UI Choice | JSON Value |
---|---|
Auto (Use 802.11d) | AUTO |
Algeria | DZ |
Anguilla | AI |
Argentina | AR |
Australia | AU |
Austria | AT |
Bahamas | BS |
Bahrain | BH |
Barbados | BB |
Belarus | BY |
Belgium | BE |
Bermuda | BM |
Bolivia | BO |
Bonaire | BQ |
Bosnia and Herzegovina | BA |
Brazil | BR |
Bulgaria | BG |
Canada | CA |
Cayman Islands | KY |
Chile | CL |
China | CN |
Christmas Island | CX |
Columbia | CO |
Costa Rica | CR |
Croatia | HR |
Curacao | CW |
Cyprus | CY |
Czech Republic | CA |
Denmark | DK |
Dominican Republic | DO |
Ecuador | EC |
Egypt | EG |
El Salvador | SV |
Estonia | EE |
Falkland Islands(Malvinas) | FK |
Finland | FI |
France | FR |
French Guiana | GF |
Germany | DE |
Greece | GR |
Guadelope | GP |
Guam | GU |
Guatemala | GT |
Guyana | GY |
Haiti | HT |
Honduras | HN |
HongKong | HK |
Hungary | HU |
Iceland | IS |
India | IN |
Indonesia | ID |
Ireland | IE |
Israel | IL |
Italy | IT |
Jamaica | JM |
Japan | JP |
Jordan | JO |
Kazakhstan | KZ |
Kenya | KE |
Korea Republic | KR |
Kuwait | KW |
Latvia | LV |
Lebanon | LB |
Liechtenstein | LI |
Lithuania | LT |
Luxembourg | LU |
Macedonia | MK |
Malaysia | MY |
Malta | MT |
Martinique | MQ |
Mexico | MX |
Montenegro | ME |
Morocco | MA |
Netherlands | AN |
Netherlands | NL |
NewZeaLand | NZ |
Nicaragua | NI |
Nigeria | NG |
Niue | NU |
Norfolk Islands | NF |
Northern Marina Islands | MP |
Norway | NO |
Oman | OM |
Pakistan | PK |
Panama | PA |
Paraguay | PY |
Peru | PE |
Philippines | PH |
Poland | PL |
Portugal | PT |
Puerto Rico | PR |
Qatar | QA |
Romania | RO |
Russian Federation | RU |
St. Maarten | SX |
Saudi Arabia | SA |
Serbia | RS |
Singapore | SG |
Slovakia | SK |
Slovenia | SI |
South Africa | ZA |
Spain | ES |
Sri Lanka | LK |
Sweden | SE |
Switzerland | CH |
Taiwan | TW |
Thailand | TH |
Trinidad and Tobago | TT |
Tunisia | TN |
Turkey | TR |
Ukraine | UA |
United Arab Emirates | AE |
United Kingdom | GB |
U.S.A. | US |
Uruguay | UY |
Venezuela | VE |
Vietnam | VN |
Virgin Islands(British) | VG |
Virgin Islands(US) | VI |
Verbose Logging
Select whether the Verbose Logging feature of the WLAN adapter should be turned ON or OFF on a device.
If the value Off is selected, the Verbose Logging will be turned OFF, preventing the device from logging additional information for debugging or troubleshooting WLAN issues.
If the value On is selected, the Verbose Logging will be turned ON, allowing the device to log additional information for debugging or troubleshooting WLAN issues.
Detail Information:
Key = wlanVerboseLogging
Type = string
UI Choice | JSON Value |
---|---|
Off | 0 |
On | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Hotspot Configuration
Use this Sub-group to configure Hotspot State, SSID, 2.4GHz Channel, 5GHz Channel, Band, Security Mode, and Security Passphrase.
Detail Information:
Key = wlanHotSpotOptions
Type = bundle
Hotspot State
Select the state of the Hotspot Mode of the WLAN adapter on a device.
If the value Off is selected, the Hotspot Mode will be turned OFF, preventing the device from sharing its Internet connection as a WLAN Hotspot. Any other existing configuration related to Hotspot Mode will not be affected, allowing Hotspot Mode to be configured and tested, turned OFF and back ON without having to reconfigure it.
If the value On is selected, the Hotspot Mode will be turned ON, allowing the device to share its Internet connection as a WLAN Hotspot, subject to appropriate configuration related to Hotspot Mode.
Detail Information:
Key = wlanHotSpotState
Type = string
UI Choice | JSON Value |
---|---|
Off | 0 |
On | 1 |
SSID
Enter the Service Set Identifier (SSID) that will identify the network supported in Hotspot Mode of the WLAN adapter on a device.
Detail Information:
Key = wlanHotSpotSSID
Type = string
2.4GHz Channel
Select the single 2.4 HGHz Channel in which Hotspot Mode of the WLAN adapter will operate on a device and should be specified when the value 2.4GHz is selected for Band.
Detail Information:
Key = wlanHotSpot24GHzChannel
Type = string
UI Choice | JSON Value |
---|---|
1 | 1 |
2 | 2 |
3 | 3 |
4 | 4 |
5 | 5 |
6 | 6 |
7 | 7 |
8 | 8 |
9 | 9 |
10 | 10 |
11 | 11 |
12 | 12 |
13 | 13 |
5GHz Channel
Select the single 5.0 HGHz Channel in which Hotspot Mode of the WLAN adapter will operate on a device when the value 5GHz is selected for Band.
Detail Information:
Key = wlanHotSpotBand5GhzChannel
Type = string
UI Choice | JSON Value |
---|---|
36 | 36 |
40 | 40 |
44 | 44 |
48 | 48 |
52 | 52 |
56 | 56 |
60 | 60 |
64 | 64 |
100 | 100 |
104 | 104 |
108 | 108 |
112 | 112 |
116 | 116 |
120 | 120 |
124 | 124 |
128 | 128 |
132 | 132 |
136 | 136 |
140 | 140 |
149 | 149 |
153 | 153 |
157 | 157 |
161 | 161 |
165 | 165 |
Band
Select the Frequency Band in which Hotspot Mode of the WLAN adapter will operate on a device.
- If the value 2.4GHz is selected, the Hotspot Mode of the WLAN adapter will operate solely in the 2.4 Gigahertz (GHz) Frequency Band and hence only devices capable of operating in that Frequency Band will be capable of sharing the Internet connection of the device via Hotspot Mode.
- If the value 5GHz is selected, the Hotspot Mode of the WLAN adapter will operate solely in the 5.0 Gigahertz (GHz) Frequency Band and hence only devices capable of operating in that Frequency Band will be capable of sharing the Internet connection of the device via Hotspot Mode.
Detail Information:
Key = wlanHotSpotBand
Type = string
UI Choice | JSON Value |
---|---|
2.4GHz | 0 |
5GHz | 1 |
Security Mode
Select the Security Mode to be used to secure the Hotspot Mode of the WLAN adapter will operate on a device.
- If the value Open is selected, the WLAN adapter will apply no security for Hotspot Mode, thus providing no control over which devices can connect and share the Internet connection of the device via Hotspot Mode.
- If the value WPA2/PSK is selected, the WLAN adapter will apply Wi-Fi Protected Access Version 2 (WPA2) Pre-shared Key (PSK) security for Hotspot Mode, thus providing some control over which devices can connect and share the Internet connection of the device via Hotspot Mode. You must also specify Security Passphrase to provide the PSK passphrase that will be used to secure the network.
Detail Information:
Key = wlanHotSpotSecurityMode
Type = string
UI Choice | JSON Value |
---|---|
Open | 0 |
WPA2/PSK | 1 |
Security Passphrase
Enter the PSK passphrase that will be used to secure the Hotspot Mode network implemented by the WLAN adapter on a device, when the value WPA2/PSK is selected for Security Mode.
Detail Information:
Key = wlanHotSpotSecurityPassphrase
Type = string
Advanced Options
Use this Sub-array to configure one or more Advanced Option(s).
Detail Information:
Key = wlanAdvancedOptions
Type = bundle_array
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Advanced Option
Use this Sub-group to configure Name, Custom Name, and Value.
Detail Information:
Key = wlanAdvancedOptionPair
Type = bundle
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Name
Select a standard name that identifies a single advanced option to be configured for the WLAN adapter on a device. You must also specify Value to provide the value to be set for the advanced option identified by the selected name.
Detail Information:
Key = wlanAdvancedOptionName
Type = string
UI Choice | JSON Value |
---|---|
AutoTimeConfig | AutoTimeConfig |
HFSR | HFSR |
CCKM | CCKM |
FT | FT |
FTRIC | FTRIC |
OKC | OKC |
PMKID | PMKID |
PreAuth | PreAuth |
PowerSave | PowerSave |
WLANPowerSave | WLANPowerSave |
AdvancedLogging | AdvancedLogging |
FIPS | FIPS |
EnableRestrictedSettingsUI | EnableRestrictedSettingsUI |
802.11K | 802.11K |
802.11w | 802.11w |
802.11ac | 802.11ac |
802.11n | 802.11n |
802.11v | 802.11v |
BandPreference | BandPreference |
FTOverTheDS | FTOverTheDS |
AggregatedFT | AggregatedFT |
ScanAssist | ScanAssist |
CHD | CHD |
SubNetRoam | SubNetRoam |
WANCountry | WANCountry |
PasswordProtectEncryption | PasswordProtectEncryption |
MACRandomization | MACRandomization |
CallAdmissionControl | CallAdmissionControl |
EnableAmpdu | EnableAmpdu |
GratuitousARP | GratuitousARP |
ChannelBondingMode2g | ChannelBondingMode2g |
WLANExtendedConfig | WLANExtendedConfig |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Custom Name
Enter a custom Name that identifies a single advanced option to be configured for the WLAN adapter on a device. You must also specify Value to provide the value to be set for the advanced option identified by the specified name.
Detail Information:
Key = wlanAdvancedOptionCustomName
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Value
Enter a value for a single advanced option to be configured for the WLAN adapter on a device and should be specified when Name or Custom Name are specified to provide the name of the advanced option.
Detail Information:
Key = wlanAdvancedOptionValue
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Diagnostics Options
Use this Sub-array to configure one or more Diagnostics Option(s).
Detail Information:
Key = wlanDiagnosticsOptions
Type = bundle_array
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Diagnostics Option
Use this Sub-group to configure Name, Custom Name, and Value.
Detail Information:
Key = wlanDiagnosticsOptionPair
Type = bundle
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Name
Select a Name that identifies a single standard Diagnostic Option to be configured for the WLAN adapter on a device. You must also specify Value to provide the value to be set for the Diagnostic Option identified by the specified name.
Detail Information:
Key = wlanDiagnosticsOptionName
Type = string
UI Choice | JSON Value |
---|---|
FusionAdvancedLogging | FusionAdvancedLogging |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Custom Name
Enter a custom name that identifies a single Diagnostic Option to be configured for the WLAN adapter on a device. You must also specify Value to provide the value to be set for the Diagnostic Option identified by the specified name.
Detail Information:
Key = wlanDiagnosticsOptionCustomName
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Value
Enter a value for a single Diagnostic Option to be configured for the WLAN adapter on a device. You must also specify Name or Name Custom to provide the name that identifies the Diagnostic Option to be set.
Detail Information:
Key = wlanDiagnosticsOptionValue
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Fine Timing Measurement (FTM) Configuration
Use this Sub-group to configure AP Deployment File, AP Source, Deployment Mode, and State.
Detail Information:
Key = wlanFTM
Type = bundle
Support Information:
- NOT supported on Device(s): TC20 and TC25.
AP Deployment File
Enter the AP Target path and file name which contains the AP coordinates used Fine Timing Measurement (FTM) used by the WLAN adapter.
Detail Information:
Key = wlanFTMAPFile
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
AP Source
Select the AP Source for Fine Timing Measurement (FTM) used by the WLAN adapter.
- if Location XML is selected, then AP Deployment File must also be entered.
Detail Information:
Key = wlanFTMAPSource
Type = string
UI Choice | JSON Value |
---|---|
Location XML | 0 |
Location from LCR/LCI | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Deployment Mode
Select the deployment mode for Fine Timing Measurement (FTM) used by the WLAN adapter.
Detail Information:
Key = wlanFTMDeploymentMode
Type = string
UI Choice | JSON Value |
---|---|
Standard (FTM enabled) | 0 |
Enhanced Infra (FTM-enabled) | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
State
Select whether to turn on (enable) or off (disable) Fine Timing Measurement (FTM) used by the WLAN adapter.
- If turned on (enabled) be sure to also specify Deployment Mode to provide the FTM mode to use and AP Source to provide the AP location source.
Detail Information:
Key = wlanFTMEnable
Type = string
UI Choice | JSON Value |
---|---|
Off | 1 |
On | 0 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Network Notification
Select whether the User will be notified about, and allowed to connect to, new WLANs that are detected.
If the value Off is selected, the User will NOT be notified about, nor allowed to connect to, new WLANs that are detected.
If the value On is selected, the User WILL be notified about, and allowed to connect to, new WLANs that are detected.
Detail Information:
Key = wlanNetworkNotification
Type = string
UI Choice | JSON Value |
---|---|
Off | 2 |
On | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Wireless WAN Configuration
Use this Sub-group to configure APNs, Data, Device Administrator Lock, Dual SIM Dual Standby, General, and eSIM Profiles.
Detail Information:
Key = wwanConfig
Type = bundle
Support Information:
- NOT supported on Device(s): TC20 and TC25.
APNs
Use this Sub-array to configure one or more Access Point Name(s) that can be used to connect to WWAN data services.
Detail Information:
Key = apns
Type = bundle_array
APN
Use this Sub-group to configure Name, Make Default, Access Point, User Name, Password, Port, Proxy, MMS Port, MMS Proxy, Server, MMSC, Type, MCC, MNC, Authentication Type, MVNO Type, Protocol, Roaming Protocol, and MVNO Match Data.
Detail Information:
Key = apn
Type = bundle
Name
Enter the name of an APN.
Detail Information:
Key = apnApnName
Type = string
Make Default
Select whether an APN should be the default APN.
If the value Yes is selected, the APN being will be the default APN and will be preferred over other APNs when establishing a cellular data connection.
If the value No is selected, the APN will not be the default APN.
Detail Information:
Key = apnMakeDefault
Type = string
UI Choice | JSON Value |
---|---|
Yes | 1 |
No | 0 |
Access Point
Enter a value that uniquely identifies an APN on the network when the value AddApn is selected for Action.
APN Identifiers are allocated by cellular carriers to identify the networks that can be reached via various APNs. When acquiring a cellular data plan from a carrier, an APN Identifier will be provided, typically along with other information that qualifies or controls access to the network it identifies.
Detail Information:
Key = apnCustomAccessPoint
Type = string
User Name
Enter a user name that can be used to authenticate to an APN.
A network accessed via a given APN Identifier may or may not require authentication. If authentication is required, a user name is generally always required and a password MAY also be required.
Detail Information:
Key = apnUserName
Type = string
Password
Enter a password that can be used to authenticate to an APN.
A network accessed via a given APN Identifier may or may not require authentication. If authentication is required, a user name is generally always required and a password MAY also be required.
Detail Information:
Key = apnCustomPassword
Type = string
Port
Enter the port number of an HTTP proxy to use for all traffic over the network accessed via an APN.
If a Proxy is required, a Port is also generally always required.
Detail Information:
Key = CustomPort
Type = string
Proxy
Enter the address or name of an HTTP proxy to use for all traffic over the network accessed via an APN.
- If a Proxy is required, a Port is also generally always required.
Detail Information:
Key = apnCustomProxy
Type = string
MMS Port
Enter the port number of an HTTP proxy to use ONLY for (Multimedia Messaging Service) MMS traffic over the network accessed via an APN when the value AddApn is selected for Action.
- If an MMS Proxy is required, an MMS Port is also generally always required.
Detail Information:
Key = apnCustomMmsPort
Type = string
MMS Proxy
Enter the address or name of an HTTP proxy to use ONLY for (Multimedia Messaging Service) MMS traffic over the network accessed via an APN.
- If an MMS Proxy is required, an MMS Port is also generally always required.
Detail Information:
Key = apnCustomMmsProxy
Type = string
Server
Enter a WAP Gateway Server address that should be used for an APN.
WAP Gateways are rarely, if ever, used on or supported by modern cellular carrier networks.
Detail Information:
Key = apnCustomServer
Type = string
MMSC
Enter the Multimedia Messaging Service Center (MMSC) address required to route MMS traffic over the network accessed via an APN when the value AddApn is selected for Action.
Detail Information:
Key = apnCustomMmsc
Type = string
Type
Enter the Type of APN.
The value to enter for Type should be obtained from the cellular carrier whose network is to be accessed via the APN.
Detail Information:
Key = apnCustomType
Type = string
MCC
Enter the Mobile Country Code (MCC) of the APN.
The MCC generally match the SIM Card being used or the APN will not be usable.
Detail Information:
Key = apnCustomMcc
Type = string
MNC
Enter the Mobile Network Code (MNC) of the APN.
The MNC generally match the SIM Card being used or the APN will not be usable.
Detail Information:
Key = apnCustomMnc
Type = string
Authentication Type
Select the Type of Authentication to be used for APN.
- If the value None is selected, No Authentication Protocol will be used to authenticate for the APN.
- If the value PAP is selected, the Password Authentication Protocol (PAP) will be used to authenticate for the APN.
- If the value CHAP is selected, the Challenge Handshake Authentication Protocol (CHAP) will be used to authenticate for the APN.
Detail Information:
Key = apnCustomAuthType
Type = string
UI Choice | JSON Value |
---|---|
None | 1 |
PAP | 2 |
CHAP | 3 |
MVNO Type
Enter the Mobile Virtual Network Operator (MVNO) Type to be used for APN .
- If the value None is selected, No MVNO will be used to configured for the APN.
- If the value SPN is selected, the MVNO will be specified via an SPN (Service Provider Name) value for the APN, which you must also specify via MVNO Match Data.
- If the value IMSI is selected, the MVNO will be specified via an IMSI (International Mobile Subscriber Identity) value for the APN, which you must specify via MVNO Match Data.
- If the value GID is selected, the MVNO will be specified via an GID (Group Identifier) value for the APN, which you must specify via MVNO Match Data.
- If the value ICCID is selected, the MVNO will be specified via an GID (Integrated Circuit Card ID) value for the APN, which you must specify via MVNO Match Data.
Detail Information:
Key = apnCustomMvnoType
Type = string
UI Choice | JSON Value |
---|---|
None | 1 |
SPN | 2 |
IMSI | 3 |
GID | 4 |
ICCID | 5 |
Protocol
Select the Protocol for an APN.
- If the value IPv4 is selected, IPv4 will be applied
- If the value IPv6 is selected, IPv6 will be applied
- If the value IPv4/IPv6 is selected, IPv4/IPv6 will be applied
Detail Information:
Key = apnCustomProtocol
Type = string
UI Choice | JSON Value |
---|---|
IPv4 | 1 |
IPv6 | 2 |
IPv4/IPv6 | 3 |
Roaming Protocol
Select the APN Roaming Protocol
- If the value IPv4 is selected, IPv4 will be applied
- If the value IPv6 is selected, IPv6 will be applied
- If the value IPv4/IPv6 is selected, IPv4/IPv6 will be applied
Detail Information:
Key = apnCustomRoamingProtocol
Type = string
UI Choice | JSON Value |
---|---|
IPv4 | 1 |
IPv6 | 2 |
IPv4/IPv6 | 3 |
MVNO Match Data
Enter the Mobile Virtual Network Operator (MVNO) Match Data to be used for an APN when a value other than None is selected for MVNO Type.
The exact value to be specified depends on the MVNO Type specified. Consult your MVNO carrier for information on the MVNO Type and MVNO Match Data value to be used.
Detail Information:
Key = apnCustomMvnoMatchData
Type = string
Data Configuration
Use this Sub-group to configure State, Service Type, Background Data, User Control of Background Data, Data Limit State, Data Limit State Custom Limit, User Control of Data Limit, and Data Warning Threshold.
Detail Information:
Key = dataConfig
Type = bundle
State
Select the Power State of the WWAN adapter.
- If the value Off is selected, the power to the WWAN adapter will be turned OFF, preventing all communications via the WWAN adapter and reducing battery drain.
- If the value On is selected, the power to the WWAN adapter will be turned ON, potentially allowing communications via the WWAN adapter and increasing battery drain.
Detail Information:
Key = wwanDataConfigState
Type = string
UI Choice | JSON Value |
---|---|
Off | 2 |
On | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Service Type
Select the service type to use on the WWAN adapter.
- If the value Data Only is selected, the service type of Data Only will be used.
- If the value Voice + Data is selected, the service type of Voice + Data will be used.
Detail Information:
Key = wwanDataConfigServiceType
Type = string
UI Choice | JSON Value |
---|---|
Data Only | 2 |
Voice + Data | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Background Data
Select whether use of WWAN Background Data will be Allowed.
- If the value Disallow is selected, use of WWAN Background Data will NOT be Allowed.
- If the value Allow is selected, use of WWAN Background Data WILL be Allowed.
Detail Information:
Key = wwanDataConfigBackgroundData
Type = string
UI Choice | JSON Value |
---|---|
Disallow | 2 |
Allow | 1 |
User Control of Background Data
Select whether the User will be Allowed to control whether WWAN data can be used in the background.
If the value Disallow is selected, the User will NOT be Allowed to control whether WWAN data can be used in the background.
If the value Allow is selected, the User WILL be Allowed to control whether WWAN data can be used in the background.
Detail Information:
Key = wwanDataConfigUserControlBackgroundData
Type = string
UI Choice | JSON Value |
---|---|
Disallow | 2 |
Allow | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Data Limit State
Select whether a limit should be imposed on the amount of WWAN data used, such as to control telecom expenses.
- If the value Enable and set default limit is selected, a default limit will be imposed on the amount of WWAN data that can be used.
- If the value Enable and set custom limit is selected, a custom limit will be imposed on the amount of WWAN data that can be used and you must also specify Custom Limit to provide the desired custom limit.
- If the value Disable is selected, no limit will be imposed on the amount of WWAN data that can be used.
Detail Information:
Key = wwanDataConfigLimitState
Type = string
UI Choice | JSON Value |
---|---|
Enable and set default limit | 1 |
Enable and set custom limit | 2 |
Disable | 3 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Data Limit State Custom Limit
Enter a custom limit that should be imposed on the amount of WWAN data used, such as to control telecom expenses, when the value Enable and set custom limit is selected for Data Limit State.
The custom limit should be an integer value specifying the maximum amount of WWAN data that can be used, in megabytes (MB).
Detail Information:
Key = wwanDataConfigCustomLimit
Type = integer
Support Information:
- NOT supported on Device(s): TC20 and TC25.
User Control of Data Limit
Select whether the User will be Allowed to control limits on how much data can be communicated using the WWAN adapter.
If the value Disallow is selected, the User will NOT be Allowed to control limits on how much data can be communicated using the WWAN adapter.
If the value Allow is selected, the User WILL be Allowed to control limits on how much data can be communicated using the WWAN adapter.
Detail Information:
Key = wwanDataConfigUserControlDataLimit
Type = string
UI Choice | JSON Value |
---|---|
Disallow | 2 |
Allow | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Data Warning Threshold
Enter a Threshold amount of WWAN data usage, where a Warning will be generated to the User if it is exceeded.
The threshold should be an integer value specifying the threshold amount of WWAN data, in megabytes (MB).
Detail Information:
Key = wwanDataConfigWarningThreshold
Type = integer
Device Administrator Lock Configuration
Use this Sub-group to configure State, Type, ICCID, Network List, Unlock Code, and Unlock Retry Count.
Detail Information:
Key = daLockConfig
Type = bundle
State
Select whether the WWAN adapter will be locked to a Device Administrator defined carrier. If the value Unlocked is selected, the WWAN adapter will NOT be locked to a Device Administrator-defined carrier. If the WWAN adapter was previously locked to a carrier, then you must also specify Type to identify the type of prior Lock to be Unlocked and you must also specify Unlock Code to provide the same Unlock Code provided when the prior Lock was performed.
- If the value Locked is selected, the WWAN adapter WILL be locked to a Device Administrator-defined carrier. You must specify Type, Unlock Code, Unlock Retry Count, and Network List to provide the detail information required to establish the Lock. You must also specify ICCID if the value ICCID Lock is selected for Type.
Detail Information:
Key = daLockConfigState
Type = string
UI Choice | JSON Value |
---|---|
Locked | 1 |
Unlocked | 2 |
Type
Select the Lock Type to be used to Lock the WWAN adapter to a Device Administrator-defined carrier when Locked is specified for State.
If the value Network Lock is selected, the WWAN adapter will be Locked to one or more carrier networks and Network List must be specified to identify those networks.
If the value ICCID Lock is selected, the WWAN adapter will be Locked to a SIM Card, identified by an Integrated Circuit Card Identifier (ICCID) and ICCID must be specified to identify that ICCID.
Detail Information:
Key = daLockConfigType
Type = string
UI Choice | JSON Value |
---|---|
Network Lock | 0 |
ICCID Lock | 1 |
ICCID
Enter the Integrated Circuit Card Identifier (ICCID) that identifies the SIM Card to which the WWAN adapter will be Locked when Locked is specified for State and ICCID Lock is specified for Type.
Detail Information:
Key = daLockConfigIccid
Type = string
Network List
Enter the Network List, as one or more MCC or MNC values, that identifies network(s) to which the WWAN adapter will be Locked when Locked is specified for State and Network Lock is specified for Type.
To provide multiple values, separate with commas (e.g. 1,310410,31012).
Detail Information:
Key = daLockConfigNetworkList
Type = string
Unlock Code
Enter a string value for the Unlock Code.
- When Locked is specified for State, an Unlock Code must be chosen, entered, and saved security, since it will be needed later to Unlock.
- When Unlocked is specified for State, the Unlock Code previously specified when the Lock was done must be entered in order to successfully Unlock.
Detail Information:
Key = daLockConfigUnlockCode
Type = string
Unlock Retry Count
Enter a integer value for the Unlock Retry Count when Locked is specified for State to configure the maximum number of unsuccessful Unlock attempts can be attempted before further attempts will be blocked.
Detail Information:
Key = daLockConfigUnlockRetryCount
Type = string
Dual SIM Dual Standby Configuration
Use this Sub-group to configure Subscription Mode, State, Automatic Subscription, and Manual Subscription.
Detail Information:
Key = dsdsConfig
Type = bundle
Support Information:
Supported on Operating System(s): Oreo and Android 10.
Supported on Device(s): L10, TC57, and TC77.
Subscription Mode
Select how Subscription Selection should be performed when the value On is selected for State.
If the value Automatic is selected, Automatic Subscription Selection will be used. You can specify the preferred SIM, and hence the preferred Subscription, to use for Data Communications, Voice Calls, and Text Messages collectively, by specifying Preferred Data Subscription SIM. If you do not specify a preferred Subscription, the Subscription for the primary SIM will be used as the preferred Subsciption. The preferred Subscription will be used as the current Subscription when it is in an In Service condition. When the current Subscription is in a sustained Out of Service condition, an automatic switch to the Subscription for the other SIM will be performed if that Subscription is in an In Service condition. You must specify Out of Service Timeout to provide the duration that the current Subscription must remain in an Out of Service condition before automatic switching to the other Subscription can occur.
If the value Manual is selected, Manual Subscription Selection will be used. You can select the preferred SIM, and hence the preferred Subscription, to use for Data Communications, Voice Calls, and Text Messages independently, by specifying Preferred Data Subscription SIM, Preferred Voice Call Subscription SIM, and Preferred Text Message Subscription SIM, respectively. If you do not specify a preferred Subscription for any service, then the Subscription for the primary SIM will be used as the preferred Subscription.
Detail Information:
Key = dsdsSubscriptionMode
Type = string
UI Choice | JSON Value |
---|---|
Manual | 2 |
Automatic | 1 |
Support Information:
Supported on Operating System(s): Oreo and Android 10.
Supported on Device(s): L10, TC57, and TC77.
State
Select whether the WWAN adapter will handle multiple SIM Card(s) in Dual SIM Dual Standby (DSDS) Mode.
If the value Off is selected, the WWAN adapter will NOT handle multiple SIM Cards in Single SIM Mode, which means that ONLY the Subscription for the currently selected SIM will be available for use. To use a different Subscription, a different SIM must be explicitly selected by specifying SIM Card Slot.
If the value On is selected, the WWAN adapter WILL handle multiple SIM Cards in Dual SIM Dual Standby Mode, which means that two SIM Cards, if present, can be active at the same time. This can be beneficial if the Subscriptions for those SIMs have different performance, pricing, coverage, etc. The default behavior in Dual SIM Dual Standby Mode is for Incoming Voice Calls and Incoming Text Messages to be received using BOTH Subscriptions, Outgoing Voice Calls and Outgoing Text Messages to ask the User which Subscription to use, and Data Communications to use the Subscription for the primary SIM. You can also use the Sub-group Dual SIM Dual Standby Configuration to modify the default behavior of Dual SIM Dual Standby Mode.
Detail Information:
Key = dsdsState
Type = string
UI Choice | JSON Value |
---|---|
Off | 2 |
On | 1 |
Support Information:
- Supported on Device(s): L10, TC57, and TC77.
Automatic Subscription Configuration
Use this Sub-group to configure Out of Service Timeout and Preferred Subscription SIM.
Detail Information:
Key = dsdsAutoConfig
Type = bundle
Support Information:
Supported on Operating System(s): Oreo and Android 10.
Supported on Device(s): L10, TC57, and TC77.
Out of Service Timeout
Enter a Duration (in seconds) that the Subscription for the current SIM must remain in an Out of Service condition before automatic switching to the Subscription for the other SIM may occur, when the value On is selected for State and the value Automatic is selected for Subscription Mode.
Detail Information:
Key = dsdsAutoConfigOutOfServiceTimeout
Type = integer
Support Information:
Supported on Operating System(s): Oreo and Android 10.
Supported on Device(s): L10, TC57, and TC77.
Preferred Subscription SIM
Select the SIM that identifies the Subscription to be used as the preferred Subscription, when the value On is selected for State and the value Automatic is selected for Subscription Mode.
The Subscription for the selected SIM will be the initial default Subscription to use and the preferred Subscription to use to if the Subscriptions for both SIMs are in an In Service condition.
Detail Information:
Key = dsdsAutoConfigPreferredSubscriptionSim
Type = string
UI Choice | JSON Value |
---|---|
SIM 1 | 1 |
SIM 2 | 2 |
Support Information:
Supported on Operating System(s): Oreo and Android 10.
Supported on Device(s): L10, TC57, and TC77.
Manual Subscription Configuration
Use this Sub-group to configure Preferred Data Subscription SIM, Preferred Voice Call Subscription SIM, and Preferred Text Message Subscription SIM.
Detail Information:
Key = dsdsManualConfig
Type = bundle
Support Information:
Supported on Operating System(s): Oreo and Android 10.
Supported on Device(s): L10, TC57, and TC77.
Preferred Data Subscription SIM
Select the SIM that identifies the Subscription to be used as the preferred Subscription for Data Communications, when the value On is selected for State and the value Manual is selected for Subscription Mode. If you do not specify a preferred Subscription, then the Subscription for the primary SIM will be used as the preferred Subscription.
Detail Information:
Key = dsdsManualConfigPreferredDataSubscriptionSim
Type = string
UI Choice | JSON Value |
---|---|
SIM 1 | 1 |
SIM 2 | 2 |
Support Information:
Supported on Operating System(s): Oreo and Android 10.
Supported on Device(s): L10, TC57, and TC77.
Preferred Voice Call Subscription SIM
Select the SIM that identifies the Subscription to be used as the preferred Subscription for Voice Calls, when the value On is selected for State and the value Manual is selected for Subscription Mode.
If the value Ask is selected, then no preferred Subscription for Voice Calls will be specified and the User will be asked each time an Outgoing Voice Call is initiated.
If the value SIM 1 or SIM 2 is selected, then the Subscription for the selected SIM will be used as the preferred Subscription for Voice Calls and the User will NOT be asked each time an Outgoing Voice Call is initiated.
Detail Information:
Key = dsdsManualConfigPreferredVoiceCallSubscriptionSim
Type = string
UI Choice | JSON Value |
---|---|
Ask | 1 |
SIM 1 | 2 |
SIM 2 | 3 |
Support Information:
Supported on Operating System(s): Oreo and Android 10.
Supported on Device(s): L10, TC57, and TC77.
Preferred Text Message Subscription SIM
Select the SIM that identifies the Subscription to be used as the preferred Subscription for Text Messages, when the value On is selected for State and the value Manual is selected for Subscription Mode.
If the value Ask is selected, then no preferred Subscription for Text Messages will be specified and the User will be asked each time an Outgoing Text Message is initiated.
If the value SIM 1 or SIM 2 is selected, then the Subscription for the selected SIM will be used as the preferred Subscription for Text Messages and the User will NOT be asked each time an Outgoing Text Messages is initiated.
Detail Information:
Key = dsdsManualConfigPreferredTextMessageSubscriptionSim
Type = string
UI Choice | JSON Value |
---|---|
Ask | 1 |
SIM 1 | 2 |
SIM 2 | 3 |
Support Information:
Supported on Operating System(s): Oreo and Android 10.
Supported on Device(s): L10, TC57, and TC77.
General Configuration
Use this Sub-group to configure State, User Control of State, SIM Card Slot, User Control of Sim Card Slot, Public Land Mobile Network Lock State, Public Land Mobile Network Lock Value, and User Control of Public Land Mobile Network Lock.
Detail Information:
Key = generalConfig
Type = bundle
State
Select the Power State of the WWAN Adapter.
A given device may or may not support a WWAN Adapter. An attempt to configure the WWAN Adapter on a device that does not have one will result in an error.
Detail Information:
Key = wwanGeneralConfigState
Type = string
UI Choice | JSON Value |
---|---|
Off | 2 |
On | 1 |
User Control of State
Select whether the User will be Allowed to change the WWAN Power State.
- If the value Disallow is selected, the User will NOT be Allowed to change the WWAN Power State.
- If the value Allow is selected, the User WILL be Allowed to change the WWAN Power State.
Detail Information:
Key = wwanGeneralConfigUserControlState
Type = string
UI Choice | JSON Value |
---|---|
Disallow | 2 |
Allow | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
SIM Card Slot
Select the SIM Card slot that will be used by the WWAN adapter.
A given device may or may not support a WWAN Adapter. An attempt to configure the WWAN Adapter on a device that does not have one will result in an error.
A given device may have a limited number of SIM Card slots. An attempt to configure the WWAN Adapter to use an unsupported SIM Card slot will result in an error.
A given device may support a given SIM car slot, but that SIM car slot may not contain a SIM Card. An attempt to configure the WWAN Adapter to use a supported but unpopulated SIM Card slot will result in an error.
If the value Slot 1 is selected, the WWAN adapter will attempt to use the SIM Card slot designated as Slot 1.
If the value Slot 2 is selected, the WWAN adapter will attempt to use the SIM Card slot designated as Slot 2.
If the value Slot 3 is selected, the WWAN adapter will attempt to use the SIM Card slot designated as Slot 3.
If the value Slot 4 is selected, the WWAN adapter will attempt to use the SIM Card slot designated as Slot 4.
Detail Information:
Key = wwanGeneralConfigSimCardSlot
Type = string
UI Choice | JSON Value |
---|---|
Slot 1 | 1 |
Slot 2 | 2 |
Slot 3 | 3 |
Slot 4 | 4 |
User Control of Sim Card Slot
Select whether the User will be allowed to select which WWAN SIM slot will be used.
- If the value Disallow is selected, the User will NOT be allowed to select which WWAN SIM slot will be used.
- If the value Allow is selected, the User WILL be allowed to select which WWAN SIM slot will be used.
Detail Information:
Key = wwanGeneralConfigUserControlSimCardSlot
Type = string
UI Choice | JSON Value |
---|---|
Disallow | 2 |
Allow | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Public Land Mobile Network Lock State
Select whether the WWAN adapter will be locked to a single Public Land Mobile Network Lock (PLMN).
- If the value Off is selected, the WWAN adapter will be locked to a single Public Land Mobile Network Lock (PLMN).and hence will be free to connect to any PLMN that is compatible with the SIM Card being used.
- If the value On is selected, the WWAN adapter will be locked to a single Public Land Mobile Network Lock (PLMN) and hence will only be able to connect to the PLMN to which it is locked. You must also specify Value to provide the value that identifies the PLMN to which the WWAN adapter will be locked.
Detail Information:
Key = wwanGeneralConfigPlmnLockState
Type = string
UI Choice | JSON Value |
---|---|
Off | 2 |
On | 1 |
Public Land Mobile Network Lock Value
Enter the value that identifies the Public Land Mobile Network Lock (PLMN) to which the WWAN adapter will be locked when the value On is selected for Public Land Mobile Network Lock State.
The value provided to identify a PLMN must specify both the Mobile Country Code (MCC) and the Mobile Network Code (MNC). Since all MCC values are three digits and MNC values can be 2 or 3 digits, the value provided must be of the format XXXYY or XXXYYY, where XXX is the three digit MCC value and YY or YYY is the 2 or 3 digit MNC value.
Detail Information:
Key = wwanGeneralConfigPlmnLockValue
Type = string
User Control of Public Land Mobile Network Lock
Select whether the User will be Allowed to control locking of the WWAN adapter to a single Public Land Mobile Network (PLMN).
- If the value Disallow is selected, the User will NOT be Allowed to control locking of the WWAN adapter to a single Public Land Mobile Network (PLMN).
- If the value Allow is selected, the User WILL be Allowed to control locking of the WWAN adapter to a single Public Land Mobile Network (PLMN).
Detail Information:
Key = wwanGeneralConfigUserControlPlmnLock
Type = string
UI Choice | JSON Value |
---|---|
Disallow | 2 |
Allow | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
eSIM Profiles
Use this Sub-array to configure one or more eSIM Profile(s).
Detail Information:
Key = esimProfiles
Type = bundle_array
eSIM Profile
Use this Sub-group to configure Activation Code, Nickname, State, SIM Slot ID, SM-DP+ Slot ID, and SM-DP+ Address.
Detail Information:
Key = esimProfile
Type = bundle
Activation Code
Enter the Activation Code for an eSIM Profile.
Detail Information:
Key = eSimActivationCode
Type = string
Nickname
Enter a Profile Nickname for an eSIM Profile.
Detail Information:
Key = esimProfileNickname
Type = string
State
Select the State (On/Off) of an eSIM Profile.
- if the value Off is selected, the State the eSIM Profile will NOT be available for use.
- if the value On is selected, the State the eSIM Profile WILL be available for use.
Detail Information:
Key = esimState
Type = string
UI Choice | JSON Value |
---|---|
Off | 2 |
On | 1 |
SIM Slot ID
Select the SIM Slot ID to be used for an eSIM Profile.
Detail Information:
Key = esimProfileSlotId
Type = string
UI Choice | JSON Value |
---|---|
SIM1 | 0 |
SIM2 | 1 |
SM-DP+ Slot ID
Select the SM-DP+ Slot ID for an eSIM Profile.
Detail Information:
Key = esimSmdpSlotId
Type = string
UI Choice | JSON Value |
---|---|
SIM1 | 0 |
SIM2 | 1 |
SM-DP+ Address
Enter the SM-DP+ Address for an eSIM Profile.
Detail Information:
Key = esimSmdpAddress
Type = string
Worry Free WiFi Configuration
Use this Sub-group to configure State, Analysis, Coverage View, Global Settings, and Packet Capture.
Detail Information:
Key = worryFreeWiFiConfig
Type = bundle
Support Information:
NOT supported on Device(s): TC20 and TC25.
Supported from: MX 8.1.
State
Select whether Worry Free WiFi features will be used.
- If the value Off is selected, Worry Free WiFi features will NOT be used.
- If the value On is selected, Worry Free WiFi features MAY be used, if their individual controls are used.
Detail Information:
Key = wfWiFiState
Type = string
UI Choice | JSON Value |
---|---|
Off | 0 |
On | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Analysis Configuration
Use this Sub-group to configure State, Type, Voice Duration, Voice Packet Filtering Rule, Mode, SSID, Session Name, Logger Report Level, Ping Type, Remote Gateway Custom Server Address, Remote Gateway Type, SD Card Storage, and Session Storage Duration.
Detail Information:
Key = netWfwAnalysis
Type = bundle
Support Information:
- NOT supported on Device(s): TC20 and TC25.
State
Select the State of Analysis.
- If the value On is selected, a Worry Free WiFi Analysis Session will be started, if on is not already in progress. You may also need to specify some or all of the following:
- If the value Off is selected, any Worry Free WiFi Analysis Session that is in progress will be terminated.
Detail Information:
Key = wfWiFiAction
Type = string
UI Choice | JSON Value |
---|---|
On | 0 |
Off | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Type
Select the Analysis Type that will be used by Worry Free WiFi .
- If the value Roam is selected, Worry Free WiFi will perform analysis designed to troubleshoot and optimize WiFi operations related to roaming.
- If the value Voice is selected, then Worry Free WiFi will perform analysis designed to troubleshoot and optimize WiFi operations related to voice communications.
- If the value Connection is selected, then Worry Free WiFi will perform analysis designed to troubleshoot and optimize WiFi operations related to establishing connections.
Detail Information:
Key = wfWiFiAnalysisType
Type = string
UI Choice | JSON Value |
---|---|
Roam | 0 |
Voice | 1 |
Connection | 2 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Voice Duration
Enter the Duration (HH:MM:SS) that an Analysis Session started by Worry Free WiFi will run, when the value !!0@wirelessAndNetworkConfig.worryFreeWiFiConfig.netWfwAnalysis.netWfwAnalysisType!! or !!1@wirelessAndNetworkConfig.worryFreeWiFiConfig.netWfwAnalysis.wfWiFiAnalysisType!! is selected for Type. The value entered must be of the format HH:MM:SS, where HH is the integral number of hours, MM is the integral number of minutes, and SS is the integral number of seconds.
Detail Information:
Key = wfWiFiAnalysisTypeRoamVoiceAnalysisDuration
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Voice Packet Filtering Rule
Enter the Filtering Rule that will limit the capture of Session data to a specific voice packet type, when the value Voice is selected for Type. TBD.
Detail Information:
Key = wfWiFiAnalysisTypeVoicePacketFilteringRule
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Mode
Select the Analysis Mode for an Analysis Session started by Worry Free WiFi.
- If the value Active is selected, Active Analysis will be performed during the Analysis Session.
- If the value Passive is selected, Passive Analysis will be performed during the Analysis Session.
Detail Information:
Key = wfWiFiActionStartActivityMode
Type = string
UI Choice | JSON Value |
---|---|
Active | 0 |
Passive | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
SSID
Enter the network that will be used for an Analysis Session started by Worry Free WiFi.
Note that if an Analysis Session is started for a network other than the currently configured network, the currently connected network will be disconnected so the specified network can be connected for use by the Analysis Session.
Detail Information:
Key = wfWiFiActionStartAnalysisSSID
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Session Name
Enter the name of the Analysis Session to be started by Worry Free WiFi.
The name assigned to an Analysis Session can help to analyze exported data by identifying the Analysis Session during which the data was collected.
Detail Information:
Key = wfWiFiActionStartSessionName
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Logger Report Level
Select the Logger Report Level for an Analysis Session started by Worry Free WiFi.
- If the value Info is selected, all available data will be logged, including data that is informational as well as data related to warnings or errors that are detected.
- If the value Warning is selected, only data that is related to warnings or errors that are detected will be logged.
- If the value Error is selected, only data that is related to errors that are detected will be logged.
Detail Information:
Key = wfWiFiActionStartLoggerReportLevel
Type = string
UI Choice | JSON Value |
---|---|
Info | 0 |
Warning | 1 |
Error | 2 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Ping Type
Select the Ping Type for an Analysis Session started by Worry Free WiFi.
- If the value No Data is selected, Pings sent during the Analysis Session that is started will include no data.
- If the value Data Ping is selected, Pings sent during the Analysis Session that is started will include data.
Detail Information:
Key = wfWiFiActionStartPingType
Type = string
UI Choice | JSON Value |
---|---|
No Data | 0 |
Data Ping | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Remote Gateway Custom Server Address
Enter the Custom Remote Gateway Server Address for an Analysis Session started by Worry Free WiFi, when the value Custom is selected for Remote Gateway Type.
Detail Information:
Key = wfWiFiActionStartRemoteGatewayTypeCustomServerAddress
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Remote Gateway Type
Select the Remote Gateway Type for an Analysis Session started by Worry Free WiFi.
- If the value Default is selected, the Default Remote Gateway will be used.
- If the value Custom is selected, a custom Remote Gateway will be used and you must also specify Remote Gateway Custom Server Address to provide the desired custom Gateway Server Address.
Detail Information:
Key = wfWiFiActionStartRemoteGatewayType
Type = string
UI Choice | JSON Value |
---|---|
Default | 0 |
Custom | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
SD Card Storage
Select how SD Card Storage will be used for an Analysis Session started by Worry Free WiFi.
- If the value Only Live Data is selected, only the most recent data from the new Analysis Session will be stored in the SD Card and will replace any prior Analysis Session data stored.
- If the value Delete old Ping and Packet Data is selected, old Ping and Packet Data will be deleted and replaced by any new Ping and Packet Data for the new Analysis Session.
- Deprecated: If the value Delete Old Sessions(Deprecated) is selected, any data generated by any prior Analysis Sessions will be deleted and replace by the data from the newAnalysis Session.
Detail Information:
Key = wfWiFiActionStartSdCardStorage
Type = string
UI Choice | JSON Value |
---|---|
Only Live Data | 0 |
Delete old Ping and Packet Data | 1 |
Delete Old Sessions(Deprecated) | 2 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Session Storage Duration
Enter the maximum Duration (HH:MM:SS) of Session data to be captured and Stored during Server Analytics performed during a Session started by Worry Free WiFi, when the value Delete old Ping and Packet Data is selected for SD Card Storage. The value entered must be of the format HH:MM:SS, where HH is the integral number of hours, MM is the integral number of minutes, and SS is the integral number of seconds.
Detail Information:
Key = wfWiFiActionStartSessionStorageDuration
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Coverage View
Use this Sub-group to configure Scan Feature Type, State, Scan Interval, SSID, Auto Reachability Test, Session Name, and SD Card Storage.
Detail Information:
Key = wfWiFiCoverageView
Type = bundle
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Scan Feature Type
Select the Scan Feature Type that will control the type of Scanning that will be performed by Worry Free WiFi as part of Coverage View.
- If the value Coverage View is selected, Worry Free WiFi will perform full scanning as required to support Coverage View.
- If the value Scan is selected, Worry Free WiFi will perform more limited scanning.
Detail Information:
Key = wfWiFiScanFeatureType
Type = string
UI Choice | JSON Value |
---|---|
Coverage View | 1 |
Scan | 2 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
State
Select the State of Coverage View.
If the value On is selected, Worry Free WiFi Coverage View will be enabled. You may also need to specify some or all of the following:
Scan Interval to specify the Scan Interval to use for Coverage View.
SSID to specify the SSID to use for Coverage View.
Auto Reachability Test to specify whether an Auto Reachability Test should be performed as part of Coverage View.
Auto Reachability Test to specify whether Server Analytics should be performed as part of Coverage View.
Session Name to specify the Session Name to use for Coverage View.
- Session Name to specify whether SD Card Storage will be used for Coverage View.
If the value Off is selected, Worry Free WiFi Coverage View will be disabled.
Detail Information:
Key = wfWiFiCoverageViewAction
Type = string
UI Choice | JSON Value |
---|---|
On | 0 |
Off | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Scan Interval
Enter the Scan Interval to be used for by Worry Free WiFi for Coverage View.
Detail Information:
Key = wfWiFiCoverageViewActionStartScanInterval
Type = integer
Support Information:
- NOT supported on Device(s): TC20 and TC25.
SSID
Enter the SSID that identifies the network to be used by Worry Free WiFi for Coverage View.
Detail Information:
Key = wfWiFiCoverageViewActionStartSsid
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Auto Reachability Test
Select whether an Auto Reachability Test will be performed by Worry Free WiFi as part of Coverage View.
- If the value Off is selected, Worry Free WiFi will NOT perform an Auto Reachability Test as part of Coverage View each time a Roam occurs.
- If the value On is selected, Worry Free WiFi will perform an Auto Reachability Test as part of Coverage View each time a Roam occurs.
Detail Information:
Key = wfWiFiCoverageViewActionStartAutoReachabilityTest
Type = string
UI Choice | JSON Value |
---|---|
Off | 0 |
On | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Session Name
Enter a Session Name that should be used by Worry Free WiFi as part of Coverage View, when the value On is selected for State.
Detail Information:
Key = wfWiFiCoverageViewActionStartSessionName
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
SD Card Storage
Select how SD Card Storage is used for an Analysis Session started by Worry Free WiFi as part of Coverage View, when the value !!1@wirelessAndNetworkConfig.worryFreeWiFiConfig.netWfwState!! is selected for State.
- If the value !!0!! is selected, only the most recent data from the new Analysis Session will be stored in the SD Card and will replace any prior Analysis Session data stored.
- If the value !!1!! is selected, old Ping and Packet Data will be deleted and replaced by any new Ping and Packet Data for the new Analysis Session.
- Deprecated: If the value !!2!! is selected, any data generated by any prior Analysis Sessions will be deleted and replace by the data from the newAnalysis Session.
Detail Information:
Key = wfWiFiCoverageViewActionStartSdCardStorage
Type = string
UI Choice | JSON Value |
---|---|
Only Live Data | 0 |
Delete old Ping and Packet Data | 1 |
Delete old Sessions(Deprecated) | 2 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Global Settings
Use this Sub-group to configure Temporary Password State, Administrative Password, Existing Password, Temporary Password, Duration, and User Access to Configuration UI.
Detail Information:
Key = wfWiFiGlobalSettings
Type = bundle
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Temporary Password State
Select whether the User will be Allowed to use a Temporary Password to Access sensitive sections of the Worry Free WiFi UI.
- If the value Disallow is selected, the User will NOT be Allowed to use a Temporary Password to Access sensitive sections of the Worry Free WiFi UI.
- If the value Allow is selected, the the User WILL be Allowed to use a Temporary Password to Access sensitive sections of the Worry Free WiFi UI and you must also specify Temporary Password and Duration to provide the Temporary Password Value and the Duration during which the Temporary Password may be used.
Detail Information:
Key = wfWiFiTemporaryPasswordState
Type = string
UI Choice | JSON Value |
---|---|
Disallow | 0 |
Allow | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Administrative Password
Enter an Administrative Password that can be shared with Trusted Users to provide full access to configure Worry Free WiFi.
An Administrative Password:
Must be configured before Worry Free WiFi features can be used.
Must have a length of 8-32 characters, consisting of A-Z, a-z, 0-9, underscore (_), pound (#) and dollar sign ($).
Never expires.
Can be provided to Trusted Users to allow them unrestricted access to configure Worry Free WiFi.
Will be used to generate an Encryption Key to encrypt data produced by Worry Free WiFi.
Will also be needed off-device to decrypt data produced and encrypted by Worry Free WiFi.
Will also be needed to subsequently change the Administrative Password.
Detail Information:
Key = wfWiFiPassword
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Existing Password
Enter the Existing Administrative Password to allow a new Administrative Password to be specified.
The Existing Administrative Password:
Must be specified whenever a new Administrative Password is specified to change (replace) the Existing Administrative Password.
If specified, must match the value of the most recently specified Administrative Password.
Detail Information:
Key = wfWiFiExistingPassword
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Temporary Password
Enter a Temporary Password that can be shared with a User to be used to provide temporary and limited access to configure Worry Free WiFi.
If specified, a Temporary Password:
Must have a length of 8-32 characters, consisting of A-Z, a-z, 0-9, underscore (_), pound (#) and dollar sign ($).
Can be provided to less-trusted Users to allow them to configure Worry Free WiFi to collect packets without having to share the Administrative Password.
Be used to generate an Encryption Key to encrypt collected packets.
Will also be needed off-device to decrypt packets collected and encrypted by Worry Free WiFi.
Detail Information:
Key = wfWiFiTemporaryPassword
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Duration
Enter a duration (in hours) that a specified Temporary Password will be valid and after which it will expires and need to be replaced with a new one.
Detail Information:
Key = wfWiFiTemporaryPasswordDuration
Type = integer
Support Information:
- NOT supported on Device(s): TC20 and TC25.
User Access to Configuration UI
Select whether the User will be Allowed to Access the UI to configure Worry Free WiFi features.
- If the value Disallow is selected, the User will NOT be Allowed to Access the UI to configure Worry Free WiFi features, even if they can enter the Password configured via Administrative Password.
- If the value Allow is selected, the User WILL be Allowed to Access the UI to configure Worry Free WiFi features, if they can enter the Password configured via Administrative Password.
Detail Information:
Key = wfWiFiDeviceUserControl
Type = string
UI Choice | JSON Value |
---|---|
Disallow | 0 |
Allow | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Packet Capture
Use this Sub-group to configure State, File Name, Max File Size, Packet Type, and State On Max Storage Size.
Detail Information:
Key = wfWiFiPacketCapture
Type = bundle
Support Information:
- NOT supported on Device(s): TC20 and TC25.
State
Select whether Packet Capture will be performed by Worry Free WiFi.
- If the value Off is selected, Packet Capture will NOT be performed by Worry Free WiFi. This can significantly the decrease the utilization of device resources and decrease battery drain, but will provide less data that can be used for troubleshooting.
- If the value On is selected, Packet Capture WILL be performed by Worry Free WiFi. This can significantly increase utilization of device resources and increase battery drain, but will provide additional data that can be used for troubleshooting.
Detail Information:
Key = wfWiFiPacketCaptureState
Type = string
UI Choice | JSON Value |
---|---|
Off | 0 |
On | 1 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
File Name
Enter the file name of the file in the Device File System into which Packet Capture data will be stored by Worry Free WiFi, when the value On is selected for State.
Detail Information:
Key = wfWiFiPacketCaptureStateOnFileName
Type = string
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Max File Size
Enter the maximum size (in megabytes) of the Packet Capture data that will be stored into a file in the Device File System by Worry Free WiFi, when the value On is selected for State.
Detail Information:
Key = wfWiFiPacketCaptureStateOnMaxFileSize
Type = integer
Support Information:
- NOT supported on Device(s): TC20 and TC25.
Packet Type
Select the Package Capture Type that will be determine the type of Packets that will be captured by Worry Free WiFi, when the value On is specified for State.
- If the value Management Only is selected, Worry Free WiFi will only capture Management Packets.
- If the value All is selected, Worry Free WiFi will capture ALL Packets, including Packets that might contain sensitive data.
Detail Information:
Key = wfWiFiPacketCaptureType
Type = string
UI Choice | JSON Value |
---|---|
Management Only | 1 |
All | 2 |
Support Information:
- NOT supported on Device(s): TC20 and TC25.
State On Max Storage Size
Enter the maximum size (in megabytes) of the Packet Capture data that will be stored in all files in the Device File System by Worry Free WiFi, when the value On is selected for State.
Detail Information:
Key = wfWiFiPacketCaptureStateOnMaxStorageSize
Type = integer
Support Information:
- NOT supported on Device(s): TC20 and TC25.