2 * comedi/drivers/ni_daq_700.c
3 * Driver for DAQCard-700 DIO only
6 * COMEDI - Linux Control and Measurement Device Interface
7 * Copyright (C) 1998 David A. Schleef <ds@schleef.org>
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.
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.
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.
27 Description: National Instruments PCMCIA DAQCard-700 DIO only
28 Author: Fred Brooks <nsaspook@nsaspook.com>,
29 based on ni_daq_dio24 by Daniel Vecino Castel <dvecino@able.es>
30 Devices: [National Instruments] PCMCIA DAQ-Card-700 (ni_daq_700)
32 Updated: Thu, 21 Feb 2008 12:07:20 +0000
34 The daqcard-700 appears in Comedi as a single digital I/O subdevice with
35 16 channels. The channel 0 corresponds to the daqcard-700's output
36 port, bit 0; channel 8 corresponds to the input port, bit 0.
38 Direction configuration: channels 0-7 output, 8-15 input (8225 device
39 emu as port A output, port B input, port C N/A).
41 IRQ is assigned but not used.
44 #include "../comedidev.h"
46 #include <linux/ioport.h>
47 #include <linux/version.h>
49 #include <pcmcia/cs_types.h>
50 #include <pcmcia/cs.h>
51 #include <pcmcia/cistpl.h>
52 #include <pcmcia/cisreg.h>
53 #include <pcmcia/ds.h>
55 static struct pcmcia_device
*pcmcia_cur_dev
= NULL
;
57 #define DIO700_SIZE 8 // size of io region used by board
59 static int dio700_attach(comedi_device
* dev
, comedi_devconfig
* it
);
60 static int dio700_detach(comedi_device
* dev
);
62 enum dio700_bustype
{ pcmcia_bustype
};
64 typedef struct dio700_board_struct
{
66 int device_id
; // device id for pcmcia board
67 enum dio700_bustype bustype
; // PCMCIA
68 int have_dio
; // have daqcard-700 dio
69 // function pointers so we can use inb/outb or readb/writeb
71 unsigned int (*read_byte
) (unsigned int address
);
72 void (*write_byte
) (unsigned int byte
, unsigned int address
);
75 static const dio700_board dio700_boards
[] = {
78 device_id
:0x4743,// 0x10b is manufacturer id, 0x4743 is device id
79 bustype
: pcmcia_bustype
,
84 device_id
:0x4743,// 0x10b is manufacturer id, 0x4743 is device id
85 bustype
: pcmcia_bustype
,
91 * Useful for shorthand access to the particular board structure
93 #define thisboard ((const dio700_board *)dev->board_ptr)
96 int data
; /* number of data points left to be taken */
99 #define devpriv ((dio700_private *)dev->private)
101 static comedi_driver driver_dio700
= {
102 driver_name
:"ni_daq_700",
104 attach
:dio700_attach
,
105 detach
:dio700_detach
,
106 num_names
:sizeof(dio700_boards
) / sizeof(dio700_board
),
107 board_name
:&dio700_boards
[0].name
,
108 offset
:sizeof(dio700_board
),
111 /* the real driver routines */
120 struct subdev_700_struct
{
121 unsigned long cb_arg
;
122 int (*cb_func
) (int, int, int, unsigned long);
126 #define CALLBACK_ARG (((struct subdev_700_struct *)s->private)->cb_arg)
127 #define CALLBACK_FUNC (((struct subdev_700_struct *)s->private)->cb_func)
128 #define subdevpriv ((struct subdev_700_struct *)s->private)
130 static void do_config(comedi_device
* dev
, comedi_subdevice
* s
);
132 void subdev_700_interrupt(comedi_device
* dev
, comedi_subdevice
* s
)
136 d
= CALLBACK_FUNC(0, _700_DATA
, 0, CALLBACK_ARG
);
138 comedi_buf_put(s
->async
, d
);
139 s
->async
->events
|= COMEDI_CB_EOS
;
141 comedi_event(dev
, s
);
144 static int subdev_700_cb(int dir
, int port
, int data
, unsigned long arg
)
146 /* port is always A for output and B for input (8255 emu) */
147 unsigned long iobase
= arg
;
150 outb(data
, iobase
+ DIO_W
);
153 return inb(iobase
+ DIO_R
);
157 static int subdev_700_insn(comedi_device
* dev
, comedi_subdevice
* s
,
158 comedi_insn
* insn
, lsampl_t
* data
)
161 s
->state
&= ~data
[0];
162 s
->state
|= (data
[0] & data
[1]);
165 CALLBACK_FUNC(1, _700_DATA
, s
->state
& 0xff,
169 data
[1] = s
->state
& 0xff;
170 data
[1] |= CALLBACK_FUNC(0, _700_DATA
, 0, CALLBACK_ARG
) << 8;
175 static int subdev_700_insn_config(comedi_device
* dev
, comedi_subdevice
* s
,
176 comedi_insn
* insn
, lsampl_t
* data
)
180 case INSN_CONFIG_DIO_INPUT
:
182 case INSN_CONFIG_DIO_OUTPUT
:
184 case INSN_CONFIG_DIO_QUERY
:
186 (s
->io_bits
& (1 << CR_CHAN(insn
->
187 chanspec
))) ? COMEDI_OUTPUT
:
198 static void do_config(comedi_device
* dev
, comedi_subdevice
* s
)
199 { /* use powerup defaults */
203 static int subdev_700_cmdtest(comedi_device
* dev
, comedi_subdevice
* s
,
211 tmp
= cmd
->start_src
;
212 cmd
->start_src
&= TRIG_NOW
;
213 if (!cmd
->start_src
|| tmp
!= cmd
->start_src
)
216 tmp
= cmd
->scan_begin_src
;
217 cmd
->scan_begin_src
&= TRIG_EXT
;
218 if (!cmd
->scan_begin_src
|| tmp
!= cmd
->scan_begin_src
)
221 tmp
= cmd
->convert_src
;
222 cmd
->convert_src
&= TRIG_FOLLOW
;
223 if (!cmd
->convert_src
|| tmp
!= cmd
->convert_src
)
226 tmp
= cmd
->scan_end_src
;
227 cmd
->scan_end_src
&= TRIG_COUNT
;
228 if (!cmd
->scan_end_src
|| tmp
!= cmd
->scan_end_src
)
232 cmd
->stop_src
&= TRIG_NONE
;
233 if (!cmd
->stop_src
|| tmp
!= cmd
->stop_src
)
246 if (cmd
->start_arg
!= 0) {
250 if (cmd
->scan_begin_arg
!= 0) {
251 cmd
->scan_begin_arg
= 0;
254 if (cmd
->convert_arg
!= 0) {
255 cmd
->convert_arg
= 0;
258 if (cmd
->scan_end_arg
!= 1) {
259 cmd
->scan_end_arg
= 1;
262 if (cmd
->stop_arg
!= 0) {
278 static int subdev_700_cmd(comedi_device
* dev
, comedi_subdevice
* s
)
285 static int subdev_700_cancel(comedi_device
* dev
, comedi_subdevice
* s
)
292 int subdev_700_init(comedi_device
* dev
, comedi_subdevice
* s
, int (*cb
) (int,
293 int, int, unsigned long), unsigned long arg
)
295 s
->type
= COMEDI_SUBD_DIO
;
296 s
->subdev_flags
= SDF_READABLE
| SDF_WRITABLE
;
298 s
->range_table
= &range_digital
;
301 s
->private = kmalloc(sizeof(struct subdev_700_struct
), GFP_KERNEL
);
307 CALLBACK_FUNC
= subdev_700_cb
;
311 s
->insn_bits
= subdev_700_insn
;
312 s
->insn_config
= subdev_700_insn_config
;
321 int subdev_700_init_irq(comedi_device
* dev
, comedi_subdevice
* s
,
322 int (*cb
) (int, int, int, unsigned long), unsigned long arg
)
326 ret
= subdev_700_init(dev
, s
, cb
, arg
);
330 s
->do_cmdtest
= subdev_700_cmdtest
;
331 s
->do_cmd
= subdev_700_cmd
;
332 s
->cancel
= subdev_700_cancel
;
334 subdevpriv
->have_irq
= 1;
339 void subdev_700_cleanup(comedi_device
* dev
, comedi_subdevice
* s
)
342 if (subdevpriv
->have_irq
) {
349 EXPORT_SYMBOL(subdev_700_init
);
350 EXPORT_SYMBOL(subdev_700_init_irq
);
351 EXPORT_SYMBOL(subdev_700_cleanup
);
352 EXPORT_SYMBOL(subdev_700_interrupt
);
354 static int dio700_attach(comedi_device
* dev
, comedi_devconfig
* it
)
357 unsigned long iobase
= 0;
359 unsigned int irq
= 0;
361 struct pcmcia_device
*link
;
363 /* allocate and initialize dev->private */
364 if (alloc_private(dev
, sizeof(dio700_private
)) < 0)
367 // get base address, irq etc. based on bustype
368 switch (thisboard
->bustype
) {
370 link
= pcmcia_cur_dev
; /* XXX hack */
373 iobase
= link
->io
.BasePort1
;
375 irq
= link
->irq
.AssignedIRQ
;
379 printk("bug! couldn't determine board type\n");
383 printk("comedi%d: ni_daq_700: %s, io 0x%lx", dev
->minor
,
384 thisboard
->name
, iobase
);
387 printk(", irq %u", irq
);
394 printk("io base address is zero!\n");
398 dev
->iobase
= iobase
;
405 dev
->board_name
= thisboard
->name
;
407 if (alloc_subdevices(dev
, 1) < 0)
410 /* DAQCard-700 dio */
411 s
= dev
->subdevices
+ 0;
412 subdev_700_init(dev
, s
, NULL
, dev
->iobase
);
417 static int dio700_detach(comedi_device
* dev
)
419 printk("comedi%d: ni_daq_700: cs-remove\n", dev
->minor
);
422 subdev_700_cleanup(dev
, dev
->subdevices
+ 0);
424 if (thisboard
->bustype
!= pcmcia_bustype
&& dev
->iobase
)
425 release_region(dev
->iobase
, DIO700_SIZE
);
427 comedi_free_irq(dev
->irq
, dev
);
435 All the PCMCIA modules use PCMCIA_DEBUG to control debugging. If
436 you do not define PCMCIA_DEBUG at all, all the debug code will be
437 left out. If you compile with PCMCIA_DEBUG=0, the debug code will
438 be present but disabled -- but it can then be enabled for specific
439 modules at load time with a 'pc_debug=#' option to insmod.
442 static int pc_debug
= PCMCIA_DEBUG
;
443 module_param(pc_debug
, int, 0644);
444 #define DEBUG(n, args...) if (pc_debug>(n)) printk(KERN_DEBUG args)
445 static char *version
= "ni_daq_700.c, based on dummy_cs.c";
447 #define DEBUG(n, args...)
450 /*====================================================================*/
452 static void dio700_config(struct pcmcia_device
*link
);
453 static void dio700_release(struct pcmcia_device
*link
);
454 static int dio700_cs_suspend(struct pcmcia_device
*p_dev
);
455 static int dio700_cs_resume(struct pcmcia_device
*p_dev
);
458 The attach() and detach() entry points are used to create and destroy
459 "instances" of the driver, where each instance represents everything
460 needed to manage one actual PCMCIA card.
463 static int dio700_cs_attach(struct pcmcia_device
*);
464 static void dio700_cs_detach(struct pcmcia_device
*);
467 You'll also need to prototype all the functions that will actually
468 be used to talk to your device. See 'memory_cs' for a good example
469 of a fully self-sufficient driver; the other drivers rely more or
470 less on other parts of the kernel.
474 The dev_info variable is the "key" that is used to match up this
475 device driver with appropriate cards, through the card configuration
479 static const dev_info_t dev_info
= "ni_daq_700";
481 typedef struct local_info_t
{
482 struct pcmcia_device
*link
;
485 struct bus_operations
*bus
;
488 /*======================================================================
490 dio700_cs_attach() creates an "instance" of the driver, allocating
491 local data structures for one device. The device is registered
494 The dev_link structure is initialized, but we don't actually
495 configure the card at this point -- we wait until we receive a
496 card insertion event.
498 ======================================================================*/
500 static int dio700_cs_attach(struct pcmcia_device
*link
)
504 printk(KERN_INFO
"ni_daq_700: cs-attach\n");
506 DEBUG(0, "dio700_cs_attach()\n");
508 /* Allocate space for private device-specific data */
509 local
= kzalloc(sizeof(local_info_t
), GFP_KERNEL
);
515 /* Interrupt setup */
516 link
->irq
.Attributes
= IRQ_TYPE_EXCLUSIVE
;
517 link
->irq
.IRQInfo1
= IRQ_LEVEL_ID
;
518 link
->irq
.Handler
= NULL
;
521 General socket configuration defaults can go here. In this
522 client, we assume very little, and rely on the CIS for almost
523 everything. In most clients, many details (i.e., number, sizes,
524 and attributes of IO windows) are fixed by the nature of the
525 device, and can be hard-wired here.
527 link
->conf
.Attributes
= 0;
528 link
->conf
.IntType
= INT_MEMORY_AND_IO
;
530 pcmcia_cur_dev
= link
;
535 } /* dio700_cs_attach */
537 /*======================================================================
539 This deletes a driver "instance". The device is de-registered
540 with Card Services. If it has been released, all local data
541 structures are freed. Otherwise, the structures will be freed
542 when the device is released.
544 ======================================================================*/
546 static void dio700_cs_detach(struct pcmcia_device
*link
)
549 printk(KERN_INFO
"ni_daq_700: cs-detach!\n");
551 DEBUG(0, "dio700_cs_detach(0x%p)\n", link
);
553 if (link
->dev_node
) {
554 ((local_info_t
*) link
->priv
)->stop
= 1;
555 dio700_release(link
);
558 /* This points to the parent local_info_t struct */
562 } /* dio700_cs_detach */
564 /*======================================================================
566 dio700_config() is scheduled to run after a CARD_INSERTION event
567 is received, to configure the PCMCIA socket, and to make the
568 device available to the system.
570 ======================================================================*/
572 static void dio700_config(struct pcmcia_device
*link
)
574 local_info_t
*dev
= link
->priv
;
581 cistpl_cftable_entry_t dflt
= { 0 };
583 printk(KERN_INFO
"ni_daq_700: cs-config\n");
585 DEBUG(0, "dio700_config(0x%p)\n", link
);
588 This reads the card's CONFIG tuple to find its configuration
591 tuple
.DesiredTuple
= CISTPL_CONFIG
;
592 tuple
.Attributes
= 0;
593 tuple
.TupleData
= buf
;
594 tuple
.TupleDataMax
= sizeof(buf
);
595 tuple
.TupleOffset
= 0;
596 if ((last_ret
= pcmcia_get_first_tuple(link
, &tuple
)) != 0) {
597 cs_error(link
, GetFirstTuple
, last_ret
);
600 if ((last_ret
= pcmcia_get_tuple_data(link
, &tuple
)) != 0) {
601 cs_error(link
, GetTupleData
, last_ret
);
604 if ((last_ret
= pcmcia_parse_tuple(&tuple
, &parse
)) != 0) {
605 cs_error(link
, ParseTuple
, last_ret
);
608 link
->conf
.ConfigBase
= parse
.config
.base
;
609 link
->conf
.Present
= parse
.config
.rmask
[0];
612 In this loop, we scan the CIS for configuration table entries,
613 each of which describes a valid card configuration, including
614 voltage, IO window, memory window, and interrupt settings.
616 We make no assumptions about the card to be configured: we use
617 just the information available in the CIS. In an ideal world,
618 this would work for any PCMCIA card, but it requires a complete
619 and accurate CIS. In practice, a driver usually "knows" most of
620 these things without consulting the CIS, and most client drivers
621 will only use the CIS to fill in implementation-defined details.
623 tuple
.DesiredTuple
= CISTPL_CFTABLE_ENTRY
;
624 if ((last_ret
= pcmcia_get_first_tuple(link
, &tuple
)) != 0) {
625 cs_error(link
, GetFirstTuple
, last_ret
);
629 cistpl_cftable_entry_t
*cfg
= &(parse
.cftable_entry
);
630 if (pcmcia_get_tuple_data(link
, &tuple
) != 0)
632 if (pcmcia_parse_tuple(&tuple
, &parse
) != 0)
635 if (cfg
->flags
& CISTPL_CFTABLE_DEFAULT
)
639 link
->conf
.ConfigIndex
= cfg
->index
;
641 /* Does this card need audio output? */
642 if (cfg
->flags
& CISTPL_CFTABLE_AUDIO
) {
643 link
->conf
.Attributes
|= CONF_ENABLE_SPKR
;
644 link
->conf
.Status
= CCSR_AUDIO_ENA
;
647 /* Do we need to allocate an interrupt? */
648 if (cfg
->irq
.IRQInfo1
|| dflt
.irq
.IRQInfo1
)
649 link
->conf
.Attributes
|= CONF_ENABLE_IRQ
;
651 /* IO window settings */
652 link
->io
.NumPorts1
= link
->io
.NumPorts2
= 0;
653 if ((cfg
->io
.nwin
> 0) || (dflt
.io
.nwin
> 0)) {
654 cistpl_io_t
*io
= (cfg
->io
.nwin
) ? &cfg
->io
: &dflt
.io
;
655 link
->io
.Attributes1
= IO_DATA_PATH_WIDTH_AUTO
;
656 if (!(io
->flags
& CISTPL_IO_8BIT
))
657 link
->io
.Attributes1
= IO_DATA_PATH_WIDTH_16
;
658 if (!(io
->flags
& CISTPL_IO_16BIT
))
659 link
->io
.Attributes1
= IO_DATA_PATH_WIDTH_8
;
660 link
->io
.IOAddrLines
= io
->flags
& CISTPL_IO_LINES_MASK
;
661 link
->io
.BasePort1
= io
->win
[0].base
;
662 link
->io
.NumPorts1
= io
->win
[0].len
;
664 link
->io
.Attributes2
= link
->io
.Attributes1
;
665 link
->io
.BasePort2
= io
->win
[1].base
;
666 link
->io
.NumPorts2
= io
->win
[1].len
;
668 /* This reserves IO space but doesn't actually enable it */
669 if (pcmcia_request_io(link
, &link
->io
) != 0)
673 if ((cfg
->mem
.nwin
> 0) || (dflt
.mem
.nwin
> 0)) {
675 (cfg
->mem
.nwin
) ? &cfg
->mem
: &dflt
.mem
;
676 req
.Attributes
= WIN_DATA_WIDTH_16
| WIN_MEMORY_TYPE_CM
;
677 req
.Attributes
|= WIN_ENABLE
;
678 req
.Base
= mem
->win
[0].host_addr
;
679 req
.Size
= mem
->win
[0].len
;
680 if (req
.Size
< 0x1000)
683 if (pcmcia_request_window(&link
, &req
, &link
->win
))
686 map
.CardOffset
= mem
->win
[0].card_addr
;
687 if (pcmcia_map_mem_page(link
->win
, &map
))
690 /* If we got this far, we're cool! */
694 if ((last_ret
= pcmcia_get_next_tuple(link
, &tuple
)) != 0) {
695 cs_error(link
, GetNextTuple
, last_ret
);
701 Allocate an interrupt line. Note that this does not assign a
702 handler to the interrupt, unless the 'Handler' member of the
703 irq structure is initialized.
705 if (link
->conf
.Attributes
& CONF_ENABLE_IRQ
)
706 if ((last_ret
= pcmcia_request_irq(link
, &link
->irq
)) != 0) {
707 cs_error(link
, RequestIRQ
, last_ret
);
712 This actually configures the PCMCIA socket -- setting up
713 the I/O windows and the interrupt mapping, and putting the
714 card and host interface into "Memory and IO" mode.
716 if ((last_ret
= pcmcia_request_configuration(link
, &link
->conf
)) != 0) {
717 cs_error(link
, RequestConfiguration
, last_ret
);
722 At this point, the dev_node_t structure(s) need to be
723 initialized and arranged in a linked list at link->dev.
725 sprintf(dev
->node
.dev_name
, "ni_daq_700");
726 dev
->node
.major
= dev
->node
.minor
= 0;
727 link
->dev_node
= &dev
->node
;
729 /* Finally, report what we've done */
730 printk(KERN_INFO
"%s: index 0x%02x",
731 dev
->node
.dev_name
, link
->conf
.ConfigIndex
);
732 if (link
->conf
.Attributes
& CONF_ENABLE_IRQ
)
733 printk(", irq %d", link
->irq
.AssignedIRQ
);
734 if (link
->io
.NumPorts1
)
735 printk(", io 0x%04x-0x%04x", link
->io
.BasePort1
,
736 link
->io
.BasePort1
+ link
->io
.NumPorts1
- 1);
737 if (link
->io
.NumPorts2
)
738 printk(" & 0x%04x-0x%04x", link
->io
.BasePort2
,
739 link
->io
.BasePort2
+ link
->io
.NumPorts2
- 1);
741 printk(", mem 0x%06lx-0x%06lx", req
.Base
,
742 req
.Base
+ req
.Size
- 1);
748 printk(KERN_INFO
"ni_daq_700 cs failed");
749 dio700_release(link
);
751 } /* dio700_config */
753 static void dio700_release(struct pcmcia_device
*link
)
755 DEBUG(0, "dio700_release(0x%p)\n", link
);
757 pcmcia_disable_device(link
);
758 } /* dio700_release */
760 /*======================================================================
762 The card status event handler. Mostly, this schedules other
763 stuff to run after an event is received.
765 When a CARD_REMOVAL event is received, we immediately set a
766 private flag to block future accesses to this device. All the
767 functions that actually access the device should check this flag
768 to make sure the card is still present.
770 ======================================================================*/
772 static int dio700_cs_suspend(struct pcmcia_device
*link
)
774 local_info_t
*local
= link
->priv
;
776 /* Mark the device as stopped, to block IO until later */
779 } /* dio700_cs_suspend */
781 static int dio700_cs_resume(struct pcmcia_device
*link
)
783 local_info_t
*local
= link
->priv
;
787 } /* dio700_cs_resume */
789 /*====================================================================*/
791 static struct pcmcia_device_id dio700_cs_ids
[] = {
792 /* N.B. These IDs should match those in dio700_boards */
793 PCMCIA_DEVICE_MANF_CARD(0x010b, 0x4743), /* daqcard-700 */
797 MODULE_LICENSE("GPL");
798 MODULE_DEVICE_TABLE(pcmcia
, dio700_cs_ids
);
800 struct pcmcia_driver dio700_cs_driver
= {
801 .probe
= dio700_cs_attach
,
802 .remove
= dio700_cs_detach
,
803 .suspend
= dio700_cs_suspend
,
804 .resume
= dio700_cs_resume
,
805 .id_table
= dio700_cs_ids
,
806 .owner
= THIS_MODULE
,
812 static int __init
init_dio700_cs(void)
814 printk("ni_daq_700: cs-init \n");
815 DEBUG(0, "%s\n", version
);
816 pcmcia_register_driver(&dio700_cs_driver
);
820 static void __exit
exit_dio700_cs(void)
822 DEBUG(0, "ni_daq_700: unloading\n");
823 pcmcia_unregister_driver(&dio700_cs_driver
);
825 int __init
init_module(void)
829 ret
= init_dio700_cs();
833 return comedi_driver_register(&driver_dio700
);
836 void __exit
cleanup_module(void)
839 comedi_driver_unregister(&driver_dio700
);