das08_cs.c revision 1cc745d1cdca8086b472a06671f0830fc0e98861 
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/*
27Driver: das08_cs
28Description: DAS-08 PCMCIA boards
29Author: Warren Jasper, ds, Frank Hess
30Devices: [ComputerBoards] PCM-DAS08 (pcm-das08)
31Status: works
32
33This is the PCMCIA-specific support split off from the
34das08 driver.
35
36Options (for pcm-das08):
37	NONE
38
39Command 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/cistpl.h>
52#include <pcmcia/ds.h>
53
54static struct pcmcia_device *cur_dev;
55
56#define thisboard ((const struct das08_board_struct *)dev->board_ptr)
57
58static int das08_cs_attach(struct comedi_device *dev,
59			   struct comedi_devconfig *it);
60
61static struct comedi_driver driver_das08_cs = {
62	.driver_name = "das08_cs",
63	.module = THIS_MODULE,
64	.attach = das08_cs_attach,
65	.detach = das08_common_detach,
66	.board_name = &das08_cs_boards[0].name,
67	.num_names = ARRAY_SIZE(das08_cs_boards),
68	.offset = sizeof(struct das08_board_struct),
69};
70
71static int das08_cs_attach(struct comedi_device *dev,
72			   struct comedi_devconfig *it)
73{
74	int ret;
75	unsigned long iobase;
76	struct pcmcia_device *link = cur_dev;	/*  XXX hack */
77
78	ret = alloc_private(dev, sizeof(struct das08_private_struct));
79	if (ret < 0)
80		return ret;
81
82	printk("comedi%d: das08_cs: ", dev->minor);
83	/*  deal with a pci board */
84
85	if (thisboard->bustype == pcmcia) {
86		if (link == NULL) {
87			printk(" no pcmcia cards found\n");
88			return -EIO;
89		}
90		iobase = link->resource[0]->start;
91	} else {
92		printk(" bug! board does not have PCMCIA bustype\n");
93		return -EINVAL;
94	}
95
96	printk("\n");
97
98	return das08_common_attach(dev, iobase);
99}
100
101/*======================================================================
102
103    The following pcmcia code for the pcm-das08 is adapted from the
104    dummy_cs.c driver of the Linux PCMCIA Card Services package.
105
106    The initial developer of the original code is David A. Hinds
107    <dahinds@users.sourceforge.net>.  Portions created by David A. Hinds
108    are Copyright (C) 1999 David A. Hinds.  All Rights Reserved.
109
110======================================================================*/
111
112static void das08_pcmcia_config(struct pcmcia_device *link);
113static void das08_pcmcia_release(struct pcmcia_device *link);
114static int das08_pcmcia_suspend(struct pcmcia_device *p_dev);
115static int das08_pcmcia_resume(struct pcmcia_device *p_dev);
116
117/*
118   The attach() and detach() entry points are used to create and destroy
119   "instances" of the driver, where each instance represents everything
120   needed to manage one actual PCMCIA card.
121*/
122
123static int das08_pcmcia_attach(struct pcmcia_device *);
124static void das08_pcmcia_detach(struct pcmcia_device *);
125
126/*
127   You'll also need to prototype all the functions that will actually
128   be used to talk to your device.  See 'memory_cs' for a good example
129   of a fully self-sufficient driver; the other drivers rely more or
130   less on other parts of the kernel.
131*/
132
133struct local_info_t {
134	struct pcmcia_device *link;
135	int stop;
136	struct bus_operations *bus;
137};
138
139/*======================================================================
140
141    das08_pcmcia_attach() creates an "instance" of the driver, allocating
142    local data structures for one device.  The device is registered
143    with Card Services.
144
145    The dev_link structure is initialized, but we don't actually
146    configure the card at this point -- we wait until we receive a
147    card insertion event.
148
149======================================================================*/
150
151static int das08_pcmcia_attach(struct pcmcia_device *link)
152{
153	struct local_info_t *local;
154
155	dev_dbg(&link->dev, "das08_pcmcia_attach()\n");
156
157	/* Allocate space for private device-specific data */
158	local = kzalloc(sizeof(struct local_info_t), GFP_KERNEL);
159	if (!local)
160		return -ENOMEM;
161	local->link = link;
162	link->priv = local;
163
164	cur_dev = link;
165
166	das08_pcmcia_config(link);
167
168	return 0;
169}				/* das08_pcmcia_attach */
170
171/*======================================================================
172
173    This deletes a driver "instance".  The device is de-registered
174    with Card Services.  If it has been released, all local data
175    structures are freed.  Otherwise, the structures will be freed
176    when the device is released.
177
178======================================================================*/
179
180static void das08_pcmcia_detach(struct pcmcia_device *link)
181{
182
183	dev_dbg(&link->dev, "das08_pcmcia_detach\n");
184
185	((struct local_info_t *)link->priv)->stop = 1;
186	das08_pcmcia_release(link);
187
188	/* This points to the parent struct local_info_t struct */
189	kfree(link->priv);
190
191}				/* das08_pcmcia_detach */
192
193
194static int das08_pcmcia_config_loop(struct pcmcia_device *p_dev,
195				void *priv_data)
196{
197	if (p_dev->config_index == 0)
198		return -EINVAL;
199
200	return pcmcia_request_io(p_dev);
201}
202
203
204/*======================================================================
205
206    das08_pcmcia_config() is scheduled to run after a CARD_INSERTION event
207    is received, to configure the PCMCIA socket, and to make the
208    device available to the system.
209
210======================================================================*/
211
212static void das08_pcmcia_config(struct pcmcia_device *link)
213{
214	int ret;
215
216	dev_dbg(&link->dev, "das08_pcmcia_config\n");
217
218	link->config_flags |= CONF_ENABLE_IRQ | CONF_AUTO_SET_IO;
219
220	ret = pcmcia_loop_config(link, das08_pcmcia_config_loop, NULL);
221	if (ret) {
222		dev_warn(&link->dev, "no configuration found\n");
223		goto failed;
224	}
225
226	if (!link->irq)
227		goto failed;
228
229	/*
230	   This actually configures the PCMCIA socket -- setting up
231	   the I/O windows and the interrupt mapping, and putting the
232	   card and host interface into "Memory and IO" mode.
233	 */
234	ret = pcmcia_enable_device(link);
235	if (ret)
236		goto failed;
237
238	return;
239
240failed:
241	das08_pcmcia_release(link);
242
243}				/* das08_pcmcia_config */
244
245/*======================================================================
246
247    After a card is removed, das08_pcmcia_release() will unregister the
248    device, and release the PCMCIA configuration.  If the device is
249    still open, this will be postponed until it is closed.
250
251======================================================================*/
252
253static void das08_pcmcia_release(struct pcmcia_device *link)
254{
255	dev_dbg(&link->dev, "das08_pcmcia_release\n");
256	pcmcia_disable_device(link);
257}				/* das08_pcmcia_release */
258
259/*======================================================================
260
261    The card status event handler.  Mostly, this schedules other
262    stuff to run after an event is received.
263
264    When a CARD_REMOVAL event is received, we immediately set a
265    private flag to block future accesses to this device.  All the
266    functions that actually access the device should check this flag
267    to make sure the card is still present.
268
269======================================================================*/
270
271static int das08_pcmcia_suspend(struct pcmcia_device *link)
272{
273	struct local_info_t *local = link->priv;
274	/* Mark the device as stopped, to block IO until later */
275	local->stop = 1;
276
277	return 0;
278}				/* das08_pcmcia_suspend */
279
280static int das08_pcmcia_resume(struct pcmcia_device *link)
281{
282	struct local_info_t *local = link->priv;
283
284	local->stop = 0;
285	return 0;
286}				/* das08_pcmcia_resume */
287
288/*====================================================================*/
289
290static struct pcmcia_device_id das08_cs_id_table[] = {
291	PCMCIA_DEVICE_MANF_CARD(0x01c5, 0x4001),
292	PCMCIA_DEVICE_NULL
293};
294
295MODULE_DEVICE_TABLE(pcmcia, das08_cs_id_table);
296MODULE_AUTHOR("David A. Schleef <ds@schleef.org>, "
297	      "Frank Mori Hess <fmhess@users.sourceforge.net>");
298MODULE_DESCRIPTION("Comedi driver for ComputerBoards DAS-08 PCMCIA boards");
299MODULE_LICENSE("GPL");
300
301struct pcmcia_driver das08_cs_driver = {
302	.probe = das08_pcmcia_attach,
303	.remove = das08_pcmcia_detach,
304	.suspend = das08_pcmcia_suspend,
305	.resume = das08_pcmcia_resume,
306	.id_table = das08_cs_id_table,
307	.owner = THIS_MODULE,
308	.drv = {
309		.name = "pcm-das08",
310		},
311};
312
313static int __init init_das08_pcmcia_cs(void)
314{
315	pcmcia_register_driver(&das08_cs_driver);
316	return 0;
317}
318
319static void __exit exit_das08_pcmcia_cs(void)
320{
321	pr_debug("das08_pcmcia_cs: unloading\n");
322	pcmcia_unregister_driver(&das08_cs_driver);
323}
324
325static int __init das08_cs_init_module(void)
326{
327	int ret;
328
329	ret = init_das08_pcmcia_cs();
330	if (ret < 0)
331		return ret;
332
333	return comedi_driver_register(&driver_das08_cs);
334}
335
336static void __exit das08_cs_exit_module(void)
337{
338	exit_das08_pcmcia_cs();
339	comedi_driver_unregister(&driver_das08_cs);
340}
341
342module_init(das08_cs_init_module);
343module_exit(das08_cs_exit_module);
344