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 PCI_VENDOR_ID_ADVANTECH 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
67
/* synchronized status register */
69
#define PCI1723_RANGE_CALIBRATION_MODE 0x14
70
/* range and calibration mode */
71
#define PCI1723_RANGE_CALIBRATION_STATUS 0x14
72
/* range and calibration status */
74
#define PCI1723_CONTROL_CMD_CALIBRATION_FUN 0x16
76
* SADC control command for
77
* calibration function
79
#define PCI1723_STATUS_CMD_CALIBRATION_FUN 0x16
81
* SADC control status for
82
* calibration function
85
#define PCI1723_CALIBRATION_PARA_STROBE 0x18
86
/* Calibration parameter strobe */
88
#define PCI1723_DIGITAL_IO_PORT_SET 0x1A /* Digital I/O port setting */
89
#define PCI1723_DIGITAL_IO_PORT_MODE 0x1A /* Digital I/O port mode */
91
#define PCI1723_WRITE_DIGITAL_OUTPUT_CMD 0x1C
92
/* Write digital output command */
93
#define PCI1723_READ_DIGITAL_INPUT_DATA 0x1C /* Read digital input data */
95
#define PCI1723_WRITE_CAL_CMD 0x1E /* Write calibration command */
96
#define PCI1723_READ_CAL_STATUS 0x1E /* Read calibration status */
98
#define PCI1723_SYN_STROBE 0x20 /* Synchronized strobe */
100
#define PCI1723_RESET_ALL_CHN_STROBE 0x22
101
/* Reset all D/A channels strobe */
103
#define PCI1723_RESET_CAL_CONTROL_STROBE 0x24
105
* Reset the calibration
109
#define PCI1723_CHANGE_CHA_OUTPUT_TYPE_STROBE 0x26
111
* Change D/A channels output
115
#define PCI1723_SELECT_CALIBRATION 0x28 /* Select the calibration Ref_V */
117
/* static unsigned short pci_list_builded=0; =1 list of card is know */
119
static const struct comedi_lrange range_pci1723 = { 1, {
125
* Board descriptions for pci1723 boards.
127
struct pci1723_board {
129
int vendor_id; /* PCI vendor a device ID of card */
133
int n_aochan; /* num of D/A chans */
134
int n_diochan; /* num of DIO chans */
135
int ao_maxdata; /* resolution of D/A */
136
const struct comedi_lrange *rangelist_ao; /* rangelist for D/A */
139
static const struct pci1723_board boardtypes[] = {
142
.vendor_id = PCI_VENDOR_ID_ADVANTECH,
144
.iorange = IORANGE_1723,
145
.cardtype = TYPE_PCI1723,
148
.ao_maxdata = 0xffff,
149
.rangelist_ao = &range_pci1723,
154
* This is used by modprobe to translate PCI IDs to drivers.
155
* Should only be used for PCI and ISA-PnP devices
157
static DEFINE_PCI_DEVICE_TABLE(pci1723_pci_table) = {
158
{ PCI_DEVICE(PCI_VENDOR_ID_ADVANTECH, 0x1723) },
162
MODULE_DEVICE_TABLE(pci, pci1723_pci_table);
165
* The struct comedi_driver structure tells the Comedi core module
166
* which functions to call to configure/deconfigure (attach/detach)
167
* the board, and also about the kernel module that contains
170
static int pci1723_attach(struct comedi_device *dev,
171
struct comedi_devconfig *it);
172
static int pci1723_detach(struct comedi_device *dev);
174
#define n_boardtypes (sizeof(boardtypes)/sizeof(struct pci1723_board))
176
static struct comedi_driver driver_pci1723 = {
177
.driver_name = "adv_pci1723",
178
.module = THIS_MODULE,
179
.attach = pci1723_attach,
180
.detach = pci1723_detach,
183
/* This structure is for data unique to this hardware driver. */
184
struct pci1723_private {
185
int valid; /* card is usable; */
187
struct pci_dev *pcidev;
188
unsigned char da_range[8]; /* D/A output range for each channel */
190
short ao_data[8]; /* data output buffer */
193
/* The following macro to make it easy to access the private structure. */
194
#define devpriv ((struct pci1723_private *)dev->private)
196
#define this_board boardtypes
199
* The pci1723 card reset;
201
static int pci1723_reset(struct comedi_device *dev)
204
DPRINTK("adv_pci1723 EDBG: BGN: pci1723_reset(...)\n");
206
outw(0x01, dev->iobase + PCI1723_SYN_SET);
207
/* set synchronous output mode */
209
for (i = 0; i < 8; i++) {
210
/* set all outputs to 0V */
211
devpriv->ao_data[i] = 0x8000;
212
outw(devpriv->ao_data[i], dev->iobase + PCI1723_DA(i));
213
/* set all ranges to +/- 10V */
214
devpriv->da_range[i] = 0;
215
outw(((devpriv->da_range[i] << 4) | i),
216
PCI1723_RANGE_CALIBRATION_MODE);
219
outw(0, dev->iobase + PCI1723_CHANGE_CHA_OUTPUT_TYPE_STROBE);
221
outw(0, dev->iobase + PCI1723_SYN_STROBE); /* update outputs */
223
/* set asynchronous output mode */
224
outw(0, dev->iobase + PCI1723_SYN_SET);
226
DPRINTK("adv_pci1723 EDBG: END: pci1723_reset(...)\n");
230
static int pci1723_insn_read_ao(struct comedi_device *dev,
231
struct comedi_subdevice *s,
232
struct comedi_insn *insn, unsigned int *data)
236
chan = CR_CHAN(insn->chanspec);
237
DPRINTK(" adv_PCI1723 DEBUG: pci1723_insn_read_ao() -----\n");
238
for (n = 0; n < insn->n; n++)
239
data[n] = devpriv->ao_data[chan];
247
static int pci1723_ao_write_winsn(struct comedi_device *dev,
248
struct comedi_subdevice *s,
249
struct comedi_insn *insn, unsigned int *data)
252
chan = CR_CHAN(insn->chanspec);
254
DPRINTK("PCI1723: the pci1723_ao_write_winsn() ------\n");
256
for (n = 0; n < insn->n; n++) {
258
devpriv->ao_data[chan] = data[n];
259
outw(data[n], dev->iobase + PCI1723_DA(chan));
266
digital i/o config/query
268
static int pci1723_dio_insn_config(struct comedi_device *dev,
269
struct comedi_subdevice *s,
270
struct comedi_insn *insn, unsigned int *data)
274
unsigned short dio_mode;
276
mask = 1 << CR_CHAN(insn->chanspec);
283
case INSN_CONFIG_DIO_INPUT:
286
case INSN_CONFIG_DIO_OUTPUT:
289
case INSN_CONFIG_DIO_QUERY:
290
data[1] = (s->io_bits & bits) ? COMEDI_OUTPUT : COMEDI_INPUT;
296
/* update hardware DIO mode */
297
dio_mode = 0x0000; /* low byte output, high byte output */
298
if ((s->io_bits & 0x00FF) == 0)
299
dio_mode |= 0x0001; /* low byte input */
300
if ((s->io_bits & 0xFF00) == 0)
301
dio_mode |= 0x0002; /* high byte input */
302
outw(dio_mode, dev->iobase + PCI1723_DIGITAL_IO_PORT_SET);
307
digital i/o bits read/write
309
static int pci1723_dio_insn_bits(struct comedi_device *dev,
310
struct comedi_subdevice *s,
311
struct comedi_insn *insn, unsigned int *data)
314
s->state &= ~data[0];
315
s->state |= (data[0] & data[1]);
316
outw(s->state, dev->iobase + PCI1723_WRITE_DIGITAL_OUTPUT_CMD);
318
data[1] = inw(dev->iobase + PCI1723_READ_DIGITAL_INPUT_DATA);
323
* Attach is called by the Comedi core to configure the driver
324
* for a pci1723 board.
326
static int pci1723_attach(struct comedi_device *dev,
327
struct comedi_devconfig *it)
329
struct comedi_subdevice *s;
330
int ret, subdev, n_subdevices;
331
struct pci_dev *pcidev;
333
unsigned char pci_bus, pci_slot, pci_func;
334
int opt_bus, opt_slot;
337
printk(KERN_ERR "comedi%d: adv_pci1723: board=%s",
338
dev->minor, this_board->name);
340
opt_bus = it->options[0];
341
opt_slot = it->options[1];
343
ret = alloc_private(dev, sizeof(struct pci1723_private));
345
printk(" - Allocation failed!\n");
349
/* Look for matching PCI device */
350
errstr = "not found!";
352
while (NULL != (pcidev =
353
pci_get_device(PCI_VENDOR_ID_ADVANTECH,
354
this_board->device_id, pcidev))) {
355
/* Found matching vendor/device. */
356
if (opt_bus || opt_slot) {
357
/* Check bus/slot. */
358
if (opt_bus != pcidev->bus->number
359
|| opt_slot != PCI_SLOT(pcidev->devfn))
360
continue; /* no match */
363
* Look for device that isn't in use.
364
* Enable PCI device and request regions.
366
if (comedi_pci_enable(pcidev, "adv_pci1723")) {
368
"failed to enable PCI device and request regions!";
375
if (opt_bus || opt_slot) {
376
printk(KERN_ERR " - Card at b:s %d:%d %s\n",
377
opt_bus, opt_slot, errstr);
379
printk(KERN_ERR " - Card %s\n", errstr);
384
pci_bus = pcidev->bus->number;
385
pci_slot = PCI_SLOT(pcidev->devfn);
386
pci_func = PCI_FUNC(pcidev->devfn);
387
iobase = pci_resource_start(pcidev, 2);
389
printk(KERN_ERR ", b:s:f=%d:%d:%d, io=0x%4x",
390
pci_bus, pci_slot, pci_func, iobase);
392
dev->iobase = iobase;
394
dev->board_name = this_board->name;
395
devpriv->pcidev = pcidev;
399
if (this_board->n_aochan)
401
if (this_board->n_diochan)
404
ret = alloc_subdevices(dev, n_subdevices);
406
printk(" - Allocation failed!\n");
412
if (this_board->n_aochan) {
413
s = dev->subdevices + subdev;
414
dev->write_subdev = s;
415
s->type = COMEDI_SUBD_AO;
416
s->subdev_flags = SDF_WRITEABLE | SDF_GROUND | SDF_COMMON;
417
s->n_chan = this_board->n_aochan;
418
s->maxdata = this_board->ao_maxdata;
419
s->len_chanlist = this_board->n_aochan;
420
s->range_table = this_board->rangelist_ao;
422
s->insn_write = pci1723_ao_write_winsn;
423
s->insn_read = pci1723_insn_read_ao;
425
/* read DIO config */
426
switch (inw(dev->iobase + PCI1723_DIGITAL_IO_PORT_MODE)
428
case 0x00: /* low byte output, high byte output */
431
case 0x01: /* low byte input, high byte output */
434
case 0x02: /* low byte output, high byte input */
437
case 0x03: /* low byte input, high byte input */
441
/* read DIO port state */
442
s->state = inw(dev->iobase + PCI1723_READ_DIGITAL_INPUT_DATA);
447
if (this_board->n_diochan) {
448
s = dev->subdevices + subdev;
449
s->type = COMEDI_SUBD_DIO;
451
SDF_READABLE | SDF_WRITABLE | SDF_GROUND | SDF_COMMON;
452
s->n_chan = this_board->n_diochan;
454
s->len_chanlist = this_board->n_diochan;
455
s->range_table = &range_digital;
456
s->insn_config = pci1723_dio_insn_config;
457
s->insn_bits = pci1723_dio_insn_bits;
469
* _detach is called to deconfigure a device. It should deallocate
471
* This function is also called when _attach() fails, so it should be
472
* careful not to release resources that were not necessarily
473
* allocated by _attach(). dev->private and dev->subdevices are
474
* deallocated automatically by the core.
476
static int pci1723_detach(struct comedi_device *dev)
478
printk(KERN_ERR "comedi%d: pci1723: remove\n", dev->minor);
484
if (devpriv->pcidev) {
486
comedi_pci_disable(devpriv->pcidev);
487
pci_dev_put(devpriv->pcidev);
495
* A convenient macro that defines init_module() and cleanup_module(),
498
static int __devinit driver_pci1723_pci_probe(struct pci_dev *dev,
499
const struct pci_device_id *ent)
501
return comedi_pci_auto_config(dev, driver_pci1723.driver_name);
504
static void __devexit driver_pci1723_pci_remove(struct pci_dev *dev)
506
comedi_pci_auto_unconfig(dev);
509
static struct pci_driver driver_pci1723_pci_driver = {
510
.id_table = pci1723_pci_table,
511
.probe = &driver_pci1723_pci_probe,
512
.remove = __devexit_p(&driver_pci1723_pci_remove)
515
static int __init driver_pci1723_init_module(void)
519
retval = comedi_driver_register(&driver_pci1723);
523
driver_pci1723_pci_driver.name = (char *)driver_pci1723.driver_name;
524
return pci_register_driver(&driver_pci1723_pci_driver);
527
static void __exit driver_pci1723_cleanup_module(void)
529
pci_unregister_driver(&driver_pci1723_pci_driver);
530
comedi_driver_unregister(&driver_pci1723);
533
module_init(driver_pci1723_init_module);
534
module_exit(driver_pci1723_cleanup_module);
536
MODULE_AUTHOR("Comedi http://www.comedi.org");
537
MODULE_DESCRIPTION("Comedi low-level driver");
538
MODULE_LICENSE("GPL");