1 /* $FreeBSD: releng/12.2/sys/dev/usb/net/usb_ethernet.c 334158 2018-05-24 15:24:42Z hselasky $ */
2 /*-
3 * SPDX-License-Identifier: BSD-2-Clause-FreeBSD
4 *
5 * Copyright (c) 2009 Andrew Thompson (thompsa@FreeBSD.org)
6 *
7 * Redistribution and use in source and binary forms, with or without
8 * modification, are permitted provided that the following conditions
9 * are met:
10 * 1. Redistributions of source code must retain the above copyright
11 * notice, this list of conditions and the following disclaimer.
12 * 2. Redistributions in binary form must reproduce the above copyright
13 * notice, this list of conditions and the following disclaimer in the
14 * documentation and/or other materials provided with the distribution.
15 *
16 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
17 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
20 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
22 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
23 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
24 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
25 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
26 * SUCH DAMAGE.
27 */
28
29 #include <sys/cdefs.h>
30 __FBSDID("$FreeBSD: releng/12.2/sys/dev/usb/net/usb_ethernet.c 334158 2018-05-24 15:24:42Z hselasky $");
31
32 #include <lwip/netifapi.h>
33
34 #include "implementation/global_implementation.h"
35 #include "net/usb_ethernet.h"
36
37 #define USE_LWIP_BUFFER 0
38
39 static usb_proc_callback_t ue_attach_post_task;
40 static usb_proc_callback_t ue_tick_task;
41 static usb_proc_callback_t ue_start_task;
42 static usb_proc_callback_t ue_stop_task;
43
44 struct netif *pnetif_usb0 = NULL;
45
46 #define IFQ_MAXLEN 50
47 int ifqmaxlen = IFQ_MAXLEN;
48
49 static void ue_init(struct los_eth_driver *sc,
50 unsigned char *enaddr,
51 int flags);
52 static void ue_start(struct los_eth_driver *sc,
53 struct eth_drv_sg *sg_list,
54 int sg_len,
55 int total_len,
56 UINTPTR key);
57 static void ue_watchdog(void *);
58 static void ue_start_task(struct usb_proc_msg *_task);
59
60 /*
61 * Return values:
62 * 0: success
63 * Else: device has been detached
64 */
65 uint8_t
uether_pause(struct usb_ether * ue,unsigned int _ticks)66 uether_pause(struct usb_ether *ue, unsigned int _ticks)
67 {
68 if (usb_proc_is_gone(&ue->ue_tq)) {
69 /* nothing to do */
70 return (1);
71 }
72 usb_pause_mtx(ue->ue_mtx, _ticks);
73 return (0);
74 }
75
76 static void
ue_queue_command(struct usb_ether * ue,usb_proc_callback_t * fn,struct usb_proc_msg * t0,struct usb_proc_msg * t1)77 ue_queue_command(struct usb_ether *ue,
78 usb_proc_callback_t *fn,
79 struct usb_proc_msg *t0, struct usb_proc_msg *t1)
80 {
81 struct usb_ether_cfg_task *task;
82
83 UE_LOCK_ASSERT(ue, MA_OWNED);
84
85 if (usb_proc_is_gone(&ue->ue_tq)) {
86 return; /* nothing to do */
87 }
88 /*
89 * NOTE: The task cannot get executed before we drop the
90 * "sc_mtx" mutex. It is safe to update fields in the message
91 * structure after that the message got queued.
92 */
93 task = (struct usb_ether_cfg_task *)
94 usb_proc_msignal(&ue->ue_tq, t0, t1);
95
96 /* Setup callback and self pointers */
97 task->hdr.pm_callback = fn;
98 task->ue = ue;
99
100 /*
101 * Start and stop must be synchronous!
102 */
103 if ((fn == ue_start_task) || (fn == ue_stop_task))
104 usb_proc_mwait(&ue->ue_tq, t0, t1);
105 }
106
107 void *
uether_getsc(struct usb_ether * ue)108 uether_getsc(struct usb_ether *ue)
109 {
110 return (ue->ue_sc);
111 }
112
113 int
uether_ifattach(struct usb_ether * ue)114 uether_ifattach(struct usb_ether *ue)
115 {
116 int ret = EFAULT;
117
118 /* check some critical parameters */
119 if ((ue->ue_dev == NULL) ||
120 (ue->ue_udev == NULL) ||
121 (ue->ue_mtx == NULL) ||
122 (ue->ue_methods == NULL))
123 return (EINVAL);
124
125 if (LOS_EventInit(&ue->ue_event) != LOS_OK) {
126 device_printf(ue->ue_dev, "event init fail\n");
127 goto error;
128 }
129
130 ret = usb_proc_create(&ue->ue_tq, ue->ue_mtx,
131 device_get_nameunit(ue->ue_dev), USB_PRI_MED);
132 if (ret)
133 {
134 device_printf(ue->ue_dev, "could not setup taskqueue\n");
135 (void)LOS_EventDestroy(&ue->ue_event);
136 goto error;
137 }
138
139 /* fork rest of the attach code */
140 UE_LOCK(ue);
141 ue_queue_command(ue, ue_attach_post_task,
142 &ue->ue_sync_task[0].hdr,
143 &ue->ue_sync_task[1].hdr);
144 UE_UNLOCK(ue);
145
146 error:
147 return (ret);
148 }
149
150 void
uether_ifattach_wait(struct usb_ether * ue)151 uether_ifattach_wait(struct usb_ether *ue)
152 {
153
154 UE_LOCK(ue);
155 usb_proc_mwait(&ue->ue_tq,
156 &ue->ue_sync_task[0].hdr,
157 &ue->ue_sync_task[1].hdr);
158 UE_UNLOCK(ue);
159 }
160
161 /* allocating space for eth_driver */
162 static struct los_eth_driver *
if_alloc(void)163 if_alloc(void)
164 {
165 struct los_eth_driver *sc;
166 struct eth_drv_sc *drv_sc;
167
168 sc = (struct los_eth_driver *)zalloc(sizeof(struct los_eth_driver));
169 if (sc == NULL) {
170 return (NULL);
171 }
172
173 drv_sc = (struct eth_drv_sc *)zalloc(sizeof(struct eth_drv_sc));
174 if (drv_sc == NULL) {
175 free(sc);
176 return (NULL);
177 }
178
179 drv_sc->funs = (struct eth_hwr_funs*)zalloc(sizeof(struct eth_hwr_funs));
180 if (drv_sc->funs == NULL) {
181 PRINTK("could not allocate eth_hwr_funs\n");
182 free(sc);
183 free(drv_sc);
184 return (NULL);
185 }
186 sc->driver_context = drv_sc;
187
188 return (sc);
189 }
190
191 static void
if_free(struct los_eth_driver * sc)192 if_free(struct los_eth_driver * sc)
193 {
194 struct eth_drv_sc *drv_sc;
195 if (sc == NULL) {
196 return;
197 }
198
199 drv_sc = (struct eth_drv_sc *)sc->driver_context;
200 if (drv_sc != NULL) {
201 if (drv_sc->funs) {
202 free(drv_sc->funs);
203 drv_sc->funs = NULL;
204 }
205 free(drv_sc);
206 sc->driver_context = NULL;
207 free(sc);
208 }
209 }
210
211 void
ue_recv(struct los_eth_driver * sc,struct eth_drv_sg * sg_list,int sg_len)212 ue_recv(struct los_eth_driver *sc,struct eth_drv_sg *sg_list,int sg_len)
213 {
214 struct eth_drv_sc *drv_sc = (struct eth_drv_sc *)sc->driver_context;
215 struct usb_ether *ue = (struct usb_ether *)drv_sc->driver_private;
216 struct pbuf *m;
217 UINT32 bytes_in_buffer;
218 UINT32 bytes_in_list;
219 UINT32 bytes_needed_list;
220 UINT32 buffer_pos = 0;
221 UINT8 *sg_buf;
222 UINT8 *hw_rxbuf;
223 int i;
224 int ret;
225
226 IF_DEQUEUE(&ue->ue_rxq, m);
227 if (m == NULL) {
228 PRINTK("no buffer! can not happen!\n");
229 /* Delete the space */
230 return;
231 }
232
233 for(i = 0; i < sg_len; ++i) {
234 bytes_in_list = 0;
235 while (bytes_in_list < sg_list[i].len) {
236 bytes_needed_list = sg_list[i].len - bytes_in_list;
237 bytes_in_buffer = m->len;
238 bytes_in_buffer -= buffer_pos;
239
240 sg_buf = (UINT8 *)(sg_list[i].buf);
241 hw_rxbuf = (UINT8 *)(m->payload);
242 if (bytes_needed_list < bytes_in_buffer) {
243 if (sg_buf != NULL) {
244 ret = memcpy_s(&sg_buf[bytes_in_list], bytes_needed_list,
245 (UINT8 *)&hw_rxbuf[buffer_pos], bytes_needed_list);
246 if (ret != EOK) {
247 goto END;
248 }
249 }
250 bytes_in_list += bytes_needed_list;
251 buffer_pos += bytes_needed_list;
252 } else {
253 if (sg_buf != NULL) {
254 ret = memcpy_s(&sg_buf[bytes_in_list], bytes_needed_list,
255 (UINT8 *)&hw_rxbuf[buffer_pos], bytes_in_buffer);
256 if (ret != EOK) {
257 goto END;
258 }
259 }
260
261 bytes_in_list += bytes_in_buffer;
262 buffer_pos = 0;
263 }
264 }
265 }
266
267 END:
268 uether_freebuf(m);
269 }
270
271 int
ue_can_send(struct los_eth_driver * sc)272 ue_can_send(struct los_eth_driver *sc)
273 {
274 (void)sc;
275 return (true);
276 }
277
278 static const char usb_eth_name[3] = "ue";
279
280 static void
ue_attach_post_task(struct usb_proc_msg * _task)281 ue_attach_post_task(struct usb_proc_msg *_task)
282 {
283 struct usb_ether_cfg_task *task =
284 (struct usb_ether_cfg_task *)_task;
285 struct usb_ether *ue = task->ue;
286 struct los_eth_driver *sc;
287 struct eth_drv_sc *drv_sc;
288 int error;
289
290 UE_UNLOCK(ue);
291
292 callout_init_mtx(&ue->ue_watchdog, ue->ue_mtx, 0);
293
294 error = 0;
295 sc = if_alloc();
296 if (sc == NULL) {
297 device_printf(ue->ue_dev, "could not allocate eth_drv_sc\n");
298 goto fail;
299 }
300
301 drv_sc = (struct eth_drv_sc *)sc->driver_context;
302 drv_sc->driver_private = ue;
303 drv_sc->dev_name = usb_eth_name;
304 if (ue->ue_methods->ue_attach_post_sub != NULL) {
305 ue->ue_drv_sc = sc;
306 error = ue->ue_methods->ue_attach_post_sub(ue);
307 } else {
308 drv_sc->funs->send = ue_start;
309 drv_sc->funs->can_send = ue_can_send;
310 drv_sc->funs->start = ue_init;
311 drv_sc->funs->recv = ue_recv;
312 drv_sc->funs->eth_drv = ð_drv_funs_usb;
313 ue->ue_drv_sc = sc;
314 }
315
316 if (error) {
317 device_printf(ue->ue_dev, "attaching PHYs failed\n");
318 goto fail;
319 }
320
321 (drv_sc->funs->eth_drv->init)(sc, ue->ue_eaddr);
322
323 if (LOS_EventWrite(&ue->ue_event, 0x01) != LOS_OK) {
324 device_printf(ue->ue_dev, "event write fail\n");
325 goto fail;
326 }
327
328 pnetif_usb0 = &sc->ac_if;
329
330 UE_LOCK(ue);
331 return;
332
333 fail:
334
335 if (ue->ue_drv_sc != NULL) {
336 if_free(sc);
337 ue->ue_drv_sc = NULL;
338 }
339 UE_LOCK(ue);
340 return;
341 }
342
343 void
uether_ifdetach(struct usb_ether * ue)344 uether_ifdetach(struct usb_ether *ue)
345 {
346 struct los_eth_driver *sc;
347 struct eth_drv_sc *drv_sc;
348 struct pbuf *m;
349
350 /* wait for any post attach or other command to complete */
351 usb_proc_drain(&ue->ue_tq);
352
353 /* read "ifnet" pointer after taskqueue drain */
354 sc = ue->ue_drv_sc;
355 if (sc != NULL) {
356 drv_sc = ( struct eth_drv_sc *)sc->driver_context;
357 /* we are not running any more */
358 UE_LOCK(ue);
359 drv_sc->state &= ~IFF_DRV_RUNNING;
360 UE_UNLOCK(ue);
361
362 /* drain any callouts */
363 callout_drain(&ue->ue_watchdog);
364
365 /* detach ethernet */
366 for (;;) {
367 UE_LOCK(ue);
368 IF_DEQUEUE(&(ue->ue_txq), m);
369 UE_UNLOCK(ue);
370 if (m == NULL)
371 break;
372 uether_freebuf(m);
373 }
374 for (;;) {
375 UE_LOCK(ue);
376 IF_DEQUEUE(&(ue->ue_rxq), m);
377 UE_UNLOCK(ue);
378 if (m == NULL)
379 break;
380 uether_freebuf(m);
381 }
382
383 (void)netifapi_dhcp_stop(&sc->ac_if);
384 (void)netifapi_dhcp_cleanup(&sc->ac_if);
385 (void)netifapi_netif_remove(&sc->ac_if);
386
387 /* free interface instance */
388 if_free(sc);
389 ue->ue_drv_sc = NULL;
390 }
391
392 /* free taskqueue, if any */
393 usb_proc_free(&ue->ue_tq);
394
395 (void)LOS_EventDestroy(&ue->ue_event);
396 }
397
398 uint8_t
uether_is_gone(struct usb_ether * ue)399 uether_is_gone(struct usb_ether *ue)
400 {
401 return (usb_proc_is_gone(&ue->ue_tq));
402 }
403
404 static void
ue_init(struct los_eth_driver * sc,unsigned char * enaddr,int flags)405 ue_init(struct los_eth_driver *sc,
406 unsigned char *enaddr,
407 int flags)
408 {
409 struct eth_drv_sc *drv_sc = (struct eth_drv_sc *)sc->driver_context;
410 struct usb_ether *ue = (struct usb_ether *)drv_sc->driver_private;
411
412 UE_LOCK(ue);
413 ue_start_task(&ue->ue_sync_task[0].hdr);
414 UE_UNLOCK(ue);
415 }
416
417 static void
ue_start_task(struct usb_proc_msg * _task)418 ue_start_task(struct usb_proc_msg *_task)
419 {
420 struct usb_ether_cfg_task *task =
421 (struct usb_ether_cfg_task *)_task;
422 struct usb_ether *ue = task->ue;
423 struct los_eth_driver *sc = ue->ue_drv_sc;
424 struct eth_drv_sc *drv_sc = (struct eth_drv_sc *)sc->driver_context;
425
426 UE_LOCK_ASSERT(ue, MA_OWNED);
427
428 ue->ue_methods->ue_init(ue);
429
430 if ((drv_sc->state & IFF_DRV_RUNNING) == 0)
431 return;
432
433 if (ue->ue_methods->ue_tick != NULL)
434 callout_reset(&ue->ue_watchdog, hz, ue_watchdog, ue);
435 }
436
437 static void
ue_stop_task(struct usb_proc_msg * _task)438 ue_stop_task(struct usb_proc_msg *_task)
439 {
440 struct usb_ether_cfg_task *task =
441 (struct usb_ether_cfg_task *)_task;
442 struct usb_ether *ue = task->ue;
443
444 UE_LOCK_ASSERT(ue, MA_OWNED);
445
446 callout_stop(&ue->ue_watchdog);
447
448 ue->ue_methods->ue_stop(ue);
449 }
450
451 static void
ue_start(struct los_eth_driver * sc,struct eth_drv_sg * sg_list,int sg_len,int total_len,UINTPTR key)452 ue_start(struct los_eth_driver *sc,
453 struct eth_drv_sg *sg_list,
454 int sg_len,
455 int total_len,
456 UINTPTR key)
457 {
458 struct eth_drv_sc *drv_sc = (struct eth_drv_sc *)sc->driver_context;
459 struct usb_ether *ue = (struct usb_ether *)drv_sc->driver_private;
460 struct pbuf *m;
461 int len = 0;
462 int i;
463 int ret;
464
465 m = uether_newbuf(total_len);
466 if (m == NULL) {
467 return;
468 }
469
470 for (i = 0; i < sg_len; i++) {
471 ret = memcpy_s((void *)((char *)m->payload + len), (size_t)(total_len - len),
472 (const void *)(sg_list[i].buf), sg_list[i].len);
473 if (ret != EOK) {
474 uether_freebuf(m);
475 return;
476 }
477 len += sg_list[i].len;
478 }
479
480 UE_LOCK(ue);
481 if ((drv_sc->state & IFF_DRV_RUNNING) == 0) {
482 UE_UNLOCK(ue);
483 uether_freebuf(m);
484 return;
485 }
486 IF_ENQUEUE(&(ue->ue_txq), m);
487
488 ue->ue_methods->ue_start(ue);
489 UE_UNLOCK(ue);
490 }
491
492 static void
ue_watchdog(void * arg)493 ue_watchdog(void *arg)
494 {
495 struct usb_ether *ue = (struct usb_ether *)arg;
496 struct los_eth_driver *sc = ue->ue_drv_sc;
497 struct eth_drv_sc *drv_sc = (struct eth_drv_sc *)sc->driver_context;
498
499 if ((drv_sc->state & IFF_DRV_RUNNING) == 0)
500 return;
501
502 ue_queue_command(ue, ue_tick_task,
503 &ue->ue_tick_task[0].hdr,
504 &ue->ue_tick_task[1].hdr);
505
506 callout_reset(&ue->ue_watchdog, hz, ue_watchdog, ue);
507 }
508
509 static void
ue_tick_task(struct usb_proc_msg * _task)510 ue_tick_task(struct usb_proc_msg *_task)
511 {
512 struct usb_ether_cfg_task *task =
513 (struct usb_ether_cfg_task *)_task;
514 struct usb_ether *ue = task->ue;
515 struct los_eth_driver *sc = ue->ue_drv_sc;
516 struct eth_drv_sc *drv_sc = (struct eth_drv_sc *)sc->driver_context;
517
518 if ((drv_sc->state & IFF_DRV_RUNNING) == 0)
519 return;
520
521 ue->ue_methods->ue_tick(ue);
522 }
523
524 #if USE_LWIP_BUFFER
525 struct pbuf *
uether_newbuf(int length)526 uether_newbuf(int length)
527 {
528 struct pbuf *m_new;
529 m_new = pbuf_alloc(PBUF_RAW, length, PBUF_RAM);
530
531 if (m_new == NULL) {
532 PRINTK("pbuf_alloc fail\n");
533 return (NULL);
534 }
535 #if ETH_PAD_SIZE
536 pbuf_header(m_new, -ETH_PAD_SIZE); /* drop the padding word */
537 #endif
538
539 return (m_new);
540 }
541 #else
542 struct pbuf *
uether_newbuf(int length)543 uether_newbuf(int length)
544 {
545 struct pbuf *m_new = (struct pbuf *)zalloc(sizeof(struct pbuf));
546 if (m_new == NULL) {
547 PRINTK("pbuf_alloc fail\n");
548 return (NULL);
549 }
550 m_new->payload = memalign(USB_CACHE_ALIGN_SIZE, SKB_DATA_ALIGN(length));
551 if (m_new->payload == NULL) {
552 PRINTK("pbuf_alloc fail\n");
553 free(m_new);
554 return (NULL);
555 }
556 (void)memset_s(m_new->payload, SKB_DATA_ALIGN(length), 0, SKB_DATA_ALIGN(length));
557
558 m_new->len = length;
559
560 return (m_new);
561 }
562
563 void
uether_freebuf(struct pbuf * buf)564 uether_freebuf(struct pbuf *buf)
565 {
566 if(buf != NULL) {
567 if(buf->payload) {
568 free(buf->payload);
569 buf->payload = NULL;
570 }
571 free(buf);
572 }
573 }
574 #endif
575 int
uether_rxmbuf(struct usb_ether * ue,struct pbuf * m,unsigned int len)576 uether_rxmbuf(struct usb_ether *ue, struct pbuf *m, unsigned int len)
577 {
578 UE_LOCK_ASSERT(ue, MA_OWNED);
579
580 m->len = len;
581
582 /* enqueue for later when the lock can be released */
583 IF_ENQUEUE(&(ue->ue_rxq), m);
584 ue->ue_rxq.ifq_head->tot_len += len;
585 return (0);
586 }
587
588 #if USE_LWIP_BUFFER
589 void
uether_rxflush(struct usb_ether * ue)590 uether_rxflush(struct usb_ether *ue)
591 {
592 struct netif *netif = &(ue->ue_drv_sc->ac_if);
593 struct pbuf *m = ue->ue_rxq.ifq_head;
594 int tot_len = 0;
595 struct pbuf *q;
596
597 UE_LOCK_ASSERT(ue, MA_OWNED);
598
599 PRINTK("uether_rxflush \n");
600 for (q = m; q != NULL; q = q->next) {
601 tot_len += q->len;
602 }
603 m->tot_len = tot_len;
604
605 #if ETH_PAD_SIZE
606 pbuf_header(m, ETH_PAD_SIZE); /* drop the padding word */
607 #endif
608
609 /*
610 * The USB xfer has been resubmitted so its safe to unlock now.
611 */
612 UE_UNLOCK(ue);
613
614 driverif_input(netif, m);
615 UE_LOCK(ue);
616 }
617 #else
618 void
uether_rxflush(struct usb_ether * ue)619 uether_rxflush(struct usb_ether *ue)
620 {
621 struct los_eth_driver *sc = ue->ue_drv_sc;
622 struct eth_drv_sc *drv_sc = (struct eth_drv_sc *)sc->driver_context;
623 struct pbuf *m;
624
625 UE_LOCK_ASSERT(ue, MA_OWNED);
626 for (;;) {
627 m = ue->ue_rxq.ifq_head;
628 if (m == NULL)
629 break;
630
631 (drv_sc->funs->eth_drv->recv)(sc, m->len);
632 }
633 }
634 #endif
635