1 /* usb-urb.c is part of the DVB USB library. 2 * 3 * Copyright (C) 2004-6 Patrick Boettcher (patrick.boettcher@posteo.de) 4 * see dvb-usb-init.c for copyright information. 5 * 6 * This file keeps functions for initializing and handling the 7 * BULK and ISOC USB data transfers in a generic way. 8 * Can be used for DVB-only and also, that's the plan, for 9 * Hybrid USB devices (analog and DVB). 10 */ 11 #include "dvb_usb_common.h" 12 13 /* URB stuff for streaming */ 14 15 int usb_urb_reconfig(struct usb_data_stream *stream, 16 struct usb_data_stream_properties *props); 17 18 static void usb_urb_complete(struct urb *urb) 19 { 20 struct usb_data_stream *stream = urb->context; 21 int ptype = usb_pipetype(urb->pipe); 22 int i; 23 u8 *b; 24 25 dev_dbg_ratelimited(&stream->udev->dev, 26 "%s: %s urb completed status=%d length=%d/%d pack_num=%d errors=%d\n", 27 __func__, ptype == PIPE_ISOCHRONOUS ? "isoc" : "bulk", 28 urb->status, urb->actual_length, 29 urb->transfer_buffer_length, 30 urb->number_of_packets, urb->error_count); 31 32 switch (urb->status) { 33 case 0: /* success */ 34 case -ETIMEDOUT: /* NAK */ 35 break; 36 case -ECONNRESET: /* kill */ 37 case -ENOENT: 38 case -ESHUTDOWN: 39 return; 40 default: /* error */ 41 dev_dbg_ratelimited(&stream->udev->dev, 42 "%s: urb completition failed=%d\n", 43 __func__, urb->status); 44 break; 45 } 46 47 b = (u8 *) urb->transfer_buffer; 48 switch (ptype) { 49 case PIPE_ISOCHRONOUS: 50 for (i = 0; i < urb->number_of_packets; i++) { 51 if (urb->iso_frame_desc[i].status != 0) 52 dev_dbg(&stream->udev->dev, 53 "%s: iso frame descriptor has an error=%d\n", 54 __func__, 55 urb->iso_frame_desc[i].status); 56 else if (urb->iso_frame_desc[i].actual_length > 0) 57 stream->complete(stream, 58 b + urb->iso_frame_desc[i].offset, 59 urb->iso_frame_desc[i].actual_length); 60 61 urb->iso_frame_desc[i].status = 0; 62 urb->iso_frame_desc[i].actual_length = 0; 63 } 64 break; 65 case PIPE_BULK: 66 if (urb->actual_length > 0) 67 stream->complete(stream, b, urb->actual_length); 68 break; 69 default: 70 dev_err(&stream->udev->dev, 71 "%s: unknown endpoint type in completition handler\n", 72 KBUILD_MODNAME); 73 return; 74 } 75 usb_submit_urb(urb, GFP_ATOMIC); 76 } 77 78 int usb_urb_killv2(struct usb_data_stream *stream) 79 { 80 int i; 81 for (i = 0; i < stream->urbs_submitted; i++) { 82 dev_dbg(&stream->udev->dev, "%s: kill urb=%d\n", __func__, i); 83 /* stop the URB */ 84 usb_kill_urb(stream->urb_list[i]); 85 } 86 stream->urbs_submitted = 0; 87 return 0; 88 } 89 90 int usb_urb_submitv2(struct usb_data_stream *stream, 91 struct usb_data_stream_properties *props) 92 { 93 int i, ret; 94 95 if (props) { 96 ret = usb_urb_reconfig(stream, props); 97 if (ret < 0) 98 return ret; 99 } 100 101 for (i = 0; i < stream->urbs_initialized; i++) { 102 dev_dbg(&stream->udev->dev, "%s: submit urb=%d\n", __func__, i); 103 ret = usb_submit_urb(stream->urb_list[i], GFP_ATOMIC); 104 if (ret) { 105 dev_err(&stream->udev->dev, 106 "%s: could not submit urb no. %d - get them all back\n", 107 KBUILD_MODNAME, i); 108 usb_urb_killv2(stream); 109 return ret; 110 } 111 stream->urbs_submitted++; 112 } 113 return 0; 114 } 115 116 static int usb_urb_free_urbs(struct usb_data_stream *stream) 117 { 118 int i; 119 120 usb_urb_killv2(stream); 121 122 for (i = stream->urbs_initialized - 1; i >= 0; i--) { 123 if (stream->urb_list[i]) { 124 dev_dbg(&stream->udev->dev, "%s: free urb=%d\n", 125 __func__, i); 126 /* free the URBs */ 127 usb_free_urb(stream->urb_list[i]); 128 } 129 } 130 stream->urbs_initialized = 0; 131 132 return 0; 133 } 134 135 static int usb_urb_alloc_bulk_urbs(struct usb_data_stream *stream) 136 { 137 int i, j; 138 139 /* allocate the URBs */ 140 for (i = 0; i < stream->props.count; i++) { 141 dev_dbg(&stream->udev->dev, "%s: alloc urb=%d\n", __func__, i); 142 stream->urb_list[i] = usb_alloc_urb(0, GFP_ATOMIC); 143 if (!stream->urb_list[i]) { 144 dev_dbg(&stream->udev->dev, "%s: failed\n", __func__); 145 for (j = 0; j < i; j++) 146 usb_free_urb(stream->urb_list[j]); 147 return -ENOMEM; 148 } 149 usb_fill_bulk_urb(stream->urb_list[i], 150 stream->udev, 151 usb_rcvbulkpipe(stream->udev, 152 stream->props.endpoint), 153 stream->buf_list[i], 154 stream->props.u.bulk.buffersize, 155 usb_urb_complete, stream); 156 157 stream->urb_list[i]->transfer_flags = URB_NO_TRANSFER_DMA_MAP; 158 stream->urb_list[i]->transfer_dma = stream->dma_addr[i]; 159 stream->urbs_initialized++; 160 } 161 return 0; 162 } 163 164 static int usb_urb_alloc_isoc_urbs(struct usb_data_stream *stream) 165 { 166 int i, j; 167 168 /* allocate the URBs */ 169 for (i = 0; i < stream->props.count; i++) { 170 struct urb *urb; 171 int frame_offset = 0; 172 dev_dbg(&stream->udev->dev, "%s: alloc urb=%d\n", __func__, i); 173 stream->urb_list[i] = usb_alloc_urb( 174 stream->props.u.isoc.framesperurb, GFP_ATOMIC); 175 if (!stream->urb_list[i]) { 176 dev_dbg(&stream->udev->dev, "%s: failed\n", __func__); 177 for (j = 0; j < i; j++) 178 usb_free_urb(stream->urb_list[j]); 179 return -ENOMEM; 180 } 181 182 urb = stream->urb_list[i]; 183 184 urb->dev = stream->udev; 185 urb->context = stream; 186 urb->complete = usb_urb_complete; 187 urb->pipe = usb_rcvisocpipe(stream->udev, 188 stream->props.endpoint); 189 urb->transfer_flags = URB_ISO_ASAP | URB_NO_TRANSFER_DMA_MAP; 190 urb->interval = stream->props.u.isoc.interval; 191 urb->number_of_packets = stream->props.u.isoc.framesperurb; 192 urb->transfer_buffer_length = stream->props.u.isoc.framesize * 193 stream->props.u.isoc.framesperurb; 194 urb->transfer_buffer = stream->buf_list[i]; 195 urb->transfer_dma = stream->dma_addr[i]; 196 197 for (j = 0; j < stream->props.u.isoc.framesperurb; j++) { 198 urb->iso_frame_desc[j].offset = frame_offset; 199 urb->iso_frame_desc[j].length = 200 stream->props.u.isoc.framesize; 201 frame_offset += stream->props.u.isoc.framesize; 202 } 203 204 stream->urbs_initialized++; 205 } 206 return 0; 207 } 208 209 static int usb_free_stream_buffers(struct usb_data_stream *stream) 210 { 211 if (stream->state & USB_STATE_URB_BUF) { 212 while (stream->buf_num) { 213 stream->buf_num--; 214 dev_dbg(&stream->udev->dev, "%s: free buf=%d\n", 215 __func__, stream->buf_num); 216 usb_free_coherent(stream->udev, stream->buf_size, 217 stream->buf_list[stream->buf_num], 218 stream->dma_addr[stream->buf_num]); 219 } 220 } 221 222 stream->state &= ~USB_STATE_URB_BUF; 223 224 return 0; 225 } 226 227 static int usb_alloc_stream_buffers(struct usb_data_stream *stream, int num, 228 unsigned long size) 229 { 230 stream->buf_num = 0; 231 stream->buf_size = size; 232 233 dev_dbg(&stream->udev->dev, 234 "%s: all in all I will use %lu bytes for streaming\n", 235 __func__, num * size); 236 237 for (stream->buf_num = 0; stream->buf_num < num; stream->buf_num++) { 238 stream->buf_list[stream->buf_num] = usb_alloc_coherent( 239 stream->udev, size, GFP_ATOMIC, 240 &stream->dma_addr[stream->buf_num]); 241 if (!stream->buf_list[stream->buf_num]) { 242 dev_dbg(&stream->udev->dev, "%s: alloc buf=%d failed\n", 243 __func__, stream->buf_num); 244 usb_free_stream_buffers(stream); 245 return -ENOMEM; 246 } 247 248 dev_dbg(&stream->udev->dev, "%s: alloc buf=%d %p (dma %llu)\n", 249 __func__, stream->buf_num, 250 stream->buf_list[stream->buf_num], 251 (long long)stream->dma_addr[stream->buf_num]); 252 memset(stream->buf_list[stream->buf_num], 0, size); 253 stream->state |= USB_STATE_URB_BUF; 254 } 255 256 return 0; 257 } 258 259 int usb_urb_reconfig(struct usb_data_stream *stream, 260 struct usb_data_stream_properties *props) 261 { 262 int buf_size; 263 264 if (!props) 265 return 0; 266 267 /* check allocated buffers are large enough for the request */ 268 if (props->type == USB_BULK) { 269 buf_size = stream->props.u.bulk.buffersize; 270 } else if (props->type == USB_ISOC) { 271 buf_size = props->u.isoc.framesize * props->u.isoc.framesperurb; 272 } else { 273 dev_err(&stream->udev->dev, "%s: invalid endpoint type=%d\n", 274 KBUILD_MODNAME, props->type); 275 return -EINVAL; 276 } 277 278 if (stream->buf_num < props->count || stream->buf_size < buf_size) { 279 dev_err(&stream->udev->dev, 280 "%s: cannot reconfigure as allocated buffers are too small\n", 281 KBUILD_MODNAME); 282 return -EINVAL; 283 } 284 285 /* check if all fields are same */ 286 if (stream->props.type == props->type && 287 stream->props.count == props->count && 288 stream->props.endpoint == props->endpoint) { 289 if (props->type == USB_BULK && 290 props->u.bulk.buffersize == 291 stream->props.u.bulk.buffersize) 292 return 0; 293 else if (props->type == USB_ISOC && 294 props->u.isoc.framesperurb == 295 stream->props.u.isoc.framesperurb && 296 props->u.isoc.framesize == 297 stream->props.u.isoc.framesize && 298 props->u.isoc.interval == 299 stream->props.u.isoc.interval) 300 return 0; 301 } 302 303 dev_dbg(&stream->udev->dev, "%s: re-alloc urbs\n", __func__); 304 305 usb_urb_free_urbs(stream); 306 memcpy(&stream->props, props, sizeof(*props)); 307 if (props->type == USB_BULK) 308 return usb_urb_alloc_bulk_urbs(stream); 309 else if (props->type == USB_ISOC) 310 return usb_urb_alloc_isoc_urbs(stream); 311 312 return 0; 313 } 314 315 int usb_urb_initv2(struct usb_data_stream *stream, 316 const struct usb_data_stream_properties *props) 317 { 318 int ret; 319 320 if (!stream || !props) 321 return -EINVAL; 322 323 memcpy(&stream->props, props, sizeof(*props)); 324 325 if (!stream->complete) { 326 dev_err(&stream->udev->dev, 327 "%s: there is no data callback - this doesn't make sense\n", 328 KBUILD_MODNAME); 329 return -EINVAL; 330 } 331 332 switch (stream->props.type) { 333 case USB_BULK: 334 ret = usb_alloc_stream_buffers(stream, stream->props.count, 335 stream->props.u.bulk.buffersize); 336 if (ret < 0) 337 return ret; 338 339 return usb_urb_alloc_bulk_urbs(stream); 340 case USB_ISOC: 341 ret = usb_alloc_stream_buffers(stream, stream->props.count, 342 stream->props.u.isoc.framesize * 343 stream->props.u.isoc.framesperurb); 344 if (ret < 0) 345 return ret; 346 347 return usb_urb_alloc_isoc_urbs(stream); 348 default: 349 dev_err(&stream->udev->dev, 350 "%s: unknown urb-type for data transfer\n", 351 KBUILD_MODNAME); 352 return -EINVAL; 353 } 354 } 355 356 int usb_urb_exitv2(struct usb_data_stream *stream) 357 { 358 usb_urb_free_urbs(stream); 359 usb_free_stream_buffers(stream); 360 361 return 0; 362 } 363