BMW 2.x to 3.0 Migration Guide
This guide has been written to help you migrate from BMW 2.x to version 3.0, and understand the improvements that were made in this new version.
I) Migrating from 2.x to 3.0
1) Display configuration
Default display settings have changed, however you can change that easily.
There are no longer dedicated settings for those, but you can:
- tap the settings button on the bottom-left of the status tab.
- long-press a graph to show extra options (split graph, show history, use coded colors), etc.
- long-press the text history to show extra options (full history vs % changes only, or mA vs %/h display).
- tap the %/h or mA column to switch between %/h or mA
2) Main screen = Status tab
By default the status tab shows monitoring status and the source of current mA and battery capacity. You can tap the settings button on the left of the status information to change the tab display (graphs or text history) or make appropriate corrections to data source.
If recording is off, graphs, history, calibration and markers cannot be used because the app is not logging any data. This information will be written in red if so.
3) Battery data recording
Battery data are recorded in real-time (see below for more details) by default or every 10 minutes running on KitKat.
Recording is on by default, however if it is turned off, the display configuration is automatically adapted as graphics/history/etc would have no data to show.
You can change recording in battery / monitoring settings.
Data is now recorded in a database, but you can export/import it from battery settings. This is especially useful when reinstalling the app.
4) Tabbed interface and navigation bar
5) Graphic widgets
6) Internal notification icon
Version 3.0 no longer offer an internal notification icon, please open notification settings and tap on 'Notification Packages' to download and install an external package, then re-open 'Notification Packages' to activate it. You might have to enable 'unknown sources' in Android settings to have Android install the pack or if rooted temporarily grant root to the app so it is installed automatically.
Pro users can add a notification shortcut to display battery information and also workaround the KitKat kill-bug.
When updating to 3.0, alarms are all disabled. They can now be configured in the last tab on the right (Watchers) and are now much more flexible.
8) Widgets issues?
Some users have reported having widgets lost during each and every update after migrating to 3.x, or getting duplicate widgets in the widgets list. This has nothing to do with 3.x and actually happens with version 2.x as well, see here for more information. Updating from 2.x to 3.x will definitely remove all existing widgets from your home screen, but only the first time you update to 3.x.
Widget configurations can be saved (at the bottom of the widgets settings page) so that they can be quickly applied later.
FWIW, Android OS maintains the list of available and added widgets based on a static configuration provided by widget apps. Duplicates or lost widgets are not the result of an app bug.
II) Changes and improvements
1) Battery recording
Battery data are now logged in real-time by default. This allows knowing precisely when % changes, measuring precise %/h and more accurate estimates, while previous version would log every 10 minutes by default, % changes could jump by a few %, making %/h and various estimates less accurate.
Tests have also shown that real-time logging consumes half to a third of the CPU consumed with version 2.x recording at the default 10 minutes interval. See screenshots here for actual measures on different devices.
This change has been made following many user requests and feedback that were not able to get precise % information int the old version.
It was also required for all devices with estimated mA, where the lack of % precision would create discrepancies in mA reported and incorrect battery capacity calculations.
2) Main screen shows recording status and mA/mAh source by default
The app now displays detailed information about recording status and the source of the current (mA) and battery capacity data. This is important because mA data is either provided by Android kernel or estimated based on % changes, and battery capacity is provided by Android OS.
As we received daily complaints that mA or battery capacity was "not recognized" by the app, it was important that the app clearly shows where this data is coming from.
We also received many complaints that the app would not record any data by default (without widgets or notifications) so it is also important to show that information to new and existing users.
3) History in a database
We received many feedback and requests from existing users over the year to make the app follow Android guidelines, hence store data in a database. This also helps improve overall app performance while recording or loading data.
An import/export feature has been added in battery settings for users using the old file on their PC or when reinstalling the app.
4) Graph use theme color by default
We received many feedback and requests from existing users over the year to make the UI follow Android guidelines, hence not show red/green colors in the graphics. Experts can however switch back to the old behavior when desired.
5) History text shows %/h by default
6) History text shows % changes only by default
7) History markers
Markers have been greatly improved and can now show history statistics for ROM, Kernel changes and also provide an overall summary or detail view.
8) Battery statistics
The app now displays detailed information about wakelock and app run-times and calculate % drained by each app.
The app now displays the recorded charge cycles and the calculated capacity from each cycle. This more clearly show how the calculation is made and makes it easier to understand. There used to be a lot of request because the old version would not clearly identify used cycles.