sierra.c 32 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163
  1. /*
  2. USB Driver for Sierra Wireless
  3. Copyright (C) 2006, 2007, 2008 Kevin Lloyd <klloyd@sierrawireless.com>,
  4. Copyright (C) 2008, 2009 Elina Pasheva, Matthew Safar, Rory Filer
  5. <linux@sierrawireless.com>
  6. IMPORTANT DISCLAIMER: This driver is not commercially supported by
  7. Sierra Wireless. Use at your own risk.
  8. This driver is free software; you can redistribute it and/or modify
  9. it under the terms of Version 2 of the GNU General Public License as
  10. published by the Free Software Foundation.
  11. Portions based on the option driver by Matthias Urlichs <smurf@smurf.noris.de>
  12. Whom based his on the Keyspan driver by Hugh Blemings <hugh@blemings.org>
  13. */
  14. /* Uncomment to log function calls */
  15. /* #define DEBUG */
  16. #define DRIVER_VERSION "v.1.7.16"
  17. #define DRIVER_AUTHOR "Kevin Lloyd, Elina Pasheva, Matthew Safar, Rory Filer"
  18. #define DRIVER_DESC "USB Driver for Sierra Wireless USB modems"
  19. #include <linux/kernel.h>
  20. #include <linux/jiffies.h>
  21. #include <linux/errno.h>
  22. #include <linux/tty.h>
  23. #include <linux/slab.h>
  24. #include <linux/tty_flip.h>
  25. #include <linux/module.h>
  26. #include <linux/usb.h>
  27. #include <linux/usb/serial.h>
  28. #define SWIMS_USB_REQUEST_SetPower 0x00
  29. #define SWIMS_USB_REQUEST_SetNmea 0x07
  30. #define N_IN_URB_HM 8
  31. #define N_OUT_URB_HM 64
  32. #define N_IN_URB 4
  33. #define N_OUT_URB 4
  34. #define IN_BUFLEN 4096
  35. #define MAX_TRANSFER (PAGE_SIZE - 512)
  36. /* MAX_TRANSFER is chosen so that the VM is not stressed by
  37. allocations > PAGE_SIZE and the number of packets in a page
  38. is an integer 512 is the largest possible packet on EHCI */
  39. static int debug;
  40. static int nmea;
  41. /* Used in interface blacklisting */
  42. struct sierra_iface_info {
  43. const u32 infolen; /* number of interface numbers on blacklist */
  44. const u8 *ifaceinfo; /* pointer to the array holding the numbers */
  45. };
  46. struct sierra_intf_private {
  47. spinlock_t susp_lock;
  48. unsigned int suspended:1;
  49. int in_flight;
  50. };
  51. static int sierra_set_power_state(struct usb_device *udev, __u16 swiState)
  52. {
  53. int result;
  54. dev_dbg(&udev->dev, "%s\n", __func__);
  55. result = usb_control_msg(udev, usb_sndctrlpipe(udev, 0),
  56. SWIMS_USB_REQUEST_SetPower, /* __u8 request */
  57. USB_TYPE_VENDOR, /* __u8 request type */
  58. swiState, /* __u16 value */
  59. 0, /* __u16 index */
  60. NULL, /* void *data */
  61. 0, /* __u16 size */
  62. USB_CTRL_SET_TIMEOUT); /* int timeout */
  63. return result;
  64. }
  65. static int sierra_vsc_set_nmea(struct usb_device *udev, __u16 enable)
  66. {
  67. int result;
  68. dev_dbg(&udev->dev, "%s\n", __func__);
  69. result = usb_control_msg(udev, usb_sndctrlpipe(udev, 0),
  70. SWIMS_USB_REQUEST_SetNmea, /* __u8 request */
  71. USB_TYPE_VENDOR, /* __u8 request type */
  72. enable, /* __u16 value */
  73. 0x0000, /* __u16 index */
  74. NULL, /* void *data */
  75. 0, /* __u16 size */
  76. USB_CTRL_SET_TIMEOUT); /* int timeout */
  77. return result;
  78. }
  79. static int sierra_calc_num_ports(struct usb_serial *serial)
  80. {
  81. int num_ports = 0;
  82. u8 ifnum, numendpoints;
  83. dev_dbg(&serial->dev->dev, "%s\n", __func__);
  84. ifnum = serial->interface->cur_altsetting->desc.bInterfaceNumber;
  85. numendpoints = serial->interface->cur_altsetting->desc.bNumEndpoints;
  86. /* Dummy interface present on some SKUs should be ignored */
  87. if (ifnum == 0x99)
  88. num_ports = 0;
  89. else if (numendpoints <= 3)
  90. num_ports = 1;
  91. else
  92. num_ports = (numendpoints-1)/2;
  93. return num_ports;
  94. }
  95. static int is_blacklisted(const u8 ifnum,
  96. const struct sierra_iface_info *blacklist)
  97. {
  98. const u8 *info;
  99. int i;
  100. if (blacklist) {
  101. info = blacklist->ifaceinfo;
  102. for (i = 0; i < blacklist->infolen; i++) {
  103. if (info[i] == ifnum)
  104. return 1;
  105. }
  106. }
  107. return 0;
  108. }
  109. static int is_himemory(const u8 ifnum,
  110. const struct sierra_iface_info *himemorylist)
  111. {
  112. const u8 *info;
  113. int i;
  114. if (himemorylist) {
  115. info = himemorylist->ifaceinfo;
  116. for (i=0; i < himemorylist->infolen; i++) {
  117. if (info[i] == ifnum)
  118. return 1;
  119. }
  120. }
  121. return 0;
  122. }
  123. static int sierra_calc_interface(struct usb_serial *serial)
  124. {
  125. int interface;
  126. struct usb_interface *p_interface;
  127. struct usb_host_interface *p_host_interface;
  128. dev_dbg(&serial->dev->dev, "%s\n", __func__);
  129. /* Get the interface structure pointer from the serial struct */
  130. p_interface = serial->interface;
  131. /* Get a pointer to the host interface structure */
  132. p_host_interface = p_interface->cur_altsetting;
  133. /* read the interface descriptor for this active altsetting
  134. * to find out the interface number we are on
  135. */
  136. interface = p_host_interface->desc.bInterfaceNumber;
  137. return interface;
  138. }
  139. static int sierra_probe(struct usb_serial *serial,
  140. const struct usb_device_id *id)
  141. {
  142. int result = 0;
  143. struct usb_device *udev;
  144. struct sierra_intf_private *data;
  145. u8 ifnum;
  146. udev = serial->dev;
  147. dev_dbg(&udev->dev, "%s\n", __func__);
  148. ifnum = sierra_calc_interface(serial);
  149. /*
  150. * If this interface supports more than 1 alternate
  151. * select the 2nd one
  152. */
  153. if (serial->interface->num_altsetting == 2) {
  154. dev_dbg(&udev->dev, "Selecting alt setting for interface %d\n",
  155. ifnum);
  156. /* We know the alternate setting is 1 for the MC8785 */
  157. usb_set_interface(udev, ifnum, 1);
  158. }
  159. /* ifnum could have changed - by calling usb_set_interface */
  160. ifnum = sierra_calc_interface(serial);
  161. if (is_blacklisted(ifnum,
  162. (struct sierra_iface_info *)id->driver_info)) {
  163. dev_dbg(&serial->dev->dev,
  164. "Ignoring blacklisted interface #%d\n", ifnum);
  165. return -ENODEV;
  166. }
  167. data = serial->private = kzalloc(sizeof(struct sierra_intf_private), GFP_KERNEL);
  168. if (!data)
  169. return -ENOMEM;
  170. spin_lock_init(&data->susp_lock);
  171. return result;
  172. }
  173. /* interfaces with higher memory requirements */
  174. static const u8 hi_memory_typeA_ifaces[] = { 0, 2 };
  175. static const struct sierra_iface_info typeA_interface_list = {
  176. .infolen = ARRAY_SIZE(hi_memory_typeA_ifaces),
  177. .ifaceinfo = hi_memory_typeA_ifaces,
  178. };
  179. static const u8 hi_memory_typeB_ifaces[] = { 3, 4, 5, 6 };
  180. static const struct sierra_iface_info typeB_interface_list = {
  181. .infolen = ARRAY_SIZE(hi_memory_typeB_ifaces),
  182. .ifaceinfo = hi_memory_typeB_ifaces,
  183. };
  184. /* 'blacklist' of interfaces not served by this driver */
  185. static const u8 direct_ip_non_serial_ifaces[] = { 7, 8, 9, 10, 11, 19, 20 };
  186. static const struct sierra_iface_info direct_ip_interface_blacklist = {
  187. .infolen = ARRAY_SIZE(direct_ip_non_serial_ifaces),
  188. .ifaceinfo = direct_ip_non_serial_ifaces,
  189. };
  190. static const struct usb_device_id id_table[] = {
  191. { USB_DEVICE(0x0F3D, 0x0112) }, /* Airprime/Sierra PC 5220 */
  192. { USB_DEVICE(0x03F0, 0x1B1D) }, /* HP ev2200 a.k.a MC5720 */
  193. { USB_DEVICE(0x03F0, 0x211D) }, /* HP ev2210 a.k.a MC5725 */
  194. { USB_DEVICE(0x03F0, 0x1E1D) }, /* HP hs2300 a.k.a MC8775 */
  195. { USB_DEVICE(0x1199, 0x0017) }, /* Sierra Wireless EM5625 */
  196. { USB_DEVICE(0x1199, 0x0018) }, /* Sierra Wireless MC5720 */
  197. { USB_DEVICE(0x1199, 0x0218) }, /* Sierra Wireless MC5720 */
  198. { USB_DEVICE(0x1199, 0x0020) }, /* Sierra Wireless MC5725 */
  199. { USB_DEVICE(0x1199, 0x0220) }, /* Sierra Wireless MC5725 */
  200. { USB_DEVICE(0x1199, 0x0022) }, /* Sierra Wireless EM5725 */
  201. { USB_DEVICE(0x1199, 0x0024) }, /* Sierra Wireless MC5727 */
  202. { USB_DEVICE(0x1199, 0x0224) }, /* Sierra Wireless MC5727 */
  203. { USB_DEVICE(0x1199, 0x0019) }, /* Sierra Wireless AirCard 595 */
  204. { USB_DEVICE(0x1199, 0x0021) }, /* Sierra Wireless AirCard 597E */
  205. { USB_DEVICE(0x1199, 0x0112) }, /* Sierra Wireless AirCard 580 */
  206. { USB_DEVICE(0x1199, 0x0120) }, /* Sierra Wireless USB Dongle 595U */
  207. { USB_DEVICE(0x1199, 0x0301) }, /* Sierra Wireless USB Dongle 250U */
  208. /* Sierra Wireless C597 */
  209. { USB_DEVICE_AND_INTERFACE_INFO(0x1199, 0x0023, 0xFF, 0xFF, 0xFF) },
  210. /* Sierra Wireless T598 */
  211. { USB_DEVICE_AND_INTERFACE_INFO(0x1199, 0x0025, 0xFF, 0xFF, 0xFF) },
  212. { USB_DEVICE(0x1199, 0x0026) }, /* Sierra Wireless T11 */
  213. { USB_DEVICE(0x1199, 0x0027) }, /* Sierra Wireless AC402 */
  214. { USB_DEVICE(0x1199, 0x0028) }, /* Sierra Wireless MC5728 */
  215. { USB_DEVICE(0x1199, 0x0029) }, /* Sierra Wireless Device */
  216. { USB_DEVICE(0x1199, 0x6802) }, /* Sierra Wireless MC8755 */
  217. { USB_DEVICE(0x1199, 0x6803) }, /* Sierra Wireless MC8765 */
  218. { USB_DEVICE(0x1199, 0x6804) }, /* Sierra Wireless MC8755 */
  219. { USB_DEVICE(0x1199, 0x6805) }, /* Sierra Wireless MC8765 */
  220. { USB_DEVICE(0x1199, 0x6808) }, /* Sierra Wireless MC8755 */
  221. { USB_DEVICE(0x1199, 0x6809) }, /* Sierra Wireless MC8765 */
  222. { USB_DEVICE(0x1199, 0x6812) }, /* Sierra Wireless MC8775 & AC 875U */
  223. { USB_DEVICE(0x1199, 0x6813) }, /* Sierra Wireless MC8775 */
  224. { USB_DEVICE(0x1199, 0x6815) }, /* Sierra Wireless MC8775 */
  225. { USB_DEVICE(0x1199, 0x6816) }, /* Sierra Wireless MC8775 */
  226. { USB_DEVICE(0x1199, 0x6820) }, /* Sierra Wireless AirCard 875 */
  227. { USB_DEVICE(0x1199, 0x6821) }, /* Sierra Wireless AirCard 875U */
  228. { USB_DEVICE(0x1199, 0x6822) }, /* Sierra Wireless AirCard 875E */
  229. { USB_DEVICE(0x1199, 0x6832) }, /* Sierra Wireless MC8780 */
  230. { USB_DEVICE(0x1199, 0x6833) }, /* Sierra Wireless MC8781 */
  231. { USB_DEVICE(0x1199, 0x6834) }, /* Sierra Wireless MC8780 */
  232. { USB_DEVICE(0x1199, 0x6835) }, /* Sierra Wireless MC8781 */
  233. { USB_DEVICE(0x1199, 0x6838) }, /* Sierra Wireless MC8780 */
  234. { USB_DEVICE(0x1199, 0x6839) }, /* Sierra Wireless MC8781 */
  235. { USB_DEVICE(0x1199, 0x683A) }, /* Sierra Wireless MC8785 */
  236. { USB_DEVICE(0x1199, 0x683B) }, /* Sierra Wireless MC8785 Composite */
  237. /* Sierra Wireless MC8790, MC8791, MC8792 Composite */
  238. { USB_DEVICE(0x1199, 0x683C) },
  239. { USB_DEVICE(0x1199, 0x683D) }, /* Sierra Wireless MC8791 Composite */
  240. /* Sierra Wireless MC8790, MC8791, MC8792 */
  241. { USB_DEVICE(0x1199, 0x683E) },
  242. { USB_DEVICE(0x1199, 0x6850) }, /* Sierra Wireless AirCard 880 */
  243. { USB_DEVICE(0x1199, 0x6851) }, /* Sierra Wireless AirCard 881 */
  244. { USB_DEVICE(0x1199, 0x6852) }, /* Sierra Wireless AirCard 880 E */
  245. { USB_DEVICE(0x1199, 0x6853) }, /* Sierra Wireless AirCard 881 E */
  246. { USB_DEVICE(0x1199, 0x6855) }, /* Sierra Wireless AirCard 880 U */
  247. { USB_DEVICE(0x1199, 0x6856) }, /* Sierra Wireless AirCard 881 U */
  248. { USB_DEVICE(0x1199, 0x6859) }, /* Sierra Wireless AirCard 885 E */
  249. { USB_DEVICE(0x1199, 0x685A) }, /* Sierra Wireless AirCard 885 E */
  250. /* Sierra Wireless C885 */
  251. { USB_DEVICE_AND_INTERFACE_INFO(0x1199, 0x6880, 0xFF, 0xFF, 0xFF)},
  252. /* Sierra Wireless C888, Air Card 501, USB 303, USB 304 */
  253. { USB_DEVICE_AND_INTERFACE_INFO(0x1199, 0x6890, 0xFF, 0xFF, 0xFF)},
  254. /* Sierra Wireless C22/C33 */
  255. { USB_DEVICE_AND_INTERFACE_INFO(0x1199, 0x6891, 0xFF, 0xFF, 0xFF)},
  256. /* Sierra Wireless HSPA Non-Composite Device */
  257. { USB_DEVICE_AND_INTERFACE_INFO(0x1199, 0x6892, 0xFF, 0xFF, 0xFF)},
  258. { USB_DEVICE(0x1199, 0x6893) }, /* Sierra Wireless Device */
  259. { USB_DEVICE(0x1199, 0x68A2), /* Sierra Wireless MC77xx in QMI mode */
  260. .driver_info = (kernel_ulong_t)&direct_ip_interface_blacklist
  261. },
  262. { USB_DEVICE(0x1199, 0x68A3), /* Sierra Wireless Direct IP modems */
  263. .driver_info = (kernel_ulong_t)&direct_ip_interface_blacklist
  264. },
  265. { USB_DEVICE(0x0f3d, 0x68A3), /* Airprime/Sierra Wireless Direct IP modems */
  266. .driver_info = (kernel_ulong_t)&direct_ip_interface_blacklist
  267. },
  268. { USB_DEVICE(0x413C, 0x08133) }, /* Dell Computer Corp. Wireless 5720 VZW Mobile Broadband (EVDO Rev-A) Minicard GPS Port */
  269. { }
  270. };
  271. MODULE_DEVICE_TABLE(usb, id_table);
  272. struct sierra_port_private {
  273. spinlock_t lock; /* lock the structure */
  274. int outstanding_urbs; /* number of out urbs in flight */
  275. struct usb_anchor active;
  276. struct usb_anchor delayed;
  277. int num_out_urbs;
  278. int num_in_urbs;
  279. /* Input endpoints and buffers for this port */
  280. struct urb *in_urbs[N_IN_URB_HM];
  281. /* Settings for the port */
  282. int rts_state; /* Handshaking pins (outputs) */
  283. int dtr_state;
  284. int cts_state; /* Handshaking pins (inputs) */
  285. int dsr_state;
  286. int dcd_state;
  287. int ri_state;
  288. unsigned int opened:1;
  289. };
  290. static int sierra_send_setup(struct usb_serial_port *port)
  291. {
  292. struct usb_serial *serial = port->serial;
  293. struct sierra_port_private *portdata;
  294. __u16 interface = 0;
  295. int val = 0;
  296. int do_send = 0;
  297. int retval;
  298. dev_dbg(&port->dev, "%s\n", __func__);
  299. portdata = usb_get_serial_port_data(port);
  300. if (portdata->dtr_state)
  301. val |= 0x01;
  302. if (portdata->rts_state)
  303. val |= 0x02;
  304. /* If composite device then properly report interface */
  305. if (serial->num_ports == 1) {
  306. interface = sierra_calc_interface(serial);
  307. /* Control message is sent only to interfaces with
  308. * interrupt_in endpoints
  309. */
  310. if (port->interrupt_in_urb) {
  311. /* send control message */
  312. do_send = 1;
  313. }
  314. }
  315. /* Otherwise the need to do non-composite mapping */
  316. else {
  317. if (port->bulk_out_endpointAddress == 2)
  318. interface = 0;
  319. else if (port->bulk_out_endpointAddress == 4)
  320. interface = 1;
  321. else if (port->bulk_out_endpointAddress == 5)
  322. interface = 2;
  323. do_send = 1;
  324. }
  325. if (!do_send)
  326. return 0;
  327. retval = usb_autopm_get_interface(serial->interface);
  328. if (retval < 0)
  329. return retval;
  330. retval = usb_control_msg(serial->dev, usb_rcvctrlpipe(serial->dev, 0),
  331. 0x22, 0x21, val, interface, NULL, 0, USB_CTRL_SET_TIMEOUT);
  332. usb_autopm_put_interface(serial->interface);
  333. return retval;
  334. }
  335. static void sierra_set_termios(struct tty_struct *tty,
  336. struct usb_serial_port *port, struct ktermios *old_termios)
  337. {
  338. dev_dbg(&port->dev, "%s\n", __func__);
  339. tty_termios_copy_hw(tty->termios, old_termios);
  340. sierra_send_setup(port);
  341. }
  342. static int sierra_tiocmget(struct tty_struct *tty)
  343. {
  344. struct usb_serial_port *port = tty->driver_data;
  345. unsigned int value;
  346. struct sierra_port_private *portdata;
  347. dev_dbg(&port->dev, "%s\n", __func__);
  348. portdata = usb_get_serial_port_data(port);
  349. value = ((portdata->rts_state) ? TIOCM_RTS : 0) |
  350. ((portdata->dtr_state) ? TIOCM_DTR : 0) |
  351. ((portdata->cts_state) ? TIOCM_CTS : 0) |
  352. ((portdata->dsr_state) ? TIOCM_DSR : 0) |
  353. ((portdata->dcd_state) ? TIOCM_CAR : 0) |
  354. ((portdata->ri_state) ? TIOCM_RNG : 0);
  355. return value;
  356. }
  357. static int sierra_tiocmset(struct tty_struct *tty,
  358. unsigned int set, unsigned int clear)
  359. {
  360. struct usb_serial_port *port = tty->driver_data;
  361. struct sierra_port_private *portdata;
  362. portdata = usb_get_serial_port_data(port);
  363. if (set & TIOCM_RTS)
  364. portdata->rts_state = 1;
  365. if (set & TIOCM_DTR)
  366. portdata->dtr_state = 1;
  367. if (clear & TIOCM_RTS)
  368. portdata->rts_state = 0;
  369. if (clear & TIOCM_DTR)
  370. portdata->dtr_state = 0;
  371. return sierra_send_setup(port);
  372. }
  373. static void sierra_release_urb(struct urb *urb)
  374. {
  375. struct usb_serial_port *port;
  376. if (urb) {
  377. port = urb->context;
  378. dev_dbg(&port->dev, "%s: %p\n", __func__, urb);
  379. kfree(urb->transfer_buffer);
  380. usb_free_urb(urb);
  381. }
  382. }
  383. static void sierra_outdat_callback(struct urb *urb)
  384. {
  385. struct usb_serial_port *port = urb->context;
  386. struct sierra_port_private *portdata = usb_get_serial_port_data(port);
  387. struct sierra_intf_private *intfdata;
  388. int status = urb->status;
  389. dev_dbg(&port->dev, "%s - port %d\n", __func__, port->number);
  390. intfdata = port->serial->private;
  391. /* free up the transfer buffer, as usb_free_urb() does not do this */
  392. kfree(urb->transfer_buffer);
  393. usb_autopm_put_interface_async(port->serial->interface);
  394. if (status)
  395. dev_dbg(&port->dev, "%s - nonzero write bulk status "
  396. "received: %d\n", __func__, status);
  397. spin_lock(&portdata->lock);
  398. --portdata->outstanding_urbs;
  399. spin_unlock(&portdata->lock);
  400. spin_lock(&intfdata->susp_lock);
  401. --intfdata->in_flight;
  402. spin_unlock(&intfdata->susp_lock);
  403. usb_serial_port_softint(port);
  404. }
  405. /* Write */
  406. static int sierra_write(struct tty_struct *tty, struct usb_serial_port *port,
  407. const unsigned char *buf, int count)
  408. {
  409. struct sierra_port_private *portdata;
  410. struct sierra_intf_private *intfdata;
  411. struct usb_serial *serial = port->serial;
  412. unsigned long flags;
  413. unsigned char *buffer;
  414. struct urb *urb;
  415. size_t writesize = min((size_t)count, (size_t)MAX_TRANSFER);
  416. int retval = 0;
  417. /* verify that we actually have some data to write */
  418. if (count == 0)
  419. return 0;
  420. portdata = usb_get_serial_port_data(port);
  421. intfdata = serial->private;
  422. dev_dbg(&port->dev, "%s: write (%zd bytes)\n", __func__, writesize);
  423. spin_lock_irqsave(&portdata->lock, flags);
  424. dev_dbg(&port->dev, "%s - outstanding_urbs: %d\n", __func__,
  425. portdata->outstanding_urbs);
  426. if (portdata->outstanding_urbs > portdata->num_out_urbs) {
  427. spin_unlock_irqrestore(&portdata->lock, flags);
  428. dev_dbg(&port->dev, "%s - write limit hit\n", __func__);
  429. return 0;
  430. }
  431. portdata->outstanding_urbs++;
  432. dev_dbg(&port->dev, "%s - 1, outstanding_urbs: %d\n", __func__,
  433. portdata->outstanding_urbs);
  434. spin_unlock_irqrestore(&portdata->lock, flags);
  435. retval = usb_autopm_get_interface_async(serial->interface);
  436. if (retval < 0) {
  437. spin_lock_irqsave(&portdata->lock, flags);
  438. portdata->outstanding_urbs--;
  439. spin_unlock_irqrestore(&portdata->lock, flags);
  440. goto error_simple;
  441. }
  442. buffer = kmalloc(writesize, GFP_ATOMIC);
  443. if (!buffer) {
  444. dev_err(&port->dev, "out of memory\n");
  445. retval = -ENOMEM;
  446. goto error_no_buffer;
  447. }
  448. urb = usb_alloc_urb(0, GFP_ATOMIC);
  449. if (!urb) {
  450. dev_err(&port->dev, "no more free urbs\n");
  451. retval = -ENOMEM;
  452. goto error_no_urb;
  453. }
  454. memcpy(buffer, buf, writesize);
  455. usb_serial_debug_data(debug, &port->dev, __func__, writesize, buffer);
  456. usb_fill_bulk_urb(urb, serial->dev,
  457. usb_sndbulkpipe(serial->dev,
  458. port->bulk_out_endpointAddress),
  459. buffer, writesize, sierra_outdat_callback, port);
  460. /* Handle the need to send a zero length packet */
  461. urb->transfer_flags |= URB_ZERO_PACKET;
  462. spin_lock_irqsave(&intfdata->susp_lock, flags);
  463. if (intfdata->suspended) {
  464. usb_anchor_urb(urb, &portdata->delayed);
  465. spin_unlock_irqrestore(&intfdata->susp_lock, flags);
  466. goto skip_power;
  467. } else {
  468. usb_anchor_urb(urb, &portdata->active);
  469. }
  470. /* send it down the pipe */
  471. retval = usb_submit_urb(urb, GFP_ATOMIC);
  472. if (retval) {
  473. usb_unanchor_urb(urb);
  474. spin_unlock_irqrestore(&intfdata->susp_lock, flags);
  475. dev_err(&port->dev, "%s - usb_submit_urb(write bulk) failed "
  476. "with status = %d\n", __func__, retval);
  477. goto error;
  478. } else {
  479. intfdata->in_flight++;
  480. spin_unlock_irqrestore(&intfdata->susp_lock, flags);
  481. }
  482. skip_power:
  483. /* we are done with this urb, so let the host driver
  484. * really free it when it is finished with it */
  485. usb_free_urb(urb);
  486. return writesize;
  487. error:
  488. usb_free_urb(urb);
  489. error_no_urb:
  490. kfree(buffer);
  491. error_no_buffer:
  492. spin_lock_irqsave(&portdata->lock, flags);
  493. --portdata->outstanding_urbs;
  494. dev_dbg(&port->dev, "%s - 2. outstanding_urbs: %d\n", __func__,
  495. portdata->outstanding_urbs);
  496. spin_unlock_irqrestore(&portdata->lock, flags);
  497. usb_autopm_put_interface_async(serial->interface);
  498. error_simple:
  499. return retval;
  500. }
  501. static void sierra_indat_callback(struct urb *urb)
  502. {
  503. int err;
  504. int endpoint;
  505. struct usb_serial_port *port;
  506. struct tty_struct *tty;
  507. unsigned char *data = urb->transfer_buffer;
  508. int status = urb->status;
  509. endpoint = usb_pipeendpoint(urb->pipe);
  510. port = urb->context;
  511. dev_dbg(&port->dev, "%s: %p\n", __func__, urb);
  512. if (status) {
  513. dev_dbg(&port->dev, "%s: nonzero status: %d on"
  514. " endpoint %02x\n", __func__, status, endpoint);
  515. } else {
  516. if (urb->actual_length) {
  517. tty = tty_port_tty_get(&port->port);
  518. if (tty) {
  519. tty_insert_flip_string(tty, data,
  520. urb->actual_length);
  521. tty_flip_buffer_push(tty);
  522. tty_kref_put(tty);
  523. usb_serial_debug_data(debug, &port->dev,
  524. __func__, urb->actual_length, data);
  525. }
  526. } else {
  527. dev_dbg(&port->dev, "%s: empty read urb"
  528. " received\n", __func__);
  529. }
  530. }
  531. /* Resubmit urb so we continue receiving */
  532. if (status != -ESHUTDOWN && status != -EPERM) {
  533. usb_mark_last_busy(port->serial->dev);
  534. err = usb_submit_urb(urb, GFP_ATOMIC);
  535. if (err && err != -EPERM)
  536. dev_err(&port->dev, "resubmit read urb failed."
  537. "(%d)\n", err);
  538. }
  539. }
  540. static void sierra_instat_callback(struct urb *urb)
  541. {
  542. int err;
  543. int status = urb->status;
  544. struct usb_serial_port *port = urb->context;
  545. struct sierra_port_private *portdata = usb_get_serial_port_data(port);
  546. struct usb_serial *serial = port->serial;
  547. dev_dbg(&port->dev, "%s: urb %p port %p has data %p\n", __func__,
  548. urb, port, portdata);
  549. if (status == 0) {
  550. struct usb_ctrlrequest *req_pkt =
  551. (struct usb_ctrlrequest *)urb->transfer_buffer;
  552. if (!req_pkt) {
  553. dev_dbg(&port->dev, "%s: NULL req_pkt\n",
  554. __func__);
  555. return;
  556. }
  557. if ((req_pkt->bRequestType == 0xA1) &&
  558. (req_pkt->bRequest == 0x20)) {
  559. int old_dcd_state;
  560. unsigned char signals = *((unsigned char *)
  561. urb->transfer_buffer +
  562. sizeof(struct usb_ctrlrequest));
  563. struct tty_struct *tty;
  564. dev_dbg(&port->dev, "%s: signal x%x\n", __func__,
  565. signals);
  566. old_dcd_state = portdata->dcd_state;
  567. portdata->cts_state = 1;
  568. portdata->dcd_state = ((signals & 0x01) ? 1 : 0);
  569. portdata->dsr_state = ((signals & 0x02) ? 1 : 0);
  570. portdata->ri_state = ((signals & 0x08) ? 1 : 0);
  571. tty = tty_port_tty_get(&port->port);
  572. if (tty && !C_CLOCAL(tty) &&
  573. old_dcd_state && !portdata->dcd_state)
  574. tty_hangup(tty);
  575. tty_kref_put(tty);
  576. } else {
  577. dev_dbg(&port->dev, "%s: type %x req %x\n",
  578. __func__, req_pkt->bRequestType,
  579. req_pkt->bRequest);
  580. }
  581. } else
  582. dev_dbg(&port->dev, "%s: error %d\n", __func__, status);
  583. /* Resubmit urb so we continue receiving IRQ data */
  584. if (status != -ESHUTDOWN && status != -ENOENT) {
  585. usb_mark_last_busy(serial->dev);
  586. urb->dev = serial->dev;
  587. err = usb_submit_urb(urb, GFP_ATOMIC);
  588. if (err && err != -EPERM)
  589. dev_err(&port->dev, "%s: resubmit intr urb "
  590. "failed. (%d)\n", __func__, err);
  591. }
  592. }
  593. static int sierra_write_room(struct tty_struct *tty)
  594. {
  595. struct usb_serial_port *port = tty->driver_data;
  596. struct sierra_port_private *portdata = usb_get_serial_port_data(port);
  597. unsigned long flags;
  598. dev_dbg(&port->dev, "%s - port %d\n", __func__, port->number);
  599. /* try to give a good number back based on if we have any free urbs at
  600. * this point in time */
  601. spin_lock_irqsave(&portdata->lock, flags);
  602. if (portdata->outstanding_urbs > (portdata->num_out_urbs * 2) / 3) {
  603. spin_unlock_irqrestore(&portdata->lock, flags);
  604. dev_dbg(&port->dev, "%s - write limit hit\n", __func__);
  605. return 0;
  606. }
  607. spin_unlock_irqrestore(&portdata->lock, flags);
  608. return 2048;
  609. }
  610. static void sierra_stop_rx_urbs(struct usb_serial_port *port)
  611. {
  612. int i;
  613. struct sierra_port_private *portdata = usb_get_serial_port_data(port);
  614. for (i = 0; i < portdata->num_in_urbs; i++)
  615. usb_kill_urb(portdata->in_urbs[i]);
  616. usb_kill_urb(port->interrupt_in_urb);
  617. }
  618. static int sierra_submit_rx_urbs(struct usb_serial_port *port, gfp_t mem_flags)
  619. {
  620. int ok_cnt;
  621. int err = -EINVAL;
  622. int i;
  623. struct urb *urb;
  624. struct sierra_port_private *portdata = usb_get_serial_port_data(port);
  625. ok_cnt = 0;
  626. for (i = 0; i < portdata->num_in_urbs; i++) {
  627. urb = portdata->in_urbs[i];
  628. if (!urb)
  629. continue;
  630. err = usb_submit_urb(urb, mem_flags);
  631. if (err) {
  632. dev_err(&port->dev, "%s: submit urb failed: %d\n",
  633. __func__, err);
  634. } else {
  635. ok_cnt++;
  636. }
  637. }
  638. if (ok_cnt && port->interrupt_in_urb) {
  639. err = usb_submit_urb(port->interrupt_in_urb, mem_flags);
  640. if (err) {
  641. dev_err(&port->dev, "%s: submit intr urb failed: %d\n",
  642. __func__, err);
  643. }
  644. }
  645. if (ok_cnt > 0) /* at least one rx urb submitted */
  646. return 0;
  647. else
  648. return err;
  649. }
  650. static struct urb *sierra_setup_urb(struct usb_serial *serial, int endpoint,
  651. int dir, void *ctx, int len,
  652. gfp_t mem_flags,
  653. usb_complete_t callback)
  654. {
  655. struct urb *urb;
  656. u8 *buf;
  657. if (endpoint == -1)
  658. return NULL;
  659. urb = usb_alloc_urb(0, mem_flags);
  660. if (urb == NULL) {
  661. dev_dbg(&serial->dev->dev, "%s: alloc for endpoint %d failed\n",
  662. __func__, endpoint);
  663. return NULL;
  664. }
  665. buf = kmalloc(len, mem_flags);
  666. if (buf) {
  667. /* Fill URB using supplied data */
  668. usb_fill_bulk_urb(urb, serial->dev,
  669. usb_sndbulkpipe(serial->dev, endpoint) | dir,
  670. buf, len, callback, ctx);
  671. /* debug */
  672. dev_dbg(&serial->dev->dev, "%s %c u : %p d:%p\n", __func__,
  673. dir == USB_DIR_IN ? 'i' : 'o', urb, buf);
  674. } else {
  675. dev_dbg(&serial->dev->dev, "%s %c u:%p d:%p\n", __func__,
  676. dir == USB_DIR_IN ? 'i' : 'o', urb, buf);
  677. sierra_release_urb(urb);
  678. urb = NULL;
  679. }
  680. return urb;
  681. }
  682. static void sierra_close(struct usb_serial_port *port)
  683. {
  684. int i;
  685. struct usb_serial *serial = port->serial;
  686. struct sierra_port_private *portdata;
  687. struct sierra_intf_private *intfdata = port->serial->private;
  688. dev_dbg(&port->dev, "%s\n", __func__);
  689. portdata = usb_get_serial_port_data(port);
  690. portdata->rts_state = 0;
  691. portdata->dtr_state = 0;
  692. if (serial->dev) {
  693. mutex_lock(&serial->disc_mutex);
  694. if (!serial->disconnected) {
  695. serial->interface->needs_remote_wakeup = 0;
  696. /* odd error handling due to pm counters */
  697. if (!usb_autopm_get_interface(serial->interface))
  698. sierra_send_setup(port);
  699. else
  700. usb_autopm_get_interface_no_resume(serial->interface);
  701. }
  702. mutex_unlock(&serial->disc_mutex);
  703. spin_lock_irq(&intfdata->susp_lock);
  704. portdata->opened = 0;
  705. spin_unlock_irq(&intfdata->susp_lock);
  706. /* Stop reading urbs */
  707. sierra_stop_rx_urbs(port);
  708. /* .. and release them */
  709. for (i = 0; i < portdata->num_in_urbs; i++) {
  710. sierra_release_urb(portdata->in_urbs[i]);
  711. portdata->in_urbs[i] = NULL;
  712. }
  713. }
  714. }
  715. static int sierra_open(struct tty_struct *tty, struct usb_serial_port *port)
  716. {
  717. struct sierra_port_private *portdata;
  718. struct usb_serial *serial = port->serial;
  719. struct sierra_intf_private *intfdata = serial->private;
  720. int i;
  721. int err;
  722. int endpoint;
  723. struct urb *urb;
  724. portdata = usb_get_serial_port_data(port);
  725. dev_dbg(&port->dev, "%s\n", __func__);
  726. /* Set some sane defaults */
  727. portdata->rts_state = 1;
  728. portdata->dtr_state = 1;
  729. endpoint = port->bulk_in_endpointAddress;
  730. for (i = 0; i < portdata->num_in_urbs; i++) {
  731. urb = sierra_setup_urb(serial, endpoint, USB_DIR_IN, port,
  732. IN_BUFLEN, GFP_KERNEL,
  733. sierra_indat_callback);
  734. portdata->in_urbs[i] = urb;
  735. }
  736. /* clear halt condition */
  737. usb_clear_halt(serial->dev,
  738. usb_sndbulkpipe(serial->dev, endpoint) | USB_DIR_IN);
  739. err = sierra_submit_rx_urbs(port, GFP_KERNEL);
  740. if (err) {
  741. /* get rid of everything as in close */
  742. sierra_close(port);
  743. /* restore balance for autopm */
  744. if (!serial->disconnected)
  745. usb_autopm_put_interface(serial->interface);
  746. return err;
  747. }
  748. sierra_send_setup(port);
  749. serial->interface->needs_remote_wakeup = 1;
  750. spin_lock_irq(&intfdata->susp_lock);
  751. portdata->opened = 1;
  752. spin_unlock_irq(&intfdata->susp_lock);
  753. usb_autopm_put_interface(serial->interface);
  754. return 0;
  755. }
  756. static void sierra_dtr_rts(struct usb_serial_port *port, int on)
  757. {
  758. struct usb_serial *serial = port->serial;
  759. struct sierra_port_private *portdata;
  760. portdata = usb_get_serial_port_data(port);
  761. portdata->rts_state = on;
  762. portdata->dtr_state = on;
  763. if (serial->dev) {
  764. mutex_lock(&serial->disc_mutex);
  765. if (!serial->disconnected)
  766. sierra_send_setup(port);
  767. mutex_unlock(&serial->disc_mutex);
  768. }
  769. }
  770. static int sierra_startup(struct usb_serial *serial)
  771. {
  772. struct usb_serial_port *port;
  773. struct sierra_port_private *portdata;
  774. struct sierra_iface_info *himemoryp = NULL;
  775. int i;
  776. u8 ifnum;
  777. dev_dbg(&serial->dev->dev, "%s\n", __func__);
  778. /* Set Device mode to D0 */
  779. sierra_set_power_state(serial->dev, 0x0000);
  780. /* Check NMEA and set */
  781. if (nmea)
  782. sierra_vsc_set_nmea(serial->dev, 1);
  783. /* Now setup per port private data */
  784. for (i = 0; i < serial->num_ports; i++) {
  785. port = serial->port[i];
  786. portdata = kzalloc(sizeof(*portdata), GFP_KERNEL);
  787. if (!portdata) {
  788. dev_dbg(&port->dev, "%s: kmalloc for "
  789. "sierra_port_private (%d) failed!\n",
  790. __func__, i);
  791. return -ENOMEM;
  792. }
  793. spin_lock_init(&portdata->lock);
  794. init_usb_anchor(&portdata->active);
  795. init_usb_anchor(&portdata->delayed);
  796. ifnum = i;
  797. /* Assume low memory requirements */
  798. portdata->num_out_urbs = N_OUT_URB;
  799. portdata->num_in_urbs = N_IN_URB;
  800. /* Determine actual memory requirements */
  801. if (serial->num_ports == 1) {
  802. /* Get interface number for composite device */
  803. ifnum = sierra_calc_interface(serial);
  804. himemoryp =
  805. (struct sierra_iface_info *)&typeB_interface_list;
  806. if (is_himemory(ifnum, himemoryp)) {
  807. portdata->num_out_urbs = N_OUT_URB_HM;
  808. portdata->num_in_urbs = N_IN_URB_HM;
  809. }
  810. }
  811. else {
  812. himemoryp =
  813. (struct sierra_iface_info *)&typeA_interface_list;
  814. if (is_himemory(i, himemoryp)) {
  815. portdata->num_out_urbs = N_OUT_URB_HM;
  816. portdata->num_in_urbs = N_IN_URB_HM;
  817. }
  818. }
  819. dev_dbg(&serial->dev->dev,
  820. "Memory usage (urbs) interface #%d, in=%d, out=%d\n",
  821. ifnum,portdata->num_in_urbs, portdata->num_out_urbs );
  822. /* Set the port private data pointer */
  823. usb_set_serial_port_data(port, portdata);
  824. }
  825. return 0;
  826. }
  827. static void sierra_release(struct usb_serial *serial)
  828. {
  829. int i;
  830. struct usb_serial_port *port;
  831. struct sierra_port_private *portdata;
  832. dev_dbg(&serial->dev->dev, "%s\n", __func__);
  833. for (i = 0; i < serial->num_ports; ++i) {
  834. port = serial->port[i];
  835. if (!port)
  836. continue;
  837. portdata = usb_get_serial_port_data(port);
  838. if (!portdata)
  839. continue;
  840. kfree(portdata);
  841. }
  842. }
  843. #ifdef CONFIG_PM
  844. static void stop_read_write_urbs(struct usb_serial *serial)
  845. {
  846. int i;
  847. struct usb_serial_port *port;
  848. struct sierra_port_private *portdata;
  849. /* Stop reading/writing urbs */
  850. for (i = 0; i < serial->num_ports; ++i) {
  851. port = serial->port[i];
  852. portdata = usb_get_serial_port_data(port);
  853. sierra_stop_rx_urbs(port);
  854. usb_kill_anchored_urbs(&portdata->active);
  855. }
  856. }
  857. static int sierra_suspend(struct usb_serial *serial, pm_message_t message)
  858. {
  859. struct sierra_intf_private *intfdata;
  860. int b;
  861. if (message.event & PM_EVENT_AUTO) {
  862. intfdata = serial->private;
  863. spin_lock_irq(&intfdata->susp_lock);
  864. b = intfdata->in_flight;
  865. if (b) {
  866. spin_unlock_irq(&intfdata->susp_lock);
  867. return -EBUSY;
  868. } else {
  869. intfdata->suspended = 1;
  870. spin_unlock_irq(&intfdata->susp_lock);
  871. }
  872. }
  873. stop_read_write_urbs(serial);
  874. return 0;
  875. }
  876. static int sierra_resume(struct usb_serial *serial)
  877. {
  878. struct usb_serial_port *port;
  879. struct sierra_intf_private *intfdata = serial->private;
  880. struct sierra_port_private *portdata;
  881. struct urb *urb;
  882. int ec = 0;
  883. int i, err;
  884. spin_lock_irq(&intfdata->susp_lock);
  885. for (i = 0; i < serial->num_ports; i++) {
  886. port = serial->port[i];
  887. portdata = usb_get_serial_port_data(port);
  888. while ((urb = usb_get_from_anchor(&portdata->delayed))) {
  889. usb_anchor_urb(urb, &portdata->active);
  890. intfdata->in_flight++;
  891. err = usb_submit_urb(urb, GFP_ATOMIC);
  892. if (err < 0) {
  893. intfdata->in_flight--;
  894. usb_unanchor_urb(urb);
  895. usb_scuttle_anchored_urbs(&portdata->delayed);
  896. break;
  897. }
  898. }
  899. if (portdata->opened) {
  900. err = sierra_submit_rx_urbs(port, GFP_ATOMIC);
  901. if (err)
  902. ec++;
  903. }
  904. }
  905. intfdata->suspended = 0;
  906. spin_unlock_irq(&intfdata->susp_lock);
  907. return ec ? -EIO : 0;
  908. }
  909. static int sierra_reset_resume(struct usb_interface *intf)
  910. {
  911. struct usb_serial *serial = usb_get_intfdata(intf);
  912. dev_err(&serial->dev->dev, "%s\n", __func__);
  913. return usb_serial_resume(intf);
  914. }
  915. #else
  916. #define sierra_suspend NULL
  917. #define sierra_resume NULL
  918. #define sierra_reset_resume NULL
  919. #endif
  920. static struct usb_driver sierra_driver = {
  921. .name = "sierra",
  922. .probe = usb_serial_probe,
  923. .disconnect = usb_serial_disconnect,
  924. .suspend = usb_serial_suspend,
  925. .resume = usb_serial_resume,
  926. .reset_resume = sierra_reset_resume,
  927. .id_table = id_table,
  928. .no_dynamic_id = 1,
  929. .supports_autosuspend = 1,
  930. };
  931. static struct usb_serial_driver sierra_device = {
  932. .driver = {
  933. .owner = THIS_MODULE,
  934. .name = "sierra",
  935. },
  936. .description = "Sierra USB modem",
  937. .id_table = id_table,
  938. .usb_driver = &sierra_driver,
  939. .calc_num_ports = sierra_calc_num_ports,
  940. .probe = sierra_probe,
  941. .open = sierra_open,
  942. .close = sierra_close,
  943. .dtr_rts = sierra_dtr_rts,
  944. .write = sierra_write,
  945. .write_room = sierra_write_room,
  946. .set_termios = sierra_set_termios,
  947. .tiocmget = sierra_tiocmget,
  948. .tiocmset = sierra_tiocmset,
  949. .attach = sierra_startup,
  950. .release = sierra_release,
  951. .suspend = sierra_suspend,
  952. .resume = sierra_resume,
  953. .read_int_callback = sierra_instat_callback,
  954. };
  955. /* Functions used by new usb-serial code. */
  956. static int __init sierra_init(void)
  957. {
  958. int retval;
  959. retval = usb_serial_register(&sierra_device);
  960. if (retval)
  961. goto failed_device_register;
  962. retval = usb_register(&sierra_driver);
  963. if (retval)
  964. goto failed_driver_register;
  965. printk(KERN_INFO KBUILD_MODNAME ": " DRIVER_VERSION ":"
  966. DRIVER_DESC "\n");
  967. return 0;
  968. failed_driver_register:
  969. usb_serial_deregister(&sierra_device);
  970. failed_device_register:
  971. return retval;
  972. }
  973. static void __exit sierra_exit(void)
  974. {
  975. usb_deregister(&sierra_driver);
  976. usb_serial_deregister(&sierra_device);
  977. }
  978. module_init(sierra_init);
  979. module_exit(sierra_exit);
  980. MODULE_AUTHOR(DRIVER_AUTHOR);
  981. MODULE_DESCRIPTION(DRIVER_DESC);
  982. MODULE_VERSION(DRIVER_VERSION);
  983. MODULE_LICENSE("GPL");
  984. module_param(nmea, bool, S_IRUGO | S_IWUSR);
  985. MODULE_PARM_DESC(nmea, "NMEA streaming");
  986. module_param(debug, bool, S_IRUGO | S_IWUSR);
  987. MODULE_PARM_DESC(debug, "Debug messages");