2 * Generic linux-input device driver for axis-bearing devices
4 * Copyright (c) 2001 Brian S. Julin
7 * Redistribution and use in source and binary forms, with or without
8 * modification, are permitted provided that the following conditions
10 * 1. Redistributions of source code must retain the above copyright
11 * notice, this list of conditions, and the following disclaimer,
12 * without modification.
13 * 2. The name of the author may not be used to endorse or promote products
14 * derived from this software without specific prior written permission.
16 * Alternatively, this software may be distributed under the terms of the
17 * GNU General Public License ("GPL").
19 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
20 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
21 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
22 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE FOR
23 * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
24 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
25 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
26 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
27 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
30 * HP-HIL Technical Reference Manual. Hewlett Packard Product No. 45918A
34 #include <linux/hil.h>
35 #include <linux/input.h>
36 #include <linux/serio.h>
37 #include <linux/kernel.h>
38 #include <linux/module.h>
39 #include <linux/init.h>
40 #include <linux/slab.h>
41 #include <linux/pci_ids.h>
43 #define PREFIX "HIL PTR: "
44 #define HIL_GENERIC_NAME "HIL pointer device"
46 MODULE_AUTHOR("Brian S. Julin <bri@calyx.com>");
47 MODULE_DESCRIPTION(HIL_GENERIC_NAME " driver");
48 MODULE_LICENSE("Dual BSD/GPL");
51 #define TABLET_SIMULATES_MOUSE /* allow tablet to be used as mouse */
52 #undef TABLET_AUTOADJUST /* auto-adjust valid tablet ranges */
55 #define HIL_PTR_MAX_LENGTH 16
58 struct input_dev *dev;
61 /* Input buffer and index for packets from HIL bus. */
62 hil_packet data[HIL_PTR_MAX_LENGTH];
63 int idx4; /* four counts per packet */
65 /* Raw device info records from HIL bus, see hil.h for fields. */
66 char idd[HIL_PTR_MAX_LENGTH]; /* DID byte and IDD record */
67 char rsc[HIL_PTR_MAX_LENGTH]; /* RSC record */
68 char exd[HIL_PTR_MAX_LENGTH]; /* EXD record */
69 char rnm[HIL_PTR_MAX_LENGTH + 1]; /* RNM record + NULL term. */
71 /* Extra device details not contained in struct input_dev. */
72 unsigned int nbtn, naxes;
73 unsigned int btnmap[7];
75 /* Something to sleep around with. */
79 /* Process a complete packet after transfer from the HIL */
80 static void hil_ptr_process_record(struct hil_ptr *ptr)
82 struct input_dev *dev = ptr->dev;
83 hil_packet *data = ptr->data;
85 int idx, i, cnt, laxis;
91 if ((p & ~HIL_CMDCT_POL) ==
92 (HIL_ERR_INT | HIL_PKT_CMD | HIL_CMD_POL)) goto report;
93 if ((p & ~HIL_CMDCT_RPL) ==
94 (HIL_ERR_INT | HIL_PKT_CMD | HIL_CMD_RPL)) goto report;
96 /* Not a poll response. See if we are loading config records. */
97 switch (p & HIL_PKT_DATA_MASK) {
99 for (i = 0; i < idx; i++)
100 ptr->idd[i] = ptr->data[i] & HIL_PKT_DATA_MASK;
101 for (; i < HIL_PTR_MAX_LENGTH; i++)
105 for (i = 0; i < idx; i++)
106 ptr->rsc[i] = ptr->data[i] & HIL_PKT_DATA_MASK;
107 for (; i < HIL_PTR_MAX_LENGTH; i++)
111 for (i = 0; i < idx; i++)
112 ptr->exd[i] = ptr->data[i] & HIL_PKT_DATA_MASK;
113 for (; i < HIL_PTR_MAX_LENGTH; i++)
117 for (i = 0; i < idx; i++)
118 ptr->rnm[i] = ptr->data[i] & HIL_PKT_DATA_MASK;
119 for (; i < HIL_PTR_MAX_LENGTH + 1; i++)
123 /* These occur when device isn't present */
124 if (p == (HIL_ERR_INT | HIL_PKT_CMD)) break;
125 /* Anything else we'd like to know about. */
126 printk(KERN_WARNING PREFIX "Device sent unknown record %x\n", p);
132 if ((p & HIL_CMDCT_POL) != idx - 1) {
133 printk(KERN_WARNING PREFIX "Malformed poll packet %x (idx = %i)\n", p, idx);
137 i = (ptr->data[0] & HIL_POL_AXIS_ALT) ? 3 : 0;
138 laxis = ptr->data[0] & HIL_POL_NUM_AXES_MASK;
141 ax16 = ptr->idd[1] & HIL_IDD_HEADER_16BIT; /* 8 or 16bit resolution */
142 absdev = ptr->idd[1] & HIL_IDD_HEADER_ABS;
144 for (cnt = 1; i < laxis; i++) {
145 unsigned int lo,hi,val;
146 lo = ptr->data[cnt++] & HIL_PKT_DATA_MASK;
147 hi = ax16 ? (ptr->data[cnt++] & HIL_PKT_DATA_MASK) : 0;
150 #ifdef TABLET_AUTOADJUST
151 if (val < dev->absmin[ABS_X + i])
152 dev->absmin[ABS_X + i] = val;
153 if (val > dev->absmax[ABS_X + i])
154 dev->absmax[ABS_X + i] = val;
156 if (i%3) val = dev->absmax[ABS_X + i] - val;
157 input_report_abs(dev, ABS_X + i, val);
159 val = (int) (((int8_t)lo) | ((int8_t)hi<<8));
161 input_report_rel(dev, REL_X + i, val);
165 while (cnt < idx - 1) {
168 btn = ptr->data[cnt++];
172 continue; /* TODO: proximity == touch? */
174 else if ((btn > 0x8c) || (btn < 0x80)) continue;
175 btn = (btn - 0x80) >> 1;
176 btn = ptr->btnmap[btn];
177 input_report_key(dev, btn, !up);
185 static void hil_ptr_process_err(struct hil_ptr *ptr) {
186 printk(KERN_WARNING PREFIX "errored HIL packet\n");
192 static irqreturn_t hil_ptr_interrupt(struct serio *serio,
193 unsigned char data, unsigned int flags, struct pt_regs *regs)
199 ptr = serio_get_drvdata(serio);
205 if (ptr->idx4 >= (HIL_PTR_MAX_LENGTH * sizeof(hil_packet))) {
206 hil_ptr_process_err(ptr);
210 if (!(ptr->idx4 % 4)) ptr->data[idx] = 0;
211 packet = ptr->data[idx];
212 packet |= ((hil_packet)data) << ((3 - (ptr->idx4 % 4)) * 8);
213 ptr->data[idx] = packet;
215 /* Records of N 4-byte hil_packets must terminate with a command. */
216 if ((++(ptr->idx4)) % 4) return IRQ_HANDLED;
217 if ((packet & 0xffff0000) != HIL_ERR_INT) {
218 hil_ptr_process_err(ptr);
221 if (packet & HIL_PKT_CMD)
222 hil_ptr_process_record(ptr);
226 static void hil_ptr_disconnect(struct serio *serio)
230 ptr = serio_get_drvdata(serio);
237 input_unregister_device(ptr->dev);
241 static int hil_ptr_connect(struct serio *serio, struct serio_driver *driver)
245 unsigned int i, naxsets, btntype;
248 if (!(ptr = kzalloc(sizeof(struct hil_ptr), GFP_KERNEL)))
251 ptr->dev = input_allocate_device();
255 ptr->dev->private = ptr;
257 if (serio_open(serio, driver))
260 serio_set_drvdata(serio, ptr);
263 init_MUTEX_LOCKED(&(ptr->sem));
265 /* Get device info. MLC driver supplies devid/status/etc. */
266 serio->write(serio, 0);
267 serio->write(serio, 0);
268 serio->write(serio, HIL_PKT_CMD >> 8);
269 serio->write(serio, HIL_CMD_IDD);
272 serio->write(serio, 0);
273 serio->write(serio, 0);
274 serio->write(serio, HIL_PKT_CMD >> 8);
275 serio->write(serio, HIL_CMD_RSC);
278 serio->write(serio, 0);
279 serio->write(serio, 0);
280 serio->write(serio, HIL_PKT_CMD >> 8);
281 serio->write(serio, HIL_CMD_RNM);
284 serio->write(serio, 0);
285 serio->write(serio, 0);
286 serio->write(serio, HIL_PKT_CMD >> 8);
287 serio->write(serio, HIL_CMD_EXD);
295 if ((did & HIL_IDD_DID_TYPE_MASK) == HIL_IDD_DID_TYPE_REL) {
296 ptr->dev->evbit[0] = BIT(EV_REL);
300 if ((did & HIL_IDD_DID_TYPE_MASK) == HIL_IDD_DID_TYPE_ABS) {
301 ptr->dev->evbit[0] = BIT(EV_ABS);
304 if (!ptr->dev->evbit[0]) {
308 ptr->nbtn = HIL_IDD_NUM_BUTTONS(idd);
309 if (ptr->nbtn) ptr->dev->evbit[0] |= BIT(EV_KEY);
311 naxsets = HIL_IDD_NUM_AXSETS(*idd);
312 ptr->naxes = HIL_IDD_NUM_AXES_PER_SET(*idd);
314 printk(KERN_INFO PREFIX "HIL pointer device found (did: 0x%02x, axis: %s)\n",
316 printk(KERN_INFO PREFIX "HIL pointer has %i buttons and %i sets of %i axes\n",
317 ptr->nbtn, naxsets, ptr->naxes);
320 if ((did & HIL_IDD_DID_ABS_TABLET_MASK) == HIL_IDD_DID_ABS_TABLET)
321 #ifdef TABLET_SIMULATES_MOUSE
326 if ((did & HIL_IDD_DID_ABS_TSCREEN_MASK) == HIL_IDD_DID_ABS_TSCREEN)
329 if ((did & HIL_IDD_DID_REL_MOUSE_MASK) == HIL_IDD_DID_REL_MOUSE)
332 for (i = 0; i < ptr->nbtn; i++) {
333 set_bit(btntype | i, ptr->dev->keybit);
334 ptr->btnmap[i] = btntype | i;
337 if (btntype == BTN_MOUSE) {
338 /* Swap buttons 2 and 3 */
339 ptr->btnmap[1] = BTN_MIDDLE;
340 ptr->btnmap[2] = BTN_RIGHT;
343 if ((did & HIL_IDD_DID_TYPE_MASK) == HIL_IDD_DID_TYPE_REL) {
344 for (i = 0; i < ptr->naxes; i++) {
345 set_bit(REL_X + i, ptr->dev->relbit);
347 for (i = 3; (i < ptr->naxes + 3) && (naxsets > 1); i++) {
348 set_bit(REL_X + i, ptr->dev->relbit);
351 for (i = 0; i < ptr->naxes; i++) {
352 set_bit(ABS_X + i, ptr->dev->absbit);
353 ptr->dev->absmin[ABS_X + i] = 0;
354 ptr->dev->absmax[ABS_X + i] =
355 HIL_IDD_AXIS_MAX((ptr->idd + 1), i);
357 for (i = 3; (i < ptr->naxes + 3) && (naxsets > 1); i++) {
358 set_bit(ABS_X + i, ptr->dev->absbit);
359 ptr->dev->absmin[ABS_X + i] = 0;
360 ptr->dev->absmax[ABS_X + i] =
361 HIL_IDD_AXIS_MAX((ptr->idd + 1), (i - 3));
363 #ifdef TABLET_AUTOADJUST
364 for (i = 0; i < ABS_MAX; i++) {
365 int diff = ptr->dev->absmax[ABS_X + i] / 10;
366 ptr->dev->absmin[ABS_X + i] += diff;
367 ptr->dev->absmax[ABS_X + i] -= diff;
372 ptr->dev->name = strlen(ptr->rnm) ? ptr->rnm : HIL_GENERIC_NAME;
374 ptr->dev->id.bustype = BUS_HIL;
375 ptr->dev->id.vendor = PCI_VENDOR_ID_HP;
376 ptr->dev->id.product = 0x0001; /* TODO: get from ptr->rsc */
377 ptr->dev->id.version = 0x0100; /* TODO: get from ptr->rsc */
378 ptr->dev->dev = &serio->dev;
380 input_register_device(ptr->dev);
381 printk(KERN_INFO "input: %s (%s), ID: %d\n",
383 (btntype == BTN_MOUSE) ? "HIL mouse":"HIL tablet or touchpad",
390 input_free_device(ptr->dev);
393 serio_set_drvdata(serio, NULL);
397 static struct serio_device_id hil_ptr_ids[] = {
399 .type = SERIO_HIL_MLC,
407 static struct serio_driver hil_ptr_serio_driver = {
411 .description = "HP HIL mouse/tablet driver",
412 .id_table = hil_ptr_ids,
413 .connect = hil_ptr_connect,
414 .disconnect = hil_ptr_disconnect,
415 .interrupt = hil_ptr_interrupt
418 static int __init hil_ptr_init(void)
420 serio_register_driver(&hil_ptr_serio_driver);
424 static void __exit hil_ptr_exit(void)
426 serio_unregister_driver(&hil_ptr_serio_driver);
429 module_init(hil_ptr_init);
430 module_exit(hil_ptr_exit);