projects / deliverable / linux.git / blame
| Commit | Line | Data |
|---|---|---|
| 14bf62cd SA |
1 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/actual_dpi |
| 2 | Date: March 2010 | |
| 3 | Contact: Stefan Achatz <erazor_de@users.sourceforge.net> | |
| 4 | Description: 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 | ||
| 20 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/actual_profile | |
| 21 | Date: March 2010 | |
| 22 | Contact: Stefan Achatz <erazor_de@users.sourceforge.net> | |
| 23 | Description: When read, this file returns the number of the actual profile. | |
| 24 | This file is readonly. | |
| 25 | ||
| 26 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/firmware_version | |
| 27 | Date: March 2010 | |
| 28 | Contact: Stefan Achatz <erazor_de@users.sourceforge.net> | |
| 29 | Description: 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 | ||
| 36 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/kone_driver_version | |
| 37 | Date: March 2010 | |
| 38 | Contact: Stefan Achatz <erazor_de@users.sourceforge.net> | |
| 39 | Description: 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 | ||
| 49 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/profile[1-5] | |
| 50 | Date: March 2010 | |
| 51 | Contact: Stefan Achatz <erazor_de@users.sourceforge.net> | |
| 52 | Description: 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 | ||
| 64 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/settings | |
| 65 | Date: March 2010 | |
| 66 | Contact: Stefan Achatz <erazor_de@users.sourceforge.net> | |
| 67 | Description: 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 | ||
| 74 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/startup_profile | |
| 75 | Date: March 2010 | |
| 76 | Contact: Stefan Achatz <erazor_de@users.sourceforge.net> | |
| 77 | Description: 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 | ||
| 83 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/tcu | |
| 84 | Date: March 2010 | |
| 85 | Contact: Stefan Achatz <erazor_de@users.sourceforge.net> | |
| 86 | Description: 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 | ||
| 94 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/weight | |
| 95 | Date: March 2010 | |
| 96 | Contact: Stefan Achatz <erazor_de@users.sourceforge.net> | |
| 97 | Description: 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. |