Blame view

Documentation/usb/mtouchusb.rst 2.77 KB
d80b5005c   Mauro Carvalho Chehab   docs: usb: conver...
1
2
3
4
5
6
  ================
  mtouchusb driver
  ================
  
  Changes
  =======
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
7
8
  
  - 0.3 - Created based off of scanner & INSTALL from the original touchscreen
1f8ee46b4   Masanari Iida   Documentation: Fi...
9
    driver on freecode (http://freecode.com/projects/3mtouchscreendriver)
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
10
11
12
  - Amended for linux-2.4.18, then 2.4.19
  
  - 0.5 - Complete rewrite using Linux Input in 2.6.3
d80b5005c   Mauro Carvalho Chehab   docs: usb: conver...
13
    Unfortunately no calibration support at this time
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
14
15
  
  - 1.4 - Multiple changes to support the EXII 5000UC and house cleaning
d80b5005c   Mauro Carvalho Chehab   docs: usb: conver...
16
17
18
19
20
21
22
    Changed reset from standard USB dev reset to vendor reset
    Changed data sent to host from compensated to raw coordinates
    Eliminated vendor/product module params
    Performed multiple successful tests with an EXII-5010UC
  
  Supported Hardware
  ==================
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
23

d80b5005c   Mauro Carvalho Chehab   docs: usb: conver...
24
  ::
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
25
26
27
28
29
30
31
32
33
34
35
36
37
38
  
          All controllers have the Vendor: 0x0596 & Product: 0x0001
  
  
          Controller Description          Part Number
          ------------------------------------------------------
  
          USB Capacitive - Pearl Case     14-205  (Discontinued)
          USB Capacitive - Black Case     14-124  (Discontinued)
          USB Capacitive - No Case        14-206  (Discontinued)
  
          USB Capacitive - Pearl Case     EXII-5010UC
          USB Capacitive - Black Case     EXII-5030UC
          USB Capacitive - No Case        EXII-5050UC
d80b5005c   Mauro Carvalho Chehab   docs: usb: conver...
39
40
  Driver Notes
  ============
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
41

d80b5005c   Mauro Carvalho Chehab   docs: usb: conver...
42
  Installation is simple, you only need to add Linux Input, Linux USB, and the
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
43
44
45
46
47
48
  driver to the kernel.  The driver can also be optionally built as a module.
  
  This driver appears to be one of possible 2 Linux USB Input Touchscreen
  drivers.  Although 3M produces a binary only driver available for
  download, I persist in updating this driver since I would like to use the
  touchscreen for embedded apps using QTEmbedded, DirectFB, etc. So I feel the
2fe0ae78c   Matt LaPlante   Fix typos in Docu...
49
  logical choice is to use Linux Input.
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
50
51
52
53
54
55
56
57
58
  
  Currently there is no way to calibrate the device via this driver.  Even if
  the device could be calibrated, the driver pulls to raw coordinate data from
  the controller.  This means calibration must be performed within the
  userspace.
  
  The controller screen resolution is now 0 to 16384 for both X and Y reporting
  the raw touch data.  This is the same for the old and new capacitive USB
  controllers.
d80b5005c   Mauro Carvalho Chehab   docs: usb: conver...
59
60
  Perhaps at some point an abstract function will be placed into evdev so
  generic functions like calibrations, resets, and vendor information can be
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
61
62
  requested from the userspace (And the drivers would handle the vendor specific
  tasks).
d80b5005c   Mauro Carvalho Chehab   docs: usb: conver...
63
64
  TODO
  ====
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
65
66
67
  
  Implement a control urb again to handle requests to and from the device
  such as calibration, etc once/if it becomes available.
d80b5005c   Mauro Carvalho Chehab   docs: usb: conver...
68
69
  Disclaimer
  ==========
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
70

d80b5005c   Mauro Carvalho Chehab   docs: usb: conver...
71
  I am not a MicroTouch/3M employee, nor have I ever been.  3M does not support
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
72
  this driver!  If you want touch drivers only supported within X, please go to:
0ea6e6112   Justin P. Mattock   Documentation: up...
73
  http://www.3m.com/3MTouchSystems/
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
74

d80b5005c   Mauro Carvalho Chehab   docs: usb: conver...
75
76
  Thanks
  ======
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
77
78
79
  
  A huge thank you to 3M Touch Systems for the EXII-5010UC controllers for
  testing!