/*

    bttv - Bt848 frame grabber driver

    Copyright (C) 1996,97,98 Ralph  Metzler <rjkm@thp.uni-koeln.de>
                           & Marcus Metzler <mocm@thp.uni-koeln.de>
    (c) 1999-2002 Gerd Knorr <kraxel@bytesex.org>

    some v4l2 code lines are taken from Justin's bttv2 driver which is
    (c) 2000 Justin Schoeman <justin@suntiger.ee.up.ac.za>

    V4L1 removal from:
    (c) 2005-2006 Nickolay V. Shmyrev <nshmyrev@yandex.ru>

    Fixes to be fully V4L2 compliant by
    (c) 2006 Mauro Carvalho Chehab <mchehab@infradead.org>

    Cropping and overscan support
    Copyright (C) 2005, 2006 Michael H. Schimek <mschimek@gmx.at>
    Sponsored by OPQ Systems AB

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

#include <linux/init.h>
#include <linux/module.h>
#include <linux/delay.h>
#include <linux/slab.h>
#include <linux/errno.h>
#include <linux/fs.h>
#include <linux/kernel.h>
#include <linux/sched.h>
#include <linux/interrupt.h>
#include <linux/kdev_t.h>
#include "bttvp.h"
#include <media/v4l2-common.h>
#include <media/v4l2-ioctl.h>
#include <media/tvaudio.h>
#include <media/msp3400.h>

#include <linux/dma-mapping.h>

#include <asm/io.h>
#include <asm/byteorder.h>

#include <media/saa6588.h>


unsigned int bttv_num;                  /* number of Bt848s in use */
struct bttv *bttvs[BTTV_MAX];

unsigned int bttv_debug;
unsigned int bttv_verbose = 1;
unsigned int bttv_gpio;

/* config variables */
#ifdef __BIG_ENDIAN
static unsigned int bigendian=1;
#else
static unsigned int bigendian;
#endif
static unsigned int radio[BTTV_MAX];
static unsigned int irq_debug;
static unsigned int gbuffers = 8;
static unsigned int gbufsize = 0x208000;
static unsigned int reset_crop = 1;

static int video_nr[BTTV_MAX] = { [0 ... (BTTV_MAX-1)] = -1 };
static int radio_nr[BTTV_MAX] = { [0 ... (BTTV_MAX-1)] = -1 };
static int vbi_nr[BTTV_MAX] = { [0 ... (BTTV_MAX-1)] = -1 };
static int debug_latency;
static int disable_ir;

static unsigned int fdsr;

/* options */
static unsigned int combfilter;
static unsigned int lumafilter;
static unsigned int automute    = 1;
static unsigned int chroma_agc;
static unsigned int adc_crush   = 1;
static unsigned int whitecrush_upper = 0xCF;
static unsigned int whitecrush_lower = 0x7F;
static unsigned int vcr_hack;
static unsigned int irq_iswitch;
static unsigned int uv_ratio    = 50;
static unsigned int full_luma_range;
static unsigned int coring;

/* API features (turn on/off stuff for testing) */
static unsigned int v4l2        = 1;

/* insmod args */
module_param(bttv_verbose,      int, 0644);
module_param(bttv_gpio,         int, 0644);
module_param(bttv_debug,        int, 0644);
module_param(irq_debug,         int, 0644);
module_param(debug_latency,     int, 0644);
module_param(disable_ir,        int, 0444);

module_param(fdsr,              int, 0444);
module_param(gbuffers,          int, 0444);
module_param(gbufsize,          int, 0444);
module_param(reset_crop,        int, 0444);

module_param(v4l2,              int, 0644);
module_param(bigendian,         int, 0644);
module_param(irq_iswitch,       int, 0644);
module_param(combfilter,        int, 0444);
module_param(lumafilter,        int, 0444);
module_param(automute,          int, 0444);
module_param(chroma_agc,        int, 0444);
module_param(adc_crush,         int, 0444);
module_param(whitecrush_upper,  int, 0444);
module_param(whitecrush_lower,  int, 0444);
module_param(vcr_hack,          int, 0444);
module_param(uv_ratio,          int, 0444);
module_param(full_luma_range,   int, 0444);
module_param(coring,            int, 0444);

module_param_array(radio,       int, NULL, 0444);
module_param_array(video_nr,    int, NULL, 0444);
module_param_array(radio_nr,    int, NULL, 0444);
module_param_array(vbi_nr,      int, NULL, 0444);

MODULE_PARM_DESC(radio,"The TV card supports radio, default is 0 (no)");
MODULE_PARM_DESC(bigendian,"byte order of the framebuffer, default is native endian");
MODULE_PARM_DESC(bttv_verbose,"verbose startup messages, default is 1 (yes)");
MODULE_PARM_DESC(bttv_gpio,"log gpio changes, default is 0 (no)");
MODULE_PARM_DESC(bttv_debug,"debug messages, default is 0 (no)");
MODULE_PARM_DESC(irq_debug,"irq handler debug messages, default is 0 (no)");
MODULE_PARM_DESC(disable_ir, "disable infrared remote support");
MODULE_PARM_DESC(gbuffers,"number of capture buffers. range 2-32, default 8");
MODULE_PARM_DESC(gbufsize,"size of the capture buffers, default is 0x208000");
MODULE_PARM_DESC(reset_crop,"reset cropping parameters at open(), default "
                 "is 1 (yes) for compatibility with older applications");
MODULE_PARM_DESC(automute,"mute audio on bad/missing video signal, default is 1 (yes)");
MODULE_PARM_DESC(chroma_agc,"enables the AGC of chroma signal, default is 0 (no)");
MODULE_PARM_DESC(adc_crush,"enables the luminance ADC crush, default is 1 (yes)");
MODULE_PARM_DESC(whitecrush_upper,"sets the white crush upper value, default is 207");
MODULE_PARM_DESC(whitecrush_lower,"sets the white crush lower value, default is 127");
MODULE_PARM_DESC(vcr_hack,"enables the VCR hack (improves synch on poor VCR tapes), default is 0 (no)");
MODULE_PARM_DESC(irq_iswitch,"switch inputs in irq handler");
MODULE_PARM_DESC(uv_ratio,"ratio between u and v gains, default is 50");
MODULE_PARM_DESC(full_luma_range,"use the full luma range, default is 0 (no)");
MODULE_PARM_DESC(coring,"set the luma coring level, default is 0 (no)");
MODULE_PARM_DESC(video_nr, "video device numbers");
MODULE_PARM_DESC(vbi_nr, "vbi device numbers");
MODULE_PARM_DESC(radio_nr, "radio device numbers");

MODULE_DESCRIPTION("bttv - v4l/v4l2 driver module for bt848/878 based cards");
MODULE_AUTHOR("Ralph Metzler & Marcus Metzler & Gerd Knorr");
MODULE_LICENSE("GPL");

/* ----------------------------------------------------------------------- */
/* sysfs                                                                   */

static ssize_t show_card(struct device *cd,
                         struct device_attribute *attr, char *buf)
{
        struct video_device *vfd = container_of(cd, struct video_device, dev);
        struct bttv *btv = video_get_drvdata(vfd);
        return sprintf(buf, "%d\n", btv ? btv->c.type : UNSET);
}
static DEVICE_ATTR(card, S_IRUGO, show_card, NULL);

/* ----------------------------------------------------------------------- */
/* dvb auto-load setup                                                     */
#if defined(CONFIG_MODULES) && defined(MODULE)
static void request_module_async(struct work_struct *work)
{
        request_module("dvb-bt8xx");
}

static void request_modules(struct bttv *dev)
{
        INIT_WORK(&dev->request_module_wk, request_module_async);
        schedule_work(&dev->request_module_wk);
}

static void flush_request_modules(struct bttv *dev)
{
        flush_work_sync(&dev->request_module_wk);
}
#else
#define request_modules(dev)
#define flush_request_modules(dev)
#endif /* CONFIG_MODULES */


/* ----------------------------------------------------------------------- */
/* static data                                                             */

/* special timing tables from conexant... */
static u8 SRAM_Table[][60] =
{
        /* PAL digital input over GPIO[7:0] */
        {
                45, // 45 bytes following
                0x36,0x11,0x01,0x00,0x90,0x02,0x05,0x10,0x04,0x16,
                0x12,0x05,0x11,0x00,0x04,0x12,0xC0,0x00,0x31,0x00,
                0x06,0x51,0x08,0x03,0x89,0x08,0x07,0xC0,0x44,0x00,
                0x81,0x01,0x01,0xA9,0x0D,0x02,0x02,0x50,0x03,0x37,
                0x37,0x00,0xAF,0x21,0x00
        },
        /* NTSC digital input over GPIO[7:0] */
        {
                51, // 51 bytes following
                0x0C,0xC0,0x00,0x00,0x90,0x02,0x03,0x10,0x03,0x06,
                0x10,0x04,0x12,0x12,0x05,0x02,0x13,0x04,0x19,0x00,
                0x04,0x39,0x00,0x06,0x59,0x08,0x03,0x83,0x08,0x07,
                0x03,0x50,0x00,0xC0,0x40,0x00,0x86,0x01,0x01,0xA6,
                0x0D,0x02,0x03,0x11,0x01,0x05,0x37,0x00,0xAC,0x21,
                0x00,
        },
        // TGB_NTSC392 // quartzsight
        // This table has been modified to be used for Fusion Rev D
        {
                0x2A, // size of table = 42
                0x06, 0x08, 0x04, 0x0a, 0xc0, 0x00, 0x18, 0x08, 0x03, 0x24,
                0x08, 0x07, 0x02, 0x90, 0x02, 0x08, 0x10, 0x04, 0x0c, 0x10,
                0x05, 0x2c, 0x11, 0x04, 0x55, 0x48, 0x00, 0x05, 0x50, 0x00,
                0xbf, 0x0c, 0x02, 0x2f, 0x3d, 0x00, 0x2f, 0x3f, 0x00, 0xc3,
                0x20, 0x00
        }
};

/* minhdelayx1  first video pixel we can capture on a line and
   hdelayx1     start of active video, both relative to rising edge of
                /HRESET pulse (0H) in 1 / fCLKx1.
   swidth       width of active video and
   totalwidth   total line width, both in 1 / fCLKx1.
   sqwidth      total line width in square pixels.
   vdelay       start of active video in 2 * field lines relative to
                trailing edge of /VRESET pulse (VDELAY register).
   sheight      height of active video in 2 * field lines.
   videostart0  ITU-R frame line number of the line corresponding
                to vdelay in the first field. */
#define CROPCAP(minhdelayx1, hdelayx1, swidth, totalwidth, sqwidth,      \
                vdelay, sheight, videostart0)                            \
        .cropcap.bounds.left = minhdelayx1,                              \
        /* * 2 because vertically we count field lines times two, */     \
        /* e.g. 23 * 2 to 23 * 2 + 576 in PAL-BGHI defrect. */           \
        .cropcap.bounds.top = (videostart0) * 2 - (vdelay) + MIN_VDELAY, \
        /* 4 is a safety margin at the end of the line. */               \
        .cropcap.bounds.width = (totalwidth) - (minhdelayx1) - 4,        \
        .cropcap.bounds.height = (sheight) + (vdelay) - MIN_VDELAY,      \
        .cropcap.defrect.left = hdelayx1,                                \
        .cropcap.defrect.top = (videostart0) * 2,                        \
        .cropcap.defrect.width = swidth,                                 \
        .cropcap.defrect.height = sheight,                               \
        .cropcap.pixelaspect.numerator = totalwidth,                     \
        .cropcap.pixelaspect.denominator = sqwidth,

const struct bttv_tvnorm bttv_tvnorms[] = {
        /* PAL-BDGHI */
        /* max. active video is actually 922, but 924 is divisible by 4 and 3! */
        /* actually, max active PAL with HSCALE=0 is 948, NTSC is 768 - nil */
        {
                .v4l2_id        = V4L2_STD_PAL,
                .name           = "PAL",
                .Fsc            = 35468950,
                .swidth         = 924,
                .sheight        = 576,
                .totalwidth     = 1135,
                .adelay         = 0x7f,
                .bdelay         = 0x72,
                .iform          = (BT848_IFORM_PAL_BDGHI|BT848_IFORM_XT1),
                .scaledtwidth   = 1135,
                .hdelayx1       = 186,
                .hactivex1      = 924,
                .vdelay         = 0x20,
                .vbipack        = 255, /* min (2048 / 4, 0x1ff) & 0xff */
                .sram           = 0,
                /* ITU-R frame line number of the first VBI line
                   we can capture, of the first and second field.
                   The last line is determined by cropcap.bounds. */
                .vbistart       = { 7, 320 },
                CROPCAP(/* minhdelayx1 */ 68,
                        /* hdelayx1 */ 186,
                        /* Should be (768 * 1135 + 944 / 2) / 944.
                           cropcap.defrect is used for image width
                           checks, so we keep the old value 924. */
                        /* swidth */ 924,
                        /* totalwidth */ 1135,
                        /* sqwidth */ 944,
                        /* vdelay */ 0x20,
                        /* sheight */ 576,
                        /* videostart0 */ 23)
                /* bt878 (and bt848?) can capture another
                   line below active video. */
                .cropcap.bounds.height = (576 + 2) + 0x20 - 2,
        },{
                .v4l2_id        = V4L2_STD_NTSC_M | V4L2_STD_NTSC_M_KR,
                .name           = "NTSC",
                .Fsc            = 28636363,
                .swidth         = 768,
                .sheight        = 480,
                .totalwidth     = 910,
                .adelay         = 0x68,
                .bdelay         = 0x5d,
                .iform          = (BT848_IFORM_NTSC|BT848_IFORM_XT0),
                .scaledtwidth   = 910,
                .hdelayx1       = 128,
                .hactivex1      = 910,
                .vdelay         = 0x1a,
                .vbipack        = 144, /* min (1600 / 4, 0x1ff) & 0xff */
                .sram           = 1,
                .vbistart       = { 10, 273 },
                CROPCAP(/* minhdelayx1 */ 68,
                        /* hdelayx1 */ 128,
                        /* Should be (640 * 910 + 780 / 2) / 780? */
                        /* swidth */ 768,
                        /* totalwidth */ 910,
                        /* sqwidth */ 780,
                        /* vdelay */ 0x1a,
                        /* sheight */ 480,
                        /* videostart0 */ 23)
        },{
                .v4l2_id        = V4L2_STD_SECAM,
                .name           = "SECAM",
                .Fsc            = 35468950,
                .swidth         = 924,
                .sheight        = 576,
                .totalwidth     = 1135,
                .adelay         = 0x7f,
                .bdelay         = 0xb0,
                .iform          = (BT848_IFORM_SECAM|BT848_IFORM_XT1),
                .scaledtwidth   = 1135,
                .hdelayx1       = 186,
                .hactivex1      = 922,
                .vdelay         = 0x20,
                .vbipack        = 255,
                .sram           = 0, /* like PAL, correct? */
                .vbistart       = { 7, 320 },
                CROPCAP(/* minhdelayx1 */ 68,
                        /* hdelayx1 */ 186,
                        /* swidth */ 924,
                        /* totalwidth */ 1135,
                        /* sqwidth */ 944,
                        /* vdelay */ 0x20,
                        /* sheight */ 576,
                        /* videostart0 */ 23)
        },{
                .v4l2_id        = V4L2_STD_PAL_Nc,
                .name           = "PAL-Nc",
                .Fsc            = 28636363,
                .swidth         = 640,
                .sheight        = 576,
                .totalwidth     = 910,
                .adelay         = 0x68,
                .bdelay         = 0x5d,
                .iform          = (BT848_IFORM_PAL_NC|BT848_IFORM_XT0),
                .scaledtwidth   = 780,
                .hdelayx1       = 130,
                .hactivex1      = 734,
                .vdelay         = 0x1a,
                .vbipack        = 144,
                .sram           = -1,
                .vbistart       = { 7, 320 },
                CROPCAP(/* minhdelayx1 */ 68,
                        /* hdelayx1 */ 130,
                        /* swidth */ (640 * 910 + 780 / 2) / 780,
                        /* totalwidth */ 910,
                        /* sqwidth */ 780,
                        /* vdelay */ 0x1a,
                        /* sheight */ 576,
                        /* videostart0 */ 23)
        },{
                .v4l2_id        = V4L2_STD_PAL_M,
                .name           = "PAL-M",
                .Fsc            = 28636363,
                .swidth         = 640,
                .sheight        = 480,
                .totalwidth     = 910,
                .adelay         = 0x68,
                .bdelay         = 0x5d,
                .iform          = (BT848_IFORM_PAL_M|BT848_IFORM_XT0),
                .scaledtwidth   = 780,
                .hdelayx1       = 135,
                .hactivex1      = 754,
                .vdelay         = 0x1a,
                .vbipack        = 144,
                .sram           = -1,
                .vbistart       = { 10, 273 },
                CROPCAP(/* minhdelayx1 */ 68,
                        /* hdelayx1 */ 135,
                        /* swidth */ (640 * 910 + 780 / 2) / 780,
                        /* totalwidth */ 910,
                        /* sqwidth */ 780,
                        /* vdelay */ 0x1a,
                        /* sheight */ 480,
                        /* videostart0 */ 23)
        },{
                .v4l2_id        = V4L2_STD_PAL_N,
                .name           = "PAL-N",
                .Fsc            = 35468950,
                .swidth         = 768,
                .sheight        = 576,
                .totalwidth     = 1135,
                .adelay         = 0x7f,
                .bdelay         = 0x72,
                .iform          = (BT848_IFORM_PAL_N|BT848_IFORM_XT1),
                .scaledtwidth   = 944,
                .hdelayx1       = 186,
                .hactivex1      = 922,
                .vdelay         = 0x20,
                .vbipack        = 144,
                .sram           = -1,
                .vbistart       = { 7, 320 },
                CROPCAP(/* minhdelayx1 */ 68,
                        /* hdelayx1 */ 186,
                        /* swidth */ (768 * 1135 + 944 / 2) / 944,
                        /* totalwidth */ 1135,
                        /* sqwidth */ 944,
                        /* vdelay */ 0x20,
                        /* sheight */ 576,
                        /* videostart0 */ 23)
        },{
                .v4l2_id        = V4L2_STD_NTSC_M_JP,
                .name           = "NTSC-JP",
                .Fsc            = 28636363,
                .swidth         = 640,
                .sheight        = 480,
                .totalwidth     = 910,
                .adelay         = 0x68,
                .bdelay         = 0x5d,
                .iform          = (BT848_IFORM_NTSC_J|BT848_IFORM_XT0),
                .scaledtwidth   = 780,
                .hdelayx1       = 135,
                .hactivex1      = 754,
                .vdelay         = 0x16,
                .vbipack        = 144,
                .sram           = -1,
                .vbistart       = { 10, 273 },
                CROPCAP(/* minhdelayx1 */ 68,
                        /* hdelayx1 */ 135,
                        /* swidth */ (640 * 910 + 780 / 2) / 780,
                        /* totalwidth */ 910,
                        /* sqwidth */ 780,
                        /* vdelay */ 0x16,
                        /* sheight */ 480,
                        /* videostart0 */ 23)
        },{
                /* that one hopefully works with the strange timing
                 * which video recorders produce when playing a NTSC
                 * tape on a PAL TV ... */
                .v4l2_id        = V4L2_STD_PAL_60,
                .name           = "PAL-60",
                .Fsc            = 35468950,
                .swidth         = 924,
                .sheight        = 480,
                .totalwidth     = 1135,
                .adelay         = 0x7f,
                .bdelay         = 0x72,
                .iform          = (BT848_IFORM_PAL_BDGHI|BT848_IFORM_XT1),
                .scaledtwidth   = 1135,
                .hdelayx1       = 186,
                .hactivex1      = 924,
                .vdelay         = 0x1a,
                .vbipack        = 255,
                .vtotal         = 524,
                .sram           = -1,
                .vbistart       = { 10, 273 },
                CROPCAP(/* minhdelayx1 */ 68,
                        /* hdelayx1 */ 186,
                        /* swidth */ 924,
                        /* totalwidth */ 1135,
                        /* sqwidth */ 944,
                        /* vdelay */ 0x1a,
                        /* sheight */ 480,
                        /* videostart0 */ 23)
        }
};
static const unsigned int BTTV_TVNORMS = ARRAY_SIZE(bttv_tvnorms);

/* ----------------------------------------------------------------------- */
/* bttv format list
   packed pixel formats must come first */
static const struct bttv_format formats[] = {
        {
                .name     = "8 bpp, gray",
                .fourcc   = V4L2_PIX_FMT_GREY,
                .btformat = BT848_COLOR_FMT_Y8,
                .depth    = 8,
                .flags    = FORMAT_FLAGS_PACKED,
        },{
                .name     = "8 bpp, dithered color",
                .fourcc   = V4L2_PIX_FMT_HI240,
                .btformat = BT848_COLOR_FMT_RGB8,
                .depth    = 8,
                .flags    = FORMAT_FLAGS_PACKED | FORMAT_FLAGS_DITHER,
        },{
                .name     = "15 bpp RGB, le",
                .fourcc   = V4L2_PIX_FMT_RGB555,
                .btformat = BT848_COLOR_FMT_RGB15,
                .depth    = 16,
                .flags    = FORMAT_FLAGS_PACKED,
        },{
                .name     = "15 bpp RGB, be",
                .fourcc   = V4L2_PIX_FMT_RGB555X,
                .btformat = BT848_COLOR_FMT_RGB15,
                .btswap   = 0x03, /* byteswap */
                .depth    = 16,
                .flags    = FORMAT_FLAGS_PACKED,
        },{
                .name     = "16 bpp RGB, le",
                .fourcc   = V4L2_PIX_FMT_RGB565,
                .btformat = BT848_COLOR_FMT_RGB16,
                .depth    = 16,
                .flags    = FORMAT_FLAGS_PACKED,
        },{
                .name     = "16 bpp RGB, be",
                .fourcc   = V4L2_PIX_FMT_RGB565X,
                .btformat = BT848_COLOR_FMT_RGB16,
                .btswap   = 0x03, /* byteswap */
                .depth    = 16,
                .flags    = FORMAT_FLAGS_PACKED,
        },{
                .name     = "24 bpp RGB, le",
                .fourcc   = V4L2_PIX_FMT_BGR24,
                .btformat = BT848_COLOR_FMT_RGB24,
                .depth    = 24,
                .flags    = FORMAT_FLAGS_PACKED,
        },{
                .name     = "32 bpp RGB, le",
                .fourcc   = V4L2_PIX_FMT_BGR32,
                .btformat = BT848_COLOR_FMT_RGB32,
                .depth    = 32,
                .flags    = FORMAT_FLAGS_PACKED,
        },{
                .name     = "32 bpp RGB, be",
                .fourcc   = V4L2_PIX_FMT_RGB32,
                .btformat = BT848_COLOR_FMT_RGB32,
                .btswap   = 0x0f, /* byte+word swap */
                .depth    = 32,
                .flags    = FORMAT_FLAGS_PACKED,
        },{
                .name     = "4:2:2, packed, YUYV",
                .fourcc   = V4L2_PIX_FMT_YUYV,
                .btformat = BT848_COLOR_FMT_YUY2,
                .depth    = 16,
                .flags    = FORMAT_FLAGS_PACKED,
        },{
                .name     = "4:2:2, packed, YUYV",
                .fourcc   = V4L2_PIX_FMT_YUYV,
                .btformat = BT848_COLOR_FMT_YUY2,
                .depth    = 16,
                .flags    = FORMAT_FLAGS_PACKED,
        },{
                .name     = "4:2:2, packed, UYVY",
                .fourcc   = V4L2_PIX_FMT_UYVY,
                .btformat = BT848_COLOR_FMT_YUY2,
                .btswap   = 0x03, /* byteswap */
                .depth    = 16,
                .flags    = FORMAT_FLAGS_PACKED,
        },{
                .name     = "4:2:2, planar, Y-Cb-Cr",
                .fourcc   = V4L2_PIX_FMT_YUV422P,
                .btformat = BT848_COLOR_FMT_YCrCb422,
                .depth    = 16,
                .flags    = FORMAT_FLAGS_PLANAR,
                .hshift   = 1,
                .vshift   = 0,
        },{
                .name     = "4:2:0, planar, Y-Cb-Cr",
                .fourcc   = V4L2_PIX_FMT_YUV420,
                .btformat = BT848_COLOR_FMT_YCrCb422,
                .depth    = 12,
                .flags    = FORMAT_FLAGS_PLANAR,
                .hshift   = 1,
                .vshift   = 1,
        },{
                .name     = "4:2:0, planar, Y-Cr-Cb",
                .fourcc   = V4L2_PIX_FMT_YVU420,
                .btformat = BT848_COLOR_FMT_YCrCb422,
                .depth    = 12,
                .flags    = FORMAT_FLAGS_PLANAR | FORMAT_FLAGS_CrCb,
                .hshift   = 1,
                .vshift   = 1,
        },{
                .name     = "4:1:1, planar, Y-Cb-Cr",
                .fourcc   = V4L2_PIX_FMT_YUV411P,
                .btformat = BT848_COLOR_FMT_YCrCb411,
                .depth    = 12,
                .flags    = FORMAT_FLAGS_PLANAR,
                .hshift   = 2,
                .vshift   = 0,
        },{
                .name     = "4:1:0, planar, Y-Cb-Cr",
                .fourcc   = V4L2_PIX_FMT_YUV410,
                .btformat = BT848_COLOR_FMT_YCrCb411,
                .depth    = 9,
                .flags    = FORMAT_FLAGS_PLANAR,
                .hshift   = 2,
                .vshift   = 2,
        },{
                .name     = "4:1:0, planar, Y-Cr-Cb",
                .fourcc   = V4L2_PIX_FMT_YVU410,
                .btformat = BT848_COLOR_FMT_YCrCb411,
                .depth    = 9,
                .flags    = FORMAT_FLAGS_PLANAR | FORMAT_FLAGS_CrCb,
                .hshift   = 2,
                .vshift   = 2,
        },{
                .name     = "raw scanlines",
                .fourcc   = -1,
                .btformat = BT848_COLOR_FMT_RAW,
                .depth    = 8,
                .flags    = FORMAT_FLAGS_RAW,
        }
};
static const unsigned int FORMATS = ARRAY_SIZE(formats);

/* ----------------------------------------------------------------------- */

#define V4L2_CID_PRIVATE_CHROMA_AGC  (V4L2_CID_PRIVATE_BASE + 0)
#define V4L2_CID_PRIVATE_COMBFILTER  (V4L2_CID_PRIVATE_BASE + 1)
#define V4L2_CID_PRIVATE_AUTOMUTE    (V4L2_CID_PRIVATE_BASE + 2)
#define V4L2_CID_PRIVATE_LUMAFILTER  (V4L2_CID_PRIVATE_BASE + 3)
#define V4L2_CID_PRIVATE_AGC_CRUSH   (V4L2_CID_PRIVATE_BASE + 4)
#define V4L2_CID_PRIVATE_VCR_HACK    (V4L2_CID_PRIVATE_BASE + 5)
#define V4L2_CID_PRIVATE_WHITECRUSH_UPPER   (V4L2_CID_PRIVATE_BASE + 6)
#define V4L2_CID_PRIVATE_WHITECRUSH_LOWER   (V4L2_CID_PRIVATE_BASE + 7)
#define V4L2_CID_PRIVATE_UV_RATIO    (V4L2_CID_PRIVATE_BASE + 8)
#define V4L2_CID_PRIVATE_FULL_LUMA_RANGE    (V4L2_CID_PRIVATE_BASE + 9)
#define V4L2_CID_PRIVATE_CORING      (V4L2_CID_PRIVATE_BASE + 10)
#define V4L2_CID_PRIVATE_LASTP1      (V4L2_CID_PRIVATE_BASE + 11)

static const struct v4l2_queryctrl no_ctl = {
        .name  = "42",
        .flags = V4L2_CTRL_FLAG_DISABLED,
};
static const struct v4l2_queryctrl bttv_ctls[] = {
        /* --- video --- */
        {
                .id            = V4L2_CID_BRIGHTNESS,
                .name          = "Brightness",
                .minimum       = 0,
                .maximum       = 65535,
                .step          = 256,
                .default_value = 32768,
                .type          = V4L2_CTRL_TYPE_INTEGER,
        },{
                .id            = V4L2_CID_CONTRAST,
                .name          = "Contrast",
                .minimum       = 0,
                .maximum       = 65535,
                .step          = 128,
                .default_value = 32768,
                .type          = V4L2_CTRL_TYPE_INTEGER,
        },{
                .id            = V4L2_CID_SATURATION,
                .name          = "Saturation",
                .minimum       = 0,
                .maximum       = 65535,
                .step          = 128,
                .default_value = 32768,
                .type          = V4L2_CTRL_TYPE_INTEGER,
        },{
                .id            = V4L2_CID_HUE,
                .name          = "Hue",
                .minimum       = 0,
                .maximum       = 65535,
                .step          = 256,
                .default_value = 32768,
                .type          = V4L2_CTRL_TYPE_INTEGER,
        },
        /* --- audio --- */
        {
                .id            = V4L2_CID_AUDIO_MUTE,
                .name          = "Mute",
                .minimum       = 0,
                .maximum       = 1,
                .type          = V4L2_CTRL_TYPE_BOOLEAN,
        },{
                .id            = V4L2_CID_AUDIO_VOLUME,
                .name          = "Volume",
                .minimum       = 0,
                .maximum       = 65535,
                .step          = 65535/100,
                .default_value = 65535,
                .type          = V4L2_CTRL_TYPE_INTEGER,
        },{
                .id            = V4L2_CID_AUDIO_BALANCE,
                .name          = "Balance",
                .minimum       = 0,
                .maximum       = 65535,
                .step          = 65535/100,
                .default_value = 32768,
                .type          = V4L2_CTRL_TYPE_INTEGER,
        },{
                .id            = V4L2_CID_AUDIO_BASS,
                .name          = "Bass",
                .minimum       = 0,
                .maximum       = 65535,
                .step          = 65535/100,
                .default_value = 32768,
                .type          = V4L2_CTRL_TYPE_INTEGER,
        },{
                .id            = V4L2_CID_AUDIO_TREBLE,
                .name          = "Treble",
                .minimum       = 0,
                .maximum       = 65535,
                .step          = 65535/100,
                .default_value = 32768,
                .type          = V4L2_CTRL_TYPE_INTEGER,
        },
        /* --- private --- */
        {
                .id            = V4L2_CID_PRIVATE_CHROMA_AGC,
                .name          = "chroma agc",
                .minimum       = 0,
                .maximum       = 1,
                .type          = V4L2_CTRL_TYPE_BOOLEAN,
        },{
                .id            = V4L2_CID_PRIVATE_COMBFILTER,
                .name          = "combfilter",
                .minimum       = 0,
                .maximum       = 1,
                .type          = V4L2_CTRL_TYPE_BOOLEAN,
        },{
                .id            = V4L2_CID_PRIVATE_AUTOMUTE,
                .name          = "automute",
                .minimum       = 0,
                .maximum       = 1,
                .type          = V4L2_CTRL_TYPE_BOOLEAN,
        },{
                .id            = V4L2_CID_PRIVATE_LUMAFILTER,
                .name          = "luma decimation filter",
                .minimum       = 0,
                .maximum       = 1,
                .type          = V4L2_CTRL_TYPE_BOOLEAN,
        },{
                .id            = V4L2_CID_PRIVATE_AGC_CRUSH,
                .name          = "agc crush",
                .minimum       = 0,
                .maximum       = 1,
                .type          = V4L2_CTRL_TYPE_BOOLEAN,
        },{
                .id            = V4L2_CID_PRIVATE_VCR_HACK,
                .name          = "vcr hack",
                .minimum       = 0,
                .maximum       = 1,
                .type          = V4L2_CTRL_TYPE_BOOLEAN,
        },{
                .id            = V4L2_CID_PRIVATE_WHITECRUSH_UPPER,
                .name          = "whitecrush upper",
                .minimum       = 0,
                .maximum       = 255,
                .step          = 1,
                .default_value = 0xCF,
                .type          = V4L2_CTRL_TYPE_INTEGER,
        },{
                .id            = V4L2_CID_PRIVATE_WHITECRUSH_LOWER,
                .name          = "whitecrush lower",
                .minimum       = 0,
                .maximum       = 255,
                .step          = 1,
                .default_value = 0x7F,
                .type          = V4L2_CTRL_TYPE_INTEGER,
        },{
                .id            = V4L2_CID_PRIVATE_UV_RATIO,
                .name          = "uv ratio",
                .minimum       = 0,
                .maximum       = 100,
                .step          = 1,
                .default_value = 50,
                .type          = V4L2_CTRL_TYPE_INTEGER,
        },{
                .id            = V4L2_CID_PRIVATE_FULL_LUMA_RANGE,
                .name          = "full luma range",
                .minimum       = 0,
                .maximum       = 1,
                .type          = V4L2_CTRL_TYPE_BOOLEAN,
        },{
                .id            = V4L2_CID_PRIVATE_CORING,
                .name          = "coring",
                .minimum       = 0,
                .maximum       = 3,
                .step          = 1,
                .default_value = 0,
                .type          = V4L2_CTRL_TYPE_INTEGER,
        }



};

static const struct v4l2_queryctrl *ctrl_by_id(int id)
{
        int i;

        for (i = 0; i < ARRAY_SIZE(bttv_ctls); i++)
                if (bttv_ctls[i].id == id)
                        return bttv_ctls+i;

        return NULL;
}

/* ----------------------------------------------------------------------- */
/* resource management                                                     */

/*
   RESOURCE_    allocated by                freed by

   VIDEO_READ   bttv_read 1)                bttv_read 2)

   VIDEO_STREAM VIDIOC_STREAMON             VIDIOC_STREAMOFF
                 VIDIOC_QBUF 1)              bttv_release
                 VIDIOCMCAPTURE 1)

   OVERLAY       VIDIOCCAPTURE on            VIDIOCCAPTURE off
                 VIDIOC_OVERLAY on           VIDIOC_OVERLAY off
                 3)                          bttv_release

   VBI           VIDIOC_STREAMON             VIDIOC_STREAMOFF
                 VIDIOC_QBUF 1)              bttv_release
                 bttv_read, bttv_poll 1) 4)

   1) The resource must be allocated when we enter buffer prepare functions
      and remain allocated while buffers are in the DMA queue.
   2) This is a single frame read.
   3) VIDIOC_S_FBUF and VIDIOC_S_FMT (OVERLAY) still work when
      RESOURCE_OVERLAY is allocated.
   4) This is a continuous read, implies VIDIOC_STREAMON.

   Note this driver permits video input and standard changes regardless if
   resources are allocated.
*/

#define VBI_RESOURCES (RESOURCE_VBI)
#define VIDEO_RESOURCES (RESOURCE_VIDEO_READ | \
                         RESOURCE_VIDEO_STREAM | \
                         RESOURCE_OVERLAY)

static
int check_alloc_btres_lock(struct bttv *btv, struct bttv_fh *fh, int bit)
{
        int xbits; /* mutual exclusive resources */

        if (fh->resources & bit)
                /* have it already allocated */
                return 1;

        xbits = bit;
        if (bit & (RESOURCE_VIDEO_READ | RESOURCE_VIDEO_STREAM))
                xbits |= RESOURCE_VIDEO_READ | RESOURCE_VIDEO_STREAM;

        /* is it free? */
        if (btv->resources & xbits) {
                /* no, someone else uses it */
                goto fail;
        }

        if ((bit & VIDEO_RESOURCES)
            && 0 == (btv->resources & VIDEO_RESOURCES)) {
                /* Do crop - use current, don't - use default parameters. */
                __s32 top = btv->crop[!!fh->do_crop].rect.top;

                if (btv->vbi_end > top)
                        goto fail;

                /* We cannot capture the same line as video and VBI data.
                   Claim scan lines crop[].rect.top to bottom. */
                btv->crop_start = top;
        } else if (bit & VBI_RESOURCES) {
                __s32 end = fh->vbi_fmt.end;

                if (end > btv->crop_start)
                        goto fail;

                /* Claim scan lines above fh->vbi_fmt.end. */
                btv->vbi_end = end;
        }

        /* it's free, grab it */
        fh->resources  |= bit;
        btv->resources |= bit;
        return 1;

 fail:
        return 0;
}

static
int check_btres(struct bttv_fh *fh, int bit)
{
        return (fh->resources & bit);
}

static
int locked_btres(struct bttv *btv, int bit)
{
        return (btv->resources & bit);
}

/* Call with btv->lock down. */
static void
disclaim_vbi_lines(struct bttv *btv)
{
        btv->vbi_end = 0;
}

/* Call with btv->lock down. */
static void
disclaim_video_lines(struct bttv *btv)
{
        const struct bttv_tvnorm *tvnorm;
        u8 crop;

        tvnorm = &bttv_tvnorms[btv->tvnorm];
        btv->crop_start = tvnorm->cropcap.bounds.top
                + tvnorm->cropcap.bounds.height;

        /* VBI capturing ends at VDELAY, start of video capturing, no
           matter how many lines the VBI RISC program expects. When video
           capturing is off, it shall no longer "preempt" VBI capturing,
           so we set VDELAY to maximum. */
        crop = btread(BT848_E_CROP) | 0xc0;
        btwrite(crop, BT848_E_CROP);
        btwrite(0xfe, BT848_E_VDELAY_LO);
        btwrite(crop, BT848_O_CROP);
        btwrite(0xfe, BT848_O_VDELAY_LO);
}

static
void free_btres_lock(struct bttv *btv, struct bttv_fh *fh, int bits)
{
        if ((fh->resources & bits) != bits) {
                /* trying to free ressources not allocated by us ... */
                printk("bttv: BUG! (btres)\n");
        }
        fh->resources  &= ~bits;
        btv->resources &= ~bits;

        bits = btv->resources;

        if (0 == (bits & VIDEO_RESOURCES))
                disclaim_video_lines(btv);

        if (0 == (bits & VBI_RESOURCES))
                disclaim_vbi_lines(btv);
}

/* ----------------------------------------------------------------------- */
/* If Bt848a or Bt849, use PLL for PAL/SECAM and crystal for NTSC          */

/* Frequency = (F_input / PLL_X) * PLL_I.PLL_F/PLL_C
   PLL_X = Reference pre-divider (0=1, 1=2)
   PLL_C = Post divider (0=6, 1=4)
   PLL_I = Integer input
   PLL_F = Fractional input

   F_input = 28.636363 MHz:
   PAL (CLKx2 = 35.46895 MHz): PLL_X = 1, PLL_I = 0x0E, PLL_F = 0xDCF9, PLL_C = 0
*/

static void set_pll_freq(struct bttv *btv, unsigned int fin, unsigned int fout)
{
        unsigned char fl, fh, fi;

        /* prevent overflows */
        fin/=4;
        fout/=4;

        fout*=12;
        fi=fout/fin;

        fout=(fout%fin)*256;
        fh=fout/fin;

        fout=(fout%fin)*256;
        fl=fout/fin;

        btwrite(fl, BT848_PLL_F_LO);
        btwrite(fh, BT848_PLL_F_HI);
        btwrite(fi|BT848_PLL_X, BT848_PLL_XCI);
}

static void set_pll(struct bttv *btv)
{
        int i;

        if (!btv->pll.pll_crystal)
                return;

        if (btv->pll.pll_ofreq == btv->pll.pll_current) {

                dprintk("bttv%d: PLL: no change required\n",btv->c.nr);
                return;
        }

        if (btv->pll.pll_ifreq == btv->pll.pll_ofreq) {
                /* no PLL needed */
                if (btv->pll.pll_current == 0)
                        return;
                bttv_printk(KERN_INFO "bttv%d: PLL can sleep, using XTAL (%d).\n",
                        btv->c.nr,btv->pll.pll_ifreq);
                btwrite(0x00,BT848_TGCTRL);
                btwrite(0x00,BT848_PLL_XCI);
                btv->pll.pll_current = 0;
                return;
        }

        bttv_printk(KERN_INFO "bttv%d: PLL: %d => %d ",btv->c.nr,
                btv->pll.pll_ifreq, btv->pll.pll_ofreq);
        set_pll_freq(btv, btv->pll.pll_ifreq, btv->pll.pll_ofreq);

        for (i=0; i<10; i++) {
                /*  Let other people run while the PLL stabilizes */
                bttv_printk(".");
                msleep(10);

                if (btread(BT848_DSTATUS) & BT848_DSTATUS_PLOCK) {
                        btwrite(0,BT848_DSTATUS);
                } else {
                        btwrite(0x08,BT848_TGCTRL);
                        btv->pll.pll_current = btv->pll.pll_ofreq;
                        bttv_printk(" ok\n");
                        return;
                }
        }
        btv->pll.pll_current = -1;
        bttv_printk("failed\n");
        return;
}

/* used to switch between the bt848's analog/digital video capture modes */
static void bt848A_set_timing(struct bttv *btv)
{
        int i, len;
        int table_idx = bttv_tvnorms[btv->tvnorm].sram;
        int fsc       = bttv_tvnorms[btv->tvnorm].Fsc;

        if (btv->input == btv->dig) {
                dprintk("bttv%d: load digital timing table (table_idx=%d)\n",
                        btv->c.nr,table_idx);

                /* timing change...reset timing generator address */
                btwrite(0x00, BT848_TGCTRL);
                btwrite(0x02, BT848_TGCTRL);
                btwrite(0x00, BT848_TGCTRL);

                len=SRAM_Table[table_idx][0];
                for(i = 1; i <= len; i++)
                        btwrite(SRAM_Table[table_idx][i],BT848_TGLB);
                btv->pll.pll_ofreq = 27000000;

                set_pll(btv);
                btwrite(0x11, BT848_TGCTRL);
                btwrite(0x41, BT848_DVSIF);
        } else {
                btv->pll.pll_ofreq = fsc;
                set_pll(btv);
                btwrite(0x0, BT848_DVSIF);
        }
}

/* ----------------------------------------------------------------------- */

static void bt848_bright(struct bttv *btv, int bright)
{
        int value;

        // printk("bttv: set bright: %d\n",bright); // DEBUG
        btv->bright = bright;

        /* We want -128 to 127 we get 0-65535 */
        value = (bright >> 8) - 128;
        btwrite(value & 0xff, BT848_BRIGHT);
}

static void bt848_hue(struct bttv *btv, int hue)
{
        int value;

        btv->hue = hue;

        /* -128 to 127 */
        value = (hue >> 8) - 128;
        btwrite(value & 0xff, BT848_HUE);
}

static void bt848_contrast(struct bttv *btv, int cont)
{
        int value,hibit;

        btv->contrast = cont;

        /* 0-511 */
        value = (cont  >> 7);
        hibit = (value >> 6) & 4;
        btwrite(value & 0xff, BT848_CONTRAST_LO);
        btaor(hibit, ~4, BT848_E_CONTROL);
        btaor(hibit, ~4, BT848_O_CONTROL);
}

static void bt848_sat(struct bttv *btv, int color)
{
        int val_u,val_v,hibits;

        btv->saturation = color;

        /* 0-511 for the color */
        val_u   = ((color * btv->opt_uv_ratio) / 50) >> 7;
        val_v   = (((color * (100 - btv->opt_uv_ratio) / 50) >>7)*180L)/254;
        hibits  = (val_u >> 7) & 2;
        hibits |= (val_v >> 8) & 1;
        btwrite(val_u & 0xff, BT848_SAT_U_LO);
        btwrite(val_v & 0xff, BT848_SAT_V_LO);
        btaor(hibits, ~3, BT848_E_CONTROL);
        btaor(hibits, ~3, BT848_O_CONTROL);
}

/* ----------------------------------------------------------------------- */

static int
video_mux(struct bttv *btv, unsigned int input)
{
        int mux,mask2;

        if (input >= bttv_tvcards[btv->c.type].video_inputs)
                return -EINVAL;

        /* needed by RemoteVideo MX */
        mask2 = bttv_tvcards[btv->c.type].gpiomask2;
        if (mask2)
                gpio_inout(mask2,mask2);

        if (input == btv->svhs)  {
                btor(BT848_CONTROL_COMP, BT848_E_CONTROL);
                btor(BT848_CONTROL_COMP, BT848_O_CONTROL);
        } else {
                btand(~BT848_CONTROL_COMP, BT848_E_CONTROL);
                btand(~BT848_CONTROL_COMP, BT848_O_CONTROL);
        }
        mux = bttv_muxsel(btv, input);
        btaor(mux<<5, ~(3<<5), BT848_IFORM);
        dprintk(KERN_DEBUG "bttv%d: video mux: input=%d mux=%d\n",
                btv->c.nr,input,mux);

        /* card specific hook */
        if(bttv_tvcards[btv->c.type].muxsel_hook)
                bttv_tvcards[btv->c.type].muxsel_hook (btv, input);
        return 0;
}

static char *audio_modes[] = {
        "audio: tuner", "audio: radio", "audio: extern",
        "audio: intern", "audio: mute"
};

static int
audio_mux(struct bttv *btv, int input, int mute)
{
        int gpio_val, signal;
        struct v4l2_control ctrl;

        gpio_inout(bttv_tvcards[btv->c.type].gpiomask,
                   bttv_tvcards[btv->c.type].gpiomask);
        signal = btread(BT848_DSTATUS) & BT848_DSTATUS_HLOC;

        btv->mute = mute;
        btv->audio = input;

        /* automute */
        mute = mute || (btv->opt_automute && !signal && !btv->radio_user);

        if (mute)
                gpio_val = bttv_tvcards[btv->c.type].gpiomute;
        else
                gpio_val = bttv_tvcards[btv->c.type].gpiomux[input];

        switch (btv->c.type) {
        case BTTV_BOARD_VOODOOTV_FM:
        case BTTV_BOARD_VOODOOTV_200:
                gpio_val = bttv_tda9880_setnorm(btv, gpio_val);
                break;

        default:
                gpio_bits(bttv_tvcards[btv->c.type].gpiomask, gpio_val);
        }

        if (bttv_gpio)
                bttv_gpio_tracking(btv, audio_modes[mute ? 4 : input]);
        if (in_interrupt())
                return 0;

        ctrl.id = V4L2_CID_AUDIO_MUTE;
        ctrl.value = btv->mute;
        bttv_call_all(btv, core, s_ctrl, &ctrl);
        if (btv->sd_msp34xx) {
                u32 in;

                /* Note: the inputs tuner/radio/extern/intern are translated
                   to msp routings. This assumes common behavior for all msp3400
                   based TV cards. When this assumption fails, then the
                   specific MSP routing must be added to the card table.
                   For now this is sufficient. */
                switch (input) {
                case TVAUDIO_INPUT_RADIO:
                        in = MSP_INPUT(MSP_IN_SCART2, MSP_IN_TUNER1,
                                    MSP_DSP_IN_SCART, MSP_DSP_IN_SCART);
                        break;
                case TVAUDIO_INPUT_EXTERN:
                        in = MSP_INPUT(MSP_IN_SCART1, MSP_IN_TUNER1,
                                    MSP_DSP_IN_SCART, MSP_DSP_IN_SCART);
                        break;
                case TVAUDIO_INPUT_INTERN:
                        /* Yes, this is the same input as for RADIO. I doubt
                           if this is ever used. The only board with an INTERN
                           input is the BTTV_BOARD_AVERMEDIA98. I wonder how
                           that was tested. My guess is that the whole INTERN
                           input does not work. */
                        in = MSP_INPUT(MSP_IN_SCART2, MSP_IN_TUNER1,
                                    MSP_DSP_IN_SCART, MSP_DSP_IN_SCART);
                        break;
                case TVAUDIO_INPUT_TUNER:
                default:
                        /* This is the only card that uses TUNER2, and afaik,
                           is the only difference between the VOODOOTV_FM
                           and VOODOOTV_200 */
                        if (btv->c.type == BTTV_BOARD_VOODOOTV_200)
                                in = MSP_INPUT(MSP_IN_SCART1, MSP_IN_TUNER2, \
                                        MSP_DSP_IN_TUNER, MSP_DSP_IN_TUNER);
                        else
                                in = MSP_INPUT_DEFAULT;
                        break;
                }
                v4l2_subdev_call(btv->sd_msp34xx, audio, s_routing,
                               in, MSP_OUTPUT_DEFAULT, 0);
        }
        if (btv->sd_tvaudio) {
                v4l2_subdev_call(btv->sd_tvaudio, audio, s_routing,
                                input, 0, 0);
        }
        return 0;
}

static inline int
audio_mute(struct bttv *btv, int mute)
{
        return audio_mux(btv, btv->audio, mute);
}

static inline int
audio_input(struct bttv *btv, int input)
{
        return audio_mux(btv, input, btv->mute);
}

static void
bttv_crop_calc_limits(struct bttv_crop *c)
{
        /* Scale factor min. 1:1, max. 16:1. Min. image size
           48 x 32. Scaled width must be a multiple of 4. */

        if (1) {
                /* For bug compatibility with VIDIOCGCAP and image
                   size checks in earlier driver versions. */
                c->min_scaled_width = 48;
                c->min_scaled_height = 32;
        } else {
                c->min_scaled_width =
                        (max(48, c->rect.width >> 4) + 3) & ~3;
                c->min_scaled_height =
                        max(32, c->rect.height >> 4);
        }

        c->max_scaled_width  = c->rect.width & ~3;
        c->max_scaled_height = c->rect.height;
}

static void
bttv_crop_reset(struct bttv_crop *c, unsigned int norm)
{
        c->rect = bttv_tvnorms[norm].cropcap.defrect;
        bttv_crop_calc_limits(c);
}

/* Call with btv->lock down. */
static int
set_tvnorm(struct bttv *btv, unsigned int norm)
{
        const struct bttv_tvnorm *tvnorm;
        v4l2_std_id id;

        BUG_ON(norm >= BTTV_TVNORMS);
        BUG_ON(btv->tvnorm >= BTTV_TVNORMS);

        tvnorm = &bttv_tvnorms[norm];

        if (memcmp(&bttv_tvnorms[btv->tvnorm].cropcap, &tvnorm->cropcap,
                    sizeof (tvnorm->cropcap))) {
                bttv_crop_reset(&btv->crop[0], norm);
                btv->crop[1] = btv->crop[0]; /* current = default */

                if (0 == (btv->resources & VIDEO_RESOURCES)) {
                        btv->crop_start = tvnorm->cropcap.bounds.top
                                + tvnorm->cropcap.bounds.height;
                }
        }

        btv->tvnorm = norm;

        btwrite(tvnorm->adelay, BT848_ADELAY);
        btwrite(tvnorm->bdelay, BT848_BDELAY);
        btaor(tvnorm->iform,~(BT848_IFORM_NORM|BT848_IFORM_XTBOTH),
              BT848_IFORM);
        btwrite(tvnorm->vbipack, BT848_VBI_PACK_SIZE);
        btwrite(1, BT848_VBI_PACK_DEL);
        bt848A_set_timing(btv);

        switch (btv->c.type) {
        case BTTV_BOARD_VOODOOTV_FM:
        case BTTV_BOARD_VOODOOTV_200:
                bttv_tda9880_setnorm(btv, gpio_read());
                break;
        }
        id = tvnorm->v4l2_id;
        bttv_call_all(btv, core, s_std, id);

        return 0;
}

/* Call with btv->lock down. */
static void
set_input(struct bttv *btv, unsigned int input, unsigned int norm)
{
        unsigned long flags;

        btv->input = input;
        if (irq_iswitch) {
                spin_lock_irqsave(&btv->s_lock,flags);
                if (btv->curr.frame_irq) {
                        /* active capture -> delayed input switch */
                        btv->new_input = input;
                } else {
                        video_mux(btv,input);
                }
                spin_unlock_irqrestore(&btv->s_lock,flags);
        } else {
                video_mux(btv,input);
        }
        audio_input(btv, (btv->tuner_type != TUNER_ABSENT && input == 0) ?
                         TVAUDIO_INPUT_TUNER : TVAUDIO_INPUT_EXTERN);
        set_tvnorm(btv, norm);
}

static void init_irqreg(struct bttv *btv)
{
        /* clear status */
        btwrite(0xfffffUL, BT848_INT_STAT);

        if (bttv_tvcards[btv->c.type].no_video) {
                /* i2c only */
                btwrite(BT848_INT_I2CDONE,
                        BT848_INT_MASK);
        } else {
                /* full video */
                btwrite((btv->triton1)  |
                        (btv->gpioirq ? BT848_INT_GPINT : 0) |
                        BT848_INT_SCERR |
                        (fdsr ? BT848_INT_FDSR : 0) |
                        BT848_INT_RISCI | BT848_INT_OCERR |
                        BT848_INT_FMTCHG|BT848_INT_HLOCK|
                        BT848_INT_I2CDONE,
                        BT848_INT_MASK);
        }
}

static void init_bt848(struct bttv *btv)
{
        int val;

        if (bttv_tvcards[btv->c.type].no_video) {
                /* very basic init only */
                init_irqreg(btv);
                return;
        }

        btwrite(0x00, BT848_CAP_CTL);
        btwrite(BT848_COLOR_CTL_GAMMA, BT848_COLOR_CTL);
        btwrite(BT848_IFORM_XTAUTO | BT848_IFORM_AUTO, BT848_IFORM);

        /* set planar and packed mode trigger points and         */
        /* set rising edge of inverted GPINTR pin as irq trigger */
        btwrite(BT848_GPIO_DMA_CTL_PKTP_32|
                BT848_GPIO_DMA_CTL_PLTP1_16|
                BT848_GPIO_DMA_CTL_PLTP23_16|
                BT848_GPIO_DMA_CTL_GPINTC|
                BT848_GPIO_DMA_CTL_GPINTI,
                BT848_GPIO_DMA_CTL);

        val = btv->opt_chroma_agc ? BT848_SCLOOP_CAGC : 0;
        btwrite(val, BT848_E_SCLOOP);
        btwrite(val, BT848_O_SCLOOP);

        btwrite(0x20, BT848_E_VSCALE_HI);
        btwrite(0x20, BT848_O_VSCALE_HI);
        btwrite(BT848_ADC_RESERVED | (btv->opt_adc_crush ? BT848_ADC_CRUSH : 0),
                BT848_ADC);

        btwrite(whitecrush_upper, BT848_WC_UP);
        btwrite(whitecrush_lower, BT848_WC_DOWN);

        if (btv->opt_lumafilter) {
                btwrite(0, BT848_E_CONTROL);
                btwrite(0, BT848_O_CONTROL);
        } else {
                btwrite(BT848_CONTROL_LDEC, BT848_E_CONTROL);
                btwrite(BT848_CONTROL_LDEC, BT848_O_CONTROL);
        }

        bt848_bright(btv,   btv->bright);
        bt848_hue(btv,      btv->hue);
        bt848_contrast(btv, btv->contrast);
        bt848_sat(btv,      btv->saturation);

        /* interrupt */
        init_irqreg(btv);
}

static void bttv_reinit_bt848(struct bttv *btv)
{
        unsigned long flags;

        if (bttv_verbose)
                printk(KERN_INFO "bttv%d: reset, reinitialize\n",btv->c.nr);
        spin_lock_irqsave(&btv->s_lock,flags);
        btv->errors=0;
        bttv_set_dma(btv,0);
        spin_unlock_irqrestore(&btv->s_lock,flags);

        init_bt848(btv);
        btv->pll.pll_current = -1;
        set_input(btv, btv->input, btv->tvnorm);
}

static int bttv_g_ctrl(struct file *file, void *priv,
                                        struct v4l2_control *c)
{
        struct bttv_fh *fh = priv;
        struct bttv *btv = fh->btv;

        switch (c->id) {
        case V4L2_CID_BRIGHTNESS:
                c->value = btv->bright;
                break;
        case V4L2_CID_HUE:
                c->value = btv->hue;
                break;
        case V4L2_CID_CONTRAST:
                c->value = btv->contrast;
                break;
        case V4L2_CID_SATURATION:
                c->value = btv->saturation;
                break;

        case V4L2_CID_AUDIO_MUTE:
        case V4L2_CID_AUDIO_VOLUME:
        case V4L2_CID_AUDIO_BALANCE:
        case V4L2_CID_AUDIO_BASS:
        case V4L2_CID_AUDIO_TREBLE:
                bttv_call_all(btv, core, g_ctrl, c);
                break;

        case V4L2_CID_PRIVATE_CHROMA_AGC:
                c->value = btv->opt_chroma_agc;
                break;
        case V4L2_CID_PRIVATE_COMBFILTER:
                c->value = btv->opt_combfilter;
                break;
        case V4L2_CID_PRIVATE_LUMAFILTER:
                c->value = btv->opt_lumafilter;
                break;
        case V4L2_CID_PRIVATE_AUTOMUTE:
                c->value = btv->opt_automute;
                break;
        case V4L2_CID_PRIVATE_AGC_CRUSH:
                c->value = btv->opt_adc_crush;
                break;
        case V4L2_CID_PRIVATE_VCR_HACK:
                c->value = btv->opt_vcr_hack;
                break;
        case V4L2_CID_PRIVATE_WHITECRUSH_UPPER:
                c->value = btv->opt_whitecrush_upper;
                break;
        case V4L2_CID_PRIVATE_WHITECRUSH_LOWER:
                c->value = btv->opt_whitecrush_lower;
                break;
        case V4L2_CID_PRIVATE_UV_RATIO:
                c->value = btv->opt_uv_ratio;
                break;
        case V4L2_CID_PRIVATE_FULL_LUMA_RANGE:
                c->value = btv->opt_full_luma_range;
                break;
        case V4L2_CID_PRIVATE_CORING:
                c->value = btv->opt_coring;
                break;
        default:
                return -EINVAL;
        }
        return 0;
}

static int bttv_s_ctrl(struct file *file, void *f,
                                        struct v4l2_control *c)
{
        int err;
        int val;
        struct bttv_fh *fh = f;
        struct bttv *btv = fh->btv;

        err = v4l2_prio_check(&btv->prio, fh->prio);
        if (0 != err)
                return err;

        switch (c->id) {
        case V4L2_CID_BRIGHTNESS:
                bt848_bright(btv, c->value);
                break;
        case V4L2_CID_HUE:
                bt848_hue(btv, c->value);
                break;
        case V4L2_CID_CONTRAST:
                bt848_contrast(btv, c->value);
                break;
        case V4L2_CID_SATURATION:
                bt848_sat(btv, c->value);
                break;
        case V4L2_CID_AUDIO_MUTE:
                audio_mute(btv, c->value);
                /* fall through */
        case V4L2_CID_AUDIO_VOLUME:
                if (btv->volume_gpio)
                        btv->volume_gpio(btv, c->value);

                bttv_call_all(btv, core, s_ctrl, c);
                break;
        case V4L2_CID_AUDIO_BALANCE:
        case V4L2_CID_AUDIO_BASS:
        case V4L2_CID_AUDIO_TREBLE:
                bttv_call_all(btv, core, s_ctrl, c);
                break;

        case V4L2_CID_PRIVATE_CHROMA_AGC:
                btv->opt_chroma_agc = c->value;
                val = btv->opt_chroma_agc ? BT848_SCLOOP_CAGC : 0;
                btwrite(val, BT848_E_SCLOOP);
                btwrite(val, BT848_O_SCLOOP);
                break;
        case V4L2_CID_PRIVATE_COMBFILTER:
                btv->opt_combfilter = c->value;
                break;
        case V4L2_CID_PRIVATE_LUMAFILTER:
                btv->opt_lumafilter = c->value;
                if (btv->opt_lumafilter) {
                        btand(~BT848_CONTROL_LDEC, BT848_E_CONTROL);
                        btand(~BT848_CONTROL_LDEC, BT848_O_CONTROL);
                } else {
                        btor(BT848_CONTROL_LDEC, BT848_E_CONTROL);
                        btor(BT848_CONTROL_LDEC, BT848_O_CONTROL);
                }
                break;
        case V4L2_CID_PRIVATE_AUTOMUTE:
                btv->opt_automute = c->value;
                break;
        case V4L2_CID_PRIVATE_AGC_CRUSH:
                btv->opt_adc_crush = c->value;
                btwrite(BT848_ADC_RESERVED |
                                (btv->opt_adc_crush ? BT848_ADC_CRUSH : 0),
                                BT848_ADC);
                break;
        case V4L2_CID_PRIVATE_VCR_HACK:
                btv->opt_vcr_hack = c->value;
                break;
        case V4L2_CID_PRIVATE_WHITECRUSH_UPPER:
                btv->opt_whitecrush_upper = c->value;
                btwrite(c->value, BT848_WC_UP);
                break;
        case V4L2_CID_PRIVATE_WHITECRUSH_LOWER:
                btv->opt_whitecrush_lower = c->value;
                btwrite(c->value, BT848_WC_DOWN);
                break;
        case V4L2_CID_PRIVATE_UV_RATIO:
                btv->opt_uv_ratio = c->value;
                bt848_sat(btv, btv->saturation);
                break;
        case V4L2_CID_PRIVATE_FULL_LUMA_RANGE:
                btv->opt_full_luma_range = c->value;
                btaor((c->value<<7), ~BT848_OFORM_RANGE, BT848_OFORM);
                break;
        case V4L2_CID_PRIVATE_CORING:
                btv->opt_coring = c->value;
                btaor((c->value<<5), ~BT848_OFORM_CORE32, BT848_OFORM);
                break;
        default:
                return -EINVAL;
        }
        return 0;
}

/* ----------------------------------------------------------------------- */

void bttv_gpio_tracking(struct bttv *btv, char *comment)
{
        unsigned int outbits, data;
        outbits = btread(BT848_GPIO_OUT_EN);
        data    = btread(BT848_GPIO_DATA);
        printk(KERN_DEBUG "bttv%d: gpio: en=%08x, out=%08x in=%08x [%s]\n",
               btv->c.nr,outbits,data & outbits, data & ~outbits, comment);
}

static void bttv_field_count(struct bttv *btv)
{
        int need_count = 0;

        if (btv->users)
                need_count++;

        if (need_count) {
                /* start field counter */
                btor(BT848_INT_VSYNC,BT848_INT_MASK);
        } else {
                /* stop field counter */
                btand(~BT848_INT_VSYNC,BT848_INT_MASK);
                btv->field_count = 0;
        }
}

static const struct bttv_format*
format_by_fourcc(int fourcc)
{
        unsigned int i;

        for (i = 0; i < FORMATS; i++) {
                if (-1 == formats[i].fourcc)
                        continue;
                if (formats[i].fourcc == fourcc)
                        return formats+i;
        }
        return NULL;
}

/* ----------------------------------------------------------------------- */
/* misc helpers                                                            */

static int
bttv_switch_overlay(struct bttv *btv, struct bttv_fh *fh,
                    struct bttv_buffer *new)
{
        struct bttv_buffer *old;
        unsigned long flags;
        int retval = 0;

        dprintk("switch_overlay: enter [new=%p]\n",new);
        if (new)
                new->vb.state = VIDEOBUF_DONE;
        spin_lock_irqsave(&btv->s_lock,flags);
        old = btv->screen;
        btv->screen = new;
        btv->loop_irq |= 1;
        bttv_set_dma(btv, 0x03);
        spin_unlock_irqrestore(&btv->s_lock,flags);
        if (NULL != old) {
                dprintk("switch_overlay: old=%p state is %d\n",old,old->vb.state);
                bttv_dma_free(&fh->cap,btv, old);
                kfree(old);
        }
        if (NULL == new)
                free_btres_lock(btv,fh,RESOURCE_OVERLAY);
        dprintk("switch_overlay: done\n");
        return retval;
}

/* ----------------------------------------------------------------------- */
/* video4linux (1) interface                                               */

static int bttv_prepare_buffer(struct videobuf_queue *q,struct bttv *btv,
                               struct bttv_buffer *buf,
                               const struct bttv_format *fmt,
                               unsigned int width, unsigned int height,
                               enum v4l2_field field)
{
        struct bttv_fh *fh = q->priv_data;
        int redo_dma_risc = 0;
        struct bttv_crop c;
        int norm;
        int rc;

        /* check settings */
        if (NULL == fmt)
                return -EINVAL;
        if (fmt->btformat == BT848_COLOR_FMT_RAW) {
                width  = RAW_BPL;
                height = RAW_LINES*2;
                if (width*height > buf->vb.bsize)
                        return -EINVAL;
                buf->vb.size = buf->vb.bsize;

                /* Make sure tvnorm and vbi_end remain consistent
                   until we're done. */

                norm = btv->tvnorm;

                /* In this mode capturing always starts at defrect.top
                   (default VDELAY), ignoring cropping parameters. */
                if (btv->vbi_end > bttv_tvnorms[norm].cropcap.defrect.top) {
                        return -EINVAL;
                }

                c.rect = bttv_tvnorms[norm].cropcap.defrect;
        } else {
                norm = btv->tvnorm;
                c = btv->crop[!!fh->do_crop];

                if (width < c.min_scaled_width ||
                    width > c.max_scaled_width ||
                    height < c.min_scaled_height)
                        return -EINVAL;

                switch (field) {
                case V4L2_FIELD_TOP:
                case V4L2_FIELD_BOTTOM:
                case V4L2_FIELD_ALTERNATE:
                        /* btv->crop counts frame lines. Max. scale
                           factor is 16:1 for frames, 8:1 for fields. */
                        if (height * 2 > c.max_scaled_height)
                                return -EINVAL;
                        break;

                default:
                        if (height > c.max_scaled_height)
                                return -EINVAL;
                        break;
                }

                buf->vb.size = (width * height * fmt->depth) >> 3;
                if (0 != buf->vb.baddr  &&  buf->vb.bsize < buf->vb.size)
                        return -EINVAL;
        }

        /* alloc + fill struct bttv_buffer (if changed) */
        if (buf->vb.width != width || buf->vb.height != height ||
            buf->vb.field != field ||
            buf->tvnorm != norm || buf->fmt != fmt ||
            buf->crop.top != c.rect.top ||
            buf->crop.left != c.rect.left ||
            buf->crop.width != c.rect.width ||
            buf->crop.height != c.rect.height) {
                buf->vb.width  = width;
                buf->vb.height = height;
                buf->vb.field  = field;
                buf->tvnorm    = norm;
                buf->fmt       = fmt;
                buf->crop      = c.rect;
                redo_dma_risc = 1;
        }

        /* alloc risc memory */
        if (VIDEOBUF_NEEDS_INIT == buf->vb.state) {
                redo_dma_risc = 1;
                if (0 != (rc = videobuf_iolock(q,&buf->vb,&btv->fbuf)))
                        goto fail;
        }

        if (redo_dma_risc)
                if (0 != (rc = bttv_buffer_risc(btv,buf)))
                        goto fail;

        buf->vb.state = VIDEOBUF_PREPARED;
        return 0;

 fail:
        bttv_dma_free(q,btv,buf);
        return rc;
}

static int
buffer_setup(struct videobuf_queue *q, unsigned int *count, unsigned int *size)
{
        struct bttv_fh *fh = q->priv_data;

        *size = fh->fmt->depth*fh->width*fh->height >> 3;
        if (0 == *count)
                *count = gbuffers;
        if (*size * *count > gbuffers * gbufsize)
                *count = (gbuffers * gbufsize) / *size;
        return 0;
}

static int
buffer_prepare(struct videobuf_queue *q, struct videobuf_buffer *vb,
               enum v4l2_field field)
{
        struct bttv_buffer *buf = container_of(vb,struct bttv_buffer,vb);
        struct bttv_fh *fh = q->priv_data;

        return bttv_prepare_buffer(q,fh->btv, buf, fh->fmt,
                                   fh->width, fh->height, field);
}

static void
buffer_queue(struct videobuf_queue *q, struct videobuf_buffer *vb)
{
        struct bttv_buffer *buf = container_of(vb,struct bttv_buffer,vb);
        struct bttv_fh *fh = q->priv_data;
        struct bttv    *btv = fh->btv;

        buf->vb.state = VIDEOBUF_QUEUED;
        list_add_tail(&buf->vb.queue,&btv->capture);
        if (!btv->curr.frame_irq) {
                btv->loop_irq |= 1;
                bttv_set_dma(btv, 0x03);
        }
}

static void buffer_release(struct videobuf_queue *q, struct videobuf_buffer *vb)
{
        struct bttv_buffer *buf = container_of(vb,struct bttv_buffer,vb);
        struct bttv_fh *fh = q->priv_data;

        bttv_dma_free(q,fh->btv,buf);
}

static struct videobuf_queue_ops bttv_video_qops = {
        .buf_setup    = buffer_setup,
        .buf_prepare  = buffer_prepare,
        .buf_queue    = buffer_queue,
        .buf_release  = buffer_release,
};

static int bttv_s_std(struct file *file, void *priv, v4l2_std_id *id)
{
        struct bttv_fh *fh  = priv;
        struct bttv *btv = fh->btv;
        unsigned int i;
        int err;

        err = v4l2_prio_check(&btv->prio, fh->prio);
        if (err)
                goto err;

        for (i = 0; i < BTTV_TVNORMS; i++)
                if (*id & bttv_tvnorms[i].v4l2_id)
                        break;
        if (i == BTTV_TVNORMS) {
                err = -EINVAL;
                goto err;
        }

        set_tvnorm(btv, i);

err:

        return err;
}

static int bttv_querystd(struct file *file, void *f, v4l2_std_id *id)
{
        struct bttv_fh *fh = f;
        struct bttv *btv = fh->btv;

        if (btread(BT848_DSTATUS) & BT848_DSTATUS_NUML)
                *id = V4L2_STD_625_50;
        else
                *id = V4L2_STD_525_60;
        return 0;
}

static int bttv_enum_input(struct file *file, void *priv,
                                        struct v4l2_input *i)
{
        struct bttv_fh *fh = priv;
        struct bttv *btv = fh->btv;
        int rc = 0;

        if (i->index >= bttv_tvcards[btv->c.type].video_inputs) {
                rc = -EINVAL;
                goto err;
        }

        i->type     = V4L2_INPUT_TYPE_CAMERA;
        i->audioset = 1;

        if (btv->tuner_type != TUNER_ABSENT && i->index == 0) {
                sprintf(i->name, "Television");
                i->type  = V4L2_INPUT_TYPE_TUNER;
                i->tuner = 0;
        } else if (i->index == btv->svhs) {
                sprintf(i->name, "S-Video");
        } else {
                sprintf(i->name, "Composite%d", i->index);
        }

        if (i->index == btv->input) {
                __u32 dstatus = btread(BT848_DSTATUS);
                if (0 == (dstatus & BT848_DSTATUS_PRES))
                        i->status |= V4L2_IN_ST_NO_SIGNAL;
                if (0 == (dstatus & BT848_DSTATUS_HLOC))
                        i->status |= V4L2_IN_ST_NO_H_LOCK;
        }

        i->std = BTTV_NORMS;

err:

        return rc;
}

static int bttv_g_input(struct file *file, void *priv, unsigned int *i)
{
        struct bttv_fh *fh = priv;
        struct bttv *btv = fh->btv;

        *i = btv->input;

        return 0;
}

static int bttv_s_input(struct file *file, void *priv, unsigned int i)
{
        struct bttv_fh *fh  = priv;
        struct bttv *btv = fh->btv;

        int err;

        err = v4l2_prio_check(&btv->prio, fh->prio);
        if (unlikely(err))
                goto err;

        if (i > bttv_tvcards[btv->c.type].video_inputs) {
                err = -EINVAL;
                goto err;
        }

        set_input(btv, i, btv->tvnorm);

err:
        return 0;
}

static int bttv_s_tuner(struct file *file, void *priv,
                                        struct v4l2_tuner *t)
{
        struct bttv_fh *fh  = priv;
        struct bttv *btv = fh->btv;
        int err;

        if (unlikely(0 != t->index))
                return -EINVAL;

        if (unlikely(btv->tuner_type == TUNER_ABSENT)) {
                err = -EINVAL;
                goto err;
        }

        err = v4l2_prio_check(&btv->prio, fh->prio);
        if (unlikely(err))
                goto err;

        bttv_call_all(btv, tuner, s_tuner, t);

        if (btv->audio_mode_gpio)
                btv->audio_mode_gpio(btv, t, 1);

err:

        return 0;
}

static int bttv_g_frequency(struct file *file, void *priv,
                                        struct v4l2_frequency *f)
{
        struct bttv_fh *fh  = priv;
        struct bttv *btv = fh->btv;

        f->type = btv->radio_user ? V4L2_TUNER_RADIO : V4L2_TUNER_ANALOG_TV;
        f->frequency = btv->freq;

        return 0;
}

static int bttv_s_frequency(struct file *file, void *priv,
                                        struct v4l2_frequency *f)
{
        struct bttv_fh *fh  = priv;

        struct bttv *btv = fh->btv;
        int err;

        if (unlikely(f->tuner != 0))
                return -EINVAL;

        err = v4l2_prio_check(&btv->prio, fh->prio);
        if (unlikely(err))
                goto err;

        if (unlikely(f->type != (btv->radio_user
                ? V4L2_TUNER_RADIO : V4L2_TUNER_ANALOG_TV))) {
                err = -EINVAL;
                goto err;
        }
        btv->freq = f->frequency;
        bttv_call_all(btv, tuner, s_frequency, f);
        if (btv->has_matchbox && btv->radio_user)
                tea5757_set_freq(btv, btv->freq);
err:

        return 0;
}

static int bttv_log_status(struct file *file, void *f)
{
        struct bttv_fh *fh  = f;
        struct bttv *btv = fh->btv;

        printk(KERN_INFO "bttv%d: ========  START STATUS CARD #%d  ========\n",
                        btv->c.nr, btv->c.nr);
        bttv_call_all(btv, core, log_status);
        printk(KERN_INFO "bttv%d: ========  END STATUS CARD   #%d  ========\n",
                        btv->c.nr, btv->c.nr);
        return 0;
}

#ifdef CONFIG_VIDEO_ADV_DEBUG
static int bttv_g_register(struct file *file, void *f,
                                        struct v4l2_dbg_register *reg)
{
        struct bttv_fh *fh = f;
        struct bttv *btv = fh->btv;

        if (!capable(CAP_SYS_ADMIN))
                return -EPERM;

        if (!v4l2_chip_match_host(&reg->match))
                return -EINVAL;

        /* bt848 has a 12-bit register space */
        reg->reg &= 0xfff;
        reg->val = btread(reg->reg);
        reg->size = 1;

        return 0;
}

static int bttv_s_register(struct file *file, void *f,
                                        struct v4l2_dbg_register *reg)
{
        struct bttv_fh *fh = f;
        struct bttv *btv = fh->btv;

        if (!capable(CAP_SYS_ADMIN))
                return -EPERM;

        if (!v4l2_chip_match_host(&reg->match))
                return -EINVAL;

        /* bt848 has a 12-bit register space */
        reg->reg &= 0xfff;
        btwrite(reg->val, reg->reg);

        return 0;
}
#endif

/* Given cropping boundaries b and the scaled width and height of a
   single field or frame, which must not exceed hardware limits, this
   function adjusts the cropping parameters c. */
static void
bttv_crop_adjust        (struct bttv_crop *             c,
                         const struct v4l2_rect *       b,
                         __s32                          width,
                         __s32                          height,
                         enum v4l2_field                field)
{
        __s32 frame_height = height << !V4L2_FIELD_HAS_BOTH(field);
        __s32 max_left;
        __s32 max_top;

        if (width < c->min_scaled_width) {
                /* Max. hor. scale factor 16:1. */
                c->rect.width = width * 16;
        } else if (width > c->max_scaled_width) {
                /* Min. hor. scale factor 1:1. */
                c->rect.width = width;

                max_left = b->left + b->width - width;
                max_left = min(max_left, (__s32) MAX_HDELAY);
                if (c->rect.left > max_left)
                        c->rect.left = max_left;
        }

        if (height < c->min_scaled_height) {
                /* Max. vert. scale factor 16:1, single fields 8:1. */
                c->rect.height = height * 16;
        } else if (frame_height > c->max_scaled_height) {
                /* Min. vert. scale factor 1:1.
                   Top and height count field lines times two. */
                c->rect.height = (frame_height + 1) & ~1;

                max_top = b->top + b->height - c->rect.height;
                if (c->rect.top > max_top)
                        c->rect.top = max_top;
        }

        bttv_crop_calc_limits(c);
}

/* Returns an error if scaling to a frame or single field with the given
   width and height is not possible with the current cropping parameters
   and width aligned according to width_mask. If adjust_size is TRUE the
   function may adjust the width and/or height instead, rounding width
   to (width + width_bias) & width_mask. If adjust_crop is TRUE it may
   also adjust the current cropping parameters to get closer to the
   desired image size. */
static int
limit_scaled_size_lock       (struct bttv_fh *               fh,
                         __s32 *                        width,
                         __s32 *                        height,
                         enum v4l2_field                field,
                         unsigned int                   width_mask,
                         unsigned int                   width_bias,
                         int                            adjust_size,
                         int                            adjust_crop)
{
        struct bttv *btv = fh->btv;
        const struct v4l2_rect *b;
        struct bttv_crop *c;
        __s32 min_width;
        __s32 min_height;
        __s32 max_width;
        __s32 max_height;
        int rc;

        BUG_ON((int) width_mask >= 0 ||
               width_bias >= (unsigned int) -width_mask);

        /* Make sure tvnorm, vbi_end and the current cropping parameters
           remain consistent until we're done. */

        b = &bttv_tvnorms[btv->tvnorm].cropcap.bounds;

        /* Do crop - use current, don't - use default parameters. */
        c = &btv->crop[!!fh->do_crop];

        if (fh->do_crop
            && adjust_size
            && adjust_crop
            && !locked_btres(btv, VIDEO_RESOURCES)) {
                min_width = 48;
                min_height = 32;

                /* We cannot scale up. When the scaled image is larger
                   than crop.rect we adjust the crop.rect as required
                   by the V4L2 spec, hence cropcap.bounds are our limit. */
                max_width = min(b->width, (__s32) MAX_HACTIVE);
                max_height = b->height;

                /* We cannot capture the same line as video and VBI data.
                   Note btv->vbi_end is really a minimum, see
                   bttv_vbi_try_fmt(). */
                if (btv->vbi_end > b->top) {
                        max_height -= btv->vbi_end - b->top;
                        rc = -EBUSY;
                        if (min_height > max_height)
                                goto fail;
                }
        } else {
                rc = -EBUSY;
                if (btv->vbi_end > c->rect.top)
                        goto fail;

                min_width  = c->min_scaled_width;
                min_height = c->min_scaled_height;
                max_width  = c->max_scaled_width;
                max_height = c->max_scaled_height;

                adjust_crop = 0;
        }

        min_width = (min_width - width_mask - 1) & width_mask;
        max_width = max_width & width_mask;

        /* Max. scale factor is 16:1 for frames, 8:1 for fields. */
        min_height = min_height;
        /* Min. scale factor is 1:1. */
        max_height >>= !V4L2_FIELD_HAS_BOTH(field);

        if (adjust_size) {
                *width = clamp(*width, min_width, max_width);
                *height = clamp(*height, min_height, max_height);

                /* Round after clamping to avoid overflow. */
                *width = (*width + width_bias) & width_mask;

                if (adjust_crop) {
                        bttv_crop_adjust(c, b, *width, *height, field);

                        if (btv->vbi_end > c->rect.top) {
                                /* Move the crop window out of the way. */
                                c->rect.top = btv->vbi_end;
                        }
                }
        } else {
                rc = -EINVAL;
                if (*width  < min_width ||
                    *height < min_height ||
                    *width  > max_width ||
                    *height > max_height ||
                    0 != (*width & ~width_mask))
                        goto fail;
        }

        rc = 0; /* success */

 fail:

        return rc;
}

/* Returns an error if the given overlay window dimensions are not
   possible with the current cropping parameters. If adjust_size is
   TRUE the function may adjust the window width and/or height
   instead, however it always rounds the horizontal position and
   width as btcx_align() does. If adjust_crop is TRUE the function
   may also adjust the current cropping parameters to get closer
   to the desired window size. */
static int
verify_window_lock              (struct bttv_fh *               fh,
                         struct v4l2_window *           win,
                         int                            adjust_size,
                         int                            adjust_crop)
{
        enum v4l2_field field;
        unsigned int width_mask;
        int rc;

        if (win->w.width  < 48 || win->w.height < 32)
                return -EINVAL;
        if (win->clipcount > 2048)
                return -EINVAL;

        field = win->field;

        if (V4L2_FIELD_ANY == field) {
                __s32 height2;

                height2 = fh->btv->crop[!!fh->do_crop].rect.height >> 1;
                field = (win->w.height > height2)
                        ? V4L2_FIELD_INTERLACED
                        : V4L2_FIELD_TOP;
        }
        switch (field) {
        case V4L2_FIELD_TOP:
        case V4L2_FIELD_BOTTOM:
        case V4L2_FIELD_INTERLACED:
                break;
        default:
                return -EINVAL;
        }

        /* 4-byte alignment. */
        if (NULL == fh->ovfmt)
                return -EINVAL;
        width_mask = ~0;
        switch (fh->ovfmt->depth) {
        case 8:
        case 24:
                width_mask = ~3;
                break;
        case 16:
                width_mask = ~1;
                break;
        case 32:
                break;
        default:
                BUG();
        }

        win->w.width -= win->w.left & ~width_mask;
        win->w.left = (win->w.left - width_mask - 1) & width_mask;

        rc = limit_scaled_size_lock(fh, &win->w.width, &win->w.height,
                               field, width_mask,
                               /* width_bias: round down */ 0,
                               adjust_size, adjust_crop);
        if (0 != rc)
                return rc;

        win->field = field;
        return 0;
}

static int setup_window_lock(struct bttv_fh *fh, struct bttv *btv,
                        struct v4l2_window *win, int fixup)
{
        struct v4l2_clip *clips = NULL;
        int n,size,retval = 0;

        if (NULL == fh->ovfmt)
                return -EINVAL;
        if (!(fh->ovfmt->flags & FORMAT_FLAGS_PACKED))
                return -EINVAL;
        retval = verify_window_lock(fh, win,
                               /* adjust_size */ fixup,
                               /* adjust_crop */ fixup);
        if (0 != retval)
                return retval;

        /* copy clips  --  luckily v4l1 + v4l2 are binary
           compatible here ...*/
        n = win->clipcount;
        size = sizeof(*clips)*(n+4);
        clips = kmalloc(size,GFP_KERNEL);
        if (NULL == clips)
                return -ENOMEM;
        if (n > 0) {
                if (copy_from_user(clips,win->clips,sizeof(struct v4l2_clip)*n)) {
                        kfree(clips);
                        return -EFAULT;
                }
        }

        /* clip against screen */
        if (NULL != btv->fbuf.base)
                n = btcx_screen_clips(btv->fbuf.fmt.width, btv->fbuf.fmt.height,
                                      &win->w, clips, n);
        btcx_sort_clips(clips,n);

        /* 4-byte alignments */
        switch (fh->ovfmt->depth) {
        case 8:
        case 24:
                btcx_align(&win->w, clips, n, 3);
                break;
        case 16:
                btcx_align(&win->w, clips, n, 1);
                break;
        case 32:
                /* no alignment fixups needed */
                break;
        default:
                BUG();
        }

        kfree(fh->ov.clips);
        fh->ov.clips    = clips;
        fh->ov.nclips   = n;

        fh->ov.w        = win->w;
        fh->ov.field    = win->field;
        fh->ov.setup_ok = 1;

        btv->init.ov.w.width   = win->w.width;
        btv->init.ov.w.height  = win->w.height;
        btv->init.ov.field     = win->field;

        /* update overlay if needed */
        retval = 0;
        if (check_btres(fh, RESOURCE_OVERLAY)) {
                struct bttv_buffer *new;

                new = videobuf_sg_alloc(sizeof(*new));
                new->crop = btv->crop[!!fh->do_crop].rect;
                bttv_overlay_risc(btv, &fh->ov, fh->ovfmt, new);
                retval = bttv_switch_overlay(btv,fh,new);
        }
        return retval;
}

/* ----------------------------------------------------------------------- */

static struct videobuf_queue* bttv_queue(struct bttv_fh *fh)
{
        struct videobuf_queue* q = NULL;

        switch (fh->type) {
        case V4L2_BUF_TYPE_VIDEO_CAPTURE:
                q = &fh->cap;
                break;
        case V4L2_BUF_TYPE_VBI_CAPTURE:
                q = &fh->vbi;
                break;
        default:
                BUG();
        }
        return q;
}

static int bttv_resource(struct bttv_fh *fh)
{
        int res = 0;

        switch (fh->type) {
        case V4L2_BUF_TYPE_VIDEO_CAPTURE:
                res = RESOURCE_VIDEO_STREAM;
                break;
        case V4L2_BUF_TYPE_VBI_CAPTURE:
                res = RESOURCE_VBI;
                break;
        default:
                BUG();
        }
        return res;
}

static int bttv_switch_type(struct bttv_fh *fh, enum v4l2_buf_type type)
{
        struct videobuf_queue *q = bttv_queue(fh);
        int res = bttv_resource(fh);

        if (check_btres(fh,res))
                return -EBUSY;
        if (videobuf_queue_is_busy(q))
                return -EBUSY;
        fh->type = type;
        return 0;
}

static void
pix_format_set_size     (struct v4l2_pix_format *       f,
                         const struct bttv_format *     fmt,
                         unsigned int                   width,
                         unsigned int                   height)
{
        f->width = width;
        f->height = height;

        if (fmt->flags & FORMAT_FLAGS_PLANAR) {
                f->bytesperline = width; /* Y plane */
                f->sizeimage = (width * height * fmt->depth) >> 3;
        } else {
                f->bytesperline = (width * fmt->depth) >> 3;
                f->sizeimage = height * f->bytesperline;
        }
}

static int bttv_g_fmt_vid_cap(struct file *file, void *priv,
                                        struct v4l2_format *f)
{
        struct bttv_fh *fh  = priv;

        pix_format_set_size(&f->fmt.pix, fh->fmt,
                                fh->width, fh->height);
        f->fmt.pix.field        = fh->cap.field;
        f->fmt.pix.pixelformat  = fh->fmt->fourcc;

        return 0;
}

static int bttv_g_fmt_vid_overlay(struct file *file, void *priv,
                                        struct v4l2_format *f)
{
        struct bttv_fh *fh  = priv;

        f->fmt.win.w     = fh->ov.w;
        f->fmt.win.field = fh->ov.field;

        return 0;
}

static int bttv_try_fmt_vid_cap(struct file *file, void *priv,
                                                struct v4l2_format *f)
{
        const struct bttv_format *fmt;
        struct bttv_fh *fh = priv;
        struct bttv *btv = fh->btv;
        enum v4l2_field field;
        __s32 width, height;
        int rc;

        fmt = format_by_fourcc(f->fmt.pix.pixelformat);
        if (NULL == fmt)
                return -EINVAL;

        field = f->fmt.pix.field;

        if (V4L2_FIELD_ANY == field) {
                __s32 height2;

                height2 = btv->crop[!!fh->do_crop].rect.height >> 1;
                field = (f->fmt.pix.height > height2)
                        ? V4L2_FIELD_INTERLACED
                        : V4L2_FIELD_BOTTOM;
        }

        if (V4L2_FIELD_SEQ_BT == field)
                field = V4L2_FIELD_SEQ_TB;

        switch (field) {
        case V4L2_FIELD_TOP:
        case V4L2_FIELD_BOTTOM:
        case V4L2_FIELD_ALTERNATE:
        case V4L2_FIELD_INTERLACED:
                break;
        case V4L2_FIELD_SEQ_TB:
                if (fmt->flags & FORMAT_FLAGS_PLANAR)
                        return -EINVAL;
                break;
        default:
                return -EINVAL;
        }

        width = f->fmt.pix.width;
        height = f->fmt.pix.height;

        rc = limit_scaled_size_lock(fh, &width, &height, field,
                               /* width_mask: 4 pixels */ ~3,
                               /* width_bias: nearest */ 2,
                               /* adjust_size */ 1,
                               /* adjust_crop */ 0);
        if (0 != rc)
                return rc;

        /* update data for the application */
        f->fmt.pix.field = field;
        pix_format_set_size(&f->fmt.pix, fmt, width, height);

        return 0;
}

static int bttv_try_fmt_vid_overlay(struct file *file, void *priv,
                                                struct v4l2_format *f)
{
        struct bttv_fh *fh = priv;

        return verify_window_lock(fh, &f->fmt.win,
                        /* adjust_size */ 1,
                        /* adjust_crop */ 0);
}

static int bttv_s_fmt_vid_cap(struct file *file, void *priv,
                                struct v4l2_format *f)
{
        int retval;
        const struct bttv_format *fmt;
        struct bttv_fh *fh = priv;
        struct bttv *btv = fh->btv;
        __s32 width, height;
        enum v4l2_field field;

        retval = bttv_switch_type(fh, f->type);
        if (0 != retval)
                return retval;

        retval = bttv_try_fmt_vid_cap(file, priv, f);
        if (0 != retval)
                return retval;

        width = f->fmt.pix.width;
        height = f->fmt.pix.height;
        field = f->fmt.pix.field;

        retval = limit_scaled_size_lock(fh, &width, &height, f->fmt.pix.field,
                               /* width_mask: 4 pixels */ ~3,
                               /* width_bias: nearest */ 2,
                               /* adjust_size */ 1,
                               /* adjust_crop */ 1);
        if (0 != retval)
                return retval;

        f->fmt.pix.field = field;

        fmt = format_by_fourcc(f->fmt.pix.pixelformat);

        /* update our state informations */
        fh->fmt              = fmt;
        fh->cap.field        = f->fmt.pix.field;
        fh->cap.last         = V4L2_FIELD_NONE;
        fh->width            = f->fmt.pix.width;
        fh->height           = f->fmt.pix.height;
        btv->init.fmt        = fmt;
        btv->init.width      = f->fmt.pix.width;
        btv->init.height     = f->fmt.pix.height;

        return 0;
}

static int bttv_s_fmt_vid_overlay(struct file *file, void *priv,
                                struct v4l2_format *f)
{
        struct bttv_fh *fh = priv;
        struct bttv *btv = fh->btv;

        if (no_overlay > 0) {
                printk(KERN_ERR "V4L2_BUF_TYPE_VIDEO_OVERLAY: no_overlay\n");
                return -EINVAL;
        }

        return setup_window_lock(fh, btv, &f->fmt.win, 1);
}

static int bttv_querycap(struct file *file, void  *priv,
                                struct v4l2_capability *cap)
{
        struct bttv_fh *fh = priv;
        struct bttv *btv = fh->btv;

        if (0 == v4l2)
                return -EINVAL;

        strlcpy(cap->driver, "bttv", sizeof(cap->driver));
        strlcpy(cap->card, btv->video_dev->name, sizeof(cap->card));
        snprintf(cap->bus_info, sizeof(cap->bus_info),
                 "PCI:%s", pci_name(btv->c.pci));
        cap->version = BTTV_VERSION_CODE;
        cap->capabilities =
                V4L2_CAP_VIDEO_CAPTURE |
                V4L2_CAP_VBI_CAPTURE |
                V4L2_CAP_READWRITE |
                V4L2_CAP_STREAMING;
        if (no_overlay <= 0)
                cap->capabilities |= V4L2_CAP_VIDEO_OVERLAY;

        /*
         * No need to lock here: those vars are initialized during board
         * probe and remains untouched during the rest of the driver lifecycle
         */
        if (btv->has_saa6588)
                cap->capabilities |= V4L2_CAP_RDS_CAPTURE;
        if (btv->tuner_type != TUNER_ABSENT)
                cap->capabilities |= V4L2_CAP_TUNER;
        return 0;
}

static int bttv_enum_fmt_cap_ovr(struct v4l2_fmtdesc *f)
{
        int index = -1, i;

        for (i = 0; i < FORMATS; i++) {
                if (formats[i].fourcc != -1)
                        index++;
                if ((unsigned int)index == f->index)
                        break;
        }
        if (FORMATS == i)
                return -EINVAL;

        f->pixelformat = formats[i].fourcc;
        strlcpy(f->description, formats[i].name, sizeof(f->description));

        return i;
}

static int bttv_enum_fmt_vid_cap(struct file *file, void  *priv,
                                struct v4l2_fmtdesc *f)
{
        int rc = bttv_enum_fmt_cap_ovr(f);

        if (rc < 0)
                return rc;

        return 0;
}

static int bttv_enum_fmt_vid_overlay(struct file *file, void  *priv,
                                        struct v4l2_fmtdesc *f)
{
        int rc;

        if (no_overlay > 0) {
                printk(KERN_ERR "V4L2_BUF_TYPE_VIDEO_OVERLAY: no_overlay\n");
                return -EINVAL;
        }

        rc = bttv_enum_fmt_cap_ovr(f);

        if (rc < 0)
                return rc;

        if (!(formats[rc].flags & FORMAT_FLAGS_PACKED))
                return -EINVAL;

        return 0;
}

static int bttv_g_fbuf(struct file *file, void *f,
                                struct v4l2_framebuffer *fb)
{
        struct bttv_fh *fh = f;
        struct bttv *btv = fh->btv;

        *fb = btv->fbuf;
        fb->capability = V4L2_FBUF_CAP_LIST_CLIPPING;
        if (fh->ovfmt)
                fb->fmt.pixelformat  = fh->ovfmt->fourcc;
        return 0;
}

static int bttv_overlay(struct file *file, void *f, unsigned int on)
{
        struct bttv_fh *fh = f;
        struct bttv *btv = fh->btv;
        struct bttv_buffer *new;
        int retval = 0;

        if (on) {
                /* verify args */
                if (unlikely(!btv->fbuf.base)) {
                        return -EINVAL;
                }
                if (unlikely(!fh->ov.setup_ok)) {
                        dprintk("bttv%d: overlay: !setup_ok\n", btv->c.nr);
                        retval = -EINVAL;
                }
                if (retval)
                        return retval;
        }

        if (!check_alloc_btres_lock(btv, fh, RESOURCE_OVERLAY))
                return -EBUSY;

        if (on) {
                fh->ov.tvnorm = btv->tvnorm;
                new = videobuf_sg_alloc(sizeof(*new));
                new->crop = btv->crop[!!fh->do_crop].rect;
                bttv_overlay_risc(btv, &fh->ov, fh->ovfmt, new);
        } else {
                new = NULL;
        }

        /* switch over */
        retval = bttv_switch_overlay(btv, fh, new);
        return retval;
}

static int bttv_s_fbuf(struct file *file, void *f,
                                struct v4l2_framebuffer *fb)
{
        struct bttv_fh *fh = f;
        struct bttv *btv = fh->btv;
        const struct bttv_format *fmt;
        int retval;

        if (!capable(CAP_SYS_ADMIN) &&
                !capable(CAP_SYS_RAWIO))
                return -EPERM;

        /* check args */
        fmt = format_by_fourcc(fb->fmt.pixelformat);
        if (NULL == fmt)
                return -EINVAL;
        if (0 == (fmt->flags & FORMAT_FLAGS_PACKED))
                return -EINVAL;

        retval = -EINVAL;
        if (fb->flags & V4L2_FBUF_FLAG_OVERLAY) {
                __s32 width = fb->fmt.width;
                __s32 height = fb->fmt.height;

                retval = limit_scaled_size_lock(fh, &width, &height,
                                           V4L2_FIELD_INTERLACED,
                                           /* width_mask */ ~3,
                                           /* width_bias */ 2,
                                           /* adjust_size */ 0,
                                           /* adjust_crop */ 0);
                if (0 != retval)
                        return retval;
        }

        /* ok, accept it */
        btv->fbuf.base       = fb->base;
        btv->fbuf.fmt.width  = fb->fmt.width;
        btv->fbuf.fmt.height = fb->fmt.height;
        if (0 != fb->fmt.bytesperline)
                btv->fbuf.fmt.bytesperline = fb->fmt.bytesperline;
        else
                btv->fbuf.fmt.bytesperline = btv->fbuf.fmt.width*fmt->depth/8;

        retval = 0;
        fh->ovfmt = fmt;
        btv->init.ovfmt = fmt;
        if (fb->flags & V4L2_FBUF_FLAG_OVERLAY) {
                fh->ov.w.left   = 0;
                fh->ov.w.top    = 0;
                fh->ov.w.width  = fb->fmt.width;
                fh->ov.w.height = fb->fmt.height;
                btv->init.ov.w.width  = fb->fmt.width;
                btv->init.ov.w.height = fb->fmt.height;
                        kfree(fh->ov.clips);
                fh->ov.clips = NULL;
                fh->ov.nclips = 0;

                if (check_btres(fh, RESOURCE_OVERLAY)) {
                        struct bttv_buffer *new;

                        new = videobuf_sg_alloc(sizeof(*new));
                        new->crop = btv->crop[!!fh->do_crop].rect;
                        bttv_overlay_risc(btv, &fh->ov, fh->ovfmt, new);
                        retval = bttv_switch_overlay(btv, fh, new);
                }
        }
        return retval;
}

static int bttv_reqbufs(struct file *file, void *priv,
                                struct v4l2_requestbuffers *p)
{
        struct bttv_fh *fh = priv;
        return videobuf_reqbufs(bttv_queue(fh), p);
}

static int bttv_querybuf(struct file *file, void *priv,
                                struct v4l2_buffer *b)
{
        struct bttv_fh *fh = priv;
        return videobuf_querybuf(bttv_queue(fh), b);
}

static int bttv_qbuf(struct file *file, void *priv, struct v4l2_buffer *b)
{
        struct bttv_fh *fh = priv;
        struct bttv *btv = fh->btv;
        int res = bttv_resource(fh);

        if (!check_alloc_btres_lock(btv, fh, res))
                return -EBUSY;

        return videobuf_qbuf(bttv_queue(fh), b);
}

static int bttv_dqbuf(struct file *file, void *priv, struct v4l2_buffer *b)
{
        struct bttv_fh *fh = priv;
        return videobuf_dqbuf(bttv_queue(fh), b,
                        file->f_flags & O_NONBLOCK);
}

static int bttv_streamon(struct file *file, void *priv,
                                        enum v4l2_buf_type type)
{
        struct bttv_fh *fh = priv;
        struct bttv *btv = fh->btv;
        int res = bttv_resource(fh);

        if (!check_alloc_btres_lock(btv, fh, res))
                return -EBUSY;
        return videobuf_streamon(bttv_queue(fh));
}


static int bttv_streamoff(struct file *file, void *priv,
                                        enum v4l2_buf_type type)
{
        struct bttv_fh *fh = priv;
        struct bttv *btv = fh->btv;
        int retval;
        int res = bttv_resource(fh);


        retval = videobuf_streamoff(bttv_queue(fh));
        if (retval < 0)
                return retval;
        free_btres_lock(btv, fh, res);
        return 0;
}

static int bttv_queryctrl(struct file *file, void *priv,
                                        struct v4l2_queryctrl *c)
{
        struct bttv_fh *fh = priv;
        struct bttv *btv = fh->btv;
        const struct v4l2_queryctrl *ctrl;

        if ((c->id <  V4L2_CID_BASE ||
             c->id >= V4L2_CID_LASTP1) &&
            (c->id <  V4L2_CID_PRIVATE_BASE ||
             c->id >= V4L2_CID_PRIVATE_LASTP1))
                return -EINVAL;

        if (!btv->volume_gpio && (c->id == V4L2_CID_AUDIO_VOLUME))
                *c = no_ctl;
        else {
                ctrl = ctrl_by_id(c->id);

                *c = (NULL != ctrl) ? *ctrl : no_ctl;
        }

        return 0;
}

static int bttv_g_parm(struct file *file, void *f,
                                struct v4l2_streamparm *parm)
{
        struct bttv_fh *fh = f;
        struct bttv *btv = fh->btv;

        v4l2_video_std_frame_period(bttv_tvnorms[btv->tvnorm].v4l2_id,
                                    &parm->parm.capture.timeperframe);

        return 0;
}

static int bttv_g_tuner(struct file *file, void *priv,
                                struct v4l2_tuner *t)
{
        struct bttv_fh *fh = priv;
        struct bttv *btv = fh->btv;

        if (btv->tuner_type == TUNER_ABSENT)
                return -EINVAL;
        if (0 != t->index)
                return -EINVAL;

        t->rxsubchans = V4L2_TUNER_SUB_MONO;
        bttv_call_all(btv, tuner, g_tuner, t);
        strcpy(t->name, "Television");
        t->capability = V4L2_TUNER_CAP_NORM;
        t->type       = V4L2_TUNER_ANALOG_TV;
        if (btread(BT848_DSTATUS)&BT848_DSTATUS_HLOC)
                t->signal = 0xffff;

        if (btv->audio_mode_gpio)
                btv->audio_mode_gpio(btv, t, 0);

        return 0;
}

static int bttv_g_priority(struct file *file, void *f, enum v4l2_priority *p)
{
        struct bttv_fh *fh = f;
        struct bttv *btv = fh->btv;

        *p = v4l2_prio_max(&btv->prio);

        return 0;
}

static int bttv_s_priority(struct file *file, void *f,
                                        enum v4l2_priority prio)
{
        struct bttv_fh *fh = f;
        struct bttv *btv = fh->btv;
        int     rc;

        rc = v4l2_prio_change(&btv->prio, &fh->prio, prio);

        return rc;
}

static int bttv_cropcap(struct file *file, void *priv,
                                struct v4l2_cropcap *cap)
{
        struct bttv_fh *fh = priv;
        struct bttv *btv = fh->btv;

        if (cap->type != V4L2_BUF_TYPE_VIDEO_CAPTURE &&
            cap->type != V4L2_BUF_TYPE_VIDEO_OVERLAY)
                return -EINVAL;

        *cap = bttv_tvnorms[btv->tvnorm].cropcap;

        return 0;
}

static int bttv_g_crop(struct file *file, void *f, struct v4l2_crop *crop)
{
        struct bttv_fh *fh = f;
        struct bttv *btv = fh->btv;

        if (crop->type != V4L2_BUF_TYPE_VIDEO_CAPTURE &&
            crop->type != V4L2_BUF_TYPE_VIDEO_OVERLAY)
                return -EINVAL;

        /* No fh->do_crop = 1; because btv->crop[1] may be
           inconsistent with fh->width or fh->height and apps
           do not expect a change here. */

        crop->c = btv->crop[!!fh->do_crop].rect;

        return 0;
}

static int bttv_s_crop(struct file *file, void *f, struct v4l2_crop *crop)
{
        struct bttv_fh *fh = f;
        struct bttv *btv = fh->btv;
        const struct v4l2_rect *b;
        int retval;
        struct bttv_crop c;
        __s32 b_left;
        __s32 b_top;
        __s32 b_right;
        __s32 b_bottom;

        if (crop->type != V4L2_BUF_TYPE_VIDEO_CAPTURE &&
            crop->type != V4L2_BUF_TYPE_VIDEO_OVERLAY)