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_abi_version 37Date: May 2010 38Contact: Stefan Achatz <erazor_de@users.sourceforge.net> 39Description: When read, this file returns the abi version as an integer value. 40 This attribute is used by the userland tools to find the sysfs- 41 paths of installed kone-mice and determine the capabilites of 42 the driver. Versions of this driver for old kernels replace 43 usbhid instead of generic-usb. The way to scan for this file 44 has been chosen to provide a consistent way for all supported 45 kernel versions. 46 This file is readonly. 47 48What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/profile[1-5] 49Date: March 2010 50Contact: Stefan Achatz <erazor_de@users.sourceforge.net> 51Description: The mouse can store 5 profiles which can be switched by the 52 press of a button. A profile holds informations like button 53 mappings, sensitivity, the colors of the 5 leds and light 54 effects. 55 When read, these files return the respective profile. The 56 returned data is 975 bytes in size. 57 When written, this file lets one write the respective profile 58 data back to the mouse. The data has to be 975 bytes long. 59 The mouse will reject invalid data, whereas the profile number 60 stored in the profile doesn't need to fit the number of the 61 store. 62 63What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/settings 64Date: March 2010 65Contact: Stefan Achatz <erazor_de@users.sourceforge.net> 66Description: When read, this file returns the settings stored in the mouse. 67 The size of the data is 36 bytes and holds information like the 68 startup_profile, tcu state and calibration_data. 69 When written, this file lets write settings back to the mouse. 70 The data has to be 36 bytes long. The mouse will reject invalid 71 data. 72 73What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/startup_profile 74Date: March 2010 75Contact: Stefan Achatz <erazor_de@users.sourceforge.net> 76Description: The integer value of this attribute ranges from 1 to 5. 77 When read, this attribute returns the number of the profile 78 that's active when the mouse is powered on. 79 When written, this file sets the number of the startup profile 80 and the mouse activates this profile immediately. 81 82What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/tcu 83Date: March 2010 84Contact: Stefan Achatz <erazor_de@users.sourceforge.net> 85Description: The mouse has a "Tracking Control Unit" which lets the user 86 calibrate the laser power to fit the mousepad surface. 87 When read, this file returns the current state of the TCU, 88 where 0 means off and 1 means on. 89 Writing 0 in this file will switch the TCU off. 90 Writing 1 in this file will start the calibration which takes 91 around 6 seconds to complete and activates the TCU. 92 93What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/weight 94Date: March 2010 95Contact: Stefan Achatz <erazor_de@users.sourceforge.net> 96Description: The mouse can be equipped with one of four supplied weights 97 ranging from 5 to 20 grams which are recognized by the mouse 98 and its value can be read out. When read, this file returns the 99 raw value returned by the mouse which eases further processing 100 in other software. 101 The values map to the weights as follows: 102 103 VALUE WEIGHT 104 0 none 105 1 5g 106 2 10g 107 3 15g 108 4 20g 109 110 This file is readonly. 111