[PATCH 02/25] docs/zh_CN: Add acm.rst translation

Updated
From:macrofun <baikefan@leap-io-kernel.com>
Date:
Message-ID:<20251123074540.34161-3-baikefan@leap-io-kernel.com>
Patch:v1 · 2/25
Language:zh_CN
Patch-ID:a9db2b65f55b87c9dc54cffc4cba6311b8d21af2
Files:Documentation/translations/zh_CN/usb/acm.rst

Patch content 1 changed file

Translate .../usb/acm.rst into Chinese. Update the translation through commit ecefae6db042("docs: usb: rename files to .rst and add them to drivers-api") Signed-off-by: macrofun <baikefan@leap-io-kernel.com>--- Documentation/translations/zh_CN/usb/acm.rst | 137 +++++++++++++++++++ 1 file changed, 137 insertions(+) create mode 100644 Documentation/translations/zh_CN/usb/acm.rst diff --git a/Documentation/translations/zh_CN/usb/acm.rst b/Documentation/translations/zh_CN/usb/acm.rstnew file mode 100644index 000000000000..974654410344--- /dev/null+++ b/Documentation/translations/zh_CN/usb/acm.rst@@ -0,0 +1,137 @@+.. SPDX-License-Identifier: GPL-2.0+.. include:: ../disclaimer-zh_CN.rst++:Original: Documentation/usb/acm.rst++:翻译:++ 白钶凡 Kefan Bai <baikefan@leap-io-kernel.com>++:校译:+++======================+Linux ACM驱动 v0.16+======================++版权所有(c) 1999 Vojtech Pavlik <vojtech@suse.cz>++由SuSE赞助++0. 免责声明+~~~~~~~~~~~~~+本程序是自由软件;您可以依据自由软件基金会发布的GNU通用公共许可证第2版,+或(由您选择的)任何更高版本的规定,对本程序进行再发布和/或修改。++我们希望本程序有用,但不提供任何担保;甚至不包含对适销性或适用于特定目的的默示性担保。+更多细节请参阅GNU通用公共许可证。++您应该已经随本程序收到GNU通用公共许可证副本;+如果没有,请写信至:Free Software Foundation, Inc., 59+Temple Place, Suite 330, Boston, MA 02111-1307 USA。++如需联系作者,可通过电子邮件发送消息至 vojtech@suse.cz,+或通过纸质邮件寄至:+Vojtech Pavlik, Ucitelska 1576, Prague 8, 182 00, Czech Republic。++为方便起见,本软件包中已包含GNU通用公共许可证第2版:参见文件COPYING。++1. 使用方法+~~~~~~~~~~~~~+drivers/usb/class/cdc-acm.c驱动可用于USB调制解调器和USB ISDN终端适配器,+这些设备符合USB通用串行总线通信设备类(Universal Serial Bus+Communication Device Class)的抽象控制模型(Abstract Control Model,+USB CDC ACM)规范。++许多调制解调器支持此驱动,以下是我所知道的一些型号:++	- 3Com OfficeConnect 56k+	- 3Com Voice FaxModem Pro+	- 3Com Sportster+	- MultiTech MultiModem 56k+	- Zoom 2986L FaxModem+	- Compaq 56k FaxModem+	- ELSA Microlink 56k++我知道有一款ISDN终端适配器可以与ACM驱动一起使用:++	- 3Com USR ISDN Pro TA++一些手机也可以通过USB连接。我知道以下机型可以正常工作:++	- SonyEricsson K800i++不幸的是,许多调制解调器以及大多数ISDN终端适配器使用专有接口,+因此无法与此驱动兼容。购买前请确认设备是否符合ACM规范。++要使用调制解调器,您需要加载以下模块:++	usbcore.ko+	uhci-hcd.ko ohci-hcd.ko or ehci-hcd.ko+	cdc-acm.ko++之后,调制解调器应该可以正常访问。+你应该能够使用minicom、ppp和mgetty与它们进行通信。++2. 验证驱动是否正常工作+~~~~~~~~~~~~~~~~~~~~~~~~++第一步是检查 /sys/kernel/debug/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++其中以下三行(以及 Cls= 'comm' 和 'data' 类)非常重要,它们表示这是一个ACM设备。+Driver=acm 表示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++在系统日志中你应该看到::++  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++如果以上都正常,请启动minicom,将其设置为连接ttyACM设备,然后输入'at'。+如果响应 "OK",则说明一切工作正常。--2.34.1