1 /* 2 * Copyright (c) 2013 Lubomir Rintel 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 * No physical hardware was harmed running Windows during the 33 * reverse-engineering activity 34 */ 35 36 #include <linux/module.h> 37 #include <linux/slab.h> 38 #include <linux/usb.h> 39 40 #include <media/v4l2-device.h> 41 #include <media/v4l2-ctrls.h> 42 #include <media/videobuf2-v4l2.h> 43 #include <media/videobuf2-vmalloc.h> 44 45 /* Hardware. */ 46 #define USBTV_VIDEO_ENDP 0x81 47 #define USBTV_AUDIO_ENDP 0x83 48 #define USBTV_BASE 0xc000 49 #define USBTV_CONTROL_REG 11 50 #define USBTV_REQUEST_REG 12 51 52 /* Number of concurrent isochronous urbs submitted. 53 * Higher numbers was seen to overly saturate the USB bus. */ 54 #define USBTV_ISOC_TRANSFERS 16 55 #define USBTV_ISOC_PACKETS 8 56 57 #define USBTV_CHUNK_SIZE 256 58 #define USBTV_CHUNK 240 59 60 #define USBTV_AUDIO_URBSIZE 20480 61 #define USBTV_AUDIO_HDRSIZE 4 62 #define USBTV_AUDIO_BUFFER 65536 63 64 /* Chunk header. */ 65 #define USBTV_MAGIC_OK(chunk) ((be32_to_cpu(chunk[0]) & 0xff000000) \ 66 == 0x88000000) 67 #define USBTV_FRAME_ID(chunk) ((be32_to_cpu(chunk[0]) & 0x00ff0000) >> 16) 68 #define USBTV_ODD(chunk) ((be32_to_cpu(chunk[0]) & 0x0000f000) >> 15) 69 #define USBTV_CHUNK_NO(chunk) (be32_to_cpu(chunk[0]) & 0x00000fff) 70 71 #define USBTV_TV_STD (V4L2_STD_525_60 | V4L2_STD_PAL | \ 72 V4L2_STD_PAL_Nc | V4L2_STD_SECAM) 73 74 /* parameters for supported TV norms */ 75 struct usbtv_norm_params { 76 v4l2_std_id norm; 77 int cap_width, cap_height; 78 }; 79 80 /* A single videobuf2 frame buffer. */ 81 struct usbtv_buf { 82 struct vb2_v4l2_buffer vb; 83 struct list_head list; 84 }; 85 86 /* Per-device structure. */ 87 struct usbtv { 88 struct device *dev; 89 struct usb_device *udev; 90 91 /* video */ 92 struct v4l2_device v4l2_dev; 93 struct v4l2_ctrl_handler ctrl; 94 struct video_device vdev; 95 struct vb2_queue vb2q; 96 struct mutex v4l2_lock; 97 struct mutex vb2q_lock; 98 99 /* List of videobuf2 buffers protected by a lock. */ 100 spinlock_t buflock; 101 struct list_head bufs; 102 103 /* Number of currently processed frame, useful find 104 * out when a new one begins. */ 105 u32 frame_id; 106 int chunks_done; 107 108 enum { 109 USBTV_COMPOSITE_INPUT, 110 USBTV_SVIDEO_INPUT, 111 } input; 112 v4l2_std_id norm; 113 int width, height; 114 int n_chunks; 115 int iso_size; 116 int last_odd; 117 unsigned int sequence; 118 struct urb *isoc_urbs[USBTV_ISOC_TRANSFERS]; 119 120 /* audio */ 121 struct snd_card *snd; 122 struct snd_pcm_substream *snd_substream; 123 atomic_t snd_stream; 124 struct work_struct snd_trigger; 125 struct urb *snd_bulk_urb; 126 size_t snd_buffer_pos; 127 size_t snd_period_pos; 128 }; 129 130 int usbtv_set_regs(struct usbtv *usbtv, const u16 regs[][2], int size); 131 132 int usbtv_video_init(struct usbtv *usbtv); 133 void usbtv_video_free(struct usbtv *usbtv); 134 135 int usbtv_audio_init(struct usbtv *usbtv); 136 void usbtv_audio_free(struct usbtv *usbtv); 137 void usbtv_audio_suspend(struct usbtv *usbtv); 138 void usbtv_audio_resume(struct usbtv *usbtv); 139