4 * Copyright (C) 1999 - 2001
5 * Greg Kroah-Hartman (greg@kroah.com)
6 * Bill Ryder (bryder@sgi.com)
8 * Kuba Ober (kuba@mareimbrium.org)
10 * This program is free software; you can redistribute it and/or modify
11 * it under the terms of the GNU General Public License as published by
12 * the Free Software Foundation; either version 2 of the License, or
13 * (at your option) any later version.
15 * See Documentation/usb/usb-serial.txt for more information on using this driver
17 * See http://ftdi-usb-sio.sourceforge.net for upto date testing info
18 * and extra documentation
20 * (21/Jul/2004) Ian Abbott
21 * Incorporated Steven Turner's code to add support for the FT2232C chip.
22 * The prelimilary port to the 2.6 kernel was by Rus V. Brushkoff. I have
23 * fixed a couple of things.
25 * (27/May/2004) Ian Abbott
26 * Improved throttling code, mostly stolen from the WhiteHEAT driver.
28 * (26/Mar/2004) Jan Capek
29 * Added PID's for ICD-U20/ICD-U40 - incircuit PIC debuggers from CCS Inc.
31 * (09/Feb/2004) Ian Abbott
32 * Changed full name of USB-UIRT device to avoid "/" character.
33 * Added FTDI's alternate PID (0x6006) for FT232/245 devices.
34 * Added PID for "ELV USB Module UO100" from Stefan Frings.
36 * (21/Oct/2003) Ian Abbott
37 * Renamed some VID/PID macros for Matrix Orbital and Perle Systems
38 * devices. Removed Matrix Orbital and Perle Systems devices from the
39 * 8U232AM device table, but left them in the FT232BM table, as they are
40 * known to use only FT232BM.
42 * (17/Oct/2003) Scott Allen
43 * Added vid/pid for Perle Systems UltraPort USB serial converters
45 * (21/Sep/2003) Ian Abbott
46 * Added VID/PID for Omnidirectional Control Technology US101 USB to
47 * RS-232 adapter (also rebadged as Dick Smith Electronics XH6381).
48 * VID/PID supplied by Donald Gordon.
50 * (19/Aug/2003) Ian Abbott
51 * Freed urb's transfer buffer in write bulk callback.
52 * Omitted some paranoid checks in write bulk callback that don't matter.
53 * Scheduled work in write bulk callback regardless of port's open count.
55 * (05/Aug/2003) Ian Abbott
56 * Added VID/PID for ID TECH IDT1221U USB to RS-232 adapter.
57 * VID/PID provided by Steve Briggs.
59 * (23/Jul/2003) Ian Abbott
60 * Added PIDs for CrystalFontz 547, 633, 631, 635, 640 and 640 from
63 * (10/Jul/2003) David Glance
64 * Added PID for DSS-20 SyncStation cradle for Sony-Ericsson P800.
66 * (27/Jun/2003) Ian Abbott
67 * Reworked the urb handling logic. We have no more pool, but dynamically
68 * allocate the urb and the transfer buffer on the fly. In testing this
69 * does not incure any measurable overhead. This also relies on the fact
70 * that we have proper reference counting logic for urbs. I nicked this
71 * from Greg KH's Visor driver.
73 * (23/Jun/2003) Ian Abbott
74 * Reduced flip buffer pushes and corrected a data length test in
75 * ftdi_read_bulk_callback.
76 * Defererence pointers after any paranoid checks, not before.
78 * (21/Jun/2003) Erik Nygren
79 * Added support for Home Electronics Tira-1 IR transceiver using FT232BM chip.
80 * See <http://www.home-electro.com/tira1.htm>. Only operates properly
81 * at 100000 and RTS-CTS, so set custom divisor mode on startup.
82 * Also force the Tira-1 and USB-UIRT to only use their custom baud rates.
84 * (18/Jun/2003) Ian Abbott
85 * Added Device ID of the USB relais from Rudolf Gugler (backported from
86 * Philipp Gühring's patch for 2.5.x kernel).
87 * Moved read transfer buffer reallocation into startup function.
88 * Free existing write urb and transfer buffer in startup function.
89 * Only use urbs in write urb pool that were successfully allocated.
90 * Moved some constant macros out of functions.
91 * Minor whitespace and comment changes.
93 * (12/Jun/2003) David Norwood
94 * Added support for USB-UIRT IR transceiver using 8U232AM chip.
95 * See <http://home.earthlink.net/~jrhees/USBUIRT/index.htm>. Only
96 * operates properly at 312500, so set custom divisor mode on startup.
98 * (12/Jun/2003) Ian Abbott
99 * Added Sealevel SeaLINK+ 210x, 220x, 240x, 280x vid/pids from Tuan Hoang
100 * - I've eliminated some that don't seem to exist!
101 * Added Home Electronics Tira-1 IR transceiver pid from Chris Horn
102 * Some whitespace/coding-style cleanups
104 * (11/Jun/2003) Ian Abbott
105 * Fixed unsafe spinlock usage in ftdi_write
107 * (24/Feb/2003) Richard Shooter
108 * Increase read buffer size to improve read speeds at higher baud rates
109 * (specifically tested with up to 1Mb/sec at 1.5M baud)
111 * (23/Feb/2003) John Wilkins
112 * Added Xon/xoff flow control (activating support in the ftdi device)
113 * Added vid/pid for Videonetworks/Homechoice (UK ISP)
115 * (23/Feb/2003) Bill Ryder
116 * Added matrix orb device vid/pids from Wayne Wylupski
118 * (19/Feb/2003) Ian Abbott
119 * For TIOCSSERIAL, set alt_speed to 0 when ASYNC_SPD_MASK value has
120 * changed to something other than ASYNC_SPD_HI, ASYNC_SPD_VHI,
121 * ASYNC_SPD_SHI or ASYNC_SPD_WARP. Also, unless ASYNC_SPD_CUST is in
122 * force, don't bother changing baud rate when custom_divisor has changed.
124 * (18/Feb/2003) Ian Abbott
125 * Fixed TIOCMGET handling to include state of DTR and RTS, the state
126 * of which are now saved by set_dtr() and set_rts().
127 * Fixed improper storage class for buf in set_dtr() and set_rts().
128 * Added FT232BM chip type and support for its extra baud rates (compared
130 * Took account of special case divisor values for highest baud rates of
131 * FT8U232AM and FT232BM.
132 * For TIOCSSERIAL, forced alt_speed to 0 when ASYNC_SPD_CUST kludge used,
133 * as previous alt_speed setting is now stale.
134 * Moved startup code common between the startup routines for the
135 * different chip types into a common subroutine.
137 * (17/Feb/2003) Bill Ryder
138 * Added write urb buffer pool on a per device basis
139 * Added more checking for open file on callbacks (fixed OOPS)
140 * Added CrystalFontz 632 and 634 PIDs
141 * (thanx to CrystalFontz for the sample devices - they flushed out
143 * Minor debugging message changes
144 * Added throttle, unthrottle and chars_in_buffer functions
145 * Fixed FTDI_SIO (the original device) bug
146 * Fixed some shutdown handling
151 * (07/Jun/2002) Kuba Ober
152 * Changed FTDI_SIO_BASE_BAUD_TO_DIVISOR macro into ftdi_baud_to_divisor
153 * function. It was getting too complex.
154 * Fix the divisor calculation logic which was setting divisor of 0.125
155 * instead of 0.5 for fractional parts of divisor equal to 5/8, 6/8, 7/8.
156 * Also make it bump up the divisor to next integer in case of 7/8 - it's
157 * a better approximation.
159 * (25/Jul/2002) Bill Ryder inserted Dmitri's TIOCMIWAIT patch
160 * Not tested by me but it doesn't break anything I use.
162 * (04/Jan/2002) Kuba Ober
163 * Implemented 38400 baudrate kludge, where it can be substituted with other
164 * values. That's the only way to set custom baudrates.
165 * Implemented TIOCSSERIAL, TIOCGSERIAL ioctl's so that setserial is happy.
166 * FIXME: both baudrate things should eventually go to usbserial.c as other
167 * devices may need that functionality too. Actually, it can probably be
168 * merged in serial.c somehow - too many drivers repeat this code over
170 * Fixed baudrate forgetfulness - open() used to reset baudrate to 9600 every time.
171 * Divisors for baudrates are calculated by a macro.
172 * Small code cleanups. Ugly whitespace changes for Plato's sake only ;-].
174 * (04/Nov/2001) Bill Ryder
175 * Fixed bug in read_bulk_callback where incorrect urb buffer was used.
176 * Cleaned up write offset calculation
177 * Added write_room since default values can be incorrect for sio
178 * Changed write_bulk_callback to use same queue_task as other drivers
179 * (the previous version caused panics)
180 * Removed port iteration code since the device only has one I/O port and it
184 * Switched from using spinlock to a semaphore, which fixes lots of problems.
186 * (23/May/2001) Bill Ryder
187 * Added runtime debug patch (thanx Tyson D Sawyer).
188 * Cleaned up comments for 8U232
189 * Added parity, framing and overrun error handling
190 * Added receive break handling.
193 * Identify version on module load.
195 * (18/March/2001) Bill Ryder
197 * Added send break handling. (requires kernel patch too)
198 * Fixed 8U232AM hardware RTS/CTS etc status reporting.
199 * Added flipbuf fix copied from generic device
201 * (12/3/2000) Bill Ryder
202 * Added support for 8U232AM device.
203 * Moved PID and VIDs into header file only.
204 * Turned on low-latency for the tty (device will do high baudrates)
205 * Added shutdown routine to close files when device removed.
206 * More debug and error message cleanups.
208 * (11/13/2000) Bill Ryder
209 * Added spinlock protected open code and close code.
210 * Multiple opens work (sort of - see webpage mentioned above).
211 * Cleaned up comments. Removed multiple PID/VID definitions.
212 * Factorised cts/dtr code
213 * Made use of __FUNCTION__ in dbg's
215 * (11/01/2000) Adam J. Richter
216 * usb_device_id table support
219 * Fixed bug with urb->dev not being set properly, now that the usb
223 * Removed DEBUG #ifdefs with call to usb_serial_debug_data
226 * Added module_init and module_exit functions to handle the fact that this
227 * driver is a loadable module now.
229 * (04/04/2000) Bill Ryder
230 * Fixed bugs in TCGET/TCSET ioctls (by removing them - they are
231 * handled elsewhere in the tty io driver chain).
233 * (03/30/2000) Bill Ryder
234 * Implemented lots of ioctls
235 * Fixed a race condition in write
236 * Changed some dbg's to errs
239 * Split driver up into device specific pieces.
243 /* Bill Ryder - bryder@sgi.com - wrote the FTDI_SIO implementation */
244 /* Thanx to FTDI for so kindly providing details of the protocol required */
245 /* to talk to the device */
246 /* Thanx to gkh and the rest of the usb dev group for all code I have assimilated :-) */
248 #include <linux/kernel.h>
249 #include <linux/errno.h>
250 #include <linux/init.h>
251 #include <linux/slab.h>
252 #include <linux/tty.h>
253 #include <linux/tty_driver.h>
254 #include <linux/tty_flip.h>
255 #include <linux/module.h>
256 #include <linux/spinlock.h>
257 #include <asm/uaccess.h>
258 #include <linux/usb.h>
259 #include <linux/serial.h>
260 #include <linux/usb/serial.h>
261 #include "ftdi_sio.h"
264 * Version Information
266 #define DRIVER_VERSION "v1.4.3"
267 #define DRIVER_AUTHOR "Greg Kroah-Hartman <greg@kroah.com>, Bill Ryder <bryder@sgi.com>, Kuba Ober <kuba@mareimbrium.org>"
268 #define DRIVER_DESC "USB FTDI Serial Converters Driver"
271 static __u16 vendor
= FTDI_VID
;
272 static __u16 product
;
274 /* struct ftdi_sio_quirk is used by devices requiring special attention. */
275 struct ftdi_sio_quirk
{
276 void (*setup
)(struct usb_serial
*); /* Special settings during startup. */
279 static void ftdi_USB_UIRT_setup (struct usb_serial
*serial
);
280 static void ftdi_HE_TIRA1_setup (struct usb_serial
*serial
);
282 static struct ftdi_sio_quirk ftdi_USB_UIRT_quirk
= {
283 .setup
= ftdi_USB_UIRT_setup
,
286 static struct ftdi_sio_quirk ftdi_HE_TIRA1_quirk
= {
287 .setup
= ftdi_HE_TIRA1_setup
,
291 * The 8U232AM has the same API as the sio except for:
292 * - it can support MUCH higher baudrates; up to:
293 * o 921600 for RS232 and 2000000 for RS422/485 at 48MHz
295 * so .. 8U232AM's baudrate setting codes are different
296 * - it has a two byte status code.
297 * - it returns characters every 16ms (the FTDI does it every 40ms)
299 * the bcdDevice value is used to differentiate FT232BM and FT245BM from
300 * the earlier FT8U232AM and FT8U232BM. For now, include all known VID/PID
301 * combinations in both tables.
302 * FIXME: perhaps bcdDevice can also identify 12MHz FT8U232AM devices,
303 * but I don't know if those ever went into mass production. [Ian Abbott]
308 static struct usb_device_id id_table_combined
[] = {
309 { USB_DEVICE(FTDI_VID
, FTDI_AMC232_PID
) },
310 { USB_DEVICE(FTDI_VID
, FTDI_CANUSB_PID
) },
311 { USB_DEVICE(FTDI_VID
, FTDI_ACTZWAVE_PID
) },
312 { USB_DEVICE(FTDI_VID
, FTDI_IRTRANS_PID
) },
313 { USB_DEVICE(FTDI_VID
, FTDI_IPLUS_PID
) },
314 { USB_DEVICE(FTDI_VID
, FTDI_DMX4ALL
) },
315 { USB_DEVICE(FTDI_VID
, FTDI_SIO_PID
) },
316 { USB_DEVICE(FTDI_VID
, FTDI_8U232AM_PID
) },
317 { USB_DEVICE(FTDI_VID
, FTDI_8U232AM_ALT_PID
) },
318 { USB_DEVICE(FTDI_VID
, FTDI_8U2232C_PID
) },
319 { USB_DEVICE(FTDI_VID
, FTDI_MICRO_CHAMELEON_PID
) },
320 { USB_DEVICE(FTDI_VID
, FTDI_RELAIS_PID
) },
321 { USB_DEVICE(INTERBIOMETRICS_VID
, INTERBIOMETRICS_IOBOARD_PID
) },
322 { USB_DEVICE(INTERBIOMETRICS_VID
, INTERBIOMETRICS_MINI_IOBOARD_PID
) },
323 { USB_DEVICE(FTDI_VID
, FTDI_XF_632_PID
) },
324 { USB_DEVICE(FTDI_VID
, FTDI_XF_634_PID
) },
325 { USB_DEVICE(FTDI_VID
, FTDI_XF_547_PID
) },
326 { USB_DEVICE(FTDI_VID
, FTDI_XF_633_PID
) },
327 { USB_DEVICE(FTDI_VID
, FTDI_XF_631_PID
) },
328 { USB_DEVICE(FTDI_VID
, FTDI_XF_635_PID
) },
329 { USB_DEVICE(FTDI_VID
, FTDI_XF_640_PID
) },
330 { USB_DEVICE(FTDI_VID
, FTDI_XF_642_PID
) },
331 { USB_DEVICE(FTDI_VID
, FTDI_DSS20_PID
) },
332 { USB_DEVICE(FTDI_NF_RIC_VID
, FTDI_NF_RIC_PID
) },
333 { USB_DEVICE(FTDI_VID
, FTDI_VNHCPCUSB_D_PID
) },
334 { USB_DEVICE(FTDI_VID
, FTDI_MTXORB_0_PID
) },
335 { USB_DEVICE(FTDI_VID
, FTDI_MTXORB_1_PID
) },
336 { USB_DEVICE(FTDI_VID
, FTDI_MTXORB_2_PID
) },
337 { USB_DEVICE(FTDI_VID
, FTDI_MTXORB_3_PID
) },
338 { USB_DEVICE(FTDI_VID
, FTDI_MTXORB_4_PID
) },
339 { USB_DEVICE(FTDI_VID
, FTDI_MTXORB_5_PID
) },
340 { USB_DEVICE(FTDI_VID
, FTDI_MTXORB_6_PID
) },
341 { USB_DEVICE(FTDI_VID
, FTDI_PERLE_ULTRAPORT_PID
) },
342 { USB_DEVICE(FTDI_VID
, FTDI_PIEGROUP_PID
) },
343 { USB_DEVICE(FTDI_VID
, FTDI_TNC_X_PID
) },
344 { USB_DEVICE(SEALEVEL_VID
, SEALEVEL_2101_PID
) },
345 { USB_DEVICE(SEALEVEL_VID
, SEALEVEL_2102_PID
) },
346 { USB_DEVICE(SEALEVEL_VID
, SEALEVEL_2103_PID
) },
347 { USB_DEVICE(SEALEVEL_VID
, SEALEVEL_2104_PID
) },
348 { USB_DEVICE(SEALEVEL_VID
, SEALEVEL_2106_PID
) },
349 { USB_DEVICE(SEALEVEL_VID
, SEALEVEL_2201_1_PID
) },
350 { USB_DEVICE(SEALEVEL_VID
, SEALEVEL_2201_2_PID
) },
351 { USB_DEVICE(SEALEVEL_VID
, SEALEVEL_2202_1_PID
) },
352 { USB_DEVICE(SEALEVEL_VID
, SEALEVEL_2202_2_PID
) },
353 { USB_DEVICE(SEALEVEL_VID
, SEALEVEL_2203_1_PID
) },
354 { USB_DEVICE(SEALEVEL_VID
, SEALEVEL_2203_2_PID
) },
355 { USB_DEVICE(SEALEVEL_VID
, SEALEVEL_2401_1_PID
) },
356 { USB_DEVICE(SEALEVEL_VID
, SEALEVEL_2401_2_PID
) },
357 { USB_DEVICE(SEALEVEL_VID
, SEALEVEL_2401_3_PID
) },
358 { USB_DEVICE(SEALEVEL_VID
, SEALEVEL_2401_4_PID
) },
359 { USB_DEVICE(SEALEVEL_VID
, SEALEVEL_2402_1_PID
) },
360 { USB_DEVICE(SEALEVEL_VID
, SEALEVEL_2402_2_PID
) },
361 { USB_DEVICE(SEALEVEL_VID
, SEALEVEL_2402_3_PID
) },
362 { USB_DEVICE(SEALEVEL_VID
, SEALEVEL_2402_4_PID
) },
363 { USB_DEVICE(SEALEVEL_VID
, SEALEVEL_2403_1_PID
) },
364 { USB_DEVICE(SEALEVEL_VID
, SEALEVEL_2403_2_PID
) },
365 { USB_DEVICE(SEALEVEL_VID
, SEALEVEL_2403_3_PID
) },
366 { USB_DEVICE(SEALEVEL_VID
, SEALEVEL_2403_4_PID
) },
367 { USB_DEVICE(SEALEVEL_VID
, SEALEVEL_2801_1_PID
) },
368 { USB_DEVICE(SEALEVEL_VID
, SEALEVEL_2801_2_PID
) },
369 { USB_DEVICE(SEALEVEL_VID
, SEALEVEL_2801_3_PID
) },
370 { USB_DEVICE(SEALEVEL_VID
, SEALEVEL_2801_4_PID
) },
371 { USB_DEVICE(SEALEVEL_VID
, SEALEVEL_2801_5_PID
) },
372 { USB_DEVICE(SEALEVEL_VID
, SEALEVEL_2801_6_PID
) },
373 { USB_DEVICE(SEALEVEL_VID
, SEALEVEL_2801_7_PID
) },
374 { USB_DEVICE(SEALEVEL_VID
, SEALEVEL_2801_8_PID
) },
375 { USB_DEVICE(SEALEVEL_VID
, SEALEVEL_2802_1_PID
) },
376 { USB_DEVICE(SEALEVEL_VID
, SEALEVEL_2802_2_PID
) },
377 { USB_DEVICE(SEALEVEL_VID
, SEALEVEL_2802_3_PID
) },
378 { USB_DEVICE(SEALEVEL_VID
, SEALEVEL_2802_4_PID
) },
379 { USB_DEVICE(SEALEVEL_VID
, SEALEVEL_2802_5_PID
) },
380 { USB_DEVICE(SEALEVEL_VID
, SEALEVEL_2802_6_PID
) },
381 { USB_DEVICE(SEALEVEL_VID
, SEALEVEL_2802_7_PID
) },
382 { USB_DEVICE(SEALEVEL_VID
, SEALEVEL_2802_8_PID
) },
383 { USB_DEVICE(SEALEVEL_VID
, SEALEVEL_2803_1_PID
) },
384 { USB_DEVICE(SEALEVEL_VID
, SEALEVEL_2803_2_PID
) },
385 { USB_DEVICE(SEALEVEL_VID
, SEALEVEL_2803_3_PID
) },
386 { USB_DEVICE(SEALEVEL_VID
, SEALEVEL_2803_4_PID
) },
387 { USB_DEVICE(SEALEVEL_VID
, SEALEVEL_2803_5_PID
) },
388 { USB_DEVICE(SEALEVEL_VID
, SEALEVEL_2803_6_PID
) },
389 { USB_DEVICE(SEALEVEL_VID
, SEALEVEL_2803_7_PID
) },
390 { USB_DEVICE(SEALEVEL_VID
, SEALEVEL_2803_8_PID
) },
391 { USB_DEVICE(IDTECH_VID
, IDTECH_IDT1221U_PID
) },
392 { USB_DEVICE(OCT_VID
, OCT_US101_PID
) },
393 { USB_DEVICE(FTDI_VID
, FTDI_HE_TIRA1_PID
),
394 .driver_info
= (kernel_ulong_t
)&ftdi_HE_TIRA1_quirk
},
395 { USB_DEVICE(FTDI_VID
, FTDI_USB_UIRT_PID
),
396 .driver_info
= (kernel_ulong_t
)&ftdi_USB_UIRT_quirk
},
397 { USB_DEVICE(FTDI_VID
, PROTEGO_SPECIAL_1
) },
398 { USB_DEVICE(FTDI_VID
, PROTEGO_R2X0
) },
399 { USB_DEVICE(FTDI_VID
, PROTEGO_SPECIAL_3
) },
400 { USB_DEVICE(FTDI_VID
, PROTEGO_SPECIAL_4
) },
401 { USB_DEVICE(FTDI_VID
, FTDI_GUDEADS_E808_PID
) },
402 { USB_DEVICE(FTDI_VID
, FTDI_GUDEADS_E809_PID
) },
403 { USB_DEVICE(FTDI_VID
, FTDI_GUDEADS_E80A_PID
) },
404 { USB_DEVICE(FTDI_VID
, FTDI_GUDEADS_E80B_PID
) },
405 { USB_DEVICE(FTDI_VID
, FTDI_GUDEADS_E80C_PID
) },
406 { USB_DEVICE(FTDI_VID
, FTDI_GUDEADS_E80D_PID
) },
407 { USB_DEVICE(FTDI_VID
, FTDI_GUDEADS_E80E_PID
) },
408 { USB_DEVICE(FTDI_VID
, FTDI_GUDEADS_E80F_PID
) },
409 { USB_DEVICE(FTDI_VID
, FTDI_GUDEADS_E888_PID
) },
410 { USB_DEVICE(FTDI_VID
, FTDI_GUDEADS_E889_PID
) },
411 { USB_DEVICE(FTDI_VID
, FTDI_GUDEADS_E88A_PID
) },
412 { USB_DEVICE(FTDI_VID
, FTDI_GUDEADS_E88B_PID
) },
413 { USB_DEVICE(FTDI_VID
, FTDI_GUDEADS_E88C_PID
) },
414 { USB_DEVICE(FTDI_VID
, FTDI_GUDEADS_E88D_PID
) },
415 { USB_DEVICE(FTDI_VID
, FTDI_GUDEADS_E88E_PID
) },
416 { USB_DEVICE(FTDI_VID
, FTDI_GUDEADS_E88F_PID
) },
417 { USB_DEVICE(FTDI_VID
, FTDI_ELV_UO100_PID
) },
418 { USB_DEVICE(FTDI_VID
, FTDI_ELV_UM100_PID
) },
419 { USB_DEVICE(FTDI_VID
, FTDI_ELV_UR100_PID
) },
420 { USB_DEVICE(FTDI_VID
, FTDI_ELV_ALC8500_PID
) },
421 { USB_DEVICE(FTDI_VID
, FTDI_PYRAMID_PID
) },
422 { USB_DEVICE(FTDI_VID
, FTDI_ELV_FHZ1000PC_PID
) },
424 * These will probably use user-space drivers. Uncomment them if
425 * you need them or use the user-specified vendor/product module
426 * parameters (see ftdi_sio.h for the numbers). Make a fuss if
427 * you think the driver should recognize any of them by default.
429 /* { USB_DEVICE(FTDI_VID, FTDI_ELV_CLI7000_PID) }, */
430 /* { USB_DEVICE(FTDI_VID, FTDI_ELV_PPS7330_PID) }, */
431 /* { USB_DEVICE(FTDI_VID, FTDI_ELV_TFM100_PID) }, */
432 /* { USB_DEVICE(FTDI_VID, FTDI_ELV_UDF77_PID) }, */
433 /* { USB_DEVICE(FTDI_VID, FTDI_ELV_UIO88_PID) }, */
434 /* { USB_DEVICE(FTDI_VID, FTDI_ELV_UAD8_PID) }, */
435 /* { USB_DEVICE(FTDI_VID, FTDI_ELV_UDA7_PID) }, */
436 /* { USB_DEVICE(FTDI_VID, FTDI_ELV_USI2_PID) }, */
437 /* { USB_DEVICE(FTDI_VID, FTDI_ELV_T1100_PID) }, */
438 /* { USB_DEVICE(FTDI_VID, FTDI_ELV_PCD200_PID) }, */
439 /* { USB_DEVICE(FTDI_VID, FTDI_ELV_ULA200_PID) }, */
440 /* { USB_DEVICE(FTDI_VID, FTDI_ELV_CSI8_PID) }, */
441 /* { USB_DEVICE(FTDI_VID, FTDI_ELV_EM1000DL_PID) }, */
442 /* { USB_DEVICE(FTDI_VID, FTDI_ELV_PCK100_PID) }, */
443 /* { USB_DEVICE(FTDI_VID, FTDI_ELV_RFP500_PID) }, */
444 /* { USB_DEVICE(FTDI_VID, FTDI_ELV_FS20SIG_PID) }, */
445 /* { USB_DEVICE(FTDI_VID, FTDI_ELV_WS300PC_PID) }, */
446 /* { USB_DEVICE(FTDI_VID, FTDI_ELV_FHZ1300PC_PID) }, */
447 /* { USB_DEVICE(FTDI_VID, FTDI_ELV_WS500_PID) }, */
448 { USB_DEVICE(FTDI_VID
, LINX_SDMUSBQSS_PID
) },
449 { USB_DEVICE(FTDI_VID
, LINX_MASTERDEVEL2_PID
) },
450 { USB_DEVICE(FTDI_VID
, LINX_FUTURE_0_PID
) },
451 { USB_DEVICE(FTDI_VID
, LINX_FUTURE_1_PID
) },
452 { USB_DEVICE(FTDI_VID
, LINX_FUTURE_2_PID
) },
453 { USB_DEVICE(FTDI_VID
, FTDI_CCSICDU20_0_PID
) },
454 { USB_DEVICE(FTDI_VID
, FTDI_CCSICDU40_1_PID
) },
455 { USB_DEVICE(FTDI_VID
, INSIDE_ACCESSO
) },
456 { USB_DEVICE(INTREPID_VID
, INTREPID_VALUECAN_PID
) },
457 { USB_DEVICE(INTREPID_VID
, INTREPID_NEOVI_PID
) },
458 { USB_DEVICE(FALCOM_VID
, FALCOM_TWIST_PID
) },
459 { USB_DEVICE(FALCOM_VID
, FALCOM_SAMBA_PID
) },
460 { USB_DEVICE(FTDI_VID
, FTDI_SUUNTO_SPORTS_PID
) },
461 { USB_DEVICE(FTDI_VID
, FTDI_RM_CANVIEW_PID
) },
462 { USB_DEVICE(BANDB_VID
, BANDB_USOTL4_PID
) },
463 { USB_DEVICE(BANDB_VID
, BANDB_USTL4_PID
) },
464 { USB_DEVICE(BANDB_VID
, BANDB_USO9ML2_PID
) },
465 { USB_DEVICE(FTDI_VID
, EVER_ECO_PRO_CDS
) },
466 { USB_DEVICE(FTDI_VID
, FTDI_4N_GALAXY_DE_0_PID
) },
467 { USB_DEVICE(FTDI_VID
, FTDI_4N_GALAXY_DE_1_PID
) },
468 { USB_DEVICE(FTDI_VID
, FTDI_4N_GALAXY_DE_2_PID
) },
469 { USB_DEVICE(FTDI_VID
, XSENS_CONVERTER_0_PID
) },
470 { USB_DEVICE(FTDI_VID
, XSENS_CONVERTER_1_PID
) },
471 { USB_DEVICE(FTDI_VID
, XSENS_CONVERTER_2_PID
) },
472 { USB_DEVICE(FTDI_VID
, XSENS_CONVERTER_3_PID
) },
473 { USB_DEVICE(FTDI_VID
, XSENS_CONVERTER_4_PID
) },
474 { USB_DEVICE(FTDI_VID
, XSENS_CONVERTER_5_PID
) },
475 { USB_DEVICE(FTDI_VID
, XSENS_CONVERTER_6_PID
) },
476 { USB_DEVICE(FTDI_VID
, XSENS_CONVERTER_7_PID
) },
477 { USB_DEVICE(MOBILITY_VID
, MOBILITY_USB_SERIAL_PID
) },
478 { USB_DEVICE(FTDI_VID
, FTDI_ACTIVE_ROBOTS_PID
) },
479 { USB_DEVICE(FTDI_VID
, FTDI_MHAM_KW_PID
) },
480 { USB_DEVICE(FTDI_VID
, FTDI_MHAM_YS_PID
) },
481 { USB_DEVICE(FTDI_VID
, FTDI_MHAM_Y6_PID
) },
482 { USB_DEVICE(FTDI_VID
, FTDI_MHAM_Y8_PID
) },
483 { USB_DEVICE(FTDI_VID
, FTDI_MHAM_IC_PID
) },
484 { USB_DEVICE(FTDI_VID
, FTDI_MHAM_DB9_PID
) },
485 { USB_DEVICE(FTDI_VID
, FTDI_MHAM_RS232_PID
) },
486 { USB_DEVICE(FTDI_VID
, FTDI_MHAM_Y9_PID
) },
487 { USB_DEVICE(FTDI_VID
, FTDI_TERATRONIK_VCP_PID
) },
488 { USB_DEVICE(FTDI_VID
, FTDI_TERATRONIK_D2XX_PID
) },
489 { USB_DEVICE(EVOLUTION_VID
, EVOLUTION_ER1_PID
) },
490 { USB_DEVICE(FTDI_VID
, FTDI_ARTEMIS_PID
) },
491 { USB_DEVICE(FTDI_VID
, FTDI_ATIK_ATK16_PID
) },
492 { USB_DEVICE(FTDI_VID
, FTDI_ATIK_ATK16C_PID
) },
493 { USB_DEVICE(FTDI_VID
, FTDI_ATIK_ATK16HR_PID
) },
494 { USB_DEVICE(FTDI_VID
, FTDI_ATIK_ATK16HRC_PID
) },
495 { USB_DEVICE(KOBIL_VID
, KOBIL_CONV_B1_PID
) },
496 { USB_DEVICE(KOBIL_VID
, KOBIL_CONV_KAAN_PID
) },
497 { USB_DEVICE(POSIFLEX_VID
, POSIFLEX_PP7000_PID
) },
498 { USB_DEVICE(FTDI_VID
, FTDI_TTUSB_PID
) },
499 { USB_DEVICE(FTDI_VID
, FTDI_ECLO_COM_1WIRE_PID
) },
500 { USB_DEVICE(FTDI_VID
, FTDI_WESTREX_MODEL_777_PID
) },
501 { USB_DEVICE(FTDI_VID
, FTDI_WESTREX_MODEL_8900F_PID
) },
502 { USB_DEVICE(FTDI_VID
, FTDI_PCDJ_DAC2_PID
) },
503 { USB_DEVICE(FTDI_VID
, FTDI_RRCIRKITS_LOCOBUFFER_PID
) },
504 { USB_DEVICE(FTDI_VID
, FTDI_ASK_RDR400_PID
) },
505 { USB_DEVICE(ICOM_ID1_VID
, ICOM_ID1_PID
) },
506 { USB_DEVICE(PAPOUCH_VID
, PAPOUCH_TMU_PID
) },
507 { USB_DEVICE(FTDI_VID
, FTDI_ACG_HFDUAL_PID
) },
508 { USB_DEVICE(FTDI_VID
, FTDI_YEI_SERVOCENTER31_PID
) },
509 { USB_DEVICE(FTDI_VID
, FTDI_THORLABS_PID
) },
510 { USB_DEVICE(TESTO_VID
, TESTO_USB_INTERFACE_PID
) },
511 { USB_DEVICE(FTDI_VID
, FTDI_GAMMA_SCOUT_PID
) },
512 { USB_DEVICE(FTDI_VID
, FTDI_TACTRIX_OPENPORT_13M_PID
) },
513 { USB_DEVICE(FTDI_VID
, FTDI_TACTRIX_OPENPORT_13S_PID
) },
514 { USB_DEVICE(FTDI_VID
, FTDI_TACTRIX_OPENPORT_13U_PID
) },
515 { USB_DEVICE(ELEKTOR_VID
, ELEKTOR_FT323R_PID
) },
516 { }, /* Optional parameter entry */
517 { } /* Terminating entry */
520 MODULE_DEVICE_TABLE (usb
, id_table_combined
);
522 static struct usb_driver ftdi_driver
= {
524 .probe
= usb_serial_probe
,
525 .disconnect
= usb_serial_disconnect
,
526 .id_table
= id_table_combined
,
530 static const char *ftdi_chip_name
[] = {
531 [SIO
] = "SIO", /* the serial part of FT8U100AX */
532 [FT8U232AM
] = "FT8U232AM",
533 [FT232BM
] = "FT232BM",
534 [FT2232C
] = "FT2232C",
538 /* Constants for read urb and write urb */
543 #define THROTTLED 0x01
544 #define ACTUALLY_THROTTLED 0x02
546 struct ftdi_private
{
547 ftdi_chip_type_t chip_type
;
548 /* type of the device, either SIO or FT8U232AM */
549 int baud_base
; /* baud base clock for divisor setting */
550 int custom_divisor
; /* custom_divisor kludge, this is for baud_base (different from what goes to the chip!) */
551 __u16 last_set_data_urb_value
;
552 /* the last data state set - needed for doing a break */
553 int write_offset
; /* This is the offset in the usb data block to write the serial data -
554 * it is different between devices
556 int flags
; /* some ASYNC_xxxx flags are supported */
557 unsigned long last_dtr_rts
; /* saved modem control outputs */
558 wait_queue_head_t delta_msr_wait
; /* Used for TIOCMIWAIT */
559 char prev_status
, diff_status
; /* Used for TIOCMIWAIT */
560 __u8 rx_flags
; /* receive state flags (throttling) */
561 spinlock_t rx_lock
; /* spinlock for receive state */
562 struct delayed_work rx_work
;
563 struct usb_serial_port
*port
;
565 unsigned long rx_bytes
;
567 __u16 interface
; /* FT2232C port interface (0 for FT232/245) */
569 int force_baud
; /* if non-zero, force the baud rate to this value */
570 int force_rtscts
; /* if non-zero, force RTS-CTS to always be enabled */
572 spinlock_t tx_lock
; /* spinlock for transmit state */
573 unsigned long tx_bytes
;
574 unsigned long tx_outstanding_bytes
;
575 unsigned long tx_outstanding_urbs
;
578 /* Used for TIOCMIWAIT */
579 #define FTDI_STATUS_B0_MASK (FTDI_RS0_CTS | FTDI_RS0_DSR | FTDI_RS0_RI | FTDI_RS0_RLSD)
580 #define FTDI_STATUS_B1_MASK (FTDI_RS_BI)
583 #define FTDI_IMPL_ASYNC_FLAGS = ( ASYNC_SPD_HI | ASYNC_SPD_VHI \
584 ASYNC_SPD_CUST | ASYNC_SPD_SHI | ASYNC_SPD_WARP )
586 /* function prototypes for a FTDI serial converter */
587 static int ftdi_sio_probe (struct usb_serial
*serial
, const struct usb_device_id
*id
);
588 static int ftdi_sio_attach (struct usb_serial
*serial
);
589 static void ftdi_shutdown (struct usb_serial
*serial
);
590 static int ftdi_open (struct usb_serial_port
*port
, struct file
*filp
);
591 static void ftdi_close (struct usb_serial_port
*port
, struct file
*filp
);
592 static int ftdi_write (struct usb_serial_port
*port
, const unsigned char *buf
, int count
);
593 static int ftdi_write_room (struct usb_serial_port
*port
);
594 static int ftdi_chars_in_buffer (struct usb_serial_port
*port
);
595 static void ftdi_write_bulk_callback (struct urb
*urb
);
596 static void ftdi_read_bulk_callback (struct urb
*urb
);
597 static void ftdi_process_read (struct work_struct
*work
);
598 static void ftdi_set_termios (struct usb_serial_port
*port
, struct termios
* old
);
599 static int ftdi_tiocmget (struct usb_serial_port
*port
, struct file
*file
);
600 static int ftdi_tiocmset (struct usb_serial_port
*port
, struct file
* file
, unsigned int set
, unsigned int clear
);
601 static int ftdi_ioctl (struct usb_serial_port
*port
, struct file
* file
, unsigned int cmd
, unsigned long arg
);
602 static void ftdi_break_ctl (struct usb_serial_port
*port
, int break_state
);
603 static void ftdi_throttle (struct usb_serial_port
*port
);
604 static void ftdi_unthrottle (struct usb_serial_port
*port
);
606 static unsigned short int ftdi_232am_baud_base_to_divisor (int baud
, int base
);
607 static unsigned short int ftdi_232am_baud_to_divisor (int baud
);
608 static __u32
ftdi_232bm_baud_base_to_divisor (int baud
, int base
);
609 static __u32
ftdi_232bm_baud_to_divisor (int baud
);
611 static struct usb_serial_driver ftdi_sio_device
= {
613 .owner
= THIS_MODULE
,
616 .description
= "FTDI USB Serial Device",
617 .id_table
= id_table_combined
,
618 .num_interrupt_in
= 0,
622 .probe
= ftdi_sio_probe
,
625 .throttle
= ftdi_throttle
,
626 .unthrottle
= ftdi_unthrottle
,
628 .write_room
= ftdi_write_room
,
629 .chars_in_buffer
= ftdi_chars_in_buffer
,
630 .read_bulk_callback
= ftdi_read_bulk_callback
,
631 .write_bulk_callback
= ftdi_write_bulk_callback
,
632 .tiocmget
= ftdi_tiocmget
,
633 .tiocmset
= ftdi_tiocmset
,
635 .set_termios
= ftdi_set_termios
,
636 .break_ctl
= ftdi_break_ctl
,
637 .attach
= ftdi_sio_attach
,
638 .shutdown
= ftdi_shutdown
,
642 #define WDR_TIMEOUT 5000 /* default urb timeout */
643 #define WDR_SHORT_TIMEOUT 1000 /* shorter urb timeout */
645 /* High and low are for DTR, RTS etc etc */
649 /* number of outstanding urbs to prevent userspace DoS from happening */
650 #define URB_UPPER_LIMIT 42
653 * ***************************************************************************
655 * ***************************************************************************
658 static unsigned short int ftdi_232am_baud_base_to_divisor(int baud
, int base
)
660 unsigned short int divisor
;
661 int divisor3
= base
/ 2 / baud
; // divisor shifted 3 bits to the left
662 if ((divisor3
& 0x7) == 7) divisor3
++; // round x.7/8 up to x+1
663 divisor
= divisor3
>> 3;
665 if (divisor3
== 1) divisor
|= 0xc000; else // 0.125
666 if (divisor3
>= 4) divisor
|= 0x4000; else // 0.5
667 if (divisor3
!= 0) divisor
|= 0x8000; // 0.25
668 if (divisor
== 1) divisor
= 0; /* special case for maximum baud rate */
672 static unsigned short int ftdi_232am_baud_to_divisor(int baud
)
674 return(ftdi_232am_baud_base_to_divisor(baud
, 48000000));
677 static __u32
ftdi_232bm_baud_base_to_divisor(int baud
, int base
)
679 static const unsigned char divfrac
[8] = { 0, 3, 2, 4, 1, 5, 6, 7 };
681 int divisor3
= base
/ 2 / baud
; // divisor shifted 3 bits to the left
682 divisor
= divisor3
>> 3;
683 divisor
|= (__u32
)divfrac
[divisor3
& 0x7] << 14;
684 /* Deal with special cases for highest baud rates. */
685 if (divisor
== 1) divisor
= 0; else // 1.0
686 if (divisor
== 0x4001) divisor
= 1; // 1.5
690 static __u32
ftdi_232bm_baud_to_divisor(int baud
)
692 return(ftdi_232bm_baud_base_to_divisor(baud
, 48000000));
695 #define set_mctrl(port, set) update_mctrl((port), (set), 0)
696 #define clear_mctrl(port, clear) update_mctrl((port), 0, (clear))
698 static int update_mctrl(struct usb_serial_port
*port
, unsigned int set
, unsigned int clear
)
700 struct ftdi_private
*priv
= usb_get_serial_port_data(port
);
705 if (((set
| clear
) & (TIOCM_DTR
| TIOCM_RTS
)) == 0) {
706 dbg("%s - DTR|RTS not being set|cleared", __FUNCTION__
);
707 return 0; /* no change */
710 buf
= kmalloc(1, GFP_NOIO
);
715 clear
&= ~set
; /* 'set' takes precedence over 'clear' */
717 if (clear
& TIOCM_DTR
)
718 urb_value
|= FTDI_SIO_SET_DTR_LOW
;
719 if (clear
& TIOCM_RTS
)
720 urb_value
|= FTDI_SIO_SET_RTS_LOW
;
722 urb_value
|= FTDI_SIO_SET_DTR_HIGH
;
724 urb_value
|= FTDI_SIO_SET_RTS_HIGH
;
725 rv
= usb_control_msg(port
->serial
->dev
,
726 usb_sndctrlpipe(port
->serial
->dev
, 0),
727 FTDI_SIO_SET_MODEM_CTRL_REQUEST
,
728 FTDI_SIO_SET_MODEM_CTRL_REQUEST_TYPE
,
729 urb_value
, priv
->interface
,
730 buf
, 0, WDR_TIMEOUT
);
734 err("%s Error from MODEM_CTRL urb: DTR %s, RTS %s",
736 (set
& TIOCM_DTR
) ? "HIGH" :
737 (clear
& TIOCM_DTR
) ? "LOW" : "unchanged",
738 (set
& TIOCM_RTS
) ? "HIGH" :
739 (clear
& TIOCM_RTS
) ? "LOW" : "unchanged");
741 dbg("%s - DTR %s, RTS %s", __FUNCTION__
,
742 (set
& TIOCM_DTR
) ? "HIGH" :
743 (clear
& TIOCM_DTR
) ? "LOW" : "unchanged",
744 (set
& TIOCM_RTS
) ? "HIGH" :
745 (clear
& TIOCM_RTS
) ? "LOW" : "unchanged");
746 priv
->last_dtr_rts
= (priv
->last_dtr_rts
& ~clear
) | set
;
752 static __u32
get_ftdi_divisor(struct usb_serial_port
* port
);
755 static int change_speed(struct usb_serial_port
*port
)
757 struct ftdi_private
*priv
= usb_get_serial_port_data(port
);
761 __u32 urb_index_value
;
764 buf
= kmalloc(1, GFP_NOIO
);
768 urb_index_value
= get_ftdi_divisor(port
);
769 urb_value
= (__u16
)urb_index_value
;
770 urb_index
= (__u16
)(urb_index_value
>> 16);
771 if (priv
->interface
) { /* FT2232C */
772 urb_index
= (__u16
)((urb_index
<< 8) | priv
->interface
);
775 rv
= usb_control_msg(port
->serial
->dev
,
776 usb_sndctrlpipe(port
->serial
->dev
, 0),
777 FTDI_SIO_SET_BAUDRATE_REQUEST
,
778 FTDI_SIO_SET_BAUDRATE_REQUEST_TYPE
,
779 urb_value
, urb_index
,
780 buf
, 0, WDR_SHORT_TIMEOUT
);
787 static __u32
get_ftdi_divisor(struct usb_serial_port
* port
)
788 { /* get_ftdi_divisor */
789 struct ftdi_private
*priv
= usb_get_serial_port_data(port
);
795 * The logic involved in setting the baudrate can be cleanly split in 3 steps.
796 * Obtaining the actual baud rate is a little tricky since unix traditionally
797 * somehow ignored the possibility to set non-standard baud rates.
798 * 1. Standard baud rates are set in tty->termios->c_cflag
799 * 2. If these are not enough, you can set any speed using alt_speed as follows:
800 * - set tty->termios->c_cflag speed to B38400
801 * - set your real speed in tty->alt_speed; it gets ignored when
803 * - call TIOCSSERIAL ioctl with (struct serial_struct) set as follows:
804 * flags & ASYNC_SPD_MASK == ASYNC_SPD_[HI, VHI, SHI, WARP], this just
805 * sets alt_speed to (HI: 57600, VHI: 115200, SHI: 230400, WARP: 460800)
806 * ** Steps 1, 2 are done courtesy of tty_get_baud_rate
807 * 3. You can also set baud rate by setting custom divisor as follows
808 * - set tty->termios->c_cflag speed to B38400
809 * - call TIOCSSERIAL ioctl with (struct serial_struct) set as follows:
810 * o flags & ASYNC_SPD_MASK == ASYNC_SPD_CUST
811 * o custom_divisor set to baud_base / your_new_baudrate
812 * ** Step 3 is done courtesy of code borrowed from serial.c - I should really
813 * spend some time and separate+move this common code to serial.c, it is
814 * replicated in nearly every serial driver you see.
817 /* 1. Get the baud rate from the tty settings, this observes alt_speed hack */
819 baud
= tty_get_baud_rate(port
->tty
);
820 dbg("%s - tty_get_baud_rate reports speed %d", __FUNCTION__
, baud
);
822 /* 2. Observe async-compatible custom_divisor hack, update baudrate if needed */
825 ((priv
->flags
& ASYNC_SPD_MASK
) == ASYNC_SPD_CUST
) &&
826 (priv
->custom_divisor
)) {
827 baud
= priv
->baud_base
/ priv
->custom_divisor
;
828 dbg("%s - custom divisor %d sets baud rate to %d", __FUNCTION__
, priv
->custom_divisor
, baud
);
831 /* 3. Convert baudrate to device-specific divisor */
833 if (!baud
) baud
= 9600;
834 switch(priv
->chip_type
) {
835 case SIO
: /* SIO chip */
837 case 300: div_value
= ftdi_sio_b300
; break;
838 case 600: div_value
= ftdi_sio_b600
; break;
839 case 1200: div_value
= ftdi_sio_b1200
; break;
840 case 2400: div_value
= ftdi_sio_b2400
; break;
841 case 4800: div_value
= ftdi_sio_b4800
; break;
842 case 9600: div_value
= ftdi_sio_b9600
; break;
843 case 19200: div_value
= ftdi_sio_b19200
; break;
844 case 38400: div_value
= ftdi_sio_b38400
; break;
845 case 57600: div_value
= ftdi_sio_b57600
; break;
846 case 115200: div_value
= ftdi_sio_b115200
; break;
848 if (div_value
== 0) {
849 dbg("%s - Baudrate (%d) requested is not supported", __FUNCTION__
, baud
);
850 div_value
= ftdi_sio_b9600
;
854 case FT8U232AM
: /* 8U232AM chip */
855 if (baud
<= 3000000) {
856 div_value
= ftdi_232am_baud_to_divisor(baud
);
858 dbg("%s - Baud rate too high!", __FUNCTION__
);
859 div_value
= ftdi_232am_baud_to_divisor(9600);
863 case FT232BM
: /* FT232BM chip */
864 case FT2232C
: /* FT2232C chip */
865 if (baud
<= 3000000) {
866 div_value
= ftdi_232bm_baud_to_divisor(baud
);
868 dbg("%s - Baud rate too high!", __FUNCTION__
);
869 div_value
= ftdi_232bm_baud_to_divisor(9600);
873 } /* priv->chip_type */
876 dbg("%s - Baud rate set to %d (divisor 0x%lX) on chip %s",
877 __FUNCTION__
, baud
, (unsigned long)div_value
,
878 ftdi_chip_name
[priv
->chip_type
]);
885 static int get_serial_info(struct usb_serial_port
* port
, struct serial_struct __user
* retinfo
)
887 struct ftdi_private
*priv
= usb_get_serial_port_data(port
);
888 struct serial_struct tmp
;
892 memset(&tmp
, 0, sizeof(tmp
));
893 tmp
.flags
= priv
->flags
;
894 tmp
.baud_base
= priv
->baud_base
;
895 tmp
.custom_divisor
= priv
->custom_divisor
;
896 if (copy_to_user(retinfo
, &tmp
, sizeof(*retinfo
)))
899 } /* get_serial_info */
902 static int set_serial_info(struct usb_serial_port
* port
, struct serial_struct __user
* newinfo
)
903 { /* set_serial_info */
904 struct ftdi_private
*priv
= usb_get_serial_port_data(port
);
905 struct serial_struct new_serial
;
906 struct ftdi_private old_priv
;
908 if (copy_from_user(&new_serial
, newinfo
, sizeof(new_serial
)))
912 /* Do error checking and permission checking */
914 if (!capable(CAP_SYS_ADMIN
)) {
915 if (((new_serial
.flags
& ~ASYNC_USR_MASK
) !=
916 (priv
->flags
& ~ASYNC_USR_MASK
)))
918 priv
->flags
= ((priv
->flags
& ~ASYNC_USR_MASK
) |
919 (new_serial
.flags
& ASYNC_USR_MASK
));
920 priv
->custom_divisor
= new_serial
.custom_divisor
;
924 if ((new_serial
.baud_base
!= priv
->baud_base
) &&
925 (new_serial
.baud_base
< 9600))
928 /* Make the changes - these are privileged changes! */
930 priv
->flags
= ((priv
->flags
& ~ASYNC_FLAGS
) |
931 (new_serial
.flags
& ASYNC_FLAGS
));
932 priv
->custom_divisor
= new_serial
.custom_divisor
;
934 port
->tty
->low_latency
= (priv
->flags
& ASYNC_LOW_LATENCY
) ? 1 : 0;
937 if ((old_priv
.flags
& ASYNC_SPD_MASK
) !=
938 (priv
->flags
& ASYNC_SPD_MASK
)) {
939 if ((priv
->flags
& ASYNC_SPD_MASK
) == ASYNC_SPD_HI
)
940 port
->tty
->alt_speed
= 57600;
941 else if ((priv
->flags
& ASYNC_SPD_MASK
) == ASYNC_SPD_VHI
)
942 port
->tty
->alt_speed
= 115200;
943 else if ((priv
->flags
& ASYNC_SPD_MASK
) == ASYNC_SPD_SHI
)
944 port
->tty
->alt_speed
= 230400;
945 else if ((priv
->flags
& ASYNC_SPD_MASK
) == ASYNC_SPD_WARP
)
946 port
->tty
->alt_speed
= 460800;
948 port
->tty
->alt_speed
= 0;
950 if (((old_priv
.flags
& ASYNC_SPD_MASK
) !=
951 (priv
->flags
& ASYNC_SPD_MASK
)) ||
952 (((priv
->flags
& ASYNC_SPD_MASK
) == ASYNC_SPD_CUST
) &&
953 (old_priv
.custom_divisor
!= priv
->custom_divisor
))) {
959 } /* set_serial_info */
962 /* Determine type of FTDI chip based on USB config and descriptor. */
963 static void ftdi_determine_type(struct usb_serial_port
*port
)
965 struct ftdi_private
*priv
= usb_get_serial_port_data(port
);
966 struct usb_serial
*serial
= port
->serial
;
967 struct usb_device
*udev
= serial
->dev
;
971 /* Assume it is not the original SIO device for now. */
972 priv
->baud_base
= 48000000 / 2;
973 priv
->write_offset
= 0;
975 version
= le16_to_cpu(udev
->descriptor
.bcdDevice
);
976 interfaces
= udev
->actconfig
->desc
.bNumInterfaces
;
977 dbg("%s: bcdDevice = 0x%x, bNumInterfaces = %u", __FUNCTION__
,
978 version
, interfaces
);
979 if (interfaces
> 1) {
982 /* Multiple interfaces. Assume FT2232C. */
983 priv
->chip_type
= FT2232C
;
984 /* Determine interface code. */
985 inter
= serial
->interface
->altsetting
->desc
.bInterfaceNumber
;
987 priv
->interface
= PIT_SIOA
;
989 priv
->interface
= PIT_SIOB
;
991 /* BM-type devices have a bug where bcdDevice gets set
992 * to 0x200 when iSerialNumber is 0. */
993 if (version
< 0x500) {
994 dbg("%s: something fishy - bcdDevice too low for multi-interface device",
997 } else if (version
< 0x200) {
998 /* Old device. Assume its the original SIO. */
999 priv
->chip_type
= SIO
;
1000 priv
->baud_base
= 12000000 / 16;
1001 priv
->write_offset
= 1;
1002 } else if (version
< 0x400) {
1003 /* Assume its an FT8U232AM (or FT8U245AM) */
1004 /* (It might be a BM because of the iSerialNumber bug,
1005 * but it will still work as an AM device.) */
1006 priv
->chip_type
= FT8U232AM
;
1008 /* Assume its an FT232BM (or FT245BM) */
1009 priv
->chip_type
= FT232BM
;
1011 info("Detected %s", ftdi_chip_name
[priv
->chip_type
]);
1016 * ***************************************************************************
1018 * ***************************************************************************
1021 static ssize_t
show_latency_timer(struct device
*dev
, struct device_attribute
*attr
, char *buf
)
1023 struct usb_serial_port
*port
= to_usb_serial_port(dev
);
1024 struct ftdi_private
*priv
= usb_get_serial_port_data(port
);
1025 struct usb_device
*udev
;
1026 unsigned short latency
= 0;
1029 udev
= to_usb_device(dev
);
1031 dbg("%s",__FUNCTION__
);
1033 rv
= usb_control_msg(udev
,
1034 usb_rcvctrlpipe(udev
, 0),
1035 FTDI_SIO_GET_LATENCY_TIMER_REQUEST
,
1036 FTDI_SIO_GET_LATENCY_TIMER_REQUEST_TYPE
,
1038 (char*) &latency
, 1, WDR_TIMEOUT
);
1041 dev_err(dev
, "Unable to read latency timer: %i", rv
);
1044 return sprintf(buf
, "%i\n", latency
);
1047 /* Write a new value of the latency timer, in units of milliseconds. */
1048 static ssize_t
store_latency_timer(struct device
*dev
, struct device_attribute
*attr
, const char *valbuf
,
1051 struct usb_serial_port
*port
= to_usb_serial_port(dev
);
1052 struct ftdi_private
*priv
= usb_get_serial_port_data(port
);
1053 struct usb_device
*udev
;
1055 int v
= simple_strtoul(valbuf
, NULL
, 10);
1058 udev
= to_usb_device(dev
);
1060 dbg("%s: setting latency timer = %i", __FUNCTION__
, v
);
1062 rv
= usb_control_msg(udev
,
1063 usb_sndctrlpipe(udev
, 0),
1064 FTDI_SIO_SET_LATENCY_TIMER_REQUEST
,
1065 FTDI_SIO_SET_LATENCY_TIMER_REQUEST_TYPE
,
1067 buf
, 0, WDR_TIMEOUT
);
1070 dev_err(dev
, "Unable to write latency timer: %i", rv
);
1077 /* Write an event character directly to the FTDI register. The ASCII
1078 value is in the low 8 bits, with the enable bit in the 9th bit. */
1079 static ssize_t
store_event_char(struct device
*dev
, struct device_attribute
*attr
, const char *valbuf
,
1082 struct usb_serial_port
*port
= to_usb_serial_port(dev
);
1083 struct ftdi_private
*priv
= usb_get_serial_port_data(port
);
1084 struct usb_device
*udev
;
1086 int v
= simple_strtoul(valbuf
, NULL
, 10);
1089 udev
= to_usb_device(dev
);
1091 dbg("%s: setting event char = %i", __FUNCTION__
, v
);
1093 rv
= usb_control_msg(udev
,
1094 usb_sndctrlpipe(udev
, 0),
1095 FTDI_SIO_SET_EVENT_CHAR_REQUEST
,
1096 FTDI_SIO_SET_EVENT_CHAR_REQUEST_TYPE
,
1098 buf
, 0, WDR_TIMEOUT
);
1101 dbg("Unable to write event character: %i", rv
);
1108 static DEVICE_ATTR(latency_timer
, S_IWUSR
| S_IRUGO
, show_latency_timer
, store_latency_timer
);
1109 static DEVICE_ATTR(event_char
, S_IWUSR
, NULL
, store_event_char
);
1111 static int create_sysfs_attrs(struct usb_serial
*serial
)
1113 struct ftdi_private
*priv
;
1114 struct usb_device
*udev
;
1117 dbg("%s",__FUNCTION__
);
1119 priv
= usb_get_serial_port_data(serial
->port
[0]);
1122 /* XXX I've no idea if the original SIO supports the event_char
1123 * sysfs parameter, so I'm playing it safe. */
1124 if (priv
->chip_type
!= SIO
) {
1125 dbg("sysfs attributes for %s", ftdi_chip_name
[priv
->chip_type
]);
1126 retval
= device_create_file(&udev
->dev
, &dev_attr_event_char
);
1128 (priv
->chip_type
== FT232BM
|| priv
->chip_type
== FT2232C
)) {
1129 retval
= device_create_file(&udev
->dev
,
1130 &dev_attr_latency_timer
);
1136 static void remove_sysfs_attrs(struct usb_serial
*serial
)
1138 struct ftdi_private
*priv
;
1139 struct usb_device
*udev
;
1141 dbg("%s",__FUNCTION__
);
1143 priv
= usb_get_serial_port_data(serial
->port
[0]);
1146 /* XXX see create_sysfs_attrs */
1147 if (priv
->chip_type
!= SIO
) {
1148 device_remove_file(&udev
->dev
, &dev_attr_event_char
);
1149 if (priv
->chip_type
== FT232BM
|| priv
->chip_type
== FT2232C
) {
1150 device_remove_file(&udev
->dev
, &dev_attr_latency_timer
);
1157 * ***************************************************************************
1158 * FTDI driver specific functions
1159 * ***************************************************************************
1162 /* Probe function to check for special devices */
1163 static int ftdi_sio_probe (struct usb_serial
*serial
, const struct usb_device_id
*id
)
1165 usb_set_serial_data(serial
, (void *)id
->driver_info
);
1170 /* attach subroutine */
1171 static int ftdi_sio_attach (struct usb_serial
*serial
)
1173 struct usb_serial_port
*port
= serial
->port
[0];
1174 struct ftdi_private
*priv
;
1175 struct ftdi_sio_quirk
*quirk
;
1178 dbg("%s",__FUNCTION__
);
1180 priv
= kzalloc(sizeof(struct ftdi_private
), GFP_KERNEL
);
1182 err("%s- kmalloc(%Zd) failed.", __FUNCTION__
, sizeof(struct ftdi_private
));
1186 spin_lock_init(&priv
->rx_lock
);
1187 spin_lock_init(&priv
->tx_lock
);
1188 init_waitqueue_head(&priv
->delta_msr_wait
);
1189 /* This will push the characters through immediately rather
1190 than queue a task to deliver them */
1191 priv
->flags
= ASYNC_LOW_LATENCY
;
1193 /* Increase the size of read buffers */
1194 kfree(port
->bulk_in_buffer
);
1195 port
->bulk_in_buffer
= kmalloc (BUFSZ
, GFP_KERNEL
);
1196 if (!port
->bulk_in_buffer
) {
1200 if (port
->read_urb
) {
1201 port
->read_urb
->transfer_buffer
= port
->bulk_in_buffer
;
1202 port
->read_urb
->transfer_buffer_length
= BUFSZ
;
1205 INIT_DELAYED_WORK(&priv
->rx_work
, ftdi_process_read
);
1208 /* Free port's existing write urb and transfer buffer. */
1209 if (port
->write_urb
) {
1210 usb_free_urb (port
->write_urb
);
1211 port
->write_urb
= NULL
;
1213 kfree(port
->bulk_out_buffer
);
1214 port
->bulk_out_buffer
= NULL
;
1216 usb_set_serial_port_data(serial
->port
[0], priv
);
1218 ftdi_determine_type (serial
->port
[0]);
1219 retval
= create_sysfs_attrs(serial
);
1221 dev_err(&serial
->dev
->dev
, "Error creating sysfs files, "
1224 /* Check for device requiring special set up. */
1225 quirk
= (struct ftdi_sio_quirk
*)usb_get_serial_data(serial
);
1226 if (quirk
&& quirk
->setup
) {
1227 quirk
->setup(serial
);
1231 } /* ftdi_sio_attach */
1234 /* Setup for the USB-UIRT device, which requires hardwired
1235 * baudrate (38400 gets mapped to 312500) */
1236 /* Called from usbserial:serial_probe */
1237 static void ftdi_USB_UIRT_setup (struct usb_serial
*serial
)
1239 struct ftdi_private
*priv
;
1241 dbg("%s",__FUNCTION__
);
1243 priv
= usb_get_serial_port_data(serial
->port
[0]);
1244 priv
->flags
|= ASYNC_SPD_CUST
;
1245 priv
->custom_divisor
= 77;
1246 priv
->force_baud
= B38400
;
1247 } /* ftdi_USB_UIRT_setup */
1249 /* Setup for the HE-TIRA1 device, which requires hardwired
1250 * baudrate (38400 gets mapped to 100000) and RTS-CTS enabled. */
1251 static void ftdi_HE_TIRA1_setup (struct usb_serial
*serial
)
1253 struct ftdi_private
*priv
;
1255 dbg("%s",__FUNCTION__
);
1257 priv
= usb_get_serial_port_data(serial
->port
[0]);
1258 priv
->flags
|= ASYNC_SPD_CUST
;
1259 priv
->custom_divisor
= 240;
1260 priv
->force_baud
= B38400
;
1261 priv
->force_rtscts
= 1;
1262 } /* ftdi_HE_TIRA1_setup */
1265 /* ftdi_shutdown is called from usbserial:usb_serial_disconnect
1266 * it is called when the usb device is disconnected
1268 * usbserial:usb_serial_disconnect
1269 * calls __serial_close for each open of the port
1270 * shutdown is called then (ie ftdi_shutdown)
1274 static void ftdi_shutdown (struct usb_serial
*serial
)
1275 { /* ftdi_shutdown */
1277 struct usb_serial_port
*port
= serial
->port
[0];
1278 struct ftdi_private
*priv
= usb_get_serial_port_data(port
);
1280 dbg("%s", __FUNCTION__
);
1282 remove_sysfs_attrs(serial
);
1284 /* all open ports are closed at this point
1285 * (by usbserial.c:__serial_close, which calls ftdi_close)
1289 usb_set_serial_port_data(port
, NULL
);
1292 } /* ftdi_shutdown */
1295 static int ftdi_open (struct usb_serial_port
*port
, struct file
*filp
)
1297 struct usb_device
*dev
= port
->serial
->dev
;
1298 struct ftdi_private
*priv
= usb_get_serial_port_data(port
);
1299 unsigned long flags
;
1302 char buf
[1]; /* Needed for the usb_control_msg I think */
1304 dbg("%s", __FUNCTION__
);
1306 spin_lock_irqsave(&priv
->tx_lock
, flags
);
1308 spin_unlock_irqrestore(&priv
->tx_lock
, flags
);
1309 spin_lock_irqsave(&priv
->rx_lock
, flags
);
1311 spin_unlock_irqrestore(&priv
->rx_lock
, flags
);
1314 port
->tty
->low_latency
= (priv
->flags
& ASYNC_LOW_LATENCY
) ? 1 : 0;
1316 /* No error checking for this (will get errors later anyway) */
1317 /* See ftdi_sio.h for description of what is reset */
1318 usb_control_msg(dev
, usb_sndctrlpipe(dev
, 0),
1319 FTDI_SIO_RESET_REQUEST
, FTDI_SIO_RESET_REQUEST_TYPE
,
1321 priv
->interface
, buf
, 0, WDR_TIMEOUT
);
1323 /* Termios defaults are set by usb_serial_init. We don't change
1324 port->tty->termios - this would loose speed settings, etc.
1325 This is same behaviour as serial.c/rs_open() - Kuba */
1327 /* ftdi_set_termios will send usb control messages */
1329 ftdi_set_termios(port
, NULL
);
1331 /* FIXME: Flow control might be enabled, so it should be checked -
1332 we have no control of defaults! */
1333 /* Turn on RTS and DTR since we are not flow controlling by default */
1334 set_mctrl(port
, TIOCM_DTR
| TIOCM_RTS
);
1337 spin_lock_irqsave(&priv
->rx_lock
, flags
);
1338 priv
->rx_flags
&= ~(THROTTLED
| ACTUALLY_THROTTLED
);
1339 spin_unlock_irqrestore(&priv
->rx_lock
, flags
);
1341 /* Start reading from the device */
1342 priv
->rx_processed
= 0;
1343 usb_fill_bulk_urb(port
->read_urb
, dev
,
1344 usb_rcvbulkpipe(dev
, port
->bulk_in_endpointAddress
),
1345 port
->read_urb
->transfer_buffer
, port
->read_urb
->transfer_buffer_length
,
1346 ftdi_read_bulk_callback
, port
);
1347 result
= usb_submit_urb(port
->read_urb
, GFP_KERNEL
);
1349 err("%s - failed submitting read urb, error %d", __FUNCTION__
, result
);
1358 * usbserial:__serial_close only calls ftdi_close if the point is open
1360 * This only gets called when it is the last close
1365 static void ftdi_close (struct usb_serial_port
*port
, struct file
*filp
)
1367 unsigned int c_cflag
= port
->tty
->termios
->c_cflag
;
1368 struct ftdi_private
*priv
= usb_get_serial_port_data(port
);
1371 dbg("%s", __FUNCTION__
);
1373 if (c_cflag
& HUPCL
){
1374 /* Disable flow control */
1375 if (usb_control_msg(port
->serial
->dev
,
1376 usb_sndctrlpipe(port
->serial
->dev
, 0),
1377 FTDI_SIO_SET_FLOW_CTRL_REQUEST
,
1378 FTDI_SIO_SET_FLOW_CTRL_REQUEST_TYPE
,
1379 0, priv
->interface
, buf
, 0,
1381 err("error from flowcontrol urb");
1384 /* drop RTS and DTR */
1385 clear_mctrl(port
, TIOCM_DTR
| TIOCM_RTS
);
1386 } /* Note change no line if hupcl is off */
1388 /* cancel any scheduled reading */
1389 cancel_delayed_work(&priv
->rx_work
);
1390 flush_scheduled_work();
1392 /* shutdown our bulk read */
1393 usb_kill_urb(port
->read_urb
);
1398 /* The SIO requires the first byte to have:
1401 * B2..7 length of message excluding byte 0
1403 * The new devices do not require this byte
1405 static int ftdi_write (struct usb_serial_port
*port
,
1406 const unsigned char *buf
, int count
)
1408 struct ftdi_private
*priv
= usb_get_serial_port_data(port
);
1410 unsigned char *buffer
;
1411 int data_offset
; /* will be 1 for the SIO and 0 otherwise */
1414 unsigned long flags
;
1416 dbg("%s port %d, %d bytes", __FUNCTION__
, port
->number
, count
);
1419 dbg("write request of 0 bytes");
1422 spin_lock_irqsave(&priv
->tx_lock
, flags
);
1423 if (priv
->tx_outstanding_urbs
> URB_UPPER_LIMIT
) {
1424 spin_unlock_irqrestore(&priv
->tx_lock
, flags
);
1425 dbg("%s - write limit hit\n", __FUNCTION__
);
1428 spin_unlock_irqrestore(&priv
->tx_lock
, flags
);
1430 data_offset
= priv
->write_offset
;
1431 dbg("data_offset set to %d",data_offset
);
1433 /* Determine total transfer size */
1434 transfer_size
= count
;
1435 if (data_offset
> 0) {
1436 /* Original sio needs control bytes too... */
1437 transfer_size
+= (data_offset
*
1438 ((count
+ (PKTSZ
- 1 - data_offset
)) /
1439 (PKTSZ
- data_offset
)));
1442 buffer
= kmalloc (transfer_size
, GFP_ATOMIC
);
1444 err("%s ran out of kernel memory for urb ...", __FUNCTION__
);
1448 urb
= usb_alloc_urb(0, GFP_ATOMIC
);
1450 err("%s - no more free urbs", __FUNCTION__
);
1456 if (data_offset
> 0) {
1457 /* Original sio requires control byte at start of each packet. */
1458 int user_pktsz
= PKTSZ
- data_offset
;
1460 unsigned char *first_byte
= buffer
;
1461 const unsigned char *current_position
= buf
;
1464 if (user_pktsz
> todo
) {
1467 /* Write the control byte at the front of the packet*/
1468 *first_byte
= 1 | ((user_pktsz
) << 2);
1469 /* Copy data for packet */
1470 memcpy (first_byte
+ data_offset
,
1471 current_position
, user_pktsz
);
1472 first_byte
+= user_pktsz
+ data_offset
;
1473 current_position
+= user_pktsz
;
1477 /* No control byte required. */
1478 /* Copy in the data to send */
1479 memcpy (buffer
, buf
, count
);
1482 usb_serial_debug_data(debug
, &port
->dev
, __FUNCTION__
, transfer_size
, buffer
);
1484 /* fill the buffer and send it */
1485 usb_fill_bulk_urb(urb
, port
->serial
->dev
,
1486 usb_sndbulkpipe(port
->serial
->dev
, port
->bulk_out_endpointAddress
),
1487 buffer
, transfer_size
,
1488 ftdi_write_bulk_callback
, port
);
1490 status
= usb_submit_urb(urb
, GFP_ATOMIC
);
1492 err("%s - failed submitting write urb, error %d", __FUNCTION__
, status
);
1496 spin_lock_irqsave(&priv
->tx_lock
, flags
);
1497 ++priv
->tx_outstanding_urbs
;
1498 priv
->tx_outstanding_bytes
+= count
;
1499 priv
->tx_bytes
+= count
;
1500 spin_unlock_irqrestore(&priv
->tx_lock
, flags
);
1503 /* we are done with this urb, so let the host driver
1504 * really free it when it is finished with it */
1507 dbg("%s write returning: %d", __FUNCTION__
, count
);
1512 /* This function may get called when the device is closed */
1514 static void ftdi_write_bulk_callback (struct urb
*urb
)
1516 unsigned long flags
;
1517 struct usb_serial_port
*port
= (struct usb_serial_port
*)urb
->context
;
1518 struct ftdi_private
*priv
;
1519 int data_offset
; /* will be 1 for the SIO and 0 otherwise */
1520 unsigned long countback
;
1522 /* free up the transfer buffer, as usb_free_urb() does not do this */
1523 kfree (urb
->transfer_buffer
);
1525 dbg("%s - port %d", __FUNCTION__
, port
->number
);
1528 dbg("nonzero write bulk status received: %d", urb
->status
);
1532 priv
= usb_get_serial_port_data(port
);
1534 dbg("%s - bad port private data pointer - exiting", __FUNCTION__
);
1537 /* account for transferred data */
1538 countback
= urb
->actual_length
;
1539 data_offset
= priv
->write_offset
;
1540 if (data_offset
> 0) {
1541 /* Subtract the control bytes */
1542 countback
-= (data_offset
* ((countback
+ (PKTSZ
- 1)) / PKTSZ
));
1544 spin_lock_irqsave(&priv
->tx_lock
, flags
);
1545 --priv
->tx_outstanding_urbs
;
1546 priv
->tx_outstanding_bytes
-= countback
;
1547 spin_unlock_irqrestore(&priv
->tx_lock
, flags
);
1549 usb_serial_port_softint(port
);
1550 } /* ftdi_write_bulk_callback */
1553 static int ftdi_write_room( struct usb_serial_port
*port
)
1555 struct ftdi_private
*priv
= usb_get_serial_port_data(port
);
1557 unsigned long flags
;
1559 dbg("%s - port %d", __FUNCTION__
, port
->number
);
1561 spin_lock_irqsave(&priv
->tx_lock
, flags
);
1562 if (priv
->tx_outstanding_urbs
< URB_UPPER_LIMIT
) {
1564 * We really can take anything the user throws at us
1565 * but let's pick a nice big number to tell the tty
1566 * layer that we have lots of free space
1572 spin_unlock_irqrestore(&priv
->tx_lock
, flags
);
1574 } /* ftdi_write_room */
1577 static int ftdi_chars_in_buffer (struct usb_serial_port
*port
)
1578 { /* ftdi_chars_in_buffer */
1579 struct ftdi_private
*priv
= usb_get_serial_port_data(port
);
1581 unsigned long flags
;
1583 dbg("%s - port %d", __FUNCTION__
, port
->number
);
1585 spin_lock_irqsave(&priv
->tx_lock
, flags
);
1586 buffered
= (int)priv
->tx_outstanding_bytes
;
1587 spin_unlock_irqrestore(&priv
->tx_lock
, flags
);
1589 err("%s outstanding tx bytes is negative!", __FUNCTION__
);
1593 } /* ftdi_chars_in_buffer */
1597 static void ftdi_read_bulk_callback (struct urb
*urb
)
1598 { /* ftdi_read_bulk_callback */
1599 struct usb_serial_port
*port
= (struct usb_serial_port
*)urb
->context
;
1600 struct tty_struct
*tty
;
1601 struct ftdi_private
*priv
;
1602 unsigned long countread
;
1603 unsigned long flags
;
1605 if (urb
->number_of_packets
> 0) {
1606 err("%s transfer_buffer_length %d actual_length %d number of packets %d",__FUNCTION__
,
1607 urb
->transfer_buffer_length
, urb
->actual_length
, urb
->number_of_packets
);
1608 err("%s transfer_flags %x ", __FUNCTION__
,urb
->transfer_flags
);
1611 dbg("%s - port %d", __FUNCTION__
, port
->number
);
1613 if (port
->open_count
<= 0)
1618 dbg("%s - bad tty pointer - exiting",__FUNCTION__
);
1622 priv
= usb_get_serial_port_data(port
);
1624 dbg("%s - bad port private data pointer - exiting", __FUNCTION__
);
1628 if (urb
!= port
->read_urb
) {
1629 err("%s - Not my urb!", __FUNCTION__
);
1633 /* This will happen at close every time so it is a dbg not an err */
1634 dbg("(this is ok on close) nonzero read bulk status received: %d", urb
->status
);
1638 /* count data bytes, but not status bytes */
1639 countread
= urb
->actual_length
;
1640 countread
-= 2 * ((countread
+ (PKTSZ
- 1)) / PKTSZ
);
1641 spin_lock_irqsave(&priv
->rx_lock
, flags
);
1642 priv
->rx_bytes
+= countread
;
1643 spin_unlock_irqrestore(&priv
->rx_lock
, flags
);
1645 ftdi_process_read(&priv
->rx_work
.work
);
1647 } /* ftdi_read_bulk_callback */
1650 static void ftdi_process_read (struct work_struct
*work
)
1651 { /* ftdi_process_read */
1652 struct ftdi_private
*priv
=
1653 container_of(work
, struct ftdi_private
, rx_work
.work
);
1654 struct usb_serial_port
*port
= priv
->port
;
1656 struct tty_struct
*tty
;
1658 unsigned char *data
;
1664 unsigned long flags
;
1666 dbg("%s - port %d", __FUNCTION__
, port
->number
);
1668 if (port
->open_count
<= 0)
1673 dbg("%s - bad tty pointer - exiting",__FUNCTION__
);
1677 priv
= usb_get_serial_port_data(port
);
1679 dbg("%s - bad port private data pointer - exiting", __FUNCTION__
);
1683 urb
= port
->read_urb
;
1685 dbg("%s - bad read_urb pointer - exiting", __FUNCTION__
);
1689 data
= urb
->transfer_buffer
;
1691 if (priv
->rx_processed
) {
1692 dbg("%s - already processed: %d bytes, %d remain", __FUNCTION__
,
1694 urb
->actual_length
- priv
->rx_processed
);
1696 /* The first two bytes of every read packet are status */
1697 if (urb
->actual_length
> 2) {
1698 usb_serial_debug_data(debug
, &port
->dev
, __FUNCTION__
, urb
->actual_length
, data
);
1700 dbg("Status only: %03oo %03oo",data
[0],data
[1]);
1705 /* TO DO -- check for hung up line and handle appropriately: */
1707 /* See acm.c - you do a tty_hangup - eg tty_hangup(tty) */
1708 /* if CD is dropped and the line is not CLOCAL then we should hangup */
1711 for (packet_offset
= priv
->rx_processed
; packet_offset
< urb
->actual_length
; packet_offset
+= PKTSZ
) {
1714 /* Compare new line status to the old one, signal if different */
1715 /* N.B. packet may be processed more than once, but differences
1716 * are only processed once. */
1718 char new_status
= data
[packet_offset
+0] & FTDI_STATUS_B0_MASK
;
1719 if (new_status
!= priv
->prev_status
) {
1720 priv
->diff_status
|= new_status
^ priv
->prev_status
;
1721 wake_up_interruptible(&priv
->delta_msr_wait
);
1722 priv
->prev_status
= new_status
;
1726 length
= min(PKTSZ
, urb
->actual_length
-packet_offset
)-2;
1728 err("%s - bad packet length: %d", __FUNCTION__
, length
+2);
1732 if (priv
->rx_flags
& THROTTLED
) {
1733 dbg("%s - throttled", __FUNCTION__
);
1736 if (tty_buffer_request_room(tty
, length
) < length
) {
1737 /* break out & wait for throttling/unthrottling to happen */
1738 dbg("%s - receive room low", __FUNCTION__
);
1742 /* Handle errors and break */
1743 error_flag
= TTY_NORMAL
;
1744 /* Although the device uses a bitmask and hence can have multiple */
1745 /* errors on a packet - the order here sets the priority the */
1746 /* error is returned to the tty layer */
1748 if ( data
[packet_offset
+1] & FTDI_RS_OE
) {
1749 error_flag
= TTY_OVERRUN
;
1750 dbg("OVERRRUN error");
1752 if ( data
[packet_offset
+1] & FTDI_RS_BI
) {
1753 error_flag
= TTY_BREAK
;
1754 dbg("BREAK received");
1756 if ( data
[packet_offset
+1] & FTDI_RS_PE
) {
1757 error_flag
= TTY_PARITY
;
1758 dbg("PARITY error");
1760 if ( data
[packet_offset
+1] & FTDI_RS_FE
) {
1761 error_flag
= TTY_FRAME
;
1762 dbg("FRAMING error");
1765 for (i
= 2; i
< length
+2; i
++) {
1766 /* Note that the error flag is duplicated for
1767 every character received since we don't know
1768 which character it applied to */
1769 tty_insert_flip_char(tty
, data
[packet_offset
+i
], error_flag
);
1774 #ifdef NOT_CORRECT_BUT_KEEPING_IT_FOR_NOW
1775 /* if a parity error is detected you get status packets forever
1776 until a character is sent without a parity error.
1777 This doesn't work well since the application receives a never
1778 ending stream of bad data - even though new data hasn't been sent.
1779 Therefore I (bill) have taken this out.
1780 However - this might make sense for framing errors and so on
1781 so I am leaving the code in for now.
1784 if (error_flag
!= TTY_NORMAL
){
1785 dbg("error_flag is not normal");
1786 /* In this case it is just status - if that is an error send a bad character */
1787 if(tty
->flip
.count
>= TTY_FLIPBUF_SIZE
) {
1788 tty_flip_buffer_push(tty
);
1790 tty_insert_flip_char(tty
, 0xff, error_flag
);
1795 } /* "for(packet_offset=0..." */
1799 tty_flip_buffer_push(tty
);
1802 if (packet_offset
< urb
->actual_length
) {
1803 /* not completely processed - record progress */
1804 priv
->rx_processed
= packet_offset
;
1805 dbg("%s - incomplete, %d bytes processed, %d remain",
1806 __FUNCTION__
, packet_offset
,
1807 urb
->actual_length
- packet_offset
);
1808 /* check if we were throttled while processing */
1809 spin_lock_irqsave(&priv
->rx_lock
, flags
);
1810 if (priv
->rx_flags
& THROTTLED
) {
1811 priv
->rx_flags
|= ACTUALLY_THROTTLED
;
1812 spin_unlock_irqrestore(&priv
->rx_lock
, flags
);
1813 dbg("%s - deferring remainder until unthrottled",
1817 spin_unlock_irqrestore(&priv
->rx_lock
, flags
);
1818 /* if the port is closed stop trying to read */
1819 if (port
->open_count
> 0){
1820 /* delay processing of remainder */
1821 schedule_delayed_work(&priv
->rx_work
, 1);
1823 dbg("%s - port is closed", __FUNCTION__
);
1828 /* urb is completely processed */
1829 priv
->rx_processed
= 0;
1831 /* if the port is closed stop trying to read */
1832 if (port
->open_count
> 0){
1833 /* Continue trying to always read */
1834 usb_fill_bulk_urb(port
->read_urb
, port
->serial
->dev
,
1835 usb_rcvbulkpipe(port
->serial
->dev
, port
->bulk_in_endpointAddress
),
1836 port
->read_urb
->transfer_buffer
, port
->read_urb
->transfer_buffer_length
,
1837 ftdi_read_bulk_callback
, port
);
1839 result
= usb_submit_urb(port
->read_urb
, GFP_ATOMIC
);
1841 err("%s - failed resubmitting read urb, error %d", __FUNCTION__
, result
);
1845 } /* ftdi_process_read */
1848 static void ftdi_break_ctl( struct usb_serial_port
*port
, int break_state
)
1850 struct ftdi_private
*priv
= usb_get_serial_port_data(port
);
1851 __u16 urb_value
= 0;
1854 /* break_state = -1 to turn on break, and 0 to turn off break */
1855 /* see drivers/char/tty_io.c to see it used */
1856 /* last_set_data_urb_value NEVER has the break bit set in it */
1859 urb_value
= priv
->last_set_data_urb_value
| FTDI_SIO_SET_BREAK
;
1861 urb_value
= priv
->last_set_data_urb_value
;
1865 if (usb_control_msg(port
->serial
->dev
, usb_sndctrlpipe(port
->serial
->dev
, 0),
1866 FTDI_SIO_SET_DATA_REQUEST
,
1867 FTDI_SIO_SET_DATA_REQUEST_TYPE
,
1868 urb_value
, priv
->interface
,
1869 buf
, 0, WDR_TIMEOUT
) < 0) {
1870 err("%s FAILED to enable/disable break state (state was %d)", __FUNCTION__
,break_state
);
1873 dbg("%s break state is %d - urb is %d", __FUNCTION__
,break_state
, urb_value
);
1878 /* old_termios contains the original termios settings and tty->termios contains
1879 * the new setting to be used
1880 * WARNING: set_termios calls this with old_termios in kernel space
1883 static void ftdi_set_termios (struct usb_serial_port
*port
, struct termios
*old_termios
)
1884 { /* ftdi_termios */
1885 struct usb_device
*dev
= port
->serial
->dev
;
1886 unsigned int cflag
= port
->tty
->termios
->c_cflag
;
1887 struct ftdi_private
*priv
= usb_get_serial_port_data(port
);
1888 __u16 urb_value
; /* will hold the new flags */
1889 char buf
[1]; /* Perhaps I should dynamically alloc this? */
1891 // Added for xon/xoff support
1892 unsigned int iflag
= port
->tty
->termios
->c_iflag
;
1893 unsigned char vstop
;
1894 unsigned char vstart
;
1896 dbg("%s", __FUNCTION__
);
1898 /* Force baud rate if this device requires it, unless it is set to B0. */
1899 if (priv
->force_baud
&& ((port
->tty
->termios
->c_cflag
& CBAUD
) != B0
)) {
1900 dbg("%s: forcing baud rate for this device", __FUNCTION__
);
1901 port
->tty
->termios
->c_cflag
&= ~CBAUD
;
1902 port
->tty
->termios
->c_cflag
|= priv
->force_baud
;
1905 /* Force RTS-CTS if this device requires it. */
1906 if (priv
->force_rtscts
) {
1907 dbg("%s: forcing rtscts for this device", __FUNCTION__
);
1908 port
->tty
->termios
->c_cflag
|= CRTSCTS
;
1911 cflag
= port
->tty
->termios
->c_cflag
;
1913 /* FIXME -For this cut I don't care if the line is really changing or
1914 not - so just do the change regardless - should be able to
1915 compare old_termios and tty->termios */
1916 /* NOTE These routines can get interrupted by
1917 ftdi_sio_read_bulk_callback - need to examine what this
1918 means - don't see any problems yet */
1920 /* Set number of data bits, parity, stop bits */
1923 urb_value
|= (cflag
& CSTOPB
? FTDI_SIO_SET_DATA_STOP_BITS_2
:
1924 FTDI_SIO_SET_DATA_STOP_BITS_1
);
1925 urb_value
|= (cflag
& PARENB
?
1926 (cflag
& PARODD
? FTDI_SIO_SET_DATA_PARITY_ODD
:
1927 FTDI_SIO_SET_DATA_PARITY_EVEN
) :
1928 FTDI_SIO_SET_DATA_PARITY_NONE
);
1929 if (cflag
& CSIZE
) {
1930 switch (cflag
& CSIZE
) {
1931 case CS5
: urb_value
|= 5; dbg("Setting CS5"); break;
1932 case CS6
: urb_value
|= 6; dbg("Setting CS6"); break;
1933 case CS7
: urb_value
|= 7; dbg("Setting CS7"); break;
1934 case CS8
: urb_value
|= 8; dbg("Setting CS8"); break;
1936 err("CSIZE was set but not CS5-CS8");
1940 /* This is needed by the break command since it uses the same command - but is
1941 * or'ed with this value */
1942 priv
->last_set_data_urb_value
= urb_value
;
1944 if (usb_control_msg(dev
, usb_sndctrlpipe(dev
, 0),
1945 FTDI_SIO_SET_DATA_REQUEST
,
1946 FTDI_SIO_SET_DATA_REQUEST_TYPE
,
1947 urb_value
, priv
->interface
,
1948 buf
, 0, WDR_SHORT_TIMEOUT
) < 0) {
1949 err("%s FAILED to set databits/stopbits/parity", __FUNCTION__
);
1952 /* Now do the baudrate */
1953 if ((cflag
& CBAUD
) == B0
) {
1954 /* Disable flow control */
1955 if (usb_control_msg(dev
, usb_sndctrlpipe(dev
, 0),
1956 FTDI_SIO_SET_FLOW_CTRL_REQUEST
,
1957 FTDI_SIO_SET_FLOW_CTRL_REQUEST_TYPE
,
1959 buf
, 0, WDR_TIMEOUT
) < 0) {
1960 err("%s error from disable flowcontrol urb", __FUNCTION__
);
1962 /* Drop RTS and DTR */
1963 clear_mctrl(port
, TIOCM_DTR
| TIOCM_RTS
);
1965 /* set the baudrate determined before */
1966 if (change_speed(port
)) {
1967 err("%s urb failed to set baudrate", __FUNCTION__
);
1969 /* Ensure RTS and DTR are raised when baudrate changed from 0 */
1970 if (!old_termios
|| (old_termios
->c_cflag
& CBAUD
) == B0
) {
1971 set_mctrl(port
, TIOCM_DTR
| TIOCM_RTS
);
1975 /* Set flow control */
1976 /* Note device also supports DTR/CD (ugh) and Xon/Xoff in hardware */
1977 if (cflag
& CRTSCTS
) {
1978 dbg("%s Setting to CRTSCTS flow control", __FUNCTION__
);
1979 if (usb_control_msg(dev
,
1980 usb_sndctrlpipe(dev
, 0),
1981 FTDI_SIO_SET_FLOW_CTRL_REQUEST
,
1982 FTDI_SIO_SET_FLOW_CTRL_REQUEST_TYPE
,
1983 0 , (FTDI_SIO_RTS_CTS_HS
| priv
->interface
),
1984 buf
, 0, WDR_TIMEOUT
) < 0) {
1985 err("urb failed to set to rts/cts flow control");
1992 * Check the IXOFF status in the iflag component of the termios structure
1993 * if IXOFF is not set, the pre-xon/xoff code is executed.
1995 if (iflag
& IXOFF
) {
1996 dbg("%s request to enable xonxoff iflag=%04x",__FUNCTION__
,iflag
);
1997 // Try to enable the XON/XOFF on the ftdi_sio
1998 // Set the vstart and vstop -- could have been done up above where
1999 // a lot of other dereferencing is done but that would be very
2000 // inefficient as vstart and vstop are not always needed
2001 vstart
=port
->tty
->termios
->c_cc
[VSTART
];
2002 vstop
=port
->tty
->termios
->c_cc
[VSTOP
];
2003 urb_value
=(vstop
<< 8) | (vstart
);
2005 if (usb_control_msg(dev
,
2006 usb_sndctrlpipe(dev
, 0),
2007 FTDI_SIO_SET_FLOW_CTRL_REQUEST
,
2008 FTDI_SIO_SET_FLOW_CTRL_REQUEST_TYPE
,
2009 urb_value
, (FTDI_SIO_XON_XOFF_HS
2011 buf
, 0, WDR_TIMEOUT
) < 0) {
2012 err("urb failed to set to xon/xoff flow control");
2015 /* else clause to only run if cfag ! CRTSCTS and iflag ! XOFF */
2016 /* CHECKME Assuming XON/XOFF handled by tty stack - not by device */
2017 dbg("%s Turning off hardware flow control", __FUNCTION__
);
2018 if (usb_control_msg(dev
,
2019 usb_sndctrlpipe(dev
, 0),
2020 FTDI_SIO_SET_FLOW_CTRL_REQUEST
,
2021 FTDI_SIO_SET_FLOW_CTRL_REQUEST_TYPE
,
2023 buf
, 0, WDR_TIMEOUT
) < 0) {
2024 err("urb failed to clear flow control");
2030 } /* ftdi_termios */
2033 static int ftdi_tiocmget (struct usb_serial_port
*port
, struct file
*file
)
2035 struct ftdi_private
*priv
= usb_get_serial_port_data(port
);
2036 unsigned char buf
[2];
2039 dbg("%s TIOCMGET", __FUNCTION__
);
2040 switch (priv
->chip_type
) {
2042 /* Request the status from the device */
2043 if ((ret
= usb_control_msg(port
->serial
->dev
,
2044 usb_rcvctrlpipe(port
->serial
->dev
, 0),
2045 FTDI_SIO_GET_MODEM_STATUS_REQUEST
,
2046 FTDI_SIO_GET_MODEM_STATUS_REQUEST_TYPE
,
2048 buf
, 1, WDR_TIMEOUT
)) < 0 ) {
2049 err("%s Could not get modem status of device - err: %d", __FUNCTION__
,
2057 /* the 8U232AM returns a two byte value (the sio is a 1 byte value) - in the same
2058 format as the data returned from the in point */
2059 if ((ret
= usb_control_msg(port
->serial
->dev
,
2060 usb_rcvctrlpipe(port
->serial
->dev
, 0),
2061 FTDI_SIO_GET_MODEM_STATUS_REQUEST
,
2062 FTDI_SIO_GET_MODEM_STATUS_REQUEST_TYPE
,
2064 buf
, 2, WDR_TIMEOUT
)) < 0 ) {
2065 err("%s Could not get modem status of device - err: %d", __FUNCTION__
,
2075 return (buf
[0] & FTDI_SIO_DSR_MASK
? TIOCM_DSR
: 0) |
2076 (buf
[0] & FTDI_SIO_CTS_MASK
? TIOCM_CTS
: 0) |
2077 (buf
[0] & FTDI_SIO_RI_MASK
? TIOCM_RI
: 0) |
2078 (buf
[0] & FTDI_SIO_RLSD_MASK
? TIOCM_CD
: 0) |
2082 static int ftdi_tiocmset(struct usb_serial_port
*port
, struct file
* file
, unsigned int set
, unsigned int clear
)
2084 dbg("%s TIOCMSET", __FUNCTION__
);
2085 return update_mctrl(port
, set
, clear
);
2089 static int ftdi_ioctl (struct usb_serial_port
*port
, struct file
* file
, unsigned int cmd
, unsigned long arg
)
2091 struct ftdi_private
*priv
= usb_get_serial_port_data(port
);
2093 dbg("%s cmd 0x%04x", __FUNCTION__
, cmd
);
2095 /* Based on code from acm.c and others */
2098 case TIOCGSERIAL
: /* gets serial port data */
2099 return get_serial_info(port
, (struct serial_struct __user
*) arg
);
2101 case TIOCSSERIAL
: /* sets serial port data */
2102 return set_serial_info(port
, (struct serial_struct __user
*) arg
);
2105 * Wait for any of the 4 modem inputs (DCD,RI,DSR,CTS) to change
2106 * - mask passed in arg for lines of interest
2107 * (use |'ed TIOCM_RNG/DSR/CD/CTS for masking)
2108 * Caller should use TIOCGICOUNT to see which one it was.
2110 * This code is borrowed from linux/drivers/char/serial.c
2113 while (priv
!= NULL
) {
2114 interruptible_sleep_on(&priv
->delta_msr_wait
);
2115 /* see if a signal did it */
2116 if (signal_pending(current
))
2117 return -ERESTARTSYS
;
2119 char diff
= priv
->diff_status
;
2122 return -EIO
; /* no change => error */
2125 /* Consume all events */
2126 priv
->diff_status
= 0;
2128 /* Return 0 if caller wanted to know about these bits */
2129 if ( ((arg
& TIOCM_RNG
) && (diff
& FTDI_RS0_RI
)) ||
2130 ((arg
& TIOCM_DSR
) && (diff
& FTDI_RS0_DSR
)) ||
2131 ((arg
& TIOCM_CD
) && (diff
& FTDI_RS0_RLSD
)) ||
2132 ((arg
& TIOCM_CTS
) && (diff
& FTDI_RS0_CTS
)) ) {
2136 * Otherwise caller can't care less about what happened,
2137 * and so we continue to wait for more events.
2149 /* This is not necessarily an error - turns out the higher layers will do
2150 * some ioctls itself (see comment above)
2152 dbg("%s arg not supported - it was 0x%04x - check /usr/include/asm/ioctls.h", __FUNCTION__
, cmd
);
2154 return(-ENOIOCTLCMD
);
2158 static void ftdi_throttle (struct usb_serial_port
*port
)
2160 struct ftdi_private
*priv
= usb_get_serial_port_data(port
);
2161 unsigned long flags
;
2163 dbg("%s - port %d", __FUNCTION__
, port
->number
);
2165 spin_lock_irqsave(&priv
->rx_lock
, flags
);
2166 priv
->rx_flags
|= THROTTLED
;
2167 spin_unlock_irqrestore(&priv
->rx_lock
, flags
);
2171 static void ftdi_unthrottle (struct usb_serial_port
*port
)
2173 struct ftdi_private
*priv
= usb_get_serial_port_data(port
);
2174 int actually_throttled
;
2175 unsigned long flags
;
2177 dbg("%s - port %d", __FUNCTION__
, port
->number
);
2179 spin_lock_irqsave(&priv
->rx_lock
, flags
);
2180 actually_throttled
= priv
->rx_flags
& ACTUALLY_THROTTLED
;
2181 priv
->rx_flags
&= ~(THROTTLED
| ACTUALLY_THROTTLED
);
2182 spin_unlock_irqrestore(&priv
->rx_lock
, flags
);
2184 if (actually_throttled
)
2185 schedule_delayed_work(&priv
->rx_work
, 0);
2188 static int __init
ftdi_init (void)
2192 dbg("%s", __FUNCTION__
);
2193 if (vendor
> 0 && product
> 0) {
2194 /* Add user specified VID/PID to reserved element of table. */
2196 for (i
= 0; id_table_combined
[i
].idVendor
; i
++)
2198 id_table_combined
[i
].match_flags
= USB_DEVICE_ID_MATCH_DEVICE
;
2199 id_table_combined
[i
].idVendor
= vendor
;
2200 id_table_combined
[i
].idProduct
= product
;
2202 retval
= usb_serial_register(&ftdi_sio_device
);
2204 goto failed_sio_register
;
2205 retval
= usb_register(&ftdi_driver
);
2207 goto failed_usb_register
;
2209 info(DRIVER_VERSION
":" DRIVER_DESC
);
2211 failed_usb_register
:
2212 usb_serial_deregister(&ftdi_sio_device
);
2213 failed_sio_register
:
2218 static void __exit
ftdi_exit (void)
2221 dbg("%s", __FUNCTION__
);
2223 usb_deregister (&ftdi_driver
);
2224 usb_serial_deregister (&ftdi_sio_device
);
2229 module_init(ftdi_init
);
2230 module_exit(ftdi_exit
);
2232 MODULE_AUTHOR( DRIVER_AUTHOR
);
2233 MODULE_DESCRIPTION( DRIVER_DESC
);
2234 MODULE_LICENSE("GPL");
2236 module_param(debug
, bool, S_IRUGO
| S_IWUSR
);
2237 MODULE_PARM_DESC(debug
, "Debug enabled or not");
2238 module_param(vendor
, ushort
, 0);
2239 MODULE_PARM_DESC(vendor
, "User specified vendor ID (default="
2240 __MODULE_STRING(FTDI_VID
)")");
2241 module_param(product
, ushort
, 0);
2242 MODULE_PARM_DESC(vendor
, "User specified product ID");