1*4882a593Smuzhiyun // SPDX-License-Identifier: GPL-2.0-only
2*4882a593Smuzhiyun /*
3*4882a593Smuzhiyun * Sahara TouchIT-213 serial touchscreen driver
4*4882a593Smuzhiyun *
5*4882a593Smuzhiyun * Copyright (c) 2007-2008 Claudio Nieder <private@claudio.ch>
6*4882a593Smuzhiyun *
7*4882a593Smuzhiyun * Based on Touchright driver (drivers/input/touchscreen/touchright.c)
8*4882a593Smuzhiyun * Copyright (c) 2006 Rick Koch <n1gp@hotmail.com>
9*4882a593Smuzhiyun * Copyright (c) 2004 Vojtech Pavlik
10*4882a593Smuzhiyun * and Dan Streetman <ddstreet@ieee.org>
11*4882a593Smuzhiyun */
12*4882a593Smuzhiyun
13*4882a593Smuzhiyun
14*4882a593Smuzhiyun #include <linux/errno.h>
15*4882a593Smuzhiyun #include <linux/kernel.h>
16*4882a593Smuzhiyun #include <linux/module.h>
17*4882a593Smuzhiyun #include <linux/slab.h>
18*4882a593Smuzhiyun #include <linux/input.h>
19*4882a593Smuzhiyun #include <linux/serio.h>
20*4882a593Smuzhiyun
21*4882a593Smuzhiyun #define DRIVER_DESC "Sahara TouchIT-213 serial touchscreen driver"
22*4882a593Smuzhiyun
23*4882a593Smuzhiyun MODULE_AUTHOR("Claudio Nieder <private@claudio.ch>");
24*4882a593Smuzhiyun MODULE_DESCRIPTION(DRIVER_DESC);
25*4882a593Smuzhiyun MODULE_LICENSE("GPL");
26*4882a593Smuzhiyun
27*4882a593Smuzhiyun /*
28*4882a593Smuzhiyun * Definitions & global arrays.
29*4882a593Smuzhiyun */
30*4882a593Smuzhiyun
31*4882a593Smuzhiyun /*
32*4882a593Smuzhiyun * Data is received through COM1 at 9600bit/s,8bit,no parity in packets
33*4882a593Smuzhiyun * of 5 byte each.
34*4882a593Smuzhiyun *
35*4882a593Smuzhiyun * +--------+ +--------+ +--------+ +--------+ +--------+
36*4882a593Smuzhiyun * |1000000p| |0xxxxxxx| |0xxxxxxx| |0yyyyyyy| |0yyyyyyy|
37*4882a593Smuzhiyun * +--------+ +--------+ +--------+ +--------+ +--------+
38*4882a593Smuzhiyun * MSB LSB MSB LSB
39*4882a593Smuzhiyun *
40*4882a593Smuzhiyun * The value of p is 1 as long as the screen is touched and 0 when
41*4882a593Smuzhiyun * reporting the location where touching stopped, e.g. where the pen was
42*4882a593Smuzhiyun * lifted from the screen.
43*4882a593Smuzhiyun *
44*4882a593Smuzhiyun * When holding the screen in landscape mode as the BIOS text output is
45*4882a593Smuzhiyun * presented, x is the horizontal axis with values growing from left to
46*4882a593Smuzhiyun * right and y is the vertical axis with values growing from top to
47*4882a593Smuzhiyun * bottom.
48*4882a593Smuzhiyun *
49*4882a593Smuzhiyun * When holding the screen in portrait mode with the Sahara logo in its
50*4882a593Smuzhiyun * correct position, x ist the vertical axis with values growing from
51*4882a593Smuzhiyun * top to bottom and y is the horizontal axis with values growing from
52*4882a593Smuzhiyun * right to left.
53*4882a593Smuzhiyun */
54*4882a593Smuzhiyun
55*4882a593Smuzhiyun #define T213_FORMAT_TOUCH_BIT 0x01
56*4882a593Smuzhiyun #define T213_FORMAT_STATUS_BYTE 0x80
57*4882a593Smuzhiyun #define T213_FORMAT_STATUS_MASK ~T213_FORMAT_TOUCH_BIT
58*4882a593Smuzhiyun
59*4882a593Smuzhiyun /*
60*4882a593Smuzhiyun * On my Sahara Touch-IT 213 I have observed x values from 0 to 0x7f0
61*4882a593Smuzhiyun * and y values from 0x1d to 0x7e9, so the actual measurement is
62*4882a593Smuzhiyun * probably done with an 11 bit precision.
63*4882a593Smuzhiyun */
64*4882a593Smuzhiyun #define T213_MIN_XC 0
65*4882a593Smuzhiyun #define T213_MAX_XC 0x07ff
66*4882a593Smuzhiyun #define T213_MIN_YC 0
67*4882a593Smuzhiyun #define T213_MAX_YC 0x07ff
68*4882a593Smuzhiyun
69*4882a593Smuzhiyun /*
70*4882a593Smuzhiyun * Per-touchscreen data.
71*4882a593Smuzhiyun */
72*4882a593Smuzhiyun
73*4882a593Smuzhiyun struct touchit213 {
74*4882a593Smuzhiyun struct input_dev *dev;
75*4882a593Smuzhiyun struct serio *serio;
76*4882a593Smuzhiyun int idx;
77*4882a593Smuzhiyun unsigned char csum;
78*4882a593Smuzhiyun unsigned char data[5];
79*4882a593Smuzhiyun char phys[32];
80*4882a593Smuzhiyun };
81*4882a593Smuzhiyun
touchit213_interrupt(struct serio * serio,unsigned char data,unsigned int flags)82*4882a593Smuzhiyun static irqreturn_t touchit213_interrupt(struct serio *serio,
83*4882a593Smuzhiyun unsigned char data, unsigned int flags)
84*4882a593Smuzhiyun {
85*4882a593Smuzhiyun struct touchit213 *touchit213 = serio_get_drvdata(serio);
86*4882a593Smuzhiyun struct input_dev *dev = touchit213->dev;
87*4882a593Smuzhiyun
88*4882a593Smuzhiyun touchit213->data[touchit213->idx] = data;
89*4882a593Smuzhiyun
90*4882a593Smuzhiyun switch (touchit213->idx++) {
91*4882a593Smuzhiyun case 0:
92*4882a593Smuzhiyun if ((touchit213->data[0] & T213_FORMAT_STATUS_MASK) !=
93*4882a593Smuzhiyun T213_FORMAT_STATUS_BYTE) {
94*4882a593Smuzhiyun pr_debug("unsynchronized data: 0x%02x\n", data);
95*4882a593Smuzhiyun touchit213->idx = 0;
96*4882a593Smuzhiyun }
97*4882a593Smuzhiyun break;
98*4882a593Smuzhiyun
99*4882a593Smuzhiyun case 4:
100*4882a593Smuzhiyun touchit213->idx = 0;
101*4882a593Smuzhiyun input_report_abs(dev, ABS_X,
102*4882a593Smuzhiyun (touchit213->data[1] << 7) | touchit213->data[2]);
103*4882a593Smuzhiyun input_report_abs(dev, ABS_Y,
104*4882a593Smuzhiyun (touchit213->data[3] << 7) | touchit213->data[4]);
105*4882a593Smuzhiyun input_report_key(dev, BTN_TOUCH,
106*4882a593Smuzhiyun touchit213->data[0] & T213_FORMAT_TOUCH_BIT);
107*4882a593Smuzhiyun input_sync(dev);
108*4882a593Smuzhiyun break;
109*4882a593Smuzhiyun }
110*4882a593Smuzhiyun
111*4882a593Smuzhiyun return IRQ_HANDLED;
112*4882a593Smuzhiyun }
113*4882a593Smuzhiyun
114*4882a593Smuzhiyun /*
115*4882a593Smuzhiyun * touchit213_disconnect() is the opposite of touchit213_connect()
116*4882a593Smuzhiyun */
117*4882a593Smuzhiyun
touchit213_disconnect(struct serio * serio)118*4882a593Smuzhiyun static void touchit213_disconnect(struct serio *serio)
119*4882a593Smuzhiyun {
120*4882a593Smuzhiyun struct touchit213 *touchit213 = serio_get_drvdata(serio);
121*4882a593Smuzhiyun
122*4882a593Smuzhiyun input_get_device(touchit213->dev);
123*4882a593Smuzhiyun input_unregister_device(touchit213->dev);
124*4882a593Smuzhiyun serio_close(serio);
125*4882a593Smuzhiyun serio_set_drvdata(serio, NULL);
126*4882a593Smuzhiyun input_put_device(touchit213->dev);
127*4882a593Smuzhiyun kfree(touchit213);
128*4882a593Smuzhiyun }
129*4882a593Smuzhiyun
130*4882a593Smuzhiyun /*
131*4882a593Smuzhiyun * touchit213_connect() is the routine that is called when someone adds a
132*4882a593Smuzhiyun * new serio device that supports the Touchright protocol and registers it as
133*4882a593Smuzhiyun * an input device.
134*4882a593Smuzhiyun */
135*4882a593Smuzhiyun
touchit213_connect(struct serio * serio,struct serio_driver * drv)136*4882a593Smuzhiyun static int touchit213_connect(struct serio *serio, struct serio_driver *drv)
137*4882a593Smuzhiyun {
138*4882a593Smuzhiyun struct touchit213 *touchit213;
139*4882a593Smuzhiyun struct input_dev *input_dev;
140*4882a593Smuzhiyun int err;
141*4882a593Smuzhiyun
142*4882a593Smuzhiyun touchit213 = kzalloc(sizeof(struct touchit213), GFP_KERNEL);
143*4882a593Smuzhiyun input_dev = input_allocate_device();
144*4882a593Smuzhiyun if (!touchit213 || !input_dev) {
145*4882a593Smuzhiyun err = -ENOMEM;
146*4882a593Smuzhiyun goto fail1;
147*4882a593Smuzhiyun }
148*4882a593Smuzhiyun
149*4882a593Smuzhiyun touchit213->serio = serio;
150*4882a593Smuzhiyun touchit213->dev = input_dev;
151*4882a593Smuzhiyun snprintf(touchit213->phys, sizeof(touchit213->phys),
152*4882a593Smuzhiyun "%s/input0", serio->phys);
153*4882a593Smuzhiyun
154*4882a593Smuzhiyun input_dev->name = "Sahara Touch-iT213 Serial TouchScreen";
155*4882a593Smuzhiyun input_dev->phys = touchit213->phys;
156*4882a593Smuzhiyun input_dev->id.bustype = BUS_RS232;
157*4882a593Smuzhiyun input_dev->id.vendor = SERIO_TOUCHIT213;
158*4882a593Smuzhiyun input_dev->id.product = 0;
159*4882a593Smuzhiyun input_dev->id.version = 0x0100;
160*4882a593Smuzhiyun input_dev->dev.parent = &serio->dev;
161*4882a593Smuzhiyun input_dev->evbit[0] = BIT_MASK(EV_KEY) | BIT_MASK(EV_ABS);
162*4882a593Smuzhiyun input_dev->keybit[BIT_WORD(BTN_TOUCH)] = BIT_MASK(BTN_TOUCH);
163*4882a593Smuzhiyun input_set_abs_params(touchit213->dev, ABS_X,
164*4882a593Smuzhiyun T213_MIN_XC, T213_MAX_XC, 0, 0);
165*4882a593Smuzhiyun input_set_abs_params(touchit213->dev, ABS_Y,
166*4882a593Smuzhiyun T213_MIN_YC, T213_MAX_YC, 0, 0);
167*4882a593Smuzhiyun
168*4882a593Smuzhiyun serio_set_drvdata(serio, touchit213);
169*4882a593Smuzhiyun
170*4882a593Smuzhiyun err = serio_open(serio, drv);
171*4882a593Smuzhiyun if (err)
172*4882a593Smuzhiyun goto fail2;
173*4882a593Smuzhiyun
174*4882a593Smuzhiyun err = input_register_device(touchit213->dev);
175*4882a593Smuzhiyun if (err)
176*4882a593Smuzhiyun goto fail3;
177*4882a593Smuzhiyun
178*4882a593Smuzhiyun return 0;
179*4882a593Smuzhiyun
180*4882a593Smuzhiyun fail3: serio_close(serio);
181*4882a593Smuzhiyun fail2: serio_set_drvdata(serio, NULL);
182*4882a593Smuzhiyun fail1: input_free_device(input_dev);
183*4882a593Smuzhiyun kfree(touchit213);
184*4882a593Smuzhiyun return err;
185*4882a593Smuzhiyun }
186*4882a593Smuzhiyun
187*4882a593Smuzhiyun /*
188*4882a593Smuzhiyun * The serio driver structure.
189*4882a593Smuzhiyun */
190*4882a593Smuzhiyun
191*4882a593Smuzhiyun static const struct serio_device_id touchit213_serio_ids[] = {
192*4882a593Smuzhiyun {
193*4882a593Smuzhiyun .type = SERIO_RS232,
194*4882a593Smuzhiyun .proto = SERIO_TOUCHIT213,
195*4882a593Smuzhiyun .id = SERIO_ANY,
196*4882a593Smuzhiyun .extra = SERIO_ANY,
197*4882a593Smuzhiyun },
198*4882a593Smuzhiyun { 0 }
199*4882a593Smuzhiyun };
200*4882a593Smuzhiyun
201*4882a593Smuzhiyun MODULE_DEVICE_TABLE(serio, touchit213_serio_ids);
202*4882a593Smuzhiyun
203*4882a593Smuzhiyun static struct serio_driver touchit213_drv = {
204*4882a593Smuzhiyun .driver = {
205*4882a593Smuzhiyun .name = "touchit213",
206*4882a593Smuzhiyun },
207*4882a593Smuzhiyun .description = DRIVER_DESC,
208*4882a593Smuzhiyun .id_table = touchit213_serio_ids,
209*4882a593Smuzhiyun .interrupt = touchit213_interrupt,
210*4882a593Smuzhiyun .connect = touchit213_connect,
211*4882a593Smuzhiyun .disconnect = touchit213_disconnect,
212*4882a593Smuzhiyun };
213*4882a593Smuzhiyun
214*4882a593Smuzhiyun module_serio_driver(touchit213_drv);
215