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 comedi_lrange range_pci1723 = { 1, {
103 * Board descriptions for pci1723 boards.
105 typedef struct pci1723_board_struct {
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 comedi_lrange *rangelist_ao; // rangelist for D/A
117 static const boardtype boardtypes[] = {
120 vendor_id:ADVANTECH_VENDOR,
122 iorange: IORANGE_1723,
123 cardtype:TYPE_PCI1723,
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) = {
134 {PCI_VENDOR_ID_ADVANTECH, 0x1723, PCI_ANY_ID, PCI_ANY_ID, 0, 0, 0},
138 MODULE_DEVICE_TABLE(pci, pci1723_pci_table);
141 * The comedi_driver structure tells the Comedi core module
142 * which functions to call to configure/deconfigure (attach/detach)
143 * the board, and also about the kernel module that contains
146 static int pci1723_attach(comedi_device * dev, comedi_devconfig * it);
147 static int pci1723_detach(comedi_device * dev);
149 #define n_boardtypes (sizeof(boardtypes)/sizeof(boardtype))
151 static comedi_driver driver_pci1723 = {
152 driver_name:"adv_pci1723",
154 attach:pci1723_attach,
155 detach:pci1723_detach,
158 /* this structure is for data unique to this hardware driver. */
160 int valid; //card is usable;
162 struct pci_dev *pcidev;
163 unsigned char da_range[8]; // D/A output range for each channel
165 sampl_t ao_data[8]; // data output buffer
168 /*the following macro to make it easy to
169 * access the private structure.
171 #define devpriv ((pci1723_private *)dev->private)
173 #define this_board boardtypes
176 * the pci1723 card reset;
178 static int pci1723_reset(comedi_device * dev)
181 DPRINTK("adv_pci1723 EDBG: BGN: pci1723_reset(...)\n");
183 outw(0x01, dev->iobase + PCI1723_SYN_SET); // set synchronous output mode
185 for (i = 0; i < 8; i++) {
186 // set all outputs to 0V
187 devpriv->ao_data[i] = 0x8000;
188 outw(devpriv->ao_data[i], dev->iobase + PCI1723_DA(i));
189 // set all ranges to +/- 10V
190 devpriv->da_range[i] = 0;
191 outw(((devpriv->da_range[i] << 4) | i),
192 PCI1723_RANGE_CALIBRATION_MODE);
195 outw(0, dev->iobase + PCI1723_CHANGE_CHA_OUTPUT_TYPE_STROBE); // update ranges
196 outw(0, dev->iobase + PCI1723_SYN_STROBE); // update outputs
198 // set asynchronous output mode
199 outw(0, dev->iobase + PCI1723_SYN_SET);
201 DPRINTK("adv_pci1723 EDBG: END: pci1723_reset(...)\n");
205 static int pci1723_insn_read_ao(comedi_device * dev, comedi_subdevice * s,
206 comedi_insn * insn, lsampl_t * data)
210 chan = CR_CHAN(insn->chanspec);
211 DPRINTK(" adv_PCI1723 DEBUG: pci1723_insn_read_ao() ----- \n");
212 for (n = 0; n < insn->n; n++)
213 data[n] = devpriv->ao_data[chan];
221 static int pci1723_ao_write_winsn(comedi_device * dev, comedi_subdevice * s,
222 comedi_insn * insn, lsampl_t * data)
225 chan = CR_CHAN(insn->chanspec);
227 DPRINTK("PCI1723: the pci1723_ao_write_winsn() ------\n");
229 for (n = 0; n < insn->n; n++) {
231 devpriv->ao_data[chan] = data[n];
232 outw(data[n], dev->iobase + PCI1723_DA(chan));
239 digital i/o config/query
241 static int pci1723_dio_insn_config(comedi_device * dev, comedi_subdevice * s,
242 comedi_insn * insn, lsampl_t * data)
246 unsigned short dio_mode;
248 mask = 1 << CR_CHAN(insn->chanspec);
255 case INSN_CONFIG_DIO_INPUT:
258 case INSN_CONFIG_DIO_OUTPUT:
261 case INSN_CONFIG_DIO_QUERY:
262 data[1] = (s->io_bits & bits) ? COMEDI_OUTPUT : COMEDI_INPUT;
268 // update hardware DIO mode
269 dio_mode = 0x0000; // low byte output, high byte output
270 if ((s->io_bits & 0x00FF) == 0)
271 dio_mode |= 0x0001; // low byte input
272 if ((s->io_bits & 0xFF00) == 0)
273 dio_mode |= 0x0002; // high byte input
274 outw(dio_mode, dev->iobase + PCI1723_DIGITAL_IO_PORT_SET);
279 digital i/o bits read/write
281 static int pci1723_dio_insn_bits(comedi_device * dev, comedi_subdevice * s,
282 comedi_insn * insn, lsampl_t * data)
285 s->state &= ~data[0];
286 s->state |= (data[0] & data[1]);
287 outw(s->state, dev->iobase + PCI1723_WRITE_DIGITAL_OUTPUT_CMD);
289 data[1] = inw(dev->iobase + PCI1723_READ_DIGITAL_INPUT_DATA);
294 * Attach is called by the Comedi core to configure the driver
295 * for a pci1723 board.
297 static int pci1723_attach(comedi_device * dev, comedi_devconfig * it)
300 int ret, subdev, n_subdevices;
301 struct pci_dev *pcidev;
303 unsigned char pci_bus, pci_slot, pci_func;
304 int opt_bus, opt_slot;
307 rt_printk("comedi%d: adv_pci1723: board=%s", dev->minor,
310 opt_bus = it->options[0];
311 opt_slot = it->options[1];
313 if ((ret = alloc_private(dev, sizeof(pci1723_private))) < 0) {
314 rt_printk(" - Allocation failed!\n");
318 /* Look for matching PCI device */
319 errstr = "not found!";
321 while (NULL != (pcidev =
322 pci_get_device(PCI_VENDOR_ID_ADVANTECH,
323 this_board->device_id, pcidev))) {
324 /* Found matching vendor/device. */
325 if (opt_bus || opt_slot) {
326 /* Check bus/slot. */
327 if (opt_bus != pcidev->bus->number
328 || opt_slot != PCI_SLOT(pcidev->devfn))
329 continue; /* no match */
332 * Look for device that isn't in use.
333 * Enable PCI device and request regions.
335 if (comedi_pci_enable(pcidev, "adv_pci1723")) {
336 errstr = "failed to enable PCI device and request regions!";
343 if (opt_bus || opt_slot) {
344 rt_printk(" - Card at b:s %d:%d %s\n",
345 opt_bus, opt_slot, errstr);
347 rt_printk(" - Card %s\n", errstr);
352 pci_bus = pcidev->bus->number;
353 pci_slot = PCI_SLOT(pcidev->devfn);
354 pci_func = PCI_FUNC(pcidev->devfn);
355 iobase = pci_resource_start(pcidev, 2);
357 rt_printk(", b:s:f=%d:%d:%d, io=0x%4x", pci_bus, pci_slot, pci_func,
360 dev->iobase = iobase;
362 dev->board_name = this_board->name;
363 devpriv->pcidev = pcidev;
367 if (this_board->n_aochan)
369 if (this_board->n_diochan)
372 if ((ret = alloc_subdevices(dev, n_subdevices)) < 0) {
373 rt_printk(" - Allocation failed!\n");
379 if (this_board->n_aochan) {
380 s = dev->subdevices + subdev;
381 dev->write_subdev = s;
382 s->type = COMEDI_SUBD_AO;
383 s->subdev_flags = SDF_WRITEABLE | SDF_GROUND | SDF_COMMON;
384 s->n_chan = this_board->n_aochan;
385 s->maxdata = this_board->ao_maxdata;
386 s->len_chanlist = this_board->n_aochan;
387 s->range_table = this_board->rangelist_ao;
389 s->insn_write = pci1723_ao_write_winsn;
390 s->insn_read = pci1723_insn_read_ao;
393 switch (inw(dev->iobase + PCI1723_DIGITAL_IO_PORT_MODE) & 0x03) {
394 case 0x00: // low byte output, high byte output
397 case 0x01: // low byte input, high byte output
400 case 0x02: // low byte output, high byte input
403 case 0x03: // low byte input, high byte input
407 // read DIO port state
408 s->state = inw(dev->iobase + PCI1723_READ_DIGITAL_INPUT_DATA);
413 if (this_board->n_diochan) {
414 s = dev->subdevices + subdev;
415 s->type = COMEDI_SUBD_DIO;
417 SDF_READABLE | SDF_WRITABLE | SDF_GROUND | SDF_COMMON;
418 s->n_chan = this_board->n_diochan;
420 s->len_chanlist = this_board->n_diochan;
421 s->range_table = &range_digital;
422 s->insn_config = pci1723_dio_insn_config;
423 s->insn_bits = pci1723_dio_insn_bits;
435 * _detach is called to deconfigure a device. It should deallocate
437 * This function is also called when _attach() fails, so it should be
438 * careful not to release resources that were not necessarily
439 * allocated by _attach(). dev->private and dev->subdevices are
440 * deallocated automatically by the core.
442 static int pci1723_detach(comedi_device * dev)
444 printk("comedi%d: pci1723: remove\n", dev->minor);
450 if (devpriv->pcidev) {
452 comedi_pci_disable(devpriv->pcidev);
454 pci_dev_put(devpriv->pcidev);
462 * A convenient macro that defines init_module() and cleanup_module(),
465 COMEDI_PCI_INITCLEANUP(driver_pci1723, pci1723_pci_table);