1What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/actual_dpi 2Date: March 2010 3Contact: Stefan Achatz <erazor_de@users.sourceforge.net> 4Description: It is possible to switch the dpi setting of the mouse with the 5 press of a button. 6 When read, this file returns the raw number of the actual dpi 7 setting reported by the mouse. This number has to be further 8 processed to receive the real dpi value. 9 10 VALUE DPI 11 1 800 12 2 1200 13 3 1600 14 4 2000 15 5 2400 16 6 3200 17 18 This file is readonly. 19 20What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/actual_profile 21Date: March 2010 22Contact: Stefan Achatz <erazor_de@users.sourceforge.net> 23Description: When read, this file returns the number of the actual profile. 24 This file is readonly. 25 26What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/firmware_version 27Date: March 2010 28Contact: Stefan Achatz <erazor_de@users.sourceforge.net> 29Description: When read, this file returns the raw integer version number of the 30 firmware reported by the mouse. Using the integer value eases 31 further usage in other programs. To receive the real version 32 number the decimal point has to be shifted 2 positions to the 33 left. E.g. a returned value of 138 means 1.38 34 This file is readonly. 35 36What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/kone_driver_version 37Date: March 2010 38Contact: Stefan Achatz <erazor_de@users.sourceforge.net> 39Description: When read, this file returns the driver version. 40 The format of the string is "v<major>.<minor>.<patchlevel>". 41 This attribute is used by the userland tools to find the sysfs- 42 paths of installed kone-mice and determine the capabilites of 43 the driver. Versions of this driver for old kernels replace 44 usbhid instead of generic-usb. The way to scan for this file 45 has been chosen to provide a consistent way for all supported 46 kernel versions. 47 This file is readonly. 48 49What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/profile[1-5] 50Date: March 2010 51Contact: Stefan Achatz <erazor_de@users.sourceforge.net> 52Description: The mouse can store 5 profiles which can be switched by the 53 press of a button. A profile holds informations like button 54 mappings, sensitivity, the colors of the 5 leds and light 55 effects. 56 When read, these files return the respective profile. The 57 returned data is 975 bytes in size. 58 When written, this file lets one write the respective profile 59 data back to the mouse. The data has to be 975 bytes long. 60 The mouse will reject invalid data, whereas the profile number 61 stored in the profile doesn't need to fit the number of the 62 store. 63 64What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/settings 65Date: March 2010 66Contact: Stefan Achatz <erazor_de@users.sourceforge.net> 67Description: When read, this file returns the settings stored in the mouse. 68 The size of the data is 36 bytes and holds information like the 69 startup_profile, tcu state and calibration_data. 70 When written, this file lets write settings back to the mouse. 71 The data has to be 36 bytes long. The mouse will reject invalid 72 data. 73 74What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/startup_profile 75Date: March 2010 76Contact: Stefan Achatz <erazor_de@users.sourceforge.net> 77Description: The integer value of this attribute ranges from 1 to 5. 78 When read, this attribute returns the number of the profile 79 that's active when the mouse is powered on. 80 When written, this file sets the number of the startup profile 81 and the mouse activates this profile immediately. 82 83What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/tcu 84Date: March 2010 85Contact: Stefan Achatz <erazor_de@users.sourceforge.net> 86Description: The mouse has a "Tracking Control Unit" which lets the user 87 calibrate the laser power to fit the mousepad surface. 88 When read, this file returns the current state of the TCU, 89 where 0 means off and 1 means on. 90 Writing 0 in this file will switch the TCU off. 91 Writing 1 in this file will start the calibration which takes 92 around 6 seconds to complete and activates the TCU. 93 94What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/weight 95Date: March 2010 96Contact: Stefan Achatz <erazor_de@users.sourceforge.net> 97Description: The mouse can be equipped with one of four supplied weights 98 ranging from 5 to 20 grams which are recognized by the mouse 99 and its value can be read out. When read, this file returns the 100 raw value returned by the mouse which eases further processing 101 in other software. 102 The values map to the weights as follows: 103 104 VALUE WEIGHT 105 0 none 106 1 5g 107 2 10g 108 3 15g 109 4 20g 110 111 This file is readonly. 112