2 comedi/drivers/ni_daq_dio24.c
3 Driver for National Instruments PCMCIA DAQ-Card DIO-24
4 Copyright (C) 2002 Daniel Vecino Castel <dvecino@able.es>
6 PCMCIA crap at end of file is adapted from dummy_cs.c 1.31 2001/08/24 12:13:13
7 from the pcmcia package.
8 The initial developer of the pcmcia dummy_cs.c code is David A. Hinds
9 <dahinds@users.sourceforge.net>. Portions created by David A. Hinds
10 are Copyright (C) 1999 David A. Hinds. All Rights Reserved.
12 This program is free software; you can redistribute it and/or modify
13 it under the terms of the GNU General Public License as published by
14 the Free Software Foundation; either version 2 of the License, or
15 (at your option) any later version.
17 This program is distributed in the hope that it will be useful,
18 but WITHOUT ANY WARRANTY; without even the implied warranty of
19 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
20 GNU General Public License for more details.
22 You should have received a copy of the GNU General Public License
23 along with this program; if not, write to the Free Software
24 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
26 ************************************************************************
30 Description: National Instruments PCMCIA DAQ-Card DIO-24
31 Author: Daniel Vecino Castel <dvecino@able.es>
32 Devices: [National Instruments] PCMCIA DAQ-Card DIO-24 (ni_daq_dio24)
34 Updated: Thu, 07 Nov 2002 21:53:06 -0800
36 This is just a wrapper around the 8255.o driver to properly handle
40 /* #define LABPC_DEBUG *//* enable debugging messages */
43 #include <linux/interrupt.h>
44 #include "../comedidev.h"
46 #include <linux/ioport.h>
50 #include <pcmcia/cs_types.h>
51 #include <pcmcia/cs.h>
52 #include <pcmcia/cistpl.h>
53 #include <pcmcia/cisreg.h>
54 #include <pcmcia/ds.h>
56 static struct pcmcia_device *pcmcia_cur_dev = NULL;
58 #define DIO24_SIZE 4 /* size of io region used by board */
60 static int dio24_attach(struct comedi_device *dev, struct comedi_devconfig *it);
61 static int dio24_detach(struct comedi_device *dev);
63 enum dio24_bustype { pcmcia_bustype };
65 struct dio24_board_struct {
67 int device_id; /* device id for pcmcia board */
68 enum dio24_bustype bustype; /* PCMCIA */
69 int have_dio; /* have 8255 chip */
70 /* function pointers so we can use inb/outb or readb/writeb as appropriate */
71 unsigned int (*read_byte) (unsigned int address);
72 void (*write_byte) (unsigned int byte, unsigned int address);
75 static const struct dio24_board_struct dio24_boards[] = {
77 .name = "daqcard-dio24",
78 .device_id = 0x475c, /* 0x10b is manufacturer id, 0x475c is device id */
79 .bustype = pcmcia_bustype,
83 .name = "ni_daq_dio24",
84 .device_id = 0x475c, /* 0x10b is manufacturer id, 0x475c is device id */
85 .bustype = pcmcia_bustype,
91 * Useful for shorthand access to the particular board structure
93 #define thisboard ((const struct dio24_board_struct *)dev->board_ptr)
95 struct dio24_private {
97 int data; /* number of data points left to be taken */
100 #define devpriv ((struct dio24_private *)dev->private)
102 static struct comedi_driver driver_dio24 = {
103 .driver_name = "ni_daq_dio24",
104 .module = THIS_MODULE,
105 .attach = dio24_attach,
106 .detach = dio24_detach,
107 .num_names = ARRAY_SIZE(dio24_boards),
108 .board_name = &dio24_boards[0].name,
109 .offset = sizeof(struct dio24_board_struct),
112 static int dio24_attach(struct comedi_device *dev, struct comedi_devconfig *it)
114 struct comedi_subdevice *s;
115 unsigned long iobase = 0;
117 unsigned int irq = 0;
119 struct pcmcia_device *link;
121 /* allocate and initialize dev->private */
122 if (alloc_private(dev, sizeof(struct dio24_private)) < 0)
125 /* get base address, irq etc. based on bustype */
126 switch (thisboard->bustype) {
128 link = pcmcia_cur_dev; /* XXX hack */
131 iobase = link->io.BasePort1;
133 irq = link->irq.AssignedIRQ;
137 printk("bug! couldn't determine board type\n");
141 printk("comedi%d: ni_daq_dio24: %s, io 0x%lx", dev->minor,
142 thisboard->name, iobase);
145 printk(", irq %u", irq);
152 printk("io base address is zero!\n");
156 dev->iobase = iobase;
163 dev->board_name = thisboard->name;
165 if (alloc_subdevices(dev, 1) < 0)
169 s = dev->subdevices + 0;
170 subdev_8255_init(dev, s, NULL, dev->iobase);
175 static int dio24_detach(struct comedi_device *dev)
177 printk("comedi%d: ni_daq_dio24: remove\n", dev->minor);
180 subdev_8255_cleanup(dev, dev->subdevices + 0);
182 if (thisboard->bustype != pcmcia_bustype && dev->iobase)
183 release_region(dev->iobase, DIO24_SIZE);
185 free_irq(dev->irq, dev);
190 /* PCMCIA crap -- watch your words! */
192 static void dio24_config(struct pcmcia_device *link);
193 static void dio24_release(struct pcmcia_device *link);
194 static int dio24_cs_suspend(struct pcmcia_device *p_dev);
195 static int dio24_cs_resume(struct pcmcia_device *p_dev);
198 The attach() and detach() entry points are used to create and destroy
199 "instances" of the driver, where each instance represents everything
200 needed to manage one actual PCMCIA card.
203 static int dio24_cs_attach(struct pcmcia_device *);
204 static void dio24_cs_detach(struct pcmcia_device *);
207 You'll also need to prototype all the functions that will actually
208 be used to talk to your device. See 'memory_cs' for a good example
209 of a fully self-sufficient driver; the other drivers rely more or
210 less on other parts of the kernel.
214 The dev_info variable is the "key" that is used to match up this
215 device driver with appropriate cards, through the card configuration
219 static const dev_info_t dev_info = "ni_daq_dio24";
221 struct local_info_t {
222 struct pcmcia_device *link;
225 struct bus_operations *bus;
228 /*======================================================================
230 dio24_cs_attach() creates an "instance" of the driver, allocating
231 local data structures for one device. The device is registered
234 The dev_link structure is initialized, but we don't actually
235 configure the card at this point -- we wait until we receive a
236 card insertion event.
238 ======================================================================*/
240 static int dio24_cs_attach(struct pcmcia_device *link)
242 struct local_info_t *local;
244 printk(KERN_INFO "ni_daq_dio24: HOLA SOY YO - CS-attach!\n");
246 dev_dbg(&link->dev, "dio24_cs_attach()\n");
248 /* Allocate space for private device-specific data */
249 local = kzalloc(sizeof(struct local_info_t), GFP_KERNEL);
255 /* Interrupt setup */
256 link->irq.Attributes = IRQ_TYPE_DYNAMIC_SHARING;
257 link->irq.Handler = NULL;
260 General socket configuration defaults can go here. In this
261 client, we assume very little, and rely on the CIS for almost
262 everything. In most clients, many details (i.e., number, sizes,
263 and attributes of IO windows) are fixed by the nature of the
264 device, and can be hard-wired here.
266 link->conf.Attributes = 0;
267 link->conf.IntType = INT_MEMORY_AND_IO;
269 pcmcia_cur_dev = link;
274 } /* dio24_cs_attach */
276 /*======================================================================
278 This deletes a driver "instance". The device is de-registered
279 with Card Services. If it has been released, all local data
280 structures are freed. Otherwise, the structures will be freed
281 when the device is released.
283 ======================================================================*/
285 static void dio24_cs_detach(struct pcmcia_device *link)
288 printk(KERN_INFO "ni_daq_dio24: HOLA SOY YO - cs-detach!\n");
290 dev_dbg(&link->dev, "dio24_cs_detach\n");
292 if (link->dev_node) {
293 ((struct local_info_t *)link->priv)->stop = 1;
297 /* This points to the parent local_info_t struct */
301 } /* dio24_cs_detach */
303 /*======================================================================
305 dio24_config() is scheduled to run after a CARD_INSERTION event
306 is received, to configure the PCMCIA socket, and to make the
307 device available to the system.
309 ======================================================================*/
311 static int dio24_pcmcia_config_loop(struct pcmcia_device *p_dev,
312 cistpl_cftable_entry_t *cfg,
313 cistpl_cftable_entry_t *dflt,
317 win_req_t *req = priv_data;
323 /* Does this card need audio output? */
324 if (cfg->flags & CISTPL_CFTABLE_AUDIO) {
325 p_dev->conf.Attributes |= CONF_ENABLE_SPKR;
326 p_dev->conf.Status = CCSR_AUDIO_ENA;
329 /* Do we need to allocate an interrupt? */
330 if (cfg->irq.IRQInfo1 || dflt->irq.IRQInfo1)
331 p_dev->conf.Attributes |= CONF_ENABLE_IRQ;
333 /* IO window settings */
334 p_dev->io.NumPorts1 = p_dev->io.NumPorts2 = 0;
335 if ((cfg->io.nwin > 0) || (dflt->io.nwin > 0)) {
336 cistpl_io_t *io = (cfg->io.nwin) ? &cfg->io : &dflt->io;
337 p_dev->io.Attributes1 = IO_DATA_PATH_WIDTH_AUTO;
338 if (!(io->flags & CISTPL_IO_8BIT))
339 p_dev->io.Attributes1 = IO_DATA_PATH_WIDTH_16;
340 if (!(io->flags & CISTPL_IO_16BIT))
341 p_dev->io.Attributes1 = IO_DATA_PATH_WIDTH_8;
342 p_dev->io.IOAddrLines = io->flags & CISTPL_IO_LINES_MASK;
343 p_dev->io.BasePort1 = io->win[0].base;
344 p_dev->io.NumPorts1 = io->win[0].len;
346 p_dev->io.Attributes2 = p_dev->io.Attributes1;
347 p_dev->io.BasePort2 = io->win[1].base;
348 p_dev->io.NumPorts2 = io->win[1].len;
350 /* This reserves IO space but doesn't actually enable it */
351 if (pcmcia_request_io(p_dev, &p_dev->io) != 0)
355 if ((cfg->mem.nwin > 0) || (dflt->mem.nwin > 0)) {
357 (cfg->mem.nwin) ? &cfg->mem : &dflt->mem;
358 req->Attributes = WIN_DATA_WIDTH_16 | WIN_MEMORY_TYPE_CM;
359 req->Attributes |= WIN_ENABLE;
360 req->Base = mem->win[0].host_addr;
361 req->Size = mem->win[0].len;
362 if (req->Size < 0x1000)
364 req->AccessSpeed = 0;
365 if (pcmcia_request_window(p_dev, req, &p_dev->win))
368 map.CardOffset = mem->win[0].card_addr;
369 if (pcmcia_map_mem_page(p_dev, p_dev->win, &map))
372 /* If we got this far, we're cool! */
376 static void dio24_config(struct pcmcia_device *link)
378 struct local_info_t *dev = link->priv;
382 printk(KERN_INFO "ni_daq_dio24: HOLA SOY YO! - config\n");
384 dev_dbg(&link->dev, "dio24_config\n");
386 ret = pcmcia_loop_config(link, dio24_pcmcia_config_loop, &req);
388 dev_warn(&link->dev, "no configuration found\n");
393 Allocate an interrupt line. Note that this does not assign a
394 handler to the interrupt, unless the 'Handler' member of the
395 irq structure is initialized.
397 if (link->conf.Attributes & CONF_ENABLE_IRQ) {
398 ret = pcmcia_request_irq(link, &link->irq);
404 This actually configures the PCMCIA socket -- setting up
405 the I/O windows and the interrupt mapping, and putting the
406 card and host interface into "Memory and IO" mode.
408 ret = pcmcia_request_configuration(link, &link->conf);
413 At this point, the dev_node_t structure(s) need to be
414 initialized and arranged in a linked list at link->dev.
416 sprintf(dev->node.dev_name, "ni_daq_dio24");
417 dev->node.major = dev->node.minor = 0;
418 link->dev_node = &dev->node;
420 /* Finally, report what we've done */
421 printk(KERN_INFO "%s: index 0x%02x",
422 dev->node.dev_name, link->conf.ConfigIndex);
423 if (link->conf.Attributes & CONF_ENABLE_IRQ)
424 printk(", irq %d", link->irq.AssignedIRQ);
425 if (link->io.NumPorts1)
426 printk(", io 0x%04x-0x%04x", link->io.BasePort1,
427 link->io.BasePort1 + link->io.NumPorts1 - 1);
428 if (link->io.NumPorts2)
429 printk(" & 0x%04x-0x%04x", link->io.BasePort2,
430 link->io.BasePort2 + link->io.NumPorts2 - 1);
432 printk(", mem 0x%06lx-0x%06lx", req.Base,
433 req.Base + req.Size - 1);
439 printk(KERN_INFO "Fallo");
444 static void dio24_release(struct pcmcia_device *link)
446 dev_dbg(&link->dev, "dio24_release\n");
448 pcmcia_disable_device(link);
449 } /* dio24_release */
451 /*======================================================================
453 The card status event handler. Mostly, this schedules other
454 stuff to run after an event is received.
456 When a CARD_REMOVAL event is received, we immediately set a
457 private flag to block future accesses to this device. All the
458 functions that actually access the device should check this flag
459 to make sure the card is still present.
461 ======================================================================*/
463 static int dio24_cs_suspend(struct pcmcia_device *link)
465 struct local_info_t *local = link->priv;
467 /* Mark the device as stopped, to block IO until later */
470 } /* dio24_cs_suspend */
472 static int dio24_cs_resume(struct pcmcia_device *link)
474 struct local_info_t *local = link->priv;
478 } /* dio24_cs_resume */
480 /*====================================================================*/
482 static struct pcmcia_device_id dio24_cs_ids[] = {
483 /* N.B. These IDs should match those in dio24_boards */
484 PCMCIA_DEVICE_MANF_CARD(0x010b, 0x475c), /* daqcard-dio24 */
488 MODULE_DEVICE_TABLE(pcmcia, dio24_cs_ids);
490 struct pcmcia_driver dio24_cs_driver = {
491 .probe = dio24_cs_attach,
492 .remove = dio24_cs_detach,
493 .suspend = dio24_cs_suspend,
494 .resume = dio24_cs_resume,
495 .id_table = dio24_cs_ids,
496 .owner = THIS_MODULE,
502 static int __init init_dio24_cs(void)
504 printk("ni_daq_dio24: HOLA SOY YO!\n");
505 pcmcia_register_driver(&dio24_cs_driver);
509 static void __exit exit_dio24_cs(void)
511 pcmcia_unregister_driver(&dio24_cs_driver);
514 int __init init_module(void)
518 ret = init_dio24_cs();
522 return comedi_driver_register(&driver_dio24);
525 void __exit cleanup_module(void)
528 comedi_driver_unregister(&driver_dio24);