2 * Copyright (c) 2010 Hans Petter Selasky. All rights reserved.
3 * Copyright (c) 2009 Diego Giagio. All rights reserved.
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
8 * 1. Redistributions of source code must retain the above copyright
9 * notice, this list of conditions and the following disclaimer.
10 * 2. Redistributions in binary form must reproduce the above copyright
11 * notice, this list of conditions and the following disclaimer in the
12 * documentation and/or other materials provided with the distribution.
14 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
15 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
18 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
26 * $FreeBSD: head/sys/dev/usb/net/if_ipheth.c 271832 2014-09-18 21:09:22Z glebius $
30 * Thanks to Diego Giagio for figuring out the programming details for
31 * the Apple iPhone Ethernet driver.
34 #include <sys/stdint.h>
35 #include <sys/param.h>
36 #include <sys/queue.h>
37 #include <sys/types.h>
38 #include <sys/systm.h>
39 #include <sys/kernel.h>
41 #include <sys/module.h>
43 #include <sys/condvar.h>
44 #include <sys/socket.h>
45 #include <sys/sysctl.h>
46 #include <sys/unistd.h>
47 #include <sys/callout.h>
48 #include <sys/malloc.h>
52 #include <net/if_var.h>
53 #include <net/ifq_var.h>
55 #include <bus/u4b/usb.h>
56 #include <bus/u4b/usbdi.h>
57 #include <bus/u4b/usbdi_util.h>
60 #define USB_DEBUG_VAR ipheth_debug
61 #include <bus/u4b/usb_debug.h>
62 #include <bus/u4b/usb_process.h>
64 #include <bus/u4b/net/usb_ethernet.h>
65 #include <bus/u4b/net/if_iphethvar.h>
67 static device_probe_t ipheth_probe
;
68 static device_attach_t ipheth_attach
;
69 static device_detach_t ipheth_detach
;
71 static usb_callback_t ipheth_bulk_write_callback
;
72 static usb_callback_t ipheth_bulk_read_callback
;
74 static uether_fn_t ipheth_attach_post
;
75 static uether_fn_t ipheth_tick
;
76 static uether_fn_t ipheth_init
;
77 static uether_fn_t ipheth_stop
;
78 static uether_fn_t ipheth_start
;
79 static uether_fn_t ipheth_setmulti
;
80 static uether_fn_t ipheth_setpromisc
;
83 static int ipheth_debug
= 0;
85 static SYSCTL_NODE(_hw_usb
, OID_AUTO
, ipheth
, CTLFLAG_RW
, 0, "USB iPhone ethernet");
86 SYSCTL_INT(_hw_usb_ipheth
, OID_AUTO
, debug
, CTLFLAG_RW
, &ipheth_debug
, 0, "Debug level");
89 static const struct usb_config ipheth_config
[IPHETH_N_TRANSFER
] = {
93 .endpoint
= UE_ADDR_ANY
,
94 .direction
= UE_DIR_RX
,
95 .frames
= IPHETH_RX_FRAMES_MAX
,
96 .bufsize
= (IPHETH_RX_FRAMES_MAX
* MCLBYTES
),
97 .flags
= {.short_frames_ok
= 1,.short_xfer_ok
= 1,.ext_buffer
= 1,},
98 .callback
= ipheth_bulk_read_callback
,
99 .timeout
= 0, /* no timeout */
104 .endpoint
= UE_ADDR_ANY
,
105 .direction
= UE_DIR_TX
,
106 .frames
= IPHETH_TX_FRAMES_MAX
,
107 .bufsize
= (IPHETH_TX_FRAMES_MAX
* IPHETH_BUF_SIZE
),
108 .flags
= {.force_short_xfer
= 1,},
109 .callback
= ipheth_bulk_write_callback
,
110 .timeout
= IPHETH_TX_TIMEOUT
,
114 static device_method_t ipheth_methods
[] = {
115 /* Device interface */
116 DEVMETHOD(device_probe
, ipheth_probe
),
117 DEVMETHOD(device_attach
, ipheth_attach
),
118 DEVMETHOD(device_detach
, ipheth_detach
),
123 static driver_t ipheth_driver
= {
125 .methods
= ipheth_methods
,
126 .size
= sizeof(struct ipheth_softc
),
129 static devclass_t ipheth_devclass
;
131 DRIVER_MODULE(ipheth
, uhub
, ipheth_driver
, ipheth_devclass
, NULL
, NULL
);
132 MODULE_VERSION(ipheth
, 1);
133 MODULE_DEPEND(ipheth
, uether
, 1, 1, 1);
134 MODULE_DEPEND(ipheth
, usb
, 1, 1, 1);
135 MODULE_DEPEND(ipheth
, ether
, 1, 1, 1);
137 static const struct usb_ether_methods ipheth_ue_methods
= {
138 .ue_attach_post
= ipheth_attach_post
,
139 .ue_start
= ipheth_start
,
140 .ue_init
= ipheth_init
,
141 .ue_tick
= ipheth_tick
,
142 .ue_stop
= ipheth_stop
,
143 .ue_setmulti
= ipheth_setmulti
,
144 .ue_setpromisc
= ipheth_setpromisc
,
147 #define IPHETH_ID(v,p,c,sc,pt) \
148 USB_VENDOR(v), USB_PRODUCT(p), \
149 USB_IFACE_CLASS(c), USB_IFACE_SUBCLASS(sc), \
150 USB_IFACE_PROTOCOL(pt)
152 static const STRUCT_USB_HOST_ID ipheth_devs
[] = {
154 {IPHETH_ID(USB_VENDOR_APPLE
, USB_PRODUCT_APPLE_IPHONE
,
155 IPHETH_USBINTF_CLASS
, IPHETH_USBINTF_SUBCLASS
,
156 IPHETH_USBINTF_PROTO
)},
157 {IPHETH_ID(USB_VENDOR_APPLE
, USB_PRODUCT_APPLE_IPHONE_3G
,
158 IPHETH_USBINTF_CLASS
, IPHETH_USBINTF_SUBCLASS
,
159 IPHETH_USBINTF_PROTO
)},
160 {IPHETH_ID(USB_VENDOR_APPLE
, USB_PRODUCT_APPLE_IPHONE_3GS
,
161 IPHETH_USBINTF_CLASS
, IPHETH_USBINTF_SUBCLASS
,
162 IPHETH_USBINTF_PROTO
)},
163 {IPHETH_ID(USB_VENDOR_APPLE
, USB_PRODUCT_APPLE_IPHONE_4
,
164 IPHETH_USBINTF_CLASS
, IPHETH_USBINTF_SUBCLASS
,
165 IPHETH_USBINTF_PROTO
)},
166 {IPHETH_ID(USB_VENDOR_APPLE
, USB_PRODUCT_APPLE_IPHONE_4S
,
167 IPHETH_USBINTF_CLASS
, IPHETH_USBINTF_SUBCLASS
,
168 IPHETH_USBINTF_PROTO
)},
169 {IPHETH_ID(USB_VENDOR_APPLE
, USB_PRODUCT_APPLE_IPHONE_5
,
170 IPHETH_USBINTF_CLASS
, IPHETH_USBINTF_SUBCLASS
,
171 IPHETH_USBINTF_PROTO
)},
173 /* product agnostic interface match */
174 {USB_VENDOR(USB_VENDOR_APPLE
),
175 USB_IFACE_CLASS(IPHETH_USBINTF_CLASS
),
176 USB_IFACE_SUBCLASS(IPHETH_USBINTF_SUBCLASS
),
177 USB_IFACE_PROTOCOL(IPHETH_USBINTF_PROTO
)},
182 ipheth_get_mac_addr(struct ipheth_softc
*sc
)
184 struct usb_device_request req
;
187 req
.bmRequestType
= UT_READ_VENDOR_DEVICE
;
188 req
.bRequest
= IPHETH_CMD_GET_MACADDR
;
191 req
.wIndex
[0] = sc
->sc_iface_no
;
193 req
.wLength
[0] = ETHER_ADDR_LEN
;
196 error
= usbd_do_request(sc
->sc_ue
.ue_udev
, NULL
, &req
, sc
->sc_data
);
201 memcpy(sc
->sc_ue
.ue_eaddr
, sc
->sc_data
, ETHER_ADDR_LEN
);
207 ipheth_probe(device_t dev
)
209 struct usb_attach_arg
*uaa
= device_get_ivars(dev
);
211 if (uaa
->usb_mode
!= USB_MODE_HOST
)
214 return (usbd_lookup_id_by_uaa(ipheth_devs
, sizeof(ipheth_devs
), uaa
));
218 ipheth_attach(device_t dev
)
220 struct ipheth_softc
*sc
= device_get_softc(dev
);
221 struct usb_ether
*ue
= &sc
->sc_ue
;
222 struct usb_attach_arg
*uaa
= device_get_ivars(dev
);
225 sc
->sc_iface_no
= uaa
->info
.bIfaceIndex
;
227 device_set_usb_desc(dev
);
229 lockinit(&sc
->sc_lock
, device_get_nameunit(dev
), 0, LK_CANRECURSE
);
231 error
= usbd_set_alt_interface_index(uaa
->device
,
232 uaa
->info
.bIfaceIndex
, IPHETH_ALT_INTFNUM
);
234 device_printf(dev
, "Cannot set alternate setting\n");
237 error
= usbd_transfer_setup(uaa
->device
, &sc
->sc_iface_no
,
238 sc
->sc_xfer
, ipheth_config
, IPHETH_N_TRANSFER
, sc
, &sc
->sc_lock
);
240 device_printf(dev
, "Cannot setup USB transfers\n");
245 ue
->ue_udev
= uaa
->device
;
246 ue
->ue_lock
= &sc
->sc_lock
;
247 ue
->ue_methods
= &ipheth_ue_methods
;
249 error
= ipheth_get_mac_addr(sc
);
251 device_printf(dev
, "Cannot get MAC address\n");
255 error
= uether_ifattach(ue
);
257 device_printf(dev
, "could not attach interface\n");
260 return (0); /* success */
264 return (ENXIO
); /* failure */
268 ipheth_detach(device_t dev
)
270 struct ipheth_softc
*sc
= device_get_softc(dev
);
271 struct usb_ether
*ue
= &sc
->sc_ue
;
273 /* stop all USB transfers first */
274 usbd_transfer_unsetup(sc
->sc_xfer
, IPHETH_N_TRANSFER
);
278 lockuninit(&sc
->sc_lock
);
284 ipheth_start(struct usb_ether
*ue
)
286 struct ipheth_softc
*sc
= uether_getsc(ue
);
289 * Start the USB transfers, if not already started:
291 usbd_transfer_start(sc
->sc_xfer
[IPHETH_BULK_TX
]);
292 usbd_transfer_start(sc
->sc_xfer
[IPHETH_BULK_RX
]);
296 ipheth_stop(struct usb_ether
*ue
)
298 struct ipheth_softc
*sc
= uether_getsc(ue
);
301 * Stop the USB transfers, if not already stopped:
303 usbd_transfer_stop(sc
->sc_xfer
[IPHETH_BULK_TX
]);
304 usbd_transfer_stop(sc
->sc_xfer
[IPHETH_BULK_RX
]);
308 ipheth_tick(struct usb_ether
*ue
)
310 struct ipheth_softc
*sc
= uether_getsc(ue
);
311 struct usb_device_request req
;
314 req
.bmRequestType
= UT_READ_VENDOR_DEVICE
;
315 req
.bRequest
= IPHETH_CMD_CARRIER_CHECK
;
318 req
.wIndex
[0] = sc
->sc_iface_no
;
320 req
.wLength
[0] = IPHETH_CTRL_BUF_SIZE
;
323 error
= uether_do_request(ue
, &req
, sc
->sc_data
, IPHETH_CTRL_TIMEOUT
);
329 (sc
->sc_data
[0] == IPHETH_CARRIER_ON
);
333 ipheth_attach_post(struct usb_ether
*ue
)
339 ipheth_init(struct usb_ether
*ue
)
341 struct ipheth_softc
*sc
= uether_getsc(ue
);
342 struct ifnet
*ifp
= uether_getifp(ue
);
344 IPHETH_LOCK_ASSERT(sc
);
346 ifp
->if_flags
|= IFF_RUNNING
;
348 /* stall data write direction, which depends on USB mode */
349 usbd_xfer_set_stall(sc
->sc_xfer
[IPHETH_BULK_TX
]);
351 /* start data transfers */
356 ipheth_setmulti(struct usb_ether
*ue
)
362 ipheth_setpromisc(struct usb_ether
*ue
)
368 ipheth_free_queue(struct mbuf
**ppm
, uint8_t n
)
372 for (x
= 0; x
!= n
; x
++) {
373 if (ppm
[x
] != NULL
) {
381 ipheth_bulk_write_callback(struct usb_xfer
*xfer
, usb_error_t error
)
383 struct ipheth_softc
*sc
= usbd_xfer_softc(xfer
);
384 struct ifnet
*ifp
= uether_getifp(&sc
->sc_ue
);
385 struct usb_page_cache
*pc
;
391 usbd_xfer_status(xfer
, &actlen
, NULL
, &aframes
, NULL
);
395 switch (USB_GET_STATE(xfer
)) {
396 case USB_ST_TRANSFERRED
:
397 DPRINTFN(11, "transfer complete: %u bytes in %u frames\n",
400 IFNET_STAT_INC(ifp
, opackets
, 1);
402 /* free all previous TX buffers */
403 ipheth_free_queue(sc
->sc_tx_buf
, IPHETH_TX_FRAMES_MAX
);
408 for (x
= 0; x
!= IPHETH_TX_FRAMES_MAX
; x
++) {
410 m
= ifq_dequeue(&ifp
->if_snd
);
415 usbd_xfer_set_frame_offset(xfer
,
416 x
* IPHETH_BUF_SIZE
, x
);
418 pc
= usbd_xfer_get_frame(xfer
, x
);
420 sc
->sc_tx_buf
[x
] = m
;
422 if (m
->m_pkthdr
.len
> IPHETH_BUF_SIZE
)
423 m
->m_pkthdr
.len
= IPHETH_BUF_SIZE
;
425 usbd_m_copy_in(pc
, 0, m
, 0, m
->m_pkthdr
.len
);
427 usbd_xfer_set_frame_len(xfer
, x
, IPHETH_BUF_SIZE
);
429 if (IPHETH_BUF_SIZE
!= m
->m_pkthdr
.len
) {
430 usbd_frame_zero(pc
, m
->m_pkthdr
.len
,
431 IPHETH_BUF_SIZE
- m
->m_pkthdr
.len
);
435 * If there's a BPF listener, bounce a copy of
441 usbd_xfer_set_frames(xfer
, x
);
443 usbd_transfer_submit(xfer
);
448 DPRINTFN(11, "transfer error, %s\n",
451 /* free all previous TX buffers */
452 ipheth_free_queue(sc
->sc_tx_buf
, IPHETH_TX_FRAMES_MAX
);
454 /* count output errors */
455 IFNET_STAT_INC(ifp
, oerrors
, 1);
457 if (error
!= USB_ERR_CANCELLED
) {
458 /* try to clear stall first */
459 usbd_xfer_set_stall(xfer
);
467 ipheth_bulk_read_callback(struct usb_xfer
*xfer
, usb_error_t error
)
469 struct ipheth_softc
*sc
= usbd_xfer_softc(xfer
);
476 usbd_xfer_status(xfer
, &actlen
, NULL
, &aframes
, NULL
);
478 switch (USB_GET_STATE(xfer
)) {
479 case USB_ST_TRANSFERRED
:
481 DPRINTF("received %u bytes in %u frames\n", actlen
, aframes
);
483 for (x
= 0; x
!= aframes
; x
++) {
485 m
= sc
->sc_rx_buf
[x
];
486 sc
->sc_rx_buf
[x
] = NULL
;
487 len
= usbd_xfer_frame_len(xfer
, x
);
489 if (len
< (sizeof(struct ether_header
) +
495 m_adj(m
, IPHETH_RX_ADJ
);
498 uether_rxmbuf(&sc
->sc_ue
, m
, len
- IPHETH_RX_ADJ
);
504 for (x
= 0; x
!= IPHETH_RX_FRAMES_MAX
; x
++) {
505 if (sc
->sc_rx_buf
[x
] == NULL
) {
510 /* cancel alignment for ethernet */
511 m_adj(m
, ETHER_ALIGN
);
513 sc
->sc_rx_buf
[x
] = m
;
515 m
= sc
->sc_rx_buf
[x
];
518 usbd_xfer_set_frame_data(xfer
, x
, m
->m_data
, m
->m_len
);
520 /* set number of frames and start hardware */
521 usbd_xfer_set_frames(xfer
, x
);
522 usbd_transfer_submit(xfer
);
523 /* flush any received frames */
524 uether_rxflush(&sc
->sc_ue
);
528 DPRINTF("error = %s\n", usbd_errstr(error
));
530 if (error
!= USB_ERR_CANCELLED
) {
532 /* try to clear stall first */
533 usbd_xfer_set_stall(xfer
);
534 usbd_xfer_set_frames(xfer
, 0);
535 usbd_transfer_submit(xfer
);
538 /* need to free the RX-mbufs when we are cancelled */
539 ipheth_free_queue(sc
->sc_rx_buf
, IPHETH_RX_FRAMES_MAX
);