← Documents Documentation/usb/usb-serial.rst GitHub 원문 ↗

Linux 6.18.37 · USB

USB 직렬 드라이버

USB serial core의 TTY 설정과 WhiteHEAT, Palm/PocketPC, Keyspan, FTDI, Cypress, Digi, Belkin, PL2303, CH341, Moschip 및 generic adapter의 지원 상태를 설명합니다.

Source pathDocumentation/usb/usb-serial.rst
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.

1. 요약·해설

원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.

요약·해설

usb-serial.rst:1-537

이 문서는 USB serial core의 공통 TTY 번호 체계와 여러 변환기·PDA·GPS·card-reader 장치의 당시 지원 수준, 제한, 설정 명령과 연락처를 한데 모은 장치별 안내서입니다.

장치별 상태 설명에는 역사적 정보가 많으므로 실제 hardware 사용 시 현재 driver source와 system log도 함께 확인해야 합니다. 이 페이지는 Linux v6.18.37에 포함된 원문의 표현과 수치를 보존해 번역합니다.

문서 탐색
항목설명
Common setupmajor 188, /dev/ttyUSB0..255, system log
PDA/syncVisor, Palm, Clié, PocketPC, Keyspan PDA
ConvertersWhiteHEAT, FTDI, Digi, Belkin, MCT, Edgeport, PL2303, CH341, Moschip
Special devicesGPS, ISDN TA, chipcard reader, Empeg
FallbackGeneric serial driver와 VID/PID 등록

긴 장치 목록을 운용 관점에서 묶었습니다.

2. 영어 원문 전체

번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.

원문 전체 펼치기
1 ==========
2 USB serial
3 ==========
4
5 Introduction
6 ============
7
8 The USB serial driver currently supports a number of different USB to
9 serial converter products, as well as some devices that use a serial
10 interface from userspace to talk to the device.
11
12 See the individual product section below for specific information about
13 the different devices.
14
15
16 Configuration
17 =============
18
19 Currently the driver can handle up to 256 different serial interfaces at
20 one time.
21
22 The major number that the driver uses is 188 so to use the driver,
23 create the following nodes::
24
25 mknod /dev/ttyUSB0 c 188 0
26 mknod /dev/ttyUSB1 c 188 1
27 mknod /dev/ttyUSB2 c 188 2
28 mknod /dev/ttyUSB3 c 188 3
29 .
30 .
31 .
32 mknod /dev/ttyUSB254 c 188 254
33 mknod /dev/ttyUSB255 c 188 255
34
35 When the device is connected and recognized by the driver, the driver
36 will print to the system log, which node(s) the device has been bound
37 to.
38
39
40 Specific Devices Supported
41 ==========================
42
43
44 ConnectTech WhiteHEAT 4 port converter
45 --------------------------------------
46
47 ConnectTech has been very forthcoming with information about their
48 device, including providing a unit to test with.
49
50 The driver is officially supported by Connect Tech Inc.
51 http://www.connecttech.com
52
53 For any questions or problems with this driver, please contact
54 Connect Tech's Support Department at [email protected]
55
56
57 HandSpring Visor, Palm USB, and Clié USB driver
58 -----------------------------------------------
59
60 This driver works with all HandSpring USB, Palm USB, and Sony Clié USB
61 devices.
62
63 Only when the device tries to connect to the host, will the device show
64 up to the host as a valid USB device. When this happens, the device is
65 properly enumerated, assigned a port, and then communication _should_ be
66 possible. The driver cleans up properly when the device is removed, or
67 the connection is canceled on the device.
68
69 NOTE:
70 This means that in order to talk to the device, the sync button must be
71 pressed BEFORE trying to get any program to communicate to the device.
72 This goes against the current documentation for pilot-xfer and other
73 packages, but is the only way that it will work due to the hardware
74 in the device.
75
76 When the device is connected, try talking to it on the second port
77 (this is usually /dev/ttyUSB1 if you do not have any other usb-serial
78 devices in the system.) The system log should tell you which port is
79 the port to use for the HotSync transfer. The "Generic" port can be used
80 for other device communication, such as a PPP link.
81
82 For some Sony Clié devices, /dev/ttyUSB0 must be used to talk to the
83 device. This is true for all OS version 3.5 devices, and most devices
84 that have had a flash upgrade to a newer version of the OS. See the
85 kernel system log for information on which is the correct port to use.
86
87 If after pressing the sync button, nothing shows up in the system log,
88 try resetting the device, first a hot reset, and then a cold reset if
89 necessary. Some devices need this before they can talk to the USB port
90 properly.
91
92 Devices that are not compiled into the kernel can be specified with module
93 parameters. e.g. modprobe visor vendor=0x54c product=0x66
94
95 There is a webpage and mailing lists for this portion of the driver at:
96 http://sourceforge.net/projects/usbvisor/
97
98 For any questions or problems with this driver, please contact Greg
99 Kroah-Hartman at [email protected]
100
101
102 PocketPC PDA Driver
103 -------------------
104
105 This driver can be used to connect to Compaq iPAQ, HP Jornada, Casio EM500
106 and other PDAs running Windows CE 3.0 or PocketPC 2002 using a USB
107 cable/cradle.
108 Most devices supported by ActiveSync are supported out of the box.
109 For others, please use module parameters to specify the product and vendor
110 id. e.g. modprobe ipaq vendor=0x3f0 product=0x1125
111
112 The driver presents a serial interface (usually on /dev/ttyUSB0) over
113 which one may run ppp and establish a TCP/IP link to the PDA. Once this
114 is done, you can transfer files, backup, download email etc. The most
115 significant advantage of using USB is speed - I can get 73 to 113
116 kbytes/sec for download/upload to my iPAQ.
117
118 This driver is only one of a set of components required to utilize
119 the USB connection. Please visit http://synce.sourceforge.net which
120 contains the necessary packages and a simple step-by-step howto.
121
122 Once connected, you can use Win CE programs like ftpView, Pocket Outlook
123 from the PDA and xcerdisp, synce utilities from the Linux side.
124
125 To use Pocket IE, follow the instructions given at
126 http://www.tekguru.co.uk/EM500/usbtonet.htm to achieve the same thing
127 on Win98. Omit the proxy server part; Linux is quite capable of forwarding
128 packets unlike Win98. Another modification is required at least for the
129 iPAQ - disable autosync by going to the Start/Settings/Connections menu
130 and unchecking the "Automatically synchronize ..." box. Go to
131 Start/Programs/Connections, connect the cable and select "usbdial" (or
132 whatever you named your new USB connection). You should finally wind
133 up with a "Connected to usbdial" window with status shown as connected.
134 Now start up PIE and browse away.
135
136 If it doesn't work for some reason, load both the usbserial and ipaq module
137 with the module parameter "debug" set to 1 and examine the system log.
138 You can also try soft-resetting your PDA before attempting a connection.
139
140 Other functionality may be possible depending on your PDA. According to
141 Wes Cilldhaire <[email protected]>, with the Toshiba E570,
142 ...if you boot into the bootloader (hold down the power when hitting the
143 reset button, continuing to hold onto the power until the bootloader screen
144 is displayed), then put it in the cradle with the ipaq driver loaded, open
145 a terminal on /dev/ttyUSB0, it gives you a "USB Reflash" terminal, which can
146 be used to flash the ROM, as well as the microP code.. so much for needing
147 Toshiba's $350 serial cable for flashing!! :D
148 NOTE: This has NOT been tested. Use at your own risk.
149
150 For any questions or problems with the driver, please contact Ganesh
151 Varadarajan <[email protected]>
152
153
154 Keyspan PDA Serial Adapter
155 --------------------------
156
157 Single port DB-9 serial adapter, pushed as a PDA adapter for iMacs (mostly
158 sold in Macintosh catalogs, comes in a translucent white/green dongle).
159 Fairly simple device. Firmware is homebrew.
160 This driver also works for the Xircom/Entrega single port serial adapter.
161
162 Current status:
163
164 Things that work:
165 - basic input/output (tested with 'cu')
166 - blocking write when serial line can't keep up
167 - changing baud rates (up to 115200)
168 - getting/setting modem control pins (TIOCM{GET,SET,BIS,BIC})
169 - sending break (although duration looks suspect)
170
171 Things that don't:
172 - device strings (as logged by kernel) have trailing binary garbage
173 - device ID isn't right, might collide with other Keyspan products
174 - changing baud rates ought to flush tx/rx to avoid mangled half characters
175
176 Big Things on the todo list:
177 - parity, 7 vs 8 bits per char, 1 or 2 stop bits
178 - HW flow control
179 - not all of the standard USB descriptors are handled:
180 Get_Status, Set_Feature, O_NONBLOCK, select()
181
182 For any questions or problems with this driver, please contact Brian
184
185
186 Keyspan USA-series Serial Adapters
187 ----------------------------------
188
189 Single, Dual and Quad port adapters - driver uses Keyspan supplied
190 firmware and is being developed with their support.
191
192 Current status:
193
194 The USA-18X, USA-28X, USA-19, USA-19W and USA-49W are supported and
195 have been pretty thoroughly tested at various baud rates with 8-N-1
196 character settings. Other character lengths and parity setups are
197 presently untested.
198
199 The USA-28 isn't yet supported though doing so should be pretty
200 straightforward. Contact the maintainer if you require this
201 functionality.
202
203 More information is available at:
204
205 http://www.carnationsoftware.com/carnation/Keyspan.html
206
207 For any questions or problems with this driver, please contact Hugh
208 Blemings at [email protected]
209
210
211 FTDI Single Port Serial Driver
212 ------------------------------
213
214 This is a single port DB-25 serial adapter.
215
216 Devices supported include:
217
218 - TripNav TN-200 USB GPS
219 - Navis Engineering Bureau CH-4711 USB GPS
220
221 For any questions or problems with this driver, please contact Bill Ryder.
222
223
224 ZyXEL omni.net lcd plus ISDN TA
225 -------------------------------
226
227 This is an ISDN TA. Please report both successes and troubles to
229
230
231 Cypress M8 CY4601 Family Serial Driver
232 --------------------------------------
233
234 This driver was in most part developed by Neil "koyama" Whelchel. It
235 has been improved since that previous form to support dynamic serial
236 line settings and improved line handling. The driver is for the most
237 part stable and has been tested on an smp machine. (dual p2)
238
239 Chipsets supported under CY4601 family:
240
241 CY7C63723, CY7C63742, CY7C63743, CY7C64013
242
243 Devices supported:
244
245 - DeLorme's USB Earthmate GPS (SiRF Star II lp arch)
246 - Cypress HID->COM RS232 adapter
247
248 Note:
249 Cypress Semiconductor claims no affiliation with the
250 hid->com device.
251
252 Most devices using chipsets under the CY4601 family should
253 work with the driver. As long as they stay true to the CY4601
254 usbserial specification.
255
256 Technical notes:
257
258 The Earthmate starts out at 4800 8N1 by default... the driver will
259 upon start init to this setting. usbserial core provides the rest
260 of the termios settings, along with some custom termios so that the
261 output is in proper format and parsable.
262
263 The device can be put into sirf mode by issuing NMEA command::
264
265 $PSRF100,<protocol>,<baud>,<databits>,<stopbits>,<parity>*CHECKSUM
266 $PSRF100,0,9600,8,1,0*0C
267
268 It should then be sufficient to change the port termios to match this
269 to begin communicating.
270
271 As far as I can tell it supports pretty much every sirf command as
272 documented online available with firmware 2.31, with some unknown
273 message ids.
274
275 The hid->com adapter can run at a maximum baud of 115200bps. Please note
276 that the device has trouble or is incapable of raising line voltage properly.
277 It will be fine with null modem links, as long as you do not try to link two
278 together without hacking the adapter to set the line high.
279
280 The driver is smp safe. Performance with the driver is rather low when using
281 it for transferring files. This is being worked on, but I would be willing to
282 accept patches. An urb queue or packet buffer would likely fit the bill here.
283
284 If you have any questions, problems, patches, feature requests, etc. you can
285 contact me here via email:
286
288
289 (your problems/patches can alternately be submitted to usb-devel)
290
291
292 Digi AccelePort Driver
293 ----------------------
294
295 This driver supports the Digi AccelePort USB 2 and 4 devices, 2 port
296 (plus a parallel port) and 4 port USB serial converters. The driver
297 does NOT yet support the Digi AccelePort USB 8.
298
299 This driver works under SMP with the usb-uhci driver. It does not
300 work under SMP with the uhci driver.
301
302 The driver is generally working, though we still have a few more ioctls
303 to implement and final testing and debugging to do. The parallel port
304 on the USB 2 is supported as a serial to parallel converter; in other
305 words, it appears as another USB serial port on Linux, even though
306 physically it is really a parallel port. The Digi Acceleport USB 8
307 is not yet supported.
308
309 Please contact Peter Berger ([email protected]) or Al Borchers
310 ([email protected]) for questions or problems with this
311 driver.
312
313
314 Belkin USB Serial Adapter F5U103
315 --------------------------------
316
317 Single port DB-9/PS-2 serial adapter from Belkin with firmware by eTEK Labs.
318 The Peracom single port serial adapter also works with this driver, as
319 well as the GoHubs adapter.
320
321 Current status:
322
323 The following have been tested and work:
324
325 - Baud rate 300-230400
326 - Data bits 5-8
327 - Stop bits 1-2
328 - Parity N,E,O,M,S
329 - Handshake None, Software (XON/XOFF), Hardware (CTSRTS,CTSDTR) [1]_
330 - Break Set and clear
331 - Line control Input/Output query and control [2]_
332
333 .. [1]
334 Hardware input flow control is only enabled for firmware
335 levels above 2.06. Read source code comments describing Belkin
336 firmware errata. Hardware output flow control is working for all
337 firmware versions.
338
339 .. [2]
340 Queries of inputs (CTS,DSR,CD,RI) show the last
341 reported state. Queries of outputs (DTR,RTS) show the last
342 requested state and may not reflect current state as set by
343 automatic hardware flow control.
344
345 TO DO List:
346 - Add true modem control line query capability. Currently tracks the
347 states reported by the interrupt and the states requested.
348 - Add error reporting back to application for UART error conditions.
349 - Add support for flush ioctls.
350 - Add everything else that is missing :)
351
352 For any questions or problems with this driver, please contact William
353 Greathouse at [email protected]
354
355
356 Empeg empeg-car Mark I/II Driver
357 --------------------------------
358
359 This is an experimental driver to provide connectivity support for the
360 client synchronization tools for an Empeg empeg-car mp3 player.
361
362 Tips:
363 * Don't forget to create the device nodes for ttyUSB{0,1,2,...}
364 * modprobe empeg (modprobe is your friend)
365 * emptool --usb /dev/ttyUSB0 (or whatever you named your device node)
366
367 For any questions or problems with this driver, please contact Gary
368 Brubaker at [email protected]
369
370
371 MCT USB Single Port Serial Adapter U232
372 ---------------------------------------
373
374 This driver is for the MCT USB-RS232 Converter (25 pin, Model No.
375 U232-P25) from Magic Control Technology Corp. (there is also a 9 pin
376 Model No. U232-P9). More information about this device can be found at
377 the manufacturer's web-site: http://www.mct.com.tw.
378
379 The driver is generally working, though it still needs some more testing.
380 It is derived from the Belkin USB Serial Adapter F5U103 driver and its
381 TODO list is valid for this driver as well.
382
383 This driver has also been found to work for other products, which have
384 the same Vendor ID but different Product IDs. Sitecom's U232-P25 serial
385 converter uses Product ID 0x230 and Vendor ID 0x711 and works with this
386 driver. Also, D-Link's DU-H3SP USB BAY also works with this driver.
387
388 For any questions or problems with this driver, please contact Wolfgang
389 Grandegger at [email protected]
390
391
392 Inside Out Networks Edgeport Driver
393 -----------------------------------
394
395 This driver supports all devices made by Inside Out Networks, specifically
396 the following models:
397
398 - Edgeport/4
399 - Rapidport/4
400 - Edgeport/4t
401 - Edgeport/2
402 - Edgeport/4i
403 - Edgeport/2i
404 - Edgeport/421
405 - Edgeport/21
406 - Edgeport/8
407 - Edgeport/8 Dual
408 - Edgeport/2D8
409 - Edgeport/4D8
410 - Edgeport/8i
411 - Edgeport/2 DIN
412 - Edgeport/4 DIN
413 - Edgeport/16 Dual
414
415 For any questions or problems with this driver, please contact Greg
416 Kroah-Hartman at [email protected]
417
418
419 REINER SCT cyberJack pinpad/e-com USB chipcard reader
420 -----------------------------------------------------
421
422 Interface to ISO 7816 compatible contactbased chipcards, e.g. GSM SIMs.
423
424 Current status:
425
426 This is the kernel part of the driver for this USB card reader.
427 There is also a user part for a CT-API driver available. A site
428 for downloading is TBA. For now, you can request it from the
429 maintainer ([email protected]).
430
431 For any questions or problems with this driver, please contact
433
434
435 Prolific PL2303 Driver
436 ----------------------
437
438 This driver supports any device that has the PL2303 chip from Prolific
439 in it. This includes a number of single port USB to serial converters,
440 more than 70% of USB GPS devices (in 2010), and some USB UPSes. Devices
441 from Aten (the UC-232) and IO-Data work with this driver, as does
442 the DCU-11 mobile-phone cable.
443
444 For any questions or problems with this driver, please contact Greg
445 Kroah-Hartman at [email protected]
446
447
448 KL5KUSB105 chipset / PalmConnect USB single-port adapter
449 --------------------------------------------------------
450
451 Current status:
452
453 The driver was put together by looking at the usb bus transactions
454 done by Palm's driver under Windows, so a lot of functionality is
455 still missing. Notably, serial ioctls are sometimes faked or not yet
456 implemented. Support for finding out about DSR and CTS line status is
457 however implemented (though not nicely), so your favorite autopilot(1)
458 and pilot-manager -daemon calls will work. Baud rates up to 115200
459 are supported, but handshaking (software or hardware) is not, which is
460 why it is wise to cut down on the rate used is wise for large
461 transfers until this is settled.
462
463 See http://www.uuhaus.de/linux/palmconnect.html for up-to-date
464 information on this driver.
465
466 Winchiphead CH341 Driver
467 ------------------------
468
469 This driver is for the Winchiphead CH341 USB-RS232 Converter. This chip
470 also implements an IEEE 1284 parallel port, I2C and SPI, but that is not
471 supported by the driver. The protocol was analyzed from the behaviour
472 of the Windows driver, no datasheet is available at present.
473
474 The manufacturer's website: http://www.winchiphead.com/.
475
476 For any questions or problems with this driver, please contact
478
479 Moschip MCS7720, MCS7715 driver
480 -------------------------------
481
482 These chips are present in devices sold by various manufacturers, such as Syba
483 and Cables Unlimited. There may be others. The 7720 provides two serial
484 ports, and the 7715 provides one serial and one standard PC parallel port.
485 Support for the 7715's parallel port is enabled by a separate option, which
486 will not appear unless parallel port support is first enabled at the top-level
487 of the Device Drivers config menu. Currently only compatibility mode is
488 supported on the parallel port (no ECP/EPP).
489
490 TODO:
491 - Implement ECP/EPP modes for the parallel port.
492 - Baud rates higher than 115200 are currently broken.
493 - Devices with a single serial port based on the Moschip MCS7703 may work
494 with this driver with a simple addition to the usb_device_id table. I
495 don't have one of these devices, so I can't say for sure.
496
497 Generic Serial driver
498 ---------------------
499
500 If your device is not one of the above listed devices, compatible with
501 the above models, you can try out the "generic" interface. This
502 interface does not provide any type of control messages sent to the
503 device, and does not support any kind of device flow control. All that
504 is required of your device is that it has at least one bulk in endpoint,
505 or one bulk out endpoint.
506
507 To enable the generic driver to recognize your device, provide::
508
509 echo <vid> <pid> >/sys/bus/usb-serial/drivers/generic/new_id
510
511 where the <vid> and <pid> is replaced with the hex representation of your
512 device's vendor id and product id.
513 If the driver is compiled as a module you can also provide one id when
514 loading the module::
515
516 insmod usbserial vendor=0x#### product=0x####
517
518 This driver has been successfully used to connect to the NetChip USB
519 development board, providing a way to develop USB firmware without
520 having to write a custom driver.
521
522 For any questions or problems with this driver, please contact Greg
523 Kroah-Hartman at [email protected]
524
525
526 Contact
527 =======
528
529 If anyone has any problems using these drivers, with any of the above
530 specified products, please contact the specific driver's author listed
531 above, or join the Linux-USB mailing list (information on joining the
532 mailing list, as well as a link to its searchable archive is at
533 http://www.linux-usb.org/ )
534
535
536 Greg Kroah-Hartman
538

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.

소개

1-14

USB serial driver는 여러 USB-to-serial 변환 제품뿐 아니라 사용자 공간에서 직렬 interface를 통해 장치와 통신하는 일부 장치도 지원합니다.

장치마다 동작 방식과 제한이 다르므로 구체적인 정보는 아래의 개별 제품 절을 확인해야 합니다.

USB 직렬 통신 경로
USB serial deviceUSB serial driver/dev/ttyUSB*Userspace application

USB 장치가 serial interface를 통해 사용자 공간 프로그램과 연결되는 기본 구조입니다.

==========
USB serial
==========

Introduction
============

  The USB serial driver currently supports a number of different USB to
  serial converter products, as well as some devices that use a serial
  interface from userspace to talk to the device.

  See the individual product section below for specific information about
  the different devices.

설정

15-39

드라이버는 동시에 최대 256개의 서로 다른 serial interface를 처리할 수 있습니다.

사용하는 major number는 `188`입니다. 수동으로 device node를 만들 때 `/dev/ttyUSB0`부터 `/dev/ttyUSB255`까지 minor number 0~255를 대응시켜 `mknod`를 실행합니다.

장치가 연결되어 드라이버에 인식되면 어느 node에 bind되었는지가 system log에 출력됩니다.

USB serial device number
항목설명
/dev/ttyUSB0c 188 0
/dev/ttyUSB1c 188 1
/dev/ttyUSB2c 188 2
......
/dev/ttyUSB254c 188 254
/dev/ttyUSB255c 188 255

TTY node와 character-device 번호의 대응입니다.


Configuration
=============

  Currently the driver can handle up to 256 different serial interfaces at
  one time.

    The major number that the driver uses is 188 so to use the driver,
    create the following nodes::

	mknod /dev/ttyUSB0 c 188 0
	mknod /dev/ttyUSB1 c 188 1
	mknod /dev/ttyUSB2 c 188 2
	mknod /dev/ttyUSB3 c 188 3
		.
		.
		.
	mknod /dev/ttyUSB254 c 188 254
	mknod /dev/ttyUSB255 c 188 255

  When the device is connected and recognized by the driver, the driver
  will print to the system log, which node(s) the device has been bound
  to.

ConnectTech WhiteHEAT 4-port converter

40-56

ConnectTech는 시험 장치를 제공하는 등 WhiteHEAT 장치 정보를 적극적으로 공개했습니다.

이 드라이버는 Connect Tech Inc.가 공식 지원합니다. 회사 사이트는 `http://www.connecttech.com`이며 질문이나 문제는 `[email protected]`으로 보냅니다.

WhiteHEAT 지원
항목설명
Port4-port converter
SupportConnect Tech Inc.
Webhttp://www.connecttech.com

공식 지원 주체와 연락 경로입니다.

Specific Devices Supported
==========================


ConnectTech WhiteHEAT 4 port converter
--------------------------------------

  ConnectTech has been very forthcoming with information about their
  device, including providing a unit to test with.

  The driver is officially supported by Connect Tech Inc.
  http://www.connecttech.com

  For any questions or problems with this driver, please contact
  Connect Tech's Support Department at [email protected]

HandSpring Visor, Palm USB 및 Sony Clié

57-101

이 드라이버는 모든 HandSpring USB, Palm USB, Sony Clié USB 장치에서 동작합니다.

장치가 host에 접속을 시도할 때만 유효한 USB 장치로 나타납니다. 이때 장치가 enumerate되고 port를 배정받아 통신할 수 있게 됩니다. 장치를 제거하거나 장치 쪽에서 연결을 취소하면 드라이버도 올바르게 정리합니다.

중요: 프로그램이 장치와 통신을 시도하기 전에 반드시 sync button을 눌러야 합니다. 이는 `pilot-xfer` 등 당시 package 문서와 반대이지만 장치 hardware 때문에 필요한 순서입니다.

연결 뒤에는 두 번째 port를 먼저 사용합니다. 다른 usb-serial 장치가 없다면 보통 `/dev/ttyUSB1`입니다. HotSync 전송에 사용할 port는 system log가 알려 주며, `Generic` port는 PPP link 같은 다른 장치 통신에 쓸 수 있습니다.

일부 Sony Clié 장치, 특히 OS 3.5 장치 전부와 더 새 OS로 flash upgrade한 장치 대부분은 `/dev/ttyUSB0`을 사용해야 합니다. 정확한 port는 kernel system log에서 확인합니다.

sync button을 눌러도 system log에 아무것도 나타나지 않으면 먼저 hot reset을, 필요하면 cold reset을 수행합니다. 일부 장치는 USB port와 제대로 통신하기 전에 reset이 필요합니다.

kernel에 compile되지 않은 장치는 module parameter로 지정할 수 있습니다. 예는 `modprobe visor vendor=0x54c product=0x66`입니다.

이 부분의 웹페이지와 mailing list는 `http://sourceforge.net/projects/usbvisor/`에 있습니다. 질문과 문제는 Greg Kroah-Hartman(`[email protected]`)에게 문의합니다.

Visor/Palm 연결 순서
프로그램 실행 전 sync button 누르기USB enumeration 및 port 할당system log에서 HotSync port 확인/dev/ttyUSB1 또는 Clié의 /dev/ttyUSB0 사용문제가 있으면 hot reset 후 cold reset

장치가 host에 나타나는 시점과 HotSync port 선택 절차입니다.

HandSpring Visor, Palm USB, and Clié USB driver
-----------------------------------------------

  This driver works with all HandSpring USB, Palm USB, and Sony Clié USB
  devices.

  Only when the device tries to connect to the host, will the device show
  up to the host as a valid USB device. When this happens, the device is
  properly enumerated, assigned a port, and then communication _should_ be
  possible. The driver cleans up properly when the device is removed, or
  the connection is canceled on the device.

  NOTE:
    This means that in order to talk to the device, the sync button must be
    pressed BEFORE trying to get any program to communicate to the device.
    This goes against the current documentation for pilot-xfer and other
    packages, but is the only way that it will work due to the hardware
    in the device.

  When the device is connected, try talking to it on the second port
  (this is usually /dev/ttyUSB1 if you do not have any other usb-serial
  devices in the system.) The system log should tell you which port is
  the port to use for the HotSync transfer. The "Generic" port can be used
  for other device communication, such as a PPP link.

  For some Sony Clié devices, /dev/ttyUSB0 must be used to talk to the
  device.  This is true for all OS version 3.5 devices, and most devices
  that have had a flash upgrade to a newer version of the OS.  See the
  kernel system log for information on which is the correct port to use.

  If after pressing the sync button, nothing shows up in the system log,
  try resetting the device, first a hot reset, and then a cold reset if
  necessary.  Some devices need this before they can talk to the USB port
  properly.

  Devices that are not compiled into the kernel can be specified with module
  parameters.  e.g. modprobe visor vendor=0x54c product=0x66

  There is a webpage and mailing lists for this portion of the driver at:
  http://sourceforge.net/projects/usbvisor/

  For any questions or problems with this driver, please contact Greg
  Kroah-Hartman at [email protected]

PocketPC PDA driver

102-153

이 드라이버는 USB cable 또는 cradle을 통해 Windows CE 3.0이나 PocketPC 2002를 실행하는 Compaq iPAQ, HP Jornada, Casio EM500 및 다른 PDA를 연결합니다.

ActiveSync가 지원하는 장치 대부분은 별도 설정 없이 동작합니다. 나머지는 `modprobe ipaq vendor=0x3f0 product=0x1125`처럼 module parameter로 product ID와 vendor ID를 지정합니다.

드라이버는 보통 `/dev/ttyUSB0`에 serial interface를 제공하며, 그 위에서 PPP를 실행해 PDA와 TCP/IP link를 만들 수 있습니다. 연결 후 file 전송, backup, email download 등이 가능하며 원문 작성자의 iPAQ에서는 upload/download 속도가 73~113 kbytes/sec였습니다.

USB 연결에는 이 드라이버 외의 구성 요소도 필요합니다. `http://synce.sourceforge.net`에서 필요한 package와 단계별 howto를 제공합니다.

연결 뒤 PDA 쪽에서는 `ftpView`, `Pocket Outlook` 같은 Win CE 프로그램을, Linux 쪽에서는 `xcerdisp`와 synce utility를 사용할 수 있습니다.

Pocket IE 사용 절차는 `http://www.tekguru.co.uk/EM500/usbtonet.htm`의 Win98 절차를 참고하되 proxy server 부분은 생략합니다. Linux는 packet forwarding이 가능하기 때문입니다.

적어도 iPAQ에서는 Start/Settings/Connections에서 `Automatically synchronize ...` 선택을 해제해 autosync를 비활성화해야 합니다. Start/Programs/Connections로 이동해 cable을 연결하고 `usbdial` 또는 사용자가 붙인 USB connection 이름을 선택합니다. `Connected to usbdial` 창이 connected 상태를 보이면 PIE를 시작해 탐색합니다.

동작하지 않으면 `usbserial`과 `ipaq` module을 모두 `debug=1`로 load하고 system log를 확인합니다. 연결 전에 PDA를 soft reset하는 방법도 시도할 수 있습니다.

PDA에 따라 다른 기능도 가능할 수 있습니다. Toshiba E570은 power button을 누른 채 reset하여 bootloader가 표시될 때까지 유지하고, `ipaq` driver를 load한 상태로 cradle에 꽂은 뒤 `/dev/ttyUSB0` terminal을 열면 `USB Reflash` terminal이 나타나 ROM과 microP code를 flash할 수 있다는 사용자 보고가 있습니다.

이 Toshiba E570 방법은 시험되지 않았으므로 전적으로 사용자 책임으로 사용해야 합니다. 드라이버 문의처는 Ganesh Varadarajan(`[email protected]`)입니다.

PocketPC 연결 핵심
항목설명
PDA/OSCompaq iPAQ, HP Jornada, Casio EM500 등; Windows CE 3.0/PocketPC 2002
Device보통 /dev/ttyUSB0
NetworkPPP를 통한 TCP/IP
Measured speed73~113 kbytes/sec
Debugusbserial debug=1 + ipaq debug=1
주의E570 USB Reflash 절차는 미시험

지원 환경, interface와 진단 방법을 요약합니다.

PocketPC PDA Driver
-------------------

  This driver can be used to connect to Compaq iPAQ, HP Jornada, Casio EM500
  and other PDAs running Windows CE 3.0 or PocketPC 2002 using a USB
  cable/cradle.
  Most devices supported by ActiveSync are supported out of the box.
  For others, please use module parameters to specify the product and vendor
  id. e.g. modprobe ipaq vendor=0x3f0 product=0x1125

  The driver presents a serial interface (usually on /dev/ttyUSB0) over
  which one may run ppp and establish a TCP/IP link to the PDA. Once this
  is done, you can transfer files, backup, download email etc. The most
  significant advantage of using USB is speed - I can get 73 to 113
  kbytes/sec for download/upload to my iPAQ.

  This driver is only one of a set of components required to utilize
  the USB connection. Please visit http://synce.sourceforge.net which
  contains the necessary packages and a simple step-by-step howto.

  Once connected, you can use Win CE programs like ftpView, Pocket Outlook
  from the PDA and xcerdisp, synce utilities from the Linux side.

  To use Pocket IE, follow the instructions given at
  http://www.tekguru.co.uk/EM500/usbtonet.htm to achieve the same thing
  on Win98. Omit the proxy server part; Linux is quite capable of forwarding
  packets unlike Win98. Another modification is required at least for the
  iPAQ - disable autosync by going to the Start/Settings/Connections menu
  and unchecking the "Automatically synchronize ..." box. Go to
  Start/Programs/Connections, connect the cable and select "usbdial" (or
  whatever you named your new USB connection). You should finally wind
  up with a "Connected to usbdial" window with status shown as connected.
  Now start up PIE and browse away.

  If it doesn't work for some reason, load both the usbserial and ipaq module
  with the module parameter "debug" set to 1 and examine the system log.
  You can also try soft-resetting your PDA before attempting a connection.

  Other functionality may be possible depending on your PDA. According to
  Wes Cilldhaire <[email protected]>, with the Toshiba E570,
  ...if you boot into the bootloader (hold down the power when hitting the
  reset button, continuing to hold onto the power until the bootloader screen
  is displayed), then put it in the cradle with the ipaq driver loaded, open
  a terminal on /dev/ttyUSB0, it gives you a "USB Reflash" terminal, which can
  be used to flash the ROM, as well as the microP code..  so much for needing
  Toshiba's $350 serial cable for flashing!! :D
  NOTE: This has NOT been tested. Use at your own risk.

  For any questions or problems with the driver, please contact Ganesh
  Varadarajan <[email protected]>

Keyspan PDA serial adapter

154-185

이 장치는 iMac용 PDA adapter로 판매된 single-port DB-9 serial adapter이며 반투명한 흰색/녹색 dongle 형태입니다. 단순한 장치이고 firmware는 자체 제작되었습니다. Xircom/Entrega single-port serial adapter도 같은 드라이버로 동작합니다.

동작하는 기능은 `cu`로 시험한 기본 입출력, serial line이 따라가지 못할 때의 blocking write, 최대 115200 baud 변경, `TIOCM{GET,SET,BIS,BIC}` modem control pin 읽기/설정, break 전송입니다. 다만 break 지속 시간은 의심스럽습니다.

동작하지 않는 부분은 kernel log의 device string 뒤에 붙는 binary garbage, 다른 Keyspan 제품과 충돌할 수 있는 잘못된 device ID, baud 변경 시 TX/RX를 flush하지 않아 생길 수 있는 잘린 character입니다.

주요 TODO는 parity, 7/8 data bits, 1/2 stop bits, hardware flow control, 그리고 `Get_Status`, `Set_Feature`, `O_NONBLOCK`, `select()` 등 아직 다루지 않는 표준 USB descriptor·동작입니다.

문의처는 Brian Warner(`[email protected]`)입니다.

Keyspan PDA 상태
항목설명
Worksbasic I/O, blocking write, baud <=115200, modem pins, break
Brokendevice strings, device ID, baud-change TX/RX flush
TODOparity, 7/8 bits, 1/2 stop bits, HW flow control, descriptors
CompatibleXircom/Entrega single-port adapter

검증된 기능과 남은 제한입니다.

Keyspan PDA Serial Adapter
--------------------------

  Single port DB-9 serial adapter, pushed as a PDA adapter for iMacs (mostly
  sold in Macintosh catalogs, comes in a translucent white/green dongle).
  Fairly simple device. Firmware is homebrew.
  This driver also works for the Xircom/Entrega single port serial adapter.

  Current status:

   Things that work:
     - basic input/output (tested with 'cu')
     - blocking write when serial line can't keep up
     - changing baud rates (up to 115200)
     - getting/setting modem control pins (TIOCM{GET,SET,BIS,BIC})
     - sending break (although duration looks suspect)

   Things that don't:
     - device strings (as logged by kernel) have trailing binary garbage
     - device ID isn't right, might collide with other Keyspan products
     - changing baud rates ought to flush tx/rx to avoid mangled half characters

   Big Things on the todo list:
     - parity, 7 vs 8 bits per char, 1 or 2 stop bits
     - HW flow control
     - not all of the standard USB descriptors are handled:
       Get_Status, Set_Feature, O_NONBLOCK, select()

  For any questions or problems with this driver, please contact Brian
  Warner at [email protected]

Keyspan USA-series serial adapter

186-210

Single, Dual, Quad port adapter를 지원하며 드라이버는 Keyspan이 제공한 firmware를 사용하고 회사의 지원 아래 개발됩니다.

`USA-18X`, `USA-28X`, `USA-19`, `USA-19W`, `USA-49W`는 지원되며 여러 baud rate와 8-N-1 문자 설정으로 충분히 시험되었습니다. 다른 character length와 parity 설정은 당시 시험되지 않았습니다.

`USA-28`은 아직 지원하지 않지만 구현은 비교적 단순할 것으로 봅니다. 이 기능이 필요하면 maintainer에게 연락해야 합니다.

추가 정보는 `http://www.carnationsoftware.com/carnation/Keyspan.html`, 문의처는 Hugh Blemings(`[email protected]`)입니다.

Keyspan USA-series
항목설명
Supported/testedUSA-18X, USA-28X, USA-19, USA-19W, USA-49W
Tested framing8-N-1, various baud rates
Not supportedUSA-28
Untestedother character lengths and parity

모델별 지원 상태입니다.

Keyspan USA-series Serial Adapters
----------------------------------

  Single, Dual and Quad port adapters - driver uses Keyspan supplied
  firmware and is being developed with their support.

  Current status:

    The USA-18X, USA-28X, USA-19, USA-19W and USA-49W are supported and
    have been pretty thoroughly tested at various baud rates with 8-N-1
    character settings.  Other character lengths and parity setups are
    presently untested.

    The USA-28 isn't yet supported though doing so should be pretty
    straightforward.  Contact the maintainer if you require this
    functionality.

  More information is available at:

        http://www.carnationsoftware.com/carnation/Keyspan.html

  For any questions or problems with this driver, please contact Hugh
  Blemings at [email protected]

FTDI single-port serial driver

211-223

FTDI 드라이버가 설명하는 장치는 single-port DB-25 serial adapter입니다.

지원 장치에는 `TripNav TN-200 USB GPS`와 `Navis Engineering Bureau CH-4711 USB GPS`가 포함됩니다. 문의처는 Bill Ryder입니다.

FTDI 지원 예
항목설명
TripNavTN-200 USB GPS
Navis Engineering BureauCH-4711 USB GPS

원문에 명시된 single-port DB-25 기반 장치입니다.

FTDI Single Port Serial Driver
------------------------------

  This is a single port DB-25 serial adapter.

  Devices supported include:

                - TripNav TN-200 USB GPS
                - Navis Engineering Bureau CH-4711 USB GPS

  For any questions or problems with this driver, please contact Bill Ryder.

ZyXEL omni.net lcd plus ISDN TA

224-230

이 장치는 ISDN terminal adapter(TA)입니다. 성공 사례와 문제를 모두 `[email protected]`로 보고합니다.

ZyXEL 장치
항목설명
Modelomni.net lcd plus
TypeISDN TA

장치 유형과 보고 주소입니다.

ZyXEL omni.net lcd plus ISDN TA
-------------------------------

  This is an ISDN TA. Please report both successes and troubles to
  [email protected]

Cypress M8 CY4601 family serial driver

231-291

이 드라이버는 대부분 Neil `koyama` Whelchel이 개발했습니다. 이후 dynamic serial-line setting과 line handling을 개선했으며, 대체로 안정적이고 dual-P2 SMP machine에서 시험되었습니다.

CY4601 family에서 지원하는 chipset은 `CY7C63723`, `CY7C63742`, `CY7C63743`, `CY7C64013`입니다.

명시된 지원 장치는 SiRF Star II lp architecture를 쓰는 DeLorme USB Earthmate GPS와 Cypress HID-to-COM RS232 adapter입니다. Cypress Semiconductor는 HID-to-COM 장치와 관계가 없다고 밝힙니다.

CY4601 usbserial specification을 준수하는 한 이 family chipset을 쓰는 장치 대부분이 동작할 것으로 예상합니다.

Earthmate의 기본 설정은 4800 8N1이며 드라이버가 시작할 때 이 값으로 초기화합니다. 나머지 termios setting은 usbserial core와 일부 custom termios가 제공해 출력 형식을 올바르게 만들고 parsing할 수 있게 합니다.

장치를 SiRF mode로 바꾸려면 NMEA command `$PSRF100,<protocol>,<baud>,<databits>,<stopbits>,<parity>*CHECKSUM`을 보냅니다. 원문의 예는 `$PSRF100,0,9600,8,1,0*0C`이며 그 뒤 port termios를 같은 값으로 변경하면 통신할 수 있습니다.

firmware 2.31에서 온라인 문서에 있는 거의 모든 SiRF command를 지원하는 것으로 보이지만 일부 message ID는 알려지지 않았습니다.

HID-to-COM adapter의 최대 속도는 115200 bps입니다. line voltage를 제대로 올리지 못하거나 어려움을 겪으므로 null-modem link에서는 괜찮지만 adapter를 개조해 line을 high로 두지 않은 채 두 개를 서로 연결해서는 안 됩니다.

드라이버는 SMP-safe입니다. file 전송 성능은 낮으며 개선 중입니다. URB queue나 packet buffer가 적합한 개선책으로 보이고 patch를 받습니다.

질문, 문제, patch, 기능 요청은 `[email protected]`으로 보내거나 usb-devel에 제출할 수 있습니다.

Cypress CY4601 지원
항목설명
ChipsetsCY7C63723, CY7C63742, CY7C63743, CY7C64013
Earthmate default4800 8N1
SiRF example$PSRF100,0,9600,8,1,0*0C
HID-to-COM maximum115200 bps
ConcurrencySMP-safe
Performance ideaURB queue or packet buffer

chipset, 장치와 통신 한계입니다.

Cypress M8 CY4601 Family Serial Driver
--------------------------------------

  This driver was in most part developed by Neil "koyama" Whelchel.  It
  has been improved since that previous form to support dynamic serial
  line settings and improved line handling.  The driver is for the most
  part stable and has been tested on an smp machine. (dual p2)

    Chipsets supported under CY4601 family:

		CY7C63723, CY7C63742, CY7C63743, CY7C64013

    Devices supported:

		- DeLorme's USB Earthmate GPS (SiRF Star II lp arch)
		- Cypress HID->COM RS232 adapter

		Note:
			Cypress Semiconductor claims no affiliation with the
			hid->com device.

     Most devices using chipsets under the CY4601 family should
     work with the driver.  As long as they stay true to the CY4601
     usbserial specification.

    Technical notes:

        The Earthmate starts out at 4800 8N1 by default... the driver will
	upon start init to this setting.  usbserial core provides the rest
	of the termios settings, along with some custom termios so that the
	output is in proper format and parsable.

	The device can be put into sirf mode by issuing NMEA command::

		$PSRF100,<protocol>,<baud>,<databits>,<stopbits>,<parity>*CHECKSUM
		$PSRF100,0,9600,8,1,0*0C

		It should then be sufficient to change the port termios to match this
		to begin communicating.

	As far as I can tell it supports pretty much every sirf command as
	documented online available with firmware 2.31, with some unknown
	message ids.

	The hid->com adapter can run at a maximum baud of 115200bps.  Please note
	that the device has trouble or is incapable of raising line voltage properly.
	It will be fine with null modem links, as long as you do not try to link two
	together without hacking the adapter to set the line high.

	The driver is smp safe.  Performance with the driver is rather low when using
	it for transferring files.  This is being worked on, but I would be willing to
	accept patches.  An urb queue or packet buffer would likely fit the bill here.

	If you have any questions, problems, patches, feature requests, etc. you can
	contact me here via email:

					[email protected]

		(your problems/patches can alternately be submitted to usb-devel)

Digi AccelePort driver

292-313

이 드라이버는 Digi AccelePort USB 2와 USB 4를 지원합니다. 각각 2개의 serial port와 parallel port 하나, 또는 4개의 USB serial port를 제공하지만 Digi AccelePort USB 8은 아직 지원하지 않습니다.

SMP에서 `usb-uhci` driver와는 동작하지만 `uhci` driver와는 동작하지 않습니다.

대체로 동작하지만 일부 ioctl 구현과 최종 시험·debugging이 남아 있습니다. USB 2의 물리적 parallel port는 serial-to-parallel converter로 지원되어 Linux에서는 또 하나의 USB serial port처럼 나타납니다.

문의처는 Peter Berger(`[email protected]`) 또는 Al Borchers(`[email protected]`)입니다.

Digi AccelePort 상태
항목설명
USB 2지원; 2 serial + 1 parallel-as-serial
USB 4지원; 4 serial
USB 8미지원
SMP + usb-uhci동작
SMP + uhci동작하지 않음
Remaining일부 ioctls, final test/debug

모델과 SMP host-controller 조합의 지원 상태입니다.

Digi AccelePort Driver
----------------------

  This driver supports the Digi AccelePort USB 2 and 4 devices, 2 port
  (plus a parallel port) and 4 port USB serial converters.  The driver
  does NOT yet support the Digi AccelePort USB 8.

  This driver works under SMP with the usb-uhci driver.  It does not
  work under SMP with the uhci driver.

  The driver is generally working, though we still have a few more ioctls
  to implement and final testing and debugging to do.  The parallel port
  on the USB 2 is supported as a serial to parallel converter; in other
  words, it appears as another USB serial port on Linux, even though
  physically it is really a parallel port.  The Digi Acceleport USB 8
  is not yet supported.

  Please contact Peter Berger ([email protected]) or Al Borchers
  ([email protected]) for questions or problems with this
  driver.

Belkin F5U103 USB serial adapter

314-355

eTEK Labs firmware를 쓰는 Belkin single-port DB-9/PS-2 serial adapter입니다. Peracom single-port adapter와 GoHubs adapter도 이 드라이버로 동작합니다.

시험되어 동작하는 범위는 baud rate 300~230400, data bits 5~8, stop bits 1~2, parity N/E/O/M/S, handshake 없음·software XON/XOFF·hardware CTSRTS/CTSDTR, break 설정·해제, line-control input/output 조회·제어입니다.

hardware input flow control은 firmware 2.06보다 높은 version에서만 활성화됩니다. Belkin firmware errata는 source code comment를 확인해야 합니다. hardware output flow control은 모든 firmware version에서 동작합니다.

input `CTS`, `DSR`, `CD`, `RI` 조회는 마지막으로 보고된 상태를 보여 줍니다. output `DTR`, `RTS` 조회는 마지막 요청 상태를 보여 주므로 automatic hardware flow control이 정한 현재 상태와 다를 수 있습니다.

TODO는 진정한 modem-control line 조회, UART error condition을 application에 보고, flush ioctl 지원, 그 밖의 빠진 기능 추가입니다. 현재 구현은 interrupt가 보고한 상태와 요청한 상태를 추적합니다.

문의처는 William Greathouse(`[email protected]`)입니다.

Belkin F5U103 시험 범위
항목설명
Baud300~230400
Data bits5~8
Stop bits1~2
ParityN, E, O, M, S
HandshakeNone, XON/XOFF, CTSRTS, CTSDTR
Breakset/clear
Line controlinput/output query and control

원문이 동작한다고 명시한 serial setting입니다.

Belkin USB Serial Adapter F5U103
--------------------------------

  Single port DB-9/PS-2 serial adapter from Belkin with firmware by eTEK Labs.
  The Peracom single port serial adapter also works with this driver, as
  well as the GoHubs adapter.

  Current status:

    The following have been tested and work:

      - Baud rate    300-230400
      - Data bits    5-8
      - Stop bits    1-2
      - Parity       N,E,O,M,S
      - Handshake    None, Software (XON/XOFF), Hardware (CTSRTS,CTSDTR) [1]_
      - Break        Set and clear
      - Line control Input/Output query and control [2]_

  .. [1]
         Hardware input flow control is only enabled for firmware
         levels above 2.06.  Read source code comments describing Belkin
         firmware errata.  Hardware output flow control is working for all
         firmware versions.

  .. [2]
         Queries of inputs (CTS,DSR,CD,RI) show the last
         reported state.  Queries of outputs (DTR,RTS) show the last
         requested state and may not reflect current state as set by
         automatic hardware flow control.

  TO DO List:
    - Add true modem control line query capability.  Currently tracks the
      states reported by the interrupt and the states requested.
    - Add error reporting back to application for UART error conditions.
    - Add support for flush ioctls.
    - Add everything else that is missing :)

  For any questions or problems with this driver, please contact William
  Greathouse at [email protected]

Empeg empeg-car Mark I/II driver

356-370

Empeg empeg-car MP3 player용 client synchronization tool의 연결을 제공하는 experimental driver입니다.

사용하려면 `ttyUSB{0,1,2,...}` device node를 만들고 `modprobe empeg`로 module을 load한 뒤 `emptool --usb /dev/ttyUSB0`처럼 실제 node를 지정합니다.

질문과 문제는 Gary Brubaker(`[email protected]`)에게 문의합니다.

Empeg 연결
ttyUSB device node 생성modprobe empegemptool --usb /dev/ttyUSB0

device node 준비부터 synchronization tool 실행까지의 순서입니다.

Empeg empeg-car Mark I/II Driver
--------------------------------

  This is an experimental driver to provide connectivity support for the
  client synchronization tools for an Empeg empeg-car mp3 player.

  Tips:
    * Don't forget to create the device nodes for ttyUSB{0,1,2,...}
    * modprobe empeg (modprobe is your friend)
    * emptool --usb /dev/ttyUSB0 (or whatever you named your device node)

  For any questions or problems with this driver, please contact Gary
  Brubaker at [email protected]

MCT U232 single-port serial adapter

371-391

Magic Control Technology Corp.의 MCT USB-RS232 converter용 드라이버입니다. 25-pin `U232-P25`와 9-pin `U232-P9` 모델이 있으며 제조사 사이트는 `http://www.mct.com.tw`입니다.

드라이버는 대체로 동작하지만 더 많은 시험이 필요합니다. Belkin F5U103 driver에서 파생되었으므로 그 TODO list도 이 드라이버에 적용됩니다.

같은 Vendor ID와 다른 Product ID를 가진 제품에서도 동작합니다. Sitecom U232-P25는 Product ID `0x230`, Vendor ID `0x711`을 사용하며 이 드라이버로 동작하고, D-Link DU-H3SP USB BAY도 동작합니다.

문의처는 Wolfgang Grandegger(`[email protected]`)입니다.

MCT 호환 장치
항목설명
MCTU232-P25 (25-pin), U232-P9 (9-pin)
Sitecom U232-P25product=0x230, vendor=0x711
D-LinkDU-H3SP USB BAY
Base driverBelkin F5U103

모델과 USB ID 또는 호환 관계입니다.

MCT USB Single Port Serial Adapter U232
---------------------------------------

  This driver is for the MCT USB-RS232 Converter (25 pin, Model No.
  U232-P25) from Magic Control Technology Corp. (there is also a 9 pin
  Model No. U232-P9). More information about this device can be found at
  the manufacturer's web-site: http://www.mct.com.tw.

  The driver is generally working, though it still needs some more testing.
  It is derived from the Belkin USB Serial Adapter F5U103 driver and its
  TODO list is valid for this driver as well.

  This driver has also been found to work for other products, which have
  the same Vendor ID but different Product IDs. Sitecom's U232-P25 serial
  converter uses Product ID 0x230 and Vendor ID 0x711 and works with this
  driver. Also, D-Link's DU-H3SP USB BAY also works with this driver.

  For any questions or problems with this driver, please contact Wolfgang
  Grandegger at [email protected]

Inside Out Networks Edgeport driver

392-418

이 드라이버는 Inside Out Networks가 만든 장치를 지원합니다.

명시된 모델은 `Edgeport/4`, `Rapidport/4`, `Edgeport/4t`, `Edgeport/2`, `Edgeport/4i`, `Edgeport/2i`, `Edgeport/421`, `Edgeport/21`, `Edgeport/8`, `Edgeport/8 Dual`, `Edgeport/2D8`, `Edgeport/4D8`, `Edgeport/8i`, `Edgeport/2 DIN`, `Edgeport/4 DIN`, `Edgeport/16 Dual`입니다.

질문과 문제는 Greg Kroah-Hartman(`[email protected]`)에게 문의합니다.

Inside Out Networks 모델
항목설명
4-port familyEdgeport/4, Rapidport/4, Edgeport/4t, Edgeport/4i, Edgeport/421, Edgeport/4 DIN
2-port familyEdgeport/2, Edgeport/2i, Edgeport/21, Edgeport/2 DIN
8-port familyEdgeport/8, Edgeport/8 Dual, Edgeport/8i
Mixed/high densityEdgeport/2D8, Edgeport/4D8, Edgeport/16 Dual

원문에 열거된 지원 장치 전체입니다.

Inside Out Networks Edgeport Driver
-----------------------------------

  This driver supports all devices made by Inside Out Networks, specifically
  the following models:

       - Edgeport/4
       - Rapidport/4
       - Edgeport/4t
       - Edgeport/2
       - Edgeport/4i
       - Edgeport/2i
       - Edgeport/421
       - Edgeport/21
       - Edgeport/8
       - Edgeport/8 Dual
       - Edgeport/2D8
       - Edgeport/4D8
       - Edgeport/8i
       - Edgeport/2 DIN
       - Edgeport/4 DIN
       - Edgeport/16 Dual

  For any questions or problems with this driver, please contact Greg
  Kroah-Hartman at [email protected]

REINER SCT cyberJack chipcard reader

419-434

REINER SCT cyberJack pinpad/e-com USB reader는 GSM SIM 같은 ISO 7816 호환 접촉식 chipcard에 대한 interface를 제공합니다.

이 문서의 드라이버는 USB card reader의 kernel 부분입니다. CT-API driver의 user 부분도 존재하지만 download site는 추후 발표 예정이었으며, 현재는 maintainer `[email protected]`에게 요청할 수 있다고 설명합니다.

질문과 문제의 연락처도 `[email protected]`입니다.

cyberJack software 구성
ISO 7816 contact cardcyberJack USB readerKernel driverUserspace CT-API driver

reader를 사용하려면 kernel 부분과 사용자 CT-API 부분이 함께 필요합니다.

REINER SCT cyberJack pinpad/e-com USB chipcard reader
-----------------------------------------------------

  Interface to ISO 7816 compatible contactbased chipcards, e.g. GSM SIMs.

  Current status:

    This is the kernel part of the driver for this USB card reader.
    There is also a user part for a CT-API driver available. A site
    for downloading is TBA. For now, you can request it from the
    maintainer ([email protected]).

  For any questions or problems with this driver, please contact
  [email protected]

Prolific PL2303 driver

435-447

이 드라이버는 Prolific PL2303 chip을 탑재한 모든 장치를 지원합니다.

여기에는 여러 single-port USB-to-serial converter, 2010년 기준 USB GPS 장치의 70% 이상, 일부 USB UPS가 포함됩니다. Aten `UC-232`, IO-Data 제품, `DCU-11` mobile-phone cable도 동작합니다.

질문과 문제는 Greg Kroah-Hartman(`[email protected]`)에게 문의합니다.

PL2303 사용 범위
항목설명
Converterssingle-port USB-to-serial
GPS2010년 기준 USB GPS의 70% 이상
Power일부 USB UPS
ExamplesAten UC-232, IO-Data, DCU-11 cable

원문이 제시한 대표 제품군입니다.

Prolific PL2303 Driver
----------------------

  This driver supports any device that has the PL2303 chip from Prolific
  in it.  This includes a number of single port USB to serial converters,
  more than 70% of USB GPS devices (in 2010), and some USB UPSes. Devices
  from Aten (the UC-232) and IO-Data work with this driver, as does
  the DCU-11 mobile-phone cable.

  For any questions or problems with this driver, please contact Greg
  Kroah-Hartman at [email protected]

KL5KUSB105 / PalmConnect adapter

448-465

이 드라이버는 Windows에서 Palm driver가 수행한 USB bus transaction을 관찰해 작성했으므로 많은 기능이 빠져 있습니다. 특히 serial ioctl 일부는 흉내만 내거나 아직 구현하지 않았습니다.

DSR·CTS line status 확인 기능은 다소 거친 형태로 구현되어 있어 `autopilot(1)`과 `pilot-manager -daemon` 호출은 동작합니다.

최대 115200 baud를 지원하지만 software와 hardware handshaking은 모두 지원하지 않습니다. 이 문제가 해결되기 전에는 큰 전송에서 속도를 낮추는 것이 좋습니다.

최신 정보는 `http://www.uuhaus.de/linux/palmconnect.html`을 참고합니다.

PalmConnect 제한
항목설명
Serial ioctls일부 fake 또는 미구현
Line statusDSR/CTS 지원
Baud최대 115200
Handshakingsoftware/hardware 모두 미지원
Large transfers속도를 낮추는 것이 권장됨

reverse-engineered driver의 구현 상태입니다.

KL5KUSB105 chipset / PalmConnect USB single-port adapter
--------------------------------------------------------

Current status:

  The driver was put together by looking at the usb bus transactions
  done by Palm's driver under Windows, so a lot of functionality is
  still missing.  Notably, serial ioctls are sometimes faked or not yet
  implemented.  Support for finding out about DSR and CTS line status is
  however implemented (though not nicely), so your favorite autopilot(1)
  and pilot-manager -daemon calls will work.  Baud rates up to 115200
  are supported, but handshaking (software or hardware) is not, which is
  why it is wise to cut down on the rate used is wise for large
  transfers until this is settled.

  See http://www.uuhaus.de/linux/palmconnect.html for up-to-date
  information on this driver.

Winchiphead CH341 driver

466-478

Winchiphead CH341 USB-RS232 converter용 드라이버입니다.

CH341은 IEEE 1284 parallel port, I2C, SPI도 구현하지만 이 드라이버는 해당 기능을 지원하지 않습니다. 공개 datasheet가 없어 Windows driver의 동작을 분석해 protocol을 파악했습니다.

제조사 사이트는 `http://www.winchiphead.com/`, 문의처는 `[email protected]`입니다.

CH341 기능 범위
항목설명
SupportedUSB-RS232
Not supportedIEEE 1284 parallel, I2C, SPI
Protocol sourceWindows driver behavior analysis
Datasheet당시 공개 자료 없음

chip 기능과 이 드라이버의 지원 범위를 구분합니다.

Winchiphead CH341 Driver
------------------------

  This driver is for the Winchiphead CH341 USB-RS232 Converter. This chip
  also implements an IEEE 1284 parallel port, I2C and SPI, but that is not
  supported by the driver. The protocol was analyzed from the behaviour
  of the Windows driver, no datasheet is available at present.

  The manufacturer's website: http://www.winchiphead.com/.

  For any questions or problems with this driver, please contact
  [email protected].

Moschip MCS7720/MCS7715 driver

479-496

이 chip은 Syba, Cables Unlimited 등 여러 제조사의 장치에 들어 있습니다. 다른 제품도 있을 수 있습니다.

MCS7720은 serial port 두 개를 제공하고 MCS7715는 serial port 하나와 표준 PC parallel port 하나를 제공합니다.

MCS7715 parallel port 지원은 별도 option으로 켜며, Device Drivers 최상위 configuration에서 parallel-port support를 먼저 활성화해야 해당 option이 나타납니다. parallel port는 compatibility mode만 지원하고 ECP/EPP는 지원하지 않습니다.

TODO는 parallel port ECP/EPP mode 구현과 115200보다 높은 baud rate 수정입니다. single serial port MCS7703 장치는 `usb_device_id` table에 간단히 추가하면 동작할 수 있지만 작성자에게 장치가 없어 확정하지 못했습니다.

Moschip port 구성
항목설명
MCS77202 serial ports
MCS77151 serial + 1 PC parallel
Parallel modecompatibility only; no ECP/EPP
Baud >115200현재 고장
MCS7703usb_device_id 추가로 가능할 수 있으나 미확인

chip별 port와 제한입니다.

Moschip MCS7720, MCS7715 driver
-------------------------------

  These chips are present in devices sold by various manufacturers, such as Syba
  and Cables Unlimited.  There may be others.  The 7720 provides two serial
  ports, and the 7715 provides one serial and one standard PC parallel port.
  Support for the 7715's parallel port is enabled by a separate option, which
  will not appear unless parallel port support is first enabled at the top-level
  of the Device Drivers config menu.  Currently only compatibility mode is
  supported on the parallel port (no ECP/EPP).

  TODO:
    - Implement ECP/EPP modes for the parallel port.
    - Baud rates higher than 115200 are currently broken.
    - Devices with a single serial port based on the Moschip MCS7703 may work
      with this driver with a simple addition to the usb_device_id table.  I
      don't have one of these devices, so I can't say for sure.

Generic serial driver

497-525

앞에서 열거한 장치나 호환 모델이 아니라면 `generic` interface를 시험할 수 있습니다.

generic interface는 장치로 보내는 control message를 제공하지 않고 어떤 device flow control도 지원하지 않습니다. 장치는 bulk-in endpoint 또는 bulk-out endpoint를 적어도 하나 가져야 합니다.

generic driver가 장치를 인식하게 하려면 `echo <vid> <pid> >/sys/bus/usb-serial/drivers/generic/new_id`를 실행하고 `<vid>`, `<pid>`를 장치 vendor ID와 product ID의 16진수 표현으로 바꿉니다.

드라이버가 module로 compile되었다면 load할 때 ID 하나를 `insmod usbserial vendor=0x#### product=0x####` 형식으로 전달할 수도 있습니다.

이 드라이버는 NetChip USB development board 연결에 성공적으로 사용되어 custom driver를 작성하지 않고 USB firmware를 개발하는 방법을 제공했습니다.

질문과 문제는 Greg Kroah-Hartman(`[email protected]`)에게 문의합니다.

Generic 장치 등록
장치의 VID/PID 확인generic/new_id에 echo 또는 usbserial module parameter 지정bulk-in/bulk-out endpoint 확인/dev/ttyUSB*에서 통신

USB ID를 runtime 또는 module-load 시점에 제공하는 두 경로입니다.

Generic driver 계약
항목설명
Requiredbulk-in 또는 bulk-out endpoint 최소 1개
Runtime ID/sys/bus/usb-serial/drivers/generic/new_id
Module IDvendor=0x#### product=0x####
No controldevice control messages 미제공
No flow controldevice flow control 미지원

최소 endpoint 조건과 지원하지 않는 기능입니다.

Generic Serial driver
---------------------

  If your device is not one of the above listed devices, compatible with
  the above models, you can try out the "generic" interface. This
  interface does not provide any type of control messages sent to the
  device, and does not support any kind of device flow control. All that
  is required of your device is that it has at least one bulk in endpoint,
  or one bulk out endpoint.

  To enable the generic driver to recognize your device, provide::

	echo <vid> <pid> >/sys/bus/usb-serial/drivers/generic/new_id

  where the <vid> and <pid> is replaced with the hex representation of your
  device's vendor id and product id.
  If the driver is compiled as a module you can also provide one id when
  loading the module::

	insmod usbserial vendor=0x#### product=0x####

  This driver has been successfully used to connect to the NetChip USB
  development board, providing a way to develop USB firmware without
  having to write a custom driver.

  For any questions or problems with this driver, please contact Greg
  Kroah-Hartman at [email protected]

연락처

526-537

위 제품과 드라이버 사용 중 문제가 생기면 각 절에 적힌 해당 드라이버 작성자에게 연락하거나 Linux-USB mailing list에 참여합니다.

mailing list 가입 정보와 검색 가능한 archive link는 `http://www.linux-usb.org/`에 있습니다.

문서 작성자 연락처는 Greg Kroah-Hartman(`[email protected]`)입니다.

지원 경로
항목설명
Device-specific각 절에 기재된 driver author
CommunityLinux-USB mailing list
List informationhttp://www.linux-usb.org/
Document authorGreg Kroah-Hartman <[email protected]>

장치별 문의와 공통 Linux-USB 채널입니다.

Contact
=======

  If anyone has any problems using these drivers, with any of the above
  specified products, please contact the specific driver's author listed
  above, or join the Linux-USB mailing list (information on joining the
  mailing list, as well as a link to its searchable archive is at
  http://www.linux-usb.org/ )


Greg Kroah-Hartman
[email protected]