wacom.h 7.66 KB
Newer Older
1
/* SPDX-License-Identifier: GPL-2.0-or-later */
2
/*
3
 * drivers/input/tablet/wacom.h
4
 *
5
 *  USB Wacom tablet support
6 7 8 9 10 11 12 13 14
 *
 *  Copyright (c) 2000-2004 Vojtech Pavlik	<vojtech@ucw.cz>
 *  Copyright (c) 2000 Andreas Bach Aaen	<abach@stofanet.dk>
 *  Copyright (c) 2000 Clifford Wolf		<clifford@clifford.at>
 *  Copyright (c) 2000 Sam Mosel		<sam.mosel@computer.org>
 *  Copyright (c) 2000 James E. Blair		<corvus@gnu.org>
 *  Copyright (c) 2000 Daniel Egger		<egger@suse.de>
 *  Copyright (c) 2001 Frederic Lepied		<flepied@mandrakesoft.com>
 *  Copyright (c) 2004 Panagiotis Issaris	<panagiotis.issaris@mech.kuleuven.ac.be>
15
 *  Copyright (c) 2002-2011 Ping Cheng		<pingc@wacom.com>
16
 *  Copyright (c) 2014 Benjamin Tissoires	<benjamin.tissoires@redhat.com>
17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66
 *
 *  ChangeLog:
 *      v0.1 (vp)  - Initial release
 *      v0.2 (aba) - Support for all buttons / combinations
 *      v0.3 (vp)  - Support for Intuos added
 *	v0.4 (sm)  - Support for more Intuos models, menustrip
 *			relative mode, proximity.
 *	v0.5 (vp)  - Big cleanup, nifty features removed,
 *			they belong in userspace
 *	v1.8 (vp)  - Submit URB only when operating, moved to CVS,
 *			use input_report_key instead of report_btn and
 *			other cleanups
 *	v1.11 (vp) - Add URB ->dev setting for new kernels
 *	v1.11 (jb) - Add support for the 4D Mouse & Lens
 *	v1.12 (de) - Add support for two more inking pen IDs
 *	v1.14 (vp) - Use new USB device id probing scheme.
 *		     Fix Wacom Graphire mouse wheel
 *	v1.18 (vp) - Fix mouse wheel direction
 *		     Make mouse relative
 *      v1.20 (fl) - Report tool id for Intuos devices
 *                 - Multi tools support
 *                 - Corrected Intuos protocol decoding (airbrush, 4D mouse, lens cursor...)
 *                 - Add PL models support
 *		   - Fix Wacom Graphire mouse wheel again
 *	v1.21 (vp) - Removed protocol descriptions
 *		   - Added MISC_SERIAL for tool serial numbers
 *	      (gb) - Identify version on module load.
 *    v1.21.1 (fl) - added Graphire2 support
 *    v1.21.2 (fl) - added Intuos2 support
 *                 - added all the PL ids
 *    v1.21.3 (fl) - added another eraser id from Neil Okamoto
 *                 - added smooth filter for Graphire from Peri Hankey
 *                 - added PenPartner support from Olaf van Es
 *                 - new tool ids from Ole Martin Bjoerndalen
 *	v1.29 (pc) - Add support for more tablets
 *		   - Fix pressure reporting
 *	v1.30 (vp) - Merge 2.4 and 2.5 drivers
 *		   - Since 2.5 now has input_sync(), remove MSC_SERIAL abuse
 *		   - Cleanups here and there
 *    v1.30.1 (pi) - Added Graphire3 support
 *	v1.40 (pc) - Add support for several new devices, fix eraser reporting, ...
 *	v1.43 (pc) - Added support for Cintiq 21UX
 *		   - Fixed a Graphire bug
 *		   - Merged wacom_intuos3_irq into wacom_intuos_irq
 *	v1.44 (pc) - Added support for Graphire4, Cintiq 710, Intuos3 6x11, etc.
 *		   - Report Device IDs
 *      v1.45 (pc) - Added support for DTF 521, Intuos3 12x12 and 12x19
 *                 - Minor data report fix
 *      v1.46 (pc) - Split wacom.c into wacom_sys.c and wacom_wac.c,
 *		   - where wacom_sys.c deals with system specific code,
67
 *		   - and wacom_wac.c deals with Wacom specific code
Ping Cheng's avatar
Ping Cheng committed
68
 *		   - Support Intuos3 4x6
69
 *      v1.47 (pc) - Added support for Bamboo
70
 *      v1.48 (pc) - Added support for Bamboo1, BambooFun, and Cintiq 12WX
71
 *      v1.49 (pc) - Added support for USB Tablet PC (0x90, 0x93, and 0x9A)
72
 *      v1.50 (pc) - Fixed a TabletPC touch bug in 2.6.28
73
 *      v1.51 (pc) - Added support for Intuos4
74
 *      v1.52 (pc) - Query Wacom data upon system resume
75
 *                 - add defines for features->type
76
 *                 - add new devices (0x9F, 0xE2, and 0XE3)
77 78
 *      v2.00 (bt) - conversion to a HID driver
 *                 - integration of the Bluetooth devices
79 80 81 82 83 84 85 86 87
 */

/*
 */
#ifndef WACOM_H
#define WACOM_H
#include <linux/kernel.h>
#include <linux/slab.h>
#include <linux/module.h>
88
#include <linux/mod_devicetable.h>
89
#include <linux/hid.h>
90
#include <linux/kfifo.h>
91
#include <linux/leds.h>
92
#include <linux/usb/input.h>
93
#include <linux/power_supply.h>
94 95 96 97 98
#include <asm/unaligned.h>

/*
 * Version Information
 */
99
#define DRIVER_VERSION "v2.00"
100
#define DRIVER_AUTHOR "Vojtech Pavlik <vojtech@ucw.cz>"
101
#define DRIVER_DESC "USB Wacom tablet driver"
102 103

#define USB_VENDOR_ID_WACOM	0x056a
104
#define USB_VENDOR_ID_LENOVO	0x17ef
105

106 107 108
enum wacom_worker {
	WACOM_WORKER_WIRELESS,
	WACOM_WORKER_BATTERY,
109
	WACOM_WORKER_REMOTE,
110
	WACOM_WORKER_MODE_CHANGE,
111 112
};

113 114 115 116 117 118 119 120 121 122 123 124 125
struct wacom;

struct wacom_led {
	struct led_classdev cdev;
	struct led_trigger trigger;
	struct wacom *wacom;
	unsigned int group;
	unsigned int id;
	u8 llv;
	u8 hlv;
	bool held;
};

126 127
struct wacom_group_leds {
	u8 select; /* status led selector (0..3) */
128 129
	struct wacom_led *leds;
	unsigned int count;
130
	struct device *dev;
131 132
};

133
struct wacom_battery {
134
	struct wacom *wacom;
135 136 137
	struct power_supply_desc bat_desc;
	struct power_supply *battery;
	char bat_name[WACOM_NAME_MAX];
138
	int bat_status;
139 140 141 142 143 144
	int battery_capacity;
	int bat_charging;
	int bat_connected;
	int ps_connected;
};

145 146 147 148
struct wacom_remote {
	spinlock_t remote_lock;
	struct kfifo remote_fifo;
	struct kobject *remote_dir;
149 150 151
	struct {
		struct attribute_group group;
		u32 serial;
152 153
		struct input_dev *input;
		bool registered;
154
		struct wacom_battery battery;
155
	} remotes[WACOM_MAX_REMOTES];
156 157
};

158 159
struct wacom {
	struct usb_device *usbdev;
160
	struct usb_interface *intf;
161
	struct wacom_wac wacom_wac;
162
	struct hid_device *hdev;
163
	struct mutex lock;
164 165
	struct work_struct wireless_work;
	struct work_struct battery_work;
166
	struct work_struct remote_work;
167
	struct delayed_work init_work;
168
	struct wacom_remote *remote;
169
	struct work_struct mode_change_work;
170
	bool generic_has_leds;
171 172
	struct wacom_leds {
		struct wacom_group_leds *groups;
173
		unsigned int count;
174 175
		u8 llv;       /* status led brightness no button (1..127) */
		u8 hlv;       /* status led brightness button pressed (1..127) */
176
		u8 img_lum;   /* OLED matrix display brightness */
177 178
		u8 max_llv;   /* maximum brightness of LED (llv) */
		u8 max_hlv;   /* maximum brightness of LED (hlv) */
179
	} led;
180
	struct wacom_battery battery;
181
	bool resources;
182 183
};

184 185
static inline void wacom_schedule_work(struct wacom_wac *wacom_wac,
				       enum wacom_worker which)
186 187
{
	struct wacom *wacom = container_of(wacom_wac, struct wacom, wacom_wac);
188 189 190 191 192 193 194 195

	switch (which) {
	case WACOM_WORKER_WIRELESS:
		schedule_work(&wacom->wireless_work);
		break;
	case WACOM_WORKER_BATTERY:
		schedule_work(&wacom->battery_work);
		break;
196 197 198
	case WACOM_WORKER_REMOTE:
		schedule_work(&wacom->remote_work);
		break;
199 200 201
	case WACOM_WORKER_MODE_CHANGE:
		schedule_work(&wacom->mode_change_work);
		break;
202
	}
203 204
}

205
extern const struct hid_device_id wacom_ids[];
206

207
void wacom_wac_irq(struct wacom_wac *wacom_wac, size_t len);
208
void wacom_setup_device_quirks(struct wacom *wacom);
209 210 211
int wacom_setup_pen_input_capabilities(struct input_dev *input_dev,
				   struct wacom_wac *wacom_wac);
int wacom_setup_touch_input_capabilities(struct input_dev *input_dev,
212
				   struct wacom_wac *wacom_wac);
213 214
int wacom_setup_pad_input_capabilities(struct input_dev *input_dev,
				       struct wacom_wac *wacom_wac);
215 216
void wacom_wac_usage_mapping(struct hid_device *hdev,
		struct hid_field *field, struct hid_usage *usage);
217
void wacom_wac_event(struct hid_device *hdev, struct hid_field *field,
218 219
		struct hid_usage *usage, __s32 value);
void wacom_wac_report(struct hid_device *hdev, struct hid_report *report);
220
void wacom_battery_work(struct work_struct *work);
221 222 223 224
enum led_brightness wacom_leds_brightness_get(struct wacom_led *led);
struct wacom_led *wacom_led_find(struct wacom *wacom, unsigned int group,
				 unsigned int id);
struct wacom_led *wacom_led_next(struct wacom *wacom, struct wacom_led *cur);
225
int wacom_equivalent_usage(int usage);
226
int wacom_initialize_leds(struct wacom *wacom);
227
#endif