Intents

ACTION_BATTERY_START_LOG Broadcast Action: Enable Battery Manager logging, if disabled.

The intent will have the following extra values:

EXTRA_BATTERY_LOG_IN_IDLE_MODE - boolean that indicates if logging must be executed in idle mode.
EXTRA_BATTERY_LOG_PERIOD - int representing the log period in seconds.
EXTRA_BATTERY_LOG_STATUS - boolean that indicates if field "Status" must be logged.
EXTRA_BATTERY_LOG_SOURCE - boolean that indicates if field "Source" must be logged.
EXTRA_BATTERY_LOG_CAPACITY - boolean that indicates if field "Capacity" must be logged.
EXTRA_BATTERY_LOG_TEMPERATURE - boolean that indicates if field "Temperature" must be logged.
EXTRA_BATTERY_LOG_VOLTAGE - boolean that indicates if field "Voltage" must be logged.
EXTRA_BATTERY_LOG_CURRENT - boolean that indicates if field "Current" must be logged.
EXTRA_BATTERY_LOG_CHARGE_LEFT - boolean that indicates if field "Charge Left" must be logged.

Broadcast intent adb example:

 adb shell am broadcast -a com.datalogic.device.intent.action.battery.START_LOG -n com.datalogic.battery/com.datalogic.battery.receiver.BatteryLogReceiver
 --ez com.datalogic.device.intent.extra.battery.LOG_IN_IDLE_MODE true
 --ei com.datalogic.device.intent.extra.battery.LOG_PERIOD 60
 --ez com.datalogic.device.intent.extra.battery.LOG_STATUS true
 --ez com.datalogic.device.intent.extra.battery.LOG_SOURCE true
 --ez com.datalogic.device.intent.extra.battery.LOG_CAPACITY true
 --ez com.datalogic.device.intent.extra.battery.LOG_TEMPERATURE true
 --ez com.datalogic.device.intent.extra.battery.LOG_VOLTAGE true
 --ez com.datalogic.device.intent.extra.battery.LOG_CURRENT true
 --ez com.datalogic.device.intent.extra.battery.LOG_CHARGE_LEFT true
 

ACTION_BATTERY_STOP_LOG Broadcast Action: Disable Battery Manager logging, if enabled.

ACTION_BATTERY_SWAP Broadcast Action: Sent to notify a battery swap event

The intent will have the following extra values:

EXTRA_BATTERY_EVENT_ID - int that indicates the type of event.
EXTRA_BATTERY_EVENT_TIMESTAMP - long the indicates when the events happens.

ACTION_CONFIGURATION_BOOT_REQUIRED Broadcast Action: Sent when a reboot is required to fully apply the new device configuration.

ACTION_CONFIGURATION_CHANGED Broadcast Action: Sent to notify a change of the device configuration, when the value of a PropertyID changed.
The intent is sent every time the values of some properties change due to a commit() request or a ACTION_CONFIGURATION_COMMIT or a spontaneuos event caused by an environmental change. The intent carries as extra data the new values of the changed properties, the time of the change event and, in case of error, the list of requested changes that were not possible to commit.

The intent will have the following extra values:

EXTRA_CONFIGURATION_CHANGED_MAP - Bundle containing the Map<Integer, String> of properties' changes.
EXTRA_CONFIGURATION_ERROR_MAP - Bundle containing the Map<Integer, String> of the refused properties' changes.
EXTRA_CONFIGURATION_CHANGED_TIME - Bundle containing the timestamp of the changes

ACTION_CONFIGURATION_COMMIT This intent allows to request a change of the device configuration.
The intent carries as extra data the list of requested properties' changes.

The intent will have the following extra values:

EXTRA_CONFIGURATION_CHANGED_MAP - Bundle containing the map of requested properties' changes.

java code example:

 Intent intent = new Intent(Intents.ACTION_CONFIGURATION_COMMIT);
 HashMap map = new HashMap();
 map.put(PropertyID.WIFI_802_DOT_11_MODE, Wifi802Dot11Mode.WIFI_802_DOT_11_ABG.toString());
 map.put(PropertyID.CODE128_ENABLE, "true")
 map.put(PropertyID.CODE128_LENGTH2, "10");
 map.put(PropertyID.CODE128_USER_ID, String.format ("\\u%04x", (int)'a'));
 intent.putExtra(Intents.EXTRA_CONFIGURATION_CHANGED_MAP, map);
 mContext.sendBroadcast(intent);
 

 adb shell am broadcast -a com.datalogic.device.intent.action.configuration.COMMIT
 --esal com.datalogic.device.intent.extra.configuration.CHANGED_MAP "TOUCH_MODE_SENSITIVITY=TOUCH_MODE_STYLUS,800=10,CODE128_ENABLE=false"
 

 adb shell am broadcast -a com.datalogic.device.intent.action.configuration.COMMIT
 --es com.datalogic.device.intent.extra.configuration.CHANGED_MAP "TOUCH_MODE_SENSITIVITY=TOUCH_MODE_STYLUS,800=10,CODE128_ENABLE=false"
 

ACTION_CRADLE_DEVICE_CORRECTLY_INSERTED Broadcast Action: Sent when the device has been correctly inserted into the cradle.

ACTION_CRADLE_DEVICE_EXTRACTED Broadcast Action: Sent when the device has been extracted from the cradle.

ACTION_CRADLE_DEVICE_LOCKED Broadcast Action: Sent when the device has been locked into the cradle.

ACTION_CRADLE_DEVICE_UNLOCKED Broadcast Action: Sent when the device has been unlock from the cradle.

ACTION_CRADLE_DEVICE_WRONGLY_INSERTED Broadcast Action: Sent when the device has been wrongly inserted into the cradle.

ACTION_CRADLE_FAILURE_OCCURRED Broadcast Action: Sent when a failure occurs on the cradle.

The intent will have the following extra values:

EXTRA_CRADLE_FAILURE - indicating which kind of failure occured on the cradle

ACTION_CRADLE_FAILURE_RECOVERED Broadcast Action: Sent when a failure has been recovered on the cradle.

The intent will have the following extra values:

EXTRA_CRADLE_FAILURE - indicating which kind of failure has been recovered on the cradle

ACTION_CRADLE_FIRMWARE_UPGRADE_COMPLETED Broadcast Action: Sent when the cradle firmware upgrade procedure is completed.

The intent will have the following extra values:

EXTRA_CRADLE_FIRMWARE_UPGRADE_BYTES - int representing the number of bytes transferred to the cradle.

ACTION_CRADLE_FIRMWARE_UPGRADE_ERROR Broadcast Action: Sent when an error occurs during the cradle firmware upgrade procedure.

ACTION_CRADLE_FIRMWARE_UPGRADE_IN_PROGRESS Broadcast Action: Sent during the firmware upgrade procedure, when a firmware block has been trasferred to the the cradle.

The intent will have the following extra values:

EXTRA_CRADLE_FIRMWARE_UPGRADE_BYTES - int representing the number of bytes has been already transferred to the cradle.

ACTION_CRADLE_FIRMWARE_UPGRADE_STARTED Broadcast Action: Sent when the system starts the firmware upgrade process with the cradle.

The intent will have the following extra values:

EXTRA_CRADLE_FIRMWARE_UPGRADE_BYTES - int representing the number of bytes (firmware size) will be transferred to the cradle.

ACTION_CRADLE_LOCK_DEVICE This intent allow the user to lock the device into the cradle. When invoked, the system will communicate with the cradle to lock the device.

ACTION_CRADLE_UNLOCK_DEVICE This intent allow the user to unlock the device from the cradle. When invoked, the system will communicate with the cradle to unlock the device.

ACTION_CRADLE_UNLOCK_KEY_EXTRACTED Broadcast Action: Sent when the unlock key has been extracted from the cradle (to lock the device).

ACTION_CRADLE_UNLOCK_KEY_INSERTED Broadcast Action: Sent when the unlock key has been inserted into the cradle (to unlock the device).

ACTION_SYSTEM_FIRMWARE_UPGRADE This intent allows to request a device firmware upgrade.

The intent will have the following extra values:

EXTRA_SYSTEM_FIRMWARE_UPGRADE_FILE_PATH - Path of the fw to be used for the upgrade.
EXTRA_SYSTEM_FIRMWARE_UPGRADE_REBOOT - To request a reboot device after a successful update.
EXTRA_SYSTEM_FIRMWARE_UPGRADE_RESET - To request a device reset after a successful update.

broadcast intent adb example:

 adb shell am broadcast -a com.datalogic.systemupdate.action.FIRMWARE_UPDATE -n com.datalogic.systemupdate/.SystemUpgradeReceiver
 --es path /sdcard/ota.zip
 --ei reset 0
 --ei reboot 1
 

In addition to the broadcast intent a startService intent or a startActivity intent can be used with the same extra data of the broadcast intent.
Pay attention that with startService intent the extra data EXTRA_SYSTEM_FIRMWARE_UPGRADE_ACTION must be specified with the value 2 while for the broadcast and the startActivity intents it is implicit.

startService intent adb example:

 adb shell am startservice -n com.datalogic.systemupdate/.SystemUpgradeService
 --ei action 2
 --es path /sdcard/ota.zip
 --ei reset 0
 --ei reboot 1
 

startActivity intent adb example:

 adb shell am start -n com.datalogic.systemupdate/.SystemUpgradeActivity
 --es path /sdcard/ota.zip
 --ei reset 0
 --ei reboot 1
 

EXTRA_BATTERY_EVENT_ID Used as an int extra field in ACTION_BATTERY_SWAP, It defines the event associated to the battery swap: available values are:

BATTERY_SWAP_EVENT_UNKNOWN: unknown event.
BATTERY_SWAP_EVENT_BEGIN: battery swap started: battery extracted.
BATTERY_SWAP_EVENT_END: battery swap ended: battery inserted.

EXTRA_BATTERY_EVENT_TIMESTAMP Used as a long extra field in ACTION_BATTERY_SWAP, It specifies the time in milliseconds when event happens. Time is calculated by System.currentTimeMillis().

EXTRA_BATTERY_LOG_CAPACITY Used as a boolean extra field in ACTION_BATTERY_START_LOG, It enables or disables log of feature "Capacity"

EXTRA_BATTERY_LOG_CHARGE_LEFT Used as a boolean extra field in ACTION_BATTERY_START_LOG, It enables or disables log of feature "Charge Left"

EXTRA_BATTERY_LOG_CURRENT Used as a boolean extra field in ACTION_BATTERY_START_LOG, It enables or disables log of feature "Current"

EXTRA_BATTERY_LOG_IN_IDLE_MODE Used as a boolean extra field in ACTION_BATTERY_START_LOG, It enables or disables feature "Log In Idle Mode".

EXTRA_BATTERY_LOG_PERIOD Used as an int extra field in ACTION_BATTERY_START_LOG, It selects the logging period expressed in seconds.

If EXTRA_BATTERY_LOG_IN_IDLE_MODE is enabled, allowed values are (60, 120, 300, 600, 1800, 3600) with 300 as default.
If EXTRA_BATTERY_LOG_IN_IDLE_MODE is disabled, allowed values are (10,30, 60, 120, 300, 600, 1800, 3600) with 60 as default.

EXTRA_BATTERY_LOG_SOURCE Used as a boolean extra field in ACTION_BATTERY_START_LOG, It enables or disables log of feature "Source"

EXTRA_BATTERY_LOG_STATUS Used as a boolean extra field in ACTION_BATTERY_START_LOG, It enables or disables log of feature "Status"

EXTRA_BATTERY_LOG_TEMPERATURE Used as a boolean extra field in ACTION_BATTERY_START_LOG, It enables or disables log of feature "Temperature"

EXTRA_BATTERY_LOG_VOLTAGE Used as a boolean extra field in ACTION_BATTERY_START_LOG, It enables or disables log of feature "Voltage"

EXTRA_CONFIGURATION_CHANGED_MAP Used as an Map<Integer, String> extra field in ACTION_CONFIGURATION_COMMIT and ACTION_CONFIGURATION_CHANGED. The field contains a Map<Integer, String> with the new values of all the properties changed. The Integer key is the PropertyID of the property and the String value is the stringified form of the new value of the property.

EXTRA_CONFIGURATION_CHANGED_TIME Used as an int extra field in ACTION_CONFIGURATION_CHANGED. The field contains the time of the event as a difference, measured in milliseconds, between the current time and midnight, January 1, 1970 UTC. See System.currentTimeMillis(). Use Date to convert the value in a Date object.

EXTRA_CONFIGURATION_ERROR_MAP Used as an Map<Integer, String> extra field in ACTION_CONFIGURATION_CHANGED. The field contains a Map<Integer, String> that lists the properties' changes, requested through the sdk interface or a ACTION_CONFIGURATION_COMMIT that were not possible to apply. The Integer key is the PropertyID of the property and the String value is the stringified form of the value of the property that was not possible to apply.

EXTRA_CRADLE_FAILURE Used as an int extra field in ACTION_CRADLE_FAILURE_OCCURRED and ACTION_CRADLE_FAILURE_RECOVERED intents to request the type of failure occured or recovered on the cradle.
Possible values are EXTRA_CRADLE_FAILURE_UNKNOWN, EXTRA_CRADLE_FAILURE_BAD_LEVER_POSITION, EXTRA_CRADLE_FAILURE_WLC_FOD, EXTRA_CRADLE_FAILURE_WLC_EOC_TIMEOUT, EXTRA_CRADLE_FAILURE_WLC_TX, EXTRA_CRADLE_FAILURE_SOLENOID_OVERTEMPERATURE, EXTRA_CRADLE_FAILURE_WRONG_DAISY_CHAIN_CONFIG, EXTRA_CRADLE_FAILURE_GENERAL, EXTRA_CRADLE_FAILURE_SOLENOID, EXTRA_CRADLE_FAILURE_CHARGER, EXTRA_CRADLE_FAILURE_BATTERY_AUTH, EXTRA_CRADLE_FAILURE_BATTERY_EEPROM, EXTRA_CRADLE_FAILURE_BATTERY_DEAD or EXTRA_CRADLE_FAILURE_WLC_GENERAL.

EXTRA_CRADLE_FAILURE_BAD_LEVER_POSITION Used as an int value for EXTRA_CRADLE_FAILURE to request the failure type. The slot's lever is not in the correct position.

EXTRA_CRADLE_FAILURE_BATTERY_AUTH Used as an int value for EXTRA_CRADLE_FAILURE to request the failure type. The Cradle is experiencing a problem on the battery authentication.

EXTRA_CRADLE_FAILURE_BATTERY_DEAD Used as an int value for EXTRA_CRADLE_FAILURE to request the failure type. The Cradle is experiencing a problem on the battery status.

EXTRA_CRADLE_FAILURE_BATTERY_EEPROM Used as an int value for EXTRA_CRADLE_FAILURE to request the failure type. The Cradle is experiencing a problem on the battery eeprom.

EXTRA_CRADLE_FAILURE_WRONG_DAISY_CHAIN_CONFIG Used as an int value for EXTRA_CRADLE_FAILURE to request the failure type. The Cradle is experiencing a problem on the charger.

EXTRA_CRADLE_FAILURE_DEVICE_NOT_CHARGING Used as an int value for EXTRA_CRADLE_FAILURE to request the failure type. The Cradle is experiencing a problem on its internal charging system.

EXTRA_CRADLE_FAILURE_FLASH_CORRUPTED Used as an int value for EXTRA_CRADLE_FAILURE to request the failure type. The cradle's internal flash is corrupted.

EXTRA_CRADLE_FAILURE_GENERAL Used as an int value for EXTRA_CRADLE_FAILURE to request the failure type. General failure was detected.

EXTRA_CRADLE_FAILURE_LEVER_NOT_CALIBRATED Used as an int value for EXTRA_CRADLE_FAILURE to request the failure type. The Cradle is experiencing a problem with lever calibration.

EXTRA_CRADLE_FAILURE_SOLENOID Used as an int value for EXTRA_CRADLE_FAILURE to request the failure type. The locking solenoid is too hot and the lever cannot be controlled until temperature will be reduced.

EXTRA_CRADLE_FAILURE_SOLENOID_OVERTEMPERATURE Used as an int value for EXTRA_CRADLE_FAILURE to request the failure type. The locking solenoid is too hot and the lever cannot be controlled until temperature will be reduced.

EXTRA_CRADLE_FAILURE_UNKNOWN Used as an int value for EXTRA_CRADLE_FAILURE to request the failure type. No failure was detected.

EXTRA_CRADLE_FAILURE_WLC_EOC_TIMEOUT Used as an int value for EXTRA_CRADLE_FAILURE to request the failure type. The device asked for an "end of power transmission" for too long.

EXTRA_CRADLE_FAILURE_WLC_FOD Used as an int value for EXTRA_CRADLE_FAILURE to request the failure type. There is some metal object which prevents a successful wireless charge power transmission between the cradle and the device.

EXTRA_CRADLE_FAILURE_WLC_GENERAL Used as an int value for EXTRA_CRADLE_FAILURE to request the failure type. The Cradle is experiencing a general problem on the wlc.

EXTRA_CRADLE_FAILURE_WLC_TX Used as an int value for EXTRA_CRADLE_FAILURE to request the failure type. The Cradle is experiencing a problem on WLC's TX and it cannot power to the device.

EXTRA_CRADLE_FAILURE_WRONG_DAISY_CHAIN_CONFIG Used as an int value for EXTRA_CRADLE_FAILURE to request the failure type. The current cradle's daisy chain configuration is not allowed.

EXTRA_CRADLE_FIRMWARE_UPGRADE_BYTES Used as an int extra field in ACTION_CRADLE_FIRMWARE_UPGRADE_STARTED, ACTION_CRADLE_FIRMWARE_UPGRADE_IN_PROGRESS and ACTION_CRADLE_FIRMWARE_UPGRADE_COMPLETED that represents the number of bytes transferred to the cradle.

EXTRA_SYSTEM_FIRMWARE_UPGRADE_ACTION Used, as an int, in a startService intent to com.datalogic.systemupdate/.SystemUpgradeService to request a device firmware upgrade.
The value to be used is 2.

EXTRA_SYSTEM_FIRMWARE_UPGRADE_FILE_PATH Used as a String value to specify the path of the fw to be used for the upgrade.

EXTRA_SYSTEM_FIRMWARE_UPGRADE_REBOOT Used as an int value to request a device reboot after successful update.
Use 1 to request the reboot, 0 otherwise.

EXTRA_SYSTEM_FIRMWARE_UPGRADE_RESET Used as an int value to request a reset after successful update.
The allowed values are:

 - 0 for NONE
 - 1 for FACTORY RESET
 - 2 for ENTERPRISE RESET