Skip to main content

Key Remapping

This page allows the user to reassign the keycodes of physical buttons of a Datalogic device to: other keycodes, text, broadcast an intent, or perform advanced scripted actions.

Key Remapping starting screen

Supported devices and firmware

Unsupported Devices

Memor 10, Memor 1, Memor K, and Joya Touch A6 devices are not supported

DeviceOS VersionMinimum Firmware Version
Memor 35/35X131.07.001
Memor 30/30X131.07.001
Memor 1111
13
1.09.19
2.01.04
Skorpio X5134.04.004
Memor 20134.04.004

Actions

At the top of the Key Remapping page there are a few actions that can be performed to assist managing the key remappings of Datalogic devices.

Import Key Remapping

To import a key remapping JSON file, click the the Import Key Remapping button. Key remapping JSON files can be exported from supported Datalogic devices by going to Datalogic Settings -> Keyboard & touch -> View all remapped keys, then pressing the vertical ellipsis and selecting Export mapping data.

Export Key Remapping JSON File

The remapping file can then be found in the sdcard/Documents/DLKeyRemapStorage folder.

Export Key Remapping

To export a key remapping JSON file, click the the Export Key Remapping button. Key remapping JSON files can be installed through the com.datalogic.device.intent.action.keyremap.INSTALL intent with the following extras:

NameTypeDescription
com.datalogic.device.intent.extra.keyremap.JSON_PATHstringFile path to key remapping JSON file to install.
com.datalogic.device.intent.extra.keyremap.REMOVE_CURRENT_CONFIGURATIONbooleanIf true, clear previously configured key remappings.

Additionally, the key remapping JSON file can be imported into other Scan2Deploy profiles, as well as manually on the device by going to Datalogic Settings -> Keyboard & touch -> View all remapped keys, then pressing the vertical ellipsis and selecting Import mapping data.

Remove existing key remappings

If checked, then any existing key remappings on a device are removed when the profile is applied.

note

Removing key remappings also applies to any key remapping definitions created in the Device Settings page.

Define Key Remappings

A list of key remappings that map input keycodes to a given output.

Input Options

The Input controls of the Key Remapping panel contains a selector that tabs through four different groupings of keycodes: Common, which contains keycodes that are often found on Datalogic devices; Alphanumeric, which contains keycodes 0-9 and A-Z; Symbols, which contains various symbols found on a keyboard; and Function, which contains F keys F1-F24. By default the input value is the common keycode SCAN R.

Key Remap input options

Output Options

The Output controls of the Key Remapping panel contains a selector that tabs through the four different options available: Keycode, output a given keycode with optional meta states; Text, output a given string; Intent, broadcast a given intent; and Script, output a sequence of given outputs and events. By default the output value is the keycode value BARCODE.

Key Remap output options

Intent

The Intent output option configures an intent to be broadcast. There are three different types of methods to configure the intent, the are:

TypeDescription
ApplicationPick an app to start the default activity of.
URIWrite or paste an intent into a text field.
Custom IntentUse a form to build an intent.

Script

The Script output option maps an ordered set of actions to one or more key events of a button with the given input's keycode value. On the device this section is referred to as Advanced configuration. A input trigger event can be added by pressing the button and the available events are:

Input Trigger EventTrigger Description
Every pressInput key is pressed down.
Every releaseInput key is released.
On long pressInput key is released after being held down longer than the long press timeout interval.
On very long pressInput key is released after being held down longer than the very long press timeout interval.
On single pressInput key is pressed once.
On double pressInput key is pressed multiple times.

Each of these input trigger events can have a sequential list of script output actions associated with them, which are initiated when the trigger event occurs. A script output action can be added by pressing the button and the available actions are:

Script Output ActionsDescription
Key ActionSimulate a button's key action with a given keycode value and meta states. Key action options are Down & Up, Down, and Up.
IntentBroadcast a given intent.
TextOutput a given string.
DelayDelay the next action by a given number of milliseconds.

Additionally, the timing configuration dictating the behavior of the input trigger events can be configured by clicking the button. The configurable parameters are:

Timing ParameterDescription
Long Press Timeout LengthThe length in milliseconds of the long press timeout interval, for the On long press trigger event.
Very Long Press Timeout LengthThe length in milliseconds of the very long press timeout interval, for the On very long press trigger event.
Max Interval between DOWN / UP of MultipressThe length in milliseconds of the amount of time allowed between two key presses, to determine if they are two On single press trigger events, or a single On double press trigger event.
Max Interval between each MultipressThe length in milliseconds of the amount of time allowed between consecutive On double press trigger events.

Add Remap

To add an additional key remapping, click the the Add remap button.