gadget/function/u_ether.h

1 /* SPDX-License-Identifier: GPL-2.0+ */
3  * u_ether.h -- interface to USB gadget "ethernet link" utilities
5  * Copyright (C) 2003-2005,2008 David Brownell
6  * Copyright (C) 2003-2004 Robert Schwebel, Benedikt Spranger
15 #include <linux/usb/composite.h>
16 #include <linux/usb/cdc.h>
37 	MODULE_PARM_DESC(host_addr, "Host Ethernet Address")
42  * This represents the USB side of an "ethernet" link, managed by a USB
45  * using different host interaction models.
96 /* gether_setup - initialize one ethernet-over-usb link
99  *	host side of the link is recorded
112 	return gether_setup_name(g, dev_addr, host_addr, ethaddr, qmult, "usb");  in gether_setup()
122  * gether_register_netdev - register the net device
125  * Registers the net device associated with this ethernet-over-usb link
130 /* gether_setup_default - initialize one ethernet-over-usb link
141 	return gether_setup_name_default("usb");  in gether_setup_default()
145  * gether_set_gadget - initialize one ethernet-over-usb link with a gadget
149  * This associates one ethernet-over-usb link with a gadget.
154  * gether_set_dev_addr - initialize an ethernet-over-usb link with eth address
158  * This sets the device-side Ethernet address of this ethernet-over-usb link
165  * gether_get_dev_addr - get an ethernet-over-usb link eth address
170  * This gets the device-side Ethernet address of this ethernet-over-usb link.
176  * gether_set_host_addr - initialize an ethernet-over-usb link with host address
178  * @host_addr: eth address of the host
180  * This sets the host-side Ethernet address of this ethernet-over-usb link
187  * gether_get_host_addr - get an ethernet-over-usb link host address
189  * @host_addr: place to store eth address of the host
192  * This gets the host-side Ethernet address of this ethernet-over-usb link.
198  * gether_get_host_addr_cdc - get an ethernet-over-usb link host address
200  * @host_addr: place to store eth address of the host
203  * This gets the CDC formatted host-side Ethernet address of this
204  * ethernet-over-usb link.
210  * gether_get_host_addr_u8 - get an ethernet-over-usb link host address
212  * @host_mac: place to store the eth address of the host
214  * This gets the binary formatted host-side Ethernet address of this
215  * ethernet-over-usb link.
220  * gether_set_qmult - initialize an ethernet-over-usb link with a multiplier
224  * This sets the queue length multiplier of this ethernet-over-usb link.
230  * gether_get_qmult - get an ethernet-over-usb link multiplier
233  * This gets the queue length multiplier of this ethernet-over-usb link.
238  * gether_get_ifname - get an ethernet-over-usb link interface name
243  * This gets the interface name of this ethernet-over-usb link.
249  * gether_set_ifname - set an ethernet-over-usb link interface name
254  * This sets the interface name of this ethernet-over-usb link.
282 /* peak (theoretical) bulk transfer rate in bits-per-second */
285 	if (g->speed >= USB_SPEED_SUPER_PLUS)  in gether_bitrate()
287 	if (g->speed == USB_SPEED_SUPER)  in gether_bitrate()
289 	else if (g->speed == USB_SPEED_HIGH)  in gether_bitrate()