diff options
Diffstat (limited to 'Documentation/ABI')
-rw-r--r-- | Documentation/ABI/stable/sysfs-firmware-efi-vars | 75 | ||||
-rw-r--r-- | Documentation/ABI/testing/pstore | 35 | ||||
-rw-r--r-- | Documentation/ABI/testing/sysfs-devices-power | 20 | ||||
-rw-r--r-- | Documentation/ABI/testing/sysfs-driver-hid | 10 | ||||
-rw-r--r-- | Documentation/ABI/testing/sysfs-driver-hid-roccat-arvo | 53 | ||||
-rw-r--r-- | Documentation/ABI/testing/sysfs-driver-hid-roccat-kone | 8 | ||||
-rw-r--r-- | Documentation/ABI/testing/sysfs-driver-hid-roccat-koneplus | 11 | ||||
-rw-r--r-- | Documentation/ABI/testing/sysfs-driver-hid-roccat-kovaplus | 100 | ||||
-rw-r--r-- | Documentation/ABI/testing/sysfs-driver-hid-roccat-pyra | 9 | ||||
-rw-r--r-- | Documentation/ABI/testing/sysfs-firmware-dmi | 110 | ||||
-rw-r--r-- | Documentation/ABI/testing/sysfs-fs-pstore | 7 | ||||
-rw-r--r-- | Documentation/ABI/testing/sysfs-platform-kim | 48 |
12 files changed, 476 insertions, 10 deletions
diff --git a/Documentation/ABI/stable/sysfs-firmware-efi-vars b/Documentation/ABI/stable/sysfs-firmware-efi-vars new file mode 100644 index 000000000000..5def20b9019e --- /dev/null +++ b/Documentation/ABI/stable/sysfs-firmware-efi-vars | |||
@@ -0,0 +1,75 @@ | |||
1 | What: /sys/firmware/efi/vars | ||
2 | Date: April 2004 | ||
3 | Contact: Matt Domsch <Matt_Domsch@dell.com> | ||
4 | Description: | ||
5 | This directory exposes interfaces for interactive with | ||
6 | EFI variables. For more information on EFI variables, | ||
7 | see 'Variable Services' in the UEFI specification | ||
8 | (section 7.2 in specification version 2.3 Errata D). | ||
9 | |||
10 | In summary, EFI variables are named, and are classified | ||
11 | into separate namespaces through the use of a vendor | ||
12 | GUID. They also have an arbitrary binary value | ||
13 | associated with them. | ||
14 | |||
15 | The efivars module enumerates these variables and | ||
16 | creates a separate directory for each one found. Each | ||
17 | directory has a name of the form "<key>-<vendor guid>" | ||
18 | and contains the following files: | ||
19 | |||
20 | attributes: A read-only text file enumerating the | ||
21 | EFI variable flags. Potential values | ||
22 | include: | ||
23 | |||
24 | EFI_VARIABLE_NON_VOLATILE | ||
25 | EFI_VARIABLE_BOOTSERVICE_ACCESS | ||
26 | EFI_VARIABLE_RUNTIME_ACCESS | ||
27 | EFI_VARIABLE_HARDWARE_ERROR_RECORD | ||
28 | EFI_VARIABLE_AUTHENTICATED_WRITE_ACCESS | ||
29 | |||
30 | See the EFI documentation for an | ||
31 | explanation of each of these variables. | ||
32 | |||
33 | data: A read-only binary file that can be read | ||
34 | to attain the value of the EFI variable | ||
35 | |||
36 | guid: The vendor GUID of the variable. This | ||
37 | should always match the GUID in the | ||
38 | variable's name. | ||
39 | |||
40 | raw_var: A binary file that can be read to obtain | ||
41 | a structure that contains everything | ||
42 | there is to know about the variable. | ||
43 | For structure definition see "struct | ||
44 | efi_variable" in the kernel sources. | ||
45 | |||
46 | This file can also be written to in | ||
47 | order to update the value of a variable. | ||
48 | For this to work however, all fields of | ||
49 | the "struct efi_variable" passed must | ||
50 | match byte for byte with the structure | ||
51 | read out of the file, save for the value | ||
52 | portion. | ||
53 | |||
54 | **Note** the efi_variable structure | ||
55 | read/written with this file contains a | ||
56 | 'long' type that may change widths | ||
57 | depending on your underlying | ||
58 | architecture. | ||
59 | |||
60 | size: As ASCII representation of the size of | ||
61 | the variable's value. | ||
62 | |||
63 | |||
64 | In addition, two other magic binary files are provided | ||
65 | in the top-level directory and are used for adding and | ||
66 | removing variables: | ||
67 | |||
68 | new_var: Takes a "struct efi_variable" and | ||
69 | instructs the EFI firmware to create a | ||
70 | new variable. | ||
71 | |||
72 | del_var: Takes a "struct efi_variable" and | ||
73 | instructs the EFI firmware to remove any | ||
74 | variable that has a matching vendor GUID | ||
75 | and variable key name. | ||
diff --git a/Documentation/ABI/testing/pstore b/Documentation/ABI/testing/pstore new file mode 100644 index 000000000000..f1fb2a004264 --- /dev/null +++ b/Documentation/ABI/testing/pstore | |||
@@ -0,0 +1,35 @@ | |||
1 | Where: /dev/pstore/... | ||
2 | Date: January 2011 | ||
3 | Kernel Version: 2.6.38 | ||
4 | Contact: tony.luck@intel.com | ||
5 | Description: Generic interface to platform dependent persistent storage. | ||
6 | |||
7 | Platforms that provide a mechanism to preserve some data | ||
8 | across system reboots can register with this driver to | ||
9 | provide a generic interface to show records captured in | ||
10 | the dying moments. In the case of a panic the last part | ||
11 | of the console log is captured, but other interesting | ||
12 | data can also be saved. | ||
13 | |||
14 | # mount -t pstore - /dev/pstore | ||
15 | |||
16 | $ ls -l /dev/pstore | ||
17 | total 0 | ||
18 | -r--r--r-- 1 root root 7896 Nov 30 15:38 dmesg-erst-1 | ||
19 | |||
20 | Different users of this interface will result in different | ||
21 | filename prefixes. Currently two are defined: | ||
22 | |||
23 | "dmesg" - saved console log | ||
24 | "mce" - architecture dependent data from fatal h/w error | ||
25 | |||
26 | Once the information in a file has been read, removing | ||
27 | the file will signal to the underlying persistent storage | ||
28 | device that it can reclaim the space for later re-use. | ||
29 | |||
30 | $ rm /dev/pstore/dmesg-erst-1 | ||
31 | |||
32 | The expectation is that all files in /dev/pstore | ||
33 | will be saved elsewhere and erased from persistent store | ||
34 | soon after boot to free up space ready for the next | ||
35 | catastrophe. | ||
diff --git a/Documentation/ABI/testing/sysfs-devices-power b/Documentation/ABI/testing/sysfs-devices-power index 7628cd1bc36a..8ffbc25376a0 100644 --- a/Documentation/ABI/testing/sysfs-devices-power +++ b/Documentation/ABI/testing/sysfs-devices-power | |||
@@ -29,9 +29,8 @@ Description: | |||
29 | "disabled" to it. | 29 | "disabled" to it. |
30 | 30 | ||
31 | For the devices that are not capable of generating system wakeup | 31 | For the devices that are not capable of generating system wakeup |
32 | events this file contains "\n". In that cases the user space | 32 | events this file is not present. In that case the device cannot |
33 | cannot modify the contents of this file and the device cannot be | 33 | be enabled to wake up the system from sleep states. |
34 | enabled to wake up the system. | ||
35 | 34 | ||
36 | What: /sys/devices/.../power/control | 35 | What: /sys/devices/.../power/control |
37 | Date: January 2009 | 36 | Date: January 2009 |
@@ -85,7 +84,7 @@ Description: | |||
85 | The /sys/devices/.../wakeup_count attribute contains the number | 84 | The /sys/devices/.../wakeup_count attribute contains the number |
86 | of signaled wakeup events associated with the device. This | 85 | of signaled wakeup events associated with the device. This |
87 | attribute is read-only. If the device is not enabled to wake up | 86 | attribute is read-only. If the device is not enabled to wake up |
88 | the system from sleep states, this attribute is empty. | 87 | the system from sleep states, this attribute is not present. |
89 | 88 | ||
90 | What: /sys/devices/.../power/wakeup_active_count | 89 | What: /sys/devices/.../power/wakeup_active_count |
91 | Date: September 2010 | 90 | Date: September 2010 |
@@ -95,7 +94,7 @@ Description: | |||
95 | number of times the processing of wakeup events associated with | 94 | number of times the processing of wakeup events associated with |
96 | the device was completed (at the kernel level). This attribute | 95 | the device was completed (at the kernel level). This attribute |
97 | is read-only. If the device is not enabled to wake up the | 96 | is read-only. If the device is not enabled to wake up the |
98 | system from sleep states, this attribute is empty. | 97 | system from sleep states, this attribute is not present. |
99 | 98 | ||
100 | What: /sys/devices/.../power/wakeup_hit_count | 99 | What: /sys/devices/.../power/wakeup_hit_count |
101 | Date: September 2010 | 100 | Date: September 2010 |
@@ -105,7 +104,8 @@ Description: | |||
105 | number of times the processing of a wakeup event associated with | 104 | number of times the processing of a wakeup event associated with |
106 | the device might prevent the system from entering a sleep state. | 105 | the device might prevent the system from entering a sleep state. |
107 | This attribute is read-only. If the device is not enabled to | 106 | This attribute is read-only. If the device is not enabled to |
108 | wake up the system from sleep states, this attribute is empty. | 107 | wake up the system from sleep states, this attribute is not |
108 | present. | ||
109 | 109 | ||
110 | What: /sys/devices/.../power/wakeup_active | 110 | What: /sys/devices/.../power/wakeup_active |
111 | Date: September 2010 | 111 | Date: September 2010 |
@@ -115,7 +115,7 @@ Description: | |||
115 | or 0, depending on whether or not a wakeup event associated with | 115 | or 0, depending on whether or not a wakeup event associated with |
116 | the device is being processed (1). This attribute is read-only. | 116 | the device is being processed (1). This attribute is read-only. |
117 | If the device is not enabled to wake up the system from sleep | 117 | If the device is not enabled to wake up the system from sleep |
118 | states, this attribute is empty. | 118 | states, this attribute is not present. |
119 | 119 | ||
120 | What: /sys/devices/.../power/wakeup_total_time_ms | 120 | What: /sys/devices/.../power/wakeup_total_time_ms |
121 | Date: September 2010 | 121 | Date: September 2010 |
@@ -125,7 +125,7 @@ Description: | |||
125 | the total time of processing wakeup events associated with the | 125 | the total time of processing wakeup events associated with the |
126 | device, in milliseconds. This attribute is read-only. If the | 126 | device, in milliseconds. This attribute is read-only. If the |
127 | device is not enabled to wake up the system from sleep states, | 127 | device is not enabled to wake up the system from sleep states, |
128 | this attribute is empty. | 128 | this attribute is not present. |
129 | 129 | ||
130 | What: /sys/devices/.../power/wakeup_max_time_ms | 130 | What: /sys/devices/.../power/wakeup_max_time_ms |
131 | Date: September 2010 | 131 | Date: September 2010 |
@@ -135,7 +135,7 @@ Description: | |||
135 | the maximum time of processing a single wakeup event associated | 135 | the maximum time of processing a single wakeup event associated |
136 | with the device, in milliseconds. This attribute is read-only. | 136 | with the device, in milliseconds. This attribute is read-only. |
137 | If the device is not enabled to wake up the system from sleep | 137 | If the device is not enabled to wake up the system from sleep |
138 | states, this attribute is empty. | 138 | states, this attribute is not present. |
139 | 139 | ||
140 | What: /sys/devices/.../power/wakeup_last_time_ms | 140 | What: /sys/devices/.../power/wakeup_last_time_ms |
141 | Date: September 2010 | 141 | Date: September 2010 |
@@ -146,7 +146,7 @@ Description: | |||
146 | signaling the last wakeup event associated with the device, in | 146 | signaling the last wakeup event associated with the device, in |
147 | milliseconds. This attribute is read-only. If the device is | 147 | milliseconds. This attribute is read-only. If the device is |
148 | not enabled to wake up the system from sleep states, this | 148 | not enabled to wake up the system from sleep states, this |
149 | attribute is empty. | 149 | attribute is not present. |
150 | 150 | ||
151 | What: /sys/devices/.../power/autosuspend_delay_ms | 151 | What: /sys/devices/.../power/autosuspend_delay_ms |
152 | Date: September 2010 | 152 | Date: September 2010 |
diff --git a/Documentation/ABI/testing/sysfs-driver-hid b/Documentation/ABI/testing/sysfs-driver-hid new file mode 100644 index 000000000000..b6490e14fe83 --- /dev/null +++ b/Documentation/ABI/testing/sysfs-driver-hid | |||
@@ -0,0 +1,10 @@ | |||
1 | What: For USB devices : /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/report_descriptor | ||
2 | For BT devices : /sys/class/bluetooth/hci<addr>/<hid-bus>:<vendor-id>:<product-id>.<num>/report_descriptor | ||
3 | Symlink : /sys/class/hidraw/hidraw<num>/device/report_descriptor | ||
4 | Date: Jan 2011 | ||
5 | KernelVersion: 2.0.39 | ||
6 | Contact: Alan Ott <alan@signal11.us> | ||
7 | Description: When read, this file returns the device's raw binary HID | ||
8 | report descriptor. | ||
9 | This file cannot be written. | ||
10 | Users: HIDAPI library (http://www.signal11.us/oss/hidapi) | ||
diff --git a/Documentation/ABI/testing/sysfs-driver-hid-roccat-arvo b/Documentation/ABI/testing/sysfs-driver-hid-roccat-arvo new file mode 100644 index 000000000000..55e281b0071a --- /dev/null +++ b/Documentation/ABI/testing/sysfs-driver-hid-roccat-arvo | |||
@@ -0,0 +1,53 @@ | |||
1 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/arvo/roccatarvo<minor>/actual_profile | ||
2 | Date: Januar 2011 | ||
3 | Contact: Stefan Achatz <erazor_de@users.sourceforge.net> | ||
4 | Description: The integer value of this attribute ranges from 1-5. | ||
5 | When read, this attribute returns the number of the actual | ||
6 | profile which is also the profile that's active on device startup. | ||
7 | When written this attribute activates the selected profile | ||
8 | immediately. | ||
9 | Users: http://roccat.sourceforge.net | ||
10 | |||
11 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/arvo/roccatarvo<minor>/button | ||
12 | Date: Januar 2011 | ||
13 | Contact: Stefan Achatz <erazor_de@users.sourceforge.net> | ||
14 | Description: The keyboard can store short macros with consist of 1 button with | ||
15 | several modifier keys internally. | ||
16 | When written, this file lets one set the sequence for a specific | ||
17 | button for a specific profile. Button and profile numbers are | ||
18 | included in written data. The data has to be 24 bytes long. | ||
19 | This file is writeonly. | ||
20 | Users: http://roccat.sourceforge.net | ||
21 | |||
22 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/arvo/roccatarvo<minor>/info | ||
23 | Date: Januar 2011 | ||
24 | Contact: Stefan Achatz <erazor_de@users.sourceforge.net> | ||
25 | Description: When read, this file returns some info about the device like the | ||
26 | installed firmware version. | ||
27 | The size of the data is 8 bytes in size. | ||
28 | This file is readonly. | ||
29 | Users: http://roccat.sourceforge.net | ||
30 | |||
31 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/arvo/roccatarvo<minor>/key_mask | ||
32 | Date: Januar 2011 | ||
33 | Contact: Stefan Achatz <erazor_de@users.sourceforge.net> | ||
34 | Description: The keyboard lets the user deactivate 5 certain keys like the | ||
35 | windows and application keys, to protect the user from the outcome | ||
36 | of accidentally pressing them. | ||
37 | The integer value of this attribute has bits 0-4 set depending | ||
38 | on the state of the corresponding key. | ||
39 | When read, this file returns the current state of the buttons. | ||
40 | When written, the given buttons are activated/deactivated | ||
41 | immediately. | ||
42 | Users: http://roccat.sourceforge.net | ||
43 | |||
44 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/arvo/roccatarvo<minor>/mode_key | ||
45 | Date: Januar 2011 | ||
46 | Contact: Stefan Achatz <erazor_de@users.sourceforge.net> | ||
47 | Description: The keyboard has a condensed layout without num-lock key. | ||
48 | Instead it uses a mode-key which activates a gaming mode where | ||
49 | the assignment of the number block changes. | ||
50 | The integer value of this attribute ranges from 0 (OFF) to 1 (ON). | ||
51 | When read, this file returns the actual state of the key. | ||
52 | When written, the key is activated/deactivated immediately. | ||
53 | Users: http://roccat.sourceforge.net | ||
diff --git a/Documentation/ABI/testing/sysfs-driver-hid-roccat-kone b/Documentation/ABI/testing/sysfs-driver-hid-roccat-kone index 698b8081c473..b4c4f158ab9c 100644 --- a/Documentation/ABI/testing/sysfs-driver-hid-roccat-kone +++ b/Documentation/ABI/testing/sysfs-driver-hid-roccat-kone | |||
@@ -16,12 +16,14 @@ Description: It is possible to switch the dpi setting of the mouse with the | |||
16 | 6 3200 | 16 | 6 3200 |
17 | 17 | ||
18 | This file is readonly. | 18 | This file is readonly. |
19 | Users: http://roccat.sourceforge.net | ||
19 | 20 | ||
20 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/kone/roccatkone<minor>/actual_profile | 21 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/kone/roccatkone<minor>/actual_profile |
21 | Date: March 2010 | 22 | Date: March 2010 |
22 | Contact: Stefan Achatz <erazor_de@users.sourceforge.net> | 23 | Contact: Stefan Achatz <erazor_de@users.sourceforge.net> |
23 | Description: When read, this file returns the number of the actual profile. | 24 | Description: When read, this file returns the number of the actual profile. |
24 | This file is readonly. | 25 | This file is readonly. |
26 | Users: http://roccat.sourceforge.net | ||
25 | 27 | ||
26 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/kone/roccatkone<minor>/firmware_version | 28 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/kone/roccatkone<minor>/firmware_version |
27 | Date: March 2010 | 29 | Date: March 2010 |
@@ -32,6 +34,7 @@ Description: When read, this file returns the raw integer version number of the | |||
32 | number the decimal point has to be shifted 2 positions to the | 34 | number the decimal point has to be shifted 2 positions to the |
33 | left. E.g. a returned value of 138 means 1.38 | 35 | left. E.g. a returned value of 138 means 1.38 |
34 | This file is readonly. | 36 | This file is readonly. |
37 | Users: http://roccat.sourceforge.net | ||
35 | 38 | ||
36 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/kone/roccatkone<minor>/profile[1-5] | 39 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/kone/roccatkone<minor>/profile[1-5] |
37 | Date: March 2010 | 40 | Date: March 2010 |
@@ -47,6 +50,7 @@ Description: The mouse can store 5 profiles which can be switched by the | |||
47 | The mouse will reject invalid data, whereas the profile number | 50 | The mouse will reject invalid data, whereas the profile number |
48 | stored in the profile doesn't need to fit the number of the | 51 | stored in the profile doesn't need to fit the number of the |
49 | store. | 52 | store. |
53 | Users: http://roccat.sourceforge.net | ||
50 | 54 | ||
51 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/kone/roccatkone<minor>/settings | 55 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/kone/roccatkone<minor>/settings |
52 | Date: March 2010 | 56 | Date: March 2010 |
@@ -57,6 +61,7 @@ Description: When read, this file returns the settings stored in the mouse. | |||
57 | When written, this file lets write settings back to the mouse. | 61 | When written, this file lets write settings back to the mouse. |
58 | The data has to be 36 bytes long. The mouse will reject invalid | 62 | The data has to be 36 bytes long. The mouse will reject invalid |
59 | data. | 63 | data. |
64 | Users: http://roccat.sourceforge.net | ||
60 | 65 | ||
61 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/kone/roccatkone<minor>/startup_profile | 66 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/kone/roccatkone<minor>/startup_profile |
62 | Date: March 2010 | 67 | Date: March 2010 |
@@ -66,6 +71,7 @@ Description: The integer value of this attribute ranges from 1 to 5. | |||
66 | that's active when the mouse is powered on. | 71 | that's active when the mouse is powered on. |
67 | When written, this file sets the number of the startup profile | 72 | When written, this file sets the number of the startup profile |
68 | and the mouse activates this profile immediately. | 73 | and the mouse activates this profile immediately. |
74 | Users: http://roccat.sourceforge.net | ||
69 | 75 | ||
70 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/kone/roccatkone<minor>/tcu | 76 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/kone/roccatkone<minor>/tcu |
71 | Date: March 2010 | 77 | Date: March 2010 |
@@ -77,6 +83,7 @@ Description: The mouse has a "Tracking Control Unit" which lets the user | |||
77 | Writing 0 in this file will switch the TCU off. | 83 | Writing 0 in this file will switch the TCU off. |
78 | Writing 1 in this file will start the calibration which takes | 84 | Writing 1 in this file will start the calibration which takes |
79 | around 6 seconds to complete and activates the TCU. | 85 | around 6 seconds to complete and activates the TCU. |
86 | Users: http://roccat.sourceforge.net | ||
80 | 87 | ||
81 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/kone/roccatkone<minor>/weight | 88 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/kone/roccatkone<minor>/weight |
82 | Date: March 2010 | 89 | Date: March 2010 |
@@ -96,3 +103,4 @@ Description: The mouse can be equipped with one of four supplied weights | |||
96 | 4 20g | 103 | 4 20g |
97 | 104 | ||
98 | This file is readonly. | 105 | This file is readonly. |
106 | Users: http://roccat.sourceforge.net | ||
diff --git a/Documentation/ABI/testing/sysfs-driver-hid-roccat-koneplus b/Documentation/ABI/testing/sysfs-driver-hid-roccat-koneplus index 0f9f30eb1742..00efced73969 100644 --- a/Documentation/ABI/testing/sysfs-driver-hid-roccat-koneplus +++ b/Documentation/ABI/testing/sysfs-driver-hid-roccat-koneplus | |||
@@ -4,6 +4,7 @@ Contact: Stefan Achatz <erazor_de@users.sourceforge.net> | |||
4 | Description: When read, this file returns the number of the actual profile in | 4 | Description: When read, this file returns the number of the actual profile in |
5 | range 0-4. | 5 | range 0-4. |
6 | This file is readonly. | 6 | This file is readonly. |
7 | Users: http://roccat.sourceforge.net | ||
7 | 8 | ||
8 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/koneplus/roccatkoneplus<minor>/firmware_version | 9 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/koneplus/roccatkoneplus<minor>/firmware_version |
9 | Date: October 2010 | 10 | Date: October 2010 |
@@ -14,6 +15,7 @@ Description: When read, this file returns the raw integer version number of the | |||
14 | number the decimal point has to be shifted 2 positions to the | 15 | number the decimal point has to be shifted 2 positions to the |
15 | left. E.g. a returned value of 121 means 1.21 | 16 | left. E.g. a returned value of 121 means 1.21 |
16 | This file is readonly. | 17 | This file is readonly. |
18 | Users: http://roccat.sourceforge.net | ||
17 | 19 | ||
18 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/koneplus/roccatkoneplus<minor>/macro | 20 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/koneplus/roccatkoneplus<minor>/macro |
19 | Date: October 2010 | 21 | Date: October 2010 |
@@ -24,6 +26,7 @@ Description: The mouse can store a macro with max 500 key/button strokes | |||
24 | button for a specific profile. Button and profile numbers are | 26 | button for a specific profile. Button and profile numbers are |
25 | included in written data. The data has to be 2082 bytes long. | 27 | included in written data. The data has to be 2082 bytes long. |
26 | This file is writeonly. | 28 | This file is writeonly. |
29 | Users: http://roccat.sourceforge.net | ||
27 | 30 | ||
28 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/koneplus/roccatkoneplus<minor>/profile_buttons | 31 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/koneplus/roccatkoneplus<minor>/profile_buttons |
29 | Date: August 2010 | 32 | Date: August 2010 |
@@ -37,6 +40,7 @@ Description: The mouse can store 5 profiles which can be switched by the | |||
37 | Which profile to write is determined by the profile number | 40 | Which profile to write is determined by the profile number |
38 | contained in the data. | 41 | contained in the data. |
39 | This file is writeonly. | 42 | This file is writeonly. |
43 | Users: http://roccat.sourceforge.net | ||
40 | 44 | ||
41 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/koneplus/roccatkoneplus<minor>/profile[1-5]_buttons | 45 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/koneplus/roccatkoneplus<minor>/profile[1-5]_buttons |
42 | Date: August 2010 | 46 | Date: August 2010 |
@@ -47,6 +51,7 @@ Description: The mouse can store 5 profiles which can be switched by the | |||
47 | When read, these files return the respective profile buttons. | 51 | When read, these files return the respective profile buttons. |
48 | The returned data is 77 bytes in size. | 52 | The returned data is 77 bytes in size. |
49 | This file is readonly. | 53 | This file is readonly. |
54 | Users: http://roccat.sourceforge.net | ||
50 | 55 | ||
51 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/koneplus/roccatkoneplus<minor>/profile_settings | 56 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/koneplus/roccatkoneplus<minor>/profile_settings |
52 | Date: October 2010 | 57 | Date: October 2010 |
@@ -61,6 +66,7 @@ Description: The mouse can store 5 profiles which can be switched by the | |||
61 | Which profile to write is determined by the profile number | 66 | Which profile to write is determined by the profile number |
62 | contained in the data. | 67 | contained in the data. |
63 | This file is writeonly. | 68 | This file is writeonly. |
69 | Users: http://roccat.sourceforge.net | ||
64 | 70 | ||
65 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/koneplus/roccatkoneplus<minor>/profile[1-5]_settings | 71 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/koneplus/roccatkoneplus<minor>/profile[1-5]_settings |
66 | Date: August 2010 | 72 | Date: August 2010 |
@@ -72,6 +78,7 @@ Description: The mouse can store 5 profiles which can be switched by the | |||
72 | When read, these files return the respective profile settings. | 78 | When read, these files return the respective profile settings. |
73 | The returned data is 43 bytes in size. | 79 | The returned data is 43 bytes in size. |
74 | This file is readonly. | 80 | This file is readonly. |
81 | Users: http://roccat.sourceforge.net | ||
75 | 82 | ||
76 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/koneplus/roccatkoneplus<minor>/sensor | 83 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/koneplus/roccatkoneplus<minor>/sensor |
77 | Date: October 2010 | 84 | Date: October 2010 |
@@ -80,6 +87,7 @@ Description: The mouse has a tracking- and a distance-control-unit. These | |||
80 | can be activated/deactivated and the lift-off distance can be | 87 | can be activated/deactivated and the lift-off distance can be |
81 | set. The data has to be 6 bytes long. | 88 | set. The data has to be 6 bytes long. |
82 | This file is writeonly. | 89 | This file is writeonly. |
90 | Users: http://roccat.sourceforge.net | ||
83 | 91 | ||
84 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/koneplus/roccatkoneplus<minor>/startup_profile | 92 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/koneplus/roccatkoneplus<minor>/startup_profile |
85 | Date: October 2010 | 93 | Date: October 2010 |
@@ -89,6 +97,7 @@ Description: The integer value of this attribute ranges from 0-4. | |||
89 | that's active when the mouse is powered on. | 97 | that's active when the mouse is powered on. |
90 | When written, this file sets the number of the startup profile | 98 | When written, this file sets the number of the startup profile |
91 | and the mouse activates this profile immediately. | 99 | and the mouse activates this profile immediately. |
100 | Users: http://roccat.sourceforge.net | ||
92 | 101 | ||
93 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/koneplus/roccatkoneplus<minor>/tcu | 102 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/koneplus/roccatkoneplus<minor>/tcu |
94 | Date: October 2010 | 103 | Date: October 2010 |
@@ -97,6 +106,7 @@ Description: When written a calibration process for the tracking control unit | |||
97 | can be initiated/cancelled. | 106 | can be initiated/cancelled. |
98 | The data has to be 3 bytes long. | 107 | The data has to be 3 bytes long. |
99 | This file is writeonly. | 108 | This file is writeonly. |
109 | Users: http://roccat.sourceforge.net | ||
100 | 110 | ||
101 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/koneplus/roccatkoneplus<minor>/tcu_image | 111 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/koneplus/roccatkoneplus<minor>/tcu_image |
102 | Date: October 2010 | 112 | Date: October 2010 |
@@ -106,3 +116,4 @@ Description: When read the mouse returns a 30x30 pixel image of the | |||
106 | calibration process initiated with tcu. | 116 | calibration process initiated with tcu. |
107 | The returned data is 1028 bytes in size. | 117 | The returned data is 1028 bytes in size. |
108 | This file is readonly. | 118 | This file is readonly. |
119 | Users: http://roccat.sourceforge.net | ||
diff --git a/Documentation/ABI/testing/sysfs-driver-hid-roccat-kovaplus b/Documentation/ABI/testing/sysfs-driver-hid-roccat-kovaplus new file mode 100644 index 000000000000..fdfa16f8189b --- /dev/null +++ b/Documentation/ABI/testing/sysfs-driver-hid-roccat-kovaplus | |||
@@ -0,0 +1,100 @@ | |||
1 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/kovaplus/roccatkovaplus<minor>/actual_cpi | ||
2 | Date: January 2011 | ||
3 | Contact: Stefan Achatz <erazor_de@users.sourceforge.net> | ||
4 | Description: The integer value of this attribute ranges from 1-4. | ||
5 | When read, this attribute returns the number of the active | ||
6 | cpi level. | ||
7 | This file is readonly. | ||
8 | Users: http://roccat.sourceforge.net | ||
9 | |||
10 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/kovaplus/roccatkovaplus<minor>/actual_profile | ||
11 | Date: January 2011 | ||
12 | Contact: Stefan Achatz <erazor_de@users.sourceforge.net> | ||
13 | Description: The integer value of this attribute ranges from 0-4. | ||
14 | When read, this attribute returns the number of the active | ||
15 | profile. | ||
16 | When written, the mouse activates this profile immediately. | ||
17 | The profile that's active when powered down is the same that's | ||
18 | active when the mouse is powered on. | ||
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>/kovaplus/roccatkovaplus<minor>/actual_sensitivity_x | ||
22 | Date: January 2011 | ||
23 | Contact: Stefan Achatz <erazor_de@users.sourceforge.net> | ||
24 | Description: The integer value of this attribute ranges from 1-10. | ||
25 | When read, this attribute returns the number of the actual | ||
26 | sensitivity in x direction. | ||
27 | This file is readonly. | ||
28 | Users: http://roccat.sourceforge.net | ||
29 | |||
30 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/kovaplus/roccatkovaplus<minor>/actual_sensitivity_y | ||
31 | Date: January 2011 | ||
32 | Contact: Stefan Achatz <erazor_de@users.sourceforge.net> | ||
33 | Description: The integer value of this attribute ranges from 1-10. | ||
34 | When read, this attribute returns the number of the actual | ||
35 | sensitivity in y direction. | ||
36 | This file is readonly. | ||
37 | Users: http://roccat.sourceforge.net | ||
38 | |||
39 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/kovaplus/roccatkovaplus<minor>/firmware_version | ||
40 | Date: January 2011 | ||
41 | Contact: Stefan Achatz <erazor_de@users.sourceforge.net> | ||
42 | Description: When read, this file returns the raw integer version number of the | ||
43 | firmware reported by the mouse. Using the integer value eases | ||
44 | further usage in other programs. To receive the real version | ||
45 | number the decimal point has to be shifted 2 positions to the | ||
46 | left. E.g. a returned value of 121 means 1.21 | ||
47 | This file is readonly. | ||
48 | Users: http://roccat.sourceforge.net | ||
49 | |||
50 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/kovaplus/roccatkovaplus<minor>/profile_buttons | ||
51 | Date: January 2011 | ||
52 | Contact: Stefan Achatz <erazor_de@users.sourceforge.net> | ||
53 | Description: The mouse can store 5 profiles which can be switched by the | ||
54 | press of a button. A profile is split in settings and buttons. | ||
55 | profile_buttons holds informations about button layout. | ||
56 | When written, this file lets one write the respective profile | ||
57 | buttons back to the mouse. The data has to be 23 bytes long. | ||
58 | The mouse will reject invalid data. | ||
59 | Which profile to write is determined by the profile number | ||
60 | contained in the data. | ||
61 | This file is writeonly. | ||
62 | Users: http://roccat.sourceforge.net | ||
63 | |||
64 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/kovaplus/roccatkovaplus<minor>/profile[1-5]_buttons | ||
65 | Date: January 2011 | ||
66 | Contact: Stefan Achatz <erazor_de@users.sourceforge.net> | ||
67 | Description: The mouse can store 5 profiles which can be switched by the | ||
68 | press of a button. A profile is split in settings and buttons. | ||
69 | profile_buttons holds informations about button layout. | ||
70 | When read, these files return the respective profile buttons. | ||
71 | The returned data is 23 bytes in size. | ||
72 | This file is readonly. | ||
73 | Users: http://roccat.sourceforge.net | ||
74 | |||
75 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/kovaplus/roccatkovaplus<minor>/profile_settings | ||
76 | Date: January 2011 | ||
77 | Contact: Stefan Achatz <erazor_de@users.sourceforge.net> | ||
78 | Description: The mouse can store 5 profiles which can be switched by the | ||
79 | press of a button. A profile is split in settings and buttons. | ||
80 | profile_settings holds informations like resolution, sensitivity | ||
81 | and light effects. | ||
82 | When written, this file lets one write the respective profile | ||
83 | settings back to the mouse. The data has to be 16 bytes long. | ||
84 | The mouse will reject invalid data. | ||
85 | Which profile to write is determined by the profile number | ||
86 | contained in the data. | ||
87 | This file is writeonly. | ||
88 | Users: http://roccat.sourceforge.net | ||
89 | |||
90 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/kovaplus/roccatkovaplus<minor>/profile[1-5]_settings | ||
91 | Date: January 2011 | ||
92 | Contact: Stefan Achatz <erazor_de@users.sourceforge.net> | ||
93 | Description: The mouse can store 5 profiles which can be switched by the | ||
94 | press of a button. A profile is split in settings and buttons. | ||
95 | profile_settings holds informations like resolution, sensitivity | ||
96 | and light effects. | ||
97 | When read, these files return the respective profile settings. | ||
98 | The returned data is 16 bytes in size. | ||
99 | This file is readonly. | ||
100 | Users: http://roccat.sourceforge.net | ||
diff --git a/Documentation/ABI/testing/sysfs-driver-hid-roccat-pyra b/Documentation/ABI/testing/sysfs-driver-hid-roccat-pyra index 1c37b823f142..5fab71af3c46 100644 --- a/Documentation/ABI/testing/sysfs-driver-hid-roccat-pyra +++ b/Documentation/ABI/testing/sysfs-driver-hid-roccat-pyra | |||
@@ -13,6 +13,7 @@ Description: It is possible to switch the cpi setting of the mouse with the | |||
13 | 4 1600 | 13 | 4 1600 |
14 | 14 | ||
15 | This file is readonly. | 15 | This file is readonly. |
16 | Users: http://roccat.sourceforge.net | ||
16 | 17 | ||
17 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/pyra/roccatpyra<minor>/actual_profile | 18 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/pyra/roccatpyra<minor>/actual_profile |
18 | Date: August 2010 | 19 | Date: August 2010 |
@@ -20,6 +21,7 @@ Contact: Stefan Achatz <erazor_de@users.sourceforge.net> | |||
20 | Description: When read, this file returns the number of the actual profile in | 21 | Description: When read, this file returns the number of the actual profile in |
21 | range 0-4. | 22 | range 0-4. |
22 | This file is readonly. | 23 | This file is readonly. |
24 | Users: http://roccat.sourceforge.net | ||
23 | 25 | ||
24 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/pyra/roccatpyra<minor>/firmware_version | 26 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/pyra/roccatpyra<minor>/firmware_version |
25 | Date: August 2010 | 27 | Date: August 2010 |
@@ -30,6 +32,7 @@ Description: When read, this file returns the raw integer version number of the | |||
30 | number the decimal point has to be shifted 2 positions to the | 32 | number the decimal point has to be shifted 2 positions to the |
31 | left. E.g. a returned value of 138 means 1.38 | 33 | left. E.g. a returned value of 138 means 1.38 |
32 | This file is readonly. | 34 | This file is readonly. |
35 | Users: http://roccat.sourceforge.net | ||
33 | 36 | ||
34 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/pyra/roccatpyra<minor>/profile_settings | 37 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/pyra/roccatpyra<minor>/profile_settings |
35 | Date: August 2010 | 38 | Date: August 2010 |
@@ -44,6 +47,7 @@ Description: The mouse can store 5 profiles which can be switched by the | |||
44 | Which profile to write is determined by the profile number | 47 | Which profile to write is determined by the profile number |
45 | contained in the data. | 48 | contained in the data. |
46 | This file is writeonly. | 49 | This file is writeonly. |
50 | Users: http://roccat.sourceforge.net | ||
47 | 51 | ||
48 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/pyra/roccatpyra<minor>/profile[1-5]_settings | 52 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/pyra/roccatpyra<minor>/profile[1-5]_settings |
49 | Date: August 2010 | 53 | Date: August 2010 |
@@ -55,6 +59,7 @@ Description: The mouse can store 5 profiles which can be switched by the | |||
55 | When read, these files return the respective profile settings. | 59 | When read, these files return the respective profile settings. |
56 | The returned data is 13 bytes in size. | 60 | The returned data is 13 bytes in size. |
57 | This file is readonly. | 61 | This file is readonly. |
62 | Users: http://roccat.sourceforge.net | ||
58 | 63 | ||
59 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/pyra/roccatpyra<minor>/profile_buttons | 64 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/pyra/roccatpyra<minor>/profile_buttons |
60 | Date: August 2010 | 65 | Date: August 2010 |
@@ -68,6 +73,7 @@ Description: The mouse can store 5 profiles which can be switched by the | |||
68 | Which profile to write is determined by the profile number | 73 | Which profile to write is determined by the profile number |
69 | contained in the data. | 74 | contained in the data. |
70 | This file is writeonly. | 75 | This file is writeonly. |
76 | Users: http://roccat.sourceforge.net | ||
71 | 77 | ||
72 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/pyra/roccatpyra<minor>/profile[1-5]_buttons | 78 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/pyra/roccatpyra<minor>/profile[1-5]_buttons |
73 | Date: August 2010 | 79 | Date: August 2010 |
@@ -78,6 +84,7 @@ Description: The mouse can store 5 profiles which can be switched by the | |||
78 | When read, these files return the respective profile buttons. | 84 | When read, these files return the respective profile buttons. |
79 | The returned data is 19 bytes in size. | 85 | The returned data is 19 bytes in size. |
80 | This file is readonly. | 86 | This file is readonly. |
87 | Users: http://roccat.sourceforge.net | ||
81 | 88 | ||
82 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/pyra/roccatpyra<minor>/startup_profile | 89 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/pyra/roccatpyra<minor>/startup_profile |
83 | Date: August 2010 | 90 | Date: August 2010 |
@@ -86,6 +93,7 @@ Description: The integer value of this attribute ranges from 0-4. | |||
86 | When read, this attribute returns the number of the profile | 93 | When read, this attribute returns the number of the profile |
87 | that's active when the mouse is powered on. | 94 | that's active when the mouse is powered on. |
88 | This file is readonly. | 95 | This file is readonly. |
96 | Users: http://roccat.sourceforge.net | ||
89 | 97 | ||
90 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/pyra/roccatpyra<minor>/settings | 98 | What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/pyra/roccatpyra<minor>/settings |
91 | Date: August 2010 | 99 | Date: August 2010 |
@@ -96,3 +104,4 @@ Description: When read, this file returns the settings stored in the mouse. | |||
96 | When written, this file lets write settings back to the mouse. | 104 | When written, this file lets write settings back to the mouse. |
97 | The data has to be 3 bytes long. The mouse will reject invalid | 105 | The data has to be 3 bytes long. The mouse will reject invalid |
98 | data. | 106 | data. |
107 | Users: http://roccat.sourceforge.net | ||
diff --git a/Documentation/ABI/testing/sysfs-firmware-dmi b/Documentation/ABI/testing/sysfs-firmware-dmi new file mode 100644 index 000000000000..ba9da9503c23 --- /dev/null +++ b/Documentation/ABI/testing/sysfs-firmware-dmi | |||
@@ -0,0 +1,110 @@ | |||
1 | What: /sys/firmware/dmi/ | ||
2 | Date: February 2011 | ||
3 | Contact: Mike Waychison <mikew@google.com> | ||
4 | Description: | ||
5 | Many machines' firmware (x86 and ia64) export DMI / | ||
6 | SMBIOS tables to the operating system. Getting at this | ||
7 | information is often valuable to userland, especially in | ||
8 | cases where there are OEM extensions used. | ||
9 | |||
10 | The kernel itself does not rely on the majority of the | ||
11 | information in these tables being correct. It equally | ||
12 | cannot ensure that the data as exported to userland is | ||
13 | without error either. | ||
14 | |||
15 | DMI is structured as a large table of entries, where | ||
16 | each entry has a common header indicating the type and | ||
17 | length of the entry, as well as 'handle' that is | ||
18 | supposed to be unique amongst all entries. | ||
19 | |||
20 | Some entries are required by the specification, but many | ||
21 | others are optional. In general though, users should | ||
22 | never expect to find a specific entry type on their | ||
23 | system unless they know for certain what their firmware | ||
24 | is doing. Machine to machine will vary. | ||
25 | |||
26 | Multiple entries of the same type are allowed. In order | ||
27 | to handle these duplicate entry types, each entry is | ||
28 | assigned by the operating system an 'instance', which is | ||
29 | derived from an entry type's ordinal position. That is | ||
30 | to say, if there are 'N' multiple entries with the same type | ||
31 | 'T' in the DMI tables (adjacent or spread apart, it | ||
32 | doesn't matter), they will be represented in sysfs as | ||
33 | entries "T-0" through "T-(N-1)": | ||
34 | |||
35 | Example entry directories: | ||
36 | |||
37 | /sys/firmware/dmi/entries/17-0 | ||
38 | /sys/firmware/dmi/entries/17-1 | ||
39 | /sys/firmware/dmi/entries/17-2 | ||
40 | /sys/firmware/dmi/entries/17-3 | ||
41 | ... | ||
42 | |||
43 | Instance numbers are used in lieu of the firmware | ||
44 | assigned entry handles as the kernel itself makes no | ||
45 | guarantees that handles as exported are unique, and | ||
46 | there are likely firmware images that get this wrong in | ||
47 | the wild. | ||
48 | |||
49 | Each DMI entry in sysfs has the common header values | ||
50 | exported as attributes: | ||
51 | |||
52 | handle : The 16bit 'handle' that is assigned to this | ||
53 | entry by the firmware. This handle may be | ||
54 | referred to by other entries. | ||
55 | length : The length of the entry, as presented in the | ||
56 | entry itself. Note that this is _not the | ||
57 | total count of bytes associated with the | ||
58 | entry_. This value represents the length of | ||
59 | the "formatted" portion of the entry. This | ||
60 | "formatted" region is sometimes followed by | ||
61 | the "unformatted" region composed of nul | ||
62 | terminated strings, with termination signalled | ||
63 | by a two nul characters in series. | ||
64 | raw : The raw bytes of the entry. This includes the | ||
65 | "formatted" portion of the entry, the | ||
66 | "unformatted" strings portion of the entry, | ||
67 | and the two terminating nul characters. | ||
68 | type : The type of the entry. This value is the same | ||
69 | as found in the directory name. It indicates | ||
70 | how the rest of the entry should be | ||
71 | interpreted. | ||
72 | instance: The instance ordinal of the entry for the | ||
73 | given type. This value is the same as found | ||
74 | in the parent directory name. | ||
75 | position: The position of the entry within the entirety | ||
76 | of the entirety. | ||
77 | |||
78 | === Entry Specialization === | ||
79 | |||
80 | Some entry types may have other information available in | ||
81 | sysfs. | ||
82 | |||
83 | --- Type 15 - System Event Log --- | ||
84 | |||
85 | This entry allows the firmware to export a log of | ||
86 | events the system has taken. This information is | ||
87 | typically backed by nvram, but the implementation | ||
88 | details are abstracted by this table. This entries data | ||
89 | is exported in the directory: | ||
90 | |||
91 | /sys/firmware/dmi/entries/15-0/system_event_log | ||
92 | |||
93 | and has the following attributes (documented in the | ||
94 | SMBIOS / DMI specification under "System Event Log (Type 15)": | ||
95 | |||
96 | area_length | ||
97 | header_start_offset | ||
98 | data_start_offset | ||
99 | access_method | ||
100 | status | ||
101 | change_token | ||
102 | access_method_address | ||
103 | header_format | ||
104 | per_log_type_descriptor_length | ||
105 | type_descriptors_supported_count | ||
106 | |||
107 | As well, the kernel exports the binary attribute: | ||
108 | |||
109 | raw_event_log : The raw binary bits of the event log | ||
110 | as described by the DMI entry. | ||
diff --git a/Documentation/ABI/testing/sysfs-fs-pstore b/Documentation/ABI/testing/sysfs-fs-pstore new file mode 100644 index 000000000000..8e659d854805 --- /dev/null +++ b/Documentation/ABI/testing/sysfs-fs-pstore | |||
@@ -0,0 +1,7 @@ | |||
1 | What: /sys/fs/pstore/kmsg_bytes | ||
2 | Date: January 2011 | ||
3 | Kernel Version: 2.6.38 | ||
4 | Contact: "Tony Luck" <tony.luck@intel.com> | ||
5 | Description: | ||
6 | Controls amount of console log that will be saved | ||
7 | to persistent store on oops/panic. | ||
diff --git a/Documentation/ABI/testing/sysfs-platform-kim b/Documentation/ABI/testing/sysfs-platform-kim new file mode 100644 index 000000000000..c1653271872a --- /dev/null +++ b/Documentation/ABI/testing/sysfs-platform-kim | |||
@@ -0,0 +1,48 @@ | |||
1 | What: /sys/devices/platform/kim/dev_name | ||
2 | Date: January 2010 | ||
3 | KernelVersion: 2.6.38 | ||
4 | Contact: "Pavan Savoy" <pavan_savoy@ti.com> | ||
5 | Description: | ||
6 | Name of the UART device at which the WL128x chip | ||
7 | is connected. example: "/dev/ttyS0". | ||
8 | The device name flows down to architecture specific board | ||
9 | initialization file from the SFI/ATAGS bootloader | ||
10 | firmware. The name exposed is read from the user-space | ||
11 | dameon and opens the device when install is requested. | ||
12 | |||
13 | What: /sys/devices/platform/kim/baud_rate | ||
14 | Date: January 2010 | ||
15 | KernelVersion: 2.6.38 | ||
16 | Contact: "Pavan Savoy" <pavan_savoy@ti.com> | ||
17 | Description: | ||
18 | The maximum reliable baud-rate the host can support. | ||
19 | Different platforms tend to have different high-speed | ||
20 | UART configurations, so the baud-rate needs to be set | ||
21 | locally and also sent across to the WL128x via a HCI-VS | ||
22 | command. The entry is read and made use by the user-space | ||
23 | daemon when the ldisc install is requested. | ||
24 | |||
25 | What: /sys/devices/platform/kim/flow_cntrl | ||
26 | Date: January 2010 | ||
27 | KernelVersion: 2.6.38 | ||
28 | Contact: "Pavan Savoy" <pavan_savoy@ti.com> | ||
29 | Description: | ||
30 | The WL128x makes use of flow control mechanism, and this | ||
31 | entry most often should be 1, the host's UART is required | ||
32 | to have the capability of flow-control, or else this | ||
33 | entry can be made use of for exceptions. | ||
34 | |||
35 | What: /sys/devices/platform/kim/install | ||
36 | Date: January 2010 | ||
37 | KernelVersion: 2.6.38 | ||
38 | Contact: "Pavan Savoy" <pavan_savoy@ti.com> | ||
39 | Description: | ||
40 | When one of the protocols Bluetooth, FM or GPS wants to make | ||
41 | use of the shared UART transport, it registers to the shared | ||
42 | transport driver, which will signal the user-space for opening, | ||
43 | configuring baud and install line discipline via this sysfs | ||
44 | entry. This entry would be polled upon by the user-space | ||
45 | daemon managing the UART, and is notified about the change | ||
46 | by the sysfs_notify. The value would be '1' when UART needs | ||
47 | to be opened/ldisc installed, and would be '0' when UART | ||
48 | is no more required and needs to be closed. | ||