aboutsummaryrefslogblamecommitdiffstats
path: root/drivers/hid/hid-waltop.c
blob: b3a4163f2e67c1211a5b8cf7f6221cbad425493a (plain) (tree)



















                                                                             
























                                                                            



                                                                         

                                                                      














































































































































































                                                                            







































































































































































































                                                                               





















                                                                            



                                                                           











































































































































































































































                                                                              

                                                                      
                                                                      
                                                                      

                                                                      


                                                                      
                                                                      
                                                                      














                                                                      









                                                                      
                                                                      

                                                                      


















                                                                      
































































































































































































































































































                                                                              









                                                                          





                                                                           





                                                                            





                                                                            







                                                                             

                                                                              
                                                                               

                                                                               






















                                                   
/*
 *  HID driver for Waltop devices not fully compliant with HID standard
 *
 *  Copyright (c) 2010 Nikolai Kondrashov
 */

/*
 * This program is free software; you can redistribute it and/or modify it
 * under the terms of the GNU General Public License as published by the Free
 * Software Foundation; either version 2 of the License, or (at your option)
 * any later version.
 */

#include <linux/device.h>
#include <linux/hid.h>
#include <linux/module.h>

#include "hid-ids.h"

/*
 * There exists an official driver on the manufacturer's website, which
 * wasn't submitted to the kernel, for some reason. The official driver
 * doesn't seem to support extra features of some tablets, like wheels.
 *
 * It shows that the feature report ID 2 could be used to control any waltop
 * tablet input mode, switching it between "default", "tablet" and "ink".
 *
 * This driver only uses "default" mode for all the supported tablets. This
 * mode tries to be HID-compatible (not very successfully), but cripples the
 * resolution of some tablets.
 *
 * The "tablet" mode uses some proprietary, yet decipherable protocol, which
 * represents the correct resolution, but is possibly HID-incompatible (i.e.
 * indescribable by a report descriptor).
 *
 * The purpose of the "ink" mode is unknown.
 *
 * The feature reports needed for switching to each mode are these:
 *
 * 02 16 00     default
 * 02 16 01     tablet
 * 02 16 02     ink
 */

/*
 * Original Slim Tablet 5.8 inch report descriptor.
 *
 * All the reports except the report with ID 16 (the stylus) are unused,
 * possibly because the tablet is not configured to, or because they were
 * just copied from a more capable model. The full purpose of features
 * described for report ID 2 is unknown.
 *
 * The stylus buttons are described as three bit fields, whereas actually
 * it's an "array", i.e. they're reported as button numbers (1, 2 and 3).
 * The "eraser" field is not used. There is also a "push" without a "pop" in
 * the stylus description.
 *
 *  Usage Page (Desktop),           ; Generic desktop controls (01h)
 *  Usage (Mouse),                  ; Mouse (02h, application collection)
 *  Collection (Application),
 *    Report ID (1),
 *    Usage (Pointer),              ; Pointer (01h, physical collection)
 *    Collection (Physical),
 *      Usage Page (Button),        ; Button (09h)
 *      Usage Minimum (01h),
 *      Usage Maximum (05h),
 *      Logical Minimum (0),
 *      Logical Maximum (1),
 *      Report Size (1),
 *      Report Count (5),
 *      Input (Variable),
 *      Report Size (3),
 *      Report Count (1),
 *      Input (Constant, Variable),
 *      Usage Page (Desktop),       ; Generic desktop controls (01h)
 *      Usage (X),                  ; X (30h, dynamic value)
 *      Usage (Y),                  ; Y (31h, dynamic value)
 *      Usage (Wheel),              ; Wheel (38h, dynamic value)
 *      Logical Minimum (-127),
 *      Logical Maximum (127),
 *      Report Size (8),
 *      Report Count (3),
 *      Input (Variable, Relative),
 *    End Collection,
 *  End Collection,
 *  Usage Page (Digitizer),         ; Digitizer (0Dh)
 *  Usage (Pen),                    ; Pen (02h, application collection)
 *  Collection (Application),
 *    Report ID (2),
 *    Usage (Stylus),               ; Stylus (20h, logical collection)
 *    Collection (Physical),
 *      Usage (00h),
 *      Logical Minimum (0),
 *      Logical Maximum (255),
 *      Report Size (8),
 *      Report Count (7),
 *      Input (Variable),
 *      Usage (Azimuth),            ; Azimuth (3Fh, dynamic value)
 *      Usage (Altitude),           ; Altitude (40h, dynamic value)
 *      Logical Minimum (0),
 *      Logical Maximum (255),
 *      Report Size (8),
 *      Report Count (2),
 *      Feature (Variable),
 *    End Collection,
 *    Report ID (5),
 *    Usage Page (Digitizer),       ; Digitizer (0Dh)
 *    Usage (Stylus),               ; Stylus (20h, logical collection)
 *    Collection (Physical),
 *      Usage (00h),
 *      Logical Minimum (0),
 *      Logical Maximum (255),
 *      Report Size (8),
 *      Report Count (7),
 *      Input (Variable),
 *    End Collection,
 *    Report ID (10),
 *    Usage Page (Digitizer),       ; Digitizer (0Dh)
 *    Usage (Stylus),               ; Stylus (20h, logical collection)
 *    Collection (Physical),
 *      Usage (00h),
 *      Logical Minimum (0),
 *      Logical Maximum (255),
 *      Report Size (8),
 *      Report Count (3),
 *      Input (Variable),
 *    End Collection,
 *    Report ID (16),
 *    Usage (Stylus),               ; Stylus (20h, logical collection)
 *    Collection (Physical),
 *      Usage (Tip Switch),         ; Tip switch (42h, momentary control)
 *      Usage (Barrel Switch),      ; Barrel switch (44h, momentary control)
 *      Usage (Invert),             ; Invert (3Ch, momentary control)
 *      Usage (Eraser),             ; Eraser (45h, momentary control)
 *      Usage (In Range),           ; In range (32h, momentary control)
 *      Logical Minimum (0),
 *      Logical Maximum (1),
 *      Report Size (1),
 *      Report Count (5),
 *      Input (Variable),
 *      Report Count (3),
 *      Input (Constant, Variable),
 *      Usage Page (Desktop),       ; Generic desktop controls (01h)
 *      Usage (X),                  ; X (30h, dynamic value)
 *      Report Size (16),
 *      Report Count (1),
 *      Push,
 *      Unit Exponent (13),
 *      Unit (Inch^3),
 *      Logical Minimum (0),
 *      Logical Maximum (10000),
 *      Physical Minimum (0),
 *      Physical Maximum (10000),
 *      Input (Variable),
 *      Usage (Y),                  ; Y (31h, dynamic value)
 *      Logical Maximum (6000),
 *      Physical Maximum (6000),
 *      Input (Variable),
 *      Usage Page (Digitizer),     ; Digitizer (0Dh)
 *      Usage (Tip Pressure),       ; Tip pressure (30h, dynamic value)
 *      Logical Minimum (0),
 *      Logical Maximum (1023),
 *      Physical Minimum (0),
 *      Physical Maximum (1023),
 *      Input (Variable),
 *    End Collection,
 *  End Collection
 */

/* Size of the original report descriptor of Slim Tablet 5.8 inch */
#define SLIM_TABLET_5_8_INCH_RDESC_ORIG_SIZE	222

/*
 * Fixed Slim Tablet 5.8 inch descriptor.
 *
 * All the reports except the stylus report (ID 16) were removed as unused.
 * The stylus buttons description was fixed.
 */
static __u8 slim_tablet_5_8_inch_rdesc_fixed[] = {
	0x05, 0x0D,         /*  Usage Page (Digitizer),             */
	0x09, 0x02,         /*  Usage (Pen),                        */
	0xA1, 0x01,         /*  Collection (Application),           */
	0x85, 0x10,         /*      Report ID (16),                 */
	0x09, 0x20,         /*      Usage (Stylus),                 */
	0xA0,               /*      Collection (Physical),          */
	0x09, 0x42,         /*          Usage (Tip Switch),         */
	0x09, 0x44,         /*          Usage (Barrel Switch),      */
	0x09, 0x46,         /*          Usage (Tablet Pick),        */
	0x15, 0x01,         /*          Logical Minimum (1),        */
	0x25, 0x03,         /*          Logical Maximum (3),        */
	0x75, 0x04,         /*          Report Size (4),            */
	0x95, 0x01,         /*          Report Count (1),           */
	0x80,               /*          Input,                      */
	0x09, 0x32,         /*          Usage (In Range),           */
	0x14,               /*          Logical Minimum (0),        */
	0x25, 0x01,         /*          Logical Maximum (1),        */
	0x75, 0x01,         /*          Report Size (1),            */
	0x95, 0x01,         /*          Report Count (1),           */
	0x81, 0x02,         /*          Input (Variable),           */
	0x95, 0x03,         /*          Report Count (3),           */
	0x81, 0x03,         /*          Input (Constant, Variable), */
	0x75, 0x10,         /*          Report Size (16),           */
	0x95, 0x01,         /*          Report Count (1),           */
	0x14,               /*          Logical Minimum (0),        */
	0xA4,               /*          Push,                       */
	0x05, 0x01,         /*          Usage Page (Desktop),       */
	0x65, 0x13,         /*          Unit (Inch),                */
	0x55, 0xFD,         /*          Unit Exponent (-3),         */
	0x34,               /*          Physical Minimum (0),       */
	0x09, 0x30,         /*          Usage (X),                  */
	0x46, 0x88, 0x13,   /*          Physical Maximum (5000),    */
	0x26, 0x10, 0x27,   /*          Logical Maximum (10000),    */
	0x81, 0x02,         /*          Input (Variable),           */
	0x09, 0x31,         /*          Usage (Y),                  */
	0x46, 0xB8, 0x0B,   /*          Physical Maximum (3000),    */
	0x26, 0x70, 0x17,   /*          Logical Maximum (6000),     */
	0x81, 0x02,         /*          Input (Variable),           */
	0xB4,               /*          Pop,                        */
	0x09, 0x30,         /*          Usage (Tip Pressure),       */
	0x26, 0xFF, 0x03,   /*          Logical Maximum (1023),     */
	0x81, 0x02,         /*          Input (Variable),           */
	0xC0,               /*      End Collection,                 */
	0xC0                /*  End Collection                      */
};

/*
 * Original Slim Tablet 12.1 inch report descriptor.
 *
 * The descriptor is similar to the Slim Tablet 5.8 inch descriptor with the
 * addition of a keyboard report, seemingly unused. It may have get here
 * from a Media Tablet - probably an unimplemented feature.
 *
 *  Usage Page (Desktop),             ; Generic desktop controls (01h)
 *  Usage (Mouse),                    ; Mouse (02h, application collection)
 *  Collection (Application),
 *    Report ID (1),
 *    Usage (Pointer),                ; Pointer (01h, physical collection)
 *    Collection (Physical),
 *      Usage Page (Button),          ; Button (09h)
 *      Usage Minimum (01h),
 *      Usage Maximum (05h),
 *      Logical Minimum (0),
 *      Logical Maximum (1),
 *      Report Size (1),
 *      Report Count (5),
 *      Input (Variable),
 *      Report Size (3),
 *      Report Count (1),
 *      Input (Constant, Variable),
 *      Usage Page (Desktop),         ; Generic desktop controls (01h)
 *      Usage (X),                    ; X (30h, dynamic value)
 *      Usage (Y),                    ; Y (31h, dynamic value)
 *      Usage (Wheel),                ; Wheel (38h, dynamic value)
 *      Logical Minimum (-127),
 *      Logical Maximum (127),
 *      Report Size (8),
 *      Report Count (3),
 *      Input (Variable, Relative),
 *    End Collection,
 *  End Collection,
 *  Usage Page (Digitizer),           ; Digitizer (0Dh)
 *  Usage (Pen),                      ; Pen (02h, application collection)
 *  Collection (Application),
 *    Report ID (2),
 *    Usage (Stylus),                 ; Stylus (20h, logical collection)
 *    Collection (Physical),
 *      Usage (00h),
 *      Logical Minimum (0),
 *      Logical Maximum (255),
 *      Report Size (8),
 *      Report Count (7),
 *      Input (Variable),
 *      Usage (Azimuth),              ; Azimuth (3Fh, dynamic value)
 *      Usage (Altitude),             ; Altitude (40h, dynamic value)
 *      Logical Minimum (0),
 *      Logical Maximum (255),
 *      Report Size (8),
 *      Report Count (2),
 *      Feature (Variable),
 *    End Collection,
 *    Report ID (5),
 *    Usage Page (Digitizer),         ; Digitizer (0Dh)
 *    Usage (Stylus),                 ; Stylus (20h, logical collection)
 *    Collection (Physical),
 *      Usage (00h),
 *      Logical Minimum (0),
 *      Logical Maximum (255),
 *      Report Size (8),
 *      Report Count (7),
 *      Input (Variable),
 *    End Collection,
 *    Report ID (10),
 *    Usage Page (Digitizer),         ; Digitizer (0Dh)
 *    Usage (Stylus),                 ; Stylus (20h, logical collection)
 *    Collection (Physical),
 *      Usage (00h),
 *      Logical Minimum (0),
 *      Logical Maximum (255),
 *      Report Size (8),
 *      Report Count (3),
 *      Input (Variable),
 *    End Collection,
 *    Report ID (16),
 *    Usage (Stylus),                 ; Stylus (20h, logical collection)
 *    Collection (Physical),
 *      Usage (Tip Switch),           ; Tip switch (42h, momentary control)
 *      Usage (Barrel Switch),        ; Barrel switch (44h, momentary control)
 *      Usage (Invert),               ; Invert (3Ch, momentary control)
 *      Usage (Eraser),               ; Eraser (45h, momentary control)
 *      Usage (In Range),             ; In range (32h, momentary control)
 *      Logical Minimum (0),
 *      Logical Maximum (1),
 *      Report Size (1),
 *      Report Count (5),
 *      Input (Variable),
 *      Report Count (3),
 *      Input (Constant, Variable),
 *      Usage Page (Desktop),         ; Generic desktop controls (01h)
 *      Usage (X),                    ; X (30h, dynamic value)
 *      Report Size (16),
 *      Report Count (1),
 *      Push,
 *      Unit Exponent (13),
 *      Unit (Inch^3),
 *      Logical Minimum (0),
 *      Logical Maximum (20000),
 *      Physical Minimum (0),
 *      Physical Maximum (20000),
 *      Input (Variable),
 *      Usage (Y),                    ; Y (31h, dynamic value)
 *      Logical Maximum (12500),
 *      Physical Maximum (12500),
 *      Input (Variable),
 *      Usage Page (Digitizer),       ; Digitizer (0Dh)
 *      Usage (Tip Pressure),         ; Tip pressure (30h, dynamic value)
 *      Logical Minimum (0),
 *      Logical Maximum (1023),
 *      Physical Minimum (0),
 *      Physical Maximum (1023),
 *      Input (Variable),
 *    End Collection,
 *  End Collection,
 *  Usage Page (Desktop),             ; Generic desktop controls (01h)
 *  Usage (Keyboard),                 ; Keyboard (06h, application collection)
 *  Collection (Application),
 *    Report ID (13),
 *    Usage Page (Keyboard),          ; Keyboard/keypad (07h)
 *    Usage Minimum (KB Leftcontrol), ; Keyboard left control
 *                                    ; (E0h, dynamic value)
 *    Usage Maximum (KB Right GUI),   ; Keyboard right GUI (E7h, dynamic value)
 *    Logical Minimum (0),
 *    Logical Maximum (1),
 *    Report Size (1),
 *    Report Count (8),
 *    Input (Variable),
 *    Report Size (8),
 *    Report Count (1),
 *    Input (Constant),
 *    Usage Page (Keyboard),          ; Keyboard/keypad (07h)
 *    Usage Minimum (None),           ; No event (00h, selector)
 *    Usage Maximum (KB Application), ; Keyboard Application (65h, selector)
 *    Logical Minimum (0),
 *    Logical Maximum (101),
 *    Report Size (8),
 *    Report Count (5),
 *    Input,
 *  End Collection
 */

/* Size of the original report descriptor of Slim Tablet 12.1 inch */
#define SLIM_TABLET_12_1_INCH_RDESC_ORIG_SIZE	269

/*
 * Fixed Slim Tablet 12.1 inch descriptor.
 *
 * All the reports except the stylus report (ID 16) were removed as unused.
 * The stylus buttons description was fixed.
 */
static __u8 slim_tablet_12_1_inch_rdesc_fixed[] = {
	0x05, 0x0D,         /*  Usage Page (Digitizer),             */
	0x09, 0x02,         /*  Usage (Pen),                        */
	0xA1, 0x01,         /*  Collection (Application),           */
	0x85, 0x10,         /*      Report ID (16),                 */
	0x09, 0x20,         /*      Usage (Stylus),                 */
	0xA0,               /*      Collection (Physical),          */
	0x09, 0x42,         /*          Usage (Tip Switch),         */
	0x09, 0x44,         /*          Usage (Barrel Switch),      */
	0x09, 0x46,         /*          Usage (Tablet Pick),        */
	0x15, 0x01,         /*          Logical Minimum (1),        */
	0x25, 0x03,         /*          Logical Maximum (3),        */
	0x75, 0x04,         /*          Report Size (4),            */
	0x95, 0x01,         /*          Report Count (1),           */
	0x80,               /*          Input,                      */
	0x09, 0x32,         /*          Usage (In Range),           */
	0x14,               /*          Logical Minimum (0),        */
	0x25, 0x01,         /*          Logical Maximum (1),        */
	0x75, 0x01,         /*          Report Size (1),            */
	0x95, 0x01,         /*          Report Count (1),           */
	0x81, 0x02,         /*          Input (Variable),           */
	0x95, 0x03,         /*          Report Count (3),           */
	0x81, 0x03,         /*          Input (Constant, Variable), */
	0x75, 0x10,         /*          Report Size (16),           */
	0x95, 0x01,         /*          Report Count (1),           */
	0x14,               /*          Logical Minimum (0),        */
	0xA4,               /*          Push,                       */
	0x05, 0x01,         /*          Usage Page (Desktop),       */
	0x65, 0x13,         /*          Unit (Inch),                */
	0x55, 0xFD,         /*          Unit Exponent (-3),         */
	0x34,               /*          Physical Minimum (0),       */
	0x09, 0x30,         /*          Usage (X),                  */
	0x46, 0x10, 0x27,   /*          Physical Maximum (10000),   */
	0x26, 0x20, 0x4E,   /*          Logical Maximum (20000),    */
	0x81, 0x02,         /*          Input (Variable),           */
	0x09, 0x31,         /*          Usage (Y),                  */
	0x46, 0x6A, 0x18,   /*          Physical Maximum (6250),    */
	0x26, 0xD4, 0x30,   /*          Logical Maximum (12500),    */
	0x81, 0x02,         /*          Input (Variable),           */
	0xB4,               /*          Pop,                        */
	0x09, 0x30,         /*          Usage (Tip Pressure),       */
	0x26, 0xFF, 0x03,   /*          Logical Maximum (1023),     */
	0x81, 0x02,         /*          Input (Variable),           */
	0xC0,               /*      End Collection,                 */
	0xC0                /*  End Collection                      */
};

/*
 * Original Media Tablet 10.6 inch report descriptor.
 *
 * There are at least two versions of this model in the wild. They are
 * represented by Genius G-Pen M609 (older version) and Genius G-Pen M609X
 * (newer version).
 *
 * Both versions have the usual pen with two barrel buttons and two
 * identical wheels with center buttons in the top corners of the tablet
 * base. They also have buttons on the top, between the wheels, for
 * selecting the wheels' functions and wide/standard mode. In the wide mode
 * the whole working surface is sensed, in the standard mode a narrower area
 * is sensed, but the logical report extents remain the same. These modes
 * correspond roughly to 16:9 and 4:3 aspect ratios respectively.
 *
 * The older version has three wheel function buttons ("scroll", "zoom" and
 * "volume") and two separate buttons for wide and standard mode. The newer
 * version has four wheel function buttons (plus "brush") and only one
 * button is used for selecting wide/standard mode. So, the total number of
 * buttons remains the same, but one of the mode buttons is repurposed as a
 * wheels' function button in the newer version.
 *
 * The wheel functions are:
 * scroll   - the wheels act as scroll wheels, the center buttons switch
 *            between vertical and horizontal scrolling;
 * zoom     - the wheels zoom in/out, the buttons supposedly reset to 100%;
 * volume   - the wheels control the sound volume, the buttons mute;
 * brush    - the wheels are supposed to control brush width in a graphics
 *            editor, the buttons do nothing.
 *
 * Below is the newer version's report descriptor. It may very well be that
 * the older version's descriptor is different and thus it won't be
 * supported.
 *
 * The mouse report (ID 1) only uses the wheel field for reporting the tablet
 * wheels' scroll mode. The keyboard report (ID 13) is used to report the
 * wheels' zoom and brush control functions as key presses. The report ID 12
 * is used to report the wheels' volume control functions. The stylus report
 * (ID 16) has the same problems as the Slim Tablet 5.8 inch report has.
 *
 * The rest of the reports are unused, at least in the default configuration.
 * The purpose of the features is unknown.
 *
 *  Usage Page (Desktop),
 *  Usage (Mouse),
 *  Collection (Application),
 *    Report ID (1),
 *    Usage (Pointer),
 *    Collection (Physical),
 *      Usage Page (Button),
 *      Usage Minimum (01h),
 *      Usage Maximum (05h),
 *      Logical Minimum (0),
 *      Logical Maximum (1),
 *      Report Size (1),
 *      Report Count (5),
 *      Input (Variable),
 *      Report Size (3),
 *      Report Count (1),
 *      Input (Constant, Variable),
 *      Usage Page (Desktop),
 *      Usage (X),
 *      Usage (Y),
 *      Usage (Wheel),
 *      Logical Minimum (-127),
 *      Logical Maximum (127),
 *      Report Size (8),
 *      Report Count (3),
 *      Input (Variable, Relative),
 *    End Collection,
 *  End Collection,
 *  Usage Page (Digitizer),
 *  Usage (Pen),
 *  Collection (Application),
 *    Report ID (2),
 *    Usage (Stylus),
 *    Collection (Physical),
 *      Usage (00h),
 *      Logical Minimum (0),
 *      Logical Maximum (255),
 *      Report Size (8),
 *      Report Count (7),
 *      Input (Variable),
 *      Usage (Azimuth),
 *      Usage (Altitude),
 *      Logical Minimum (0),
 *      Logical Maximum (255),
 *      Report Size (8),
 *      Report Count (2),
 *      Feature (Variable),
 *    End Collection,
 *    Report ID (5),
 *    Usage Page (Digitizer),
 *    Usage (Stylus),
 *    Collection (Physical),
 *      Usage (00h),
 *      Logical Minimum (0),
 *      Logical Maximum (255),
 *      Report Size (8),
 *      Report Count (7),
 *      Input (Variable),
 *    End Collection,
 *    Report ID (10),
 *    Usage Page (Digitizer),
 *    Usage (Stylus),
 *    Collection (Physical),
 *      Usage (00h),
 *      Logical Minimum (0),
 *      Logical Maximum (255),
 *      Report Size (8),
 *      Report Count (7),
 *      Input (Variable),
 *    End Collection,
 *    Report ID (16),
 *    Usage (Stylus),
 *    Collection (Physical),
 *      Usage (Tip Switch),
 *      Usage (Barrel Switch),
 *      Usage (Invert),
 *      Usage (Eraser),
 *      Usage (In Range),
 *      Logical Minimum (0),
 *      Logical Maximum (1),
 *      Report Size (1),
 *      Report Count (5),
 *      Input (Variable),
 *      Report Count (3),
 *      Input (Constant, Variable),
 *      Usage Page (Desktop),
 *      Usage (X),
 *      Report Size (16),
 *      Report Count (1),
 *      Push,
 *      Unit Exponent (13),
 *      Unit (Inch^3),
 *      Logical Minimum (0),
 *      Logical Maximum (18000),
 *      Physical Minimum (0),
 *      Physical Maximum (18000),
 *      Input (Variable),
 *      Usage (Y),
 *      Logical Maximum (11000),
 *      Physical Maximum (11000),
 *      Input (Variable),
 *      Usage Page (Digitizer),
 *      Usage (Tip Pressure),
 *      Logical Minimum (0),
 *      Logical Maximum (1023),
 *      Physical Minimum (0),
 *      Physical Maximum (1023),
 *      Input (Variable),
 *    End Collection,
 *  End Collection,
 *  Usage Page (Desktop),
 *  Usage (Keyboard),
 *  Collection (Application),
 *    Report ID (13),
 *    Usage Page (Keyboard),
 *    Usage Minimum (KB Leftcontrol),
 *    Usage Maximum (KB Right GUI),
 *    Logical Minimum (0),
 *    Logical Maximum (1),
 *    Report Size (1),
 *    Report Count (8),
 *    Input (Variable),
 *    Report Size (8),
 *    Report Count (1),
 *    Input (Constant),
 *    Usage Page (Keyboard),
 *    Usage Minimum (None),
 *    Usage Maximum (KB Application),
 *    Logical Minimum (0),
 *    Logical Maximum (101),
 *    Report Size (8),
 *    Report Count (5),
 *    Input,
 *  End Collection,
 *  Usage Page (Consumer),
 *  Usage (Consumer Control),
 *  Collection (Application),
 *    Report ID (12),
 *    Usage (Volume Inc),
 *    Usage (Volume Dec),
 *    Usage (Mute),
 *    Logical Minimum (0),
 *    Logical Maximum (1),
 *    Report Size (1),
 *    Report Count (3),
 *    Input (Variable, Relative),
 *    Report Size (5),
 *    Report Count (1),
 *    Input (Constant, Variable, Relative),
 *  End Collection
 */

/* Size of the original report descriptor of Media Tablet 10.6 inch */
#define MEDIA_TABLET_10_6_INCH_RDESC_ORIG_SIZE	300

/*
 * Fixed Media Tablet 10.6 inch descriptor.
 *
 * The descriptions of reports unused in the default configuration are
 * removed. The stylus report (ID 16) is fixed similarly to Slim Tablet 5.8
 * inch.  The unused mouse report (ID 1) fields are replaced with constant
 * padding.
 *
 * The keyboard report (ID 13) is hacked to instead have an "array" field
 * reporting consumer page controls, and all the unused bits are masked out
 * with constant padding. The "brush" wheels' function is represented as "Scan
 * Previous/Next Track" controls due to the lack of brush controls in the
 * usage tables specification.
 */
static __u8 media_tablet_10_6_inch_rdesc_fixed[] = {
	0x05, 0x0D,         /*  Usage Page (Digitizer),             */
	0x09, 0x02,         /*  Usage (Pen),                        */
	0xA1, 0x01,         /*  Collection (Application),           */
	0x85, 0x10,         /*      Report ID (16),                 */
	0x09, 0x20,         /*      Usage (Stylus),                 */
	0xA0,               /*      Collection (Physical),          */
	0x09, 0x42,         /*          Usage (Tip Switch),         */
	0x09, 0x44,         /*          Usage (Barrel Switch),      */
	0x09, 0x46,         /*          Usage (Tablet Pick),        */
	0x15, 0x01,         /*          Logical Minimum (1),        */
	0x25, 0x03,         /*          Logical Maximum (3),        */
	0x75, 0x04,         /*          Report Size (4),            */
	0x95, 0x01,         /*          Report Count (1),           */
	0x80,               /*          Input,                      */
	0x75, 0x01,         /*          Report Size (1),            */
	0x09, 0x32,         /*          Usage (In Range),           */
	0x14,               /*          Logical Minimum (0),        */
	0x25, 0x01,         /*          Logical Maximum (1),        */
	0x95, 0x01,         /*          Report Count (1),           */
	0x81, 0x02,         /*          Input (Variable),           */
	0x95, 0x03,         /*          Report Count (3),           */
	0x81, 0x03,         /*          Input (Constant, Variable), */
	0x75, 0x10,         /*          Report Size (16),           */
	0x95, 0x01,         /*          Report Count (1),           */
	0x14,               /*          Logical Minimum (0),        */
	0xA4,               /*          Push,                       */
	0x05, 0x01,         /*          Usage Page (Desktop),       */
	0x65, 0x13,         /*          Unit (Inch),                */
	0x55, 0xFD,         /*          Unit Exponent (-3),         */
	0x34,               /*          Physical Minimum (0),       */
	0x09, 0x30,         /*          Usage (X),                  */
	0x46, 0x28, 0x23,   /*          Physical Maximum (9000),    */
	0x26, 0x50, 0x46,   /*          Logical Maximum (18000),    */
	0x81, 0x02,         /*          Input (Variable),           */
	0x09, 0x31,         /*          Usage (Y),                  */
	0x46, 0x7C, 0x15,   /*          Physical Maximum (5500),    */
	0x26, 0xF8, 0x2A,   /*          Logical Maximum (11000),    */
	0x81, 0x02,         /*          Input (Variable),           */
	0xB4,               /*          Pop,                        */
	0x09, 0x30,         /*          Usage (Tip Pressure),       */
	0x26, 0xFF, 0x03,   /*          Logical Maximum (1023),     */
	0x81, 0x02,         /*          Input (Variable),           */
	0xC0,               /*      End Collection,                 */
	0xC0,               /*  End Collection,                     */
	0x05, 0x01,         /*  Usage Page (Desktop),               */
	0x09, 0x02,         /*  Usage (Mouse),                      */
	0xA1, 0x01,         /*  Collection (Application),           */
	0x85, 0x01,         /*      Report ID (1),                  */
	0x09, 0x01,         /*      Usage (Pointer),                */
	0xA0,               /*      Collection (Physical),          */
	0x75, 0x08,         /*          Report Size (8),            */
	0x95, 0x03,         /*          Report Count (3),           */
	0x81, 0x03,         /*          Input (Constant, Variable), */
	0x95, 0x02,         /*          Report Count (2),           */
	0x15, 0xFF,         /*          Logical Minimum (-1),       */
	0x25, 0x01,         /*          Logical Maximum (1),        */
	0x09, 0x38,         /*          Usage (Wheel),              */
	0x0B, 0x38, 0x02,   /*          Usage (Consumer AC Pan),    */
		0x0C, 0x00,
	0x81, 0x06,         /*          Input (Variable, Relative), */
	0x95, 0x02,         /*          Report Count (2),           */
	0x81, 0x03,         /*          Input (Constant, Variable), */
	0xC0,               /*      End Collection,                 */
	0xC0,               /*  End Collection,                     */
	0x05, 0x0C,         /*  Usage Page (Consumer),              */
	0x09, 0x01,         /*  Usage (Consumer Control),           */
	0xA1, 0x01,         /*  Collection (Application),           */
	0x85, 0x0D,         /*      Report ID (13),                 */
	0x95, 0x01,         /*      Report Count (1),               */
	0x75, 0x10,         /*      Report Size (16),               */
	0x81, 0x03,         /*      Input (Constant, Variable),     */
	0x0A, 0x2F, 0x02,   /*      Usage (AC Zoom),                */
	0x0A, 0x2E, 0x02,   /*      Usage (AC Zoom Out),            */
	0x0A, 0x2D, 0x02,   /*      Usage (AC Zoom In),             */
	0x09, 0xB6,         /*      Usage (Scan Previous Track),    */
	0x09, 0xB5,         /*      Usage (Scan Next Track),        */
	0x08,               /*      Usage (00h),                    */
	0x08,               /*      Usage (00h),                    */
	0x08,               /*      Usage (00h),                    */
	0x08,               /*      Usage (00h),                    */
	0x08,               /*      Usage (00h),                    */
	0x0A, 0x2E, 0x02,   /*      Usage (AC Zoom Out),            */
	0x0A, 0x2D, 0x02,   /*      Usage (AC Zoom In),             */
	0x15, 0x0C,         /*      Logical Minimum (12),           */
	0x25, 0x17,         /*      Logical Maximum (23),           */
	0x75, 0x05,         /*      Report Size (5),                */
	0x80,               /*      Input,                          */
	0x75, 0x03,         /*      Report Size (3),                */
	0x81, 0x03,         /*      Input (Constant, Variable),     */
	0x75, 0x20,         /*      Report Size (32),               */
	0x81, 0x03,         /*      Input (Constant, Variable),     */
	0xC0,               /*  End Collection,                     */
	0x09, 0x01,         /*  Usage (Consumer Control),           */
	0xA1, 0x01,         /*  Collection (Application),           */
	0x85, 0x0C,         /*      Report ID (12),                 */
	0x75, 0x01,         /*      Report Size (1),                */
	0x09, 0xE9,         /*      Usage (Volume Inc),             */
	0x09, 0xEA,         /*      Usage (Volume Dec),             */
	0x09, 0xE2,         /*      Usage (Mute),                   */
	0x14,               /*      Logical Minimum (0),            */
	0x25, 0x01,         /*      Logical Maximum (1),            */
	0x95, 0x03,         /*      Report Count (3),               */
	0x81, 0x06,         /*      Input (Variable, Relative),     */
	0x95, 0x35,         /*      Report Count (53),              */
	0x81, 0x03,         /*      Input (Constant, Variable),     */
	0xC0                /*  End Collection                      */
};

/*
 * Original Media Tablet 14.1 inch report descriptor.
 *
 * There are at least two versions of this model in the wild. They are
 * represented by Genius G-Pen M712 (older version) and Genius G-Pen M712X
 * (newer version). The hardware difference between these versions is the same
 * as between older and newer versions of Media Tablet 10.6 inch. The report
 * descriptors are identical for both versions.
 *
 * The function, behavior and report descriptor of this tablet is similar to
 * that of Media Tablet 10.6 inch. However, there is one more field (with
 * Consumer AC Pan usage) in the mouse description. Then the tablet X and Y
 * logical extents both get scaled to 0..16383 range (a hardware limit?),
 * which kind of defeats the advertised 4000 LPI resolution, considering the
 * physical extents of 12x7.25 inches. Plus, reports 5, 10 and 255 are used
 * sometimes (while moving the pen) with unknown purpose. Also, the key codes
 * generated for zoom in/out are different.
 *
 *  Usage Page (Desktop),
 *  Usage (Mouse),
 *  Collection (Application),
 *    Report ID (1),
 *    Usage (Pointer),
 *    Collection (Physical),
 *      Usage Page (Button),
 *      Usage Minimum (01h),
 *      Usage Maximum (05h),
 *      Logical Minimum (0),
 *      Logical Maximum (1),
 *      Report Size (1),
 *      Report Count (5),
 *      Input (Variable),
 *      Report Size (3),
 *      Report Count (1),
 *      Input (Constant, Variable),
 *      Usage Page (Desktop),
 *      Usage (X),
 *      Usage (Y),
 *      Usage (Wheel),
 *      Logical Minimum (-127),
 *      Logical Maximum (127),
 *      Report Size (8),
 *      Report Count (3),
 *      Input (Variable, Relative),
 *      Usage Page (Consumer),
 *      Logical Minimum (-127),
 *      Logical Maximum (127),
 *      Report Size (8),
 *      Report Count (1),
 *      Usage (AC Pan),
 *      Input (Variable, Relative),
 *    End Collection,
 *  End Collection,
 *  Usage Page (Digitizer),
 *  Usage (Pen),
 *  Collection (Application),
 *    Report ID (2),
 *    Usage (Stylus),
 *    Collection (Physical),
 *      Usage (00h),
 *      Logical Minimum (0),
 *      Logical Maximum (255),
 *      Report Size (8),
 *      Report Count (7),
 *      Input (Variable),
 *      Usage (Azimuth),
 *      Usage (Altitude),
 *      Logical Minimum (0),
 *      Logical Maximum (255),
 *      Report Size (8),
 *      Report Count (2),
 *      Feature (Variable),
 *    End Collection,
 *    Report ID (5),
 *    Usage Page (Digitizer),
 *    Usage (Stylus),
 *    Collection (Physical),
 *      Usage (00h),
 *      Logical Minimum (0),
 *      Logical Maximum (255),
 *      Report Size (8),
 *      Report Count (7),
 *      Input (Variable),
 *    End Collection,
 *    Report ID (10),
 *    Usage Page (Digitizer),
 *    Usage (Stylus),
 *    Collection (Physical),
 *      Usage (00h),
 *      Logical Minimum (0),
 *      Logical Maximum (255),
 *      Report Size (8),
 *      Report Count (7),
 *      Input (Variable),
 *    End Collection,
 *    Report ID (16),
 *    Usage (Stylus),
 *    Collection (Physical),
 *      Usage (Tip Switch),
 *      Usage (Barrel Switch),
 *      Usage (Invert),
 *      Usage (Eraser),
 *      Usage (In Range),
 *      Logical Minimum (0),
 *      Logical Maximum (1),
 *      Report Size (1),
 *      Report Count (5),
 *      Input (Variable),
 *      Report Count (3),
 *      Input (Constant, Variable),
 *      Usage Page (Desktop),
 *      Usage (X),
 *      Report Size (16),
 *      Report Count (1),
 *      Push,
 *      Unit Exponent (13),
 *      Unit (Inch^3),
 *      Logical Minimum (0),
 *      Logical Maximum (16383),
 *      Physical Minimum (0),
 *      Physical Maximum (16383),
 *      Input (Variable),
 *      Usage (Y),
 *      Input (Variable),
 *      Usage Page (Digitizer),
 *      Usage (Tip Pressure),
 *      Logical Minimum (0),
 *      Logical Maximum (1023),
 *      Physical Minimum (0),
 *      Physical Maximum (1023),
 *      Input (Variable),
 *    End Collection,
 *  End Collection,
 *  Usage Page (Desktop),
 *  Usage (Keyboard),
 *  Collection (Application),
 *    Report ID (13),
 *    Usage Page (Keyboard),
 *    Usage Minimum (KB Leftcontrol),
 *    Usage Maximum (KB Right GUI),
 *    Logical Minimum (0),
 *    Logical Maximum (1),
 *    Report Size (1),
 *    Report Count (8),
 *    Input (Variable),
 *    Report Size (8),
 *    Report Count (1),
 *    Input (Constant),
 *    Usage Page (Keyboard),
 *    Usage Minimum (None),
 *    Usage Maximum (KB Application),
 *    Logical Minimum (0),
 *    Logical Maximum (101),
 *    Report Size (8),
 *    Report Count (5),
 *    Input,
 *  End Collection,
 *  Usage Page (Consumer),
 *  Usage (Consumer Control),
 *  Collection (Application),
 *    Report ID (12),
 *    Usage (Volume Inc),
 *    Usage (Volume Dec),
 *    Usage (Mute),
 *    Logical Minimum (0),
 *    Logical Maximum (1),
 *    Report Size (1),
 *    Report Count (3),
 *    Input (Variable, Relative),
 *    Report Size (5),
 *    Report Count (1),
 *    Input (Constant, Variable, Relative),
 *  End Collection
 */

/* Size of the original report descriptor of Media Tablet 14.1 inch */
#define MEDIA_TABLET_14_1_INCH_RDESC_ORIG_SIZE	309

/*
 * Fixed Media Tablet 14.1 inch descriptor.
 * It is fixed similarly to the Media Tablet 10.6 inch descriptor.
 */
static __u8 media_tablet_14_1_inch_rdesc_fixed[] = {
	0x05, 0x0D,         /*  Usage Page (Digitizer),             */
	0x09, 0x02,         /*  Usage (Pen),                        */
	0xA1, 0x01,         /*  Collection (Application),           */
	0x85, 0x10,         /*      Report ID (16),                 */
	0x09, 0x20,         /*      Usage (Stylus),                 */
	0xA0,               /*      Collection (Physical),          */
	0x09, 0x42,         /*          Usage (Tip Switch),         */
	0x09, 0x44,         /*          Usage (Barrel Switch),      */
	0x09, 0x46,         /*          Usage (Tablet Pick),        */
	0x15, 0x01,         /*          Logical Minimum (1),        */
	0x25, 0x03,         /*          Logical Maximum (3),        */
	0x75, 0x04,         /*          Report Size (4),            */
	0x95, 0x01,         /*          Report Count (1),           */
	0x80,               /*          Input,                      */
	0x75, 0x01,         /*          Report Size (1),            */
	0x09, 0x32,         /*          Usage (In Range),           */
	0x14,               /*          Logical Minimum (0),        */
	0x25, 0x01,         /*          Logical Maximum (1),        */
	0x95, 0x01,         /*          Report Count (1),           */
	0x81, 0x02,         /*          Input (Variable),           */
	0x95, 0x03,         /*          Report Count (3),           */
	0x81, 0x03,         /*          Input (Constant, Variable), */
	0x75, 0x10,         /*          Report Size (16),           */
	0x95, 0x01,         /*          Report Count (1),           */
	0x14,               /*          Logical Minimum (0),        */
	0xA4,               /*          Push,                       */
	0x05, 0x01,         /*          Usage Page (Desktop),       */
	0x65, 0x13,         /*          Unit (Inch),                */
	0x55, 0xFD,         /*          Unit Exponent (-3),         */
	0x34,               /*          Physical Minimum (0),       */
	0x09, 0x30,         /*          Usage (X),                  */
	0x46, 0xE0, 0x2E,   /*          Physical Maximum (12000),   */
	0x26, 0xFF, 0x3F,   /*          Logical Maximum (16383),    */
	0x81, 0x02,         /*          Input (Variable),           */
	0x09, 0x31,         /*          Usage (Y),                  */
	0x46, 0x52, 0x1C,   /*          Physical Maximum (7250),    */
	0x26, 0xFF, 0x3F,   /*          Logical Maximum (16383),    */
	0x81, 0x02,         /*          Input (Variable),           */
	0xB4,               /*          Pop,                        */
	0x09, 0x30,         /*          Usage (Tip Pressure),       */
	0x26, 0xFF, 0x03,   /*          Logical Maximum (1023),     */
	0x81, 0x02,         /*          Input (Variable),           */
	0xC0,               /*      End Collection,                 */
	0xC0,               /*  End Collection,                     */
	0x05, 0x01,         /*  Usage Page (Desktop),               */
	0x09, 0x02,         /*  Usage (Mouse),                      */
	0xA1, 0x01,         /*  Collection (Application),           */
	0x85, 0x01,         /*      Report ID (1),                  */
	0x09, 0x01,         /*      Usage (Pointer),                */
	0xA0,               /*      Collection (Physical),          */
	0x75, 0x08,         /*          Report Size (8),            */
	0x95, 0x03,         /*          Report Count (3),           */
	0x81, 0x03,         /*          Input (Constant, Variable), */
	0x95, 0x02,         /*          Report Count (2),           */
	0x15, 0xFF,         /*          Logical Minimum (-1),       */
	0x25, 0x01,         /*          Logical Maximum (1),        */
	0x09, 0x38,         /*          Usage (Wheel),              */
	0x0B, 0x38, 0x02,   /*          Usage (Consumer AC Pan),    */
		0x0C, 0x00,
	0x81, 0x06,         /*          Input (Variable, Relative), */
	0xC0,               /*      End Collection,                 */
	0xC0,               /*  End Collection,                     */
	0x05, 0x0C,         /*  Usage Page (Consumer),              */
	0x09, 0x01,         /*  Usage (Consumer Control),           */
	0xA1, 0x01,         /*  Collection (Application),           */
	0x85, 0x0D,         /*      Report ID (13),                 */
	0x95, 0x01,         /*      Report Count (1),               */
	0x75, 0x10,         /*      Report Size (16),               */
	0x81, 0x03,         /*      Input (Constant, Variable),     */
	0x0A, 0x2F, 0x02,   /*      Usage (AC Zoom),                */
	0x0A, 0x2E, 0x02,   /*      Usage (AC Zoom Out),            */
	0x0A, 0x2D, 0x02,   /*      Usage (AC Zoom In),             */
	0x09, 0xB6,         /*      Usage (Scan Previous Track),    */
	0x09, 0xB5,         /*      Usage (Scan Next Track),        */
	0x08,               /*      Usage (00h),                    */
	0x08,               /*      Usage (00h),                    */
	0x08,               /*      Usage (00h),                    */
	0x08,               /*      Usage (00h),                    */
	0x08,               /*      Usage (00h),                    */
	0x0A, 0x2E, 0x02,   /*      Usage (AC Zoom Out),            */
	0x0A, 0x2D, 0x02,   /*      Usage (AC Zoom In),             */
	0x15, 0x0C,         /*      Logical Minimum (12),           */
	0x25, 0x17,         /*      Logical Maximum (23),           */
	0x75, 0x05,         /*      Report Size (5),                */
	0x80,               /*      Input,                          */
	0x75, 0x03,         /*      Report Size (3),                */
	0x81, 0x03,         /*      Input (Constant, Variable),     */
	0x75, 0x20,         /*      Report Size (32),               */
	0x81, 0x03,         /*      Input (Constant, Variable),     */
	0xC0,               /*  End Collection,                     */
	0x09, 0x01,         /*  Usage (Consumer Control),           */
	0xA1, 0x01,         /*  Collection (Application),           */
	0x85, 0x0C,         /*      Report ID (12),                 */
	0x75, 0x01,         /*      Report Size (1),                */
	0x09, 0xE9,         /*      Usage (Volume Inc),             */
	0x09, 0xEA,         /*      Usage (Volume Dec),             */
	0x09, 0xE2,         /*      Usage (Mute),                   */
	0x14,               /*      Logical Minimum (0),            */
	0x25, 0x01,         /*      Logical Maximum (1),            */
	0x95, 0x03,         /*      Report Count (3),               */
	0x81, 0x06,         /*      Input (Variable, Relative),     */
	0x75, 0x05,         /*      Report Size (5),                */
	0x81, 0x03,         /*      Input (Constant, Variable),     */
	0xC0                /*  End Collection                      */
};

static __u8 *waltop_report_fixup(struct hid_device *hdev, __u8 *rdesc,
		unsigned int *rsize)
{
	switch (hdev->product) {
	case USB_DEVICE_ID_WALTOP_SLIM_TABLET_5_8_INCH:
		if (*rsize == SLIM_TABLET_5_8_INCH_RDESC_ORIG_SIZE) {
			rdesc = slim_tablet_5_8_inch_rdesc_fixed;
			*rsize = sizeof(slim_tablet_5_8_inch_rdesc_fixed);
		}
		break;
	case USB_DEVICE_ID_WALTOP_SLIM_TABLET_12_1_INCH:
		if (*rsize == SLIM_TABLET_12_1_INCH_RDESC_ORIG_SIZE) {
			rdesc = slim_tablet_12_1_inch_rdesc_fixed;
			*rsize = sizeof(slim_tablet_12_1_inch_rdesc_fixed);
		}
		break;
	case USB_DEVICE_ID_WALTOP_MEDIA_TABLET_10_6_INCH:
		if (*rsize == MEDIA_TABLET_10_6_INCH_RDESC_ORIG_SIZE) {
			rdesc = media_tablet_10_6_inch_rdesc_fixed;
			*rsize = sizeof(media_tablet_10_6_inch_rdesc_fixed);
		}
		break;
	case USB_DEVICE_ID_WALTOP_MEDIA_TABLET_14_1_INCH:
		if (*rsize == MEDIA_TABLET_14_1_INCH_RDESC_ORIG_SIZE) {
			rdesc = media_tablet_14_1_inch_rdesc_fixed;
			*rsize = sizeof(media_tablet_14_1_inch_rdesc_fixed);
		}
		break;
	}
	return rdesc;
}

static const struct hid_device_id waltop_devices[] = {
	{ HID_USB_DEVICE(USB_VENDOR_ID_WALTOP,
				USB_DEVICE_ID_WALTOP_SLIM_TABLET_5_8_INCH) },
	{ HID_USB_DEVICE(USB_VENDOR_ID_WALTOP,
				USB_DEVICE_ID_WALTOP_SLIM_TABLET_12_1_INCH) },
	{ HID_USB_DEVICE(USB_VENDOR_ID_WALTOP,
				USB_DEVICE_ID_WALTOP_MEDIA_TABLET_10_6_INCH) },
	{ HID_USB_DEVICE(USB_VENDOR_ID_WALTOP,
				USB_DEVICE_ID_WALTOP_MEDIA_TABLET_14_1_INCH) },
	{ }
};
MODULE_DEVICE_TABLE(hid, waltop_devices);

static struct hid_driver waltop_driver = {
	.name = "waltop",
	.id_table = waltop_devices,
	.report_fixup = waltop_report_fixup,
};

static int __init waltop_init(void)
{
	return hid_register_driver(&waltop_driver);
}

static void __exit waltop_exit(void)
{
	hid_unregister_driver(&waltop_driver);
}

module_init(waltop_init);
module_exit(waltop_exit);
MODULE_LICENSE("GPL");