xref: /linux/drivers/usb/serial/qcserial.c (revision b889fcf63cb62e7fdb7816565e28f44dbe4a76a5)
1 /*
2  * Qualcomm Serial USB driver
3  *
4  *	Copyright (c) 2008 QUALCOMM Incorporated.
5  *	Copyright (c) 2009 Greg Kroah-Hartman <gregkh@suse.de>
6  *	Copyright (c) 2009 Novell Inc.
7  *
8  *	This program is free software; you can redistribute it and/or
9  *	modify it under the terms of the GNU General Public License version
10  *	2 as published by the Free Software Foundation.
11  *
12  */
13 
14 #include <linux/tty.h>
15 #include <linux/tty_flip.h>
16 #include <linux/module.h>
17 #include <linux/usb.h>
18 #include <linux/usb/serial.h>
19 #include <linux/slab.h>
20 #include "usb-wwan.h"
21 
22 #define DRIVER_AUTHOR "Qualcomm Inc"
23 #define DRIVER_DESC "Qualcomm USB Serial driver"
24 
25 #define DEVICE_G1K(v, p) \
26 	USB_DEVICE(v, p), .driver_info = 1
27 
28 static const struct usb_device_id id_table[] = {
29 	/* Gobi 1000 devices */
30 	{DEVICE_G1K(0x05c6, 0x9211)},	/* Acer Gobi QDL device */
31 	{DEVICE_G1K(0x05c6, 0x9212)},	/* Acer Gobi Modem Device */
32 	{DEVICE_G1K(0x03f0, 0x1f1d)},	/* HP un2400 Gobi Modem Device */
33 	{DEVICE_G1K(0x03f0, 0x201d)},	/* HP un2400 Gobi QDL Device */
34 	{DEVICE_G1K(0x04da, 0x250d)},	/* Panasonic Gobi Modem device */
35 	{DEVICE_G1K(0x04da, 0x250c)},	/* Panasonic Gobi QDL device */
36 	{DEVICE_G1K(0x413c, 0x8172)},	/* Dell Gobi Modem device */
37 	{DEVICE_G1K(0x413c, 0x8171)},	/* Dell Gobi QDL device */
38 	{DEVICE_G1K(0x1410, 0xa001)},	/* Novatel Gobi Modem device */
39 	{DEVICE_G1K(0x1410, 0xa008)},	/* Novatel Gobi QDL device */
40 	{DEVICE_G1K(0x0b05, 0x1776)},	/* Asus Gobi Modem device */
41 	{DEVICE_G1K(0x0b05, 0x1774)},	/* Asus Gobi QDL device */
42 	{DEVICE_G1K(0x19d2, 0xfff3)},	/* ONDA Gobi Modem device */
43 	{DEVICE_G1K(0x19d2, 0xfff2)},	/* ONDA Gobi QDL device */
44 	{DEVICE_G1K(0x1557, 0x0a80)},	/* OQO Gobi QDL device */
45 	{DEVICE_G1K(0x05c6, 0x9001)},   /* Generic Gobi Modem device */
46 	{DEVICE_G1K(0x05c6, 0x9002)},	/* Generic Gobi Modem device */
47 	{DEVICE_G1K(0x05c6, 0x9202)},	/* Generic Gobi Modem device */
48 	{DEVICE_G1K(0x05c6, 0x9203)},	/* Generic Gobi Modem device */
49 	{DEVICE_G1K(0x05c6, 0x9222)},	/* Generic Gobi Modem device */
50 	{DEVICE_G1K(0x05c6, 0x9008)},	/* Generic Gobi QDL device */
51 	{DEVICE_G1K(0x05c6, 0x9009)},	/* Generic Gobi Modem device */
52 	{DEVICE_G1K(0x05c6, 0x9201)},	/* Generic Gobi QDL device */
53 	{DEVICE_G1K(0x05c6, 0x9221)},	/* Generic Gobi QDL device */
54 	{DEVICE_G1K(0x05c6, 0x9231)},	/* Generic Gobi QDL device */
55 	{DEVICE_G1K(0x1f45, 0x0001)},	/* Unknown Gobi QDL device */
56 
57 	/* Gobi 2000 devices */
58 	{USB_DEVICE(0x1410, 0xa010)},	/* Novatel Gobi 2000 QDL device */
59 	{USB_DEVICE(0x1410, 0xa011)},	/* Novatel Gobi 2000 QDL device */
60 	{USB_DEVICE(0x1410, 0xa012)},	/* Novatel Gobi 2000 QDL device */
61 	{USB_DEVICE(0x1410, 0xa013)},	/* Novatel Gobi 2000 QDL device */
62 	{USB_DEVICE(0x1410, 0xa014)},	/* Novatel Gobi 2000 QDL device */
63 	{USB_DEVICE(0x413c, 0x8185)},	/* Dell Gobi 2000 QDL device (N0218, VU936) */
64 	{USB_DEVICE(0x413c, 0x8186)},	/* Dell Gobi 2000 Modem device (N0218, VU936) */
65 	{USB_DEVICE(0x05c6, 0x9208)},	/* Generic Gobi 2000 QDL device */
66 	{USB_DEVICE(0x05c6, 0x920b)},	/* Generic Gobi 2000 Modem device */
67 	{USB_DEVICE(0x05c6, 0x9224)},	/* Sony Gobi 2000 QDL device (N0279, VU730) */
68 	{USB_DEVICE(0x05c6, 0x9225)},	/* Sony Gobi 2000 Modem device (N0279, VU730) */
69 	{USB_DEVICE(0x05c6, 0x9244)},	/* Samsung Gobi 2000 QDL device (VL176) */
70 	{USB_DEVICE(0x05c6, 0x9245)},	/* Samsung Gobi 2000 Modem device (VL176) */
71 	{USB_DEVICE(0x03f0, 0x241d)},	/* HP Gobi 2000 QDL device (VP412) */
72 	{USB_DEVICE(0x03f0, 0x251d)},	/* HP Gobi 2000 Modem device (VP412) */
73 	{USB_DEVICE(0x05c6, 0x9214)},	/* Acer Gobi 2000 QDL device (VP413) */
74 	{USB_DEVICE(0x05c6, 0x9215)},	/* Acer Gobi 2000 Modem device (VP413) */
75 	{USB_DEVICE(0x05c6, 0x9264)},	/* Asus Gobi 2000 QDL device (VR305) */
76 	{USB_DEVICE(0x05c6, 0x9265)},	/* Asus Gobi 2000 Modem device (VR305) */
77 	{USB_DEVICE(0x05c6, 0x9234)},	/* Top Global Gobi 2000 QDL device (VR306) */
78 	{USB_DEVICE(0x05c6, 0x9235)},	/* Top Global Gobi 2000 Modem device (VR306) */
79 	{USB_DEVICE(0x05c6, 0x9274)},	/* iRex Technologies Gobi 2000 QDL device (VR307) */
80 	{USB_DEVICE(0x05c6, 0x9275)},	/* iRex Technologies Gobi 2000 Modem device (VR307) */
81 	{USB_DEVICE(0x1199, 0x9000)},	/* Sierra Wireless Gobi 2000 QDL device (VT773) */
82 	{USB_DEVICE(0x1199, 0x9001)},	/* Sierra Wireless Gobi 2000 Modem device (VT773) */
83 	{USB_DEVICE(0x1199, 0x9002)},	/* Sierra Wireless Gobi 2000 Modem device (VT773) */
84 	{USB_DEVICE(0x1199, 0x9003)},	/* Sierra Wireless Gobi 2000 Modem device (VT773) */
85 	{USB_DEVICE(0x1199, 0x9004)},	/* Sierra Wireless Gobi 2000 Modem device (VT773) */
86 	{USB_DEVICE(0x1199, 0x9005)},	/* Sierra Wireless Gobi 2000 Modem device (VT773) */
87 	{USB_DEVICE(0x1199, 0x9006)},	/* Sierra Wireless Gobi 2000 Modem device (VT773) */
88 	{USB_DEVICE(0x1199, 0x9007)},	/* Sierra Wireless Gobi 2000 Modem device (VT773) */
89 	{USB_DEVICE(0x1199, 0x9008)},	/* Sierra Wireless Gobi 2000 Modem device (VT773) */
90 	{USB_DEVICE(0x1199, 0x9009)},	/* Sierra Wireless Gobi 2000 Modem device (VT773) */
91 	{USB_DEVICE(0x1199, 0x900a)},	/* Sierra Wireless Gobi 2000 Modem device (VT773) */
92 	{USB_DEVICE(0x1199, 0x9011)},   /* Sierra Wireless Gobi 2000 Modem device (MC8305) */
93 	{USB_DEVICE(0x16d8, 0x8001)},	/* CMDTech Gobi 2000 QDL device (VU922) */
94 	{USB_DEVICE(0x16d8, 0x8002)},	/* CMDTech Gobi 2000 Modem device (VU922) */
95 	{USB_DEVICE(0x05c6, 0x9204)},	/* Gobi 2000 QDL device */
96 	{USB_DEVICE(0x05c6, 0x9205)},	/* Gobi 2000 Modem device */
97 
98 	/* Gobi 3000 devices */
99 	{USB_DEVICE(0x03f0, 0x371d)},	/* HP un2430 Gobi 3000 QDL */
100 	{USB_DEVICE(0x05c6, 0x920c)},	/* Gobi 3000 QDL */
101 	{USB_DEVICE(0x05c6, 0x920d)},	/* Gobi 3000 Composite */
102 	{USB_DEVICE(0x1410, 0xa020)},   /* Novatel Gobi 3000 QDL */
103 	{USB_DEVICE(0x1410, 0xa021)},	/* Novatel Gobi 3000 Composite */
104 	{USB_DEVICE(0x413c, 0x8193)},	/* Dell Gobi 3000 QDL */
105 	{USB_DEVICE(0x413c, 0x8194)},	/* Dell Gobi 3000 Composite */
106 	{USB_DEVICE(0x1199, 0x68a4)},	/* Sierra Wireless QDL */
107 	{USB_DEVICE(0x1199, 0x68a5)},	/* Sierra Wireless Modem */
108 	{USB_DEVICE(0x1199, 0x68a8)},	/* Sierra Wireless QDL */
109 	{USB_DEVICE(0x1199, 0x68a9)},	/* Sierra Wireless Modem */
110 	{USB_DEVICE(0x1199, 0x9010)},	/* Sierra Wireless Gobi 3000 QDL */
111 	{USB_DEVICE(0x1199, 0x9012)},	/* Sierra Wireless Gobi 3000 QDL */
112 	{USB_DEVICE(0x1199, 0x9013)},	/* Sierra Wireless Gobi 3000 Modem device (MC8355) */
113 	{USB_DEVICE(0x1199, 0x9014)},	/* Sierra Wireless Gobi 3000 QDL */
114 	{USB_DEVICE(0x1199, 0x9015)},	/* Sierra Wireless Gobi 3000 Modem device */
115 	{USB_DEVICE(0x1199, 0x9018)},	/* Sierra Wireless Gobi 3000 QDL */
116 	{USB_DEVICE(0x1199, 0x9019)},	/* Sierra Wireless Gobi 3000 Modem device */
117 	{USB_DEVICE(0x1199, 0x901b)},	/* Sierra Wireless MC7770 */
118 	{USB_DEVICE(0x12D1, 0x14F0)},	/* Sony Gobi 3000 QDL */
119 	{USB_DEVICE(0x12D1, 0x14F1)},	/* Sony Gobi 3000 Composite */
120 
121 	/* non Gobi Qualcomm serial devices */
122 	{USB_DEVICE_INTERFACE_NUMBER(0x0f3d, 0x68a2, 0)},	/* Sierra Wireless MC7700 Device Management */
123 	{USB_DEVICE_INTERFACE_NUMBER(0x0f3d, 0x68a2, 2)},	/* Sierra Wireless MC7700 NMEA */
124 	{USB_DEVICE_INTERFACE_NUMBER(0x0f3d, 0x68a2, 3)},	/* Sierra Wireless MC7700 Modem */
125 	{USB_DEVICE_INTERFACE_NUMBER(0x114f, 0x68a2, 0)},	/* Sierra Wireless MC7750 Device Management */
126 	{USB_DEVICE_INTERFACE_NUMBER(0x114f, 0x68a2, 2)},	/* Sierra Wireless MC7750 NMEA */
127 	{USB_DEVICE_INTERFACE_NUMBER(0x114f, 0x68a2, 3)},	/* Sierra Wireless MC7750 Modem */
128 	{USB_DEVICE_INTERFACE_NUMBER(0x1199, 0x68a2, 0)},	/* Sierra Wireless MC7710 Device Management */
129 	{USB_DEVICE_INTERFACE_NUMBER(0x1199, 0x68a2, 2)},	/* Sierra Wireless MC7710 NMEA */
130 	{USB_DEVICE_INTERFACE_NUMBER(0x1199, 0x68a2, 3)},	/* Sierra Wireless MC7710 Modem */
131 	{USB_DEVICE_INTERFACE_NUMBER(0x1199, 0x901c, 0)},	/* Sierra Wireless EM7700 Device Management */
132 	{USB_DEVICE_INTERFACE_NUMBER(0x1199, 0x901c, 2)},	/* Sierra Wireless EM7700 NMEA */
133 	{USB_DEVICE_INTERFACE_NUMBER(0x1199, 0x901c, 3)},	/* Sierra Wireless EM7700 Modem */
134 
135 	{ }				/* Terminating entry */
136 };
137 MODULE_DEVICE_TABLE(usb, id_table);
138 
139 static int qcprobe(struct usb_serial *serial, const struct usb_device_id *id)
140 {
141 	struct usb_host_interface *intf = serial->interface->cur_altsetting;
142 	struct device *dev = &serial->dev->dev;
143 	int retval = -ENODEV;
144 	__u8 nintf;
145 	__u8 ifnum;
146 	bool is_gobi1k = id->driver_info ? true : false;
147 	int altsetting = -1;
148 
149 	dev_dbg(dev, "Is Gobi 1000 = %d\n", is_gobi1k);
150 
151 	nintf = serial->dev->actconfig->desc.bNumInterfaces;
152 	dev_dbg(dev, "Num Interfaces = %d\n", nintf);
153 	ifnum = intf->desc.bInterfaceNumber;
154 	dev_dbg(dev, "This Interface = %d\n", ifnum);
155 
156 	if (nintf == 1) {
157 		/* QDL mode */
158 		/* Gobi 2000 has a single altsetting, older ones have two */
159 		if (serial->interface->num_altsetting == 2)
160 			intf = &serial->interface->altsetting[1];
161 		else if (serial->interface->num_altsetting > 2)
162 			goto done;
163 
164 		if (intf->desc.bNumEndpoints == 2 &&
165 		    usb_endpoint_is_bulk_in(&intf->endpoint[0].desc) &&
166 		    usb_endpoint_is_bulk_out(&intf->endpoint[1].desc)) {
167 			dev_dbg(dev, "QDL port found\n");
168 
169 			if (serial->interface->num_altsetting == 1)
170 				retval = 0; /* Success */
171 			else
172 				altsetting = 1;
173 		}
174 		goto done;
175 
176 	}
177 
178 	/* allow any number of interfaces when doing direct interface match */
179 	if (id->match_flags & USB_DEVICE_ID_MATCH_INT_NUMBER) {
180 		dev_dbg(dev, "Generic Qualcomm serial interface found\n");
181 		altsetting = 0;
182 		goto done;
183 	}
184 
185 	if (nintf < 3 || nintf > 4) {
186 		dev_err(dev, "unknown number of interfaces: %d\n", nintf);
187 		goto done;
188 	}
189 
190 	/* default to enabling interface */
191 	altsetting = 0;
192 
193 	/* Composite mode; don't bind to the QMI/net interface as that
194 	 * gets handled by other drivers.
195 	 */
196 
197 	if (is_gobi1k) {
198 		/* Gobi 1K USB layout:
199 		 * 0: serial port (doesn't respond)
200 		 * 1: serial port (doesn't respond)
201 		 * 2: AT-capable modem port
202 		 * 3: QMI/net
203 		 */
204 		if (ifnum == 2)
205 			dev_dbg(dev, "Modem port found\n");
206 		else
207 			altsetting = -1;
208 	} else {
209 		/* Gobi 2K+ USB layout:
210 		 * 0: QMI/net
211 		 * 1: DM/DIAG (use libqcdm from ModemManager for communication)
212 		 * 2: AT-capable modem port
213 		 * 3: NMEA
214 		 */
215 		switch (ifnum) {
216 		case 0:
217 			/* Don't claim the QMI/net interface */
218 			altsetting = -1;
219 			break;
220 		case 1:
221 			dev_dbg(dev, "Gobi 2K+ DM/DIAG interface found\n");
222 			break;
223 		case 2:
224 			dev_dbg(dev, "Modem port found\n");
225 			break;
226 		case 3:
227 			/*
228 			 * NMEA (serial line 9600 8N1)
229 			 * # echo "\$GPS_START" > /dev/ttyUSBx
230 			 * # echo "\$GPS_STOP"  > /dev/ttyUSBx
231 			 */
232 			dev_dbg(dev, "Gobi 2K+ NMEA GPS interface found\n");
233 			break;
234 		}
235 	}
236 
237 done:
238 	if (altsetting >= 0) {
239 		retval = usb_set_interface(serial->dev, ifnum, altsetting);
240 		if (retval < 0) {
241 			dev_err(dev,
242 				"Could not set interface, error %d\n",
243 				retval);
244 			retval = -ENODEV;
245 		}
246 	}
247 
248 	return retval;
249 }
250 
251 static int qc_attach(struct usb_serial *serial)
252 {
253 	struct usb_wwan_intf_private *data;
254 
255 	data = kzalloc(sizeof(*data), GFP_KERNEL);
256 	if (!data)
257 		return -ENOMEM;
258 
259 	spin_lock_init(&data->susp_lock);
260 
261 	usb_set_serial_data(serial, data);
262 
263 	return 0;
264 }
265 
266 static void qc_release(struct usb_serial *serial)
267 {
268 	struct usb_wwan_intf_private *priv = usb_get_serial_data(serial);
269 
270 	usb_set_serial_data(serial, NULL);
271 	kfree(priv);
272 }
273 
274 static struct usb_serial_driver qcdevice = {
275 	.driver = {
276 		.owner     = THIS_MODULE,
277 		.name      = "qcserial",
278 	},
279 	.description         = "Qualcomm USB modem",
280 	.id_table            = id_table,
281 	.num_ports           = 1,
282 	.probe               = qcprobe,
283 	.open		     = usb_wwan_open,
284 	.close		     = usb_wwan_close,
285 	.write		     = usb_wwan_write,
286 	.write_room	     = usb_wwan_write_room,
287 	.chars_in_buffer     = usb_wwan_chars_in_buffer,
288 	.attach              = qc_attach,
289 	.release	     = qc_release,
290 	.port_probe          = usb_wwan_port_probe,
291 	.port_remove	     = usb_wwan_port_remove,
292 #ifdef CONFIG_PM
293 	.suspend	     = usb_wwan_suspend,
294 	.resume		     = usb_wwan_resume,
295 #endif
296 };
297 
298 static struct usb_serial_driver * const serial_drivers[] = {
299 	&qcdevice, NULL
300 };
301 
302 module_usb_serial_driver(serial_drivers, id_table);
303 
304 MODULE_AUTHOR(DRIVER_AUTHOR);
305 MODULE_DESCRIPTION(DRIVER_DESC);
306 MODULE_LICENSE("GPL v2");
307