1 // SPDX-License-Identifier: GPL-2.0-or-later
3 * Roccat Kone driver for Linux
5 * Copyright (c) 2010 Stefan Achatz <erazor_de@users.sourceforge.net>
12 * Roccat Kone is a gamer mouse which consists of a mouse part and a keyboard
13 * part. The keyboard part enables the mouse to execute stored macros with mixed
14 * key- and button-events.
16 * TODO implement on-the-fly polling-rate change
17 * The windows driver has the ability to change the polling rate of the
18 * device on the press of a mousebutton.
19 * Is it possible to remove and reinstall the urb in raw-event- or any
20 * other handler, or to defer this action to be executed somewhere else?
22 * TODO is it possible to overwrite group for sysfs attributes via udev?
25 #include <linux/device.h>
26 #include <linux/input.h>
27 #include <linux/hid.h>
28 #include <linux/module.h>
29 #include <linux/slab.h>
30 #include <linux/hid-roccat.h>
32 #include "hid-roccat-common.h"
33 #include "hid-roccat-kone.h"
35 static uint profile_numbers[5] = {0, 1, 2, 3, 4};
37 static void kone_profile_activated(struct kone_device *kone, uint new_profile)
39 kone->actual_profile = new_profile;
40 kone->actual_dpi = kone->profiles[new_profile - 1].startup_dpi;
43 static void kone_profile_report(struct kone_device *kone, uint new_profile)
45 struct kone_roccat_report roccat_report;
47 roccat_report.event = kone_mouse_event_switch_profile;
48 roccat_report.value = new_profile;
49 roccat_report.key = 0;
50 roccat_report_event(kone->chrdev_minor, (uint8_t *)&roccat_report);
53 static int kone_receive(struct usb_device *usb_dev, uint usb_command,
54 void *data, uint size)
59 buf = kmalloc(size, GFP_KERNEL);
63 len = usb_control_msg(usb_dev, usb_rcvctrlpipe(usb_dev, 0),
65 USB_TYPE_CLASS | USB_RECIP_INTERFACE | USB_DIR_IN,
66 usb_command, 0, buf, size, USB_CTRL_SET_TIMEOUT);
68 memcpy(data, buf, size);
70 return ((len < 0) ? len : ((len != size) ? -EIO : 0));
73 static int kone_send(struct usb_device *usb_dev, uint usb_command,
74 void const *data, uint size)
79 buf = kmemdup(data, size, GFP_KERNEL);
83 len = usb_control_msg(usb_dev, usb_sndctrlpipe(usb_dev, 0),
85 USB_TYPE_CLASS | USB_RECIP_INTERFACE | USB_DIR_OUT,
86 usb_command, 0, buf, size, USB_CTRL_SET_TIMEOUT);
89 return ((len < 0) ? len : ((len != size) ? -EIO : 0));
92 /* kone_class is used for creating sysfs attributes via roccat char device */
93 static struct class *kone_class;
95 static void kone_set_settings_checksum(struct kone_settings *settings)
97 uint16_t checksum = 0;
98 unsigned char *address = (unsigned char *)settings;
101 for (i = 0; i < sizeof(struct kone_settings) - 2; ++i, ++address)
102 checksum += *address;
103 settings->checksum = cpu_to_le16(checksum);
107 * Checks success after writing data to mouse
108 * On success returns 0
109 * On failure returns errno
111 static int kone_check_write(struct usb_device *usb_dev)
118 * Mouse needs 50 msecs until it says ok, but there are
119 * 30 more msecs needed for next write to work.
123 retval = kone_receive(usb_dev,
124 kone_command_confirm_write, &data, 1);
129 * value of 3 seems to mean something like
130 * "not finished yet, but it looks good"
131 * So check again after a moment.
135 if (data == 1) /* everything alright */
139 dev_err(&usb_dev->dev, "got retval %d when checking write\n", data);
144 * Reads settings from mouse and stores it in @buf
145 * On success returns 0
146 * On failure returns errno
148 static int kone_get_settings(struct usb_device *usb_dev,
149 struct kone_settings *buf)
151 return kone_receive(usb_dev, kone_command_settings, buf,
152 sizeof(struct kone_settings));
156 * Writes settings from @buf to mouse
157 * On success returns 0
158 * On failure returns errno
160 static int kone_set_settings(struct usb_device *usb_dev,
161 struct kone_settings const *settings)
165 retval = kone_send(usb_dev, kone_command_settings,
166 settings, sizeof(struct kone_settings));
169 return kone_check_write(usb_dev);
173 * Reads profile data from mouse and stores it in @buf
174 * @number: profile number to read
175 * On success returns 0
176 * On failure returns errno
178 static int kone_get_profile(struct usb_device *usb_dev,
179 struct kone_profile *buf, int number)
183 if (number < 1 || number > 5)
186 len = usb_control_msg(usb_dev, usb_rcvctrlpipe(usb_dev, 0),
187 USB_REQ_CLEAR_FEATURE,
188 USB_TYPE_CLASS | USB_RECIP_INTERFACE | USB_DIR_IN,
189 kone_command_profile, number, buf,
190 sizeof(struct kone_profile), USB_CTRL_SET_TIMEOUT);
192 if (len != sizeof(struct kone_profile))
199 * Writes profile data to mouse.
200 * @number: profile number to write
201 * On success returns 0
202 * On failure returns errno
204 static int kone_set_profile(struct usb_device *usb_dev,
205 struct kone_profile const *profile, int number)
209 if (number < 1 || number > 5)
212 len = usb_control_msg(usb_dev, usb_sndctrlpipe(usb_dev, 0),
213 USB_REQ_SET_CONFIGURATION,
214 USB_TYPE_CLASS | USB_RECIP_INTERFACE | USB_DIR_OUT,
215 kone_command_profile, number, (void *)profile,
216 sizeof(struct kone_profile),
217 USB_CTRL_SET_TIMEOUT);
219 if (len != sizeof(struct kone_profile))
222 if (kone_check_write(usb_dev))
229 * Reads value of "fast-clip-weight" and stores it in @result
230 * On success returns 0
231 * On failure returns errno
233 static int kone_get_weight(struct usb_device *usb_dev, int *result)
238 retval = kone_receive(usb_dev, kone_command_weight, &data, 1);
248 * Reads firmware_version of mouse and stores it in @result
249 * On success returns 0
250 * On failure returns errno
252 static int kone_get_firmware_version(struct usb_device *usb_dev, int *result)
257 retval = kone_receive(usb_dev, kone_command_firmware_version,
262 *result = le16_to_cpu(data);
266 static ssize_t kone_sysfs_read_settings(struct file *fp, struct kobject *kobj,
267 struct bin_attribute *attr, char *buf,
268 loff_t off, size_t count) {
269 struct device *dev = kobj_to_dev(kobj)->parent->parent;
270 struct kone_device *kone = hid_get_drvdata(dev_get_drvdata(dev));
272 if (off >= sizeof(struct kone_settings))
275 if (off + count > sizeof(struct kone_settings))
276 count = sizeof(struct kone_settings) - off;
278 mutex_lock(&kone->kone_lock);
279 memcpy(buf, ((char const *)&kone->settings) + off, count);
280 mutex_unlock(&kone->kone_lock);
286 * Writing settings automatically activates startup_profile.
287 * This function keeps values in kone_device up to date and assumes that in
288 * case of error the old data is still valid
290 static ssize_t kone_sysfs_write_settings(struct file *fp, struct kobject *kobj,
291 struct bin_attribute *attr, char *buf,
292 loff_t off, size_t count) {
293 struct device *dev = kobj_to_dev(kobj)->parent->parent;
294 struct kone_device *kone = hid_get_drvdata(dev_get_drvdata(dev));
295 struct usb_device *usb_dev = interface_to_usbdev(to_usb_interface(dev));
296 int retval = 0, difference, old_profile;
297 struct kone_settings *settings = (struct kone_settings *)buf;
299 /* I need to get my data in one piece */
300 if (off != 0 || count != sizeof(struct kone_settings))
303 mutex_lock(&kone->kone_lock);
304 difference = memcmp(settings, &kone->settings,
305 sizeof(struct kone_settings));
307 if (settings->startup_profile < 1 ||
308 settings->startup_profile > 5) {
313 retval = kone_set_settings(usb_dev, settings);
317 old_profile = kone->settings.startup_profile;
318 memcpy(&kone->settings, settings, sizeof(struct kone_settings));
320 kone_profile_activated(kone, kone->settings.startup_profile);
322 if (kone->settings.startup_profile != old_profile)
323 kone_profile_report(kone, kone->settings.startup_profile);
326 mutex_unlock(&kone->kone_lock);
331 return sizeof(struct kone_settings);
333 static BIN_ATTR(settings, 0660, kone_sysfs_read_settings,
334 kone_sysfs_write_settings, sizeof(struct kone_settings));
336 static ssize_t kone_sysfs_read_profilex(struct file *fp,
337 struct kobject *kobj, struct bin_attribute *attr,
338 char *buf, loff_t off, size_t count) {
339 struct device *dev = kobj_to_dev(kobj)->parent->parent;
340 struct kone_device *kone = hid_get_drvdata(dev_get_drvdata(dev));
342 if (off >= sizeof(struct kone_profile))
345 if (off + count > sizeof(struct kone_profile))
346 count = sizeof(struct kone_profile) - off;
348 mutex_lock(&kone->kone_lock);
349 memcpy(buf, ((char const *)&kone->profiles[*(uint *)(attr->private)]) + off, count);
350 mutex_unlock(&kone->kone_lock);
355 /* Writes data only if different to stored data */
356 static ssize_t kone_sysfs_write_profilex(struct file *fp,
357 struct kobject *kobj, struct bin_attribute *attr,
358 char *buf, loff_t off, size_t count) {
359 struct device *dev = kobj_to_dev(kobj)->parent->parent;
360 struct kone_device *kone = hid_get_drvdata(dev_get_drvdata(dev));
361 struct usb_device *usb_dev = interface_to_usbdev(to_usb_interface(dev));
362 struct kone_profile *profile;
363 int retval = 0, difference;
365 /* I need to get my data in one piece */
366 if (off != 0 || count != sizeof(struct kone_profile))
369 profile = &kone->profiles[*(uint *)(attr->private)];
371 mutex_lock(&kone->kone_lock);
372 difference = memcmp(buf, profile, sizeof(struct kone_profile));
374 retval = kone_set_profile(usb_dev,
375 (struct kone_profile const *)buf,
376 *(uint *)(attr->private) + 1);
378 memcpy(profile, buf, sizeof(struct kone_profile));
380 mutex_unlock(&kone->kone_lock);
385 return sizeof(struct kone_profile);
387 #define PROFILE_ATTR(number) \
388 static struct bin_attribute bin_attr_profile##number = { \
389 .attr = { .name = "profile" #number, .mode = 0660 }, \
390 .size = sizeof(struct kone_profile), \
391 .read = kone_sysfs_read_profilex, \
392 .write = kone_sysfs_write_profilex, \
393 .private = &profile_numbers[number-1], \
401 static ssize_t kone_sysfs_show_actual_profile(struct device *dev,
402 struct device_attribute *attr, char *buf)
404 struct kone_device *kone =
405 hid_get_drvdata(dev_get_drvdata(dev->parent->parent));
406 return snprintf(buf, PAGE_SIZE, "%d\n", kone->actual_profile);
408 static DEVICE_ATTR(actual_profile, 0440, kone_sysfs_show_actual_profile, NULL);
410 static ssize_t kone_sysfs_show_actual_dpi(struct device *dev,
411 struct device_attribute *attr, char *buf)
413 struct kone_device *kone =
414 hid_get_drvdata(dev_get_drvdata(dev->parent->parent));
415 return snprintf(buf, PAGE_SIZE, "%d\n", kone->actual_dpi);
417 static DEVICE_ATTR(actual_dpi, 0440, kone_sysfs_show_actual_dpi, NULL);
419 /* weight is read each time, since we don't get informed when it's changed */
420 static ssize_t kone_sysfs_show_weight(struct device *dev,
421 struct device_attribute *attr, char *buf)
423 struct kone_device *kone;
424 struct usb_device *usb_dev;
428 dev = dev->parent->parent;
429 kone = hid_get_drvdata(dev_get_drvdata(dev));
430 usb_dev = interface_to_usbdev(to_usb_interface(dev));
432 mutex_lock(&kone->kone_lock);
433 retval = kone_get_weight(usb_dev, &weight);
434 mutex_unlock(&kone->kone_lock);
438 return snprintf(buf, PAGE_SIZE, "%d\n", weight);
440 static DEVICE_ATTR(weight, 0440, kone_sysfs_show_weight, NULL);
442 static ssize_t kone_sysfs_show_firmware_version(struct device *dev,
443 struct device_attribute *attr, char *buf)
445 struct kone_device *kone =
446 hid_get_drvdata(dev_get_drvdata(dev->parent->parent));
447 return snprintf(buf, PAGE_SIZE, "%d\n", kone->firmware_version);
449 static DEVICE_ATTR(firmware_version, 0440, kone_sysfs_show_firmware_version,
452 static ssize_t kone_sysfs_show_tcu(struct device *dev,
453 struct device_attribute *attr, char *buf)
455 struct kone_device *kone =
456 hid_get_drvdata(dev_get_drvdata(dev->parent->parent));
457 return snprintf(buf, PAGE_SIZE, "%d\n", kone->settings.tcu);
460 static int kone_tcu_command(struct usb_device *usb_dev, int number)
465 return kone_send(usb_dev, kone_command_calibrate, &value, 1);
469 * Calibrating the tcu is the only action that changes settings data inside the
470 * mouse, so this data needs to be reread
472 static ssize_t kone_sysfs_set_tcu(struct device *dev,
473 struct device_attribute *attr, char const *buf, size_t size)
475 struct kone_device *kone;
476 struct usb_device *usb_dev;
480 dev = dev->parent->parent;
481 kone = hid_get_drvdata(dev_get_drvdata(dev));
482 usb_dev = interface_to_usbdev(to_usb_interface(dev));
484 retval = kstrtoul(buf, 10, &state);
488 if (state != 0 && state != 1)
491 mutex_lock(&kone->kone_lock);
493 if (state == 1) { /* state activate */
494 retval = kone_tcu_command(usb_dev, 1);
497 retval = kone_tcu_command(usb_dev, 2);
500 ssleep(5); /* tcu needs this time for calibration */
501 retval = kone_tcu_command(usb_dev, 3);
504 retval = kone_tcu_command(usb_dev, 0);
507 retval = kone_tcu_command(usb_dev, 4);
511 * Kone needs this time to settle things.
512 * Reading settings too early will result in invalid data.
513 * Roccat's driver waits 1 sec, maybe this time could be
519 /* calibration changes values in settings, so reread */
520 retval = kone_get_settings(usb_dev, &kone->settings);
522 goto exit_no_settings;
524 /* only write settings back if activation state is different */
525 if (kone->settings.tcu != state) {
526 kone->settings.tcu = state;
527 kone_set_settings_checksum(&kone->settings);
529 retval = kone_set_settings(usb_dev, &kone->settings);
531 dev_err(&usb_dev->dev, "couldn't set tcu state\n");
533 * try to reread valid settings into buffer overwriting
536 retval = kone_get_settings(usb_dev, &kone->settings);
538 goto exit_no_settings;
541 /* calibration resets profile */
542 kone_profile_activated(kone, kone->settings.startup_profile);
547 dev_err(&usb_dev->dev, "couldn't read settings\n");
549 mutex_unlock(&kone->kone_lock);
552 static DEVICE_ATTR(tcu, 0660, kone_sysfs_show_tcu, kone_sysfs_set_tcu);
554 static ssize_t kone_sysfs_show_startup_profile(struct device *dev,
555 struct device_attribute *attr, char *buf)
557 struct kone_device *kone =
558 hid_get_drvdata(dev_get_drvdata(dev->parent->parent));
559 return snprintf(buf, PAGE_SIZE, "%d\n", kone->settings.startup_profile);
562 static ssize_t kone_sysfs_set_startup_profile(struct device *dev,
563 struct device_attribute *attr, char const *buf, size_t size)
565 struct kone_device *kone;
566 struct usb_device *usb_dev;
568 unsigned long new_startup_profile;
570 dev = dev->parent->parent;
571 kone = hid_get_drvdata(dev_get_drvdata(dev));
572 usb_dev = interface_to_usbdev(to_usb_interface(dev));
574 retval = kstrtoul(buf, 10, &new_startup_profile);
578 if (new_startup_profile < 1 || new_startup_profile > 5)
581 mutex_lock(&kone->kone_lock);
583 kone->settings.startup_profile = new_startup_profile;
584 kone_set_settings_checksum(&kone->settings);
586 retval = kone_set_settings(usb_dev, &kone->settings);
588 mutex_unlock(&kone->kone_lock);
592 /* changing the startup profile immediately activates this profile */
593 kone_profile_activated(kone, new_startup_profile);
594 kone_profile_report(kone, new_startup_profile);
596 mutex_unlock(&kone->kone_lock);
599 static DEVICE_ATTR(startup_profile, 0660, kone_sysfs_show_startup_profile,
600 kone_sysfs_set_startup_profile);
602 static struct attribute *kone_attrs[] = {
604 * Read actual dpi settings.
605 * Returns raw value for further processing. Refer to enum
606 * kone_polling_rates to get real value.
608 &dev_attr_actual_dpi.attr,
609 &dev_attr_actual_profile.attr,
612 * The mouse can be equipped with one of four supplied weights from 5
613 * to 20 grams which are recognized and its value can be read out.
614 * This returns the raw value reported by the mouse for easy evaluation
615 * by software. Refer to enum kone_weights to get corresponding real
618 &dev_attr_weight.attr,
621 * Prints firmware version stored in mouse as integer.
622 * The raw value reported by the mouse is returned for easy evaluation,
623 * to get the real version number the decimal point has to be shifted 2
624 * positions to the left. E.g. a value of 138 means 1.38.
626 &dev_attr_firmware_version.attr,
629 * Prints state of Tracking Control Unit as number where 0 = off and
630 * 1 = on. Writing 0 deactivates tcu and writing 1 calibrates and
635 /* Prints and takes the number of the profile the mouse starts with */
636 &dev_attr_startup_profile.attr,
640 static struct bin_attribute *kone_bin_attributes[] = {
650 static const struct attribute_group kone_group = {
652 .bin_attrs = kone_bin_attributes,
655 static const struct attribute_group *kone_groups[] = {
660 static int kone_init_kone_device_struct(struct usb_device *usb_dev,
661 struct kone_device *kone)
666 mutex_init(&kone->kone_lock);
668 for (i = 0; i < 5; ++i) {
669 retval = kone_get_profile(usb_dev, &kone->profiles[i], i + 1);
674 retval = kone_get_settings(usb_dev, &kone->settings);
678 retval = kone_get_firmware_version(usb_dev, &kone->firmware_version);
682 kone_profile_activated(kone, kone->settings.startup_profile);
688 * Since IGNORE_MOUSE quirk moved to hid-apple, there is no way to bind only to
689 * mousepart if usb_hid is compiled into the kernel and kone is compiled as
691 * Secial behaviour is bound only to mousepart since only mouseevents contain
692 * additional notifications.
694 static int kone_init_specials(struct hid_device *hdev)
696 struct usb_interface *intf = to_usb_interface(hdev->dev.parent);
697 struct usb_device *usb_dev = interface_to_usbdev(intf);
698 struct kone_device *kone;
701 if (intf->cur_altsetting->desc.bInterfaceProtocol
702 == USB_INTERFACE_PROTOCOL_MOUSE) {
704 kone = kzalloc(sizeof(*kone), GFP_KERNEL);
707 hid_set_drvdata(hdev, kone);
709 retval = kone_init_kone_device_struct(usb_dev, kone);
711 hid_err(hdev, "couldn't init struct kone_device\n");
715 retval = roccat_connect(kone_class, hdev,
716 sizeof(struct kone_roccat_report));
718 hid_err(hdev, "couldn't init char dev\n");
719 /* be tolerant about not getting chrdev */
721 kone->roccat_claimed = 1;
722 kone->chrdev_minor = retval;
725 hid_set_drvdata(hdev, NULL);
734 static void kone_remove_specials(struct hid_device *hdev)
736 struct usb_interface *intf = to_usb_interface(hdev->dev.parent);
737 struct kone_device *kone;
739 if (intf->cur_altsetting->desc.bInterfaceProtocol
740 == USB_INTERFACE_PROTOCOL_MOUSE) {
741 kone = hid_get_drvdata(hdev);
742 if (kone->roccat_claimed)
743 roccat_disconnect(kone->chrdev_minor);
744 kfree(hid_get_drvdata(hdev));
748 static int kone_probe(struct hid_device *hdev, const struct hid_device_id *id)
752 if (!hid_is_usb(hdev))
755 retval = hid_parse(hdev);
757 hid_err(hdev, "parse failed\n");
761 retval = hid_hw_start(hdev, HID_CONNECT_DEFAULT);
763 hid_err(hdev, "hw start failed\n");
767 retval = kone_init_specials(hdev);
769 hid_err(hdev, "couldn't install mouse\n");
781 static void kone_remove(struct hid_device *hdev)
783 kone_remove_specials(hdev);
787 /* handle special events and keep actual profile and dpi values up to date */
788 static void kone_keep_values_up_to_date(struct kone_device *kone,
789 struct kone_mouse_event const *event)
791 switch (event->event) {
792 case kone_mouse_event_switch_profile:
793 kone->actual_dpi = kone->profiles[event->value - 1].
796 case kone_mouse_event_osd_profile:
797 kone->actual_profile = event->value;
799 case kone_mouse_event_switch_dpi:
800 case kone_mouse_event_osd_dpi:
801 kone->actual_dpi = event->value;
806 static void kone_report_to_chrdev(struct kone_device const *kone,
807 struct kone_mouse_event const *event)
809 struct kone_roccat_report roccat_report;
811 switch (event->event) {
812 case kone_mouse_event_switch_profile:
813 case kone_mouse_event_switch_dpi:
814 case kone_mouse_event_osd_profile:
815 case kone_mouse_event_osd_dpi:
816 roccat_report.event = event->event;
817 roccat_report.value = event->value;
818 roccat_report.key = 0;
819 roccat_report_event(kone->chrdev_minor,
820 (uint8_t *)&roccat_report);
822 case kone_mouse_event_call_overlong_macro:
823 case kone_mouse_event_multimedia:
824 if (event->value == kone_keystroke_action_press) {
825 roccat_report.event = event->event;
826 roccat_report.value = kone->actual_profile;
827 roccat_report.key = event->macro_key;
828 roccat_report_event(kone->chrdev_minor,
829 (uint8_t *)&roccat_report);
837 * Is called for keyboard- and mousepart.
838 * Only mousepart gets informations about special events in its extended event
841 static int kone_raw_event(struct hid_device *hdev, struct hid_report *report,
844 struct kone_device *kone = hid_get_drvdata(hdev);
845 struct kone_mouse_event *event = (struct kone_mouse_event *)data;
847 /* keyboard events are always processed by default handler */
848 if (size != sizeof(struct kone_mouse_event))
855 * Firmware 1.38 introduced new behaviour for tilt and special buttons.
856 * Pressed button is reported in each movement event.
857 * Workaround sends only one event per press.
859 if (memcmp(&kone->last_mouse_event.tilt, &event->tilt, 5))
860 memcpy(&kone->last_mouse_event, event,
861 sizeof(struct kone_mouse_event));
863 memset(&event->wipe, 0, sizeof(event->wipe));
865 kone_keep_values_up_to_date(kone, event);
867 if (kone->roccat_claimed)
868 kone_report_to_chrdev(kone, event);
870 return 0; /* always do further processing */
873 static const struct hid_device_id kone_devices[] = {
874 { HID_USB_DEVICE(USB_VENDOR_ID_ROCCAT, USB_DEVICE_ID_ROCCAT_KONE) },
878 MODULE_DEVICE_TABLE(hid, kone_devices);
880 static struct hid_driver kone_driver = {
882 .id_table = kone_devices,
884 .remove = kone_remove,
885 .raw_event = kone_raw_event
888 static int __init kone_init(void)
892 /* class name has to be same as driver name */
893 kone_class = class_create(THIS_MODULE, "kone");
894 if (IS_ERR(kone_class))
895 return PTR_ERR(kone_class);
896 kone_class->dev_groups = kone_groups;
898 retval = hid_register_driver(&kone_driver);
900 class_destroy(kone_class);
904 static void __exit kone_exit(void)
906 hid_unregister_driver(&kone_driver);
907 class_destroy(kone_class);
910 module_init(kone_init);
911 module_exit(kone_exit);
913 MODULE_AUTHOR("Stefan Achatz");
914 MODULE_DESCRIPTION("USB Roccat Kone driver");
915 MODULE_LICENSE("GPL v2");