Commit | Line | Data |
---|---|---|
c38e0c97 | 1 | ;;; battery.el --- display battery status information -*- coding: utf-8 -*- |
6b279740 | 2 | |
ba318903 | 3 | ;; Copyright (C) 1997-1998, 2000-2014 Free Software Foundation, Inc. |
6b279740 | 4 | |
3b361901 | 5 | ;; Author: Ralph Schleicher <rs@nunatak.allgaeu.org> |
d5323ba0 | 6 | ;; Keywords: hardware |
6b279740 | 7 | |
f12b0b96 | 8 | ;; This file is part of GNU Emacs. |
6b279740 | 9 | |
eb3fa2cf | 10 | ;; GNU Emacs is free software: you can redistribute it and/or modify |
6b279740 | 11 | ;; it under the terms of the GNU General Public License as published by |
eb3fa2cf GM |
12 | ;; the Free Software Foundation, either version 3 of the License, or |
13 | ;; (at your option) any later version. | |
6b279740 | 14 | |
f12b0b96 | 15 | ;; GNU Emacs is distributed in the hope that it will be useful, |
6b279740 RS |
16 | ;; but WITHOUT ANY WARRANTY; without even the implied warranty of |
17 | ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
18 | ;; GNU General Public License for more details. | |
19 | ||
20 | ;; You should have received a copy of the GNU General Public License | |
eb3fa2cf | 21 | ;; along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. |
6b279740 RS |
22 | |
23 | ;;; Commentary: | |
24 | ||
20d4381e JR |
25 | ;; There is at present support for GNU/Linux, OS X and Windows. This |
26 | ;; library supports both the `/proc/apm' file format of Linux version | |
27 | ;; 1.3.58 or newer and the `/proc/acpi/' directory structure of Linux | |
28 | ;; 2.4.20 and 2.6. Darwin (OS X) is supported by using the `pmset' | |
29 | ;; program. Windows is supported by the GetSystemPowerStatus API call. | |
6b279740 RS |
30 | |
31 | ;;; Code: | |
32 | ||
33 | (require 'timer) | |
f58e0fd5 | 34 | (eval-when-compile (require 'cl-lib)) |
6b279740 | 35 | \f |
4bef9110 SE |
36 | (defgroup battery nil |
37 | "Display battery status information." | |
38 | :prefix "battery-" | |
39 | :group 'hardware) | |
40 | ||
6decb6c2 SM |
41 | ;; Either BATn or yeeloong-bat, basically. |
42 | (defconst battery--linux-sysfs-regexp "[bB][aA][tT][0-9]?$") | |
43 | ||
4bef9110 | 44 | (defcustom battery-status-function |
6b279740 RS |
45 | (cond ((and (eq system-type 'gnu/linux) |
46 | (file-readable-p "/proc/apm")) | |
2b3cb60a EZ |
47 | 'battery-linux-proc-apm) |
48 | ((and (eq system-type 'gnu/linux) | |
49 | (file-directory-p "/proc/acpi/battery")) | |
71d21198 | 50 | 'battery-linux-proc-acpi) |
3660b4f5 CY |
51 | ((and (eq system-type 'gnu/linux) |
52 | (file-directory-p "/sys/class/power_supply/") | |
6decb6c2 SM |
53 | (directory-files "/sys/class/power_supply/" nil |
54 | battery--linux-sysfs-regexp)) | |
3660b4f5 | 55 | 'battery-linux-sysfs) |
19b748ad TM |
56 | ((and (eq system-type 'berkeley-unix) |
57 | (file-executable-p "/usr/sbin/apm")) | |
58 | 'battery-bsd-apm) | |
71d21198 | 59 | ((and (eq system-type 'darwin) |
785428c7 RF |
60 | (condition-case nil |
61 | (with-temp-buffer | |
248634e9 LK |
62 | (and (eq (call-process "pmset" nil t nil "-g" "ps") 0) |
63 | (> (buffer-size) 0))) | |
64 | (error nil))) | |
20d4381e | 65 | 'battery-pmset) |
0fda9b75 | 66 | ((fboundp 'w32-battery-status) |
20d4381e | 67 | 'w32-battery-status)) |
9201cc28 | 68 | "Function for getting battery status information. |
681e6b4b DL |
69 | The function has to return an alist of conversion definitions. |
70 | Its cons cells are of the form | |
6b279740 RS |
71 | |
72 | (CONVERSION . REPLACEMENT-TEXT) | |
73 | ||
74 | CONVERSION is the character code of a \"conversion specification\" | |
4bef9110 | 75 | introduced by a `%' character in a control string." |
681e6b4b | 76 | :type '(choice (const nil) function) |
4bef9110 | 77 | :group 'battery) |
6b279740 | 78 | |
4bef9110 | 79 | (defcustom battery-echo-area-format |
20d4381e | 80 | (cond ((eq battery-status-function 'battery-linux-proc-acpi) |
71d21198 | 81 | "Power %L, battery %B at %r (%p%% load, remaining time %t)") |
3660b4f5 | 82 | ((eq battery-status-function 'battery-linux-sysfs) |
54071013 | 83 | "Power %L, battery %B (%p%% load, remaining time %t)") |
71d21198 | 84 | ((eq battery-status-function 'battery-pmset) |
20d4381e JR |
85 | "%L power, battery %B (%p%% load, remaining time %t)") |
86 | (battery-status-function | |
87 | "Power %L, battery %B (%p%% load, remaining time %t)")) | |
9201cc28 | 88 | "Control string formatting the string to display in the echo area. |
6b279740 RS |
89 | Ordinary characters in the control string are printed as-is, while |
90 | conversion specifications introduced by a `%' character in the control | |
91 | string are substituted as defined by the current value of the variable | |
76815b2a RS |
92 | `battery-status-function'. Here are the ones generally available: |
93 | %c Current capacity (mAh or mWh) | |
94 | %r Current rate of charge or discharge | |
95 | %B Battery status (verbose) | |
96 | %b Battery status: empty means high, `-' means low, | |
97 | `!' means critical, and `+' means charging | |
98 | %d Temperature (in degrees Celsius) | |
99 | %L AC line status (verbose) | |
100 | %p Battery load percentage | |
101 | %m Remaining time (to charge or discharge) in minutes | |
102 | %h Remaining time (to charge or discharge) in hours | |
103 | %t Remaining time (to charge or discharge) in the form `h:min'" | |
4bef9110 SE |
104 | :type '(choice string (const nil)) |
105 | :group 'battery) | |
6b279740 RS |
106 | |
107 | (defvar battery-mode-line-string nil | |
108 | "String to display in the mode line.") | |
f4c4fc74 | 109 | ;;;###autoload (put 'battery-mode-line-string 'risky-local-variable t) |
6b279740 | 110 | |
43d5bf84 RS |
111 | (defcustom battery-mode-line-limit 100 |
112 | "Percentage of full battery load below which display battery status" | |
2bed3f04 | 113 | :version "24.1" |
43d5bf84 RS |
114 | :type 'integer |
115 | :group 'battery) | |
116 | ||
4bef9110 | 117 | (defcustom battery-mode-line-format |
20d4381e | 118 | (cond ((eq battery-status-function 'battery-linux-proc-acpi) |
c38e0c97 | 119 | "[%b%p%%,%d°C]") |
20d4381e | 120 | (battery-status-function |
71d21198 | 121 | "[%b%p%%]")) |
9201cc28 | 122 | "Control string formatting the string to display in the mode line. |
6b279740 RS |
123 | Ordinary characters in the control string are printed as-is, while |
124 | conversion specifications introduced by a `%' character in the control | |
125 | string are substituted as defined by the current value of the variable | |
76815b2a RS |
126 | `battery-status-function'. Here are the ones generally available: |
127 | %c Current capacity (mAh or mWh) | |
128 | %r Current rate of charge or discharge | |
129 | %B Battery status (verbose) | |
130 | %b Battery status: empty means high, `-' means low, | |
131 | `!' means critical, and `+' means charging | |
132 | %d Temperature (in degrees Celsius) | |
133 | %L AC line status (verbose) | |
134 | %p Battery load percentage | |
135 | %m Remaining time (to charge or discharge) in minutes | |
136 | %h Remaining time (to charge or discharge) in hours | |
137 | %t Remaining time (to charge or discharge) in the form `h:min'" | |
4bef9110 SE |
138 | :type '(choice string (const nil)) |
139 | :group 'battery) | |
140 | ||
141 | (defcustom battery-update-interval 60 | |
9201cc28 | 142 | "Seconds after which the battery status will be updated." |
4bef9110 SE |
143 | :type 'integer |
144 | :group 'battery) | |
6b279740 | 145 | |
71d21198 | 146 | (defcustom battery-load-low 25 |
9201cc28 | 147 | "Upper bound of low battery load percentage. |
71d21198 LK |
148 | A battery load percentage below this number is considered low." |
149 | :type 'integer | |
150 | :group 'battery) | |
151 | ||
152 | (defcustom battery-load-critical 10 | |
9201cc28 | 153 | "Upper bound of critical battery load percentage. |
71d21198 LK |
154 | A battery load percentage below this number is considered critical." |
155 | :type 'integer | |
156 | :group 'battery) | |
157 | ||
6b279740 RS |
158 | (defvar battery-update-timer nil |
159 | "Interval timer object.") | |
160 | ||
1720e508 | 161 | ;;;###autoload |
6b279740 RS |
162 | (defun battery () |
163 | "Display battery status information in the echo area. | |
b624447c | 164 | The text being displayed in the echo area is controlled by the variables |
6b279740 RS |
165 | `battery-echo-area-format' and `battery-status-function'." |
166 | (interactive) | |
167 | (message "%s" (if (and battery-echo-area-format battery-status-function) | |
168 | (battery-format battery-echo-area-format | |
169 | (funcall battery-status-function)) | |
170 | "Battery status not available"))) | |
171 | ||
1720e508 | 172 | ;;;###autoload |
73a6a972 | 173 | (define-minor-mode display-battery-mode |
06e21633 CY |
174 | "Toggle battery status display in mode line (Display Battery mode). |
175 | With a prefix argument ARG, enable Display Battery mode if ARG is | |
176 | positive, and disable it otherwise. If called from Lisp, enable | |
177 | the mode if ARG is omitted or nil. | |
178 | ||
179 | The text displayed in the mode line is controlled by | |
6b279740 | 180 | `battery-mode-line-format' and `battery-status-function'. |
06e21633 | 181 | The mode line is be updated every `battery-update-interval' |
6b279740 | 182 | seconds." |
62631b2c | 183 | :global t :group 'battery |
6b279740 RS |
184 | (setq battery-mode-line-string "") |
185 | (or global-mode-string (setq global-mode-string '(""))) | |
6b279740 | 186 | (and battery-update-timer (cancel-timer battery-update-timer)) |
f1cf7a31 JL |
187 | (if (and battery-status-function battery-mode-line-format) |
188 | (if (not display-battery-mode) | |
189 | (setq global-mode-string | |
190 | (delq 'battery-mode-line-string global-mode-string)) | |
191 | (add-to-list 'global-mode-string 'battery-mode-line-string t) | |
192 | (setq battery-update-timer (run-at-time nil battery-update-interval | |
193 | 'battery-update-handler)) | |
194 | (battery-update)) | |
195 | (message "Battery status not available") | |
196 | (setq display-battery-mode nil))) | |
6b279740 RS |
197 | |
198 | (defun battery-update-handler () | |
199 | (battery-update) | |
200 | (sit-for 0)) | |
201 | ||
202 | (defun battery-update () | |
203 | "Update battery status information in the mode line." | |
43d5bf84 RS |
204 | (let ((data (and battery-status-function (funcall battery-status-function)))) |
205 | (setq battery-mode-line-string | |
206 | (propertize (if (and battery-mode-line-format | |
207 | (<= (car (read-from-string (cdr (assq ?p data)))) | |
208 | battery-mode-line-limit)) | |
209 | (battery-format | |
210 | battery-mode-line-format | |
211 | data) | |
212 | "") | |
213 | 'face | |
214 | (and (<= (car (read-from-string (cdr (assq ?p data)))) | |
215 | battery-load-critical) | |
f22f4808 | 216 | 'error) |
43d5bf84 | 217 | 'help-echo "Battery status information"))) |
6b279740 | 218 | (force-mode-line-update)) |
6b279740 RS |
219 | \f |
220 | ;;; `/proc/apm' interface for Linux. | |
221 | ||
222 | (defconst battery-linux-proc-apm-regexp | |
223 | (concat "^\\([^ ]+\\)" ; Driver version. | |
224 | " \\([^ ]+\\)" ; APM BIOS version. | |
225 | " 0x\\([0-9a-f]+\\)" ; APM BIOS flags. | |
226 | " 0x\\([0-9a-f]+\\)" ; AC line status. | |
227 | " 0x\\([0-9a-f]+\\)" ; Battery status. | |
228 | " 0x\\([0-9a-f]+\\)" ; Battery flags. | |
d5323ba0 KH |
229 | " \\(-?[0-9]+\\)%" ; Load percentage. |
230 | " \\(-?[0-9]+\\)" ; Remaining time. | |
6b279740 RS |
231 | " \\(.*\\)" ; Time unit. |
232 | "$") | |
233 | "Regular expression matching contents of `/proc/apm'.") | |
234 | ||
235 | (defun battery-linux-proc-apm () | |
30710442 | 236 | "Get APM status information from Linux (the kernel). |
6b279740 RS |
237 | This function works only with the new `/proc/apm' format introduced |
238 | in Linux version 1.3.58. | |
239 | ||
240 | The following %-sequences are provided: | |
241 | %v Linux driver version | |
242 | %V APM BIOS version | |
243 | %I APM BIOS status (verbose) | |
244 | %L AC line status (verbose) | |
245 | %B Battery status (verbose) | |
246 | %b Battery status, empty means high, `-' means low, | |
247 | `!' means critical, and `+' means charging | |
12d6b124 | 248 | %p Battery load percentage |
76815b2a RS |
249 | %s Remaining time (to charge or discharge) in seconds |
250 | %m Remaining time (to charge or discharge) in minutes | |
251 | %h Remaining time (to charge or discharge) in hours | |
252 | %t Remaining time (to charge or discharge) in the form `h:min'" | |
6b279740 RS |
253 | (let (driver-version bios-version bios-interface line-status |
254 | battery-status battery-status-symbol load-percentage | |
12d6b124 LK |
255 | seconds minutes hours remaining-time tem) |
256 | (with-temp-buffer | |
257 | (ignore-errors (insert-file-contents "/proc/apm")) | |
258 | (when (re-search-forward battery-linux-proc-apm-regexp) | |
259 | (setq driver-version (match-string 1)) | |
260 | (setq bios-version (match-string 2)) | |
261 | (setq tem (string-to-number (match-string 3) 16)) | |
262 | (if (not (logand tem 2)) | |
263 | (setq bios-interface "not supported") | |
264 | (setq bios-interface "enabled") | |
265 | (cond ((logand tem 16) (setq bios-interface "disabled")) | |
266 | ((logand tem 32) (setq bios-interface "disengaged"))) | |
267 | (setq tem (string-to-number (match-string 4) 16)) | |
268 | (cond ((= tem 0) (setq line-status "off-line")) | |
269 | ((= tem 1) (setq line-status "on-line")) | |
270 | ((= tem 2) (setq line-status "on backup"))) | |
271 | (setq tem (string-to-number (match-string 6) 16)) | |
272 | (if (= tem 255) | |
273 | (setq battery-status "N/A") | |
274 | (setq tem (string-to-number (match-string 5) 16)) | |
275 | (cond ((= tem 0) (setq battery-status "high" | |
276 | battery-status-symbol "")) | |
277 | ((= tem 1) (setq battery-status "low" | |
278 | battery-status-symbol "-")) | |
279 | ((= tem 2) (setq battery-status "critical" | |
280 | battery-status-symbol "!")) | |
281 | ((= tem 3) (setq battery-status "charging" | |
282 | battery-status-symbol "+"))) | |
283 | (setq load-percentage (match-string 7)) | |
284 | (setq seconds (string-to-number (match-string 8))) | |
285 | (and (string-equal (match-string 9) "min") | |
286 | (setq seconds (* 60 seconds))) | |
287 | (setq minutes (/ seconds 60) | |
288 | hours (/ seconds 3600)) | |
289 | (setq remaining-time | |
290 | (format "%d:%02d" hours (- minutes (* 60 hours)))))))) | |
d5323ba0 KH |
291 | (list (cons ?v (or driver-version "N/A")) |
292 | (cons ?V (or bios-version "N/A")) | |
293 | (cons ?I (or bios-interface "N/A")) | |
294 | (cons ?L (or line-status "N/A")) | |
295 | (cons ?B (or battery-status "N/A")) | |
296 | (cons ?b (or battery-status-symbol "")) | |
297 | (cons ?p (or load-percentage "N/A")) | |
298 | (cons ?s (or (and seconds (number-to-string seconds)) "N/A")) | |
299 | (cons ?m (or (and minutes (number-to-string minutes)) "N/A")) | |
300 | (cons ?h (or (and hours (number-to-string hours)) "N/A")) | |
301 | (cons ?t (or remaining-time "N/A"))))) | |
6b279740 RS |
302 | |
303 | \f | |
2b3cb60a EZ |
304 | ;;; `/proc/acpi/' interface for Linux. |
305 | ||
306 | (defun battery-linux-proc-acpi () | |
30710442 | 307 | "Get ACPI status information from Linux (the kernel). |
3660b4f5 | 308 | This function works only with the `/proc/acpi/' format introduced |
2b3cb60a EZ |
309 | in Linux version 2.4.20 and 2.6.0. |
310 | ||
311 | The following %-sequences are provided: | |
312 | %c Current capacity (mAh) | |
12d6b124 | 313 | %r Current rate |
2b3cb60a EZ |
314 | %B Battery status (verbose) |
315 | %b Battery status, empty means high, `-' means low, | |
316 | `!' means critical, and `+' means charging | |
317 | %d Temperature (in degrees Celsius) | |
318 | %L AC line status (verbose) | |
12d6b124 | 319 | %p Battery load percentage |
76815b2a RS |
320 | %m Remaining time (to charge or discharge) in minutes |
321 | %h Remaining time (to charge or discharge) in hours | |
322 | %t Remaining time (to charge or discharge) in the form `h:min'" | |
0f4a15f8 | 323 | (let ((design-capacity 0) |
d0600240 RS |
324 | (last-full-capacity 0) |
325 | full-capacity | |
0f4a15f8 SM |
326 | (warn 0) |
327 | (low 0) | |
328 | capacity rate rate-type charging-state minutes hours) | |
329 | ;; ACPI provides information about each battery present in the system in | |
330 | ;; a separate subdirectory. We are going to merge the available | |
d66fe334 EZ |
331 | ;; information together since displaying for a variable amount of |
332 | ;; batteries seems overkill for format-strings. | |
333 | (with-temp-buffer | |
0f4a15f8 SM |
334 | (dolist (dir (ignore-errors (directory-files "/proc/acpi/battery/" |
335 | t "\\`[^.]"))) | |
336 | (erase-buffer) | |
337 | (ignore-errors (insert-file-contents (expand-file-name "state" dir))) | |
338 | (when (re-search-forward "present: +yes$" nil t) | |
339 | (and (re-search-forward "charging state: +\\(.*\\)$" nil t) | |
76815b2a | 340 | (member charging-state '("unknown" "charged" nil)) |
0f4a15f8 SM |
341 | ;; On most multi-battery systems, most of the time only one |
342 | ;; battery is "charging"/"discharging", the others are | |
343 | ;; "unknown". | |
344 | (setq charging-state (match-string 1))) | |
345 | (when (re-search-forward "present rate: +\\([0-9]+\\) \\(m[AW]\\)$" | |
346 | nil t) | |
6a8c9eaf DN |
347 | (setq rate (+ (or rate 0) (string-to-number (match-string 1)))) |
348 | (when (> rate 0) | |
349 | (setq rate-type (or (and rate-type | |
0f4a15f8 SM |
350 | (if (string= rate-type (match-string 2)) |
351 | rate-type | |
352 | (error | |
353 | "Inconsistent rate types (%s vs. %s)" | |
354 | rate-type (match-string 2)))) | |
6a8c9eaf | 355 | (match-string 2))))) |
0f4a15f8 SM |
356 | (when (re-search-forward "remaining capacity: +\\([0-9]+\\) m[AW]h$" |
357 | nil t) | |
358 | (setq capacity | |
359 | (+ (or capacity 0) (string-to-number (match-string 1)))))) | |
360 | (goto-char (point-max)) | |
361 | (ignore-errors (insert-file-contents (expand-file-name "info" dir))) | |
362 | (when (re-search-forward "present: +yes$" nil t) | |
363 | (when (re-search-forward "design capacity: +\\([0-9]+\\) m[AW]h$" | |
364 | nil t) | |
f58e0fd5 | 365 | (cl-incf design-capacity (string-to-number (match-string 1)))) |
d0600240 RS |
366 | (when (re-search-forward "last full capacity: +\\([0-9]+\\) m[AW]h$" |
367 | nil t) | |
f58e0fd5 | 368 | (cl-incf last-full-capacity (string-to-number (match-string 1)))) |
0f4a15f8 SM |
369 | (when (re-search-forward |
370 | "design capacity warning: +\\([0-9]+\\) m[AW]h$" nil t) | |
f58e0fd5 | 371 | (cl-incf warn (string-to-number (match-string 1)))) |
0f4a15f8 SM |
372 | (when (re-search-forward "design capacity low: +\\([0-9]+\\) m[AW]h$" |
373 | nil t) | |
f58e0fd5 | 374 | (cl-incf low (string-to-number (match-string 1))))))) |
d0600240 RS |
375 | (setq full-capacity (if (> last-full-capacity 0) |
376 | last-full-capacity design-capacity)) | |
2b3cb60a | 377 | (and capacity rate |
062db3ec EZ |
378 | (setq minutes (if (zerop rate) 0 |
379 | (floor (* (/ (float (if (string= charging-state | |
380 | "charging") | |
d0600240 RS |
381 | (- full-capacity capacity) |
382 | capacity)) | |
383 | rate) | |
384 | 60))) | |
2b3cb60a EZ |
385 | hours (/ minutes 60))) |
386 | (list (cons ?c (or (and capacity (number-to-string capacity)) "N/A")) | |
785428c7 RF |
387 | (cons ?L (or (battery-search-for-one-match-in-files |
388 | (mapcar (lambda (e) (concat e "/state")) | |
b8e3d88f RS |
389 | (ignore-errors |
390 | (directory-files "/proc/acpi/ac_adapter/" | |
391 | t "\\`[^.]"))) | |
785428c7 RF |
392 | "state: +\\(.*\\)$" 1) |
393 | ||
2b3cb60a | 394 | "N/A")) |
785428c7 RF |
395 | (cons ?d (or (battery-search-for-one-match-in-files |
396 | (mapcar (lambda (e) (concat e "/temperature")) | |
b8e3d88f RS |
397 | (ignore-errors |
398 | (directory-files "/proc/acpi/thermal_zone/" | |
399 | t "\\`[^.]"))) | |
785428c7 RF |
400 | "temperature: +\\([0-9]+\\) C$" 1) |
401 | ||
2b3cb60a | 402 | "N/A")) |
062db3ec EZ |
403 | (cons ?r (or (and rate (concat (number-to-string rate) " " |
404 | rate-type)) "N/A")) | |
2b3cb60a EZ |
405 | (cons ?B (or charging-state "N/A")) |
406 | (cons ?b (or (and (string= charging-state "charging") "+") | |
c93b1b4b JL |
407 | (and capacity (< capacity low) "!") |
408 | (and capacity (< capacity warn) "-") | |
2b3cb60a EZ |
409 | "")) |
410 | (cons ?h (or (and hours (number-to-string hours)) "N/A")) | |
411 | (cons ?m (or (and minutes (number-to-string minutes)) "N/A")) | |
412 | (cons ?t (or (and minutes | |
413 | (format "%d:%02d" hours (- minutes (* 60 hours)))) | |
414 | "N/A")) | |
d0600240 | 415 | (cons ?p (or (and full-capacity capacity |
5c79f850 | 416 | (> full-capacity 0) |
2b3cb60a EZ |
417 | (number-to-string |
418 | (floor (/ capacity | |
d0600240 | 419 | (/ (float full-capacity) 100))))) |
2b3cb60a EZ |
420 | "N/A"))))) |
421 | ||
422 | \f | |
3660b4f5 CY |
423 | ;;; `/sys/class/power_supply/BATN' interface for Linux. |
424 | ||
425 | (defun battery-linux-sysfs () | |
426 | "Get ACPI status information from Linux kernel. | |
427 | This function works only with the new `/sys/class/power_supply/' | |
428 | format introduced in Linux version 2.4.25. | |
429 | ||
430 | The following %-sequences are provided: | |
431 | %c Current capacity (mAh or mWh) | |
728a1f2b | 432 | %r Current rate |
3660b4f5 | 433 | %B Battery status (verbose) |
728a1f2b | 434 | %d Temperature (in degrees Celsius) |
3660b4f5 | 435 | %p Battery load percentage |
728a1f2b JC |
436 | %L AC line status (verbose) |
437 | %m Remaining time (to charge or discharge) in minutes | |
438 | %h Remaining time (to charge or discharge) in hours | |
439 | %t Remaining time (to charge or discharge) in the form `h:min'" | |
440 | (let (charging-state rate temperature hours | |
3660b4f5 CY |
441 | (charge-full 0.0) |
442 | (charge-now 0.0) | |
443 | (energy-full 0.0) | |
444 | (energy-now 0.0)) | |
445 | ;; SysFS provides information about each battery present in the | |
446 | ;; system in a separate subdirectory. We are going to merge the | |
447 | ;; available information together. | |
448 | (with-temp-buffer | |
449 | (dolist (dir (ignore-errors | |
450 | (directory-files | |
6decb6c2 SM |
451 | "/sys/class/power_supply/" t |
452 | battery--linux-sysfs-regexp))) | |
3660b4f5 CY |
453 | (erase-buffer) |
454 | (ignore-errors (insert-file-contents | |
455 | (expand-file-name "uevent" dir))) | |
456 | (when (re-search-forward "POWER_SUPPLY_PRESENT=1$" nil t) | |
457 | (goto-char (point-min)) | |
458 | (and (re-search-forward "POWER_SUPPLY_STATUS=\\(.*\\)$" nil t) | |
459 | (member charging-state '("Unknown" "Full" nil)) | |
460 | (setq charging-state (match-string 1))) | |
9e37f3b9 | 461 | (goto-char (point-min)) |
728a1f2b JC |
462 | (when (re-search-forward |
463 | "POWER_SUPPLY_\\(CURRENT\\|POWER\\)_NOW=\\([0-9]*\\)$" | |
464 | nil t) | |
465 | (setq rate (float (string-to-number (match-string 2))))) | |
9e37f3b9 | 466 | (goto-char (point-min)) |
728a1f2b JC |
467 | (when (re-search-forward "POWER_SUPPLY_TEMP=\\([0-9]*\\)$" nil t) |
468 | (setq temperature (match-string 1))) | |
9e37f3b9 | 469 | (goto-char (point-min)) |
3660b4f5 CY |
470 | (let (full-string now-string) |
471 | ;; Sysfs may list either charge (mAh) or energy (mWh). | |
472 | ;; Keep track of both, and choose which to report later. | |
473 | (cond ((and (re-search-forward | |
474 | "POWER_SUPPLY_CHARGE_FULL=\\([0-9]*\\)$" nil t) | |
475 | (setq full-string (match-string 1)) | |
476 | (re-search-forward | |
477 | "POWER_SUPPLY_CHARGE_NOW=\\([0-9]*\\)$" nil t) | |
478 | (setq now-string (match-string 1))) | |
479 | (setq charge-full (+ charge-full | |
480 | (string-to-number full-string)) | |
481 | charge-now (+ charge-now | |
482 | (string-to-number now-string)))) | |
9e37f3b9 RS |
483 | ((and (progn (goto-char (point-min)) t) |
484 | (re-search-forward | |
3660b4f5 CY |
485 | "POWER_SUPPLY_ENERGY_FULL=\\([0-9]*\\)$" nil t) |
486 | (setq full-string (match-string 1)) | |
487 | (re-search-forward | |
488 | "POWER_SUPPLY_ENERGY_NOW=\\([0-9]*\\)$" nil t) | |
489 | (setq now-string (match-string 1))) | |
490 | (setq energy-full (+ energy-full | |
491 | (string-to-number full-string)) | |
492 | energy-now (+ energy-now | |
728a1f2b JC |
493 | (string-to-number now-string)))))) |
494 | (goto-char (point-min)) | |
495 | (when (and energy-now rate (not (zerop rate)) | |
496 | (re-search-forward | |
497 | "POWER_SUPPLY_VOLTAGE_NOW=\\([0-9]*\\)$" nil t)) | |
498 | (let ((remaining (if (string= charging-state "Discharging") | |
499 | energy-now | |
500 | (- energy-full energy-now)))) | |
501 | (setq hours (/ (/ (* remaining (string-to-number | |
502 | (match-string 1))) | |
503 | rate) | |
504 | 10000000.0))))))) | |
3660b4f5 CY |
505 | (list (cons ?c (cond ((or (> charge-full 0) (> charge-now 0)) |
506 | (number-to-string charge-now)) | |
507 | ((or (> energy-full 0) (> energy-now 0)) | |
508 | (number-to-string energy-now)) | |
509 | (t "N/A"))) | |
728a1f2b JC |
510 | (cons ?r (if rate (format "%.1f" (/ rate 1000000.0)) "N/A")) |
511 | (cons ?m (if hours (format "%d" (* hours 60)) "N/A")) | |
512 | (cons ?h (if hours (format "%d" hours) "N/A")) | |
513 | (cons ?t (if hours | |
514 | (format "%d:%02d" hours (* (- hours (floor hours)) 60)) | |
515 | "N/A")) | |
516 | (cons ?d (or temperature "N/A")) | |
3660b4f5 | 517 | (cons ?B (or charging-state "N/A")) |
54071013 | 518 | (cons ?p (cond ((and (> charge-full 0) (> charge-now 0)) |
3660b4f5 CY |
519 | (format "%.1f" |
520 | (/ (* 100 charge-now) charge-full))) | |
521 | ((> energy-full 0) | |
522 | (format "%.1f" | |
523 | (/ (* 100 energy-now) energy-full))) | |
524 | (t "N/A"))) | |
525 | (cons ?L (if (file-readable-p "/sys/class/power_supply/AC/online") | |
526 | (if (battery-search-for-one-match-in-files | |
527 | (list "/sys/class/power_supply/AC/online" | |
528 | "/sys/class/power_supply/ACAD/online") | |
529 | "1" 0) | |
530 | "AC" | |
531 | "BAT") | |
532 | "N/A"))))) | |
19b748ad TM |
533 | |
534 | \f | |
535 | ;;; `apm' interface for BSD. | |
536 | (defun battery-bsd-apm () | |
537 | "Get APM status information from BSD apm binary. | |
538 | The following %-sequences are provided: | |
539 | %L AC line status (verbose) | |
540 | %B Battery status (verbose) | |
541 | %b Battery status, empty means high, `-' means low, | |
542 | `!' means critical, and `+' means charging | |
543 | %P Advanced power saving mode state (verbose) | |
544 | %p Battery charge percentage | |
545 | %s Remaining battery charge time in seconds | |
546 | %m Remaining battery charge time in minutes | |
547 | %h Remaining battery charge time in hours | |
548 | %t Remaining battery charge time in the form `h:min'" | |
549 | (let* ((os-name (car (split-string | |
550 | (shell-command-to-string "/usr/bin/uname")))) | |
551 | (apm-flag (if (equal os-name "OpenBSD") "P" "s")) | |
552 | (apm-cmd (concat "/usr/sbin/apm -ablm" apm-flag)) | |
553 | (apm-output (split-string (shell-command-to-string apm-cmd))) | |
554 | ;; Battery status | |
555 | (battery-status | |
556 | (let ((stat (string-to-number (nth 0 apm-output)))) | |
557 | (cond ((eq stat 0) '("high" . "")) | |
558 | ((eq stat 1) '("low" . "-")) | |
559 | ((eq stat 2) '("critical" . "!")) | |
560 | ((eq stat 3) '("charging" . "+")) | |
561 | ((eq stat 4) '("absent" . nil))))) | |
562 | ;; Battery percentage | |
563 | (battery-percentage (nth 1 apm-output)) | |
564 | ;; Battery life | |
565 | (battery-life (nth 2 apm-output)) | |
566 | ;; AC status | |
567 | (line-status | |
568 | (let ((ac (string-to-number (nth 3 apm-output)))) | |
569 | (cond ((eq ac 0) "disconnected") | |
570 | ((eq ac 1) "connected") | |
571 | ((eq ac 2) "backup power")))) | |
572 | ;; Advanced power savings mode | |
573 | (apm-mode | |
574 | (let ((apm (string-to-number (nth 4 apm-output)))) | |
575 | (if (string= os-name "OpenBSD") | |
576 | (cond ((eq apm 0) "manual") | |
577 | ((eq apm 1) "automatic") | |
578 | ((eq apm 2) "cool running")) | |
579 | (if (eq apm 1) "on" "off")))) | |
580 | seconds minutes hours remaining-time) | |
581 | (unless (member battery-life '("unknown" "-1")) | |
582 | (if (member os-name '("OpenBSD" "NetBSD")) | |
583 | (setq minutes (string-to-number battery-life) | |
584 | seconds (* 60 minutes)) | |
585 | (setq seconds (string-to-number battery-life) | |
586 | minutes (truncate (/ seconds 60)))) | |
587 | (setq hours (truncate (/ minutes 60)) | |
588 | remaining-time (format "%d:%02d" hours | |
589 | (- minutes (* 60 hours))))) | |
590 | (list (cons ?L (or line-status "N/A")) | |
591 | (cons ?B (or (car battery-status) "N/A")) | |
592 | (cons ?b (or (cdr battery-status) "N/A")) | |
593 | (cons ?p (if (string= battery-percentage "255") | |
594 | "N/A" | |
595 | battery-percentage)) | |
596 | (cons ?P (or apm-mode "N/A")) | |
597 | (cons ?s (or (and seconds (number-to-string seconds)) "N/A")) | |
598 | (cons ?m (or (and minutes (number-to-string minutes)) "N/A")) | |
599 | (cons ?h (or (and hours (number-to-string hours)) "N/A")) | |
600 | (cons ?t (or remaining-time "N/A"))))) | |
601 | ||
3660b4f5 | 602 | \f |
71d21198 LK |
603 | ;;; `pmset' interface for Darwin (OS X). |
604 | ||
605 | (defun battery-pmset () | |
606 | "Get battery status information using `pmset'. | |
607 | ||
608 | The following %-sequences are provided: | |
609 | %L Power source (verbose) | |
610 | %B Battery status (verbose) | |
611 | %b Battery status, empty means high, `-' means low, | |
612 | `!' means critical, and `+' means charging | |
613 | %p Battery load percentage | |
614 | %h Remaining time in hours | |
615 | %m Remaining time in minutes | |
616 | %t Remaining time in the form `h:min'" | |
617 | (let (power-source load-percentage battery-status battery-status-symbol | |
618 | remaining-time hours minutes) | |
619 | (with-temp-buffer | |
620 | (ignore-errors (call-process "pmset" nil t nil "-g" "ps")) | |
621 | (goto-char (point-min)) | |
d5f1282f | 622 | (when (re-search-forward "\\(?:Currentl?y\\|Now\\) drawing from '\\(AC\\|Battery\\) Power'" nil t) |
71d21198 LK |
623 | (setq power-source (match-string 1)) |
624 | (when (re-search-forward "^ -InternalBattery-0[ \t]+" nil t) | |
625 | (when (looking-at "\\([0-9]\\{1,3\\}\\)%") | |
626 | (setq load-percentage (match-string 1)) | |
627 | (goto-char (match-end 0)) | |
628 | (cond ((looking-at "; charging") | |
629 | (setq battery-status "charging" | |
630 | battery-status-symbol "+")) | |
631 | ((< (string-to-number load-percentage) battery-load-low) | |
632 | (setq battery-status "low" | |
633 | battery-status-symbol "-")) | |
634 | ((< (string-to-number load-percentage) battery-load-critical) | |
635 | (setq battery-status "critical" | |
636 | battery-status-symbol "!")) | |
637 | (t | |
638 | (setq battery-status "high" | |
639 | battery-status-symbol ""))) | |
640 | (when (re-search-forward "\\(\\([0-9]+\\):\\([0-9]+\\)\\) remaining" nil t) | |
641 | (setq remaining-time (match-string 1)) | |
642 | (let ((h (string-to-number (match-string 2))) | |
643 | (m (string-to-number (match-string 3)))) | |
644 | (setq hours (number-to-string (+ h (if (< m 30) 0 1))) | |
645 | minutes (number-to-string (+ (* h 60) m))))))))) | |
646 | (list (cons ?L (or power-source "N/A")) | |
647 | (cons ?p (or load-percentage "N/A")) | |
648 | (cons ?B (or battery-status "N/A")) | |
649 | (cons ?b (or battery-status-symbol "")) | |
650 | (cons ?h (or hours "N/A")) | |
651 | (cons ?m (or minutes "N/A")) | |
652 | (cons ?t (or remaining-time "N/A"))))) | |
653 | ||
654 | \f | |
6b279740 RS |
655 | ;;; Private functions. |
656 | ||
657 | (defun battery-format (format alist) | |
658 | "Substitute %-sequences in FORMAT." | |
0f4a15f8 SM |
659 | (replace-regexp-in-string |
660 | "%." | |
661 | (lambda (str) | |
662 | (let ((char (aref str 1))) | |
663 | (if (eq char ?%) "%" | |
664 | (or (cdr (assoc char alist)) "")))) | |
665 | format t t)) | |
6b279740 | 666 | |
785428c7 RF |
667 | (defun battery-search-for-one-match-in-files (files regexp match-num) |
668 | "Search REGEXP in the content of the files listed in FILES. | |
f14bbeeb | 669 | If a match occurred, return the parenthesized expression numbered by |
785428c7 RF |
670 | MATCH-NUM in the match. Otherwise, return nil." |
671 | (with-temp-buffer | |
672 | (catch 'found | |
673 | (dolist (file files) | |
674 | (and (ignore-errors (insert-file-contents file nil nil nil 'replace)) | |
675 | (re-search-forward regexp nil t) | |
676 | (throw 'found (match-string match-num))))))) | |
677 | ||
6b279740 RS |
678 | \f |
679 | (provide 'battery) | |
680 | ||
681 | ;;; battery.el ends here |