The configuration of a Datalogic device can be done in different ways: S2D, EMM+OEMCOnfig or SDK. Recently, a new method was introduced based only on sending Intent directly to the system.
Applies to:
Devices that integrate SDK ver 1.29 (only method 1), devices that integrate SDK ver 1.32 (any methods). Some properties may not be available on all devices.
Starting from SDK version 1.29, in the class Intents, an action intent called ACTION_CONFIGURATION_COMMIT is exposed.
The ACTION_CONFIGURATION_COMMIT Intent can be used to apply a configuration to a Datalogic device.
It is possible to pass to this Intent an extra, as an input, called EXTRA_CONFIGURATION_CHANGED_MAP.
That extra accepts an Object Map with the schema Map<Key, Value>, which will contain the list of parameters to be modified. The “Key” of the Map<Key, Value> is an Integer that represents the ID of the property, the “Value“ is represented by a String.
This is the list of the available parameter PropertyID:
https://datalogic.github.io/android-sdk-docs/reference/com/datalogic/device/configuration/PropertyID.html
For some devices, especially for properties that do not involve the Scan Engine, a reboot is required.
When a property that requires a reboot is set, the system sends an ACTION_CONFIGURATION_BOOT_REQUIRED Intent, or, if the setting is done through UI, the following message is showed:
---- Example ----:
- Enable only the 2.4 GHz Wi-Fi band (note: this setting will require a reboot).
- Disable the code 128 family.
(reference device: Joya Touch 22)
-
Looking at the Datalogic SDK (Java/Kotlin) reference documentation, in the Class under “WIFI_GROUP” You can find the option “WIFI_BAND_SELECTION”,
The “Key” is “WIFI_BAND_SELECTION”
And “WIFI_BAND24_GHZ” is the “Value” to insert as a String.
-
On the same tree, by searching for Code128 in the tree, you can easily find the PropertyID and the value for disabling the Code128 symbology:
.
ROOT / SCANNER_GROUP / s1D_GROUP / CODE128_GROUP / CODE128_ENABLE
.
public static final int **CODE128_ENABLE**
Added in revision 32
This parameter enables or disables the symbology.
The class of the property isBooleanProperty
.
Constant Value:1032 (0x00000408)
.
With these information, build a Configuration Intent with this schema:
-
Broadcast action:
com.datalogic.device.intent.action.configuration.COMMIT
-
Intent EXTRA (String or List):
com.datalogic.device.intent.extra.configuration.CHANGED_MAP [Key=value],[..]
That Configuration Intent can be sent to the system in different ways: