Merge git://git.kernel.org/pub/scm/linux/kernel/git/brodo/pcmcia-2.6
[linux-2.6.git] / drivers / staging / comedi / drivers / das08_cs.c
1 /*
2     comedi/drivers/das08_cs.c
3     DAS08 driver
4
5     COMEDI - Linux Control and Measurement Device Interface
6     Copyright (C) 2000 David A. Schleef <ds@schleef.org>
7     Copyright (C) 2001,2002,2003 Frank Mori Hess <fmhess@users.sourceforge.net>
8
9     This program is free software; you can redistribute it and/or modify
10     it under the terms of the GNU General Public License as published by
11     the Free Software Foundation; either version 2 of the License, or
12     (at your option) any later version.
13
14     This program is distributed in the hope that it will be useful,
15     but WITHOUT ANY WARRANTY; without even the implied warranty of
16     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
17     GNU General Public License for more details.
18
19     You should have received a copy of the GNU General Public License
20     along with this program; if not, write to the Free Software
21     Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
22
23 *****************************************************************
24
25 */
26 /*
27 Driver: das08_cs
28 Description: DAS-08 PCMCIA boards
29 Author: Warren Jasper, ds, Frank Hess
30 Devices: [ComputerBoards] PCM-DAS08 (pcm-das08)
31 Status: works
32
33 This is the PCMCIA-specific support split off from the
34 das08 driver.
35
36 Options (for pcm-das08):
37         NONE
38
39 Command support does not exist, but could be added for this board.
40 */
41
42 #include "../comedidev.h"
43
44 #include <linux/delay.h>
45 #include <linux/pci.h>
46 #include <linux/slab.h>
47
48 #include "das08.h"
49
50 /* pcmcia includes */
51 #include <pcmcia/cs.h>
52 #include <pcmcia/cistpl.h>
53 #include <pcmcia/ds.h>
54
55 static struct pcmcia_device *cur_dev;
56
57 #define thisboard ((const struct das08_board_struct *)dev->board_ptr)
58
59 static int das08_cs_attach(struct comedi_device *dev,
60                            struct comedi_devconfig *it);
61
62 static struct comedi_driver driver_das08_cs = {
63         .driver_name = "das08_cs",
64         .module = THIS_MODULE,
65         .attach = das08_cs_attach,
66         .detach = das08_common_detach,
67         .board_name = &das08_cs_boards[0].name,
68         .num_names = ARRAY_SIZE(das08_cs_boards),
69         .offset = sizeof(struct das08_board_struct),
70 };
71
72 static int das08_cs_attach(struct comedi_device *dev,
73                            struct comedi_devconfig *it)
74 {
75         int ret;
76         unsigned long iobase;
77         struct pcmcia_device *link = cur_dev;   /*  XXX hack */
78
79         ret = alloc_private(dev, sizeof(struct das08_private_struct));
80         if (ret < 0)
81                 return ret;
82
83         printk("comedi%d: das08_cs: ", dev->minor);
84         /*  deal with a pci board */
85
86         if (thisboard->bustype == pcmcia) {
87                 if (link == NULL) {
88                         printk(" no pcmcia cards found\n");
89                         return -EIO;
90                 }
91                 iobase = link->resource[0]->start;
92         } else {
93                 printk(" bug! board does not have PCMCIA bustype\n");
94                 return -EINVAL;
95         }
96
97         printk("\n");
98
99         return das08_common_attach(dev, iobase);
100 }
101
102 /*======================================================================
103
104     The following pcmcia code for the pcm-das08 is adapted from the
105     dummy_cs.c driver of the Linux PCMCIA Card Services package.
106
107     The initial developer of the original code is David A. Hinds
108     <dahinds@users.sourceforge.net>.  Portions created by David A. Hinds
109     are Copyright (C) 1999 David A. Hinds.  All Rights Reserved.
110
111 ======================================================================*/
112
113 static void das08_pcmcia_config(struct pcmcia_device *link);
114 static void das08_pcmcia_release(struct pcmcia_device *link);
115 static int das08_pcmcia_suspend(struct pcmcia_device *p_dev);
116 static int das08_pcmcia_resume(struct pcmcia_device *p_dev);
117
118 /*
119    The attach() and detach() entry points are used to create and destroy
120    "instances" of the driver, where each instance represents everything
121    needed to manage one actual PCMCIA card.
122 */
123
124 static int das08_pcmcia_attach(struct pcmcia_device *);
125 static void das08_pcmcia_detach(struct pcmcia_device *);
126
127 /*
128    You'll also need to prototype all the functions that will actually
129    be used to talk to your device.  See 'memory_cs' for a good example
130    of a fully self-sufficient driver; the other drivers rely more or
131    less on other parts of the kernel.
132 */
133
134 struct local_info_t {
135         struct pcmcia_device *link;
136         int stop;
137         struct bus_operations *bus;
138 };
139
140 /*======================================================================
141
142     das08_pcmcia_attach() creates an "instance" of the driver, allocating
143     local data structures for one device.  The device is registered
144     with Card Services.
145
146     The dev_link structure is initialized, but we don't actually
147     configure the card at this point -- we wait until we receive a
148     card insertion event.
149
150 ======================================================================*/
151
152 static int das08_pcmcia_attach(struct pcmcia_device *link)
153 {
154         struct local_info_t *local;
155
156         dev_dbg(&link->dev, "das08_pcmcia_attach()\n");
157
158         /* Allocate space for private device-specific data */
159         local = kzalloc(sizeof(struct local_info_t), GFP_KERNEL);
160         if (!local)
161                 return -ENOMEM;
162         local->link = link;
163         link->priv = local;
164
165         /*
166            General socket configuration defaults can go here.  In this
167            client, we assume very little, and rely on the CIS for almost
168            everything.  In most clients, many details (i.e., number, sizes,
169            and attributes of IO windows) are fixed by the nature of the
170            device, and can be hard-wired here.
171          */
172         link->conf.Attributes = 0;
173         link->conf.IntType = INT_MEMORY_AND_IO;
174
175         cur_dev = link;
176
177         das08_pcmcia_config(link);
178
179         return 0;
180 }                               /* das08_pcmcia_attach */
181
182 /*======================================================================
183
184     This deletes a driver "instance".  The device is de-registered
185     with Card Services.  If it has been released, all local data
186     structures are freed.  Otherwise, the structures will be freed
187     when the device is released.
188
189 ======================================================================*/
190
191 static void das08_pcmcia_detach(struct pcmcia_device *link)
192 {
193
194         dev_dbg(&link->dev, "das08_pcmcia_detach\n");
195
196         ((struct local_info_t *)link->priv)->stop = 1;
197         das08_pcmcia_release(link);
198
199         /* This points to the parent struct local_info_t struct */
200         kfree(link->priv);
201
202 }                               /* das08_pcmcia_detach */
203
204
205 static int das08_pcmcia_config_loop(struct pcmcia_device *p_dev,
206                                 cistpl_cftable_entry_t *cfg,
207                                 cistpl_cftable_entry_t *dflt,
208                                 unsigned int vcc,
209                                 void *priv_data)
210 {
211         if (cfg->index == 0)
212                 return -ENODEV;
213
214         /* Do we need to allocate an interrupt? */
215         p_dev->conf.Attributes |= CONF_ENABLE_IRQ;
216
217         /* IO window settings */
218         p_dev->resource[0]->end = p_dev->resource[1]->end = 0;
219         if ((cfg->io.nwin > 0) || (dflt->io.nwin > 0)) {
220                 cistpl_io_t *io = (cfg->io.nwin) ? &cfg->io : &dflt->io;
221                 p_dev->io_lines = io->flags & CISTPL_IO_LINES_MASK;
222                 p_dev->resource[0]->flags &= ~IO_DATA_PATH_WIDTH;
223                 p_dev->resource[0]->flags |=
224                         pcmcia_io_cfg_data_width(io->flags);
225                 p_dev->io.IOAddrLines = io->flags & CISTPL_IO_LINES_MASK;
226                 p_dev->resource[0]->start = io->win[0].base;
227                 p_dev->resource[0]->end = io->win[0].len;
228                 if (io->nwin > 1) {
229                         p_dev->resource[1]->flags = p_dev->resource[0]->flags;
230                         p_dev->resource[1]->start = io->win[1].base;
231                         p_dev->resource[1]->end = io->win[1].len;
232                 }
233                 /* This reserves IO space but doesn't actually enable it */
234                 return pcmcia_request_io(p_dev);
235         }
236         return 0;
237 }
238
239
240 /*======================================================================
241
242     das08_pcmcia_config() is scheduled to run after a CARD_INSERTION event
243     is received, to configure the PCMCIA socket, and to make the
244     device available to the system.
245
246 ======================================================================*/
247
248 static void das08_pcmcia_config(struct pcmcia_device *link)
249 {
250         int ret;
251
252         dev_dbg(&link->dev, "das08_pcmcia_config\n");
253
254         ret = pcmcia_loop_config(link, das08_pcmcia_config_loop, NULL);
255         if (ret) {
256                 dev_warn(&link->dev, "no configuration found\n");
257                 goto failed;
258         }
259
260         if (!link->irq)
261                 goto failed;
262
263         /*
264            This actually configures the PCMCIA socket -- setting up
265            the I/O windows and the interrupt mapping, and putting the
266            card and host interface into "Memory and IO" mode.
267          */
268         ret = pcmcia_request_configuration(link, &link->conf);
269         if (ret)
270                 goto failed;
271
272         /* Finally, report what we've done */
273         dev_info(&link->dev, "index 0x%02x", link->conf.ConfigIndex);
274         if (link->conf.Attributes & CONF_ENABLE_IRQ)
275                 printk(", irq %u", link->irq);
276         if (link->resource[0])
277                 printk(", io %pR", link->resource[0]);
278         if (link->resource[1])
279                 printk(" & %pR", link->resource[1]);
280         printk("\n");
281
282         return;
283
284 failed:
285         das08_pcmcia_release(link);
286
287 }                               /* das08_pcmcia_config */
288
289 /*======================================================================
290
291     After a card is removed, das08_pcmcia_release() will unregister the
292     device, and release the PCMCIA configuration.  If the device is
293     still open, this will be postponed until it is closed.
294
295 ======================================================================*/
296
297 static void das08_pcmcia_release(struct pcmcia_device *link)
298 {
299         dev_dbg(&link->dev, "das08_pcmcia_release\n");
300         pcmcia_disable_device(link);
301 }                               /* das08_pcmcia_release */
302
303 /*======================================================================
304
305     The card status event handler.  Mostly, this schedules other
306     stuff to run after an event is received.
307
308     When a CARD_REMOVAL event is received, we immediately set a
309     private flag to block future accesses to this device.  All the
310     functions that actually access the device should check this flag
311     to make sure the card is still present.
312
313 ======================================================================*/
314
315 static int das08_pcmcia_suspend(struct pcmcia_device *link)
316 {
317         struct local_info_t *local = link->priv;
318         /* Mark the device as stopped, to block IO until later */
319         local->stop = 1;
320
321         return 0;
322 }                               /* das08_pcmcia_suspend */
323
324 static int das08_pcmcia_resume(struct pcmcia_device *link)
325 {
326         struct local_info_t *local = link->priv;
327
328         local->stop = 0;
329         return 0;
330 }                               /* das08_pcmcia_resume */
331
332 /*====================================================================*/
333
334 static struct pcmcia_device_id das08_cs_id_table[] = {
335         PCMCIA_DEVICE_MANF_CARD(0x01c5, 0x4001),
336         PCMCIA_DEVICE_NULL
337 };
338
339 MODULE_DEVICE_TABLE(pcmcia, das08_cs_id_table);
340 MODULE_AUTHOR("David A. Schleef <ds@schleef.org>, "
341               "Frank Mori Hess <fmhess@users.sourceforge.net>");
342 MODULE_DESCRIPTION("Comedi driver for ComputerBoards DAS-08 PCMCIA boards");
343 MODULE_LICENSE("GPL");
344
345 struct pcmcia_driver das08_cs_driver = {
346         .probe = das08_pcmcia_attach,
347         .remove = das08_pcmcia_detach,
348         .suspend = das08_pcmcia_suspend,
349         .resume = das08_pcmcia_resume,
350         .id_table = das08_cs_id_table,
351         .owner = THIS_MODULE,
352         .drv = {
353                 .name = "pcm-das08",
354                 },
355 };
356
357 static int __init init_das08_pcmcia_cs(void)
358 {
359         pcmcia_register_driver(&das08_cs_driver);
360         return 0;
361 }
362
363 static void __exit exit_das08_pcmcia_cs(void)
364 {
365         pr_debug("das08_pcmcia_cs: unloading\n");
366         pcmcia_unregister_driver(&das08_cs_driver);
367 }
368
369 static int __init das08_cs_init_module(void)
370 {
371         int ret;
372
373         ret = init_das08_pcmcia_cs();
374         if (ret < 0)
375                 return ret;
376
377         return comedi_driver_register(&driver_das08_cs);
378 }
379
380 static void __exit das08_cs_exit_module(void)
381 {
382         exit_das08_pcmcia_cs();
383         comedi_driver_unregister(&driver_das08_cs);
384 }
385
386 module_init(das08_cs_init_module);
387 module_exit(das08_cs_exit_module);