drivers/hid/hid-holtekff.c

   1 /*
   2  *  Force feedback support for Holtek On Line Grip based gamepads
   3  *
   4  *  These include at least a Brazilian "Clone Joypad Super Power Fire"
   5  *  which uses vendor ID 0x1241 and identifies as "HOLTEK On Line Grip".
   6  *
   7  *  Copyright (c) 2011 Anssi Hannula <anssi.hannula@iki.fi>
   8  */
   9
  10 /*
  11  * This program is free software; you can redistribute it and/or modify
  12  * it under the terms of the GNU General Public License as published by
  13  * the Free Software Foundation; either version 2 of the License, or
  14  * (at your option) any later version.
  15  *
  16  * This program is distributed in the hope that it will be useful,
  17  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  18  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  19  * GNU General Public License for more details.
  20  *
  21  * You should have received a copy of the GNU General Public License
  22  * along with this program; if not, write to the Free Software
  23  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
  24  */
  25
  26 #include <linux/hid.h>
  27 #include <linux/input.h>
  28 #include <linux/module.h>
  29 #include <linux/slab.h>
  30 #include <linux/usb.h>
  31
  32 #include "hid-ids.h"
  33
  34 #ifdef CONFIG_HOLTEK_FF
  35 #include "usbhid/usbhid.h"
  36
  37 MODULE_LICENSE("GPL");
  38 MODULE_AUTHOR("Anssi Hannula <anssi.hannula@iki.fi>");
  39 MODULE_DESCRIPTION("Force feedback support for Holtek On Line Grip based devices");
  40
  41 /*
  42  * These commands and parameters are currently known:
  43  *
  44  * byte 0: command id:
  45  *      01  set effect parameters
  46  *      02  play specified effect
  47  *      03  stop specified effect
  48  *      04  stop all effects
  49  *      06  stop all effects
  50  *      (the difference between 04 and 06 isn't known; win driver
  51  *       sends 06,04 on application init, and 06 otherwise)
  52  *
  53  * Commands 01 and 02 need to be sent as pairs, i.e. you need to send 01
  54  * before each 02.
  55  *
  56  * The rest of the bytes are parameters. Command 01 takes all of them, and
  57  * commands 02,03 take only the effect id.
  58  *
  59  * byte 1:
  60  *      bits 0-3: effect id:
  61  *              1: very strong rumble
  62  *              2: periodic rumble, short intervals
  63  *              3: very strong rumble
  64  *              4: periodic rumble, long intervals
  65  *              5: weak periodic rumble, long intervals
  66  *              6: weak periodic rumble, short intervals
  67  *              7: periodic rumble, short intervals
  68  *              8: strong periodic rumble, short intervals
  69  *              9: very strong rumble
  70  *              a: causes an error
  71  *              b: very strong periodic rumble, very short intervals
  72  *              c-f: nothing
  73  *      bit 6: right (weak) motor enabled
  74  *      bit 7: left (strong) motor enabled
  75  *
  76  * bytes 2-3:  time in milliseconds, big-endian
  77  * bytes 5-6:  unknown (win driver seems to use at least 10e0 with effect 1
  78  *                     and 0014 with effect 6)
  79  * byte 7:
  80  *      bits 0-3: effect magnitude
  81  */
  82
  83 #define HOLTEKFF_MSG_LENGTH     7
  84
  85 static const u8 start_effect_1[] = { 0x02, 0x01, 0x00, 0x00, 0x00, 0x00, 0x00 };
  86 static const u8 stop_all4[] =      { 0x04, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00 };
  87 static const u8 stop_all6[] =      { 0x06, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00 };
  88
  89 struct holtekff_device {
  90         struct hid_field *field;
  91 };
  92
  93 static void holtekff_send(struct holtekff_device *holtekff,
  94                           struct hid_device *hid,
  95                           const u8 data[HOLTEKFF_MSG_LENGTH])
  96 {
  97         int i;
  98
  99         for (i = 0; i < HOLTEKFF_MSG_LENGTH; i++) {
 100                 holtekff->field->value[i] = data[i];
 101         }
 102
 103         dbg_hid("sending %02x %02x %02x %02x %02x %02x %02x\n", data[0],
 104                 data[1], data[2], data[3], data[4], data[5], data[6]);
 105
 106         usbhid_submit_report(hid, holtekff->field->report, USB_DIR_OUT);
 107 }
 108
 109 static int holtekff_play(struct input_dev *dev, void *data,
 110                          struct ff_effect *effect)
 111 {
 112         struct hid_device *hid = input_get_drvdata(dev);
 113         struct holtekff_device *holtekff = data;
 114         int left, right;
 115         /* effect type 1, length 65535 msec */
 116         u8 buf[HOLTEKFF_MSG_LENGTH] =
 117                 { 0x01, 0x01, 0xff, 0xff, 0x10, 0xe0, 0x00 };
 118
 119         left = effect->u.rumble.strong_magnitude;
 120         right = effect->u.rumble.weak_magnitude;
 121         dbg_hid("called with 0x%04x 0x%04x\n", left, right);
 122
 123         if (!left && !right) {
 124                 holtekff_send(holtekff, hid, stop_all6);
 125                 return 0;
 126         }
 127
 128         if (left)
 129                 buf[1] |= 0x80;
 130         if (right)
 131                 buf[1] |= 0x40;
 132
 133         /* The device takes a single magnitude, so we just sum them up. */
 134         buf[6] = min(0xf, (left >> 12) + (right >> 12));
 135
 136         holtekff_send(holtekff, hid, buf);
 137         holtekff_send(holtekff, hid, start_effect_1);
 138
 139         return 0;
 140 }
 141
 142 static int holtekff_init(struct hid_device *hid)
 143 {
 144         struct holtekff_device *holtekff;
 145         struct hid_report *report;
 146         struct hid_input *hidinput = list_entry(hid->inputs.next,
 147                                                 struct hid_input, list);
 148         struct list_head *report_list =
 149                         &hid->report_enum[HID_OUTPUT_REPORT].report_list;
 150         struct input_dev *dev = hidinput->input;
 151         int error;
 152
 153         if (list_empty(report_list)) {
 154                 hid_err(hid, "no output report found\n");
 155                 return -ENODEV;
 156         }
 157
 158         report = list_entry(report_list->next, struct hid_report, list);
 159
 160         if (report->maxfield < 1 || report->field[0]->report_count != 7) {
 161                 hid_err(hid, "unexpected output report layout\n");
 162                 return -ENODEV;
 163         }
 164
 165         holtekff = kzalloc(sizeof(*holtekff), GFP_KERNEL);
 166         if (!holtekff)
 167                 return -ENOMEM;
 168
 169         set_bit(FF_RUMBLE, dev->ffbit);
 170
 171         holtekff->field = report->field[0];
 172
 173         /* initialize the same way as win driver does */
 174         holtekff_send(holtekff, hid, stop_all4);
 175         holtekff_send(holtekff, hid, stop_all6);
 176
 177         error = input_ff_create_memless(dev, holtekff, holtekff_play);
 178         if (error) {
 179                 kfree(holtekff);
 180                 return error;
 181         }
 182
 183         hid_info(hid, "Force feedback for Holtek On Line Grip based devices by Anssi Hannula <anssi.hannula@iki.fi>\n");
 184
 185         return 0;
 186 }
 187 #else
 188 static inline int holtekff_init(struct hid_device *hid)
 189 {
 190         return 0;
 191 }
 192 #endif
 193
 194 static int holtek_probe(struct hid_device *hdev, const struct hid_device_id *id)
 195 {
 196         int ret;
 197
 198         ret = hid_parse(hdev);
 199         if (ret) {
 200                 hid_err(hdev, "parse failed\n");
 201                 goto err;
 202         }
 203
 204         ret = hid_hw_start(hdev, HID_CONNECT_DEFAULT & ~HID_CONNECT_FF);
 205         if (ret) {
 206                 hid_err(hdev, "hw start failed\n");
 207                 goto err;
 208         }
 209
 210         holtekff_init(hdev);
 211
 212         return 0;
 213 err:
 214         return ret;
 215 }
 216
 217 static const struct hid_device_id holtek_devices[] = {
 218         { HID_USB_DEVICE(USB_VENDOR_ID_HOLTEK, USB_DEVICE_ID_HOLTEK_ON_LINE_GRIP) },
 219         { }
 220 };
 221 MODULE_DEVICE_TABLE(hid, holtek_devices);
 222
 223 static struct hid_driver holtek_driver = {
 224         .name = "holtek",
 225         .id_table = holtek_devices,
 226         .probe = holtek_probe,
 227 };
 228
 229 static int __init holtek_init(void)
 230 {
 231         return hid_register_driver(&holtek_driver);
 232 }
 233
 234 static void __exit holtek_exit(void)
 235 {
 236         hid_unregister_driver(&holtek_driver);
 237 }
 238
 239 module_init(holtek_init);
 240 module_exit(holtek_exit);
 241