diff options
| author | Nikolai Kondrashov <spbnick@gmail.com> | 2010-08-30 06:06:38 -0400 |
|---|---|---|
| committer | Jiri Kosina <jkosina@suse.cz> | 2010-09-01 06:36:36 -0400 |
| commit | cdd49a85e237929a4c00965f1a88bdd9195898d8 (patch) | |
| tree | 5d6bb849f4d40f5f7cdf49538dcd427426d0783d /drivers/hid/hid-waltop.c | |
| parent | 30311549c3e2a0d9d839ed6e40398a2c354ce5e2 (diff) | |
HID: waltop: comment on tablet modes
Add a comment on modes supported by Waltop tablets - a knowledge extracted
from the outdated official driver, but not yet used by this driver.
Signed-off-by: Nikolai Kondrashov <spbnick@gmail.com>
Signed-off-by: Jiri Kosina <jkosina@suse.cz>
Diffstat (limited to 'drivers/hid/hid-waltop.c')
| -rw-r--r-- | drivers/hid/hid-waltop.c | 29 |
1 files changed, 27 insertions, 2 deletions
diff --git a/drivers/hid/hid-waltop.c b/drivers/hid/hid-waltop.c index 246160a9fb89..6ef9ed6a57d6 100644 --- a/drivers/hid/hid-waltop.c +++ b/drivers/hid/hid-waltop.c | |||
| @@ -18,12 +18,37 @@ | |||
| 18 | #include "hid-ids.h" | 18 | #include "hid-ids.h" |
| 19 | 19 | ||
| 20 | /* | 20 | /* |
| 21 | * There exists an official driver on the manufacturer's website, which | ||
| 22 | * wasn't submitted to the kernel, for some reason. The official driver | ||
| 23 | * doesn't seem to support extra features of some tablets, like wheels. | ||
| 24 | * | ||
| 25 | * It shows that the feature report ID 2 could be used to control any waltop | ||
| 26 | * tablet input mode, switching it between "default", "tablet" and "ink". | ||
| 27 | * | ||
| 28 | * This driver only uses "default" mode for all the supported tablets. This | ||
| 29 | * mode tries to be HID-compatible (not very successfully), but cripples the | ||
| 30 | * resolution of some tablets. | ||
| 31 | * | ||
| 32 | * The "tablet" mode uses some proprietary, yet decipherable protocol, which | ||
| 33 | * represents the correct resolution, but is possibly HID-incompatible (i.e. | ||
| 34 | * indescribable by a report descriptor). | ||
| 35 | * | ||
| 36 | * The purpose of the "ink" mode is unknown. | ||
| 37 | * | ||
| 38 | * The feature reports needed for switching to each mode are these: | ||
| 39 | * | ||
| 40 | * 02 16 00 default | ||
| 41 | * 02 16 01 tablet | ||
| 42 | * 02 16 02 ink | ||
| 43 | */ | ||
| 44 | |||
| 45 | /* | ||
| 21 | * Original Slim Tablet 5.8 inch report descriptor. | 46 | * Original Slim Tablet 5.8 inch report descriptor. |
| 22 | * | 47 | * |
| 23 | * All the reports except the report with ID 16 (the stylus) are unused, | 48 | * All the reports except the report with ID 16 (the stylus) are unused, |
| 24 | * possibly because the tablet is not configured to, or because they were | 49 | * possibly because the tablet is not configured to, or because they were |
| 25 | * just copied from a more capable model. The purpose of features described | 50 | * just copied from a more capable model. The full purpose of features |
| 26 | * for report ID 2 is unknown. | 51 | * described for report ID 2 is unknown. |
| 27 | * | 52 | * |
| 28 | * The stylus buttons are described as three bit fields, whereas actually | 53 | * The stylus buttons are described as three bit fields, whereas actually |
| 29 | * it's an "array", i.e. they're reported as button numbers (1, 2 and 3). | 54 | * it's an "array", i.e. they're reported as button numbers (1, 2 and 3). |