Advanced Keyboard Page

This page allows the user to configure the physical and virtual buttons available in specific Datalogic devices.

Supported devices and firmware

The following table shows the devices that support this feature, with their minimum OS and firmware version.

Device	Minimum OS Version	Minimum Firmware Version
Joya Touch 22	11	1.05.001
Memor 11	11	1.03.07
Memor 20	11	3.18.001
Memor 3x	13	1.00.001
Skorpio X5	10	3.18.001

Keyboard

The image below shows the initial view of the Advanced Keyboard page for a Skorpio X5 device. It provides a visual representation of the different keyboard layouts and keys available for customization.

The controls above the keyboard provide the following functionality:

• Select the Keyboard type to customize (options depend upon the currently selected device).

  warning

  Advanced keyboard configuration will not apply on the device if the incorrect Keyboard type is selected. Additionally, any current customization on this page will be removed if the Keyboard selection is changed.

• Select the Layout to customize. The Default layout is always present, but it is possible to create up to 8 additional layouts with the add button . The currently selected layout can be deleted with the remove button .

  tip

  To enable access to different layouts on the device, keys can be mapped to switch to the desired layout.

• Reset the keyboard configuration with the delete button . This will remove all layout and key customizations and restore the default keyboard setup.

• Configure additional keyboard information and settings with the options button .

Key Customization

Modifications to the keys can be made by hovering over one the keyboard keys and clicking it to open a configuration dialog. Within this dialog, the key types and values can be modified, or the key can be reset back to its default value. The various Keycode Type options available for remapping key values are explained in further detail below.

Standard Keycode

The standard remapping option provides a list of common keycodes that can be chosen from. The list includes many universal key events (descriptions can be found in the Android documentation) as well as some Datalogic specific options, such as the SCAN keys that trigger a scan when pressed.

tip

Keys can be mapped to an empty keycode so that no value is sent as a result of a key press / release.

Unicode Keycode

Unicode remapping grants the ability to remap a key to a specified UTF-16 unicode character, expressed in hexadecimal format, for extended character support.

Layout Change

Keyboard layout changes can be triggered by remapping keys to individual layouts or a general selection option. The generated options list shows all available non-default layouts as well as the special Layout Select action. When remapped to a specific layout change (FN1, FN2, etc...), key presses will activate/deactivate the target layout. When remapped to the Layout Select action, the desired layout can be chosen from all available layouts through repeated key presses.

tip

To change the behavior of how the layout selection is applied, see the special keys section

Keyboard Backlight Control

The backlight control remapping can be used to quickly change the behavior of how the system manages the keyboard backlight. The following operations are available:

• Keyboard backlight on / off / toggle: turn on / off / toggle the keyboard backlight control. When the control is enabled, the system will turn the backlight on when keyboard interaction is detected and will automatically turn off after the idle timeout is reached (configurable with the Datalogic settings).
• Keyboard backlight brightness up / down: increase / decrease the brightness of the backlight.

Custom Action

Custom action defines a new identifier (number greater than 255) for key press detection. After remapping a key to a custom action, listeners can be created from the Datalogic SDK in order to be notified when a custom action press / release has ocurred (using methods in https://datalogic.github.io/android-sdk-docs/reference/com/datalogic/device/input/AdvancedKeyboard.html).

Multitap

Multitap provides the ability to configure multiple key values for a single key (only standard and unicode keycodes are supported). The desired keycode can be selected from the multitap list by pressing the associated key multiple times to cycle through the options.

tip

Within the configuration dialog, previously added multitap values can be modified or removed by clicking on them.

Additional Options

Additional information and options can be configured by pressing the options button and choosing the corresponding tab (see below for descriptions).

Keyboard Info

Keyboard info shows general information about the current keyboard configuration. Some information can be modified, such as the keyboard revision, author, and description. Other information is automatically generated such as the keyboard name and creation date.

Multitap

The multitap options allow customization of the overall feature and will apply to all available multitap keys.

• Multitap Delay: Represents the number of milliseconds between multitap key presses before a character is submitted to the UI.

Special Keys (Standard)

The standard set of special modification keys (SHIFT, ALT, CTRL, FUNC, SYM and META) can be configured to behave differently when interacting with other keys. The behavior can vary between 3 possible options:

• Toggled: User can press and release the associated key. The modifier will be applied only to the next key that is pressed and released.
• Locked: User can press and release the associated key. The modifier will be applied to all other key presses and releases until the associated key is pressed and released again.
• Hold: The modifier will be applied only while the user keeps the associated key pressed.

Special Keys (Layout Change)

Each individual layout change key can be customized to behave in a prescribed manner when accessing the other keys available on the layout. The behavior can vary between 3 possible options:.

• Toggled: User can press and release the associated key. The layout change will be applied only to the next key that is pressed and released.
• Locked: User can press and release the associated key. After that, the layout change will be applied to all other key presses and releases until the associated key is pressed and released again.
• Hold: The layout change will be applied only while the user keeps the associated key pressed.

note

The number of layout change controls present in this menu directly corresponds to the number of additional layouts added to the keyboard (FN1, FN2, etc...).