Overview
The purpose of this document is to describe the functionality of the Battery Intent API Interface. Its intended audience are Android developers.
Requirements
Knowledge of Android programming and familiarity with the Android intent mechanism are assumed.
- Android Versions:
- 2.3.4 and later.
- Devices:
- Symbol Android devices, such as the ET1 rev D, MC40 rev A.
Features
On Symbol devices like the MC40, extra battery information can be retrieved using the standard Android Battery Intent. Setting up to receive this information is the same as with consumer Android devices. However, the data that is returned to your application includes some extra information like:
- Backup Battery Voltage
- Battery Manufacture Date
- Battery Serial Number
- Part Number for Battery
- Unique ID for Battery
- Rated Capacity of the Battery
- Charge Cycle count of the Battery
Programming Interface
Function Prototype
mIntent_Receiver = new Intent_Receiver();
mIntentFilter = new IntentFilter();
mIntentFilter.addAction(Intent.ACTION_BATTERY_CHANGED);
registerReceiver(mIntent_Receiver,mIntentFilter);
Parameters
Please reference the Android Battery Manager API.
Return Values
In addition to the battery information Android returns by default, which can be found here, Symbol devices return the following additional parameters:
- bkvoltage - Backup Battery Voltage
- mfd - Battery Manufacture Date
- serialnumber - Battery Serial Number
- partnumber - Part Number for Battery
- uniqueid - Unique ID for Battery
- ratedcapacity - Rated Capacity of the Battery
- cycle - Charge Cycle count of the Battery
Example
public void onReceive(Context context, Intent intent) {
if (BATTERY_STATE_CHANGED_INTENT.equals(intent.getAction())) {
int bkvoltage = intent.getExtras().getInt("bkvoltage");
String mfd = intent.getExtras().getString("mfd");
String serialnumber = intent.getExtras().getString("serialnumber");
String partnumber = intent.getExtras().getString("partnumber");
String uniqueid = intent.getExtras().getString("uniqueid");
int ratedcapacity = intent.getExtras().getInt("ratedcapacity");
int cycle = intent.getExtras().getInt("cycle");
}
}