Root/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 */
37static int io_speed;
38module_param(io_speed, int, 0444);
39
40
41int 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
49struct 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 */
64static 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 */
100static 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 */
159static 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 isn'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 */
197int 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}
201EXPORT_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 */
210int 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}
214EXPORT_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 */
227int 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}
246EXPORT_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 */
257int 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    }
290unlock:
291    mutex_unlock(&s->ops_mutex);
292
293    return ret;
294}
295EXPORT_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 */
307int 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
331unlock:
332    mutex_unlock(&s->ops_mutex);
333
334    return ret;
335}
336EXPORT_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 */
350int 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 */
397static 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
417out:
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 */
432int 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 */
472EXPORT_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 */
484int 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 || flags & CONF_ENABLE_IRQ)
518        flags |= CONF_ENABLE_IOCARD;
519    if (flags & CONF_ENABLE_IOCARD)
520        s->socket.flags |= SS_IOCARD;
521    if (flags & CONF_ENABLE_ZVCARD)
522        s->socket.flags |= SS_ZVCARD | SS_IOCARD;
523    if (flags & CONF_ENABLE_SPKR) {
524        s->socket.flags |= SS_SPKR_ENA;
525        status = CCSR_AUDIO_ENA;
526        if (!(p_dev->config_regs & PRESENT_STATUS))
527            dev_warn(&p_dev->dev, "speaker requested, but "
528                          "PRESENT_STATUS not set!\n");
529    }
530    if (flags & CONF_ENABLE_IRQ)
531        s->socket.io_irq = s->pcmcia_irq;
532    else
533        s->socket.io_irq = 0;
534    if (flags & CONF_ENABLE_ESR) {
535        p_dev->config_regs |= PRESENT_EXT_STATUS;
536        ext_status = ESR_REQ_ATTN_ENA;
537    }
538    s->ops->set_socket(s, &s->socket);
539    s->lock_count++;
540
541    dev_dbg(&p_dev->dev,
542        "enable_device: V %d, flags %x, base %x, regs %x, idx %x\n",
543        p_dev->vpp, flags, p_dev->config_base, p_dev->config_regs,
544        p_dev->config_index);
545
546    /* Set up CIS configuration registers */
547    base = p_dev->config_base;
548    if (p_dev->config_regs & PRESENT_COPY) {
549        u16 tmp = 0;
550        dev_dbg(&p_dev->dev, "clearing CISREG_SCR\n");
551        pcmcia_write_cis_mem(s, 1, (base + CISREG_SCR)>>1, 1, &tmp);
552    }
553    if (p_dev->config_regs & PRESENT_PIN_REPLACE) {
554        u16 tmp = 0;
555        dev_dbg(&p_dev->dev, "clearing CISREG_PRR\n");
556        pcmcia_write_cis_mem(s, 1, (base + CISREG_PRR)>>1, 1, &tmp);
557    }
558    if (p_dev->config_regs & PRESENT_OPTION) {
559        if (s->functions == 1) {
560            option = p_dev->config_index & COR_CONFIG_MASK;
561        } else {
562            option = p_dev->config_index & COR_MFC_CONFIG_MASK;
563            option |= COR_FUNC_ENA|COR_IREQ_ENA;
564            if (p_dev->config_regs & PRESENT_IOBASE_0)
565                option |= COR_ADDR_DECODE;
566        }
567        if ((flags & CONF_ENABLE_IRQ) &&
568            !(flags & CONF_ENABLE_PULSE_IRQ))
569            option |= COR_LEVEL_REQ;
570        pcmcia_write_cis_mem(s, 1, (base + CISREG_COR)>>1, 1, &option);
571        mdelay(40);
572    }
573    if (p_dev->config_regs & PRESENT_STATUS)
574        pcmcia_write_cis_mem(s, 1, (base + CISREG_CCSR)>>1, 1, &status);
575
576    if (p_dev->config_regs & PRESENT_EXT_STATUS)
577        pcmcia_write_cis_mem(s, 1, (base + CISREG_ESR)>>1, 1,
578                    &ext_status);
579
580    if (p_dev->config_regs & PRESENT_IOBASE_0) {
581        u8 b = c->io[0].start & 0xff;
582        pcmcia_write_cis_mem(s, 1, (base + CISREG_IOBASE_0)>>1, 1, &b);
583        b = (c->io[0].start >> 8) & 0xff;
584        pcmcia_write_cis_mem(s, 1, (base + CISREG_IOBASE_1)>>1, 1, &b);
585    }
586    if (p_dev->config_regs & PRESENT_IOSIZE) {
587        u8 b = resource_size(&c->io[0]) + resource_size(&c->io[1]) - 1;
588        pcmcia_write_cis_mem(s, 1, (base + CISREG_IOSIZE)>>1, 1, &b);
589    }
590
591    /* Configure I/O windows */
592    if (c->state & CONFIG_IO_REQ) {
593        iomap.speed = io_speed;
594        for (i = 0; i < MAX_IO_WIN; i++)
595            if (s->io[i].res) {
596                iomap.map = i;
597                iomap.flags = MAP_ACTIVE;
598                switch (s->io[i].res->flags & IO_DATA_PATH_WIDTH) {
599                case IO_DATA_PATH_WIDTH_16:
600                    iomap.flags |= MAP_16BIT; break;
601                case IO_DATA_PATH_WIDTH_AUTO:
602                    iomap.flags |= MAP_AUTOSZ; break;
603                default:
604                    break;
605                }
606                iomap.start = s->io[i].res->start;
607                iomap.stop = s->io[i].res->end;
608                s->ops->set_io_map(s, &iomap);
609                s->io[i].Config++;
610            }
611    }
612
613    c->state |= CONFIG_LOCKED;
614    p_dev->_locked = 1;
615    mutex_unlock(&s->ops_mutex);
616    return 0;
617} /* pcmcia_enable_device */
618EXPORT_SYMBOL(pcmcia_enable_device);
619
620
621/**
622 * pcmcia_request_io() - attempt to reserve port ranges for PCMCIA devices
623 * @p_dev: the associated PCMCIA device
624 *
625 * pcmcia_request_io() attempts to reserve the IO port ranges specified in
626 * &struct pcmcia_device @p_dev->resource[0] and @p_dev->resource[1]. The
627 * "start" value is the requested start of the IO port resource; "end"
628 * reflects the number of ports requested. The number of IO lines requested
629 * is specified in &struct pcmcia_device @p_dev->io_lines.
630 */
631int pcmcia_request_io(struct pcmcia_device *p_dev)
632{
633    struct pcmcia_socket *s = p_dev->socket;
634    config_t *c = p_dev->function_config;
635    int ret = -EINVAL;
636
637    mutex_lock(&s->ops_mutex);
638    dev_dbg(&p_dev->dev, "pcmcia_request_io: %pR , %pR",
639        &c->io[0], &c->io[1]);
640
641    if (!(s->state & SOCKET_PRESENT)) {
642        dev_dbg(&p_dev->dev, "pcmcia_request_io: No card present\n");
643        goto out;
644    }
645
646    if (c->state & CONFIG_LOCKED) {
647        dev_dbg(&p_dev->dev, "Configuration is locked\n");
648        goto out;
649    }
650    if (c->state & CONFIG_IO_REQ) {
651        dev_dbg(&p_dev->dev, "IO already configured\n");
652        goto out;
653    }
654
655    ret = alloc_io_space(s, &c->io[0], p_dev->io_lines);
656    if (ret)
657        goto out;
658
659    if (c->io[1].end) {
660        ret = alloc_io_space(s, &c->io[1], p_dev->io_lines);
661        if (ret) {
662            struct resource tmp = c->io[0];
663            /* release the previously allocated resource */
664            release_io_space(s, &c->io[0]);
665            /* but preserve the settings, for they worked... */
666            c->io[0].end = resource_size(&tmp);
667            c->io[0].start = tmp.start;
668            c->io[0].flags = tmp.flags;
669            goto out;
670        }
671    } else
672        c->io[1].start = 0;
673
674    c->state |= CONFIG_IO_REQ;
675    p_dev->_io = 1;
676
677    dev_dbg(&p_dev->dev, "pcmcia_request_io succeeded: %pR , %pR",
678        &c->io[0], &c->io[1]);
679out:
680    mutex_unlock(&s->ops_mutex);
681
682    return ret;
683} /* pcmcia_request_io */
684EXPORT_SYMBOL(pcmcia_request_io);
685
686
687/**
688 * pcmcia_request_irq() - attempt to request a IRQ for a PCMCIA device
689 * @p_dev: the associated PCMCIA device
690 * @handler: IRQ handler to register
691 *
692 * pcmcia_request_irq() is a wrapper around request_irq() which allows
693 * the PCMCIA core to clean up the registration in pcmcia_disable_device().
694 * Drivers are free to use request_irq() directly, but then they need to
695 * call free_irq() themselfves, too. Also, only %IRQF_SHARED capable IRQ
696 * handlers are allowed.
697 */
698int __must_check pcmcia_request_irq(struct pcmcia_device *p_dev,
699                    irq_handler_t handler)
700{
701    int ret;
702
703    if (!p_dev->irq)
704        return -EINVAL;
705
706    ret = request_irq(p_dev->irq, handler, IRQF_SHARED,
707            p_dev->devname, p_dev->priv);
708    if (!ret)
709        p_dev->_irq = 1;
710
711    return ret;
712}
713EXPORT_SYMBOL(pcmcia_request_irq);
714
715
716/**
717 * pcmcia_request_exclusive_irq() - attempt to request an exclusive IRQ first
718 * @p_dev: the associated PCMCIA device
719 * @handler: IRQ handler to register
720 *
721 * pcmcia_request_exclusive_irq() is a wrapper around request_irq() which
722 * attempts first to request an exclusive IRQ. If it fails, it also accepts
723 * a shared IRQ, but prints out a warning. PCMCIA drivers should allow for
724 * IRQ sharing and either use request_irq directly (then they need to call
725 * free_irq() themselves, too), or the pcmcia_request_irq() function.
726 */
727int __must_check
728__pcmcia_request_exclusive_irq(struct pcmcia_device *p_dev,
729            irq_handler_t handler)
730{
731    int ret;
732
733    if (!p_dev->irq)
734        return -EINVAL;
735
736    ret = request_irq(p_dev->irq, handler, 0, p_dev->devname, p_dev->priv);
737    if (ret) {
738        ret = pcmcia_request_irq(p_dev, handler);
739        dev_printk(KERN_WARNING, &p_dev->dev, "pcmcia: "
740            "request for exclusive IRQ could not be fulfilled.\n");
741        dev_printk(KERN_WARNING, &p_dev->dev, "pcmcia: the driver "
742            "needs updating to supported shared IRQ lines.\n");
743    }
744    if (ret)
745        dev_printk(KERN_INFO, &p_dev->dev, "request_irq() failed\n");
746    else
747        p_dev->_irq = 1;
748
749    return ret;
750} /* pcmcia_request_exclusive_irq */
751EXPORT_SYMBOL(__pcmcia_request_exclusive_irq);
752
753
754#ifdef CONFIG_PCMCIA_PROBE
755
756/* mask of IRQs already reserved by other cards, we should avoid using them */
757static u8 pcmcia_used_irq[32];
758
759static irqreturn_t test_action(int cpl, void *dev_id)
760{
761    return IRQ_NONE;
762}
763
764/**
765 * pcmcia_setup_isa_irq() - determine whether an ISA IRQ can be used
766 * @p_dev - the associated PCMCIA device
767 *
768 * locking note: must be called with ops_mutex locked.
769 */
770static int pcmcia_setup_isa_irq(struct pcmcia_device *p_dev, int type)
771{
772    struct pcmcia_socket *s = p_dev->socket;
773    unsigned int try, irq;
774    u32 mask = s->irq_mask;
775    int ret = -ENODEV;
776
777    for (try = 0; try < 64; try++) {
778        irq = try % 32;
779
780        if (irq > NR_IRQS)
781            continue;
782
783        /* marked as available by driver, not blocked by userspace? */
784        if (!((mask >> irq) & 1))
785            continue;
786
787        /* avoid an IRQ which is already used by another PCMCIA card */
788        if ((try < 32) && pcmcia_used_irq[irq])
789            continue;
790
791        /* register the correct driver, if possible, to check whether
792         * registering a dummy handle works, i.e. if the IRQ isn't
793         * marked as used by the kernel resource management core */
794        ret = request_irq(irq, test_action, type, p_dev->devname,
795                  p_dev);
796        if (!ret) {
797            free_irq(irq, p_dev);
798            p_dev->irq = s->pcmcia_irq = irq;
799            pcmcia_used_irq[irq]++;
800            break;
801        }
802    }
803
804    return ret;
805}
806
807void pcmcia_cleanup_irq(struct pcmcia_socket *s)
808{
809    pcmcia_used_irq[s->pcmcia_irq]--;
810    s->pcmcia_irq = 0;
811}
812
813#else /* CONFIG_PCMCIA_PROBE */
814
815static int pcmcia_setup_isa_irq(struct pcmcia_device *p_dev, int type)
816{
817    return -EINVAL;
818}
819
820void pcmcia_cleanup_irq(struct pcmcia_socket *s)
821{
822    s->pcmcia_irq = 0;
823    return;
824}
825
826#endif /* CONFIG_PCMCIA_PROBE */
827
828
829/**
830 * pcmcia_setup_irq() - determine IRQ to be used for device
831 * @p_dev - the associated PCMCIA device
832 *
833 * locking note: must be called with ops_mutex locked.
834 */
835int pcmcia_setup_irq(struct pcmcia_device *p_dev)
836{
837    struct pcmcia_socket *s = p_dev->socket;
838
839    if (p_dev->irq)
840        return 0;
841
842    /* already assigned? */
843    if (s->pcmcia_irq) {
844        p_dev->irq = s->pcmcia_irq;
845        return 0;
846    }
847
848    /* prefer an exclusive ISA irq */
849    if (!pcmcia_setup_isa_irq(p_dev, 0))
850        return 0;
851
852    /* but accept a shared ISA irq */
853    if (!pcmcia_setup_isa_irq(p_dev, IRQF_SHARED))
854        return 0;
855
856    /* but use the PCI irq otherwise */
857    if (s->pci_irq) {
858        p_dev->irq = s->pcmcia_irq = s->pci_irq;
859        return 0;
860    }
861
862    return -EINVAL;
863}
864
865
866/**
867 * pcmcia_request_window() - attempt to reserve iomem for PCMCIA devices
868 * @p_dev: the associated PCMCIA device
869 * @res: &struct resource pointing to p_dev->resource[2..5]
870 * @speed: access speed
871 *
872 * pcmcia_request_window() attepts to reserve an iomem ranges specified in
873 * &struct resource @res pointing to one of the entries in
874 * &struct pcmcia_device @p_dev->resource[2..5]. The "start" value is the
875 * requested start of the IO mem resource; "end" reflects the size
876 * requested.
877 */
878int pcmcia_request_window(struct pcmcia_device *p_dev, struct resource *res,
879            unsigned int speed)
880{
881    struct pcmcia_socket *s = p_dev->socket;
882    pccard_mem_map *win;
883    u_long align;
884    int w;
885
886    dev_dbg(&p_dev->dev, "request_window %pR %d\n", res, speed);
887
888    if (!(s->state & SOCKET_PRESENT)) {
889        dev_dbg(&p_dev->dev, "No card present\n");
890        return -ENODEV;
891    }
892
893    /* Window size defaults to smallest available */
894    if (res->end == 0)
895        res->end = s->map_size;
896    align = (s->features & SS_CAP_MEM_ALIGN) ? res->end : s->map_size;
897    if (res->end & (s->map_size-1)) {
898        dev_dbg(&p_dev->dev, "invalid map size\n");
899        return -EINVAL;
900    }
901    if ((res->start && (s->features & SS_CAP_STATIC_MAP)) ||
902        (res->start & (align-1))) {
903        dev_dbg(&p_dev->dev, "invalid base address\n");
904        return -EINVAL;
905    }
906    if (res->start)
907        align = 0;
908
909    /* Allocate system memory window */
910    mutex_lock(&s->ops_mutex);
911    for (w = 0; w < MAX_WIN; w++)
912        if (!(s->state & SOCKET_WIN_REQ(w)))
913            break;
914    if (w == MAX_WIN) {
915        dev_dbg(&p_dev->dev, "all windows are used already\n");
916        mutex_unlock(&s->ops_mutex);
917        return -EINVAL;
918    }
919
920    win = &s->win[w];
921
922    if (!(s->features & SS_CAP_STATIC_MAP)) {
923        win->res = pcmcia_find_mem_region(res->start, res->end, align,
924                        0, s);
925        if (!win->res) {
926            dev_dbg(&p_dev->dev, "allocating mem region failed\n");
927            mutex_unlock(&s->ops_mutex);
928            return -EINVAL;
929        }
930    }
931    p_dev->_win |= CLIENT_WIN_REQ(w);
932
933    /* Configure the socket controller */
934    win->map = w+1;
935    win->flags = res->flags & WIN_FLAGS_MAP;
936    win->speed = speed;
937    win->card_start = 0;
938
939    if (s->ops->set_mem_map(s, win) != 0) {
940        dev_dbg(&p_dev->dev, "failed to set memory mapping\n");
941        mutex_unlock(&s->ops_mutex);
942        return -EIO;
943    }
944    s->state |= SOCKET_WIN_REQ(w);
945
946    /* Return window handle */
947    if (s->features & SS_CAP_STATIC_MAP)
948        res->start = win->static_start;
949    else
950        res->start = win->res->start;
951
952    /* convert to new-style resources */
953    res->end += res->start - 1;
954    res->flags &= ~WIN_FLAGS_REQ;
955    res->flags |= (win->map << 2) | IORESOURCE_MEM;
956    res->parent = win->res;
957    if (win->res)
958        request_resource(&iomem_resource, res);
959
960    dev_dbg(&p_dev->dev, "request_window results in %pR\n", res);
961
962    mutex_unlock(&s->ops_mutex);
963
964    return 0;
965} /* pcmcia_request_window */
966EXPORT_SYMBOL(pcmcia_request_window);
967
968
969/**
970 * pcmcia_disable_device() - disable and clean up a PCMCIA device
971 * @p_dev: the associated PCMCIA device
972 *
973 * pcmcia_disable_device() is the driver-callable counterpart to
974 * pcmcia_enable_device(): If a PCMCIA device is no longer used,
975 * drivers are expected to clean up and disable the device by calling
976 * this function. Any I/O ranges (iomem and ioports) will be released,
977 * the Vpp voltage will be set to 0, and IRQs will no longer be
978 * generated -- at least if there is no other card function (of
979 * multifunction devices) being used.
980 */
981void pcmcia_disable_device(struct pcmcia_device *p_dev)
982{
983    int i;
984
985    dev_dbg(&p_dev->dev, "disabling device\n");
986
987    for (i = 0; i < MAX_WIN; i++) {
988        struct resource *res = p_dev->resource[MAX_IO_WIN + i];
989        if (res->flags & WIN_FLAGS_REQ)
990            pcmcia_release_window(p_dev, res);
991    }
992
993    pcmcia_release_configuration(p_dev);
994    pcmcia_release_io(p_dev);
995    if (p_dev->_irq) {
996        free_irq(p_dev->irq, p_dev->priv);
997        p_dev->_irq = 0;
998    }
999}
1000EXPORT_SYMBOL(pcmcia_disable_device);
1001

Archive Download this file

Branches:
ben-wpan
ben-wpan-stefan
javiroman/ks7010
jz-2.6.34
jz-2.6.34-rc5
jz-2.6.34-rc6
jz-2.6.34-rc7
jz-2.6.35
jz-2.6.36
jz-2.6.37
jz-2.6.38
jz-2.6.39
jz-3.0
jz-3.1
jz-3.11
jz-3.12
jz-3.13
jz-3.15
jz-3.16
jz-3.18-dt
jz-3.2
jz-3.3
jz-3.4
jz-3.5
jz-3.6
jz-3.6-rc2-pwm
jz-3.9
jz-3.9-clk
jz-3.9-rc8
jz47xx
jz47xx-2.6.38
master

Tags:
od-2011-09-04
od-2011-09-18
v2.6.34-rc5
v2.6.34-rc6
v2.6.34-rc7
v3.9



interactive