C
HAPTER
10. P
LUGINS
120
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 directory, 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
This column reports 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
start 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.
Time Left
It shows the estimated (by Rockbox) remaining time until shutdown. Again,
as with Level(above), this column can be used to see differences between real time
left and estimated time left. This could help make time left more accurate.
Voltage
The battery voltage, the moment the measurement was captured. Measure-
ments are captured when this number changes while benchmarking. This column
can be used to give quite interesting graphs in a spreadsheet program. (Excel,
Calc, e.t.c)
T
HE
R
OCKBOX MANUAL
I
RIVER
H3
XX
