DRAFT
VERSION
C
HAPTER
7. P
LUGINS
43
7.4.2. Battery Benchmark
The Battery Benchmark Plugin enables you to test your battery’s performance, while
making normal use of your player. Once loaded it will run in the background (TSR plu-
gin), reading various info about your battery while you use it. Once you finish your ses-
sion you can find the benchmark output data in a file on your player
/battery bench.txt
.
Please submit your results to the Rockbox wiki.
http://www.rockbox.org/twiki/bin/view/
Main/BatteryRuntime
How it works
After you load the plug-in the operation of your player continues as normal. You can
do whatever you could do before loading the plugin except loading another plugin.
If you happen to load a plugin while benchmarking, a splash screen will inform you
about the termination of the benchmark. While you operate it will log various battery
related information every time the disk is activated by external causes, (buffer refill,
open folder, USB mode) or an hour passes without updating the log file.
The plugin will continue to log info until:
•
Another plugin is loaded.
•
The player is shut down.
•
The battery is empty.
Between disk activity (or an hour), it will log info in memory (every measurement is
captured when the voltage changes). If there are too many measurements older entries
will be deleted and the log file will inform the user about the interval where entries
were lost. Benchmarks can be resumed if you accidentally load a plugin, or turn off
your player, as long as the log file
/battery bench.txt
is not deleted.
Information explained
On the top of the file you will see various info on how to use the plugin.
Time
It is the total time of operation of the player. It is not the time that you started
the plug-in. If you have your player on for 5 minutes and then startt the plugin,
it will start measuring from 5 minutes.
Seconds
As time, it shows time passed in seconds. Nothing special, it is there because
it is free and maybe someone might want to make graphs with seconds.
Level
The percent level of the battery estimated by Rockbox. This is an estimation
and not an accurate result. Using the real percentage (current battery voltage /
top battery voltage) * 100) we can calculate the difference between the estima-
tion. Goal of this column is to make the estimation algorithm of Rockbox more
accurate.
T
HE
R
OCKBOX MANUAL
A
RCHOS
S
TUDIO
/P
LAYER
