stk11xx-v4l.c File Reference

Driver for Syntek USB video camera. More...

#include <linux/module.h>
#include <linux/init.h>
#include <linux/kernel.h>
#include <linux/version.h>
#include <linux/errno.h>
#include <linux/slab.h>
#include <linux/kref.h>
#include <linux/vmalloc.h>
#include <linux/mm.h>
#include <linux/videodev.h>
#include <linux/usb.h>
#include <media/v4l2-common.h>
#include <media/v4l2-ioctl.h>
#include "stk11xx.h"

Go to the source code of this file.

Functions

int v4l_stk11xx_select_video_mode (struct usb_stk11xx *dev, int width, int height)

Select a video mode.

static int v4l_stk11xx_open (struct file *fp)

Open the video device.

static int v4l_stk11xx_release (struct file *fp)

Release an opened file.

static ssize_t v4l_stk11xx_read (struct file *fp, char __user *buf, size_t count, loff_t *f_pos)

Read the video device.

static unsigned int v4l_stk11xx_poll (struct file *fp, poll_table *wait)

Polling function.

static int v4l_stk11xx_mmap (struct file *fp, struct vm_area_struct *vma)

Memory map.

static long v4l_stk11xx_do_ioctl (struct file *fp, unsigned int cmd, void __user *arg)

Manage IOCTL.

static long v4l_stk11xx_ioctl (struct file *fp, unsigned int cmd, unsigned long arg)

Manage IOCTL.

int v4l_stk11xx_register_video_device (struct usb_stk11xx *dev)

Register the video device.

int v4l_stk11xx_unregister_video_device (struct usb_stk11xx *dev)

Unregister the video device.

Variables

static struct v4l2_file_operations v4l_stk11xx_fops

struct stk11xx_coord stk11xx_image_sizes [STK11XX_NBR_SIZES]

static struct v4l2_queryctrl stk11xx_controls []

Detailed Description

Driver for Syntek USB video camera.

Author:: Nicolas VIVIEN

Date:: 2006-10-23

Version:: v2.0.x

Note:: Copyright (C) Nicolas VIVIEN

Licences

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA

SubVersion

Date: 2009-05-08 12:24:08 +0200 (ven 08 mai 2009)

Revision: 86

Author: nicklas79

HeadURL: https://syntekdriver.svn.sourceforge.net/svnroot/syntekdriver/tags/2.1.0/stk11xx-v4l.c

Definition in file stk11xx-v4l.c.

Function Documentation

static long v4l_stk11xx_do_ioctl	(	struct file *	fp,
		unsigned int	cmd,
		void __user *	arg
	)			`[static]`

Manage IOCTL.

Parameters:

	fp	File pointer
	cmd	Command
	arg	Arguments of the command

Returns:: 0 if all is OK

This function permits to manage all the IOCTL from the application.

Definition at line 612 of file stk11xx-v4l.c.

References dev_stk11xx_camera_asleep(), dev_stk11xx_camera_off(), dev_stk11xx_camera_on(), dev_stk11xx_camera_settings(), dev_stk11xx_init_camera(), dev_stk11xx_reconf_camera(), dev_stk11xx_start_stream(), dev_stk11xx_stop_stream(), DRIVER_VERSION_NUM, stk11xx_clear_buffers(), stk11xx_controls, stk11xx_handle_frame(), stk11xx_image_sizes, stk11xx_next_image(), STK11XX_SXGA, STK11XX_VGA, STK_DEBUG, STK_ERROR, usb_stk11xx_isoc_cleanup(), usb_stk11xx_isoc_init(), and v4l_stk11xx_select_video_mode().

Referenced by v4l_stk11xx_ioctl().

static long v4l_stk11xx_ioctl	(	struct file *	fp,
		unsigned int	cmd,
		unsigned long	arg
	)			`[static]`

Manage IOCTL.

Parameters:

	fp	File pointer
	cmd	Command
	arg	Arguements of the command

Returns:: 0 if all is OK

This function permits to manage all the IOCTL from the application.

Definition at line 1642 of file stk11xx-v4l.c.

References STK_DEBUG, and v4l_stk11xx_do_ioctl().

static int v4l_stk11xx_mmap	(	struct file *	fp,
		struct vm_area_struct *	vma
	)			`[static]`

Memory map.

Parameters:

	fp	File pointer
	vma	VMA structure

Returns:: 0 if all is OK

This function permits to map a memory space.

Definition at line 528 of file stk11xx-v4l.c.

References STK11XX_MAX_IMAGES, STK_ERROR, and STK_STREAM.

static int v4l_stk11xx_open ( struct file * fp ) [static]

Open the video device.

Parameters:

fp

File pointer

Returns:: 0 if all is OK

This function permits to open a video device (/dev/videoX)

Definition at line 255 of file stk11xx-v4l.c.

References dev_stk11xx_camera_on(), dev_stk11xx_camera_settings(), dev_stk11xx_init_camera(), dev_stk11xx_reconf_camera(), dev_stk11xx_start_stream(), stk11xx_allocate_buffers(), stk11xx_free_buffers(), stk11xx_reset_buffers(), STK_DEBUG, STK_ERROR, usb_stk11xx_isoc_cleanup(), usb_stk11xx_isoc_init(), and v4l_stk11xx_select_video_mode().

static unsigned int v4l_stk11xx_poll	(	struct file *	fp,
		poll_table *	wait
	)			`[static]`

Polling function.

Parameters:

	fp	File pointer
	wait

Returns:: 0 if all is OK

Definition at line 490 of file stk11xx-v4l.c.

References STK_STREAM.

static ssize_t v4l_stk11xx_read	(	struct file *	fp,
		char __user *	buf,
		size_t	count,
		loff_t *	f_pos
	)			`[static]`

Read the video device.

Parameters:

fp

File pointer

Return values:

	buf	Buffer in user space
	count
	f_pos

Returns:: Count value

This function is called by the application is reading the video device.

Definition at line 391 of file stk11xx-v4l.c.

References stk11xx_handle_frame(), stk11xx_next_image(), and STK_STREAM.

int v4l_stk11xx_register_video_device ( struct usb_stk11xx * dev )

Register the video device.

Parameters:

dev

Device structure

Returns:: 0 if all is OK

This function permits to register the USB device to the video device.

Definition at line 1679 of file stk11xx-v4l.c.

References DRIVER_DESC, STK_ERROR, STK_INFO, and v4l_stk11xx_fops.

Referenced by usb_stk11xx_probe().

static int v4l_stk11xx_release ( struct file * fp ) [static]

Release an opened file.

Parameters:

fp

File pointer

Returns:: 0 if all is OK

This function permits to release an opened file with the 'open' method.

Definition at line 344 of file stk11xx-v4l.c.

References dev_stk11xx_camera_asleep(), dev_stk11xx_camera_off(), dev_stk11xx_stop_stream(), stk11xx_free_buffers(), STK_ERROR, and usb_stk11xx_isoc_cleanup().

int v4l_stk11xx_select_video_mode	(	struct usb_stk11xx *	dev,
		int	width,
		int	height
	)

Select a video mode.

Parameters:

	dev
	width	Width of wished resolution
	height	Height of wished resolution

Returns:: 0 if all is OK

This function permits to check and select a video mode.

Definition at line 128 of file stk11xx-v4l.c.

References stk11xx_image_sizes, STK11XX_SXGA, STK11XX_VGA, and STK_DEBUG.

Referenced by v4l_stk11xx_do_ioctl(), and v4l_stk11xx_open().

int v4l_stk11xx_unregister_video_device ( struct usb_stk11xx * dev )

Unregister the video device.

Parameters:

dev

Device structure

Returns:: 0 if all is OK

This function permits to unregister the video device.

Definition at line 1712 of file stk11xx-v4l.c.

References STK_INFO.

Referenced by usb_stk11xx_disconnect().

Variable Documentation

stk11xx_controls [static]

List of all V4Lv2 controls supported by the driver

Definition at line 77 of file stk11xx-v4l.c.

Referenced by v4l_stk11xx_do_ioctl().

struct stk11xx_coord stk11xx_image_sizes[STK11XX_NBR_SIZES]

Initial value:

 {
    {   80,   60 },
    {  128,   96 },
    {  160,  120 },
    {  213,  160 },
    {  320,  240 },
    {  640,  480 },
    {  800,  600 },
    { 1024,  768 },
    { 1280, 1024 }
}

List of all resolutions supported by the driver

Definition at line 60 of file stk11xx-v4l.c.

Referenced by show_informations(), v4l_stk11xx_do_ioctl(), and v4l_stk11xx_select_video_mode().

static struct v4l2_file_operations v4l_stk11xx_fops [static, read]

Initial value:

 {
    .owner = THIS_MODULE,
    .open = v4l_stk11xx_open,
    .release = v4l_stk11xx_release,
    .read = v4l_stk11xx_read,
    .poll = v4l_stk11xx_poll,
    .mmap = v4l_stk11xx_mmap,
    .ioctl = v4l_stk11xx_ioctl,
}

This variable contains some callback

Definition at line 53 of file stk11xx-v4l.c.

Referenced by v4l_stk11xx_register_video_device().


Functions
int	v4l_stk11xx_select_video_mode (struct usb_stk11xx *dev, int width, int height)
	Select a video mode.
static int	v4l_stk11xx_open (struct file *fp)
	Open the video device.
static int	v4l_stk11xx_release (struct file *fp)
	Release an opened file.
static ssize_t	v4l_stk11xx_read (struct file fp, char __user buf, size_t count, loff_t *f_pos)
	Read the video device.
static unsigned int	v4l_stk11xx_poll (struct file fp, poll_table wait)
	Polling function.
static int	v4l_stk11xx_mmap (struct file fp, struct vm_area_struct vma)
	Memory map.
static long	v4l_stk11xx_do_ioctl (struct file fp, unsigned int cmd, void __user arg)
	Manage IOCTL.
static long	v4l_stk11xx_ioctl (struct file *fp, unsigned int cmd, unsigned long arg)
	Manage IOCTL.
int	v4l_stk11xx_register_video_device (struct usb_stk11xx *dev)
	Register the video device.
int	v4l_stk11xx_unregister_video_device (struct usb_stk11xx *dev)
	Unregister the video device.
Variables
static struct v4l2_file_operations	v4l_stk11xx_fops
struct stk11xx_coord	stk11xx_image_sizes [STK11XX_NBR_SIZES]
static struct v4l2_queryctrl	stk11xx_controls []