gpiolib: annotate gpio-intialization with __must_check
[linux-2.6/linux-acpi-2.6/ibm-acpi-2.6.git] / drivers / char / toshiba.c
blob014c9d90d297ba57f1f83c7abbe1768042971b6b
1 /* toshiba.c -- Linux driver for accessing the SMM on Toshiba laptops
3 * Copyright (c) 1996-2001 Jonathan A. Buzzard (jonathan@buzzard.org.uk)
5 * Valuable assistance and patches from:
6 * Tom May <tom@you-bastards.com>
7 * Rob Napier <rnapier@employees.org>
9 * Fn status port numbers for machine ID's courtesy of
10 * 0xfc02: Scott Eisert <scott.e@sky-eye.com>
11 * 0xfc04: Steve VanDevender <stevev@efn.org>
12 * 0xfc08: Garth Berry <garth@itsbruce.net>
13 * 0xfc0a: Egbert Eich <eich@xfree86.org>
14 * 0xfc10: Andrew Lofthouse <Andrew.Lofthouse@robins.af.mil>
15 * 0xfc11: Spencer Olson <solson@novell.com>
16 * 0xfc13: Claudius Frankewitz <kryp@gmx.de>
17 * 0xfc15: Tom May <tom@you-bastards.com>
18 * 0xfc17: Dave Konrad <konrad@xenia.it>
19 * 0xfc1a: George Betzos <betzos@engr.colostate.edu>
20 * 0xfc1b: Munemasa Wada <munemasa@jnovel.co.jp>
21 * 0xfc1d: Arthur Liu <armie@slap.mine.nu>
22 * 0xfc5a: Jacques L'helgoualc'h <lhh@free.fr>
23 * 0xfcd1: Mr. Dave Konrad <konrad@xenia.it>
25 * WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING
27 * This code is covered by the GNU GPL and you are free to make any
28 * changes you wish to it under the terms of the license. However the
29 * code has the potential to render your computer and/or someone else's
30 * unusable. Please proceed with care when modifying the code.
32 * Note: Unfortunately the laptop hardware can close the System Configuration
33 * Interface on it's own accord. It is therefore necessary for *all*
34 * programs using this driver to be aware that *any* SCI call can fail at
35 * *any* time. It is up to any program to be aware of this eventuality
36 * and take appropriate steps.
38 * This program is free software; you can redistribute it and/or modify it
39 * under the terms of the GNU General Public License as published by the
40 * Free Software Foundation; either version 2, or (at your option) any
41 * later version.
43 * This program is distributed in the hope that it will be useful, but
44 * WITHOUT ANY WARRANTY; without even the implied warranty of
45 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
46 * General Public License for more details.
48 * The information used to write this driver has been obtained by reverse
49 * engineering the software supplied by Toshiba for their portable computers in
50 * strict accordance with the European Council Directive 92/250/EEC on the legal
51 * protection of computer programs, and it's implementation into English Law by
52 * the Copyright (Computer Programs) Regulations 1992 (S.I. 1992 No.3233).
56 #define TOSH_VERSION "1.11 26/9/2001"
57 #define TOSH_DEBUG 0
59 #include <linux/module.h>
60 #include <linux/kernel.h>
61 #include <linux/types.h>
62 #include <linux/fcntl.h>
63 #include <linux/miscdevice.h>
64 #include <linux/ioport.h>
65 #include <asm/io.h>
66 #include <asm/uaccess.h>
67 #include <linux/init.h>
68 #include <linux/stat.h>
69 #include <linux/proc_fs.h>
70 #include <linux/seq_file.h>
71 #include <linux/mutex.h>
72 #include <linux/toshiba.h>
74 #define TOSH_MINOR_DEV 181
76 MODULE_LICENSE("GPL");
77 MODULE_AUTHOR("Jonathan Buzzard <jonathan@buzzard.org.uk>");
78 MODULE_DESCRIPTION("Toshiba laptop SMM driver");
79 MODULE_SUPPORTED_DEVICE("toshiba");
81 static DEFINE_MUTEX(tosh_mutex);
82 static int tosh_fn;
83 module_param_named(fn, tosh_fn, int, 0);
84 MODULE_PARM_DESC(fn, "User specified Fn key detection port");
86 static int tosh_id;
87 static int tosh_bios;
88 static int tosh_date;
89 static int tosh_sci;
90 static int tosh_fan;
92 static long tosh_ioctl(struct file *, unsigned int,
93 unsigned long);
96 static const struct file_operations tosh_fops = {
97 .owner = THIS_MODULE,
98 .unlocked_ioctl = tosh_ioctl,
99 .llseek = noop_llseek,
102 static struct miscdevice tosh_device = {
103 TOSH_MINOR_DEV,
104 "toshiba",
105 &tosh_fops
109 * Read the Fn key status
111 #ifdef CONFIG_PROC_FS
112 static int tosh_fn_status(void)
114 unsigned char scan;
115 unsigned long flags;
117 if (tosh_fn!=0) {
118 scan = inb(tosh_fn);
119 } else {
120 local_irq_save(flags);
121 outb(0x8e, 0xe4);
122 scan = inb(0xe5);
123 local_irq_restore(flags);
126 return (int) scan;
128 #endif
132 * For the Portage 610CT and the Tecra 700CS/700CDT emulate the HCI fan function
134 static int tosh_emulate_fan(SMMRegisters *regs)
136 unsigned long eax,ecx,flags;
137 unsigned char al;
139 eax = regs->eax & 0xff00;
140 ecx = regs->ecx & 0xffff;
142 /* Portage 610CT */
144 if (tosh_id==0xfccb) {
145 if (eax==0xfe00) {
146 /* fan status */
147 local_irq_save(flags);
148 outb(0xbe, 0xe4);
149 al = inb(0xe5);
150 local_irq_restore(flags);
151 regs->eax = 0x00;
152 regs->ecx = (unsigned int) (al & 0x01);
154 if ((eax==0xff00) && (ecx==0x0000)) {
155 /* fan off */
156 local_irq_save(flags);
157 outb(0xbe, 0xe4);
158 al = inb(0xe5);
159 outb(0xbe, 0xe4);
160 outb (al | 0x01, 0xe5);
161 local_irq_restore(flags);
162 regs->eax = 0x00;
163 regs->ecx = 0x00;
165 if ((eax==0xff00) && (ecx==0x0001)) {
166 /* fan on */
167 local_irq_save(flags);
168 outb(0xbe, 0xe4);
169 al = inb(0xe5);
170 outb(0xbe, 0xe4);
171 outb(al & 0xfe, 0xe5);
172 local_irq_restore(flags);
173 regs->eax = 0x00;
174 regs->ecx = 0x01;
178 /* Tecra 700CS/CDT */
180 if (tosh_id==0xfccc) {
181 if (eax==0xfe00) {
182 /* fan status */
183 local_irq_save(flags);
184 outb(0xe0, 0xe4);
185 al = inb(0xe5);
186 local_irq_restore(flags);
187 regs->eax = 0x00;
188 regs->ecx = al & 0x01;
190 if ((eax==0xff00) && (ecx==0x0000)) {
191 /* fan off */
192 local_irq_save(flags);
193 outb(0xe0, 0xe4);
194 al = inb(0xe5);
195 outw(0xe0 | ((al & 0xfe) << 8), 0xe4);
196 local_irq_restore(flags);
197 regs->eax = 0x00;
198 regs->ecx = 0x00;
200 if ((eax==0xff00) && (ecx==0x0001)) {
201 /* fan on */
202 local_irq_save(flags);
203 outb(0xe0, 0xe4);
204 al = inb(0xe5);
205 outw(0xe0 | ((al | 0x01) << 8), 0xe4);
206 local_irq_restore(flags);
207 regs->eax = 0x00;
208 regs->ecx = 0x01;
212 return 0;
217 * Put the laptop into System Management Mode
219 int tosh_smm(SMMRegisters *regs)
221 int eax;
223 asm ("# load the values into the registers\n\t" \
224 "pushl %%eax\n\t" \
225 "movl 0(%%eax),%%edx\n\t" \
226 "push %%edx\n\t" \
227 "movl 4(%%eax),%%ebx\n\t" \
228 "movl 8(%%eax),%%ecx\n\t" \
229 "movl 12(%%eax),%%edx\n\t" \
230 "movl 16(%%eax),%%esi\n\t" \
231 "movl 20(%%eax),%%edi\n\t" \
232 "popl %%eax\n\t" \
233 "# call the System Management mode\n\t" \
234 "inb $0xb2,%%al\n\t"
235 "# fill out the memory with the values in the registers\n\t" \
236 "xchgl %%eax,(%%esp)\n\t"
237 "movl %%ebx,4(%%eax)\n\t" \
238 "movl %%ecx,8(%%eax)\n\t" \
239 "movl %%edx,12(%%eax)\n\t" \
240 "movl %%esi,16(%%eax)\n\t" \
241 "movl %%edi,20(%%eax)\n\t" \
242 "popl %%edx\n\t" \
243 "movl %%edx,0(%%eax)\n\t" \
244 "# setup the return value to the carry flag\n\t" \
245 "lahf\n\t" \
246 "shrl $8,%%eax\n\t" \
247 "andl $1,%%eax\n" \
248 : "=a" (eax)
249 : "a" (regs)
250 : "%ebx", "%ecx", "%edx", "%esi", "%edi", "memory");
252 return eax;
254 EXPORT_SYMBOL(tosh_smm);
257 static long tosh_ioctl(struct file *fp, unsigned int cmd, unsigned long arg)
259 SMMRegisters regs;
260 SMMRegisters __user *argp = (SMMRegisters __user *)arg;
261 unsigned short ax,bx;
262 int err;
264 if (!argp)
265 return -EINVAL;
267 if (copy_from_user(&regs, argp, sizeof(SMMRegisters)))
268 return -EFAULT;
270 switch (cmd) {
271 case TOSH_SMM:
272 ax = regs.eax & 0xff00;
273 bx = regs.ebx & 0xffff;
274 /* block HCI calls to read/write memory & PCI devices */
275 if (((ax==0xff00) || (ax==0xfe00)) && (bx>0x0069))
276 return -EINVAL;
278 /* do we need to emulate the fan ? */
279 mutex_lock(&tosh_mutex);
280 if (tosh_fan==1) {
281 if (((ax==0xf300) || (ax==0xf400)) && (bx==0x0004)) {
282 err = tosh_emulate_fan(&regs);
283 mutex_unlock(&tosh_mutex);
284 break;
287 err = tosh_smm(&regs);
288 mutex_unlock(&tosh_mutex);
289 break;
290 default:
291 return -EINVAL;
294 if (copy_to_user(argp, &regs, sizeof(SMMRegisters)))
295 return -EFAULT;
297 return (err==0) ? 0:-EINVAL;
302 * Print the information for /proc/toshiba
304 #ifdef CONFIG_PROC_FS
305 static int proc_toshiba_show(struct seq_file *m, void *v)
307 int key;
309 key = tosh_fn_status();
311 /* Arguments
312 0) Linux driver version (this will change if format changes)
313 1) Machine ID
314 2) SCI version
315 3) BIOS version (major, minor)
316 4) BIOS date (in SCI date format)
317 5) Fn Key status
319 seq_printf(m, "1.1 0x%04x %d.%d %d.%d 0x%04x 0x%02x\n",
320 tosh_id,
321 (tosh_sci & 0xff00)>>8,
322 tosh_sci & 0xff,
323 (tosh_bios & 0xff00)>>8,
324 tosh_bios & 0xff,
325 tosh_date,
326 key);
327 return 0;
330 static int proc_toshiba_open(struct inode *inode, struct file *file)
332 return single_open(file, proc_toshiba_show, NULL);
335 static const struct file_operations proc_toshiba_fops = {
336 .owner = THIS_MODULE,
337 .open = proc_toshiba_open,
338 .read = seq_read,
339 .llseek = seq_lseek,
340 .release = single_release,
342 #endif
346 * Determine which port to use for the Fn key status
348 static void tosh_set_fn_port(void)
350 switch (tosh_id) {
351 case 0xfc02: case 0xfc04: case 0xfc09: case 0xfc0a: case 0xfc10:
352 case 0xfc11: case 0xfc13: case 0xfc15: case 0xfc1a: case 0xfc1b:
353 case 0xfc5a:
354 tosh_fn = 0x62;
355 break;
356 case 0xfc08: case 0xfc17: case 0xfc1d: case 0xfcd1: case 0xfce0:
357 case 0xfce2:
358 tosh_fn = 0x68;
359 break;
360 default:
361 tosh_fn = 0x00;
362 break;
365 return;
370 * Get the machine identification number of the current model
372 static int tosh_get_machine_id(void __iomem *bios)
374 int id;
375 SMMRegisters regs;
376 unsigned short bx,cx;
377 unsigned long address;
379 id = (0x100*(int) readb(bios+0xfffe))+((int) readb(bios+0xfffa));
381 /* do we have a SCTTable machine identication number on our hands */
383 if (id==0xfc2f) {
385 /* start by getting a pointer into the BIOS */
387 regs.eax = 0xc000;
388 regs.ebx = 0x0000;
389 regs.ecx = 0x0000;
390 tosh_smm(&regs);
391 bx = (unsigned short) (regs.ebx & 0xffff);
393 /* At this point in the Toshiba routines under MS Windows
394 the bx register holds 0xe6f5. However my code is producing
395 a different value! For the time being I will just fudge the
396 value. This has been verified on a Satellite Pro 430CDT,
397 Tecra 750CDT, Tecra 780DVD and Satellite 310CDT. */
398 #if TOSH_DEBUG
399 printk("toshiba: debugging ID ebx=0x%04x\n", regs.ebx);
400 #endif
401 bx = 0xe6f5;
403 /* now twiddle with our pointer a bit */
405 address = bx;
406 cx = readw(bios + address);
407 address = 9+bx+cx;
408 cx = readw(bios + address);
409 address = 0xa+cx;
410 cx = readw(bios + address);
412 /* now construct our machine identification number */
414 id = ((cx & 0xff)<<8)+((cx & 0xff00)>>8);
417 return id;
422 * Probe for the presence of a Toshiba laptop
424 * returns and non-zero if unable to detect the presence of a Toshiba
425 * laptop, otherwise zero and determines the Machine ID, BIOS version and
426 * date, and SCI version.
428 static int tosh_probe(void)
430 int i,major,minor,day,year,month,flag;
431 unsigned char signature[7] = { 0x54,0x4f,0x53,0x48,0x49,0x42,0x41 };
432 SMMRegisters regs;
433 void __iomem *bios = ioremap_cache(0xf0000, 0x10000);
435 if (!bios)
436 return -ENOMEM;
438 /* extra sanity check for the string "TOSHIBA" in the BIOS because
439 some machines that are not Toshiba's pass the next test */
441 for (i=0;i<7;i++) {
442 if (readb(bios+0xe010+i)!=signature[i]) {
443 printk("toshiba: not a supported Toshiba laptop\n");
444 iounmap(bios);
445 return -ENODEV;
449 /* call the Toshiba SCI support check routine */
451 regs.eax = 0xf0f0;
452 regs.ebx = 0x0000;
453 regs.ecx = 0x0000;
454 flag = tosh_smm(&regs);
456 /* if this is not a Toshiba laptop carry flag is set and ah=0x86 */
458 if ((flag==1) || ((regs.eax & 0xff00)==0x8600)) {
459 printk("toshiba: not a supported Toshiba laptop\n");
460 iounmap(bios);
461 return -ENODEV;
464 /* if we get this far then we are running on a Toshiba (probably)! */
466 tosh_sci = regs.edx & 0xffff;
468 /* next get the machine ID of the current laptop */
470 tosh_id = tosh_get_machine_id(bios);
472 /* get the BIOS version */
474 major = readb(bios+0xe009)-'0';
475 minor = ((readb(bios+0xe00b)-'0')*10)+(readb(bios+0xe00c)-'0');
476 tosh_bios = (major*0x100)+minor;
478 /* get the BIOS date */
480 day = ((readb(bios+0xfff5)-'0')*10)+(readb(bios+0xfff6)-'0');
481 month = ((readb(bios+0xfff8)-'0')*10)+(readb(bios+0xfff9)-'0');
482 year = ((readb(bios+0xfffb)-'0')*10)+(readb(bios+0xfffc)-'0');
483 tosh_date = (((year-90) & 0x1f)<<10) | ((month & 0xf)<<6)
484 | ((day & 0x1f)<<1);
487 /* in theory we should check the ports we are going to use for the
488 fn key detection (and the fan on the Portage 610/Tecra700), and
489 then request them to stop other drivers using them. However as
490 the keyboard driver grabs 0x60-0x6f and the pic driver grabs
491 0xa0-0xbf we can't. We just have to live dangerously and use the
492 ports anyway, oh boy! */
494 /* do we need to emulate the fan? */
496 if ((tosh_id==0xfccb) || (tosh_id==0xfccc))
497 tosh_fan = 1;
499 iounmap(bios);
501 return 0;
504 static int __init toshiba_init(void)
506 int retval;
507 /* are we running on a Toshiba laptop */
509 if (tosh_probe())
510 return -ENODEV;
512 printk(KERN_INFO "Toshiba System Management Mode driver v" TOSH_VERSION "\n");
514 /* set the port to use for Fn status if not specified as a parameter */
515 if (tosh_fn==0x00)
516 tosh_set_fn_port();
518 /* register the device file */
519 retval = misc_register(&tosh_device);
520 if (retval < 0)
521 return retval;
523 #ifdef CONFIG_PROC_FS
525 struct proc_dir_entry *pde;
527 pde = proc_create("toshiba", 0, NULL, &proc_toshiba_fops);
528 if (!pde) {
529 misc_deregister(&tosh_device);
530 return -ENOMEM;
533 #endif
535 return 0;
538 static void __exit toshiba_exit(void)
540 remove_proc_entry("toshiba", NULL);
541 misc_deregister(&tosh_device);
544 module_init(toshiba_init);
545 module_exit(toshiba_exit);