xref: /openbmc/linux/drivers/usb/atm/speedtch.c (revision 1c2dd16a)
1 /******************************************************************************
2  *  speedtch.c  -  Alcatel SpeedTouch USB xDSL modem driver
3  *
4  *  Copyright (C) 2001, Alcatel
5  *  Copyright (C) 2003, Duncan Sands
6  *  Copyright (C) 2004, David Woodhouse
7  *
8  *  Based on "modem_run.c", copyright (C) 2001, Benoit Papillault
9  *
10  *  This program is free software; you can redistribute it and/or modify it
11  *  under the terms of the GNU General Public License as published by the Free
12  *  Software Foundation; either version 2 of the License, or (at your option)
13  *  any later version.
14  *
15  *  This program is distributed in the hope that it will be useful, but WITHOUT
16  *  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
17  *  FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
18  *  more details.
19  *
20  *  You should have received a copy of the GNU General Public License along with
21  *  this program; if not, write to the Free Software Foundation, Inc., 59
22  *  Temple Place - Suite 330, Boston, MA  02111-1307, USA.
23  *
24  ******************************************************************************/
25 
26 #include <asm/page.h>
27 #include <linux/device.h>
28 #include <linux/errno.h>
29 #include <linux/firmware.h>
30 #include <linux/kernel.h>
31 #include <linux/module.h>
32 #include <linux/moduleparam.h>
33 #include <linux/slab.h>
34 #include <linux/stat.h>
35 #include <linux/timer.h>
36 #include <linux/types.h>
37 #include <linux/usb/ch9.h>
38 #include <linux/workqueue.h>
39 
40 #include "usbatm.h"
41 
42 #define DRIVER_AUTHOR	"Johan Verrept, Duncan Sands <duncan.sands@free.fr>"
43 #define DRIVER_VERSION	"1.10"
44 #define DRIVER_DESC	"Alcatel SpeedTouch USB driver version " DRIVER_VERSION
45 
46 static const char speedtch_driver_name[] = "speedtch";
47 
48 #define CTRL_TIMEOUT 2000	/* milliseconds */
49 #define DATA_TIMEOUT 2000	/* milliseconds */
50 
51 #define OFFSET_7	0		/* size 1 */
52 #define OFFSET_b	1		/* size 8 */
53 #define OFFSET_d	9		/* size 4 */
54 #define OFFSET_e	13		/* size 1 */
55 #define OFFSET_f	14		/* size 1 */
56 
57 #define SIZE_7		1
58 #define SIZE_b		8
59 #define SIZE_d		4
60 #define SIZE_e		1
61 #define SIZE_f		1
62 
63 #define MIN_POLL_DELAY		5000	/* milliseconds */
64 #define MAX_POLL_DELAY		60000	/* milliseconds */
65 
66 #define RESUBMIT_DELAY		1000	/* milliseconds */
67 
68 #define DEFAULT_BULK_ALTSETTING	1
69 #define DEFAULT_ISOC_ALTSETTING	3
70 #define DEFAULT_DL_512_FIRST	0
71 #define DEFAULT_ENABLE_ISOC	0
72 #define DEFAULT_SW_BUFFERING	0
73 
74 static unsigned int altsetting = 0; /* zero means: use the default */
75 static bool dl_512_first = DEFAULT_DL_512_FIRST;
76 static bool enable_isoc = DEFAULT_ENABLE_ISOC;
77 static bool sw_buffering = DEFAULT_SW_BUFFERING;
78 
79 #define DEFAULT_B_MAX_DSL	8128
80 #define DEFAULT_MODEM_MODE	11
81 #define MODEM_OPTION_LENGTH	16
82 static const unsigned char DEFAULT_MODEM_OPTION[MODEM_OPTION_LENGTH] = {
83 	0x10, 0x00, 0x00, 0x00, 0x20, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00
84 };
85 
86 static unsigned int BMaxDSL = DEFAULT_B_MAX_DSL;
87 static unsigned char ModemMode = DEFAULT_MODEM_MODE;
88 static unsigned char ModemOption[MODEM_OPTION_LENGTH];
89 static unsigned int num_ModemOption;
90 
91 module_param(altsetting, uint, S_IRUGO | S_IWUSR);
92 MODULE_PARM_DESC(altsetting,
93 		"Alternative setting for data interface (bulk_default: "
94 		__MODULE_STRING(DEFAULT_BULK_ALTSETTING) "; isoc_default: "
95 		__MODULE_STRING(DEFAULT_ISOC_ALTSETTING) ")");
96 
97 module_param(dl_512_first, bool, S_IRUGO | S_IWUSR);
98 MODULE_PARM_DESC(dl_512_first,
99 		 "Read 512 bytes before sending firmware (default: "
100 		 __MODULE_STRING(DEFAULT_DL_512_FIRST) ")");
101 
102 module_param(enable_isoc, bool, S_IRUGO | S_IWUSR);
103 MODULE_PARM_DESC(enable_isoc,
104 		"Use isochronous transfers if available (default: "
105 		__MODULE_STRING(DEFAULT_ENABLE_ISOC) ")");
106 
107 module_param(sw_buffering, bool, S_IRUGO | S_IWUSR);
108 MODULE_PARM_DESC(sw_buffering,
109 		 "Enable software buffering (default: "
110 		 __MODULE_STRING(DEFAULT_SW_BUFFERING) ")");
111 
112 module_param(BMaxDSL, uint, S_IRUGO | S_IWUSR);
113 MODULE_PARM_DESC(BMaxDSL,
114 		"default: " __MODULE_STRING(DEFAULT_B_MAX_DSL));
115 
116 module_param(ModemMode, byte, S_IRUGO | S_IWUSR);
117 MODULE_PARM_DESC(ModemMode,
118 		"default: " __MODULE_STRING(DEFAULT_MODEM_MODE));
119 
120 module_param_array(ModemOption, byte, &num_ModemOption, S_IRUGO);
121 MODULE_PARM_DESC(ModemOption, "default: 0x10,0x00,0x00,0x00,0x20");
122 
123 #define INTERFACE_DATA		1
124 #define ENDPOINT_INT		0x81
125 #define ENDPOINT_BULK_DATA	0x07
126 #define ENDPOINT_ISOC_DATA	0x07
127 #define ENDPOINT_FIRMWARE	0x05
128 
129 struct speedtch_params {
130 	unsigned int altsetting;
131 	unsigned int BMaxDSL;
132 	unsigned char ModemMode;
133 	unsigned char ModemOption[MODEM_OPTION_LENGTH];
134 };
135 
136 struct speedtch_instance_data {
137 	struct usbatm_data *usbatm;
138 
139 	struct speedtch_params params; /* set in probe, constant afterwards */
140 
141 	struct timer_list status_check_timer;
142 	struct work_struct status_check_work;
143 
144 	unsigned char last_status;
145 
146 	int poll_delay; /* milliseconds */
147 
148 	struct timer_list resubmit_timer;
149 	struct urb *int_urb;
150 	unsigned char int_data[16];
151 
152 	unsigned char scratch_buffer[16];
153 };
154 
155 /***************
156 **  firmware  **
157 ***************/
158 
159 static void speedtch_set_swbuff(struct speedtch_instance_data *instance, int state)
160 {
161 	struct usbatm_data *usbatm = instance->usbatm;
162 	struct usb_device *usb_dev = usbatm->usb_dev;
163 	int ret;
164 
165 	ret = usb_control_msg(usb_dev, usb_sndctrlpipe(usb_dev, 0),
166 			      0x32, 0x40, state ? 0x01 : 0x00, 0x00, NULL, 0, CTRL_TIMEOUT);
167 	if (ret < 0)
168 		usb_warn(usbatm,
169 			 "%sabling SW buffering: usb_control_msg returned %d\n",
170 			 state ? "En" : "Dis", ret);
171 	else
172 		usb_dbg(usbatm, "speedtch_set_swbuff: %sbled SW buffering\n", state ? "En" : "Dis");
173 }
174 
175 static void speedtch_test_sequence(struct speedtch_instance_data *instance)
176 {
177 	struct usbatm_data *usbatm = instance->usbatm;
178 	struct usb_device *usb_dev = usbatm->usb_dev;
179 	unsigned char *buf = instance->scratch_buffer;
180 	int ret;
181 
182 	/* URB 147 */
183 	buf[0] = 0x1c;
184 	buf[1] = 0x50;
185 	ret = usb_control_msg(usb_dev, usb_sndctrlpipe(usb_dev, 0),
186 			      0x01, 0x40, 0x0b, 0x00, buf, 2, CTRL_TIMEOUT);
187 	if (ret < 0)
188 		usb_warn(usbatm, "%s failed on URB147: %d\n", __func__, ret);
189 
190 	/* URB 148 */
191 	buf[0] = 0x32;
192 	buf[1] = 0x00;
193 	ret = usb_control_msg(usb_dev, usb_sndctrlpipe(usb_dev, 0),
194 			      0x01, 0x40, 0x02, 0x00, buf, 2, CTRL_TIMEOUT);
195 	if (ret < 0)
196 		usb_warn(usbatm, "%s failed on URB148: %d\n", __func__, ret);
197 
198 	/* URB 149 */
199 	buf[0] = 0x01;
200 	buf[1] = 0x00;
201 	buf[2] = 0x01;
202 	ret = usb_control_msg(usb_dev, usb_sndctrlpipe(usb_dev, 0),
203 			      0x01, 0x40, 0x03, 0x00, buf, 3, CTRL_TIMEOUT);
204 	if (ret < 0)
205 		usb_warn(usbatm, "%s failed on URB149: %d\n", __func__, ret);
206 
207 	/* URB 150 */
208 	buf[0] = 0x01;
209 	buf[1] = 0x00;
210 	buf[2] = 0x01;
211 	ret = usb_control_msg(usb_dev, usb_sndctrlpipe(usb_dev, 0),
212 			      0x01, 0x40, 0x04, 0x00, buf, 3, CTRL_TIMEOUT);
213 	if (ret < 0)
214 		usb_warn(usbatm, "%s failed on URB150: %d\n", __func__, ret);
215 
216 	/* Extra initialisation in recent drivers - gives higher speeds */
217 
218 	/* URBext1 */
219 	buf[0] = instance->params.ModemMode;
220 	ret = usb_control_msg(usb_dev, usb_sndctrlpipe(usb_dev, 0),
221 			      0x01, 0x40, 0x11, 0x00, buf, 1, CTRL_TIMEOUT);
222 	if (ret < 0)
223 		usb_warn(usbatm, "%s failed on URBext1: %d\n", __func__, ret);
224 
225 	/* URBext2 */
226 	/* This seems to be the one which actually triggers the higher sync
227 	   rate -- it does require the new firmware too, although it works OK
228 	   with older firmware */
229 	ret = usb_control_msg(usb_dev, usb_sndctrlpipe(usb_dev, 0),
230 			      0x01, 0x40, 0x14, 0x00,
231 			      instance->params.ModemOption,
232 			      MODEM_OPTION_LENGTH, CTRL_TIMEOUT);
233 	if (ret < 0)
234 		usb_warn(usbatm, "%s failed on URBext2: %d\n", __func__, ret);
235 
236 	/* URBext3 */
237 	buf[0] = instance->params.BMaxDSL & 0xff;
238 	buf[1] = instance->params.BMaxDSL >> 8;
239 	ret = usb_control_msg(usb_dev, usb_sndctrlpipe(usb_dev, 0),
240 			      0x01, 0x40, 0x12, 0x00, buf, 2, CTRL_TIMEOUT);
241 	if (ret < 0)
242 		usb_warn(usbatm, "%s failed on URBext3: %d\n", __func__, ret);
243 }
244 
245 static int speedtch_upload_firmware(struct speedtch_instance_data *instance,
246 				     const struct firmware *fw1,
247 				     const struct firmware *fw2)
248 {
249 	unsigned char *buffer;
250 	struct usbatm_data *usbatm = instance->usbatm;
251 	struct usb_device *usb_dev = usbatm->usb_dev;
252 	int actual_length;
253 	int ret = 0;
254 	int offset;
255 
256 	usb_dbg(usbatm, "%s entered\n", __func__);
257 
258 	buffer = (unsigned char *)__get_free_page(GFP_KERNEL);
259 	if (!buffer) {
260 		ret = -ENOMEM;
261 		usb_dbg(usbatm, "%s: no memory for buffer!\n", __func__);
262 		goto out;
263 	}
264 
265 	if (!usb_ifnum_to_if(usb_dev, 2)) {
266 		ret = -ENODEV;
267 		usb_dbg(usbatm, "%s: interface not found!\n", __func__);
268 		goto out_free;
269 	}
270 
271 	/* URB 7 */
272 	if (dl_512_first) {	/* some modems need a read before writing the firmware */
273 		ret = usb_bulk_msg(usb_dev, usb_rcvbulkpipe(usb_dev, ENDPOINT_FIRMWARE),
274 				   buffer, 0x200, &actual_length, 2000);
275 
276 		if (ret < 0 && ret != -ETIMEDOUT)
277 			usb_warn(usbatm, "%s: read BLOCK0 from modem failed (%d)!\n", __func__, ret);
278 		else
279 			usb_dbg(usbatm, "%s: BLOCK0 downloaded (%d bytes)\n", __func__, ret);
280 	}
281 
282 	/* URB 8 : both leds are static green */
283 	for (offset = 0; offset < fw1->size; offset += PAGE_SIZE) {
284 		int thislen = min_t(int, PAGE_SIZE, fw1->size - offset);
285 		memcpy(buffer, fw1->data + offset, thislen);
286 
287 		ret = usb_bulk_msg(usb_dev, usb_sndbulkpipe(usb_dev, ENDPOINT_FIRMWARE),
288 				   buffer, thislen, &actual_length, DATA_TIMEOUT);
289 
290 		if (ret < 0) {
291 			usb_err(usbatm, "%s: write BLOCK1 to modem failed (%d)!\n", __func__, ret);
292 			goto out_free;
293 		}
294 		usb_dbg(usbatm, "%s: BLOCK1 uploaded (%zu bytes)\n", __func__, fw1->size);
295 	}
296 
297 	/* USB led blinking green, ADSL led off */
298 
299 	/* URB 11 */
300 	ret = usb_bulk_msg(usb_dev, usb_rcvbulkpipe(usb_dev, ENDPOINT_FIRMWARE),
301 			   buffer, 0x200, &actual_length, DATA_TIMEOUT);
302 
303 	if (ret < 0) {
304 		usb_err(usbatm, "%s: read BLOCK2 from modem failed (%d)!\n", __func__, ret);
305 		goto out_free;
306 	}
307 	usb_dbg(usbatm, "%s: BLOCK2 downloaded (%d bytes)\n", __func__, actual_length);
308 
309 	/* URBs 12 to 139 - USB led blinking green, ADSL led off */
310 	for (offset = 0; offset < fw2->size; offset += PAGE_SIZE) {
311 		int thislen = min_t(int, PAGE_SIZE, fw2->size - offset);
312 		memcpy(buffer, fw2->data + offset, thislen);
313 
314 		ret = usb_bulk_msg(usb_dev, usb_sndbulkpipe(usb_dev, ENDPOINT_FIRMWARE),
315 				   buffer, thislen, &actual_length, DATA_TIMEOUT);
316 
317 		if (ret < 0) {
318 			usb_err(usbatm, "%s: write BLOCK3 to modem failed (%d)!\n", __func__, ret);
319 			goto out_free;
320 		}
321 	}
322 	usb_dbg(usbatm, "%s: BLOCK3 uploaded (%zu bytes)\n", __func__, fw2->size);
323 
324 	/* USB led static green, ADSL led static red */
325 
326 	/* URB 142 */
327 	ret = usb_bulk_msg(usb_dev, usb_rcvbulkpipe(usb_dev, ENDPOINT_FIRMWARE),
328 			   buffer, 0x200, &actual_length, DATA_TIMEOUT);
329 
330 	if (ret < 0) {
331 		usb_err(usbatm, "%s: read BLOCK4 from modem failed (%d)!\n", __func__, ret);
332 		goto out_free;
333 	}
334 
335 	/* success */
336 	usb_dbg(usbatm, "%s: BLOCK4 downloaded (%d bytes)\n", __func__, actual_length);
337 
338 	/* Delay to allow firmware to start up. We can do this here
339 	   because we're in our own kernel thread anyway. */
340 	msleep_interruptible(1000);
341 
342 	if ((ret = usb_set_interface(usb_dev, INTERFACE_DATA, instance->params.altsetting)) < 0) {
343 		usb_err(usbatm, "%s: setting interface to %d failed (%d)!\n", __func__, instance->params.altsetting, ret);
344 		goto out_free;
345 	}
346 
347 	/* Enable software buffering, if requested */
348 	if (sw_buffering)
349 		speedtch_set_swbuff(instance, 1);
350 
351 	/* Magic spell; don't ask us what this does */
352 	speedtch_test_sequence(instance);
353 
354 	ret = 0;
355 
356 out_free:
357 	free_page((unsigned long)buffer);
358 out:
359 	return ret;
360 }
361 
362 static int speedtch_find_firmware(struct usbatm_data *usbatm, struct usb_interface *intf,
363 				  int phase, const struct firmware **fw_p)
364 {
365 	struct device *dev = &intf->dev;
366 	const u16 bcdDevice = le16_to_cpu(interface_to_usbdev(intf)->descriptor.bcdDevice);
367 	const u8 major_revision = bcdDevice >> 8;
368 	const u8 minor_revision = bcdDevice & 0xff;
369 	char buf[24];
370 
371 	sprintf(buf, "speedtch-%d.bin.%x.%02x", phase, major_revision, minor_revision);
372 	usb_dbg(usbatm, "%s: looking for %s\n", __func__, buf);
373 
374 	if (request_firmware(fw_p, buf, dev)) {
375 		sprintf(buf, "speedtch-%d.bin.%x", phase, major_revision);
376 		usb_dbg(usbatm, "%s: looking for %s\n", __func__, buf);
377 
378 		if (request_firmware(fw_p, buf, dev)) {
379 			sprintf(buf, "speedtch-%d.bin", phase);
380 			usb_dbg(usbatm, "%s: looking for %s\n", __func__, buf);
381 
382 			if (request_firmware(fw_p, buf, dev)) {
383 				usb_err(usbatm, "%s: no stage %d firmware found!\n", __func__, phase);
384 				return -ENOENT;
385 			}
386 		}
387 	}
388 
389 	usb_info(usbatm, "found stage %d firmware %s\n", phase, buf);
390 
391 	return 0;
392 }
393 
394 static int speedtch_heavy_init(struct usbatm_data *usbatm, struct usb_interface *intf)
395 {
396 	const struct firmware *fw1, *fw2;
397 	struct speedtch_instance_data *instance = usbatm->driver_data;
398 	int ret;
399 
400 	if ((ret = speedtch_find_firmware(usbatm, intf, 1, &fw1)) < 0)
401 		return ret;
402 
403 	if ((ret = speedtch_find_firmware(usbatm, intf, 2, &fw2)) < 0) {
404 		release_firmware(fw1);
405 		return ret;
406 	}
407 
408 	if ((ret = speedtch_upload_firmware(instance, fw1, fw2)) < 0)
409 		usb_err(usbatm, "%s: firmware upload failed (%d)!\n", __func__, ret);
410 
411 	release_firmware(fw2);
412 	release_firmware(fw1);
413 
414 	return ret;
415 }
416 
417 
418 /**********
419 **  ATM  **
420 **********/
421 
422 static int speedtch_read_status(struct speedtch_instance_data *instance)
423 {
424 	struct usbatm_data *usbatm = instance->usbatm;
425 	struct usb_device *usb_dev = usbatm->usb_dev;
426 	unsigned char *buf = instance->scratch_buffer;
427 	int ret;
428 
429 	memset(buf, 0, 16);
430 
431 	ret = usb_control_msg(usb_dev, usb_rcvctrlpipe(usb_dev, 0),
432 			      0x12, 0xc0, 0x07, 0x00, buf + OFFSET_7, SIZE_7,
433 			      CTRL_TIMEOUT);
434 	if (ret < 0) {
435 		atm_dbg(usbatm, "%s: MSG 7 failed\n", __func__);
436 		return ret;
437 	}
438 
439 	ret = usb_control_msg(usb_dev, usb_rcvctrlpipe(usb_dev, 0),
440 			      0x12, 0xc0, 0x0b, 0x00, buf + OFFSET_b, SIZE_b,
441 			      CTRL_TIMEOUT);
442 	if (ret < 0) {
443 		atm_dbg(usbatm, "%s: MSG B failed\n", __func__);
444 		return ret;
445 	}
446 
447 	ret = usb_control_msg(usb_dev, usb_rcvctrlpipe(usb_dev, 0),
448 			      0x12, 0xc0, 0x0d, 0x00, buf + OFFSET_d, SIZE_d,
449 			      CTRL_TIMEOUT);
450 	if (ret < 0) {
451 		atm_dbg(usbatm, "%s: MSG D failed\n", __func__);
452 		return ret;
453 	}
454 
455 	ret = usb_control_msg(usb_dev, usb_rcvctrlpipe(usb_dev, 0),
456 			      0x01, 0xc0, 0x0e, 0x00, buf + OFFSET_e, SIZE_e,
457 			      CTRL_TIMEOUT);
458 	if (ret < 0) {
459 		atm_dbg(usbatm, "%s: MSG E failed\n", __func__);
460 		return ret;
461 	}
462 
463 	ret = usb_control_msg(usb_dev, usb_rcvctrlpipe(usb_dev, 0),
464 			      0x01, 0xc0, 0x0f, 0x00, buf + OFFSET_f, SIZE_f,
465 			      CTRL_TIMEOUT);
466 	if (ret < 0) {
467 		atm_dbg(usbatm, "%s: MSG F failed\n", __func__);
468 		return ret;
469 	}
470 
471 	return 0;
472 }
473 
474 static int speedtch_start_synchro(struct speedtch_instance_data *instance)
475 {
476 	struct usbatm_data *usbatm = instance->usbatm;
477 	struct usb_device *usb_dev = usbatm->usb_dev;
478 	unsigned char *buf = instance->scratch_buffer;
479 	int ret;
480 
481 	atm_dbg(usbatm, "%s entered\n", __func__);
482 
483 	memset(buf, 0, 2);
484 
485 	ret = usb_control_msg(usb_dev, usb_rcvctrlpipe(usb_dev, 0),
486 			      0x12, 0xc0, 0x04, 0x00,
487 			      buf, 2, CTRL_TIMEOUT);
488 
489 	if (ret < 0)
490 		atm_warn(usbatm, "failed to start ADSL synchronisation: %d\n", ret);
491 	else
492 		atm_dbg(usbatm, "%s: modem prodded. %d bytes returned: %02x %02x\n",
493 			__func__, ret, buf[0], buf[1]);
494 
495 	return ret;
496 }
497 
498 static void speedtch_check_status(struct work_struct *work)
499 {
500 	struct speedtch_instance_data *instance =
501 		container_of(work, struct speedtch_instance_data,
502 			     status_check_work);
503 	struct usbatm_data *usbatm = instance->usbatm;
504 	struct atm_dev *atm_dev = usbatm->atm_dev;
505 	unsigned char *buf = instance->scratch_buffer;
506 	int down_speed, up_speed, ret;
507 	unsigned char status;
508 
509 #ifdef VERBOSE_DEBUG
510 	atm_dbg(usbatm, "%s entered\n", __func__);
511 #endif
512 
513 	ret = speedtch_read_status(instance);
514 	if (ret < 0) {
515 		atm_warn(usbatm, "error %d fetching device status\n", ret);
516 		instance->poll_delay = min(2 * instance->poll_delay, MAX_POLL_DELAY);
517 		return;
518 	}
519 
520 	instance->poll_delay = max(instance->poll_delay / 2, MIN_POLL_DELAY);
521 
522 	status = buf[OFFSET_7];
523 
524 	if ((status != instance->last_status) || !status) {
525 		atm_dbg(usbatm, "%s: line state 0x%02x\n", __func__, status);
526 
527 		switch (status) {
528 		case 0:
529 			atm_dev_signal_change(atm_dev, ATM_PHY_SIG_LOST);
530 			if (instance->last_status)
531 				atm_info(usbatm, "ADSL line is down\n");
532 			/* It may never resync again unless we ask it to... */
533 			ret = speedtch_start_synchro(instance);
534 			break;
535 
536 		case 0x08:
537 			atm_dev_signal_change(atm_dev, ATM_PHY_SIG_UNKNOWN);
538 			atm_info(usbatm, "ADSL line is blocked?\n");
539 			break;
540 
541 		case 0x10:
542 			atm_dev_signal_change(atm_dev, ATM_PHY_SIG_LOST);
543 			atm_info(usbatm, "ADSL line is synchronising\n");
544 			break;
545 
546 		case 0x20:
547 			down_speed = buf[OFFSET_b] | (buf[OFFSET_b + 1] << 8)
548 				| (buf[OFFSET_b + 2] << 16) | (buf[OFFSET_b + 3] << 24);
549 			up_speed = buf[OFFSET_b + 4] | (buf[OFFSET_b + 5] << 8)
550 				| (buf[OFFSET_b + 6] << 16) | (buf[OFFSET_b + 7] << 24);
551 
552 			if (!(down_speed & 0x0000ffff) && !(up_speed & 0x0000ffff)) {
553 				down_speed >>= 16;
554 				up_speed >>= 16;
555 			}
556 
557 			atm_dev->link_rate = down_speed * 1000 / 424;
558 			atm_dev_signal_change(atm_dev, ATM_PHY_SIG_FOUND);
559 
560 			atm_info(usbatm,
561 				 "ADSL line is up (%d kb/s down | %d kb/s up)\n",
562 				 down_speed, up_speed);
563 			break;
564 
565 		default:
566 			atm_dev_signal_change(atm_dev, ATM_PHY_SIG_UNKNOWN);
567 			atm_info(usbatm, "unknown line state %02x\n", status);
568 			break;
569 		}
570 
571 		instance->last_status = status;
572 	}
573 }
574 
575 static void speedtch_status_poll(unsigned long data)
576 {
577 	struct speedtch_instance_data *instance = (void *)data;
578 
579 	schedule_work(&instance->status_check_work);
580 
581 	/* The following check is racy, but the race is harmless */
582 	if (instance->poll_delay < MAX_POLL_DELAY)
583 		mod_timer(&instance->status_check_timer, jiffies + msecs_to_jiffies(instance->poll_delay));
584 	else
585 		atm_warn(instance->usbatm, "Too many failures - disabling line status polling\n");
586 }
587 
588 static void speedtch_resubmit_int(unsigned long data)
589 {
590 	struct speedtch_instance_data *instance = (void *)data;
591 	struct urb *int_urb = instance->int_urb;
592 	int ret;
593 
594 	atm_dbg(instance->usbatm, "%s entered\n", __func__);
595 
596 	if (int_urb) {
597 		ret = usb_submit_urb(int_urb, GFP_ATOMIC);
598 		if (!ret)
599 			schedule_work(&instance->status_check_work);
600 		else {
601 			atm_dbg(instance->usbatm, "%s: usb_submit_urb failed with result %d\n", __func__, ret);
602 			mod_timer(&instance->resubmit_timer, jiffies + msecs_to_jiffies(RESUBMIT_DELAY));
603 		}
604 	}
605 }
606 
607 static void speedtch_handle_int(struct urb *int_urb)
608 {
609 	struct speedtch_instance_data *instance = int_urb->context;
610 	struct usbatm_data *usbatm = instance->usbatm;
611 	unsigned int count = int_urb->actual_length;
612 	int status = int_urb->status;
613 	int ret;
614 
615 	/* The magic interrupt for "up state" */
616 	static const unsigned char up_int[6]   = { 0xa1, 0x00, 0x01, 0x00, 0x00, 0x00 };
617 	/* The magic interrupt for "down state" */
618 	static const unsigned char down_int[6] = { 0xa1, 0x00, 0x00, 0x00, 0x00, 0x00 };
619 
620 	atm_dbg(usbatm, "%s entered\n", __func__);
621 
622 	if (status < 0) {
623 		atm_dbg(usbatm, "%s: nonzero urb status %d!\n", __func__, status);
624 		goto fail;
625 	}
626 
627 	if ((count == 6) && !memcmp(up_int, instance->int_data, 6)) {
628 		del_timer(&instance->status_check_timer);
629 		atm_info(usbatm, "DSL line goes up\n");
630 	} else if ((count == 6) && !memcmp(down_int, instance->int_data, 6)) {
631 		atm_info(usbatm, "DSL line goes down\n");
632 	} else {
633 		int i;
634 
635 		atm_dbg(usbatm, "%s: unknown interrupt packet of length %d:", __func__, count);
636 		for (i = 0; i < count; i++)
637 			printk(" %02x", instance->int_data[i]);
638 		printk("\n");
639 		goto fail;
640 	}
641 
642 	int_urb = instance->int_urb;
643 	if (int_urb) {
644 		ret = usb_submit_urb(int_urb, GFP_ATOMIC);
645 		schedule_work(&instance->status_check_work);
646 		if (ret < 0) {
647 			atm_dbg(usbatm, "%s: usb_submit_urb failed with result %d\n", __func__, ret);
648 			goto fail;
649 		}
650 	}
651 
652 	return;
653 
654 fail:
655 	int_urb = instance->int_urb;
656 	if (int_urb)
657 		mod_timer(&instance->resubmit_timer, jiffies + msecs_to_jiffies(RESUBMIT_DELAY));
658 }
659 
660 static int speedtch_atm_start(struct usbatm_data *usbatm, struct atm_dev *atm_dev)
661 {
662 	struct usb_device *usb_dev = usbatm->usb_dev;
663 	struct speedtch_instance_data *instance = usbatm->driver_data;
664 	int i, ret;
665 	unsigned char mac_str[13];
666 
667 	atm_dbg(usbatm, "%s entered\n", __func__);
668 
669 	/* Set MAC address, it is stored in the serial number */
670 	memset(atm_dev->esi, 0, sizeof(atm_dev->esi));
671 	if (usb_string(usb_dev, usb_dev->descriptor.iSerialNumber, mac_str, sizeof(mac_str)) == 12) {
672 		for (i = 0; i < 6; i++)
673 			atm_dev->esi[i] = (hex_to_bin(mac_str[i * 2]) << 4) +
674 				hex_to_bin(mac_str[i * 2 + 1]);
675 	}
676 
677 	/* Start modem synchronisation */
678 	ret = speedtch_start_synchro(instance);
679 
680 	/* Set up interrupt endpoint */
681 	if (instance->int_urb) {
682 		ret = usb_submit_urb(instance->int_urb, GFP_KERNEL);
683 		if (ret < 0) {
684 			/* Doesn't matter; we'll poll anyway */
685 			atm_dbg(usbatm, "%s: submission of interrupt URB failed (%d)!\n", __func__, ret);
686 			usb_free_urb(instance->int_urb);
687 			instance->int_urb = NULL;
688 		}
689 	}
690 
691 	/* Start status polling */
692 	mod_timer(&instance->status_check_timer, jiffies + msecs_to_jiffies(1000));
693 
694 	return 0;
695 }
696 
697 static void speedtch_atm_stop(struct usbatm_data *usbatm, struct atm_dev *atm_dev)
698 {
699 	struct speedtch_instance_data *instance = usbatm->driver_data;
700 	struct urb *int_urb = instance->int_urb;
701 
702 	atm_dbg(usbatm, "%s entered\n", __func__);
703 
704 	del_timer_sync(&instance->status_check_timer);
705 
706 	/*
707 	 * Since resubmit_timer and int_urb can schedule themselves and
708 	 * each other, shutting them down correctly takes some care
709 	 */
710 	instance->int_urb = NULL; /* signal shutdown */
711 	mb();
712 	usb_kill_urb(int_urb);
713 	del_timer_sync(&instance->resubmit_timer);
714 	/*
715 	 * At this point, speedtch_handle_int and speedtch_resubmit_int
716 	 * can run or be running, but instance->int_urb == NULL means that
717 	 * they will not reschedule
718 	 */
719 	usb_kill_urb(int_urb);
720 	del_timer_sync(&instance->resubmit_timer);
721 	usb_free_urb(int_urb);
722 
723 	flush_work(&instance->status_check_work);
724 }
725 
726 static int speedtch_pre_reset(struct usb_interface *intf)
727 {
728 	return 0;
729 }
730 
731 static int speedtch_post_reset(struct usb_interface *intf)
732 {
733 	return 0;
734 }
735 
736 
737 /**********
738 **  USB  **
739 **********/
740 
741 static struct usb_device_id speedtch_usb_ids[] = {
742 	{USB_DEVICE(0x06b9, 0x4061)},
743 	{}
744 };
745 
746 MODULE_DEVICE_TABLE(usb, speedtch_usb_ids);
747 
748 static int speedtch_usb_probe(struct usb_interface *, const struct usb_device_id *);
749 
750 static struct usb_driver speedtch_usb_driver = {
751 	.name		= speedtch_driver_name,
752 	.probe		= speedtch_usb_probe,
753 	.disconnect	= usbatm_usb_disconnect,
754 	.pre_reset	= speedtch_pre_reset,
755 	.post_reset	= speedtch_post_reset,
756 	.id_table	= speedtch_usb_ids
757 };
758 
759 static void speedtch_release_interfaces(struct usb_device *usb_dev,
760 					int num_interfaces)
761 {
762 	struct usb_interface *cur_intf;
763 	int i;
764 
765 	for (i = 0; i < num_interfaces; i++) {
766 		cur_intf = usb_ifnum_to_if(usb_dev, i);
767 		if (cur_intf) {
768 			usb_set_intfdata(cur_intf, NULL);
769 			usb_driver_release_interface(&speedtch_usb_driver, cur_intf);
770 		}
771 	}
772 }
773 
774 static int speedtch_bind(struct usbatm_data *usbatm,
775 			 struct usb_interface *intf,
776 			 const struct usb_device_id *id)
777 {
778 	struct usb_device *usb_dev = interface_to_usbdev(intf);
779 	struct usb_interface *cur_intf, *data_intf;
780 	struct speedtch_instance_data *instance;
781 	int ifnum = intf->altsetting->desc.bInterfaceNumber;
782 	int num_interfaces = usb_dev->actconfig->desc.bNumInterfaces;
783 	int i, ret;
784 	int use_isoc;
785 
786 	usb_dbg(usbatm, "%s entered\n", __func__);
787 
788 	/* sanity checks */
789 
790 	if (usb_dev->descriptor.bDeviceClass != USB_CLASS_VENDOR_SPEC) {
791 		usb_err(usbatm, "%s: wrong device class %d\n", __func__, usb_dev->descriptor.bDeviceClass);
792 		return -ENODEV;
793 	}
794 
795 	data_intf = usb_ifnum_to_if(usb_dev, INTERFACE_DATA);
796 	if (!data_intf) {
797 		usb_err(usbatm, "%s: data interface not found!\n", __func__);
798 		return -ENODEV;
799 	}
800 
801 	/* claim all interfaces */
802 
803 	for (i = 0; i < num_interfaces; i++) {
804 		cur_intf = usb_ifnum_to_if(usb_dev, i);
805 
806 		if ((i != ifnum) && cur_intf) {
807 			ret = usb_driver_claim_interface(&speedtch_usb_driver, cur_intf, usbatm);
808 
809 			if (ret < 0) {
810 				usb_err(usbatm, "%s: failed to claim interface %2d (%d)!\n", __func__, i, ret);
811 				speedtch_release_interfaces(usb_dev, i);
812 				return ret;
813 			}
814 		}
815 	}
816 
817 	instance = kzalloc(sizeof(*instance), GFP_KERNEL);
818 
819 	if (!instance) {
820 		ret = -ENOMEM;
821 		goto fail_release;
822 	}
823 
824 	instance->usbatm = usbatm;
825 
826 	/* module parameters may change at any moment, so take a snapshot */
827 	instance->params.altsetting = altsetting;
828 	instance->params.BMaxDSL = BMaxDSL;
829 	instance->params.ModemMode = ModemMode;
830 	memcpy(instance->params.ModemOption, DEFAULT_MODEM_OPTION, MODEM_OPTION_LENGTH);
831 	memcpy(instance->params.ModemOption, ModemOption, num_ModemOption);
832 	use_isoc = enable_isoc;
833 
834 	if (instance->params.altsetting)
835 		if ((ret = usb_set_interface(usb_dev, INTERFACE_DATA, instance->params.altsetting)) < 0) {
836 			usb_err(usbatm, "%s: setting interface to %2d failed (%d)!\n", __func__, instance->params.altsetting, ret);
837 			instance->params.altsetting = 0; /* fall back to default */
838 		}
839 
840 	if (!instance->params.altsetting && use_isoc)
841 		if ((ret = usb_set_interface(usb_dev, INTERFACE_DATA, DEFAULT_ISOC_ALTSETTING)) < 0) {
842 			usb_dbg(usbatm, "%s: setting interface to %2d failed (%d)!\n", __func__, DEFAULT_ISOC_ALTSETTING, ret);
843 			use_isoc = 0; /* fall back to bulk */
844 		}
845 
846 	if (use_isoc) {
847 		const struct usb_host_interface *desc = data_intf->cur_altsetting;
848 		const __u8 target_address = USB_DIR_IN | usbatm->driver->isoc_in;
849 
850 		use_isoc = 0; /* fall back to bulk if endpoint not found */
851 
852 		for (i = 0; i < desc->desc.bNumEndpoints; i++) {
853 			const struct usb_endpoint_descriptor *endpoint_desc = &desc->endpoint[i].desc;
854 
855 			if ((endpoint_desc->bEndpointAddress == target_address)) {
856 				use_isoc =
857 					usb_endpoint_xfer_isoc(endpoint_desc);
858 				break;
859 			}
860 		}
861 
862 		if (!use_isoc)
863 			usb_info(usbatm, "isochronous transfer not supported - using bulk\n");
864 	}
865 
866 	if (!use_isoc && !instance->params.altsetting)
867 		if ((ret = usb_set_interface(usb_dev, INTERFACE_DATA, DEFAULT_BULK_ALTSETTING)) < 0) {
868 			usb_err(usbatm, "%s: setting interface to %2d failed (%d)!\n", __func__, DEFAULT_BULK_ALTSETTING, ret);
869 			goto fail_free;
870 		}
871 
872 	if (!instance->params.altsetting)
873 		instance->params.altsetting = use_isoc ? DEFAULT_ISOC_ALTSETTING : DEFAULT_BULK_ALTSETTING;
874 
875 	usbatm->flags |= (use_isoc ? UDSL_USE_ISOC : 0);
876 
877 	INIT_WORK(&instance->status_check_work, speedtch_check_status);
878 	init_timer(&instance->status_check_timer);
879 
880 	instance->status_check_timer.function = speedtch_status_poll;
881 	instance->status_check_timer.data = (unsigned long)instance;
882 	instance->last_status = 0xff;
883 	instance->poll_delay = MIN_POLL_DELAY;
884 
885 	init_timer(&instance->resubmit_timer);
886 	instance->resubmit_timer.function = speedtch_resubmit_int;
887 	instance->resubmit_timer.data = (unsigned long)instance;
888 
889 	instance->int_urb = usb_alloc_urb(0, GFP_KERNEL);
890 
891 	if (instance->int_urb)
892 		usb_fill_int_urb(instance->int_urb, usb_dev,
893 				 usb_rcvintpipe(usb_dev, ENDPOINT_INT),
894 				 instance->int_data, sizeof(instance->int_data),
895 				 speedtch_handle_int, instance, 16);
896 	else
897 		usb_dbg(usbatm, "%s: no memory for interrupt urb!\n", __func__);
898 
899 	/* check whether the modem already seems to be alive */
900 	ret = usb_control_msg(usb_dev, usb_rcvctrlpipe(usb_dev, 0),
901 			      0x12, 0xc0, 0x07, 0x00,
902 			      instance->scratch_buffer + OFFSET_7, SIZE_7, 500);
903 
904 	usbatm->flags |= (ret == SIZE_7 ? UDSL_SKIP_HEAVY_INIT : 0);
905 
906 	usb_dbg(usbatm, "%s: firmware %s loaded\n", __func__, usbatm->flags & UDSL_SKIP_HEAVY_INIT ? "already" : "not");
907 
908 	if (!(usbatm->flags & UDSL_SKIP_HEAVY_INIT))
909 		if ((ret = usb_reset_device(usb_dev)) < 0) {
910 			usb_err(usbatm, "%s: device reset failed (%d)!\n", __func__, ret);
911 			goto fail_free;
912 		}
913 
914         usbatm->driver_data = instance;
915 
916 	return 0;
917 
918 fail_free:
919 	usb_free_urb(instance->int_urb);
920 	kfree(instance);
921 fail_release:
922 	speedtch_release_interfaces(usb_dev, num_interfaces);
923 	return ret;
924 }
925 
926 static void speedtch_unbind(struct usbatm_data *usbatm, struct usb_interface *intf)
927 {
928 	struct usb_device *usb_dev = interface_to_usbdev(intf);
929 	struct speedtch_instance_data *instance = usbatm->driver_data;
930 
931 	usb_dbg(usbatm, "%s entered\n", __func__);
932 
933 	speedtch_release_interfaces(usb_dev, usb_dev->actconfig->desc.bNumInterfaces);
934 	usb_free_urb(instance->int_urb);
935 	kfree(instance);
936 }
937 
938 
939 /***********
940 **  init  **
941 ***********/
942 
943 static struct usbatm_driver speedtch_usbatm_driver = {
944 	.driver_name	= speedtch_driver_name,
945 	.bind		= speedtch_bind,
946 	.heavy_init	= speedtch_heavy_init,
947 	.unbind		= speedtch_unbind,
948 	.atm_start	= speedtch_atm_start,
949 	.atm_stop	= speedtch_atm_stop,
950 	.bulk_in	= ENDPOINT_BULK_DATA,
951 	.bulk_out	= ENDPOINT_BULK_DATA,
952 	.isoc_in	= ENDPOINT_ISOC_DATA
953 };
954 
955 static int speedtch_usb_probe(struct usb_interface *intf, const struct usb_device_id *id)
956 {
957 	return usbatm_usb_probe(intf, id, &speedtch_usbatm_driver);
958 }
959 
960 module_usb_driver(speedtch_usb_driver);
961 
962 MODULE_AUTHOR(DRIVER_AUTHOR);
963 MODULE_DESCRIPTION(DRIVER_DESC);
964 MODULE_LICENSE("GPL");
965 MODULE_VERSION(DRIVER_VERSION);
966