mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
synced 2024-08-23 09:19:51 +00:00
![Christoph Egger](/assets/img/avatar_default.png)
A bunch of USB gadget drivers where never ported from the linux 2.4 series to 2.6 kernels. However there's some code still in the tree for them which isn't used and is probably untested for ages. As the chance of these drivers being forward ported is probably quite small now it might be time to get rid of them. Signed-off-by: Christoph Egger <siccegge@stud.informatik.uni-erlangen.de> Cc: Alan Stern <stern@rowland.harvard.edu> Signed-off-by: Greg Kroah-Hartman <gregkh@suse.de>
122 lines
3.7 KiB
C
122 lines
3.7 KiB
C
/*
|
|
* u_ether.h -- interface to USB gadget "ethernet link" utilities
|
|
*
|
|
* Copyright (C) 2003-2005,2008 David Brownell
|
|
* Copyright (C) 2003-2004 Robert Schwebel, Benedikt Spranger
|
|
* Copyright (C) 2008 Nokia Corporation
|
|
*
|
|
* This program is free software; you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation; either version 2 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* This program is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with this program; if not, write to the Free Software
|
|
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
|
*/
|
|
|
|
#ifndef __U_ETHER_H
|
|
#define __U_ETHER_H
|
|
|
|
#include <linux/err.h>
|
|
#include <linux/if_ether.h>
|
|
#include <linux/usb/composite.h>
|
|
#include <linux/usb/cdc.h>
|
|
|
|
#include "gadget_chips.h"
|
|
|
|
|
|
/*
|
|
* This represents the USB side of an "ethernet" link, managed by a USB
|
|
* function which provides control and (maybe) framing. Two functions
|
|
* in different configurations could share the same ethernet link/netdev,
|
|
* using different host interaction models.
|
|
*
|
|
* There is a current limitation that only one instance of this link may
|
|
* be present in any given configuration. When that's a problem, network
|
|
* layer facilities can be used to package multiple logical links on this
|
|
* single "physical" one.
|
|
*/
|
|
struct gether {
|
|
struct usb_function func;
|
|
|
|
/* updated by gether_{connect,disconnect} */
|
|
struct eth_dev *ioport;
|
|
|
|
/* endpoints handle full and/or high speeds */
|
|
struct usb_ep *in_ep;
|
|
struct usb_ep *out_ep;
|
|
|
|
/* descriptors match device speed at gether_connect() time */
|
|
struct usb_endpoint_descriptor *in;
|
|
struct usb_endpoint_descriptor *out;
|
|
|
|
bool is_zlp_ok;
|
|
|
|
u16 cdc_filter;
|
|
|
|
/* hooks for added framing, as needed for RNDIS and EEM. */
|
|
u32 header_len;
|
|
struct sk_buff *(*wrap)(struct gether *port,
|
|
struct sk_buff *skb);
|
|
int (*unwrap)(struct gether *port,
|
|
struct sk_buff *skb,
|
|
struct sk_buff_head *list);
|
|
|
|
/* called on network open/close */
|
|
void (*open)(struct gether *);
|
|
void (*close)(struct gether *);
|
|
};
|
|
|
|
#define DEFAULT_FILTER (USB_CDC_PACKET_TYPE_BROADCAST \
|
|
|USB_CDC_PACKET_TYPE_ALL_MULTICAST \
|
|
|USB_CDC_PACKET_TYPE_PROMISCUOUS \
|
|
|USB_CDC_PACKET_TYPE_DIRECTED)
|
|
|
|
|
|
/* netdev setup/teardown as directed by the gadget driver */
|
|
int gether_setup(struct usb_gadget *g, u8 ethaddr[ETH_ALEN]);
|
|
void gether_cleanup(void);
|
|
|
|
/* connect/disconnect is handled by individual functions */
|
|
struct net_device *gether_connect(struct gether *);
|
|
void gether_disconnect(struct gether *);
|
|
|
|
/* Some controllers can't support CDC Ethernet (ECM) ... */
|
|
static inline bool can_support_ecm(struct usb_gadget *gadget)
|
|
{
|
|
if (!gadget_supports_altsettings(gadget))
|
|
return false;
|
|
|
|
/* Everything else is *presumably* fine ... but this is a bit
|
|
* chancy, so be **CERTAIN** there are no hardware issues with
|
|
* your controller. Add it above if it can't handle CDC.
|
|
*/
|
|
return true;
|
|
}
|
|
|
|
/* each configuration may bind one instance of an ethernet link */
|
|
int geth_bind_config(struct usb_configuration *c, u8 ethaddr[ETH_ALEN]);
|
|
int ecm_bind_config(struct usb_configuration *c, u8 ethaddr[ETH_ALEN]);
|
|
int eem_bind_config(struct usb_configuration *c);
|
|
|
|
#ifdef USB_ETH_RNDIS
|
|
|
|
int rndis_bind_config(struct usb_configuration *c, u8 ethaddr[ETH_ALEN]);
|
|
|
|
#else
|
|
|
|
static inline int
|
|
rndis_bind_config(struct usb_configuration *c, u8 ethaddr[ETH_ALEN])
|
|
{
|
|
return 0;
|
|
}
|
|
|
|
#endif
|
|
|
|
#endif /* __U_ETHER_H */
|