/* SPDX-License-Identifier: GPL-2.0+ */
/*
 * 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@kernel.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.
 */

#ifndef _EM28XX_H
#define _EM28XX_H

#include <linux/bitfield.h>

#define EM28XX_VERSION "0.2.2"
#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
#define EM28178_BOARD_PLEX_PX_BCUD                98
#define EM28174_BOARD_HAUPPAUGE_WINTV_DUALHD_DVB  99
#define EM28174_BOARD_HAUPPAUGE_WINTV_DUALHD_01595 100
#define EM2884_BOARD_TERRATEC_H6                  101
#define EM2882_BOARD_ZOLID_HYBRID_TV_STICK              102

/* 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 DVB_MAX_ADAPTERS /* All adapters could be em28xx */

/* 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 94

#define EM28XX_INTERLACED_DEFAULT 1

/* 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

#define PRIMARY_TS      0
#define SECONDARY_TS    1

enum em28xx_mode {
        EM28XX_SUSPEND,
        EM28XX_ANALOG_MODE,
        EM28XX_DIGITAL_MODE,
};

struct em28xx;

/**
 * struct em28xx_usb_bufs - Contains URB-related buffer data
 *
 * @max_pkt_size:       max packet size of isoc transaction
 * @num_packets:        number of packets in each buffer
 * @num_bufs:           number of allocated urb
 * @urb:                urb for isoc/bulk transfers
 * @buf:                transfer buffers for isoc/bulk transfer
 */
struct em28xx_usb_bufs {
        int                             max_pkt_size;
        int                             num_packets;
        int                             num_bufs;
        struct urb                      **urb;
        char                            **buf;
};

/**
 * struct em28xx_usb_ctl - Contains URB-related buffer data
 *
 * @analog_bufs:        isoc/bulk transfer buffers for analog mode
 * @digital_bufs:       isoc/bulk transfer buffers for digital mode
 * @vid_buf:            Stores already requested video buffers
 * @vbi_buf:            Stores already requested VBI buffers
 * @urb_data_copy:      copy data from URB
 */
struct em28xx_usb_ctl {
        struct em28xx_usb_bufs          analog_bufs;
        struct em28xx_usb_bufs          digital_bufs;
        struct em28xx_buffer    *vid_buf;
        struct em28xx_buffer    *vbi_buf;
        int (*urb_data_copy)(struct em28xx *dev, struct urb *urb);
};

/**
 * struct em28xx_fmt - Struct to enumberate video formats
 *
 * @name:       Name for the video standard
 * @fourcc:     v4l2 format id
 * @depth:      mean number of bits to represent a pixel
 * @reg:        em28xx register value to set it
 */
struct em28xx_fmt {
        char    *name;
        u32     fourcc;
        int     depth;
        int     reg;
};

/**
 * struct em28xx_buffer- buffer for storing one video frame
 *
 * @vb:         common v4l buffer stuff
 * @list:       List to associate it with the other buffers
 * @mem:        pointer to the buffer, as returned by vb2_plane_vaddr()
 * @length:     length of the buffer, as returned by vb2_plane_size()
 * @top_field:  If non-zero, indicate that the buffer is the top field
 * @pos:        Indicate the next position of the buffer to be filled.
 * @vb_buf:     pointer to vmalloc memory address in vb
 *
 * .. note::
 *
 *    in interlaced mode, @pos is reset to zero at the start of each new
 *    field (not frame !)
 */
struct em28xx_buffer {
        struct vb2_v4l2_buffer  vb;             /* must be first */

        struct list_head        list;

        void                    *mem;
        unsigned int            length;
        int                     top_field;

        unsigned int            pos;

        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_COMPOSITE = 1,
        EM28XX_VMUX_SVIDEO,
        EM28XX_VMUX_TELEVISION,
        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_amux - describes the type of audio input used by em28xx
 *
 * @EM28XX_AMUX_UNUSED:
 *      Used only on em28xx dev->map field, in order to mark an entry
 *      as unused.
 * @EM28XX_AMUX_VIDEO:
 *      On devices without AC97, this is the only value that it is currently
 *      allowed.
 *      On devices with AC97, it corresponds to the AC97 mixer "Video" control.
 * @EM28XX_AMUX_LINE_IN:
 *      Only for devices with AC97. Corresponds to AC97 mixer "Line In".
 * @EM28XX_AMUX_VIDEO2:
 *      Only for devices with AC97. It means that em28xx should use "Line In"
 *      And AC97 should use the "Video" mixer control.
 * @EM28XX_AMUX_PHONE:
 *      Only for devices with AC97. Corresponds to AC97 mixer "Phone".
 * @EM28XX_AMUX_MIC:
 *      Only for devices with AC97. Corresponds to AC97 mixer "Mic".
 * @EM28XX_AMUX_CD:
 *      Only for devices with AC97. Corresponds to AC97 mixer "CD".
 * @EM28XX_AMUX_AUX:
 *      Only for devices with AC97. Corresponds to AC97 mixer "Aux".
 * @EM28XX_AMUX_PCM_OUT:
 *      Only for devices with AC97. Corresponds to AC97 mixer "PCM out".
 *
 * The em28xx chip itself has only two audio inputs: tuner and line in.
 * On almost all devices, only the tuner input is used.
 *
 * However, on most devices, an auxiliary AC97 codec device is used,
 * usually connected to the em28xx tuner input (except for
 * @EM28XX_AMUX_LINE_IN).
 *
 * The AC97 device typically have several different inputs and outputs.
 * The exact number and description depends on their model.
 *
 * It is possible to AC97 to mixer more than one different entries at the
 * same time, via the alsa mux.
 */
enum em28xx_amux {
        EM28XX_AMUX_UNUSED = -1,
        EM28XX_AMUX_VIDEO = 0,
        EM28XX_AMUX_LINE_IN,

        /* Some less-common mixer setups */
        EM28XX_AMUX_VIDEO2,
        EM28XX_AMUX_PHONE,
        EM28XX_AMUX_MIC,
        EM28XX_AMUX_CD,
        EM28XX_AMUX_AUX,
        EM28XX_AMUX_PCM_OUT,
};

enum em28xx_aout {
        /* AC97 outputs */
        EM28XX_AOUT_MASTER = BIT(0),
        EM28XX_AOUT_LINE   = BIT(1),
        EM28XX_AOUT_MONO   = BIT(2),
        EM28XX_AOUT_LFE    = BIT(3),
        EM28XX_AOUT_SURR   = BIT(4),

        /* PCM IN Mixer - used by AC97_RECORD_SELECT register */
        EM28XX_AOUT_PCM_IN = BIT(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;
        const 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_DIGITAL_CAPTURING_TS2,
        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 int def_i2c_bus;       /* Default I2C bus */

        /* i2c flags */
        unsigned int tda9887_conf;

        /* GPIO sequences */
        const struct em28xx_reg_seq *dvb_gpio;
        const struct em28xx_reg_seq *suspend_gpio;
        const struct em28xx_reg_seq *tuner_gpio;
        const 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 has_dual_ts: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 */
        const 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 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;     /* Protects vb_vidq */
        struct mutex vb_vbi_queue_lock; /* Protects vb_vbiq */

        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 int hscale;    /* horizontal scale factor (see datasheet) */
        unsigned int 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;

#ifdef CONFIG_MEDIA_CONTROLLER
        struct media_pad video_pad, vbi_pad;
        struct media_entity *decoder;
#endif
};

struct em28xx_audio {
        char name[50];
        unsigned int 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;               /* Protects struct em28xx_audio */

        /* 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 int 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
        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 int disconnected:1;    // device has been diconnected
        unsigned int has_video:1;
        unsigned int is_audio_only:1;
        unsigned int is_webcam:1;
        unsigned int has_msp34xx:1;
        unsigned int i2c_speed:2;
        enum em28xx_int_audio_type int_audio_type;
        enum em28xx_usb_audio_type usb_audio_type;
        unsigned char name[32];

        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 int def_i2c_bus;       // Default I2C bus
        unsigned int 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
        enum em28xx_amux amux_map[MAX_EM28XX_INPUT];

        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;              /* protects em28xx struct */
        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; /* Protects em28xx video/vbi/dvb IRQ stream data */

        // usb transfer
        struct usb_interface *intf;     // the usb interface
        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_ts2;     // address of isoc endpoint for DVB TS2
        u8 dvb_ep_bulk_ts2;     // address of bulk endpoint for DVB TS2
        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_max_pkt_size_isoc_ts2; // 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;

#ifdef CONFIG_MEDIA_CONTROLLER
        struct media_device *media_dev;
        struct media_entity input_ent[MAX_EM28XX_INPUT];
        struct media_pad input_pad[MAX_EM28XX_INPUT];
#endif

        struct em28xx   *dev_next;
        int ts;
};

#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 *dev);
        int (*fini)(struct em28xx *dev);
        int (*suspend)(struct em28xx *dev);
        int (*resume)(struct em28xx *dev);
};

/* Provided by em28xx-i2c.c */
void em28xx_do_i2c_scan(struct em28xx *dev, unsigned int bus);
int  em28xx_i2c_register(struct em28xx *dev, unsigned int bus,
                         enum em28xx_i2c_algo_type algo_type);
int  em28xx_i2c_unregister(struct em28xx *dev, unsigned int 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, const 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 const 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);

#endif