Loading...
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 | // SPDX-License-Identifier: GPL-2.0+ /****************************************************************************** * usbatm.h - Generic USB xDSL driver core * * Copyright (C) 2001, Alcatel * Copyright (C) 2003, Duncan Sands, SolNegro, Josep Comas * Copyright (C) 2004, David Woodhouse ******************************************************************************/ #ifndef _USBATM_H_ #define _USBATM_H_ #include <linux/atm.h> #include <linux/atmdev.h> #include <linux/completion.h> #include <linux/device.h> #include <linux/kernel.h> #include <linux/kref.h> #include <linux/list.h> #include <linux/stringify.h> #include <linux/usb.h> #include <linux/mutex.h> #include <linux/ratelimit.h> /* #define VERBOSE_DEBUG */ #define usb_err(instance, format, arg...) \ dev_err(&(instance)->usb_intf->dev , format , ## arg) #define usb_info(instance, format, arg...) \ dev_info(&(instance)->usb_intf->dev , format , ## arg) #define usb_warn(instance, format, arg...) \ dev_warn(&(instance)->usb_intf->dev , format , ## arg) #define usb_dbg(instance, format, arg...) \ dev_dbg(&(instance)->usb_intf->dev , format , ## arg) /* FIXME: move to dev_* once ATM is driver model aware */ #define atm_printk(level, instance, format, arg...) \ printk(level "ATM dev %d: " format , \ (instance)->atm_dev->number , ## arg) #define atm_err(instance, format, arg...) \ atm_printk(KERN_ERR, instance , format , ## arg) #define atm_info(instance, format, arg...) \ atm_printk(KERN_INFO, instance , format , ## arg) #define atm_warn(instance, format, arg...) \ atm_printk(KERN_WARNING, instance , format , ## arg) #define atm_dbg(instance, format, ...) \ pr_debug("ATM dev %d: " format, \ (instance)->atm_dev->number, ##__VA_ARGS__) #define atm_rldbg(instance, format, ...) \ pr_debug_ratelimited("ATM dev %d: " format, \ (instance)->atm_dev->number, ##__VA_ARGS__) /* flags, set by mini-driver in bind() */ #define UDSL_SKIP_HEAVY_INIT (1<<0) #define UDSL_USE_ISOC (1<<1) #define UDSL_IGNORE_EILSEQ (1<<2) /* mini driver */ struct usbatm_data; /* * Assuming all methods exist and succeed, they are called in this order: * * bind, heavy_init, atm_start, ..., atm_stop, unbind */ struct usbatm_driver { const char *driver_name; /* init device ... can sleep, or cause probe() failure */ int (*bind) (struct usbatm_data *, struct usb_interface *, const struct usb_device_id *id); /* additional device initialization that is too slow to be done in probe() */ int (*heavy_init) (struct usbatm_data *, struct usb_interface *); /* cleanup device ... can sleep, but can't fail */ void (*unbind) (struct usbatm_data *, struct usb_interface *); /* init ATM device ... can sleep, or cause ATM initialization failure */ int (*atm_start) (struct usbatm_data *, struct atm_dev *); /* cleanup ATM device ... can sleep, but can't fail */ void (*atm_stop) (struct usbatm_data *, struct atm_dev *); int bulk_in; /* bulk rx endpoint */ int isoc_in; /* isochronous rx endpoint */ int bulk_out; /* bulk tx endpoint */ unsigned rx_padding; unsigned tx_padding; }; extern int usbatm_usb_probe(struct usb_interface *intf, const struct usb_device_id *id, struct usbatm_driver *driver); extern void usbatm_usb_disconnect(struct usb_interface *intf); struct usbatm_channel { int endpoint; /* usb pipe */ unsigned int stride; /* ATM cell size + padding */ unsigned int buf_size; /* urb buffer size */ unsigned int packet_size; /* endpoint maxpacket */ spinlock_t lock; struct list_head list; struct tasklet_struct tasklet; struct timer_list delay; struct usbatm_data *usbatm; }; /* main driver data */ struct usbatm_data { /****************** * public fields * ******************/ /* mini driver */ struct usbatm_driver *driver; void *driver_data; char driver_name[16]; unsigned int flags; /* set by mini-driver in bind() */ /* USB device */ struct usb_device *usb_dev; struct usb_interface *usb_intf; char description[64]; /* ATM device */ struct atm_dev *atm_dev; /******************************** * private fields - do not use * ********************************/ struct kref refcount; struct mutex serialize; int disconnected; /* heavy init */ struct task_struct *thread; struct completion thread_started; struct completion thread_exited; /* ATM device */ struct list_head vcc_list; struct usbatm_channel rx_channel; struct usbatm_channel tx_channel; struct sk_buff_head sndqueue; struct sk_buff *current_skb; /* being emptied */ struct usbatm_vcc_data *cached_vcc; int cached_vci; short cached_vpi; unsigned char *cell_buf; /* holds partial rx cell */ unsigned int buf_usage; struct urb *urbs[0]; }; static inline void *to_usbatm_driver_data(struct usb_interface *intf) { struct usbatm_data *usbatm_instance; if (intf == NULL) return NULL; usbatm_instance = usb_get_intfdata(intf); if (usbatm_instance == NULL) /* set NULL before unbind() */ return NULL; return usbatm_instance->driver_data; /* set NULL after unbind() */ } #endif /* _USBATM_H_ */ |