dockapps/wmacpi
Doug Torrance a68f78f034 wmacpi: Bump to wmacpi-ng version 0.50.
Source obtained from http://sourceforge.net/projects/wmacpi/files/.

2003 July 6 0.50
	Finally got rid of that annoying button - that space now contains
	a 'B 1' or 'B 2' (only those two at present, since I'm too lazy to
	fix it so that the number is generic. It should work fine for
	anyone who doesn't have a freakish system with more than two
	batteries . . .)

	A few more code cleanups.
2014-08-19 18:13:56 +01:00
..
.xvpics wmacpi: Bump to wmacpi-ng version 0.50. 2014-08-19 18:13:56 +01:00
debian wmacpi: Bump to wmacpi-ng version 0.50. 2014-08-19 18:13:56 +01:00
acpi-ng.c wmacpi: Bump to wmacpi-ng version 0.50. 2014-08-19 18:13:56 +01:00
AUTHORS Strip off version numbers from dir name 2012-02-12 22:50:31 +00:00
ChangeLog wmacpi: Bump to wmacpi-ng version 0.50. 2014-08-19 18:13:56 +01:00
COPYING wmacpi: Bump to wmacpi-ng version 0.50. 2014-08-19 18:13:56 +01:00
INSTALL Strip off version numbers from dir name 2012-02-12 22:50:31 +00:00
libacpi.c wmacpi: Bump to wmacpi-ng version 0.50. 2014-08-19 18:13:56 +01:00
libacpi.h wmacpi: Bump to wmacpi-ng version 0.50. 2014-08-19 18:13:56 +01:00
Makefile wmacpi: Bump to wmacpi-ng version 0.50. 2014-08-19 18:13:56 +01:00
master.xpm wmacpi: Bump to wmacpi-ng version 0.50. 2014-08-19 18:13:56 +01:00
master_low.xpm wmacpi: Bump to wmacpi-ng version 0.50. 2014-08-19 18:13:56 +01:00
README Strip off version numbers from dir name 2012-02-12 22:50:31 +00:00
TODO wmacpi: Bump to wmacpi-ng version 0.50. 2014-08-19 18:13:56 +01:00
wmacpi-ng.c wmacpi: Bump to wmacpi-ng version 0.50. 2014-08-19 18:13:56 +01:00
wmacpi-ng.h wmacpi: Bump to wmacpi-ng version 0.50. 2014-08-19 18:13:56 +01:00

For install instructions, see "INSTALL" file.

Usage:

+-------------+
|battery graph| <- visual percentage battery remaining
|[:][=] [100%]| <- [:] - on AC (blink when charging) [=] - on battery
|[00:00] [///]| <- [00:00] time remaining   [///] timer mode switch
|status   area| <- messages scroll here
+-------------+

see wmacpi -h for some command line switches

Timer mode, available only when "on-battery", keeps track how long your laptop
has been away from AC power.  Clicking the button toggles between timer and
standard "time remaining" mode.

******************************************************************************

Implementation of "ACPI" mode:

As far as I know, there aren't any tools available right now to process battery
statistics provided in /proc/power by ACPI stuff in 2.4.x kernels.  This is my
attempt to have a usable dockapp battery monitor for ACPI laptop systems.
Since version 1.32 I've added some code to detect multiple batteries.  However
it's not fully implemented yet, and while it will detect and enumerate
batteries, the statistics reported are for the first found battery.
  * Your battery is "Control Method" type
  * Your ACPI BIOS is supported by current version of ACPI in kernel
    2.4.17 + intel patches
  * You applied acpi subsystem patch version 20020214 (from intel.com)

If you are using kernels or ACPI version older than 2.4.17, keep using 
wmacpi 1.32. This version is only for the latest ACPI code.
To use ACPI support, just follow "INSTALL" instructions.  Makefile has been
updated to include -DACPI. If you don't have ACPI, you don't need this version
of wmacpi. Information below only applies to APM systems, without ACPI support.

Implementation of "APM" mode

This works on all machines that have a standard non-borked APM implementation.
For people with broken APM implementations, I added some stuff, which was
sent to me by Daniel Pittman <daniel@rimspace.net>, to compensate for some
of the stupidity.  If you see dumb behaviour from wmapm, consider editing
wmapm.c and uncomment one, or both, of these lines (on lines 19 and 20):

#define RETARDED_APM if your bios thinks the battery is charging all the time
when it's on AC power.  What this will do is stop "charging" process as soon
as the battery reaches 100%.

#define STUPID_APM if your bios shows -1 minutes remaining when AC is plugged
in, or when battery is charging.

If your bios is even dumber than this, and you come up with another special
case that needs to be handled, feel free to #ifdef it under <badword>_APM and
send me a diff -u.  I will include it in the next version.  Any of these
changes would have to go into acquire_apm_info.  Note, I changed format of
apminfo structure to get rid of redundancy - now there is only one power state
variable, which keeps track whether we are on AC, charging, battery, etc.

Note, all the *_APM stuff is untested - my laptop has a working BIOS :)  If you
test this and it doesn't work as advertised, go ahead and send me a fix.

 -timecop