2 * HID driver for N-Trig touchscreens
4 * Copyright (c) 2008 Rafi Rubin
5 * Copyright (c) 2009 Stephane Chatty
10 * This program is free software; you can redistribute it and/or modify it
11 * under the terms of the GNU General Public License as published by the Free
12 * Software Foundation; either version 2 of the License, or (at your option)
16 #include <linux/device.h>
17 #include <linux/hid.h>
18 #include <linux/module.h>
22 #define NTRIG_DUPLICATE_USAGES 0x001
24 #define nt_map_key_clear(c) hid_map_usage_clear(hi, usage, bit, max, \
28 /* Incoming raw values for a single contact */
34 __u8 first_contact_confidence;
41 * this driver is aimed at two firmware versions in circulation:
42 * - dual pen/finger single touch
43 * - finger multitouch, pen not working
46 static int ntrig_input_mapping(struct hid_device *hdev, struct hid_input *hi,
47 struct hid_field *field, struct hid_usage *usage,
48 unsigned long **bit, int *max)
50 /* No special mappings needed for the pen and single touch */
54 switch (usage->hid & HID_USAGE_PAGE) {
58 hid_map_usage(hi, usage, bit, max,
59 EV_ABS, ABS_MT_POSITION_X);
60 input_set_abs_params(hi->input, ABS_X,
61 field->logical_minimum,
62 field->logical_maximum, 0, 0);
65 hid_map_usage(hi, usage, bit, max,
66 EV_ABS, ABS_MT_POSITION_Y);
67 input_set_abs_params(hi->input, ABS_Y,
68 field->logical_minimum,
69 field->logical_maximum, 0, 0);
74 case HID_UP_DIGITIZER:
76 /* we do not want to map these for now */
77 case HID_DG_CONTACTID: /* Not trustworthy, squelch for now */
78 case HID_DG_INPUTMODE:
79 case HID_DG_DEVICEINDEX:
80 case HID_DG_CONTACTMAX:
83 /* width/height mapped on TouchMajor/TouchMinor/Orientation */
85 hid_map_usage(hi, usage, bit, max,
86 EV_ABS, ABS_MT_TOUCH_MAJOR);
89 hid_map_usage(hi, usage, bit, max,
90 EV_ABS, ABS_MT_TOUCH_MINOR);
91 input_set_abs_params(hi->input, ABS_MT_ORIENTATION,
98 /* we do not want to map these: no input-oriented meaning */
105 static int ntrig_input_mapped(struct hid_device *hdev, struct hid_input *hi,
106 struct hid_field *field, struct hid_usage *usage,
107 unsigned long **bit, int *max)
109 /* No special mappings needed for the pen and single touch */
113 if (usage->type == EV_KEY || usage->type == EV_REL
114 || usage->type == EV_ABS)
115 clear_bit(usage->code, *bit);
121 * this function is called upon all reports
122 * so that we can filter contact point information,
123 * decide whether we are in multi or single touch mode
124 * and call input_mt_sync after each point if necessary
126 static int ntrig_event (struct hid_device *hid, struct hid_field *field,
127 struct hid_usage *usage, __s32 value)
129 struct input_dev *input = field->hidinput->input;
130 struct ntrig_data *nd = hid_get_drvdata(hid);
132 /* No special handling needed for the pen */
133 if (field->application == HID_DG_PEN)
136 if (hid->claimed & HID_CLAIMED_INPUT) {
137 switch (usage->hid) {
139 /* Tag indicating the start of a multitouch group */
141 nd->first_contact_confidence = 0;
143 case HID_DG_CONFIDENCE:
144 nd->confidence = value;
148 /* Clear the contact footer */
149 nd->mt_foot_count = 0;
154 case HID_DG_CONTACTID:
163 * when in single touch mode, this is the last
164 * report received in a finger event. We want
165 * to emit a normal (X, Y) position
167 if (!nd->reading_mt) {
168 input_event(input, EV_ABS, ABS_X, nd->x);
169 input_event(input, EV_ABS, ABS_Y, nd->y);
174 * we receive this when the device is in multitouch
175 * mode. The first of the three values tagged with
176 * this usage tells if the contact point is real
180 /* Shouldn't get more than 4 footer packets, so skip */
181 if (nd->mt_foot_count >= 4)
184 nd->mt_footer[nd->mt_foot_count++] = value;
186 /* if the footer isn't complete break */
187 if (nd->mt_foot_count != 4)
190 /* Pen activity signal, trigger end of touch. */
191 if (nd->mt_footer[2]) {
196 /* If the contact was invalid */
197 if (!(nd->confidence && nd->mt_footer[0])
204 /* emit a normal (X, Y) for the first point only */
206 nd->first_contact_confidence = nd->confidence;
207 input_event(input, EV_ABS, ABS_X, nd->x);
208 input_event(input, EV_ABS, ABS_Y, nd->y);
210 input_event(input, EV_ABS, ABS_MT_POSITION_X, nd->x);
211 input_event(input, EV_ABS, ABS_MT_POSITION_Y, nd->y);
213 input_event(input, EV_ABS,
214 ABS_MT_ORIENTATION, 1);
215 input_event(input, EV_ABS,
216 ABS_MT_TOUCH_MAJOR, nd->w);
217 input_event(input, EV_ABS,
218 ABS_MT_TOUCH_MINOR, nd->h);
220 input_event(input, EV_ABS,
221 ABS_MT_ORIENTATION, 0);
222 input_event(input, EV_ABS,
223 ABS_MT_TOUCH_MAJOR, nd->h);
224 input_event(input, EV_ABS,
225 ABS_MT_TOUCH_MINOR, nd->w);
227 input_mt_sync(field->hidinput->input);
230 case HID_DG_CONTACTCOUNT: /* End of a multitouch group */
236 if (nd->first_contact_confidence) {
238 case 0: /* for single touch devices */
240 input_report_key(input,
241 BTN_TOOL_DOUBLETAP, 1);
244 input_report_key(input,
245 BTN_TOOL_TRIPLETAP, 1);
249 input_report_key(input,
250 BTN_TOOL_QUADTAP, 1);
252 input_report_key(input, BTN_TOUCH, 1);
254 input_report_key(input,
255 BTN_TOOL_DOUBLETAP, 0);
256 input_report_key(input,
257 BTN_TOOL_TRIPLETAP, 0);
258 input_report_key(input,
259 BTN_TOOL_QUADTAP, 0);
264 /* fallback to the generic hidinput handling */
269 /* we have handled the hidinput part, now remains hiddev */
270 if ((hid->claimed & HID_CLAIMED_HIDDEV) && hid->hiddev_hid_event)
271 hid->hiddev_hid_event(hid, field, usage, value);
276 static int ntrig_probe(struct hid_device *hdev, const struct hid_device_id *id)
279 struct ntrig_data *nd;
280 struct hid_input *hidinput;
281 struct input_dev *input;
284 hdev->quirks |= HID_QUIRK_MULTI_INPUT;
286 nd = kmalloc(sizeof(struct ntrig_data), GFP_KERNEL);
288 dev_err(&hdev->dev, "cannot allocate N-Trig data\n");
293 hid_set_drvdata(hdev, nd);
295 ret = hid_parse(hdev);
297 dev_err(&hdev->dev, "parse failed\n");
301 ret = hid_hw_start(hdev, HID_CONNECT_DEFAULT & ~HID_CONNECT_FF);
303 dev_err(&hdev->dev, "hw start failed\n");
308 list_for_each_entry(hidinput, &hdev->inputs, list) {
309 input = hidinput->input;
310 switch (hidinput->report->field[0]->application) {
312 input->name = "N-Trig Pen";
314 case HID_DG_TOUCHSCREEN:
315 __clear_bit(BTN_TOOL_PEN, input->keybit);
317 * A little something special to enable
318 * two and three finger taps.
320 __set_bit(BTN_TOOL_DOUBLETAP, input->keybit);
321 __set_bit(BTN_TOOL_TRIPLETAP, input->keybit);
322 __set_bit(BTN_TOOL_QUADTAP, input->keybit);
324 * The physical touchscreen (single touch)
325 * input has a value for physical, whereas
326 * the multitouch only has logical input
330 (hidinput->report->field[0]
332 "N-Trig Touchscreen" :
344 static void ntrig_remove(struct hid_device *hdev)
347 kfree(hid_get_drvdata(hdev));
350 static const struct hid_device_id ntrig_devices[] = {
351 { HID_USB_DEVICE(USB_VENDOR_ID_NTRIG, USB_DEVICE_ID_NTRIG_TOUCH_SCREEN),
352 .driver_data = NTRIG_DUPLICATE_USAGES },
355 MODULE_DEVICE_TABLE(hid, ntrig_devices);
357 static const struct hid_usage_id ntrig_grabbed_usages[] = {
358 { HID_ANY_ID, HID_ANY_ID, HID_ANY_ID },
359 { HID_ANY_ID - 1, HID_ANY_ID - 1, HID_ANY_ID - 1 }
362 static struct hid_driver ntrig_driver = {
364 .id_table = ntrig_devices,
365 .probe = ntrig_probe,
366 .remove = ntrig_remove,
367 .input_mapping = ntrig_input_mapping,
368 .input_mapped = ntrig_input_mapped,
369 .usage_table = ntrig_grabbed_usages,
370 .event = ntrig_event,
373 static int __init ntrig_init(void)
375 return hid_register_driver(&ntrig_driver);
378 static void __exit ntrig_exit(void)
380 hid_unregister_driver(&ntrig_driver);
383 module_init(ntrig_init);
384 module_exit(ntrig_exit);
385 MODULE_LICENSE("GPL");