Linux 3.11-rc3
[cris-mirror.git] / drivers / media / usb / cpia2 / cpia2_v4l.c
blobd5d42b6e94be128d49ec8a4dd2a0d8c452c42f48
1 /****************************************************************************
3 * Filename: cpia2_v4l.c
5 * Copyright 2001, STMicrolectronics, Inc.
6 * Contact: steve.miller@st.com
7 * Copyright 2001,2005, Scott J. Bertin <scottbertin@yahoo.com>
9 * Description:
10 * This is a USB driver for CPia2 based video cameras.
11 * The infrastructure of this driver is based on the cpia usb driver by
12 * Jochen Scharrlach and Johannes Erdfeldt.
14 * This program is free software; you can redistribute it and/or modify
15 * it under the terms of the GNU General Public License as published by
16 * the Free Software Foundation; either version 2 of the License, or
17 * (at your option) any later version.
19 * This program is distributed in the hope that it will be useful,
20 * but WITHOUT ANY WARRANTY; without even the implied warranty of
21 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
22 * GNU General Public License for more details.
24 * You should have received a copy of the GNU General Public License
25 * along with this program; if not, write to the Free Software
26 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
28 * Stripped of 2.4 stuff ready for main kernel submit by
29 * Alan Cox <alan@lxorguk.ukuu.org.uk>
30 ****************************************************************************/
32 #define CPIA_VERSION "3.0.1"
34 #include <linux/module.h>
35 #include <linux/time.h>
36 #include <linux/sched.h>
37 #include <linux/slab.h>
38 #include <linux/init.h>
39 #include <linux/videodev2.h>
40 #include <linux/stringify.h>
41 #include <media/v4l2-ioctl.h>
42 #include <media/v4l2-event.h>
44 #include "cpia2.h"
46 static int video_nr = -1;
47 module_param(video_nr, int, 0);
48 MODULE_PARM_DESC(video_nr, "video device to register (0=/dev/video0, etc)");
50 static int buffer_size = 68 * 1024;
51 module_param(buffer_size, int, 0);
52 MODULE_PARM_DESC(buffer_size, "Size for each frame buffer in bytes (default 68k)");
54 static int num_buffers = 3;
55 module_param(num_buffers, int, 0);
56 MODULE_PARM_DESC(num_buffers, "Number of frame buffers (1-"
57 __stringify(VIDEO_MAX_FRAME) ", default 3)");
59 static int alternate = DEFAULT_ALT;
60 module_param(alternate, int, 0);
61 MODULE_PARM_DESC(alternate, "USB Alternate (" __stringify(USBIF_ISO_1) "-"
62 __stringify(USBIF_ISO_6) ", default "
63 __stringify(DEFAULT_ALT) ")");
65 static int flicker_mode;
66 module_param(flicker_mode, int, 0);
67 MODULE_PARM_DESC(flicker_mode, "Flicker frequency (0 (disabled), " __stringify(50) " or "
68 __stringify(60) ", default 0)");
70 MODULE_AUTHOR("Steve Miller (STMicroelectronics) <steve.miller@st.com>");
71 MODULE_DESCRIPTION("V4L-driver for STMicroelectronics CPiA2 based cameras");
72 MODULE_SUPPORTED_DEVICE("video");
73 MODULE_LICENSE("GPL");
74 MODULE_VERSION(CPIA_VERSION);
76 #define ABOUT "V4L-Driver for Vision CPiA2 based cameras"
77 #define CPIA2_CID_USB_ALT (V4L2_CID_USER_BASE | 0xf000)
79 /******************************************************************************
81 * cpia2_open
83 *****************************************************************************/
84 static int cpia2_open(struct file *file)
86 struct camera_data *cam = video_drvdata(file);
87 int retval;
89 if (mutex_lock_interruptible(&cam->v4l2_lock))
90 return -ERESTARTSYS;
91 retval = v4l2_fh_open(file);
92 if (retval)
93 goto open_unlock;
95 if (v4l2_fh_is_singular_file(file)) {
96 if (cpia2_allocate_buffers(cam)) {
97 v4l2_fh_release(file);
98 retval = -ENOMEM;
99 goto open_unlock;
102 /* reset the camera */
103 if (cpia2_reset_camera(cam) < 0) {
104 v4l2_fh_release(file);
105 retval = -EIO;
106 goto open_unlock;
109 cam->APP_len = 0;
110 cam->COM_len = 0;
113 cpia2_dbg_dump_registers(cam);
114 open_unlock:
115 mutex_unlock(&cam->v4l2_lock);
116 return retval;
119 /******************************************************************************
121 * cpia2_close
123 *****************************************************************************/
124 static int cpia2_close(struct file *file)
126 struct video_device *dev = video_devdata(file);
127 struct camera_data *cam = video_get_drvdata(dev);
129 mutex_lock(&cam->v4l2_lock);
130 if (video_is_registered(&cam->vdev) && v4l2_fh_is_singular_file(file)) {
131 cpia2_usb_stream_stop(cam);
133 /* save camera state for later open */
134 cpia2_save_camera_state(cam);
136 cpia2_set_low_power(cam);
137 cpia2_free_buffers(cam);
140 if (cam->stream_fh == file->private_data) {
141 cam->stream_fh = NULL;
142 cam->mmapped = 0;
144 mutex_unlock(&cam->v4l2_lock);
145 return v4l2_fh_release(file);
148 /******************************************************************************
150 * cpia2_v4l_read
152 *****************************************************************************/
153 static ssize_t cpia2_v4l_read(struct file *file, char __user *buf, size_t count,
154 loff_t *off)
156 struct camera_data *cam = video_drvdata(file);
157 int noblock = file->f_flags&O_NONBLOCK;
158 ssize_t ret;
160 if(!cam)
161 return -EINVAL;
163 if (mutex_lock_interruptible(&cam->v4l2_lock))
164 return -ERESTARTSYS;
165 ret = cpia2_read(cam, buf, count, noblock);
166 mutex_unlock(&cam->v4l2_lock);
167 return ret;
171 /******************************************************************************
173 * cpia2_v4l_poll
175 *****************************************************************************/
176 static unsigned int cpia2_v4l_poll(struct file *filp, struct poll_table_struct *wait)
178 struct camera_data *cam = video_drvdata(filp);
179 unsigned int res;
181 mutex_lock(&cam->v4l2_lock);
182 res = cpia2_poll(cam, filp, wait);
183 mutex_unlock(&cam->v4l2_lock);
184 return res;
188 static int sync(struct camera_data *cam, int frame_nr)
190 struct framebuf *frame = &cam->buffers[frame_nr];
192 while (1) {
193 if (frame->status == FRAME_READY)
194 return 0;
196 if (!cam->streaming) {
197 frame->status = FRAME_READY;
198 frame->length = 0;
199 return 0;
202 mutex_unlock(&cam->v4l2_lock);
203 wait_event_interruptible(cam->wq_stream,
204 !cam->streaming ||
205 frame->status == FRAME_READY);
206 mutex_lock(&cam->v4l2_lock);
207 if (signal_pending(current))
208 return -ERESTARTSYS;
209 if (!video_is_registered(&cam->vdev))
210 return -ENOTTY;
214 /******************************************************************************
216 * ioctl_querycap
218 * V4L2 device capabilities
220 *****************************************************************************/
222 static int cpia2_querycap(struct file *file, void *fh, struct v4l2_capability *vc)
224 struct camera_data *cam = video_drvdata(file);
226 strcpy(vc->driver, "cpia2");
228 if (cam->params.pnp_id.product == 0x151)
229 strcpy(vc->card, "QX5 Microscope");
230 else
231 strcpy(vc->card, "CPiA2 Camera");
232 switch (cam->params.pnp_id.device_type) {
233 case DEVICE_STV_672:
234 strcat(vc->card, " (672/");
235 break;
236 case DEVICE_STV_676:
237 strcat(vc->card, " (676/");
238 break;
239 default:
240 strcat(vc->card, " (XXX/");
241 break;
243 switch (cam->params.version.sensor_flags) {
244 case CPIA2_VP_SENSOR_FLAGS_404:
245 strcat(vc->card, "404)");
246 break;
247 case CPIA2_VP_SENSOR_FLAGS_407:
248 strcat(vc->card, "407)");
249 break;
250 case CPIA2_VP_SENSOR_FLAGS_409:
251 strcat(vc->card, "409)");
252 break;
253 case CPIA2_VP_SENSOR_FLAGS_410:
254 strcat(vc->card, "410)");
255 break;
256 case CPIA2_VP_SENSOR_FLAGS_500:
257 strcat(vc->card, "500)");
258 break;
259 default:
260 strcat(vc->card, "XXX)");
261 break;
264 if (usb_make_path(cam->dev, vc->bus_info, sizeof(vc->bus_info)) <0)
265 memset(vc->bus_info,0, sizeof(vc->bus_info));
267 vc->device_caps = V4L2_CAP_VIDEO_CAPTURE |
268 V4L2_CAP_READWRITE |
269 V4L2_CAP_STREAMING;
270 vc->capabilities = vc->device_caps |
271 V4L2_CAP_DEVICE_CAPS;
273 return 0;
276 /******************************************************************************
278 * ioctl_input
280 * V4L2 input get/set/enumerate
282 *****************************************************************************/
284 static int cpia2_enum_input(struct file *file, void *fh, struct v4l2_input *i)
286 if (i->index)
287 return -EINVAL;
288 strcpy(i->name, "Camera");
289 i->type = V4L2_INPUT_TYPE_CAMERA;
290 return 0;
293 static int cpia2_g_input(struct file *file, void *fh, unsigned int *i)
295 *i = 0;
296 return 0;
299 static int cpia2_s_input(struct file *file, void *fh, unsigned int i)
301 return i ? -EINVAL : 0;
304 /******************************************************************************
306 * ioctl_enum_fmt
308 * V4L2 format enumerate
310 *****************************************************************************/
312 static int cpia2_enum_fmt_vid_cap(struct file *file, void *fh,
313 struct v4l2_fmtdesc *f)
315 int index = f->index;
317 if (index < 0 || index > 1)
318 return -EINVAL;
320 memset(f, 0, sizeof(*f));
321 f->index = index;
322 f->type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
323 f->flags = V4L2_FMT_FLAG_COMPRESSED;
324 switch(index) {
325 case 0:
326 strcpy(f->description, "MJPEG");
327 f->pixelformat = V4L2_PIX_FMT_MJPEG;
328 break;
329 case 1:
330 strcpy(f->description, "JPEG");
331 f->pixelformat = V4L2_PIX_FMT_JPEG;
332 break;
333 default:
334 return -EINVAL;
337 return 0;
340 /******************************************************************************
342 * ioctl_try_fmt
344 * V4L2 format try
346 *****************************************************************************/
348 static int cpia2_try_fmt_vid_cap(struct file *file, void *fh,
349 struct v4l2_format *f)
351 struct camera_data *cam = video_drvdata(file);
353 if (f->fmt.pix.pixelformat != V4L2_PIX_FMT_MJPEG &&
354 f->fmt.pix.pixelformat != V4L2_PIX_FMT_JPEG)
355 return -EINVAL;
357 f->fmt.pix.field = V4L2_FIELD_NONE;
358 f->fmt.pix.bytesperline = 0;
359 f->fmt.pix.sizeimage = cam->frame_size;
360 f->fmt.pix.colorspace = V4L2_COLORSPACE_JPEG;
361 f->fmt.pix.priv = 0;
363 switch (cpia2_match_video_size(f->fmt.pix.width, f->fmt.pix.height)) {
364 case VIDEOSIZE_VGA:
365 f->fmt.pix.width = 640;
366 f->fmt.pix.height = 480;
367 break;
368 case VIDEOSIZE_CIF:
369 f->fmt.pix.width = 352;
370 f->fmt.pix.height = 288;
371 break;
372 case VIDEOSIZE_QVGA:
373 f->fmt.pix.width = 320;
374 f->fmt.pix.height = 240;
375 break;
376 case VIDEOSIZE_288_216:
377 f->fmt.pix.width = 288;
378 f->fmt.pix.height = 216;
379 break;
380 case VIDEOSIZE_256_192:
381 f->fmt.pix.width = 256;
382 f->fmt.pix.height = 192;
383 break;
384 case VIDEOSIZE_224_168:
385 f->fmt.pix.width = 224;
386 f->fmt.pix.height = 168;
387 break;
388 case VIDEOSIZE_192_144:
389 f->fmt.pix.width = 192;
390 f->fmt.pix.height = 144;
391 break;
392 case VIDEOSIZE_QCIF:
393 default:
394 f->fmt.pix.width = 176;
395 f->fmt.pix.height = 144;
396 break;
399 return 0;
402 /******************************************************************************
404 * ioctl_set_fmt
406 * V4L2 format set
408 *****************************************************************************/
410 static int cpia2_s_fmt_vid_cap(struct file *file, void *_fh,
411 struct v4l2_format *f)
413 struct camera_data *cam = video_drvdata(file);
414 int err, frame;
416 err = cpia2_try_fmt_vid_cap(file, _fh, f);
417 if(err != 0)
418 return err;
420 cam->pixelformat = f->fmt.pix.pixelformat;
422 /* NOTE: This should be set to 1 for MJPEG, but some apps don't handle
423 * the missing Huffman table properly. */
424 cam->params.compression.inhibit_htables = 0;
425 /*f->fmt.pix.pixelformat == V4L2_PIX_FMT_MJPEG;*/
427 /* we set the video window to something smaller or equal to what
428 * is requested by the user???
430 DBG("Requested width = %d, height = %d\n",
431 f->fmt.pix.width, f->fmt.pix.height);
432 if (f->fmt.pix.width != cam->width ||
433 f->fmt.pix.height != cam->height) {
434 cam->width = f->fmt.pix.width;
435 cam->height = f->fmt.pix.height;
436 cam->params.roi.width = f->fmt.pix.width;
437 cam->params.roi.height = f->fmt.pix.height;
438 cpia2_set_format(cam);
441 for (frame = 0; frame < cam->num_frames; ++frame) {
442 if (cam->buffers[frame].status == FRAME_READING)
443 if ((err = sync(cam, frame)) < 0)
444 return err;
446 cam->buffers[frame].status = FRAME_EMPTY;
449 return 0;
452 /******************************************************************************
454 * ioctl_get_fmt
456 * V4L2 format get
458 *****************************************************************************/
460 static int cpia2_g_fmt_vid_cap(struct file *file, void *fh,
461 struct v4l2_format *f)
463 struct camera_data *cam = video_drvdata(file);
465 f->fmt.pix.width = cam->width;
466 f->fmt.pix.height = cam->height;
467 f->fmt.pix.pixelformat = cam->pixelformat;
468 f->fmt.pix.field = V4L2_FIELD_NONE;
469 f->fmt.pix.bytesperline = 0;
470 f->fmt.pix.sizeimage = cam->frame_size;
471 f->fmt.pix.colorspace = V4L2_COLORSPACE_JPEG;
472 f->fmt.pix.priv = 0;
474 return 0;
477 /******************************************************************************
479 * ioctl_cropcap
481 * V4L2 query cropping capabilities
482 * NOTE: cropping is currently disabled
484 *****************************************************************************/
486 static int cpia2_cropcap(struct file *file, void *fh, struct v4l2_cropcap *c)
488 struct camera_data *cam = video_drvdata(file);
490 if (c->type != V4L2_BUF_TYPE_VIDEO_CAPTURE)
491 return -EINVAL;
493 c->bounds.left = 0;
494 c->bounds.top = 0;
495 c->bounds.width = cam->width;
496 c->bounds.height = cam->height;
497 c->defrect.left = 0;
498 c->defrect.top = 0;
499 c->defrect.width = cam->width;
500 c->defrect.height = cam->height;
501 c->pixelaspect.numerator = 1;
502 c->pixelaspect.denominator = 1;
504 return 0;
507 struct framerate_info {
508 int value;
509 struct v4l2_fract period;
512 static const struct framerate_info framerate_controls[] = {
513 { CPIA2_VP_FRAMERATE_6_25, { 4, 25 } },
514 { CPIA2_VP_FRAMERATE_7_5, { 2, 15 } },
515 { CPIA2_VP_FRAMERATE_12_5, { 2, 25 } },
516 { CPIA2_VP_FRAMERATE_15, { 1, 15 } },
517 { CPIA2_VP_FRAMERATE_25, { 1, 25 } },
518 { CPIA2_VP_FRAMERATE_30, { 1, 30 } },
521 static int cpia2_g_parm(struct file *file, void *fh, struct v4l2_streamparm *p)
523 struct camera_data *cam = video_drvdata(file);
524 struct v4l2_captureparm *cap = &p->parm.capture;
525 int i;
527 if (p->type != V4L2_BUF_TYPE_VIDEO_CAPTURE)
528 return -EINVAL;
530 cap->capability = V4L2_CAP_TIMEPERFRAME;
531 cap->readbuffers = cam->num_frames;
532 for (i = 0; i < ARRAY_SIZE(framerate_controls); i++)
533 if (cam->params.vp_params.frame_rate == framerate_controls[i].value) {
534 cap->timeperframe = framerate_controls[i].period;
535 break;
537 return 0;
540 static int cpia2_s_parm(struct file *file, void *fh, struct v4l2_streamparm *p)
542 struct camera_data *cam = video_drvdata(file);
543 struct v4l2_captureparm *cap = &p->parm.capture;
544 struct v4l2_fract tpf = cap->timeperframe;
545 int max = ARRAY_SIZE(framerate_controls) - 1;
546 int ret;
547 int i;
549 ret = cpia2_g_parm(file, fh, p);
550 if (ret || !tpf.denominator || !tpf.numerator)
551 return ret;
553 /* Maximum 15 fps for this model */
554 if (cam->params.pnp_id.device_type == DEVICE_STV_672 &&
555 cam->params.version.sensor_flags == CPIA2_VP_SENSOR_FLAGS_500)
556 max -= 2;
557 for (i = 0; i <= max; i++) {
558 struct v4l2_fract f1 = tpf;
559 struct v4l2_fract f2 = framerate_controls[i].period;
561 f1.numerator *= f2.denominator;
562 f2.numerator *= f1.denominator;
563 if (f1.numerator >= f2.numerator)
564 break;
566 if (i > max)
567 i = max;
568 cap->timeperframe = framerate_controls[i].period;
569 return cpia2_set_fps(cam, framerate_controls[i].value);
572 static const struct {
573 u32 width;
574 u32 height;
575 } cpia2_framesizes[] = {
576 { 640, 480 },
577 { 352, 288 },
578 { 320, 240 },
579 { 288, 216 },
580 { 256, 192 },
581 { 224, 168 },
582 { 192, 144 },
583 { 176, 144 },
586 static int cpia2_enum_framesizes(struct file *file, void *fh,
587 struct v4l2_frmsizeenum *fsize)
590 if (fsize->pixel_format != V4L2_PIX_FMT_MJPEG &&
591 fsize->pixel_format != V4L2_PIX_FMT_JPEG)
592 return -EINVAL;
593 if (fsize->index >= ARRAY_SIZE(cpia2_framesizes))
594 return -EINVAL;
595 fsize->type = V4L2_FRMSIZE_TYPE_DISCRETE;
596 fsize->discrete.width = cpia2_framesizes[fsize->index].width;
597 fsize->discrete.height = cpia2_framesizes[fsize->index].height;
599 return 0;
602 static int cpia2_enum_frameintervals(struct file *file, void *fh,
603 struct v4l2_frmivalenum *fival)
605 struct camera_data *cam = video_drvdata(file);
606 int max = ARRAY_SIZE(framerate_controls) - 1;
607 int i;
609 if (fival->pixel_format != V4L2_PIX_FMT_MJPEG &&
610 fival->pixel_format != V4L2_PIX_FMT_JPEG)
611 return -EINVAL;
613 /* Maximum 15 fps for this model */
614 if (cam->params.pnp_id.device_type == DEVICE_STV_672 &&
615 cam->params.version.sensor_flags == CPIA2_VP_SENSOR_FLAGS_500)
616 max -= 2;
617 if (fival->index > max)
618 return -EINVAL;
619 for (i = 0; i < ARRAY_SIZE(cpia2_framesizes); i++)
620 if (fival->width == cpia2_framesizes[i].width &&
621 fival->height == cpia2_framesizes[i].height)
622 break;
623 if (i == ARRAY_SIZE(cpia2_framesizes))
624 return -EINVAL;
625 fival->type = V4L2_FRMIVAL_TYPE_DISCRETE;
626 fival->discrete = framerate_controls[fival->index].period;
627 return 0;
630 /******************************************************************************
632 * ioctl_s_ctrl
634 * V4L2 set the value of a control variable
636 *****************************************************************************/
638 static int cpia2_s_ctrl(struct v4l2_ctrl *ctrl)
640 struct camera_data *cam =
641 container_of(ctrl->handler, struct camera_data, hdl);
642 static const int flicker_table[] = {
643 NEVER_FLICKER,
644 FLICKER_50,
645 FLICKER_60,
648 DBG("Set control id:%d, value:%d\n", ctrl->id, ctrl->val);
650 switch (ctrl->id) {
651 case V4L2_CID_BRIGHTNESS:
652 cpia2_set_brightness(cam, ctrl->val);
653 break;
654 case V4L2_CID_CONTRAST:
655 cpia2_set_contrast(cam, ctrl->val);
656 break;
657 case V4L2_CID_SATURATION:
658 cpia2_set_saturation(cam, ctrl->val);
659 break;
660 case V4L2_CID_HFLIP:
661 cpia2_set_property_mirror(cam, ctrl->val);
662 break;
663 case V4L2_CID_VFLIP:
664 cpia2_set_property_flip(cam, ctrl->val);
665 break;
666 case V4L2_CID_POWER_LINE_FREQUENCY:
667 return cpia2_set_flicker_mode(cam, flicker_table[ctrl->val]);
668 case V4L2_CID_ILLUMINATORS_1:
669 return cpia2_set_gpio(cam, (cam->top_light->val << 6) |
670 (cam->bottom_light->val << 7));
671 case V4L2_CID_JPEG_ACTIVE_MARKER:
672 cam->params.compression.inhibit_htables =
673 !(ctrl->val & V4L2_JPEG_ACTIVE_MARKER_DHT);
674 break;
675 case V4L2_CID_JPEG_COMPRESSION_QUALITY:
676 cam->params.vc_params.quality = ctrl->val;
677 break;
678 case CPIA2_CID_USB_ALT:
679 cam->params.camera_state.stream_mode = ctrl->val;
680 break;
681 default:
682 return -EINVAL;
685 return 0;
688 /******************************************************************************
690 * ioctl_g_jpegcomp
692 * V4L2 get the JPEG compression parameters
694 *****************************************************************************/
696 static int cpia2_g_jpegcomp(struct file *file, void *fh, struct v4l2_jpegcompression *parms)
698 struct camera_data *cam = video_drvdata(file);
700 memset(parms, 0, sizeof(*parms));
702 parms->quality = 80; // TODO: Can this be made meaningful?
704 parms->jpeg_markers = V4L2_JPEG_MARKER_DQT | V4L2_JPEG_MARKER_DRI;
705 if(!cam->params.compression.inhibit_htables) {
706 parms->jpeg_markers |= V4L2_JPEG_MARKER_DHT;
709 parms->APPn = cam->APPn;
710 parms->APP_len = cam->APP_len;
711 if(cam->APP_len > 0) {
712 memcpy(parms->APP_data, cam->APP_data, cam->APP_len);
713 parms->jpeg_markers |= V4L2_JPEG_MARKER_APP;
716 parms->COM_len = cam->COM_len;
717 if(cam->COM_len > 0) {
718 memcpy(parms->COM_data, cam->COM_data, cam->COM_len);
719 parms->jpeg_markers |= JPEG_MARKER_COM;
722 DBG("G_JPEGCOMP APP_len:%d COM_len:%d\n",
723 parms->APP_len, parms->COM_len);
725 return 0;
728 /******************************************************************************
730 * ioctl_s_jpegcomp
732 * V4L2 set the JPEG compression parameters
733 * NOTE: quality and some jpeg_markers are ignored.
735 *****************************************************************************/
737 static int cpia2_s_jpegcomp(struct file *file, void *fh,
738 const struct v4l2_jpegcompression *parms)
740 struct camera_data *cam = video_drvdata(file);
742 DBG("S_JPEGCOMP APP_len:%d COM_len:%d\n",
743 parms->APP_len, parms->COM_len);
745 cam->params.compression.inhibit_htables =
746 !(parms->jpeg_markers & V4L2_JPEG_MARKER_DHT);
748 if(parms->APP_len != 0) {
749 if(parms->APP_len > 0 &&
750 parms->APP_len <= sizeof(cam->APP_data) &&
751 parms->APPn >= 0 && parms->APPn <= 15) {
752 cam->APPn = parms->APPn;
753 cam->APP_len = parms->APP_len;
754 memcpy(cam->APP_data, parms->APP_data, parms->APP_len);
755 } else {
756 LOG("Bad APPn Params n=%d len=%d\n",
757 parms->APPn, parms->APP_len);
758 return -EINVAL;
760 } else {
761 cam->APP_len = 0;
764 if(parms->COM_len != 0) {
765 if(parms->COM_len > 0 &&
766 parms->COM_len <= sizeof(cam->COM_data)) {
767 cam->COM_len = parms->COM_len;
768 memcpy(cam->COM_data, parms->COM_data, parms->COM_len);
769 } else {
770 LOG("Bad COM_len=%d\n", parms->COM_len);
771 return -EINVAL;
775 return 0;
778 /******************************************************************************
780 * ioctl_reqbufs
782 * V4L2 Initiate memory mapping.
783 * NOTE: The user's request is ignored. For now the buffers are fixed.
785 *****************************************************************************/
787 static int cpia2_reqbufs(struct file *file, void *fh, struct v4l2_requestbuffers *req)
789 struct camera_data *cam = video_drvdata(file);
791 if(req->type != V4L2_BUF_TYPE_VIDEO_CAPTURE ||
792 req->memory != V4L2_MEMORY_MMAP)
793 return -EINVAL;
795 DBG("REQBUFS requested:%d returning:%d\n", req->count, cam->num_frames);
796 req->count = cam->num_frames;
797 memset(&req->reserved, 0, sizeof(req->reserved));
799 return 0;
802 /******************************************************************************
804 * ioctl_querybuf
806 * V4L2 Query memory buffer status.
808 *****************************************************************************/
810 static int cpia2_querybuf(struct file *file, void *fh, struct v4l2_buffer *buf)
812 struct camera_data *cam = video_drvdata(file);
814 if(buf->type != V4L2_BUF_TYPE_VIDEO_CAPTURE ||
815 buf->index > cam->num_frames)
816 return -EINVAL;
818 buf->m.offset = cam->buffers[buf->index].data - cam->frame_buffer;
819 buf->length = cam->frame_size;
821 buf->memory = V4L2_MEMORY_MMAP;
823 if(cam->mmapped)
824 buf->flags = V4L2_BUF_FLAG_MAPPED;
825 else
826 buf->flags = 0;
828 buf->flags |= V4L2_BUF_FLAG_TIMESTAMP_MONOTONIC;
830 switch (cam->buffers[buf->index].status) {
831 case FRAME_EMPTY:
832 case FRAME_ERROR:
833 case FRAME_READING:
834 buf->bytesused = 0;
835 buf->flags = V4L2_BUF_FLAG_QUEUED;
836 break;
837 case FRAME_READY:
838 buf->bytesused = cam->buffers[buf->index].length;
839 buf->timestamp = cam->buffers[buf->index].timestamp;
840 buf->sequence = cam->buffers[buf->index].seq;
841 buf->flags = V4L2_BUF_FLAG_DONE;
842 break;
845 DBG("QUERYBUF index:%d offset:%d flags:%d seq:%d bytesused:%d\n",
846 buf->index, buf->m.offset, buf->flags, buf->sequence,
847 buf->bytesused);
849 return 0;
852 /******************************************************************************
854 * ioctl_qbuf
856 * V4L2 User is freeing buffer
858 *****************************************************************************/
860 static int cpia2_qbuf(struct file *file, void *fh, struct v4l2_buffer *buf)
862 struct camera_data *cam = video_drvdata(file);
864 if(buf->type != V4L2_BUF_TYPE_VIDEO_CAPTURE ||
865 buf->memory != V4L2_MEMORY_MMAP ||
866 buf->index > cam->num_frames)
867 return -EINVAL;
869 DBG("QBUF #%d\n", buf->index);
871 if(cam->buffers[buf->index].status == FRAME_READY)
872 cam->buffers[buf->index].status = FRAME_EMPTY;
874 return 0;
877 /******************************************************************************
879 * find_earliest_filled_buffer
881 * Helper for ioctl_dqbuf. Find the next ready buffer.
883 *****************************************************************************/
885 static int find_earliest_filled_buffer(struct camera_data *cam)
887 int i;
888 int found = -1;
889 for (i=0; i<cam->num_frames; i++) {
890 if(cam->buffers[i].status == FRAME_READY) {
891 if(found < 0) {
892 found = i;
893 } else {
894 /* find which buffer is earlier */
895 struct timeval *tv1, *tv2;
896 tv1 = &cam->buffers[i].timestamp;
897 tv2 = &cam->buffers[found].timestamp;
898 if(tv1->tv_sec < tv2->tv_sec ||
899 (tv1->tv_sec == tv2->tv_sec &&
900 tv1->tv_usec < tv2->tv_usec))
901 found = i;
905 return found;
908 /******************************************************************************
910 * ioctl_dqbuf
912 * V4L2 User is asking for a filled buffer.
914 *****************************************************************************/
916 static int cpia2_dqbuf(struct file *file, void *fh, struct v4l2_buffer *buf)
918 struct camera_data *cam = video_drvdata(file);
919 int frame;
921 if(buf->type != V4L2_BUF_TYPE_VIDEO_CAPTURE ||
922 buf->memory != V4L2_MEMORY_MMAP)
923 return -EINVAL;
925 frame = find_earliest_filled_buffer(cam);
927 if(frame < 0 && file->f_flags&O_NONBLOCK)
928 return -EAGAIN;
930 if(frame < 0) {
931 /* Wait for a frame to become available */
932 struct framebuf *cb=cam->curbuff;
933 mutex_unlock(&cam->v4l2_lock);
934 wait_event_interruptible(cam->wq_stream,
935 !video_is_registered(&cam->vdev) ||
936 (cb=cam->curbuff)->status == FRAME_READY);
937 mutex_lock(&cam->v4l2_lock);
938 if (signal_pending(current))
939 return -ERESTARTSYS;
940 if (!video_is_registered(&cam->vdev))
941 return -ENOTTY;
942 frame = cb->num;
946 buf->index = frame;
947 buf->bytesused = cam->buffers[buf->index].length;
948 buf->flags = V4L2_BUF_FLAG_MAPPED | V4L2_BUF_FLAG_DONE
949 | V4L2_BUF_FLAG_TIMESTAMP_MONOTONIC;
950 buf->field = V4L2_FIELD_NONE;
951 buf->timestamp = cam->buffers[buf->index].timestamp;
952 buf->sequence = cam->buffers[buf->index].seq;
953 buf->m.offset = cam->buffers[buf->index].data - cam->frame_buffer;
954 buf->length = cam->frame_size;
955 buf->reserved2 = 0;
956 buf->reserved = 0;
957 memset(&buf->timecode, 0, sizeof(buf->timecode));
959 DBG("DQBUF #%d status:%d seq:%d length:%d\n", buf->index,
960 cam->buffers[buf->index].status, buf->sequence, buf->bytesused);
962 return 0;
965 static int cpia2_streamon(struct file *file, void *fh, enum v4l2_buf_type type)
967 struct camera_data *cam = video_drvdata(file);
968 int ret = -EINVAL;
970 DBG("VIDIOC_STREAMON, streaming=%d\n", cam->streaming);
971 if (!cam->mmapped || type != V4L2_BUF_TYPE_VIDEO_CAPTURE)
972 return -EINVAL;
974 if (!cam->streaming) {
975 ret = cpia2_usb_stream_start(cam,
976 cam->params.camera_state.stream_mode);
977 if (!ret)
978 v4l2_ctrl_grab(cam->usb_alt, true);
980 return ret;
983 static int cpia2_streamoff(struct file *file, void *fh, enum v4l2_buf_type type)
985 struct camera_data *cam = video_drvdata(file);
986 int ret = -EINVAL;
988 DBG("VIDIOC_STREAMOFF, streaming=%d\n", cam->streaming);
989 if (!cam->mmapped || type != V4L2_BUF_TYPE_VIDEO_CAPTURE)
990 return -EINVAL;
992 if (cam->streaming) {
993 ret = cpia2_usb_stream_stop(cam);
994 if (!ret)
995 v4l2_ctrl_grab(cam->usb_alt, false);
997 return ret;
1000 /******************************************************************************
1002 * cpia2_mmap
1004 *****************************************************************************/
1005 static int cpia2_mmap(struct file *file, struct vm_area_struct *area)
1007 struct camera_data *cam = video_drvdata(file);
1008 int retval;
1010 if (mutex_lock_interruptible(&cam->v4l2_lock))
1011 return -ERESTARTSYS;
1012 retval = cpia2_remap_buffer(cam, area);
1014 if(!retval)
1015 cam->stream_fh = file->private_data;
1016 mutex_unlock(&cam->v4l2_lock);
1017 return retval;
1020 /******************************************************************************
1022 * reset_camera_struct_v4l
1024 * Sets all values to the defaults
1025 *****************************************************************************/
1026 static void reset_camera_struct_v4l(struct camera_data *cam)
1028 cam->width = cam->params.roi.width;
1029 cam->height = cam->params.roi.height;
1031 cam->frame_size = buffer_size;
1032 cam->num_frames = num_buffers;
1034 /* Flicker modes */
1035 cam->params.flicker_control.flicker_mode_req = flicker_mode;
1037 /* stream modes */
1038 cam->params.camera_state.stream_mode = alternate;
1040 cam->pixelformat = V4L2_PIX_FMT_JPEG;
1043 static const struct v4l2_ioctl_ops cpia2_ioctl_ops = {
1044 .vidioc_querycap = cpia2_querycap,
1045 .vidioc_enum_input = cpia2_enum_input,
1046 .vidioc_g_input = cpia2_g_input,
1047 .vidioc_s_input = cpia2_s_input,
1048 .vidioc_enum_fmt_vid_cap = cpia2_enum_fmt_vid_cap,
1049 .vidioc_g_fmt_vid_cap = cpia2_g_fmt_vid_cap,
1050 .vidioc_s_fmt_vid_cap = cpia2_s_fmt_vid_cap,
1051 .vidioc_try_fmt_vid_cap = cpia2_try_fmt_vid_cap,
1052 .vidioc_g_jpegcomp = cpia2_g_jpegcomp,
1053 .vidioc_s_jpegcomp = cpia2_s_jpegcomp,
1054 .vidioc_cropcap = cpia2_cropcap,
1055 .vidioc_reqbufs = cpia2_reqbufs,
1056 .vidioc_querybuf = cpia2_querybuf,
1057 .vidioc_qbuf = cpia2_qbuf,
1058 .vidioc_dqbuf = cpia2_dqbuf,
1059 .vidioc_streamon = cpia2_streamon,
1060 .vidioc_streamoff = cpia2_streamoff,
1061 .vidioc_s_parm = cpia2_s_parm,
1062 .vidioc_g_parm = cpia2_g_parm,
1063 .vidioc_enum_framesizes = cpia2_enum_framesizes,
1064 .vidioc_enum_frameintervals = cpia2_enum_frameintervals,
1065 .vidioc_subscribe_event = v4l2_ctrl_subscribe_event,
1066 .vidioc_unsubscribe_event = v4l2_event_unsubscribe,
1069 /***
1070 * The v4l video device structure initialized for this device
1071 ***/
1072 static const struct v4l2_file_operations cpia2_fops = {
1073 .owner = THIS_MODULE,
1074 .open = cpia2_open,
1075 .release = cpia2_close,
1076 .read = cpia2_v4l_read,
1077 .poll = cpia2_v4l_poll,
1078 .unlocked_ioctl = video_ioctl2,
1079 .mmap = cpia2_mmap,
1082 static struct video_device cpia2_template = {
1083 /* I could not find any place for the old .initialize initializer?? */
1084 .name = "CPiA2 Camera",
1085 .fops = &cpia2_fops,
1086 .ioctl_ops = &cpia2_ioctl_ops,
1087 .release = video_device_release_empty,
1090 void cpia2_camera_release(struct v4l2_device *v4l2_dev)
1092 struct camera_data *cam =
1093 container_of(v4l2_dev, struct camera_data, v4l2_dev);
1095 v4l2_ctrl_handler_free(&cam->hdl);
1096 v4l2_device_unregister(&cam->v4l2_dev);
1097 kfree(cam);
1100 static const struct v4l2_ctrl_ops cpia2_ctrl_ops = {
1101 .s_ctrl = cpia2_s_ctrl,
1104 /******************************************************************************
1106 * cpia2_register_camera
1108 *****************************************************************************/
1109 int cpia2_register_camera(struct camera_data *cam)
1111 struct v4l2_ctrl_handler *hdl = &cam->hdl;
1112 struct v4l2_ctrl_config cpia2_usb_alt = {
1113 .ops = &cpia2_ctrl_ops,
1114 .id = CPIA2_CID_USB_ALT,
1115 .name = "USB Alternate",
1116 .type = V4L2_CTRL_TYPE_INTEGER,
1117 .min = USBIF_ISO_1,
1118 .max = USBIF_ISO_6,
1119 .step = 1,
1121 int ret;
1123 v4l2_ctrl_handler_init(hdl, 12);
1124 v4l2_ctrl_new_std(hdl, &cpia2_ctrl_ops,
1125 V4L2_CID_BRIGHTNESS,
1126 cam->params.pnp_id.device_type == DEVICE_STV_672 ? 1 : 0,
1127 255, 1, DEFAULT_BRIGHTNESS);
1128 v4l2_ctrl_new_std(hdl, &cpia2_ctrl_ops,
1129 V4L2_CID_CONTRAST, 0, 255, 1, DEFAULT_CONTRAST);
1130 v4l2_ctrl_new_std(hdl, &cpia2_ctrl_ops,
1131 V4L2_CID_SATURATION, 0, 255, 1, DEFAULT_SATURATION);
1132 v4l2_ctrl_new_std(hdl, &cpia2_ctrl_ops,
1133 V4L2_CID_HFLIP, 0, 1, 1, 0);
1134 v4l2_ctrl_new_std(hdl, &cpia2_ctrl_ops,
1135 V4L2_CID_JPEG_ACTIVE_MARKER, 0,
1136 V4L2_JPEG_ACTIVE_MARKER_DHT, 0,
1137 V4L2_JPEG_ACTIVE_MARKER_DHT);
1138 v4l2_ctrl_new_std(hdl, &cpia2_ctrl_ops,
1139 V4L2_CID_JPEG_COMPRESSION_QUALITY, 1,
1140 100, 1, 100);
1141 cpia2_usb_alt.def = alternate;
1142 cam->usb_alt = v4l2_ctrl_new_custom(hdl, &cpia2_usb_alt, NULL);
1143 /* VP5 Only */
1144 if (cam->params.pnp_id.device_type != DEVICE_STV_672)
1145 v4l2_ctrl_new_std(hdl, &cpia2_ctrl_ops,
1146 V4L2_CID_VFLIP, 0, 1, 1, 0);
1147 /* Flicker control only valid for 672 */
1148 if (cam->params.pnp_id.device_type == DEVICE_STV_672)
1149 v4l2_ctrl_new_std_menu(hdl, &cpia2_ctrl_ops,
1150 V4L2_CID_POWER_LINE_FREQUENCY,
1151 V4L2_CID_POWER_LINE_FREQUENCY_60HZ, 0, 0);
1152 /* Light control only valid for the QX5 Microscope */
1153 if (cam->params.pnp_id.product == 0x151) {
1154 cam->top_light = v4l2_ctrl_new_std(hdl, &cpia2_ctrl_ops,
1155 V4L2_CID_ILLUMINATORS_1, 0, 1, 1, 0);
1156 cam->bottom_light = v4l2_ctrl_new_std(hdl, &cpia2_ctrl_ops,
1157 V4L2_CID_ILLUMINATORS_2, 0, 1, 1, 0);
1158 v4l2_ctrl_cluster(2, &cam->top_light);
1161 if (hdl->error) {
1162 ret = hdl->error;
1163 v4l2_ctrl_handler_free(hdl);
1164 return ret;
1167 cam->vdev = cpia2_template;
1168 video_set_drvdata(&cam->vdev, cam);
1169 cam->vdev.lock = &cam->v4l2_lock;
1170 cam->vdev.ctrl_handler = hdl;
1171 cam->vdev.v4l2_dev = &cam->v4l2_dev;
1172 set_bit(V4L2_FL_USE_FH_PRIO, &cam->vdev.flags);
1174 reset_camera_struct_v4l(cam);
1176 /* register v4l device */
1177 if (video_register_device(&cam->vdev, VFL_TYPE_GRABBER, video_nr) < 0) {
1178 ERR("video_register_device failed\n");
1179 return -ENODEV;
1182 return 0;
1185 /******************************************************************************
1187 * cpia2_unregister_camera
1189 *****************************************************************************/
1190 void cpia2_unregister_camera(struct camera_data *cam)
1192 video_unregister_device(&cam->vdev);
1195 /******************************************************************************
1197 * check_parameters
1199 * Make sure that all user-supplied parameters are sensible
1200 *****************************************************************************/
1201 static void __init check_parameters(void)
1203 if(buffer_size < PAGE_SIZE) {
1204 buffer_size = PAGE_SIZE;
1205 LOG("buffer_size too small, setting to %d\n", buffer_size);
1206 } else if(buffer_size > 1024*1024) {
1207 /* arbitrary upper limiit */
1208 buffer_size = 1024*1024;
1209 LOG("buffer_size ridiculously large, setting to %d\n",
1210 buffer_size);
1211 } else {
1212 buffer_size += PAGE_SIZE-1;
1213 buffer_size &= ~(PAGE_SIZE-1);
1216 if(num_buffers < 1) {
1217 num_buffers = 1;
1218 LOG("num_buffers too small, setting to %d\n", num_buffers);
1219 } else if(num_buffers > VIDEO_MAX_FRAME) {
1220 num_buffers = VIDEO_MAX_FRAME;
1221 LOG("num_buffers too large, setting to %d\n", num_buffers);
1224 if(alternate < USBIF_ISO_1 || alternate > USBIF_ISO_6) {
1225 alternate = DEFAULT_ALT;
1226 LOG("alternate specified is invalid, using %d\n", alternate);
1229 if (flicker_mode != 0 && flicker_mode != FLICKER_50 && flicker_mode != FLICKER_60) {
1230 flicker_mode = 0;
1231 LOG("Flicker mode specified is invalid, using %d\n",
1232 flicker_mode);
1235 DBG("Using %d buffers, each %d bytes, alternate=%d\n",
1236 num_buffers, buffer_size, alternate);
1239 /************ Module Stuff ***************/
1242 /******************************************************************************
1244 * cpia2_init/module_init
1246 *****************************************************************************/
1247 static int __init cpia2_init(void)
1249 LOG("%s v%s\n",
1250 ABOUT, CPIA_VERSION);
1251 check_parameters();
1252 cpia2_usb_init();
1253 return 0;
1257 /******************************************************************************
1259 * cpia2_exit/module_exit
1261 *****************************************************************************/
1262 static void __exit cpia2_exit(void)
1264 cpia2_usb_cleanup();
1265 schedule_timeout(2 * HZ);
1268 module_init(cpia2_init);
1269 module_exit(cpia2_exit);