847 lines · c
1/* SPDX-License-Identifier: GPL-2.0+ */2/*3 * em28xx.h - driver for Empia EM2800/EM2820/2840 USB video capture devices4 *5 * Copyright (C) 2005 Markus Rechberger <mrechberger@gmail.com>6 * Ludovico Cavedon <cavedon@sssup.it>7 * Mauro Carvalho Chehab <mchehab@kernel.org>8 * Copyright (C) 2012 Frank Schäfer <fschaefer.oss@googlemail.com>9 *10 * Based on the em2800 driver from Sascha Sommer <saschasommer@freenet.de>11 */12 13#ifndef _EM28XX_H14#define _EM28XX_H15 16#include <linux/bitfield.h>17 18#define EM28XX_VERSION "0.2.2"19#define DRIVER_DESC "Empia em28xx device driver"20 21#include <linux/workqueue.h>22#include <linux/i2c.h>23#include <linux/mutex.h>24#include <linux/kref.h>25#include <linux/videodev2.h>26 27#include <media/videobuf2-v4l2.h>28#include <media/videobuf2-vmalloc.h>29#include <media/v4l2-device.h>30#include <media/v4l2-ctrls.h>31#include <media/v4l2-fh.h>32#include <media/i2c/ir-kbd-i2c.h>33#include <media/rc-core.h>34#include "xc2028.h"35#include "xc5000.h"36#include "em28xx-reg.h"37 38/* Boards supported by driver */39#define EM2800_BOARD_UNKNOWN 040#define EM2820_BOARD_UNKNOWN 141#define EM2820_BOARD_TERRATEC_CINERGY_250 242#define EM2820_BOARD_PINNACLE_USB_2 343#define EM2820_BOARD_HAUPPAUGE_WINTV_USB_2 444#define EM2820_BOARD_MSI_VOX_USB_2 545#define EM2800_BOARD_TERRATEC_CINERGY_200 646#define EM2800_BOARD_LEADTEK_WINFAST_USBII 747#define EM2800_BOARD_KWORLD_USB2800 848#define EM2820_BOARD_PINNACLE_DVC_90 949#define EM2880_BOARD_HAUPPAUGE_WINTV_HVR_900 1050#define EM2880_BOARD_TERRATEC_HYBRID_XS 1151#define EM2820_BOARD_KWORLD_PVRTV2800RF 1252#define EM2880_BOARD_TERRATEC_PRODIGY_XS 1353#define EM2820_BOARD_PROLINK_PLAYTV_USB2 1454#define EM2800_BOARD_VGEAR_POCKETTV 1555#define EM2883_BOARD_HAUPPAUGE_WINTV_HVR_950 1656#define EM2880_BOARD_PINNACLE_PCTV_HD_PRO 1757#define EM2880_BOARD_HAUPPAUGE_WINTV_HVR_900_R2 1858#define EM2860_BOARD_SAA711X_REFERENCE_DESIGN 1959#define EM2880_BOARD_AMD_ATI_TV_WONDER_HD_600 2060#define EM2800_BOARD_GRABBEEX_USB2800 2161#define EM2750_BOARD_UNKNOWN 2262#define EM2750_BOARD_DLCW_130 2363#define EM2820_BOARD_DLINK_USB_TV 2464#define EM2820_BOARD_GADMEI_UTV310 2565#define EM2820_BOARD_HERCULES_SMART_TV_USB2 2666#define EM2820_BOARD_PINNACLE_USB_2_FM1216ME 2767#define EM2820_BOARD_LEADTEK_WINFAST_USBII_DELUXE 2868#define EM2860_BOARD_TVP5150_REFERENCE_DESIGN 2969#define EM2820_BOARD_VIDEOLOGY_20K14XUSB 3070#define EM2821_BOARD_USBGEAR_VD204 3171#define EM2821_BOARD_SUPERCOMP_USB_2 3272#define EM2860_BOARD_ELGATO_VIDEO_CAPTURE 3373#define EM2860_BOARD_TERRATEC_HYBRID_XS 3474#define EM2860_BOARD_TYPHOON_DVD_MAKER 3575#define EM2860_BOARD_NETGMBH_CAM 3676#define EM2860_BOARD_GADMEI_UTV330 3777#define EM2861_BOARD_YAKUMO_MOVIE_MIXER 3878#define EM2861_BOARD_KWORLD_PVRTV_300U 3979#define EM2861_BOARD_PLEXTOR_PX_TV100U 4080#define EM2870_BOARD_KWORLD_350U 4181#define EM2870_BOARD_KWORLD_355U 4282#define EM2870_BOARD_TERRATEC_XS 4383#define EM2870_BOARD_TERRATEC_XS_MT2060 4484#define EM2870_BOARD_PINNACLE_PCTV_DVB 4585#define EM2870_BOARD_COMPRO_VIDEOMATE 4686#define EM2880_BOARD_KWORLD_DVB_305U 4787#define EM2880_BOARD_KWORLD_DVB_310U 4888#define EM2880_BOARD_MSI_DIGIVOX_AD 4989#define EM2880_BOARD_MSI_DIGIVOX_AD_II 5090#define EM2880_BOARD_TERRATEC_HYBRID_XS_FR 5191#define EM2881_BOARD_DNT_DA2_HYBRID 5292#define EM2881_BOARD_PINNACLE_HYBRID_PRO 5393#define EM2882_BOARD_KWORLD_VS_DVBT 5494#define EM2882_BOARD_TERRATEC_HYBRID_XS 5595#define EM2882_BOARD_PINNACLE_HYBRID_PRO_330E 5696#define EM2883_BOARD_KWORLD_HYBRID_330U 5797#define EM2820_BOARD_COMPRO_VIDEOMATE_FORYOU 5898#define EM2874_BOARD_PCTV_HD_MINI_80E 5999#define EM2883_BOARD_HAUPPAUGE_WINTV_HVR_850 60100#define EM2820_BOARD_PROLINK_PLAYTV_BOX4_USB2 61101#define EM2820_BOARD_GADMEI_TVR200 62102#define EM2860_BOARD_KAIOMY_TVNPC_U2 63103#define EM2860_BOARD_EASYCAP 64104#define EM2820_BOARD_IODATA_GVMVP_SZ 65105#define EM2880_BOARD_EMPIRE_DUAL_TV 66106#define EM2860_BOARD_TERRATEC_GRABBY 67107#define EM2860_BOARD_TERRATEC_AV350 68108#define EM2882_BOARD_KWORLD_ATSC_315U 69109#define EM2882_BOARD_EVGA_INDTUBE 70110#define EM2820_BOARD_SILVERCREST_WEBCAM 71111#define EM2861_BOARD_GADMEI_UTV330PLUS 72112#define EM2870_BOARD_REDDO_DVB_C_USB_BOX 73113#define EM2800_BOARD_VC211A 74114#define EM2882_BOARD_DIKOM_DK300 75115#define EM2870_BOARD_KWORLD_A340 76116#define EM2874_BOARD_LEADERSHIP_ISDBT 77117#define EM28174_BOARD_PCTV_290E 78118#define EM2884_BOARD_TERRATEC_H5 79119#define EM28174_BOARD_PCTV_460E 80120#define EM2884_BOARD_HAUPPAUGE_WINTV_HVR_930C 81121#define EM2884_BOARD_CINERGY_HTC_STICK 82122#define EM2860_BOARD_HT_VIDBOX_NW03 83123#define EM2874_BOARD_MAXMEDIA_UB425_TC 84124#define EM2884_BOARD_PCTV_510E 85125#define EM2884_BOARD_PCTV_520E 86126#define EM2884_BOARD_TERRATEC_HTC_USB_XS 87127#define EM2884_BOARD_C3TECH_DIGITAL_DUO 88128#define EM2874_BOARD_DELOCK_61959 89129#define EM2874_BOARD_KWORLD_UB435Q_V2 90130#define EM2765_BOARD_SPEEDLINK_VAD_LAPLACE 91131#define EM28178_BOARD_PCTV_461E 92132#define EM2874_BOARD_KWORLD_UB435Q_V3 93133#define EM28178_BOARD_PCTV_292E 94134#define EM2861_BOARD_LEADTEK_VC100 95135#define EM28178_BOARD_TERRATEC_T2_STICK_HD 96136#define EM2884_BOARD_ELGATO_EYETV_HYBRID_2008 97137#define EM28178_BOARD_PLEX_PX_BCUD 98138#define EM28174_BOARD_HAUPPAUGE_WINTV_DUALHD_DVB 99139#define EM28174_BOARD_HAUPPAUGE_WINTV_DUALHD_01595 100140#define EM2884_BOARD_TERRATEC_H6 101141#define EM2882_BOARD_ZOLID_HYBRID_TV_STICK 102142#define EM2861_BOARD_MAGIX_VIDEOWANDLER2 103143#define EM28178_BOARD_PCTV_461E_V2 104144#define EM2860_BOARD_MYGICA_IGRABBER 105145#define EM2874_BOARD_HAUPPAUGE_USB_QUADHD 106146#define EM2860_BOARD_MYGICA_UTV3 107147 148/* Limits minimum and default number of buffers */149#define EM28XX_MIN_BUF 4150#define EM28XX_DEF_BUF 8151 152/*Limits the max URB message size */153#define URB_MAX_CTRL_SIZE 80154 155/* Params for validated field */156#define EM28XX_BOARD_NOT_VALIDATED 1157#define EM28XX_BOARD_VALIDATED 0158 159/* Params for em28xx_cmd() audio */160#define EM28XX_START_AUDIO 1161#define EM28XX_STOP_AUDIO 0162 163/* maximum number of em28xx boards */164#define EM28XX_MAXBOARDS DVB_MAX_ADAPTERS /* All adapters could be em28xx */165 166/* maximum number of frames that can be queued */167#define EM28XX_NUM_FRAMES 5168/* number of frames that get used for v4l2_read() */169#define EM28XX_NUM_READ_FRAMES 2170 171/* number of buffers for isoc transfers */172#define EM28XX_NUM_BUFS 5173#define EM28XX_DVB_NUM_BUFS 5174 175/* max number of I2C buses on em28xx devices */176#define NUM_I2C_BUSES 2177 178/*179 * isoc transfers: number of packets for each buffer180 * windows requests only 64 packets .. so we better do the same181 * this is what I found out for all alternate numbers there!182 */183#define EM28XX_NUM_ISOC_PACKETS 64184#define EM28XX_DVB_NUM_ISOC_PACKETS 64185 186/*187 * bulk transfers: transfer buffer size = packet size * packet multiplier188 * USB 2.0 spec says bulk packet size is always 512 bytes189 */190#define EM28XX_BULK_PACKET_MULTIPLIER 384191#define EM28XX_DVB_BULK_PACKET_MULTIPLIER 94192 193#define EM28XX_INTERLACED_DEFAULT 1194 195/* time in msecs to wait for AC97 xfers to finish */196#define EM28XX_AC97_XFER_TIMEOUT 100197 198/* max. number of button state polling addresses */199#define EM28XX_NUM_BUTTON_ADDRESSES_MAX 5200 201#define PRIMARY_TS 0202#define SECONDARY_TS 1203 204enum em28xx_mode {205 EM28XX_SUSPEND,206 EM28XX_ANALOG_MODE,207 EM28XX_DIGITAL_MODE,208};209 210struct em28xx;211 212/**213 * struct em28xx_usb_bufs - Contains URB-related buffer data214 *215 * @max_pkt_size: max packet size of isoc transaction216 * @num_packets: number of packets in each buffer217 * @num_bufs: number of allocated urb218 * @urb: urb for isoc/bulk transfers219 * @buf: transfer buffers for isoc/bulk transfer220 */221struct em28xx_usb_bufs {222 int max_pkt_size;223 int num_packets;224 int num_bufs;225 struct urb **urb;226 char **buf;227};228 229/**230 * struct em28xx_usb_ctl - Contains URB-related buffer data231 *232 * @analog_bufs: isoc/bulk transfer buffers for analog mode233 * @digital_bufs: isoc/bulk transfer buffers for digital mode234 * @vid_buf: Stores already requested video buffers235 * @vbi_buf: Stores already requested VBI buffers236 * @urb_data_copy: copy data from URB237 */238struct em28xx_usb_ctl {239 struct em28xx_usb_bufs analog_bufs;240 struct em28xx_usb_bufs digital_bufs;241 struct em28xx_buffer *vid_buf;242 struct em28xx_buffer *vbi_buf;243 int (*urb_data_copy)(struct em28xx *dev, struct urb *urb);244};245 246/**247 * struct em28xx_fmt - Struct to enumberate video formats248 *249 * @fourcc: v4l2 format id250 * @depth: mean number of bits to represent a pixel251 * @reg: em28xx register value to set it252 */253struct em28xx_fmt {254 u32 fourcc;255 int depth;256 int reg;257};258 259/**260 * struct em28xx_buffer- buffer for storing one video frame261 *262 * @vb: common v4l buffer stuff263 * @list: List to associate it with the other buffers264 * @mem: pointer to the buffer, as returned by vb2_plane_vaddr()265 * @length: length of the buffer, as returned by vb2_plane_size()266 * @top_field: If non-zero, indicate that the buffer is the top field267 * @pos: Indicate the next position of the buffer to be filled.268 * @vb_buf: pointer to vmalloc memory address in vb269 *270 * .. note::271 *272 * in interlaced mode, @pos is reset to zero at the start of each new273 * field (not frame !)274 */275struct em28xx_buffer {276 struct vb2_v4l2_buffer vb; /* must be first */277 278 struct list_head list;279 280 void *mem;281 unsigned int length;282 int top_field;283 284 unsigned int pos;285 286 char *vb_buf;287};288 289struct em28xx_dmaqueue {290 struct list_head active;291 292 wait_queue_head_t wq;293};294 295/* inputs */296 297#define MAX_EM28XX_INPUT 4298enum enum28xx_itype {299 EM28XX_VMUX_COMPOSITE = 1,300 EM28XX_VMUX_SVIDEO,301 EM28XX_VMUX_TELEVISION,302 EM28XX_RADIO,303};304 305enum em28xx_ac97_mode {306 EM28XX_NO_AC97 = 0,307 EM28XX_AC97_EM202,308 EM28XX_AC97_SIGMATEL,309 EM28XX_AC97_OTHER,310};311 312struct em28xx_audio_mode {313 enum em28xx_ac97_mode ac97;314};315 316enum em28xx_int_audio_type {317 EM28XX_INT_AUDIO_NONE = 0,318 EM28XX_INT_AUDIO_AC97,319 EM28XX_INT_AUDIO_I2S,320};321 322enum em28xx_usb_audio_type {323 EM28XX_USB_AUDIO_NONE = 0,324 EM28XX_USB_AUDIO_CLASS,325 EM28XX_USB_AUDIO_VENDOR,326};327 328/**329 * enum em28xx_amux - describes the type of audio input used by em28xx330 *331 * @EM28XX_AMUX_UNUSED:332 * Used only on em28xx dev->map field, in order to mark an entry333 * as unused.334 * @EM28XX_AMUX_VIDEO:335 * On devices without AC97, this is the only value that it is currently336 * allowed.337 * On devices with AC97, it corresponds to the AC97 mixer "Video" control.338 * @EM28XX_AMUX_LINE_IN:339 * Only for devices with AC97. Corresponds to AC97 mixer "Line In".340 * @EM28XX_AMUX_VIDEO2:341 * Only for devices with AC97. It means that em28xx should use "Line In"342 * And AC97 should use the "Video" mixer control.343 * @EM28XX_AMUX_PHONE:344 * Only for devices with AC97. Corresponds to AC97 mixer "Phone".345 * @EM28XX_AMUX_MIC:346 * Only for devices with AC97. Corresponds to AC97 mixer "Mic".347 * @EM28XX_AMUX_CD:348 * Only for devices with AC97. Corresponds to AC97 mixer "CD".349 * @EM28XX_AMUX_AUX:350 * Only for devices with AC97. Corresponds to AC97 mixer "Aux".351 * @EM28XX_AMUX_PCM_OUT:352 * Only for devices with AC97. Corresponds to AC97 mixer "PCM out".353 *354 * The em28xx chip itself has only two audio inputs: tuner and line in.355 * On almost all devices, only the tuner input is used.356 *357 * However, on most devices, an auxiliary AC97 codec device is used,358 * usually connected to the em28xx tuner input (except for359 * @EM28XX_AMUX_LINE_IN).360 *361 * The AC97 device typically have several different inputs and outputs.362 * The exact number and description depends on their model.363 *364 * It is possible to AC97 to mixer more than one different entries at the365 * same time, via the alsa mux.366 */367enum em28xx_amux {368 EM28XX_AMUX_UNUSED = -1,369 EM28XX_AMUX_VIDEO = 0,370 EM28XX_AMUX_LINE_IN,371 372 /* Some less-common mixer setups */373 EM28XX_AMUX_VIDEO2,374 EM28XX_AMUX_PHONE,375 EM28XX_AMUX_MIC,376 EM28XX_AMUX_CD,377 EM28XX_AMUX_AUX,378 EM28XX_AMUX_PCM_OUT,379};380 381enum em28xx_aout {382 /* AC97 outputs */383 EM28XX_AOUT_MASTER = BIT(0),384 EM28XX_AOUT_LINE = BIT(1),385 EM28XX_AOUT_MONO = BIT(2),386 EM28XX_AOUT_LFE = BIT(3),387 EM28XX_AOUT_SURR = BIT(4),388 389 /* PCM IN Mixer - used by AC97_RECORD_SELECT register */390 EM28XX_AOUT_PCM_IN = BIT(7),391 392 /* Bits 10-8 are used to indicate the PCM IN record select */393 EM28XX_AOUT_PCM_MIC_PCM = 0 << 8,394 EM28XX_AOUT_PCM_CD = 1 << 8,395 EM28XX_AOUT_PCM_VIDEO = 2 << 8,396 EM28XX_AOUT_PCM_AUX = 3 << 8,397 EM28XX_AOUT_PCM_LINE = 4 << 8,398 EM28XX_AOUT_PCM_STEREO = 5 << 8,399 EM28XX_AOUT_PCM_MONO = 6 << 8,400 EM28XX_AOUT_PCM_PHONE = 7 << 8,401};402 403static inline int ac97_return_record_select(int a_out)404{405 return (a_out & 0x700) >> 8;406}407 408struct em28xx_reg_seq {409 int reg;410 unsigned char val, mask;411 int sleep;412};413 414struct em28xx_input {415 enum enum28xx_itype type;416 unsigned int vmux;417 enum em28xx_amux amux;418 enum em28xx_aout aout;419 const struct em28xx_reg_seq *gpio;420};421 422#define INPUT(nr) (&em28xx_boards[dev->model].input[nr])423 424enum em28xx_decoder {425 EM28XX_NODECODER = 0,426 EM28XX_TVP5150,427 EM28XX_SAA711X,428};429 430enum em28xx_sensor {431 EM28XX_NOSENSOR = 0,432 EM28XX_MT9V011,433 EM28XX_MT9M001,434 EM28XX_MT9M111,435 EM28XX_OV2640,436};437 438enum em28xx_adecoder {439 EM28XX_NOADECODER = 0,440 EM28XX_TVAUDIO,441};442 443enum em28xx_led_role {444 EM28XX_LED_ANALOG_CAPTURING = 0,445 EM28XX_LED_DIGITAL_CAPTURING,446 EM28XX_LED_DIGITAL_CAPTURING_TS2,447 EM28XX_LED_ILLUMINATION,448 EM28XX_NUM_LED_ROLES, /* must be the last */449};450 451struct em28xx_led {452 enum em28xx_led_role role;453 u8 gpio_reg;454 u8 gpio_mask;455 bool inverted;456};457 458enum em28xx_button_role {459 EM28XX_BUTTON_SNAPSHOT = 0,460 EM28XX_BUTTON_ILLUMINATION,461 EM28XX_NUM_BUTTON_ROLES, /* must be the last */462};463 464struct em28xx_button {465 enum em28xx_button_role role;466 u8 reg_r;467 u8 reg_clearing;468 u8 mask;469 bool inverted;470};471 472struct em28xx_board {473 char *name;474 int vchannels;475 int tuner_type;476 int tuner_addr;477 unsigned int def_i2c_bus; /* Default I2C bus */478 479 /* i2c flags */480 unsigned int tda9887_conf;481 482 /* GPIO sequences */483 const struct em28xx_reg_seq *dvb_gpio;484 const struct em28xx_reg_seq *suspend_gpio;485 const struct em28xx_reg_seq *tuner_gpio;486 const struct em28xx_reg_seq *mute_gpio;487 488 unsigned int is_em2800:1;489 unsigned int has_msp34xx:1;490 unsigned int mts_firmware:1;491 unsigned int max_range_640_480:1;492 unsigned int has_dvb:1;493 unsigned int has_dual_ts:1;494 unsigned int is_webcam:1;495 unsigned int valid:1;496 unsigned int has_ir_i2c:1;497 498 unsigned char xclk, i2c_speed;499 unsigned char radio_addr;500 unsigned short tvaudio_addr;501 502 enum em28xx_decoder decoder;503 enum em28xx_adecoder adecoder;504 505 struct em28xx_input input[MAX_EM28XX_INPUT];506 struct em28xx_input radio;507 char *ir_codes;508 509 /* LEDs that need to be controlled explicitly */510 struct em28xx_led *leds;511 512 /* Buttons */513 const struct em28xx_button *buttons;514};515 516struct em28xx_eeprom {517 u8 id[4]; /* 1a eb 67 95 */518 __le16 vendor_ID;519 __le16 product_ID;520 521 __le16 chip_conf;522 523 __le16 board_conf;524 525 __le16 string1, string2, string3;526 527 u8 string_idx_table;528};529 530#define EM28XX_CAPTURE_STREAM_EN 1531 532/* em28xx extensions */533#define EM28XX_AUDIO 0x10534#define EM28XX_DVB 0x20535#define EM28XX_RC 0x30536#define EM28XX_V4L2 0x40537 538/* em28xx resource types (used for res_get/res_lock etc */539#define EM28XX_RESOURCE_VIDEO 0x01540#define EM28XX_RESOURCE_VBI 0x02541 542struct em28xx_v4l2 {543 struct kref ref;544 struct em28xx *dev;545 546 struct v4l2_device v4l2_dev;547 struct v4l2_ctrl_handler ctrl_handler;548 549 struct video_device vdev;550 struct video_device vbi_dev;551 struct video_device radio_dev;552 553 /* Videobuf2 */554 struct vb2_queue vb_vidq;555 struct vb2_queue vb_vbiq;556 struct mutex vb_queue_lock; /* Protects vb_vidq */557 struct mutex vb_vbi_queue_lock; /* Protects vb_vbiq */558 559 u8 vinmode;560 u8 vinctl;561 562 /* Camera specific fields */563 int sensor_xres;564 int sensor_yres;565 int sensor_xtal;566 567 int users; /* user count for exclusive use */568 int streaming_users; /* number of actively streaming users */569 570 u32 frequency; /* selected tuner frequency */571 572 struct em28xx_fmt *format;573 v4l2_std_id norm; /* selected tv norm */574 575 /* Progressive/interlaced mode */576 bool progressive;577 int interlaced_fieldmode; /* 1=interlaced fields, 0=just top fields */578 /* FIXME: everything else than interlaced_fieldmode=1 doesn't work */579 580 /* Frame properties */581 int width; /* current frame width */582 int height; /* current frame height */583 unsigned int hscale; /* horizontal scale factor (see datasheet) */584 unsigned int vscale; /* vertical scale factor (see datasheet) */585 unsigned int vbi_width;586 unsigned int vbi_height; /* lines per field */587 588 /* Capture state tracking */589 int capture_type;590 bool top_field;591 int vbi_read;592 unsigned int field_count;593 594#ifdef CONFIG_MEDIA_CONTROLLER595 struct media_pad video_pad, vbi_pad;596 struct media_entity *decoder;597#endif598};599 600struct em28xx_audio {601 char name[50];602 unsigned int num_urb;603 char **transfer_buffer;604 struct urb **urb;605 struct usb_device *udev;606 unsigned int capture_transfer_done;607 struct snd_pcm_substream *capture_pcm_substream;608 609 unsigned int hwptr_done_capture;610 struct snd_card *sndcard;611 612 size_t period;613 614 int users;615 spinlock_t slock; /* Protects struct em28xx_audio */616 617 /* Controls streaming */618 struct work_struct wq_trigger; /* trigger to start/stop audio */619 atomic_t stream_started; /* stream should be running if true */620};621 622enum em28xx_i2c_algo_type {623 EM28XX_I2C_ALGO_EM28XX = 0,624 EM28XX_I2C_ALGO_EM2800,625 EM28XX_I2C_ALGO_EM25XX_BUS_B,626};627 628struct em28xx_i2c_bus {629 struct em28xx *dev;630 631 unsigned int bus;632 enum em28xx_i2c_algo_type algo_type;633};634 635/* main device struct */636struct em28xx {637 struct kref ref;638 639 // Sub-module data640 struct em28xx_v4l2 *v4l2;641 struct em28xx_dvb *dvb;642 struct em28xx_audio adev;643 struct em28xx_IR *ir;644 645 // generic device properties646 int model; // index in the device_data struct647 int devno; // marks the number of this device648 enum em28xx_chip_id chip_id;649 650 unsigned int is_em25xx:1; // em25xx/em276x/7x/8x family bridge651 unsigned int disconnected:1; // device has been disconnected652 unsigned int has_video:1;653 unsigned int is_audio_only:1;654 unsigned int is_webcam:1;655 unsigned int has_msp34xx:1;656 unsigned int i2c_speed:2;657 enum em28xx_int_audio_type int_audio_type;658 enum em28xx_usb_audio_type usb_audio_type;659 unsigned char name[32];660 661 struct em28xx_board board;662 663 enum em28xx_sensor em28xx_sensor; // camera specific664 665 // Some older em28xx chips needs a waiting time after writing666 unsigned int wait_after_write;667 668 struct list_head devlist;669 670 u32 i2s_speed; // I2S speed for audio digital stream671 672 struct em28xx_audio_mode audio_mode;673 674 int tuner_type; // type of the tuner675 676 // i2c i/o677 struct i2c_adapter i2c_adap[NUM_I2C_BUSES];678 struct i2c_client i2c_client[NUM_I2C_BUSES];679 struct em28xx_i2c_bus i2c_bus[NUM_I2C_BUSES];680 681 unsigned char eeprom_addrwidth_16bit:1;682 unsigned int def_i2c_bus; // Default I2C bus683 unsigned int cur_i2c_bus; // Current I2C bus684 struct rt_mutex i2c_bus_lock;685 686 // video for linux687 unsigned int ctl_input; // selected input688 unsigned int ctl_ainput;// selected audio input689 unsigned int ctl_aoutput;// selected audio output690 enum em28xx_amux amux_map[MAX_EM28XX_INPUT];691 692 int mute;693 int volume;694 695 unsigned long hash; // eeprom hash - for boards with generic ID696 unsigned long i2c_hash; // i2c devicelist hash -697 // for boards with generic ID698 699 struct work_struct request_module_wk;700 701 // locks702 struct mutex lock; /* protects em28xx struct */703 struct mutex ctrl_urb_lock; /* protects urb_buf */704 705 // resources in use706 unsigned int resources;707 708 // eeprom content709 u8 *eedata;710 u16 eedata_len;711 712 // Isoc control struct713 struct em28xx_dmaqueue vidq;714 struct em28xx_dmaqueue vbiq;715 struct em28xx_usb_ctl usb_ctl;716 717 spinlock_t slock; /* Protects em28xx video/vbi/dvb IRQ stream data */718 719 // usb transfer720 struct usb_interface *intf; // the usb interface721 u8 ifnum; // number of the assigned usb interface722 u8 analog_ep_isoc; // address of isoc endpoint for analog723 u8 analog_ep_bulk; // address of bulk endpoint for analog724 u8 dvb_ep_isoc_ts2; // address of isoc endpoint for DVB TS2725 u8 dvb_ep_bulk_ts2; // address of bulk endpoint for DVB TS2726 u8 dvb_ep_isoc; // address of isoc endpoint for DVB727 u8 dvb_ep_bulk; // address of bulk endpoint for DVB728 int alt; // alternate setting729 int max_pkt_size; // max packet size of the selected ep at alt730 int packet_multiplier; // multiplier for wMaxPacketSize, used for731 // URB buffer size definition732 int num_alt; // number of alternative settings733 unsigned int *alt_max_pkt_size_isoc; // array of isoc wMaxPacketSize734 unsigned int analog_xfer_bulk:1; // use bulk instead of isoc735 // transfers for analog736 int dvb_alt_isoc; // alternate setting for DVB isoc transfers737 unsigned int dvb_max_pkt_size_isoc; // isoc max packet size of the738 // selected DVB ep at dvb_alt739 unsigned int dvb_max_pkt_size_isoc_ts2; // isoc max packet size of the740 // selected DVB ep at dvb_alt741 unsigned int dvb_xfer_bulk:1; // use bulk instead of isoc742 // transfers for DVB743 char urb_buf[URB_MAX_CTRL_SIZE]; // urb control msg buffer744 745 // helper funcs that call usb_control_msg746 int (*em28xx_write_regs)(struct em28xx *dev, u16 reg,747 char *buf, int len);748 int (*em28xx_read_reg)(struct em28xx *dev, u16 reg);749 int (*em28xx_read_reg_req_len)(struct em28xx *dev, u8 req, u16 reg,750 char *buf, int len);751 int (*em28xx_write_regs_req)(struct em28xx *dev, u8 req, u16 reg,752 char *buf, int len);753 int (*em28xx_read_reg_req)(struct em28xx *dev, u8 req, u16 reg);754 755 enum em28xx_mode mode;756 757 // Button state polling758 struct delayed_work buttons_query_work;759 u8 button_polling_addresses[EM28XX_NUM_BUTTON_ADDRESSES_MAX];760 u8 button_polling_last_values[EM28XX_NUM_BUTTON_ADDRESSES_MAX];761 u8 num_button_polling_addresses;762 u16 button_polling_interval; // [ms]763 // Snapshot button input device764 char snapshot_button_path[30]; // path of the input dev765 struct input_dev *sbutton_input_dev;766 767#ifdef CONFIG_MEDIA_CONTROLLER768 struct media_device *media_dev;769 struct media_entity input_ent[MAX_EM28XX_INPUT];770 struct media_pad input_pad[MAX_EM28XX_INPUT];771#endif772 773 struct em28xx *dev_next;774 int ts;775};776 777#define kref_to_dev(d) container_of(d, struct em28xx, ref)778 779struct em28xx_ops {780 struct list_head next;781 char *name;782 int id;783 int (*init)(struct em28xx *dev);784 int (*fini)(struct em28xx *dev);785 int (*suspend)(struct em28xx *dev);786 int (*resume)(struct em28xx *dev);787};788 789/* Provided by em28xx-i2c.c */790void em28xx_do_i2c_scan(struct em28xx *dev, unsigned int bus);791int em28xx_i2c_register(struct em28xx *dev, unsigned int bus,792 enum em28xx_i2c_algo_type algo_type);793int em28xx_i2c_unregister(struct em28xx *dev, unsigned int bus);794 795/* Provided by em28xx-core.c */796int em28xx_read_reg_req_len(struct em28xx *dev, u8 req, u16 reg,797 char *buf, int len);798int em28xx_read_reg_req(struct em28xx *dev, u8 req, u16 reg);799int em28xx_read_reg(struct em28xx *dev, u16 reg);800int em28xx_write_regs_req(struct em28xx *dev, u8 req, u16 reg, char *buf,801 int len);802int em28xx_write_regs(struct em28xx *dev, u16 reg, char *buf, int len);803int em28xx_write_reg(struct em28xx *dev, u16 reg, u8 val);804int em28xx_write_reg_bits(struct em28xx *dev, u16 reg, u8 val,805 u8 bitmask);806int em28xx_toggle_reg_bits(struct em28xx *dev, u16 reg, u8 bitmask);807 808int em28xx_read_ac97(struct em28xx *dev, u8 reg);809int em28xx_write_ac97(struct em28xx *dev, u8 reg, u16 val);810 811int em28xx_audio_analog_set(struct em28xx *dev);812int em28xx_audio_setup(struct em28xx *dev);813 814const struct em28xx_led *em28xx_find_led(struct em28xx *dev,815 enum em28xx_led_role role);816int em28xx_capture_start(struct em28xx *dev, int start);817int em28xx_alloc_urbs(struct em28xx *dev, enum em28xx_mode mode, int xfer_bulk,818 int num_bufs, int max_pkt_size, int packet_multiplier);819int em28xx_init_usb_xfer(struct em28xx *dev, enum em28xx_mode mode,820 int xfer_bulk,821 int num_bufs, int max_pkt_size, int packet_multiplier,822 int (*urb_data_copy)823 (struct em28xx *dev, struct urb *urb));824void em28xx_uninit_usb_xfer(struct em28xx *dev, enum em28xx_mode mode);825void em28xx_stop_urbs(struct em28xx *dev);826int em28xx_set_mode(struct em28xx *dev, enum em28xx_mode set_mode);827int em28xx_gpio_set(struct em28xx *dev, const struct em28xx_reg_seq *gpio);828int em28xx_register_extension(struct em28xx_ops *dev);829void em28xx_unregister_extension(struct em28xx_ops *dev);830void em28xx_init_extension(struct em28xx *dev);831void em28xx_close_extension(struct em28xx *dev);832int em28xx_suspend_extension(struct em28xx *dev);833int em28xx_resume_extension(struct em28xx *dev);834 835/* Provided by em28xx-cards.c */836extern const struct em28xx_board em28xx_boards[];837extern struct usb_device_id em28xx_id_table[];838int em28xx_tuner_callback(void *ptr, int component, int command, int arg);839void em28xx_setup_xc3028(struct em28xx *dev, struct xc2028_ctrl *ctl);840void em28xx_free_device(struct kref *ref);841 842/* Provided by em28xx-camera.c */843int em28xx_detect_sensor(struct em28xx *dev);844int em28xx_init_camera(struct em28xx *dev);845 846#endif847