2 * HID driver for Saitek devices.
4 * PS1000 (USB gamepad):
5 * Fixes the HID report descriptor by removing a non-existent axis and
6 * clearing the constant bit on the input reports for buttons and d-pad.
7 * (This module is based on "hid-ortek".)
8 * Copyright (c) 2012 Andreas Hübner
10 * R.A.T.7, R.A.T.9, M.M.O.7 (USB gaming mice):
11 * Fixes the mode button which cycles through three constantly pressed
12 * buttons. All three press events are mapped to one button and the
13 * missing release event is generated immediately.
18 * This program is free software; you can redistribute it and/or modify it
19 * under the terms of the GNU General Public License as published by the Free
20 * Software Foundation; either version 2 of the License, or (at your option)
24 #include <linux/device.h>
25 #include <linux/hid.h>
26 #include <linux/module.h>
27 #include <linux/kernel.h>
31 #define SAITEK_FIX_PS1000 0x0001
32 #define SAITEK_RELEASE_MODE_RAT7 0x0002
33 #define SAITEK_RELEASE_MODE_MMO7 0x0004
40 static int saitek_probe(struct hid_device *hdev,
41 const struct hid_device_id *id)
43 unsigned long quirks = id->driver_data;
44 struct saitek_sc *ssc;
47 ssc = devm_kzalloc(&hdev->dev, sizeof(*ssc), GFP_KERNEL);
49 hid_err(hdev, "can't alloc saitek descriptor\n");
56 hid_set_drvdata(hdev, ssc);
58 ret = hid_parse(hdev);
60 hid_err(hdev, "parse failed\n");
64 ret = hid_hw_start(hdev, HID_CONNECT_DEFAULT);
66 hid_err(hdev, "hw start failed\n");
73 static __u8 *saitek_report_fixup(struct hid_device *hdev, __u8 *rdesc,
76 struct saitek_sc *ssc = hid_get_drvdata(hdev);
78 if ((ssc->quirks & SAITEK_FIX_PS1000) && *rsize == 137 &&
79 rdesc[20] == 0x09 && rdesc[21] == 0x33 &&
80 rdesc[94] == 0x81 && rdesc[95] == 0x03 &&
81 rdesc[110] == 0x81 && rdesc[111] == 0x03) {
83 hid_info(hdev, "Fixing up Saitek PS1000 report descriptor\n");
85 /* convert spurious axis to a "noop" Logical Minimum (0) */
89 /* clear constant bit on buttons and d-pad */
97 static int saitek_raw_event(struct hid_device *hdev,
98 struct hid_report *report, u8 *raw_data, int size)
100 struct saitek_sc *ssc = hid_get_drvdata(hdev);
102 if (ssc->quirks & SAITEK_RELEASE_MODE_RAT7 && size == 7) {
103 /* R.A.T.7 uses bits 13, 14, 15 for the mode */
105 if (raw_data[1] & 0x01)
107 else if (raw_data[1] & 0x02)
109 else if (raw_data[1] & 0x04)
112 /* clear mode bits */
113 raw_data[1] &= ~0x07;
115 if (mode != ssc->mode) {
116 hid_dbg(hdev, "entered mode %d\n", mode);
117 if (ssc->mode != -1) {
118 /* use bit 13 as the mode button */
123 } else if (ssc->quirks & SAITEK_RELEASE_MODE_MMO7 && size == 8) {
125 /* M.M.O.7 uses bits 8, 22, 23 for the mode */
127 if (raw_data[1] & 0x80)
129 else if (raw_data[2] & 0x01)
131 else if (raw_data[2] & 0x02)
134 /* clear mode bits */
135 raw_data[1] &= ~0x80;
136 raw_data[2] &= ~0x03;
138 if (mode != ssc->mode) {
139 hid_dbg(hdev, "entered mode %d\n", mode);
140 if (ssc->mode != -1) {
141 /* use bit 8 as the mode button, bits 22
142 * and 23 do not represent buttons
143 * according to the HID report descriptor
154 static int saitek_event(struct hid_device *hdev, struct hid_field *field,
155 struct hid_usage *usage, __s32 value)
157 struct saitek_sc *ssc = hid_get_drvdata(hdev);
158 struct input_dev *input = field->hidinput->input;
160 if (usage->type == EV_KEY && value &&
161 (((ssc->quirks & SAITEK_RELEASE_MODE_RAT7) &&
162 usage->code - BTN_MOUSE == 10) ||
163 ((ssc->quirks & SAITEK_RELEASE_MODE_MMO7) &&
164 usage->code - BTN_MOUSE == 15))) {
166 input_report_key(input, usage->code, 1);
168 /* report missing release event */
169 input_report_key(input, usage->code, 0);
177 static const struct hid_device_id saitek_devices[] = {
178 { HID_USB_DEVICE(USB_VENDOR_ID_SAITEK, USB_DEVICE_ID_SAITEK_PS1000),
179 .driver_data = SAITEK_FIX_PS1000 },
180 { HID_USB_DEVICE(USB_VENDOR_ID_MADCATZ, USB_DEVICE_ID_MADCATZ_RAT5),
181 .driver_data = SAITEK_RELEASE_MODE_RAT7 },
182 { HID_USB_DEVICE(USB_VENDOR_ID_SAITEK, USB_DEVICE_ID_SAITEK_RAT7_OLD),
183 .driver_data = SAITEK_RELEASE_MODE_RAT7 },
184 { HID_USB_DEVICE(USB_VENDOR_ID_SAITEK, USB_DEVICE_ID_SAITEK_RAT7),
185 .driver_data = SAITEK_RELEASE_MODE_RAT7 },
186 { HID_USB_DEVICE(USB_VENDOR_ID_MADCATZ, USB_DEVICE_ID_MADCATZ_RAT9),
187 .driver_data = SAITEK_RELEASE_MODE_RAT7 },
188 { HID_USB_DEVICE(USB_VENDOR_ID_SAITEK, USB_DEVICE_ID_SAITEK_MMO7),
189 .driver_data = SAITEK_RELEASE_MODE_MMO7 },
193 MODULE_DEVICE_TABLE(hid, saitek_devices);
195 static struct hid_driver saitek_driver = {
197 .id_table = saitek_devices,
198 .probe = saitek_probe,
199 .report_fixup = saitek_report_fixup,
200 .raw_event = saitek_raw_event,
201 .event = saitek_event,
203 module_hid_driver(saitek_driver);
205 MODULE_LICENSE("GPL");