1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
|
xbatt -- battery status display for X11
1.0 1995/04/04
1.1 1995/04/28
1.2 1997/03/07
Tohihisa Eto
eto@forus.or.jp
eto@osl.fujitsu.co.jp
1. WHAT IS XBATT?
xbatt is an X11 client which displays the battery status of your
notebook computer equiped with APM (Advanced Power Management) BIOS.
It works for both FreeBSD and Linux. The status displayed consists of
the remaining battery life, the AC line status, and the charging
status.
2. SYSTEM REQUIREMENT
xbatt acquires the battery status via the APM driver.
These instructions show how to configure the APM driver.
2.1 FreeBSD
In FreeBSD, the default kernel (GENERIC) contains APM driver.
However, it is disabled by default. To enable the APM driver find
following line in /etc/sys/config
apm_enable=NO
and change NO to YES then reboot.
In some environments, this driver may not work correctly. If your
PC does not work with APM driver, please refer to the documentation
that came with the PAO package.
The latest APM and PC-CARD (PCMCIA) related driver is released as
PAO package which was written by HOSOKAWA Tatsumi(hosokawa@jp.freebsd.org).
You can find latest information in following URL:
http://www.jp.freebsd.org/PAO/
You can check the configuration by executing 'apm' commands, e.g.:
% apm
APM version: 1.0
AC Line status: off-line
Battery status: high
Remaining battery life: 50%
Even with properly configured APM driver, on some hardware equiped
with older system BIOS or APM bios, 'apm' does not return 'Remaining
battery life'. If this happens, xbatt will not work on your system.
For users of IBM ThinkPad230Cs YB5 or YB7:
If your ThinkPad doesn't display a remaining battery, the BIOS
update kit (from IBM, found in FIBMFEEL forum of NIFTY-Serve, for
example) may help you. BUT DO AT YOUR OWN RISK.
2.2 Linux
Early versions of the Linux kernel do not contain the APM driver.
before 1.3.46
The kernel does not contain APM driver. You have to
get apm-bios driver.
1.3.46 or later
These kernels include thr APM driver. So you don't need to
install any optional drivers.
Note: The kernel-1.3.x is a development release, so you
should change your kernel to 2.0.x.
If the APM driver is enabled in your environment, you can find the
file entry /proc/apm. If the file does not exist you will need to
reconfigure your kernel.
To enable the APM driver in your kernel, you have to run:
make config
then, answer following question in "Character device configuration" as
follows:
Advanced Power Management BIOS support (CONFIG_APM) [n] y
You can find APM related information in following URL:
http://www.cs.utexas.edu/users/kharker/linux-laptop/apm.html
You can check the configuration by following commands, e.g.:
- before 1.3.46 + apm-bios
% cat /proc/apm
BIOS version: 1.0
Flags: 0x03
Entry e800:5f80 cseg16 e800 dseg 3c00
AC: on line
Battery status: high
Battery life: 93%
- 1.3.46 or later
% cat /proc/apm
1.2 1.0 0x03 0x01 0x00 0xff 25% -1 ?
3. INSTALLATION
To build xbatt, you will need the XPM library (libXpm), which is
included in X11R6 contrib. If you use FreeBSD, and you don't want
make xbatt from the source, install package named `xpm-3.4*.tgz'.
To make the program, type:
xmkmf
make
To install the program, type:
make install
4. FEATURES
xbatt checks a battery status once in every 30 seconds, and updates
its display if necessary. If you move your mouse cursor to the
battery icon, xbatt will get current battery information, and display
in 1% units (if your BIOS supports this).
To change the update interval, specify the -titerInterval option, or
change the macro UPDATE_INTERVAL which written in Imakefile.
If xbatt doesn't display the correct status after resume, then move
the mouse cursor to battery icon. This action will reset the xbatt
timer.
If you use fvwm, you can 'stick' xbatt to the screen's glass by
adding the following line to ~/.fvwmrc:
Style "xbatt" NoTitle,Sticky,StaysOnTop,WindowListSkip,CirculateSkip
If you use FvwmButtons, you can put xbatt to your button area by
adding the following line to ~/.fvwmrc:
*FvwmButtons(Title xbatt, Swallow(UseOld) "xbatt" \
'Exec /usr/local/bin/xbatt &')
5. ACKNOWLEDGMENT
The author would like to express his sincere appreciation to the
following people:
for FreeBSD support
Tatsumi Hosokawa (hosokawa@jp.FreeBSD.org)
Noriyuki Takahashi (nor@aecl.ntt.jp)
Hajimu UMEMOTO (ume@iabs.hitachi.co.jp)
Kouki Higuchi <luke@fct.kgc.co.jp>
EGUCHI Osamu <eguchi@shizuokanet.or.jp>
and BSD-Nomads mailing list member
for Linux support
Koyama Tadayoshi (pcs00294@asciinet.or.jp)
Hisamatsu Hiroshi (hisama@pfu.co.jp)
Shoichi NAKAYAMA (naka@fadev.fvd.fujitsu.co.jp)
Yoshihito Yamagami (yoshi@funival.mfd.cs.fujitsu.co.jp)
Masahide NODA (mac@pssys.flab.fujitsu.co.jp)
M Ishigaki <mi@sy.ssl.fujitsu.co.jp>
Kunihiko IMAI <imai@musen.ts.fujitsu.co.jp>
Toshio Fujishiro <fjsr@s4w021.ss.ts.fujitsu.co.jp>
6. QUESTIONS?
Comments, bug-reports, and patches are welcome. Try sending a mail
to eto@forus.or.jp or eto@osl.fujitsu.co.jp .
Following list shows PC and OS configuration on which xbatt is
reported to work.
<<<FreeBSD>>>
DEC High-Note Ultra2 2.1.5-RELEASE PAO-960831
DEC High-Note Ultra2 2.2-960801-SNAP PAO-961002(*2)
DEC High-Note Ultra2 2.2-SNAP-960801 PAO-961002
IBM ThinkPad 230Cs(FBW) 2.2-ALPHA PAO-961215
IBM ThinkPad 230Cs(YB7) 2.1.5-RELEASE PAO-960831
IBM ThinkPad 530Cs 2.2-ALPHA PAO-961215(*1)
IBM ThinkPad 535 2.2-BETA PAO-961215
IBM ThinkPad 560 2.2-961014-SNAP PAO-961020
IBM Thinkpad 535 2.2-970205-GAMMAPAO-970210
Panasonic JETmini CF-11 2.1.0-RELEASE pccard-test-960207
Panasonic JETmini CF-11 2.1.5-RELEASE PAO-960831
SOTEC WinBookBird133G/S 2.2-970205-GAMMA
Sharp Mebius (PC-A354) 2.2-960801-SNAP PAO-961002
Sharp Mebius (PC-A455) 2.1.5-RELEASE PAO-960831
Toshiba Dynabook SSR575 2.2-970225-GAMMAPAO-970210
Toshiba PORTAGE 620 2.2-ALPHA PAO-961215
Toshiba PORTEGE 620 2.2-970205-GAMMAPAO-970210
Toshiba PORTEGE 620CT 2.2-BETA PAO-961215
Toshiba Satellite 110CS 2.2-961014-SNAP PAO-961020
*1 Cannot get correct battery life in TP530
*2 CTS5100 BIOS ver2.10
<<<Linux>>>
Fujitsu FMV-475NL/S Linux-1.2.8 + apm-bios-0.5
Fujitsu FMV-475NL/S Linux-2.0.27
Fujitsu FMV-475NL/T Linux-2.0.22
SOTEC WinBook Bird 100 Linux-2.0.23
TOSHIBA Libretto20 Linux-2.0.27
TOSHIBA Libretto50 Linux-2.0.27
<END-OF-FILE>
|
