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