1 files changed, 105 insertions, 0 deletions
diff --git a/Documentation/ABI/testing/sysfs-driver-hid-roccat-konepure b/Documentation/ABI/testing/sysfs-driver-hid-roccat-konepure
new file mode 100644
index 000000000000..41a9b7fbfc79
--- /dev/null
+++ b/Documentation/ABI/testing/sysfs-driver-hid-roccat-konepure
@@ -0,0 +1,105 @@
+What:           /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/konepure/roccatkonepure<minor>/actual_profile
+Date:           December 2012
+Contact:        Stefan Achatz <erazor_de@users.sourceforge.net>
+Description:    The mouse can store 5 profiles which can be switched by the
+                press of a button. actual_profile holds number of actual profile.
+                This value is persistent, so its value determines the profile
+                that's active when the mouse is powered on next time.
+                When written, the mouse activates the set profile immediately.
+                The data has to be 3 bytes long.
+                The mouse will reject invalid data.
+Users:          http://roccat.sourceforge.net
+What:           /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/konepure/roccatkonepure<minor>/control
+Date:           December 2012
+Contact:        Stefan Achatz <erazor_de@users.sourceforge.net>
+Description:    When written, this file lets one select which data from which
+                profile will be read next. The data has to be 3 bytes long.
+                This file is writeonly.
+Users:          http://roccat.sourceforge.net
+What:           /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/konepure/roccatkonepure<minor>/info
+Date:           December 2012
+Contact:        Stefan Achatz <erazor_de@users.sourceforge.net>
+Description:    When read, this file returns general data like firmware version.
+                When written, the device can be reset.
+                The data is 6 bytes long.
+Users:          http://roccat.sourceforge.net
+What:           /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/konepure/roccatkonepure<minor>/macro
+Date:           December 2012
+Contact:        Stefan Achatz <erazor_de@users.sourceforge.net>
+Description:    The mouse can store a macro with max 500 key/button strokes
+                internally.
+                When written, this file lets one set the sequence for a specific
+                button for a specific profile. Button and profile numbers are
+                included in written data. The data has to be 2082 bytes long.
+                This file is writeonly.
+Users:          http://roccat.sourceforge.net
+What:           /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/konepure/roccatkonepure<minor>/profile_buttons
+Date:           December 2012
+Contact:        Stefan Achatz <erazor_de@users.sourceforge.net>
+Description:    The mouse can store 5 profiles which can be switched by the
+                press of a button. A profile is split in settings and buttons.
+                profile_buttons holds information about button layout.
+                When written, this file lets one write the respective profile
+                buttons back to the mouse. The data has to be 59 bytes long.
+                The mouse will reject invalid data.
+                Which profile to write is determined by the profile number
+                contained in the data.
+                Before reading this file, control has to be written to select
+                which profile to read.
+Users:          http://roccat.sourceforge.net
+What:           /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/konepure/roccatkonepure<minor>/profile_settings
+Date:           December 2012
+Contact:        Stefan Achatz <erazor_de@users.sourceforge.net>
+Description:    The mouse can store 5 profiles which can be switched by the
+                press of a button. A profile is split in settings and buttons.
+                profile_settings holds information like resolution, sensitivity
+                and light effects.
+                When written, this file lets one write the respective profile
+                settings back to the mouse. The data has to be 31 bytes long.
+                The mouse will reject invalid data.
+                Which profile to write is determined by the profile number
+                contained in the data.
+                Before reading this file, control has to be written to select
+                which profile to read.
+Users:          http://roccat.sourceforge.net
+What:           /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/konepure/roccatkonepure<minor>/sensor
+Date:           December 2012
+Contact:        Stefan Achatz <erazor_de@users.sourceforge.net>
+Description:    The mouse has a tracking- and a distance-control-unit. These
+                can be activated/deactivated and the lift-off distance can be
+                set. The data has to be 6 bytes long.
+                This file is writeonly.
+Users:          http://roccat.sourceforge.net
+What:           /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/konepure/roccatkonepure<minor>/talk
+Date:           December 2012
+Contact:        Stefan Achatz <erazor_de@users.sourceforge.net>
+Description:    Used to active some easy* functions of the mouse from outside.
+                The data has to be 16 bytes long.
+                This file is writeonly.
+Users:          http://roccat.sourceforge.net
+What:           /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/konepure/roccatkonepure<minor>/tcu
+Date:           December 2012
+Contact:        Stefan Achatz <erazor_de@users.sourceforge.net>
+Description:    When written a calibration process for the tracking control unit
+                can be initiated/cancelled. Also lets one read/write sensor
+                registers.
+                The data has to be 4 bytes long.
+Users:          http://roccat.sourceforge.net
+What:           /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/konepure/roccatkonepure<minor>/tcu_image
+Date:           December 2012
+Contact:        Stefan Achatz <erazor_de@users.sourceforge.net>
+Description:    When read the mouse returns a 30x30 pixel image of the
+                sampled underground. This works only in the course of a
+                calibration process initiated with tcu.
+                The returned data is 1028 bytes in size.
+                This file is readonly.
+Users:          http://roccat.sourceforge.net

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