1 /* 2 * Copyright (c) 2013 Federico Simoncelli 3 * All rights reserved. 4 * 5 * Redistribution and use in source and binary forms, with or without 6 * modification, are permitted provided that the following conditions 7 * are met: 8 * 1. Redistributions of source code must retain the above copyright 9 * notice, this list of conditions, and the following disclaimer, 10 * without modification. 11 * 2. The name of the author may not be used to endorse or promote products 12 * derived from this software without specific prior written permission. 13 * 14 * Alternatively, this software may be distributed under the terms of the 15 * GNU General Public License ("GPL"). 16 * 17 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 18 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 19 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 20 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 21 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 22 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 23 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 24 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 25 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 26 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 27 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 28 */ 29 /* 30 * Fushicai USBTV007 Audio-Video Grabber Driver 31 * 32 * Product web site: 33 * http://www.fushicai.com/products_detail/&productId=d05449ee-b690-42f9-a661-aa7353894bed.html 34 * 35 * No physical hardware was harmed running Windows during the 36 * reverse-engineering activity 37 */ 38 39 #include <sound/core.h> 40 #include <sound/initval.h> 41 #include <sound/ac97_codec.h> 42 #include <sound/pcm_params.h> 43 44 #include "usbtv.h" 45 46 static const struct snd_pcm_hardware snd_usbtv_digital_hw = { 47 .info = SNDRV_PCM_INFO_BATCH | 48 SNDRV_PCM_INFO_MMAP | 49 SNDRV_PCM_INFO_INTERLEAVED | 50 SNDRV_PCM_INFO_BLOCK_TRANSFER | 51 SNDRV_PCM_INFO_MMAP_VALID, 52 .formats = SNDRV_PCM_FMTBIT_S16_LE, 53 .rates = SNDRV_PCM_RATE_48000, 54 .rate_min = 48000, 55 .rate_max = 48000, 56 .channels_min = 2, 57 .channels_max = 2, 58 .period_bytes_min = 11059, 59 .period_bytes_max = 13516, 60 .periods_min = 2, 61 .periods_max = 98, 62 .buffer_bytes_max = 62720 * 8, /* value in usbaudio.c */ 63 }; 64 65 static int snd_usbtv_pcm_open(struct snd_pcm_substream *substream) 66 { 67 struct usbtv *chip = snd_pcm_substream_chip(substream); 68 struct snd_pcm_runtime *runtime = substream->runtime; 69 70 chip->snd_substream = substream; 71 runtime->hw = snd_usbtv_digital_hw; 72 73 return 0; 74 } 75 76 static int snd_usbtv_pcm_close(struct snd_pcm_substream *substream) 77 { 78 struct usbtv *chip = snd_pcm_substream_chip(substream); 79 80 if (atomic_read(&chip->snd_stream)) { 81 atomic_set(&chip->snd_stream, 0); 82 schedule_work(&chip->snd_trigger); 83 } 84 85 return 0; 86 } 87 88 static int snd_usbtv_hw_params(struct snd_pcm_substream *substream, 89 struct snd_pcm_hw_params *hw_params) 90 { 91 int rv; 92 struct usbtv *chip = snd_pcm_substream_chip(substream); 93 94 rv = snd_pcm_lib_malloc_pages(substream, 95 params_buffer_bytes(hw_params)); 96 97 if (rv < 0) { 98 dev_warn(chip->dev, "pcm audio buffer allocation failure %i\n", 99 rv); 100 return rv; 101 } 102 103 return 0; 104 } 105 106 static int snd_usbtv_hw_free(struct snd_pcm_substream *substream) 107 { 108 snd_pcm_lib_free_pages(substream); 109 return 0; 110 } 111 112 static int snd_usbtv_prepare(struct snd_pcm_substream *substream) 113 { 114 struct usbtv *chip = snd_pcm_substream_chip(substream); 115 116 chip->snd_buffer_pos = 0; 117 chip->snd_period_pos = 0; 118 119 return 0; 120 } 121 122 static void usbtv_audio_urb_received(struct urb *urb) 123 { 124 struct usbtv *chip = urb->context; 125 struct snd_pcm_substream *substream = chip->snd_substream; 126 struct snd_pcm_runtime *runtime = substream->runtime; 127 size_t i, frame_bytes, chunk_length, buffer_pos, period_pos; 128 int period_elapsed; 129 void *urb_current; 130 131 switch (urb->status) { 132 case 0: 133 case -ETIMEDOUT: 134 break; 135 case -ENOENT: 136 case -EPROTO: 137 case -ECONNRESET: 138 case -ESHUTDOWN: 139 return; 140 default: 141 dev_warn(chip->dev, "unknown audio urb status %i\n", 142 urb->status); 143 } 144 145 if (!atomic_read(&chip->snd_stream)) 146 return; 147 148 frame_bytes = runtime->frame_bits >> 3; 149 chunk_length = USBTV_CHUNK / frame_bytes; 150 151 buffer_pos = chip->snd_buffer_pos; 152 period_pos = chip->snd_period_pos; 153 period_elapsed = 0; 154 155 for (i = 0; i < urb->actual_length; i += USBTV_CHUNK_SIZE) { 156 urb_current = urb->transfer_buffer + i + USBTV_AUDIO_HDRSIZE; 157 158 if (buffer_pos + chunk_length >= runtime->buffer_size) { 159 size_t cnt = (runtime->buffer_size - buffer_pos) * 160 frame_bytes; 161 memcpy(runtime->dma_area + buffer_pos * frame_bytes, 162 urb_current, cnt); 163 memcpy(runtime->dma_area, urb_current + cnt, 164 chunk_length * frame_bytes - cnt); 165 } else { 166 memcpy(runtime->dma_area + buffer_pos * frame_bytes, 167 urb_current, chunk_length * frame_bytes); 168 } 169 170 buffer_pos += chunk_length; 171 period_pos += chunk_length; 172 173 if (buffer_pos >= runtime->buffer_size) 174 buffer_pos -= runtime->buffer_size; 175 176 if (period_pos >= runtime->period_size) { 177 period_pos -= runtime->period_size; 178 period_elapsed = 1; 179 } 180 } 181 182 snd_pcm_stream_lock(substream); 183 184 chip->snd_buffer_pos = buffer_pos; 185 chip->snd_period_pos = period_pos; 186 187 snd_pcm_stream_unlock(substream); 188 189 if (period_elapsed) 190 snd_pcm_period_elapsed(substream); 191 192 usb_submit_urb(urb, GFP_ATOMIC); 193 } 194 195 static int usbtv_audio_start(struct usbtv *chip) 196 { 197 unsigned int pipe; 198 static const u16 setup[][2] = { 199 /* These seem to enable the device. */ 200 { USBTV_BASE + 0x0008, 0x0001 }, 201 { USBTV_BASE + 0x01d0, 0x00ff }, 202 { USBTV_BASE + 0x01d9, 0x0002 }, 203 204 { USBTV_BASE + 0x01da, 0x0013 }, 205 { USBTV_BASE + 0x01db, 0x0012 }, 206 { USBTV_BASE + 0x01e9, 0x0002 }, 207 { USBTV_BASE + 0x01ec, 0x006c }, 208 { USBTV_BASE + 0x0294, 0x0020 }, 209 { USBTV_BASE + 0x0255, 0x00cf }, 210 { USBTV_BASE + 0x0256, 0x0020 }, 211 { USBTV_BASE + 0x01eb, 0x0030 }, 212 { USBTV_BASE + 0x027d, 0x00a6 }, 213 { USBTV_BASE + 0x0280, 0x0011 }, 214 { USBTV_BASE + 0x0281, 0x0040 }, 215 { USBTV_BASE + 0x0282, 0x0011 }, 216 { USBTV_BASE + 0x0283, 0x0040 }, 217 { 0xf891, 0x0010 }, 218 219 /* this sets the input from composite */ 220 { USBTV_BASE + 0x0284, 0x00aa }, 221 }; 222 223 chip->snd_bulk_urb = usb_alloc_urb(0, GFP_KERNEL); 224 if (chip->snd_bulk_urb == NULL) 225 goto err_alloc_urb; 226 227 pipe = usb_rcvbulkpipe(chip->udev, USBTV_AUDIO_ENDP); 228 229 chip->snd_bulk_urb->transfer_buffer = kzalloc( 230 USBTV_AUDIO_URBSIZE, GFP_KERNEL); 231 if (chip->snd_bulk_urb->transfer_buffer == NULL) 232 goto err_transfer_buffer; 233 234 usb_fill_bulk_urb(chip->snd_bulk_urb, chip->udev, pipe, 235 chip->snd_bulk_urb->transfer_buffer, USBTV_AUDIO_URBSIZE, 236 usbtv_audio_urb_received, chip); 237 238 /* starting the stream */ 239 usbtv_set_regs(chip, setup, ARRAY_SIZE(setup)); 240 241 usb_clear_halt(chip->udev, pipe); 242 usb_submit_urb(chip->snd_bulk_urb, GFP_ATOMIC); 243 244 return 0; 245 246 err_transfer_buffer: 247 usb_free_urb(chip->snd_bulk_urb); 248 chip->snd_bulk_urb = NULL; 249 250 err_alloc_urb: 251 return -ENOMEM; 252 } 253 254 static int usbtv_audio_stop(struct usbtv *chip) 255 { 256 static const u16 setup[][2] = { 257 /* The original windows driver sometimes sends also: 258 * { USBTV_BASE + 0x00a2, 0x0013 } 259 * but it seems useless and its real effects are untested at 260 * the moment. 261 */ 262 { USBTV_BASE + 0x027d, 0x0000 }, 263 { USBTV_BASE + 0x0280, 0x0010 }, 264 { USBTV_BASE + 0x0282, 0x0010 }, 265 }; 266 267 if (chip->snd_bulk_urb) { 268 usb_kill_urb(chip->snd_bulk_urb); 269 kfree(chip->snd_bulk_urb->transfer_buffer); 270 usb_free_urb(chip->snd_bulk_urb); 271 chip->snd_bulk_urb = NULL; 272 } 273 274 usbtv_set_regs(chip, setup, ARRAY_SIZE(setup)); 275 276 return 0; 277 } 278 279 void usbtv_audio_suspend(struct usbtv *usbtv) 280 { 281 if (atomic_read(&usbtv->snd_stream) && usbtv->snd_bulk_urb) 282 usb_kill_urb(usbtv->snd_bulk_urb); 283 } 284 285 void usbtv_audio_resume(struct usbtv *usbtv) 286 { 287 if (atomic_read(&usbtv->snd_stream) && usbtv->snd_bulk_urb) 288 usb_submit_urb(usbtv->snd_bulk_urb, GFP_ATOMIC); 289 } 290 291 static void snd_usbtv_trigger(struct work_struct *work) 292 { 293 struct usbtv *chip = container_of(work, struct usbtv, snd_trigger); 294 295 if (!chip->snd) 296 return; 297 298 if (atomic_read(&chip->snd_stream)) 299 usbtv_audio_start(chip); 300 else 301 usbtv_audio_stop(chip); 302 } 303 304 static int snd_usbtv_card_trigger(struct snd_pcm_substream *substream, int cmd) 305 { 306 struct usbtv *chip = snd_pcm_substream_chip(substream); 307 308 switch (cmd) { 309 case SNDRV_PCM_TRIGGER_START: 310 case SNDRV_PCM_TRIGGER_RESUME: 311 case SNDRV_PCM_TRIGGER_PAUSE_RELEASE: 312 atomic_set(&chip->snd_stream, 1); 313 break; 314 case SNDRV_PCM_TRIGGER_STOP: 315 case SNDRV_PCM_TRIGGER_SUSPEND: 316 case SNDRV_PCM_TRIGGER_PAUSE_PUSH: 317 atomic_set(&chip->snd_stream, 0); 318 break; 319 default: 320 return -EINVAL; 321 } 322 323 schedule_work(&chip->snd_trigger); 324 325 return 0; 326 } 327 328 static snd_pcm_uframes_t snd_usbtv_pointer(struct snd_pcm_substream *substream) 329 { 330 struct usbtv *chip = snd_pcm_substream_chip(substream); 331 332 return chip->snd_buffer_pos; 333 } 334 335 static const struct snd_pcm_ops snd_usbtv_pcm_ops = { 336 .open = snd_usbtv_pcm_open, 337 .close = snd_usbtv_pcm_close, 338 .ioctl = snd_pcm_lib_ioctl, 339 .hw_params = snd_usbtv_hw_params, 340 .hw_free = snd_usbtv_hw_free, 341 .prepare = snd_usbtv_prepare, 342 .trigger = snd_usbtv_card_trigger, 343 .pointer = snd_usbtv_pointer, 344 }; 345 346 int usbtv_audio_init(struct usbtv *usbtv) 347 { 348 int rv; 349 struct snd_card *card; 350 struct snd_pcm *pcm; 351 352 INIT_WORK(&usbtv->snd_trigger, snd_usbtv_trigger); 353 atomic_set(&usbtv->snd_stream, 0); 354 355 rv = snd_card_new(&usbtv->udev->dev, SNDRV_DEFAULT_IDX1, "usbtv", 356 THIS_MODULE, 0, &card); 357 if (rv < 0) 358 return rv; 359 360 strlcpy(card->driver, usbtv->dev->driver->name, sizeof(card->driver)); 361 strlcpy(card->shortname, "usbtv", sizeof(card->shortname)); 362 snprintf(card->longname, sizeof(card->longname), 363 "USBTV Audio at bus %d device %d", usbtv->udev->bus->busnum, 364 usbtv->udev->devnum); 365 366 snd_card_set_dev(card, usbtv->dev); 367 368 usbtv->snd = card; 369 370 rv = snd_pcm_new(card, "USBTV Audio", 0, 0, 1, &pcm); 371 if (rv < 0) 372 goto err; 373 374 strlcpy(pcm->name, "USBTV Audio Input", sizeof(pcm->name)); 375 pcm->info_flags = 0; 376 pcm->private_data = usbtv; 377 378 snd_pcm_set_ops(pcm, SNDRV_PCM_STREAM_CAPTURE, &snd_usbtv_pcm_ops); 379 snd_pcm_lib_preallocate_pages_for_all(pcm, SNDRV_DMA_TYPE_CONTINUOUS, 380 snd_dma_continuous_data(GFP_KERNEL), USBTV_AUDIO_BUFFER, 381 USBTV_AUDIO_BUFFER); 382 383 rv = snd_card_register(card); 384 if (rv) 385 goto err; 386 387 return 0; 388 389 err: 390 usbtv->snd = NULL; 391 snd_card_free(card); 392 393 return rv; 394 } 395 396 void usbtv_audio_free(struct usbtv *usbtv) 397 { 398 cancel_work_sync(&usbtv->snd_trigger); 399 400 if (usbtv->snd && usbtv->udev) { 401 snd_card_free(usbtv->snd); 402 usbtv->snd = NULL; 403 } 404 } 405