HID: add FF support for Holtek On Line Grip based gamepads
authorAnssi Hannula <anssi.hannula@iki.fi>
Sun, 26 Jun 2011 21:07:31 +0000 (00:07 +0300)
committerJiri Kosina <jkosina@suse.cz>
Mon, 27 Jun 2011 10:40:00 +0000 (12:40 +0200)
Add force feedback support for Holtek On Line Grip based HID devices.

The protocol is more complex than that of most other rumblepads, but the
device still needs to be handled as a memoryless one.

Tested by Cleber de Mattos Casali with a 1241:5015 "Clone Joypad Super
Power Fire" gamepad, with help from Hendrik Iben <hendrik_iben@web.de>.

Signed-off-by: Anssi Hannula <anssi.hannula@iki.fi>
Tested-by: Cleber de Mattos Casali <clebercasali@yahoo.com.br>
Signed-off-by: Jiri Kosina <jkosina@suse.cz>
drivers/hid/Kconfig
drivers/hid/Makefile
drivers/hid/hid-core.c
drivers/hid/hid-holtekff.c [new file with mode: 0644]
drivers/hid/hid-ids.h

index 860b1db1b734c323a126d7608cbcdbc47df17dd7..acc39e8ef3e7fab143be3f63d9199a61fa0c17c3 100644 (file)
@@ -172,6 +172,20 @@ config HID_EZKEY
        ---help---
        Support for Ezkey BTC 8193 keyboard.
 
+config HID_HOLTEK
+       tristate "Holtek On Line Grip based game controller support"
+       depends on USB_HID
+       ---help---
+         Say Y here if you have a Holtek On Line Grip based game controller.
+
+config HOLTEK_FF
+       bool "Holtek On Line Grip force feedback support"
+       depends on HID_HOLTEK
+       select INPUT_FF_MEMLESS
+       ---help---
+         Say Y here if you have a Holtek On Line Grip based game controller
+         and want to have force feedback support for it.
+
 config HID_KEYTOUCH
        tristate "Keytouch HID devices"
        depends on USB_HID
index f97718084dc8923cad52a124d965a61e014ff3a0..21dea54b448201b472bb62a76ab6d104734801bc 100644 (file)
@@ -37,6 +37,7 @@ obj-$(CONFIG_HID_EMS_FF)      += hid-emsff.o
 obj-$(CONFIG_HID_ELECOM)       += hid-elecom.o
 obj-$(CONFIG_HID_EZKEY)                += hid-ezkey.o
 obj-$(CONFIG_HID_GYRATION)     += hid-gyration.o
+obj-$(CONFIG_HID_HOLTEK)       += hid-holtekff.o
 obj-$(CONFIG_HID_KENSINGTON)   += hid-kensington.o
 obj-$(CONFIG_HID_KEYTOUCH)     += hid-keytouch.o
 obj-$(CONFIG_HID_KYE)          += hid-kye.o
index 3b6af7cc98416af021a9684ea1779bf245aadd7d..e5ab72a2b5a824b6811d2995797f513c7185b1b5 100644 (file)
@@ -1387,6 +1387,7 @@ static const struct hid_device_id hid_have_special_driver[] = {
        { HID_USB_DEVICE(USB_VENDOR_ID_GYRATION, USB_DEVICE_ID_GYRATION_REMOTE_2) },
        { HID_USB_DEVICE(USB_VENDOR_ID_GYRATION, USB_DEVICE_ID_GYRATION_REMOTE_3) },
        { HID_USB_DEVICE(USB_VENDOR_ID_HANVON, USB_DEVICE_ID_HANVON_MULTITOUCH) },
+       { HID_USB_DEVICE(USB_VENDOR_ID_HOLTEK, USB_DEVICE_ID_HOLTEK_ON_LINE_GRIP) },
        { HID_USB_DEVICE(USB_VENDOR_ID_ILITEK, USB_DEVICE_ID_ILITEK_MULTITOUCH) },
        { HID_USB_DEVICE(USB_VENDOR_ID_IRTOUCHSYSTEMS, USB_DEVICE_ID_IRTOUCH_INFRARED_USB) },
        { HID_USB_DEVICE(USB_VENDOR_ID_KENSINGTON, USB_DEVICE_ID_KS_SLIMBLADE) },
diff --git a/drivers/hid/hid-holtekff.c b/drivers/hid/hid-holtekff.c
new file mode 100644 (file)
index 0000000..91e3a03
--- /dev/null
@@ -0,0 +1,240 @@
+/*
+ *  Force feedback support for Holtek On Line Grip based gamepads
+ *
+ *  These include at least a Brazilian "Clone Joypad Super Power Fire"
+ *  which uses vendor ID 0x1241 and identifies as "HOLTEK On Line Grip".
+ *
+ *  Copyright (c) 2011 Anssi Hannula <anssi.hannula@iki.fi>
+ */
+
+/*
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program; if not, write to the Free Software
+ * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
+ */
+
+#include <linux/hid.h>
+#include <linux/input.h>
+#include <linux/slab.h>
+#include <linux/usb.h>
+
+#include "hid-ids.h"
+
+#ifdef CONFIG_HOLTEK_FF
+#include "usbhid/usbhid.h"
+
+MODULE_LICENSE("GPL");
+MODULE_AUTHOR("Anssi Hannula <anssi.hannula@iki.fi>");
+MODULE_DESCRIPTION("Force feedback support for Holtek On Line Grip based devices");
+
+/*
+ * These commands and parameters are currently known:
+ *
+ * byte 0: command id:
+ *     01  set effect parameters
+ *     02  play specified effect
+ *     03  stop specified effect
+ *     04  stop all effects
+ *     06  stop all effects
+ *     (the difference between 04 and 06 isn't known; win driver
+ *      sends 06,04 on application init, and 06 otherwise)
+ * 
+ * Commands 01 and 02 need to be sent as pairs, i.e. you need to send 01
+ * before each 02.
+ *
+ * The rest of the bytes are parameters. Command 01 takes all of them, and
+ * commands 02,03 take only the effect id.
+ *
+ * byte 1:
+ *     bits 0-3: effect id:
+ *             1: very strong rumble
+ *             2: periodic rumble, short intervals
+ *             3: very strong rumble
+ *             4: periodic rumble, long intervals
+ *             5: weak periodic rumble, long intervals
+ *             6: weak periodic rumble, short intervals
+ *             7: periodic rumble, short intervals
+ *             8: strong periodic rumble, short intervals
+ *             9: very strong rumble
+ *             a: causes an error
+ *             b: very strong periodic rumble, very short intervals
+ *             c-f: nothing
+ *     bit 6: right (weak) motor enabled
+ *     bit 7: left (strong) motor enabled
+ *
+ * bytes 2-3:  time in milliseconds, big-endian
+ * bytes 5-6:  unknown (win driver seems to use at least 10e0 with effect 1
+ *                    and 0014 with effect 6)
+ * byte 7:
+ *     bits 0-3: effect magnitude
+ */
+
+#define HOLTEKFF_MSG_LENGTH     7
+
+static const u8 start_effect_1[] = { 0x02, 0x01, 0x00, 0x00, 0x00, 0x00, 0x00 };
+static const u8 stop_all4[] =     { 0x04, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00 };
+static const u8 stop_all6[] =     { 0x06, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00 };
+
+struct holtekff_device {
+       struct hid_field *field;
+};
+
+static void holtekff_send(struct holtekff_device *holtekff,
+                         struct hid_device *hid,
+                         const u8 data[HOLTEKFF_MSG_LENGTH])
+{
+       int i;
+
+       for (i = 0; i < HOLTEKFF_MSG_LENGTH; i++) {
+               holtekff->field->value[i] = data[i];
+       }
+
+       dbg_hid("sending %02x %02x %02x %02x %02x %02x %02x\n", data[0],
+               data[1], data[2], data[3], data[4], data[5], data[6]);
+
+       usbhid_submit_report(hid, holtekff->field->report, USB_DIR_OUT);
+}
+
+static int holtekff_play(struct input_dev *dev, void *data,
+                        struct ff_effect *effect)
+{
+       struct hid_device *hid = input_get_drvdata(dev);
+       struct holtekff_device *holtekff = data;
+       int left, right;
+       /* effect type 1, length 65535 msec */
+       u8 buf[HOLTEKFF_MSG_LENGTH] =
+               { 0x01, 0x01, 0xff, 0xff, 0x10, 0xe0, 0x00 };
+
+       left = effect->u.rumble.strong_magnitude;
+       right = effect->u.rumble.weak_magnitude;
+       dbg_hid("called with 0x%04x 0x%04x\n", left, right);
+
+       if (!left && !right) {
+               holtekff_send(holtekff, hid, stop_all6);
+               return 0;
+       }
+
+       if (left)
+               buf[1] |= 0x80;
+       if (right)
+               buf[1] |= 0x40;
+
+       /* The device takes a single magnitude, so we just sum them up. */
+       buf[6] = min(0xf, (left >> 12) + (right >> 12));
+
+       holtekff_send(holtekff, hid, buf);
+       holtekff_send(holtekff, hid, start_effect_1);
+
+       return 0;
+}
+
+static int holtekff_init(struct hid_device *hid)
+{
+       struct holtekff_device *holtekff;
+       struct hid_report *report;
+       struct hid_input *hidinput = list_entry(hid->inputs.next,
+                                               struct hid_input, list);
+       struct list_head *report_list =
+                       &hid->report_enum[HID_OUTPUT_REPORT].report_list;
+       struct input_dev *dev = hidinput->input;
+       int error;
+
+       if (list_empty(report_list)) {
+               hid_err(hid, "no output report found\n");
+               return -ENODEV;
+       }
+
+       report = list_entry(report_list->next, struct hid_report, list);
+
+       if (report->maxfield < 1 || report->field[0]->report_count != 7) {
+               hid_err(hid, "unexpected output report layout\n");
+               return -ENODEV;
+       }
+
+       holtekff = kzalloc(sizeof(*holtekff), GFP_KERNEL);
+       if (!holtekff)
+               return -ENOMEM;
+
+       set_bit(FF_RUMBLE, dev->ffbit);
+
+       holtekff->field = report->field[0];
+
+       /* initialize the same way as win driver does */
+       holtekff_send(holtekff, hid, stop_all4);
+       holtekff_send(holtekff, hid, stop_all6);
+
+       error = input_ff_create_memless(dev, holtekff, holtekff_play);
+       if (error) {
+               kfree(holtekff);
+               return error;
+       }
+
+       hid_info(hid, "Force feedback for Holtek On Line Grip based devices by Anssi Hannula <anssi.hannula@iki.fi>\n");
+
+       return 0;
+}
+#else
+static inline int holtekff_init(struct hid_device *hid)
+{
+       return 0;
+}
+#endif
+
+static int holtek_probe(struct hid_device *hdev, const struct hid_device_id *id)
+{
+       int ret;
+
+       ret = hid_parse(hdev);
+       if (ret) {
+               hid_err(hdev, "parse failed\n");
+               goto err;
+       }
+
+       ret = hid_hw_start(hdev, HID_CONNECT_DEFAULT & ~HID_CONNECT_FF);
+       if (ret) {
+               hid_err(hdev, "hw start failed\n");
+               goto err;
+       }
+
+       holtekff_init(hdev);
+
+       return 0;
+err:
+       return ret;
+}
+
+static const struct hid_device_id holtek_devices[] = {
+       { HID_USB_DEVICE(USB_VENDOR_ID_HOLTEK, USB_DEVICE_ID_HOLTEK_ON_LINE_GRIP) },
+       { }
+};
+MODULE_DEVICE_TABLE(hid, holtek_devices);
+
+static struct hid_driver holtek_driver = {
+       .name = "holtek",
+       .id_table = holtek_devices,
+       .probe = holtek_probe,
+};
+
+static int __init holtek_init(void)
+{
+       return hid_register_driver(&holtek_driver);
+}
+
+static void __exit holtek_exit(void)
+{
+       hid_unregister_driver(&holtek_driver);
+}
+
+module_init(holtek_init);
+module_exit(holtek_exit);
+
index e8faee4621e420b6724131d6f4efa77dac1c69f0..0c1cafac9b468600fe63263137404bd9101a8238 100644 (file)
 #define USB_VENDOR_ID_ILITEK           0x222a
 #define USB_DEVICE_ID_ILITEK_MULTITOUCH        0x0001
 
+#define USB_VENDOR_ID_HOLTEK           0x1241
+#define USB_DEVICE_ID_HOLTEK_ON_LINE_GRIP      0x5015
+
 #define USB_VENDOR_ID_IMATION          0x0718
 #define USB_DEVICE_ID_DISC_STAKKA      0xd000