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