Category Filter

How to configure Spectralink devices with OEMConfig

This article will help you configure Spectralink devices with OEMConfig via MDM.

OEMConfig is an application developed by original equipment manufacturers (OEMs) to configure OEM-specific management policies on their devices. In order to make these settings available to the devices, you must use a Unified Endpoint Management (UEM) solution that supports this feature.

Spectralink is an OEM that delivers mobility solutions optimized for healthcare, retail, and manufacturing units. Hexnode’s MDM solution makes it easier for IT admins to define various Spectralink-specific settings from its console. The admin can view and configure multiple Spectralink OEMConfig apps that have built-in configurations (managed configurations).

Note:


This feature works only on Android 5.0+ devices enrolled in the Android Enterprise program.

Configure Spectralink devices with OEMConfig

Spectralink uses the Google-recommended OEMConfig Enhanced Schema to manage devices through a hierarchical structure. It implements its OEMConfig schema through the following apps:

OEMConfig App Bundle ID
Spectralink – Barcode com.spectralink.barcode.service
Spectralink – Buttons com.spectralink.buttons
Spectralink – Logging com.spectralink.slnklogger
Spectralink – VQO com.spectralink.slnkvqo

To configure Spectralink devices with OEMConfig,

  1. Approve and add Spectralink OEMConfig apps to the Hexnode inventory
  2. Configure Spectralink-specific OEMConfig settings

Approve and add Spectralink OEMConfig apps to the Hexnode inventory

Make sure that you enroll your organization in the Android Enterprise program, and your devices in Android Enterprise as either Device Owner or Profile Owner.

Follow the steps to add Spectralink OEMConfig apps from the Managed Google Play to the Hexnode inventory:

  1. Navigate to Apps > + Add Apps > Managed Google Apps.
  2. Search for the required Spectralink OEMConfig app and select it.
  3. Click Approve to grant the required permissions for the app.
  4. You will be redirected to the Approval Settings page. Select the method by which you would like to handle new app permission requests.
  5. You can also subscribe your email addresses by navigating to the Notifications tab. The provided email addresses will be notified when the apps you have approved request new permissions. Click Add.
  6. Click Done.

This will add the approved apps to the Hexnode app inventory. Distribute these apps to the target devices to start configuring them.

Configure Spectralink-specific OEMConfig settings

To set up OEM-specific settings on Spectralink devices,

  1. Navigate to the Policies tab.
  2. Create a new policy with the New Policy button or select an existing policy to edit it.
  3. Provide a suitable name and description for the policy.
  4. Select App Configurations from Android > App Management.
  5. Click Configure and +Add new configuration button.
  6. Select the Spectralink OEMConfig app from the list to start configuring it. You can configure multiple OEMConfig apps from the list.
  7. Click Done.
  8. Navigate to the Policy Targets tab to associate the policy with the target devices.
  9. Select the required Devices/Device Groups/Users/User Groups/Domains to which the policy is to be associated.
  10. Click Save.

The configurations provided by different Spectralink OEMConfig apps are detailed below:

1. Barcode

Barcode is Spectralink’s OEMConfig application used to activate the built-in barcode scanners on their ruggedized Versity 9553 and 9653 models.

The following settings are available with the Barcode app:

Administrative Settings

Administrative Settings
Settings Description
Enable barcode scanner Specify whether to enable or disable built-in barcode scanners on the ruggedized devices.
Automatic carriage return Enable this option to automatically insert a carriage return when the last word that will fit on a line has been entered.
Decode session timeout Set the time up to which the decode session will continue.
Illumination power Specify the intensity of the scan light. You can set the illumination level from 0 (lowest) to 10 (highest).
Vibrate on scan Enable this option to vibrate the scanner when a barcode is successfully read.
Sound on scan Enable this option to play a sound when a barcode is successfully read.
Tone to play on scan Select the tone to play on a successful scan.
Inverse 1D Decoding Select the method by which the scanner decodes 1D barcodes. The available options include:
  • Dark on light
  • Light on dark
  • Either
Enable or disable supplementals for EAN and UPC Specify whether the scanners can decode the EAN and UPC barcodes with supplementals.
Enable aim title Specify whether to prefix AIM code or symbol id before barcode data. The AIM code provides information about the symbology generated by the decoder of a scanner.
Prepend string Enter a prepended string to include information before the scanned barcode data.
Replace control characters Select the control characters that can be replaced with basic Latin punctuations or symbols. You can also choose to keep using the control character itself. The available character strings include:
  • Space (Default)
  • Standard control character
  • Basic Latin punctuation or symbol

You can replace the following control characters:

  • NULL (NUL)
  • Start of Header (SOH)
  • Start of Text (STX)
  • End of Text (ETX)
  • End of Transmission (EOT)
  • Enquiry (ENQ)
  • Acknowledge (ACK)
  • Bell (BEL)
  • Backspace (BS)
  • Horizontal Tab (HT)
  • Line Feed (LF)
  • Vertical Tab (VT)
  • Form Feed (FF)
  • Carriage Return (CR)
  • Shift Out (SO)
  • Shift In (SI)
  • Data Link Escape (DLE)
  • Device Control 1 (DC1)
  • Device Control 2 (DC2)
  • Device Control 3 (DC3)
  • Device Control 4 (DC4)
  • Negative ACK (NAK)
  • Synchronize (SYN)
  • End text Block (ETB)
  • Cancel (CAN)
  • End Message (EM)
  • Substitute (SUB)
  • Escape (ESC)
  • File Separator (FS)
  • Group Separator (GS)
  • Record Separator (RS)
  • Unit Separator (US)

Symbology Settings

Specify the symbologies that can be deployed to control various barcode features.

Aztec
Settings Description
Enable Aztec Enable this option to allow Aztec barcodes (2-D matrix symbology).
Aztec Decoding Select the option needed to decode Aztec. The available options include:
  • Regular: Black barcode on white background
  • Inverse: White barcode on black background
  • Either

Codabar
Settings Description
Enable Codabar Enable this option to allow Codabar barcodes.
Codabar length Set the readable length of Codabar from 1-55.
Enable Codabar NOTIS editing Allow this option to strip the start/stop characters from a decoded Codabar symbol.

Code 11
Settings Description
Enable Code 11 Enable this option to allow Code 11 symbology.
Code 11 check digit verification Specify the option required to check the integrity of all Code 11 symbols. Thus, you can ensure data compliance with the specified check digit algorithm. The available options are:
  • Disable check digits
  • One check digit
  • Two check digits
Enable transmit code 11 Check Digit Enable this option to transmit the Code 11 check digit(s). This feature works only if ‘Code 11 check digit verification’ is enabled.

Code 32
Settings Description
Enable Code 32 Enable this option to allow Code 32 symbology. This feature works only if ‘Enable Code 39’ is enabled.

Code 39
Settings Description
Enable Code 39 Enable this option to allow Code 39 symbology.
Enable Code 39 full ASCII conversion Enable this option to allow Code 39 – Full ASCII symbology.
Enable Code 39 check digit Verification Enable this option to check the integrity of all Code 39 symbols. Thus, you can ensure data compliance with the specified check digit algorithm.
Enable transmit Code 39 check digit Enable this option to transmit the Code 39 check digit with the data.

Code 93
Settings Description
Enable Code 93 Enable this option to allow Code 93 symbology.

Code 128
Settings Description
Enable Code 128 Enable this option to allow Code 128 symbology.

Data Matrix/Data Matrix Inverse
Settings Description
Enable Data Matrix Enable this option to allow Data Matrix.
Data Matrix mirror images Select the Data Matrix mirror image setting as:
  • Never
  • Mirror
  • Both
Data Matrix decoding Select the option required to decode Data Matrix. The options are:
  • Regular: Black barcode on white background
  • Inverse: White barcode on black background
  • Both

EAN 8
Settings Description
Enable EAN 8 Enable this option to allow EAN 8 symbology.
Enable convert EAN8 to EAN13 Enable this option to convert EAN-8 data to EAN-13 format.
Enable transmit EAN-8 check digit Enable this option to transmit the EAN-8 check digits with the data.

EAN 13
Settings Description
Enable EAN 13 Enable this option to allow EAN 13 symbology.

EAN GS1-128
Settings Description
Enable EAN GS1-128 Enable this option to allow GS1-128 symbology.

EAN GS1 DataBar 14
Settings Description
Enable EAN GS1 DataBar 14 Enable this option to allow GS1 DataBar 14 symbology.
Enable GS1 DataBar composite CC-A/B Enable this option to allow GS1 DataBar composite CC-A/B.
Enable GS1 DataBar composite CC-C Enable this option to allow GS1 DataBar composite CC-C.
Enable GS1 DataBar Expanded Enable this option to allow GS1 DataBar Expanded.
Enable GS1 DataBar Limited Enable this option to allow GS1 DataBar Limited.

Han Xin code
Settings Description
Enable Han Xin code Enable this option to allow Han Xin code.

Interleaved 2 of 5
Settings Description
Enable Interleaved 2 of 5 Enable this option to allow Interleaved 2 of 5.
Interleaved 2 of 5 check digit verification Select the algorithm to check the integrity of an Interleaved 2 of 5 symbol. You can select one of the below options:
  • Disable
  • USS: Uniform Symbology Specification
  • OPCC: Optical Product Code Council
Enable Interleaved 2 of 5 quiet zone Enable this option to allow Interleaved 2 of 5 quiet zone.
Enable transmit Interleaved 2 of 5 check digit Enable this option to transmit the Interleaved check digits with the data.
Interleaved 2 of 5 length type Set the length of the code to read the number of characters that the code contains. The available lengths to choose from include:
  • One discrete length: Select this option to decode codes containing a specified length.
  • Two discrete lengths: Decode codes containing two specified lengths.
  • Length within range: Only codes within a specified range will be decoded.
  • Any length: Codes containing any number of characters can be decoded.
Set Interleaved 2 of 5 length 1 (0-55) Set the Interleaved 2 of 5 length 1 from 0 to 55.
Set Interleaved 2 of 5 length 2 (0-55) Set the Interleaved 2 of 5 length 2 from 0 to 55.

ISBT 128
Settings Description
Enable ISBT 128 Enable this option to allow ISBT 128.
Select an option for concatenating pairs of ISBT code types Select one of the below options for concatenating pairs of ISBT code types:
  • Disable: Select this option to restrict the device from performing concatenation.
  • Enable: Select this option to allow the device to decode and perform concatenation of ISBT codes. Note that the device cannot decode single ISBT symbols.
  • Auto discriminate: Select this option to permit the device to immediately decode and concatenate pairs of ISBT codes.
Enable check ISBT table If ‘Select an option for concatenating pairs of ISBT code types’ is set to ‘Enable,’ enable this option to perform concatenation of only those pairs found in this table.
ISBT concatenation redundancy If ‘Select an option for concatenating pairs of ISBT code types’ is set to ‘Auto discriminate,’ select the number of times the device must decode an ISBT symbol before determining that there is no additional symbol.

Matrix 2 of 5
Settings Description
Enable Matrix 2 of 5 Enable this option to allow Matrix 2 of 5.
Enable Matrix 2 of 5 check digit Enable this option to check the integrity of Matrix 2 of 5 code.
Enable transmit Matrix 2 of 5 check digit Enable this option to transmit the check digit with the data.

Micro PDF
Settings Description
Enable Micro PDF Enable this option to allow Micro PDF symbology.

Micro QR
Settings Description
Enable Micro QR Enable this option to allow Micro QR barcode.

MSI Plessy
Settings Description
Enable MSI Plessy Enable this option to allow MSI Plessy.
Number of MSI check digits Select the number of check digits to check the integrity of the data. You can either select one digit or two digits.
Enable transmit MSI check digit Enable this option to transmit the check digits with the data.
MSI check digit algorithm If ‘Number of MSI check digits’ is set to ‘Two digits,’ select the algorithm required to check the integrity of the data as additional verification. You can choose either MOD10/MOD11 or MOD10/MOD01O algorithm.

PDF 417
Settings Description
Enable PDF 417 Enable this option to allow PDF 417 barcode format.

QR/QR Inverse
Settings Description
Enable QR Enable this option to allow QR codes.
QR decoding Select the option required to decode QR. The available options include:
  • Regular: Black barcode on white background
  • Inverse: White barcode on black background
  • Both

UPC-A
Settings Description
Enable UPC-A Enable this option to allow UPC-A barcode.
Transmit UPC-A preamble Select one of the following options required to transmit UPC-A preamble to the host device:
  • No preamble
  • System character
  • System character and country code
Enable transmit UPC-A check digit Enable this option to transmit the symbol with the UPC-A check digit.

UPC-E
Settings Description
Enable UPC-E Enable this option to allow UPC-E barcode.
Transmit UPC-E preamble Select one of the following options required to transmit UPC-E preamble to the host device:
  • No preamble
  • System character
  • System character and country code
Enable transmit UPC-E check digit Enable this option to transmit the symbol with the UPC-E check digit.

2. Buttons

Spectralink’s Buttons application allows users to configure settings for the buttons on their Versity models. The Versity devices have six programmable buttons:

  • LEFT
  • RIGHT
  • TOP
  • FINGERPRINT
  • VOL.UP
  • VOL.DOWN

These buttons can be set to run any apps installed on the Spectralink devices. With Hexnode MDM, the following settings can be configured with the Buttons app:

Buttons
Settings Description
Enable user control of left button Enable this option to allow the end-users to configure the left button. The admin’s configuration will take precedence until a user changes the button.
Left button Select the application to run when the left button is clicked. The available options include:
  • No action
  • Home key
  • Back key
  • Menu key
  • PTT
  • Alarm
  • Volume up
  • Volume down
  • Run application
  • Scanner
  • Custom 1
  • Custom 2
  • Custom 3
  • Custom 4
Left button application If the ‘Left button’ is set to ‘Run application,’ enter the package name or package name/activity for the application. Use the format or .. For example, the package name of Biz phone is com.spectralink.phone. If you need to enter the dialer screen directly within the Biz phone, include the activity name along with the package name. In this case, the format will be
com.spectralink.phone/com.spectralink.phone.activities.Dialer.
Enable user control of right button Enable this option to allow the end-users to configure the right button. The admin’s configuration will take precedence until a user changes the button.
Right button Choose one application from the list of available options to open when the right button is pressed. The available options include:
  • No action
  • Home key
  • Back key
  • Menu key
  • PTT
  • Alarm
  • Volume up
  • Volume down
  • Run application
  • Scanner
  • Custom 1
  • Custom 2
  • Custom 3
  • Custom 4
Right button application Enter the package name or package name/activity for the application if ‘Run application’ is selected for the ‘Right button.’
Enable user control of top button If enabled, the end-users can configure the top button. The admin’s configuration will take precedence until a user changes the button.
Top Select one application from the below list to run when the top button is pressed:
  • No action
  • Home key
  • Back key
  • Menu key
  • PTT
  • Alarm
  • Volume up
  • Volume down
  • Run application
  • Scanner
  • Custom 1
  • Custom 2
  • Custom 3
  • Custom 4
Top button application If the ‘Top’ option is set to ‘Run application,’ enter the package name or package name/activity for the application.
Enable user control of fingerprint Enable this option to permit the end-users to configure the fingerprint button. The admin’s configuration will take precedence until a user changes the button.
Fingerprint Choose from the list of available options:
  • No action
  • Home key
  • Back key
  • Menu key
  • PTT
  • Alarm
  • Volume up
  • Volume down
  • Run application
  • Scanner
  • Fingerprint
  • Custom 1
  • Custom 2
  • Custom 3
  • Custom 4
Fingerprint button application If the ‘Fingerprint’ option is set to ‘Run application,’ manually enter the package name or package name/activity for the application.
Enable user control of volume up button Enable this option to allow the end-users to configure the volume up button. The admin’s configuration will take precedence until a user changes the button.
Volume up Select one application from the available list of options:
  • No action
  • Home key
  • Back key
  • Menu key
  • PTT
  • Alarm
  • Volume up
  • Volume down
  • Run application
  • Scanner
  • Custom 1
  • Custom 2
  • Custom 3
  • Custom 4
Volume up button application If the ‘Volume up’ option is set to ‘Run application,’ enter the package name or package name/activity for the application in this field.
Enable user control of volume down button Enable this option to allow users to configure the volume down button. The admin’s configuration will take precedence until a user changes the button.
Volume down Choose from the list of available options:
  • No action
  • Home key
  • Back key
  • Menu key
  • PTT
  • Alarm
  • Volume up
  • Volume down
  • Run application
  • Scanner
  • Custom 1
  • Custom 2
  • Custom 3
  • Custom 4
Volume down button application If the ‘Volume down’ option is set to ‘Run application,’ manually enter the package name or package name/activity for the application.

Notes:

  • Make sure that the app package, if specified, is already installed on the Spectralink devices.
  • The custom settings are available only for app programmers. Contact your Spectralink support for more information.

3. Logging

The Logging app enables administrators to manage diagnostic information on their Versity devices. Using this Spectralink OEMConfig app, the admin can control logging services, configure syslog server address, provide advanced debugging access, and much more.

Configure the below settings available with the Logging app:

Syslog Settings
Settings Description
Enable syslog service Enable this option to turn syslog service on.
Syslog server address Enter the IP address of the syslog server, or the fully qualified DNS name (i.e., example.com or 123.456.78.9).
Syslog server port Enter the port associated with the syslog server.
Logcat parameters Enter the filter tag strings/logcat command-line parameters to determine the verbosity of the syslog output (e.g., *:w, *:e, etc.).

Advanced Logging
Settings Description
Capture bug report Enable this option to collect bug reports that contain device logs, stack traces, and other diagnostic information.
Enable logcat Enable this option to collect and view the system debug output.
Custom file size Set the maximum size of the logcat file (1024-12288 KB).
Network capture Enable this option to capture the contents of network packets (layer 3+) to a file that can be analyzed using the Wireshark parsing tool.
Snapshot length Set the network capture snapshot length (0-262144).
Qxdm Enable this option to enable Qxdm, which is a collection and diagnostic tool for capturing performance data.
Qxdm configuration file Select the configuration file used to set filtering for Qxdm capture. The available files include:
  • Audio and network related
  • Bluetooth WLAN FM
  • Driver sensors
  • GPS (GNSS) related
  • Network related
  • Cellular related (GSM, CDMA)
  • Audio (PCM) related
  • Wi-Fi (WLAN) roaming
  • Custom
Enable crash dump USB download mode Enable/disable crash dump USB download mode.
Zip file password protect If this option is enabled, all advanced logging zipped files will be password protected with the Advanced debugging password.
Password parameter Enter the password for entering the Advanced debugging menu.
Allow on-device configuration If this option is enabled, the user will be able to edit advanced logging settings.
Upload server address Enter the IP address or hostname of the server for advanced debugging without http/https (i.e., example.com or 123.456.78.9).
Upload server port Enter the server port for advanced debugging as 80, 443, or 1024-65535.
Network protocol Enter a numeric to select either HTTP or HTTPS network protocol (HTTP=0 or HTTPS=1).
Enable wake lock Activate the wake lock option for debugging purposes only.
Enable UART console output Enable/disable UART console output from the headphone jack.

4. VQO

Voice Quality Optimization (VQO) app is another Spectralink OEMConfig app used for enhancing audio and video calls from dialers. The app can optimize voice quality, recognize audio and video packets, allow threshold adjustments, and so forth.

Here’s the list of features that can be configured on Spectralink devices using the VQO app:

VQO
Settings Description
Wi-Fi low RSSI threshold Enter a value between 55 and 100 to set the RSSI threshold value at or below which the device seeks a better access point (displays as a negative value on the phone).
Auto band selection Enable this option to allow both bands (2.4 GHz and 5 GHz) and all available Wi-Fi channels. In this case, you cannot make Band or Channel selection. If this option is disabled, select the required band and the specific channels within each band.
2.4 GHz Wi-Fi band Enable/disable Wi-Fi 2.4 GHz band. If enabled, users can enable/disable specific channels within the 2.4 GHz band.
5 GHz Wi-Fi band Enable/disable Wi-Fi 5 GHz band. If enabled, users can enable/disable specific channels within the 5 GHz band.
Channel selection Enable/disable the various channels listed below:
  • Ch:1 (2412 MHz)
  • Ch:2 (2417 MHz)
  • Ch:3 (2422 MHz)
  • Ch:4 (2427 MHz)
  • Ch:5 (2432 MHz)
  • Ch:6 (2437 MHz)
  • Ch:7 (2442 MHz)
  • Ch:8 (2447 MHz)
  • Ch:9 (2452 MHz)
  • Ch:10 (2457 MHz)
  • Ch:11 (2462 MHz)
  • Ch:12 (2467 MHz)
  • Ch:13 (2472 MHz)
  • Ch:14 (2484 MHz)
  • Ch:36 (5180 MHz)
  • Ch:40 (5200 MHz)
  • Ch:44 (5220 MHz)
  • Ch:48 (5240 MHz)
  • Ch:52 (5260 MHz)
  • Ch:56 (5280 MHz)
  • Ch:60 (5300 MHz)
  • Ch:64 (5320 MHz)
  • Ch:100 (5500 MHz)
  • Ch:104 (5520 MHz)
  • Ch:108 (5540 MHz)
  • Ch:112 (5560 MHz)
  • Ch:116 (5580 MHz)
  • Ch:120 (5600 MHz)
  • Ch:124 (5620 MHz)
  • Ch:128 (5640 MHz)
  • Ch:132 (5660 MHz)
  • Ch:136 (5680 MHz)
  • Ch:140 (5700 MHz)
  • Ch:144 (5720 MHz)
  • Ch:149 (5745 MHz)
  • Ch:153 (5765 MHz)
  • Ch:157 (5785 MHz)
  • Ch:161 (5805 MHz)
  • Ch:165 (5825 MHz)
FT Enable/disable Fast Transition (FT).
CCKM Enable/disable Cisco Centralized Key Management (CCKM).

Note:

The OEM specific-settings explained in this document are based on the configurations set by the respective OEM vendors, which may vary frequently. Since Hexnode is not solely responsible for setting up these configurations, you may find slight variations in the settings displayed on the portal from this document.