[thirdparty/linux.git] / drivers / staging / comedi / drivers / dt2815.c

// SPDX-License-Identifier: GPL-2.0+
/*
 * comedi/drivers/dt2815.c
 * Hardware driver for Data Translation DT2815
 *
 * COMEDI - Linux Control and Measurement Device Interface
 * Copyright (C) 1999 Anders Blomdell <anders.blomdell@control.lth.se>
 */
/*
 * Driver: dt2815
 * Description: Data Translation DT2815
 * Author: ds
 * Status: mostly complete, untested
 * Devices: [Data Translation] DT2815 (dt2815)
 *
 * I'm not sure anyone has ever tested this board.  If you have information
 * contrary, please update.
 *
 * Configuration options:
 * [0] - I/O port base base address
 * [1] - IRQ (unused)
 * [2] - Voltage unipolar/bipolar configuration
 *	0 == unipolar 5V  (0V -- +5V)
 *	1 == bipolar 5V  (-5V -- +5V)
 * [3] - Current offset configuration
 *	0 == disabled  (0mA -- +32mAV)
 *	1 == enabled  (+4mA -- +20mAV)
 * [4] - Firmware program configuration
 *	0 == program 1 (see manual table 5-4)
 *	1 == program 2 (see manual table 5-4)
 *	2 == program 3 (see manual table 5-4)
 *	3 == program 4 (see manual table 5-4)
 * [5] - Analog output 0 range configuration
 *	0 == voltage
 *	1 == current
 * [6] - Analog output 1 range configuration (same options)
 * [7] - Analog output 2 range configuration (same options)
 * [8] - Analog output 3 range configuration (same options)
 * [9] - Analog output 4 range configuration (same options)
 * [10] - Analog output 5 range configuration (same options)
 * [11] - Analog output 6 range configuration (same options)
 * [12] - Analog output 7 range configuration (same options)
 */

#include <linux/module.h>
#include "../comedidev.h"

#include <linux/delay.h>

#define DT2815_DATA 0
#define DT2815_STATUS 1

struct dt2815_private {
	const struct comedi_lrange *range_type_list[8];
	unsigned int ao_readback[8];
};

static int dt2815_ao_status(struct comedi_device *dev,
			    struct comedi_subdevice *s,
			    struct comedi_insn *insn,
			    unsigned long context)
{
	unsigned int status;

	status = inb(dev->iobase + DT2815_STATUS);
	if (status == context)
		return 0;
	return -EBUSY;
}

static int dt2815_ao_insn_read(struct comedi_device *dev,
			       struct comedi_subdevice *s,
			       struct comedi_insn *insn, unsigned int *data)
{
	struct dt2815_private *devpriv = dev->private;
	int i;
	int chan = CR_CHAN(insn->chanspec);

	for (i = 0; i < insn->n; i++)
		data[i] = devpriv->ao_readback[chan];

	return i;
}

static int dt2815_ao_insn(struct comedi_device *dev, struct comedi_subdevice *s,
			  struct comedi_insn *insn, unsigned int *data)
{
	struct dt2815_private *devpriv = dev->private;
	int i;
	int chan = CR_CHAN(insn->chanspec);
	unsigned int lo, hi;
	int ret;

	for (i = 0; i < insn->n; i++) {
		/* FIXME: lo bit 0 chooses voltage output or current output */
		lo = ((data[i] & 0x0f) << 4) | (chan << 1) | 0x01;
		hi = (data[i] & 0xff0) >> 4;

		ret = comedi_timeout(dev, s, insn, dt2815_ao_status, 0x00);
		if (ret)
			return ret;

		outb(lo, dev->iobase + DT2815_DATA);

		ret = comedi_timeout(dev, s, insn, dt2815_ao_status, 0x10);
		if (ret)
			return ret;

		outb(hi, dev->iobase + DT2815_DATA);

		devpriv->ao_readback[chan] = data[i];
	}
	return i;
}

/*
 * options[0]   Board base address
 * options[1]   IRQ (not applicable)
 * options[2]   Voltage unipolar/bipolar configuration
 *		0 == unipolar 5V  (0V -- +5V)
 *		1 == bipolar 5V  (-5V -- +5V)
 * options[3]   Current offset configuration
 *		0 == disabled  (0mA -- +32mAV)
 *		1 == enabled  (+4mA -- +20mAV)
 * options[4]   Firmware program configuration
 *		0 == program 1 (see manual table 5-4)
 *		1 == program 2 (see manual table 5-4)
 *		2 == program 3 (see manual table 5-4)
 *		3 == program 4 (see manual table 5-4)
 * options[5]   Analog output 0 range configuration
 *		0 == voltage
 *		1 == current
 * options[6]   Analog output 1 range configuration
 * ...
 * options[12]   Analog output 7 range configuration
 *		0 == voltage
 *		1 == current
 */

static int dt2815_attach(struct comedi_device *dev, struct comedi_devconfig *it)
{
	struct dt2815_private *devpriv;
	struct comedi_subdevice *s;
	int i;
	const struct comedi_lrange *current_range_type, *voltage_range_type;
	int ret;

	ret = comedi_request_region(dev, it->options[0], 0x2);
	if (ret)
		return ret;

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

	devpriv = comedi_alloc_devpriv(dev, sizeof(*devpriv));
	if (!devpriv)
		return -ENOMEM;

	s = &dev->subdevices[0];
	/* ao subdevice */
	s->type = COMEDI_SUBD_AO;
	s->subdev_flags = SDF_WRITABLE;
	s->maxdata = 0xfff;
	s->n_chan = 8;
	s->insn_write = dt2815_ao_insn;
	s->insn_read = dt2815_ao_insn_read;
	s->range_table_list = devpriv->range_type_list;

	current_range_type = (it->options[3])
	    ? &range_4_20mA : &range_0_32mA;
	voltage_range_type = (it->options[2])
	    ? &range_bipolar5 : &range_unipolar5;
	for (i = 0; i < 8; i++) {
		devpriv->range_type_list[i] = (it->options[5 + i])
		    ? current_range_type : voltage_range_type;
	}

	/* Init the 2815 */
	outb(0x00, dev->iobase + DT2815_STATUS);
	for (i = 0; i < 100; i++) {
		/* This is incredibly slow (approx 20 ms) */
		unsigned int status;

		usleep_range(1000, 3000);
		status = inb(dev->iobase + DT2815_STATUS);
		if (status == 4) {
			unsigned int program;

			program = (it->options[4] & 0x3) << 3 | 0x7;
			outb(program, dev->iobase + DT2815_DATA);
			dev_dbg(dev->class_dev, "program: 0x%x (@t=%d)\n",
				program, i);
			break;
		} else if (status != 0x00) {
			dev_dbg(dev->class_dev,
				"unexpected status 0x%x (@t=%d)\n",
				status, i);
			if (status & 0x60)
				outb(0x00, dev->iobase + DT2815_STATUS);
		}
	}

	return 0;
}

static struct comedi_driver dt2815_driver = {
	.driver_name	= "dt2815",
	.module		= THIS_MODULE,
	.attach		= dt2815_attach,
	.detach		= comedi_legacy_detach,
};
module_comedi_driver(dt2815_driver);

MODULE_AUTHOR("Comedi http://www.comedi.org");
MODULE_DESCRIPTION("Comedi low-level driver");
MODULE_LICENSE("GPL");
Commit	Line	Data
e184e2be	1	// SPDX-License-Identifier: GPL-2.0+
d6a929b7	2	/*
62c701d7 RKM	3	* comedi/drivers/dt2815.c
	4	* Hardware driver for Data Translation DT2815
	5	*
	6	* COMEDI - Linux Control and Measurement Device Interface
	7	* Copyright (C) 1999 Anders Blomdell <anders.blomdell@control.lth.se>
d6a929b7 DS	8	*/
d6a929b7 DS	9	/*
62c701d7 RKM	10	* Driver: dt2815
	11	* Description: Data Translation DT2815
	12	* Author: ds
	13	* Status: mostly complete, untested
	14	* Devices: [Data Translation] DT2815 (dt2815)
	15	*
	16	* I'm not sure anyone has ever tested this board. If you have information
	17	* contrary, please update.
	18	*
	19	* Configuration options:
	20	* [0] - I/O port base base address
	21	* [1] - IRQ (unused)
	22	* [2] - Voltage unipolar/bipolar configuration
	23	* 0 == unipolar 5V (0V -- +5V)
	24	* 1 == bipolar 5V (-5V -- +5V)
	25	* [3] - Current offset configuration
	26	* 0 == disabled (0mA -- +32mAV)
	27	* 1 == enabled (+4mA -- +20mAV)
	28	* [4] - Firmware program configuration
	29	* 0 == program 1 (see manual table 5-4)
	30	* 1 == program 2 (see manual table 5-4)
	31	* 2 == program 3 (see manual table 5-4)
	32	* 3 == program 4 (see manual table 5-4)
	33	* [5] - Analog output 0 range configuration
	34	* 0 == voltage
	35	* 1 == current
	36	* [6] - Analog output 1 range configuration (same options)
	37	* [7] - Analog output 2 range configuration (same options)
	38	* [8] - Analog output 3 range configuration (same options)
	39	* [9] - Analog output 4 range configuration (same options)
	40	* [10] - Analog output 5 range configuration (same options)
	41	* [11] - Analog output 6 range configuration (same options)
	42	* [12] - Analog output 7 range configuration (same options)
	43	*/
d6a929b7	44
ce157f80	45	#include <linux/module.h>
d6a929b7 DS	46	#include "../comedidev.h"
d6a929b7 DS	47
d6a929b7 DS	48	#include <linux/delay.h>
d6a929b7 DS	49
d6a929b7 DS	50	#define DT2815_DATA 0
	51	#define DT2815_STATUS 1
	52
0b011a6f	53	struct dt2815_private {
9ced1de6	54	const struct comedi_lrange *range_type_list[8];
790c5541	55	unsigned int ao_readback[8];
0b011a6f BP	56	};
0b011a6f BP	57
8a62fcbd HS	58	static int dt2815_ao_status(struct comedi_device *dev,
	59	struct comedi_subdevice *s,
	60	struct comedi_insn *insn,
	61	unsigned long context)
d6a929b7	62	{
8a62fcbd	63	unsigned int status;
d6a929b7	64
8a62fcbd HS	65	status = inb(dev->iobase + DT2815_STATUS);
	66	if (status == context)
	67	return 0;
	68	return -EBUSY;
d6a929b7 DS	69	}
d6a929b7 DS	70
0a85b6f0 MT	71	static int dt2815_ao_insn_read(struct comedi_device *dev,
	72	struct comedi_subdevice *s,
	73	struct comedi_insn insn, unsigned int data)
d6a929b7	74	{
9a1a6cf8	75	struct dt2815_private *devpriv = dev->private;
d6a929b7 DS	76	int i;
	77	int chan = CR_CHAN(insn->chanspec);
	78
0acc516a	79	for (i = 0; i < insn->n; i++)
d6a929b7	80	data[i] = devpriv->ao_readback[chan];
d6a929b7 DS	81
	82	return i;
	83	}
	84
da91b269	85	static int dt2815_ao_insn(struct comedi_device dev, struct comedi_subdevice s,
0a85b6f0	86	struct comedi_insn insn, unsigned int data)
d6a929b7	87	{
9a1a6cf8	88	struct dt2815_private *devpriv = dev->private;
d6a929b7 DS	89	int i;
d6a929b7 DS	90	int chan = CR_CHAN(insn->chanspec);
d6a929b7	91	unsigned int lo, hi;
8a62fcbd	92	int ret;
d6a929b7 DS	93
d6a929b7 DS	94	for (i = 0; i < insn->n; i++) {
ed87d33d	95	/* FIXME: lo bit 0 chooses voltage output or current output */
d6a929b7 DS	96	lo = ((data[i] & 0x0f) << 4) \| (chan << 1) \| 0x01;
	97	hi = (data[i] & 0xff0) >> 4;
	98
8a62fcbd	99	ret = comedi_timeout(dev, s, insn, dt2815_ao_status, 0x00);
22ca19d9	100	if (ret)
8a62fcbd	101	return ret;
d6a929b7 DS	102
	103	outb(lo, dev->iobase + DT2815_DATA);
	104
8a62fcbd	105	ret = comedi_timeout(dev, s, insn, dt2815_ao_status, 0x10);
22ca19d9	106	if (ret)
8a62fcbd	107	return ret;
8a62fcbd	108
ed87d33d IA	109	outb(hi, dev->iobase + DT2815_DATA);
ed87d33d IA	110
d6a929b7 DS	111	devpriv->ao_readback[chan] = data[i];
	112	}
	113	return i;
	114	}
	115
	116	/*
62c701d7 RKM	117	* options[0] Board base address
	118	* options[1] IRQ (not applicable)
	119	* options[2] Voltage unipolar/bipolar configuration
	120	* 0 == unipolar 5V (0V -- +5V)
	121	* 1 == bipolar 5V (-5V -- +5V)
	122	* options[3] Current offset configuration
	123	* 0 == disabled (0mA -- +32mAV)
	124	* 1 == enabled (+4mA -- +20mAV)
	125	* options[4] Firmware program configuration
	126	* 0 == program 1 (see manual table 5-4)
	127	* 1 == program 2 (see manual table 5-4)
	128	* 2 == program 3 (see manual table 5-4)
	129	* 3 == program 4 (see manual table 5-4)
	130	* options[5] Analog output 0 range configuration
	131	* 0 == voltage
	132	* 1 == current
	133	* options[6] Analog output 1 range configuration
	134	* ...
	135	* options[12] Analog output 7 range configuration
	136	* 0 == voltage
	137	* 1 == current
d6a929b7 DS	138	*/
d6a929b7 DS	139
da91b269	140	static int dt2815_attach(struct comedi_device dev, struct comedi_devconfig it)
d6a929b7	141	{
9a1a6cf8	142	struct dt2815_private *devpriv;
34c43922	143	struct comedi_subdevice *s;
d6a929b7	144	int i;
9ced1de6	145	const struct comedi_lrange current_range_type, voltage_range_type;
8b6c5694	146	int ret;
d6a929b7	147
862755ec	148	ret = comedi_request_region(dev, it->options[0], 0x2);
19b3da3e HS	149	if (ret)
19b3da3e HS	150	return ret;
d6a929b7	151
8b6c5694 HS	152	ret = comedi_alloc_subdevices(dev, 1);
	153	if (ret)
	154	return ret;
	155
0bdab509	156	devpriv = comedi_alloc_devpriv(dev, sizeof(*devpriv));
c34fa261 HS	157	if (!devpriv)
c34fa261 HS	158	return -ENOMEM;
d6a929b7	159
76c40c47	160	s = &dev->subdevices[0];
d6a929b7 DS	161	/* ao subdevice */
	162	s->type = COMEDI_SUBD_AO;
	163	s->subdev_flags = SDF_WRITABLE;
	164	s->maxdata = 0xfff;
	165	s->n_chan = 8;
	166	s->insn_write = dt2815_ao_insn;
	167	s->insn_read = dt2815_ao_insn_read;
	168	s->range_table_list = devpriv->range_type_list;
	169
	170	current_range_type = (it->options[3])
2c71c4ff	171	? &range_4_20mA : &range_0_32mA;
d6a929b7	172	voltage_range_type = (it->options[2])
0a85b6f0	173	? &range_bipolar5 : &range_unipolar5;
d6a929b7 DS	174	for (i = 0; i < 8; i++) {
d6a929b7 DS	175	devpriv->range_type_list[i] = (it->options[5 + i])
0a85b6f0	176	? current_range_type : voltage_range_type;
d6a929b7 DS	177	}
	178
	179	/* Init the 2815 */
	180	outb(0x00, dev->iobase + DT2815_STATUS);
	181	for (i = 0; i < 100; i++) {
	182	/* This is incredibly slow (approx 20 ms) */
	183	unsigned int status;
	184
1b2d7f19	185	usleep_range(1000, 3000);
d6a929b7 DS	186	status = inb(dev->iobase + DT2815_STATUS);
	187	if (status == 4) {
	188	unsigned int program;
f61b57a4	189
d6a929b7 DS	190	program = (it->options[4] & 0x3) << 3 \| 0x7;
d6a929b7 DS	191	outb(program, dev->iobase + DT2815_DATA);
5b7b0eb2 HS	192	dev_dbg(dev->class_dev, "program: 0x%x (@t=%d)\n",
5b7b0eb2 HS	193	program, i);
d6a929b7 DS	194	break;
d6a929b7 DS	195	} else if (status != 0x00) {
5b7b0eb2 HS	196	dev_dbg(dev->class_dev,
	197	"unexpected status 0x%x (@t=%d)\n",
	198	status, i);
0acc516a	199	if (status & 0x60)
d6a929b7	200	outb(0x00, dev->iobase + DT2815_STATUS);
d6a929b7 DS	201	}
	202	}
	203
d6a929b7 DS	204	return 0;
	205	}
	206
294f930d	207	static struct comedi_driver dt2815_driver = {
b85eec95 HS	208	.driver_name = "dt2815",
	209	.module = THIS_MODULE,
	210	.attach = dt2815_attach,
21208519	211	.detach = comedi_legacy_detach,
b85eec95	212	};
294f930d	213	module_comedi_driver(dt2815_driver);
b85eec95	214
90f703d3 AT	215	MODULE_AUTHOR("Comedi http://www.comedi.org");
	216	MODULE_DESCRIPTION("Comedi low-level driver");
	217	MODULE_LICENSE("GPL");