2 * USB-to-WWAN Driver for Sierra Wireless modems
4 * Copyright (C) 2008, 2009, 2010 Paxton Smith, Matthew Safar, Rory Filer
5 * <linux@sierrawireless.com>
7 * Portions of this based on the cdc_ether driver by David Brownell (2003-2005)
8 * and Ole Andre Vadla Ravnas (ActiveSync) (2006).
10 * IMPORTANT DISCLAIMER: This driver is not commercially supported by
11 * Sierra Wireless. Use at your own risk.
13 * This program is free software; you can redistribute it and/or modify
14 * it under the terms of the GNU General Public License as published by
15 * the Free Software Foundation; either version 2 of the License, or
16 * (at your option) any later version.
18 * This program is distributed in the hope that it will be useful,
19 * but WITHOUT ANY WARRANTY; without even the implied warranty of
20 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
21 * GNU General Public License for more details.
23 * You should have received a copy of the GNU General Public License
24 * along with this program; if not, see <http://www.gnu.org/licenses/>.
27 #define DRIVER_VERSION "v.2.0"
28 #define DRIVER_AUTHOR "Paxton Smith, Matthew Safar, Rory Filer"
29 #define DRIVER_DESC "USB-to-WWAN Driver for Sierra Wireless modems"
30 static const char driver_name
[] = "sierra_net";
32 /* if defined debug messages enabled */
35 #include <linux/module.h>
36 #include <linux/etherdevice.h>
37 #include <linux/ethtool.h>
38 #include <linux/mii.h>
39 #include <linux/sched.h>
40 #include <linux/timer.h>
41 #include <linux/usb.h>
42 #include <linux/usb/cdc.h>
45 #include <asm/unaligned.h>
46 #include <linux/usb/usbnet.h>
48 #define SWI_USB_REQUEST_GET_FW_ATTR 0x06
49 #define SWI_GET_FW_ATTR_MASK 0x08
51 /* atomic counter partially included in MAC address to make sure 2 devices
52 * do not end up with the same MAC - concept breaks in case of > 255 ifaces
54 static atomic_t iface_counter
= ATOMIC_INIT(0);
57 * SYNC Timer Delay definition used to set the expiry time
59 #define SIERRA_NET_SYNCDELAY (2*HZ)
61 /* Max. MTU supported. The modem buffers are limited to 1500 */
62 #define SIERRA_NET_MAX_SUPPORTED_MTU 1500
64 /* The SIERRA_NET_USBCTL_BUF_LEN defines a buffer size allocated for control
65 * message reception ... and thus the max. received packet.
66 * (May be the cause for parse_hip returning -EINVAL)
68 #define SIERRA_NET_USBCTL_BUF_LEN 1024
70 /* Overriding the default usbnet rx_urb_size */
71 #define SIERRA_NET_RX_URB_SIZE (8 * 1024)
73 /* Private data structure */
74 struct sierra_net_data
{
76 u16 link_up
; /* air link up or down */
77 u8 tx_hdr_template
[4]; /* part of HIP hdr for tx'd packets */
79 u8 sync_msg
[4]; /* SYNC message */
80 u8 shdwn_msg
[4]; /* Shutdown message */
82 /* Backpointer to the container */
83 struct usbnet
*usbnet
;
85 u8 ifnum
; /* interface number */
87 /* Bit masks, must be a power of 2 */
88 #define SIERRA_NET_EVENT_RESP_AVAIL 0x01
89 #define SIERRA_NET_TIMER_EXPIRY 0x02
90 unsigned long kevent_flags
;
91 struct work_struct sierra_net_kevent
;
92 struct timer_list sync_timer
; /* For retrying SYNC sequence */
105 /* HIP message type */
106 #define SIERRA_NET_HIP_EXTENDEDID 0x7F
107 #define SIERRA_NET_HIP_HSYNC_ID 0x60 /* Modem -> host */
108 #define SIERRA_NET_HIP_RESTART_ID 0x62 /* Modem -> host */
109 #define SIERRA_NET_HIP_MSYNC_ID 0x20 /* Host -> modem */
110 #define SIERRA_NET_HIP_SHUTD_ID 0x26 /* Host -> modem */
112 #define SIERRA_NET_HIP_EXT_IP_IN_ID 0x0202
113 #define SIERRA_NET_HIP_EXT_IP_OUT_ID 0x0002
115 /* 3G UMTS Link Sense Indication definitions */
116 #define SIERRA_NET_HIP_LSI_UMTSID 0x78
118 /* Reverse Channel Grant Indication HIP message */
119 #define SIERRA_NET_HIP_RCGI 0x64
121 /* LSI Protocol types */
122 #define SIERRA_NET_PROTOCOL_UMTS 0x01
123 #define SIERRA_NET_PROTOCOL_UMTS_DS 0x04
125 #define SIERRA_NET_COVERAGE_NONE 0x00
126 #define SIERRA_NET_COVERAGE_NOPACKET 0x01
129 #define SIERRA_NET_SESSION_IDLE 0x00
131 #define SIERRA_NET_AS_LINK_TYPE_IPV4 0x00
132 #define SIERRA_NET_AS_LINK_TYPE_IPV6 0x02
138 /* eventually use a union for the rest - assume umts for now */
140 u8 network_len
; /* network name len */
141 u8 network
[40]; /* network name (UCS2, bigendian) */
146 struct lsi_umts_single
{
149 u8 pdp_addr_len
; /* NW-supplied PDP address len */
150 u8 pdp_addr
[16]; /* NW-supplied PDP address (bigendian)) */
152 u8 dns1_addr_len
; /* NW-supplied 1st DNS address len (bigendian) */
153 u8 dns1_addr
[16]; /* NW-supplied 1st DNS address */
154 u8 dns2_addr_len
; /* NW-supplied 2nd DNS address len */
155 u8 dns2_addr
[16]; /* NW-supplied 2nd DNS address (bigendian)*/
156 u8 wins1_addr_len
; /* NW-supplied 1st Wins address len */
157 u8 wins1_addr
[16]; /* NW-supplied 1st Wins address (bigendian)*/
158 u8 wins2_addr_len
; /* NW-supplied 2nd Wins address len */
159 u8 wins2_addr
[16]; /* NW-supplied 2nd Wins address (bigendian) */
161 u8 gw_addr_len
; /* NW-supplied GW address len */
162 u8 gw_addr
[16]; /* NW-supplied GW address (bigendian) */
166 struct lsi_umts_dual
{
168 u8 pdp_addr4_len
; /* NW-supplied PDP IPv4 address len */
169 u8 pdp_addr4
[4]; /* NW-supplied PDP IPv4 address (bigendian)) */
170 u8 pdp_addr6_len
; /* NW-supplied PDP IPv6 address len */
171 u8 pdp_addr6
[16]; /* NW-supplied PDP IPv6 address (bigendian)) */
173 u8 dns1_addr4_len
; /* NW-supplied 1st DNS v4 address len (bigendian) */
174 u8 dns1_addr4
[4]; /* NW-supplied 1st DNS v4 address */
175 u8 dns1_addr6_len
; /* NW-supplied 1st DNS v6 address len */
176 u8 dns1_addr6
[16]; /* NW-supplied 1st DNS v6 address (bigendian)*/
177 u8 dns2_addr4_len
; /* NW-supplied 2nd DNS v4 address len (bigendian) */
178 u8 dns2_addr4
[4]; /* NW-supplied 2nd DNS v4 address */
179 u8 dns2_addr6_len
; /* NW-supplied 2nd DNS v6 address len */
180 u8 dns2_addr6
[16]; /* NW-supplied 2nd DNS v6 address (bigendian)*/
184 #define SIERRA_NET_LSI_COMMON_LEN 4
185 #define SIERRA_NET_LSI_UMTS_LEN (sizeof(struct lsi_umts_single))
186 #define SIERRA_NET_LSI_UMTS_STATUS_LEN \
187 (SIERRA_NET_LSI_UMTS_LEN - SIERRA_NET_LSI_COMMON_LEN)
188 #define SIERRA_NET_LSI_UMTS_DS_LEN (sizeof(struct lsi_umts_dual))
189 #define SIERRA_NET_LSI_UMTS_DS_STATUS_LEN \
190 (SIERRA_NET_LSI_UMTS_DS_LEN - SIERRA_NET_LSI_COMMON_LEN)
192 /* Our own net device operations structure */
193 static const struct net_device_ops sierra_net_device_ops
= {
194 .ndo_open
= usbnet_open
,
195 .ndo_stop
= usbnet_stop
,
196 .ndo_start_xmit
= usbnet_start_xmit
,
197 .ndo_tx_timeout
= usbnet_tx_timeout
,
198 .ndo_change_mtu
= usbnet_change_mtu
,
199 .ndo_get_stats64
= usbnet_get_stats64
,
200 .ndo_set_mac_address
= eth_mac_addr
,
201 .ndo_validate_addr
= eth_validate_addr
,
204 /* get private data associated with passed in usbnet device */
205 static inline struct sierra_net_data
*sierra_net_get_private(struct usbnet
*dev
)
207 return (struct sierra_net_data
*)dev
->data
[0];
210 /* set private data associated with passed in usbnet device */
211 static inline void sierra_net_set_private(struct usbnet
*dev
,
212 struct sierra_net_data
*priv
)
214 dev
->data
[0] = (unsigned long)priv
;
217 /* is packet IPv4/IPv6 */
218 static inline int is_ip(struct sk_buff
*skb
)
220 return skb
->protocol
== cpu_to_be16(ETH_P_IP
) ||
221 skb
->protocol
== cpu_to_be16(ETH_P_IPV6
);
225 * check passed in packet and make sure that:
226 * - it is linear (no scatter/gather)
227 * - it is ethernet (mac_header properly set)
229 static int check_ethip_packet(struct sk_buff
*skb
, struct usbnet
*dev
)
231 skb_reset_mac_header(skb
); /* ethernet header */
233 if (skb_is_nonlinear(skb
)) {
234 netdev_err(dev
->net
, "Non linear buffer-dropping\n");
238 if (!pskb_may_pull(skb
, ETH_HLEN
))
240 skb
->protocol
= eth_hdr(skb
)->h_proto
;
245 static const u8
*save16bit(struct param
*p
, const u8
*datap
)
248 p
->word
= get_unaligned_be16(datap
);
249 return datap
+ sizeof(p
->word
);
252 static const u8
*save8bit(struct param
*p
, const u8
*datap
)
256 return datap
+ sizeof(p
->byte
);
259 /*----------------------------------------------------------------------------*
261 *----------------------------------------------------------------------------*/
263 #define SIERRA_NET_HIP_HDR_LEN 4
264 /* Extended HIP header */
265 #define SIERRA_NET_HIP_EXT_HDR_LEN 6
269 struct param payload_len
;
271 struct param msgspecific
;
272 struct param extmsgid
;
275 static int parse_hip(const u8
*buf
, const u32 buflen
, struct hip_hdr
*hh
)
277 const u8
*curp
= buf
;
280 if (buflen
< SIERRA_NET_HIP_HDR_LEN
)
283 curp
= save16bit(&hh
->payload_len
, curp
);
284 curp
= save8bit(&hh
->msgid
, curp
);
285 curp
= save8bit(&hh
->msgspecific
, curp
);
287 padded
= hh
->msgid
.byte
& 0x80;
288 hh
->msgid
.byte
&= 0x7F; /* 7 bits */
290 hh
->extmsgid
.is_present
= (hh
->msgid
.byte
== SIERRA_NET_HIP_EXTENDEDID
);
291 if (hh
->extmsgid
.is_present
) {
292 if (buflen
< SIERRA_NET_HIP_EXT_HDR_LEN
)
295 hh
->payload_len
.word
&= 0x3FFF; /* 14 bits */
297 curp
= save16bit(&hh
->extmsgid
, curp
);
298 hh
->extmsgid
.word
&= 0x03FF; /* 10 bits */
300 hh
->hdrlen
= SIERRA_NET_HIP_EXT_HDR_LEN
;
302 hh
->payload_len
.word
&= 0x07FF; /* 11 bits */
303 hh
->hdrlen
= SIERRA_NET_HIP_HDR_LEN
;
308 hh
->payload_len
.word
--;
311 /* if real packet shorter than the claimed length */
312 if (buflen
< (hh
->hdrlen
+ hh
->payload_len
.word
))
318 static void build_hip(u8
*buf
, const u16 payloadlen
,
319 struct sierra_net_data
*priv
)
321 /* the following doesn't have the full functionality. We
322 * currently build only one kind of header, so it is faster this way
324 put_unaligned_be16(payloadlen
, buf
);
325 memcpy(buf
+2, priv
->tx_hdr_template
, sizeof(priv
->tx_hdr_template
));
327 /*----------------------------------------------------------------------------*
329 *----------------------------------------------------------------------------*/
331 static int sierra_net_send_cmd(struct usbnet
*dev
,
332 u8
*cmd
, int cmdlen
, const char * cmd_name
)
334 struct sierra_net_data
*priv
= sierra_net_get_private(dev
);
337 status
= usbnet_write_cmd(dev
, USB_CDC_SEND_ENCAPSULATED_COMMAND
,
338 USB_DIR_OUT
|USB_TYPE_CLASS
|USB_RECIP_INTERFACE
,
339 0, priv
->ifnum
, cmd
, cmdlen
);
341 if (status
!= cmdlen
&& status
!= -ENODEV
)
342 netdev_err(dev
->net
, "Submit %s failed %d\n", cmd_name
, status
);
347 static int sierra_net_send_sync(struct usbnet
*dev
)
350 struct sierra_net_data
*priv
= sierra_net_get_private(dev
);
352 dev_dbg(&dev
->udev
->dev
, "%s", __func__
);
354 status
= sierra_net_send_cmd(dev
, priv
->sync_msg
,
355 sizeof(priv
->sync_msg
), "SYNC");
360 static void sierra_net_set_ctx_index(struct sierra_net_data
*priv
, u8 ctx_ix
)
362 dev_dbg(&(priv
->usbnet
->udev
->dev
), "%s %d", __func__
, ctx_ix
);
363 priv
->tx_hdr_template
[0] = 0x3F;
364 priv
->tx_hdr_template
[1] = ctx_ix
;
365 *((__be16
*)&priv
->tx_hdr_template
[2]) =
366 cpu_to_be16(SIERRA_NET_HIP_EXT_IP_OUT_ID
);
369 static inline int sierra_net_is_valid_addrlen(u8 len
)
371 return len
== sizeof(struct in_addr
);
374 static int sierra_net_parse_lsi(struct usbnet
*dev
, char *data
, int datalen
)
376 struct lsi_umts
*lsi
= (struct lsi_umts
*)data
;
379 if (datalen
< sizeof(struct lsi_umts_single
)) {
380 netdev_err(dev
->net
, "%s: Data length %d, exp >= %zu\n",
381 __func__
, datalen
, sizeof(struct lsi_umts_single
));
385 /* Validate the session state */
386 if (lsi
->session_state
== SIERRA_NET_SESSION_IDLE
) {
387 netdev_err(dev
->net
, "Session idle, 0x%02x\n",
392 /* Validate the protocol - only support UMTS for now */
393 if (lsi
->protocol
== SIERRA_NET_PROTOCOL_UMTS
) {
394 struct lsi_umts_single
*single
= (struct lsi_umts_single
*)lsi
;
396 /* Validate the link type */
397 if (single
->link_type
!= SIERRA_NET_AS_LINK_TYPE_IPV4
&&
398 single
->link_type
!= SIERRA_NET_AS_LINK_TYPE_IPV6
) {
399 netdev_err(dev
->net
, "Link type unsupported: 0x%02x\n",
403 expected_length
= SIERRA_NET_LSI_UMTS_STATUS_LEN
;
404 } else if (lsi
->protocol
== SIERRA_NET_PROTOCOL_UMTS_DS
) {
405 expected_length
= SIERRA_NET_LSI_UMTS_DS_STATUS_LEN
;
407 netdev_err(dev
->net
, "Protocol unsupported, 0x%02x\n",
412 if (be16_to_cpu(lsi
->length
) != expected_length
) {
413 netdev_err(dev
->net
, "%s: LSI_UMTS_STATUS_LEN %d, exp %u\n",
414 __func__
, be16_to_cpu(lsi
->length
), expected_length
);
418 /* Validate the coverage */
419 if (lsi
->coverage
== SIERRA_NET_COVERAGE_NONE
||
420 lsi
->coverage
== SIERRA_NET_COVERAGE_NOPACKET
) {
421 netdev_err(dev
->net
, "No coverage, 0x%02x\n", lsi
->coverage
);
425 /* Set link_sense true */
429 static void sierra_net_handle_lsi(struct usbnet
*dev
, char *data
,
432 struct sierra_net_data
*priv
= sierra_net_get_private(dev
);
435 link_up
= sierra_net_parse_lsi(dev
, data
+ hh
->hdrlen
,
436 hh
->payload_len
.word
);
438 netdev_err(dev
->net
, "Invalid LSI\n");
442 sierra_net_set_ctx_index(priv
, hh
->msgspecific
.byte
);
447 usbnet_link_change(dev
, link_up
, 0);
450 static void sierra_net_dosync(struct usbnet
*dev
)
453 struct sierra_net_data
*priv
= sierra_net_get_private(dev
);
455 dev_dbg(&dev
->udev
->dev
, "%s", __func__
);
457 /* The SIERRA_NET_HIP_MSYNC_ID command appears to request that the
458 * firmware restart itself. After restarting, the modem will respond
459 * with the SIERRA_NET_HIP_RESTART_ID indication. The driver continues
460 * sending MSYNC commands every few seconds until it receives the
461 * RESTART event from the firmware
464 /* tell modem we are ready */
465 status
= sierra_net_send_sync(dev
);
468 "Send SYNC failed, status %d\n", status
);
469 status
= sierra_net_send_sync(dev
);
472 "Send SYNC failed, status %d\n", status
);
474 /* Now, start a timer and make sure we get the Restart Indication */
475 priv
->sync_timer
.expires
= jiffies
+ SIERRA_NET_SYNCDELAY
;
476 add_timer(&priv
->sync_timer
);
479 static void sierra_net_kevent(struct work_struct
*work
)
481 struct sierra_net_data
*priv
=
482 container_of(work
, struct sierra_net_data
, sierra_net_kevent
);
483 struct usbnet
*dev
= priv
->usbnet
;
489 if (test_bit(SIERRA_NET_EVENT_RESP_AVAIL
, &priv
->kevent_flags
)) {
490 clear_bit(SIERRA_NET_EVENT_RESP_AVAIL
, &priv
->kevent_flags
);
492 /* Query the modem for the LSI message */
493 buf
= kzalloc(SIERRA_NET_USBCTL_BUF_LEN
, GFP_KERNEL
);
498 len
= usb_control_msg(dev
->udev
, usb_rcvctrlpipe(dev
->udev
, 0),
499 USB_CDC_GET_ENCAPSULATED_RESPONSE
,
500 USB_DIR_IN
|USB_TYPE_CLASS
|USB_RECIP_INTERFACE
,
501 0, ifnum
, buf
, SIERRA_NET_USBCTL_BUF_LEN
,
502 USB_CTRL_SET_TIMEOUT
);
506 "usb_control_msg failed, status %d\n", len
);
510 dev_dbg(&dev
->udev
->dev
, "%s: Received status message,"
511 " %04x bytes", __func__
, len
);
513 err
= parse_hip(buf
, len
, &hh
);
515 netdev_err(dev
->net
, "%s: Bad packet,"
516 " parse result %d\n", __func__
, err
);
521 /* Validate packet length */
522 if (len
!= hh
.hdrlen
+ hh
.payload_len
.word
) {
523 netdev_err(dev
->net
, "%s: Bad packet, received"
524 " %d, expected %d\n", __func__
, len
,
525 hh
.hdrlen
+ hh
.payload_len
.word
);
530 /* Switch on received message types */
531 switch (hh
.msgid
.byte
) {
532 case SIERRA_NET_HIP_LSI_UMTSID
:
533 dev_dbg(&dev
->udev
->dev
, "LSI for ctx:%d",
534 hh
.msgspecific
.byte
);
535 sierra_net_handle_lsi(dev
, buf
, &hh
);
537 case SIERRA_NET_HIP_RESTART_ID
:
538 dev_dbg(&dev
->udev
->dev
, "Restart reported: %d,"
539 " stopping sync timer",
540 hh
.msgspecific
.byte
);
541 /* Got sync resp - stop timer & clear mask */
542 del_timer_sync(&priv
->sync_timer
);
543 clear_bit(SIERRA_NET_TIMER_EXPIRY
,
544 &priv
->kevent_flags
);
546 case SIERRA_NET_HIP_HSYNC_ID
:
547 dev_dbg(&dev
->udev
->dev
, "SYNC received");
548 err
= sierra_net_send_sync(dev
);
551 "Send SYNC failed %d\n", err
);
553 case SIERRA_NET_HIP_EXTENDEDID
:
554 netdev_err(dev
->net
, "Unrecognized HIP msg, "
555 "extmsgid 0x%04x\n", hh
.extmsgid
.word
);
557 case SIERRA_NET_HIP_RCGI
:
561 netdev_err(dev
->net
, "Unrecognized HIP msg, "
562 "msgid 0x%02x\n", hh
.msgid
.byte
);
568 /* The sync timer bit might be set */
569 if (test_bit(SIERRA_NET_TIMER_EXPIRY
, &priv
->kevent_flags
)) {
570 clear_bit(SIERRA_NET_TIMER_EXPIRY
, &priv
->kevent_flags
);
571 dev_dbg(&dev
->udev
->dev
, "Deferred sync timer expiry");
572 sierra_net_dosync(priv
->usbnet
);
575 if (priv
->kevent_flags
)
576 dev_dbg(&dev
->udev
->dev
, "sierra_net_kevent done, "
577 "kevent_flags = 0x%lx", priv
->kevent_flags
);
580 static void sierra_net_defer_kevent(struct usbnet
*dev
, int work
)
582 struct sierra_net_data
*priv
= sierra_net_get_private(dev
);
584 set_bit(work
, &priv
->kevent_flags
);
585 schedule_work(&priv
->sierra_net_kevent
);
589 * Sync Retransmit Timer Handler. On expiry, kick the work queue
591 static void sierra_sync_timer(struct timer_list
*t
)
593 struct sierra_net_data
*priv
= from_timer(priv
, t
, sync_timer
);
594 struct usbnet
*dev
= priv
->usbnet
;
596 dev_dbg(&dev
->udev
->dev
, "%s", __func__
);
597 /* Kick the tasklet */
598 sierra_net_defer_kevent(dev
, SIERRA_NET_TIMER_EXPIRY
);
601 static void sierra_net_status(struct usbnet
*dev
, struct urb
*urb
)
603 struct usb_cdc_notification
*event
;
605 dev_dbg(&dev
->udev
->dev
, "%s", __func__
);
607 if (urb
->actual_length
< sizeof *event
)
610 /* Add cases to handle other standard notifications. */
611 event
= urb
->transfer_buffer
;
612 switch (event
->bNotificationType
) {
613 case USB_CDC_NOTIFY_NETWORK_CONNECTION
:
614 case USB_CDC_NOTIFY_SPEED_CHANGE
:
615 /* USB 305 sends those */
617 case USB_CDC_NOTIFY_RESPONSE_AVAILABLE
:
618 sierra_net_defer_kevent(dev
, SIERRA_NET_EVENT_RESP_AVAIL
);
621 netdev_err(dev
->net
, ": unexpected notification %02x!\n",
622 event
->bNotificationType
);
627 static void sierra_net_get_drvinfo(struct net_device
*net
,
628 struct ethtool_drvinfo
*info
)
630 /* Inherit standard device info */
631 usbnet_get_drvinfo(net
, info
);
632 strlcpy(info
->driver
, driver_name
, sizeof(info
->driver
));
633 strlcpy(info
->version
, DRIVER_VERSION
, sizeof(info
->version
));
636 static u32
sierra_net_get_link(struct net_device
*net
)
638 struct usbnet
*dev
= netdev_priv(net
);
639 /* Report link is down whenever the interface is down */
640 return sierra_net_get_private(dev
)->link_up
&& netif_running(net
);
643 static const struct ethtool_ops sierra_net_ethtool_ops
= {
644 .get_drvinfo
= sierra_net_get_drvinfo
,
645 .get_link
= sierra_net_get_link
,
646 .get_msglevel
= usbnet_get_msglevel
,
647 .set_msglevel
= usbnet_set_msglevel
,
648 .nway_reset
= usbnet_nway_reset
,
649 .get_link_ksettings
= usbnet_get_link_ksettings
,
650 .set_link_ksettings
= usbnet_set_link_ksettings
,
653 static int sierra_net_get_fw_attr(struct usbnet
*dev
, u16
*datap
)
658 result
= usbnet_read_cmd(dev
,
659 /* _u8 vendor specific request */
660 SWI_USB_REQUEST_GET_FW_ATTR
,
661 USB_DIR_IN
| USB_TYPE_VENDOR
, /* __u8 request type */
662 0x0000, /* __u16 value not used */
663 0x0000, /* __u16 index not used */
664 &attrdata
, /* char *data */
665 sizeof(attrdata
) /* __u16 size */
671 *datap
= le16_to_cpu(attrdata
);
676 * collects the bulk endpoints, the status endpoint.
678 static int sierra_net_bind(struct usbnet
*dev
, struct usb_interface
*intf
)
684 struct sierra_net_data
*priv
;
685 static const u8 sync_tmplate
[sizeof(priv
->sync_msg
)] = {
686 0x00, 0x00, SIERRA_NET_HIP_MSYNC_ID
, 0x00};
687 static const u8 shdwn_tmplate
[sizeof(priv
->shdwn_msg
)] = {
688 0x00, 0x00, SIERRA_NET_HIP_SHUTD_ID
, 0x00};
690 dev_dbg(&dev
->udev
->dev
, "%s", __func__
);
692 ifacenum
= intf
->cur_altsetting
->desc
.bInterfaceNumber
;
693 numendpoints
= intf
->cur_altsetting
->desc
.bNumEndpoints
;
694 /* We have three endpoints, bulk in and out, and a status */
695 if (numendpoints
!= 3) {
696 dev_err(&dev
->udev
->dev
, "Expected 3 endpoints, found: %d",
700 /* Status endpoint set in usbnet_get_endpoints() */
702 status
= usbnet_get_endpoints(dev
, intf
);
704 dev_err(&dev
->udev
->dev
, "Error in usbnet_get_endpoints (%d)",
708 /* Initialize sierra private data */
709 priv
= kzalloc(sizeof *priv
, GFP_KERNEL
);
714 priv
->ifnum
= ifacenum
;
715 dev
->net
->netdev_ops
= &sierra_net_device_ops
;
717 /* change MAC addr to include, ifacenum, and to be unique */
718 dev
->net
->dev_addr
[ETH_ALEN
-2] = atomic_inc_return(&iface_counter
);
719 dev
->net
->dev_addr
[ETH_ALEN
-1] = ifacenum
;
721 /* prepare shutdown message template */
722 memcpy(priv
->shdwn_msg
, shdwn_tmplate
, sizeof(priv
->shdwn_msg
));
723 /* set context index initially to 0 - prepares tx hdr template */
724 sierra_net_set_ctx_index(priv
, 0);
726 /* prepare sync message template */
727 memcpy(priv
->sync_msg
, sync_tmplate
, sizeof(priv
->sync_msg
));
729 /* decrease the rx_urb_size and max_tx_size to 4k on USB 1.1 */
730 dev
->rx_urb_size
= SIERRA_NET_RX_URB_SIZE
;
731 if (dev
->udev
->speed
!= USB_SPEED_HIGH
)
732 dev
->rx_urb_size
= min_t(size_t, 4096, SIERRA_NET_RX_URB_SIZE
);
734 dev
->net
->hard_header_len
+= SIERRA_NET_HIP_EXT_HDR_LEN
;
735 dev
->hard_mtu
= dev
->net
->mtu
+ dev
->net
->hard_header_len
;
736 dev
->net
->max_mtu
= SIERRA_NET_MAX_SUPPORTED_MTU
;
738 /* Set up the netdev */
739 dev
->net
->flags
|= IFF_NOARP
;
740 dev
->net
->ethtool_ops
= &sierra_net_ethtool_ops
;
741 netif_carrier_off(dev
->net
);
743 sierra_net_set_private(dev
, priv
);
745 priv
->kevent_flags
= 0;
747 /* Use the shared workqueue */
748 INIT_WORK(&priv
->sierra_net_kevent
, sierra_net_kevent
);
750 /* Only need to do this once */
751 timer_setup(&priv
->sync_timer
, sierra_sync_timer
, 0);
753 /* verify fw attributes */
754 status
= sierra_net_get_fw_attr(dev
, &fwattr
);
755 dev_dbg(&dev
->udev
->dev
, "Fw attr: %x\n", fwattr
);
757 /* test whether firmware supports DHCP */
758 if (!(status
== sizeof(fwattr
) && (fwattr
& SWI_GET_FW_ATTR_MASK
))) {
759 /* found incompatible firmware version */
760 dev_err(&dev
->udev
->dev
, "Incompatible driver and firmware"
769 static void sierra_net_unbind(struct usbnet
*dev
, struct usb_interface
*intf
)
772 struct sierra_net_data
*priv
= sierra_net_get_private(dev
);
774 dev_dbg(&dev
->udev
->dev
, "%s", __func__
);
776 /* kill the timer and work */
777 del_timer_sync(&priv
->sync_timer
);
778 cancel_work_sync(&priv
->sierra_net_kevent
);
780 /* tell modem we are going away */
781 status
= sierra_net_send_cmd(dev
, priv
->shdwn_msg
,
782 sizeof(priv
->shdwn_msg
), "Shutdown");
785 "usb_control_msg failed, status %d\n", status
);
787 usbnet_status_stop(dev
);
789 sierra_net_set_private(dev
, NULL
);
793 static struct sk_buff
*sierra_net_skb_clone(struct usbnet
*dev
,
794 struct sk_buff
*skb
, int len
)
796 struct sk_buff
*new_skb
;
799 new_skb
= skb_clone(skb
, GFP_ATOMIC
);
801 /* remove len bytes from original */
804 /* trim next packet to it's length */
806 skb_trim(new_skb
, len
);
808 if (netif_msg_rx_err(dev
))
809 netdev_err(dev
->net
, "failed to get skb\n");
810 dev
->net
->stats
.rx_dropped
++;
816 /* ---------------------------- Receive data path ----------------------*/
817 static int sierra_net_rx_fixup(struct usbnet
*dev
, struct sk_buff
*skb
)
821 struct sk_buff
*new_skb
;
823 dev_dbg(&dev
->udev
->dev
, "%s", __func__
);
825 /* could contain multiple packets */
826 while (likely(skb
->len
)) {
827 err
= parse_hip(skb
->data
, skb
->len
, &hh
);
829 if (netif_msg_rx_err(dev
))
830 netdev_err(dev
->net
, "Invalid HIP header %d\n",
832 /* dev->net->stats.rx_errors incremented by caller */
833 dev
->net
->stats
.rx_length_errors
++;
837 /* Validate Extended HIP header */
838 if (!hh
.extmsgid
.is_present
839 || hh
.extmsgid
.word
!= SIERRA_NET_HIP_EXT_IP_IN_ID
) {
840 if (netif_msg_rx_err(dev
))
841 netdev_err(dev
->net
, "HIP/ETH: Invalid pkt\n");
843 dev
->net
->stats
.rx_frame_errors
++;
844 /* dev->net->stats.rx_errors incremented by caller */
848 skb_pull(skb
, hh
.hdrlen
);
850 /* We are going to accept this packet, prepare it.
851 * In case protocol is IPv6, keep it, otherwise force IPv4.
853 skb_reset_mac_header(skb
);
854 if (eth_hdr(skb
)->h_proto
!= cpu_to_be16(ETH_P_IPV6
))
855 eth_hdr(skb
)->h_proto
= cpu_to_be16(ETH_P_IP
);
856 eth_zero_addr(eth_hdr(skb
)->h_source
);
857 memcpy(eth_hdr(skb
)->h_dest
, dev
->net
->dev_addr
, ETH_ALEN
);
859 /* Last packet in batch handled by usbnet */
860 if (hh
.payload_len
.word
== skb
->len
)
863 new_skb
= sierra_net_skb_clone(dev
, skb
, hh
.payload_len
.word
);
865 usbnet_skb_return(dev
, new_skb
);
872 /* ---------------------------- Transmit data path ----------------------*/
873 static struct sk_buff
*sierra_net_tx_fixup(struct usbnet
*dev
,
874 struct sk_buff
*skb
, gfp_t flags
)
876 struct sierra_net_data
*priv
= sierra_net_get_private(dev
);
880 BUILD_BUG_ON(FIELD_SIZEOF(struct usbnet
, data
)
881 < sizeof(struct cdc_state
));
883 dev_dbg(&dev
->udev
->dev
, "%s", __func__
);
884 if (priv
->link_up
&& check_ethip_packet(skb
, dev
) && is_ip(skb
)) {
885 /* enough head room as is? */
886 if (SIERRA_NET_HIP_EXT_HDR_LEN
<= skb_headroom(skb
)) {
887 /* Save the Eth/IP length and set up HIP hdr */
889 skb_push(skb
, SIERRA_NET_HIP_EXT_HDR_LEN
);
890 /* Handle ZLP issue */
891 need_tail
= ((len
+ SIERRA_NET_HIP_EXT_HDR_LEN
)
892 % dev
->maxpacket
== 0);
894 if (unlikely(skb_tailroom(skb
) == 0)) {
895 netdev_err(dev
->net
, "tx_fixup:"
896 "no room for packet\n");
897 dev_kfree_skb_any(skb
);
900 skb
->data
[skb
->len
] = 0;
905 build_hip(skb
->data
, len
, priv
);
909 * compensate in the future if necessary
911 netdev_err(dev
->net
, "tx_fixup: no room for HIP\n");
916 dev
->net
->stats
.tx_carrier_errors
++;
918 /* tx_dropped incremented by usbnet */
920 /* filter the packet out, release it */
921 dev_kfree_skb_any(skb
);
925 static const struct driver_info sierra_net_info_direct_ip
= {
926 .description
= "Sierra Wireless USB-to-WWAN Modem",
927 .flags
= FLAG_WWAN
| FLAG_SEND_ZLP
,
928 .bind
= sierra_net_bind
,
929 .unbind
= sierra_net_unbind
,
930 .status
= sierra_net_status
,
931 .rx_fixup
= sierra_net_rx_fixup
,
932 .tx_fixup
= sierra_net_tx_fixup
,
936 sierra_net_probe(struct usb_interface
*udev
, const struct usb_device_id
*prod
)
940 ret
= usbnet_probe(udev
, prod
);
942 struct usbnet
*dev
= usb_get_intfdata(udev
);
944 ret
= usbnet_status_start(dev
, GFP_KERNEL
);
946 /* Interrupt URB now set up; initiate sync sequence */
947 sierra_net_dosync(dev
);
953 #define DIRECT_IP_DEVICE(vend, prod) \
954 {USB_DEVICE_INTERFACE_NUMBER(vend, prod, 7), \
955 .driver_info = (unsigned long)&sierra_net_info_direct_ip}, \
956 {USB_DEVICE_INTERFACE_NUMBER(vend, prod, 10), \
957 .driver_info = (unsigned long)&sierra_net_info_direct_ip}, \
958 {USB_DEVICE_INTERFACE_NUMBER(vend, prod, 11), \
959 .driver_info = (unsigned long)&sierra_net_info_direct_ip}
961 static const struct usb_device_id products
[] = {
962 DIRECT_IP_DEVICE(0x1199, 0x68A3), /* Sierra Wireless USB-to-WWAN modem */
963 DIRECT_IP_DEVICE(0x0F3D, 0x68A3), /* AT&T Direct IP modem */
964 DIRECT_IP_DEVICE(0x1199, 0x68AA), /* Sierra Wireless Direct IP LTE modem */
965 DIRECT_IP_DEVICE(0x0F3D, 0x68AA), /* AT&T Direct IP LTE modem */
969 MODULE_DEVICE_TABLE(usb
, products
);
971 /* We are based on usbnet, so let it handle the USB driver specifics */
972 static struct usb_driver sierra_net_driver
= {
973 .name
= "sierra_net",
974 .id_table
= products
,
975 .probe
= sierra_net_probe
,
976 .disconnect
= usbnet_disconnect
,
977 .suspend
= usbnet_suspend
,
978 .resume
= usbnet_resume
,
980 .disable_hub_initiated_lpm
= 1,
983 module_usb_driver(sierra_net_driver
);
985 MODULE_AUTHOR(DRIVER_AUTHOR
);
986 MODULE_DESCRIPTION(DRIVER_DESC
);
987 MODULE_VERSION(DRIVER_VERSION
);
988 MODULE_LICENSE("GPL");