1 /* 2 * Copyright (c) 2011 The Chromium OS Authors. 3 * 4 * SPDX-License-Identifier: GPL-2.0+ 5 */ 6 7 #ifndef __USB_ETHER_H__ 8 #define __USB_ETHER_H__ 9 10 #include <net.h> 11 12 /* 13 * IEEE 802.3 Ethernet magic constants. The frame sizes omit the preamble 14 * and FCS/CRC (frame check sequence). 15 */ 16 #define ETH_ALEN 6 /* Octets in one ethernet addr */ 17 #define ETH_HLEN 14 /* Total octets in header. */ 18 #define ETH_ZLEN 60 /* Min. octets in frame sans FCS */ 19 #define ETH_DATA_LEN 1500 /* Max. octets in payload */ 20 #define ETH_FRAME_LEN PKTSIZE_ALIGN /* Max. octets in frame sans FCS */ 21 22 /* TODO(sjg@chromium.org): Remove @pusb_dev when all boards use CONFIG_DM_ETH */ 23 struct ueth_data { 24 /* eth info */ 25 #ifdef CONFIG_DM_ETH 26 uint8_t *rxbuf; 27 int rxsize; 28 int rxlen; /* Total bytes available in rxbuf */ 29 int rxptr; /* Current position in rxbuf */ 30 #else 31 struct eth_device eth_dev; /* used with eth_register */ 32 /* driver private */ 33 void *dev_priv; 34 #endif 35 int phy_id; /* mii phy id */ 36 37 /* usb info */ 38 struct usb_device *pusb_dev; /* this usb_device */ 39 unsigned char ifnum; /* interface number */ 40 unsigned char ep_in; /* in endpoint */ 41 unsigned char ep_out; /* out ....... */ 42 unsigned char ep_int; /* interrupt . */ 43 unsigned char subclass; /* as in overview */ 44 unsigned char protocol; /* .............. */ 45 unsigned char irqinterval; /* Intervall for IRQ Pipe */ 46 }; 47 48 #ifdef CONFIG_DM_ETH 49 /** 50 * usb_ether_register() - register a new USB ethernet device 51 * 52 * This selects the correct USB interface and figures out the endpoints to use. 53 * 54 * @dev: USB device 55 * @ss: Place to put USB ethernet data 56 * @rxsize: Maximum size to allocate for the receive buffer 57 * @return 0 if OK, -ve on error 58 */ 59 int usb_ether_register(struct udevice *dev, struct ueth_data *ueth, int rxsize); 60 61 /** 62 * usb_ether_deregister() - deregister a USB ethernet device 63 * 64 * @ueth: USB Ethernet device 65 * @return 0 66 */ 67 int usb_ether_deregister(struct ueth_data *ueth); 68 69 /** 70 * usb_ether_receive() - recieve a packet from the bulk in endpoint 71 * 72 * The packet is stored in the internal buffer ready for processing. 73 * 74 * @ueth: USB Ethernet device 75 * @rxsize: Maximum size to receive 76 * @return 0 if a packet was received, -EAGAIN if not, -ENOSPC if @rxsize is 77 * larger than the size passed ot usb_ether_register(), other -ve on error 78 */ 79 int usb_ether_receive(struct ueth_data *ueth, int rxsize); 80 81 /** 82 * usb_ether_get_rx_bytes() - obtain bytes from the internal packet buffer 83 * 84 * This should be called repeatedly to obtain packet data until it returns 0. 85 * After each packet is processed, call usb_ether_advance_rxbuf() to move to 86 * the next one. 87 * 88 * @ueth: USB Ethernet device 89 * @ptrp: Returns a pointer to the start of the next packet if there is 90 * one available 91 * @return number of bytes available, or 0 if none 92 */ 93 int usb_ether_get_rx_bytes(struct ueth_data *ueth, uint8_t **ptrp); 94 95 /** 96 * usb_ether_advance_rxbuf() - Advance to the next packet in the internal buffer 97 * 98 * After processing the data returned by usb_ether_get_rx_bytes(), call this 99 * function to move to the next packet. You must specify the number of bytes 100 * you have processed in @num_bytes. 101 * 102 * @ueth: USB Ethernet device 103 * @num_bytes: Number of bytes to skip, or -1 to skip all bytes 104 */ 105 void usb_ether_advance_rxbuf(struct ueth_data *ueth, int num_bytes); 106 #else 107 /* 108 * Function definitions for each USB ethernet driver go here 109 * (declaration is unconditional, compilation is conditional) 110 */ 111 void asix_eth_before_probe(void); 112 int asix_eth_probe(struct usb_device *dev, unsigned int ifnum, 113 struct ueth_data *ss); 114 int asix_eth_get_info(struct usb_device *dev, struct ueth_data *ss, 115 struct eth_device *eth); 116 117 void ax88179_eth_before_probe(void); 118 int ax88179_eth_probe(struct usb_device *dev, unsigned int ifnum, 119 struct ueth_data *ss); 120 int ax88179_eth_get_info(struct usb_device *dev, struct ueth_data *ss, 121 struct eth_device *eth); 122 123 void mcs7830_eth_before_probe(void); 124 int mcs7830_eth_probe(struct usb_device *dev, unsigned int ifnum, 125 struct ueth_data *ss); 126 int mcs7830_eth_get_info(struct usb_device *dev, struct ueth_data *ss, 127 struct eth_device *eth); 128 129 void smsc95xx_eth_before_probe(void); 130 int smsc95xx_eth_probe(struct usb_device *dev, unsigned int ifnum, 131 struct ueth_data *ss); 132 int smsc95xx_eth_get_info(struct usb_device *dev, struct ueth_data *ss, 133 struct eth_device *eth); 134 #endif 135 136 #endif /* __USB_ETHER_H__ */ 137