poc.c

Go to the documentation of this file.

/*
    comedi/drivers/poc.c
    Mini-drivers for POC (Piece of Crap) boards
    Copyright (C) 2000 Frank Mori Hess <[email protected]>
    Copyright (C) 2001 David A. Schleef <[email protected]>

    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program; if not, write to the Free Software
    Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
*/
/*
Driver: poc
Description: Generic driver for very simple devices
Author: ds
Devices: [Keithley Metrabyte] DAC-02 (dac02), [Advantech] PCL-733 (pcl733),
  PCL-734 (pcl734)
Updated: Sat, 16 Mar 2002 17:34:48 -0800
Status: unknown

This driver is indended to support very simple ISA-based devices,
including:
  dac02 - Keithley DAC-02 analog output board
  pcl733 - Advantech PCL-733
  pcl734 - Advantech PCL-734

Configuration options:
  [0] - I/O port base
*/

#include "../comedidev.h"

#include <linux/ioport.h>

struct boarddef_struct {
    const char *name;
    unsigned int iosize;
    int (*setup) (struct comedi_device *);
    int type;
    int n_chan;
    int n_bits;
    int (*winsn) (struct comedi_device *, struct comedi_subdevice *,
              struct comedi_insn *, unsigned int *);
    int (*rinsn) (struct comedi_device *, struct comedi_subdevice *,
              struct comedi_insn *, unsigned int *);
    int (*insnbits) (struct comedi_device *, struct comedi_subdevice *,
             struct comedi_insn *, unsigned int *);
    const struct comedi_lrange *range;
};

static int readback_insn(struct comedi_device *dev, struct comedi_subdevice *s,
             struct comedi_insn *insn, unsigned int *data)
{
    int chan;

    chan = CR_CHAN(insn->chanspec);
    data[0] = ((unsigned int *)dev->private)[chan];

    return 1;
}

/* DAC-02 registers */
#define DAC02_LSB(a)    (2 * a)
#define DAC02_MSB(a)    (2 * a + 1)

static int dac02_ao_winsn(struct comedi_device *dev, struct comedi_subdevice *s,
              struct comedi_insn *insn, unsigned int *data)
{
    int temp;
    int chan;
    int output;

    chan = CR_CHAN(insn->chanspec);
    ((unsigned int *)dev->private)[chan] = data[0];
    output = data[0];
#ifdef wrong
    /*  convert to complementary binary if range is bipolar */
    if ((CR_RANGE(insn->chanspec) & 0x2) == 0)
        output = ~output;
#endif
    temp = (output << 4) & 0xf0;
    outb(temp, dev->iobase + DAC02_LSB(chan));
    temp = (output >> 4) & 0xff;
    outb(temp, dev->iobase + DAC02_MSB(chan));

    return 1;
}

static int pcl733_insn_bits(struct comedi_device *dev,
                struct comedi_subdevice *s,
                struct comedi_insn *insn, unsigned int *data)
{
    data[1] = inb(dev->iobase + 0);
    data[1] |= (inb(dev->iobase + 1) << 8);
    data[1] |= (inb(dev->iobase + 2) << 16);
    data[1] |= (inb(dev->iobase + 3) << 24);

    return insn->n;
}

static int pcl734_insn_bits(struct comedi_device *dev,
                struct comedi_subdevice *s,
                struct comedi_insn *insn, unsigned int *data)
{
    if (data[0]) {
        s->state &= ~data[0];
        s->state |= (data[0] & data[1]);
        if ((data[0] >> 0) & 0xff)
            outb((s->state >> 0) & 0xff, dev->iobase + 0);
        if ((data[0] >> 8) & 0xff)
            outb((s->state >> 8) & 0xff, dev->iobase + 1);
        if ((data[0] >> 16) & 0xff)
            outb((s->state >> 16) & 0xff, dev->iobase + 2);
        if ((data[0] >> 24) & 0xff)
            outb((s->state >> 24) & 0xff, dev->iobase + 3);
    }
    data[1] = s->state;

    return insn->n;
}

static int poc_attach(struct comedi_device *dev, struct comedi_devconfig *it)
{
    const struct boarddef_struct *board = comedi_board(dev);
    struct comedi_subdevice *s;
    unsigned long iobase;
    unsigned int iosize;
    int ret;

    iobase = it->options[0];
    printk(KERN_INFO "comedi%d: poc: using %s iobase 0x%lx\n", dev->minor,
           board->name, iobase);

    dev->board_name = board->name;

    if (iobase == 0) {
        printk(KERN_ERR "io base address required\n");
        return -EINVAL;
    }

    iosize = board->iosize;
    /* check if io addresses are available */
    if (!request_region(iobase, iosize, "dac02")) {
        printk(KERN_ERR "I/O port conflict: failed to allocate ports "
            "0x%lx to 0x%lx\n", iobase, iobase + iosize - 1);
        return -EIO;
    }
    dev->iobase = iobase;

    ret = comedi_alloc_subdevices(dev, 1);
    if (ret)
        return ret;

    if (alloc_private(dev, sizeof(unsigned int) * board->n_chan) < 0)
        return -ENOMEM;

    /* analog output subdevice */
    s = &dev->subdevices[0];
    s->type = board->type;
    s->n_chan = board->n_chan;
    s->maxdata = (1 << board->n_bits) - 1;
    s->range_table = board->range;
    s->insn_write = board->winsn;
    s->insn_read = board->rinsn;
    s->insn_bits = board->insnbits;
    if (s->type == COMEDI_SUBD_AO || s->type == COMEDI_SUBD_DO)
        s->subdev_flags = SDF_WRITABLE;

    return 0;
}

static void poc_detach(struct comedi_device *dev)
{
    const struct boarddef_struct *board = comedi_board(dev);

    if (dev->iobase)
        release_region(dev->iobase, board->iosize);
}

static const struct boarddef_struct boards[] = {
    {
        .name       = "dac02",
        .iosize     = 8,
        /* .setup   = dac02_setup, */
        .type       = COMEDI_SUBD_AO,
        .n_chan     = 2,
        .n_bits     = 12,
        .winsn      = dac02_ao_winsn,
        .rinsn      = readback_insn,
        .range      = &range_unknown,
    }, {
        .name       = "pcl733",
        .iosize     = 4,
        .type       = COMEDI_SUBD_DI,
        .n_chan     = 32,
        .n_bits     = 1,
        .insnbits   = pcl733_insn_bits,
        .range      = &range_digital,
    }, {
        .name       = "pcl734",
        .iosize     = 4,
        .type       = COMEDI_SUBD_DO,
        .n_chan     = 32,
        .n_bits     = 1,
        .insnbits   = pcl734_insn_bits,
        .range      = &range_digital,
    },
};

static struct comedi_driver poc_driver = {
    .driver_name    = "poc",
    .module     = THIS_MODULE,
    .attach     = poc_attach,
    .detach     = poc_detach,
    .board_name = &boards[0].name,
    .num_names  = ARRAY_SIZE(boards),
    .offset     = sizeof(boards[0]),
};
module_comedi_driver(poc_driver);

MODULE_AUTHOR("Comedi http://www.comedi.org");
MODULE_DESCRIPTION("Comedi low-level driver");
MODULE_LICENSE("GPL");