BatMemTime Today Screen Plug in Version 3.3.4
For Pocket PC 2002 (arm and x-scale) & Pocket PC 2000 (ARM, MIPS, & SH3)


Description
-----------

Displays any or all of the following information on the today screen.

Battery:
	Backup Battery Level (not all devices support this)
	Main Battery Level
	Main Battery Voltage (not all devices support this)
	Up-Time since last charge
	Estimated Remaining time Based on:
		Average Power Use 
		Avg Use for current charge cyle 
		Current Power Use

Memory:
	free/used Storage and Program Memory (formatted as in Memory settings control panel applet)

Storage:
	Up to 6 storage cards and Rom Stores ("hp safe store" or Toshibas' "Flash ROM Disk").

Up-time:
	Up-time since last soft reset, since resetable time, and Total Up-time since install or last hard reset.

Either Used, Free, or Total memory size can be displayed next to memory gauges


Controls/Settings
-----------------

Tap on the main icon to bring up the Options Dialog.

Tap on (Used, Free, or Total) Under the main icon to toggle between the three options for memory display.  Or if there is only one line of information tap on the (U, F, or T) next to the main icon.  The gauges themselves don't change.  They always display used memory as the solid part of the gauge and free memory as the open part of the gauge.

Tap on the storage/program gauge to bring up the Memory Settings Control Panel applet.

Tapping and dragging on the storage/program split line will change the memory division

Tap on any other item to bring up a description of that item.

Tap on storage card gauges to see the cards name.

Tapping on the up-time since last recharge will give you an option to reset the counter to zero manually.

Tapping on the Estimated remaining time, displays all three estimates using different calculation methods.  You are given the option to toggle to another one of the methods.


Features
--------

Multi-threaded: Uses a worker thread to gather information.  This prevents the UI from getting locked up while waiting for information to be returned by potentially slow response items like storage cards.

Only the information that changes gets re-drawn preventing excessive flashing of the display.

Uses See-thru gauges.  The unfilled portion of the gauges shows through to the today screen background.

Fully un-installs itself.
  
Offers three different methods of Estimating remaining battery time:

Average Power Use: 
Use this option if you don't change between normal and extended batteries and are using the Pocket PC as you normally do.

Average Use for this charge cycle:
Use this option if you change between normal and extended batteries or are using the device in a way that you normally don't that would use more or less power than usual.

CurrentPowerUse:
This bases its estimate on the last X percent of battery drain, where X = the resolution of your Pocket PCs gauge.  (If the gauge shows every 1% increment then the last 1% is what the estimate will be based on.)
This is usefull for checking out how the power use changes as you use your Pocket PC for various things.  THis can be very interesting, but occasionaly you will get a weird reading from this setting which usually goes away after another % drop in level.  It is usually caused by leaving the Pocket PC off for a while, because the power drains without up-time, so it thinks that you are draining the battery very fast and it will display a very short battery life.


You will have to drop through 2 battery level increments before any estimated remaining time predictions are made.


Enhancements and Bug Fixes
--------------------------

3.3.4
-----

Ignores folders named NETWORK* when displaying storage cards


3.3.3
-----

Handles 6 Storage Cards instead of 3


3.3.2
-----

PPC2000 only: Added an optional transparent background for use with facelift. (beta)


3.3
---
Improved the filtering of data used to estimate remaining battery time.  Un-realistic data is ignored.  Some of the filtering is always done.  Additional filtering is done if you check the option to "Ignore un-realistic or Offline Lve Drop".  This also causes some level drops while turned off to be ignored.  Only extremely unrealistic values are filtered out for now.  An adjustable filtering level may be added in the future.

Added ability to change the gauge colors.  A standard color chooser dialog with a choice of 48 colors is displayed.  For now you can not tweak the colors.

Added ability to change the program/storage memory split by dragging on the gauge.

Added a re-settable up-time display.  The existing display of up-time since the last hard reset or install is now only seen in the message box that comes up when you click on the up-time display.

Miscellaneous minor bug fixes.  


3.2
---
Memory Leaks eliminated.

Eliminated slow update after being in the background.

Misc improvements behind the scenes.


3.1
---
Line indicating split between program and storage memory now updates properly when the split changes.

Memory leaks eliminated.  (Some remain.)

Multi-threading code was improved.

Minor formatting change to Total Uptime message box.


3.0
---
First public release.

Installation
------------

1. Copy 'BatMemTime Today Plugin 3.0.zip' to the desktop and unzip it.  
2. Double click on 'BatMemTime_Today_setup.exe' while your pocket PC is connected to the PC and it will be installed.
3. If this is an upgrade, it won't take effect until you do a soft-reset.

(c) 2003
Tom Gigear
tomgigear@msn.com
