1// SPDX-License-Identifier: GPL-2.0+
2/*
3 * Driver for Amplicon PC263 relay board.
4 *
5 * Copyright (C) 2002 MEV Ltd. <https://www.mev.co.uk/>
6 *
7 * COMEDI - Linux Control and Measurement Device Interface
8 * Copyright (C) 2000 David A. Schleef <ds@schleef.org>
9 */
10
11/*
12 * Driver: amplc_pc263
13 * Description: Amplicon PC263
14 * Author: Ian Abbott <abbotti@mev.co.uk>
15 * Devices: [Amplicon] PC263 (pc263)
16 * Updated: Fri, 12 Apr 2013 15:19:36 +0100
17 * Status: works
18 *
19 * Configuration options:
20 *   [0] - I/O port base address
21 *
22 * The board appears as one subdevice, with 16 digital outputs, each
23 * connected to a reed-relay. Relay contacts are closed when output is 1.
24 * The state of the outputs can be read.
25 */
26
27#include <linux/module.h>
28#include <linux/comedi/comedidev.h>
29
30/* PC263 registers */
31#define PC263_DO_0_7_REG	0x00
32#define PC263_DO_8_15_REG	0x01
33
34struct pc263_board {
35	const char *name;
36};
37
38static const struct pc263_board pc263_boards[] = {
39	{
40		.name = "pc263",
41	},
42};
43
44static int pc263_do_insn_bits(struct comedi_device *dev,
45			      struct comedi_subdevice *s,
46			      struct comedi_insn *insn,
47			      unsigned int *data)
48{
49	if (comedi_dio_update_state(s, data)) {
50		outb(s->state & 0xff, dev->iobase + PC263_DO_0_7_REG);
51		outb((s->state >> 8) & 0xff, dev->iobase + PC263_DO_8_15_REG);
52	}
53
54	data[1] = s->state;
55
56	return insn->n;
57}
58
59static int pc263_attach(struct comedi_device *dev, struct comedi_devconfig *it)
60{
61	struct comedi_subdevice *s;
62	int ret;
63
64	ret = comedi_request_region(dev, it->options[0], 0x2);
65	if (ret)
66		return ret;
67
68	ret = comedi_alloc_subdevices(dev, 1);
69	if (ret)
70		return ret;
71
72	/* Digital Output subdevice */
73	s = &dev->subdevices[0];
74	s->type		= COMEDI_SUBD_DO;
75	s->subdev_flags	= SDF_WRITABLE;
76	s->n_chan	= 16;
77	s->maxdata	= 1;
78	s->range_table	= &range_digital;
79	s->insn_bits	= pc263_do_insn_bits;
80
81	/* read initial relay state */
82	s->state = inb(dev->iobase + PC263_DO_0_7_REG) |
83		   (inb(dev->iobase + PC263_DO_8_15_REG) << 8);
84
85	return 0;
86}
87
88static struct comedi_driver amplc_pc263_driver = {
89	.driver_name	= "amplc_pc263",
90	.module		= THIS_MODULE,
91	.attach		= pc263_attach,
92	.detach		= comedi_legacy_detach,
93	.board_name	= &pc263_boards[0].name,
94	.offset		= sizeof(struct pc263_board),
95	.num_names	= ARRAY_SIZE(pc263_boards),
96};
97
98module_comedi_driver(amplc_pc263_driver);
99
100MODULE_AUTHOR("Comedi https://www.comedi.org");
101MODULE_DESCRIPTION("Comedi driver for Amplicon PC263 relay board");
102MODULE_LICENSE("GPL");
103