mirror of
https://github.com/torvalds/linux.git
synced 2024-11-15 00:21:59 +00:00
ecefae6db0
While there are a mix of things here, most of the stuff were written from Kernel developer's PoV. So, add them to the driver-api book. A follow up for this patch would be to move documents from there that are specific to sysadmins, adding them to the admin-guide. Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org> Acked-by: Johan Hovold <johan@kernel.org> Acked-by: Felipe Balbi <felipe.balbi@linux.intel.com> Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
133 lines
4.9 KiB
ReStructuredText
133 lines
4.9 KiB
ReStructuredText
======================
|
|
Linux ACM driver v0.16
|
|
======================
|
|
|
|
Copyright (c) 1999 Vojtech Pavlik <vojtech@suse.cz>
|
|
|
|
Sponsored by SuSE
|
|
|
|
0. Disclaimer
|
|
~~~~~~~~~~~~~
|
|
This program is free software; you can redistribute it and/or modify it
|
|
under the terms of the GNU General Public License as published by the Free
|
|
Software Foundation; either version 2 of the License, or (at your option)
|
|
any later version.
|
|
|
|
This program is distributed in the hope that it will be useful, but
|
|
WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
|
|
or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
|
|
more details.
|
|
|
|
You should have received a copy of the GNU General Public License along
|
|
with this program; if not, write to the Free Software Foundation, Inc., 59
|
|
Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
|
|
|
Should you need to contact me, the author, you can do so either by e-mail -
|
|
mail your message to <vojtech@suse.cz>, or by paper mail: Vojtech Pavlik,
|
|
Ucitelska 1576, Prague 8, 182 00 Czech Republic
|
|
|
|
For your convenience, the GNU General Public License version 2 is included
|
|
in the package: See the file COPYING.
|
|
|
|
1. Usage
|
|
~~~~~~~~
|
|
The drivers/usb/class/cdc-acm.c drivers works with USB modems and USB ISDN terminal
|
|
adapters that conform to the Universal Serial Bus Communication Device Class
|
|
Abstract Control Model (USB CDC ACM) specification.
|
|
|
|
Many modems do, here is a list of those I know of:
|
|
|
|
- 3Com OfficeConnect 56k
|
|
- 3Com Voice FaxModem Pro
|
|
- 3Com Sportster
|
|
- MultiTech MultiModem 56k
|
|
- Zoom 2986L FaxModem
|
|
- Compaq 56k FaxModem
|
|
- ELSA Microlink 56k
|
|
|
|
I know of one ISDN TA that does work with the acm driver:
|
|
|
|
- 3Com USR ISDN Pro TA
|
|
|
|
Some cell phones also connect via USB. I know the following phones work:
|
|
|
|
- SonyEricsson K800i
|
|
|
|
Unfortunately many modems and most ISDN TAs use proprietary interfaces and
|
|
thus won't work with this drivers. Check for ACM compliance before buying.
|
|
|
|
To use the modems you need these modules loaded::
|
|
|
|
usbcore.ko
|
|
uhci-hcd.ko ohci-hcd.ko or ehci-hcd.ko
|
|
cdc-acm.ko
|
|
|
|
After that, the modem[s] should be accessible. You should be able to use
|
|
minicom, ppp and mgetty with them.
|
|
|
|
2. Verifying that it works
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
The first step would be to check /sys/kernel/debug/usb/devices, it should look
|
|
like this::
|
|
|
|
T: Bus=01 Lev=00 Prnt=00 Port=00 Cnt=00 Dev#= 1 Spd=12 MxCh= 2
|
|
B: Alloc= 0/900 us ( 0%), #Int= 0, #Iso= 0
|
|
D: Ver= 1.00 Cls=09(hub ) Sub=00 Prot=00 MxPS= 8 #Cfgs= 1
|
|
P: Vendor=0000 ProdID=0000 Rev= 0.00
|
|
S: Product=USB UHCI Root Hub
|
|
S: SerialNumber=6800
|
|
C:* #Ifs= 1 Cfg#= 1 Atr=40 MxPwr= 0mA
|
|
I: If#= 0 Alt= 0 #EPs= 1 Cls=09(hub ) Sub=00 Prot=00 Driver=hub
|
|
E: Ad=81(I) Atr=03(Int.) MxPS= 8 Ivl=255ms
|
|
T: Bus=01 Lev=01 Prnt=01 Port=01 Cnt=01 Dev#= 2 Spd=12 MxCh= 0
|
|
D: Ver= 1.00 Cls=02(comm.) Sub=00 Prot=00 MxPS= 8 #Cfgs= 2
|
|
P: Vendor=04c1 ProdID=008f Rev= 2.07
|
|
S: Manufacturer=3Com Inc.
|
|
S: Product=3Com U.S. Robotics Pro ISDN TA
|
|
S: SerialNumber=UFT53A49BVT7
|
|
C: #Ifs= 1 Cfg#= 1 Atr=60 MxPwr= 0mA
|
|
I: If#= 0 Alt= 0 #EPs= 3 Cls=ff(vend.) Sub=ff Prot=ff Driver=acm
|
|
E: Ad=85(I) Atr=02(Bulk) MxPS= 64 Ivl= 0ms
|
|
E: Ad=04(O) Atr=02(Bulk) MxPS= 64 Ivl= 0ms
|
|
E: Ad=81(I) Atr=03(Int.) MxPS= 16 Ivl=128ms
|
|
C:* #Ifs= 2 Cfg#= 2 Atr=60 MxPwr= 0mA
|
|
I: If#= 0 Alt= 0 #EPs= 1 Cls=02(comm.) Sub=02 Prot=01 Driver=acm
|
|
E: Ad=81(I) Atr=03(Int.) MxPS= 16 Ivl=128ms
|
|
I: If#= 1 Alt= 0 #EPs= 2 Cls=0a(data ) Sub=00 Prot=00 Driver=acm
|
|
E: Ad=85(I) Atr=02(Bulk) MxPS= 64 Ivl= 0ms
|
|
E: Ad=04(O) Atr=02(Bulk) MxPS= 64 Ivl= 0ms
|
|
|
|
The presence of these three lines (and the Cls= 'comm' and 'data' classes)
|
|
is important, it means it's an ACM device. The Driver=acm means the acm
|
|
driver is used for the device. If you see only Cls=ff(vend.) then you're out
|
|
of luck, you have a device with vendor specific-interface::
|
|
|
|
D: Ver= 1.00 Cls=02(comm.) Sub=00 Prot=00 MxPS= 8 #Cfgs= 2
|
|
I: If#= 0 Alt= 0 #EPs= 1 Cls=02(comm.) Sub=02 Prot=01 Driver=acm
|
|
I: If#= 1 Alt= 0 #EPs= 2 Cls=0a(data ) Sub=00 Prot=00 Driver=acm
|
|
|
|
In the system log you should see::
|
|
|
|
usb.c: USB new device connect, assigned device number 2
|
|
usb.c: kmalloc IF c7691fa0, numif 1
|
|
usb.c: kmalloc IF c7b5f3e0, numif 2
|
|
usb.c: skipped 4 class/vendor specific interface descriptors
|
|
usb.c: new device strings: Mfr=1, Product=2, SerialNumber=3
|
|
usb.c: USB device number 2 default language ID 0x409
|
|
Manufacturer: 3Com Inc.
|
|
Product: 3Com U.S. Robotics Pro ISDN TA
|
|
SerialNumber: UFT53A49BVT7
|
|
acm.c: probing config 1
|
|
acm.c: probing config 2
|
|
ttyACM0: USB ACM device
|
|
acm.c: acm_control_msg: rq: 0x22 val: 0x0 len: 0x0 result: 0
|
|
acm.c: acm_control_msg: rq: 0x20 val: 0x0 len: 0x7 result: 7
|
|
usb.c: acm driver claimed interface c7b5f3e0
|
|
usb.c: acm driver claimed interface c7b5f3f8
|
|
usb.c: acm driver claimed interface c7691fa0
|
|
|
|
If all this seems to be OK, fire up minicom and set it to talk to the ttyACM
|
|
device and try typing 'at'. If it responds with 'OK', then everything is
|
|
working.
|