1 ====================== 1 ======================
2 Linux ACM driver v0.16 2 Linux ACM driver v0.16
3 ====================== 3 ======================
4 4
5 Copyright (c) 1999 Vojtech Pavlik <vojtech@suse 5 Copyright (c) 1999 Vojtech Pavlik <vojtech@suse.cz>
6 6
7 Sponsored by SuSE 7 Sponsored by SuSE
8 8
9 0. Disclaimer 9 0. Disclaimer
10 ~~~~~~~~~~~~~ 10 ~~~~~~~~~~~~~
11 This program is free software; you can redistr 11 This program is free software; you can redistribute it and/or modify it
12 under the terms of the GNU General Public Lice 12 under the terms of the GNU General Public License as published by the Free
13 Software Foundation; either version 2 of the L 13 Software Foundation; either version 2 of the License, or (at your option)
14 any later version. 14 any later version.
15 15
16 This program is distributed in the hope that i 16 This program is distributed in the hope that it will be useful, but
17 WITHOUT ANY WARRANTY; without even the implied 17 WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
18 or FITNESS FOR A PARTICULAR PURPOSE. See the 18 or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
19 more details. 19 more details.
20 20
21 You should have received a copy of the GNU Gen 21 You should have received a copy of the GNU General Public License along
22 with this program; if not, write to the Free S 22 with this program; if not, write to the Free Software Foundation, Inc., 59
23 Temple Place, Suite 330, Boston, MA 02111-1307 23 Temple Place, Suite 330, Boston, MA 02111-1307 USA
24 24
25 Should you need to contact me, the author, you 25 Should you need to contact me, the author, you can do so either by e-mail -
26 mail your message to <vojtech@suse.cz>, or by p 26 mail your message to <vojtech@suse.cz>, or by paper mail: Vojtech Pavlik,
27 Ucitelska 1576, Prague 8, 182 00 Czech Republi 27 Ucitelska 1576, Prague 8, 182 00 Czech Republic
28 28
29 For your convenience, the GNU General Public L 29 For your convenience, the GNU General Public License version 2 is included
30 in the package: See the file COPYING. 30 in the package: See the file COPYING.
31 31
32 1. Usage 32 1. Usage
33 ~~~~~~~~ 33 ~~~~~~~~
34 The drivers/usb/class/cdc-acm.c drivers works 34 The drivers/usb/class/cdc-acm.c drivers works with USB modems and USB ISDN terminal
35 adapters that conform to the Universal Serial 35 adapters that conform to the Universal Serial Bus Communication Device Class
36 Abstract Control Model (USB CDC ACM) specifica 36 Abstract Control Model (USB CDC ACM) specification.
37 37
38 Many modems do, here is a list of those I know 38 Many modems do, here is a list of those I know of:
39 39
40 - 3Com OfficeConnect 56k 40 - 3Com OfficeConnect 56k
41 - 3Com Voice FaxModem Pro 41 - 3Com Voice FaxModem Pro
42 - 3Com Sportster 42 - 3Com Sportster
43 - MultiTech MultiModem 56k 43 - MultiTech MultiModem 56k
44 - Zoom 2986L FaxModem 44 - Zoom 2986L FaxModem
45 - Compaq 56k FaxModem 45 - Compaq 56k FaxModem
46 - ELSA Microlink 56k 46 - ELSA Microlink 56k
47 47
48 I know of one ISDN TA that does work with the 48 I know of one ISDN TA that does work with the acm driver:
49 49
50 - 3Com USR ISDN Pro TA 50 - 3Com USR ISDN Pro TA
51 51
52 Some cell phones also connect via USB. I know 52 Some cell phones also connect via USB. I know the following phones work:
53 53
54 - SonyEricsson K800i 54 - SonyEricsson K800i
55 55
56 Unfortunately many modems and most ISDN TAs us 56 Unfortunately many modems and most ISDN TAs use proprietary interfaces and
57 thus won't work with this drivers. Check for A 57 thus won't work with this drivers. Check for ACM compliance before buying.
58 58
59 To use the modems you need these modules loade 59 To use the modems you need these modules loaded::
60 60
61 usbcore.ko 61 usbcore.ko
62 uhci-hcd.ko ohci-hcd.ko or ehci-hcd.ko 62 uhci-hcd.ko ohci-hcd.ko or ehci-hcd.ko
63 cdc-acm.ko 63 cdc-acm.ko
64 64
65 After that, the modem[s] should be accessible. 65 After that, the modem[s] should be accessible. You should be able to use
66 minicom, ppp and mgetty with them. 66 minicom, ppp and mgetty with them.
67 67
68 2. Verifying that it works 68 2. Verifying that it works
69 ~~~~~~~~~~~~~~~~~~~~~~~~~~ 69 ~~~~~~~~~~~~~~~~~~~~~~~~~~
70 70
71 The first step would be to check /sys/kernel/d 71 The first step would be to check /sys/kernel/debug/usb/devices, it should look
72 like this:: 72 like this::
73 73
74 T: Bus=01 Lev=00 Prnt=00 Port=00 Cnt=00 Dev 74 T: Bus=01 Lev=00 Prnt=00 Port=00 Cnt=00 Dev#= 1 Spd=12 MxCh= 2
75 B: Alloc= 0/900 us ( 0%), #Int= 0, #Iso= 75 B: Alloc= 0/900 us ( 0%), #Int= 0, #Iso= 0
76 D: Ver= 1.00 Cls=09(hub ) Sub=00 Prot=00 M 76 D: Ver= 1.00 Cls=09(hub ) Sub=00 Prot=00 MxPS= 8 #Cfgs= 1
77 P: Vendor=0000 ProdID=0000 Rev= 0.00 77 P: Vendor=0000 ProdID=0000 Rev= 0.00
78 S: Product=USB UHCI Root Hub 78 S: Product=USB UHCI Root Hub
79 S: SerialNumber=6800 79 S: SerialNumber=6800
80 C:* #Ifs= 1 Cfg#= 1 Atr=40 MxPwr= 0mA 80 C:* #Ifs= 1 Cfg#= 1 Atr=40 MxPwr= 0mA
81 I: If#= 0 Alt= 0 #EPs= 1 Cls=09(hub ) Sub= 81 I: If#= 0 Alt= 0 #EPs= 1 Cls=09(hub ) Sub=00 Prot=00 Driver=hub
82 E: Ad=81(I) Atr=03(Int.) MxPS= 8 Ivl=255m 82 E: Ad=81(I) Atr=03(Int.) MxPS= 8 Ivl=255ms
83 T: Bus=01 Lev=01 Prnt=01 Port=01 Cnt=01 Dev 83 T: Bus=01 Lev=01 Prnt=01 Port=01 Cnt=01 Dev#= 2 Spd=12 MxCh= 0
84 D: Ver= 1.00 Cls=02(comm.) Sub=00 Prot=00 M 84 D: Ver= 1.00 Cls=02(comm.) Sub=00 Prot=00 MxPS= 8 #Cfgs= 2
85 P: Vendor=04c1 ProdID=008f Rev= 2.07 85 P: Vendor=04c1 ProdID=008f Rev= 2.07
86 S: Manufacturer=3Com Inc. 86 S: Manufacturer=3Com Inc.
87 S: Product=3Com U.S. Robotics Pro ISDN TA 87 S: Product=3Com U.S. Robotics Pro ISDN TA
88 S: SerialNumber=UFT53A49BVT7 88 S: SerialNumber=UFT53A49BVT7
89 C: #Ifs= 1 Cfg#= 1 Atr=60 MxPwr= 0mA 89 C: #Ifs= 1 Cfg#= 1 Atr=60 MxPwr= 0mA
90 I: If#= 0 Alt= 0 #EPs= 3 Cls=ff(vend.) Sub= 90 I: If#= 0 Alt= 0 #EPs= 3 Cls=ff(vend.) Sub=ff Prot=ff Driver=acm
91 E: Ad=85(I) Atr=02(Bulk) MxPS= 64 Ivl= 0m 91 E: Ad=85(I) Atr=02(Bulk) MxPS= 64 Ivl= 0ms
92 E: Ad=04(O) Atr=02(Bulk) MxPS= 64 Ivl= 0m 92 E: Ad=04(O) Atr=02(Bulk) MxPS= 64 Ivl= 0ms
93 E: Ad=81(I) Atr=03(Int.) MxPS= 16 Ivl=128m 93 E: Ad=81(I) Atr=03(Int.) MxPS= 16 Ivl=128ms
94 C:* #Ifs= 2 Cfg#= 2 Atr=60 MxPwr= 0mA 94 C:* #Ifs= 2 Cfg#= 2 Atr=60 MxPwr= 0mA
95 I: If#= 0 Alt= 0 #EPs= 1 Cls=02(comm.) Sub= 95 I: If#= 0 Alt= 0 #EPs= 1 Cls=02(comm.) Sub=02 Prot=01 Driver=acm
96 E: Ad=81(I) Atr=03(Int.) MxPS= 16 Ivl=128m 96 E: Ad=81(I) Atr=03(Int.) MxPS= 16 Ivl=128ms
97 I: If#= 1 Alt= 0 #EPs= 2 Cls=0a(data ) Sub= 97 I: If#= 1 Alt= 0 #EPs= 2 Cls=0a(data ) Sub=00 Prot=00 Driver=acm
98 E: Ad=85(I) Atr=02(Bulk) MxPS= 64 Ivl= 0m 98 E: Ad=85(I) Atr=02(Bulk) MxPS= 64 Ivl= 0ms
99 E: Ad=04(O) Atr=02(Bulk) MxPS= 64 Ivl= 0m 99 E: Ad=04(O) Atr=02(Bulk) MxPS= 64 Ivl= 0ms
100 100
101 The presence of these three lines (and the Cls 101 The presence of these three lines (and the Cls= 'comm' and 'data' classes)
102 is important, it means it's an ACM device. The 102 is important, it means it's an ACM device. The Driver=acm means the acm
103 driver is used for the device. If you see only 103 driver is used for the device. If you see only Cls=ff(vend.) then you're out
104 of luck, you have a device with vendor specifi 104 of luck, you have a device with vendor specific-interface::
105 105
106 D: Ver= 1.00 Cls=02(comm.) Sub=00 Prot=00 M 106 D: Ver= 1.00 Cls=02(comm.) Sub=00 Prot=00 MxPS= 8 #Cfgs= 2
107 I: If#= 0 Alt= 0 #EPs= 1 Cls=02(comm.) Sub= 107 I: If#= 0 Alt= 0 #EPs= 1 Cls=02(comm.) Sub=02 Prot=01 Driver=acm
108 I: If#= 1 Alt= 0 #EPs= 2 Cls=0a(data ) Sub= 108 I: If#= 1 Alt= 0 #EPs= 2 Cls=0a(data ) Sub=00 Prot=00 Driver=acm
109 109
110 In the system log you should see:: 110 In the system log you should see::
111 111
112 usb.c: USB new device connect, assigned devi 112 usb.c: USB new device connect, assigned device number 2
113 usb.c: kmalloc IF c7691fa0, numif 1 113 usb.c: kmalloc IF c7691fa0, numif 1
114 usb.c: kmalloc IF c7b5f3e0, numif 2 114 usb.c: kmalloc IF c7b5f3e0, numif 2
115 usb.c: skipped 4 class/vendor specific inter 115 usb.c: skipped 4 class/vendor specific interface descriptors
116 usb.c: new device strings: Mfr=1, Product=2, 116 usb.c: new device strings: Mfr=1, Product=2, SerialNumber=3
117 usb.c: USB device number 2 default language 117 usb.c: USB device number 2 default language ID 0x409
118 Manufacturer: 3Com Inc. 118 Manufacturer: 3Com Inc.
119 Product: 3Com U.S. Robotics Pro ISDN TA 119 Product: 3Com U.S. Robotics Pro ISDN TA
120 SerialNumber: UFT53A49BVT7 120 SerialNumber: UFT53A49BVT7
121 acm.c: probing config 1 121 acm.c: probing config 1
122 acm.c: probing config 2 122 acm.c: probing config 2
123 ttyACM0: USB ACM device 123 ttyACM0: USB ACM device
124 acm.c: acm_control_msg: rq: 0x22 val: 0x0 le 124 acm.c: acm_control_msg: rq: 0x22 val: 0x0 len: 0x0 result: 0
125 acm.c: acm_control_msg: rq: 0x20 val: 0x0 le 125 acm.c: acm_control_msg: rq: 0x20 val: 0x0 len: 0x7 result: 7
126 usb.c: acm driver claimed interface c7b5f3e0 126 usb.c: acm driver claimed interface c7b5f3e0
127 usb.c: acm driver claimed interface c7b5f3f8 127 usb.c: acm driver claimed interface c7b5f3f8
128 usb.c: acm driver claimed interface c7691fa0 128 usb.c: acm driver claimed interface c7691fa0
129 129
130 If all this seems to be OK, fire up minicom an 130 If all this seems to be OK, fire up minicom and set it to talk to the ttyACM
131 device and try typing 'at'. If it responds wit 131 device and try typing 'at'. If it responds with 'OK', then everything is
132 working. 132 working.
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.