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