Archived:MIDlet cannot power down GPS module with an existing satellite fix (Known Issue)
extkbeditor2
(Talk | contribs) m |
hamishwillee
(Talk | contribs) |
||
| (22 intermediate revisions by 4 users not shown) | |||
| Line 1: | Line 1: | ||
| − | [[Category:Java ME]][[Category:Location API (JSR-179) ]][[Category: | + | {{Archived|timestamp=20120223101822|user=roy.debjit| }} |
| − | + | [[Category:Java ME]][[Category:Location]][[Category:Location API (JSR-179)]][[Category:GPS]][[Category:Known Issue]][[Category:S60 3rd Edition FP1]] | |
| − | + | {{ArticleMetaData <!-- v1.2 --> | |
| − | {{ | + | |sourcecode= <!-- Link to example source code e.g. [[Media:The Code Example ZIP.zip]] --> |
| − | + | |installfile= <!-- Link to installation file (e.g. [[Media:The Installation File.sis]]) --> | |
| − | | | + | |devices= Nokia E90 Communicator, Nokia 6110 Navigator |
| − | | | + | |sdk= <!-- SDK(s) built and tested against (e.g. [http://linktosdkdownload/ Nokia Qt SDK 1.1]) --> |
| − | |devices=Nokia E90 Communicator, Nokia 6110 Navigator | + | |platform= S60 3rd Edition FP1 |
| − | | | + | |devicecompatability= <!-- Compatible devices e.g.: All* (must have internal GPS) --> |
| − | | | + | |dependencies= <!-- Any other/external dependencies e.g.: Google Maps Api v1.0 --> |
| − | | | + | |signing= <!-- Signing requirements - empty or one of: Self-Signed, DevCert, Manufacturer --> |
| − | |keywords= | + | |capabilities= <!-- Capabilities required by the article/code example (e.g. Location, NetworkServices. --> |
| + | |keywords= <!-- APIs, classes and methods (e.g. QSystemScreenSaver, QList, CBase --> | ||
| + | |language= <!-- Language category code for non-English topics - e.g. Lang-Chinese --> | ||
| + | |translated-by= <!-- [[User:XXXX]] --> | ||
| + | |translated-from-title= <!-- Title only --> | ||
| + | |translated-from-id= <!-- Id of translated revision --> | ||
| + | |review-by= skalogir | ||
| + | |review-timestamp= 20111117 | ||
| + | |update-by= <!-- After significant update: [[User:username]]--> | ||
| + | |update-timestamp= <!-- After significant update: YYYYMMDD --> | ||
| + | |creationdate= 20080402 | ||
| + | |author= [[User:Technical writer 1]] | ||
| + | <!-- The following are not in current metadata --> | ||
| + | |id= KIJ000875 | ||
}} | }} | ||
| − | |||
==Overview== | ==Overview== | ||
| − | |||
| − | ==Description== | + | {{Abstract|When using Location API's (JSR-179) methods to get a proper provider, it is not possible to stop GPS module location activity if there is a GPS satellite fix, resulting in reduced battery life.}} |
| − | Location API's | + | {{Note|On Symbian Anna devices, this issue has been fixed, so stopping listening to location updates from within the application, results in reduced battery power consumption. See also [[Best practises for listening to location updates with Java ME]].}} |
| + | ==Description == | ||
| + | |||
| + | Location API's {{Icode|getInstance(Criteria criteria)}} method selects the location provider based on the defined criteria, where the value null indicates the least restrictive criteria with default values. | ||
Example usage for acquiring location provider information with JSR-179: | Example usage for acquiring location provider information with JSR-179: | ||
| + | <code java> | ||
| + | .. | ||
| + | LocationProvider locProvider; | ||
| + | .. | ||
| + | locProvider = LocationProvider.getInstance(null); | ||
| + | locProvider.setLocationListener(this, -1, 0, 0); //setting listener for LocationProvider updates | ||
| + | </code> | ||
| + | When acquiring location provider information as defined above, the Location API does not stop GPS module location activity if there is a GPS satellite fix. When the location listener is stopped and the location provider is reset, the actual receiver does not stop and it does not power down (regardless of whether the satellite fix continues to be available or not): | ||
| + | <code java> | ||
| + | locProvider.setLocationListener(null, -1, 0, 0); // setting registered listener cancelled | ||
| + | locProvider.reset(); // resetting LocationProvider by aborting all pending synchronous requests | ||
| + | </code> | ||
| + | As a result, battery life is reduced to below 10 hours. | ||
| − | + | == How to reproduce == | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | Download and install [http://www.developer.nokia.com/info/sw.nokia.com/id/324866e9-0460-4fa4-ac53-01f0c392d40f/Nokia_Energy_Profiler.html Nokia Energy Profiler]. | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | Download and install [http://www. | + | |
Implement a test MIDlet using this | Implement a test MIDlet using this | ||
| − | [http:// | + | [http://www.developer.nokia.com/Community/Discussion/showthread.php?124336-JSR-179API-provider-reset-to-stop-GPS-location-activity&s=61e0dd35b6dca11ae234fcbee160e0a9&p=376467 source code]. |
| − | + | ||
Procedures: | Procedures: | ||
| + | # Launch Nokia Energy Profiler. From Options, choose Start to begin measurement and check the initial battery level in the top right corner. | ||
| + | # Leave Nokia Energy Profiler running and exit it by pressing the Menu key. | ||
| + | # Launch the test MIDlet. The MIDlet starts searching for a fix. After a fix has been found, press '''Stop GPS'''. Leave the MIDlet running and exit it by pressing the Menu key. | ||
| + | # Resume to the Nokia Energy Profiler and check the battery level. It is now reduced to below 10 hours. | ||
| + | # Repeat step 2. | ||
| + | # Resume to the running MIDlet and close it by pressing Exit. | ||
| + | # Repeat step 4. The battery level will be slowly resumed. Close the Profiler by pressing Exit. Relaunch the Profiler and start the measurement again to view the improved battery level. | ||
| − | + | == Solution == | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | Exiting the MIDlet results in improved battery level on S60 3rd Edition, Feature Pack 1 devices. On Symbian Anna devices, this issue has been fixed, so stopping listening to location updates from within the application, results in reduced battery power consumption. See also [[Best practises for listening to location updates with Java ME]]. | |
| − | Exiting the MIDlet results in improved battery level. | + | |
Revision as of 07:10, 28 June 2012
Archived: This article is archived because it is not considered relevant for third-party developers creating commercial solutions today. If you think this article is still relevant, let us know by adding the template {{ReviewForRemovalFromArchive|user=~~~~|write your reason here}}.
Article Metadata
Tested with
Devices(s): Nokia E90 Communicator, Nokia 6110 Navigator
Compatibility
Platform(s): S60 3rd Edition FP1
Article
Created: User:Technical writer 1
(02 Apr 2008)
Reviewed: skalogir (17 Nov 2011)
Last edited: hamishwillee
(28 Jun 2012)
Contents |
Overview
When using Location API's (JSR-179) methods to get a proper provider, it is not possible to stop GPS module location activity if there is a GPS satellite fix, resulting in reduced battery life.
Note: On Symbian Anna devices, this issue has been fixed, so stopping listening to location updates from within the application, results in reduced battery power consumption. See also Best practises for listening to location updates with Java ME.
Description
Location API's getInstance(Criteria criteria) method selects the location provider based on the defined criteria, where the value null indicates the least restrictive criteria with default values.
Example usage for acquiring location provider information with JSR-179:
..
LocationProvider locProvider;
..
locProvider = LocationProvider.getInstance(null);
locProvider.setLocationListener(this, -1, 0, 0); //setting listener for LocationProvider updates
When acquiring location provider information as defined above, the Location API does not stop GPS module location activity if there is a GPS satellite fix. When the location listener is stopped and the location provider is reset, the actual receiver does not stop and it does not power down (regardless of whether the satellite fix continues to be available or not):
locProvider.setLocationListener(null, -1, 0, 0); // setting registered listener cancelled
locProvider.reset(); // resetting LocationProvider by aborting all pending synchronous requests
As a result, battery life is reduced to below 10 hours.
How to reproduce
Download and install Nokia Energy Profiler.
Implement a test MIDlet using this source code.
Procedures:
- Launch Nokia Energy Profiler. From Options, choose Start to begin measurement and check the initial battery level in the top right corner.
- Leave Nokia Energy Profiler running and exit it by pressing the Menu key.
- Launch the test MIDlet. The MIDlet starts searching for a fix. After a fix has been found, press Stop GPS. Leave the MIDlet running and exit it by pressing the Menu key.
- Resume to the Nokia Energy Profiler and check the battery level. It is now reduced to below 10 hours.
- Repeat step 2.
- Resume to the running MIDlet and close it by pressing Exit.
- Repeat step 4. The battery level will be slowly resumed. Close the Profiler by pressing Exit. Relaunch the Profiler and start the measurement again to view the improved battery level.
Solution
Exiting the MIDlet results in improved battery level on S60 3rd Edition, Feature Pack 1 devices. On Symbian Anna devices, this issue has been fixed, so stopping listening to location updates from within the application, results in reduced battery power consumption. See also Best practises for listening to location updates with Java ME.
