/drivers/media/video/et61x251/et61x251.h
C Header | 234 lines | 175 code | 35 blank | 24 comment | 20 complexity | bc1cdba7f66c65a170c8c9eac9fbb267 MD5 | raw file
Possible License(s): CC-BY-SA-3.0, GPL-2.0, LGPL-2.0, AGPL-1.0
1/***************************************************************************
2 * V4L2 driver for ET61X[12]51 PC Camera Controllers *
3 * *
4 * Copyright (C) 2006 by Luca Risolia <luca.risolia@studio.unibo.it> *
5 * *
6 * This program is free software; you can redistribute it and/or modify *
7 * it under the terms of the GNU General Public License as published by *
8 * the Free Software Foundation; either version 2 of the License, or *
9 * (at your option) any later version. *
10 * *
11 * This program is distributed in the hope that it will be useful, *
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of *
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
14 * GNU General Public License for more details. *
15 * *
16 * You should have received a copy of the GNU General Public License *
17 * along with this program; if not, write to the Free Software *
18 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. *
19 ***************************************************************************/
20
21#ifndef _ET61X251_H_
22#define _ET61X251_H_
23
24#include <linux/version.h>
25#include <linux/usb.h>
26#include <linux/videodev2.h>
27#include <media/v4l2-common.h>
28#include <linux/device.h>
29#include <linux/list.h>
30#include <linux/spinlock.h>
31#include <linux/time.h>
32#include <linux/wait.h>
33#include <linux/types.h>
34#include <linux/param.h>
35#include <linux/rwsem.h>
36#include <linux/mutex.h>
37#include <linux/stddef.h>
38#include <linux/string.h>
39#include <linux/kref.h>
40
41#include "et61x251_sensor.h"
42
43/*****************************************************************************/
44
45#define ET61X251_DEBUG
46#define ET61X251_DEBUG_LEVEL 2
47#define ET61X251_MAX_DEVICES 64
48#define ET61X251_PRESERVE_IMGSCALE 0
49#define ET61X251_FORCE_MUNMAP 0
50#define ET61X251_MAX_FRAMES 32
51#define ET61X251_COMPRESSION_QUALITY 0
52#define ET61X251_URBS 2
53#define ET61X251_ISO_PACKETS 7
54#define ET61X251_ALTERNATE_SETTING 13
55#define ET61X251_URB_TIMEOUT msecs_to_jiffies(2 * ET61X251_ISO_PACKETS)
56#define ET61X251_CTRL_TIMEOUT 100
57#define ET61X251_FRAME_TIMEOUT 2
58
59/*****************************************************************************/
60
61static const struct usb_device_id et61x251_id_table[] = {
62 { USB_DEVICE(0x102c, 0x6151), },
63 { USB_DEVICE(0x102c, 0x6251), },
64 { USB_DEVICE(0x102c, 0x6253), },
65 { USB_DEVICE(0x102c, 0x6254), },
66 { USB_DEVICE(0x102c, 0x6255), },
67 { USB_DEVICE(0x102c, 0x6256), },
68 { USB_DEVICE(0x102c, 0x6257), },
69 { USB_DEVICE(0x102c, 0x6258), },
70 { USB_DEVICE(0x102c, 0x6259), },
71 { USB_DEVICE(0x102c, 0x625a), },
72 { USB_DEVICE(0x102c, 0x625b), },
73 { USB_DEVICE(0x102c, 0x625c), },
74 { USB_DEVICE(0x102c, 0x625d), },
75 { USB_DEVICE(0x102c, 0x625e), },
76 { USB_DEVICE(0x102c, 0x625f), },
77 { USB_DEVICE(0x102c, 0x6260), },
78 { USB_DEVICE(0x102c, 0x6261), },
79 { USB_DEVICE(0x102c, 0x6262), },
80 { USB_DEVICE(0x102c, 0x6263), },
81 { USB_DEVICE(0x102c, 0x6264), },
82 { USB_DEVICE(0x102c, 0x6265), },
83 { USB_DEVICE(0x102c, 0x6266), },
84 { USB_DEVICE(0x102c, 0x6267), },
85 { USB_DEVICE(0x102c, 0x6268), },
86 { USB_DEVICE(0x102c, 0x6269), },
87 { }
88};
89
90ET61X251_SENSOR_TABLE
91
92/*****************************************************************************/
93
94enum et61x251_frame_state {
95 F_UNUSED,
96 F_QUEUED,
97 F_GRABBING,
98 F_DONE,
99 F_ERROR,
100};
101
102struct et61x251_frame_t {
103 void* bufmem;
104 struct v4l2_buffer buf;
105 enum et61x251_frame_state state;
106 struct list_head frame;
107 unsigned long vma_use_count;
108};
109
110enum et61x251_dev_state {
111 DEV_INITIALIZED = 0x01,
112 DEV_DISCONNECTED = 0x02,
113 DEV_MISCONFIGURED = 0x04,
114};
115
116enum et61x251_io_method {
117 IO_NONE,
118 IO_READ,
119 IO_MMAP,
120};
121
122enum et61x251_stream_state {
123 STREAM_OFF,
124 STREAM_INTERRUPT,
125 STREAM_ON,
126};
127
128struct et61x251_sysfs_attr {
129 u8 reg, i2c_reg;
130};
131
132struct et61x251_module_param {
133 u8 force_munmap;
134 u16 frame_timeout;
135};
136
137static DEFINE_MUTEX(et61x251_sysfs_lock);
138static DECLARE_RWSEM(et61x251_dev_lock);
139
140struct et61x251_device {
141 struct video_device* v4ldev;
142
143 struct et61x251_sensor sensor;
144
145 struct usb_device* usbdev;
146 struct urb* urb[ET61X251_URBS];
147 void* transfer_buffer[ET61X251_URBS];
148 u8* control_buffer;
149
150 struct et61x251_frame_t *frame_current, frame[ET61X251_MAX_FRAMES];
151 struct list_head inqueue, outqueue;
152 u32 frame_count, nbuffers, nreadbuffers;
153
154 enum et61x251_io_method io;
155 enum et61x251_stream_state stream;
156
157 struct v4l2_jpegcompression compression;
158
159 struct et61x251_sysfs_attr sysfs;
160 struct et61x251_module_param module_param;
161
162 struct kref kref;
163 enum et61x251_dev_state state;
164 u8 users;
165
166 struct completion probe;
167 struct mutex open_mutex, fileop_mutex;
168 spinlock_t queue_lock;
169 wait_queue_head_t wait_open, wait_frame, wait_stream;
170};
171
172/*****************************************************************************/
173
174struct et61x251_device*
175et61x251_match_id(struct et61x251_device* cam, const struct usb_device_id *id)
176{
177 return usb_match_id(usb_ifnum_to_if(cam->usbdev, 0), id) ? cam : NULL;
178}
179
180
181void
182et61x251_attach_sensor(struct et61x251_device* cam,
183 const struct et61x251_sensor* sensor)
184{
185 memcpy(&cam->sensor, sensor, sizeof(struct et61x251_sensor));
186}
187
188/*****************************************************************************/
189
190#undef DBG
191#undef KDBG
192#ifdef ET61X251_DEBUG
193# define DBG(level, fmt, args...) \
194do { \
195 if (debug >= (level)) { \
196 if ((level) == 1) \
197 dev_err(&cam->usbdev->dev, fmt "\n", ## args); \
198 else if ((level) == 2) \
199 dev_info(&cam->usbdev->dev, fmt "\n", ## args); \
200 else if ((level) >= 3) \
201 dev_info(&cam->usbdev->dev, "[%s:%s:%d] " fmt "\n", \
202 __FILE__, __func__, __LINE__ , ## args); \
203 } \
204} while (0)
205# define KDBG(level, fmt, args...) \
206do { \
207 if (debug >= (level)) { \
208 if ((level) == 1 || (level) == 2) \
209 pr_info("et61x251: " fmt "\n", ## args); \
210 else if ((level) == 3) \
211 pr_debug("sn9c102: [%s:%s:%d] " fmt "\n", __FILE__, \
212 __func__, __LINE__ , ## args); \
213 } \
214} while (0)
215# define V4LDBG(level, name, cmd) \
216do { \
217 if (debug >= (level)) \
218 v4l_print_ioctl(name, cmd); \
219} while (0)
220#else
221# define DBG(level, fmt, args...) do {;} while(0)
222# define KDBG(level, fmt, args...) do {;} while(0)
223# define V4LDBG(level, name, cmd) do {;} while(0)
224#endif
225
226#undef PDBG
227#define PDBG(fmt, args...) \
228dev_info(&cam->usbdev->dev, "[%s:%s:%d] " fmt "\n", __FILE__, __func__, \
229 __LINE__ , ## args)
230
231#undef PDBGG
232#define PDBGG(fmt, args...) do {;} while(0) /* placeholder */
233
234#endif /* _ET61X251_H_ */