hc
2023-12-08 01573e231f18eb2d99162747186f59511f56b64d
kernel/Documentation/ABI/testing/sysfs-driver-hid-roccat-kone
....@@ -3,17 +3,21 @@
33 Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
44 Description: It is possible to switch the dpi setting of the mouse with the
55 press of a button.
6
+
67 When read, this file returns the raw number of the actual dpi
78 setting reported by the mouse. This number has to be further
8
- processed to receive the real dpi value.
9
+ processed to receive the real dpi value:
910
11
+ ===== =====
1012 VALUE DPI
13
+ ===== =====
1114 1 800
1215 2 1200
1316 3 1600
1417 4 2000
1518 5 2400
1619 6 3200
20
+ ===== =====
1721
1822 This file is readonly.
1923 Users: http://roccat.sourceforge.net
....@@ -22,6 +26,7 @@
2226 Date: March 2010
2327 Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
2428 Description: When read, this file returns the number of the actual profile.
29
+
2530 This file is readonly.
2631 Users: http://roccat.sourceforge.net
2732
....@@ -33,6 +38,7 @@
3338 further usage in other programs. To receive the real version
3439 number the decimal point has to be shifted 2 positions to the
3540 left. E.g. a returned value of 138 means 1.38
41
+
3642 This file is readonly.
3743 Users: http://roccat.sourceforge.net
3844
....@@ -43,10 +49,13 @@
4349 press of a button. A profile holds information like button
4450 mappings, sensitivity, the colors of the 5 leds and light
4551 effects.
52
+
4653 When read, these files return the respective profile. The
4754 returned data is 975 bytes in size.
55
+
4856 When written, this file lets one write the respective profile
4957 data back to the mouse. The data has to be 975 bytes long.
58
+
5059 The mouse will reject invalid data, whereas the profile number
5160 stored in the profile doesn't need to fit the number of the
5261 store.
....@@ -58,6 +67,7 @@
5867 Description: When read, this file returns the settings stored in the mouse.
5968 The size of the data is 36 bytes and holds information like the
6069 startup_profile, tcu state and calibration_data.
70
+
6171 When written, this file lets write settings back to the mouse.
6272 The data has to be 36 bytes long. The mouse will reject invalid
6373 data.
....@@ -67,8 +77,10 @@
6777 Date: March 2010
6878 Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
6979 Description: The integer value of this attribute ranges from 1 to 5.
80
+
7081 When read, this attribute returns the number of the profile
7182 that's active when the mouse is powered on.
83
+
7284 When written, this file sets the number of the startup profile
7385 and the mouse activates this profile immediately.
7486 Users: http://roccat.sourceforge.net
....@@ -80,9 +92,12 @@
8092 calibrate the laser power to fit the mousepad surface.
8193 When read, this file returns the current state of the TCU,
8294 where 0 means off and 1 means on.
95
+
8396 Writing 0 in this file will switch the TCU off.
97
+
8498 Writing 1 in this file will start the calibration which takes
8599 around 6 seconds to complete and activates the TCU.
100
+
86101 Users: http://roccat.sourceforge.net
87102
88103 What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/kone/roccatkone<minor>/weight
....@@ -93,14 +108,18 @@
93108 and its value can be read out. When read, this file returns the
94109 raw value returned by the mouse which eases further processing
95110 in other software.
111
+
96112 The values map to the weights as follows:
97113
114
+ ===== ======
98115 VALUE WEIGHT
116
+ ===== ======
99117 0 none
100118 1 5g
101119 2 10g
102120 3 15g
103121 4 20g
122
+ ===== ======
104123
105124 This file is readonly.
106125 Users: http://roccat.sourceforge.net