1 /*
2  * Force feedback support for DragonRise Inc. game controllers
3  *
4  * From what I have gathered, these devices are mass produced in China and are
5  * distributed under several vendors. They often share the same design as
6  * the original PlayStation DualShock controller.
7  *
8  * 0079:0006 "DragonRise Inc.   Generic   USB  Joystick  "
9  *  - tested with a Tesun USB-703 game controller.
10  *
11  * Copyright (c) 2009 Richard Walmsley <richwalm@gmail.com>
12  */
13 
14 /*
15  * This program is free software; you can redistribute it and/or modify
16  * it under the terms of the GNU General Public License as published by
17  * the Free Software Foundation; either version 2 of the License, or
18  * (at your option) any later version.
19  *
20  * This program is distributed in the hope that it will be useful,
21  * but WITHOUT ANY WARRANTY; without even the implied warranty of
22  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
23  * GNU General Public License for more details.
24  *
25  * You should have received a copy of the GNU General Public License
26  * along with this program; if not, write to the Free Software
27  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
28  */
29 
30 #include <linux/input.h>
31 #include <linux/slab.h>
32 #include <linux/usb.h>
33 #include <linux/hid.h>
34 
35 #include "hid-ids.h"
36 
37 #ifdef CONFIG_DRAGONRISE_FF
38 #include "usbhid/usbhid.h"
39 
40 struct drff_device {
41 	struct hid_report *report;
42 };
43 
drff_play(struct input_dev * dev,void * data,struct ff_effect * effect)44 static int drff_play(struct input_dev *dev, void *data,
45 				 struct ff_effect *effect)
46 {
47 	struct hid_device *hid = input_get_drvdata(dev);
48 	struct drff_device *drff = data;
49 	int strong, weak;
50 
51 	strong = effect->u.rumble.strong_magnitude;
52 	weak = effect->u.rumble.weak_magnitude;
53 
54 	dbg_hid("called with 0x%04x 0x%04x", strong, weak);
55 
56 	if (strong || weak) {
57 		strong = strong * 0xff / 0xffff;
58 		weak = weak * 0xff / 0xffff;
59 
60 		/* While reverse engineering this device, I found that when
61 		   this value is set, it causes the strong rumble to function
62 		   at a near maximum speed, so we'll bypass it. */
63 		if (weak == 0x0a)
64 			weak = 0x0b;
65 
66 		drff->report->field[0]->value[0] = 0x51;
67 		drff->report->field[0]->value[1] = 0x00;
68 		drff->report->field[0]->value[2] = weak;
69 		drff->report->field[0]->value[4] = strong;
70 		usbhid_submit_report(hid, drff->report, USB_DIR_OUT);
71 
72 		drff->report->field[0]->value[0] = 0xfa;
73 		drff->report->field[0]->value[1] = 0xfe;
74 	} else {
75 		drff->report->field[0]->value[0] = 0xf3;
76 		drff->report->field[0]->value[1] = 0x00;
77 	}
78 
79 	drff->report->field[0]->value[2] = 0x00;
80 	drff->report->field[0]->value[4] = 0x00;
81 	dbg_hid("running with 0x%02x 0x%02x", strong, weak);
82 	usbhid_submit_report(hid, drff->report, USB_DIR_OUT);
83 
84 	return 0;
85 }
86 
drff_init(struct hid_device * hid)87 static int drff_init(struct hid_device *hid)
88 {
89 	struct drff_device *drff;
90 	struct hid_report *report;
91 	struct hid_input *hidinput = list_first_entry(&hid->inputs,
92 						struct hid_input, list);
93 	struct list_head *report_list =
94 			&hid->report_enum[HID_OUTPUT_REPORT].report_list;
95 	struct input_dev *dev = hidinput->input;
96 	int error;
97 
98 	if (list_empty(report_list)) {
99 		hid_err(hid, "no output reports found\n");
100 		return -ENODEV;
101 	}
102 
103 	report = list_first_entry(report_list, struct hid_report, list);
104 	if (report->maxfield < 1) {
105 		hid_err(hid, "no fields in the report\n");
106 		return -ENODEV;
107 	}
108 
109 	if (report->field[0]->report_count < 7) {
110 		hid_err(hid, "not enough values in the field\n");
111 		return -ENODEV;
112 	}
113 
114 	drff = kzalloc(sizeof(struct drff_device), GFP_KERNEL);
115 	if (!drff)
116 		return -ENOMEM;
117 
118 	set_bit(FF_RUMBLE, dev->ffbit);
119 
120 	error = input_ff_create_memless(dev, drff, drff_play);
121 	if (error) {
122 		kfree(drff);
123 		return error;
124 	}
125 
126 	drff->report = report;
127 	drff->report->field[0]->value[0] = 0xf3;
128 	drff->report->field[0]->value[1] = 0x00;
129 	drff->report->field[0]->value[2] = 0x00;
130 	drff->report->field[0]->value[3] = 0x00;
131 	drff->report->field[0]->value[4] = 0x00;
132 	drff->report->field[0]->value[5] = 0x00;
133 	drff->report->field[0]->value[6] = 0x00;
134 	usbhid_submit_report(hid, drff->report, USB_DIR_OUT);
135 
136 	hid_info(hid, "Force Feedback for DragonRise Inc. "
137 		 "game controllers by Richard Walmsley <richwalm@gmail.com>\n");
138 
139 	return 0;
140 }
141 #else
drff_init(struct hid_device * hid)142 static inline int drff_init(struct hid_device *hid)
143 {
144 	return 0;
145 }
146 #endif
147 
148 /*
149  * The original descriptor of joystick with PID 0x0011, represented by DVTech PC
150  * JS19. It seems both copied from another device and a result of confusion
151  * either about the specification or about the program used to create the
152  * descriptor. In any case, it's a wonder it works on Windows.
153  *
154  *  Usage Page (Desktop),             ; Generic desktop controls (01h)
155  *  Usage (Joystik),                  ; Joystik (04h, application collection)
156  *  Collection (Application),
157  *    Collection (Logical),
158  *      Report Size (8),
159  *      Report Count (5),
160  *      Logical Minimum (0),
161  *      Logical Maximum (255),
162  *      Physical Minimum (0),
163  *      Physical Maximum (255),
164  *      Usage (X),                    ; X (30h, dynamic value)
165  *      Usage (X),                    ; X (30h, dynamic value)
166  *      Usage (X),                    ; X (30h, dynamic value)
167  *      Usage (X),                    ; X (30h, dynamic value)
168  *      Usage (Y),                    ; Y (31h, dynamic value)
169  *      Input (Variable),
170  *      Report Size (4),
171  *      Report Count (1),
172  *      Logical Maximum (7),
173  *      Physical Maximum (315),
174  *      Unit (Degrees),
175  *      Usage (00h),
176  *      Input (Variable, Null State),
177  *      Unit,
178  *      Report Size (1),
179  *      Report Count (10),
180  *      Logical Maximum (1),
181  *      Physical Maximum (1),
182  *      Usage Page (Button),          ; Button (09h)
183  *      Usage Minimum (01h),
184  *      Usage Maximum (0Ah),
185  *      Input (Variable),
186  *      Usage Page (FF00h),           ; FF00h, vendor-defined
187  *      Report Size (1),
188  *      Report Count (10),
189  *      Logical Maximum (1),
190  *      Physical Maximum (1),
191  *      Usage (01h),
192  *      Input (Variable),
193  *    End Collection,
194  *    Collection (Logical),
195  *      Report Size (8),
196  *      Report Count (4),
197  *      Physical Maximum (255),
198  *      Logical Maximum (255),
199  *      Usage (02h),
200  *      Output (Variable),
201  *    End Collection,
202  *  End Collection
203  */
204 
205 /* Size of the original descriptor of the PID 0x0011 joystick */
206 #define PID0011_RDESC_ORIG_SIZE	101
207 
208 /* Fixed report descriptor for PID 0x011 joystick */
209 static __u8 pid0011_rdesc_fixed[] = {
210 	0x05, 0x01,         /*  Usage Page (Desktop),           */
211 	0x09, 0x04,         /*  Usage (Joystik),                */
212 	0xA1, 0x01,         /*  Collection (Application),       */
213 	0xA1, 0x02,         /*      Collection (Logical),       */
214 	0x14,               /*          Logical Minimum (0),    */
215 	0x75, 0x08,         /*          Report Size (8),        */
216 	0x95, 0x03,         /*          Report Count (3),       */
217 	0x81, 0x01,         /*          Input (Constant),       */
218 	0x26, 0xFF, 0x00,   /*          Logical Maximum (255),  */
219 	0x95, 0x02,         /*          Report Count (2),       */
220 	0x09, 0x30,         /*          Usage (X),              */
221 	0x09, 0x31,         /*          Usage (Y),              */
222 	0x81, 0x02,         /*          Input (Variable),       */
223 	0x75, 0x01,         /*          Report Size (1),        */
224 	0x95, 0x04,         /*          Report Count (4),       */
225 	0x81, 0x01,         /*          Input (Constant),       */
226 	0x25, 0x01,         /*          Logical Maximum (1),    */
227 	0x95, 0x0A,         /*          Report Count (10),      */
228 	0x05, 0x09,         /*          Usage Page (Button),    */
229 	0x19, 0x01,         /*          Usage Minimum (01h),    */
230 	0x29, 0x0A,         /*          Usage Maximum (0Ah),    */
231 	0x81, 0x02,         /*          Input (Variable),       */
232 	0x95, 0x0A,         /*          Report Count (10),      */
233 	0x81, 0x01,         /*          Input (Constant),       */
234 	0xC0,               /*      End Collection,             */
235 	0xC0                /*  End Collection                  */
236 };
237 
dr_report_fixup(struct hid_device * hdev,__u8 * rdesc,unsigned int * rsize)238 static __u8 *dr_report_fixup(struct hid_device *hdev, __u8 *rdesc,
239 				unsigned int *rsize)
240 {
241 	switch (hdev->product) {
242 	case 0x0011:
243 		if (*rsize == PID0011_RDESC_ORIG_SIZE) {
244 			rdesc = pid0011_rdesc_fixed;
245 			*rsize = sizeof(pid0011_rdesc_fixed);
246 		}
247 		break;
248 	}
249 	return rdesc;
250 }
251 
dr_probe(struct hid_device * hdev,const struct hid_device_id * id)252 static int dr_probe(struct hid_device *hdev, const struct hid_device_id *id)
253 {
254 	int ret;
255 
256 	dev_dbg(&hdev->dev, "DragonRise Inc. HID hardware probe...");
257 
258 	ret = hid_parse(hdev);
259 	if (ret) {
260 		hid_err(hdev, "parse failed\n");
261 		goto err;
262 	}
263 
264 	ret = hid_hw_start(hdev, HID_CONNECT_DEFAULT & ~HID_CONNECT_FF);
265 	if (ret) {
266 		hid_err(hdev, "hw start failed\n");
267 		goto err;
268 	}
269 
270 	switch (hdev->product) {
271 	case 0x0006:
272 		ret = drff_init(hdev);
273 		if (ret) {
274 			dev_err(&hdev->dev, "force feedback init failed\n");
275 			hid_hw_stop(hdev);
276 			goto err;
277 		}
278 		break;
279 	}
280 
281 	return 0;
282 err:
283 	return ret;
284 }
285 
286 static const struct hid_device_id dr_devices[] = {
287 	{ HID_USB_DEVICE(USB_VENDOR_ID_DRAGONRISE, 0x0006),  },
288 	{ HID_USB_DEVICE(USB_VENDOR_ID_DRAGONRISE, 0x0011),  },
289 	{ }
290 };
291 MODULE_DEVICE_TABLE(hid, dr_devices);
292 
293 static struct hid_driver dr_driver = {
294 	.name = "dragonrise",
295 	.id_table = dr_devices,
296 	.report_fixup = dr_report_fixup,
297 	.probe = dr_probe,
298 };
299 
dr_init(void)300 static int __init dr_init(void)
301 {
302 	return hid_register_driver(&dr_driver);
303 }
304 
dr_exit(void)305 static void __exit dr_exit(void)
306 {
307 	hid_unregister_driver(&dr_driver);
308 }
309 
310 module_init(dr_init);
311 module_exit(dr_exit);
312 MODULE_LICENSE("GPL");
313