V4L/DVB (12258): em28xx: fix typo in mt352 init sequence for Terratec Cinergy T XS USB
[linux-2.6] / drivers / media / video / w9968cf.c
1 /***************************************************************************
2  * Video4Linux driver for W996[87]CF JPEG USB Dual Mode Camera Chip.       *
3  *                                                                         *
4  * Copyright (C) 2002-2004 by Luca Risolia <luca.risolia@studio.unibo.it>  *
5  *                                                                         *
6  * - Memory management code from bttv driver by Ralph Metzler,             *
7  *   Marcus Metzler and Gerd Knorr.                                        *
8  * - I2C interface to kernel, high-level image sensor control routines and *
9  *   some symbolic names from OV511 driver by Mark W. McClelland.          *
10  * - Low-level I2C fast write function by Piotr Czerczak.                  *
11  * - Low-level I2C read function by Frederic Jouault.                      *
12  *                                                                         *
13  * This program is free software; you can redistribute it and/or modify    *
14  * it under the terms of the GNU General Public License as published by    *
15  * the Free Software Foundation; either version 2 of the License, or       *
16  * (at your option) any later version.                                     *
17  *                                                                         *
18  * This program is distributed in the hope that it will be useful,         *
19  * but WITHOUT ANY WARRANTY; without even the implied warranty of          *
20  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the           *
21  * GNU General Public License for more details.                            *
22  *                                                                         *
23  * You should have received a copy of the GNU General Public License       *
24  * along with this program; if not, write to the Free Software             *
25  * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.               *
26  ***************************************************************************/
27
28 #include <linux/module.h>
29 #include <linux/kernel.h>
30 #include <linux/kmod.h>
31 #include <linux/init.h>
32 #include <linux/fs.h>
33 #include <linux/vmalloc.h>
34 #include <linux/slab.h>
35 #include <linux/mm.h>
36 #include <linux/string.h>
37 #include <linux/errno.h>
38 #include <linux/sched.h>
39 #include <linux/ioctl.h>
40 #include <linux/delay.h>
41 #include <linux/stddef.h>
42 #include <asm/page.h>
43 #include <asm/uaccess.h>
44 #include <linux/page-flags.h>
45 #include <linux/videodev.h>
46 #include <media/v4l2-ioctl.h>
47
48 #include "w9968cf.h"
49 #include "w9968cf_decoder.h"
50
51 static struct w9968cf_vpp_t* w9968cf_vpp;
52 static DECLARE_WAIT_QUEUE_HEAD(w9968cf_vppmod_wait);
53
54 static LIST_HEAD(w9968cf_dev_list); /* head of V4L registered cameras list */
55 static DEFINE_MUTEX(w9968cf_devlist_mutex); /* semaphore for list traversal */
56
57 static DECLARE_RWSEM(w9968cf_disconnect); /* prevent races with open() */
58
59
60 /****************************************************************************
61  * Module macros and parameters                                             *
62  ****************************************************************************/
63
64 MODULE_DEVICE_TABLE(usb, winbond_id_table);
65
66 MODULE_AUTHOR(W9968CF_MODULE_AUTHOR" "W9968CF_AUTHOR_EMAIL);
67 MODULE_DESCRIPTION(W9968CF_MODULE_NAME);
68 MODULE_VERSION(W9968CF_MODULE_VERSION);
69 MODULE_LICENSE(W9968CF_MODULE_LICENSE);
70 MODULE_SUPPORTED_DEVICE("Video");
71
72 static unsigned short simcams = W9968CF_SIMCAMS;
73 static short video_nr[]={[0 ... W9968CF_MAX_DEVICES-1] = -1}; /*-1=first free*/
74 static unsigned int packet_size[] = {[0 ... W9968CF_MAX_DEVICES-1] =
75                                      W9968CF_PACKET_SIZE};
76 static unsigned short max_buffers[] = {[0 ... W9968CF_MAX_DEVICES-1] =
77                                        W9968CF_BUFFERS};
78 static int double_buffer[] = {[0 ... W9968CF_MAX_DEVICES-1] =
79                               W9968CF_DOUBLE_BUFFER};
80 static int clamping[] = {[0 ... W9968CF_MAX_DEVICES-1] = W9968CF_CLAMPING};
81 static unsigned short filter_type[]= {[0 ... W9968CF_MAX_DEVICES-1] =
82                                       W9968CF_FILTER_TYPE};
83 static int largeview[]= {[0 ... W9968CF_MAX_DEVICES-1] = W9968CF_LARGEVIEW};
84 static unsigned short decompression[] = {[0 ... W9968CF_MAX_DEVICES-1] =
85                                          W9968CF_DECOMPRESSION};
86 static int upscaling[]= {[0 ... W9968CF_MAX_DEVICES-1] = W9968CF_UPSCALING};
87 static unsigned short force_palette[] = {[0 ... W9968CF_MAX_DEVICES-1] = 0};
88 static int force_rgb[] = {[0 ... W9968CF_MAX_DEVICES-1] = W9968CF_FORCE_RGB};
89 static int autobright[] = {[0 ... W9968CF_MAX_DEVICES-1] = W9968CF_AUTOBRIGHT};
90 static int autoexp[] = {[0 ... W9968CF_MAX_DEVICES-1] = W9968CF_AUTOEXP};
91 static unsigned short lightfreq[] = {[0 ... W9968CF_MAX_DEVICES-1] =
92                                      W9968CF_LIGHTFREQ};
93 static int bandingfilter[] = {[0 ... W9968CF_MAX_DEVICES-1]=
94                               W9968CF_BANDINGFILTER};
95 static short clockdiv[] = {[0 ... W9968CF_MAX_DEVICES-1] = W9968CF_CLOCKDIV};
96 static int backlight[] = {[0 ... W9968CF_MAX_DEVICES-1] = W9968CF_BACKLIGHT};
97 static int mirror[] = {[0 ... W9968CF_MAX_DEVICES-1] = W9968CF_MIRROR};
98 static int monochrome[] = {[0 ... W9968CF_MAX_DEVICES-1]=W9968CF_MONOCHROME};
99 static unsigned int brightness[] = {[0 ... W9968CF_MAX_DEVICES-1] =
100                                     W9968CF_BRIGHTNESS};
101 static unsigned int hue[] = {[0 ... W9968CF_MAX_DEVICES-1] = W9968CF_HUE};
102 static unsigned int colour[]={[0 ... W9968CF_MAX_DEVICES-1] = W9968CF_COLOUR};
103 static unsigned int contrast[] = {[0 ... W9968CF_MAX_DEVICES-1] =
104                                   W9968CF_CONTRAST};
105 static unsigned int whiteness[] = {[0 ... W9968CF_MAX_DEVICES-1] =
106                                    W9968CF_WHITENESS};
107 #ifdef W9968CF_DEBUG
108 static unsigned short debug = W9968CF_DEBUG_LEVEL;
109 static int specific_debug = W9968CF_SPECIFIC_DEBUG;
110 #endif
111
112 static unsigned int param_nv[24]; /* number of values per parameter */
113
114 module_param(simcams, ushort, 0644);
115 module_param_array(video_nr, short, &param_nv[0], 0444);
116 module_param_array(packet_size, uint, &param_nv[1], 0444);
117 module_param_array(max_buffers, ushort, &param_nv[2], 0444);
118 module_param_array(double_buffer, bool, &param_nv[3], 0444);
119 module_param_array(clamping, bool, &param_nv[4], 0444);
120 module_param_array(filter_type, ushort, &param_nv[5], 0444);
121 module_param_array(largeview, bool, &param_nv[6], 0444);
122 module_param_array(decompression, ushort, &param_nv[7], 0444);
123 module_param_array(upscaling, bool, &param_nv[8], 0444);
124 module_param_array(force_palette, ushort, &param_nv[9], 0444);
125 module_param_array(force_rgb, ushort, &param_nv[10], 0444);
126 module_param_array(autobright, bool, &param_nv[11], 0444);
127 module_param_array(autoexp, bool, &param_nv[12], 0444);
128 module_param_array(lightfreq, ushort, &param_nv[13], 0444);
129 module_param_array(bandingfilter, bool, &param_nv[14], 0444);
130 module_param_array(clockdiv, short, &param_nv[15], 0444);
131 module_param_array(backlight, bool, &param_nv[16], 0444);
132 module_param_array(mirror, bool, &param_nv[17], 0444);
133 module_param_array(monochrome, bool, &param_nv[18], 0444);
134 module_param_array(brightness, uint, &param_nv[19], 0444);
135 module_param_array(hue, uint, &param_nv[20], 0444);
136 module_param_array(colour, uint, &param_nv[21], 0444);
137 module_param_array(contrast, uint, &param_nv[22], 0444);
138 module_param_array(whiteness, uint, &param_nv[23], 0444);
139 #ifdef W9968CF_DEBUG
140 module_param(debug, ushort, 0644);
141 module_param(specific_debug, bool, 0644);
142 #endif
143
144 MODULE_PARM_DESC(simcams,
145                  "\n<n> Number of cameras allowed to stream simultaneously."
146                  "\nn may vary from 0 to "
147                  __MODULE_STRING(W9968CF_MAX_DEVICES)"."
148                  "\nDefault value is "__MODULE_STRING(W9968CF_SIMCAMS)"."
149                  "\n");
150 MODULE_PARM_DESC(video_nr,
151                  "\n<-1|n[,...]> Specify V4L minor mode number."
152                  "\n -1 = use next available (default)"
153                  "\n  n = use minor number n (integer >= 0)"
154                  "\nYou can specify up to "__MODULE_STRING(W9968CF_MAX_DEVICES)
155                  " cameras this way."
156                  "\nFor example:"
157                  "\nvideo_nr=-1,2,-1 would assign minor number 2 to"
158                  "\nthe second camera and use auto for the first"
159                  "\none and for every other camera."
160                  "\n");
161 MODULE_PARM_DESC(packet_size,
162                  "\n<n[,...]> Specify the maximum data payload"
163                  "\nsize in bytes for alternate settings, for each device."
164                  "\nn is scaled between 63 and 1023 "
165                  "(default is "__MODULE_STRING(W9968CF_PACKET_SIZE)")."
166                  "\n");
167 MODULE_PARM_DESC(max_buffers,
168                  "\n<n[,...]> For advanced users."
169                  "\nSpecify the maximum number of video frame buffers"
170                  "\nto allocate for each device, from 2 to "
171                  __MODULE_STRING(W9968CF_MAX_BUFFERS)
172                  ". (default is "__MODULE_STRING(W9968CF_BUFFERS)")."
173                  "\n");
174 MODULE_PARM_DESC(double_buffer,
175                  "\n<0|1[,...]> "
176                  "Hardware double buffering: 0 disabled, 1 enabled."
177                  "\nIt should be enabled if you want smooth video output: if"
178                  "\nyou obtain out of sync. video, disable it, or try to"
179                  "\ndecrease the 'clockdiv' module parameter value."
180                  "\nDefault value is "__MODULE_STRING(W9968CF_DOUBLE_BUFFER)
181                  " for every device."
182                  "\n");
183 MODULE_PARM_DESC(clamping,
184                  "\n<0|1[,...]> Video data clamping: 0 disabled, 1 enabled."
185                  "\nDefault value is "__MODULE_STRING(W9968CF_CLAMPING)
186                  " for every device."
187                  "\n");
188 MODULE_PARM_DESC(filter_type,
189                  "\n<0|1|2[,...]> Video filter type."
190                  "\n0 none, 1 (1-2-1) 3-tap filter, "
191                  "2 (2-3-6-3-2) 5-tap filter."
192                  "\nDefault value is "__MODULE_STRING(W9968CF_FILTER_TYPE)
193                  " for every device."
194                  "\nThe filter is used to reduce noise and aliasing artifacts"
195                  "\nproduced by the CCD or CMOS image sensor, and the scaling"
196                  " process."
197                  "\n");
198 MODULE_PARM_DESC(largeview,
199                  "\n<0|1[,...]> Large view: 0 disabled, 1 enabled."
200                  "\nDefault value is "__MODULE_STRING(W9968CF_LARGEVIEW)
201                  " for every device."
202                  "\n");
203 MODULE_PARM_DESC(upscaling,
204                  "\n<0|1[,...]> Software scaling (for non-compressed video):"
205                  "\n0 disabled, 1 enabled."
206                  "\nDisable it if you have a slow CPU or you don't have"
207                  " enough memory."
208                  "\nDefault value is "__MODULE_STRING(W9968CF_UPSCALING)
209                  " for every device."
210                  "\nIf 'w9968cf-vpp' is not present, this parameter is"
211                  " set to 0."
212                  "\n");
213 MODULE_PARM_DESC(decompression,
214                  "\n<0|1|2[,...]> Software video decompression:"
215                  "\n- 0 disables decompression (doesn't allow formats needing"
216                  " decompression)"
217                  "\n- 1 forces decompression (allows formats needing"
218                  " decompression only);"
219                  "\n- 2 allows any permitted formats."
220                  "\nFormats supporting compressed video are YUV422P and"
221                  " YUV420P/YUV420 "
222                  "\nin any resolutions where both width and height are "
223                  "a multiple of 16."
224                  "\nDefault value is "__MODULE_STRING(W9968CF_DECOMPRESSION)
225                  " for every device."
226                  "\nIf 'w9968cf-vpp' is not present, forcing decompression is "
227                  "\nnot allowed; in this case this parameter is set to 2."
228                  "\n");
229 MODULE_PARM_DESC(force_palette,
230                  "\n<0"
231                  "|" __MODULE_STRING(VIDEO_PALETTE_UYVY)
232                  "|" __MODULE_STRING(VIDEO_PALETTE_YUV420)
233                  "|" __MODULE_STRING(VIDEO_PALETTE_YUV422P)
234                  "|" __MODULE_STRING(VIDEO_PALETTE_YUV420P)
235                  "|" __MODULE_STRING(VIDEO_PALETTE_YUYV)
236                  "|" __MODULE_STRING(VIDEO_PALETTE_YUV422)
237                  "|" __MODULE_STRING(VIDEO_PALETTE_GREY)
238                  "|" __MODULE_STRING(VIDEO_PALETTE_RGB555)
239                  "|" __MODULE_STRING(VIDEO_PALETTE_RGB565)
240                  "|" __MODULE_STRING(VIDEO_PALETTE_RGB24)
241                  "|" __MODULE_STRING(VIDEO_PALETTE_RGB32)
242                  "[,...]>"
243                  " Force picture palette."
244                  "\nIn order:"
245                  "\n- 0 allows any of the following formats:"
246                  "\n- UYVY    16 bpp - Original video, compression disabled"
247                  "\n- YUV420  12 bpp - Original video, compression enabled"
248                  "\n- YUV422P 16 bpp - Original video, compression enabled"
249                  "\n- YUV420P 12 bpp - Original video, compression enabled"
250                  "\n- YUVY    16 bpp - Software conversion from UYVY"
251                  "\n- YUV422  16 bpp - Software conversion from UYVY"
252                  "\n- GREY     8 bpp - Software conversion from UYVY"
253                  "\n- RGB555  16 bpp - Software conversion from UYVY"
254                  "\n- RGB565  16 bpp - Software conversion from UYVY"
255                  "\n- RGB24   24 bpp - Software conversion from UYVY"
256                  "\n- RGB32   32 bpp - Software conversion from UYVY"
257                  "\nWhen not 0, this parameter will override 'decompression'."
258                  "\nDefault value is 0 for every device."
259                  "\nInitial palette is "
260                  __MODULE_STRING(W9968CF_PALETTE_DECOMP_ON)"."
261                  "\nIf 'w9968cf-vpp' is not present, this parameter is"
262                  " set to 9 (UYVY)."
263                  "\n");
264 MODULE_PARM_DESC(force_rgb,
265                  "\n<0|1[,...]> Read RGB video data instead of BGR:"
266                  "\n 1 = use RGB component ordering."
267                  "\n 0 = use BGR component ordering."
268                  "\nThis parameter has effect when using RGBX palettes only."
269                  "\nDefault value is "__MODULE_STRING(W9968CF_FORCE_RGB)
270                  " for every device."
271                  "\n");
272 MODULE_PARM_DESC(autobright,
273                  "\n<0|1[,...]> Image sensor automatically changes brightness:"
274                  "\n 0 = no, 1 = yes"
275                  "\nDefault value is "__MODULE_STRING(W9968CF_AUTOBRIGHT)
276                  " for every device."
277                  "\n");
278 MODULE_PARM_DESC(autoexp,
279                  "\n<0|1[,...]> Image sensor automatically changes exposure:"
280                  "\n 0 = no, 1 = yes"
281                  "\nDefault value is "__MODULE_STRING(W9968CF_AUTOEXP)
282                  " for every device."
283                  "\n");
284 MODULE_PARM_DESC(lightfreq,
285                  "\n<50|60[,...]> Light frequency in Hz:"
286                  "\n 50 for European and Asian lighting,"
287                  " 60 for American lighting."
288                  "\nDefault value is "__MODULE_STRING(W9968CF_LIGHTFREQ)
289                  " for every device."
290                  "\n");
291 MODULE_PARM_DESC(bandingfilter,
292                  "\n<0|1[,...]> Banding filter to reduce effects of"
293                  " fluorescent lighting:"
294                  "\n 0 disabled, 1 enabled."
295                  "\nThis filter tries to reduce the pattern of horizontal"
296                  "\nlight/dark bands caused by some (usually fluorescent)"
297                  " lighting."
298                  "\nDefault value is "__MODULE_STRING(W9968CF_BANDINGFILTER)
299                  " for every device."
300                  "\n");
301 MODULE_PARM_DESC(clockdiv,
302                  "\n<-1|n[,...]> "
303                  "Force pixel clock divisor to a specific value (for experts):"
304                  "\n  n may vary from 0 to 127."
305                  "\n -1 for automatic value."
306                  "\nSee also the 'double_buffer' module parameter."
307                  "\nDefault value is "__MODULE_STRING(W9968CF_CLOCKDIV)
308                  " for every device."
309                  "\n");
310 MODULE_PARM_DESC(backlight,
311                  "\n<0|1[,...]> Objects are lit from behind:"
312                  "\n 0 = no, 1 = yes"
313                  "\nDefault value is "__MODULE_STRING(W9968CF_BACKLIGHT)
314                  " for every device."
315                  "\n");
316 MODULE_PARM_DESC(mirror,
317                  "\n<0|1[,...]> Reverse image horizontally:"
318                  "\n 0 = no, 1 = yes"
319                  "\nDefault value is "__MODULE_STRING(W9968CF_MIRROR)
320                  " for every device."
321                  "\n");
322 MODULE_PARM_DESC(monochrome,
323                  "\n<0|1[,...]> Use image sensor as monochrome sensor:"
324                  "\n 0 = no, 1 = yes"
325                  "\nNot all the sensors support monochrome color."
326                  "\nDefault value is "__MODULE_STRING(W9968CF_MONOCHROME)
327                  " for every device."
328                  "\n");
329 MODULE_PARM_DESC(brightness,
330                  "\n<n[,...]> Set picture brightness (0-65535)."
331                  "\nDefault value is "__MODULE_STRING(W9968CF_BRIGHTNESS)
332                  " for every device."
333                  "\nThis parameter has no effect if 'autobright' is enabled."
334                  "\n");
335 MODULE_PARM_DESC(hue,
336                  "\n<n[,...]> Set picture hue (0-65535)."
337                  "\nDefault value is "__MODULE_STRING(W9968CF_HUE)
338                  " for every device."
339                  "\n");
340 MODULE_PARM_DESC(colour,
341                  "\n<n[,...]> Set picture saturation (0-65535)."
342                  "\nDefault value is "__MODULE_STRING(W9968CF_COLOUR)
343                  " for every device."
344                  "\n");
345 MODULE_PARM_DESC(contrast,
346                  "\n<n[,...]> Set picture contrast (0-65535)."
347                  "\nDefault value is "__MODULE_STRING(W9968CF_CONTRAST)
348                  " for every device."
349                  "\n");
350 MODULE_PARM_DESC(whiteness,
351                  "\n<n[,...]> Set picture whiteness (0-65535)."
352                  "\nDefault value is "__MODULE_STRING(W9968CF_WHITENESS)
353                  " for every device."
354                  "\n");
355 #ifdef W9968CF_DEBUG
356 MODULE_PARM_DESC(debug,
357                  "\n<n> Debugging information level, from 0 to 6:"
358                  "\n0 = none (use carefully)"
359                  "\n1 = critical errors"
360                  "\n2 = significant informations"
361                  "\n3 = configuration or general messages"
362                  "\n4 = warnings"
363                  "\n5 = called functions"
364                  "\n6 = function internals"
365                  "\nLevel 5 and 6 are useful for testing only, when only "
366                  "one device is used."
367                  "\nDefault value is "__MODULE_STRING(W9968CF_DEBUG_LEVEL)"."
368                  "\n");
369 MODULE_PARM_DESC(specific_debug,
370                  "\n<0|1> Enable or disable specific debugging messages:"
371                  "\n0 = print messages concerning every level"
372                  " <= 'debug' level."
373                  "\n1 = print messages concerning the level"
374                  " indicated by 'debug'."
375                  "\nDefault value is "
376                  __MODULE_STRING(W9968CF_SPECIFIC_DEBUG)"."
377                  "\n");
378 #endif /* W9968CF_DEBUG */
379
380
381
382 /****************************************************************************
383  * Some prototypes                                                          *
384  ****************************************************************************/
385
386 /* Video4linux interface */
387 static const struct v4l2_file_operations w9968cf_fops;
388 static int w9968cf_open(struct file *);
389 static int w9968cf_release(struct file *);
390 static int w9968cf_mmap(struct file *, struct vm_area_struct *);
391 static long w9968cf_ioctl(struct file *, unsigned, unsigned long);
392 static ssize_t w9968cf_read(struct file *, char __user *, size_t, loff_t *);
393 static long w9968cf_v4l_ioctl(struct file *, unsigned int,
394                              void __user *);
395
396 /* USB-specific */
397 static int w9968cf_start_transfer(struct w9968cf_device*);
398 static int w9968cf_stop_transfer(struct w9968cf_device*);
399 static int w9968cf_write_reg(struct w9968cf_device*, u16 value, u16 index);
400 static int w9968cf_read_reg(struct w9968cf_device*, u16 index);
401 static int w9968cf_write_fsb(struct w9968cf_device*, u16* data);
402 static int w9968cf_write_sb(struct w9968cf_device*, u16 value);
403 static int w9968cf_read_sb(struct w9968cf_device*);
404 static int w9968cf_upload_quantizationtables(struct w9968cf_device*);
405 static void w9968cf_urb_complete(struct urb *urb);
406
407 /* Low-level I2C (SMBus) I/O */
408 static int w9968cf_smbus_start(struct w9968cf_device*);
409 static int w9968cf_smbus_stop(struct w9968cf_device*);
410 static int w9968cf_smbus_write_byte(struct w9968cf_device*, u8 v);
411 static int w9968cf_smbus_read_byte(struct w9968cf_device*, u8* v);
412 static int w9968cf_smbus_write_ack(struct w9968cf_device*);
413 static int w9968cf_smbus_read_ack(struct w9968cf_device*);
414 static int w9968cf_smbus_refresh_bus(struct w9968cf_device*);
415 static int w9968cf_i2c_adap_read_byte(struct w9968cf_device* cam,
416                                       u16 address, u8* value);
417 static int w9968cf_i2c_adap_read_byte_data(struct w9968cf_device*, u16 address,
418                                            u8 subaddress, u8* value);
419 static int w9968cf_i2c_adap_write_byte(struct w9968cf_device*,
420                                        u16 address, u8 subaddress);
421 static int w9968cf_i2c_adap_fastwrite_byte_data(struct w9968cf_device*,
422                                                 u16 address, u8 subaddress,
423                                                 u8 value);
424
425 /* I2C interface to kernel */
426 static int w9968cf_i2c_init(struct w9968cf_device*);
427 static int w9968cf_i2c_smbus_xfer(struct i2c_adapter*, u16 addr,
428                                   unsigned short flags, char read_write,
429                                   u8 command, int size, union i2c_smbus_data*);
430 static u32 w9968cf_i2c_func(struct i2c_adapter*);
431
432 /* Memory management */
433 static void* rvmalloc(unsigned long size);
434 static void rvfree(void *mem, unsigned long size);
435 static void w9968cf_deallocate_memory(struct w9968cf_device*);
436 static int  w9968cf_allocate_memory(struct w9968cf_device*);
437
438 /* High-level image sensor control functions */
439 static int w9968cf_sensor_set_control(struct w9968cf_device*,int cid,int val);
440 static int w9968cf_sensor_get_control(struct w9968cf_device*,int cid,int *val);
441 static int w9968cf_sensor_cmd(struct w9968cf_device*,
442                               unsigned int cmd, void *arg);
443 static int w9968cf_sensor_init(struct w9968cf_device*);
444 static int w9968cf_sensor_update_settings(struct w9968cf_device*);
445 static int w9968cf_sensor_get_picture(struct w9968cf_device*);
446 static int w9968cf_sensor_update_picture(struct w9968cf_device*,
447                                          struct video_picture pict);
448
449 /* Other helper functions */
450 static void w9968cf_configure_camera(struct w9968cf_device*,struct usb_device*,
451                                      enum w9968cf_model_id,
452                                      const unsigned short dev_nr);
453 static void w9968cf_adjust_configuration(struct w9968cf_device*);
454 static int w9968cf_turn_on_led(struct w9968cf_device*);
455 static int w9968cf_init_chip(struct w9968cf_device*);
456 static inline u16 w9968cf_valid_palette(u16 palette);
457 static inline u16 w9968cf_valid_depth(u16 palette);
458 static inline u8 w9968cf_need_decompression(u16 palette);
459 static int w9968cf_set_picture(struct w9968cf_device*, struct video_picture);
460 static int w9968cf_set_window(struct w9968cf_device*, struct video_window);
461 static int w9968cf_postprocess_frame(struct w9968cf_device*,
462                                      struct w9968cf_frame_t*);
463 static int w9968cf_adjust_window_size(struct w9968cf_device*, u32 *w, u32 *h);
464 static void w9968cf_init_framelist(struct w9968cf_device*);
465 static void w9968cf_push_frame(struct w9968cf_device*, u8 f_num);
466 static void w9968cf_pop_frame(struct w9968cf_device*,struct w9968cf_frame_t**);
467 static void w9968cf_release_resources(struct w9968cf_device*);
468
469
470
471 /****************************************************************************
472  * Symbolic names                                                           *
473  ****************************************************************************/
474
475 /* Used to represent a list of values and their respective symbolic names */
476 struct w9968cf_symbolic_list {
477         const int num;
478         const char *name;
479 };
480
481 /*--------------------------------------------------------------------------
482   Returns the name of the matching element in the symbolic_list array. The
483   end of the list must be marked with an element that has a NULL name.
484   --------------------------------------------------------------------------*/
485 static inline const char *
486 symbolic(struct w9968cf_symbolic_list list[], const int num)
487 {
488         int i;
489
490         for (i = 0; list[i].name != NULL; i++)
491                 if (list[i].num == num)
492                         return (list[i].name);
493
494         return "Unknown";
495 }
496
497 static struct w9968cf_symbolic_list camlist[] = {
498         { W9968CF_MOD_GENERIC, "W996[87]CF JPEG USB Dual Mode Camera" },
499         { W9968CF_MOD_CLVBWGP, "Creative Labs Video Blaster WebCam Go Plus" },
500
501         /* Other cameras (having the same descriptors as Generic W996[87]CF) */
502         { W9968CF_MOD_ADPVDMA, "Aroma Digi Pen VGA Dual Mode ADG-5000" },
503         { W9986CF_MOD_AAU, "AVerMedia AVerTV USB" },
504         { W9968CF_MOD_CLVBWG, "Creative Labs Video Blaster WebCam Go" },
505         { W9968CF_MOD_LL, "Lebon LDC-035A" },
506         { W9968CF_MOD_EEEMC, "Ezonics EZ-802 EZMega Cam" },
507         { W9968CF_MOD_OOE, "OmniVision OV8610-EDE" },
508         { W9968CF_MOD_ODPVDMPC, "OPCOM Digi Pen VGA Dual Mode Pen Camera" },
509         { W9968CF_MOD_PDPII, "Pretec Digi Pen-II" },
510         { W9968CF_MOD_PDP480, "Pretec DigiPen-480" },
511
512         {  -1, NULL }
513 };
514
515 static struct w9968cf_symbolic_list senlist[] = {
516         { CC_OV76BE,   "OV76BE" },
517         { CC_OV7610,   "OV7610" },
518         { CC_OV7620,   "OV7620" },
519         { CC_OV7620AE, "OV7620AE" },
520         { CC_OV6620,   "OV6620" },
521         { CC_OV6630,   "OV6630" },
522         { CC_OV6630AE, "OV6630AE" },
523         { CC_OV6630AF, "OV6630AF" },
524         { -1, NULL }
525 };
526
527 /* Video4Linux1 palettes */
528 static struct w9968cf_symbolic_list v4l1_plist[] = {
529         { VIDEO_PALETTE_GREY,    "GREY" },
530         { VIDEO_PALETTE_HI240,   "HI240" },
531         { VIDEO_PALETTE_RGB565,  "RGB565" },
532         { VIDEO_PALETTE_RGB24,   "RGB24" },
533         { VIDEO_PALETTE_RGB32,   "RGB32" },
534         { VIDEO_PALETTE_RGB555,  "RGB555" },
535         { VIDEO_PALETTE_YUV422,  "YUV422" },
536         { VIDEO_PALETTE_YUYV,    "YUYV" },
537         { VIDEO_PALETTE_UYVY,    "UYVY" },
538         { VIDEO_PALETTE_YUV420,  "YUV420" },
539         { VIDEO_PALETTE_YUV411,  "YUV411" },
540         { VIDEO_PALETTE_RAW,     "RAW" },
541         { VIDEO_PALETTE_YUV422P, "YUV422P" },
542         { VIDEO_PALETTE_YUV411P, "YUV411P" },
543         { VIDEO_PALETTE_YUV420P, "YUV420P" },
544         { VIDEO_PALETTE_YUV410P, "YUV410P" },
545         { -1, NULL }
546 };
547
548 /* Decoder error codes: */
549 static struct w9968cf_symbolic_list decoder_errlist[] = {
550         { W9968CF_DEC_ERR_CORRUPTED_DATA, "Corrupted data" },
551         { W9968CF_DEC_ERR_BUF_OVERFLOW,   "Buffer overflow" },
552         { W9968CF_DEC_ERR_NO_SOI,         "SOI marker not found" },
553         { W9968CF_DEC_ERR_NO_SOF0,        "SOF0 marker not found" },
554         { W9968CF_DEC_ERR_NO_SOS,         "SOS marker not found" },
555         { W9968CF_DEC_ERR_NO_EOI,         "EOI marker not found" },
556         { -1, NULL }
557 };
558
559 /* URB error codes: */
560 static struct w9968cf_symbolic_list urb_errlist[] = {
561         { -ENOMEM,    "No memory for allocation of internal structures" },
562         { -ENOSPC,    "The host controller's bandwidth is already consumed" },
563         { -ENOENT,    "URB was canceled by unlink_urb" },
564         { -EXDEV,     "ISO transfer only partially completed" },
565         { -EAGAIN,    "Too match scheduled for the future" },
566         { -ENXIO,     "URB already queued" },
567         { -EFBIG,     "Too much ISO frames requested" },
568         { -ENOSR,     "Buffer error (overrun)" },
569         { -EPIPE,     "Specified endpoint is stalled (device not responding)"},
570         { -EOVERFLOW, "Babble (too much data)" },
571         { -EPROTO,    "Bit-stuff error (bad cable?)" },
572         { -EILSEQ,    "CRC/Timeout" },
573         { -ETIME,     "Device does not respond to token" },
574         { -ETIMEDOUT, "Device does not respond to command" },
575         { -1, NULL }
576 };
577
578 /****************************************************************************
579  * Memory management functions                                              *
580  ****************************************************************************/
581 static void* rvmalloc(unsigned long size)
582 {
583         void* mem;
584         unsigned long adr;
585
586         size = PAGE_ALIGN(size);
587         mem = vmalloc_32(size);
588         if (!mem)
589                 return NULL;
590
591         memset(mem, 0, size); /* Clear the ram out, no junk to the user */
592         adr = (unsigned long) mem;
593         while (size > 0) {
594                 SetPageReserved(vmalloc_to_page((void *)adr));
595                 adr += PAGE_SIZE;
596                 size -= PAGE_SIZE;
597         }
598
599         return mem;
600 }
601
602
603 static void rvfree(void* mem, unsigned long size)
604 {
605         unsigned long adr;
606
607         if (!mem)
608                 return;
609
610         adr = (unsigned long) mem;
611         while ((long) size > 0) {
612                 ClearPageReserved(vmalloc_to_page((void *)adr));
613                 adr += PAGE_SIZE;
614                 size -= PAGE_SIZE;
615         }
616         vfree(mem);
617 }
618
619
620 /*--------------------------------------------------------------------------
621   Deallocate previously allocated memory.
622   --------------------------------------------------------------------------*/
623 static void w9968cf_deallocate_memory(struct w9968cf_device* cam)
624 {
625         u8 i;
626
627         /* Free the isochronous transfer buffers */
628         for (i = 0; i < W9968CF_URBS; i++) {
629                 kfree(cam->transfer_buffer[i]);
630                 cam->transfer_buffer[i] = NULL;
631         }
632
633         /* Free temporary frame buffer */
634         if (cam->frame_tmp.buffer) {
635                 rvfree(cam->frame_tmp.buffer, cam->frame_tmp.size);
636                 cam->frame_tmp.buffer = NULL;
637         }
638
639         /* Free helper buffer */
640         if (cam->frame_vpp.buffer) {
641                 rvfree(cam->frame_vpp.buffer, cam->frame_vpp.size);
642                 cam->frame_vpp.buffer = NULL;
643         }
644
645         /* Free video frame buffers */
646         if (cam->frame[0].buffer) {
647                 rvfree(cam->frame[0].buffer, cam->nbuffers*cam->frame[0].size);
648                 cam->frame[0].buffer = NULL;
649         }
650
651         cam->nbuffers = 0;
652
653         DBG(5, "Memory successfully deallocated")
654 }
655
656
657 /*--------------------------------------------------------------------------
658   Allocate memory buffers for USB transfers and video frames.
659   This function is called by open() only.
660   Return 0 on success, a negative number otherwise.
661   --------------------------------------------------------------------------*/
662 static int w9968cf_allocate_memory(struct w9968cf_device* cam)
663 {
664         const u16 p_size = wMaxPacketSize[cam->altsetting-1];
665         void* buff = NULL;
666         unsigned long hw_bufsize, vpp_bufsize;
667         u8 i, bpp;
668
669         /* NOTE: Deallocation is done elsewhere in case of error */
670
671         /* Calculate the max amount of raw data per frame from the device */
672         hw_bufsize = cam->maxwidth*cam->maxheight*2;
673
674         /* Calculate the max buf. size needed for post-processing routines */
675         bpp = (w9968cf_vpp) ? 4 : 2;
676         if (cam->upscaling)
677                 vpp_bufsize = max(W9968CF_MAX_WIDTH*W9968CF_MAX_HEIGHT*bpp,
678                                   cam->maxwidth*cam->maxheight*bpp);
679         else
680                 vpp_bufsize = cam->maxwidth*cam->maxheight*bpp;
681
682         /* Allocate memory for the isochronous transfer buffers */
683         for (i = 0; i < W9968CF_URBS; i++) {
684                 if (!(cam->transfer_buffer[i] =
685                       kzalloc(W9968CF_ISO_PACKETS*p_size, GFP_KERNEL))) {
686                         DBG(1, "Couldn't allocate memory for the isochronous "
687                                "transfer buffers (%u bytes)",
688                             p_size * W9968CF_ISO_PACKETS)
689                         return -ENOMEM;
690                 }
691         }
692
693         /* Allocate memory for the temporary frame buffer */
694         if (!(cam->frame_tmp.buffer = rvmalloc(hw_bufsize))) {
695                 DBG(1, "Couldn't allocate memory for the temporary "
696                        "video frame buffer (%lu bytes)", hw_bufsize)
697                 return -ENOMEM;
698         }
699         cam->frame_tmp.size = hw_bufsize;
700         cam->frame_tmp.number = -1;
701
702         /* Allocate memory for the helper buffer */
703         if (w9968cf_vpp) {
704                 if (!(cam->frame_vpp.buffer = rvmalloc(vpp_bufsize))) {
705                         DBG(1, "Couldn't allocate memory for the helper buffer"
706                                " (%lu bytes)", vpp_bufsize)
707                         return -ENOMEM;
708                 }
709                 cam->frame_vpp.size = vpp_bufsize;
710         } else
711                 cam->frame_vpp.buffer = NULL;
712
713         /* Allocate memory for video frame buffers */
714         cam->nbuffers = cam->max_buffers;
715         while (cam->nbuffers >= 2) {
716                 if ((buff = rvmalloc(cam->nbuffers * vpp_bufsize)))
717                         break;
718                 else
719                         cam->nbuffers--;
720         }
721
722         if (!buff) {
723                 DBG(1, "Couldn't allocate memory for the video frame buffers")
724                 cam->nbuffers = 0;
725                 return -ENOMEM;
726         }
727
728         if (cam->nbuffers != cam->max_buffers)
729                 DBG(2, "Couldn't allocate memory for %u video frame buffers. "
730                        "Only memory for %u buffers has been allocated",
731                     cam->max_buffers, cam->nbuffers)
732
733         for (i = 0; i < cam->nbuffers; i++) {
734                 cam->frame[i].buffer = buff + i*vpp_bufsize;
735                 cam->frame[i].size = vpp_bufsize;
736                 cam->frame[i].number = i;
737                 /* Circular list */
738                 if (i != cam->nbuffers-1)
739                         cam->frame[i].next = &cam->frame[i+1];
740                 else
741                         cam->frame[i].next = &cam->frame[0];
742                 cam->frame[i].status = F_UNUSED;
743         }
744
745         DBG(5, "Memory successfully allocated")
746         return 0;
747 }
748
749
750
751 /****************************************************************************
752  * USB-specific functions                                                   *
753  ****************************************************************************/
754
755 /*--------------------------------------------------------------------------
756   This is an handler function which is called after the URBs are completed.
757   It collects multiple data packets coming from the camera by putting them
758   into frame buffers: one or more zero data length data packets are used to
759   mark the end of a video frame; the first non-zero data packet is the start
760   of the next video frame; if an error is encountered in a packet, the entire
761   video frame is discarded and grabbed again.
762   If there are no requested frames in the FIFO list, packets are collected into
763   a temporary buffer.
764   --------------------------------------------------------------------------*/
765 static void w9968cf_urb_complete(struct urb *urb)
766 {
767         struct w9968cf_device* cam = (struct w9968cf_device*)urb->context;
768         struct w9968cf_frame_t** f;
769         unsigned int len, status;
770         void* pos;
771         u8 i;
772         int err = 0;
773
774         if ((!cam->streaming) || cam->disconnected) {
775                 DBG(4, "Got interrupt, but not streaming")
776                 return;
777         }
778
779         /* "(*f)" will be used instead of "cam->frame_current" */
780         f = &cam->frame_current;
781
782         /* If a frame has been requested and we are grabbing into
783            the temporary frame, we'll switch to that requested frame */
784         if ((*f) == &cam->frame_tmp && *cam->requested_frame) {
785                 if (cam->frame_tmp.status == F_GRABBING) {
786                         w9968cf_pop_frame(cam, &cam->frame_current);
787                         (*f)->status = F_GRABBING;
788                         (*f)->length = cam->frame_tmp.length;
789                         memcpy((*f)->buffer, cam->frame_tmp.buffer,
790                                (*f)->length);
791                         DBG(6, "Switched from temp. frame to frame #%d",
792                             (*f)->number)
793                 }
794         }
795
796         for (i = 0; i < urb->number_of_packets; i++) {
797                 len = urb->iso_frame_desc[i].actual_length;
798                 status = urb->iso_frame_desc[i].status;
799                 pos = urb->iso_frame_desc[i].offset + urb->transfer_buffer;
800
801                 if (status && len != 0) {
802                         DBG(4, "URB failed, error in data packet "
803                                "(error #%u, %s)",
804                             status, symbolic(urb_errlist, status))
805                         (*f)->status = F_ERROR;
806                         continue;
807                 }
808
809                 if (len) { /* start of frame */
810
811                         if ((*f)->status == F_UNUSED) {
812                                 (*f)->status = F_GRABBING;
813                                 (*f)->length = 0;
814                         }
815
816                         /* Buffer overflows shouldn't happen, however...*/
817                         if ((*f)->length + len > (*f)->size) {
818                                 DBG(4, "Buffer overflow: bad data packets")
819                                 (*f)->status = F_ERROR;
820                         }
821
822                         if ((*f)->status == F_GRABBING) {
823                                 memcpy((*f)->buffer + (*f)->length, pos, len);
824                                 (*f)->length += len;
825                         }
826
827                 } else if ((*f)->status == F_GRABBING) { /* end of frame */
828
829                         DBG(6, "Frame #%d successfully grabbed", (*f)->number)
830
831                         if (cam->vpp_flag & VPP_DECOMPRESSION) {
832                                 err = w9968cf_vpp->check_headers((*f)->buffer,
833                                                                  (*f)->length);
834                                 if (err) {
835                                         DBG(4, "Skip corrupted frame: %s",
836                                             symbolic(decoder_errlist, err))
837                                         (*f)->status = F_UNUSED;
838                                         continue; /* grab this frame again */
839                                 }
840                         }
841
842                         (*f)->status = F_READY;
843                         (*f)->queued = 0;
844
845                         /* Take a pointer to the new frame from the FIFO list.
846                            If the list is empty,we'll use the temporary frame*/
847                         if (*cam->requested_frame)
848                                 w9968cf_pop_frame(cam, &cam->frame_current);
849                         else {
850                                 cam->frame_current = &cam->frame_tmp;
851                                 (*f)->status = F_UNUSED;
852                         }
853
854                 } else if ((*f)->status == F_ERROR)
855                         (*f)->status = F_UNUSED; /* grab it again */
856
857                 PDBGG("Frame length %lu | pack.#%u | pack.len. %u | state %d",
858                       (unsigned long)(*f)->length, i, len, (*f)->status)
859
860         } /* end for */
861
862         /* Resubmit this URB */
863         urb->dev = cam->usbdev;
864         urb->status = 0;
865         spin_lock(&cam->urb_lock);
866         if (cam->streaming)
867                 if ((err = usb_submit_urb(urb, GFP_ATOMIC))) {
868                         cam->misconfigured = 1;
869                         DBG(1, "Couldn't resubmit the URB: error %d, %s",
870                             err, symbolic(urb_errlist, err))
871                 }
872         spin_unlock(&cam->urb_lock);
873
874         /* Wake up the user process */
875         wake_up_interruptible(&cam->wait_queue);
876 }
877
878
879 /*---------------------------------------------------------------------------
880   Setup the URB structures for the isochronous transfer.
881   Submit the URBs so that the data transfer begins.
882   Return 0 on success, a negative number otherwise.
883   ---------------------------------------------------------------------------*/
884 static int w9968cf_start_transfer(struct w9968cf_device* cam)
885 {
886         struct usb_device *udev = cam->usbdev;
887         struct urb* urb;
888         const u16 p_size = wMaxPacketSize[cam->altsetting-1];
889         u16 w, h, d;
890         int vidcapt;
891         u32 t_size;
892         int err = 0;
893         s8 i, j;
894
895         for (i = 0; i < W9968CF_URBS; i++) {
896                 urb = usb_alloc_urb(W9968CF_ISO_PACKETS, GFP_KERNEL);
897                 if (!urb) {
898                         for (j = 0; j < i; j++)
899                                 usb_free_urb(cam->urb[j]);
900                         DBG(1, "Couldn't allocate the URB structures")
901                         return -ENOMEM;
902                 }
903
904                 cam->urb[i] = urb;
905                 urb->dev = udev;
906                 urb->context = (void*)cam;
907                 urb->pipe = usb_rcvisocpipe(udev, 1);
908                 urb->transfer_flags = URB_ISO_ASAP;
909                 urb->number_of_packets = W9968CF_ISO_PACKETS;
910                 urb->complete = w9968cf_urb_complete;
911                 urb->transfer_buffer = cam->transfer_buffer[i];
912                 urb->transfer_buffer_length = p_size*W9968CF_ISO_PACKETS;
913                 urb->interval = 1;
914                 for (j = 0; j < W9968CF_ISO_PACKETS; j++) {
915                         urb->iso_frame_desc[j].offset = p_size*j;
916                         urb->iso_frame_desc[j].length = p_size;
917                 }
918         }
919
920         /* Transfer size per frame, in WORD ! */
921         d = cam->hw_depth;
922         w = cam->hw_width;
923         h = cam->hw_height;
924
925         t_size = (w*h*d)/16;
926
927         err = w9968cf_write_reg(cam, 0xbf17, 0x00); /* reset everything */
928         err += w9968cf_write_reg(cam, 0xbf10, 0x00); /* normal operation */
929
930         /* Transfer size */
931         err += w9968cf_write_reg(cam, t_size & 0xffff, 0x3d); /* low bits */
932         err += w9968cf_write_reg(cam, t_size >> 16, 0x3e);    /* high bits */
933
934         if (cam->vpp_flag & VPP_DECOMPRESSION)
935                 err += w9968cf_upload_quantizationtables(cam);
936
937         vidcapt = w9968cf_read_reg(cam, 0x16); /* read picture settings */
938         err += w9968cf_write_reg(cam, vidcapt|0x8000, 0x16); /* capt. enable */
939
940         err += usb_set_interface(udev, 0, cam->altsetting);
941         err += w9968cf_write_reg(cam, 0x8a05, 0x3c); /* USB FIFO enable */
942
943         if (err || (vidcapt < 0)) {
944                 for (i = 0; i < W9968CF_URBS; i++)
945                         usb_free_urb(cam->urb[i]);
946                 DBG(1, "Couldn't tell the camera to start the data transfer")
947                 return err;
948         }
949
950         w9968cf_init_framelist(cam);
951
952         /* Begin to grab into the temporary buffer */
953         cam->frame_tmp.status = F_UNUSED;
954         cam->frame_tmp.queued = 0;
955         cam->frame_current = &cam->frame_tmp;
956
957         if (!(cam->vpp_flag & VPP_DECOMPRESSION))
958                 DBG(5, "Isochronous transfer size: %lu bytes/frame",
959                     (unsigned long)t_size*2)
960
961         DBG(5, "Starting the isochronous transfer...")
962
963         cam->streaming = 1;
964
965         /* Submit the URBs */
966         for (i = 0; i < W9968CF_URBS; i++) {
967                 err = usb_submit_urb(cam->urb[i], GFP_KERNEL);
968                 if (err) {
969                         cam->streaming = 0;
970                         for (j = i-1; j >= 0; j--) {
971                                 usb_kill_urb(cam->urb[j]);
972                                 usb_free_urb(cam->urb[j]);
973                         }
974                         DBG(1, "Couldn't send a transfer request to the "
975                                "USB core (error #%d, %s)", err,
976                             symbolic(urb_errlist, err))
977                         return err;
978                 }
979         }
980
981         return 0;
982 }
983
984
985 /*--------------------------------------------------------------------------
986   Stop the isochronous transfer and set alternate setting to 0 (0Mb/s).
987   Return 0 on success, a negative number otherwise.
988   --------------------------------------------------------------------------*/
989 static int w9968cf_stop_transfer(struct w9968cf_device* cam)
990 {
991         struct usb_device *udev = cam->usbdev;
992         unsigned long lock_flags;
993         int err = 0;
994         s8 i;
995
996         if (!cam->streaming)
997                 return 0;
998
999         /* This avoids race conditions with usb_submit_urb()
1000            in the URB completition handler */
1001         spin_lock_irqsave(&cam->urb_lock, lock_flags);
1002         cam->streaming = 0;
1003         spin_unlock_irqrestore(&cam->urb_lock, lock_flags);
1004
1005         for (i = W9968CF_URBS-1; i >= 0; i--)
1006                 if (cam->urb[i]) {
1007                         usb_kill_urb(cam->urb[i]);
1008                         usb_free_urb(cam->urb[i]);
1009                         cam->urb[i] = NULL;
1010                 }
1011
1012         if (cam->disconnected)
1013                 goto exit;
1014
1015         err = w9968cf_write_reg(cam, 0x0a05, 0x3c); /* stop USB transfer */
1016         err += usb_set_interface(udev, 0, 0); /* 0 Mb/s */
1017         err += w9968cf_write_reg(cam, 0x0000, 0x39); /* disable JPEG encoder */
1018         err += w9968cf_write_reg(cam, 0x0000, 0x16); /* stop video capture */
1019
1020         if (err) {
1021                 DBG(2, "Failed to tell the camera to stop the isochronous "
1022                        "transfer. However this is not a critical error.")
1023                 return -EIO;
1024         }
1025
1026 exit:
1027         DBG(5, "Isochronous transfer stopped")
1028         return 0;
1029 }
1030
1031
1032 /*--------------------------------------------------------------------------
1033   Write a W9968CF register.
1034   Return 0 on success, -1 otherwise.
1035   --------------------------------------------------------------------------*/
1036 static int w9968cf_write_reg(struct w9968cf_device* cam, u16 value, u16 index)
1037 {
1038         struct usb_device* udev = cam->usbdev;
1039         int res;
1040
1041         res = usb_control_msg(udev, usb_sndctrlpipe(udev, 0), 0,
1042                               USB_TYPE_VENDOR | USB_DIR_OUT | USB_RECIP_DEVICE,
1043                               value, index, NULL, 0, W9968CF_USB_CTRL_TIMEOUT);
1044
1045         if (res < 0)
1046                 DBG(4, "Failed to write a register "
1047                        "(value 0x%04X, index 0x%02X, error #%d, %s)",
1048                     value, index, res, symbolic(urb_errlist, res))
1049
1050         return (res >= 0) ? 0 : -1;
1051 }
1052
1053
1054 /*--------------------------------------------------------------------------
1055   Read a W9968CF register.
1056   Return the register value on success, -1 otherwise.
1057   --------------------------------------------------------------------------*/
1058 static int w9968cf_read_reg(struct w9968cf_device* cam, u16 index)
1059 {
1060         struct usb_device* udev = cam->usbdev;
1061         u16* buff = cam->control_buffer;
1062         int res;
1063
1064         res = usb_control_msg(udev, usb_rcvctrlpipe(udev, 0), 1,
1065                               USB_DIR_IN | USB_TYPE_VENDOR | USB_RECIP_DEVICE,
1066                               0, index, buff, 2, W9968CF_USB_CTRL_TIMEOUT);
1067
1068         if (res < 0)
1069                 DBG(4, "Failed to read a register "
1070                        "(index 0x%02X, error #%d, %s)",
1071                     index, res, symbolic(urb_errlist, res))
1072
1073         return (res >= 0) ? (int)(*buff) : -1;
1074 }
1075
1076
1077 /*--------------------------------------------------------------------------
1078   Write 64-bit data to the fast serial bus registers.
1079   Return 0 on success, -1 otherwise.
1080   --------------------------------------------------------------------------*/
1081 static int w9968cf_write_fsb(struct w9968cf_device* cam, u16* data)
1082 {
1083         struct usb_device* udev = cam->usbdev;
1084         u16 value;
1085         int res;
1086
1087         value = *data++;
1088
1089         res = usb_control_msg(udev, usb_sndctrlpipe(udev, 0), 0,
1090                               USB_TYPE_VENDOR | USB_DIR_OUT | USB_RECIP_DEVICE,
1091                               value, 0x06, data, 6, W9968CF_USB_CTRL_TIMEOUT);
1092
1093         if (res < 0)
1094                 DBG(4, "Failed to write the FSB registers "
1095                        "(error #%d, %s)", res, symbolic(urb_errlist, res))
1096
1097         return (res >= 0) ? 0 : -1;
1098 }
1099
1100
1101 /*--------------------------------------------------------------------------
1102   Write data to the serial bus control register.
1103   Return 0 on success, a negative number otherwise.
1104   --------------------------------------------------------------------------*/
1105 static int w9968cf_write_sb(struct w9968cf_device* cam, u16 value)
1106 {
1107         int err = 0;
1108
1109         err = w9968cf_write_reg(cam, value, 0x01);
1110         udelay(W9968CF_I2C_BUS_DELAY);
1111
1112         return err;
1113 }
1114
1115
1116 /*--------------------------------------------------------------------------
1117   Read data from the serial bus control register.
1118   Return 0 on success, a negative number otherwise.
1119   --------------------------------------------------------------------------*/
1120 static int w9968cf_read_sb(struct w9968cf_device* cam)
1121 {
1122         int v = 0;
1123
1124         v = w9968cf_read_reg(cam, 0x01);
1125         udelay(W9968CF_I2C_BUS_DELAY);
1126
1127         return v;
1128 }
1129
1130
1131 /*--------------------------------------------------------------------------
1132   Upload quantization tables for the JPEG compression.
1133   This function is called by w9968cf_start_transfer().
1134   Return 0 on success, a negative number otherwise.
1135   --------------------------------------------------------------------------*/
1136 static int w9968cf_upload_quantizationtables(struct w9968cf_device* cam)
1137 {
1138         u16 a, b;
1139         int err = 0, i, j;
1140
1141         err += w9968cf_write_reg(cam, 0x0010, 0x39); /* JPEG clock enable */
1142
1143         for (i = 0, j = 0; i < 32; i++, j += 2) {
1144                 a = Y_QUANTABLE[j] | ((unsigned)(Y_QUANTABLE[j+1]) << 8);
1145                 b = UV_QUANTABLE[j] | ((unsigned)(UV_QUANTABLE[j+1]) << 8);
1146                 err += w9968cf_write_reg(cam, a, 0x40+i);
1147                 err += w9968cf_write_reg(cam, b, 0x60+i);
1148         }
1149         err += w9968cf_write_reg(cam, 0x0012, 0x39); /* JPEG encoder enable */
1150
1151         return err;
1152 }
1153
1154
1155
1156 /****************************************************************************
1157  * Low-level I2C I/O functions.                                             *
1158  * The adapter supports the following I2C transfer functions:               *
1159  * i2c_adap_fastwrite_byte_data() (at 400 kHz bit frequency only)           *
1160  * i2c_adap_read_byte_data()                                                *
1161  * i2c_adap_read_byte()                                                     *
1162  ****************************************************************************/
1163
1164 static int w9968cf_smbus_start(struct w9968cf_device* cam)
1165 {
1166         int err = 0;
1167
1168         err += w9968cf_write_sb(cam, 0x0011); /* SDE=1, SDA=0, SCL=1 */
1169         err += w9968cf_write_sb(cam, 0x0010); /* SDE=1, SDA=0, SCL=0 */
1170
1171         return err;
1172 }
1173
1174
1175 static int w9968cf_smbus_stop(struct w9968cf_device* cam)
1176 {
1177         int err = 0;
1178
1179         err += w9968cf_write_sb(cam, 0x0011); /* SDE=1, SDA=0, SCL=1 */
1180         err += w9968cf_write_sb(cam, 0x0013); /* SDE=1, SDA=1, SCL=1 */
1181
1182         return err;
1183 }
1184
1185
1186 static int w9968cf_smbus_write_byte(struct w9968cf_device* cam, u8 v)
1187 {
1188         u8 bit;
1189         int err = 0, sda;
1190
1191         for (bit = 0 ; bit < 8 ; bit++) {
1192                 sda = (v & 0x80) ? 2 : 0;
1193                 v <<= 1;
1194                 /* SDE=1, SDA=sda, SCL=0 */
1195                 err += w9968cf_write_sb(cam, 0x10 | sda);
1196                 /* SDE=1, SDA=sda, SCL=1 */
1197                 err += w9968cf_write_sb(cam, 0x11 | sda);
1198                 /* SDE=1, SDA=sda, SCL=0 */
1199                 err += w9968cf_write_sb(cam, 0x10 | sda);
1200         }
1201
1202         return err;
1203 }
1204
1205
1206 static int w9968cf_smbus_read_byte(struct w9968cf_device* cam, u8* v)
1207 {
1208         u8 bit;
1209         int err = 0;
1210
1211         *v = 0;
1212         for (bit = 0 ; bit < 8 ; bit++) {
1213                 *v <<= 1;
1214                 err += w9968cf_write_sb(cam, 0x0013);
1215                 *v |= (w9968cf_read_sb(cam) & 0x0008) ? 1 : 0;
1216                 err += w9968cf_write_sb(cam, 0x0012);
1217         }
1218
1219         return err;
1220 }
1221
1222
1223 static int w9968cf_smbus_write_ack(struct w9968cf_device* cam)
1224 {
1225         int err = 0;
1226
1227         err += w9968cf_write_sb(cam, 0x0010); /* SDE=1, SDA=0, SCL=0 */
1228         err += w9968cf_write_sb(cam, 0x0011); /* SDE=1, SDA=0, SCL=1 */
1229         err += w9968cf_write_sb(cam, 0x0010); /* SDE=1, SDA=0, SCL=0 */
1230
1231         return err;
1232 }
1233
1234
1235 static int w9968cf_smbus_read_ack(struct w9968cf_device* cam)
1236 {
1237         int err = 0, sda;
1238
1239         err += w9968cf_write_sb(cam, 0x0013); /* SDE=1, SDA=1, SCL=1 */
1240         sda = (w9968cf_read_sb(cam) & 0x08) ? 1 : 0; /* sda = SDA */
1241         err += w9968cf_write_sb(cam, 0x0012); /* SDE=1, SDA=1, SCL=0 */
1242         if (sda < 0)
1243                 err += sda;
1244         if (sda == 1) {
1245                 DBG(6, "Couldn't receive the ACK")
1246                 err += -1;
1247         }
1248
1249         return err;
1250 }
1251
1252
1253 /* This seems to refresh the communication through the serial bus */
1254 static int w9968cf_smbus_refresh_bus(struct w9968cf_device* cam)
1255 {
1256         int err = 0, j;
1257
1258         for (j = 1; j <= 10; j++) {
1259                 err = w9968cf_write_reg(cam, 0x0020, 0x01);
1260                 err += w9968cf_write_reg(cam, 0x0000, 0x01);
1261                 if (err)
1262                         break;
1263         }
1264
1265         return err;
1266 }
1267
1268
1269 /* SMBus protocol: S Addr Wr [A] Subaddr [A] Value [A] P */
1270 static int
1271 w9968cf_i2c_adap_fastwrite_byte_data(struct w9968cf_device* cam,
1272                                      u16 address, u8 subaddress,u8 value)
1273 {
1274         u16* data = cam->data_buffer;
1275         int err = 0;
1276
1277         err += w9968cf_smbus_refresh_bus(cam);
1278
1279         /* Enable SBUS outputs */
1280         err += w9968cf_write_sb(cam, 0x0020);
1281
1282         data[0] = 0x082f | ((address & 0x80) ? 0x1500 : 0x0);
1283         data[0] |= (address & 0x40) ? 0x4000 : 0x0;
1284         data[1] = 0x2082 | ((address & 0x40) ? 0x0005 : 0x0);
1285         data[1] |= (address & 0x20) ? 0x0150 : 0x0;
1286         data[1] |= (address & 0x10) ? 0x5400 : 0x0;
1287         data[2] = 0x8208 | ((address & 0x08) ? 0x0015 : 0x0);
1288         data[2] |= (address & 0x04) ? 0x0540 : 0x0;
1289         data[2] |= (address & 0x02) ? 0x5000 : 0x0;
1290         data[3] = 0x1d20 | ((address & 0x02) ? 0x0001 : 0x0);
1291         data[3] |= (address & 0x01) ? 0x0054 : 0x0;
1292
1293         err += w9968cf_write_fsb(cam, data);
1294
1295         data[0] = 0x8208 | ((subaddress & 0x80) ? 0x0015 : 0x0);
1296         data[0] |= (subaddress & 0x40) ? 0x0540 : 0x0;
1297         data[0] |= (subaddress & 0x20) ? 0x5000 : 0x0;
1298         data[1] = 0x0820 | ((subaddress & 0x20) ? 0x0001 : 0x0);
1299         data[1] |= (subaddress & 0x10) ? 0x0054 : 0x0;
1300         data[1] |= (subaddress & 0x08) ? 0x1500 : 0x0;
1301         data[1] |= (subaddress & 0x04) ? 0x4000 : 0x0;
1302         data[2] = 0x2082 | ((subaddress & 0x04) ? 0x0005 : 0x0);
1303         data[2] |= (subaddress & 0x02) ? 0x0150 : 0x0;
1304         data[2] |= (subaddress & 0x01) ? 0x5400 : 0x0;
1305         data[3] = 0x001d;
1306
1307         err += w9968cf_write_fsb(cam, data);
1308
1309         data[0] = 0x8208 | ((value & 0x80) ? 0x0015 : 0x0);
1310         data[0] |= (value & 0x40) ? 0x0540 : 0x0;
1311         data[0] |= (value & 0x20) ? 0x5000 : 0x0;
1312         data[1] = 0x0820 | ((value & 0x20) ? 0x0001 : 0x0);
1313         data[1] |= (value & 0x10) ? 0x0054 : 0x0;
1314         data[1] |= (value & 0x08) ? 0x1500 : 0x0;
1315         data[1] |= (value & 0x04) ? 0x4000 : 0x0;
1316         data[2] = 0x2082 | ((value & 0x04) ? 0x0005 : 0x0);
1317         data[2] |= (value & 0x02) ? 0x0150 : 0x0;
1318         data[2] |= (value & 0x01) ? 0x5400 : 0x0;
1319         data[3] = 0xfe1d;
1320
1321         err += w9968cf_write_fsb(cam, data);
1322
1323         /* Disable SBUS outputs */
1324         err += w9968cf_write_sb(cam, 0x0000);
1325
1326         if (!err)
1327                 DBG(5, "I2C write byte data done, addr.0x%04X, subaddr.0x%02X "
1328                        "value 0x%02X", address, subaddress, value)
1329         else
1330                 DBG(5, "I2C write byte data failed, addr.0x%04X, "
1331                        "subaddr.0x%02X, value 0x%02X",
1332                     address, subaddress, value)
1333
1334         return err;
1335 }
1336
1337
1338 /* SMBus protocol: S Addr Wr [A] Subaddr [A] P S Addr+1 Rd [A] [Value] NA P */
1339 static int
1340 w9968cf_i2c_adap_read_byte_data(struct w9968cf_device* cam,
1341                                 u16 address, u8 subaddress,
1342                                 u8* value)
1343 {
1344         int err = 0;
1345
1346         /* Serial data enable */
1347         err += w9968cf_write_sb(cam, 0x0013); /* don't change ! */
1348
1349         err += w9968cf_smbus_start(cam);
1350         err += w9968cf_smbus_write_byte(cam, address);
1351         err += w9968cf_smbus_read_ack(cam);
1352         err += w9968cf_smbus_write_byte(cam, subaddress);
1353         err += w9968cf_smbus_read_ack(cam);
1354         err += w9968cf_smbus_stop(cam);
1355         err += w9968cf_smbus_start(cam);
1356         err += w9968cf_smbus_write_byte(cam, address + 1);
1357         err += w9968cf_smbus_read_ack(cam);
1358         err += w9968cf_smbus_read_byte(cam, value);
1359         err += w9968cf_smbus_write_ack(cam);
1360         err += w9968cf_smbus_stop(cam);
1361
1362         /* Serial data disable */
1363         err += w9968cf_write_sb(cam, 0x0000);
1364
1365         if (!err)
1366                 DBG(5, "I2C read byte data done, addr.0x%04X, "
1367                        "subaddr.0x%02X, value 0x%02X",
1368                     address, subaddress, *value)
1369         else
1370                 DBG(5, "I2C read byte data failed, addr.0x%04X, "
1371                        "subaddr.0x%02X, wrong value 0x%02X",
1372                     address, subaddress, *value)
1373
1374         return err;
1375 }
1376
1377
1378 /* SMBus protocol: S Addr+1 Rd [A] [Value] NA P */
1379 static int
1380 w9968cf_i2c_adap_read_byte(struct w9968cf_device* cam,
1381                            u16 address, u8* value)
1382 {
1383         int err = 0;
1384
1385         /* Serial data enable */
1386         err += w9968cf_write_sb(cam, 0x0013);
1387
1388         err += w9968cf_smbus_start(cam);
1389         err += w9968cf_smbus_write_byte(cam, address + 1);
1390         err += w9968cf_smbus_read_ack(cam);
1391         err += w9968cf_smbus_read_byte(cam, value);
1392         err += w9968cf_smbus_write_ack(cam);
1393         err += w9968cf_smbus_stop(cam);
1394
1395         /* Serial data disable */
1396         err += w9968cf_write_sb(cam, 0x0000);
1397
1398         if (!err)
1399                 DBG(5, "I2C read byte done, addr.0x%04X, "
1400                        "value 0x%02X", address, *value)
1401         else
1402                 DBG(5, "I2C read byte failed, addr.0x%04X, "
1403                        "wrong value 0x%02X", address, *value)
1404
1405         return err;
1406 }
1407
1408
1409 /* SMBus protocol: S Addr Wr [A] Value [A] P */
1410 static int
1411 w9968cf_i2c_adap_write_byte(struct w9968cf_device* cam,
1412                             u16 address, u8 value)
1413 {
1414         DBG(4, "i2c_write_byte() is an unsupported transfer mode")
1415         return -EINVAL;
1416 }
1417
1418
1419
1420 /****************************************************************************
1421  * I2C interface to kernel                                                  *
1422  ****************************************************************************/
1423
1424 static int
1425 w9968cf_i2c_smbus_xfer(struct i2c_adapter *adapter, u16 addr,
1426                        unsigned short flags, char read_write, u8 command,
1427                        int size, union i2c_smbus_data *data)
1428 {
1429         struct v4l2_device *v4l2_dev = i2c_get_adapdata(adapter);
1430         struct w9968cf_device *cam = to_cam(v4l2_dev);
1431         u8 i;
1432         int err = 0;
1433
1434         if (size == I2C_SMBUS_BYTE) {
1435                 /* Why addr <<= 1? See OVXXX0_SID defines in ovcamchip.h */
1436                 addr <<= 1;
1437
1438                 if (read_write == I2C_SMBUS_WRITE)
1439                         err = w9968cf_i2c_adap_write_byte(cam, addr, command);
1440                 else if (read_write == I2C_SMBUS_READ)
1441                         for (i = 1; i <= W9968CF_I2C_RW_RETRIES; i++) {
1442                                 err = w9968cf_i2c_adap_read_byte(cam, addr,
1443                                                          &data->byte);
1444                                 if (err) {
1445                                         if (w9968cf_smbus_refresh_bus(cam)) {
1446                                                 err = -EIO;
1447                                                 break;
1448                                         }
1449                                 } else
1450                                         break;
1451                         }
1452         } else if (size == I2C_SMBUS_BYTE_DATA) {
1453                 addr <<= 1;
1454
1455                 if (read_write == I2C_SMBUS_WRITE)
1456                         err = w9968cf_i2c_adap_fastwrite_byte_data(cam, addr,
1457                                                           command, data->byte);
1458                 else if (read_write == I2C_SMBUS_READ) {
1459                         for (i = 1; i <= W9968CF_I2C_RW_RETRIES; i++) {
1460                                 err = w9968cf_i2c_adap_read_byte_data(cam,addr,
1461                                                          command, &data->byte);
1462                                 if (err) {
1463                                         if (w9968cf_smbus_refresh_bus(cam)) {
1464                                                 err = -EIO;
1465                                                 break;
1466                                         }
1467                                 } else
1468                                         break;
1469                         }
1470
1471                 } else
1472                         return -EINVAL;
1473
1474         } else {
1475                 DBG(4, "Unsupported I2C transfer mode (%d)", size)
1476                 return -EINVAL;
1477         }
1478         return err;
1479 }
1480
1481
1482 static u32 w9968cf_i2c_func(struct i2c_adapter* adap)
1483 {
1484         return I2C_FUNC_SMBUS_READ_BYTE |
1485                I2C_FUNC_SMBUS_READ_BYTE_DATA  |
1486                I2C_FUNC_SMBUS_WRITE_BYTE_DATA;
1487 }
1488
1489
1490 static int w9968cf_i2c_init(struct w9968cf_device* cam)
1491 {
1492         int err = 0;
1493
1494         static struct i2c_algorithm algo = {
1495                 .smbus_xfer =    w9968cf_i2c_smbus_xfer,
1496                 .functionality = w9968cf_i2c_func,
1497         };
1498
1499         static struct i2c_adapter adap = {
1500                 .id =                I2C_HW_SMBUS_W9968CF,
1501                 .owner =             THIS_MODULE,
1502                 .algo =              &algo,
1503         };
1504
1505         memcpy(&cam->i2c_adapter, &adap, sizeof(struct i2c_adapter));
1506         strcpy(cam->i2c_adapter.name, "w9968cf");
1507         cam->i2c_adapter.dev.parent = &cam->usbdev->dev;
1508         i2c_set_adapdata(&cam->i2c_adapter, &cam->v4l2_dev);
1509
1510         DBG(6, "Registering I2C adapter with kernel...")
1511
1512         err = i2c_add_adapter(&cam->i2c_adapter);
1513         if (err)
1514                 DBG(1, "Failed to register the I2C adapter")
1515         else
1516                 DBG(5, "I2C adapter registered")
1517
1518         return err;
1519 }
1520
1521
1522
1523 /****************************************************************************
1524  * Helper functions                                                         *
1525  ****************************************************************************/
1526
1527 /*--------------------------------------------------------------------------
1528   Turn on the LED on some webcams. A beep should be heard too.
1529   Return 0 on success, a negative number otherwise.
1530   --------------------------------------------------------------------------*/
1531 static int w9968cf_turn_on_led(struct w9968cf_device* cam)
1532 {
1533         int err = 0;
1534
1535         err += w9968cf_write_reg(cam, 0xff00, 0x00); /* power-down */
1536         err += w9968cf_write_reg(cam, 0xbf17, 0x00); /* reset everything */
1537         err += w9968cf_write_reg(cam, 0xbf10, 0x00); /* normal operation */
1538         err += w9968cf_write_reg(cam, 0x0010, 0x01); /* serial bus, SDS high */
1539         err += w9968cf_write_reg(cam, 0x0000, 0x01); /* serial bus, SDS low */
1540         err += w9968cf_write_reg(cam, 0x0010, 0x01); /* ..high 'beep-beep' */
1541
1542         if (err)
1543                 DBG(2, "Couldn't turn on the LED")
1544
1545         DBG(5, "LED turned on")
1546
1547         return err;
1548 }
1549
1550
1551 /*--------------------------------------------------------------------------
1552   Write some registers for the device initialization.
1553   This function is called once on open().
1554   Return 0 on success, a negative number otherwise.
1555   --------------------------------------------------------------------------*/
1556 static int w9968cf_init_chip(struct w9968cf_device* cam)
1557 {
1558         unsigned long hw_bufsize = cam->maxwidth*cam->maxheight*2,
1559                       y0 = 0x0000,
1560                       u0 = y0 + hw_bufsize/2,
1561                       v0 = u0 + hw_bufsize/4,
1562                       y1 = v0 + hw_bufsize/4,
1563                       u1 = y1 + hw_bufsize/2,
1564                       v1 = u1 + hw_bufsize/4;
1565         int err = 0;
1566
1567         err += w9968cf_write_reg(cam, 0xff00, 0x00); /* power off */
1568         err += w9968cf_write_reg(cam, 0xbf10, 0x00); /* power on */
1569
1570         err += w9968cf_write_reg(cam, 0x405d, 0x03); /* DRAM timings */
1571         err += w9968cf_write_reg(cam, 0x0030, 0x04); /* SDRAM timings */
1572
1573         err += w9968cf_write_reg(cam, y0 & 0xffff, 0x20); /* Y buf.0, low */
1574         err += w9968cf_write_reg(cam, y0 >> 16, 0x21);    /* Y buf.0, high */
1575         err += w9968cf_write_reg(cam, u0 & 0xffff, 0x24); /* U buf.0, low */
1576         err += w9968cf_write_reg(cam, u0 >> 16, 0x25);    /* U buf.0, high */
1577         err += w9968cf_write_reg(cam, v0 & 0xffff, 0x28); /* V buf.0, low */
1578         err += w9968cf_write_reg(cam, v0 >> 16, 0x29);    /* V buf.0, high */
1579
1580         err += w9968cf_write_reg(cam, y1 & 0xffff, 0x22); /* Y buf.1, low */
1581         err += w9968cf_write_reg(cam, y1 >> 16, 0x23);    /* Y buf.1, high */
1582         err += w9968cf_write_reg(cam, u1 & 0xffff, 0x26); /* U buf.1, low */
1583         err += w9968cf_write_reg(cam, u1 >> 16, 0x27);    /* U buf.1, high */
1584         err += w9968cf_write_reg(cam, v1 & 0xffff, 0x2a); /* V buf.1, low */
1585         err += w9968cf_write_reg(cam, v1 >> 16, 0x2b);    /* V buf.1, high */
1586
1587         err += w9968cf_write_reg(cam, y1 & 0xffff, 0x32); /* JPEG buf 0 low */
1588         err += w9968cf_write_reg(cam, y1 >> 16, 0x33);    /* JPEG buf 0 high */
1589
1590         err += w9968cf_write_reg(cam, y1 & 0xffff, 0x34); /* JPEG buf 1 low */
1591         err += w9968cf_write_reg(cam, y1 >> 16, 0x35);    /* JPEG bug 1 high */
1592
1593         err += w9968cf_write_reg(cam, 0x0000, 0x36);/* JPEG restart interval */
1594         err += w9968cf_write_reg(cam, 0x0804, 0x37);/*JPEG VLE FIFO threshold*/
1595         err += w9968cf_write_reg(cam, 0x0000, 0x38);/* disable hw up-scaling */
1596         err += w9968cf_write_reg(cam, 0x0000, 0x3f); /* JPEG/MCTL test data */
1597
1598         err += w9968cf_set_picture(cam, cam->picture); /* this before */
1599         err += w9968cf_set_window(cam, cam->window);
1600
1601         if (err)
1602                 DBG(1, "Chip initialization failed")
1603         else
1604                 DBG(5, "Chip successfully initialized")
1605
1606         return err;
1607 }
1608
1609
1610 /*--------------------------------------------------------------------------
1611   Return non-zero if the palette is supported, 0 otherwise.
1612   --------------------------------------------------------------------------*/
1613 static inline u16 w9968cf_valid_palette(u16 palette)
1614 {
1615         u8 i = 0;
1616         while (w9968cf_formatlist[i].palette != 0) {
1617                 if (palette == w9968cf_formatlist[i].palette)
1618                         return palette;
1619                 i++;
1620         }
1621         return 0;
1622 }
1623
1624
1625 /*--------------------------------------------------------------------------
1626   Return the depth corresponding to the given palette.
1627   Palette _must_ be supported !
1628   --------------------------------------------------------------------------*/
1629 static inline u16 w9968cf_valid_depth(u16 palette)
1630 {
1631         u8 i=0;
1632         while (w9968cf_formatlist[i].palette != palette)
1633                 i++;
1634
1635         return w9968cf_formatlist[i].depth;
1636 }
1637
1638
1639 /*--------------------------------------------------------------------------
1640   Return non-zero if the format requires decompression, 0 otherwise.
1641   --------------------------------------------------------------------------*/
1642 static inline u8 w9968cf_need_decompression(u16 palette)
1643 {
1644         u8 i = 0;
1645         while (w9968cf_formatlist[i].palette != 0) {
1646                 if (palette == w9968cf_formatlist[i].palette)
1647                         return w9968cf_formatlist[i].compression;
1648                 i++;
1649         }
1650         return 0;
1651 }
1652
1653
1654 /*--------------------------------------------------------------------------
1655   Change the picture settings of the camera.
1656   Return 0 on success, a negative number otherwise.
1657   --------------------------------------------------------------------------*/
1658 static int
1659 w9968cf_set_picture(struct w9968cf_device* cam, struct video_picture pict)
1660 {
1661         u16 fmt, hw_depth, hw_palette, reg_v = 0x0000;
1662         int err = 0;
1663
1664         /* Make sure we are using a valid depth */
1665         pict.depth = w9968cf_valid_depth(pict.palette);
1666
1667         fmt = pict.palette;
1668
1669         hw_depth = pict.depth; /* depth used by the winbond chip */
1670         hw_palette = pict.palette; /* palette used by the winbond chip */
1671
1672         /* VS & HS polarities */
1673         reg_v = (cam->vs_polarity << 12) | (cam->hs_polarity << 11);
1674
1675         switch (fmt)
1676         {
1677                 case VIDEO_PALETTE_UYVY:
1678                         reg_v |= 0x0000;
1679                         cam->vpp_flag = VPP_NONE;
1680                         break;
1681                 case VIDEO_PALETTE_YUV422P:
1682                         reg_v |= 0x0002;
1683                         cam->vpp_flag = VPP_DECOMPRESSION;
1684                         break;
1685                 case VIDEO_PALETTE_YUV420:
1686                 case VIDEO_PALETTE_YUV420P:
1687                         reg_v |= 0x0003;
1688                         cam->vpp_flag = VPP_DECOMPRESSION;
1689                         break;
1690                 case VIDEO_PALETTE_YUYV:
1691                 case VIDEO_PALETTE_YUV422:
1692                         reg_v |= 0x0000;
1693                         cam->vpp_flag = VPP_SWAP_YUV_BYTES;
1694                         hw_palette = VIDEO_PALETTE_UYVY;
1695                         break;
1696                 /* Original video is used instead of RGBX palettes.
1697                    Software conversion later. */
1698                 case VIDEO_PALETTE_GREY:
1699                 case VIDEO_PALETTE_RGB555:
1700                 case VIDEO_PALETTE_RGB565:
1701                 case VIDEO_PALETTE_RGB24:
1702                 case VIDEO_PALETTE_RGB32:
1703                         reg_v |= 0x0000; /* UYVY 16 bit is used */
1704                         hw_depth = 16;
1705                         hw_palette = VIDEO_PALETTE_UYVY;
1706                         cam->vpp_flag = VPP_UYVY_TO_RGBX;
1707                         break;
1708         }
1709
1710         /* NOTE: due to memory issues, it is better to disable the hardware
1711                  double buffering during compression */
1712         if (cam->double_buffer && !(cam->vpp_flag & VPP_DECOMPRESSION))
1713                 reg_v |= 0x0080;
1714
1715         if (cam->clamping)
1716                 reg_v |= 0x0020;
1717
1718         if (cam->filter_type == 1)
1719                 reg_v |= 0x0008;
1720         else if (cam->filter_type == 2)
1721                 reg_v |= 0x000c;
1722
1723         if ((err = w9968cf_write_reg(cam, reg_v, 0x16)))
1724                 goto error;
1725
1726         if ((err = w9968cf_sensor_update_picture(cam, pict)))
1727                 goto error;
1728
1729         /* If all went well, update the device data structure */
1730         memcpy(&cam->picture, &pict, sizeof(pict));
1731         cam->hw_depth = hw_depth;
1732         cam->hw_palette = hw_palette;
1733
1734         /* Settings changed, so we clear the frame buffers */
1735         memset(cam->frame[0].buffer, 0, cam->nbuffers*cam->frame[0].size);
1736
1737         DBG(4, "Palette is %s, depth is %u bpp",
1738             symbolic(v4l1_plist, pict.palette), pict.depth)
1739
1740         return 0;
1741
1742 error:
1743         DBG(1, "Failed to change picture settings")
1744         return err;
1745 }
1746
1747
1748 /*--------------------------------------------------------------------------
1749   Change the capture area size of the camera.
1750   This function _must_ be called _after_ w9968cf_set_picture().
1751   Return 0 on success, a negative number otherwise.
1752   --------------------------------------------------------------------------*/
1753 static int
1754 w9968cf_set_window(struct w9968cf_device* cam, struct video_window win)
1755 {
1756         u16 x, y, w, h, scx, scy, cw, ch, ax, ay;
1757         unsigned long fw, fh;
1758         struct ovcamchip_window s_win;
1759         int err = 0;
1760
1761         /* Work around to avoid FP arithmetics */
1762         #define SC(x) ((x) << 10)
1763         #define UNSC(x) ((x) >> 10)
1764
1765         /* Make sure we are using a supported resolution */
1766         if ((err = w9968cf_adjust_window_size(cam, &win.width, &win.height)))
1767                 goto error;
1768
1769         /* Scaling factors */
1770         fw = SC(win.width) / cam->maxwidth;
1771         fh = SC(win.height) / cam->maxheight;
1772
1773         /* Set up the width and height values used by the chip */
1774         if ((win.width > cam->maxwidth) || (win.height > cam->maxheight)) {
1775                 cam->vpp_flag |= VPP_UPSCALE;
1776                 /* Calculate largest w,h mantaining the same w/h ratio */
1777                 w = (fw >= fh) ? cam->maxwidth : SC(win.width)/fh;
1778                 h = (fw >= fh) ? SC(win.height)/fw : cam->maxheight;
1779                 if (w < cam->minwidth) /* just in case */
1780                         w = cam->minwidth;
1781                 if (h < cam->minheight) /* just in case */
1782                         h = cam->minheight;
1783         } else {
1784                 cam->vpp_flag &= ~VPP_UPSCALE;
1785                 w = win.width;
1786                 h = win.height;
1787         }
1788
1789         /* x,y offsets of the cropped area */
1790         scx = cam->start_cropx;
1791         scy = cam->start_cropy;
1792
1793         /* Calculate cropped area manteining the right w/h ratio */
1794         if (cam->largeview && !(cam->vpp_flag & VPP_UPSCALE)) {
1795                 cw = (fw >= fh) ? cam->maxwidth : SC(win.width)/fh;
1796                 ch = (fw >= fh) ? SC(win.height)/fw : cam->maxheight;
1797         } else {
1798                 cw = w;
1799                 ch = h;
1800         }
1801
1802         /* Setup the window of the sensor */
1803         s_win.format = VIDEO_PALETTE_UYVY;
1804         s_win.width = cam->maxwidth;
1805         s_win.height = cam->maxheight;
1806         s_win.quarter = 0; /* full progressive video */
1807
1808         /* Center it */
1809         s_win.x = (s_win.width - cw) / 2;
1810         s_win.y = (s_win.height - ch) / 2;
1811
1812         /* Clock divisor */
1813         if (cam->clockdiv >= 0)
1814                 s_win.clockdiv = cam->clockdiv; /* manual override */
1815         else
1816                 switch (cam->sensor) {
1817                         case CC_OV6620:
1818                                 s_win.clockdiv = 0;
1819                                 break;
1820                         case CC_OV6630:
1821                                 s_win.clockdiv = 0;
1822                                 break;
1823                         case CC_OV76BE:
1824                         case CC_OV7610:
1825                         case CC_OV7620:
1826                                 s_win.clockdiv = 0;
1827                                 break;
1828                         default:
1829                                 s_win.clockdiv = W9968CF_DEF_CLOCKDIVISOR;
1830                 }
1831
1832         /* We have to scale win.x and win.y offsets */
1833         if ( (cam->largeview && !(cam->vpp_flag & VPP_UPSCALE))
1834              || (cam->vpp_flag & VPP_UPSCALE) ) {
1835                 ax = SC(win.x)/fw;
1836                 ay = SC(win.y)/fh;
1837         } else {
1838                 ax = win.x;
1839                 ay = win.y;
1840         }
1841
1842         if ((ax + cw) > cam->maxwidth)
1843                 ax = cam->maxwidth - cw;
1844
1845         if ((ay + ch) > cam->maxheight)
1846                 ay = cam->maxheight - ch;
1847
1848         /* Adjust win.x, win.y */
1849         if ( (cam->largeview && !(cam->vpp_flag & VPP_UPSCALE))
1850              || (cam->vpp_flag & VPP_UPSCALE) ) {
1851                 win.x = UNSC(ax*fw);
1852                 win.y = UNSC(ay*fh);
1853         } else {
1854                 win.x = ax;
1855                 win.y = ay;
1856         }
1857
1858         /* Offsets used by the chip */
1859         x = ax + s_win.x;
1860         y = ay + s_win.y;
1861
1862         /* Go ! */
1863         if ((err = w9968cf_sensor_cmd(cam, OVCAMCHIP_CMD_S_MODE, &s_win)))
1864                 goto error;
1865
1866         err += w9968cf_write_reg(cam, scx + x, 0x10);
1867         err += w9968cf_write_reg(cam, scy + y, 0x11);
1868         err += w9968cf_write_reg(cam, scx + x + cw, 0x12);
1869         err += w9968cf_write_reg(cam, scy + y + ch, 0x13);
1870         err += w9968cf_write_reg(cam, w, 0x14);
1871         err += w9968cf_write_reg(cam, h, 0x15);
1872
1873         /* JPEG width & height */
1874         err += w9968cf_write_reg(cam, w, 0x30);
1875         err += w9968cf_write_reg(cam, h, 0x31);
1876
1877         /* Y & UV frame buffer strides (in WORD) */
1878         if (cam->vpp_flag & VPP_DECOMPRESSION) {
1879                 err += w9968cf_write_reg(cam, w/2, 0x2c);
1880                 err += w9968cf_write_reg(cam, w/4, 0x2d);
1881         } else
1882                 err += w9968cf_write_reg(cam, w, 0x2c);
1883
1884         if (err)
1885                 goto error;
1886
1887         /* If all went well, update the device data structure */
1888         memcpy(&cam->window, &win, sizeof(win));
1889         cam->hw_width = w;
1890         cam->hw_height = h;
1891
1892         /* Settings changed, so we clear the frame buffers */
1893         memset(cam->frame[0].buffer, 0, cam->nbuffers*cam->frame[0].size);
1894
1895         DBG(4, "The capture area is %dx%d, Offset (x,y)=(%u,%u)",
1896             win.width, win.height, win.x, win.y)
1897
1898         PDBGG("x=%u ,y=%u, w=%u, h=%u, ax=%u, ay=%u, s_win.x=%u, s_win.y=%u, "
1899               "cw=%u, ch=%u, win.x=%u, win.y=%u, win.width=%u, win.height=%u",
1900               x, y, w, h, ax, ay, s_win.x, s_win.y, cw, ch, win.x, win.y,
1901               win.width, win.height)
1902
1903         return 0;
1904
1905 error:
1906         DBG(1, "Failed to change the capture area size")
1907         return err;
1908 }
1909
1910
1911 /*--------------------------------------------------------------------------
1912   Adjust the asked values for window width and height.
1913   Return 0 on success, -1 otherwise.
1914   --------------------------------------------------------------------------*/
1915 static int
1916 w9968cf_adjust_window_size(struct w9968cf_device *cam, u32 *width, u32 *height)
1917 {
1918         unsigned int maxw, maxh, align;
1919
1920         maxw = cam->upscaling && !(cam->vpp_flag & VPP_DECOMPRESSION) &&
1921                w9968cf_vpp ? max((u16)W9968CF_MAX_WIDTH, cam->maxwidth)
1922                            : cam->maxwidth;
1923         maxh = cam->upscaling && !(cam->vpp_flag & VPP_DECOMPRESSION) &&
1924                w9968cf_vpp ? max((u16)W9968CF_MAX_HEIGHT, cam->maxheight)
1925                            : cam->maxheight;
1926         align = (cam->vpp_flag & VPP_DECOMPRESSION) ? 4 : 0;
1927
1928         v4l_bound_align_image(width, cam->minwidth, maxw, align,
1929                               height, cam->minheight, maxh, align, 0);
1930
1931         PDBGG("Window size adjusted w=%u, h=%u ", *width, *height)
1932
1933         return 0;
1934 }
1935
1936
1937 /*--------------------------------------------------------------------------
1938   Initialize the FIFO list of requested frames.
1939   --------------------------------------------------------------------------*/
1940 static void w9968cf_init_framelist(struct w9968cf_device* cam)
1941 {
1942         u8 i;
1943
1944         for (i = 0; i < cam->nbuffers; i++) {
1945                 cam->requested_frame[i] = NULL;
1946                 cam->frame[i].queued = 0;
1947                 cam->frame[i].status = F_UNUSED;
1948         }
1949 }
1950
1951
1952 /*--------------------------------------------------------------------------
1953   Add a frame in the FIFO list of requested frames.
1954   This function is called in process context.
1955   --------------------------------------------------------------------------*/
1956 static void w9968cf_push_frame(struct w9968cf_device* cam, u8 f_num)
1957 {
1958         u8 f;
1959         unsigned long lock_flags;
1960
1961         spin_lock_irqsave(&cam->flist_lock, lock_flags);
1962
1963         for (f=0; cam->requested_frame[f] != NULL; f++);
1964         cam->requested_frame[f] = &cam->frame[f_num];
1965         cam->frame[f_num].queued = 1;
1966         cam->frame[f_num].status = F_UNUSED; /* clear the status */
1967
1968         spin_unlock_irqrestore(&cam->flist_lock, lock_flags);
1969
1970         DBG(6, "Frame #%u pushed into the FIFO list. Position %u", f_num, f)
1971 }
1972
1973
1974 /*--------------------------------------------------------------------------
1975   Read, store and remove the first pointer in the FIFO list of requested
1976   frames. This function is called in interrupt context.
1977   --------------------------------------------------------------------------*/
1978 static void
1979 w9968cf_pop_frame(struct w9968cf_device* cam, struct w9968cf_frame_t** framep)
1980 {
1981         u8 i;
1982
1983         spin_lock(&cam->flist_lock);
1984
1985         *framep = cam->requested_frame[0];
1986
1987         /* Shift the list of pointers */
1988         for (i = 0; i < cam->nbuffers-1; i++)
1989                 cam->requested_frame[i] = cam->requested_frame[i+1];
1990         cam->requested_frame[i] = NULL;
1991
1992         spin_unlock(&cam->flist_lock);
1993
1994         DBG(6,"Popped frame #%d from the list", (*framep)->number)
1995 }
1996
1997
1998 /*--------------------------------------------------------------------------
1999   High-level video post-processing routine on grabbed frames.
2000   Return 0 on success, a negative number otherwise.
2001   --------------------------------------------------------------------------*/
2002 static int
2003 w9968cf_postprocess_frame(struct w9968cf_device* cam,
2004                           struct w9968cf_frame_t* fr)
2005 {
2006         void *pIn = fr->buffer, *pOut = cam->frame_vpp.buffer, *tmp;
2007         u16 w = cam->window.width,
2008             h = cam->window.height,
2009             d = cam->picture.depth,
2010             fmt = cam->picture.palette,
2011             rgb = cam->force_rgb,
2012             hw_w = cam->hw_width,
2013             hw_h = cam->hw_height,
2014             hw_d = cam->hw_depth;
2015         int err = 0;
2016
2017         #define _PSWAP(pIn, pOut) {tmp = (pIn); (pIn) = (pOut); (pOut) = tmp;}
2018
2019         if (cam->vpp_flag & VPP_DECOMPRESSION) {
2020                 memcpy(pOut, pIn, fr->length);
2021                 _PSWAP(pIn, pOut)
2022                 err = w9968cf_vpp->decode(pIn, fr->length, hw_w, hw_h, pOut);
2023                 PDBGG("Compressed frame length: %lu",(unsigned long)fr->length)
2024                 fr->length = (hw_w*hw_h*hw_d)/8;
2025                 _PSWAP(pIn, pOut)
2026                 if (err) {
2027                         DBG(4, "An error occurred while decoding the frame: "
2028                                "%s", symbolic(decoder_errlist, err))
2029                         return err;
2030                 } else
2031                         DBG(6, "Frame decoded")
2032         }
2033
2034         if (cam->vpp_flag & VPP_SWAP_YUV_BYTES) {
2035                 w9968cf_vpp->swap_yuvbytes(pIn, fr->length);
2036                 DBG(6, "Original UYVY component ordering changed")
2037         }
2038
2039         if (cam->vpp_flag & VPP_UPSCALE) {
2040                 w9968cf_vpp->scale_up(pIn, pOut, hw_w, hw_h, hw_d, w, h);
2041                 fr->length = (w*h*hw_d)/8;
2042                 _PSWAP(pIn, pOut)
2043                 DBG(6, "Vertical up-scaling done: %u,%u,%ubpp->%u,%u",
2044                     hw_w, hw_h, hw_d, w, h)
2045         }
2046
2047         if (cam->vpp_flag & VPP_UYVY_TO_RGBX) {
2048                 w9968cf_vpp->uyvy_to_rgbx(pIn, fr->length, pOut, fmt, rgb);
2049                 fr->length = (w*h*d)/8;
2050                 _PSWAP(pIn, pOut)
2051                 DBG(6, "UYVY-16bit to %s conversion done",
2052                     symbolic(v4l1_plist, fmt))
2053         }
2054
2055         if (pOut == fr->buffer)
2056                 memcpy(fr->buffer, cam->frame_vpp.buffer, fr->length);
2057
2058         return 0;
2059 }
2060
2061
2062
2063 /****************************************************************************
2064  * Image sensor control routines                                            *
2065  ****************************************************************************/
2066
2067 static int
2068 w9968cf_sensor_set_control(struct w9968cf_device* cam, int cid, int val)
2069 {
2070         struct ovcamchip_control ctl;
2071         int err;
2072
2073         ctl.id = cid;
2074         ctl.value = val;
2075
2076         err = w9968cf_sensor_cmd(cam, OVCAMCHIP_CMD_S_CTRL, &ctl);
2077
2078         return err;
2079 }
2080
2081
2082 static int
2083 w9968cf_sensor_get_control(struct w9968cf_device* cam, int cid, int* val)
2084 {
2085         struct ovcamchip_control ctl;
2086         int err;
2087
2088         ctl.id = cid;
2089
2090         err = w9968cf_sensor_cmd(cam, OVCAMCHIP_CMD_G_CTRL, &ctl);
2091         if (!err)
2092                 *val = ctl.value;
2093
2094         return err;
2095 }
2096
2097
2098 static int
2099 w9968cf_sensor_cmd(struct w9968cf_device* cam, unsigned int cmd, void* arg)
2100 {
2101         int rc;
2102
2103         rc = v4l2_subdev_call(cam->sensor_sd, core, ioctl, cmd, arg);
2104         /* The I2C driver returns -EPERM on non-supported controls */
2105         return (rc < 0 && rc != -EPERM) ? rc : 0;
2106 }
2107
2108
2109 /*--------------------------------------------------------------------------
2110   Update some settings of the image sensor.
2111   Returns: 0 on success, a negative number otherwise.
2112   --------------------------------------------------------------------------*/
2113 static int w9968cf_sensor_update_settings(struct w9968cf_device* cam)
2114 {
2115         int err = 0;
2116
2117         /* Auto brightness */
2118         err = w9968cf_sensor_set_control(cam, OVCAMCHIP_CID_AUTOBRIGHT,
2119                                          cam->auto_brt);
2120         if (err)
2121                 return err;
2122
2123         /* Auto exposure */
2124         err = w9968cf_sensor_set_control(cam, OVCAMCHIP_CID_AUTOEXP,
2125                                          cam->auto_exp);
2126         if (err)
2127                 return err;
2128
2129         /* Banding filter */
2130         err = w9968cf_sensor_set_control(cam, OVCAMCHIP_CID_BANDFILT,
2131                                          cam->bandfilt);
2132         if (err)
2133                 return err;
2134
2135         /* Light frequency */
2136         err = w9968cf_sensor_set_control(cam, OVCAMCHIP_CID_FREQ,
2137                                          cam->lightfreq);
2138         if (err)
2139                 return err;
2140
2141         /* Back light */
2142         err = w9968cf_sensor_set_control(cam, OVCAMCHIP_CID_BACKLIGHT,
2143                                          cam->backlight);
2144         if (err)
2145                 return err;
2146
2147         /* Mirror */
2148         err = w9968cf_sensor_set_control(cam, OVCAMCHIP_CID_MIRROR,
2149                                          cam->mirror);
2150         if (err)
2151                 return err;
2152
2153         return 0;
2154 }
2155
2156
2157 /*--------------------------------------------------------------------------
2158   Get some current picture settings from the image sensor and update the
2159   internal 'picture' structure of the camera.
2160   Returns: 0 on success, a negative number otherwise.
2161   --------------------------------------------------------------------------*/
2162 static int w9968cf_sensor_get_picture(struct w9968cf_device* cam)
2163 {
2164         int err, v;
2165
2166         err = w9968cf_sensor_get_control(cam, OVCAMCHIP_CID_CONT, &v);
2167         if (err)
2168                 return err;
2169         cam->picture.contrast = v;
2170
2171         err = w9968cf_sensor_get_control(cam, OVCAMCHIP_CID_BRIGHT, &v);
2172         if (err)
2173                 return err;
2174         cam->picture.brightness = v;
2175
2176         err = w9968cf_sensor_get_control(cam, OVCAMCHIP_CID_SAT, &v);
2177         if (err)
2178                 return err;
2179         cam->picture.colour = v;
2180
2181         err = w9968cf_sensor_get_control(cam, OVCAMCHIP_CID_HUE, &v);
2182         if (err)
2183                 return err;
2184         cam->picture.hue = v;
2185
2186         DBG(5, "Got picture settings from the image sensor")
2187
2188         PDBGG("Brightness, contrast, hue, colour, whiteness are "
2189               "%u,%u,%u,%u,%u", cam->picture.brightness,cam->picture.contrast,
2190               cam->picture.hue, cam->picture.colour, cam->picture.whiteness)
2191
2192         return 0;
2193 }
2194
2195
2196 /*--------------------------------------------------------------------------
2197   Update picture settings of the image sensor.
2198   Returns: 0 on success, a negative number otherwise.
2199   --------------------------------------------------------------------------*/
2200 static int
2201 w9968cf_sensor_update_picture(struct w9968cf_device* cam,
2202                               struct video_picture pict)
2203 {
2204         int err = 0;
2205
2206         if ((!cam->sensor_initialized)
2207             || pict.contrast != cam->picture.contrast) {
2208                 err = w9968cf_sensor_set_control(cam, OVCAMCHIP_CID_CONT,
2209                                                  pict.contrast);
2210                 if (err)
2211                         goto fail;
2212                 DBG(4, "Contrast changed from %u to %u",
2213                     cam->picture.contrast, pict.contrast)
2214                 cam->picture.contrast = pict.contrast;
2215         }
2216
2217         if (((!cam->sensor_initialized) ||
2218             pict.brightness != cam->picture.brightness) && (!cam->auto_brt)) {
2219                 err = w9968cf_sensor_set_control(cam, OVCAMCHIP_CID_BRIGHT,
2220                                                  pict.brightness);
2221                 if (err)
2222                         goto fail;
2223                 DBG(4, "Brightness changed from %u to %u",
2224                     cam->picture.brightness, pict.brightness)
2225                 cam->picture.brightness = pict.brightness;
2226         }
2227
2228         if ((!cam->sensor_initialized) || pict.colour != cam->picture.colour) {
2229                 err = w9968cf_sensor_set_control(cam, OVCAMCHIP_CID_SAT,
2230                                                  pict.colour);
2231                 if (err)
2232                         goto fail;
2233                 DBG(4, "Colour changed from %u to %u",
2234                     cam->picture.colour, pict.colour)
2235                 cam->picture.colour = pict.colour;
2236         }
2237
2238         if ((!cam->sensor_initialized) || pict.hue != cam->picture.hue) {
2239                 err = w9968cf_sensor_set_control(cam, OVCAMCHIP_CID_HUE,
2240                                                  pict.hue);
2241                 if (err)
2242                         goto fail;
2243                 DBG(4, "Hue changed from %u to %u",
2244                     cam->picture.hue, pict.hue)
2245                 cam->picture.hue = pict.hue;
2246         }
2247
2248         return 0;
2249
2250 fail:
2251         DBG(4, "Failed to change sensor picture setting")
2252         return err;
2253 }
2254
2255
2256
2257 /****************************************************************************
2258  * Camera configuration                                                     *
2259  ****************************************************************************/
2260
2261 /*--------------------------------------------------------------------------
2262   This function is called when a supported image sensor is detected.
2263   Return 0 if the initialization succeeds, a negative number otherwise.
2264   --------------------------------------------------------------------------*/
2265 static int w9968cf_sensor_init(struct w9968cf_device* cam)
2266 {
2267         int err = 0;
2268
2269         if ((err = w9968cf_sensor_cmd(cam, OVCAMCHIP_CMD_INITIALIZE,
2270                                       &cam->monochrome)))
2271                 goto error;
2272
2273         if ((err = w9968cf_sensor_cmd(cam, OVCAMCHIP_CMD_Q_SUBTYPE,
2274                                       &cam->sensor)))
2275                 goto error;
2276
2277         /* NOTE: Make sure width and height are a multiple of 16 */
2278         switch (v4l2_i2c_subdev_addr(cam->sensor_sd)) {
2279                 case OV6xx0_SID:
2280                         cam->maxwidth = 352;
2281                         cam->maxheight = 288;
2282                         cam->minwidth = 64;
2283                         cam->minheight = 48;
2284                         break;
2285                 case OV7xx0_SID:
2286                         cam->maxwidth = 640;
2287                         cam->maxheight = 480;
2288                         cam->minwidth = 64;
2289                         cam->minheight = 48;
2290                         break;
2291                 default:
2292                         DBG(1, "Not supported image sensor detected for %s",
2293                             symbolic(camlist, cam->id))
2294                         return -EINVAL;
2295         }
2296
2297         /* These values depend on the ones in the ovxxx0.c sources */
2298         switch (cam->sensor) {
2299                 case CC_OV7620:
2300                         cam->start_cropx = 287;
2301                         cam->start_cropy = 35;
2302                         /* Seems to work around a bug in the image sensor */
2303                         cam->vs_polarity = 1;
2304                         cam->hs_polarity = 1;
2305                         break;
2306                 default:
2307                         cam->start_cropx = 320;
2308                         cam->start_cropy = 35;
2309                         cam->vs_polarity = 1;
2310                         cam->hs_polarity = 0;
2311         }
2312
2313         if ((err = w9968cf_sensor_update_settings(cam)))
2314                 goto error;
2315
2316         if ((err = w9968cf_sensor_update_picture(cam, cam->picture)))
2317                 goto error;
2318
2319         cam->sensor_initialized = 1;
2320
2321         DBG(2, "%s image sensor initialized", symbolic(senlist, cam->sensor))
2322         return 0;
2323
2324 error:
2325         cam->sensor_initialized = 0;
2326         cam->sensor = CC_UNKNOWN;
2327         DBG(1, "Image sensor initialization failed for %s (/dev/video%d). "
2328                "Try to detach and attach this device again",
2329             symbolic(camlist, cam->id), cam->v4ldev->num)
2330         return err;
2331 }
2332
2333
2334 /*--------------------------------------------------------------------------
2335   Fill some basic fields in the main device data structure.
2336   This function is called once on w9968cf_usb_probe() for each recognized
2337   camera.
2338   --------------------------------------------------------------------------*/
2339 static void
2340 w9968cf_configure_camera(struct w9968cf_device* cam,
2341                          struct usb_device* udev,
2342                          enum w9968cf_model_id mod_id,
2343                          const unsigned short dev_nr)
2344 {
2345         mutex_init(&cam->fileop_mutex);
2346         init_waitqueue_head(&cam->open);
2347         spin_lock_init(&cam->urb_lock);
2348         spin_lock_init(&cam->flist_lock);
2349
2350         cam->users = 0;
2351         cam->disconnected = 0;
2352         cam->id = mod_id;
2353         cam->sensor = CC_UNKNOWN;
2354         cam->sensor_initialized = 0;
2355
2356         /* Calculate the alternate setting number (from 1 to 16)
2357            according to the 'packet_size' module parameter */
2358         if (packet_size[dev_nr] < W9968CF_MIN_PACKET_SIZE)
2359                 packet_size[dev_nr] = W9968CF_MIN_PACKET_SIZE;
2360         for (cam->altsetting = 1;
2361              packet_size[dev_nr] < wMaxPacketSize[cam->altsetting-1];
2362              cam->altsetting++);
2363
2364         cam->max_buffers = (max_buffers[dev_nr] < 2 ||
2365                             max_buffers[dev_nr] > W9968CF_MAX_BUFFERS)
2366                            ? W9968CF_BUFFERS : (u8)max_buffers[dev_nr];
2367
2368         cam->double_buffer = (double_buffer[dev_nr] == 0 ||
2369                               double_buffer[dev_nr] == 1)
2370                              ? (u8)double_buffer[dev_nr]:W9968CF_DOUBLE_BUFFER;
2371
2372         cam->clamping = (clamping[dev_nr] == 0 || clamping[dev_nr] == 1)
2373                         ? (u8)clamping[dev_nr] : W9968CF_CLAMPING;
2374
2375         cam->filter_type = (filter_type[dev_nr] == 0 ||
2376                             filter_type[dev_nr] == 1 ||
2377                             filter_type[dev_nr] == 2)
2378                            ? (u8)filter_type[dev_nr] : W9968CF_FILTER_TYPE;
2379
2380         cam->capture = 1;
2381
2382         cam->largeview = (largeview[dev_nr] == 0 || largeview[dev_nr] == 1)
2383                          ? (u8)largeview[dev_nr] : W9968CF_LARGEVIEW;
2384
2385         cam->decompression = (decompression[dev_nr] == 0 ||
2386                               decompression[dev_nr] == 1 ||
2387                               decompression[dev_nr] == 2)
2388                              ? (u8)decompression[dev_nr]:W9968CF_DECOMPRESSION;
2389
2390         cam->upscaling = (upscaling[dev_nr] == 0 ||
2391                           upscaling[dev_nr] == 1)
2392                          ? (u8)upscaling[dev_nr] : W9968CF_UPSCALING;
2393
2394         cam->auto_brt = (autobright[dev_nr] == 0 || autobright[dev_nr] == 1)
2395                         ? (u8)autobright[dev_nr] : W9968CF_AUTOBRIGHT;
2396
2397         cam->auto_exp = (autoexp[dev_nr] == 0 || autoexp[dev_nr] == 1)
2398                         ? (u8)autoexp[dev_nr] : W9968CF_AUTOEXP;
2399
2400         cam->lightfreq = (lightfreq[dev_nr] == 50 || lightfreq[dev_nr] == 60)
2401                          ? (u8)lightfreq[dev_nr] : W9968CF_LIGHTFREQ;
2402
2403         cam->bandfilt = (bandingfilter[dev_nr] == 0 ||
2404                          bandingfilter[dev_nr] == 1)
2405                         ? (u8)bandingfilter[dev_nr] : W9968CF_BANDINGFILTER;
2406
2407         cam->backlight = (backlight[dev_nr] == 0 || backlight[dev_nr] == 1)
2408                          ? (u8)backlight[dev_nr] : W9968CF_BACKLIGHT;
2409
2410         cam->clockdiv = (clockdiv[dev_nr] == -1 || clockdiv[dev_nr] >= 0)
2411                         ? (s8)clockdiv[dev_nr] : W9968CF_CLOCKDIV;
2412
2413         cam->mirror = (mirror[dev_nr] == 0 || mirror[dev_nr] == 1)
2414                       ? (u8)mirror[dev_nr] : W9968CF_MIRROR;
2415
2416         cam->monochrome = (monochrome[dev_nr] == 0 || monochrome[dev_nr] == 1)
2417                           ? monochrome[dev_nr] : W9968CF_MONOCHROME;
2418
2419         cam->picture.brightness = (u16)brightness[dev_nr];
2420         cam->picture.hue = (u16)hue[dev_nr];
2421         cam->picture.colour = (u16)colour[dev_nr];
2422         cam->picture.contrast = (u16)contrast[dev_nr];
2423         cam->picture.whiteness = (u16)whiteness[dev_nr];
2424         if (w9968cf_valid_palette((u16)force_palette[dev_nr])) {
2425                 cam->picture.palette = (u16)force_palette[dev_nr];
2426                 cam->force_palette = 1;
2427         } else {
2428                 cam->force_palette = 0;
2429                 if (cam->decompression == 0)
2430                         cam->picture.palette = W9968CF_PALETTE_DECOMP_OFF;
2431                 else if (cam->decompression == 1)
2432                         cam->picture.palette = W9968CF_PALETTE_DECOMP_FORCE;
2433                 else
2434                         cam->picture.palette = W9968CF_PALETTE_DECOMP_ON;
2435         }
2436         cam->picture.depth = w9968cf_valid_depth(cam->picture.palette);
2437
2438         cam->force_rgb = (force_rgb[dev_nr] == 0 || force_rgb[dev_nr] == 1)
2439                          ? (u8)force_rgb[dev_nr] : W9968CF_FORCE_RGB;
2440
2441         cam->window.x = 0;
2442         cam->window.y = 0;
2443         cam->window.width = W9968CF_WIDTH;
2444         cam->window.height = W9968CF_HEIGHT;
2445         cam->window.chromakey = 0;
2446         cam->window.clipcount = 0;
2447         cam->window.flags = 0;
2448
2449         DBG(3, "%s configured with settings #%u:",
2450             symbolic(camlist, cam->id), dev_nr)
2451
2452         DBG(3, "- Data packet size for USB isochrnous transfer: %u bytes",
2453             wMaxPacketSize[cam->altsetting-1])
2454
2455         DBG(3, "- Number of requested video frame buffers: %u",
2456             cam->max_buffers)
2457
2458         if (cam->double_buffer)
2459                 DBG(3, "- Hardware double buffering enabled")
2460         else
2461                 DBG(3, "- Hardware double buffering disabled")
2462
2463         if (cam->filter_type == 0)
2464                 DBG(3, "- Video filtering disabled")
2465         else if (cam->filter_type == 1)
2466                 DBG(3, "- Video filtering enabled: type 1-2-1")
2467         else if (cam->filter_type == 2)
2468                 DBG(3, "- Video filtering enabled: type 2-3-6-3-2")
2469
2470         if (cam->clamping)
2471                 DBG(3, "- Video data clamping (CCIR-601 format) enabled")
2472         else
2473                 DBG(3, "- Video data clamping (CCIR-601 format) disabled")
2474
2475         if (cam->largeview)
2476                 DBG(3, "- Large view enabled")
2477         else
2478                 DBG(3, "- Large view disabled")
2479
2480         if ((cam->decompression) == 0 && (!cam->force_palette))
2481                 DBG(3, "- Decompression disabled")
2482         else if ((cam->decompression) == 1 && (!cam->force_palette))
2483                 DBG(3, "- Decompression forced")
2484         else if ((cam->decompression) == 2 && (!cam->force_palette))
2485                 DBG(3, "- Decompression allowed")
2486
2487         if (cam->upscaling)
2488                 DBG(3, "- Software image scaling enabled")
2489         else
2490                 DBG(3, "- Software image scaling disabled")
2491
2492         if (cam->force_palette)
2493                 DBG(3, "- Image palette forced to %s",
2494                     symbolic(v4l1_plist, cam->picture.palette))
2495
2496         if (cam->force_rgb)
2497                 DBG(3, "- RGB component ordering will be used instead of BGR")
2498
2499         if (cam->auto_brt)
2500                 DBG(3, "- Auto brightness enabled")
2501         else
2502                 DBG(3, "- Auto brightness disabled")
2503
2504         if (cam->auto_exp)
2505                 DBG(3, "- Auto exposure enabled")
2506         else
2507                 DBG(3, "- Auto exposure disabled")
2508
2509         if (cam->backlight)
2510                 DBG(3, "- Backlight exposure algorithm enabled")
2511         else
2512                 DBG(3, "- Backlight exposure algorithm disabled")
2513
2514         if (cam->mirror)
2515                 DBG(3, "- Mirror enabled")
2516         else
2517                 DBG(3, "- Mirror disabled")
2518
2519         if (cam->bandfilt)
2520                 DBG(3, "- Banding filter enabled")
2521         else
2522                 DBG(3, "- Banding filter disabled")
2523
2524         DBG(3, "- Power lighting frequency: %u", cam->lightfreq)
2525
2526         if (cam->clockdiv == -1)
2527                 DBG(3, "- Automatic clock divisor enabled")
2528         else
2529                 DBG(3, "- Clock divisor: %d", cam->clockdiv)
2530
2531         if (cam->monochrome)
2532                 DBG(3, "- Image sensor used as monochrome")
2533         else
2534                 DBG(3, "- Image sensor not used as monochrome")
2535 }
2536
2537
2538 /*--------------------------------------------------------------------------
2539   If the video post-processing module is not loaded, some parameters
2540   must be overridden.
2541   --------------------------------------------------------------------------*/
2542 static void w9968cf_adjust_configuration(struct w9968cf_device* cam)
2543 {
2544         if (!w9968cf_vpp) {
2545                 if (cam->decompression == 1) {
2546                         cam->decompression = 2;
2547                         DBG(2, "Video post-processing module not found: "
2548                                "'decompression' parameter forced to 2")
2549                 }
2550                 if (cam->upscaling) {
2551                         cam->upscaling = 0;
2552                         DBG(2, "Video post-processing module not found: "
2553                                "'upscaling' parameter forced to 0")
2554                 }
2555                 if (cam->picture.palette != VIDEO_PALETTE_UYVY) {
2556                         cam->force_palette = 0;
2557                         DBG(2, "Video post-processing module not found: "
2558                                "'force_palette' parameter forced to 0")
2559                 }
2560                 cam->picture.palette = VIDEO_PALETTE_UYVY;
2561                 cam->picture.depth = w9968cf_valid_depth(cam->picture.palette);
2562         }
2563 }
2564
2565
2566 /*--------------------------------------------------------------------------
2567   Release the resources used by the driver.
2568   This function is called on disconnect
2569   (or on close if deallocation has been deferred)
2570   --------------------------------------------------------------------------*/
2571 static void w9968cf_release_resources(struct w9968cf_device* cam)
2572 {
2573         mutex_lock(&w9968cf_devlist_mutex);
2574
2575         DBG(2, "V4L device deregistered: /dev/video%d", cam->v4ldev->num)
2576
2577         video_unregister_device(cam->v4ldev);
2578         list_del(&cam->v4llist);
2579         i2c_del_adapter(&cam->i2c_adapter);
2580         w9968cf_deallocate_memory(cam);
2581         kfree(cam->control_buffer);
2582         kfree(cam->data_buffer);
2583         v4l2_device_unregister(&cam->v4l2_dev);
2584
2585         mutex_unlock(&w9968cf_devlist_mutex);
2586 }
2587
2588
2589
2590 /****************************************************************************
2591  * Video4Linux interface                                                    *
2592  ****************************************************************************/
2593
2594 static int w9968cf_open(struct file *filp)
2595 {
2596         struct w9968cf_device* cam;
2597         int err;
2598
2599         /* This the only safe way to prevent race conditions with disconnect */
2600         if (!down_read_trylock(&w9968cf_disconnect))
2601                 return -EAGAIN;
2602
2603         cam = (struct w9968cf_device*)video_get_drvdata(video_devdata(filp));
2604
2605         mutex_lock(&cam->dev_mutex);
2606
2607         if (cam->sensor == CC_UNKNOWN) {
2608                 DBG(2, "No supported image sensor has been detected by the "
2609                        "'ovcamchip' module for the %s (/dev/video%d). Make "
2610                        "sure it is loaded *before* (re)connecting the camera.",
2611                     symbolic(camlist, cam->id), cam->v4ldev->num)
2612                 mutex_unlock(&cam->dev_mutex);
2613                 up_read(&w9968cf_disconnect);
2614                 return -ENODEV;
2615         }
2616
2617         if (cam->users) {
2618                 DBG(2, "%s (/dev/video%d) has been already occupied by '%s'",
2619                     symbolic(camlist, cam->id), cam->v4ldev->num, cam->command)
2620                 if ((filp->f_flags & O_NONBLOCK)||(filp->f_flags & O_NDELAY)) {
2621                         mutex_unlock(&cam->dev_mutex);
2622                         up_read(&w9968cf_disconnect);
2623                         return -EWOULDBLOCK;
2624                 }
2625                 mutex_unlock(&cam->dev_mutex);
2626                 err = wait_event_interruptible_exclusive(cam->open,
2627                                                          cam->disconnected ||
2628                                                          !cam->users);
2629                 if (err) {
2630                         up_read(&w9968cf_disconnect);
2631                         return err;
2632                 }
2633                 if (cam->disconnected) {
2634                         up_read(&w9968cf_disconnect);
2635                         return -ENODEV;
2636                 }
2637                 mutex_lock(&cam->dev_mutex);
2638         }
2639
2640         DBG(5, "Opening '%s', /dev/video%d ...",
2641             symbolic(camlist, cam->id), cam->v4ldev->num)
2642
2643         cam->streaming = 0;
2644         cam->misconfigured = 0;
2645
2646         w9968cf_adjust_configuration(cam);
2647
2648         if ((err = w9968cf_allocate_memory(cam)))
2649                 goto deallocate_memory;
2650
2651         if ((err = w9968cf_init_chip(cam)))
2652                 goto deallocate_memory;
2653
2654         if ((err = w9968cf_start_transfer(cam)))
2655                 goto deallocate_memory;
2656
2657         filp->private_data = cam;
2658
2659         cam->users++;
2660         strcpy(cam->command, current->comm);
2661
2662         init_waitqueue_head(&cam->wait_queue);
2663
2664         DBG(5, "Video device is open")
2665
2666         mutex_unlock(&cam->dev_mutex);
2667         up_read(&w9968cf_disconnect);
2668
2669         return 0;
2670
2671 deallocate_memory:
2672         w9968cf_deallocate_memory(cam);
2673         DBG(2, "Failed to open the video device")
2674         mutex_unlock(&cam->dev_mutex);
2675         up_read(&w9968cf_disconnect);
2676         return err;
2677 }
2678
2679
2680 static int w9968cf_release(struct file *filp)
2681 {
2682         struct w9968cf_device* cam;
2683
2684         cam = (struct w9968cf_device*)video_get_drvdata(video_devdata(filp));
2685
2686         mutex_lock(&cam->dev_mutex); /* prevent disconnect() to be called */
2687
2688         w9968cf_stop_transfer(cam);
2689
2690         if (cam->disconnected) {
2691                 w9968cf_release_resources(cam);
2692                 mutex_unlock(&cam->dev_mutex);
2693                 kfree(cam);
2694                 return 0;
2695         }
2696
2697         cam->users--;
2698         w9968cf_deallocate_memory(cam);
2699         wake_up_interruptible_nr(&cam->open, 1);
2700
2701         DBG(5, "Video device closed")
2702         mutex_unlock(&cam->dev_mutex);
2703         return 0;
2704 }
2705
2706
2707 static ssize_t
2708 w9968cf_read(struct file* filp, char __user * buf, size_t count, loff_t* f_pos)
2709 {
2710         struct w9968cf_device* cam;
2711         struct w9968cf_frame_t* fr;
2712         int err = 0;
2713
2714         cam = (struct w9968cf_device*)video_get_drvdata(video_devdata(filp));
2715
2716         if (filp->f_flags & O_NONBLOCK)
2717                 return -EWOULDBLOCK;
2718
2719         if (mutex_lock_interruptible(&cam->fileop_mutex))
2720                 return -ERESTARTSYS;
2721
2722         if (cam->disconnected) {
2723                 DBG(2, "Device not present")
2724                 mutex_unlock(&cam->fileop_mutex);
2725                 return -ENODEV;
2726         }
2727
2728         if (cam->misconfigured) {
2729                 DBG(2, "The camera is misconfigured. Close and open it again.")
2730                 mutex_unlock(&cam->fileop_mutex);
2731                 return -EIO;
2732         }
2733
2734         if (!cam->frame[0].queued)
2735                 w9968cf_push_frame(cam, 0);
2736
2737         if (!cam->frame[1].queued)
2738                 w9968cf_push_frame(cam, 1);
2739
2740         err = wait_event_interruptible(cam->wait_queue,
2741                                        cam->frame[0].status == F_READY ||
2742                                        cam->frame[1].status == F_READY ||
2743                                        cam->disconnected);
2744         if (err) {
2745                 mutex_unlock(&cam->fileop_mutex);
2746                 return err;
2747         }
2748         if (cam->disconnected) {
2749                 mutex_unlock(&cam->fileop_mutex);
2750                 return -ENODEV;
2751         }
2752
2753         fr = (cam->frame[0].status == F_READY) ? &cam->frame[0]:&cam->frame[1];
2754
2755         if (w9968cf_vpp)
2756                 w9968cf_postprocess_frame(cam, fr);
2757
2758         if (count > fr->length)
2759                 count = fr->length;
2760
2761         if (copy_to_user(buf, fr->buffer, count)) {
2762                 fr->status = F_UNUSED;
2763                 mutex_unlock(&cam->fileop_mutex);
2764                 return -EFAULT;
2765         }
2766         *f_pos += count;
2767
2768         fr->status = F_UNUSED;
2769
2770         DBG(5, "%zu bytes read", count)
2771
2772         mutex_unlock(&cam->fileop_mutex);
2773         return count;
2774 }
2775
2776
2777 static int w9968cf_mmap(struct file* filp, struct vm_area_struct *vma)
2778 {
2779         struct w9968cf_device* cam = (struct w9968cf_device*)
2780                                      video_get_drvdata(video_devdata(filp));
2781         unsigned long vsize = vma->vm_end - vma->vm_start,
2782                       psize = cam->nbuffers * cam->frame[0].size,
2783                       start = vma->vm_start,
2784                       pos = (unsigned long)cam->frame[0].buffer,
2785                       page;
2786
2787         if (cam->disconnected) {
2788                 DBG(2, "Device not present")
2789                 return -ENODEV;
2790         }
2791
2792         if (cam->misconfigured) {
2793                 DBG(2, "The camera is misconfigured. Close and open it again")
2794                 return -EIO;
2795         }
2796
2797         PDBGG("mmapping %lu bytes...", vsize)
2798
2799         if (vsize > psize - (vma->vm_pgoff << PAGE_SHIFT))
2800                 return -EINVAL;
2801
2802         while (vsize > 0) {
2803                 page = vmalloc_to_pfn((void *)pos);
2804                 if (remap_pfn_range(vma, start, page + vma->vm_pgoff,
2805                                                 PAGE_SIZE, vma->vm_page_prot))
2806                         return -EAGAIN;
2807                 start += PAGE_SIZE;
2808                 pos += PAGE_SIZE;
2809                 vsize -= PAGE_SIZE;
2810         }
2811
2812         DBG(5, "mmap method successfully called")
2813         return 0;
2814 }
2815
2816
2817 static long
2818 w9968cf_ioctl(struct file *filp,
2819               unsigned int cmd, unsigned long arg)
2820 {
2821         struct w9968cf_device* cam;
2822         long err;
2823
2824         cam = (struct w9968cf_device*)video_get_drvdata(video_devdata(filp));
2825
2826         if (mutex_lock_interruptible(&cam->fileop_mutex))
2827                 return -ERESTARTSYS;
2828
2829         if (cam->disconnected) {
2830                 DBG(2, "Device not present")
2831                 mutex_unlock(&cam->fileop_mutex);
2832                 return -ENODEV;
2833         }
2834
2835         if (cam->misconfigured) {
2836                 DBG(2, "The camera is misconfigured. Close and open it again.")
2837                 mutex_unlock(&cam->fileop_mutex);
2838                 return -EIO;
2839         }
2840
2841         err = w9968cf_v4l_ioctl(filp, cmd, (void __user *)arg);
2842
2843         mutex_unlock(&cam->fileop_mutex);
2844         return err;
2845 }
2846
2847
2848 static long w9968cf_v4l_ioctl(struct file *filp,
2849                              unsigned int cmd, void __user *arg)
2850 {
2851         struct w9968cf_device* cam;
2852         const char* v4l1_ioctls[] = {
2853                 "?", "CGAP", "GCHAN", "SCHAN", "GTUNER", "STUNER",
2854                 "GPICT", "SPICT", "CCAPTURE", "GWIN", "SWIN", "GFBUF",
2855                 "SFBUF", "KEY", "GFREQ", "SFREQ", "GAUDIO", "SAUDIO",
2856                 "SYNC", "MCAPTURE", "GMBUF", "GUNIT", "GCAPTURE", "SCAPTURE",
2857                 "SPLAYMODE", "SWRITEMODE", "GPLAYINFO", "SMICROCODE",
2858                 "GVBIFMT", "SVBIFMT"
2859         };
2860
2861         #define V4L1_IOCTL(cmd) \
2862                 ((_IOC_NR((cmd)) < ARRAY_SIZE(v4l1_ioctls)) ? \
2863                 v4l1_ioctls[_IOC_NR((cmd))] : "?")
2864
2865         cam = (struct w9968cf_device*)video_get_drvdata(video_devdata(filp));
2866
2867         switch (cmd) {
2868
2869         case VIDIOCGCAP: /* get video capability */
2870         {
2871                 struct video_capability cap = {
2872                         .type = VID_TYPE_CAPTURE | VID_TYPE_SCALES,
2873                         .channels = 1,
2874                         .audios = 0,
2875                         .minwidth = cam->minwidth,
2876                         .minheight = cam->minheight,
2877                 };
2878                 sprintf(cap.name, "W996[87]CF USB Camera #%d",
2879                         cam->v4ldev->num);
2880                 cap.maxwidth = (cam->upscaling && w9968cf_vpp)
2881                                ? max((u16)W9968CF_MAX_WIDTH, cam->maxwidth)
2882                                  : cam->maxwidth;
2883                 cap.maxheight = (cam->upscaling && w9968cf_vpp)
2884                                 ? max((u16)W9968CF_MAX_HEIGHT, cam->maxheight)
2885                                   : cam->maxheight;
2886
2887                 if (copy_to_user(arg, &cap, sizeof(cap)))
2888                         return -EFAULT;
2889
2890                 DBG(5, "VIDIOCGCAP successfully called")
2891                 return 0;
2892         }
2893
2894         case VIDIOCGCHAN: /* get video channel informations */
2895         {
2896                 struct video_channel chan;
2897                 if (copy_from_user(&chan, arg, sizeof(chan)))
2898                         return -EFAULT;
2899
2900                 if (chan.channel != 0)
2901                         return -EINVAL;
2902
2903                 strcpy(chan.name, "Camera");
2904                 chan.tuners = 0;
2905                 chan.flags = 0;
2906                 chan.type = VIDEO_TYPE_CAMERA;
2907                 chan.norm = VIDEO_MODE_AUTO;
2908
2909                 if (copy_to_user(arg, &chan, sizeof(chan)))
2910                         return -EFAULT;
2911
2912                 DBG(5, "VIDIOCGCHAN successfully called")
2913                 return 0;
2914         }
2915
2916         case VIDIOCSCHAN: /* set active channel */
2917         {
2918                 struct video_channel chan;
2919
2920                 if (copy_from_user(&chan, arg, sizeof(chan)))
2921                         return -EFAULT;
2922
2923                 if (chan.channel != 0)
2924                         return -EINVAL;
2925
2926                 DBG(5, "VIDIOCSCHAN successfully called")
2927                 return 0;
2928         }
2929
2930         case VIDIOCGPICT: /* get image properties of the picture */
2931         {
2932                 if (w9968cf_sensor_get_picture(cam))
2933                         return -EIO;
2934
2935                 if (copy_to_user(arg, &cam->picture, sizeof(cam->picture)))
2936                         return -EFAULT;
2937
2938                 DBG(5, "VIDIOCGPICT successfully called")
2939                 return 0;
2940         }
2941
2942         case VIDIOCSPICT: /* change picture settings */
2943         {
2944                 struct video_picture pict;
2945                 int err = 0;
2946
2947                 if (copy_from_user(&pict, arg, sizeof(pict)))
2948                         return -EFAULT;
2949
2950                 if ( (cam->force_palette || !w9968cf_vpp)
2951                      && pict.palette != cam->picture.palette ) {
2952                         DBG(4, "Palette %s rejected: only %s is allowed",
2953                             symbolic(v4l1_plist, pict.palette),
2954                             symbolic(v4l1_plist, cam->picture.palette))
2955                         return -EINVAL;
2956                 }
2957
2958                 if (!w9968cf_valid_palette(pict.palette)) {
2959                         DBG(4, "Palette %s not supported. VIDIOCSPICT failed",
2960                             symbolic(v4l1_plist, pict.palette))
2961                         return -EINVAL;
2962                 }
2963
2964                 if (!cam->force_palette) {
2965                    if (cam->decompression == 0) {
2966                       if (w9968cf_need_decompression(pict.palette)) {
2967                          DBG(4, "Decompression disabled: palette %s is not "
2968                                 "allowed. VIDIOCSPICT failed",
2969                              symbolic(v4l1_plist, pict.palette))
2970                          return -EINVAL;
2971                       }
2972                    } else if (cam->decompression == 1) {
2973                       if (!w9968cf_need_decompression(pict.palette)) {
2974                          DBG(4, "Decompression forced: palette %s is not "
2975                                 "allowed. VIDIOCSPICT failed",
2976                              symbolic(v4l1_plist, pict.palette))
2977                          return -EINVAL;
2978                       }
2979                    }
2980                 }
2981
2982                 if (pict.depth != w9968cf_valid_depth(pict.palette)) {
2983                         DBG(4, "Requested depth %u bpp is not valid for %s "
2984                                "palette: ignored and changed to %u bpp",
2985                             pict.depth, symbolic(v4l1_plist, pict.palette),
2986                             w9968cf_valid_depth(pict.palette))
2987                         pict.depth = w9968cf_valid_depth(pict.palette);
2988                 }
2989
2990                 if (pict.palette != cam->picture.palette) {
2991                         if(*cam->requested_frame
2992                            || cam->frame_current->queued) {
2993                                 err = wait_event_interruptible
2994                                       ( cam->wait_queue,
2995                                         cam->disconnected ||
2996                                         (!*cam->requested_frame &&
2997                                          !cam->frame_current->queued) );
2998                                 if (err)
2999                                         return err;
3000                                 if (cam->disconnected)
3001                                         return -ENODEV;
3002                         }
3003
3004                         if (w9968cf_stop_transfer(cam))
3005                                 goto ioctl_fail;
3006
3007                         if (w9968cf_set_picture(cam, pict))
3008                                 goto ioctl_fail;
3009
3010                         if (w9968cf_start_transfer(cam))
3011                                 goto ioctl_fail;
3012
3013                 } else if (w9968cf_sensor_update_picture(cam, pict))
3014                         return -EIO;
3015
3016
3017                 DBG(5, "VIDIOCSPICT successfully called")
3018                 return 0;
3019         }
3020
3021         case VIDIOCSWIN: /* set capture area */
3022         {
3023                 struct video_window win;
3024                 int err = 0;
3025
3026                 if (copy_from_user(&win, arg, sizeof(win)))
3027                         return -EFAULT;
3028
3029                 DBG(6, "VIDIOCSWIN called: clipcount=%d, flags=%u, "
3030                        "x=%u, y=%u, %ux%u", win.clipcount, win.flags,
3031                     win.x, win.y, win.width, win.height)
3032
3033                 if (win.clipcount != 0 || win.flags != 0)
3034                         return -EINVAL;
3035
3036                 if ((err = w9968cf_adjust_window_size(cam, &win.width,
3037                                                       &win.height))) {
3038                         DBG(4, "Resolution not supported (%ux%u). "
3039                                "VIDIOCSWIN failed", win.width, win.height)
3040                         return err;
3041                 }
3042
3043                 if (win.x != cam->window.x ||
3044                     win.y != cam->window.y ||
3045                     win.width != cam->window.width ||
3046                     win.height != cam->window.height) {
3047                         if(*cam->requested_frame
3048                            || cam->frame_current->queued) {
3049                                 err = wait_event_interruptible
3050                                       ( cam->wait_queue,
3051                                         cam->disconnected ||
3052                                         (!*cam->requested_frame &&
3053                                          !cam->frame_current->queued) );
3054                                 if (err)
3055                                         return err;
3056                                 if (cam->disconnected)
3057                                         return -ENODEV;
3058                         }
3059
3060                         if (w9968cf_stop_transfer(cam))
3061                                 goto ioctl_fail;
3062
3063                         /* This _must_ be called before set_window() */
3064                         if (w9968cf_set_picture(cam, cam->picture))
3065                                 goto ioctl_fail;
3066
3067                         if (w9968cf_set_window(cam, win))
3068                                 goto ioctl_fail;
3069
3070                         if (w9968cf_start_transfer(cam))
3071                                 goto ioctl_fail;
3072                 }
3073
3074                 DBG(5, "VIDIOCSWIN successfully called. ")
3075                 return 0;
3076         }
3077
3078         case VIDIOCGWIN: /* get current window properties */
3079         {
3080                 if (copy_to_user(arg,&cam->window,sizeof(struct video_window)))
3081                         return -EFAULT;
3082
3083                 DBG(5, "VIDIOCGWIN successfully called")
3084                 return 0;
3085         }
3086
3087         case VIDIOCGMBUF: /* request for memory (mapped) buffer */
3088         {
3089                 struct video_mbuf mbuf;
3090                 u8 i;
3091
3092                 mbuf.size = cam->nbuffers * cam->frame[0].size;
3093                 mbuf.frames = cam->nbuffers;
3094                 for (i = 0; i < cam->nbuffers; i++)
3095                         mbuf.offsets[i] = (unsigned long)cam->frame[i].buffer -
3096                                           (unsigned long)cam->frame[0].buffer;
3097
3098                 if (copy_to_user(arg, &mbuf, sizeof(mbuf)))
3099                         return -EFAULT;
3100
3101                 DBG(5, "VIDIOCGMBUF successfully called")
3102                 return 0;
3103         }
3104
3105         case VIDIOCMCAPTURE: /* start the capture to a frame */
3106         {
3107                 struct video_mmap mmap;
3108                 struct w9968cf_frame_t* fr;
3109                 u32 w, h;
3110                 int err = 0;
3111
3112                 if (copy_from_user(&mmap, arg, sizeof(mmap)))
3113                         return -EFAULT;
3114
3115                 DBG(6, "VIDIOCMCAPTURE called: frame #%u, format=%s, %dx%d",
3116                     mmap.frame, symbolic(v4l1_plist, mmap.format),
3117                     mmap.width, mmap.height)
3118
3119                 if (mmap.frame >= cam->nbuffers) {
3120                         DBG(4, "Invalid frame number (%u). "
3121                                "VIDIOCMCAPTURE failed", mmap.frame)
3122                         return -EINVAL;
3123                 }
3124
3125                 if (mmap.format!=cam->picture.palette &&
3126                     (cam->force_palette || !w9968cf_vpp)) {
3127                         DBG(4, "Palette %s rejected: only %s is allowed",
3128                             symbolic(v4l1_plist, mmap.format),
3129                             symbolic(v4l1_plist, cam->picture.palette))
3130                         return -EINVAL;
3131                 }
3132
3133                 if (!w9968cf_valid_palette(mmap.format)) {
3134                         DBG(4, "Palette %s not supported. "
3135                                "VIDIOCMCAPTURE failed",
3136                             symbolic(v4l1_plist, mmap.format))
3137                         return -EINVAL;
3138                 }
3139
3140                 if (!cam->force_palette) {
3141                    if (cam->decompression == 0) {
3142                       if (w9968cf_need_decompression(mmap.format)) {
3143                          DBG(4, "Decompression disabled: palette %s is not "
3144                                 "allowed. VIDIOCSPICT failed",
3145                              symbolic(v4l1_plist, mmap.format))
3146                          return -EINVAL;
3147                       }
3148                    } else if (cam->decompression == 1) {
3149                       if (!w9968cf_need_decompression(mmap.format)) {
3150                          DBG(4, "Decompression forced: palette %s is not "
3151                                 "allowed. VIDIOCSPICT failed",
3152                              symbolic(v4l1_plist, mmap.format))
3153                          return -EINVAL;
3154                       }
3155                    }
3156                 }
3157
3158                 w = mmap.width; h = mmap.height;
3159                 err = w9968cf_adjust_window_size(cam, &w, &h);
3160                 mmap.width = w; mmap.height = h;
3161                 if (err) {
3162                         DBG(4, "Resolution not supported (%dx%d). "
3163                                "VIDIOCMCAPTURE failed",
3164                             mmap.width, mmap.height)
3165                         return err;
3166                 }
3167
3168                 fr = &cam->frame[mmap.frame];
3169
3170                 if (mmap.width  != cam->window.width ||
3171                     mmap.height != cam->window.height ||
3172                     mmap.format != cam->picture.palette) {
3173
3174                         struct video_window win;
3175                         struct video_picture pict;
3176
3177                         if(*cam->requested_frame
3178                            || cam->frame_current->queued) {
3179                                 DBG(6, "VIDIOCMCAPTURE. Change settings for "
3180                                        "frame #%u: %dx%d, format %s. Wait...",
3181                                     mmap.frame, mmap.width, mmap.height,
3182                                     symbolic(v4l1_plist, mmap.format))
3183                                 err = wait_event_interruptible
3184                                       ( cam->wait_queue,
3185                                         cam->disconnected ||
3186                                         (!*cam->requested_frame &&
3187                                          !cam->frame_current->queued) );
3188                                 if (err)
3189                                         return err;
3190                                 if (cam->disconnected)
3191                                         return -ENODEV;
3192                         }
3193
3194                         memcpy(&win, &cam->window, sizeof(win));
3195                         memcpy(&pict, &cam->picture, sizeof(pict));
3196                         win.width = mmap.width;
3197                         win.height = mmap.height;
3198                         pict.palette = mmap.format;
3199
3200                         if (w9968cf_stop_transfer(cam))
3201                                 goto ioctl_fail;
3202
3203                         /* This before set_window */
3204                         if (w9968cf_set_picture(cam, pict))
3205                                 goto ioctl_fail;
3206
3207                         if (w9968cf_set_window(cam, win))
3208                                 goto ioctl_fail;
3209
3210                         if (w9968cf_start_transfer(cam))
3211                                 goto ioctl_fail;
3212
3213                 } else  if (fr->queued) {
3214
3215                         DBG(6, "Wait until frame #%u is free", mmap.frame)
3216
3217                         err = wait_event_interruptible(cam->wait_queue,
3218                                                        cam->disconnected ||
3219                                                        (!fr->queued));
3220                         if (err)
3221                                 return err;
3222                         if (cam->disconnected)
3223                                 return -ENODEV;
3224                 }
3225
3226                 w9968cf_push_frame(cam, mmap.frame);
3227                 DBG(5, "VIDIOCMCAPTURE(%u): successfully called", mmap.frame)
3228                 return 0;
3229         }
3230
3231         case VIDIOCSYNC: /* wait until the capture of a frame is finished */
3232         {
3233                 unsigned int f_num;
3234                 struct w9968cf_frame_t* fr;
3235                 int err = 0;
3236
3237                 if (copy_from_user(&f_num, arg, sizeof(f_num)))
3238                         return -EFAULT;
3239
3240                 if (f_num >= cam->nbuffers) {
3241                         DBG(4, "Invalid frame number (%u). "
3242                                "VIDIOCMCAPTURE failed", f_num)
3243                         return -EINVAL;
3244                 }
3245
3246                 DBG(6, "VIDIOCSYNC called for frame #%u", f_num)
3247
3248                 fr = &cam->frame[f_num];
3249
3250                 switch (fr->status) {
3251                 case F_UNUSED:
3252                         if (!fr->queued) {
3253                                 DBG(4, "VIDIOSYNC: Frame #%u not requested!",
3254                                     f_num)
3255                                 return -EFAULT;
3256                         }
3257                 case F_ERROR:
3258                 case F_GRABBING:
3259                         err = wait_event_interruptible(cam->wait_queue,
3260                                                        (fr->status == F_READY)
3261                                                        || cam->disconnected);
3262                         if (err)
3263                                 return err;
3264                         if (cam->disconnected)
3265                                 return -ENODEV;
3266                         break;
3267                 case F_READY:
3268                         break;
3269                 }
3270
3271                 if (w9968cf_vpp)
3272                         w9968cf_postprocess_frame(cam, fr);
3273
3274                 fr->status = F_UNUSED;
3275
3276                 DBG(5, "VIDIOCSYNC(%u) successfully called", f_num)
3277                 return 0;
3278         }
3279
3280         case VIDIOCGUNIT:/* report the unit numbers of the associated devices*/
3281         {
3282                 struct video_unit unit = {
3283                         .video = cam->v4ldev->minor,
3284                         .vbi = VIDEO_NO_UNIT,
3285                         .radio = VIDEO_NO_UNIT,
3286                         .audio = VIDEO_NO_UNIT,
3287                         .teletext = VIDEO_NO_UNIT,
3288                 };
3289
3290                 if (copy_to_user(arg, &unit, sizeof(unit)))
3291                         return -EFAULT;
3292
3293                 DBG(5, "VIDIOCGUNIT successfully called")
3294                 return 0;
3295         }
3296
3297         case VIDIOCKEY:
3298                 return 0;
3299
3300         case VIDIOCGFBUF:
3301         {
3302                 if (clear_user(arg, sizeof(struct video_buffer)))
3303                         return -EFAULT;
3304
3305                 DBG(5, "VIDIOCGFBUF successfully called")
3306                 return 0;
3307         }
3308
3309         case VIDIOCGTUNER:
3310         {
3311                 struct video_tuner tuner;
3312                 if (copy_from_user(&tuner, arg, sizeof(tuner)))
3313                         return -EFAULT;
3314
3315                 if (tuner.tuner != 0)
3316                         return -EINVAL;
3317
3318                 strcpy(tuner.name, "no_tuner");
3319                 tuner.rangelow = 0;
3320                 tuner.rangehigh = 0;
3321                 tuner.flags = VIDEO_TUNER_NORM;
3322                 tuner.mode = VIDEO_MODE_AUTO;
3323                 tuner.signal = 0xffff;
3324
3325                 if (copy_to_user(arg, &tuner, sizeof(tuner)))
3326                         return -EFAULT;
3327
3328                 DBG(5, "VIDIOCGTUNER successfully called")
3329                 return 0;
3330         }
3331
3332         case VIDIOCSTUNER:
3333         {
3334                 struct video_tuner tuner;
3335                 if (copy_from_user(&tuner, arg, sizeof(tuner)))
3336                         return -EFAULT;
3337
3338                 if (tuner.tuner != 0)
3339                         return -EINVAL;
3340
3341                 if (tuner.mode != VIDEO_MODE_AUTO)
3342                         return -EINVAL;
3343
3344                 DBG(5, "VIDIOCSTUNER successfully called")
3345                 return 0;
3346         }
3347
3348         case VIDIOCSFBUF:
3349         case VIDIOCCAPTURE:
3350         case VIDIOCGFREQ:
3351         case VIDIOCSFREQ:
3352         case VIDIOCGAUDIO:
3353         case VIDIOCSAUDIO:
3354         case VIDIOCSPLAYMODE:
3355         case VIDIOCSWRITEMODE:
3356         case VIDIOCGPLAYINFO:
3357         case VIDIOCSMICROCODE:
3358         case VIDIOCGVBIFMT:
3359         case VIDIOCSVBIFMT:
3360                 DBG(4, "Unsupported V4L1 IOCtl: VIDIOC%s "
3361                        "(type 0x%01X, "
3362                        "n. 0x%01X, "
3363                        "dir. 0x%01X, "
3364                        "size 0x%02X)",
3365                     V4L1_IOCTL(cmd),
3366                     _IOC_TYPE(cmd),_IOC_NR(cmd),_IOC_DIR(cmd),_IOC_SIZE(cmd))
3367
3368                 return -EINVAL;
3369
3370         default:
3371                 DBG(4, "Invalid V4L1 IOCtl: VIDIOC%s "
3372                        "type 0x%01X, "
3373                        "n. 0x%01X, "
3374                        "dir. 0x%01X, "
3375                        "size 0x%02X",
3376                     V4L1_IOCTL(cmd),
3377                     _IOC_TYPE(cmd),_IOC_NR(cmd),_IOC_DIR(cmd),_IOC_SIZE(cmd))
3378
3379                 return -ENOIOCTLCMD;
3380
3381         } /* end of switch */
3382
3383 ioctl_fail:
3384         cam->misconfigured = 1;
3385         DBG(1, "VIDIOC%s failed because of hardware problems. "
3386                "To use the camera, close and open it again.", V4L1_IOCTL(cmd))
3387         return -EFAULT;
3388 }
3389
3390
3391 static const struct v4l2_file_operations w9968cf_fops = {
3392         .owner =   THIS_MODULE,
3393         .open =    w9968cf_open,
3394         .release = w9968cf_release,
3395         .read =    w9968cf_read,
3396         .ioctl =   w9968cf_ioctl,
3397         .mmap =    w9968cf_mmap,
3398 };
3399
3400
3401
3402 /****************************************************************************
3403  * USB probe and V4L registration, disconnect and id_table[] definition     *
3404  ****************************************************************************/
3405
3406 static int
3407 w9968cf_usb_probe(struct usb_interface* intf, const struct usb_device_id* id)
3408 {
3409         struct usb_device *udev = interface_to_usbdev(intf);
3410         struct w9968cf_device* cam;
3411         int err = 0;
3412         enum w9968cf_model_id mod_id;
3413         struct list_head* ptr;
3414         u8 sc = 0; /* number of simultaneous cameras */
3415         static unsigned short dev_nr; /* 0 - we are handling device number n */
3416         static unsigned short addrs[] = {
3417                 OV7xx0_SID,
3418                 OV6xx0_SID,
3419                 I2C_CLIENT_END
3420         };
3421
3422         if (le16_to_cpu(udev->descriptor.idVendor)  == winbond_id_table[0].idVendor &&
3423             le16_to_cpu(udev->descriptor.idProduct) == winbond_id_table[0].idProduct)
3424                 mod_id = W9968CF_MOD_CLVBWGP; /* see camlist[] table */
3425         else if (le16_to_cpu(udev->descriptor.idVendor)  == winbond_id_table[1].idVendor &&
3426                  le16_to_cpu(udev->descriptor.idProduct) == winbond_id_table[1].idProduct)
3427                 mod_id = W9968CF_MOD_GENERIC; /* see camlist[] table */
3428         else
3429                 return -ENODEV;
3430
3431         cam = (struct w9968cf_device*)
3432                   kzalloc(sizeof(struct w9968cf_device), GFP_KERNEL);
3433         if (!cam)
3434                 return -ENOMEM;
3435
3436         err = v4l2_device_register(&intf->dev, &cam->v4l2_dev);
3437         if (err)
3438                 goto fail0;
3439
3440         mutex_init(&cam->dev_mutex);
3441         mutex_lock(&cam->dev_mutex);
3442
3443         cam->usbdev = udev;
3444
3445         DBG(2, "%s detected", symbolic(camlist, mod_id))
3446
3447         if (simcams > W9968CF_MAX_DEVICES)
3448                 simcams = W9968CF_SIMCAMS;
3449
3450         /* How many cameras are connected ? */
3451         mutex_lock(&w9968cf_devlist_mutex);
3452         list_for_each(ptr, &w9968cf_dev_list)
3453                 sc++;
3454         mutex_unlock(&w9968cf_devlist_mutex);
3455
3456         if (sc >= simcams) {
3457                 DBG(2, "Device rejected: too many connected cameras "
3458                        "(max. %u)", simcams)
3459                 err = -EPERM;
3460                 goto fail;
3461         }
3462
3463
3464         /* Allocate 2 bytes of memory for camera control USB transfers */
3465         if (!(cam->control_buffer = kzalloc(2, GFP_KERNEL))) {
3466                 DBG(1,"Couldn't allocate memory for camera control transfers")
3467                 err = -ENOMEM;
3468                 goto fail;
3469         }
3470
3471         /* Allocate 8 bytes of memory for USB data transfers to the FSB */
3472         if (!(cam->data_buffer = kzalloc(8, GFP_KERNEL))) {
3473                 DBG(1, "Couldn't allocate memory for data "
3474                        "transfers to the FSB")
3475                 err = -ENOMEM;
3476                 goto fail;
3477         }
3478
3479         /* Register the V4L device */
3480         cam->v4ldev = video_device_alloc();
3481         if (!cam->v4ldev) {
3482                 DBG(1, "Could not allocate memory for a V4L structure")
3483                 err = -ENOMEM;
3484                 goto fail;
3485         }
3486
3487         strcpy(cam->v4ldev->name, symbolic(camlist, mod_id));
3488         cam->v4ldev->fops = &w9968cf_fops;
3489         cam->v4ldev->minor = video_nr[dev_nr];
3490         cam->v4ldev->release = video_device_release;
3491         video_set_drvdata(cam->v4ldev, cam);
3492         cam->v4ldev->v4l2_dev = &cam->v4l2_dev;
3493
3494         err = video_register_device(cam->v4ldev, VFL_TYPE_GRABBER,
3495                                     video_nr[dev_nr]);
3496         if (err) {
3497                 DBG(1, "V4L device registration failed")
3498                 if (err == -ENFILE && video_nr[dev_nr] == -1)
3499                         DBG(2, "Couldn't find a free /dev/videoX node")
3500                 video_nr[dev_nr] = -1;
3501                 dev_nr = (dev_nr < W9968CF_MAX_DEVICES-1) ? dev_nr+1 : 0;
3502                 goto fail;
3503         }
3504
3505         DBG(2, "V4L device registered as /dev/video%d", cam->v4ldev->num)
3506
3507         /* Set some basic constants */
3508         w9968cf_configure_camera(cam, udev, mod_id, dev_nr);
3509
3510         /* Add a new entry into the list of V4L registered devices */
3511         mutex_lock(&w9968cf_devlist_mutex);
3512         list_add(&cam->v4llist, &w9968cf_dev_list);
3513         mutex_unlock(&w9968cf_devlist_mutex);
3514         dev_nr = (dev_nr < W9968CF_MAX_DEVICES-1) ? dev_nr+1 : 0;
3515
3516         w9968cf_turn_on_led(cam);
3517
3518         w9968cf_i2c_init(cam);
3519         cam->sensor_sd = v4l2_i2c_new_probed_subdev(&cam->v4l2_dev,
3520                         &cam->i2c_adapter,
3521                         "ovcamchip", "ovcamchip", addrs);
3522
3523         usb_set_intfdata(intf, cam);
3524         mutex_unlock(&cam->dev_mutex);
3525
3526         err = w9968cf_sensor_init(cam);
3527         return 0;
3528
3529 fail: /* Free unused memory */
3530         kfree(cam->control_buffer);
3531         kfree(cam->data_buffer);
3532         if (cam->v4ldev)
3533                 video_device_release(cam->v4ldev);
3534         mutex_unlock(&cam->dev_mutex);
3535         v4l2_device_unregister(&cam->v4l2_dev);
3536 fail0:
3537         kfree(cam);
3538         return err;
3539 }
3540
3541
3542 static void w9968cf_usb_disconnect(struct usb_interface* intf)
3543 {
3544         struct w9968cf_device* cam =
3545            (struct w9968cf_device*)usb_get_intfdata(intf);
3546
3547         if (cam) {
3548                 down_write(&w9968cf_disconnect);
3549                 /* Prevent concurrent accesses to data */
3550                 mutex_lock(&cam->dev_mutex);
3551
3552                 cam->disconnected = 1;
3553
3554                 DBG(2, "Disconnecting %s...", symbolic(camlist, cam->id));
3555
3556                 v4l2_device_disconnect(&cam->v4l2_dev);
3557
3558                 wake_up_interruptible_all(&cam->open);
3559
3560                 if (cam->users) {
3561                         DBG(2, "The device is open (/dev/video%d)! "
3562                                "Process name: %s. Deregistration and memory "
3563                                "deallocation are deferred on close.",
3564                             cam->v4ldev->num, cam->command)
3565                         cam->misconfigured = 1;
3566                         w9968cf_stop_transfer(cam);
3567                         wake_up_interruptible(&cam->wait_queue);
3568                 } else
3569                         w9968cf_release_resources(cam);
3570
3571                 mutex_unlock(&cam->dev_mutex);
3572                 up_write(&w9968cf_disconnect);
3573
3574                 if (!cam->users) {
3575                         kfree(cam);
3576                 }
3577         }
3578 }
3579
3580
3581 static struct usb_driver w9968cf_usb_driver = {
3582         .name =       "w9968cf",
3583         .id_table =   winbond_id_table,
3584         .probe =      w9968cf_usb_probe,
3585         .disconnect = w9968cf_usb_disconnect,
3586 };
3587
3588
3589
3590 /****************************************************************************
3591  * Module init, exit and intermodule communication                          *
3592  ****************************************************************************/
3593
3594 static int __init w9968cf_module_init(void)
3595 {
3596         int err;
3597
3598         KDBG(2, W9968CF_MODULE_NAME" "W9968CF_MODULE_VERSION)
3599         KDBG(3, W9968CF_MODULE_AUTHOR)
3600
3601         if ((err = usb_register(&w9968cf_usb_driver)))
3602                 return err;
3603
3604         return 0;
3605 }
3606
3607
3608 static void __exit w9968cf_module_exit(void)
3609 {
3610         /* w9968cf_usb_disconnect() will be called */
3611         usb_deregister(&w9968cf_usb_driver);
3612
3613         KDBG(2, W9968CF_MODULE_NAME" deregistered")
3614 }
3615
3616
3617 module_init(w9968cf_module_init);
3618 module_exit(w9968cf_module_exit);
3619