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 */
75struct usbtv_norm_params {
76 v4l2_std_id norm;
77 int cap_width, cap_height;
78};
79
80/* A single videobuf2 frame buffer. */
81struct usbtv_buf {
82 struct vb2_v4l2_buffer vb;
83 struct list_head list;
84};
85
86/* Per-device structure. */
87struct 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
130int usbtv_set_regs(struct usbtv *usbtv, const u16 regs[][2], int size);
131
132int usbtv_video_init(struct usbtv *usbtv);
133void usbtv_video_free(struct usbtv *usbtv);
134
135int usbtv_audio_init(struct usbtv *usbtv);
136void usbtv_audio_free(struct usbtv *usbtv);
137void usbtv_audio_suspend(struct usbtv *usbtv);
138void usbtv_audio_resume(struct usbtv *usbtv);
139

source code of linux/drivers/media/usb/usbtv/usbtv.h