xref: /linux/Documentation/ABI/obsolete/sysfs-driver-hid-roccat-konepure (revision e5451c8f8330e03ad3cfa16048b4daf961af434f)
1*8d2f8479SStefan AchatzWhat:		/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/konepure/roccatkonepure<minor>/actual_profile
2*8d2f8479SStefan AchatzDate:		December 2012
3*8d2f8479SStefan AchatzContact:	Stefan Achatz <erazor_de@users.sourceforge.net>
4*8d2f8479SStefan AchatzDescription:	The mouse can store 5 profiles which can be switched by the
5*8d2f8479SStefan Achatz		press of a button. actual_profile holds number of actual profile.
6*8d2f8479SStefan Achatz		This value is persistent, so its value determines the profile
7*8d2f8479SStefan Achatz		that's active when the mouse is powered on next time.
8*8d2f8479SStefan Achatz		When written, the mouse activates the set profile immediately.
9*8d2f8479SStefan Achatz		The data has to be 3 bytes long.
10*8d2f8479SStefan Achatz		The mouse will reject invalid data.
11*8d2f8479SStefan AchatzUsers:		http://roccat.sourceforge.net
12*8d2f8479SStefan Achatz
13*8d2f8479SStefan AchatzWhat:		/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/konepure/roccatkonepure<minor>/control
14*8d2f8479SStefan AchatzDate:		December 2012
15*8d2f8479SStefan AchatzContact:	Stefan Achatz <erazor_de@users.sourceforge.net>
16*8d2f8479SStefan AchatzDescription:	When written, this file lets one select which data from which
17*8d2f8479SStefan Achatz		profile will be	read next. The data has to be 3 bytes long.
18*8d2f8479SStefan Achatz		This file is writeonly.
19*8d2f8479SStefan AchatzUsers:		http://roccat.sourceforge.net
20*8d2f8479SStefan Achatz
21*8d2f8479SStefan AchatzWhat:		/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/konepure/roccatkonepure<minor>/info
22*8d2f8479SStefan AchatzDate:		December 2012
23*8d2f8479SStefan AchatzContact:	Stefan Achatz <erazor_de@users.sourceforge.net>
24*8d2f8479SStefan AchatzDescription:	When read, this file returns general data like firmware version.
25*8d2f8479SStefan Achatz		When written, the device can be reset.
26*8d2f8479SStefan Achatz		The data is 6 bytes long.
27*8d2f8479SStefan AchatzUsers:		http://roccat.sourceforge.net
28*8d2f8479SStefan Achatz
29*8d2f8479SStefan AchatzWhat:		/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/konepure/roccatkonepure<minor>/macro
30*8d2f8479SStefan AchatzDate:		December 2012
31*8d2f8479SStefan AchatzContact:	Stefan Achatz <erazor_de@users.sourceforge.net>
32*8d2f8479SStefan AchatzDescription:	The mouse can store a macro with max 500 key/button strokes
33*8d2f8479SStefan Achatz		internally.
34*8d2f8479SStefan Achatz		When written, this file lets one set the sequence for a specific
35*8d2f8479SStefan Achatz		button for a specific profile. Button and profile numbers are
36*8d2f8479SStefan Achatz		included in written data. The data has to be 2082 bytes long.
37*8d2f8479SStefan Achatz		This file is writeonly.
38*8d2f8479SStefan AchatzUsers:		http://roccat.sourceforge.net
39*8d2f8479SStefan Achatz
40*8d2f8479SStefan AchatzWhat:		/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/konepure/roccatkonepure<minor>/profile_buttons
41*8d2f8479SStefan AchatzDate:		December 2012
42*8d2f8479SStefan AchatzContact:	Stefan Achatz <erazor_de@users.sourceforge.net>
43*8d2f8479SStefan AchatzDescription:	The mouse can store 5 profiles which can be switched by the
44*8d2f8479SStefan Achatz		press of a button. A profile is split in settings and buttons.
45*8d2f8479SStefan Achatz		profile_buttons holds information about button layout.
46*8d2f8479SStefan Achatz		When written, this file lets one write the respective profile
47*8d2f8479SStefan Achatz		buttons back to the mouse. The data has to be 59 bytes long.
48*8d2f8479SStefan Achatz		The mouse will reject invalid data.
49*8d2f8479SStefan Achatz		Which profile to write is determined by the profile number
50*8d2f8479SStefan Achatz		contained in the data.
51*8d2f8479SStefan Achatz		Before reading this file, control has to be written to select
52*8d2f8479SStefan Achatz		which profile to read.
53*8d2f8479SStefan AchatzUsers:		http://roccat.sourceforge.net
54*8d2f8479SStefan Achatz
55*8d2f8479SStefan AchatzWhat:		/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/konepure/roccatkonepure<minor>/profile_settings
56*8d2f8479SStefan AchatzDate:		December 2012
57*8d2f8479SStefan AchatzContact:	Stefan Achatz <erazor_de@users.sourceforge.net>
58*8d2f8479SStefan AchatzDescription:	The mouse can store 5 profiles which can be switched by the
59*8d2f8479SStefan Achatz		press of a button. A profile is split in settings and buttons.
60*8d2f8479SStefan Achatz		profile_settings holds information like resolution, sensitivity
61*8d2f8479SStefan Achatz		and light effects.
62*8d2f8479SStefan Achatz		When written, this file lets one write the respective profile
63*8d2f8479SStefan Achatz		settings back to the mouse. The data has to be 31 bytes long.
64*8d2f8479SStefan Achatz		The mouse will reject invalid data.
65*8d2f8479SStefan Achatz		Which profile to write is determined by the profile number
66*8d2f8479SStefan Achatz		contained in the data.
67*8d2f8479SStefan Achatz		Before reading this file, control has to be written to select
68*8d2f8479SStefan Achatz		which profile to read.
69*8d2f8479SStefan AchatzUsers:		http://roccat.sourceforge.net
70*8d2f8479SStefan Achatz
71*8d2f8479SStefan AchatzWhat:		/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/konepure/roccatkonepure<minor>/sensor
72*8d2f8479SStefan AchatzDate:		December 2012
73*8d2f8479SStefan AchatzContact:	Stefan Achatz <erazor_de@users.sourceforge.net>
74*8d2f8479SStefan AchatzDescription:	The mouse has a tracking- and a distance-control-unit. These
75*8d2f8479SStefan Achatz		can be activated/deactivated and the lift-off distance can be
76*8d2f8479SStefan Achatz		set. The data has to be 6 bytes long.
77*8d2f8479SStefan Achatz		This file is writeonly.
78*8d2f8479SStefan AchatzUsers:		http://roccat.sourceforge.net
79*8d2f8479SStefan Achatz
80*8d2f8479SStefan AchatzWhat:		/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/konepure/roccatkonepure<minor>/talk
81*8d2f8479SStefan AchatzDate:		December 2012
82*8d2f8479SStefan AchatzContact:	Stefan Achatz <erazor_de@users.sourceforge.net>
83*8d2f8479SStefan AchatzDescription:	Used to active some easy* functions of the mouse from outside.
84*8d2f8479SStefan Achatz		The data has to be 16 bytes long.
85*8d2f8479SStefan Achatz		This file is writeonly.
86*8d2f8479SStefan AchatzUsers:		http://roccat.sourceforge.net
87*8d2f8479SStefan Achatz
88*8d2f8479SStefan AchatzWhat:		/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/konepure/roccatkonepure<minor>/tcu
89*8d2f8479SStefan AchatzDate:		December 2012
90*8d2f8479SStefan AchatzContact:	Stefan Achatz <erazor_de@users.sourceforge.net>
91*8d2f8479SStefan AchatzDescription:	When written a calibration process for the tracking control unit
92*8d2f8479SStefan Achatz		can be initiated/cancelled. Also lets one read/write sensor
93*8d2f8479SStefan Achatz		registers.
94*8d2f8479SStefan Achatz		The data has to be 4 bytes long.
95*8d2f8479SStefan AchatzUsers:		http://roccat.sourceforge.net
96*8d2f8479SStefan Achatz
97*8d2f8479SStefan AchatzWhat:		/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/konepure/roccatkonepure<minor>/tcu_image
98*8d2f8479SStefan AchatzDate:		December 2012
99*8d2f8479SStefan AchatzContact:	Stefan Achatz <erazor_de@users.sourceforge.net>
100*8d2f8479SStefan AchatzDescription:	When read the mouse returns a 30x30 pixel image of the
101*8d2f8479SStefan Achatz		sampled underground. This works only in the course of a
102*8d2f8479SStefan Achatz		calibration process initiated with tcu.
103*8d2f8479SStefan Achatz		The returned data is 1028 bytes in size.
104*8d2f8479SStefan Achatz		This file is readonly.
105*8d2f8479SStefan AchatzUsers:		http://roccat.sourceforge.net
106