mirror of
https://github.com/torvalds/linux.git
synced 2024-11-11 06:31:49 +00:00
b5dcee225c
Currently, include/media is messy, as it contains both the V4L2 core headers and some driver-specific headers on the same place. That makes harder to identify what core headers should be documented and what headers belong to I2C drivers that are included only by bridge/main drivers that would require the functions provided by them. Let's move those i2c specific files to its own subdirectory. The files to move were produced via the following script: mkdir include/media/i2c (cd include/media; for i in *.h; do n=`echo $i|sed s/.h$/.c/`; if [ -e ../../drivers/media/i2c/$n ]; then echo $i; git mv $i i2c/; fi; done) (cd include/media; for i in *.h; do n=`echo $i|sed s/.h$/.c/`; if [ -e ../../drivers/media/*/i2c/$n ]; then echo $i; git mv $i i2c/; fi; done) for i in include/media/*.h; do n=`basename $i`; (for j in $(git grep -l $n); do dirname $j; done)|sort|uniq|grep -ve '^.$' > list; num=$(wc -l list|cut -d' ' -f1); if [ $num == 1 ]; then if [ "`grep i2c list`" != "" ]; then git mv $i include/media/i2c; fi; fi; done And the references corrected via this script: MAIN_DIR="media/" PREV_DIR="media/" DIRS="i2c/" echo "Checking affected files" >&2 for i in $DIRS; do for j in $(find include/$MAIN_DIR/$i -type f -name '*.h'); do n=`basename $j` git grep -l $n done done|sort|uniq >files && ( echo "Handling files..." >&2; echo "for i in \$(cat files|grep -v Documentation); do cat \$i | \\"; ( cd include/$MAIN_DIR; for j in $DIRS; do for i in $(ls $j); do echo "perl -ne 's,(include [\\\"\\<])$PREV_DIR($i)([\\\"\\>]),\1$MAIN_DIR$j\2\3,; print \$_' |\\"; done; done; echo "cat > a && mv a \$i; done"; ); echo "Handling documentation..." >&2; echo "for i in MAINTAINERS \$(cat files); do cat \$i | \\"; ( cd include/$MAIN_DIR; for j in $DIRS; do for i in $(ls $j); do echo " perl -ne 's,include/$PREV_DIR($i)\b,include/$MAIN_DIR$j\1,; print \$_' |\\"; done; done; echo "cat > a && mv a \$i; done" ); ) >script && . ./script Merged Sakari Ailus patch that moves smiapp.h to include/media/i2c. Signed-off-by: Mauro Carvalho Chehab <mchehab@osg.samsung.com> Acked-by: Arnd Bergmann <arnd@arndb.de>
809 lines
23 KiB
C
809 lines
23 KiB
C
/*
|
|
em28xx.h - driver for Empia EM2800/EM2820/2840 USB video capture devices
|
|
|
|
Copyright (C) 2005 Markus Rechberger <mrechberger@gmail.com>
|
|
Ludovico Cavedon <cavedon@sssup.it>
|
|
Mauro Carvalho Chehab <mchehab@infradead.org>
|
|
Copyright (C) 2012 Frank Schäfer <fschaefer.oss@googlemail.com>
|
|
|
|
Based on the em2800 driver from Sascha Sommer <saschasommer@freenet.de>
|
|
|
|
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
|
|
(at your option) 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., 675 Mass Ave, Cambridge, MA 02139, USA.
|
|
*/
|
|
|
|
#ifndef _EM28XX_H
|
|
#define _EM28XX_H
|
|
|
|
#define EM28XX_VERSION "0.2.1"
|
|
#define DRIVER_DESC "Empia em28xx device driver"
|
|
|
|
#include <linux/workqueue.h>
|
|
#include <linux/i2c.h>
|
|
#include <linux/mutex.h>
|
|
#include <linux/kref.h>
|
|
#include <linux/videodev2.h>
|
|
|
|
#include <media/videobuf2-v4l2.h>
|
|
#include <media/videobuf2-vmalloc.h>
|
|
#include <media/v4l2-device.h>
|
|
#include <media/v4l2-ctrls.h>
|
|
#include <media/v4l2-fh.h>
|
|
#include <media/i2c/ir-kbd-i2c.h>
|
|
#include <media/rc-core.h>
|
|
#include "tuner-xc2028.h"
|
|
#include "xc5000.h"
|
|
#include "em28xx-reg.h"
|
|
|
|
/* Boards supported by driver */
|
|
#define EM2800_BOARD_UNKNOWN 0
|
|
#define EM2820_BOARD_UNKNOWN 1
|
|
#define EM2820_BOARD_TERRATEC_CINERGY_250 2
|
|
#define EM2820_BOARD_PINNACLE_USB_2 3
|
|
#define EM2820_BOARD_HAUPPAUGE_WINTV_USB_2 4
|
|
#define EM2820_BOARD_MSI_VOX_USB_2 5
|
|
#define EM2800_BOARD_TERRATEC_CINERGY_200 6
|
|
#define EM2800_BOARD_LEADTEK_WINFAST_USBII 7
|
|
#define EM2800_BOARD_KWORLD_USB2800 8
|
|
#define EM2820_BOARD_PINNACLE_DVC_90 9
|
|
#define EM2880_BOARD_HAUPPAUGE_WINTV_HVR_900 10
|
|
#define EM2880_BOARD_TERRATEC_HYBRID_XS 11
|
|
#define EM2820_BOARD_KWORLD_PVRTV2800RF 12
|
|
#define EM2880_BOARD_TERRATEC_PRODIGY_XS 13
|
|
#define EM2820_BOARD_PROLINK_PLAYTV_USB2 14
|
|
#define EM2800_BOARD_VGEAR_POCKETTV 15
|
|
#define EM2883_BOARD_HAUPPAUGE_WINTV_HVR_950 16
|
|
#define EM2880_BOARD_PINNACLE_PCTV_HD_PRO 17
|
|
#define EM2880_BOARD_HAUPPAUGE_WINTV_HVR_900_R2 18
|
|
#define EM2860_BOARD_SAA711X_REFERENCE_DESIGN 19
|
|
#define EM2880_BOARD_AMD_ATI_TV_WONDER_HD_600 20
|
|
#define EM2800_BOARD_GRABBEEX_USB2800 21
|
|
#define EM2750_BOARD_UNKNOWN 22
|
|
#define EM2750_BOARD_DLCW_130 23
|
|
#define EM2820_BOARD_DLINK_USB_TV 24
|
|
#define EM2820_BOARD_GADMEI_UTV310 25
|
|
#define EM2820_BOARD_HERCULES_SMART_TV_USB2 26
|
|
#define EM2820_BOARD_PINNACLE_USB_2_FM1216ME 27
|
|
#define EM2820_BOARD_LEADTEK_WINFAST_USBII_DELUXE 28
|
|
#define EM2860_BOARD_TVP5150_REFERENCE_DESIGN 29
|
|
#define EM2820_BOARD_VIDEOLOGY_20K14XUSB 30
|
|
#define EM2821_BOARD_USBGEAR_VD204 31
|
|
#define EM2821_BOARD_SUPERCOMP_USB_2 32
|
|
#define EM2860_BOARD_ELGATO_VIDEO_CAPTURE 33
|
|
#define EM2860_BOARD_TERRATEC_HYBRID_XS 34
|
|
#define EM2860_BOARD_TYPHOON_DVD_MAKER 35
|
|
#define EM2860_BOARD_NETGMBH_CAM 36
|
|
#define EM2860_BOARD_GADMEI_UTV330 37
|
|
#define EM2861_BOARD_YAKUMO_MOVIE_MIXER 38
|
|
#define EM2861_BOARD_KWORLD_PVRTV_300U 39
|
|
#define EM2861_BOARD_PLEXTOR_PX_TV100U 40
|
|
#define EM2870_BOARD_KWORLD_350U 41
|
|
#define EM2870_BOARD_KWORLD_355U 42
|
|
#define EM2870_BOARD_TERRATEC_XS 43
|
|
#define EM2870_BOARD_TERRATEC_XS_MT2060 44
|
|
#define EM2870_BOARD_PINNACLE_PCTV_DVB 45
|
|
#define EM2870_BOARD_COMPRO_VIDEOMATE 46
|
|
#define EM2880_BOARD_KWORLD_DVB_305U 47
|
|
#define EM2880_BOARD_KWORLD_DVB_310U 48
|
|
#define EM2880_BOARD_MSI_DIGIVOX_AD 49
|
|
#define EM2880_BOARD_MSI_DIGIVOX_AD_II 50
|
|
#define EM2880_BOARD_TERRATEC_HYBRID_XS_FR 51
|
|
#define EM2881_BOARD_DNT_DA2_HYBRID 52
|
|
#define EM2881_BOARD_PINNACLE_HYBRID_PRO 53
|
|
#define EM2882_BOARD_KWORLD_VS_DVBT 54
|
|
#define EM2882_BOARD_TERRATEC_HYBRID_XS 55
|
|
#define EM2882_BOARD_PINNACLE_HYBRID_PRO_330E 56
|
|
#define EM2883_BOARD_KWORLD_HYBRID_330U 57
|
|
#define EM2820_BOARD_COMPRO_VIDEOMATE_FORYOU 58
|
|
#define EM2874_BOARD_PCTV_HD_MINI_80E 59
|
|
#define EM2883_BOARD_HAUPPAUGE_WINTV_HVR_850 60
|
|
#define EM2820_BOARD_PROLINK_PLAYTV_BOX4_USB2 61
|
|
#define EM2820_BOARD_GADMEI_TVR200 62
|
|
#define EM2860_BOARD_KAIOMY_TVNPC_U2 63
|
|
#define EM2860_BOARD_EASYCAP 64
|
|
#define EM2820_BOARD_IODATA_GVMVP_SZ 65
|
|
#define EM2880_BOARD_EMPIRE_DUAL_TV 66
|
|
#define EM2860_BOARD_TERRATEC_GRABBY 67
|
|
#define EM2860_BOARD_TERRATEC_AV350 68
|
|
#define EM2882_BOARD_KWORLD_ATSC_315U 69
|
|
#define EM2882_BOARD_EVGA_INDTUBE 70
|
|
#define EM2820_BOARD_SILVERCREST_WEBCAM 71
|
|
#define EM2861_BOARD_GADMEI_UTV330PLUS 72
|
|
#define EM2870_BOARD_REDDO_DVB_C_USB_BOX 73
|
|
#define EM2800_BOARD_VC211A 74
|
|
#define EM2882_BOARD_DIKOM_DK300 75
|
|
#define EM2870_BOARD_KWORLD_A340 76
|
|
#define EM2874_BOARD_LEADERSHIP_ISDBT 77
|
|
#define EM28174_BOARD_PCTV_290E 78
|
|
#define EM2884_BOARD_TERRATEC_H5 79
|
|
#define EM28174_BOARD_PCTV_460E 80
|
|
#define EM2884_BOARD_HAUPPAUGE_WINTV_HVR_930C 81
|
|
#define EM2884_BOARD_CINERGY_HTC_STICK 82
|
|
#define EM2860_BOARD_HT_VIDBOX_NW03 83
|
|
#define EM2874_BOARD_MAXMEDIA_UB425_TC 84
|
|
#define EM2884_BOARD_PCTV_510E 85
|
|
#define EM2884_BOARD_PCTV_520E 86
|
|
#define EM2884_BOARD_TERRATEC_HTC_USB_XS 87
|
|
#define EM2884_BOARD_C3TECH_DIGITAL_DUO 88
|
|
#define EM2874_BOARD_DELOCK_61959 89
|
|
#define EM2874_BOARD_KWORLD_UB435Q_V2 90
|
|
#define EM2765_BOARD_SPEEDLINK_VAD_LAPLACE 91
|
|
#define EM28178_BOARD_PCTV_461E 92
|
|
#define EM2874_BOARD_KWORLD_UB435Q_V3 93
|
|
#define EM28178_BOARD_PCTV_292E 94
|
|
#define EM2861_BOARD_LEADTEK_VC100 95
|
|
#define EM28178_BOARD_TERRATEC_T2_STICK_HD 96
|
|
#define EM2884_BOARD_ELGATO_EYETV_HYBRID_2008 97
|
|
|
|
/* Limits minimum and default number of buffers */
|
|
#define EM28XX_MIN_BUF 4
|
|
#define EM28XX_DEF_BUF 8
|
|
|
|
/*Limits the max URB message size */
|
|
#define URB_MAX_CTRL_SIZE 80
|
|
|
|
/* Params for validated field */
|
|
#define EM28XX_BOARD_NOT_VALIDATED 1
|
|
#define EM28XX_BOARD_VALIDATED 0
|
|
|
|
/* Params for em28xx_cmd() audio */
|
|
#define EM28XX_START_AUDIO 1
|
|
#define EM28XX_STOP_AUDIO 0
|
|
|
|
/* maximum number of em28xx boards */
|
|
#define EM28XX_MAXBOARDS 4 /*FIXME: should be bigger */
|
|
|
|
/* maximum number of frames that can be queued */
|
|
#define EM28XX_NUM_FRAMES 5
|
|
/* number of frames that get used for v4l2_read() */
|
|
#define EM28XX_NUM_READ_FRAMES 2
|
|
|
|
/* number of buffers for isoc transfers */
|
|
#define EM28XX_NUM_BUFS 5
|
|
#define EM28XX_DVB_NUM_BUFS 5
|
|
|
|
/* max number of I2C buses on em28xx devices */
|
|
#define NUM_I2C_BUSES 2
|
|
|
|
/* isoc transfers: number of packets for each buffer
|
|
windows requests only 64 packets .. so we better do the same
|
|
this is what I found out for all alternate numbers there!
|
|
*/
|
|
#define EM28XX_NUM_ISOC_PACKETS 64
|
|
#define EM28XX_DVB_NUM_ISOC_PACKETS 64
|
|
|
|
/* bulk transfers: transfer buffer size = packet size * packet multiplier
|
|
USB 2.0 spec says bulk packet size is always 512 bytes
|
|
*/
|
|
#define EM28XX_BULK_PACKET_MULTIPLIER 384
|
|
#define EM28XX_DVB_BULK_PACKET_MULTIPLIER 384
|
|
|
|
#define EM28XX_INTERLACED_DEFAULT 1
|
|
|
|
/*
|
|
* Time in msecs to wait for i2c xfers to finish.
|
|
* 35ms is the maximum time a SMBUS device could wait when
|
|
* clock stretching is used. As the transfer itself will take
|
|
* some time to happen, set it to 35 ms.
|
|
*
|
|
* Ok, I2C doesn't specify any limit. So, eventually, we may need
|
|
* to increase this timeout.
|
|
*
|
|
* FIXME: this assumes that an I2C message is not longer than 1ms.
|
|
* This is actually dependent on the I2C bus speed, although most
|
|
* devices use a 100kHz clock. So, this assumtion is true most of
|
|
* the time.
|
|
*/
|
|
#define EM28XX_I2C_XFER_TIMEOUT 36
|
|
|
|
/* time in msecs to wait for AC97 xfers to finish */
|
|
#define EM28XX_AC97_XFER_TIMEOUT 100
|
|
|
|
/* max. number of button state polling addresses */
|
|
#define EM28XX_NUM_BUTTON_ADDRESSES_MAX 5
|
|
|
|
enum em28xx_mode {
|
|
EM28XX_SUSPEND,
|
|
EM28XX_ANALOG_MODE,
|
|
EM28XX_DIGITAL_MODE,
|
|
};
|
|
|
|
struct em28xx;
|
|
|
|
struct em28xx_usb_bufs {
|
|
/* max packet size of isoc transaction */
|
|
int max_pkt_size;
|
|
|
|
/* number of packets in each buffer */
|
|
int num_packets;
|
|
|
|
/* number of allocated urbs */
|
|
int num_bufs;
|
|
|
|
/* urb for isoc/bulk transfers */
|
|
struct urb **urb;
|
|
|
|
/* transfer buffers for isoc/bulk transfer */
|
|
char **transfer_buffer;
|
|
};
|
|
|
|
struct em28xx_usb_ctl {
|
|
/* isoc/bulk transfer buffers for analog mode */
|
|
struct em28xx_usb_bufs analog_bufs;
|
|
|
|
/* isoc/bulk transfer buffers for digital mode */
|
|
struct em28xx_usb_bufs digital_bufs;
|
|
|
|
/* Stores already requested buffers */
|
|
struct em28xx_buffer *vid_buf;
|
|
struct em28xx_buffer *vbi_buf;
|
|
|
|
/* copy data from URB */
|
|
int (*urb_data_copy)(struct em28xx *dev, struct urb *urb);
|
|
|
|
};
|
|
|
|
/* Struct to enumberate video formats */
|
|
struct em28xx_fmt {
|
|
char *name;
|
|
u32 fourcc; /* v4l2 format id */
|
|
int depth;
|
|
int reg;
|
|
};
|
|
|
|
/* buffer for one video frame */
|
|
struct em28xx_buffer {
|
|
/* common v4l buffer stuff -- must be first */
|
|
struct vb2_v4l2_buffer vb;
|
|
struct list_head list;
|
|
|
|
void *mem;
|
|
unsigned int length;
|
|
int top_field;
|
|
|
|
/* counter to control buffer fill */
|
|
unsigned int pos;
|
|
/* NOTE; in interlaced mode, this value is reset to zero at
|
|
* the start of each new field (not frame !) */
|
|
|
|
/* pointer to vmalloc memory address in vb */
|
|
char *vb_buf;
|
|
};
|
|
|
|
struct em28xx_dmaqueue {
|
|
struct list_head active;
|
|
|
|
wait_queue_head_t wq;
|
|
};
|
|
|
|
/* inputs */
|
|
|
|
#define MAX_EM28XX_INPUT 4
|
|
enum enum28xx_itype {
|
|
EM28XX_VMUX_COMPOSITE1 = 1,
|
|
EM28XX_VMUX_COMPOSITE2,
|
|
EM28XX_VMUX_COMPOSITE3,
|
|
EM28XX_VMUX_COMPOSITE4,
|
|
EM28XX_VMUX_SVIDEO,
|
|
EM28XX_VMUX_TELEVISION,
|
|
EM28XX_VMUX_CABLE,
|
|
EM28XX_VMUX_DVB,
|
|
EM28XX_VMUX_DEBUG,
|
|
EM28XX_RADIO,
|
|
};
|
|
|
|
enum em28xx_ac97_mode {
|
|
EM28XX_NO_AC97 = 0,
|
|
EM28XX_AC97_EM202,
|
|
EM28XX_AC97_SIGMATEL,
|
|
EM28XX_AC97_OTHER,
|
|
};
|
|
|
|
struct em28xx_audio_mode {
|
|
enum em28xx_ac97_mode ac97;
|
|
};
|
|
|
|
enum em28xx_int_audio_type {
|
|
EM28XX_INT_AUDIO_NONE = 0,
|
|
EM28XX_INT_AUDIO_AC97,
|
|
EM28XX_INT_AUDIO_I2S,
|
|
};
|
|
|
|
enum em28xx_usb_audio_type {
|
|
EM28XX_USB_AUDIO_NONE = 0,
|
|
EM28XX_USB_AUDIO_CLASS,
|
|
EM28XX_USB_AUDIO_VENDOR,
|
|
};
|
|
|
|
/* em28xx has two audio inputs: tuner and line in.
|
|
However, on most devices, an auxiliary AC97 codec device is used.
|
|
The AC97 device may have several different inputs and outputs,
|
|
depending on their model. So, it is possible to use AC97 mixer to
|
|
address more than two different entries.
|
|
*/
|
|
enum em28xx_amux {
|
|
/* This is the only entry for em28xx tuner input */
|
|
EM28XX_AMUX_VIDEO, /* em28xx tuner, AC97 mixer Video */
|
|
|
|
EM28XX_AMUX_LINE_IN, /* AC97 mixer Line In */
|
|
|
|
/* Some less-common mixer setups */
|
|
EM28XX_AMUX_VIDEO2, /* em28xx Line in, AC97 mixer Video */
|
|
EM28XX_AMUX_PHONE,
|
|
EM28XX_AMUX_MIC,
|
|
EM28XX_AMUX_CD,
|
|
EM28XX_AMUX_AUX,
|
|
EM28XX_AMUX_PCM_OUT,
|
|
};
|
|
|
|
enum em28xx_aout {
|
|
/* AC97 outputs */
|
|
EM28XX_AOUT_MASTER = 1 << 0,
|
|
EM28XX_AOUT_LINE = 1 << 1,
|
|
EM28XX_AOUT_MONO = 1 << 2,
|
|
EM28XX_AOUT_LFE = 1 << 3,
|
|
EM28XX_AOUT_SURR = 1 << 4,
|
|
|
|
/* PCM IN Mixer - used by AC97_RECORD_SELECT register */
|
|
EM28XX_AOUT_PCM_IN = 1 << 7,
|
|
|
|
/* Bits 10-8 are used to indicate the PCM IN record select */
|
|
EM28XX_AOUT_PCM_MIC_PCM = 0 << 8,
|
|
EM28XX_AOUT_PCM_CD = 1 << 8,
|
|
EM28XX_AOUT_PCM_VIDEO = 2 << 8,
|
|
EM28XX_AOUT_PCM_AUX = 3 << 8,
|
|
EM28XX_AOUT_PCM_LINE = 4 << 8,
|
|
EM28XX_AOUT_PCM_STEREO = 5 << 8,
|
|
EM28XX_AOUT_PCM_MONO = 6 << 8,
|
|
EM28XX_AOUT_PCM_PHONE = 7 << 8,
|
|
};
|
|
|
|
static inline int ac97_return_record_select(int a_out)
|
|
{
|
|
return (a_out & 0x700) >> 8;
|
|
}
|
|
|
|
struct em28xx_reg_seq {
|
|
int reg;
|
|
unsigned char val, mask;
|
|
int sleep;
|
|
};
|
|
|
|
struct em28xx_input {
|
|
enum enum28xx_itype type;
|
|
unsigned int vmux;
|
|
enum em28xx_amux amux;
|
|
enum em28xx_aout aout;
|
|
struct em28xx_reg_seq *gpio;
|
|
};
|
|
|
|
#define INPUT(nr) (&em28xx_boards[dev->model].input[nr])
|
|
|
|
enum em28xx_decoder {
|
|
EM28XX_NODECODER = 0,
|
|
EM28XX_TVP5150,
|
|
EM28XX_SAA711X,
|
|
};
|
|
|
|
enum em28xx_sensor {
|
|
EM28XX_NOSENSOR = 0,
|
|
EM28XX_MT9V011,
|
|
EM28XX_MT9M001,
|
|
EM28XX_MT9M111,
|
|
EM28XX_OV2640,
|
|
};
|
|
|
|
enum em28xx_adecoder {
|
|
EM28XX_NOADECODER = 0,
|
|
EM28XX_TVAUDIO,
|
|
};
|
|
|
|
enum em28xx_led_role {
|
|
EM28XX_LED_ANALOG_CAPTURING = 0,
|
|
EM28XX_LED_DIGITAL_CAPTURING,
|
|
EM28XX_LED_ILLUMINATION,
|
|
EM28XX_NUM_LED_ROLES, /* must be the last */
|
|
};
|
|
|
|
struct em28xx_led {
|
|
enum em28xx_led_role role;
|
|
u8 gpio_reg;
|
|
u8 gpio_mask;
|
|
bool inverted;
|
|
};
|
|
|
|
enum em28xx_button_role {
|
|
EM28XX_BUTTON_SNAPSHOT = 0,
|
|
EM28XX_BUTTON_ILLUMINATION,
|
|
EM28XX_NUM_BUTTON_ROLES, /* must be the last */
|
|
};
|
|
|
|
struct em28xx_button {
|
|
enum em28xx_button_role role;
|
|
u8 reg_r;
|
|
u8 reg_clearing;
|
|
u8 mask;
|
|
bool inverted;
|
|
};
|
|
|
|
struct em28xx_board {
|
|
char *name;
|
|
int vchannels;
|
|
int tuner_type;
|
|
int tuner_addr;
|
|
unsigned def_i2c_bus; /* Default I2C bus */
|
|
|
|
/* i2c flags */
|
|
unsigned int tda9887_conf;
|
|
|
|
/* GPIO sequences */
|
|
struct em28xx_reg_seq *dvb_gpio;
|
|
struct em28xx_reg_seq *suspend_gpio;
|
|
struct em28xx_reg_seq *tuner_gpio;
|
|
struct em28xx_reg_seq *mute_gpio;
|
|
|
|
unsigned int is_em2800:1;
|
|
unsigned int has_msp34xx:1;
|
|
unsigned int mts_firmware:1;
|
|
unsigned int max_range_640_480:1;
|
|
unsigned int has_dvb:1;
|
|
unsigned int is_webcam:1;
|
|
unsigned int valid:1;
|
|
unsigned int has_ir_i2c:1;
|
|
|
|
unsigned char xclk, i2c_speed;
|
|
unsigned char radio_addr;
|
|
unsigned short tvaudio_addr;
|
|
|
|
enum em28xx_decoder decoder;
|
|
enum em28xx_adecoder adecoder;
|
|
|
|
struct em28xx_input input[MAX_EM28XX_INPUT];
|
|
struct em28xx_input radio;
|
|
char *ir_codes;
|
|
|
|
/* LEDs that need to be controlled explicitly */
|
|
struct em28xx_led *leds;
|
|
|
|
/* Buttons */
|
|
struct em28xx_button *buttons;
|
|
};
|
|
|
|
struct em28xx_eeprom {
|
|
u8 id[4]; /* 1a eb 67 95 */
|
|
__le16 vendor_ID;
|
|
__le16 product_ID;
|
|
|
|
__le16 chip_conf;
|
|
|
|
__le16 board_conf;
|
|
|
|
__le16 string1, string2, string3;
|
|
|
|
u8 string_idx_table;
|
|
};
|
|
|
|
#define EM28XX_CAPTURE_STREAM_EN 1
|
|
|
|
/* em28xx extensions */
|
|
#define EM28XX_AUDIO 0x10
|
|
#define EM28XX_DVB 0x20
|
|
#define EM28XX_RC 0x30
|
|
#define EM28XX_V4L2 0x40
|
|
|
|
/* em28xx resource types (used for res_get/res_lock etc */
|
|
#define EM28XX_RESOURCE_VIDEO 0x01
|
|
#define EM28XX_RESOURCE_VBI 0x02
|
|
|
|
struct em28xx_v4l2 {
|
|
struct kref ref;
|
|
struct em28xx *dev;
|
|
|
|
struct v4l2_device v4l2_dev;
|
|
struct v4l2_ctrl_handler ctrl_handler;
|
|
struct v4l2_clk *clk;
|
|
|
|
struct video_device vdev;
|
|
struct video_device vbi_dev;
|
|
struct video_device radio_dev;
|
|
|
|
/* Videobuf2 */
|
|
struct vb2_queue vb_vidq;
|
|
struct vb2_queue vb_vbiq;
|
|
struct mutex vb_queue_lock;
|
|
struct mutex vb_vbi_queue_lock;
|
|
|
|
u8 vinmode;
|
|
u8 vinctl;
|
|
|
|
/* Camera specific fields */
|
|
int sensor_xres;
|
|
int sensor_yres;
|
|
int sensor_xtal;
|
|
|
|
int users; /* user count for exclusive use */
|
|
int streaming_users; /* number of actively streaming users */
|
|
|
|
u32 frequency; /* selected tuner frequency */
|
|
|
|
struct em28xx_fmt *format;
|
|
v4l2_std_id norm; /* selected tv norm */
|
|
|
|
/* Progressive/interlaced mode */
|
|
bool progressive;
|
|
int interlaced_fieldmode; /* 1=interlaced fields, 0=just top fields */
|
|
/* FIXME: everything else than interlaced_fieldmode=1 doesn't work */
|
|
|
|
/* Frame properties */
|
|
int width; /* current frame width */
|
|
int height; /* current frame height */
|
|
unsigned hscale; /* horizontal scale factor (see datasheet) */
|
|
unsigned vscale; /* vertical scale factor (see datasheet) */
|
|
unsigned int vbi_width;
|
|
unsigned int vbi_height; /* lines per field */
|
|
|
|
/* Capture state tracking */
|
|
int capture_type;
|
|
bool top_field;
|
|
int vbi_read;
|
|
unsigned int field_count;
|
|
};
|
|
|
|
struct em28xx_audio {
|
|
char name[50];
|
|
unsigned num_urb;
|
|
char **transfer_buffer;
|
|
struct urb **urb;
|
|
struct usb_device *udev;
|
|
unsigned int capture_transfer_done;
|
|
struct snd_pcm_substream *capture_pcm_substream;
|
|
|
|
unsigned int hwptr_done_capture;
|
|
struct snd_card *sndcard;
|
|
|
|
size_t period;
|
|
|
|
int users;
|
|
spinlock_t slock;
|
|
|
|
/* Controls streaming */
|
|
struct work_struct wq_trigger; /* trigger to start/stop audio */
|
|
atomic_t stream_started; /* stream should be running if true */
|
|
};
|
|
|
|
struct em28xx;
|
|
|
|
enum em28xx_i2c_algo_type {
|
|
EM28XX_I2C_ALGO_EM28XX = 0,
|
|
EM28XX_I2C_ALGO_EM2800,
|
|
EM28XX_I2C_ALGO_EM25XX_BUS_B,
|
|
};
|
|
|
|
struct em28xx_i2c_bus {
|
|
struct em28xx *dev;
|
|
|
|
unsigned bus;
|
|
enum em28xx_i2c_algo_type algo_type;
|
|
};
|
|
|
|
/* main device struct */
|
|
struct em28xx {
|
|
struct kref ref;
|
|
|
|
/* Sub-module data */
|
|
struct em28xx_v4l2 *v4l2;
|
|
struct em28xx_dvb *dvb;
|
|
struct em28xx_audio adev;
|
|
struct em28xx_IR *ir;
|
|
|
|
/* generic device properties */
|
|
char name[30]; /* name (including minor) of the device */
|
|
int model; /* index in the device_data struct */
|
|
int devno; /* marks the number of this device */
|
|
enum em28xx_chip_id chip_id;
|
|
|
|
unsigned int is_em25xx:1; /* em25xx/em276x/7x/8x family bridge */
|
|
unsigned char disconnected:1; /* device has been diconnected */
|
|
unsigned int has_video:1;
|
|
unsigned int is_audio_only:1;
|
|
enum em28xx_int_audio_type int_audio_type;
|
|
enum em28xx_usb_audio_type usb_audio_type;
|
|
|
|
struct em28xx_board board;
|
|
|
|
enum em28xx_sensor em28xx_sensor; /* camera specific */
|
|
|
|
/* Some older em28xx chips needs a waiting time after writing */
|
|
unsigned int wait_after_write;
|
|
|
|
struct list_head devlist;
|
|
|
|
u32 i2s_speed; /* I2S speed for audio digital stream */
|
|
|
|
struct em28xx_audio_mode audio_mode;
|
|
|
|
int tuner_type; /* type of the tuner */
|
|
|
|
/* i2c i/o */
|
|
struct i2c_adapter i2c_adap[NUM_I2C_BUSES];
|
|
struct i2c_client i2c_client[NUM_I2C_BUSES];
|
|
struct em28xx_i2c_bus i2c_bus[NUM_I2C_BUSES];
|
|
|
|
unsigned char eeprom_addrwidth_16bit:1;
|
|
unsigned def_i2c_bus; /* Default I2C bus */
|
|
unsigned cur_i2c_bus; /* Current I2C bus */
|
|
struct rt_mutex i2c_bus_lock;
|
|
|
|
/* video for linux */
|
|
unsigned int ctl_input; /* selected input */
|
|
unsigned int ctl_ainput;/* selected audio input */
|
|
unsigned int ctl_aoutput;/* selected audio output */
|
|
int mute;
|
|
int volume;
|
|
|
|
unsigned long hash; /* eeprom hash - for boards with generic ID */
|
|
unsigned long i2c_hash; /* i2c devicelist hash -
|
|
for boards with generic ID */
|
|
|
|
struct work_struct request_module_wk;
|
|
|
|
/* locks */
|
|
struct mutex lock;
|
|
struct mutex ctrl_urb_lock; /* protects urb_buf */
|
|
|
|
/* resources in use */
|
|
unsigned int resources;
|
|
|
|
/* eeprom content */
|
|
u8 *eedata;
|
|
u16 eedata_len;
|
|
|
|
/* Isoc control struct */
|
|
struct em28xx_dmaqueue vidq;
|
|
struct em28xx_dmaqueue vbiq;
|
|
struct em28xx_usb_ctl usb_ctl;
|
|
spinlock_t slock;
|
|
|
|
/* usb transfer */
|
|
struct usb_device *udev; /* the usb device */
|
|
u8 ifnum; /* number of the assigned usb interface */
|
|
u8 analog_ep_isoc; /* address of isoc endpoint for analog */
|
|
u8 analog_ep_bulk; /* address of bulk endpoint for analog */
|
|
u8 dvb_ep_isoc; /* address of isoc endpoint for DVB */
|
|
u8 dvb_ep_bulk; /* address of bulk endpoint for DVB */
|
|
int alt; /* alternate setting */
|
|
int max_pkt_size; /* max packet size of the selected ep at alt */
|
|
int packet_multiplier; /* multiplier for wMaxPacketSize, used for
|
|
URB buffer size definition */
|
|
int num_alt; /* number of alternative settings */
|
|
unsigned int *alt_max_pkt_size_isoc; /* array of isoc wMaxPacketSize */
|
|
unsigned int analog_xfer_bulk:1; /* use bulk instead of isoc
|
|
transfers for analog */
|
|
int dvb_alt_isoc; /* alternate setting for DVB isoc transfers */
|
|
unsigned int dvb_max_pkt_size_isoc; /* isoc max packet size of the
|
|
selected DVB ep at dvb_alt */
|
|
unsigned int dvb_xfer_bulk:1; /* use bulk instead of isoc
|
|
transfers for DVB */
|
|
char urb_buf[URB_MAX_CTRL_SIZE]; /* urb control msg buffer */
|
|
|
|
/* helper funcs that call usb_control_msg */
|
|
int (*em28xx_write_regs)(struct em28xx *dev, u16 reg,
|
|
char *buf, int len);
|
|
int (*em28xx_read_reg)(struct em28xx *dev, u16 reg);
|
|
int (*em28xx_read_reg_req_len)(struct em28xx *dev, u8 req, u16 reg,
|
|
char *buf, int len);
|
|
int (*em28xx_write_regs_req)(struct em28xx *dev, u8 req, u16 reg,
|
|
char *buf, int len);
|
|
int (*em28xx_read_reg_req)(struct em28xx *dev, u8 req, u16 reg);
|
|
|
|
enum em28xx_mode mode;
|
|
|
|
/* Button state polling */
|
|
struct delayed_work buttons_query_work;
|
|
u8 button_polling_addresses[EM28XX_NUM_BUTTON_ADDRESSES_MAX];
|
|
u8 button_polling_last_values[EM28XX_NUM_BUTTON_ADDRESSES_MAX];
|
|
u8 num_button_polling_addresses;
|
|
u16 button_polling_interval; /* [ms] */
|
|
/* Snapshot button input device */
|
|
char snapshot_button_path[30]; /* path of the input dev */
|
|
struct input_dev *sbutton_input_dev;
|
|
};
|
|
|
|
#define kref_to_dev(d) container_of(d, struct em28xx, ref)
|
|
|
|
struct em28xx_ops {
|
|
struct list_head next;
|
|
char *name;
|
|
int id;
|
|
int (*init)(struct em28xx *);
|
|
int (*fini)(struct em28xx *);
|
|
int (*suspend)(struct em28xx *);
|
|
int (*resume)(struct em28xx *);
|
|
};
|
|
|
|
/* Provided by em28xx-i2c.c */
|
|
void em28xx_do_i2c_scan(struct em28xx *dev, unsigned bus);
|
|
int em28xx_i2c_register(struct em28xx *dev, unsigned bus,
|
|
enum em28xx_i2c_algo_type algo_type);
|
|
int em28xx_i2c_unregister(struct em28xx *dev, unsigned bus);
|
|
|
|
/* Provided by em28xx-core.c */
|
|
int em28xx_read_reg_req_len(struct em28xx *dev, u8 req, u16 reg,
|
|
char *buf, int len);
|
|
int em28xx_read_reg_req(struct em28xx *dev, u8 req, u16 reg);
|
|
int em28xx_read_reg(struct em28xx *dev, u16 reg);
|
|
int em28xx_write_regs_req(struct em28xx *dev, u8 req, u16 reg, char *buf,
|
|
int len);
|
|
int em28xx_write_regs(struct em28xx *dev, u16 reg, char *buf, int len);
|
|
int em28xx_write_reg(struct em28xx *dev, u16 reg, u8 val);
|
|
int em28xx_write_reg_bits(struct em28xx *dev, u16 reg, u8 val,
|
|
u8 bitmask);
|
|
int em28xx_toggle_reg_bits(struct em28xx *dev, u16 reg, u8 bitmask);
|
|
|
|
int em28xx_read_ac97(struct em28xx *dev, u8 reg);
|
|
int em28xx_write_ac97(struct em28xx *dev, u8 reg, u16 val);
|
|
|
|
int em28xx_audio_analog_set(struct em28xx *dev);
|
|
int em28xx_audio_setup(struct em28xx *dev);
|
|
|
|
const struct em28xx_led *em28xx_find_led(struct em28xx *dev,
|
|
enum em28xx_led_role role);
|
|
int em28xx_capture_start(struct em28xx *dev, int start);
|
|
int em28xx_alloc_urbs(struct em28xx *dev, enum em28xx_mode mode, int xfer_bulk,
|
|
int num_bufs, int max_pkt_size, int packet_multiplier);
|
|
int em28xx_init_usb_xfer(struct em28xx *dev, enum em28xx_mode mode,
|
|
int xfer_bulk,
|
|
int num_bufs, int max_pkt_size, int packet_multiplier,
|
|
int (*urb_data_copy)
|
|
(struct em28xx *dev, struct urb *urb));
|
|
void em28xx_uninit_usb_xfer(struct em28xx *dev, enum em28xx_mode mode);
|
|
void em28xx_stop_urbs(struct em28xx *dev);
|
|
int em28xx_set_mode(struct em28xx *dev, enum em28xx_mode set_mode);
|
|
int em28xx_gpio_set(struct em28xx *dev, struct em28xx_reg_seq *gpio);
|
|
int em28xx_register_extension(struct em28xx_ops *dev);
|
|
void em28xx_unregister_extension(struct em28xx_ops *dev);
|
|
void em28xx_init_extension(struct em28xx *dev);
|
|
void em28xx_close_extension(struct em28xx *dev);
|
|
int em28xx_suspend_extension(struct em28xx *dev);
|
|
int em28xx_resume_extension(struct em28xx *dev);
|
|
|
|
/* Provided by em28xx-cards.c */
|
|
extern struct em28xx_board em28xx_boards[];
|
|
extern struct usb_device_id em28xx_id_table[];
|
|
int em28xx_tuner_callback(void *ptr, int component, int command, int arg);
|
|
void em28xx_setup_xc3028(struct em28xx *dev, struct xc2028_ctrl *ctl);
|
|
void em28xx_free_device(struct kref *ref);
|
|
|
|
/* Provided by em28xx-camera.c */
|
|
int em28xx_detect_sensor(struct em28xx *dev);
|
|
int em28xx_init_camera(struct em28xx *dev);
|
|
|
|
/* printk macros */
|
|
|
|
#define em28xx_err(fmt, arg...) do {\
|
|
printk(KERN_ERR fmt , ##arg); } while (0)
|
|
|
|
#define em28xx_errdev(fmt, arg...) do {\
|
|
printk(KERN_ERR "%s: "fmt,\
|
|
dev->name , ##arg); } while (0)
|
|
|
|
#define em28xx_info(fmt, arg...) do {\
|
|
printk(KERN_INFO "%s: "fmt,\
|
|
dev->name , ##arg); } while (0)
|
|
#define em28xx_warn(fmt, arg...) do {\
|
|
printk(KERN_WARNING "%s: "fmt,\
|
|
dev->name , ##arg); } while (0)
|
|
|
|
#endif
|