| lists.openwall.net | lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC | |
|
Open Source and information security mailing list archives
| ||
|
Date: Mon, 22 Feb 2010 19:42:04 +0100 From: Stefan Achatz <erazor_de@...rs.sourceforge.net> To: Jiri Kosina <jkosina@...e.cz> Cc: Dmitry Torokhov <dmitry.torokhov@...il.com>, Jussi Kivilinna <jussi.kivilinna@...et.fi>, wylda@...ny.cz, Pavel Machek <pavel@...e.cz>, Alessandro Guido <ag@...ssandroguido.name>, Tomas Hanak <tomas.hanak@...il.com>, Jason Noble <nobleja@...ezero.com>, simon.windows@...il.com, Sean Hildebrand <silverwraithii@...il.com>, Sid Boyce <sboyce@...eyonder.co.uk>, Henning Glawe <glaweh@...ian.org>, linux-input@...r.kernel.org, linux-kernel@...r.kernel.org Subject: [PATCH 3/3] Adding documentation to sysfs attributes of roccat kone driver This patch adds documentation to sysfs attributes introduced by roccat kone mouse driver. The attributes are used by userland software already released by me under http://sourceforge.net/projects/roccat/ Didn't know if sysfs-driver-hid-roccat-kone or sysfs-driver-usb-roccat-kone is the right filename, since the sysfs files are in bus/usb path. I refused to split the What-lines to keep lines under 80 chars. Signed-off-by: Stefan Achatz <erazor_de@...rs.sourceforge.net> --- .../ABI/testing/sysfs-driver-hid-roccat-kone | 108 ++++++++++++++++++++ 1 files changed, 108 insertions(+), 0 deletions(-) create mode 100644 Documentation/ABI/testing/sysfs-driver-hid-roccat-kone diff --git a/Documentation/ABI/testing/sysfs-driver-hid-roccat-kone b/Documentation/ABI/testing/sysfs-driver-hid-roccat-kone new file mode 100644 index 0000000..0bf1589 --- /dev/null +++ b/Documentation/ABI/testing/sysfs-driver-hid-roccat-kone @@ -0,0 +1,108 @@ +What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/actual_dpi +Date: February 2010 +Contact: Stefan Achatz <erazor_de@...rs.sourceforge.net> +Description: It is possible to switch the dpi setting of the mouse with the + press of a button. + When read, this file returns the raw number of the actual dpi + setting of the mouse. This number has to be further processed + to receive the real dpi value. + + VALUE DPI + 1 800 + 2 1200 + 3 1600 + 4 2000 + 5 2400 + 6 3200 + + This file is readonly. + +What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/actual_profile +Date: February 2010 +Contact: Stefan Achatz <erazor_de@...rs.sourceforge.net> +Description: When read, this file returns the number of the actual profile. + This file is readonly. + +What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/firmware_version +Date: February 2010 +Contact: Stefan Achatz <erazor_de@...rs.sourceforge.net> +Description: When read, this file returns the raw version number of the + firmware stored in the mouse. Using the integer value eases + further usage in other programs. To receive the real version + number the decimal point has to be shifted 2 positions to the + left. E.g. a returned value of 138 means 1.38 + This file is readonly. + +What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/kone_driver_version +Date: February 2010 +Contact: Stefan Achatz <erazor_de@...rs.sourceforge.net> +Description: When read, this file returns the driver version. + The format of the string is "v<major>.<minor>.<patchlevel>". + This filename is used by the userland tools to find the + sys-paths of installed kone-mice. Versions of this driver for + old kernels replace usbhid instead of generic-usb. The way to + scan for this file has been chosen to provide a consistent way + for all supported kernel versions. + The version number is used to determine the drivers abilities. + This file is readonly. + +What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/profile[1-5] +Date: February 2010 +Contact: Stefan Achatz <erazor_de@...rs.sourceforge.net> +Description: The mouse can store 5 profiles which can be switched by the + press of a button. A profile holds informations like button + mappings, sensitivity, the colors of the 5 leds and light + effects. + When read, these files return the respective profile. The + returned data is 975 bytes in size. + When written, this file lets one write the respective profile + data back to the mouse. The data has to be 975 bytes long. The + checksum and correct profile number will be set by the driver. + The mouse will reject invalid data. + +What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/settings +Date: February 2010 +Contact: Stefan Achatz <erazor_de@...rs.sourceforge.net> +Description: When read, this file returns the settings stored in the mouse. + The size of the data is 36 bytes and holds information like the + startup_profile, tcu state and calibration_data. + When written, this file lets write settings back to the mouse. + The data has to be 36 bytes long, the checksum will be + calculated by the driver. The mouse will reject invalid data. + +What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/startup_profile +Date: February 2010 +Contact: Stefan Achatz <erazor_de@...rs.sourceforge.net> +Description: When read, this file returns the number of the profile thats + active when the mouse is powered on. + This file is readonly. + +What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/tcu +Date: February 2010 +Contact: Stefan Achatz <erazor_de@...rs.sourceforge.net> +Description: The mouse has a "Tracking Control Unit" which lets the user + calibrate the laser power to the mousepad surface. + When read, this file returns the current state of the TCU, + where 0 means off and 1 means on. + Writing 0 in this file will switch the TCU off. + Writing 1 in this file will start the calibration which takes + around 6 seconds to complete and activates the TCU. + +What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/weight +Date: February 2010 +Contact: Stefan Achatz <erazor_de@...rs.sourceforge.net> +Description: The mouse can be equipped with one of four supplied weights + ranging from 5 to 20 grams which are recognized by the mouse + and its value can be read out. When read, this file returns the + raw value returned by the mouse which eases further processing + in other software. + The values map to the weights as follows: + + VALUE WEIGHT + 0 none + 1 5g + 2 10g + 3 15g + 4 20g + + This file is readonly. -- 1.6.6 -- To unsubscribe from this list: send the line "unsubscribe linux-kernel" in the body of a message to majordomo@...r.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html Please read the FAQ at http://www.tux.org/lkml/
Powered by blists - more mailing lists