pcmcia: Documentation update
[linux-2.6.git] / drivers / pcmcia / pcmcia_resource.c
1 /*
2  * PCMCIA 16-bit resource management functions
3  *
4  * The initial developer of the original code is David A. Hinds
5  * <dahinds@users.sourceforge.net>.  Portions created by David A. Hinds
6  * are Copyright (C) 1999 David A. Hinds.  All Rights Reserved.
7  *
8  * Copyright (C) 1999        David A. Hinds
9  * Copyright (C) 2004-2010   Dominik Brodowski
10  *
11  * This program is free software; you can redistribute it and/or modify
12  * it under the terms of the GNU General Public License version 2 as
13  * published by the Free Software Foundation.
14  *
15  */
16
17 #include <linux/module.h>
18 #include <linux/kernel.h>
19 #include <linux/interrupt.h>
20 #include <linux/delay.h>
21 #include <linux/pci.h>
22 #include <linux/device.h>
23 #include <linux/netdevice.h>
24 #include <linux/slab.h>
25
26 #include <asm/irq.h>
27
28 #include <pcmcia/ss.h>
29 #include <pcmcia/cistpl.h>
30 #include <pcmcia/cisreg.h>
31 #include <pcmcia/ds.h>
32
33 #include "cs_internal.h"
34
35
36 /* Access speed for IO windows */
37 static int io_speed;
38 module_param(io_speed, int, 0444);
39
40
41 int pcmcia_validate_mem(struct pcmcia_socket *s)
42 {
43         if (s->resource_ops->validate_mem)
44                 return s->resource_ops->validate_mem(s);
45         /* if there is no callback, we can assume that everything is OK */
46         return 0;
47 }
48
49 struct resource *pcmcia_find_mem_region(u_long base, u_long num, u_long align,
50                                  int low, struct pcmcia_socket *s)
51 {
52         if (s->resource_ops->find_mem)
53                 return s->resource_ops->find_mem(base, num, align, low, s);
54         return NULL;
55 }
56
57
58 /**
59  * release_io_space() - release IO ports allocated with alloc_io_space()
60  * @s: pcmcia socket
61  * @res: resource to release
62  *
63  */
64 static void release_io_space(struct pcmcia_socket *s, struct resource *res)
65 {
66         resource_size_t num = resource_size(res);
67         int i;
68
69         dev_dbg(&s->dev, "release_io_space for %pR\n", res);
70
71         for (i = 0; i < MAX_IO_WIN; i++) {
72                 if (!s->io[i].res)
73                         continue;
74                 if ((s->io[i].res->start <= res->start) &&
75                     (s->io[i].res->end >= res->end)) {
76                         s->io[i].InUse -= num;
77                         if (res->parent)
78                                 release_resource(res);
79                         res->start = res->end = 0;
80                         res->flags = IORESOURCE_IO;
81                         /* Free the window if no one else is using it */
82                         if (s->io[i].InUse == 0) {
83                                 release_resource(s->io[i].res);
84                                 kfree(s->io[i].res);
85                                 s->io[i].res = NULL;
86                         }
87                 }
88         }
89 }
90
91
92 /**
93  * alloc_io_space() - allocate IO ports for use by a PCMCIA device
94  * @s: pcmcia socket
95  * @res: resource to allocate (begin: begin, end: size)
96  * @lines: number of IO lines decoded by the PCMCIA card
97  *
98  * Special stuff for managing IO windows, because they are scarce
99  */
100 static int alloc_io_space(struct pcmcia_socket *s, struct resource *res,
101                         unsigned int lines)
102 {
103         unsigned int align;
104         unsigned int base = res->start;
105         unsigned int num = res->end;
106         int ret;
107
108         res->flags |= IORESOURCE_IO;
109
110         dev_dbg(&s->dev, "alloc_io_space request for %pR, %d lines\n",
111                 res, lines);
112
113         align = base ? (lines ? 1<<lines : 0) : 1;
114         if (align && (align < num)) {
115                 if (base) {
116                         dev_dbg(&s->dev, "odd IO request\n");
117                         align = 0;
118                 } else
119                         while (align && (align < num))
120                                 align <<= 1;
121         }
122         if (base & ~(align-1)) {
123                 dev_dbg(&s->dev, "odd IO request\n");
124                 align = 0;
125         }
126
127         ret = s->resource_ops->find_io(s, res->flags, &base, num, align,
128                                 &res->parent);
129         if (ret) {
130                 dev_dbg(&s->dev, "alloc_io_space request failed (%d)\n", ret);
131                 return -EINVAL;
132         }
133
134         res->start = base;
135         res->end = res->start + num - 1;
136
137         if (res->parent) {
138                 ret = request_resource(res->parent, res);
139                 if (ret) {
140                         dev_warn(&s->dev,
141                                 "request_resource %pR failed: %d\n", res, ret);
142                         res->parent = NULL;
143                         release_io_space(s, res);
144                 }
145         }
146         dev_dbg(&s->dev, "alloc_io_space request result %d: %pR\n", ret, res);
147         return ret;
148 }
149
150
151 /**
152  * pcmcia_access_config() - read or write card configuration registers
153  *
154  * pcmcia_access_config() reads and writes configuration registers in
155  * attribute memory.  Memory window 0 is reserved for this and the tuple
156  * reading services. Drivers must use pcmcia_read_config_byte() or
157  * pcmcia_write_config_byte().
158  */
159 static int pcmcia_access_config(struct pcmcia_device *p_dev,
160                                 off_t where, u8 *val,
161                                 int (*accessf) (struct pcmcia_socket *s,
162                                                 int attr, unsigned int addr,
163                                                 unsigned int len, void *ptr))
164 {
165         struct pcmcia_socket *s;
166         config_t *c;
167         int addr;
168         int ret = 0;
169
170         s = p_dev->socket;
171
172         mutex_lock(&s->ops_mutex);
173         c = p_dev->function_config;
174
175         if (!(c->state & CONFIG_LOCKED)) {
176                 dev_dbg(&p_dev->dev, "Configuration isnt't locked\n");
177                 mutex_unlock(&s->ops_mutex);
178                 return -EACCES;
179         }
180
181         addr = (p_dev->config_base + where) >> 1;
182
183         ret = accessf(s, 1, addr, 1, val);
184
185         mutex_unlock(&s->ops_mutex);
186
187         return ret;
188 }
189
190
191 /**
192  * pcmcia_read_config_byte() - read a byte from a card configuration register
193  *
194  * pcmcia_read_config_byte() reads a byte from a configuration register in
195  * attribute memory.
196  */
197 int pcmcia_read_config_byte(struct pcmcia_device *p_dev, off_t where, u8 *val)
198 {
199         return pcmcia_access_config(p_dev, where, val, pcmcia_read_cis_mem);
200 }
201 EXPORT_SYMBOL(pcmcia_read_config_byte);
202
203
204 /**
205  * pcmcia_write_config_byte() - write a byte to a card configuration register
206  *
207  * pcmcia_write_config_byte() writes a byte to a configuration register in
208  * attribute memory.
209  */
210 int pcmcia_write_config_byte(struct pcmcia_device *p_dev, off_t where, u8 val)
211 {
212         return pcmcia_access_config(p_dev, where, &val, pcmcia_write_cis_mem);
213 }
214 EXPORT_SYMBOL(pcmcia_write_config_byte);
215
216
217 /**
218  * pcmcia_map_mem_page() - modify iomem window to point to a different offset
219  * @p_dev: pcmcia device
220  * @res: iomem resource already enabled by pcmcia_request_window()
221  * @offset: card_offset to map
222  *
223  * pcmcia_map_mem_page() modifies what can be read and written by accessing
224  * an iomem range previously enabled by pcmcia_request_window(), by setting
225  * the card_offset value to @offset.
226  */
227 int pcmcia_map_mem_page(struct pcmcia_device *p_dev, struct resource *res,
228                         unsigned int offset)
229 {
230         struct pcmcia_socket *s = p_dev->socket;
231         unsigned int w;
232         int ret;
233
234         w = ((res->flags & IORESOURCE_BITS & WIN_FLAGS_REQ) >> 2) - 1;
235         if (w >= MAX_WIN)
236                 return -EINVAL;
237
238         mutex_lock(&s->ops_mutex);
239         s->win[w].card_start = offset;
240         ret = s->ops->set_mem_map(s, &s->win[w]);
241         if (ret)
242                 dev_warn(&p_dev->dev, "failed to set_mem_map\n");
243         mutex_unlock(&s->ops_mutex);
244         return ret;
245 }
246 EXPORT_SYMBOL(pcmcia_map_mem_page);
247
248
249 /**
250  * pcmcia_fixup_iowidth() - reduce io width to 8bit
251  * @p_dev: pcmcia device
252  *
253  * pcmcia_fixup_iowidth() allows a PCMCIA device driver to reduce the
254  * IO width to 8bit after having called pcmcia_enable_device()
255  * previously.
256  */
257 int pcmcia_fixup_iowidth(struct pcmcia_device *p_dev)
258 {
259         struct pcmcia_socket *s = p_dev->socket;
260         pccard_io_map io_off = { 0, 0, 0, 0, 1 };
261         pccard_io_map io_on;
262         int i, ret = 0;
263
264         mutex_lock(&s->ops_mutex);
265
266         dev_dbg(&p_dev->dev, "fixup iowidth to 8bit\n");
267
268         if (!(s->state & SOCKET_PRESENT) ||
269                 !(p_dev->function_config->state & CONFIG_LOCKED)) {
270                 dev_dbg(&p_dev->dev, "No card? Config not locked?\n");
271                 ret = -EACCES;
272                 goto unlock;
273         }
274
275         io_on.speed = io_speed;
276         for (i = 0; i < MAX_IO_WIN; i++) {
277                 if (!s->io[i].res)
278                         continue;
279                 io_off.map = i;
280                 io_on.map = i;
281
282                 io_on.flags = MAP_ACTIVE | IO_DATA_PATH_WIDTH_8;
283                 io_on.start = s->io[i].res->start;
284                 io_on.stop = s->io[i].res->end;
285
286                 s->ops->set_io_map(s, &io_off);
287                 mdelay(40);
288                 s->ops->set_io_map(s, &io_on);
289         }
290 unlock:
291         mutex_unlock(&s->ops_mutex);
292
293         return ret;
294 }
295 EXPORT_SYMBOL(pcmcia_fixup_iowidth);
296
297
298 /**
299  * pcmcia_fixup_vpp() - set Vpp to a new voltage level
300  * @p_dev: pcmcia device
301  * @new_vpp: new Vpp voltage
302  *
303  * pcmcia_fixup_vpp() allows a PCMCIA device driver to set Vpp to
304  * a new voltage level between calls to pcmcia_enable_device()
305  * and pcmcia_disable_device().
306  */
307 int pcmcia_fixup_vpp(struct pcmcia_device *p_dev, unsigned char new_vpp)
308 {
309         struct pcmcia_socket *s = p_dev->socket;
310         int ret = 0;
311
312         mutex_lock(&s->ops_mutex);
313
314         dev_dbg(&p_dev->dev, "fixup Vpp to %d\n", new_vpp);
315
316         if (!(s->state & SOCKET_PRESENT) ||
317                 !(p_dev->function_config->state & CONFIG_LOCKED)) {
318                 dev_dbg(&p_dev->dev, "No card? Config not locked?\n");
319                 ret = -EACCES;
320                 goto unlock;
321         }
322
323         s->socket.Vpp = new_vpp;
324         if (s->ops->set_socket(s, &s->socket)) {
325                 dev_warn(&p_dev->dev, "Unable to set VPP\n");
326                 ret = -EIO;
327                 goto unlock;
328         }
329         p_dev->vpp = new_vpp;
330
331 unlock:
332         mutex_unlock(&s->ops_mutex);
333
334         return ret;
335 }
336 EXPORT_SYMBOL(pcmcia_fixup_vpp);
337
338
339 /**
340  * pcmcia_release_configuration() - physically disable a PCMCIA device
341  * @p_dev: pcmcia device
342  *
343  * pcmcia_release_configuration() is the 1:1 counterpart to
344  * pcmcia_enable_device(): If a PCMCIA device is no longer used by any
345  * driver, the Vpp voltage is set to 0, IRQs will no longer be generated,
346  * and I/O ranges will be disabled. As pcmcia_release_io() and
347  * pcmcia_release_window() still need to be called, device drivers are
348  * expected to call pcmcia_disable_device() instead.
349  */
350 int pcmcia_release_configuration(struct pcmcia_device *p_dev)
351 {
352         pccard_io_map io = { 0, 0, 0, 0, 1 };
353         struct pcmcia_socket *s = p_dev->socket;
354         config_t *c;
355         int i;
356
357         mutex_lock(&s->ops_mutex);
358         c = p_dev->function_config;
359         if (p_dev->_locked) {
360                 p_dev->_locked = 0;
361                 if (--(s->lock_count) == 0) {
362                         s->socket.flags = SS_OUTPUT_ENA; /* Is this correct? */
363                         s->socket.Vpp = 0;
364                         s->socket.io_irq = 0;
365                         s->ops->set_socket(s, &s->socket);
366                 }
367         }
368         if (c->state & CONFIG_LOCKED) {
369                 c->state &= ~CONFIG_LOCKED;
370                 if (c->state & CONFIG_IO_REQ)
371                         for (i = 0; i < MAX_IO_WIN; i++) {
372                                 if (!s->io[i].res)
373                                         continue;
374                                 s->io[i].Config--;
375                                 if (s->io[i].Config != 0)
376                                         continue;
377                                 io.map = i;
378                                 s->ops->set_io_map(s, &io);
379                         }
380         }
381         mutex_unlock(&s->ops_mutex);
382
383         return 0;
384 }
385
386
387 /**
388  * pcmcia_release_io() - release I/O allocated by a PCMCIA device
389  * @p_dev: pcmcia device
390  *
391  * pcmcia_release_io() releases the I/O ranges allocated by a PCMCIA
392  * device.  This may be invoked some time after a card ejection has
393  * already dumped the actual socket configuration, so if the client is
394  * "stale", we don't bother checking the port ranges against the
395  * current socket values.
396  */
397 static int pcmcia_release_io(struct pcmcia_device *p_dev)
398 {
399         struct pcmcia_socket *s = p_dev->socket;
400         int ret = -EINVAL;
401         config_t *c;
402
403         mutex_lock(&s->ops_mutex);
404         if (!p_dev->_io)
405                 goto out;
406
407         c = p_dev->function_config;
408
409         release_io_space(s, &c->io[0]);
410
411         if (c->io[1].end)
412                 release_io_space(s, &c->io[1]);
413
414         p_dev->_io = 0;
415         c->state &= ~CONFIG_IO_REQ;
416
417 out:
418         mutex_unlock(&s->ops_mutex);
419
420         return ret;
421 } /* pcmcia_release_io */
422
423
424 /**
425  * pcmcia_release_window() - release reserved iomem for PCMCIA devices
426  * @p_dev: pcmcia device
427  * @res: iomem resource to release
428  *
429  * pcmcia_release_window() releases &struct resource *res which was
430  * previously reserved by calling pcmcia_request_window().
431  */
432 int pcmcia_release_window(struct pcmcia_device *p_dev, struct resource *res)
433 {
434         struct pcmcia_socket *s = p_dev->socket;
435         pccard_mem_map *win;
436         unsigned int w;
437
438         dev_dbg(&p_dev->dev, "releasing window %pR\n", res);
439
440         w = ((res->flags & IORESOURCE_BITS & WIN_FLAGS_REQ) >> 2) - 1;
441         if (w >= MAX_WIN)
442                 return -EINVAL;
443
444         mutex_lock(&s->ops_mutex);
445         win = &s->win[w];
446
447         if (!(p_dev->_win & CLIENT_WIN_REQ(w))) {
448                 dev_dbg(&p_dev->dev, "not releasing unknown window\n");
449                 mutex_unlock(&s->ops_mutex);
450                 return -EINVAL;
451         }
452
453         /* Shut down memory window */
454         win->flags &= ~MAP_ACTIVE;
455         s->ops->set_mem_map(s, win);
456         s->state &= ~SOCKET_WIN_REQ(w);
457
458         /* Release system memory */
459         if (win->res) {
460                 release_resource(res);
461                 release_resource(win->res);
462                 kfree(win->res);
463                 win->res = NULL;
464         }
465         res->start = res->end = 0;
466         res->flags = IORESOURCE_MEM;
467         p_dev->_win &= ~CLIENT_WIN_REQ(w);
468         mutex_unlock(&s->ops_mutex);
469
470         return 0;
471 } /* pcmcia_release_window */
472 EXPORT_SYMBOL(pcmcia_release_window);
473
474
475 /**
476  * pcmcia_enable_device() - set up and activate a PCMCIA device
477  * @p_dev: the associated PCMCIA device
478  *
479  * pcmcia_enable_device() physically enables a PCMCIA device. It parses
480  * the flags passed to in @flags and stored in @p_dev->flags and sets up
481  * the Vpp voltage, enables the speaker line, I/O ports and store proper
482  * values to configuration registers.
483  */
484 int pcmcia_enable_device(struct pcmcia_device *p_dev)
485 {
486         int i;
487         unsigned int base;
488         struct pcmcia_socket *s = p_dev->socket;
489         config_t *c;
490         pccard_io_map iomap;
491         unsigned char status = 0;
492         unsigned char ext_status = 0;
493         unsigned char option = 0;
494         unsigned int flags = p_dev->config_flags;
495
496         if (!(s->state & SOCKET_PRESENT))
497                 return -ENODEV;
498
499         mutex_lock(&s->ops_mutex);
500         c = p_dev->function_config;
501         if (c->state & CONFIG_LOCKED) {
502                 mutex_unlock(&s->ops_mutex);
503                 dev_dbg(&p_dev->dev, "Configuration is locked\n");
504                 return -EACCES;
505         }
506
507         /* Do power control.  We don't allow changes in Vcc. */
508         s->socket.Vpp = p_dev->vpp;
509         if (s->ops->set_socket(s, &s->socket)) {
510                 mutex_unlock(&s->ops_mutex);
511                 dev_printk(KERN_WARNING, &p_dev->dev,
512                            "Unable to set socket state\n");
513                 return -EINVAL;
514         }
515
516         /* Pick memory or I/O card, DMA mode, interrupt */
517         if (p_dev->_io)
518                 s->socket.flags |= SS_IOCARD;
519         if (flags & CONF_ENABLE_SPKR) {
520                 s->socket.flags |= SS_SPKR_ENA;
521                 status = CCSR_AUDIO_ENA;
522                 if (!(p_dev->config_regs & PRESENT_STATUS))
523                         dev_warn(&p_dev->dev, "speaker requested, but "
524                                               "PRESENT_STATUS not set!\n");
525         }
526         if (flags & CONF_ENABLE_IRQ)
527                 s->socket.io_irq = s->pcmcia_irq;
528         else
529                 s->socket.io_irq = 0;
530         if (flags & CONF_ENABLE_ESR) {
531                 p_dev->config_regs |= PRESENT_EXT_STATUS;
532                 ext_status = ESR_REQ_ATTN_ENA;
533         }
534         s->ops->set_socket(s, &s->socket);
535         s->lock_count++;
536
537         /* Set up CIS configuration registers */
538         base = p_dev->config_base;
539         if (p_dev->config_regs & PRESENT_COPY) {
540                 u16 tmp = 0;
541                 dev_dbg(&p_dev->dev, "clearing CISREG_SCR\n");
542                 pcmcia_write_cis_mem(s, 1, (base + CISREG_SCR)>>1, 1, &tmp);
543         }
544         if (p_dev->config_regs & PRESENT_PIN_REPLACE) {
545                 u16 tmp = 0;
546                 dev_dbg(&p_dev->dev, "clearing CISREG_PRR\n");
547                 pcmcia_write_cis_mem(s, 1, (base + CISREG_PRR)>>1, 1, &tmp);
548         }
549         if (p_dev->config_regs & PRESENT_OPTION) {
550                 if (s->functions == 1) {
551                         option = p_dev->config_index & COR_CONFIG_MASK;
552                 } else {
553                         option = p_dev->config_index & COR_MFC_CONFIG_MASK;
554                         option |= COR_FUNC_ENA|COR_IREQ_ENA;
555                         if (p_dev->config_regs & PRESENT_IOBASE_0)
556                                 option |= COR_ADDR_DECODE;
557                 }
558                 if ((flags & CONF_ENABLE_IRQ) &&
559                         !(flags & CONF_ENABLE_PULSE_IRQ))
560                         option |= COR_LEVEL_REQ;
561                 pcmcia_write_cis_mem(s, 1, (base + CISREG_COR)>>1, 1, &option);
562                 mdelay(40);
563         }
564         if (p_dev->config_regs & PRESENT_STATUS)
565                 pcmcia_write_cis_mem(s, 1, (base + CISREG_CCSR)>>1, 1, &status);
566
567         if (p_dev->config_regs & PRESENT_EXT_STATUS)
568                 pcmcia_write_cis_mem(s, 1, (base + CISREG_ESR)>>1, 1,
569                                         &ext_status);
570
571         if (p_dev->config_regs & PRESENT_IOBASE_0) {
572                 u8 b = c->io[0].start & 0xff;
573                 pcmcia_write_cis_mem(s, 1, (base + CISREG_IOBASE_0)>>1, 1, &b);
574                 b = (c->io[0].start >> 8) & 0xff;
575                 pcmcia_write_cis_mem(s, 1, (base + CISREG_IOBASE_1)>>1, 1, &b);
576         }
577         if (p_dev->config_regs & PRESENT_IOSIZE) {
578                 u8 b = resource_size(&c->io[0]) + resource_size(&c->io[1]) - 1;
579                 pcmcia_write_cis_mem(s, 1, (base + CISREG_IOSIZE)>>1, 1, &b);
580         }
581
582         /* Configure I/O windows */
583         if (c->state & CONFIG_IO_REQ) {
584                 iomap.speed = io_speed;
585                 for (i = 0; i < MAX_IO_WIN; i++)
586                         if (s->io[i].res) {
587                                 iomap.map = i;
588                                 iomap.flags = MAP_ACTIVE;
589                                 switch (s->io[i].res->flags & IO_DATA_PATH_WIDTH) {
590                                 case IO_DATA_PATH_WIDTH_16:
591                                         iomap.flags |= MAP_16BIT; break;
592                                 case IO_DATA_PATH_WIDTH_AUTO:
593                                         iomap.flags |= MAP_AUTOSZ; break;
594                                 default:
595                                         break;
596                                 }
597                                 iomap.start = s->io[i].res->start;
598                                 iomap.stop = s->io[i].res->end;
599                                 s->ops->set_io_map(s, &iomap);
600                                 s->io[i].Config++;
601                         }
602         }
603
604         c->state |= CONFIG_LOCKED;
605         p_dev->_locked = 1;
606         mutex_unlock(&s->ops_mutex);
607         return 0;
608 } /* pcmcia_enable_device */
609 EXPORT_SYMBOL(pcmcia_enable_device);
610
611
612 /**
613  * pcmcia_request_io() - attempt to reserve port ranges for PCMCIA devices
614  * @p_dev: the associated PCMCIA device
615  *
616  * pcmcia_request_io() attempts to reserve the IO port ranges specified in
617  * &struct pcmcia_device @p_dev->resource[0] and @p_dev->resource[1]. The
618  * "start" value is the requested start of the IO port resource; "end"
619  * reflects the number of ports requested. The number of IO lines requested
620  * is specified in &struct pcmcia_device @p_dev->io_lines.
621  */
622 int pcmcia_request_io(struct pcmcia_device *p_dev)
623 {
624         struct pcmcia_socket *s = p_dev->socket;
625         config_t *c = p_dev->function_config;
626         int ret = -EINVAL;
627
628         mutex_lock(&s->ops_mutex);
629         dev_dbg(&p_dev->dev, "pcmcia_request_io: %pR , %pR",
630                 &c->io[0], &c->io[1]);
631
632         if (!(s->state & SOCKET_PRESENT)) {
633                 dev_dbg(&p_dev->dev, "pcmcia_request_io: No card present\n");
634                 goto out;
635         }
636
637         if (c->state & CONFIG_LOCKED) {
638                 dev_dbg(&p_dev->dev, "Configuration is locked\n");
639                 goto out;
640         }
641         if (c->state & CONFIG_IO_REQ) {
642                 dev_dbg(&p_dev->dev, "IO already configured\n");
643                 goto out;
644         }
645
646         ret = alloc_io_space(s, &c->io[0], p_dev->io_lines);
647         if (ret)
648                 goto out;
649
650         if (c->io[1].end) {
651                 ret = alloc_io_space(s, &c->io[1], p_dev->io_lines);
652                 if (ret) {
653                         struct resource tmp = c->io[0];
654                         /* release the previously allocated resource */
655                         release_io_space(s, &c->io[0]);
656                         /* but preserve the settings, for they worked... */
657                         c->io[0].end = resource_size(&tmp);
658                         c->io[0].start = tmp.start;
659                         c->io[0].flags = tmp.flags;
660                         goto out;
661                 }
662         } else
663                 c->io[1].start = 0;
664
665         c->state |= CONFIG_IO_REQ;
666         p_dev->_io = 1;
667
668         dev_dbg(&p_dev->dev, "pcmcia_request_io succeeded: %pR , %pR",
669                 &c->io[0], &c->io[1]);
670 out:
671         mutex_unlock(&s->ops_mutex);
672
673         return ret;
674 } /* pcmcia_request_io */
675 EXPORT_SYMBOL(pcmcia_request_io);
676
677
678 /**
679  * pcmcia_request_irq() - attempt to request a IRQ for a PCMCIA device
680  * @p_dev: the associated PCMCIA device
681  * @handler: IRQ handler to register
682  *
683  * pcmcia_request_irq() is a wrapper around request_irq() which allows
684  * the PCMCIA core to clean up the registration in pcmcia_disable_device().
685  * Drivers are free to use request_irq() directly, but then they need to
686  * call free_irq() themselfves, too. Also, only %IRQF_SHARED capable IRQ
687  * handlers are allowed.
688  */
689 int __must_check pcmcia_request_irq(struct pcmcia_device *p_dev,
690                                     irq_handler_t handler)
691 {
692         int ret;
693
694         if (!p_dev->irq)
695                 return -EINVAL;
696
697         ret = request_irq(p_dev->irq, handler, IRQF_SHARED,
698                         p_dev->devname, p_dev->priv);
699         if (!ret)
700                 p_dev->_irq = 1;
701
702         return ret;
703 }
704 EXPORT_SYMBOL(pcmcia_request_irq);
705
706
707 /**
708  * pcmcia_request_exclusive_irq() - attempt to request an exclusive IRQ first
709  * @p_dev: the associated PCMCIA device
710  * @handler: IRQ handler to register
711  *
712  * pcmcia_request_exclusive_irq() is a wrapper around request_irq() which
713  * attempts first to request an exclusive IRQ. If it fails, it also accepts
714  * a shared IRQ, but prints out a warning. PCMCIA drivers should allow for
715  * IRQ sharing and either use request_irq directly (then they need to call
716  * free_irq() themselves, too), or the pcmcia_request_irq() function.
717  */
718 int __must_check
719 __pcmcia_request_exclusive_irq(struct pcmcia_device *p_dev,
720                         irq_handler_t handler)
721 {
722         int ret;
723
724         if (!p_dev->irq)
725                 return -EINVAL;
726
727         ret = request_irq(p_dev->irq, handler, 0, p_dev->devname, p_dev->priv);
728         if (ret) {
729                 ret = pcmcia_request_irq(p_dev, handler);
730                 dev_printk(KERN_WARNING, &p_dev->dev, "pcmcia: "
731                         "request for exclusive IRQ could not be fulfilled.\n");
732                 dev_printk(KERN_WARNING, &p_dev->dev, "pcmcia: the driver "
733                         "needs updating to supported shared IRQ lines.\n");
734         }
735         if (ret)
736                 dev_printk(KERN_INFO, &p_dev->dev, "request_irq() failed\n");
737         else
738                 p_dev->_irq = 1;
739
740         return ret;
741 } /* pcmcia_request_exclusive_irq */
742 EXPORT_SYMBOL(__pcmcia_request_exclusive_irq);
743
744
745 #ifdef CONFIG_PCMCIA_PROBE
746
747 /* mask of IRQs already reserved by other cards, we should avoid using them */
748 static u8 pcmcia_used_irq[32];
749
750 static irqreturn_t test_action(int cpl, void *dev_id)
751 {
752         return IRQ_NONE;
753 }
754
755 /**
756  * pcmcia_setup_isa_irq() - determine whether an ISA IRQ can be used
757  * @p_dev - the associated PCMCIA device
758  *
759  * locking note: must be called with ops_mutex locked.
760  */
761 static int pcmcia_setup_isa_irq(struct pcmcia_device *p_dev, int type)
762 {
763         struct pcmcia_socket *s = p_dev->socket;
764         unsigned int try, irq;
765         u32 mask = s->irq_mask;
766         int ret = -ENODEV;
767
768         for (try = 0; try < 64; try++) {
769                 irq = try % 32;
770
771                 if (irq > NR_IRQS)
772                         continue;
773
774                 /* marked as available by driver, not blocked by userspace? */
775                 if (!((mask >> irq) & 1))
776                         continue;
777
778                 /* avoid an IRQ which is already used by another PCMCIA card */
779                 if ((try < 32) && pcmcia_used_irq[irq])
780                         continue;
781
782                 /* register the correct driver, if possible, to check whether
783                  * registering a dummy handle works, i.e. if the IRQ isn't
784                  * marked as used by the kernel resource management core */
785                 ret = request_irq(irq, test_action, type, p_dev->devname,
786                                   p_dev);
787                 if (!ret) {
788                         free_irq(irq, p_dev);
789                         p_dev->irq = s->pcmcia_irq = irq;
790                         pcmcia_used_irq[irq]++;
791                         break;
792                 }
793         }
794
795         return ret;
796 }
797
798 void pcmcia_cleanup_irq(struct pcmcia_socket *s)
799 {
800         pcmcia_used_irq[s->pcmcia_irq]--;
801         s->pcmcia_irq = 0;
802 }
803
804 #else /* CONFIG_PCMCIA_PROBE */
805
806 static int pcmcia_setup_isa_irq(struct pcmcia_device *p_dev, int type)
807 {
808         return -EINVAL;
809 }
810
811 void pcmcia_cleanup_irq(struct pcmcia_socket *s)
812 {
813         s->pcmcia_irq = 0;
814         return;
815 }
816
817 #endif  /* CONFIG_PCMCIA_PROBE */
818
819
820 /**
821  * pcmcia_setup_irq() - determine IRQ to be used for device
822  * @p_dev - the associated PCMCIA device
823  *
824  * locking note: must be called with ops_mutex locked.
825  */
826 int pcmcia_setup_irq(struct pcmcia_device *p_dev)
827 {
828         struct pcmcia_socket *s = p_dev->socket;
829
830         if (p_dev->irq)
831                 return 0;
832
833         /* already assigned? */
834         if (s->pcmcia_irq) {
835                 p_dev->irq = s->pcmcia_irq;
836                 return 0;
837         }
838
839         /* prefer an exclusive ISA irq */
840         if (!pcmcia_setup_isa_irq(p_dev, 0))
841                 return 0;
842
843         /* but accept a shared ISA irq */
844         if (!pcmcia_setup_isa_irq(p_dev, IRQF_SHARED))
845                 return 0;
846
847         /* but use the PCI irq otherwise */
848         if (s->pci_irq) {
849                 p_dev->irq = s->pcmcia_irq = s->pci_irq;
850                 return 0;
851         }
852
853         return -EINVAL;
854 }
855
856
857 /**
858  * pcmcia_request_window() - attempt to reserve iomem for PCMCIA devices
859  * @p_dev: the associated PCMCIA device
860  * @res: &struct resource pointing to p_dev->resource[2..5]
861  * @speed: access speed
862  *
863  * pcmcia_request_window() attepts to reserve an iomem ranges specified in
864  * &struct resource @res pointing to one of the entries in
865  * &struct pcmcia_device @p_dev->resource[2..5]. The "start" value is the
866  * requested start of the IO mem resource; "end" reflects the size
867  * requested.
868  */
869 int pcmcia_request_window(struct pcmcia_device *p_dev, struct resource *res,
870                         unsigned int speed)
871 {
872         struct pcmcia_socket *s = p_dev->socket;
873         pccard_mem_map *win;
874         u_long align;
875         int w;
876
877         if (!(s->state & SOCKET_PRESENT)) {
878                 dev_dbg(&p_dev->dev, "No card present\n");
879                 return -ENODEV;
880         }
881
882         /* Window size defaults to smallest available */
883         if (res->end == 0)
884                 res->end = s->map_size;
885         align = (s->features & SS_CAP_MEM_ALIGN) ? res->end : s->map_size;
886         if (res->end & (s->map_size-1)) {
887                 dev_dbg(&p_dev->dev, "invalid map size\n");
888                 return -EINVAL;
889         }
890         if ((res->start && (s->features & SS_CAP_STATIC_MAP)) ||
891             (res->start & (align-1))) {
892                 dev_dbg(&p_dev->dev, "invalid base address\n");
893                 return -EINVAL;
894         }
895         if (res->start)
896                 align = 0;
897
898         /* Allocate system memory window */
899         mutex_lock(&s->ops_mutex);
900         for (w = 0; w < MAX_WIN; w++)
901                 if (!(s->state & SOCKET_WIN_REQ(w)))
902                         break;
903         if (w == MAX_WIN) {
904                 dev_dbg(&p_dev->dev, "all windows are used already\n");
905                 mutex_unlock(&s->ops_mutex);
906                 return -EINVAL;
907         }
908
909         win = &s->win[w];
910
911         if (!(s->features & SS_CAP_STATIC_MAP)) {
912                 win->res = pcmcia_find_mem_region(res->start, res->end, align,
913                                                 0, s);
914                 if (!win->res) {
915                         dev_dbg(&p_dev->dev, "allocating mem region failed\n");
916                         mutex_unlock(&s->ops_mutex);
917                         return -EINVAL;
918                 }
919         }
920         p_dev->_win |= CLIENT_WIN_REQ(w);
921
922         /* Configure the socket controller */
923         win->map = w+1;
924         win->flags = res->flags & WIN_FLAGS_MAP;
925         win->speed = speed;
926         win->card_start = 0;
927
928         if (s->ops->set_mem_map(s, win) != 0) {
929                 dev_dbg(&p_dev->dev, "failed to set memory mapping\n");
930                 mutex_unlock(&s->ops_mutex);
931                 return -EIO;
932         }
933         s->state |= SOCKET_WIN_REQ(w);
934
935         /* Return window handle */
936         if (s->features & SS_CAP_STATIC_MAP)
937                 res->start = win->static_start;
938         else
939                 res->start = win->res->start;
940
941         /* convert to new-style resources */
942         res->end += res->start - 1;
943         res->flags &= ~WIN_FLAGS_REQ;
944         res->flags |= (win->map << 2) | IORESOURCE_MEM;
945         res->parent = win->res;
946         if (win->res)
947                 request_resource(&iomem_resource, res);
948
949         dev_dbg(&p_dev->dev, "request_window results in %pR\n", res);
950
951         mutex_unlock(&s->ops_mutex);
952
953         return 0;
954 } /* pcmcia_request_window */
955 EXPORT_SYMBOL(pcmcia_request_window);
956
957
958 /**
959  * pcmcia_disable_device() - disable and clean up a PCMCIA device
960  * @p_dev: the associated PCMCIA device
961  *
962  * pcmcia_disable_device() is the driver-callable counterpart to
963  * pcmcia_enable_device(): If a PCMCIA device is no longer used,
964  * drivers are expected to clean up and disable the device by calling
965  * this function. Any I/O ranges (iomem and ioports) will be released,
966  * the Vpp voltage will be set to 0, and IRQs will no longer be
967  * generated -- at least if there is no other card function (of
968  * multifunction devices) being used.
969  */
970 void pcmcia_disable_device(struct pcmcia_device *p_dev)
971 {
972         int i;
973         for (i = 0; i < MAX_WIN; i++) {
974                 struct resource *res = p_dev->resource[MAX_IO_WIN + i];
975                 if (res->flags & WIN_FLAGS_REQ)
976                         pcmcia_release_window(p_dev, res);
977         }
978
979         pcmcia_release_configuration(p_dev);
980         pcmcia_release_io(p_dev);
981         if (p_dev->_irq) {
982                 free_irq(p_dev->irq, p_dev->priv);
983                 p_dev->_irq = 0;
984         }
985 }
986 EXPORT_SYMBOL(pcmcia_disable_device);