S60 3rd Edition API Reference: hwrmpowerstatesdkpskeys.h File Reference
hwrmpowerstatesdkpskeys.h File Reference
API published in: S60 3rd Ed
Link against:
Capability Information
Required Capabilities
None
Detailed Description
The API provides the P&S power state keys that are updated by the HW Resource Manager Server.
These keys provide up-to-date information on the charging status, battery level and battery state of the device. Any application may subscribe to these P&S keys that are updated to receive notifications of any change in state.
This interface relies on the Publish and Subscribe (P&S) interface provided by Symbian. P&S is used by HW Resource Manager to globally publish the power state information.
P&S key to represent the battery level of the device.
It can also be related to the number of battery bars displayed. This property is updated only when battery level changes. Valid values are defined by the enum EPSHWRMBatteryLevel and range from -1 to 7.
If an error has occurred or the battery level has not yet been initialized, the enumeration value of EBatteryLevelUnknown is used. In all other cases the battery level is used with level 0 being the lowest (battery empty) and level 7 the highest (battery full).
This property may be updated to same status as previously, to indicate the note in question needs to be shown again.
EBatteryStatusLow update comes approximately ten times before battery is completely empty and it comes at approximately 10 minute intervals. If phone is in-call mode, update comes at approximately 1 minute intervals.
EBatteryStatusEmpty comes slightly before phone must power down automatically because of insufficient battery power.
