Linux kernel & device driver programming

Cross-Referenced Linux and Device Driver Code

[ source navigation ] [ diff markup ] [ identifier search ] [ freetext search ] [ file search ]
Version: [ 2.6.11.8 ] [ 2.6.25 ] [ 2.6.25.8 ] [ 2.6.31.13 ] Architecture: [ i386 ]
  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 
3620 
  This page was automatically generated by the LXR engine.