I am sponsoring this fast-track for Pengcheng Chen of the USB team.
The timer is set for next Thursday, November 19. The release binding
requested is "Patch". A copy of the usbwcm(7m) draft man page is
available in the case materials directory as usbwcm.7m.txt.
-Alan Coopersmith- alan.coopersmith at sun.com
Sun Microsystems, Inc. - X Window System Engineering
Template Version: @(#)sac_nextcase 1.68 02/23/09 SMI
This information is Copyright 2009 Sun Microsystems
1. Introduction
1.1. Project/Component Working Name:
usbwcm: Wacom USB Tablet STREAMS module
1.2. Name of Document Author/Supplier:
Author: Pengcheng Chen
1.3 Date of This Document:
12 November, 2009
2. Project Summary
2.1. Project Description:
This case provides a STREAMS module to support Wacom USB tablets[1].
Wacom USB tablets are popular and used in applications, such as
GIMP, Inkscape, and etc.
This module is a port of the FreeBSD uwacom driver[2], which
implements necessary interfaces for the Wacom X.org XInput driver[3]
to work.
3. Business Summary
3.1. Problem Area:
Solaris has no built-in support for Wacom USB tablets. Users can
not use these tablets out-of-box. Drivers for Wacom tablets are
available under other major OSes (like Windows and Linux).
4. Technical Description:
4.1. Details:
Wacom USB Tablet STREAMS module is developed under the current
Solaris USB Architecture (USBA) and the minimal Human Interface
Device (HID) framework.
The usbwcm module implements the same IOCTLs and input event format
as FreeBSD uwacom driver does. With these interfaces, the Wacom Xorg
XInput driver can be ported to Solaris with minor modifications.
The usbwcm module must be pushed on top of the HID class driver
(see hid(7D)). The usbwcm module translates data from Wacom USB tablet
into input events expected by Wacom Xorg XInput driver.
4.2. Bug/RFE Number(s):
4.3. In Scope:
Provide a STREAMS module supporting of the following Wacom USB Tablets:
Wacom Graphire3
Wacom Graphire4
Wacom Bamboo
Wacom Bamboo Fun
Wacom Intuos3
Wacom Intuos4
Wacom Cintiq 21UX
4.4. Out of Scope:
For Wacom tablets to work out-of-box, the Wacom Xorg XInput driver
and configuration tools[3] are also necessary. Providing support
in Xorg is a follow-on project - until it is available, users
can download the wacom driver sources from X.Org and build and
run them on their own.
4.5. Interfaces:
+----------------------------------------------------------------------+
| Interfaces Exported |
+----------------------------------------------------------------------+
| Interface |Stability label| Comments |
|----------------------------------------------------------------------|
| EVTIOCGVERSION | Uncommitted | Get current version of the event |
| | | interface implemented in this |
| | | module |
| | | |
| EVTIOCGDEVID | Uncommitted | Get device IDs |
| EVTIOCGBM | Uncommitted | Get bitmap of events reported by |
| | | the device |
| | | |
| EVTIOCGABS | Uncommitted | Get absolute valuator parameters |
+----------------------------------------------------------------------+
4.6. Doc Impact:
man page: usbwcm(7M)
4.7. Admin/Config Impact:
Configuration tools are provided with Wacom Xorg XInput driver[3],
which has no direct interation with this STREAMS module.
4.10. Packaging & Delivery:
This STREAMS module will be integrated as part of the exising SUNWusb
package.
5. Reference Documents:
[1] Wacom website
http://www.wacom.com
[2] FreeBSD uwacom driver
http://www.freshports.org/x11-drivers/input-wacom
[3] Wacom X.org XInput driver
http://linuxwacom.sourceforge.net
6. Resources and Schedule
6.4. Steering Committee requested information
6.4.1. Consolidation C-team Name:
ON
6.5. ARC review type: FastTrack
6.6. ARC Exposure: open
