[PATCH] fix fatal kernel-doc error
[linux-drm-fsl-dcu.git] / drivers / usb / input / hid-lgff.c
1 /*
2  * Force feedback support for hid-compliant for some of the devices from
3  * Logitech, namely:
4  * - WingMan Cordless RumblePad
5  * - WingMan Force 3D
6  *
7  *  Copyright (c) 2002-2004 Johann Deneux
8  *  Copyright (c) 2006 Anssi Hannula <anssi.hannula@gmail.com>
9  */
10
11 /*
12  * This program is free software; you can redistribute it and/or modify
13  * it under the terms of the GNU General Public License as published by
14  * the Free Software Foundation; either version 2 of the License, or
15  * (at your option) any later version.
16  *
17  * This program is distributed in the hope that it will be useful,
18  * but WITHOUT ANY WARRANTY; without even the implied warranty of
19  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
20  * GNU General Public License for more details.
21  *
22  * You should have received a copy of the GNU General Public License
23  * along with this program; if not, write to the Free Software
24  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
25  *
26  * Should you need to contact me, the author, you can do so by
27  * e-mail - mail your message to <johann.deneux@it.uu.se>
28  */
29
30 #include <linux/input.h>
31 #include <linux/usb.h>
32 #include <linux/hid.h>
33 #include "usbhid.h"
34
35 struct dev_type {
36         u16 idVendor;
37         u16 idProduct;
38         const signed short *ff;
39 };
40
41 static const signed short ff_rumble[] = {
42         FF_RUMBLE,
43         -1
44 };
45
46 static const signed short ff_joystick[] = {
47         FF_CONSTANT,
48         -1
49 };
50
51 static const struct dev_type devices[] = {
52         { 0x046d, 0xc211, ff_rumble },
53         { 0x046d, 0xc219, ff_rumble },
54         { 0x046d, 0xc283, ff_joystick },
55         { 0x0000, 0x0000, ff_joystick }
56 };
57
58 static int hid_lgff_play(struct input_dev *dev, void *data, struct ff_effect *effect)
59 {
60         struct hid_device *hid = dev->private;
61         struct list_head *report_list = &hid->report_enum[HID_OUTPUT_REPORT].report_list;
62         struct hid_report *report = list_entry(report_list->next, struct hid_report, list);
63         int x, y;
64         unsigned int left, right;
65
66 #define CLAMP(x) if (x < 0) x = 0; if (x > 0xff) x = 0xff
67
68         switch (effect->type) {
69         case FF_CONSTANT:
70                 x = effect->u.ramp.start_level + 0x7f;  /* 0x7f is center */
71                 y = effect->u.ramp.end_level + 0x7f;
72                 CLAMP(x);
73                 CLAMP(y);
74                 report->field[0]->value[0] = 0x51;
75                 report->field[0]->value[1] = 0x08;
76                 report->field[0]->value[2] = x;
77                 report->field[0]->value[3] = y;
78                 dbg("(x, y)=(%04x, %04x)", x, y);
79                 usbhid_submit_report(hid, report, USB_DIR_OUT);
80                 break;
81
82         case FF_RUMBLE:
83                 right = effect->u.rumble.strong_magnitude;
84                 left = effect->u.rumble.weak_magnitude;
85                 right = right * 0xff / 0xffff;
86                 left = left * 0xff / 0xffff;
87                 CLAMP(left);
88                 CLAMP(right);
89                 report->field[0]->value[0] = 0x42;
90                 report->field[0]->value[1] = 0x00;
91                 report->field[0]->value[2] = left;
92                 report->field[0]->value[3] = right;
93                 dbg("(left, right)=(%04x, %04x)", left, right);
94                 usbhid_submit_report(hid, report, USB_DIR_OUT);
95                 break;
96         }
97         return 0;
98 }
99
100 int hid_lgff_init(struct hid_device* hid)
101 {
102         struct hid_input *hidinput = list_entry(hid->inputs.next, struct hid_input, list);
103         struct list_head *report_list = &hid->report_enum[HID_OUTPUT_REPORT].report_list;
104         struct input_dev *dev = hidinput->input;
105         struct hid_report *report;
106         struct hid_field *field;
107         int error;
108         int i, j;
109
110         /* Find the report to use */
111         if (list_empty(report_list)) {
112                 err("No output report found");
113                 return -1;
114         }
115
116         /* Check that the report looks ok */
117         report = list_entry(report_list->next, struct hid_report, list);
118         if (!report) {
119                 err("NULL output report");
120                 return -1;
121         }
122
123         field = report->field[0];
124         if (!field) {
125                 err("NULL field");
126                 return -1;
127         }
128
129         for (i = 0; i < ARRAY_SIZE(devices); i++) {
130                 if (dev->id.vendor == devices[i].idVendor &&
131                     dev->id.product == devices[i].idProduct) {
132                         for (j = 0; devices[i].ff[j] >= 0; j++)
133                                 set_bit(devices[i].ff[j], dev->ffbit);
134                         break;
135                 }
136         }
137
138         error = input_ff_create_memless(dev, NULL, hid_lgff_play);
139         if (error)
140                 return error;
141
142         printk(KERN_INFO "Force feedback for Logitech force feedback devices by Johann Deneux <johann.deneux@it.uu.se>\n");
143
144         return 0;
145 }