Linux 3.9-rc4
[linux-2.6/cjktty.git] / drivers / hid / usbhid / hid-pidff.c
blobf91c136821f7097e05cd761ed9f554a56fabcfed
1 /*
2 * Force feedback driver for USB HID PID compliant devices
4 * Copyright (c) 2005, 2006 Anssi Hannula <anssi.hannula@gmail.com>
5 */
7 /*
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License as published by
10 * the Free Software Foundation; either version 2 of the License, or
11 * (at your option) any later version.
13 * This program is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 * GNU General Public License for more details.
18 * You should have received a copy of the GNU General Public License
19 * along with this program; if not, write to the Free Software
20 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
23 /* #define DEBUG */
25 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
27 #include <linux/input.h>
28 #include <linux/slab.h>
29 #include <linux/usb.h>
31 #include <linux/hid.h>
33 #include "usbhid.h"
35 #define PID_EFFECTS_MAX 64
37 /* Report usage table used to put reports into an array */
39 #define PID_SET_EFFECT 0
40 #define PID_EFFECT_OPERATION 1
41 #define PID_DEVICE_GAIN 2
42 #define PID_POOL 3
43 #define PID_BLOCK_LOAD 4
44 #define PID_BLOCK_FREE 5
45 #define PID_DEVICE_CONTROL 6
46 #define PID_CREATE_NEW_EFFECT 7
48 #define PID_REQUIRED_REPORTS 7
50 #define PID_SET_ENVELOPE 8
51 #define PID_SET_CONDITION 9
52 #define PID_SET_PERIODIC 10
53 #define PID_SET_CONSTANT 11
54 #define PID_SET_RAMP 12
55 static const u8 pidff_reports[] = {
56 0x21, 0x77, 0x7d, 0x7f, 0x89, 0x90, 0x96, 0xab,
57 0x5a, 0x5f, 0x6e, 0x73, 0x74
60 /* device_control is really 0x95, but 0x96 specified as it is the usage of
61 the only field in that report */
63 /* Value usage tables used to put fields and values into arrays */
65 #define PID_EFFECT_BLOCK_INDEX 0
67 #define PID_DURATION 1
68 #define PID_GAIN 2
69 #define PID_TRIGGER_BUTTON 3
70 #define PID_TRIGGER_REPEAT_INT 4
71 #define PID_DIRECTION_ENABLE 5
72 #define PID_START_DELAY 6
73 static const u8 pidff_set_effect[] = {
74 0x22, 0x50, 0x52, 0x53, 0x54, 0x56, 0xa7
77 #define PID_ATTACK_LEVEL 1
78 #define PID_ATTACK_TIME 2
79 #define PID_FADE_LEVEL 3
80 #define PID_FADE_TIME 4
81 static const u8 pidff_set_envelope[] = { 0x22, 0x5b, 0x5c, 0x5d, 0x5e };
83 #define PID_PARAM_BLOCK_OFFSET 1
84 #define PID_CP_OFFSET 2
85 #define PID_POS_COEFFICIENT 3
86 #define PID_NEG_COEFFICIENT 4
87 #define PID_POS_SATURATION 5
88 #define PID_NEG_SATURATION 6
89 #define PID_DEAD_BAND 7
90 static const u8 pidff_set_condition[] = {
91 0x22, 0x23, 0x60, 0x61, 0x62, 0x63, 0x64, 0x65
94 #define PID_MAGNITUDE 1
95 #define PID_OFFSET 2
96 #define PID_PHASE 3
97 #define PID_PERIOD 4
98 static const u8 pidff_set_periodic[] = { 0x22, 0x70, 0x6f, 0x71, 0x72 };
99 static const u8 pidff_set_constant[] = { 0x22, 0x70 };
101 #define PID_RAMP_START 1
102 #define PID_RAMP_END 2
103 static const u8 pidff_set_ramp[] = { 0x22, 0x75, 0x76 };
105 #define PID_RAM_POOL_AVAILABLE 1
106 static const u8 pidff_block_load[] = { 0x22, 0xac };
108 #define PID_LOOP_COUNT 1
109 static const u8 pidff_effect_operation[] = { 0x22, 0x7c };
111 static const u8 pidff_block_free[] = { 0x22 };
113 #define PID_DEVICE_GAIN_FIELD 0
114 static const u8 pidff_device_gain[] = { 0x7e };
116 #define PID_RAM_POOL_SIZE 0
117 #define PID_SIMULTANEOUS_MAX 1
118 #define PID_DEVICE_MANAGED_POOL 2
119 static const u8 pidff_pool[] = { 0x80, 0x83, 0xa9 };
121 /* Special field key tables used to put special field keys into arrays */
123 #define PID_ENABLE_ACTUATORS 0
124 #define PID_RESET 1
125 static const u8 pidff_device_control[] = { 0x97, 0x9a };
127 #define PID_CONSTANT 0
128 #define PID_RAMP 1
129 #define PID_SQUARE 2
130 #define PID_SINE 3
131 #define PID_TRIANGLE 4
132 #define PID_SAW_UP 5
133 #define PID_SAW_DOWN 6
134 #define PID_SPRING 7
135 #define PID_DAMPER 8
136 #define PID_INERTIA 9
137 #define PID_FRICTION 10
138 static const u8 pidff_effect_types[] = {
139 0x26, 0x27, 0x30, 0x31, 0x32, 0x33, 0x34,
140 0x40, 0x41, 0x42, 0x43
143 #define PID_BLOCK_LOAD_SUCCESS 0
144 #define PID_BLOCK_LOAD_FULL 1
145 static const u8 pidff_block_load_status[] = { 0x8c, 0x8d };
147 #define PID_EFFECT_START 0
148 #define PID_EFFECT_STOP 1
149 static const u8 pidff_effect_operation_status[] = { 0x79, 0x7b };
151 struct pidff_usage {
152 struct hid_field *field;
153 s32 *value;
156 struct pidff_device {
157 struct hid_device *hid;
159 struct hid_report *reports[sizeof(pidff_reports)];
161 struct pidff_usage set_effect[sizeof(pidff_set_effect)];
162 struct pidff_usage set_envelope[sizeof(pidff_set_envelope)];
163 struct pidff_usage set_condition[sizeof(pidff_set_condition)];
164 struct pidff_usage set_periodic[sizeof(pidff_set_periodic)];
165 struct pidff_usage set_constant[sizeof(pidff_set_constant)];
166 struct pidff_usage set_ramp[sizeof(pidff_set_ramp)];
168 struct pidff_usage device_gain[sizeof(pidff_device_gain)];
169 struct pidff_usage block_load[sizeof(pidff_block_load)];
170 struct pidff_usage pool[sizeof(pidff_pool)];
171 struct pidff_usage effect_operation[sizeof(pidff_effect_operation)];
172 struct pidff_usage block_free[sizeof(pidff_block_free)];
174 /* Special field is a field that is not composed of
175 usage<->value pairs that pidff_usage values are */
177 /* Special field in create_new_effect */
178 struct hid_field *create_new_effect_type;
180 /* Special fields in set_effect */
181 struct hid_field *set_effect_type;
182 struct hid_field *effect_direction;
184 /* Special field in device_control */
185 struct hid_field *device_control;
187 /* Special field in block_load */
188 struct hid_field *block_load_status;
190 /* Special field in effect_operation */
191 struct hid_field *effect_operation_status;
193 int control_id[sizeof(pidff_device_control)];
194 int type_id[sizeof(pidff_effect_types)];
195 int status_id[sizeof(pidff_block_load_status)];
196 int operation_id[sizeof(pidff_effect_operation_status)];
198 int pid_id[PID_EFFECTS_MAX];
202 * Scale an unsigned value with range 0..max for the given field
204 static int pidff_rescale(int i, int max, struct hid_field *field)
206 return i * (field->logical_maximum - field->logical_minimum) / max +
207 field->logical_minimum;
211 * Scale a signed value in range -0x8000..0x7fff for the given field
213 static int pidff_rescale_signed(int i, struct hid_field *field)
215 return i == 0 ? 0 : i >
216 0 ? i * field->logical_maximum / 0x7fff : i *
217 field->logical_minimum / -0x8000;
220 static void pidff_set(struct pidff_usage *usage, u16 value)
222 usage->value[0] = pidff_rescale(value, 0xffff, usage->field);
223 pr_debug("calculated from %d to %d\n", value, usage->value[0]);
226 static void pidff_set_signed(struct pidff_usage *usage, s16 value)
228 if (usage->field->logical_minimum < 0)
229 usage->value[0] = pidff_rescale_signed(value, usage->field);
230 else {
231 if (value < 0)
232 usage->value[0] =
233 pidff_rescale(-value, 0x8000, usage->field);
234 else
235 usage->value[0] =
236 pidff_rescale(value, 0x7fff, usage->field);
238 pr_debug("calculated from %d to %d\n", value, usage->value[0]);
242 * Send envelope report to the device
244 static void pidff_set_envelope_report(struct pidff_device *pidff,
245 struct ff_envelope *envelope)
247 pidff->set_envelope[PID_EFFECT_BLOCK_INDEX].value[0] =
248 pidff->block_load[PID_EFFECT_BLOCK_INDEX].value[0];
250 pidff->set_envelope[PID_ATTACK_LEVEL].value[0] =
251 pidff_rescale(envelope->attack_level >
252 0x7fff ? 0x7fff : envelope->attack_level, 0x7fff,
253 pidff->set_envelope[PID_ATTACK_LEVEL].field);
254 pidff->set_envelope[PID_FADE_LEVEL].value[0] =
255 pidff_rescale(envelope->fade_level >
256 0x7fff ? 0x7fff : envelope->fade_level, 0x7fff,
257 pidff->set_envelope[PID_FADE_LEVEL].field);
259 pidff->set_envelope[PID_ATTACK_TIME].value[0] = envelope->attack_length;
260 pidff->set_envelope[PID_FADE_TIME].value[0] = envelope->fade_length;
262 hid_dbg(pidff->hid, "attack %u => %d\n",
263 envelope->attack_level,
264 pidff->set_envelope[PID_ATTACK_LEVEL].value[0]);
266 usbhid_submit_report(pidff->hid, pidff->reports[PID_SET_ENVELOPE],
267 USB_DIR_OUT);
271 * Test if the new envelope differs from old one
273 static int pidff_needs_set_envelope(struct ff_envelope *envelope,
274 struct ff_envelope *old)
276 return envelope->attack_level != old->attack_level ||
277 envelope->fade_level != old->fade_level ||
278 envelope->attack_length != old->attack_length ||
279 envelope->fade_length != old->fade_length;
283 * Send constant force report to the device
285 static void pidff_set_constant_force_report(struct pidff_device *pidff,
286 struct ff_effect *effect)
288 pidff->set_constant[PID_EFFECT_BLOCK_INDEX].value[0] =
289 pidff->block_load[PID_EFFECT_BLOCK_INDEX].value[0];
290 pidff_set_signed(&pidff->set_constant[PID_MAGNITUDE],
291 effect->u.constant.level);
293 usbhid_submit_report(pidff->hid, pidff->reports[PID_SET_CONSTANT],
294 USB_DIR_OUT);
298 * Test if the constant parameters have changed between effects
300 static int pidff_needs_set_constant(struct ff_effect *effect,
301 struct ff_effect *old)
303 return effect->u.constant.level != old->u.constant.level;
307 * Send set effect report to the device
309 static void pidff_set_effect_report(struct pidff_device *pidff,
310 struct ff_effect *effect)
312 pidff->set_effect[PID_EFFECT_BLOCK_INDEX].value[0] =
313 pidff->block_load[PID_EFFECT_BLOCK_INDEX].value[0];
314 pidff->set_effect_type->value[0] =
315 pidff->create_new_effect_type->value[0];
316 pidff->set_effect[PID_DURATION].value[0] = effect->replay.length;
317 pidff->set_effect[PID_TRIGGER_BUTTON].value[0] = effect->trigger.button;
318 pidff->set_effect[PID_TRIGGER_REPEAT_INT].value[0] =
319 effect->trigger.interval;
320 pidff->set_effect[PID_GAIN].value[0] =
321 pidff->set_effect[PID_GAIN].field->logical_maximum;
322 pidff->set_effect[PID_DIRECTION_ENABLE].value[0] = 1;
323 pidff->effect_direction->value[0] =
324 pidff_rescale(effect->direction, 0xffff,
325 pidff->effect_direction);
326 pidff->set_effect[PID_START_DELAY].value[0] = effect->replay.delay;
328 usbhid_submit_report(pidff->hid, pidff->reports[PID_SET_EFFECT],
329 USB_DIR_OUT);
333 * Test if the values used in set_effect have changed
335 static int pidff_needs_set_effect(struct ff_effect *effect,
336 struct ff_effect *old)
338 return effect->replay.length != old->replay.length ||
339 effect->trigger.interval != old->trigger.interval ||
340 effect->trigger.button != old->trigger.button ||
341 effect->direction != old->direction ||
342 effect->replay.delay != old->replay.delay;
346 * Send periodic effect report to the device
348 static void pidff_set_periodic_report(struct pidff_device *pidff,
349 struct ff_effect *effect)
351 pidff->set_periodic[PID_EFFECT_BLOCK_INDEX].value[0] =
352 pidff->block_load[PID_EFFECT_BLOCK_INDEX].value[0];
353 pidff_set_signed(&pidff->set_periodic[PID_MAGNITUDE],
354 effect->u.periodic.magnitude);
355 pidff_set_signed(&pidff->set_periodic[PID_OFFSET],
356 effect->u.periodic.offset);
357 pidff_set(&pidff->set_periodic[PID_PHASE], effect->u.periodic.phase);
358 pidff->set_periodic[PID_PERIOD].value[0] = effect->u.periodic.period;
360 usbhid_submit_report(pidff->hid, pidff->reports[PID_SET_PERIODIC],
361 USB_DIR_OUT);
366 * Test if periodic effect parameters have changed
368 static int pidff_needs_set_periodic(struct ff_effect *effect,
369 struct ff_effect *old)
371 return effect->u.periodic.magnitude != old->u.periodic.magnitude ||
372 effect->u.periodic.offset != old->u.periodic.offset ||
373 effect->u.periodic.phase != old->u.periodic.phase ||
374 effect->u.periodic.period != old->u.periodic.period;
378 * Send condition effect reports to the device
380 static void pidff_set_condition_report(struct pidff_device *pidff,
381 struct ff_effect *effect)
383 int i;
385 pidff->set_condition[PID_EFFECT_BLOCK_INDEX].value[0] =
386 pidff->block_load[PID_EFFECT_BLOCK_INDEX].value[0];
388 for (i = 0; i < 2; i++) {
389 pidff->set_condition[PID_PARAM_BLOCK_OFFSET].value[0] = i;
390 pidff_set_signed(&pidff->set_condition[PID_CP_OFFSET],
391 effect->u.condition[i].center);
392 pidff_set_signed(&pidff->set_condition[PID_POS_COEFFICIENT],
393 effect->u.condition[i].right_coeff);
394 pidff_set_signed(&pidff->set_condition[PID_NEG_COEFFICIENT],
395 effect->u.condition[i].left_coeff);
396 pidff_set(&pidff->set_condition[PID_POS_SATURATION],
397 effect->u.condition[i].right_saturation);
398 pidff_set(&pidff->set_condition[PID_NEG_SATURATION],
399 effect->u.condition[i].left_saturation);
400 pidff_set(&pidff->set_condition[PID_DEAD_BAND],
401 effect->u.condition[i].deadband);
402 usbhid_submit_report(pidff->hid, pidff->reports[PID_SET_CONDITION],
403 USB_DIR_OUT);
408 * Test if condition effect parameters have changed
410 static int pidff_needs_set_condition(struct ff_effect *effect,
411 struct ff_effect *old)
413 int i;
414 int ret = 0;
416 for (i = 0; i < 2; i++) {
417 struct ff_condition_effect *cond = &effect->u.condition[i];
418 struct ff_condition_effect *old_cond = &old->u.condition[i];
420 ret |= cond->center != old_cond->center ||
421 cond->right_coeff != old_cond->right_coeff ||
422 cond->left_coeff != old_cond->left_coeff ||
423 cond->right_saturation != old_cond->right_saturation ||
424 cond->left_saturation != old_cond->left_saturation ||
425 cond->deadband != old_cond->deadband;
428 return ret;
432 * Send ramp force report to the device
434 static void pidff_set_ramp_force_report(struct pidff_device *pidff,
435 struct ff_effect *effect)
437 pidff->set_ramp[PID_EFFECT_BLOCK_INDEX].value[0] =
438 pidff->block_load[PID_EFFECT_BLOCK_INDEX].value[0];
439 pidff_set_signed(&pidff->set_ramp[PID_RAMP_START],
440 effect->u.ramp.start_level);
441 pidff_set_signed(&pidff->set_ramp[PID_RAMP_END],
442 effect->u.ramp.end_level);
443 usbhid_submit_report(pidff->hid, pidff->reports[PID_SET_RAMP],
444 USB_DIR_OUT);
448 * Test if ramp force parameters have changed
450 static int pidff_needs_set_ramp(struct ff_effect *effect, struct ff_effect *old)
452 return effect->u.ramp.start_level != old->u.ramp.start_level ||
453 effect->u.ramp.end_level != old->u.ramp.end_level;
457 * Send a request for effect upload to the device
459 * Returns 0 if device reported success, -ENOSPC if the device reported memory
460 * is full. Upon unknown response the function will retry for 60 times, if
461 * still unsuccessful -EIO is returned.
463 static int pidff_request_effect_upload(struct pidff_device *pidff, int efnum)
465 int j;
467 pidff->create_new_effect_type->value[0] = efnum;
468 usbhid_submit_report(pidff->hid, pidff->reports[PID_CREATE_NEW_EFFECT],
469 USB_DIR_OUT);
470 hid_dbg(pidff->hid, "create_new_effect sent, type: %d\n", efnum);
472 pidff->block_load[PID_EFFECT_BLOCK_INDEX].value[0] = 0;
473 pidff->block_load_status->value[0] = 0;
474 usbhid_wait_io(pidff->hid);
476 for (j = 0; j < 60; j++) {
477 hid_dbg(pidff->hid, "pid_block_load requested\n");
478 usbhid_submit_report(pidff->hid, pidff->reports[PID_BLOCK_LOAD],
479 USB_DIR_IN);
480 usbhid_wait_io(pidff->hid);
481 if (pidff->block_load_status->value[0] ==
482 pidff->status_id[PID_BLOCK_LOAD_SUCCESS]) {
483 hid_dbg(pidff->hid, "device reported free memory: %d bytes\n",
484 pidff->block_load[PID_RAM_POOL_AVAILABLE].value ?
485 pidff->block_load[PID_RAM_POOL_AVAILABLE].value[0] : -1);
486 return 0;
488 if (pidff->block_load_status->value[0] ==
489 pidff->status_id[PID_BLOCK_LOAD_FULL]) {
490 hid_dbg(pidff->hid, "not enough memory free: %d bytes\n",
491 pidff->block_load[PID_RAM_POOL_AVAILABLE].value ?
492 pidff->block_load[PID_RAM_POOL_AVAILABLE].value[0] : -1);
493 return -ENOSPC;
496 hid_err(pidff->hid, "pid_block_load failed 60 times\n");
497 return -EIO;
501 * Play the effect with PID id n times
503 static void pidff_playback_pid(struct pidff_device *pidff, int pid_id, int n)
505 pidff->effect_operation[PID_EFFECT_BLOCK_INDEX].value[0] = pid_id;
507 if (n == 0) {
508 pidff->effect_operation_status->value[0] =
509 pidff->operation_id[PID_EFFECT_STOP];
510 } else {
511 pidff->effect_operation_status->value[0] =
512 pidff->operation_id[PID_EFFECT_START];
513 pidff->effect_operation[PID_LOOP_COUNT].value[0] = n;
516 usbhid_submit_report(pidff->hid, pidff->reports[PID_EFFECT_OPERATION],
517 USB_DIR_OUT);
521 * Play the effect with effect id @effect_id for @value times
523 static int pidff_playback(struct input_dev *dev, int effect_id, int value)
525 struct pidff_device *pidff = dev->ff->private;
527 pidff_playback_pid(pidff, pidff->pid_id[effect_id], value);
529 return 0;
533 * Erase effect with PID id
535 static void pidff_erase_pid(struct pidff_device *pidff, int pid_id)
537 pidff->block_free[PID_EFFECT_BLOCK_INDEX].value[0] = pid_id;
538 usbhid_submit_report(pidff->hid, pidff->reports[PID_BLOCK_FREE],
539 USB_DIR_OUT);
543 * Stop and erase effect with effect_id
545 static int pidff_erase_effect(struct input_dev *dev, int effect_id)
547 struct pidff_device *pidff = dev->ff->private;
548 int pid_id = pidff->pid_id[effect_id];
550 hid_dbg(pidff->hid, "starting to erase %d/%d\n",
551 effect_id, pidff->pid_id[effect_id]);
552 /* Wait for the queue to clear. We do not want a full fifo to
553 prevent the effect removal. */
554 usbhid_wait_io(pidff->hid);
555 pidff_playback_pid(pidff, pid_id, 0);
556 pidff_erase_pid(pidff, pid_id);
558 return 0;
562 * Effect upload handler
564 static int pidff_upload_effect(struct input_dev *dev, struct ff_effect *effect,
565 struct ff_effect *old)
567 struct pidff_device *pidff = dev->ff->private;
568 int type_id;
569 int error;
571 switch (effect->type) {
572 case FF_CONSTANT:
573 if (!old) {
574 error = pidff_request_effect_upload(pidff,
575 pidff->type_id[PID_CONSTANT]);
576 if (error)
577 return error;
579 if (!old || pidff_needs_set_effect(effect, old))
580 pidff_set_effect_report(pidff, effect);
581 if (!old || pidff_needs_set_constant(effect, old))
582 pidff_set_constant_force_report(pidff, effect);
583 if (!old ||
584 pidff_needs_set_envelope(&effect->u.constant.envelope,
585 &old->u.constant.envelope))
586 pidff_set_envelope_report(pidff,
587 &effect->u.constant.envelope);
588 break;
590 case FF_PERIODIC:
591 if (!old) {
592 switch (effect->u.periodic.waveform) {
593 case FF_SQUARE:
594 type_id = PID_SQUARE;
595 break;
596 case FF_TRIANGLE:
597 type_id = PID_TRIANGLE;
598 break;
599 case FF_SINE:
600 type_id = PID_SINE;
601 break;
602 case FF_SAW_UP:
603 type_id = PID_SAW_UP;
604 break;
605 case FF_SAW_DOWN:
606 type_id = PID_SAW_DOWN;
607 break;
608 default:
609 hid_err(pidff->hid, "invalid waveform\n");
610 return -EINVAL;
613 error = pidff_request_effect_upload(pidff,
614 pidff->type_id[type_id]);
615 if (error)
616 return error;
618 if (!old || pidff_needs_set_effect(effect, old))
619 pidff_set_effect_report(pidff, effect);
620 if (!old || pidff_needs_set_periodic(effect, old))
621 pidff_set_periodic_report(pidff, effect);
622 if (!old ||
623 pidff_needs_set_envelope(&effect->u.periodic.envelope,
624 &old->u.periodic.envelope))
625 pidff_set_envelope_report(pidff,
626 &effect->u.periodic.envelope);
627 break;
629 case FF_RAMP:
630 if (!old) {
631 error = pidff_request_effect_upload(pidff,
632 pidff->type_id[PID_RAMP]);
633 if (error)
634 return error;
636 if (!old || pidff_needs_set_effect(effect, old))
637 pidff_set_effect_report(pidff, effect);
638 if (!old || pidff_needs_set_ramp(effect, old))
639 pidff_set_ramp_force_report(pidff, effect);
640 if (!old ||
641 pidff_needs_set_envelope(&effect->u.ramp.envelope,
642 &old->u.ramp.envelope))
643 pidff_set_envelope_report(pidff,
644 &effect->u.ramp.envelope);
645 break;
647 case FF_SPRING:
648 if (!old) {
649 error = pidff_request_effect_upload(pidff,
650 pidff->type_id[PID_SPRING]);
651 if (error)
652 return error;
654 if (!old || pidff_needs_set_effect(effect, old))
655 pidff_set_effect_report(pidff, effect);
656 if (!old || pidff_needs_set_condition(effect, old))
657 pidff_set_condition_report(pidff, effect);
658 break;
660 case FF_FRICTION:
661 if (!old) {
662 error = pidff_request_effect_upload(pidff,
663 pidff->type_id[PID_FRICTION]);
664 if (error)
665 return error;
667 if (!old || pidff_needs_set_effect(effect, old))
668 pidff_set_effect_report(pidff, effect);
669 if (!old || pidff_needs_set_condition(effect, old))
670 pidff_set_condition_report(pidff, effect);
671 break;
673 case FF_DAMPER:
674 if (!old) {
675 error = pidff_request_effect_upload(pidff,
676 pidff->type_id[PID_DAMPER]);
677 if (error)
678 return error;
680 if (!old || pidff_needs_set_effect(effect, old))
681 pidff_set_effect_report(pidff, effect);
682 if (!old || pidff_needs_set_condition(effect, old))
683 pidff_set_condition_report(pidff, effect);
684 break;
686 case FF_INERTIA:
687 if (!old) {
688 error = pidff_request_effect_upload(pidff,
689 pidff->type_id[PID_INERTIA]);
690 if (error)
691 return error;
693 if (!old || pidff_needs_set_effect(effect, old))
694 pidff_set_effect_report(pidff, effect);
695 if (!old || pidff_needs_set_condition(effect, old))
696 pidff_set_condition_report(pidff, effect);
697 break;
699 default:
700 hid_err(pidff->hid, "invalid type\n");
701 return -EINVAL;
704 if (!old)
705 pidff->pid_id[effect->id] =
706 pidff->block_load[PID_EFFECT_BLOCK_INDEX].value[0];
708 hid_dbg(pidff->hid, "uploaded\n");
710 return 0;
714 * set_gain() handler
716 static void pidff_set_gain(struct input_dev *dev, u16 gain)
718 struct pidff_device *pidff = dev->ff->private;
720 pidff_set(&pidff->device_gain[PID_DEVICE_GAIN_FIELD], gain);
721 usbhid_submit_report(pidff->hid, pidff->reports[PID_DEVICE_GAIN],
722 USB_DIR_OUT);
725 static void pidff_autocenter(struct pidff_device *pidff, u16 magnitude)
727 struct hid_field *field =
728 pidff->block_load[PID_EFFECT_BLOCK_INDEX].field;
730 if (!magnitude) {
731 pidff_playback_pid(pidff, field->logical_minimum, 0);
732 return;
735 pidff_playback_pid(pidff, field->logical_minimum, 1);
737 pidff->set_effect[PID_EFFECT_BLOCK_INDEX].value[0] =
738 pidff->block_load[PID_EFFECT_BLOCK_INDEX].field->logical_minimum;
739 pidff->set_effect_type->value[0] = pidff->type_id[PID_SPRING];
740 pidff->set_effect[PID_DURATION].value[0] = 0;
741 pidff->set_effect[PID_TRIGGER_BUTTON].value[0] = 0;
742 pidff->set_effect[PID_TRIGGER_REPEAT_INT].value[0] = 0;
743 pidff_set(&pidff->set_effect[PID_GAIN], magnitude);
744 pidff->set_effect[PID_DIRECTION_ENABLE].value[0] = 1;
745 pidff->set_effect[PID_START_DELAY].value[0] = 0;
747 usbhid_submit_report(pidff->hid, pidff->reports[PID_SET_EFFECT],
748 USB_DIR_OUT);
752 * pidff_set_autocenter() handler
754 static void pidff_set_autocenter(struct input_dev *dev, u16 magnitude)
756 struct pidff_device *pidff = dev->ff->private;
758 pidff_autocenter(pidff, magnitude);
762 * Find fields from a report and fill a pidff_usage
764 static int pidff_find_fields(struct pidff_usage *usage, const u8 *table,
765 struct hid_report *report, int count, int strict)
767 int i, j, k, found;
769 for (k = 0; k < count; k++) {
770 found = 0;
771 for (i = 0; i < report->maxfield; i++) {
772 if (report->field[i]->maxusage !=
773 report->field[i]->report_count) {
774 pr_debug("maxusage and report_count do not match, skipping\n");
775 continue;
777 for (j = 0; j < report->field[i]->maxusage; j++) {
778 if (report->field[i]->usage[j].hid ==
779 (HID_UP_PID | table[k])) {
780 pr_debug("found %d at %d->%d\n",
781 k, i, j);
782 usage[k].field = report->field[i];
783 usage[k].value =
784 &report->field[i]->value[j];
785 found = 1;
786 break;
789 if (found)
790 break;
792 if (!found && strict) {
793 pr_debug("failed to locate %d\n", k);
794 return -1;
797 return 0;
801 * Return index into pidff_reports for the given usage
803 static int pidff_check_usage(int usage)
805 int i;
807 for (i = 0; i < sizeof(pidff_reports); i++)
808 if (usage == (HID_UP_PID | pidff_reports[i]))
809 return i;
811 return -1;
815 * Find the reports and fill pidff->reports[]
816 * report_type specifies either OUTPUT or FEATURE reports
818 static void pidff_find_reports(struct hid_device *hid, int report_type,
819 struct pidff_device *pidff)
821 struct hid_report *report;
822 int i, ret;
824 list_for_each_entry(report,
825 &hid->report_enum[report_type].report_list, list) {
826 if (report->maxfield < 1)
827 continue;
828 ret = pidff_check_usage(report->field[0]->logical);
829 if (ret != -1) {
830 hid_dbg(hid, "found usage 0x%02x from field->logical\n",
831 pidff_reports[ret]);
832 pidff->reports[ret] = report;
833 continue;
837 * Sometimes logical collections are stacked to indicate
838 * different usages for the report and the field, in which
839 * case we want the usage of the parent. However, Linux HID
840 * implementation hides this fact, so we have to dig it up
841 * ourselves
843 i = report->field[0]->usage[0].collection_index;
844 if (i <= 0 ||
845 hid->collection[i - 1].type != HID_COLLECTION_LOGICAL)
846 continue;
847 ret = pidff_check_usage(hid->collection[i - 1].usage);
848 if (ret != -1 && !pidff->reports[ret]) {
849 hid_dbg(hid,
850 "found usage 0x%02x from collection array\n",
851 pidff_reports[ret]);
852 pidff->reports[ret] = report;
858 * Test if the required reports have been found
860 static int pidff_reports_ok(struct pidff_device *pidff)
862 int i;
864 for (i = 0; i <= PID_REQUIRED_REPORTS; i++) {
865 if (!pidff->reports[i]) {
866 hid_dbg(pidff->hid, "%d missing\n", i);
867 return 0;
871 return 1;
875 * Find a field with a specific usage within a report
877 static struct hid_field *pidff_find_special_field(struct hid_report *report,
878 int usage, int enforce_min)
880 int i;
882 for (i = 0; i < report->maxfield; i++) {
883 if (report->field[i]->logical == (HID_UP_PID | usage) &&
884 report->field[i]->report_count > 0) {
885 if (!enforce_min ||
886 report->field[i]->logical_minimum == 1)
887 return report->field[i];
888 else {
889 pr_err("logical_minimum is not 1 as it should be\n");
890 return NULL;
894 return NULL;
898 * Fill a pidff->*_id struct table
900 static int pidff_find_special_keys(int *keys, struct hid_field *fld,
901 const u8 *usagetable, int count)
904 int i, j;
905 int found = 0;
907 for (i = 0; i < count; i++) {
908 for (j = 0; j < fld->maxusage; j++) {
909 if (fld->usage[j].hid == (HID_UP_PID | usagetable[i])) {
910 keys[i] = j + 1;
911 found++;
912 break;
916 return found;
919 #define PIDFF_FIND_SPECIAL_KEYS(keys, field, name) \
920 pidff_find_special_keys(pidff->keys, pidff->field, pidff_ ## name, \
921 sizeof(pidff_ ## name))
924 * Find and check the special fields
926 static int pidff_find_special_fields(struct pidff_device *pidff)
928 hid_dbg(pidff->hid, "finding special fields\n");
930 pidff->create_new_effect_type =
931 pidff_find_special_field(pidff->reports[PID_CREATE_NEW_EFFECT],
932 0x25, 1);
933 pidff->set_effect_type =
934 pidff_find_special_field(pidff->reports[PID_SET_EFFECT],
935 0x25, 1);
936 pidff->effect_direction =
937 pidff_find_special_field(pidff->reports[PID_SET_EFFECT],
938 0x57, 0);
939 pidff->device_control =
940 pidff_find_special_field(pidff->reports[PID_DEVICE_CONTROL],
941 0x96, 1);
942 pidff->block_load_status =
943 pidff_find_special_field(pidff->reports[PID_BLOCK_LOAD],
944 0x8b, 1);
945 pidff->effect_operation_status =
946 pidff_find_special_field(pidff->reports[PID_EFFECT_OPERATION],
947 0x78, 1);
949 hid_dbg(pidff->hid, "search done\n");
951 if (!pidff->create_new_effect_type || !pidff->set_effect_type) {
952 hid_err(pidff->hid, "effect lists not found\n");
953 return -1;
956 if (!pidff->effect_direction) {
957 hid_err(pidff->hid, "direction field not found\n");
958 return -1;
961 if (!pidff->device_control) {
962 hid_err(pidff->hid, "device control field not found\n");
963 return -1;
966 if (!pidff->block_load_status) {
967 hid_err(pidff->hid, "block load status field not found\n");
968 return -1;
971 if (!pidff->effect_operation_status) {
972 hid_err(pidff->hid, "effect operation field not found\n");
973 return -1;
976 pidff_find_special_keys(pidff->control_id, pidff->device_control,
977 pidff_device_control,
978 sizeof(pidff_device_control));
980 PIDFF_FIND_SPECIAL_KEYS(control_id, device_control, device_control);
982 if (!PIDFF_FIND_SPECIAL_KEYS(type_id, create_new_effect_type,
983 effect_types)) {
984 hid_err(pidff->hid, "no effect types found\n");
985 return -1;
988 if (PIDFF_FIND_SPECIAL_KEYS(status_id, block_load_status,
989 block_load_status) !=
990 sizeof(pidff_block_load_status)) {
991 hid_err(pidff->hid,
992 "block load status identifiers not found\n");
993 return -1;
996 if (PIDFF_FIND_SPECIAL_KEYS(operation_id, effect_operation_status,
997 effect_operation_status) !=
998 sizeof(pidff_effect_operation_status)) {
999 hid_err(pidff->hid, "effect operation identifiers not found\n");
1000 return -1;
1003 return 0;
1007 * Find the implemented effect types
1009 static int pidff_find_effects(struct pidff_device *pidff,
1010 struct input_dev *dev)
1012 int i;
1014 for (i = 0; i < sizeof(pidff_effect_types); i++) {
1015 int pidff_type = pidff->type_id[i];
1016 if (pidff->set_effect_type->usage[pidff_type].hid !=
1017 pidff->create_new_effect_type->usage[pidff_type].hid) {
1018 hid_err(pidff->hid,
1019 "effect type number %d is invalid\n", i);
1020 return -1;
1024 if (pidff->type_id[PID_CONSTANT])
1025 set_bit(FF_CONSTANT, dev->ffbit);
1026 if (pidff->type_id[PID_RAMP])
1027 set_bit(FF_RAMP, dev->ffbit);
1028 if (pidff->type_id[PID_SQUARE]) {
1029 set_bit(FF_SQUARE, dev->ffbit);
1030 set_bit(FF_PERIODIC, dev->ffbit);
1032 if (pidff->type_id[PID_SINE]) {
1033 set_bit(FF_SINE, dev->ffbit);
1034 set_bit(FF_PERIODIC, dev->ffbit);
1036 if (pidff->type_id[PID_TRIANGLE]) {
1037 set_bit(FF_TRIANGLE, dev->ffbit);
1038 set_bit(FF_PERIODIC, dev->ffbit);
1040 if (pidff->type_id[PID_SAW_UP]) {
1041 set_bit(FF_SAW_UP, dev->ffbit);
1042 set_bit(FF_PERIODIC, dev->ffbit);
1044 if (pidff->type_id[PID_SAW_DOWN]) {
1045 set_bit(FF_SAW_DOWN, dev->ffbit);
1046 set_bit(FF_PERIODIC, dev->ffbit);
1048 if (pidff->type_id[PID_SPRING])
1049 set_bit(FF_SPRING, dev->ffbit);
1050 if (pidff->type_id[PID_DAMPER])
1051 set_bit(FF_DAMPER, dev->ffbit);
1052 if (pidff->type_id[PID_INERTIA])
1053 set_bit(FF_INERTIA, dev->ffbit);
1054 if (pidff->type_id[PID_FRICTION])
1055 set_bit(FF_FRICTION, dev->ffbit);
1057 return 0;
1061 #define PIDFF_FIND_FIELDS(name, report, strict) \
1062 pidff_find_fields(pidff->name, pidff_ ## name, \
1063 pidff->reports[report], \
1064 sizeof(pidff_ ## name), strict)
1067 * Fill and check the pidff_usages
1069 static int pidff_init_fields(struct pidff_device *pidff, struct input_dev *dev)
1071 int envelope_ok = 0;
1073 if (PIDFF_FIND_FIELDS(set_effect, PID_SET_EFFECT, 1)) {
1074 hid_err(pidff->hid, "unknown set_effect report layout\n");
1075 return -ENODEV;
1078 PIDFF_FIND_FIELDS(block_load, PID_BLOCK_LOAD, 0);
1079 if (!pidff->block_load[PID_EFFECT_BLOCK_INDEX].value) {
1080 hid_err(pidff->hid, "unknown pid_block_load report layout\n");
1081 return -ENODEV;
1084 if (PIDFF_FIND_FIELDS(effect_operation, PID_EFFECT_OPERATION, 1)) {
1085 hid_err(pidff->hid, "unknown effect_operation report layout\n");
1086 return -ENODEV;
1089 if (PIDFF_FIND_FIELDS(block_free, PID_BLOCK_FREE, 1)) {
1090 hid_err(pidff->hid, "unknown pid_block_free report layout\n");
1091 return -ENODEV;
1094 if (!PIDFF_FIND_FIELDS(set_envelope, PID_SET_ENVELOPE, 1))
1095 envelope_ok = 1;
1097 if (pidff_find_special_fields(pidff) || pidff_find_effects(pidff, dev))
1098 return -ENODEV;
1100 if (!envelope_ok) {
1101 if (test_and_clear_bit(FF_CONSTANT, dev->ffbit))
1102 hid_warn(pidff->hid,
1103 "has constant effect but no envelope\n");
1104 if (test_and_clear_bit(FF_RAMP, dev->ffbit))
1105 hid_warn(pidff->hid,
1106 "has ramp effect but no envelope\n");
1108 if (test_and_clear_bit(FF_PERIODIC, dev->ffbit))
1109 hid_warn(pidff->hid,
1110 "has periodic effect but no envelope\n");
1113 if (test_bit(FF_CONSTANT, dev->ffbit) &&
1114 PIDFF_FIND_FIELDS(set_constant, PID_SET_CONSTANT, 1)) {
1115 hid_warn(pidff->hid, "unknown constant effect layout\n");
1116 clear_bit(FF_CONSTANT, dev->ffbit);
1119 if (test_bit(FF_RAMP, dev->ffbit) &&
1120 PIDFF_FIND_FIELDS(set_ramp, PID_SET_RAMP, 1)) {
1121 hid_warn(pidff->hid, "unknown ramp effect layout\n");
1122 clear_bit(FF_RAMP, dev->ffbit);
1125 if ((test_bit(FF_SPRING, dev->ffbit) ||
1126 test_bit(FF_DAMPER, dev->ffbit) ||
1127 test_bit(FF_FRICTION, dev->ffbit) ||
1128 test_bit(FF_INERTIA, dev->ffbit)) &&
1129 PIDFF_FIND_FIELDS(set_condition, PID_SET_CONDITION, 1)) {
1130 hid_warn(pidff->hid, "unknown condition effect layout\n");
1131 clear_bit(FF_SPRING, dev->ffbit);
1132 clear_bit(FF_DAMPER, dev->ffbit);
1133 clear_bit(FF_FRICTION, dev->ffbit);
1134 clear_bit(FF_INERTIA, dev->ffbit);
1137 if (test_bit(FF_PERIODIC, dev->ffbit) &&
1138 PIDFF_FIND_FIELDS(set_periodic, PID_SET_PERIODIC, 1)) {
1139 hid_warn(pidff->hid, "unknown periodic effect layout\n");
1140 clear_bit(FF_PERIODIC, dev->ffbit);
1143 PIDFF_FIND_FIELDS(pool, PID_POOL, 0);
1145 if (!PIDFF_FIND_FIELDS(device_gain, PID_DEVICE_GAIN, 1))
1146 set_bit(FF_GAIN, dev->ffbit);
1148 return 0;
1152 * Reset the device
1154 static void pidff_reset(struct pidff_device *pidff)
1156 struct hid_device *hid = pidff->hid;
1157 int i = 0;
1159 pidff->device_control->value[0] = pidff->control_id[PID_RESET];
1160 /* We reset twice as sometimes hid_wait_io isn't waiting long enough */
1161 usbhid_submit_report(hid, pidff->reports[PID_DEVICE_CONTROL], USB_DIR_OUT);
1162 usbhid_wait_io(hid);
1163 usbhid_submit_report(hid, pidff->reports[PID_DEVICE_CONTROL], USB_DIR_OUT);
1164 usbhid_wait_io(hid);
1166 pidff->device_control->value[0] =
1167 pidff->control_id[PID_ENABLE_ACTUATORS];
1168 usbhid_submit_report(hid, pidff->reports[PID_DEVICE_CONTROL], USB_DIR_OUT);
1169 usbhid_wait_io(hid);
1171 /* pool report is sometimes messed up, refetch it */
1172 usbhid_submit_report(hid, pidff->reports[PID_POOL], USB_DIR_IN);
1173 usbhid_wait_io(hid);
1175 if (pidff->pool[PID_SIMULTANEOUS_MAX].value) {
1176 while (pidff->pool[PID_SIMULTANEOUS_MAX].value[0] < 2) {
1177 if (i++ > 20) {
1178 hid_warn(pidff->hid,
1179 "device reports %d simultaneous effects\n",
1180 pidff->pool[PID_SIMULTANEOUS_MAX].value[0]);
1181 break;
1183 hid_dbg(pidff->hid, "pid_pool requested again\n");
1184 usbhid_submit_report(hid, pidff->reports[PID_POOL],
1185 USB_DIR_IN);
1186 usbhid_wait_io(hid);
1192 * Test if autocenter modification is using the supported method
1194 static int pidff_check_autocenter(struct pidff_device *pidff,
1195 struct input_dev *dev)
1197 int error;
1200 * Let's find out if autocenter modification is supported
1201 * Specification doesn't specify anything, so we request an
1202 * effect upload and cancel it immediately. If the approved
1203 * effect id was one above the minimum, then we assume the first
1204 * effect id is a built-in spring type effect used for autocenter
1207 error = pidff_request_effect_upload(pidff, 1);
1208 if (error) {
1209 hid_err(pidff->hid, "upload request failed\n");
1210 return error;
1213 if (pidff->block_load[PID_EFFECT_BLOCK_INDEX].value[0] ==
1214 pidff->block_load[PID_EFFECT_BLOCK_INDEX].field->logical_minimum + 1) {
1215 pidff_autocenter(pidff, 0xffff);
1216 set_bit(FF_AUTOCENTER, dev->ffbit);
1217 } else {
1218 hid_notice(pidff->hid,
1219 "device has unknown autocenter control method\n");
1222 pidff_erase_pid(pidff,
1223 pidff->block_load[PID_EFFECT_BLOCK_INDEX].value[0]);
1225 return 0;
1230 * Check if the device is PID and initialize it
1232 int hid_pidff_init(struct hid_device *hid)
1234 struct pidff_device *pidff;
1235 struct hid_input *hidinput = list_entry(hid->inputs.next,
1236 struct hid_input, list);
1237 struct input_dev *dev = hidinput->input;
1238 struct ff_device *ff;
1239 int max_effects;
1240 int error;
1242 hid_dbg(hid, "starting pid init\n");
1244 if (list_empty(&hid->report_enum[HID_OUTPUT_REPORT].report_list)) {
1245 hid_dbg(hid, "not a PID device, no output report\n");
1246 return -ENODEV;
1249 pidff = kzalloc(sizeof(*pidff), GFP_KERNEL);
1250 if (!pidff)
1251 return -ENOMEM;
1253 pidff->hid = hid;
1255 pidff_find_reports(hid, HID_OUTPUT_REPORT, pidff);
1256 pidff_find_reports(hid, HID_FEATURE_REPORT, pidff);
1258 if (!pidff_reports_ok(pidff)) {
1259 hid_dbg(hid, "reports not ok, aborting\n");
1260 error = -ENODEV;
1261 goto fail;
1264 error = pidff_init_fields(pidff, dev);
1265 if (error)
1266 goto fail;
1268 pidff_reset(pidff);
1270 if (test_bit(FF_GAIN, dev->ffbit)) {
1271 pidff_set(&pidff->device_gain[PID_DEVICE_GAIN_FIELD], 0xffff);
1272 usbhid_submit_report(hid, pidff->reports[PID_DEVICE_GAIN],
1273 USB_DIR_OUT);
1276 error = pidff_check_autocenter(pidff, dev);
1277 if (error)
1278 goto fail;
1280 max_effects =
1281 pidff->block_load[PID_EFFECT_BLOCK_INDEX].field->logical_maximum -
1282 pidff->block_load[PID_EFFECT_BLOCK_INDEX].field->logical_minimum +
1284 hid_dbg(hid, "max effects is %d\n", max_effects);
1286 if (max_effects > PID_EFFECTS_MAX)
1287 max_effects = PID_EFFECTS_MAX;
1289 if (pidff->pool[PID_SIMULTANEOUS_MAX].value)
1290 hid_dbg(hid, "max simultaneous effects is %d\n",
1291 pidff->pool[PID_SIMULTANEOUS_MAX].value[0]);
1293 if (pidff->pool[PID_RAM_POOL_SIZE].value)
1294 hid_dbg(hid, "device memory size is %d bytes\n",
1295 pidff->pool[PID_RAM_POOL_SIZE].value[0]);
1297 if (pidff->pool[PID_DEVICE_MANAGED_POOL].value &&
1298 pidff->pool[PID_DEVICE_MANAGED_POOL].value[0] == 0) {
1299 hid_notice(hid,
1300 "device does not support device managed pool\n");
1301 goto fail;
1304 error = input_ff_create(dev, max_effects);
1305 if (error)
1306 goto fail;
1308 ff = dev->ff;
1309 ff->private = pidff;
1310 ff->upload = pidff_upload_effect;
1311 ff->erase = pidff_erase_effect;
1312 ff->set_gain = pidff_set_gain;
1313 ff->set_autocenter = pidff_set_autocenter;
1314 ff->playback = pidff_playback;
1316 hid_info(dev, "Force feedback for USB HID PID devices by Anssi Hannula <anssi.hannula@gmail.com>\n");
1318 return 0;
1320 fail:
1321 kfree(pidff);
1322 return error;