1 /*******************************************************************************
2 comedi/drivers/pci1723.c
4 COMEDI - Linux Control and Measurement Device Interface
5 Copyright (C) 2000 David A. Schleef <ds@schleef.org>
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 2 of the License, or
10 (at your option) any later version.
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with this program; if not, write to the Free Software
19 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
21 *******************************************************************************/
24 Description: Advantech PCI-1723
25 Author: yonggang <rsmgnu@gmail.com>, Ian Abbott <abbotti@mev.co.uk>
26 Devices: [Advantech] PCI-1723 (adv_pci1723)
27 Updated: Mon, 14 Apr 2008 15:12:56 +0100
30 Configuration Options:
31 [0] - PCI bus of device (optional)
32 [1] - PCI slot of device (optional)
34 If bus/slot is not specified, the first supported
35 PCI device found will be used.
37 Subdevice 0 is 8-channel AO, 16-bit, range +/- 10 V.
39 Subdevice 1 is 16-channel DIO. The channels are configurable as input or
40 output in 2 groups (0 to 7, 8 to 15). Configuring any channel implicitly
41 configures all channels in the same group.
45 1. Add the two milliamp ranges to the AO subdevice (0 to 20 mA, 4 to 20 mA).
46 2. Read the initial ranges and values of the AO subdevice at start-up instead
47 of reinitializing them.
48 3. Implement calibration.
51 #include "../comedidev.h"
53 #include "comedi_pci.h"
55 #define ADVANTECH_VENDOR 0x13fe /* Advantech PCI vendor ID */
57 /* hardware types of the cards */
58 #define TYPE_PCI1723 0
60 #define IORANGE_1723 0x2A
62 /* all the registers for the pci1723 board */
63 #define PCI1723_DA(N) ((N)<<1) /* W: D/A register N (0 to 7) */
65 #define PCI1723_SYN_SET 0x12 /*synchronized set register */
66 #define PCI1723_ALL_CHNNELE_SYN_STROBE 0x12 /*synchronized status register */
68 #define PCI1723_RANGE_CALIBRATION_MODE 0x14 /* range and calibration mode */
69 #define PCI1723_RANGE_CALIBRATION_STATUS 0x14 /* range and calibration status */
71 #define PCI1723_CONTROL_CMD_CALIBRATION_FUN 0x16 /* SADC control command for calibration function */
72 #define PCI1723_STATUS_CMD_CALIBRATION_FUN 0x16 /* SADC control status for calibration function */
74 #define PCI1723_CALIBRATION_PARA_STROBE 0x18 /* Calibration parameter strobe */
76 #define PCI1723_DIGITAL_IO_PORT_SET 0x1A /* Digital I/O port setting */
77 #define PCI1723_DIGITAL_IO_PORT_MODE 0x1A /* Digital I/O port mode */
79 #define PCI1723_WRITE_DIGITAL_OUTPUT_CMD 0x1C /* Write digital output command */
80 #define PCI1723_READ_DIGITAL_INPUT_DATA 0x1C /* Read digital input data */
82 #define PCI1723_WRITE_CAL_CMD 0x1E /* Write calibration command */
83 #define PCI1723_READ_CAL_STATUS 0x1E /* Read calibration status */
85 #define PCI1723_SYN_STROBE 0x20 /* Synchronized strobe */
87 #define PCI1723_RESET_ALL_CHN_STROBE 0x22 /* Reset all D/A channels strobe */
89 #define PCI1723_RESET_CAL_CONTROL_STROBE 0x24 /* Reset the calibration controller strobe */
91 #define PCI1723_CHANGE_CHA_OUTPUT_TYPE_STROBE 0x26 /* Change D/A channels output type strobe */
93 #define PCI1723_SELECT_CALIBRATION 0x28 /* Select the calibration Ref_V */
95 /* static unsigned short pci_list_builded=0; =1 list of card is know */
97 static const struct comedi_lrange range_pci1723
= { 1, {
103 * Board descriptions for pci1723 boards.
105 struct pci1723_board
{
107 int vendor_id
; /* PCI vendor a device ID of card */
111 int n_aochan
; /* num of D/A chans */
112 int n_diochan
; /* num of DIO chans */
113 int ao_maxdata
; /* resolution of D/A */
114 const struct comedi_lrange
*rangelist_ao
; /* rangelist for D/A */
117 static const struct pci1723_board boardtypes
[] = {
120 .vendor_id
= ADVANTECH_VENDOR
,
122 .iorange
= IORANGE_1723
,
123 .cardtype
= TYPE_PCI1723
,
126 .ao_maxdata
= 0xffff,
127 .rangelist_ao
= &range_pci1723
,
131 /* This is used by modprobe to translate PCI IDs to drivers. Should
132 * only be used for PCI and ISA-PnP devices */
133 static DEFINE_PCI_DEVICE_TABLE(pci1723_pci_table
) = {
135 PCI_VENDOR_ID_ADVANTECH
, 0x1723, PCI_ANY_ID
, PCI_ANY_ID
, 0, 0, 0}, {
139 MODULE_DEVICE_TABLE(pci
, pci1723_pci_table
);
142 * The struct comedi_driver structure tells the Comedi core module
143 * which functions to call to configure/deconfigure (attach/detach)
144 * the board, and also about the kernel module that contains
147 static int pci1723_attach(struct comedi_device
*dev
,
148 struct comedi_devconfig
*it
);
149 static int pci1723_detach(struct comedi_device
*dev
);
151 #define n_boardtypes (sizeof(boardtypes)/sizeof(struct pci1723_board))
153 static struct comedi_driver driver_pci1723
= {
154 .driver_name
= "adv_pci1723",
155 .module
= THIS_MODULE
,
156 .attach
= pci1723_attach
,
157 .detach
= pci1723_detach
,
160 /* this structure is for data unique to this hardware driver. */
161 struct pci1723_private
{
162 int valid
; /* card is usable; */
164 struct pci_dev
*pcidev
;
165 unsigned char da_range
[8]; /* D/A output range for each channel */
167 short ao_data
[8]; /* data output buffer */
170 /*the following macro to make it easy to
171 * access the private structure.
173 #define devpriv ((struct pci1723_private *)dev->private)
175 #define this_board boardtypes
178 * the pci1723 card reset;
180 static int pci1723_reset(struct comedi_device
*dev
)
183 DPRINTK("adv_pci1723 EDBG: BGN: pci1723_reset(...)\n");
185 outw(0x01, dev
->iobase
+ PCI1723_SYN_SET
); /* set synchronous output mode */
187 for (i
= 0; i
< 8; i
++) {
188 /* set all outputs to 0V */
189 devpriv
->ao_data
[i
] = 0x8000;
190 outw(devpriv
->ao_data
[i
], dev
->iobase
+ PCI1723_DA(i
));
191 /* set all ranges to +/- 10V */
192 devpriv
->da_range
[i
] = 0;
193 outw(((devpriv
->da_range
[i
] << 4) | i
),
194 PCI1723_RANGE_CALIBRATION_MODE
);
197 outw(0, dev
->iobase
+ PCI1723_CHANGE_CHA_OUTPUT_TYPE_STROBE
); /* update ranges */
198 outw(0, dev
->iobase
+ PCI1723_SYN_STROBE
); /* update outputs */
200 /* set asynchronous output mode */
201 outw(0, dev
->iobase
+ PCI1723_SYN_SET
);
203 DPRINTK("adv_pci1723 EDBG: END: pci1723_reset(...)\n");
207 static int pci1723_insn_read_ao(struct comedi_device
*dev
,
208 struct comedi_subdevice
*s
,
209 struct comedi_insn
*insn
, unsigned int *data
)
213 chan
= CR_CHAN(insn
->chanspec
);
214 DPRINTK(" adv_PCI1723 DEBUG: pci1723_insn_read_ao() ----- \n");
215 for (n
= 0; n
< insn
->n
; n
++)
216 data
[n
] = devpriv
->ao_data
[chan
];
224 static int pci1723_ao_write_winsn(struct comedi_device
*dev
,
225 struct comedi_subdevice
*s
,
226 struct comedi_insn
*insn
, unsigned int *data
)
229 chan
= CR_CHAN(insn
->chanspec
);
231 DPRINTK("PCI1723: the pci1723_ao_write_winsn() ------\n");
233 for (n
= 0; n
< insn
->n
; n
++) {
235 devpriv
->ao_data
[chan
] = data
[n
];
236 outw(data
[n
], dev
->iobase
+ PCI1723_DA(chan
));
243 digital i/o config/query
245 static int pci1723_dio_insn_config(struct comedi_device
*dev
,
246 struct comedi_subdevice
*s
,
247 struct comedi_insn
*insn
, unsigned int *data
)
251 unsigned short dio_mode
;
253 mask
= 1 << CR_CHAN(insn
->chanspec
);
260 case INSN_CONFIG_DIO_INPUT
:
263 case INSN_CONFIG_DIO_OUTPUT
:
266 case INSN_CONFIG_DIO_QUERY
:
267 data
[1] = (s
->io_bits
& bits
) ? COMEDI_OUTPUT
: COMEDI_INPUT
;
273 /* update hardware DIO mode */
274 dio_mode
= 0x0000; /* low byte output, high byte output */
275 if ((s
->io_bits
& 0x00FF) == 0)
276 dio_mode
|= 0x0001; /* low byte input */
277 if ((s
->io_bits
& 0xFF00) == 0)
278 dio_mode
|= 0x0002; /* high byte input */
279 outw(dio_mode
, dev
->iobase
+ PCI1723_DIGITAL_IO_PORT_SET
);
284 digital i/o bits read/write
286 static int pci1723_dio_insn_bits(struct comedi_device
*dev
,
287 struct comedi_subdevice
*s
,
288 struct comedi_insn
*insn
, unsigned int *data
)
291 s
->state
&= ~data
[0];
292 s
->state
|= (data
[0] & data
[1]);
293 outw(s
->state
, dev
->iobase
+ PCI1723_WRITE_DIGITAL_OUTPUT_CMD
);
295 data
[1] = inw(dev
->iobase
+ PCI1723_READ_DIGITAL_INPUT_DATA
);
300 * Attach is called by the Comedi core to configure the driver
301 * for a pci1723 board.
303 static int pci1723_attach(struct comedi_device
*dev
,
304 struct comedi_devconfig
*it
)
306 struct comedi_subdevice
*s
;
307 int ret
, subdev
, n_subdevices
;
308 struct pci_dev
*pcidev
;
310 unsigned char pci_bus
, pci_slot
, pci_func
;
311 int opt_bus
, opt_slot
;
314 printk("comedi%d: adv_pci1723: board=%s", dev
->minor
, this_board
->name
);
316 opt_bus
= it
->options
[0];
317 opt_slot
= it
->options
[1];
319 ret
= alloc_private(dev
, sizeof(struct pci1723_private
));
321 printk(" - Allocation failed!\n");
325 /* Look for matching PCI device */
326 errstr
= "not found!";
328 while (NULL
!= (pcidev
=
329 pci_get_device(PCI_VENDOR_ID_ADVANTECH
,
330 this_board
->device_id
, pcidev
))) {
331 /* Found matching vendor/device. */
332 if (opt_bus
|| opt_slot
) {
333 /* Check bus/slot. */
334 if (opt_bus
!= pcidev
->bus
->number
335 || opt_slot
!= PCI_SLOT(pcidev
->devfn
))
336 continue; /* no match */
339 * Look for device that isn't in use.
340 * Enable PCI device and request regions.
342 if (comedi_pci_enable(pcidev
, "adv_pci1723")) {
344 "failed to enable PCI device and request regions!";
351 if (opt_bus
|| opt_slot
) {
352 printk(" - Card at b:s %d:%d %s\n",
353 opt_bus
, opt_slot
, errstr
);
355 printk(" - Card %s\n", errstr
);
360 pci_bus
= pcidev
->bus
->number
;
361 pci_slot
= PCI_SLOT(pcidev
->devfn
);
362 pci_func
= PCI_FUNC(pcidev
->devfn
);
363 iobase
= pci_resource_start(pcidev
, 2);
365 printk(", b:s:f=%d:%d:%d, io=0x%4x", pci_bus
, pci_slot
, pci_func
,
368 dev
->iobase
= iobase
;
370 dev
->board_name
= this_board
->name
;
371 devpriv
->pcidev
= pcidev
;
375 if (this_board
->n_aochan
)
377 if (this_board
->n_diochan
)
380 ret
= alloc_subdevices(dev
, n_subdevices
);
382 printk(" - Allocation failed!\n");
388 if (this_board
->n_aochan
) {
389 s
= dev
->subdevices
+ subdev
;
390 dev
->write_subdev
= s
;
391 s
->type
= COMEDI_SUBD_AO
;
392 s
->subdev_flags
= SDF_WRITEABLE
| SDF_GROUND
| SDF_COMMON
;
393 s
->n_chan
= this_board
->n_aochan
;
394 s
->maxdata
= this_board
->ao_maxdata
;
395 s
->len_chanlist
= this_board
->n_aochan
;
396 s
->range_table
= this_board
->rangelist_ao
;
398 s
->insn_write
= pci1723_ao_write_winsn
;
399 s
->insn_read
= pci1723_insn_read_ao
;
401 /* read DIO config */
402 switch (inw(dev
->iobase
+ PCI1723_DIGITAL_IO_PORT_MODE
) & 0x03) {
403 case 0x00: /* low byte output, high byte output */
406 case 0x01: /* low byte input, high byte output */
409 case 0x02: /* low byte output, high byte input */
412 case 0x03: /* low byte input, high byte input */
416 /* read DIO port state */
417 s
->state
= inw(dev
->iobase
+ PCI1723_READ_DIGITAL_INPUT_DATA
);
422 if (this_board
->n_diochan
) {
423 s
= dev
->subdevices
+ subdev
;
424 s
->type
= COMEDI_SUBD_DIO
;
426 SDF_READABLE
| SDF_WRITABLE
| SDF_GROUND
| SDF_COMMON
;
427 s
->n_chan
= this_board
->n_diochan
;
429 s
->len_chanlist
= this_board
->n_diochan
;
430 s
->range_table
= &range_digital
;
431 s
->insn_config
= pci1723_dio_insn_config
;
432 s
->insn_bits
= pci1723_dio_insn_bits
;
444 * _detach is called to deconfigure a device. It should deallocate
446 * This function is also called when _attach() fails, so it should be
447 * careful not to release resources that were not necessarily
448 * allocated by _attach(). dev->private and dev->subdevices are
449 * deallocated automatically by the core.
451 static int pci1723_detach(struct comedi_device
*dev
)
453 printk("comedi%d: pci1723: remove\n", dev
->minor
);
459 if (devpriv
->pcidev
) {
461 comedi_pci_disable(devpriv
->pcidev
);
463 pci_dev_put(devpriv
->pcidev
);
471 * A convenient macro that defines init_module() and cleanup_module(),
474 COMEDI_PCI_INITCLEANUP(driver_pci1723
, pci1723_pci_table
);