ACPI: thinkpad-acpi: mark acpi helper functions __must_check
[linux-2.6/linux-acpi-2.6/ibm-acpi-2.6.git] / drivers / misc / thinkpad_acpi.h
blob1b4cd167ebd273cc9610297b0ca845b40cae16a7
1 /*
2 * thinkpad_acpi.h - ThinkPad ACPI Extras
5 * Copyright (C) 2004-2005 Borislav Deianov <borislav@users.sf.net>
6 * Copyright (C) 2006-2007 Henrique de Moraes Holschuh <hmh@hmh.eng.br>
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License as published by
10 * the Free Software Foundation; either version 2 of the License, or
11 * (at your option) any later version.
13 * This program is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 * GNU General Public License for more details.
18 * You should have received a copy of the GNU General Public License
19 * along with this program; if not, write to the Free Software
20 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
21 * 02110-1301, USA.
24 #ifndef __THINKPAD_ACPI_H__
25 #define __THINKPAD_ACPI_H__
27 #include <linux/kernel.h>
28 #include <linux/module.h>
29 #include <linux/init.h>
30 #include <linux/types.h>
31 #include <linux/string.h>
32 #include <linux/list.h>
34 #include <linux/proc_fs.h>
35 #include <linux/backlight.h>
36 #include <linux/fb.h>
37 #include <asm/uaccess.h>
39 #include <linux/dmi.h>
40 #include <linux/jiffies.h>
41 #include <linux/workqueue.h>
43 #include <acpi/acpi_drivers.h>
44 #include <acpi/acnamesp.h>
47 /****************************************************************************
48 * Main driver
51 #define IBM_NAME "thinkpad"
52 #define IBM_DESC "ThinkPad ACPI Extras"
53 #define IBM_FILE "thinkpad_acpi"
54 #define IBM_URL "http://ibm-acpi.sf.net/"
55 #define IBM_MAIL "ibm-acpi-devel@lists.sourceforge.net"
57 #define IBM_PROC_DIR "ibm"
58 #define IBM_ACPI_EVENT_PREFIX "ibm"
60 #define IBM_LOG IBM_FILE ": "
61 #define IBM_ERR KERN_ERR IBM_LOG
62 #define IBM_NOTICE KERN_NOTICE IBM_LOG
63 #define IBM_INFO KERN_INFO IBM_LOG
64 #define IBM_DEBUG KERN_DEBUG IBM_LOG
66 #define IBM_MAX_ACPI_ARGS 3
68 /* ThinkPad CMOS commands */
69 #define TP_CMOS_VOLUME_DOWN 0
70 #define TP_CMOS_VOLUME_UP 1
71 #define TP_CMOS_VOLUME_MUTE 2
72 #define TP_CMOS_BRIGHTNESS_UP 4
73 #define TP_CMOS_BRIGHTNESS_DOWN 5
75 #define onoff(status,bit) ((status) & (1 << (bit)) ? "on" : "off")
76 #define enabled(status,bit) ((status) & (1 << (bit)) ? "enabled" : "disabled")
77 #define strlencmp(a,b) (strncmp((a), (b), strlen(b)))
79 /* Debugging */
80 #define TPACPI_DBG_ALL 0xffff
81 #define TPACPI_DBG_ALL 0xffff
82 #define TPACPI_DBG_INIT 0x0001
83 #define TPACPI_DBG_EXIT 0x0002
84 #define dbg_printk(a_dbg_level, format, arg...) \
85 do { if (dbg_level & a_dbg_level) \
86 printk(IBM_DEBUG "%s: " format, __func__ , ## arg); } while (0)
87 #ifdef CONFIG_THINKPAD_ACPI_DEBUG
88 #define vdbg_printk(a_dbg_level, format, arg...) \
89 dbg_printk(a_dbg_level, format, ## arg)
90 static const char *str_supported(int is_supported);
91 #else
92 #define vdbg_printk(a_dbg_level, format, arg...)
93 #endif
95 /* ACPI HIDs */
96 #define IBM_HKEY_HID "IBM0068"
97 #define IBM_PCI_HID "PNP0A03"
99 /* ACPI helpers */
100 static int __must_check acpi_evalf(acpi_handle handle,
101 void *res, char *method, char *fmt, ...);
102 static int __must_check acpi_ec_read(int i, u8 * p);
103 static int __must_check acpi_ec_write(int i, u8 v);
104 static int __must_check _sta(acpi_handle handle);
106 /* ACPI handles */
107 static acpi_handle root_handle; /* root namespace */
108 static acpi_handle ec_handle; /* EC */
109 static acpi_handle ecrd_handle, ecwr_handle; /* 570 EC access */
110 static acpi_handle cmos_handle, hkey_handle; /* basic thinkpad handles */
112 static void drv_acpi_handle_init(char *name,
113 acpi_handle *handle, acpi_handle parent,
114 char **paths, int num_paths, char **path);
115 #define IBM_ACPIHANDLE_INIT(object) \
116 drv_acpi_handle_init(#object, &object##_handle, *object##_parent, \
117 object##_paths, ARRAY_SIZE(object##_paths), &object##_path)
119 /* procfs support */
120 static struct proc_dir_entry *proc_dir;
122 /* procfs helpers */
123 static int dispatch_procfs_read(char *page, char **start, off_t off,
124 int count, int *eof, void *data);
125 static int dispatch_procfs_write(struct file *file,
126 const char __user * userbuf,
127 unsigned long count, void *data);
128 static char *next_cmd(char **cmds);
130 /* Module */
131 static int experimental;
132 static u32 dbg_level;
133 static int force_load;
134 static char *ibm_thinkpad_ec_found;
136 static char* check_dmi_for_ec(void);
137 static int thinkpad_acpi_module_init(void);
138 static void thinkpad_acpi_module_exit(void);
141 /****************************************************************************
142 * Subdrivers
145 struct ibm_struct;
147 struct tp_acpi_drv_struct {
148 char *hid;
149 struct acpi_driver *driver;
151 void (*notify) (struct ibm_struct *, u32);
152 acpi_handle *handle;
153 u32 type;
154 struct acpi_device *device;
157 struct ibm_struct {
158 char *name;
160 int (*read) (char *);
161 int (*write) (char *);
162 void (*exit) (void);
164 struct list_head all_drivers;
166 struct tp_acpi_drv_struct *acpi;
168 struct {
169 u8 acpi_driver_registered:1;
170 u8 acpi_notify_installed:1;
171 u8 proc_created:1;
172 u8 init_called:1;
173 u8 experimental:1;
174 } flags;
177 struct ibm_init_struct {
178 char param[32];
180 int (*init) (struct ibm_init_struct *);
181 struct ibm_struct *data;
184 static struct {
185 #ifdef CONFIG_THINKPAD_ACPI_BAY
186 u16 bay_status:1;
187 u16 bay_eject:1;
188 u16 bay_status2:1;
189 u16 bay_eject2:1;
190 #endif
191 u16 bluetooth:1;
192 u16 hotkey:1;
193 u16 hotkey_mask:1;
194 u16 light:1;
195 u16 light_status:1;
196 u16 wan:1;
197 u16 fan_ctrl_status_undef:1;
198 } tp_features;
200 static struct list_head tpacpi_all_drivers;
202 static struct ibm_init_struct ibms_init[];
203 static int set_ibm_param(const char *val, struct kernel_param *kp);
204 static int ibm_init(struct ibm_init_struct *iibm);
205 static void ibm_exit(struct ibm_struct *ibm);
209 * procfs master subdriver
211 static int thinkpad_acpi_driver_init(struct ibm_init_struct *iibm);
212 static int thinkpad_acpi_driver_read(char *p);
216 * Bay subdriver
219 #ifdef CONFIG_THINKPAD_ACPI_BAY
220 static acpi_handle bay_handle, bay_ej_handle;
221 static acpi_handle bay2_handle, bay2_ej_handle;
223 static int bay_init(struct ibm_init_struct *iibm);
224 static void bay_notify(struct ibm_struct *ibm, u32 event);
225 static int bay_read(char *p);
226 static int bay_write(char *buf);
227 #endif /* CONFIG_THINKPAD_ACPI_BAY */
231 * Beep subdriver
234 static acpi_handle beep_handle;
236 static int beep_read(char *p);
237 static int beep_write(char *buf);
241 * Bluetooth subdriver
244 static int bluetooth_init(struct ibm_init_struct *iibm);
245 static int bluetooth_status(void);
246 static int bluetooth_read(char *p);
247 static int bluetooth_write(char *buf);
251 * Brightness (backlight) subdriver
254 static struct backlight_device *ibm_backlight_device;
255 static int brightness_offset = 0x31;
257 static int brightness_init(struct ibm_init_struct *iibm);
258 static void brightness_exit(void);
259 static int brightness_get(struct backlight_device *bd);
260 static int brightness_set(int value);
261 static int brightness_update_status(struct backlight_device *bd);
262 static int brightness_read(char *p);
263 static int brightness_write(char *buf);
267 * CMOS subdriver
270 static int cmos_eval(int cmos_cmd);
271 static int cmos_read(char *p);
272 static int cmos_write(char *buf);
276 * Dock subdriver
279 #ifdef CONFIG_THINKPAD_ACPI_DOCK
280 static acpi_handle pci_handle;
281 static acpi_handle dock_handle;
283 static void dock_notify(struct ibm_struct *ibm, u32 event);
284 static int dock_read(char *p);
285 static int dock_write(char *buf);
286 #endif /* CONFIG_THINKPAD_ACPI_DOCK */
290 * EC dump subdriver
293 static int ecdump_read(char *p) ;
294 static int ecdump_write(char *buf);
298 * Fan subdriver
301 enum { /* Fan control constants */
302 fan_status_offset = 0x2f, /* EC register 0x2f */
303 fan_rpm_offset = 0x84, /* EC register 0x84: LSB, 0x85 MSB (RPM)
304 * 0x84 must be read before 0x85 */
306 TP_EC_FAN_FULLSPEED = 0x40, /* EC fan mode: full speed */
307 TP_EC_FAN_AUTO = 0x80, /* EC fan mode: auto fan control */
310 enum fan_status_access_mode {
311 TPACPI_FAN_NONE = 0, /* No fan status or control */
312 TPACPI_FAN_RD_ACPI_GFAN, /* Use ACPI GFAN */
313 TPACPI_FAN_RD_TPEC, /* Use ACPI EC regs 0x2f, 0x84-0x85 */
316 enum fan_control_access_mode {
317 TPACPI_FAN_WR_NONE = 0, /* No fan control */
318 TPACPI_FAN_WR_ACPI_SFAN, /* Use ACPI SFAN */
319 TPACPI_FAN_WR_TPEC, /* Use ACPI EC reg 0x2f */
320 TPACPI_FAN_WR_ACPI_FANS, /* Use ACPI FANS and EC reg 0x2f */
323 enum fan_control_commands {
324 TPACPI_FAN_CMD_SPEED = 0x0001, /* speed command */
325 TPACPI_FAN_CMD_LEVEL = 0x0002, /* level command */
326 TPACPI_FAN_CMD_ENABLE = 0x0004, /* enable/disable cmd,
327 * and also watchdog cmd */
330 static enum fan_status_access_mode fan_status_access_mode;
331 static enum fan_control_access_mode fan_control_access_mode;
332 static enum fan_control_commands fan_control_commands;
333 static u8 fan_control_initial_status;
334 static int fan_watchdog_maxinterval;
336 static acpi_handle fans_handle, gfan_handle, sfan_handle;
338 static int fan_init(struct ibm_init_struct *iibm);
339 static void fan_exit(void);
340 static int fan_get_status(u8 *status);
341 static int fan_get_speed(unsigned int *speed);
342 static void fan_watchdog_fire(struct work_struct *ignored);
343 static void fan_watchdog_reset(void);
344 static int fan_set_level(int level);
345 static int fan_set_enable(void);
346 static int fan_set_disable(void);
347 static int fan_set_speed(int speed);
348 static int fan_read(char *p);
349 static int fan_write(char *buf);
350 static int fan_write_cmd_level(const char *cmd, int *rc);
351 static int fan_write_cmd_enable(const char *cmd, int *rc);
352 static int fan_write_cmd_disable(const char *cmd, int *rc);
353 static int fan_write_cmd_speed(const char *cmd, int *rc);
354 static int fan_write_cmd_watchdog(const char *cmd, int *rc);
358 * Hotkey subdriver
361 static int hotkey_orig_status;
362 static int hotkey_orig_mask;
364 static int hotkey_init(struct ibm_init_struct *iibm);
365 static void hotkey_exit(void);
366 static int hotkey_get(int *status, int *mask);
367 static int hotkey_set(int status, int mask);
368 static void hotkey_notify(struct ibm_struct *ibm, u32 event);
369 static int hotkey_read(char *p);
370 static int hotkey_write(char *buf);
374 * LED subdriver
377 enum led_access_mode {
378 TPACPI_LED_NONE = 0,
379 TPACPI_LED_570, /* 570 */
380 TPACPI_LED_OLD, /* 600e/x, 770e, 770x, A21e, A2xm/p, T20-22, X20-21 */
381 TPACPI_LED_NEW, /* all others */
384 enum { /* For TPACPI_LED_OLD */
385 TPACPI_LED_EC_HLCL = 0x0c, /* EC reg to get led to power on */
386 TPACPI_LED_EC_HLBL = 0x0d, /* EC reg to blink a lit led */
387 TPACPI_LED_EC_HLMS = 0x0e, /* EC reg to select led to command */
390 static enum led_access_mode led_supported;
391 static acpi_handle led_handle;
393 static int led_init(struct ibm_init_struct *iibm);
394 static int led_read(char *p);
395 static int led_write(char *buf);
398 * Light (thinklight) subdriver
401 static acpi_handle lght_handle, ledb_handle;
403 static int light_init(struct ibm_init_struct *iibm);
404 static int light_read(char *p);
405 static int light_write(char *buf);
409 * Thermal subdriver
412 enum thermal_access_mode {
413 TPACPI_THERMAL_NONE = 0, /* No thermal support */
414 TPACPI_THERMAL_ACPI_TMP07, /* Use ACPI TMP0-7 */
415 TPACPI_THERMAL_ACPI_UPDT, /* Use ACPI TMP0-7 with UPDT */
416 TPACPI_THERMAL_TPEC_8, /* Use ACPI EC regs, 8 sensors */
417 TPACPI_THERMAL_TPEC_16, /* Use ACPI EC regs, 16 sensors */
420 #define TPACPI_MAX_THERMAL_SENSORS 16 /* Max thermal sensors supported */
421 struct ibm_thermal_sensors_struct {
422 s32 temp[TPACPI_MAX_THERMAL_SENSORS];
425 static int thermal_init(struct ibm_init_struct *iibm);
426 static int thermal_get_sensors(struct ibm_thermal_sensors_struct *s);
427 static int thermal_read(char *p);
431 * Video subdriver
434 enum video_access_mode {
435 TPACPI_VIDEO_NONE = 0,
436 TPACPI_VIDEO_570, /* 570 */
437 TPACPI_VIDEO_770, /* 600e/x, 770e, 770x */
438 TPACPI_VIDEO_NEW, /* all others */
441 static enum video_access_mode video_supported;
442 static int video_orig_autosw;
443 static acpi_handle vid_handle, vid2_handle;
445 static int video_init(struct ibm_init_struct *iibm);
446 static void video_exit(void);
447 static int video_status(void);
448 static int video_autosw(void);
449 static int video_switch(void);
450 static int video_switch2(int status);
451 static int video_expand(void);
452 static int video_read(char *p);
453 static int video_write(char *buf);
457 * Volume subdriver
460 static int volume_offset = 0x30;
462 static int volume_read(char *p);
463 static int volume_write(char *buf);
467 * Wan subdriver
470 static int wan_init(struct ibm_init_struct *iibm);
471 static int wan_status(void);
472 static int wan_read(char *p);
473 static int wan_write(char *buf);
476 #endif /* __THINKPAD_ACPI_H */