blob: f018953a5485238e088ad1b9483177b077d3ae2b [file] [log] [blame]
Linus Torvalds1da177e2005-04-16 15:20:36 -07001/******************************************************************************
2 * mtouchusb.c -- Driver for Microtouch (Now 3M) USB Touchscreens
3 *
4 * This program is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU General Public License as
6 * published by the Free Software Foundation; either version 2 of the
7 * License, or (at your option) any later version.
8 *
9 * This program is distributed in the hope that it will be useful, but
10 * WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * General Public License for more details.
13 *
14 * You should have received a copy of the GNU General Public License
15 * along with this program; if not, write to the Free Software
16 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
17 *
18 * Based upon original work by Radoslaw Garbacz (usb-support@ite.pl)
19 * (http://freshmeat.net/projects/3mtouchscreendriver)
20 *
21 * History
22 *
23 * 0.3 & 0.4 2002 (TEJ) tejohnson@yahoo.com
24 * Updated to 2.4.18, then 2.4.19
25 * Old version still relied on stealing a minor
26 *
27 * 0.5 02/26/2004 (TEJ) tejohnson@yahoo.com
28 * Complete rewrite using Linux Input in 2.6.3
29 * Unfortunately no calibration support at this time
30 *
31 * 1.4 04/25/2004 (TEJ) tejohnson@yahoo.com
32 * Changed reset from standard USB dev reset to vendor reset
33 * Changed data sent to host from compensated to raw coordinates
34 * Eliminated vendor/product module params
Steven Cole093cf722005-05-03 19:07:24 -060035 * Performed multiple successful tests with an EXII-5010UC
Linus Torvalds1da177e2005-04-16 15:20:36 -070036 *
37 * 1.5 02/27/2005 ddstreet@ieee.org
38 * Added module parameter to select raw or hw-calibrated coordinate reporting
39 *
40 *****************************************************************************/
41
42#include <linux/config.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070043#include <linux/kernel.h>
44#include <linux/slab.h>
45#include <linux/input.h>
46#include <linux/module.h>
47#include <linux/init.h>
48#include <linux/usb.h>
Dmitry Torokhov16a334c2005-06-30 00:49:08 -050049#include <linux/usb_input.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070050
51#define MTOUCHUSB_MIN_XC 0x0
52#define MTOUCHUSB_MAX_RAW_XC 0x4000
53#define MTOUCHUSB_MAX_CALIB_XC 0xffff
54#define MTOUCHUSB_XC_FUZZ 0x0
55#define MTOUCHUSB_XC_FLAT 0x0
56#define MTOUCHUSB_MIN_YC 0x0
57#define MTOUCHUSB_MAX_RAW_YC 0x4000
58#define MTOUCHUSB_MAX_CALIB_YC 0xffff
59#define MTOUCHUSB_YC_FUZZ 0x0
60#define MTOUCHUSB_YC_FLAT 0x0
61
62#define MTOUCHUSB_ASYNC_REPORT 1
63#define MTOUCHUSB_RESET 7
64#define MTOUCHUSB_REPORT_DATA_SIZE 11
65#define MTOUCHUSB_REQ_CTRLLR_ID 10
66
67#define MTOUCHUSB_GET_RAW_XC(data) (data[8]<<8 | data[7])
68#define MTOUCHUSB_GET_CALIB_XC(data) (data[4]<<8 | data[3])
69#define MTOUCHUSB_GET_RAW_YC(data) (data[10]<<8 | data[9])
70#define MTOUCHUSB_GET_CALIB_YC(data) (data[6]<<8 | data[5])
71#define MTOUCHUSB_GET_XC(data) (raw_coordinates ? \
72 MTOUCHUSB_GET_RAW_XC(data) : \
73 MTOUCHUSB_GET_CALIB_XC(data))
74#define MTOUCHUSB_GET_YC(data) (raw_coordinates ? \
75 MTOUCHUSB_GET_RAW_YC(data) : \
76 MTOUCHUSB_GET_CALIB_YC(data))
77#define MTOUCHUSB_GET_TOUCHED(data) ((data[2] & 0x40) ? 1:0)
78
79#define DRIVER_VERSION "v1.5"
80#define DRIVER_AUTHOR "Todd E. Johnson, tejohnson@yahoo.com"
81#define DRIVER_DESC "3M USB Touchscreen Driver"
82#define DRIVER_LICENSE "GPL"
83
84static int raw_coordinates = 1;
85
86module_param(raw_coordinates, bool, S_IRUGO | S_IWUSR);
87MODULE_PARM_DESC(raw_coordinates, "report raw coordinate values (y, default) or hardware-calibrated coordinate values (n)");
88
89struct mtouch_usb {
Dmitry Torokhov8baf9ed2005-05-29 02:29:08 -050090 unsigned char *data;
91 dma_addr_t data_dma;
92 struct urb *irq;
93 struct usb_device *udev;
Dmitry Torokhovc5b7c7c2005-09-15 02:01:47 -050094 struct input_dev *input;
Dmitry Torokhov8baf9ed2005-05-29 02:29:08 -050095 char name[128];
96 char phys[64];
Linus Torvalds1da177e2005-04-16 15:20:36 -070097};
98
Dmitry Torokhov8baf9ed2005-05-29 02:29:08 -050099static struct usb_device_id mtouchusb_devices[] = {
100 { USB_DEVICE(0x0596, 0x0001) },
101 { }
Linus Torvalds1da177e2005-04-16 15:20:36 -0700102};
103
104static void mtouchusb_irq(struct urb *urb, struct pt_regs *regs)
105{
Dmitry Torokhov8baf9ed2005-05-29 02:29:08 -0500106 struct mtouch_usb *mtouch = urb->context;
107 int retval;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700108
Dmitry Torokhov8baf9ed2005-05-29 02:29:08 -0500109 switch (urb->status) {
110 case 0:
111 /* success */
112 break;
113 case -ETIMEDOUT:
114 /* this urb is timing out */
115 dbg("%s - urb timed out - was the device unplugged?",
116 __FUNCTION__);
117 return;
118 case -ECONNRESET:
119 case -ENOENT:
120 case -ESHUTDOWN:
121 /* this urb is terminated, clean up */
122 dbg("%s - urb shutting down with status: %d",
123 __FUNCTION__, urb->status);
124 return;
125 default:
126 dbg("%s - nonzero urb status received: %d",
127 __FUNCTION__, urb->status);
128 goto exit;
129 }
Linus Torvalds1da177e2005-04-16 15:20:36 -0700130
Dmitry Torokhovc5b7c7c2005-09-15 02:01:47 -0500131 input_regs(mtouch->input, regs);
132 input_report_key(mtouch->input, BTN_TOUCH,
Dmitry Torokhov8baf9ed2005-05-29 02:29:08 -0500133 MTOUCHUSB_GET_TOUCHED(mtouch->data));
Dmitry Torokhovc5b7c7c2005-09-15 02:01:47 -0500134 input_report_abs(mtouch->input, ABS_X, MTOUCHUSB_GET_XC(mtouch->data));
135 input_report_abs(mtouch->input, ABS_Y,
Linus Torvalds1da177e2005-04-16 15:20:36 -0700136 (raw_coordinates ? MTOUCHUSB_MAX_RAW_YC : MTOUCHUSB_MAX_CALIB_YC)
Dmitry Torokhov8baf9ed2005-05-29 02:29:08 -0500137 - MTOUCHUSB_GET_YC(mtouch->data));
Dmitry Torokhovc5b7c7c2005-09-15 02:01:47 -0500138 input_sync(mtouch->input);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700139
140exit:
Dmitry Torokhov8baf9ed2005-05-29 02:29:08 -0500141 retval = usb_submit_urb(urb, GFP_ATOMIC);
142 if (retval)
143 err("%s - usb_submit_urb failed with result: %d",
144 __FUNCTION__, retval);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700145}
146
Dmitry Torokhov8baf9ed2005-05-29 02:29:08 -0500147static int mtouchusb_open(struct input_dev *input)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700148{
Dmitry Torokhov8baf9ed2005-05-29 02:29:08 -0500149 struct mtouch_usb *mtouch = input->private;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700150
Dmitry Torokhov8baf9ed2005-05-29 02:29:08 -0500151 mtouch->irq->dev = mtouch->udev;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700152
Dmitry Torokhov65cde542005-05-29 02:29:38 -0500153 if (usb_submit_urb(mtouch->irq, GFP_ATOMIC))
Dmitry Torokhov8baf9ed2005-05-29 02:29:08 -0500154 return -EIO;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700155
Dmitry Torokhov8baf9ed2005-05-29 02:29:08 -0500156 return 0;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700157}
158
Dmitry Torokhov8baf9ed2005-05-29 02:29:08 -0500159static void mtouchusb_close(struct input_dev *input)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700160{
Dmitry Torokhov8baf9ed2005-05-29 02:29:08 -0500161 struct mtouch_usb *mtouch = input->private;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700162
Dmitry Torokhov65cde542005-05-29 02:29:38 -0500163 usb_kill_urb(mtouch->irq);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700164}
165
166static int mtouchusb_alloc_buffers(struct usb_device *udev, struct mtouch_usb *mtouch)
167{
Dmitry Torokhov8baf9ed2005-05-29 02:29:08 -0500168 dbg("%s - called", __FUNCTION__);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700169
Dmitry Torokhov8baf9ed2005-05-29 02:29:08 -0500170 mtouch->data = usb_buffer_alloc(udev, MTOUCHUSB_REPORT_DATA_SIZE,
171 SLAB_ATOMIC, &mtouch->data_dma);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700172
Dmitry Torokhov8baf9ed2005-05-29 02:29:08 -0500173 if (!mtouch->data)
174 return -1;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700175
Dmitry Torokhov8baf9ed2005-05-29 02:29:08 -0500176 return 0;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700177}
178
179static void mtouchusb_free_buffers(struct usb_device *udev, struct mtouch_usb *mtouch)
180{
Dmitry Torokhov8baf9ed2005-05-29 02:29:08 -0500181 dbg("%s - called", __FUNCTION__);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700182
Dmitry Torokhov8baf9ed2005-05-29 02:29:08 -0500183 if (mtouch->data)
184 usb_buffer_free(udev, MTOUCHUSB_REPORT_DATA_SIZE,
185 mtouch->data, mtouch->data_dma);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700186}
187
188static int mtouchusb_probe(struct usb_interface *intf, const struct usb_device_id *id)
189{
Dmitry Torokhov8baf9ed2005-05-29 02:29:08 -0500190 struct mtouch_usb *mtouch;
Dmitry Torokhovc5b7c7c2005-09-15 02:01:47 -0500191 struct input_dev *input_dev;
Dmitry Torokhov8baf9ed2005-05-29 02:29:08 -0500192 struct usb_host_interface *interface;
193 struct usb_endpoint_descriptor *endpoint;
194 struct usb_device *udev = interface_to_usbdev(intf);
Dmitry Torokhov8baf9ed2005-05-29 02:29:08 -0500195 int nRet;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700196
Dmitry Torokhov8baf9ed2005-05-29 02:29:08 -0500197 dbg("%s - called", __FUNCTION__);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700198
Dmitry Torokhov8baf9ed2005-05-29 02:29:08 -0500199 dbg("%s - setting interface", __FUNCTION__);
200 interface = intf->cur_altsetting;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700201
Dmitry Torokhov8baf9ed2005-05-29 02:29:08 -0500202 dbg("%s - setting endpoint", __FUNCTION__);
203 endpoint = &interface->endpoint[0].desc;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700204
Dmitry Torokhovc5b7c7c2005-09-15 02:01:47 -0500205 mtouch = kzalloc(sizeof(struct mtouch_usb), GFP_KERNEL);
206 input_dev = input_allocate_device();
207 if (!mtouch || !input_dev) {
Dmitry Torokhov8baf9ed2005-05-29 02:29:08 -0500208 err("%s - Out of memory.", __FUNCTION__);
Dmitry Torokhovc5b7c7c2005-09-15 02:01:47 -0500209 goto fail1;
Dmitry Torokhov8baf9ed2005-05-29 02:29:08 -0500210 }
Linus Torvalds1da177e2005-04-16 15:20:36 -0700211
Dmitry Torokhov8baf9ed2005-05-29 02:29:08 -0500212 dbg("%s - allocating buffers", __FUNCTION__);
Dmitry Torokhovc5b7c7c2005-09-15 02:01:47 -0500213 if (mtouchusb_alloc_buffers(udev, mtouch))
214 goto fail2;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700215
Dmitry Torokhovc5b7c7c2005-09-15 02:01:47 -0500216 mtouch->udev = udev;
217 mtouch->input = input_dev;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700218
219 if (udev->manufacturer)
Dmitry Torokhovc5b7c7c2005-09-15 02:01:47 -0500220 strlcpy(mtouch->name, udev->manufacturer, sizeof(mtouch->name));
221
222 if (udev->product) {
223 if (udev->manufacturer)
224 strlcat(mtouch->name, " ", sizeof(mtouch->name));
225 strlcat(mtouch->name, udev->product, sizeof(mtouch->name));
226 }
Linus Torvalds1da177e2005-04-16 15:20:36 -0700227
Dmitry Torokhov8baf9ed2005-05-29 02:29:08 -0500228 if (!strlen(mtouch->name))
Dmitry Torokhovc5b7c7c2005-09-15 02:01:47 -0500229 snprintf(mtouch->name, sizeof(mtouch->name),
230 "USB Touchscreen %04x:%04x",
231 le16_to_cpu(udev->descriptor.idVendor),
232 le16_to_cpu(udev->descriptor.idProduct));
233
234 usb_make_path(udev, mtouch->phys, sizeof(mtouch->phys));
235 strlcpy(mtouch->phys, "/input0", sizeof(mtouch->phys));
236
237 input_dev->name = mtouch->name;
238 input_dev->phys = mtouch->phys;
239 usb_to_input_id(udev, &input_dev->id);
240 input_dev->cdev.dev = &intf->dev;
241 input_dev->private = mtouch;
242
243 input_dev->open = mtouchusb_open;
244 input_dev->close = mtouchusb_close;
245
246 input_dev->evbit[0] = BIT(EV_KEY) | BIT(EV_ABS);
247 input_dev->keybit[LONG(BTN_TOUCH)] = BIT(BTN_TOUCH);
248 input_set_abs_params(input_dev, ABS_X, MTOUCHUSB_MIN_XC,
249 raw_coordinates ? MTOUCHUSB_MAX_RAW_XC : MTOUCHUSB_MAX_CALIB_XC,
250 MTOUCHUSB_XC_FUZZ, MTOUCHUSB_XC_FLAT);
251 input_set_abs_params(input_dev, ABS_Y, MTOUCHUSB_MIN_YC,
252 raw_coordinates ? MTOUCHUSB_MAX_RAW_YC : MTOUCHUSB_MAX_CALIB_YC,
253 MTOUCHUSB_YC_FUZZ, MTOUCHUSB_YC_FLAT);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700254
Dmitry Torokhov8baf9ed2005-05-29 02:29:08 -0500255 nRet = usb_control_msg(mtouch->udev, usb_rcvctrlpipe(udev, 0),
256 MTOUCHUSB_RESET,
257 USB_DIR_OUT | USB_TYPE_VENDOR | USB_RECIP_DEVICE,
258 1, 0, NULL, 0, USB_CTRL_SET_TIMEOUT);
259 dbg("%s - usb_control_msg - MTOUCHUSB_RESET - bytes|err: %d",
260 __FUNCTION__, nRet);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700261
Dmitry Torokhov8baf9ed2005-05-29 02:29:08 -0500262 dbg("%s - usb_alloc_urb: mtouch->irq", __FUNCTION__);
263 mtouch->irq = usb_alloc_urb(0, GFP_KERNEL);
264 if (!mtouch->irq) {
265 dbg("%s - usb_alloc_urb failed: mtouch->irq", __FUNCTION__);
Dmitry Torokhovc5b7c7c2005-09-15 02:01:47 -0500266 goto fail2;
Dmitry Torokhov8baf9ed2005-05-29 02:29:08 -0500267 }
Linus Torvalds1da177e2005-04-16 15:20:36 -0700268
Dmitry Torokhov8baf9ed2005-05-29 02:29:08 -0500269 dbg("%s - usb_fill_int_urb", __FUNCTION__);
270 usb_fill_int_urb(mtouch->irq, mtouch->udev,
271 usb_rcvintpipe(mtouch->udev, 0x81),
272 mtouch->data, MTOUCHUSB_REPORT_DATA_SIZE,
273 mtouchusb_irq, mtouch, endpoint->bInterval);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700274
Dmitry Torokhov8baf9ed2005-05-29 02:29:08 -0500275 dbg("%s - input_register_device", __FUNCTION__);
Dmitry Torokhovc5b7c7c2005-09-15 02:01:47 -0500276 input_register_device(mtouch->input);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700277
Dmitry Torokhov8baf9ed2005-05-29 02:29:08 -0500278 nRet = usb_control_msg(mtouch->udev, usb_rcvctrlpipe(udev, 0),
279 MTOUCHUSB_ASYNC_REPORT,
280 USB_DIR_OUT | USB_TYPE_VENDOR | USB_RECIP_DEVICE,
281 1, 1, NULL, 0, USB_CTRL_SET_TIMEOUT);
282 dbg("%s - usb_control_msg - MTOUCHUSB_ASYNC_REPORT - bytes|err: %d",
283 __FUNCTION__, nRet);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700284
Dmitry Torokhov8baf9ed2005-05-29 02:29:08 -0500285 usb_set_intfdata(intf, mtouch);
Dmitry Torokhov8baf9ed2005-05-29 02:29:08 -0500286 return 0;
Dmitry Torokhovc5b7c7c2005-09-15 02:01:47 -0500287
288fail2: mtouchusb_free_buffers(udev, mtouch);
289fail1: input_free_device(input_dev);
290 kfree(mtouch);
291 return -ENOMEM;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700292}
293
294static void mtouchusb_disconnect(struct usb_interface *intf)
295{
Dmitry Torokhov8baf9ed2005-05-29 02:29:08 -0500296 struct mtouch_usb *mtouch = usb_get_intfdata(intf);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700297
Dmitry Torokhov8baf9ed2005-05-29 02:29:08 -0500298 dbg("%s - called", __FUNCTION__);
299 usb_set_intfdata(intf, NULL);
300 if (mtouch) {
301 dbg("%s - mtouch is initialized, cleaning up", __FUNCTION__);
302 usb_kill_urb(mtouch->irq);
Dmitry Torokhovc5b7c7c2005-09-15 02:01:47 -0500303 input_unregister_device(mtouch->input);
Dmitry Torokhov8baf9ed2005-05-29 02:29:08 -0500304 usb_free_urb(mtouch->irq);
305 mtouchusb_free_buffers(interface_to_usbdev(intf), mtouch);
306 kfree(mtouch);
307 }
Linus Torvalds1da177e2005-04-16 15:20:36 -0700308}
309
Dmitry Torokhov8baf9ed2005-05-29 02:29:08 -0500310MODULE_DEVICE_TABLE(usb, mtouchusb_devices);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700311
312static struct usb_driver mtouchusb_driver = {
Dmitry Torokhov8baf9ed2005-05-29 02:29:08 -0500313 .name = "mtouchusb",
314 .probe = mtouchusb_probe,
315 .disconnect = mtouchusb_disconnect,
316 .id_table = mtouchusb_devices,
Linus Torvalds1da177e2005-04-16 15:20:36 -0700317};
318
Dmitry Torokhov8baf9ed2005-05-29 02:29:08 -0500319static int __init mtouchusb_init(void)
320{
321 dbg("%s - called", __FUNCTION__);
322 return usb_register(&mtouchusb_driver);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700323}
324
Dmitry Torokhov8baf9ed2005-05-29 02:29:08 -0500325static void __exit mtouchusb_cleanup(void)
326{
327 dbg("%s - called", __FUNCTION__);
328 usb_deregister(&mtouchusb_driver);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700329}
330
331module_init(mtouchusb_init);
332module_exit(mtouchusb_cleanup);
333
Dmitry Torokhov8baf9ed2005-05-29 02:29:08 -0500334MODULE_AUTHOR(DRIVER_AUTHOR);
335MODULE_DESCRIPTION(DRIVER_DESC);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700336MODULE_LICENSE("GPL");