Loading...
1// SPDX-License-Identifier: GPL-2.0-or-later
2/*
3 * HID driver for Kye/Genius devices not fully compliant with HID standard
4 *
5 * Copyright (c) 2009 Jiri Kosina
6 * Copyright (c) 2009 Tomas Hanak
7 * Copyright (c) 2012 Nikolai Kondrashov
8 * Copyright (c) 2023 David Yang
9 */
10
11#include <asm-generic/unaligned.h>
12#include <linux/device.h>
13#include <linux/hid.h>
14#include <linux/module.h>
15
16#include "hid-ids.h"
17
18/* Data gathered from Database/VID0458_PID????/Vista/TBoard/default.xml in ioTablet driver
19 *
20 * TODO:
21 * - Add battery and sleep support for EasyPen M406W and MousePen M508WX
22 * - Investigate ScrollZ.MiceFMT buttons of EasyPen M406
23 */
24
25static const __u8 easypen_m406_control_rdesc[] = {
26 0x05, 0x0C, /* Usage Page (Consumer), */
27 0x09, 0x01, /* Usage (Consumer Control), */
28 0xA1, 0x01, /* Collection (Application), */
29 0x85, 0x12, /* Report ID (18), */
30 0x0A, 0x45, 0x02, /* Usage (AC Rotate), */
31 0x09, 0x40, /* Usage (Menu), */
32 0x0A, 0x2F, 0x02, /* Usage (AC Zoom), */
33 0x0A, 0x46, 0x02, /* Usage (AC Resize), */
34 0x0A, 0x1A, 0x02, /* Usage (AC Undo), */
35 0x0A, 0x6A, 0x02, /* Usage (AC Delete), */
36 0x0A, 0x24, 0x02, /* Usage (AC Back), */
37 0x0A, 0x25, 0x02, /* Usage (AC Forward), */
38 0x14, /* Logical Minimum (0), */
39 0x25, 0x01, /* Logical Maximum (1), */
40 0x75, 0x01, /* Report Size (1), */
41 0x95, 0x08, /* Report Count (8), */
42 0x81, 0x02, /* Input (Variable), */
43 0x95, 0x30, /* Report Count (48), */
44 0x81, 0x01, /* Input (Constant), */
45 0xC0 /* End Collection */
46};
47
48static const __u8 easypen_m506_control_rdesc[] = {
49 0x05, 0x0C, /* Usage Page (Consumer), */
50 0x09, 0x01, /* Usage (Consumer Control), */
51 0xA1, 0x01, /* Collection (Application), */
52 0x85, 0x12, /* Report ID (18), */
53 0x0A, 0x6A, 0x02, /* Usage (AC Delete), */
54 0x0A, 0x1A, 0x02, /* Usage (AC Undo), */
55 0x0A, 0x2D, 0x02, /* Usage (AC Zoom In), */
56 0x0A, 0x2E, 0x02, /* Usage (AC Zoom Out), */
57 0x14, /* Logical Minimum (0), */
58 0x25, 0x01, /* Logical Maximum (1), */
59 0x75, 0x01, /* Report Size (1), */
60 0x95, 0x04, /* Report Count (4), */
61 0x81, 0x02, /* Input (Variable), */
62 0x95, 0x34, /* Report Count (52), */
63 0x81, 0x01, /* Input (Constant), */
64 0xC0 /* End Collection */
65};
66
67static const __u8 easypen_m406w_control_rdesc[] = {
68 0x05, 0x0C, /* Usage Page (Consumer), */
69 0x09, 0x01, /* Usage (Consumer Control), */
70 0xA1, 0x01, /* Collection (Application), */
71 0x85, 0x12, /* Report ID (18), */
72 0x0A, 0x6A, 0x02, /* Usage (AC Delete), */
73 0x0A, 0x1A, 0x02, /* Usage (AC Undo), */
74 0x0A, 0x01, 0x02, /* Usage (AC New), */
75 0x09, 0x40, /* Usage (Menu), */
76 0x14, /* Logical Minimum (0), */
77 0x25, 0x01, /* Logical Maximum (1), */
78 0x75, 0x01, /* Report Size (1), */
79 0x95, 0x04, /* Report Count (4), */
80 0x81, 0x02, /* Input (Variable), */
81 0x95, 0x34, /* Report Count (52), */
82 0x81, 0x01, /* Input (Constant), */
83 0xC0 /* End Collection */
84};
85
86static const __u8 easypen_m610x_control_rdesc[] = {
87 0x05, 0x0C, /* Usage Page (Consumer), */
88 0x09, 0x01, /* Usage (Consumer Control), */
89 0xA1, 0x01, /* Collection (Application), */
90 0x85, 0x12, /* Report ID (18), */
91 0x0A, 0x1A, 0x02, /* Usage (AC Undo), */
92 0x0A, 0x79, 0x02, /* Usage (AC Redo Or Repeat), */
93 0x0A, 0x2D, 0x02, /* Usage (AC Zoom In), */
94 0x0A, 0x2E, 0x02, /* Usage (AC Zoom Out), */
95 0x14, /* Logical Minimum (0), */
96 0x25, 0x01, /* Logical Maximum (1), */
97 0x75, 0x01, /* Report Size (1), */
98 0x95, 0x04, /* Report Count (4), */
99 0x81, 0x02, /* Input (Variable), */
100 0x95, 0x34, /* Report Count (52), */
101 0x81, 0x01, /* Input (Constant), */
102 0xC0 /* End Collection */
103};
104
105static const __u8 pensketch_m912_control_rdesc[] = {
106 0x05, 0x0C, /* Usage Page (Consumer), */
107 0x09, 0x01, /* Usage (Consumer Control), */
108 0xA1, 0x01, /* Collection (Application), */
109 0x85, 0x12, /* Report ID (18), */
110 0x14, /* Logical Minimum (0), */
111 0x25, 0x01, /* Logical Maximum (1), */
112 0x75, 0x01, /* Report Size (1), */
113 0x95, 0x08, /* Report Count (8), */
114 0x05, 0x0C, /* Usage Page (Consumer), */
115 0x0A, 0x6A, 0x02, /* Usage (AC Delete), */
116 0x0A, 0x1A, 0x02, /* Usage (AC Undo), */
117 0x0A, 0x01, 0x02, /* Usage (AC New), */
118 0x0A, 0x2F, 0x02, /* Usage (AC Zoom), */
119 0x0A, 0x25, 0x02, /* Usage (AC Forward), */
120 0x0A, 0x24, 0x02, /* Usage (AC Back), */
121 0x0A, 0x2D, 0x02, /* Usage (AC Zoom In), */
122 0x0A, 0x2E, 0x02, /* Usage (AC Zoom Out), */
123 0x81, 0x02, /* Input (Variable), */
124 0x95, 0x30, /* Report Count (48), */
125 0x81, 0x03, /* Input (Constant, Variable), */
126 0xC0 /* End Collection */
127};
128
129static const __u8 mousepen_m508wx_control_rdesc[] = {
130 0x05, 0x0C, /* Usage Page (Consumer), */
131 0x09, 0x01, /* Usage (Consumer Control), */
132 0xA1, 0x01, /* Collection (Application), */
133 0x85, 0x12, /* Report ID (18), */
134 0x0A, 0x1A, 0x02, /* Usage (AC Undo), */
135 0x0A, 0x6A, 0x02, /* Usage (AC Delete), */
136 0x0A, 0x2D, 0x02, /* Usage (AC Zoom In), */
137 0x0A, 0x2E, 0x02, /* Usage (AC Zoom Out), */
138 0x14, /* Logical Minimum (0), */
139 0x25, 0x01, /* Logical Maximum (1), */
140 0x75, 0x01, /* Report Size (1), */
141 0x95, 0x04, /* Report Count (4), */
142 0x81, 0x02, /* Input (Variable), */
143 0x95, 0x34, /* Report Count (52), */
144 0x81, 0x01, /* Input (Constant), */
145 0xC0 /* End Collection */
146};
147
148static const __u8 mousepen_m508x_control_rdesc[] = {
149 0x05, 0x0C, /* Usage Page (Consumer), */
150 0x09, 0x01, /* Usage (Consumer Control), */
151 0xA1, 0x01, /* Collection (Application), */
152 0x85, 0x12, /* Report ID (18), */
153 0x0A, 0x01, 0x02, /* Usage (AC New), */
154 0x09, 0x40, /* Usage (Menu), */
155 0x0A, 0x6A, 0x02, /* Usage (AC Delete), */
156 0x0A, 0x1A, 0x02, /* Usage (AC Undo), */
157 0x14, /* Logical Minimum (0), */
158 0x25, 0x01, /* Logical Maximum (1), */
159 0x75, 0x01, /* Report Size (1), */
160 0x95, 0x04, /* Report Count (4), */
161 0x81, 0x02, /* Input (Variable), */
162 0x81, 0x01, /* Input (Constant), */
163 0x15, 0xFF, /* Logical Minimum (-1), */
164 0x95, 0x10, /* Report Count (16), */
165 0x81, 0x01, /* Input (Constant), */
166 0x0A, 0x35, 0x02, /* Usage (AC Scroll), */
167 0x0A, 0x2F, 0x02, /* Usage (AC Zoom), */
168 0x0A, 0x38, 0x02, /* Usage (AC Pan), */
169 0x75, 0x08, /* Report Size (8), */
170 0x95, 0x03, /* Report Count (3), */
171 0x81, 0x06, /* Input (Variable, Relative), */
172 0x95, 0x01, /* Report Count (1), */
173 0x81, 0x01, /* Input (Constant), */
174 0xC0 /* End Collection */
175};
176
177static const __u8 easypen_m406xe_control_rdesc[] = {
178 0x05, 0x0C, /* Usage Page (Consumer), */
179 0x09, 0x01, /* Usage (Consumer Control), */
180 0xA1, 0x01, /* Collection (Application), */
181 0x85, 0x12, /* Report ID (18), */
182 0x14, /* Logical Minimum (0), */
183 0x25, 0x01, /* Logical Maximum (1), */
184 0x75, 0x01, /* Report Size (1), */
185 0x95, 0x04, /* Report Count (4), */
186 0x0A, 0x79, 0x02, /* Usage (AC Redo Or Repeat), */
187 0x0A, 0x1A, 0x02, /* Usage (AC Undo), */
188 0x0A, 0x2D, 0x02, /* Usage (AC Zoom In), */
189 0x0A, 0x2E, 0x02, /* Usage (AC Zoom Out), */
190 0x81, 0x02, /* Input (Variable), */
191 0x95, 0x34, /* Report Count (52), */
192 0x81, 0x03, /* Input (Constant, Variable), */
193 0xC0 /* End Collection */
194};
195
196static const __u8 pensketch_t609a_control_rdesc[] = {
197 0x05, 0x0C, /* Usage Page (Consumer), */
198 0x09, 0x01, /* Usage (Consumer Control), */
199 0xA1, 0x01, /* Collection (Application), */
200 0x85, 0x12, /* Report ID (18), */
201 0x0A, 0x6A, 0x02, /* Usage (AC Delete), */
202 0x14, /* Logical Minimum (0), */
203 0x25, 0x01, /* Logical Maximum (1), */
204 0x75, 0x01, /* Report Size (1), */
205 0x95, 0x08, /* Report Count (8), */
206 0x81, 0x02, /* Input (Variable), */
207 0x95, 0x37, /* Report Count (55), */
208 0x81, 0x01, /* Input (Constant), */
209 0xC0 /* End Collection */
210};
211
212/* Fix indexes in kye_tablet_fixup if you change this */
213static const __u8 kye_tablet_rdesc[] = {
214 0x06, 0x00, 0xFF, /* Usage Page (FF00h), */
215 0x09, 0x01, /* Usage (01h), */
216 0xA1, 0x01, /* Collection (Application), */
217 0x85, 0x05, /* Report ID (5), */
218 0x09, 0x01, /* Usage (01h), */
219 0x15, 0x81, /* Logical Minimum (-127), */
220 0x25, 0x7F, /* Logical Maximum (127), */
221 0x75, 0x08, /* Report Size (8), */
222 0x95, 0x07, /* Report Count (7), */
223 0xB1, 0x02, /* Feature (Variable), */
224 0xC0, /* End Collection, */
225 0x05, 0x0D, /* Usage Page (Digitizer), */
226 0x09, 0x01, /* Usage (Digitizer), */
227 0xA1, 0x01, /* Collection (Application), */
228 0x85, 0x10, /* Report ID (16), */
229 0x09, 0x20, /* Usage (Stylus), */
230 0xA0, /* Collection (Physical), */
231 0x09, 0x42, /* Usage (Tip Switch), */
232 0x09, 0x44, /* Usage (Barrel Switch), */
233 0x09, 0x46, /* Usage (Tablet Pick), */
234 0x14, /* Logical Minimum (0), */
235 0x25, 0x01, /* Logical Maximum (1), */
236 0x75, 0x01, /* Report Size (1), */
237 0x95, 0x03, /* Report Count (3), */
238 0x81, 0x02, /* Input (Variable), */
239 0x95, 0x04, /* Report Count (4), */
240 0x81, 0x01, /* Input (Constant), */
241 0x09, 0x32, /* Usage (In Range), */
242 0x95, 0x01, /* Report Count (1), */
243 0x81, 0x02, /* Input (Variable), */
244 0x75, 0x10, /* Report Size (16), */
245 0xA4, /* Push, */
246 0x05, 0x01, /* Usage Page (Desktop), */
247 0x09, 0x30, /* Usage (X), */
248 0x27, 0xFF, 0x7F, 0x00, 0x00, /* Logical Maximum (32767), */
249 0x34, /* Physical Minimum (0), */
250 0x47, 0x00, 0x00, 0x00, 0x00, /* Physical Maximum (0), */
251 0x65, 0x11, /* Unit (Centimeter), */
252 0x55, 0x00, /* Unit Exponent (0), */
253 0x75, 0x10, /* Report Size (16), */
254 0x81, 0x02, /* Input (Variable), */
255 0x09, 0x31, /* Usage (Y), */
256 0x27, 0xFF, 0x7F, 0x00, 0x00, /* Logical Maximum (32767), */
257 0x47, 0x00, 0x00, 0x00, 0x00, /* Physical Maximum (0), */
258 0x81, 0x02, /* Input (Variable), */
259 0xB4, /* Pop, */
260 0x05, 0x0D, /* Usage Page (Digitizer), */
261 0x09, 0x30, /* Usage (Tip Pressure), */
262 0x27, 0xFF, 0x07, 0x00, 0x00, /* Logical Maximum (2047), */
263 0x81, 0x02, /* Input (Variable), */
264 0xC0, /* End Collection, */
265 0xC0, /* End Collection, */
266 0x05, 0x0D, /* Usage Page (Digitizer), */
267 0x09, 0x21, /* Usage (Puck), */
268 0xA1, 0x01, /* Collection (Application), */
269 0x85, 0x11, /* Report ID (17), */
270 0x09, 0x21, /* Usage (Puck), */
271 0xA0, /* Collection (Physical), */
272 0x05, 0x09, /* Usage Page (Button), */
273 0x19, 0x01, /* Usage Minimum (01h), */
274 0x29, 0x03, /* Usage Maximum (03h), */
275 0x14, /* Logical Minimum (0), */
276 0x25, 0x01, /* Logical Maximum (1), */
277 0x75, 0x01, /* Report Size (1), */
278 0x95, 0x03, /* Report Count (3), */
279 0x81, 0x02, /* Input (Variable), */
280 0x95, 0x04, /* Report Count (4), */
281 0x81, 0x01, /* Input (Constant), */
282 0x05, 0x0D, /* Usage Page (Digitizer), */
283 0x09, 0x32, /* Usage (In Range), */
284 0x95, 0x01, /* Report Count (1), */
285 0x81, 0x02, /* Input (Variable), */
286 0x05, 0x01, /* Usage Page (Desktop), */
287 0xA4, /* Push, */
288 0x09, 0x30, /* Usage (X), */
289 0x27, 0xFF, 0x7F, 0x00, 0x00, /* Logical Maximum (32767), */
290 0x34, /* Physical Minimum (0), */
291 0x47, 0x00, 0x00, 0x00, 0x00, /* Physical Maximum (0), */
292 0x65, 0x11, /* Unit (Centimeter), */
293 0x55, 0x00, /* Unit Exponent (0), */
294 0x75, 0x10, /* Report Size (16), */
295 0x81, 0x02, /* Input (Variable), */
296 0x09, 0x31, /* Usage (Y), */
297 0x27, 0xFF, 0x7F, 0x00, 0x00, /* Logical Maximum (32767), */
298 0x47, 0x00, 0x00, 0x00, 0x00, /* Physical Maximum (0), */
299 0x81, 0x02, /* Input (Variable), */
300 0xB4, /* Pop, */
301 0x09, 0x38, /* Usage (Wheel), */
302 0x15, 0xFF, /* Logical Minimum (-1), */
303 0x75, 0x08, /* Report Size (8), */
304 0x95, 0x01, /* Report Count (1), */
305 0x81, 0x06, /* Input (Variable, Relative), */
306 0x81, 0x01, /* Input (Constant), */
307 0xC0, /* End Collection, */
308 0xC0 /* End Collection */
309};
310
311static const struct kye_tablet_info {
312 __u32 product;
313 __s32 x_logical_maximum;
314 __s32 y_logical_maximum;
315 __s32 pressure_logical_maximum;
316 __s32 x_physical_maximum;
317 __s32 y_physical_maximum;
318 __s8 unit_exponent;
319 __s8 unit;
320 bool has_punk;
321 unsigned int control_rsize;
322 const __u8 *control_rdesc;
323} kye_tablets_info[] = {
324 {USB_DEVICE_ID_KYE_EASYPEN_M406, /* 0x5005 */
325 15360, 10240, 1023, 6, 4, 0, 0x13, false,
326 sizeof(easypen_m406_control_rdesc), easypen_m406_control_rdesc},
327 {USB_DEVICE_ID_KYE_EASYPEN_M506, /* 0x500F */
328 24576, 20480, 1023, 6, 5, 0, 0x13, false,
329 sizeof(easypen_m506_control_rdesc), easypen_m506_control_rdesc},
330 {USB_DEVICE_ID_KYE_EASYPEN_I405X, /* 0x5010 */
331 14080, 10240, 1023, 55, 40, -1, 0x13, false},
332 {USB_DEVICE_ID_KYE_MOUSEPEN_I608X, /* 0x5011 */
333 20480, 15360, 2047, 8, 6, 0, 0x13, true},
334 {USB_DEVICE_ID_KYE_EASYPEN_M406W, /* 0x5012 */
335 15360, 10240, 1023, 6, 4, 0, 0x13, false,
336 sizeof(easypen_m406w_control_rdesc), easypen_m406w_control_rdesc},
337 {USB_DEVICE_ID_KYE_EASYPEN_M610X, /* 0x5013 */
338 40960, 25600, 1023, 1000, 625, -2, 0x13, false,
339 sizeof(easypen_m610x_control_rdesc), easypen_m610x_control_rdesc},
340 {USB_DEVICE_ID_KYE_EASYPEN_340, /* 0x5014 */
341 10240, 7680, 1023, 4, 3, 0, 0x13, false},
342 {USB_DEVICE_ID_KYE_PENSKETCH_M912, /* 0x5015 */
343 61440, 46080, 2047, 12, 9, 0, 0x13, true,
344 sizeof(pensketch_m912_control_rdesc), pensketch_m912_control_rdesc},
345 {USB_DEVICE_ID_KYE_MOUSEPEN_M508WX, /* 0x5016 */
346 40960, 25600, 2047, 8, 5, 0, 0x13, true,
347 sizeof(mousepen_m508wx_control_rdesc), mousepen_m508wx_control_rdesc},
348 {USB_DEVICE_ID_KYE_MOUSEPEN_M508X, /* 0x5017 */
349 40960, 25600, 2047, 8, 5, 0, 0x13, true,
350 sizeof(mousepen_m508x_control_rdesc), mousepen_m508x_control_rdesc},
351 {USB_DEVICE_ID_KYE_EASYPEN_M406XE, /* 0x5019 */
352 15360, 10240, 1023, 6, 4, 0, 0x13, false,
353 sizeof(easypen_m406xe_control_rdesc), easypen_m406xe_control_rdesc},
354 {USB_DEVICE_ID_KYE_MOUSEPEN_I608X_V2, /* 0x501A */
355 40960, 30720, 2047, 8, 6, 0, 0x13, true},
356 {USB_DEVICE_ID_KYE_PENSKETCH_T609A, /* 0x501B */
357 43520, 28160, 1023, 85, 55, -1, 0x13, false,
358 sizeof(pensketch_t609a_control_rdesc), pensketch_t609a_control_rdesc},
359 {}
360};
361
362static __u8 *kye_consumer_control_fixup(struct hid_device *hdev, __u8 *rdesc,
363 unsigned int *rsize, int offset, const char *device_name)
364{
365 /*
366 * the fixup that need to be done:
367 * - change Usage Maximum in the Consumer Control
368 * (report ID 3) to a reasonable value
369 */
370 if (*rsize >= offset + 31 &&
371 /* Usage Page (Consumer Devices) */
372 rdesc[offset] == 0x05 && rdesc[offset + 1] == 0x0c &&
373 /* Usage (Consumer Control) */
374 rdesc[offset + 2] == 0x09 && rdesc[offset + 3] == 0x01 &&
375 /* Usage Maximum > 12287 */
376 rdesc[offset + 10] == 0x2a && rdesc[offset + 12] > 0x2f) {
377 hid_info(hdev, "fixing up %s report descriptor\n", device_name);
378 rdesc[offset + 12] = 0x2f;
379 }
380 return rdesc;
381}
382
383/*
384 * Fix tablet descriptor of so-called "DataFormat 2".
385 *
386 * Though we may achieve a usable descriptor from original vendor-defined one,
387 * some problems exist:
388 * - Their Logical Maximum never exceed 32767 (7F FF), though device do report
389 * values greater than that;
390 * - Physical Maximums are arbitrarily filled (always equal to Logical
391 * Maximum);
392 * - Detail for control buttons are not provided (a vendor-defined Usage Page
393 * with fixed content).
394 *
395 * Thus we use a pre-defined parameter table rather than digging it from
396 * original descriptor.
397 *
398 * We may as well write a fallback routine for unrecognized kye tablet, but it's
399 * clear kye are unlikely to produce new models in the foreseeable future, so we
400 * simply enumerate all possible models.
401 */
402static __u8 *kye_tablet_fixup(struct hid_device *hdev, __u8 *rdesc, unsigned int *rsize)
403{
404 const struct kye_tablet_info *info;
405 unsigned int newsize;
406
407 if (*rsize < sizeof(kye_tablet_rdesc)) {
408 hid_warn(hdev,
409 "tablet report size too small, or kye_tablet_rdesc unexpectedly large\n");
410 return rdesc;
411 }
412
413 for (info = kye_tablets_info; info->product; info++) {
414 if (hdev->product == info->product)
415 break;
416 }
417
418 if (!info->product) {
419 hid_err(hdev, "tablet unknown, someone forget to add kye_tablet_info entry?\n");
420 return rdesc;
421 }
422
423 newsize = info->has_punk ? sizeof(kye_tablet_rdesc) : 112;
424 memcpy(rdesc, kye_tablet_rdesc, newsize);
425
426 put_unaligned_le32(info->x_logical_maximum, rdesc + 66);
427 put_unaligned_le32(info->x_physical_maximum, rdesc + 72);
428 rdesc[77] = info->unit;
429 rdesc[79] = info->unit_exponent;
430 put_unaligned_le32(info->y_logical_maximum, rdesc + 87);
431 put_unaligned_le32(info->y_physical_maximum, rdesc + 92);
432 put_unaligned_le32(info->pressure_logical_maximum, rdesc + 104);
433
434 if (info->has_punk) {
435 put_unaligned_le32(info->x_logical_maximum, rdesc + 156);
436 put_unaligned_le32(info->x_physical_maximum, rdesc + 162);
437 rdesc[167] = info->unit;
438 rdesc[169] = info->unit_exponent;
439 put_unaligned_le32(info->y_logical_maximum, rdesc + 177);
440 put_unaligned_le32(info->y_physical_maximum, rdesc + 182);
441 }
442
443 if (info->control_rsize) {
444 if (newsize + info->control_rsize > *rsize)
445 hid_err(hdev, "control rdesc unexpectedly large");
446 else {
447 memcpy(rdesc + newsize, info->control_rdesc, info->control_rsize);
448 newsize += info->control_rsize;
449 }
450 }
451
452 *rsize = newsize;
453 return rdesc;
454}
455
456static __u8 *kye_report_fixup(struct hid_device *hdev, __u8 *rdesc,
457 unsigned int *rsize)
458{
459 switch (hdev->product) {
460 case USB_DEVICE_ID_KYE_ERGO_525V:
461 /* the fixups that need to be done:
462 * - change led usage page to button for extra buttons
463 * - report size 8 count 1 must be size 1 count 8 for button
464 * bitfield
465 * - change the button usage range to 4-7 for the extra
466 * buttons
467 */
468 if (*rsize >= 75 &&
469 rdesc[61] == 0x05 && rdesc[62] == 0x08 &&
470 rdesc[63] == 0x19 && rdesc[64] == 0x08 &&
471 rdesc[65] == 0x29 && rdesc[66] == 0x0f &&
472 rdesc[71] == 0x75 && rdesc[72] == 0x08 &&
473 rdesc[73] == 0x95 && rdesc[74] == 0x01) {
474 hid_info(hdev,
475 "fixing up Kye/Genius Ergo Mouse "
476 "report descriptor\n");
477 rdesc[62] = 0x09;
478 rdesc[64] = 0x04;
479 rdesc[66] = 0x07;
480 rdesc[72] = 0x01;
481 rdesc[74] = 0x08;
482 }
483 break;
484 case USB_DEVICE_ID_GENIUS_GILA_GAMING_MOUSE:
485 rdesc = kye_consumer_control_fixup(hdev, rdesc, rsize, 104,
486 "Genius Gila Gaming Mouse");
487 break;
488 case USB_DEVICE_ID_GENIUS_MANTICORE:
489 rdesc = kye_consumer_control_fixup(hdev, rdesc, rsize, 104,
490 "Genius Manticore Keyboard");
491 break;
492 case USB_DEVICE_ID_GENIUS_GX_IMPERATOR:
493 rdesc = kye_consumer_control_fixup(hdev, rdesc, rsize, 83,
494 "Genius Gx Imperator Keyboard");
495 break;
496 case USB_DEVICE_ID_KYE_EASYPEN_M406:
497 case USB_DEVICE_ID_KYE_EASYPEN_M506:
498 case USB_DEVICE_ID_KYE_EASYPEN_I405X:
499 case USB_DEVICE_ID_KYE_MOUSEPEN_I608X:
500 case USB_DEVICE_ID_KYE_EASYPEN_M406W:
501 case USB_DEVICE_ID_KYE_EASYPEN_M610X:
502 case USB_DEVICE_ID_KYE_EASYPEN_340:
503 case USB_DEVICE_ID_KYE_PENSKETCH_M912:
504 case USB_DEVICE_ID_KYE_MOUSEPEN_M508WX:
505 case USB_DEVICE_ID_KYE_MOUSEPEN_M508X:
506 case USB_DEVICE_ID_KYE_EASYPEN_M406XE:
507 case USB_DEVICE_ID_KYE_MOUSEPEN_I608X_V2:
508 case USB_DEVICE_ID_KYE_PENSKETCH_T609A:
509 rdesc = kye_tablet_fixup(hdev, rdesc, rsize);
510 break;
511 }
512 return rdesc;
513}
514
515static int kye_tablet_enable(struct hid_device *hdev)
516{
517 struct list_head *list;
518 struct list_head *head;
519 struct hid_report *report;
520 __s32 *value;
521
522 list = &hdev->report_enum[HID_FEATURE_REPORT].report_list;
523 list_for_each(head, list) {
524 report = list_entry(head, struct hid_report, list);
525 if (report->id == 5)
526 break;
527 }
528
529 if (head == list) {
530 hid_err(hdev, "tablet-enabling feature report not found\n");
531 return -ENODEV;
532 }
533
534 if (report->maxfield < 1 || report->field[0]->report_count < 7) {
535 hid_err(hdev, "invalid tablet-enabling feature report\n");
536 return -ENODEV;
537 }
538
539 value = report->field[0]->value;
540
541 /*
542 * The code is for DataFormat 2 of config xml. They have no obvious
543 * meaning (at least not configurable in Windows driver) except enabling
544 * fully-functional tablet mode (absolute positioning). Otherwise, the
545 * tablet acts like a relative mouse.
546 *
547 * Though there're magic codes for DataFormat 3 and 4, no devices use
548 * these DataFormats.
549 */
550 value[0] = 0x12;
551 value[1] = 0x10;
552 value[2] = 0x11;
553 value[3] = 0x12;
554 value[4] = 0x00;
555 value[5] = 0x00;
556 value[6] = 0x00;
557 hid_hw_request(hdev, report, HID_REQ_SET_REPORT);
558
559 return 0;
560}
561
562static int kye_probe(struct hid_device *hdev, const struct hid_device_id *id)
563{
564 int ret;
565
566 ret = hid_parse(hdev);
567 if (ret) {
568 hid_err(hdev, "parse failed\n");
569 goto err;
570 }
571
572 ret = hid_hw_start(hdev, HID_CONNECT_DEFAULT);
573 if (ret) {
574 hid_err(hdev, "hw start failed\n");
575 goto err;
576 }
577
578 switch (id->product) {
579 case USB_DEVICE_ID_GENIUS_MANTICORE:
580 /*
581 * The manticore keyboard needs to have all the interfaces
582 * opened at least once to be fully functional.
583 */
584 if (hid_hw_open(hdev))
585 hid_hw_close(hdev);
586 break;
587 case USB_DEVICE_ID_KYE_EASYPEN_M406:
588 case USB_DEVICE_ID_KYE_EASYPEN_M506:
589 case USB_DEVICE_ID_KYE_EASYPEN_I405X:
590 case USB_DEVICE_ID_KYE_MOUSEPEN_I608X:
591 case USB_DEVICE_ID_KYE_EASYPEN_M406W:
592 case USB_DEVICE_ID_KYE_EASYPEN_M610X:
593 case USB_DEVICE_ID_KYE_EASYPEN_340:
594 case USB_DEVICE_ID_KYE_PENSKETCH_M912:
595 case USB_DEVICE_ID_KYE_MOUSEPEN_M508WX:
596 case USB_DEVICE_ID_KYE_MOUSEPEN_M508X:
597 case USB_DEVICE_ID_KYE_EASYPEN_M406XE:
598 case USB_DEVICE_ID_KYE_MOUSEPEN_I608X_V2:
599 case USB_DEVICE_ID_KYE_PENSKETCH_T609A:
600 ret = kye_tablet_enable(hdev);
601 if (ret) {
602 hid_err(hdev, "tablet enabling failed\n");
603 goto enabling_err;
604 }
605 break;
606 }
607
608 return 0;
609enabling_err:
610 hid_hw_stop(hdev);
611err:
612 return ret;
613}
614
615static const struct hid_device_id kye_devices[] = {
616 { HID_USB_DEVICE(USB_VENDOR_ID_KYE, USB_DEVICE_ID_KYE_ERGO_525V) },
617 { HID_USB_DEVICE(USB_VENDOR_ID_KYE,
618 USB_DEVICE_ID_GENIUS_GILA_GAMING_MOUSE) },
619 { HID_USB_DEVICE(USB_VENDOR_ID_KYE,
620 USB_DEVICE_ID_GENIUS_MANTICORE) },
621 { HID_USB_DEVICE(USB_VENDOR_ID_KYE,
622 USB_DEVICE_ID_GENIUS_GX_IMPERATOR) },
623 { HID_USB_DEVICE(USB_VENDOR_ID_KYE,
624 USB_DEVICE_ID_KYE_EASYPEN_M406) },
625 { HID_USB_DEVICE(USB_VENDOR_ID_KYE,
626 USB_DEVICE_ID_KYE_EASYPEN_M506) },
627 { HID_USB_DEVICE(USB_VENDOR_ID_KYE,
628 USB_DEVICE_ID_KYE_EASYPEN_I405X) },
629 { HID_USB_DEVICE(USB_VENDOR_ID_KYE,
630 USB_DEVICE_ID_KYE_MOUSEPEN_I608X) },
631 { HID_USB_DEVICE(USB_VENDOR_ID_KYE,
632 USB_DEVICE_ID_KYE_EASYPEN_M406W) },
633 { HID_USB_DEVICE(USB_VENDOR_ID_KYE,
634 USB_DEVICE_ID_KYE_EASYPEN_M610X) },
635 { HID_USB_DEVICE(USB_VENDOR_ID_KYE,
636 USB_DEVICE_ID_KYE_EASYPEN_340) },
637 { HID_USB_DEVICE(USB_VENDOR_ID_KYE,
638 USB_DEVICE_ID_KYE_PENSKETCH_M912) },
639 { HID_USB_DEVICE(USB_VENDOR_ID_KYE,
640 USB_DEVICE_ID_KYE_MOUSEPEN_M508WX) },
641 { HID_USB_DEVICE(USB_VENDOR_ID_KYE,
642 USB_DEVICE_ID_KYE_MOUSEPEN_M508X) },
643 { HID_USB_DEVICE(USB_VENDOR_ID_KYE,
644 USB_DEVICE_ID_KYE_EASYPEN_M406XE) },
645 { HID_USB_DEVICE(USB_VENDOR_ID_KYE,
646 USB_DEVICE_ID_KYE_MOUSEPEN_I608X_V2) },
647 { HID_USB_DEVICE(USB_VENDOR_ID_KYE,
648 USB_DEVICE_ID_KYE_PENSKETCH_T609A) },
649 { }
650};
651MODULE_DEVICE_TABLE(hid, kye_devices);
652
653static struct hid_driver kye_driver = {
654 .name = "kye",
655 .id_table = kye_devices,
656 .probe = kye_probe,
657 .report_fixup = kye_report_fixup,
658};
659module_hid_driver(kye_driver);
660
661MODULE_LICENSE("GPL");
1/*
2 * HID driver for Kye/Genius devices not fully compliant with HID standard
3 *
4 * Copyright (c) 2009 Jiri Kosina
5 * Copyright (c) 2009 Tomas Hanak
6 * Copyright (c) 2012 Nikolai Kondrashov
7 */
8
9/*
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)
13 * any later version.
14 */
15
16#include <linux/device.h>
17#include <linux/hid.h>
18#include <linux/module.h>
19
20#include "hid-ids.h"
21
22/* Original EasyPen i405X report descriptor size */
23#define EASYPEN_I405X_RDESC_ORIG_SIZE 476
24
25/* Fixed EasyPen i405X report descriptor */
26static __u8 easypen_i405x_rdesc_fixed[] = {
27 0x06, 0x00, 0xFF, /* Usage Page (FF00h), */
28 0x09, 0x01, /* Usage (01h), */
29 0xA1, 0x01, /* Collection (Application), */
30 0x85, 0x05, /* Report ID (5), */
31 0x09, 0x01, /* Usage (01h), */
32 0x15, 0x80, /* Logical Minimum (-128), */
33 0x25, 0x7F, /* Logical Maximum (127), */
34 0x75, 0x08, /* Report Size (8), */
35 0x95, 0x07, /* Report Count (7), */
36 0xB1, 0x02, /* Feature (Variable), */
37 0xC0, /* End Collection, */
38 0x05, 0x0D, /* Usage Page (Digitizer), */
39 0x09, 0x02, /* Usage (Pen), */
40 0xA1, 0x01, /* Collection (Application), */
41 0x85, 0x10, /* Report ID (16), */
42 0x09, 0x20, /* Usage (Stylus), */
43 0xA0, /* Collection (Physical), */
44 0x14, /* Logical Minimum (0), */
45 0x25, 0x01, /* Logical Maximum (1), */
46 0x75, 0x01, /* Report Size (1), */
47 0x09, 0x42, /* Usage (Tip Switch), */
48 0x09, 0x44, /* Usage (Barrel Switch), */
49 0x09, 0x46, /* Usage (Tablet Pick), */
50 0x95, 0x03, /* Report Count (3), */
51 0x81, 0x02, /* Input (Variable), */
52 0x95, 0x04, /* Report Count (4), */
53 0x81, 0x03, /* Input (Constant, Variable), */
54 0x09, 0x32, /* Usage (In Range), */
55 0x95, 0x01, /* Report Count (1), */
56 0x81, 0x02, /* Input (Variable), */
57 0x75, 0x10, /* Report Size (16), */
58 0x95, 0x01, /* Report Count (1), */
59 0xA4, /* Push, */
60 0x05, 0x01, /* Usage Page (Desktop), */
61 0x55, 0xFD, /* Unit Exponent (-3), */
62 0x65, 0x13, /* Unit (Inch), */
63 0x34, /* Physical Minimum (0), */
64 0x09, 0x30, /* Usage (X), */
65 0x46, 0x7C, 0x15, /* Physical Maximum (5500), */
66 0x26, 0x00, 0x37, /* Logical Maximum (14080), */
67 0x81, 0x02, /* Input (Variable), */
68 0x09, 0x31, /* Usage (Y), */
69 0x46, 0xA0, 0x0F, /* Physical Maximum (4000), */
70 0x26, 0x00, 0x28, /* Logical Maximum (10240), */
71 0x81, 0x02, /* Input (Variable), */
72 0xB4, /* Pop, */
73 0x09, 0x30, /* Usage (Tip Pressure), */
74 0x26, 0xFF, 0x03, /* Logical Maximum (1023), */
75 0x81, 0x02, /* Input (Variable), */
76 0xC0, /* End Collection, */
77 0xC0 /* End Collection */
78};
79
80/* Original MousePen i608X report descriptor size */
81#define MOUSEPEN_I608X_RDESC_ORIG_SIZE 476
82
83/* Fixed MousePen i608X report descriptor */
84static __u8 mousepen_i608x_rdesc_fixed[] = {
85 0x06, 0x00, 0xFF, /* Usage Page (FF00h), */
86 0x09, 0x01, /* Usage (01h), */
87 0xA1, 0x01, /* Collection (Application), */
88 0x85, 0x05, /* Report ID (5), */
89 0x09, 0x01, /* Usage (01h), */
90 0x15, 0x80, /* Logical Minimum (-128), */
91 0x25, 0x7F, /* Logical Maximum (127), */
92 0x75, 0x08, /* Report Size (8), */
93 0x95, 0x07, /* Report Count (7), */
94 0xB1, 0x02, /* Feature (Variable), */
95 0xC0, /* End Collection, */
96 0x05, 0x0D, /* Usage Page (Digitizer), */
97 0x09, 0x02, /* Usage (Pen), */
98 0xA1, 0x01, /* Collection (Application), */
99 0x85, 0x10, /* Report ID (16), */
100 0x09, 0x20, /* Usage (Stylus), */
101 0xA0, /* Collection (Physical), */
102 0x14, /* Logical Minimum (0), */
103 0x25, 0x01, /* Logical Maximum (1), */
104 0x75, 0x01, /* Report Size (1), */
105 0x09, 0x42, /* Usage (Tip Switch), */
106 0x09, 0x44, /* Usage (Barrel Switch), */
107 0x09, 0x46, /* Usage (Tablet Pick), */
108 0x95, 0x03, /* Report Count (3), */
109 0x81, 0x02, /* Input (Variable), */
110 0x95, 0x04, /* Report Count (4), */
111 0x81, 0x03, /* Input (Constant, Variable), */
112 0x09, 0x32, /* Usage (In Range), */
113 0x95, 0x01, /* Report Count (1), */
114 0x81, 0x02, /* Input (Variable), */
115 0x75, 0x10, /* Report Size (16), */
116 0x95, 0x01, /* Report Count (1), */
117 0xA4, /* Push, */
118 0x05, 0x01, /* Usage Page (Desktop), */
119 0x55, 0xFD, /* Unit Exponent (-3), */
120 0x65, 0x13, /* Unit (Inch), */
121 0x34, /* Physical Minimum (0), */
122 0x09, 0x30, /* Usage (X), */
123 0x46, 0x40, 0x1F, /* Physical Maximum (8000), */
124 0x26, 0x00, 0x50, /* Logical Maximum (20480), */
125 0x81, 0x02, /* Input (Variable), */
126 0x09, 0x31, /* Usage (Y), */
127 0x46, 0x70, 0x17, /* Physical Maximum (6000), */
128 0x26, 0x00, 0x3C, /* Logical Maximum (15360), */
129 0x81, 0x02, /* Input (Variable), */
130 0xB4, /* Pop, */
131 0x09, 0x30, /* Usage (Tip Pressure), */
132 0x26, 0xFF, 0x03, /* Logical Maximum (1023), */
133 0x81, 0x02, /* Input (Variable), */
134 0xC0, /* End Collection, */
135 0xC0, /* End Collection, */
136 0x05, 0x01, /* Usage Page (Desktop), */
137 0x09, 0x02, /* Usage (Mouse), */
138 0xA1, 0x01, /* Collection (Application), */
139 0x85, 0x11, /* Report ID (17), */
140 0x09, 0x01, /* Usage (Pointer), */
141 0xA0, /* Collection (Physical), */
142 0x14, /* Logical Minimum (0), */
143 0xA4, /* Push, */
144 0x05, 0x09, /* Usage Page (Button), */
145 0x75, 0x01, /* Report Size (1), */
146 0x19, 0x01, /* Usage Minimum (01h), */
147 0x29, 0x03, /* Usage Maximum (03h), */
148 0x25, 0x01, /* Logical Maximum (1), */
149 0x95, 0x03, /* Report Count (3), */
150 0x81, 0x02, /* Input (Variable), */
151 0x95, 0x05, /* Report Count (5), */
152 0x81, 0x01, /* Input (Constant), */
153 0xB4, /* Pop, */
154 0x95, 0x01, /* Report Count (1), */
155 0xA4, /* Push, */
156 0x55, 0xFD, /* Unit Exponent (-3), */
157 0x65, 0x13, /* Unit (Inch), */
158 0x34, /* Physical Minimum (0), */
159 0x75, 0x10, /* Report Size (16), */
160 0x09, 0x30, /* Usage (X), */
161 0x46, 0x40, 0x1F, /* Physical Maximum (8000), */
162 0x26, 0x00, 0x50, /* Logical Maximum (20480), */
163 0x81, 0x02, /* Input (Variable), */
164 0x09, 0x31, /* Usage (Y), */
165 0x46, 0x70, 0x17, /* Physical Maximum (6000), */
166 0x26, 0x00, 0x3C, /* Logical Maximum (15360), */
167 0x81, 0x02, /* Input (Variable), */
168 0xB4, /* Pop, */
169 0x75, 0x08, /* Report Size (8), */
170 0x09, 0x38, /* Usage (Wheel), */
171 0x15, 0xFF, /* Logical Minimum (-1), */
172 0x25, 0x01, /* Logical Maximum (1), */
173 0x81, 0x06, /* Input (Variable, Relative), */
174 0x81, 0x01, /* Input (Constant), */
175 0xC0, /* End Collection, */
176 0xC0 /* End Collection */
177};
178
179/* Original MousePen i608X v2 report descriptor size */
180#define MOUSEPEN_I608X_V2_RDESC_ORIG_SIZE 482
181
182/* Fixed MousePen i608X v2 report descriptor */
183static __u8 mousepen_i608x_v2_rdesc_fixed[] = {
184 0x06, 0x00, 0xFF, /* Usage Page (FF00h), */
185 0x09, 0x01, /* Usage (01h), */
186 0xA1, 0x01, /* Collection (Application), */
187 0x85, 0x05, /* Report ID (5), */
188 0x09, 0x01, /* Usage (01h), */
189 0x15, 0x80, /* Logical Minimum (-128), */
190 0x25, 0x7F, /* Logical Maximum (127), */
191 0x75, 0x08, /* Report Size (8), */
192 0x95, 0x07, /* Report Count (7), */
193 0xB1, 0x02, /* Feature (Variable), */
194 0xC0, /* End Collection, */
195 0x05, 0x0D, /* Usage Page (Digitizer), */
196 0x09, 0x02, /* Usage (Pen), */
197 0xA1, 0x01, /* Collection (Application), */
198 0x85, 0x10, /* Report ID (16), */
199 0x09, 0x20, /* Usage (Stylus), */
200 0xA0, /* Collection (Physical), */
201 0x14, /* Logical Minimum (0), */
202 0x25, 0x01, /* Logical Maximum (1), */
203 0x75, 0x01, /* Report Size (1), */
204 0x09, 0x42, /* Usage (Tip Switch), */
205 0x09, 0x44, /* Usage (Barrel Switch), */
206 0x09, 0x46, /* Usage (Tablet Pick), */
207 0x95, 0x03, /* Report Count (3), */
208 0x81, 0x02, /* Input (Variable), */
209 0x95, 0x04, /* Report Count (4), */
210 0x81, 0x03, /* Input (Constant, Variable), */
211 0x09, 0x32, /* Usage (In Range), */
212 0x95, 0x01, /* Report Count (1), */
213 0x81, 0x02, /* Input (Variable), */
214 0x75, 0x10, /* Report Size (16), */
215 0x95, 0x01, /* Report Count (1), */
216 0xA4, /* Push, */
217 0x05, 0x01, /* Usage Page (Desktop), */
218 0x55, 0xFD, /* Unit Exponent (-3), */
219 0x65, 0x13, /* Unit (Inch), */
220 0x34, /* Physical Minimum (0), */
221 0x09, 0x30, /* Usage (X), */
222 0x46, 0x40, 0x1F, /* Physical Maximum (8000), */
223 0x27, 0x00, 0xA0, 0x00, 0x00, /* Logical Maximum (40960), */
224 0x81, 0x02, /* Input (Variable), */
225 0x09, 0x31, /* Usage (Y), */
226 0x46, 0x70, 0x17, /* Physical Maximum (6000), */
227 0x26, 0x00, 0x78, /* Logical Maximum (30720), */
228 0x81, 0x02, /* Input (Variable), */
229 0xB4, /* Pop, */
230 0x09, 0x30, /* Usage (Tip Pressure), */
231 0x26, 0xFF, 0x07, /* Logical Maximum (2047), */
232 0x81, 0x02, /* Input (Variable), */
233 0xC0, /* End Collection, */
234 0xC0, /* End Collection, */
235 0x05, 0x01, /* Usage Page (Desktop), */
236 0x09, 0x02, /* Usage (Mouse), */
237 0xA1, 0x01, /* Collection (Application), */
238 0x85, 0x11, /* Report ID (17), */
239 0x09, 0x01, /* Usage (Pointer), */
240 0xA0, /* Collection (Physical), */
241 0x14, /* Logical Minimum (0), */
242 0xA4, /* Push, */
243 0x05, 0x09, /* Usage Page (Button), */
244 0x75, 0x01, /* Report Size (1), */
245 0x19, 0x01, /* Usage Minimum (01h), */
246 0x29, 0x03, /* Usage Maximum (03h), */
247 0x25, 0x01, /* Logical Maximum (1), */
248 0x95, 0x03, /* Report Count (3), */
249 0x81, 0x02, /* Input (Variable), */
250 0x95, 0x05, /* Report Count (5), */
251 0x81, 0x01, /* Input (Constant), */
252 0xB4, /* Pop, */
253 0x95, 0x01, /* Report Count (1), */
254 0xA4, /* Push, */
255 0x55, 0xFD, /* Unit Exponent (-3), */
256 0x65, 0x13, /* Unit (Inch), */
257 0x34, /* Physical Minimum (0), */
258 0x75, 0x10, /* Report Size (16), */
259 0x09, 0x30, /* Usage (X), */
260 0x46, 0x40, 0x1F, /* Physical Maximum (8000), */
261 0x27, 0x00, 0xA0, 0x00, 0x00, /* Logical Maximum (40960), */
262 0x81, 0x02, /* Input (Variable), */
263 0x09, 0x31, /* Usage (Y), */
264 0x46, 0x70, 0x17, /* Physical Maximum (6000), */
265 0x26, 0x00, 0x78, /* Logical Maximum (30720), */
266 0x81, 0x02, /* Input (Variable), */
267 0xB4, /* Pop, */
268 0x75, 0x08, /* Report Size (8), */
269 0x09, 0x38, /* Usage (Wheel), */
270 0x15, 0xFF, /* Logical Minimum (-1), */
271 0x25, 0x01, /* Logical Maximum (1), */
272 0x81, 0x06, /* Input (Variable, Relative), */
273 0x81, 0x01, /* Input (Constant), */
274 0xC0, /* End Collection, */
275 0xC0 /* End Collection */
276};
277
278/* Original EasyPen M610X report descriptor size */
279#define EASYPEN_M610X_RDESC_ORIG_SIZE 476
280
281/* Fixed EasyPen M610X report descriptor */
282static __u8 easypen_m610x_rdesc_fixed[] = {
283 0x06, 0x00, 0xFF, /* Usage Page (FF00h), */
284 0x09, 0x01, /* Usage (01h), */
285 0xA1, 0x01, /* Collection (Application), */
286 0x85, 0x05, /* Report ID (5), */
287 0x09, 0x01, /* Usage (01h), */
288 0x15, 0x80, /* Logical Minimum (-128), */
289 0x25, 0x7F, /* Logical Maximum (127), */
290 0x75, 0x08, /* Report Size (8), */
291 0x95, 0x07, /* Report Count (7), */
292 0xB1, 0x02, /* Feature (Variable), */
293 0xC0, /* End Collection, */
294 0x05, 0x0D, /* Usage Page (Digitizer), */
295 0x09, 0x02, /* Usage (Pen), */
296 0xA1, 0x01, /* Collection (Application), */
297 0x85, 0x10, /* Report ID (16), */
298 0x09, 0x20, /* Usage (Stylus), */
299 0xA0, /* Collection (Physical), */
300 0x14, /* Logical Minimum (0), */
301 0x25, 0x01, /* Logical Maximum (1), */
302 0x75, 0x01, /* Report Size (1), */
303 0x09, 0x42, /* Usage (Tip Switch), */
304 0x09, 0x44, /* Usage (Barrel Switch), */
305 0x09, 0x46, /* Usage (Tablet Pick), */
306 0x95, 0x03, /* Report Count (3), */
307 0x81, 0x02, /* Input (Variable), */
308 0x95, 0x04, /* Report Count (4), */
309 0x81, 0x03, /* Input (Constant, Variable), */
310 0x09, 0x32, /* Usage (In Range), */
311 0x95, 0x01, /* Report Count (1), */
312 0x81, 0x02, /* Input (Variable), */
313 0x75, 0x10, /* Report Size (16), */
314 0x95, 0x01, /* Report Count (1), */
315 0xA4, /* Push, */
316 0x05, 0x01, /* Usage Page (Desktop), */
317 0x55, 0xFD, /* Unit Exponent (-3), */
318 0x65, 0x13, /* Unit (Inch), */
319 0x34, /* Physical Minimum (0), */
320 0x09, 0x30, /* Usage (X), */
321 0x46, 0x10, 0x27, /* Physical Maximum (10000), */
322 0x27, 0x00, 0xA0, 0x00, 0x00, /* Logical Maximum (40960), */
323 0x81, 0x02, /* Input (Variable), */
324 0x09, 0x31, /* Usage (Y), */
325 0x46, 0x6A, 0x18, /* Physical Maximum (6250), */
326 0x26, 0x00, 0x64, /* Logical Maximum (25600), */
327 0x81, 0x02, /* Input (Variable), */
328 0xB4, /* Pop, */
329 0x09, 0x30, /* Usage (Tip Pressure), */
330 0x26, 0xFF, 0x03, /* Logical Maximum (1023), */
331 0x81, 0x02, /* Input (Variable), */
332 0xC0, /* End Collection, */
333 0xC0, /* End Collection, */
334 0x05, 0x0C, /* Usage Page (Consumer), */
335 0x09, 0x01, /* Usage (Consumer Control), */
336 0xA1, 0x01, /* Collection (Application), */
337 0x85, 0x12, /* Report ID (18), */
338 0x14, /* Logical Minimum (0), */
339 0x25, 0x01, /* Logical Maximum (1), */
340 0x75, 0x01, /* Report Size (1), */
341 0x95, 0x04, /* Report Count (4), */
342 0x0A, 0x1A, 0x02, /* Usage (AC Undo), */
343 0x0A, 0x79, 0x02, /* Usage (AC Redo Or Repeat), */
344 0x0A, 0x2D, 0x02, /* Usage (AC Zoom In), */
345 0x0A, 0x2E, 0x02, /* Usage (AC Zoom Out), */
346 0x81, 0x02, /* Input (Variable), */
347 0x95, 0x01, /* Report Count (1), */
348 0x75, 0x14, /* Report Size (20), */
349 0x81, 0x03, /* Input (Constant, Variable), */
350 0x75, 0x20, /* Report Size (32), */
351 0x81, 0x03, /* Input (Constant, Variable), */
352 0xC0 /* End Collection */
353};
354
355
356/* Original PenSketch M912 report descriptor size */
357#define PENSKETCH_M912_RDESC_ORIG_SIZE 482
358
359/* Fixed PenSketch M912 report descriptor */
360static __u8 pensketch_m912_rdesc_fixed[] = {
361 0x05, 0x01, /* Usage Page (Desktop), */
362 0x08, /* Usage (00h), */
363 0xA1, 0x01, /* Collection (Application), */
364 0x85, 0x05, /* Report ID (5), */
365 0x06, 0x00, 0xFF, /* Usage Page (FF00h), */
366 0x09, 0x01, /* Usage (01h), */
367 0x15, 0x81, /* Logical Minimum (-127), */
368 0x25, 0x7F, /* Logical Maximum (127), */
369 0x75, 0x08, /* Report Size (8), */
370 0x95, 0x07, /* Report Count (7), */
371 0xB1, 0x02, /* Feature (Variable), */
372 0xC0, /* End Collection, */
373 0x05, 0x0D, /* Usage Page (Digitizer), */
374 0x09, 0x02, /* Usage (Pen), */
375 0xA1, 0x01, /* Collection (Application), */
376 0x85, 0x10, /* Report ID (16), */
377 0x09, 0x20, /* Usage (Stylus), */
378 0xA0, /* Collection (Physical), */
379 0x09, 0x42, /* Usage (Tip Switch), */
380 0x09, 0x44, /* Usage (Barrel Switch), */
381 0x09, 0x46, /* Usage (Tablet Pick), */
382 0x14, /* Logical Minimum (0), */
383 0x25, 0x01, /* Logical Maximum (1), */
384 0x75, 0x01, /* Report Size (1), */
385 0x95, 0x03, /* Report Count (3), */
386 0x81, 0x02, /* Input (Variable), */
387 0x95, 0x04, /* Report Count (4), */
388 0x81, 0x03, /* Input (Constant, Variable), */
389 0x09, 0x32, /* Usage (In Range), */
390 0x95, 0x01, /* Report Count (1), */
391 0x81, 0x02, /* Input (Variable), */
392 0x75, 0x10, /* Report Size (16), */
393 0x95, 0x01, /* Report Count (1), */
394 0xA4, /* Push, */
395 0x05, 0x01, /* Usage Page (Desktop), */
396 0x55, 0xFD, /* Unit Exponent (-3), */
397 0x65, 0x13, /* Unit (Inch), */
398 0x14, /* Logical Minimum (0), */
399 0x34, /* Physical Minimum (0), */
400 0x09, 0x30, /* Usage (X), */
401 0x27, 0x00, 0xF0, 0x00, 0x00, /* Logical Maximum (61440), */
402 0x46, 0xE0, 0x2E, /* Physical Maximum (12000), */
403 0x81, 0x02, /* Input (Variable), */
404 0x09, 0x31, /* Usage (Y), */
405 0x27, 0x00, 0xB4, 0x00, 0x00, /* Logical Maximum (46080), */
406 0x46, 0x28, 0x23, /* Physical Maximum (9000), */
407 0x81, 0x02, /* Input (Variable), */
408 0xB4, /* Pop, */
409 0x09, 0x30, /* Usage (Tip Pressure), */
410 0x14, /* Logical Minimum (0), */
411 0x26, 0xFF, 0x07, /* Logical Maximum (2047), */
412 0x81, 0x02, /* Input (Variable), */
413 0xC0, /* End Collection, */
414 0xC0, /* End Collection, */
415 0x05, 0x0D, /* Usage Page (Digitizer), */
416 0x09, 0x21, /* Usage (Puck), */
417 0xA1, 0x01, /* Collection (Application), */
418 0x85, 0x11, /* Report ID (17), */
419 0x09, 0x21, /* Usage (Puck), */
420 0xA0, /* Collection (Physical), */
421 0x05, 0x09, /* Usage Page (Button), */
422 0x75, 0x01, /* Report Size (1), */
423 0x19, 0x01, /* Usage Minimum (01h), */
424 0x29, 0x03, /* Usage Maximum (03h), */
425 0x14, /* Logical Minimum (0), */
426 0x25, 0x01, /* Logical Maximum (1), */
427 0x95, 0x03, /* Report Count (3), */
428 0x81, 0x02, /* Input (Variable), */
429 0x95, 0x04, /* Report Count (4), */
430 0x81, 0x01, /* Input (Constant), */
431 0x95, 0x01, /* Report Count (1), */
432 0x0B, 0x32, 0x00, 0x0D, 0x00, /* Usage (Digitizer In Range), */
433 0x14, /* Logical Minimum (0), */
434 0x25, 0x01, /* Logical Maximum (1), */
435 0x81, 0x02, /* Input (Variable), */
436 0xA4, /* Push, */
437 0x05, 0x01, /* Usage Page (Desktop), */
438 0x75, 0x10, /* Report Size (16), */
439 0x95, 0x01, /* Report Count (1), */
440 0x55, 0xFD, /* Unit Exponent (-3), */
441 0x65, 0x13, /* Unit (Inch), */
442 0x14, /* Logical Minimum (0), */
443 0x34, /* Physical Minimum (0), */
444 0x09, 0x30, /* Usage (X), */
445 0x27, 0x00, 0xF0, 0x00, 0x00, /* Logical Maximum (61440), */
446 0x46, 0xE0, 0x2E, /* Physical Maximum (12000), */
447 0x81, 0x02, /* Input (Variable), */
448 0x09, 0x31, /* Usage (Y), */
449 0x27, 0x00, 0xB4, 0x00, 0x00, /* Logical Maximum (46080), */
450 0x46, 0x28, 0x23, /* Physical Maximum (9000), */
451 0x81, 0x02, /* Input (Variable), */
452 0x09, 0x38, /* Usage (Wheel), */
453 0x75, 0x08, /* Report Size (8), */
454 0x95, 0x01, /* Report Count (1), */
455 0x15, 0xFF, /* Logical Minimum (-1), */
456 0x25, 0x01, /* Logical Maximum (1), */
457 0x34, /* Physical Minimum (0), */
458 0x44, /* Physical Maximum (0), */
459 0x81, 0x06, /* Input (Variable, Relative), */
460 0xB4, /* Pop, */
461 0xC0, /* End Collection, */
462 0xC0, /* End Collection, */
463 0x05, 0x0C, /* Usage Page (Consumer), */
464 0x09, 0x01, /* Usage (Consumer Control), */
465 0xA1, 0x01, /* Collection (Application), */
466 0x85, 0x12, /* Report ID (18), */
467 0x14, /* Logical Minimum (0), */
468 0x25, 0x01, /* Logical Maximum (1), */
469 0x75, 0x01, /* Report Size (1), */
470 0x95, 0x08, /* Report Count (8), */
471 0x05, 0x0C, /* Usage Page (Consumer), */
472 0x0A, 0x6A, 0x02, /* Usage (AC Delete), */
473 0x0A, 0x1A, 0x02, /* Usage (AC Undo), */
474 0x0A, 0x01, 0x02, /* Usage (AC New), */
475 0x0A, 0x2F, 0x02, /* Usage (AC Zoom), */
476 0x0A, 0x25, 0x02, /* Usage (AC Forward), */
477 0x0A, 0x24, 0x02, /* Usage (AC Back), */
478 0x0A, 0x2D, 0x02, /* Usage (AC Zoom In), */
479 0x0A, 0x2E, 0x02, /* Usage (AC Zoom Out), */
480 0x81, 0x02, /* Input (Variable), */
481 0x95, 0x30, /* Report Count (48), */
482 0x81, 0x03, /* Input (Constant, Variable), */
483 0xC0 /* End Collection */
484};
485
486static __u8 *kye_consumer_control_fixup(struct hid_device *hdev, __u8 *rdesc,
487 unsigned int *rsize, int offset, const char *device_name) {
488 /*
489 * the fixup that need to be done:
490 * - change Usage Maximum in the Consumer Control
491 * (report ID 3) to a reasonable value
492 */
493 if (*rsize >= offset + 31 &&
494 /* Usage Page (Consumer Devices) */
495 rdesc[offset] == 0x05 && rdesc[offset + 1] == 0x0c &&
496 /* Usage (Consumer Control) */
497 rdesc[offset + 2] == 0x09 && rdesc[offset + 3] == 0x01 &&
498 /* Usage Maximum > 12287 */
499 rdesc[offset + 10] == 0x2a && rdesc[offset + 12] > 0x2f) {
500 hid_info(hdev, "fixing up %s report descriptor\n", device_name);
501 rdesc[offset + 12] = 0x2f;
502 }
503 return rdesc;
504}
505
506static __u8 *kye_report_fixup(struct hid_device *hdev, __u8 *rdesc,
507 unsigned int *rsize)
508{
509 switch (hdev->product) {
510 case USB_DEVICE_ID_KYE_ERGO_525V:
511 /* the fixups that need to be done:
512 * - change led usage page to button for extra buttons
513 * - report size 8 count 1 must be size 1 count 8 for button
514 * bitfield
515 * - change the button usage range to 4-7 for the extra
516 * buttons
517 */
518 if (*rsize >= 75 &&
519 rdesc[61] == 0x05 && rdesc[62] == 0x08 &&
520 rdesc[63] == 0x19 && rdesc[64] == 0x08 &&
521 rdesc[65] == 0x29 && rdesc[66] == 0x0f &&
522 rdesc[71] == 0x75 && rdesc[72] == 0x08 &&
523 rdesc[73] == 0x95 && rdesc[74] == 0x01) {
524 hid_info(hdev,
525 "fixing up Kye/Genius Ergo Mouse "
526 "report descriptor\n");
527 rdesc[62] = 0x09;
528 rdesc[64] = 0x04;
529 rdesc[66] = 0x07;
530 rdesc[72] = 0x01;
531 rdesc[74] = 0x08;
532 }
533 break;
534 case USB_DEVICE_ID_KYE_EASYPEN_I405X:
535 if (*rsize == EASYPEN_I405X_RDESC_ORIG_SIZE) {
536 rdesc = easypen_i405x_rdesc_fixed;
537 *rsize = sizeof(easypen_i405x_rdesc_fixed);
538 }
539 break;
540 case USB_DEVICE_ID_KYE_MOUSEPEN_I608X:
541 if (*rsize == MOUSEPEN_I608X_RDESC_ORIG_SIZE) {
542 rdesc = mousepen_i608x_rdesc_fixed;
543 *rsize = sizeof(mousepen_i608x_rdesc_fixed);
544 }
545 break;
546 case USB_DEVICE_ID_KYE_MOUSEPEN_I608X_V2:
547 if (*rsize == MOUSEPEN_I608X_V2_RDESC_ORIG_SIZE) {
548 rdesc = mousepen_i608x_v2_rdesc_fixed;
549 *rsize = sizeof(mousepen_i608x_v2_rdesc_fixed);
550 }
551 break;
552 case USB_DEVICE_ID_KYE_EASYPEN_M610X:
553 if (*rsize == EASYPEN_M610X_RDESC_ORIG_SIZE) {
554 rdesc = easypen_m610x_rdesc_fixed;
555 *rsize = sizeof(easypen_m610x_rdesc_fixed);
556 }
557 break;
558 case USB_DEVICE_ID_KYE_PENSKETCH_M912:
559 if (*rsize == PENSKETCH_M912_RDESC_ORIG_SIZE) {
560 rdesc = pensketch_m912_rdesc_fixed;
561 *rsize = sizeof(pensketch_m912_rdesc_fixed);
562 }
563 break;
564 case USB_DEVICE_ID_GENIUS_GILA_GAMING_MOUSE:
565 rdesc = kye_consumer_control_fixup(hdev, rdesc, rsize, 104,
566 "Genius Gila Gaming Mouse");
567 break;
568 case USB_DEVICE_ID_GENIUS_GX_IMPERATOR:
569 rdesc = kye_consumer_control_fixup(hdev, rdesc, rsize, 83,
570 "Genius Gx Imperator Keyboard");
571 break;
572 case USB_DEVICE_ID_GENIUS_MANTICORE:
573 rdesc = kye_consumer_control_fixup(hdev, rdesc, rsize, 104,
574 "Genius Manticore Keyboard");
575 break;
576 }
577 return rdesc;
578}
579
580/**
581 * Enable fully-functional tablet mode by setting a special feature report.
582 *
583 * @hdev: HID device
584 *
585 * The specific report ID and data were discovered by sniffing the
586 * Windows driver traffic.
587 */
588static int kye_tablet_enable(struct hid_device *hdev)
589{
590 struct list_head *list;
591 struct list_head *head;
592 struct hid_report *report;
593 __s32 *value;
594
595 list = &hdev->report_enum[HID_FEATURE_REPORT].report_list;
596 list_for_each(head, list) {
597 report = list_entry(head, struct hid_report, list);
598 if (report->id == 5)
599 break;
600 }
601
602 if (head == list) {
603 hid_err(hdev, "tablet-enabling feature report not found\n");
604 return -ENODEV;
605 }
606
607 if (report->maxfield < 1 || report->field[0]->report_count < 7) {
608 hid_err(hdev, "invalid tablet-enabling feature report\n");
609 return -ENODEV;
610 }
611
612 value = report->field[0]->value;
613
614 value[0] = 0x12;
615 value[1] = 0x10;
616 value[2] = 0x11;
617 value[3] = 0x12;
618 value[4] = 0x00;
619 value[5] = 0x00;
620 value[6] = 0x00;
621 hid_hw_request(hdev, report, HID_REQ_SET_REPORT);
622
623 return 0;
624}
625
626static int kye_probe(struct hid_device *hdev, const struct hid_device_id *id)
627{
628 int ret;
629
630 ret = hid_parse(hdev);
631 if (ret) {
632 hid_err(hdev, "parse failed\n");
633 goto err;
634 }
635
636 ret = hid_hw_start(hdev, HID_CONNECT_DEFAULT);
637 if (ret) {
638 hid_err(hdev, "hw start failed\n");
639 goto err;
640 }
641
642 switch (id->product) {
643 case USB_DEVICE_ID_KYE_EASYPEN_I405X:
644 case USB_DEVICE_ID_KYE_MOUSEPEN_I608X:
645 case USB_DEVICE_ID_KYE_MOUSEPEN_I608X_V2:
646 case USB_DEVICE_ID_KYE_EASYPEN_M610X:
647 case USB_DEVICE_ID_KYE_PENSKETCH_M912:
648 ret = kye_tablet_enable(hdev);
649 if (ret) {
650 hid_err(hdev, "tablet enabling failed\n");
651 goto enabling_err;
652 }
653 break;
654 case USB_DEVICE_ID_GENIUS_MANTICORE:
655 /*
656 * The manticore keyboard needs to have all the interfaces
657 * opened at least once to be fully functional.
658 */
659 if (hid_hw_open(hdev))
660 hid_hw_close(hdev);
661 break;
662 }
663
664 return 0;
665enabling_err:
666 hid_hw_stop(hdev);
667err:
668 return ret;
669}
670
671static const struct hid_device_id kye_devices[] = {
672 { HID_USB_DEVICE(USB_VENDOR_ID_KYE, USB_DEVICE_ID_KYE_ERGO_525V) },
673 { HID_USB_DEVICE(USB_VENDOR_ID_KYE,
674 USB_DEVICE_ID_KYE_EASYPEN_I405X) },
675 { HID_USB_DEVICE(USB_VENDOR_ID_KYE,
676 USB_DEVICE_ID_KYE_MOUSEPEN_I608X) },
677 { HID_USB_DEVICE(USB_VENDOR_ID_KYE,
678 USB_DEVICE_ID_KYE_MOUSEPEN_I608X_V2) },
679 { HID_USB_DEVICE(USB_VENDOR_ID_KYE,
680 USB_DEVICE_ID_KYE_EASYPEN_M610X) },
681 { HID_USB_DEVICE(USB_VENDOR_ID_KYE,
682 USB_DEVICE_ID_GENIUS_GILA_GAMING_MOUSE) },
683 { HID_USB_DEVICE(USB_VENDOR_ID_KYE,
684 USB_DEVICE_ID_GENIUS_GX_IMPERATOR) },
685 { HID_USB_DEVICE(USB_VENDOR_ID_KYE,
686 USB_DEVICE_ID_GENIUS_MANTICORE) },
687 { HID_USB_DEVICE(USB_VENDOR_ID_KYE,
688 USB_DEVICE_ID_KYE_PENSKETCH_M912) },
689 { }
690};
691MODULE_DEVICE_TABLE(hid, kye_devices);
692
693static struct hid_driver kye_driver = {
694 .name = "kye",
695 .id_table = kye_devices,
696 .probe = kye_probe,
697 .report_fixup = kye_report_fixup,
698};
699module_hid_driver(kye_driver);
700
701MODULE_LICENSE("GPL");