Documentation-usb-acm.txt

Chinese translated version of Documentation-usb-acm.txt


If you have any comment or update to the content, please contact the
original document maintainer directly.  However, if you have a problem
communicating in English you can also ask the Chinese maintainer for
help.  Contact the Chinese maintainer if this translation is outdated
or if there is a problem with the translation.


Maintainer: Eric W. Biederman <ebiederman@xmission.com>
Chinese maintainer: Shao Qi <shaoqitony@gmail.com>
---------------------------------------------------------------------
Documentation-usb-acm.txt 的中文翻译


如果想评论或更新本文的内容，请直接联系原文档的维护者。如果你使用英文
交流有困难的话，也可以向中文版维护者求助。如果本翻译更新不及时或者翻
译存在问题，请联系中文版维护者。
英文版维护者： Eric W. Biederman <ebiederman@xmission.com>
中文版维护者： 邵奇 Shao Qi <shaoqitony@gmail.com>
中文版翻译者： 邵奇 Shao Qi <shaoqitony@gmail.com>
中文版校译者： 邵奇 Shao Qi <shaoqitony@gmail.com>


以下为正文
---------------------------------------------------------------------


                          Linux ACM driver v0.16
                 (c) 1999 Vojtech Pavlik <vojtech@suse.cz>
                             Sponsored by SuSE
 Linux ACM 驱动 v0.16
(c) 1999 Vojtech Pavlik <vojtech@suse.cz>
                          由SuSE赞助  
----------------------------------------------------------------------------


0. Disclaimer
0. 免责声明
~~~~~~~~~~~~~
  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.
   这是一个免费软件程序；你可以根据Free Software Foundation发布的GNU通用
公共许可的条款重发布或修改它；或第二版许可，或（由你选择）任何最新版本。


  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.
  发布这个程序是希望它有用，但不做任何担保；甚至没有默认的MERCHANTABILITY担保
或是FITNESS FOR A PARTICULAR PURPOSE。 更多细节查看GNU通用公共许可。


  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
  连同这个程序，你应该收到了一份GNU通用公共许可；如果没有，写信给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
  你要联系我这个作者的话，可以发email到<vojtech@suse.cz>，或写信到：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.
  为了您的方便，GNU通用公共许可第二版包含在这个压缩包内:请查看拷贝文件。


1. Usage
1. 用法
~~~~~~~~
  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.
  drivers/usb/class/cdc-acm.c驱动以USB调制解调器和遵照通用串行总线通信设备类的USB ISDN终端适配器
方式工作。


  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:
  我知道一种以acm驱动方式工作的终端适配器（ISDN TA）：


        3Com USR ISDN Pro TA


  Some cell phones also connect via USB. I know the following phones work:
  一些手机也能通过USB链接。我知道的有以下手机：


        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.
  不幸的是，许多调制解调器和大多数终端适配器使用有专利的接口，因此不能以这些驱动方式
工作。再买之前检查ACM承诺。


  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.
  之后，调制解调器能被使用。你应该能使用minicom, ppp 和 mgetty。
  
2. Verifying that it works
2. 核查它是否奏效
~~~~~~~~~~~~~~~~~~~~~~~~~~
  The first step would be to check /proc/bus/usb/devices, it should look
like this:
  第一步要检查/proc/bus/usb/devices，它需要这个样子:


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.
这三条(and the Cls= 'comm' and 'data' classes)的存在是重要的，它意味着这是一个ACM设备。
Driver=acm意味着这个驱动是被这个设备使用的。如果你仅仅看见Cls=ff(vend.)，你很不幸，你
的设备上的是卖家的特殊端口。


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
anufacturer: 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.
如果看上去可以的，开启小型计算机，设置它来和ttyACM设备通信，试着键入at。如果
反馈OK，这就说明奏效了。