wmacpi/README

   1 For install instructions, see "INSTALL" file.
   2
   3 Usage:
   4
   5 +-------------+
   6 |battery graph| <- visual percentage battery remaining
   7 |[:][=] [100%]| <- [:] - on AC (blink when charging) [=] - on battery
   8 |[00:00] [///]| <- [00:00] time remaining   [///] timer mode switch
   9 |status   area| <- messages scroll here
  10 +-------------+
  11
  12 see wmacpi -h for some command line switches
  13
  14 Timer mode, available only when "on-battery", keeps track how long your laptop
  15 has been away from AC power.  Clicking the button toggles between timer and
  16 standard "time remaining" mode.
  17
  18 ******************************************************************************
  19
  20 Implementation of "ACPI" mode:
  21
  22 As far as I know, there aren't any tools available right now to process battery
  23 statistics provided in /proc/power by ACPI stuff in 2.4.x kernels.  This is my
  24 attempt to have a usable dockapp battery monitor for ACPI laptop systems.
  25 Since version 1.32 I've added some code to detect multiple batteries.  However
  26 it's not fully implemented yet, and while it will detect and enumerate
  27 batteries, the statistics reported are for the first found battery.
  28   * Your battery is "Control Method" type
  29   * Your ACPI BIOS is supported by current version of ACPI in kernel
  30     2.4.17 + intel patches
  31   * You applied acpi subsystem patch version 20020214 (from intel.com)
  32
  33 If you are using kernels or ACPI version older than 2.4.17, keep using
  34 wmacpi 1.32. This version is only for the latest ACPI code.
  35 To use ACPI support, just follow "INSTALL" instructions.  Makefile has been
  36 updated to include -DACPI. If you don't have ACPI, you don't need this version
  37 of wmacpi. Information below only applies to APM systems, without ACPI support.
  38
  39 Implementation of "APM" mode
  40
  41 This works on all machines that have a standard non-borked APM implementation.
  42 For people with broken APM implementations, I added some stuff, which was
  43 sent to me by Daniel Pittman <daniel@rimspace.net>, to compensate for some
  44 of the stupidity.  If you see dumb behaviour from wmapm, consider editing
  45 wmapm.c and uncomment one, or both, of these lines (on lines 19 and 20):
  46
  47 #define RETARDED_APM if your bios thinks the battery is charging all the time
  48 when it's on AC power.  What this will do is stop "charging" process as soon
  49 as the battery reaches 100%.
  50
  51 #define STUPID_APM if your bios shows -1 minutes remaining when AC is plugged
  52 in, or when battery is charging.
  53
  54 If your bios is even dumber than this, and you come up with another special
  55 case that needs to be handled, feel free to #ifdef it under <badword>_APM and
  56 send me a diff -u.  I will include it in the next version.  Any of these
  57 changes would have to go into acquire_apm_info.  Note, I changed format of
  58 apminfo structure to get rid of redundancy - now there is only one power state
  59 variable, which keeps track whether we are on AC, charging, battery, etc.
  60
  61 Note, all the *_APM stuff is untested - my laptop has a working BIOS :)  If you
  62 test this and it doesn't work as advertised, go ahead and send me a fix.
  63
  64  -timecop