From patchwork Mon Feb 22 18:42:04 2010 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stefan Achatz X-Patchwork-Id: 81245 Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by demeter.kernel.org (8.14.3/8.14.3) with ESMTP id o1MIhBc6021447 for ; Mon, 22 Feb 2010 18:43:11 GMT Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1754288Ab0BVSmP (ORCPT ); Mon, 22 Feb 2010 13:42:15 -0500 Received: from mail-in-17.arcor-online.net ([151.189.21.57]:33443 "EHLO mail-in-17.arcor-online.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1754018Ab0BVSmM (ORCPT ); Mon, 22 Feb 2010 13:42:12 -0500 Received: from mail-in-20-z2.arcor-online.net (mail-in-20-z2.arcor-online.net [151.189.8.85]) by mx.arcor.de (Postfix) with ESMTP id 0F85F3B28A0; Mon, 22 Feb 2010 19:42:11 +0100 (CET) Received: from mail-in-15.arcor-online.net (mail-in-15.arcor-online.net [151.189.21.55]) by mail-in-20-z2.arcor-online.net (Postfix) with ESMTP id C7F1610846F; Mon, 22 Feb 2010 19:42:10 +0100 (CET) Received: from neuromancer.tessier-ashpool (dslb-092-078-028-039.pools.arcor-ip.net [92.78.28.39]) (Authenticated sender: screamingfist@arcor.de) by mail-in-15.arcor-online.net (Postfix) with ESMTPSA id 42EE3356AA6; Mon, 22 Feb 2010 19:42:06 +0100 (CET) X-DKIM: Sendmail DKIM Filter v2.8.2 mail-in-15.arcor-online.net 42EE3356AA6 From: Stefan Achatz To: Jiri Kosina Subject: [PATCH 3/3] Adding documentation to sysfs attributes of roccat kone driver Date: Mon, 22 Feb 2010 19:42:04 +0100 User-Agent: KMail/1.9.9 Cc: Dmitry Torokhov , Jussi Kivilinna , wylda@volny.cz, Pavel Machek , Alessandro Guido , Tomas Hanak , Jason Noble , simon.windows@gmail.com, Sean Hildebrand , Sid Boyce , Henning Glawe , linux-input@vger.kernel.org, linux-kernel@vger.kernel.org References: <201002200911.53900.stefan_achatz@web.de> <20100222062916.GA2095@core.coreip.homeip.net> In-Reply-To: MIME-Version: 1.0 Content-Disposition: inline Message-Id: <201002221942.04624.erazor_de@users.sourceforge.net> Sender: linux-input-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-input@vger.kernel.org X-Greylist: IP, sender and recipient auto-whitelisted, not delayed by milter-greylist-4.2.3 (demeter.kernel.org [140.211.167.41]); Mon, 22 Feb 2010 18:43:11 +0000 (UTC) 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/-:./actual_dpi +Date: February 2010 +Contact: Stefan Achatz +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/-:./actual_profile +Date: February 2010 +Contact: Stefan Achatz +Description: When read, this file returns the number of the actual profile. + This file is readonly. + +What: /sys/bus/usb/devices/-:./firmware_version +Date: February 2010 +Contact: Stefan Achatz +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/-:./kone_driver_version +Date: February 2010 +Contact: Stefan Achatz +Description: When read, this file returns the driver version. + The format of the string is "v..". + 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/-:./profile[1-5] +Date: February 2010 +Contact: Stefan Achatz +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/-:./settings +Date: February 2010 +Contact: Stefan Achatz +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/-:./startup_profile +Date: February 2010 +Contact: Stefan Achatz +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/-:./tcu +Date: February 2010 +Contact: Stefan Achatz +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/-:./weight +Date: February 2010 +Contact: Stefan Achatz +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