1 // SPDX-License-Identifier: GPL-2.0+
2 /******************************************************************************
3 * cxacru.c - driver for USB ADSL modems based on
4 * Conexant AccessRunner chipset
6 * Copyright (C) 2004 David Woodhouse, Duncan Sands, Roman Kagan
7 * Copyright (C) 2005 Duncan Sands, Roman Kagan (rkagan % mail ! ru)
8 * Copyright (C) 2007 Simon Arlott
9 * Copyright (C) 2009 Simon Arlott
10 ******************************************************************************/
13 * Credit is due for Josep Comas, who created the original patch to speedtch.c
14 * to support the different padding used by the AccessRunner (now generalized
15 * into usbatm), and the userspace firmware loading utility.
18 #include <linux/module.h>
19 #include <linux/moduleparam.h>
20 #include <linux/kernel.h>
21 #include <linux/timer.h>
22 #include <linux/errno.h>
23 #include <linux/slab.h>
24 #include <linux/device.h>
25 #include <linux/firmware.h>
26 #include <linux/mutex.h>
27 #include <asm/unaligned.h>
31 #define DRIVER_AUTHOR "Roman Kagan, David Woodhouse, Duncan Sands, Simon Arlott"
32 #define DRIVER_DESC "Conexant AccessRunner ADSL USB modem driver"
34 static const char cxacru_driver_name[] = "cxacru";
36 #define CXACRU_EP_CMD 0x01 /* Bulk/interrupt in/out */
37 #define CXACRU_EP_DATA 0x02 /* Bulk in/out */
39 #define CMD_PACKET_SIZE 64 /* Should be maxpacket(ep)? */
40 #define CMD_MAX_CONFIG ((CMD_PACKET_SIZE / 4 - 1) / 2)
43 #define PLLFCLK_ADDR 0x00350068
44 #define PLLBCLK_ADDR 0x0035006c
45 #define SDRAMEN_ADDR 0x00350010
46 #define FW_ADDR 0x00801000
47 #define BR_ADDR 0x00180600
48 #define SIG_ADDR 0x00180500
49 #define BR_STACK_ADDR 0x00187f10
54 #define CMD_TIMEOUT 2000 /* msecs */
55 #define POLL_INTERVAL 1 /* secs */
57 /* commands for interaction with the modem through the control channel before
58 * firmware is loaded */
59 enum cxacru_fw_request {
69 /* commands for interaction with the modem through the control channel once
70 * firmware is loaded */
71 enum cxacru_cm_request {
72 CM_REQUEST_UNDEFINED = 0x80,
74 CM_REQUEST_CHIP_GET_MAC_ADDRESS,
75 CM_REQUEST_CHIP_GET_DP_VERSIONS,
76 CM_REQUEST_CHIP_ADSL_LINE_START,
77 CM_REQUEST_CHIP_ADSL_LINE_STOP,
78 CM_REQUEST_CHIP_ADSL_LINE_GET_STATUS,
79 CM_REQUEST_CHIP_ADSL_LINE_GET_SPEED,
80 CM_REQUEST_CARD_INFO_GET,
81 CM_REQUEST_CARD_DATA_GET,
82 CM_REQUEST_CARD_DATA_SET,
83 CM_REQUEST_COMMAND_HW_IO,
84 CM_REQUEST_INTERFACE_HW_IO,
85 CM_REQUEST_CARD_SERIAL_DATA_PATH_GET,
86 CM_REQUEST_CARD_SERIAL_DATA_PATH_SET,
87 CM_REQUEST_CARD_CONTROLLER_VERSION_GET,
88 CM_REQUEST_CARD_GET_STATUS,
89 CM_REQUEST_CARD_GET_MAC_ADDRESS,
90 CM_REQUEST_CARD_GET_DATA_LINK_STATUS,
94 /* commands for interaction with the flash memory
96 * read: response is the contents of the first 60 bytes of flash memory
97 * write: request contains the 60 bytes of data to write to flash memory
98 * response is the contents of the first 60 bytes of flash memory
100 * layout: PP PP VV VV MM MM MM MM MM MM ?? ?? SS SS SS SS SS SS SS SS
101 * SS SS SS SS SS SS SS SS 00 00 00 00 00 00 00 00 00 00 00 00
102 * 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
104 * P: le16 USB Product ID
105 * V: le16 USB Vendor ID
106 * M: be48 MAC Address
107 * S: le16 ASCII Serial Number
109 enum cxacru_cm_flash {
110 CM_FLASH_READ = 0xa1,
111 CM_FLASH_WRITE = 0xa2
114 /* reply codes to the commands above */
115 enum cxacru_cm_status {
119 CM_STATUS_UNSUPPORTED,
120 CM_STATUS_UNIMPLEMENTED,
121 CM_STATUS_PARAMETER_ERROR,
122 CM_STATUS_DBG_LOOPBACK,
126 /* indices into CARD_INFO_GET return array */
127 enum cxacru_info_idx {
128 CXINF_DOWNSTREAM_RATE,
132 CXINF_MAC_ADDRESS_HIGH,
133 CXINF_MAC_ADDRESS_LOW,
134 CXINF_UPSTREAM_SNR_MARGIN,
135 CXINF_DOWNSTREAM_SNR_MARGIN,
136 CXINF_UPSTREAM_ATTENUATION,
137 CXINF_DOWNSTREAM_ATTENUATION,
138 CXINF_TRANSMITTER_POWER,
139 CXINF_UPSTREAM_BITS_PER_FRAME,
140 CXINF_DOWNSTREAM_BITS_PER_FRAME,
141 CXINF_STARTUP_ATTEMPTS,
142 CXINF_UPSTREAM_CRC_ERRORS,
143 CXINF_DOWNSTREAM_CRC_ERRORS,
144 CXINF_UPSTREAM_FEC_ERRORS,
145 CXINF_DOWNSTREAM_FEC_ERRORS,
146 CXINF_UPSTREAM_HEC_ERRORS,
147 CXINF_DOWNSTREAM_HEC_ERRORS,
148 CXINF_LINE_STARTABLE,
151 CXINF_ADSL_HEADEND_ENVIRONMENT,
152 CXINF_CONTROLLER_VERSION,
153 /* dunno what the missing two mean */
157 enum cxacru_poll_state {
164 struct cxacru_modem_type {
171 struct usbatm_data *usbatm;
173 const struct cxacru_modem_type *modem_type;
176 struct mutex adsl_state_serialize;
178 struct delayed_work poll_work;
179 u32 card_info[CXINF_MAX];
180 struct mutex poll_state_serialize;
181 enum cxacru_poll_state poll_state;
183 /* control handles */
184 struct mutex cm_serialize;
189 struct completion rcv_done;
190 struct completion snd_done;
193 static int cxacru_cm(struct cxacru_data *instance, enum cxacru_cm_request cm,
194 u8 *wdata, int wsize, u8 *rdata, int rsize);
195 static void cxacru_poll_status(struct work_struct *work);
197 /* Card info exported through sysfs */
198 #define CXACRU__ATTR_INIT(_name) \
199 static DEVICE_ATTR_RO(_name)
201 #define CXACRU_CMD_INIT(_name) \
202 static DEVICE_ATTR_RW(_name)
204 #define CXACRU_SET_INIT(_name) \
205 static DEVICE_ATTR_WO(_name)
207 #define CXACRU_ATTR_INIT(_value, _type, _name) \
208 static ssize_t _name##_show(struct device *dev, \
209 struct device_attribute *attr, char *buf) \
211 struct cxacru_data *instance = to_usbatm_driver_data(\
212 to_usb_interface(dev)); \
214 if (instance == NULL) \
217 return cxacru_sysfs_showattr_##_type(instance->card_info[_value], buf); \
219 CXACRU__ATTR_INIT(_name)
221 #define CXACRU_ATTR_CREATE(_v, _t, _name) CXACRU_DEVICE_CREATE_FILE(_name)
222 #define CXACRU_CMD_CREATE(_name) CXACRU_DEVICE_CREATE_FILE(_name)
223 #define CXACRU_SET_CREATE(_name) CXACRU_DEVICE_CREATE_FILE(_name)
224 #define CXACRU__ATTR_CREATE(_name) CXACRU_DEVICE_CREATE_FILE(_name)
226 #define CXACRU_ATTR_REMOVE(_v, _t, _name) CXACRU_DEVICE_REMOVE_FILE(_name)
227 #define CXACRU_CMD_REMOVE(_name) CXACRU_DEVICE_REMOVE_FILE(_name)
228 #define CXACRU_SET_REMOVE(_name) CXACRU_DEVICE_REMOVE_FILE(_name)
229 #define CXACRU__ATTR_REMOVE(_name) CXACRU_DEVICE_REMOVE_FILE(_name)
231 static ssize_t cxacru_sysfs_showattr_u32(u32 value, char *buf)
233 return sprintf(buf, "%u\n", value);
236 static ssize_t cxacru_sysfs_showattr_s8(s8 value, char *buf)
238 return sprintf(buf, "%d\n", value);
241 static ssize_t cxacru_sysfs_showattr_dB(s16 value, char *buf)
243 if (likely(value >= 0)) {
244 return snprintf(buf, PAGE_SIZE, "%u.%02u\n",
245 value / 100, value % 100);
248 return snprintf(buf, PAGE_SIZE, "-%u.%02u\n",
249 value / 100, value % 100);
253 static ssize_t cxacru_sysfs_showattr_bool(u32 value, char *buf)
255 static char *str[] = { "no", "yes" };
257 if (unlikely(value >= ARRAY_SIZE(str)))
258 return sprintf(buf, "%u\n", value);
259 return sprintf(buf, "%s\n", str[value]);
262 static ssize_t cxacru_sysfs_showattr_LINK(u32 value, char *buf)
264 static char *str[] = { NULL, "not connected", "connected", "lost" };
266 if (unlikely(value >= ARRAY_SIZE(str) || str[value] == NULL))
267 return sprintf(buf, "%u\n", value);
268 return sprintf(buf, "%s\n", str[value]);
271 static ssize_t cxacru_sysfs_showattr_LINE(u32 value, char *buf)
273 static char *str[] = { "down", "attempting to activate",
274 "training", "channel analysis", "exchange", "up",
275 "waiting", "initialising"
277 if (unlikely(value >= ARRAY_SIZE(str)))
278 return sprintf(buf, "%u\n", value);
279 return sprintf(buf, "%s\n", str[value]);
282 static ssize_t cxacru_sysfs_showattr_MODU(u32 value, char *buf)
284 static char *str[] = {
287 "ITU-T G.992.1 (G.DMT)",
288 "ITU-T G.992.2 (G.LITE)"
290 if (unlikely(value >= ARRAY_SIZE(str)))
291 return sprintf(buf, "%u\n", value);
292 return sprintf(buf, "%s\n", str[value]);
296 * This could use MAC_ADDRESS_HIGH and MAC_ADDRESS_LOW, but since
297 * this data is already in atm_dev there's no point.
299 * MAC_ADDRESS_HIGH = 0x????5544
300 * MAC_ADDRESS_LOW = 0x33221100
301 * Where 00-55 are bytes 0-5 of the MAC.
303 static ssize_t mac_address_show(struct device *dev,
304 struct device_attribute *attr, char *buf)
306 struct cxacru_data *instance = to_usbatm_driver_data(
307 to_usb_interface(dev));
309 if (instance == NULL || instance->usbatm->atm_dev == NULL)
312 return sprintf(buf, "%pM\n", instance->usbatm->atm_dev->esi);
315 static ssize_t adsl_state_show(struct device *dev,
316 struct device_attribute *attr, char *buf)
318 static char *str[] = { "running", "stopped" };
319 struct cxacru_data *instance = to_usbatm_driver_data(
320 to_usb_interface(dev));
323 if (instance == NULL)
326 value = instance->card_info[CXINF_LINE_STARTABLE];
327 if (unlikely(value >= ARRAY_SIZE(str)))
328 return sprintf(buf, "%u\n", value);
329 return sprintf(buf, "%s\n", str[value]);
332 static ssize_t adsl_state_store(struct device *dev,
333 struct device_attribute *attr, const char *buf, size_t count)
335 struct cxacru_data *instance = to_usbatm_driver_data(
336 to_usb_interface(dev));
340 int len = strlen(buf);
342 if (!capable(CAP_NET_ADMIN))
345 ret = sscanf(buf, "%7s", str_cmd);
350 if (instance == NULL)
353 if (mutex_lock_interruptible(&instance->adsl_state_serialize))
356 if (!strcmp(str_cmd, "stop") || !strcmp(str_cmd, "restart")) {
357 ret = cxacru_cm(instance, CM_REQUEST_CHIP_ADSL_LINE_STOP, NULL, 0, NULL, 0);
359 atm_err(instance->usbatm, "change adsl state:"
360 " CHIP_ADSL_LINE_STOP returned %d\n", ret);
365 poll = CXPOLL_STOPPED;
369 /* Line status is only updated every second
370 * and the device appears to only react to
371 * START/STOP every second too. Wait 1.5s to
372 * be sure that restart will have an effect. */
373 if (!strcmp(str_cmd, "restart"))
376 if (!strcmp(str_cmd, "start") || !strcmp(str_cmd, "restart")) {
377 ret = cxacru_cm(instance, CM_REQUEST_CHIP_ADSL_LINE_START, NULL, 0, NULL, 0);
379 atm_err(instance->usbatm, "change adsl state:"
380 " CHIP_ADSL_LINE_START returned %d\n", ret);
385 poll = CXPOLL_POLLING;
389 if (!strcmp(str_cmd, "poll")) {
391 poll = CXPOLL_POLLING;
399 if (poll == CXPOLL_POLLING) {
400 mutex_lock(&instance->poll_state_serialize);
401 switch (instance->poll_state) {
404 instance->poll_state = CXPOLL_POLLING;
407 case CXPOLL_STOPPING:
408 /* abort stop request */
409 instance->poll_state = CXPOLL_POLLING;
412 case CXPOLL_SHUTDOWN:
413 /* don't start polling */
416 mutex_unlock(&instance->poll_state_serialize);
417 } else if (poll == CXPOLL_STOPPED) {
418 mutex_lock(&instance->poll_state_serialize);
420 if (instance->poll_state == CXPOLL_POLLING)
421 instance->poll_state = CXPOLL_STOPPING;
422 mutex_unlock(&instance->poll_state_serialize);
425 mutex_unlock(&instance->adsl_state_serialize);
427 if (poll == CXPOLL_POLLING)
428 cxacru_poll_status(&instance->poll_work.work);
433 /* CM_REQUEST_CARD_DATA_GET times out, so no show attribute */
435 static ssize_t adsl_config_store(struct device *dev,
436 struct device_attribute *attr, const char *buf, size_t count)
438 struct cxacru_data *instance = to_usbatm_driver_data(
439 to_usb_interface(dev));
440 int len = strlen(buf);
442 __le32 data[CMD_PACKET_SIZE / 4];
444 if (!capable(CAP_NET_ADMIN))
447 if (instance == NULL)
457 ret = sscanf(buf + pos, "%x=%x%n", &index, &value, &tmp);
462 if (tmp < 0 || tmp > len - pos)
466 /* skip trailing newline */
467 if (buf[pos] == '\n' && pos == len-1)
470 data[num * 2 + 1] = cpu_to_le32(index);
471 data[num * 2 + 2] = cpu_to_le32(value);
474 /* send config values when data buffer is full
477 if (pos >= len || num >= CMD_MAX_CONFIG) {
478 char log[CMD_MAX_CONFIG * 12 + 1]; /* %02x=%08x */
480 data[0] = cpu_to_le32(num);
481 ret = cxacru_cm(instance, CM_REQUEST_CARD_DATA_SET,
482 (u8 *) data, 4 + num * 8, NULL, 0);
484 atm_err(instance->usbatm,
485 "set card data returned %d\n", ret);
489 for (tmp = 0; tmp < num; tmp++)
490 snprintf(log + tmp*12, 13, " %02x=%08x",
491 le32_to_cpu(data[tmp * 2 + 1]),
492 le32_to_cpu(data[tmp * 2 + 2]));
493 atm_info(instance->usbatm, "config%s\n", log);
502 * All device attributes are included in CXACRU_ALL_FILES
503 * so that the same list can be used multiple times:
504 * INIT (define the device attributes)
505 * CREATE (create all the device files)
506 * REMOVE (remove all the device files)
508 * With the last two being defined as needed in the functions
509 * they are used in before calling CXACRU_ALL_FILES()
511 #define CXACRU_ALL_FILES(_action) \
512 CXACRU_ATTR_##_action(CXINF_DOWNSTREAM_RATE, u32, downstream_rate); \
513 CXACRU_ATTR_##_action(CXINF_UPSTREAM_RATE, u32, upstream_rate); \
514 CXACRU_ATTR_##_action(CXINF_LINK_STATUS, LINK, link_status); \
515 CXACRU_ATTR_##_action(CXINF_LINE_STATUS, LINE, line_status); \
516 CXACRU__ATTR_##_action( mac_address); \
517 CXACRU_ATTR_##_action(CXINF_UPSTREAM_SNR_MARGIN, dB, upstream_snr_margin); \
518 CXACRU_ATTR_##_action(CXINF_DOWNSTREAM_SNR_MARGIN, dB, downstream_snr_margin); \
519 CXACRU_ATTR_##_action(CXINF_UPSTREAM_ATTENUATION, dB, upstream_attenuation); \
520 CXACRU_ATTR_##_action(CXINF_DOWNSTREAM_ATTENUATION, dB, downstream_attenuation); \
521 CXACRU_ATTR_##_action(CXINF_TRANSMITTER_POWER, s8, transmitter_power); \
522 CXACRU_ATTR_##_action(CXINF_UPSTREAM_BITS_PER_FRAME, u32, upstream_bits_per_frame); \
523 CXACRU_ATTR_##_action(CXINF_DOWNSTREAM_BITS_PER_FRAME, u32, downstream_bits_per_frame); \
524 CXACRU_ATTR_##_action(CXINF_STARTUP_ATTEMPTS, u32, startup_attempts); \
525 CXACRU_ATTR_##_action(CXINF_UPSTREAM_CRC_ERRORS, u32, upstream_crc_errors); \
526 CXACRU_ATTR_##_action(CXINF_DOWNSTREAM_CRC_ERRORS, u32, downstream_crc_errors); \
527 CXACRU_ATTR_##_action(CXINF_UPSTREAM_FEC_ERRORS, u32, upstream_fec_errors); \
528 CXACRU_ATTR_##_action(CXINF_DOWNSTREAM_FEC_ERRORS, u32, downstream_fec_errors); \
529 CXACRU_ATTR_##_action(CXINF_UPSTREAM_HEC_ERRORS, u32, upstream_hec_errors); \
530 CXACRU_ATTR_##_action(CXINF_DOWNSTREAM_HEC_ERRORS, u32, downstream_hec_errors); \
531 CXACRU_ATTR_##_action(CXINF_LINE_STARTABLE, bool, line_startable); \
532 CXACRU_ATTR_##_action(CXINF_MODULATION, MODU, modulation); \
533 CXACRU_ATTR_##_action(CXINF_ADSL_HEADEND, u32, adsl_headend); \
534 CXACRU_ATTR_##_action(CXINF_ADSL_HEADEND_ENVIRONMENT, u32, adsl_headend_environment); \
535 CXACRU_ATTR_##_action(CXINF_CONTROLLER_VERSION, u32, adsl_controller_version); \
536 CXACRU_CMD_##_action( adsl_state); \
537 CXACRU_SET_##_action( adsl_config);
539 CXACRU_ALL_FILES(INIT);
541 static struct attribute *cxacru_attrs[] = {
542 &dev_attr_adsl_config.attr,
543 &dev_attr_adsl_state.attr,
544 &dev_attr_adsl_controller_version.attr,
545 &dev_attr_adsl_headend_environment.attr,
546 &dev_attr_adsl_headend.attr,
547 &dev_attr_modulation.attr,
548 &dev_attr_line_startable.attr,
549 &dev_attr_downstream_hec_errors.attr,
550 &dev_attr_upstream_hec_errors.attr,
551 &dev_attr_downstream_fec_errors.attr,
552 &dev_attr_upstream_fec_errors.attr,
553 &dev_attr_downstream_crc_errors.attr,
554 &dev_attr_upstream_crc_errors.attr,
555 &dev_attr_startup_attempts.attr,
556 &dev_attr_downstream_bits_per_frame.attr,
557 &dev_attr_upstream_bits_per_frame.attr,
558 &dev_attr_transmitter_power.attr,
559 &dev_attr_downstream_attenuation.attr,
560 &dev_attr_upstream_attenuation.attr,
561 &dev_attr_downstream_snr_margin.attr,
562 &dev_attr_upstream_snr_margin.attr,
563 &dev_attr_mac_address.attr,
564 &dev_attr_line_status.attr,
565 &dev_attr_link_status.attr,
566 &dev_attr_upstream_rate.attr,
567 &dev_attr_downstream_rate.attr,
570 ATTRIBUTE_GROUPS(cxacru);
572 /* the following three functions are stolen from drivers/usb/core/message.c */
573 static void cxacru_blocking_completion(struct urb *urb)
575 complete(urb->context);
578 struct cxacru_timer {
579 struct timer_list timer;
583 static void cxacru_timeout_kill(struct timer_list *t)
585 struct cxacru_timer *timer = from_timer(timer, t, timer);
587 usb_unlink_urb(timer->urb);
590 static int cxacru_start_wait_urb(struct urb *urb, struct completion *done,
593 struct cxacru_timer timer = {
597 timer_setup_on_stack(&timer.timer, cxacru_timeout_kill, 0);
598 mod_timer(&timer.timer, jiffies + msecs_to_jiffies(CMD_TIMEOUT));
599 wait_for_completion(done);
600 del_timer_sync(&timer.timer);
601 destroy_timer_on_stack(&timer.timer);
604 *actual_length = urb->actual_length;
605 return urb->status; /* must read status after completion */
608 static int cxacru_cm(struct cxacru_data *instance, enum cxacru_cm_request cm,
609 u8 *wdata, int wsize, u8 *rdata, int rsize)
613 const int stride = CMD_PACKET_SIZE - 4;
614 u8 *wbuf = instance->snd_buf;
615 u8 *rbuf = instance->rcv_buf;
616 int wbuflen = ((wsize - 1) / stride + 1) * CMD_PACKET_SIZE;
617 int rbuflen = ((rsize - 1) / stride + 1) * CMD_PACKET_SIZE;
619 if (wbuflen > PAGE_SIZE || rbuflen > PAGE_SIZE) {
620 if (printk_ratelimit())
621 usb_err(instance->usbatm, "requested transfer size too large (%d, %d)\n",
627 mutex_lock(&instance->cm_serialize);
629 /* submit reading urb before the writing one */
630 init_completion(&instance->rcv_done);
631 ret = usb_submit_urb(instance->rcv_urb, GFP_KERNEL);
633 if (printk_ratelimit())
634 usb_err(instance->usbatm, "submit of read urb for cm %#x failed (%d)\n",
639 memset(wbuf, 0, wbuflen);
640 /* handle wsize == 0 */
642 for (offb = offd = 0; offd < wsize; offd += stride, offb += CMD_PACKET_SIZE) {
644 memcpy(wbuf + offb + 4, wdata + offd, min_t(int, stride, wsize - offd));
647 instance->snd_urb->transfer_buffer_length = wbuflen;
648 init_completion(&instance->snd_done);
649 ret = usb_submit_urb(instance->snd_urb, GFP_KERNEL);
651 if (printk_ratelimit())
652 usb_err(instance->usbatm, "submit of write urb for cm %#x failed (%d)\n",
657 ret = cxacru_start_wait_urb(instance->snd_urb, &instance->snd_done, NULL);
659 if (printk_ratelimit())
660 usb_err(instance->usbatm, "send of cm %#x failed (%d)\n", cm, ret);
664 ret = cxacru_start_wait_urb(instance->rcv_urb, &instance->rcv_done, &actlen);
666 if (printk_ratelimit())
667 usb_err(instance->usbatm, "receive of cm %#x failed (%d)\n", cm, ret);
670 if (actlen % CMD_PACKET_SIZE || !actlen) {
671 if (printk_ratelimit())
672 usb_err(instance->usbatm, "invalid response length to cm %#x: %d\n",
678 /* check the return status and copy the data to the output buffer, if needed */
679 for (offb = offd = 0; offd < rsize && offb < actlen; offb += CMD_PACKET_SIZE) {
680 if (rbuf[offb] != cm) {
681 if (printk_ratelimit())
682 usb_err(instance->usbatm, "wrong cm %#x in response to cm %#x\n",
687 if (rbuf[offb + 1] != CM_STATUS_SUCCESS) {
688 if (printk_ratelimit())
689 usb_err(instance->usbatm, "response to cm %#x failed: %#x\n",
696 memcpy(rdata + offd, rbuf + offb + 4, min_t(int, stride, rsize - offd));
701 usb_dbg(instance->usbatm, "cm %#x\n", cm);
703 mutex_unlock(&instance->cm_serialize);
708 static int cxacru_cm_get_array(struct cxacru_data *instance, enum cxacru_cm_request cm,
715 const int stride = CMD_PACKET_SIZE / (4 * 2) - 1;
716 int buflen = ((size - 1) / stride + 1 + size * 2) * 4;
718 buf = kmalloc(buflen, GFP_KERNEL);
722 ret = cxacru_cm(instance, cm, NULL, 0, (u8 *) buf, buflen);
726 /* len > 0 && len % 4 == 0 guaranteed by cxacru_cm() */
728 for (offb = 0; offb < len; ) {
729 int l = le32_to_cpu(buf[offb++]);
731 if (l < 0 || l > stride || l > (len - offb) / 2) {
732 if (printk_ratelimit())
733 usb_err(instance->usbatm, "invalid data length from cm %#x: %d\n",
739 offd = le32_to_cpu(buf[offb++]);
741 if (printk_ratelimit())
742 usb_err(instance->usbatm, "wrong index %#x in response to cm %#x\n",
747 data[offd] = le32_to_cpu(buf[offb++]);
758 static int cxacru_card_status(struct cxacru_data *instance)
760 int ret = cxacru_cm(instance, CM_REQUEST_CARD_GET_STATUS, NULL, 0, NULL, 0);
762 if (ret < 0) { /* firmware not loaded */
763 usb_dbg(instance->usbatm, "cxacru_adsl_start: CARD_GET_STATUS returned %d\n", ret);
769 static int cxacru_atm_start(struct usbatm_data *usbatm_instance,
770 struct atm_dev *atm_dev)
772 struct cxacru_data *instance = usbatm_instance->driver_data;
773 struct usb_interface *intf = usbatm_instance->usb_intf;
775 int start_polling = 1;
777 dev_dbg(&intf->dev, "%s\n", __func__);
779 /* Read MAC address */
780 ret = cxacru_cm(instance, CM_REQUEST_CARD_GET_MAC_ADDRESS, NULL, 0,
781 atm_dev->esi, sizeof(atm_dev->esi));
783 atm_err(usbatm_instance, "cxacru_atm_start: CARD_GET_MAC_ADDRESS returned %d\n", ret);
788 mutex_lock(&instance->adsl_state_serialize);
789 ret = cxacru_cm(instance, CM_REQUEST_CHIP_ADSL_LINE_START, NULL, 0, NULL, 0);
791 atm_err(usbatm_instance, "cxacru_atm_start: CHIP_ADSL_LINE_START returned %d\n", ret);
793 /* Start status polling */
794 mutex_lock(&instance->poll_state_serialize);
795 switch (instance->poll_state) {
798 instance->poll_state = CXPOLL_POLLING;
801 case CXPOLL_STOPPING:
802 /* abort stop request */
803 instance->poll_state = CXPOLL_POLLING;
806 case CXPOLL_SHUTDOWN:
807 /* don't start polling */
810 mutex_unlock(&instance->poll_state_serialize);
811 mutex_unlock(&instance->adsl_state_serialize);
814 cxacru_poll_status(&instance->poll_work.work);
818 static void cxacru_poll_status(struct work_struct *work)
820 struct cxacru_data *instance =
821 container_of(work, struct cxacru_data, poll_work.work);
822 u32 buf[CXINF_MAX] = {};
823 struct usbatm_data *usbatm = instance->usbatm;
824 struct atm_dev *atm_dev = usbatm->atm_dev;
825 int keep_polling = 1;
828 ret = cxacru_cm_get_array(instance, CM_REQUEST_CARD_INFO_GET, buf, CXINF_MAX);
830 if (ret != -ESHUTDOWN)
831 atm_warn(usbatm, "poll status: error %d\n", ret);
833 mutex_lock(&instance->poll_state_serialize);
834 if (instance->poll_state != CXPOLL_SHUTDOWN) {
835 instance->poll_state = CXPOLL_STOPPED;
837 if (ret != -ESHUTDOWN)
838 atm_warn(usbatm, "polling disabled, set adsl_state"
839 " to 'start' or 'poll' to resume\n");
841 mutex_unlock(&instance->poll_state_serialize);
845 memcpy(instance->card_info, buf, sizeof(instance->card_info));
847 if (instance->adsl_status != buf[CXINF_LINE_STARTABLE]) {
848 instance->adsl_status = buf[CXINF_LINE_STARTABLE];
850 switch (instance->adsl_status) {
852 atm_info(usbatm, "ADSL state: running\n");
856 atm_info(usbatm, "ADSL state: stopped\n");
860 atm_info(usbatm, "Unknown adsl status %02x\n", instance->adsl_status);
865 if (instance->line_status == buf[CXINF_LINE_STATUS])
868 instance->line_status = buf[CXINF_LINE_STATUS];
869 switch (instance->line_status) {
871 atm_dev_signal_change(atm_dev, ATM_PHY_SIG_LOST);
872 atm_info(usbatm, "ADSL line: down\n");
876 atm_dev_signal_change(atm_dev, ATM_PHY_SIG_LOST);
877 atm_info(usbatm, "ADSL line: attempting to activate\n");
881 atm_dev_signal_change(atm_dev, ATM_PHY_SIG_LOST);
882 atm_info(usbatm, "ADSL line: training\n");
886 atm_dev_signal_change(atm_dev, ATM_PHY_SIG_LOST);
887 atm_info(usbatm, "ADSL line: channel analysis\n");
891 atm_dev_signal_change(atm_dev, ATM_PHY_SIG_LOST);
892 atm_info(usbatm, "ADSL line: exchange\n");
896 atm_dev->link_rate = buf[CXINF_DOWNSTREAM_RATE] * 1000 / 424;
897 atm_dev_signal_change(atm_dev, ATM_PHY_SIG_FOUND);
899 atm_info(usbatm, "ADSL line: up (%d kb/s down | %d kb/s up)\n",
900 buf[CXINF_DOWNSTREAM_RATE], buf[CXINF_UPSTREAM_RATE]);
904 atm_dev_signal_change(atm_dev, ATM_PHY_SIG_LOST);
905 atm_info(usbatm, "ADSL line: waiting\n");
909 atm_dev_signal_change(atm_dev, ATM_PHY_SIG_LOST);
910 atm_info(usbatm, "ADSL line: initializing\n");
914 atm_dev_signal_change(atm_dev, ATM_PHY_SIG_UNKNOWN);
915 atm_info(usbatm, "Unknown line state %02x\n", instance->line_status);
920 mutex_lock(&instance->poll_state_serialize);
921 if (instance->poll_state == CXPOLL_STOPPING &&
922 instance->adsl_status == 1 && /* stopped */
923 instance->line_status == 0) /* down */
924 instance->poll_state = CXPOLL_STOPPED;
926 if (instance->poll_state == CXPOLL_STOPPED)
928 mutex_unlock(&instance->poll_state_serialize);
931 schedule_delayed_work(&instance->poll_work,
932 round_jiffies_relative(POLL_INTERVAL*HZ));
935 static int cxacru_fw(struct usb_device *usb_dev, enum cxacru_fw_request fw,
936 u8 code1, u8 code2, u32 addr, const u8 *data, int size)
941 const int stride = CMD_PACKET_SIZE - 8;
943 buf = (u8 *) __get_free_page(GFP_KERNEL);
949 int l = min_t(int, stride, size - offd);
955 put_unaligned(cpu_to_le32(addr), (__le32 *)(buf + offb));
959 memcpy(buf + offb, data + offd, l);
961 memset(buf + offb + l, 0, stride - l);
964 if ((offb >= PAGE_SIZE) || (offd >= size)) {
965 ret = usb_bulk_msg(usb_dev, usb_sndbulkpipe(usb_dev, CXACRU_EP_CMD),
966 buf, offb, NULL, CMD_TIMEOUT);
968 dev_dbg(&usb_dev->dev, "sending fw %#x failed\n", fw);
973 } while (offd < size);
974 dev_dbg(&usb_dev->dev, "sent fw %#x\n", fw);
979 free_page((unsigned long) buf);
983 static void cxacru_upload_firmware(struct cxacru_data *instance,
984 const struct firmware *fw,
985 const struct firmware *bp)
988 struct usbatm_data *usbatm = instance->usbatm;
989 struct usb_device *usb_dev = usbatm->usb_dev;
990 __le16 signature[] = { usb_dev->descriptor.idVendor,
991 usb_dev->descriptor.idProduct };
994 usb_dbg(usbatm, "%s\n", __func__);
996 /* FirmwarePllFClkValue */
997 val = cpu_to_le32(instance->modem_type->pll_f_clk);
998 ret = cxacru_fw(usb_dev, FW_WRITE_MEM, 0x2, 0x0, PLLFCLK_ADDR, (u8 *) &val, 4);
1000 usb_err(usbatm, "FirmwarePllFClkValue failed: %d\n", ret);
1004 /* FirmwarePllBClkValue */
1005 val = cpu_to_le32(instance->modem_type->pll_b_clk);
1006 ret = cxacru_fw(usb_dev, FW_WRITE_MEM, 0x2, 0x0, PLLBCLK_ADDR, (u8 *) &val, 4);
1008 usb_err(usbatm, "FirmwarePllBClkValue failed: %d\n", ret);
1013 val = cpu_to_le32(SDRAM_ENA);
1014 ret = cxacru_fw(usb_dev, FW_WRITE_MEM, 0x2, 0x0, SDRAMEN_ADDR, (u8 *) &val, 4);
1016 usb_err(usbatm, "Enable SDRAM failed: %d\n", ret);
1021 usb_info(usbatm, "loading firmware\n");
1022 ret = cxacru_fw(usb_dev, FW_WRITE_MEM, 0x2, 0x0, FW_ADDR, fw->data, fw->size);
1024 usb_err(usbatm, "Firmware upload failed: %d\n", ret);
1028 /* Boot ROM patch */
1029 if (instance->modem_type->boot_rom_patch) {
1030 usb_info(usbatm, "loading boot ROM patch\n");
1031 ret = cxacru_fw(usb_dev, FW_WRITE_MEM, 0x2, 0x0, BR_ADDR, bp->data, bp->size);
1033 usb_err(usbatm, "Boot ROM patching failed: %d\n", ret);
1039 ret = cxacru_fw(usb_dev, FW_WRITE_MEM, 0x2, 0x0, SIG_ADDR, (u8 *) signature, 4);
1041 usb_err(usbatm, "Signature storing failed: %d\n", ret);
1045 usb_info(usbatm, "starting device\n");
1046 if (instance->modem_type->boot_rom_patch) {
1047 val = cpu_to_le32(BR_ADDR);
1048 ret = cxacru_fw(usb_dev, FW_WRITE_MEM, 0x2, 0x0, BR_STACK_ADDR, (u8 *) &val, 4);
1050 ret = cxacru_fw(usb_dev, FW_GOTO_MEM, 0x0, 0x0, FW_ADDR, NULL, 0);
1053 usb_err(usbatm, "Passing control to firmware failed: %d\n", ret);
1057 /* Delay to allow firmware to start up. */
1058 msleep_interruptible(1000);
1060 usb_clear_halt(usb_dev, usb_sndbulkpipe(usb_dev, CXACRU_EP_CMD));
1061 usb_clear_halt(usb_dev, usb_rcvbulkpipe(usb_dev, CXACRU_EP_CMD));
1062 usb_clear_halt(usb_dev, usb_sndbulkpipe(usb_dev, CXACRU_EP_DATA));
1063 usb_clear_halt(usb_dev, usb_rcvbulkpipe(usb_dev, CXACRU_EP_DATA));
1065 ret = cxacru_cm(instance, CM_REQUEST_CARD_GET_STATUS, NULL, 0, NULL, 0);
1067 usb_err(usbatm, "modem failed to initialize: %d\n", ret);
1072 static int cxacru_find_firmware(struct cxacru_data *instance,
1073 char *phase, const struct firmware **fw_p)
1075 struct usbatm_data *usbatm = instance->usbatm;
1076 struct device *dev = &usbatm->usb_intf->dev;
1079 sprintf(buf, "cxacru-%s.bin", phase);
1080 usb_dbg(usbatm, "cxacru_find_firmware: looking for %s\n", buf);
1082 if (request_firmware(fw_p, buf, dev)) {
1083 usb_dbg(usbatm, "no stage %s firmware found\n", phase);
1087 usb_info(usbatm, "found firmware %s\n", buf);
1092 static int cxacru_heavy_init(struct usbatm_data *usbatm_instance,
1093 struct usb_interface *usb_intf)
1095 const struct firmware *fw, *bp;
1096 struct cxacru_data *instance = usbatm_instance->driver_data;
1097 int ret = cxacru_find_firmware(instance, "fw", &fw);
1100 usb_warn(usbatm_instance, "firmware (cxacru-fw.bin) unavailable (system misconfigured?)\n");
1104 if (instance->modem_type->boot_rom_patch) {
1105 ret = cxacru_find_firmware(instance, "bp", &bp);
1107 usb_warn(usbatm_instance, "boot ROM patch (cxacru-bp.bin) unavailable (system misconfigured?)\n");
1108 release_firmware(fw);
1113 cxacru_upload_firmware(instance, fw, bp);
1115 if (instance->modem_type->boot_rom_patch)
1116 release_firmware(bp);
1117 release_firmware(fw);
1119 ret = cxacru_card_status(instance);
1121 usb_dbg(usbatm_instance, "modem initialisation failed\n");
1123 usb_dbg(usbatm_instance, "done setting up the modem\n");
1128 static int cxacru_bind(struct usbatm_data *usbatm_instance,
1129 struct usb_interface *intf, const struct usb_device_id *id)
1131 struct cxacru_data *instance;
1132 struct usb_device *usb_dev = interface_to_usbdev(intf);
1133 struct usb_host_endpoint *cmd_ep = usb_dev->ep_in[CXACRU_EP_CMD];
1134 struct usb_endpoint_descriptor *in, *out;
1138 instance = kzalloc(sizeof(*instance), GFP_KERNEL);
1142 instance->usbatm = usbatm_instance;
1143 instance->modem_type = (struct cxacru_modem_type *) id->driver_info;
1145 mutex_init(&instance->poll_state_serialize);
1146 instance->poll_state = CXPOLL_STOPPED;
1147 instance->line_status = -1;
1148 instance->adsl_status = -1;
1150 mutex_init(&instance->adsl_state_serialize);
1152 instance->rcv_buf = (u8 *) __get_free_page(GFP_KERNEL);
1153 if (!instance->rcv_buf) {
1154 usb_dbg(usbatm_instance, "cxacru_bind: no memory for rcv_buf\n");
1158 instance->snd_buf = (u8 *) __get_free_page(GFP_KERNEL);
1159 if (!instance->snd_buf) {
1160 usb_dbg(usbatm_instance, "cxacru_bind: no memory for snd_buf\n");
1164 instance->rcv_urb = usb_alloc_urb(0, GFP_KERNEL);
1165 if (!instance->rcv_urb) {
1169 instance->snd_urb = usb_alloc_urb(0, GFP_KERNEL);
1170 if (!instance->snd_urb) {
1176 usb_dbg(usbatm_instance, "cxacru_bind: no command endpoint\n");
1181 if (usb_endpoint_xfer_int(&cmd_ep->desc))
1182 ret = usb_find_common_endpoints(intf->cur_altsetting,
1183 NULL, NULL, &in, &out);
1185 ret = usb_find_common_endpoints(intf->cur_altsetting,
1186 &in, &out, NULL, NULL);
1189 usb_err(usbatm_instance, "cxacru_bind: interface has incorrect endpoints\n");
1194 if ((cmd_ep->desc.bmAttributes & USB_ENDPOINT_XFERTYPE_MASK)
1195 == USB_ENDPOINT_XFER_INT) {
1196 usb_fill_int_urb(instance->rcv_urb,
1197 usb_dev, usb_rcvintpipe(usb_dev, CXACRU_EP_CMD),
1198 instance->rcv_buf, PAGE_SIZE,
1199 cxacru_blocking_completion, &instance->rcv_done, 1);
1201 usb_fill_int_urb(instance->snd_urb,
1202 usb_dev, usb_sndintpipe(usb_dev, CXACRU_EP_CMD),
1203 instance->snd_buf, PAGE_SIZE,
1204 cxacru_blocking_completion, &instance->snd_done, 4);
1206 usb_fill_bulk_urb(instance->rcv_urb,
1207 usb_dev, usb_rcvbulkpipe(usb_dev, CXACRU_EP_CMD),
1208 instance->rcv_buf, PAGE_SIZE,
1209 cxacru_blocking_completion, &instance->rcv_done);
1211 usb_fill_bulk_urb(instance->snd_urb,
1212 usb_dev, usb_sndbulkpipe(usb_dev, CXACRU_EP_CMD),
1213 instance->snd_buf, PAGE_SIZE,
1214 cxacru_blocking_completion, &instance->snd_done);
1217 mutex_init(&instance->cm_serialize);
1219 INIT_DELAYED_WORK(&instance->poll_work, cxacru_poll_status);
1221 usbatm_instance->driver_data = instance;
1223 usbatm_instance->flags = (cxacru_card_status(instance) ? 0 : UDSL_SKIP_HEAVY_INIT);
1228 free_page((unsigned long) instance->snd_buf);
1229 free_page((unsigned long) instance->rcv_buf);
1230 usb_free_urb(instance->snd_urb);
1231 usb_free_urb(instance->rcv_urb);
1237 static void cxacru_unbind(struct usbatm_data *usbatm_instance,
1238 struct usb_interface *intf)
1240 struct cxacru_data *instance = usbatm_instance->driver_data;
1243 usb_dbg(usbatm_instance, "cxacru_unbind entered\n");
1246 usb_dbg(usbatm_instance, "cxacru_unbind: NULL instance!\n");
1250 mutex_lock(&instance->poll_state_serialize);
1251 BUG_ON(instance->poll_state == CXPOLL_SHUTDOWN);
1253 /* ensure that status polling continues unless
1254 * it has already stopped */
1255 if (instance->poll_state == CXPOLL_STOPPED)
1258 /* stop polling from being stopped or started */
1259 instance->poll_state = CXPOLL_SHUTDOWN;
1260 mutex_unlock(&instance->poll_state_serialize);
1263 cancel_delayed_work_sync(&instance->poll_work);
1265 usb_kill_urb(instance->snd_urb);
1266 usb_kill_urb(instance->rcv_urb);
1267 usb_free_urb(instance->snd_urb);
1268 usb_free_urb(instance->rcv_urb);
1270 free_page((unsigned long) instance->snd_buf);
1271 free_page((unsigned long) instance->rcv_buf);
1275 usbatm_instance->driver_data = NULL;
1278 static const struct cxacru_modem_type cxacru_cafe = {
1279 .pll_f_clk = 0x02d874df,
1280 .pll_b_clk = 0x0196a51a,
1281 .boot_rom_patch = 1,
1284 static const struct cxacru_modem_type cxacru_cb00 = {
1287 .boot_rom_patch = 0,
1290 static const struct usb_device_id cxacru_usb_ids[] = {
1291 { /* V = Conexant P = ADSL modem (Euphrates project) */
1292 USB_DEVICE(0x0572, 0xcafe), .driver_info = (unsigned long) &cxacru_cafe
1294 { /* V = Conexant P = ADSL modem (Hasbani project) */
1295 USB_DEVICE(0x0572, 0xcb00), .driver_info = (unsigned long) &cxacru_cb00
1297 { /* V = Conexant P = ADSL modem */
1298 USB_DEVICE(0x0572, 0xcb01), .driver_info = (unsigned long) &cxacru_cb00
1300 { /* V = Conexant P = ADSL modem (Well PTI-800) */
1301 USB_DEVICE(0x0572, 0xcb02), .driver_info = (unsigned long) &cxacru_cb00
1303 { /* V = Conexant P = ADSL modem */
1304 USB_DEVICE(0x0572, 0xcb06), .driver_info = (unsigned long) &cxacru_cb00
1306 { /* V = Conexant P = ADSL modem (ZTE ZXDSL 852) */
1307 USB_DEVICE(0x0572, 0xcb07), .driver_info = (unsigned long) &cxacru_cb00
1309 { /* V = Olitec P = ADSL modem version 2 */
1310 USB_DEVICE(0x08e3, 0x0100), .driver_info = (unsigned long) &cxacru_cafe
1312 { /* V = Olitec P = ADSL modem version 3 */
1313 USB_DEVICE(0x08e3, 0x0102), .driver_info = (unsigned long) &cxacru_cb00
1315 { /* V = Trust/Amigo Technology Co. P = AMX-CA86U */
1316 USB_DEVICE(0x0eb0, 0x3457), .driver_info = (unsigned long) &cxacru_cafe
1318 { /* V = Zoom P = 5510 */
1319 USB_DEVICE(0x1803, 0x5510), .driver_info = (unsigned long) &cxacru_cb00
1321 { /* V = Draytek P = Vigor 318 */
1322 USB_DEVICE(0x0675, 0x0200), .driver_info = (unsigned long) &cxacru_cb00
1324 { /* V = Zyxel P = 630-C1 aka OMNI ADSL USB (Annex A) */
1325 USB_DEVICE(0x0586, 0x330a), .driver_info = (unsigned long) &cxacru_cb00
1327 { /* V = Zyxel P = 630-C3 aka OMNI ADSL USB (Annex B) */
1328 USB_DEVICE(0x0586, 0x330b), .driver_info = (unsigned long) &cxacru_cb00
1330 { /* V = Aethra P = Starmodem UM1020 */
1331 USB_DEVICE(0x0659, 0x0020), .driver_info = (unsigned long) &cxacru_cb00
1333 { /* V = Aztech Systems P = ? AKA Pirelli AUA-010 */
1334 USB_DEVICE(0x0509, 0x0812), .driver_info = (unsigned long) &cxacru_cb00
1336 { /* V = Netopia P = Cayman 3341(Annex A)/3351(Annex B) */
1337 USB_DEVICE(0x100d, 0xcb01), .driver_info = (unsigned long) &cxacru_cb00
1339 { /* V = Netopia P = Cayman 3342(Annex A)/3352(Annex B) */
1340 USB_DEVICE(0x100d, 0x3342), .driver_info = (unsigned long) &cxacru_cb00
1345 MODULE_DEVICE_TABLE(usb, cxacru_usb_ids);
1347 static struct usbatm_driver cxacru_driver = {
1348 .driver_name = cxacru_driver_name,
1349 .bind = cxacru_bind,
1350 .heavy_init = cxacru_heavy_init,
1351 .unbind = cxacru_unbind,
1352 .atm_start = cxacru_atm_start,
1353 .bulk_in = CXACRU_EP_DATA,
1354 .bulk_out = CXACRU_EP_DATA,
1359 static int cxacru_usb_probe(struct usb_interface *intf,
1360 const struct usb_device_id *id)
1362 struct usb_device *usb_dev = interface_to_usbdev(intf);
1365 /* Avoid ADSL routers (cx82310_eth).
1366 * Abort if bDeviceClass is 0xff and iProduct is "USB NET CARD".
1368 if (usb_dev->descriptor.bDeviceClass == USB_CLASS_VENDOR_SPEC
1369 && usb_string(usb_dev, usb_dev->descriptor.iProduct,
1370 buf, sizeof(buf)) > 0) {
1371 if (!strcmp(buf, "USB NET CARD")) {
1372 dev_info(&intf->dev, "ignoring cx82310_eth device\n");
1377 return usbatm_usb_probe(intf, id, &cxacru_driver);
1380 static struct usb_driver cxacru_usb_driver = {
1381 .name = cxacru_driver_name,
1382 .probe = cxacru_usb_probe,
1383 .disconnect = usbatm_usb_disconnect,
1384 .id_table = cxacru_usb_ids,
1385 .dev_groups = cxacru_groups,
1388 module_usb_driver(cxacru_usb_driver);
1390 MODULE_AUTHOR(DRIVER_AUTHOR);
1391 MODULE_DESCRIPTION(DRIVER_DESC);
1392 MODULE_LICENSE("GPL");