1 /***************************************************************************** 2 * 3 * Filename: irda-usb.h 4 * Version: 0.10 5 * Description: IrDA-USB Driver 6 * Status: Experimental 7 * Author: Dag Brattli <dag@brattli.net> 8 * 9 * Copyright (C) 2001, Roman Weissgaerber <weissg@vienna.at> 10 * Copyright (C) 2000, Dag Brattli <dag@brattli.net> 11 * Copyright (C) 2001, Jean Tourrilhes <jt@hpl.hp.com> 12 * Copyright (C) 2004, SigmaTel, Inc. <irquality@sigmatel.com> 13 * Copyright (C) 2005, Milan Beno <beno@pobox.sk> 14 * Copyright (C) 2006, Nick FEdchik <nick@fedchik.org.ua> 15 * 16 * This program is free software; you can redistribute it and/or modify 17 * it under the terms of the GNU General Public License as published by 18 * the Free Software Foundation; either version 2 of the License, or 19 * (at your option) any later version. 20 * 21 * This program is distributed in the hope that it will be useful, 22 * but WITHOUT ANY WARRANTY; without even the implied warranty of 23 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 24 * GNU General Public License for more details. 25 * 26 * You should have received a copy of the GNU General Public License 27 * along with this program; if not, write to the Free Software 28 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. 29 * 30 *****************************************************************************/ 31 32 #include <linux/time.h> 33 34 #include <net/irda/irda.h> 35 #include <net/irda/irda_device.h> /* struct irlap_cb */ 36 37 #define RX_COPY_THRESHOLD 200 38 #define IRDA_USB_MAX_MTU 2051 39 #define IRDA_USB_SPEED_MTU 64 /* Weird, but work like this */ 40 41 /* Maximum number of active URB on the Rx path 42 * This is the amount of buffers the we keep between the USB harware and the 43 * IrDA stack. 44 * 45 * Note : the network layer does also queue the packets between us and the 46 * IrDA stack, and is actually pretty fast and efficient in doing that. 47 * Therefore, we don't need to have a large number of URBs, and we can 48 * perfectly live happy with only one. We certainly don't need to keep the 49 * full IrTTP window around here... 50 * I repeat for those who have trouble to understand : 1 URB is plenty 51 * good enough to handle back-to-back (brickwalled) frames. I tried it, 52 * it works (it's the hardware that has trouble doing it). 53 * 54 * Having 2 URBs would allow the USB stack to process one URB while we take 55 * care of the other and then swap the URBs... 56 * On the other hand, increasing the number of URB will have penalities 57 * in term of latency and will interact with the link management in IrLAP... 58 * Jean II */ 59 #define IU_MAX_ACTIVE_RX_URBS 1 /* Don't touch !!! */ 60 61 /* When a Rx URB is passed back to us, we can't reuse it immediately, 62 * because it may still be referenced by the USB layer. Therefore we 63 * need to keep one extra URB in the Rx path. 64 * Jean II */ 65 #define IU_MAX_RX_URBS (IU_MAX_ACTIVE_RX_URBS + 1) 66 67 /* Various ugly stuff to try to workaround generic problems */ 68 /* Send speed command in case of timeout, just for trying to get things sane */ 69 #define IU_BUG_KICK_TIMEOUT 70 /* Show the USB class descriptor */ 71 #undef IU_DUMP_CLASS_DESC 72 /* Assume a minimum round trip latency for USB transfer (in us)... 73 * USB transfer are done in the next USB slot if there is no traffic 74 * (1/19 msec) and is done at 12 Mb/s : 75 * Waiting for slot + tx = (53us + 16us) * 2 = 137us minimum. 76 * Rx notification will only be done at the end of the USB frame period : 77 * OHCI : frame period = 1ms 78 * UHCI : frame period = 1ms, but notification can take 2 or 3 ms :-( 79 * EHCI : frame period = 125us */ 80 #define IU_USB_MIN_RTT 500 /* This should be safe in most cases */ 81 82 /* Inbound header */ 83 #define MEDIA_BUSY 0x80 84 85 #define SPEED_2400 0x01 86 #define SPEED_9600 0x02 87 #define SPEED_19200 0x03 88 #define SPEED_38400 0x04 89 #define SPEED_57600 0x05 90 #define SPEED_115200 0x06 91 #define SPEED_576000 0x07 92 #define SPEED_1152000 0x08 93 #define SPEED_4000000 0x09 94 #define SPEED_16000000 0x0a 95 96 /* Basic capabilities */ 97 #define IUC_DEFAULT 0x00 /* Basic device compliant with 1.0 spec */ 98 /* Main bugs */ 99 #define IUC_SPEED_BUG 0x01 /* Device doesn't set speed after the frame */ 100 #define IUC_NO_WINDOW 0x02 /* Device doesn't behave with big Rx window */ 101 #define IUC_NO_TURN 0x04 /* Device doesn't do turnaround by itself */ 102 /* Not currently used */ 103 #define IUC_SIR_ONLY 0x08 /* Device doesn't behave at FIR speeds */ 104 #define IUC_SMALL_PKT 0x10 /* Device doesn't behave with big Rx packets */ 105 #define IUC_MAX_WINDOW 0x20 /* Device underestimate the Rx window */ 106 #define IUC_MAX_XBOFS 0x40 /* Device need more xbofs than advertised */ 107 #define IUC_STIR421X 0x80 /* SigmaTel 4210/4220/4116 VFIR */ 108 109 /* USB class definitions */ 110 #define USB_IRDA_HEADER 0x01 111 #define USB_CLASS_IRDA 0x02 /* USB_CLASS_APP_SPEC subclass */ 112 #define USB_DT_IRDA 0x21 113 #define USB_IRDA_STIR421X_HEADER 0x03 114 #define IU_SIGMATEL_MAX_RX_URBS (IU_MAX_ACTIVE_RX_URBS + \ 115 USB_IRDA_STIR421X_HEADER) 116 117 struct irda_class_desc { 118 __u8 bLength; 119 __u8 bDescriptorType; 120 __le16 bcdSpecRevision; 121 __u8 bmDataSize; 122 __u8 bmWindowSize; 123 __u8 bmMinTurnaroundTime; 124 __le16 wBaudRate; 125 __u8 bmAdditionalBOFs; 126 __u8 bIrdaRateSniff; 127 __u8 bMaxUnicastList; 128 } __packed; 129 130 /* class specific interface request to get the IrDA-USB class descriptor 131 * (6.2.5, USB-IrDA class spec 1.0) */ 132 133 #define IU_REQ_GET_CLASS_DESC 0x06 134 #define STIR421X_MAX_PATCH_DOWNLOAD_SIZE 1023 135 136 struct irda_usb_cb { 137 struct irda_class_desc *irda_desc; 138 struct usb_device *usbdev; /* init: probe_irda */ 139 struct usb_interface *usbintf; /* init: probe_irda */ 140 int netopen; /* Device is active for network */ 141 int present; /* Device is present on the bus */ 142 __u32 capability; /* Capability of the hardware */ 143 __u8 bulk_in_ep; /* Rx Endpoint assignments */ 144 __u8 bulk_out_ep; /* Tx Endpoint assignments */ 145 __u16 bulk_out_mtu; /* Max Tx packet size in bytes */ 146 __u8 bulk_int_ep; /* Interrupt Endpoint assignments */ 147 148 __u8 max_rx_urb; 149 struct urb **rx_urb; /* URBs used to receive data frames */ 150 struct urb *idle_rx_urb; /* Pointer to idle URB in Rx path */ 151 struct urb *tx_urb; /* URB used to send data frames */ 152 struct urb *speed_urb; /* URB used to send speed commands */ 153 154 struct net_device *netdev; /* Yes! we are some kind of netdev. */ 155 struct irlap_cb *irlap; /* The link layer we are binded to */ 156 struct qos_info qos; 157 char *speed_buff; /* Buffer for speed changes */ 158 char *tx_buff; 159 160 struct timeval stamp; 161 struct timeval now; 162 163 spinlock_t lock; /* For serializing Tx operations */ 164 165 __u16 xbofs; /* Current xbofs setting */ 166 __s16 new_xbofs; /* xbofs we need to set */ 167 __u32 speed; /* Current speed */ 168 __s32 new_speed; /* speed we need to set */ 169 170 __u8 header_length; /* USB-IrDA frame header size */ 171 int needspatch; /* device needs firmware patch */ 172 173 struct timer_list rx_defer_timer; /* Wait for Rx error to clear */ 174 }; 175 176