SyntekUSBVideoCamera
Functions

stk11xx-dev.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/usb.h>
#include <media/v4l2-common.h>
#include <media/v4l2-ioctl.h>
#include "stk11xx.h"
#include "stk11xx-dev.h"

Go to the source code of this file.

Functions

int dev_stk11xx_initialize_device (struct usb_stk11xx *dev)
 This function permits to initialize the device.
int dev_stk11xx_init_camera (struct usb_stk11xx *dev)
 This function initializes the device for the stream.
int dev_stk11xx_check_device (struct usb_stk11xx *dev, int nbr)
 This function permits to check the device in reading the register 0x0201.
int dev_stk11xx_watchdog_camera (struct usb_stk11xx *dev)
 A espece of software watchdog.
int dev_stk11xx_camera_on (struct usb_stk11xx *dev)
 This function switchs on the camera.
int dev_stk11xx_camera_off (struct usb_stk11xx *dev)
 This function switchs off the camera.
int dev_stk11xx_camera_asleep (struct usb_stk11xx *dev)
 Wake-up the camera.
int dev_stk11xx_camera_settings (struct usb_stk11xx *dev)
 This function permits to modify the settings of the camera.
int dev_stk11xx_set_camera_quality (struct usb_stk11xx *dev)
 This function permits to modify the quality video of the camera.
int dev_stk11xx_set_camera_fps (struct usb_stk11xx *dev)
 This function permits to modify the fps of the camera.
int dev_stk11xx_start_stream (struct usb_stk11xx *dev)
 This function sets the device to start the stream.
int dev_stk11xx_reconf_camera (struct usb_stk11xx *dev)
 Reconfigure the camera before the stream.
int dev_stk11xx_stop_stream (struct usb_stk11xx *dev)
 This function sets the device to stop the stream.

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-03-25 15:13:05 +0100 (mer 25 mar 2009)
Revision:
84
Author:
nicklas79
HeadURL:
https://syntekdriver.svn.sourceforge.net/svnroot/syntekdriver/tags/2.1.0/stk11xx-dev.c

Definition in file stk11xx-dev.c.


Function Documentation

int dev_stk11xx_camera_asleep ( struct usb_stk11xx dev)

Wake-up the camera.

Parameters:
devDevice structure
Returns:
0 if all is OK

This function permits to wake-up the device.

Definition at line 287 of file stk11xx-dev.c.

References dev_stk6a31_camera_asleep(), dev_stk6a33_camera_asleep(), dev_stk6a51_camera_asleep(), dev_stk6a54_camera_asleep(), dev_stk6d51_camera_asleep(), dev_stka311_camera_asleep(), dev_stka821_camera_asleep(), and usb_stk11xx::webcam_model.

Referenced by v4l_stk11xx_do_ioctl(), and v4l_stk11xx_release().

int dev_stk11xx_camera_off ( struct usb_stk11xx dev)

This function switchs off the camera.

Parameters:
devDevice structure
Returns:
0 if all is OK

In fact, we choose the alternate interface '0'.

Definition at line 264 of file stk11xx-dev.c.

References STK_ERROR, and usb_stk11xx::udev.

Referenced by dev_stk6a31_init_camera(), dev_stk6a33_init_camera(), dev_stk6a51_init_camera(), dev_stka311_init_camera(), dev_stka821_init_camera(), usb_stk11xx_probe(), v4l_stk11xx_do_ioctl(), and v4l_stk11xx_release().

int dev_stk11xx_camera_on ( struct usb_stk11xx dev)

This function switchs on the camera.

Parameters:
devDevice structure
Returns:
0 if all is OK

In fact, we choose the alternate interface '5'.

Definition at line 241 of file stk11xx-dev.c.

References STK_ERROR, and usb_stk11xx::udev.

Referenced by usb_stk11xx_probe(), v4l_stk11xx_do_ioctl(), and v4l_stk11xx_open().

int dev_stk11xx_camera_settings ( struct usb_stk11xx dev)
int dev_stk11xx_check_device ( struct usb_stk11xx dev,
int  nbr 
)
int dev_stk11xx_init_camera ( struct usb_stk11xx dev)

This function initializes the device for the stream.

Parameters:
devDevice structure
Returns:
0 if all is OK

It's the start. This function has to be called at first, before enabling the video stream.

Definition at line 115 of file stk11xx-dev.c.

References dev_stk6a31_init_camera(), dev_stk6a33_init_camera(), dev_stk6a51_init_camera(), dev_stk6a54_init_camera(), dev_stk6d51_init_camera(), dev_stka311_init_camera(), dev_stka821_init_camera(), and usb_stk11xx::webcam_model.

Referenced by v4l_stk11xx_do_ioctl(), and v4l_stk11xx_open().

int dev_stk11xx_initialize_device ( struct usb_stk11xx dev)

This function permits to initialize the device.

Parameters:
devDevice structure
Returns:
0 if all is OK

This function must be called at first. It's the start of the initialization process. After this process, the device is completly initalized and it's ready.

This function is written from the USB log.

Definition at line 63 of file stk11xx-dev.c.

References dev_stk6a31_initialize_device(), dev_stk6a33_initialize_device(), dev_stk6a51_initialize_device(), dev_stk6a54_initialize_device(), dev_stk6d51_initialize_device(), dev_stka311_initialize_device(), dev_stka821_initialize_device(), and usb_stk11xx::webcam_model.

Referenced by usb_stk11xx_probe().

int dev_stk11xx_reconf_camera ( struct usb_stk11xx dev)

Reconfigure the camera before the stream.

Parameters:
devDevice structure
Returns:
0 if all is OK

Before enabling the video stream, you have to reconfigure the device.

Definition at line 552 of file stk11xx-dev.c.

References dev_stk6a31_reconf_camera(), dev_stk6a33_reconf_camera(), dev_stk6a51_reconf_camera(), dev_stk6a54_reconf_camera(), dev_stk6d51_reconf_camera(), dev_stka311_reconf_camera(), dev_stka821_reconf_camera(), and usb_stk11xx::webcam_model.

Referenced by v4l_stk11xx_do_ioctl(), and v4l_stk11xx_open().

int dev_stk11xx_set_camera_fps ( struct usb_stk11xx dev)

This function permits to modify the fps of the camera.

Parameters:
devDevice structure
Returns:
0 if all is OK

This functions permits to modify the frame rate per second of the camera. So the number of images per second.

Definition at line 449 of file stk11xx-dev.c.

References dev_stk6a31_set_camera_fps(), dev_stk6a33_set_camera_fps(), dev_stk6a51_set_camera_fps(), dev_stk6a54_set_camera_fps(), dev_stk6d51_set_camera_fps(), dev_stka311_set_camera_fps(), dev_stka821_set_camera_fps(), and usb_stk11xx::webcam_model.

int dev_stk11xx_set_camera_quality ( struct usb_stk11xx dev)

This function permits to modify the quality video of the camera.

Parameters:
devDevice structure
Returns:
0 if all is OK

This functions permits to modify the settings :

  • brightness
  • contrast
  • white balance
  • ...

Definition at line 397 of file stk11xx-dev.c.

References dev_stk6a31_set_camera_quality(), dev_stk6a33_set_camera_quality(), dev_stk6a51_set_camera_quality(), dev_stk6a54_set_camera_quality(), dev_stk6d51_set_camera_quality(), dev_stka311_set_camera_quality(), dev_stka821_set_camera_quality(), and usb_stk11xx::webcam_model.

Referenced by store_brightness(), store_colour(), store_contrast(), and store_whitebalance().

int dev_stk11xx_start_stream ( struct usb_stk11xx dev)

This function sets the device to start the stream.

Parameters:
devDevice structure
Returns:
0 if all is OK

After the initialization of the device and the initialization of the video stream, this function permits to enable the stream.

Definition at line 501 of file stk11xx-dev.c.

References dev_stk6a31_start_stream(), dev_stk6a33_start_stream(), dev_stk6a51_start_stream(), dev_stk6a54_start_stream(), dev_stk6d51_start_stream(), dev_stka311_start_stream(), dev_stka821_start_stream(), and usb_stk11xx::webcam_model.

Referenced by v4l_stk11xx_do_ioctl(), and v4l_stk11xx_open().

int dev_stk11xx_stop_stream ( struct usb_stk11xx dev)

This function sets the device to stop the stream.

Parameters:
devDevice structure
Returns:
0 if all is OK

You use the function start_stream to enable the video stream. So you have to use the function stop_strem to disable the video stream.

Definition at line 604 of file stk11xx-dev.c.

References dev_stk6a31_stop_stream(), dev_stk6a33_stop_stream(), dev_stk6a51_stop_stream(), dev_stk6a54_stop_stream(), dev_stk6d51_stop_stream(), dev_stka311_stop_stream(), dev_stka821_stop_stream(), and usb_stk11xx::webcam_model.

Referenced by v4l_stk11xx_do_ioctl(), and v4l_stk11xx_release().

int dev_stk11xx_watchdog_camera ( struct usb_stk11xx dev)

A espece of software watchdog.

Parameters:
devDevice structure
Returns:
Value of register 0x0001

This function reads periodically the value of register 0x0001.

We don't know the purpose. I assume that it seems to a software watchdog.

Definition at line 218 of file stk11xx-dev.c.

References STK_ERROR, and usb_stk11xx_read_registry().

Referenced by stk11xx_handle_frame().