root/drivers/media/i2c/saa717x.c
// SPDX-License-Identifier: GPL-2.0-or-later
/*
 * saa717x - Philips SAA717xHL video decoder driver
 *
 * Based on the saa7115 driver
 *
 * Changes by Ohta Kyuma <alpha292@bremen.or.jp>
 *    - Apply to SAA717x,NEC uPD64031,uPD64083. (1/31/2004)
 *
 * Changes by T.Adachi (tadachi@tadachi-net.com)
 *    - support audio, video scaler etc, and checked the initialize sequence.
 *
 * Cleaned up by Hans Verkuil <hverkuil@kernel.org>
 *
 * Note: this is a reversed engineered driver based on captures from
 * the I2C bus under Windows. This chip is very similar to the saa7134,
 * though. Unfortunately, this driver is currently only working for NTSC.
 */

#include <linux/module.h>
#include <linux/kernel.h>
#include <linux/slab.h>
#include <linux/sched.h>

#include <linux/videodev2.h>
#include <linux/i2c.h>
#include <media/v4l2-device.h>
#include <media/v4l2-ctrls.h>

MODULE_DESCRIPTION("Philips SAA717x audio/video decoder driver");
MODULE_AUTHOR("K. Ohta, T. Adachi, Hans Verkuil");
MODULE_LICENSE("GPL");

static int debug;
module_param(debug, int, 0644);
MODULE_PARM_DESC(debug, "Debug level (0-1)");

/*
 * Generic i2c probe
 * concerning the addresses: i2c wants 7 bit (without the r/w bit), so '>>1'
 */

struct saa717x_state {
        struct v4l2_subdev sd;
        struct v4l2_ctrl_handler hdl;
        v4l2_std_id std;
        int input;
        int enable;
        int radio;
        int playback;
        int audio;
        int tuner_audio_mode;
        int audio_main_mute;
        int audio_main_vol_r;
        int audio_main_vol_l;
        u16 audio_main_bass;
        u16 audio_main_treble;
        u16 audio_main_volume;
        u16 audio_main_balance;
        int audio_input;
};

static inline struct saa717x_state *to_state(struct v4l2_subdev *sd)
{
        return container_of(sd, struct saa717x_state, sd);
}

static inline struct v4l2_subdev *to_sd(struct v4l2_ctrl *ctrl)
{
        return &container_of(ctrl->handler, struct saa717x_state, hdl)->sd;
}

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

/* for audio mode */
#define TUNER_AUDIO_MONO        0  /* LL */
#define TUNER_AUDIO_STEREO      1  /* LR */
#define TUNER_AUDIO_LANG1       2  /* LL */
#define TUNER_AUDIO_LANG2       3  /* RR */

#define SAA717X_NTSC_WIDTH      (704)
#define SAA717X_NTSC_HEIGHT     (480)

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

static int saa717x_write(struct v4l2_subdev *sd, u32 reg, u32 value)
{
        struct i2c_client *client = v4l2_get_subdevdata(sd);
        struct i2c_adapter *adap = client->adapter;
        int fw_addr = reg == 0x454 || (reg >= 0x464 && reg <= 0x478) || reg == 0x480 || reg == 0x488;
        unsigned char mm1[6];
        struct i2c_msg msg;

        msg.flags = 0;
        msg.addr = client->addr;
        mm1[0] = (reg >> 8) & 0xff;
        mm1[1] = reg & 0xff;

        if (fw_addr) {
                mm1[4] = (value >> 16) & 0xff;
                mm1[3] = (value >> 8) & 0xff;
                mm1[2] = value & 0xff;
        } else {
                mm1[2] = value & 0xff;
        }
        msg.len = fw_addr ? 5 : 3; /* Long Registers have *only* three bytes! */
        msg.buf = mm1;
        v4l2_dbg(2, debug, sd, "wrote:  reg 0x%03x=%08x\n", reg, value);
        return i2c_transfer(adap, &msg, 1) == 1;
}

static void saa717x_write_regs(struct v4l2_subdev *sd, u32 *data)
{
        while (data[0] || data[1]) {
                saa717x_write(sd, data[0], data[1]);
                data += 2;
        }
}

static u32 saa717x_read(struct v4l2_subdev *sd, u32 reg)
{
        struct i2c_client *client = v4l2_get_subdevdata(sd);
        struct i2c_adapter *adap = client->adapter;
        int fw_addr = (reg >= 0x404 && reg <= 0x4b8) || reg == 0x528;
        unsigned char mm1[2];
        unsigned char mm2[4] = { 0, 0, 0, 0 };
        struct i2c_msg msgs[2];
        u32 value;

        msgs[0].flags = 0;
        msgs[1].flags = I2C_M_RD;
        msgs[0].addr = msgs[1].addr = client->addr;
        mm1[0] = (reg >> 8) & 0xff;
        mm1[1] = reg & 0xff;
        msgs[0].len = 2;
        msgs[0].buf = mm1;
        msgs[1].len = fw_addr ? 3 : 1; /* Multibyte Registers contains *only* 3 bytes */
        msgs[1].buf = mm2;
        i2c_transfer(adap, msgs, 2);

        if (fw_addr)
                value = (mm2[2] << 16)  | (mm2[1] << 8) | mm2[0];
        else
                value = mm2[0];

        v4l2_dbg(2, debug, sd, "read:  reg 0x%03x=0x%08x\n", reg, value);
        return value;
}

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

static u32 reg_init_initialize[] =
{
        /* from linux driver */
        0x101, 0x008, /* Increment delay */

        0x103, 0x000, /* Analog input control 2 */
        0x104, 0x090, /* Analog input control 3 */
        0x105, 0x090, /* Analog input control 4 */
        0x106, 0x0eb, /* Horizontal sync start */
        0x107, 0x0e0, /* Horizontal sync stop */
        0x109, 0x055, /* Luminance control */

        0x10f, 0x02a, /* Chroma gain control */
        0x110, 0x000, /* Chroma control 2 */

        0x114, 0x045, /* analog/ADC */

        0x118, 0x040, /* RAW data gain */
        0x119, 0x080, /* RAW data offset */

        0x044, 0x000, /* VBI horizontal input window start (L) TASK A */
        0x045, 0x000, /* VBI horizontal input window start (H) TASK A */
        0x046, 0x0cf, /* VBI horizontal input window stop (L) TASK A */
        0x047, 0x002, /* VBI horizontal input window stop (H) TASK A */

        0x049, 0x000, /* VBI vertical input window start (H) TASK A */

        0x04c, 0x0d0, /* VBI horizontal output length (L) TASK A */
        0x04d, 0x002, /* VBI horizontal output length (H) TASK A */

        0x064, 0x080, /* Lumina brightness TASK A */
        0x065, 0x040, /* Luminance contrast TASK A */
        0x066, 0x040, /* Chroma saturation TASK A */
        /* 067H: Reserved */
        0x068, 0x000, /* VBI horizontal scaling increment (L) TASK A */
        0x069, 0x004, /* VBI horizontal scaling increment (H) TASK A */
        0x06a, 0x000, /* VBI phase offset TASK A */

        0x06e, 0x000, /* Horizontal phase offset Luma TASK A */
        0x06f, 0x000, /* Horizontal phase offset Chroma TASK A */

        0x072, 0x000, /* Vertical filter mode TASK A */

        0x084, 0x000, /* VBI horizontal input window start (L) TAKS B */
        0x085, 0x000, /* VBI horizontal input window start (H) TAKS B */
        0x086, 0x0cf, /* VBI horizontal input window stop (L) TAKS B */
        0x087, 0x002, /* VBI horizontal input window stop (H) TAKS B */

        0x089, 0x000, /* VBI vertical input window start (H) TAKS B */

        0x08c, 0x0d0, /* VBI horizontal output length (L) TASK B */
        0x08d, 0x002, /* VBI horizontal output length (H) TASK B */

        0x0a4, 0x080, /* Lumina brightness TASK B */
        0x0a5, 0x040, /* Luminance contrast TASK B */
        0x0a6, 0x040, /* Chroma saturation TASK B */
        /* 0A7H reserved */
        0x0a8, 0x000, /* VBI horizontal scaling increment (L) TASK B */
        0x0a9, 0x004, /* VBI horizontal scaling increment (H) TASK B */
        0x0aa, 0x000, /* VBI phase offset TASK B */

        0x0ae, 0x000, /* Horizontal phase offset Luma TASK B */
        0x0af, 0x000, /*Horizontal phase offset Chroma TASK B */

        0x0b2, 0x000, /* Vertical filter mode TASK B */

        0x00c, 0x000, /* Start point GREEN path */
        0x00d, 0x000, /* Start point BLUE path */
        0x00e, 0x000, /* Start point RED path */

        0x010, 0x010, /* GREEN path gamma curve --- */
        0x011, 0x020,
        0x012, 0x030,
        0x013, 0x040,
        0x014, 0x050,
        0x015, 0x060,
        0x016, 0x070,
        0x017, 0x080,
        0x018, 0x090,
        0x019, 0x0a0,
        0x01a, 0x0b0,
        0x01b, 0x0c0,
        0x01c, 0x0d0,
        0x01d, 0x0e0,
        0x01e, 0x0f0,
        0x01f, 0x0ff, /* --- GREEN path gamma curve */

        0x020, 0x010, /* BLUE path gamma curve --- */
        0x021, 0x020,
        0x022, 0x030,
        0x023, 0x040,
        0x024, 0x050,
        0x025, 0x060,
        0x026, 0x070,
        0x027, 0x080,
        0x028, 0x090,
        0x029, 0x0a0,
        0x02a, 0x0b0,
        0x02b, 0x0c0,
        0x02c, 0x0d0,
        0x02d, 0x0e0,
        0x02e, 0x0f0,
        0x02f, 0x0ff, /* --- BLUE path gamma curve */

        0x030, 0x010, /* RED path gamma curve --- */
        0x031, 0x020,
        0x032, 0x030,
        0x033, 0x040,
        0x034, 0x050,
        0x035, 0x060,
        0x036, 0x070,
        0x037, 0x080,
        0x038, 0x090,
        0x039, 0x0a0,
        0x03a, 0x0b0,
        0x03b, 0x0c0,
        0x03c, 0x0d0,
        0x03d, 0x0e0,
        0x03e, 0x0f0,
        0x03f, 0x0ff, /* --- RED path gamma curve */

        0x109, 0x085, /* Luminance control  */

        /**** from app start ****/
        0x584, 0x000, /* AGC gain control */
        0x585, 0x000, /* Program count */
        0x586, 0x003, /* Status reset */
        0x588, 0x0ff, /* Number of audio samples (L) */
        0x589, 0x00f, /* Number of audio samples (M) */
        0x58a, 0x000, /* Number of audio samples (H) */
        0x58b, 0x000, /* Audio select */
        0x58c, 0x010, /* Audio channel assign1 */
        0x58d, 0x032, /* Audio channel assign2 */
        0x58e, 0x054, /* Audio channel assign3 */
        0x58f, 0x023, /* Audio format */
        0x590, 0x000, /* SIF control */

        0x595, 0x000, /* ?? */
        0x596, 0x000, /* ?? */
        0x597, 0x000, /* ?? */

        0x464, 0x00, /* Digital input crossbar1 */

        0x46c, 0xbbbb10, /* Digital output selection1-3 */
        0x470, 0x101010, /* Digital output selection4-6 */

        0x478, 0x00, /* Sound feature control */

        0x474, 0x18, /* Softmute control */

        0x454, 0x0425b9, /* Sound Easy programming(reset) */
        0x454, 0x042539, /* Sound Easy programming(reset) */


        /**** common setting( of DVD play, including scaler commands) ****/
        0x042, 0x003, /* Data path configuration for VBI (TASK A) */

        0x082, 0x003, /* Data path configuration for VBI (TASK B) */

        0x108, 0x0f8, /* Sync control */
        0x2a9, 0x0fd, /* ??? */
        0x102, 0x089, /* select video input "mode 9" */
        0x111, 0x000, /* Mode/delay control */

        0x10e, 0x00a, /* Chroma control 1 */

        0x594, 0x002, /* SIF, analog I/O select */

        0x454, 0x0425b9, /* Sound  */
        0x454, 0x042539,

        0x111, 0x000,
        0x10e, 0x00a,
        0x464, 0x000,
        0x300, 0x000,
        0x301, 0x006,
        0x302, 0x000,
        0x303, 0x006,
        0x308, 0x040,
        0x309, 0x000,
        0x30a, 0x000,
        0x30b, 0x000,
        0x000, 0x002,
        0x001, 0x000,
        0x002, 0x000,
        0x003, 0x000,
        0x004, 0x033,
        0x040, 0x01d,
        0x041, 0x001,
        0x042, 0x004,
        0x043, 0x000,
        0x080, 0x01e,
        0x081, 0x001,
        0x082, 0x004,
        0x083, 0x000,
        0x190, 0x018,
        0x115, 0x000,
        0x116, 0x012,
        0x117, 0x018,
        0x04a, 0x011,
        0x08a, 0x011,
        0x04b, 0x000,
        0x08b, 0x000,
        0x048, 0x000,
        0x088, 0x000,
        0x04e, 0x012,
        0x08e, 0x012,
        0x058, 0x012,
        0x098, 0x012,
        0x059, 0x000,
        0x099, 0x000,
        0x05a, 0x003,
        0x09a, 0x003,
        0x05b, 0x001,
        0x09b, 0x001,
        0x054, 0x008,
        0x094, 0x008,
        0x055, 0x000,
        0x095, 0x000,
        0x056, 0x0c7,
        0x096, 0x0c7,
        0x057, 0x002,
        0x097, 0x002,
        0x0ff, 0x0ff,
        0x060, 0x001,
        0x0a0, 0x001,
        0x061, 0x000,
        0x0a1, 0x000,
        0x062, 0x000,
        0x0a2, 0x000,
        0x063, 0x000,
        0x0a3, 0x000,
        0x070, 0x000,
        0x0b0, 0x000,
        0x071, 0x004,
        0x0b1, 0x004,
        0x06c, 0x0e9,
        0x0ac, 0x0e9,
        0x06d, 0x003,
        0x0ad, 0x003,
        0x05c, 0x0d0,
        0x09c, 0x0d0,
        0x05d, 0x002,
        0x09d, 0x002,
        0x05e, 0x0f2,
        0x09e, 0x0f2,
        0x05f, 0x000,
        0x09f, 0x000,
        0x074, 0x000,
        0x0b4, 0x000,
        0x075, 0x000,
        0x0b5, 0x000,
        0x076, 0x000,
        0x0b6, 0x000,
        0x077, 0x000,
        0x0b7, 0x000,
        0x195, 0x008,
        0x0ff, 0x0ff,
        0x108, 0x0f8,
        0x111, 0x000,
        0x10e, 0x00a,
        0x2a9, 0x0fd,
        0x464, 0x001,
        0x454, 0x042135,
        0x598, 0x0e7,
        0x599, 0x07d,
        0x59a, 0x018,
        0x59c, 0x066,
        0x59d, 0x090,
        0x59e, 0x001,
        0x584, 0x000,
        0x585, 0x000,
        0x586, 0x003,
        0x588, 0x0ff,
        0x589, 0x00f,
        0x58a, 0x000,
        0x58b, 0x000,
        0x58c, 0x010,
        0x58d, 0x032,
        0x58e, 0x054,
        0x58f, 0x023,
        0x590, 0x000,
        0x595, 0x000,
        0x596, 0x000,
        0x597, 0x000,
        0x464, 0x000,
        0x46c, 0xbbbb10,
        0x470, 0x101010,


        0x478, 0x000,
        0x474, 0x018,
        0x454, 0x042135,
        0x598, 0x0e7,
        0x599, 0x07d,
        0x59a, 0x018,
        0x59c, 0x066,
        0x59d, 0x090,
        0x59e, 0x001,
        0x584, 0x000,
        0x585, 0x000,
        0x586, 0x003,
        0x588, 0x0ff,
        0x589, 0x00f,
        0x58a, 0x000,
        0x58b, 0x000,
        0x58c, 0x010,
        0x58d, 0x032,
        0x58e, 0x054,
        0x58f, 0x023,
        0x590, 0x000,
        0x595, 0x000,
        0x596, 0x000,
        0x597, 0x000,
        0x464, 0x000,
        0x46c, 0xbbbb10,
        0x470, 0x101010,

        0x478, 0x000,
        0x474, 0x018,
        0x454, 0x042135,
        0x598, 0x0e7,
        0x599, 0x07d,
        0x59a, 0x018,
        0x59c, 0x066,
        0x59d, 0x090,
        0x59e, 0x001,
        0x584, 0x000,
        0x585, 0x000,
        0x586, 0x003,
        0x588, 0x0ff,
        0x589, 0x00f,
        0x58a, 0x000,
        0x58b, 0x000,
        0x58c, 0x010,
        0x58d, 0x032,
        0x58e, 0x054,
        0x58f, 0x023,
        0x590, 0x000,
        0x595, 0x000,
        0x596, 0x000,
        0x597, 0x000,
        0x464, 0x000,
        0x46c, 0xbbbb10,
        0x470, 0x101010,
        0x478, 0x000,
        0x474, 0x018,
        0x454, 0x042135,
        0x193, 0x000,
        0x300, 0x000,
        0x301, 0x006,
        0x302, 0x000,
        0x303, 0x006,
        0x308, 0x040,
        0x309, 0x000,
        0x30a, 0x000,
        0x30b, 0x000,
        0x000, 0x002,
        0x001, 0x000,
        0x002, 0x000,
        0x003, 0x000,
        0x004, 0x033,
        0x040, 0x01d,
        0x041, 0x001,
        0x042, 0x004,
        0x043, 0x000,
        0x080, 0x01e,
        0x081, 0x001,
        0x082, 0x004,
        0x083, 0x000,
        0x190, 0x018,
        0x115, 0x000,
        0x116, 0x012,
        0x117, 0x018,
        0x04a, 0x011,
        0x08a, 0x011,
        0x04b, 0x000,
        0x08b, 0x000,
        0x048, 0x000,
        0x088, 0x000,
        0x04e, 0x012,
        0x08e, 0x012,
        0x058, 0x012,
        0x098, 0x012,
        0x059, 0x000,
        0x099, 0x000,
        0x05a, 0x003,
        0x09a, 0x003,
        0x05b, 0x001,
        0x09b, 0x001,
        0x054, 0x008,
        0x094, 0x008,
        0x055, 0x000,
        0x095, 0x000,
        0x056, 0x0c7,
        0x096, 0x0c7,
        0x057, 0x002,
        0x097, 0x002,
        0x060, 0x001,
        0x0a0, 0x001,
        0x061, 0x000,
        0x0a1, 0x000,
        0x062, 0x000,
        0x0a2, 0x000,
        0x063, 0x000,
        0x0a3, 0x000,
        0x070, 0x000,
        0x0b0, 0x000,
        0x071, 0x004,
        0x0b1, 0x004,
        0x06c, 0x0e9,
        0x0ac, 0x0e9,
        0x06d, 0x003,
        0x0ad, 0x003,
        0x05c, 0x0d0,
        0x09c, 0x0d0,
        0x05d, 0x002,
        0x09d, 0x002,
        0x05e, 0x0f2,
        0x09e, 0x0f2,
        0x05f, 0x000,
        0x09f, 0x000,
        0x074, 0x000,
        0x0b4, 0x000,
        0x075, 0x000,
        0x0b5, 0x000,
        0x076, 0x000,
        0x0b6, 0x000,
        0x077, 0x000,
        0x0b7, 0x000,
        0x195, 0x008,
        0x598, 0x0e7,
        0x599, 0x07d,
        0x59a, 0x018,
        0x59c, 0x066,
        0x59d, 0x090,
        0x59e, 0x001,
        0x584, 0x000,
        0x585, 0x000,
        0x586, 0x003,
        0x588, 0x0ff,
        0x589, 0x00f,
        0x58a, 0x000,
        0x58b, 0x000,
        0x58c, 0x010,
        0x58d, 0x032,
        0x58e, 0x054,
        0x58f, 0x023,
        0x590, 0x000,
        0x595, 0x000,
        0x596, 0x000,
        0x597, 0x000,
        0x464, 0x000,
        0x46c, 0xbbbb10,
        0x470, 0x101010,
        0x478, 0x000,
        0x474, 0x018,
        0x454, 0x042135,
        0x193, 0x0a6,
        0x108, 0x0f8,
        0x042, 0x003,
        0x082, 0x003,
        0x454, 0x0425b9,
        0x454, 0x042539,
        0x193, 0x000,
        0x193, 0x0a6,
        0x464, 0x000,

        0, 0
};

/* Tuner */
static u32 reg_init_tuner_input[] = {
        0x108, 0x0f8, /* Sync control */
        0x111, 0x000, /* Mode/delay control */
        0x10e, 0x00a, /* Chroma control 1 */
        0, 0
};

/* Composite */
static u32 reg_init_composite_input[] = {
        0x108, 0x0e8, /* Sync control */
        0x111, 0x000, /* Mode/delay control */
        0x10e, 0x04a, /* Chroma control 1 */
        0, 0
};

/* S-Video */
static u32 reg_init_svideo_input[] = {
        0x108, 0x0e8, /* Sync control */
        0x111, 0x000, /* Mode/delay control */
        0x10e, 0x04a, /* Chroma control 1 */
        0, 0
};

static u32 reg_set_audio_template[4][2] =
{
        { /* for MONO
                tadachi 6/29 DMA audio output select?
                Register 0x46c
                7-4: DMA2, 3-0: DMA1 ch. DMA4, DMA3 DMA2, DMA1
                0: MAIN left,  1: MAIN right
                2: AUX1 left,  3: AUX1 right
                4: AUX2 left,  5: AUX2 right
                6: DPL left,   7: DPL  right
                8: DPL center, 9: DPL surround
                A: monitor output, B: digital sense */
                0xbbbb00,

                /* tadachi 6/29 DAC and I2S output select?
                   Register 0x470
                   7-4:DAC right ch. 3-0:DAC left ch.
                   I2S1 right,left  I2S2 right,left */
                0x00,
        },
        { /* for STEREO */
                0xbbbb10, 0x101010,
        },
        { /* for LANG1 */
                0xbbbb00, 0x00,
        },
        { /* for LANG2/SAP */
                0xbbbb11, 0x111111,
        }
};


/* Get detected audio flags (from saa7134 driver) */
static void get_inf_dev_status(struct v4l2_subdev *sd,
                int *dual_flag, int *stereo_flag)
{
        u32 reg_data3;

        static char *stdres[0x20] = {
                [0x00] = "no standard detected",
                [0x01] = "B/G (in progress)",
                [0x02] = "D/K (in progress)",
                [0x03] = "M (in progress)",

                [0x04] = "B/G A2",
                [0x05] = "B/G NICAM",
                [0x06] = "D/K A2 (1)",
                [0x07] = "D/K A2 (2)",
                [0x08] = "D/K A2 (3)",
                [0x09] = "D/K NICAM",
                [0x0a] = "L NICAM",
                [0x0b] = "I NICAM",

                [0x0c] = "M Korea",
                [0x0d] = "M BTSC ",
                [0x0e] = "M EIAJ",

                [0x0f] = "FM radio / IF 10.7 / 50 deemp",
                [0x10] = "FM radio / IF 10.7 / 75 deemp",
                [0x11] = "FM radio / IF sel / 50 deemp",
                [0x12] = "FM radio / IF sel / 75 deemp",

                [0x13 ... 0x1e] = "unknown",
                [0x1f] = "??? [in progress]",
        };


        *dual_flag = *stereo_flag = 0;

        /* (demdec status: 0x528) */

        /* read current status */
        reg_data3 = saa717x_read(sd, 0x0528);

        v4l2_dbg(1, debug, sd, "tvaudio thread status: 0x%x [%s%s%s]\n",
                reg_data3, stdres[reg_data3 & 0x1f],
                (reg_data3 & 0x000020) ? ",stereo" : "",
                (reg_data3 & 0x000040) ? ",dual"   : "");
        v4l2_dbg(1, debug, sd, "detailed status: "
                "%s#%s#%s#%s#%s#%s#%s#%s#%s#%s#%s#%s#%s#%s\n",
                (reg_data3 & 0x000080) ? " A2/EIAJ pilot tone "     : "",
                (reg_data3 & 0x000100) ? " A2/EIAJ dual "           : "",
                (reg_data3 & 0x000200) ? " A2/EIAJ stereo "         : "",
                (reg_data3 & 0x000400) ? " A2/EIAJ noise mute "     : "",

                (reg_data3 & 0x000800) ? " BTSC/FM radio pilot "    : "",
                (reg_data3 & 0x001000) ? " SAP carrier "            : "",
                (reg_data3 & 0x002000) ? " BTSC stereo noise mute " : "",
                (reg_data3 & 0x004000) ? " SAP noise mute "         : "",
                (reg_data3 & 0x008000) ? " VDSP "                   : "",

                (reg_data3 & 0x010000) ? " NICST "                  : "",
                (reg_data3 & 0x020000) ? " NICDU "                  : "",
                (reg_data3 & 0x040000) ? " NICAM muted "            : "",
                (reg_data3 & 0x080000) ? " NICAM reserve sound "    : "",

                (reg_data3 & 0x100000) ? " init done "              : "");

        if (reg_data3 & 0x000220) {
                v4l2_dbg(1, debug, sd, "ST!!!\n");
                *stereo_flag = 1;
        }

        if (reg_data3 & 0x000140) {
                v4l2_dbg(1, debug, sd, "DUAL!!!\n");
                *dual_flag = 1;
        }
}

/* regs write to set audio mode */
static void set_audio_mode(struct v4l2_subdev *sd, int audio_mode)
{
        v4l2_dbg(1, debug, sd, "writing registers to set audio mode by set %d\n",
                        audio_mode);

        saa717x_write(sd, 0x46c, reg_set_audio_template[audio_mode][0]);
        saa717x_write(sd, 0x470, reg_set_audio_template[audio_mode][1]);
}

/* write regs to set audio volume, bass and treble */
static int set_audio_regs(struct v4l2_subdev *sd,
                struct saa717x_state *decoder)
{
        u8 mute = 0xac; /* -84 dB */
        u32 val;
        unsigned int work_l, work_r;

        /* set SIF analog I/O select */
        saa717x_write(sd, 0x0594, decoder->audio_input);
        v4l2_dbg(1, debug, sd, "set audio input %d\n",
                        decoder->audio_input);

        /* normalize ( 65535 to 0 -> 24 to -40 (not -84)) */
        work_l = (min(65536 - decoder->audio_main_balance, 32768) * decoder->audio_main_volume) / 32768;
        work_r = (min(decoder->audio_main_balance, (u16)32768) * decoder->audio_main_volume) / 32768;
        decoder->audio_main_vol_l = (long)work_l * (24 - (-40)) / 65535 - 40;
        decoder->audio_main_vol_r = (long)work_r * (24 - (-40)) / 65535 - 40;

        /* set main volume */
        /* main volume L[7-0],R[7-0],0x00  24=24dB,-83dB, -84(mute) */
        /*    def:0dB->6dB(MPG600GR) */
        /* if mute is on, set mute */
        if (decoder->audio_main_mute) {
                val = mute | (mute << 8);
        } else {
                val = (u8)decoder->audio_main_vol_l |
                        ((u8)decoder->audio_main_vol_r << 8);
        }

        saa717x_write(sd, 0x480, val);

        /* set bass and treble */
        val = decoder->audio_main_bass & 0x1f;
        val |= (decoder->audio_main_treble & 0x1f) << 5;
        saa717x_write(sd, 0x488, val);
        return 0;
}

/********** scaling staff ***********/
static void set_h_prescale(struct v4l2_subdev *sd,
                int task, int prescale)
{
        static const struct {
                int xpsc;
                int xacl;
                int xc2_1;
                int xdcg;
                int vpfy;
        } vals[] = {
                /* XPSC XACL XC2_1 XDCG VPFY */
                {    1,   0,    0,    0,   0 },
                {    2,   2,    1,    2,   2 },
                {    3,   4,    1,    3,   2 },
                {    4,   8,    1,    4,   2 },
                {    5,   8,    1,    4,   2 },
                {    6,   8,    1,    4,   3 },
                {    7,   8,    1,    4,   3 },
                {    8,  15,    0,    4,   3 },
                {    9,  15,    0,    4,   3 },
                {   10,  16,    1,    5,   3 },
        };
        static const int count = ARRAY_SIZE(vals);
        int i, task_shift;

        task_shift = task * 0x40;
        for (i = 0; i < count; i++)
                if (vals[i].xpsc == prescale)
                        break;
        if (i == count)
                return;

        /* horizontal prescaling */
        saa717x_write(sd, 0x60 + task_shift, vals[i].xpsc);
        /* accumulation length */
        saa717x_write(sd, 0x61 + task_shift, vals[i].xacl);
        /* level control */
        saa717x_write(sd, 0x62 + task_shift,
                        (vals[i].xc2_1 << 3) | vals[i].xdcg);
        /*FIR prefilter control */
        saa717x_write(sd, 0x63 + task_shift,
                        (vals[i].vpfy << 2) | vals[i].vpfy);
}

/********** scaling staff ***********/
static void set_v_scale(struct v4l2_subdev *sd, int task, int yscale)
{
        int task_shift;

        task_shift = task * 0x40;
        /* Vertical scaling ratio (LOW) */
        saa717x_write(sd, 0x70 + task_shift, yscale & 0xff);
        /* Vertical scaling ratio (HI) */
        saa717x_write(sd, 0x71 + task_shift, yscale >> 8);
}

static int saa717x_s_ctrl(struct v4l2_ctrl *ctrl)
{
        struct v4l2_subdev *sd = to_sd(ctrl);
        struct saa717x_state *state = to_state(sd);

        switch (ctrl->id) {
        case V4L2_CID_BRIGHTNESS:
                saa717x_write(sd, 0x10a, ctrl->val);
                return 0;

        case V4L2_CID_CONTRAST:
                saa717x_write(sd, 0x10b, ctrl->val);
                return 0;

        case V4L2_CID_SATURATION:
                saa717x_write(sd, 0x10c, ctrl->val);
                return 0;

        case V4L2_CID_HUE:
                saa717x_write(sd, 0x10d, ctrl->val);
                return 0;

        case V4L2_CID_AUDIO_MUTE:
                state->audio_main_mute = ctrl->val;
                break;

        case V4L2_CID_AUDIO_VOLUME:
                state->audio_main_volume = ctrl->val;
                break;

        case V4L2_CID_AUDIO_BALANCE:
                state->audio_main_balance = ctrl->val;
                break;

        case V4L2_CID_AUDIO_TREBLE:
                state->audio_main_treble = ctrl->val;
                break;

        case V4L2_CID_AUDIO_BASS:
                state->audio_main_bass = ctrl->val;
                break;

        default:
                return 0;
        }
        set_audio_regs(sd, state);
        return 0;
}

static int saa717x_s_video_routing(struct v4l2_subdev *sd,
                                   u32 input, u32 output, u32 config)
{
        struct saa717x_state *decoder = to_state(sd);
        int is_tuner = input & 0x80;  /* tuner input flag */

        input &= 0x7f;

        v4l2_dbg(1, debug, sd, "decoder set input (%d)\n", input);
        /* inputs from 0-9 are available*/
        /* saa717x have mode0-mode9 but mode5 is reserved. */
        if (input > 9 || input == 5)
                return -EINVAL;

        if (decoder->input != input) {
                int input_line = input;

                decoder->input = input_line;
                v4l2_dbg(1, debug, sd,  "now setting %s input %d\n",
                                input_line >= 6 ? "S-Video" : "Composite",
                                input_line);

                /* select mode */
                saa717x_write(sd, 0x102,
                                (saa717x_read(sd, 0x102) & 0xf0) |
                                input_line);

                /* bypass chrominance trap for modes 6..9 */
                saa717x_write(sd, 0x109,
                                (saa717x_read(sd, 0x109) & 0x7f) |
                                (input_line < 6 ? 0x0 : 0x80));

                /* change audio_mode */
                if (is_tuner) {
                        /* tuner */
                        set_audio_mode(sd, decoder->tuner_audio_mode);
                } else {
                        /* Force to STEREO mode if Composite or
                         * S-Video were chosen */
                        set_audio_mode(sd, TUNER_AUDIO_STEREO);
                }
                /* change initialize procedure (Composite/S-Video) */
                if (is_tuner)
                        saa717x_write_regs(sd, reg_init_tuner_input);
                else if (input_line >= 6)
                        saa717x_write_regs(sd, reg_init_svideo_input);
                else
                        saa717x_write_regs(sd, reg_init_composite_input);
        }

        return 0;
}

#ifdef CONFIG_VIDEO_ADV_DEBUG
static int saa717x_g_register(struct v4l2_subdev *sd, struct v4l2_dbg_register *reg)
{
        reg->val = saa717x_read(sd, reg->reg);
        reg->size = 1;
        return 0;
}

static int saa717x_s_register(struct v4l2_subdev *sd, const struct v4l2_dbg_register *reg)
{
        u16 addr = reg->reg & 0xffff;
        u8 val = reg->val & 0xff;

        saa717x_write(sd, addr, val);
        return 0;
}
#endif

static int saa717x_set_fmt(struct v4l2_subdev *sd,
                struct v4l2_subdev_state *sd_state,
                struct v4l2_subdev_format *format)
{
        struct v4l2_mbus_framefmt *fmt = &format->format;
        int prescale, h_scale, v_scale;

        v4l2_dbg(1, debug, sd, "decoder set size\n");

        if (format->pad || fmt->code != MEDIA_BUS_FMT_FIXED)
                return -EINVAL;

        /* FIXME need better bounds checking here */
        if (fmt->width < 1 || fmt->width > 1440)
                return -EINVAL;
        if (fmt->height < 1 || fmt->height > 960)
                return -EINVAL;

        fmt->field = V4L2_FIELD_INTERLACED;
        fmt->colorspace = V4L2_COLORSPACE_SMPTE170M;

        if (format->which == V4L2_SUBDEV_FORMAT_TRY)
                return 0;

        /* scaling setting */
        /* NTSC and interlace only */
        prescale = SAA717X_NTSC_WIDTH / fmt->width;
        if (prescale == 0)
                prescale = 1;
        h_scale = 1024 * SAA717X_NTSC_WIDTH / prescale / fmt->width;
        /* interlace */
        v_scale = 512 * 2 * SAA717X_NTSC_HEIGHT / fmt->height;

        /* Horizontal prescaling etc */
        set_h_prescale(sd, 0, prescale);
        set_h_prescale(sd, 1, prescale);

        /* Horizontal scaling increment */
        /* TASK A */
        saa717x_write(sd, 0x6C, (u8)(h_scale & 0xFF));
        saa717x_write(sd, 0x6D, (u8)((h_scale >> 8) & 0xFF));
        /* TASK B */
        saa717x_write(sd, 0xAC, (u8)(h_scale & 0xFF));
        saa717x_write(sd, 0xAD, (u8)((h_scale >> 8) & 0xFF));

        /* Vertical prescaling etc */
        set_v_scale(sd, 0, v_scale);
        set_v_scale(sd, 1, v_scale);

        /* set video output size */
        /* video number of pixels at output */
        /* TASK A */
        saa717x_write(sd, 0x5C, (u8)(fmt->width & 0xFF));
        saa717x_write(sd, 0x5D, (u8)((fmt->width >> 8) & 0xFF));
        /* TASK B */
        saa717x_write(sd, 0x9C, (u8)(fmt->width & 0xFF));
        saa717x_write(sd, 0x9D, (u8)((fmt->width >> 8) & 0xFF));

        /* video number of lines at output */
        /* TASK A */
        saa717x_write(sd, 0x5E, (u8)(fmt->height & 0xFF));
        saa717x_write(sd, 0x5F, (u8)((fmt->height >> 8) & 0xFF));
        /* TASK B */
        saa717x_write(sd, 0x9E, (u8)(fmt->height & 0xFF));
        saa717x_write(sd, 0x9F, (u8)((fmt->height >> 8) & 0xFF));
        return 0;
}

static int saa717x_s_radio(struct v4l2_subdev *sd)
{
        struct saa717x_state *decoder = to_state(sd);

        decoder->radio = 1;
        return 0;
}

static int saa717x_s_std(struct v4l2_subdev *sd, v4l2_std_id std)
{
        struct saa717x_state *decoder = to_state(sd);

        v4l2_dbg(1, debug, sd, "decoder set norm ");
        v4l2_dbg(1, debug, sd, "(not yet implemented)\n");

        decoder->radio = 0;
        decoder->std = std;
        return 0;
}

static int saa717x_s_audio_routing(struct v4l2_subdev *sd,
                                   u32 input, u32 output, u32 config)
{
        struct saa717x_state *decoder = to_state(sd);

        if (input < 3) { /* FIXME! --tadachi */
                decoder->audio_input = input;
                v4l2_dbg(1, debug, sd,
                                "set decoder audio input to %d\n",
                                decoder->audio_input);
                set_audio_regs(sd, decoder);
                return 0;
        }
        return -ERANGE;
}

static int saa717x_s_stream(struct v4l2_subdev *sd, int enable)
{
        struct saa717x_state *decoder = to_state(sd);

        v4l2_dbg(1, debug, sd, "decoder %s output\n",
                        enable ? "enable" : "disable");
        decoder->enable = enable;
        saa717x_write(sd, 0x193, enable ? 0xa6 : 0x26);
        return 0;
}

/* change audio mode */
static int saa717x_s_tuner(struct v4l2_subdev *sd, const struct v4l2_tuner *vt)
{
        struct saa717x_state *decoder = to_state(sd);
        int audio_mode;
        char *mes[4] = {
                "MONO", "STEREO", "LANG1", "LANG2/SAP"
        };

        audio_mode = TUNER_AUDIO_STEREO;

        switch (vt->audmode) {
                case V4L2_TUNER_MODE_MONO:
                        audio_mode = TUNER_AUDIO_MONO;
                        break;
                case V4L2_TUNER_MODE_STEREO:
                        audio_mode = TUNER_AUDIO_STEREO;
                        break;
                case V4L2_TUNER_MODE_LANG2:
                        audio_mode = TUNER_AUDIO_LANG2;
                        break;
                case V4L2_TUNER_MODE_LANG1:
                        audio_mode = TUNER_AUDIO_LANG1;
                        break;
        }

        v4l2_dbg(1, debug, sd, "change audio mode to %s\n",
                        mes[audio_mode]);
        decoder->tuner_audio_mode = audio_mode;
        /* The registers are not changed here. */
        /* See DECODER_ENABLE_OUTPUT section. */
        set_audio_mode(sd, decoder->tuner_audio_mode);
        return 0;
}

static int saa717x_g_tuner(struct v4l2_subdev *sd, struct v4l2_tuner *vt)
{
        struct saa717x_state *decoder = to_state(sd);
        int dual_f, stereo_f;

        if (decoder->radio)
                return 0;
        get_inf_dev_status(sd, &dual_f, &stereo_f);

        v4l2_dbg(1, debug, sd, "DETECT==st:%d dual:%d\n",
                        stereo_f, dual_f);

        /* mono */
        if ((dual_f == 0) && (stereo_f == 0)) {
                vt->rxsubchans = V4L2_TUNER_SUB_MONO;
                v4l2_dbg(1, debug, sd, "DETECT==MONO\n");
        }

        /* stereo */
        if (stereo_f == 1) {
                if (vt->audmode == V4L2_TUNER_MODE_STEREO ||
                                vt->audmode == V4L2_TUNER_MODE_LANG1) {
                        vt->rxsubchans = V4L2_TUNER_SUB_STEREO;
                        v4l2_dbg(1, debug, sd, "DETECT==ST(ST)\n");
                } else {
                        vt->rxsubchans = V4L2_TUNER_SUB_MONO;
                        v4l2_dbg(1, debug, sd, "DETECT==ST(MONO)\n");
                }
        }

        /* dual */
        if (dual_f == 1) {
                if (vt->audmode == V4L2_TUNER_MODE_LANG2) {
                        vt->rxsubchans = V4L2_TUNER_SUB_LANG2 | V4L2_TUNER_SUB_MONO;
                        v4l2_dbg(1, debug, sd, "DETECT==DUAL1\n");
                } else {
                        vt->rxsubchans = V4L2_TUNER_SUB_LANG1 | V4L2_TUNER_SUB_MONO;
                        v4l2_dbg(1, debug, sd, "DETECT==DUAL2\n");
                }
        }
        return 0;
}

static int saa717x_log_status(struct v4l2_subdev *sd)
{
        struct saa717x_state *state = to_state(sd);

        v4l2_ctrl_handler_log_status(&state->hdl, sd->name);
        return 0;
}

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

static const struct v4l2_ctrl_ops saa717x_ctrl_ops = {
        .s_ctrl = saa717x_s_ctrl,
};

static const struct v4l2_subdev_core_ops saa717x_core_ops = {
#ifdef CONFIG_VIDEO_ADV_DEBUG
        .g_register = saa717x_g_register,
        .s_register = saa717x_s_register,
#endif
        .log_status = saa717x_log_status,
};

static const struct v4l2_subdev_tuner_ops saa717x_tuner_ops = {
        .g_tuner = saa717x_g_tuner,
        .s_tuner = saa717x_s_tuner,
        .s_radio = saa717x_s_radio,
};

static const struct v4l2_subdev_video_ops saa717x_video_ops = {
        .s_std = saa717x_s_std,
        .s_routing = saa717x_s_video_routing,
        .s_stream = saa717x_s_stream,
};

static const struct v4l2_subdev_audio_ops saa717x_audio_ops = {
        .s_routing = saa717x_s_audio_routing,
};

static const struct v4l2_subdev_pad_ops saa717x_pad_ops = {
        .set_fmt = saa717x_set_fmt,
};

static const struct v4l2_subdev_ops saa717x_ops = {
        .core = &saa717x_core_ops,
        .tuner = &saa717x_tuner_ops,
        .audio = &saa717x_audio_ops,
        .video = &saa717x_video_ops,
        .pad = &saa717x_pad_ops,
};

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


/* i2c implementation */

/* ----------------------------------------------------------------------- */
static int saa717x_probe(struct i2c_client *client)
{
        struct saa717x_state *decoder;
        struct v4l2_ctrl_handler *hdl;
        struct v4l2_subdev *sd;
        u8 id = 0;
        char *p = "";

        /* Check if the adapter supports the needed features */
        if (!i2c_check_functionality(client->adapter, I2C_FUNC_SMBUS_BYTE_DATA))
                return -EIO;

        decoder = devm_kzalloc(&client->dev, sizeof(*decoder), GFP_KERNEL);
        if (decoder == NULL)
                return -ENOMEM;

        sd = &decoder->sd;
        v4l2_i2c_subdev_init(sd, client, &saa717x_ops);

        if (saa717x_write(sd, 0x5a4, 0xfe) &&
                        saa717x_write(sd, 0x5a5, 0x0f) &&
                        saa717x_write(sd, 0x5a6, 0x00) &&
                        saa717x_write(sd, 0x5a7, 0x01))
                id = saa717x_read(sd, 0x5a0);
        if (id != 0xc2 && id != 0x32 && id != 0xf2 && id != 0x6c) {
                v4l2_dbg(1, debug, sd, "saa717x not found (id=%02x)\n", id);
                return -ENODEV;
        }
        if (id == 0xc2)
                p = "saa7173";
        else if (id == 0x32)
                p = "saa7174A";
        else if (id == 0x6c)
                p = "saa7174HL";
        else
                p = "saa7171";
        v4l2_info(sd, "%s found @ 0x%x (%s)\n", p,
                        client->addr << 1, client->adapter->name);

        hdl = &decoder->hdl;
        v4l2_ctrl_handler_init(hdl, 9);
        /* add in ascending ID order */
        v4l2_ctrl_new_std(hdl, &saa717x_ctrl_ops,
                        V4L2_CID_BRIGHTNESS, 0, 255, 1, 128);
        v4l2_ctrl_new_std(hdl, &saa717x_ctrl_ops,
                        V4L2_CID_CONTRAST, 0, 255, 1, 68);
        v4l2_ctrl_new_std(hdl, &saa717x_ctrl_ops,
                        V4L2_CID_SATURATION, 0, 255, 1, 64);
        v4l2_ctrl_new_std(hdl, &saa717x_ctrl_ops,
                        V4L2_CID_HUE, -128, 127, 1, 0);
        v4l2_ctrl_new_std(hdl, &saa717x_ctrl_ops,
                        V4L2_CID_AUDIO_VOLUME, 0, 65535, 65535 / 100, 42000);
        v4l2_ctrl_new_std(hdl, &saa717x_ctrl_ops,
                        V4L2_CID_AUDIO_BALANCE, 0, 65535, 65535 / 100, 32768);
        v4l2_ctrl_new_std(hdl, &saa717x_ctrl_ops,
                        V4L2_CID_AUDIO_BASS, -16, 15, 1, 0);
        v4l2_ctrl_new_std(hdl, &saa717x_ctrl_ops,
                        V4L2_CID_AUDIO_TREBLE, -16, 15, 1, 0);
        v4l2_ctrl_new_std(hdl, &saa717x_ctrl_ops,
                        V4L2_CID_AUDIO_MUTE, 0, 1, 1, 0);
        sd->ctrl_handler = hdl;
        if (hdl->error) {
                int err = hdl->error;

                v4l2_ctrl_handler_free(hdl);
                return err;
        }

        decoder->std = V4L2_STD_NTSC;
        decoder->input = -1;
        decoder->enable = 1;

        /* FIXME!! */
        decoder->playback = 0;  /* initially capture mode used */
        decoder->audio = 1; /* DECODER_AUDIO_48_KHZ */

        decoder->audio_input = 2; /* FIXME!! */

        decoder->tuner_audio_mode = TUNER_AUDIO_STEREO;
        /* set volume, bass and treble */
        decoder->audio_main_vol_l = 6;
        decoder->audio_main_vol_r = 6;

        v4l2_dbg(1, debug, sd, "writing init values\n");

        /* FIXME!! */
        saa717x_write_regs(sd, reg_init_initialize);

        v4l2_ctrl_handler_setup(hdl);

        set_current_state(TASK_INTERRUPTIBLE);
        schedule_timeout(2*HZ);
        return 0;
}

static void saa717x_remove(struct i2c_client *client)
{
        struct v4l2_subdev *sd = i2c_get_clientdata(client);

        v4l2_device_unregister_subdev(sd);
        v4l2_ctrl_handler_free(sd->ctrl_handler);
}

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

static const struct i2c_device_id saa717x_id[] = {
        { "saa717x" },
        { }
};
MODULE_DEVICE_TABLE(i2c, saa717x_id);

static struct i2c_driver saa717x_driver = {
        .driver = {
                .name   = "saa717x",
        },
        .probe          = saa717x_probe,
        .remove         = saa717x_remove,
        .id_table       = saa717x_id,
};

module_i2c_driver(saa717x_driver);