1 // SPDX-License-Identifier: GPL-2.0-or-later
3 * HID driver for Steelseries SRW-S1
5 * Copyright (c) 2013 Simon Wood
11 #include <linux/device.h>
12 #include <linux/hid.h>
13 #include <linux/module.h>
17 #if IS_BUILTIN(CONFIG_LEDS_CLASS) || \
18 (IS_MODULE(CONFIG_LEDS_CLASS) && IS_MODULE(CONFIG_HID_STEELSERIES))
19 #define SRWS1_NUMBER_LEDS 15
20 struct steelseries_srws1_data
{
22 /* the last element is used for setting all leds simultaneously */
23 struct led_classdev
*led
[SRWS1_NUMBER_LEDS
+ 1];
27 /* Fixed report descriptor for Steelseries SRW-S1 wheel controller
29 * The original descriptor hides the sensitivity and assists dials
30 * a custom vendor usage page. This inserts a patch to make them
31 * appear in the 'Generic Desktop' usage.
34 static __u8 steelseries_srws1_rdesc_fixed
[] = {
35 0x05, 0x01, /* Usage Page (Desktop) */
36 0x09, 0x08, /* Usage (MultiAxis), Changed */
37 0xA1, 0x01, /* Collection (Application), */
38 0xA1, 0x02, /* Collection (Logical), */
39 0x95, 0x01, /* Report Count (1), */
40 0x05, 0x01, /* Changed Usage Page (Desktop), */
41 0x09, 0x30, /* Changed Usage (X), */
42 0x16, 0xF8, 0xF8, /* Logical Minimum (-1800), */
43 0x26, 0x08, 0x07, /* Logical Maximum (1800), */
44 0x65, 0x14, /* Unit (Degrees), */
45 0x55, 0x0F, /* Unit Exponent (15), */
46 0x75, 0x10, /* Report Size (16), */
47 0x81, 0x02, /* Input (Variable), */
48 0x09, 0x31, /* Changed Usage (Y), */
49 0x15, 0x00, /* Logical Minimum (0), */
50 0x26, 0xFF, 0x03, /* Logical Maximum (1023), */
51 0x75, 0x0C, /* Report Size (12), */
52 0x81, 0x02, /* Input (Variable), */
53 0x09, 0x32, /* Changed Usage (Z), */
54 0x15, 0x00, /* Logical Minimum (0), */
55 0x26, 0xFF, 0x03, /* Logical Maximum (1023), */
56 0x75, 0x0C, /* Report Size (12), */
57 0x81, 0x02, /* Input (Variable), */
58 0x05, 0x01, /* Usage Page (Desktop), */
59 0x09, 0x39, /* Usage (Hat Switch), */
60 0x25, 0x07, /* Logical Maximum (7), */
61 0x35, 0x00, /* Physical Minimum (0), */
62 0x46, 0x3B, 0x01, /* Physical Maximum (315), */
63 0x65, 0x14, /* Unit (Degrees), */
64 0x75, 0x04, /* Report Size (4), */
65 0x95, 0x01, /* Report Count (1), */
66 0x81, 0x02, /* Input (Variable), */
67 0x25, 0x01, /* Logical Maximum (1), */
68 0x45, 0x01, /* Physical Maximum (1), */
69 0x65, 0x00, /* Unit, */
70 0x75, 0x01, /* Report Size (1), */
71 0x95, 0x03, /* Report Count (3), */
72 0x81, 0x01, /* Input (Constant), */
73 0x05, 0x09, /* Usage Page (Button), */
74 0x19, 0x01, /* Usage Minimum (01h), */
75 0x29, 0x11, /* Usage Maximum (11h), */
76 0x95, 0x11, /* Report Count (17), */
77 0x81, 0x02, /* Input (Variable), */
78 /* ---- Dial patch starts here ---- */
79 0x05, 0x01, /* Usage Page (Desktop), */
80 0x09, 0x33, /* Usage (RX), */
81 0x75, 0x04, /* Report Size (4), */
82 0x95, 0x02, /* Report Count (2), */
83 0x15, 0x00, /* Logical Minimum (0), */
84 0x25, 0x0b, /* Logical Maximum (b), */
85 0x81, 0x02, /* Input (Variable), */
86 0x09, 0x35, /* Usage (RZ), */
87 0x75, 0x04, /* Report Size (4), */
88 0x95, 0x01, /* Report Count (1), */
89 0x25, 0x03, /* Logical Maximum (3), */
90 0x81, 0x02, /* Input (Variable), */
91 /* ---- Dial patch ends here ---- */
92 0x06, 0x00, 0xFF, /* Usage Page (FF00h), */
93 0x09, 0x01, /* Usage (01h), */
94 0x75, 0x04, /* Changed Report Size (4), */
95 0x95, 0x0D, /* Changed Report Count (13), */
96 0x81, 0x02, /* Input (Variable), */
97 0xC0, /* End Collection, */
98 0xA1, 0x02, /* Collection (Logical), */
99 0x09, 0x02, /* Usage (02h), */
100 0x75, 0x08, /* Report Size (8), */
101 0x95, 0x10, /* Report Count (16), */
102 0x91, 0x02, /* Output (Variable), */
103 0xC0, /* End Collection, */
104 0xC0 /* End Collection */
107 #if IS_BUILTIN(CONFIG_LEDS_CLASS) || \
108 (IS_MODULE(CONFIG_LEDS_CLASS) && IS_MODULE(CONFIG_HID_STEELSERIES))
109 static void steelseries_srws1_set_leds(struct hid_device
*hdev
, __u16 leds
)
111 struct list_head
*report_list
= &hdev
->report_enum
[HID_OUTPUT_REPORT
].report_list
;
112 struct hid_report
*report
= list_entry(report_list
->next
, struct hid_report
, list
);
113 __s32
*value
= report
->field
[0]->value
;
116 value
[1] = leds
& 0xFF;
117 value
[2] = leds
>> 8;
132 hid_hw_request(hdev
, report
, HID_REQ_SET_REPORT
);
134 /* Note: LED change does not show on device until the device is read/polled */
137 static void steelseries_srws1_led_all_set_brightness(struct led_classdev
*led_cdev
,
138 enum led_brightness value
)
140 struct device
*dev
= led_cdev
->dev
->parent
;
141 struct hid_device
*hid
= to_hid_device(dev
);
142 struct steelseries_srws1_data
*drv_data
= hid_get_drvdata(hid
);
145 hid_err(hid
, "Device data not found.");
149 if (value
== LED_OFF
)
150 drv_data
->led_state
= 0;
152 drv_data
->led_state
= (1 << (SRWS1_NUMBER_LEDS
+ 1)) - 1;
154 steelseries_srws1_set_leds(hid
, drv_data
->led_state
);
157 static enum led_brightness
steelseries_srws1_led_all_get_brightness(struct led_classdev
*led_cdev
)
159 struct device
*dev
= led_cdev
->dev
->parent
;
160 struct hid_device
*hid
= to_hid_device(dev
);
161 struct steelseries_srws1_data
*drv_data
;
163 drv_data
= hid_get_drvdata(hid
);
166 hid_err(hid
, "Device data not found.");
170 return (drv_data
->led_state
>> SRWS1_NUMBER_LEDS
) ? LED_FULL
: LED_OFF
;
173 static void steelseries_srws1_led_set_brightness(struct led_classdev
*led_cdev
,
174 enum led_brightness value
)
176 struct device
*dev
= led_cdev
->dev
->parent
;
177 struct hid_device
*hid
= to_hid_device(dev
);
178 struct steelseries_srws1_data
*drv_data
= hid_get_drvdata(hid
);
182 hid_err(hid
, "Device data not found.");
186 for (i
= 0; i
< SRWS1_NUMBER_LEDS
; i
++) {
187 if (led_cdev
!= drv_data
->led
[i
])
190 state
= (drv_data
->led_state
>> i
) & 1;
191 if (value
== LED_OFF
&& state
) {
192 drv_data
->led_state
&= ~(1 << i
);
193 steelseries_srws1_set_leds(hid
, drv_data
->led_state
);
194 } else if (value
!= LED_OFF
&& !state
) {
195 drv_data
->led_state
|= 1 << i
;
196 steelseries_srws1_set_leds(hid
, drv_data
->led_state
);
202 static enum led_brightness
steelseries_srws1_led_get_brightness(struct led_classdev
*led_cdev
)
204 struct device
*dev
= led_cdev
->dev
->parent
;
205 struct hid_device
*hid
= to_hid_device(dev
);
206 struct steelseries_srws1_data
*drv_data
;
209 drv_data
= hid_get_drvdata(hid
);
212 hid_err(hid
, "Device data not found.");
216 for (i
= 0; i
< SRWS1_NUMBER_LEDS
; i
++)
217 if (led_cdev
== drv_data
->led
[i
]) {
218 value
= (drv_data
->led_state
>> i
) & 1;
222 return value
? LED_FULL
: LED_OFF
;
225 static int steelseries_srws1_probe(struct hid_device
*hdev
,
226 const struct hid_device_id
*id
)
229 struct led_classdev
*led
;
233 struct steelseries_srws1_data
*drv_data
= kzalloc(sizeof(*drv_data
), GFP_KERNEL
);
235 if (drv_data
== NULL
) {
236 hid_err(hdev
, "can't alloc SRW-S1 memory\n");
240 hid_set_drvdata(hdev
, drv_data
);
242 ret
= hid_parse(hdev
);
244 hid_err(hdev
, "parse failed\n");
248 if (!hid_validate_values(hdev
, HID_OUTPUT_REPORT
, 0, 0, 16)) {
253 ret
= hid_hw_start(hdev
, HID_CONNECT_DEFAULT
);
255 hid_err(hdev
, "hw start failed\n");
259 /* register led subsystem */
260 drv_data
->led_state
= 0;
261 for (i
= 0; i
< SRWS1_NUMBER_LEDS
+ 1; i
++)
262 drv_data
->led
[i
] = NULL
;
264 steelseries_srws1_set_leds(hdev
, 0);
266 name_sz
= strlen(hdev
->uniq
) + 16;
268 /* 'ALL', for setting all LEDs simultaneously */
269 led
= kzalloc(sizeof(struct led_classdev
)+name_sz
, GFP_KERNEL
);
271 hid_err(hdev
, "can't allocate memory for LED ALL\n");
275 name
= (void *)(&led
[1]);
276 snprintf(name
, name_sz
, "SRWS1::%s::RPMALL", hdev
->uniq
);
279 led
->max_brightness
= 1;
280 led
->brightness_get
= steelseries_srws1_led_all_get_brightness
;
281 led
->brightness_set
= steelseries_srws1_led_all_set_brightness
;
283 drv_data
->led
[SRWS1_NUMBER_LEDS
] = led
;
284 ret
= led_classdev_register(&hdev
->dev
, led
);
288 /* Each individual LED */
289 for (i
= 0; i
< SRWS1_NUMBER_LEDS
; i
++) {
290 led
= kzalloc(sizeof(struct led_classdev
)+name_sz
, GFP_KERNEL
);
292 hid_err(hdev
, "can't allocate memory for LED %d\n", i
);
296 name
= (void *)(&led
[1]);
297 snprintf(name
, name_sz
, "SRWS1::%s::RPM%d", hdev
->uniq
, i
+1);
300 led
->max_brightness
= 1;
301 led
->brightness_get
= steelseries_srws1_led_get_brightness
;
302 led
->brightness_set
= steelseries_srws1_led_set_brightness
;
304 drv_data
->led
[i
] = led
;
305 ret
= led_classdev_register(&hdev
->dev
, led
);
308 hid_err(hdev
, "failed to register LED %d. Aborting.\n", i
);
310 /* Deregister all LEDs (if any) */
311 for (i
= 0; i
< SRWS1_NUMBER_LEDS
+ 1; i
++) {
312 led
= drv_data
->led
[i
];
313 drv_data
->led
[i
] = NULL
;
316 led_classdev_unregister(led
);
319 goto out
; /* but let the driver continue without LEDs */
329 static void steelseries_srws1_remove(struct hid_device
*hdev
)
332 struct led_classdev
*led
;
334 struct steelseries_srws1_data
*drv_data
= hid_get_drvdata(hdev
);
337 /* Deregister LEDs (if any) */
338 for (i
= 0; i
< SRWS1_NUMBER_LEDS
+ 1; i
++) {
339 led
= drv_data
->led
[i
];
340 drv_data
->led
[i
] = NULL
;
343 led_classdev_unregister(led
);
355 static __u8
*steelseries_srws1_report_fixup(struct hid_device
*hdev
, __u8
*rdesc
,
358 if (*rsize
>= 115 && rdesc
[11] == 0x02 && rdesc
[13] == 0xc8
359 && rdesc
[29] == 0xbb && rdesc
[40] == 0xc5) {
360 hid_info(hdev
, "Fixing up Steelseries SRW-S1 report descriptor\n");
361 rdesc
= steelseries_srws1_rdesc_fixed
;
362 *rsize
= sizeof(steelseries_srws1_rdesc_fixed
);
367 static const struct hid_device_id steelseries_srws1_devices
[] = {
368 { HID_USB_DEVICE(USB_VENDOR_ID_STEELSERIES
, USB_DEVICE_ID_STEELSERIES_SRWS1
) },
371 MODULE_DEVICE_TABLE(hid
, steelseries_srws1_devices
);
373 static struct hid_driver steelseries_srws1_driver
= {
374 .name
= "steelseries_srws1",
375 .id_table
= steelseries_srws1_devices
,
376 #if IS_BUILTIN(CONFIG_LEDS_CLASS) || \
377 (IS_MODULE(CONFIG_LEDS_CLASS) && IS_MODULE(CONFIG_HID_STEELSERIES))
378 .probe
= steelseries_srws1_probe
,
379 .remove
= steelseries_srws1_remove
,
381 .report_fixup
= steelseries_srws1_report_fixup
384 module_hid_driver(steelseries_srws1_driver
);
385 MODULE_LICENSE("GPL");