// SPDX-License-Identifier: GPL-2.0-or-later
/* Texas Instruments Triple 8-/10-BIT 165-/110-MSPS Video and Graphics
 * Digitizer with Horizontal PLL registers
 *
 * Copyright (C) 2009 Texas Instruments Inc
 * Author: Santiago Nunez-Corrales <santiago.nunez@ridgerun.com>
 *
 * This code is partially based upon the TVP5150 driver
 * written by Mauro Carvalho Chehab <mchehab@kernel.org>,
 * the TVP514x driver written by Vaibhav Hiremath <hvaibhav@ti.com>
 * and the TVP7002 driver in the TI LSP 2.10.00.14. Revisions by
 * Muralidharan Karicheri and Snehaprabha Narnakaje (TI).
 */
#include <linux/delay.h>
#include <linux/i2c.h>
#include <linux/slab.h>
#include <linux/videodev2.h>
#include <linux/module.h>
#include <linux/of.h>
#include <linux/of_graph.h>
#include <linux/v4l2-dv-timings.h>
#include <media/i2c/tvp7002.h>
#include <media/v4l2-async.h>
#include <media/v4l2-device.h>
#include <media/v4l2-common.h>
#include <media/v4l2-ctrls.h>
#include <media/v4l2-fwnode.h>

#include "tvp7002_reg.h"

MODULE_DESCRIPTION("TI TVP7002 Video and Graphics Digitizer driver");
MODULE_AUTHOR("Santiago Nunez-Corrales <santiago.nunez@ridgerun.com>");
MODULE_LICENSE("GPL");

/* I2C retry attempts */
#define I2C_RETRY_COUNT         (5)

/* End of registers */
#define TVP7002_EOR             0x5c

/* Read write definition for registers */
#define TVP7002_READ            0
#define TVP7002_WRITE           1
#define TVP7002_RESERVED        2

/* Interlaced vs progressive mask and shift */
#define TVP7002_IP_SHIFT        5
#define TVP7002_INPR_MASK       (0x01 << TVP7002_IP_SHIFT)

/* Shift for CPL and LPF registers */
#define TVP7002_CL_SHIFT        8
#define TVP7002_CL_MASK         0x0f

/* Debug functions */
static bool debug;
module_param(debug, bool, 0644);
MODULE_PARM_DESC(debug, "Debug level (0-2)");

/* Structure for register values */
struct i2c_reg_value {
        u8 reg;
        u8 value;
        u8 type;
};

/*
 * Register default values (according to tvp7002 datasheet)
 * In the case of read-only registers, the value (0xff) is
 * never written. R/W functionality is controlled by the
 * writable bit in the register struct definition.
 */
static const struct i2c_reg_value tvp7002_init_default[] = {
        { TVP7002_CHIP_REV, 0xff, TVP7002_READ },
        { TVP7002_HPLL_FDBK_DIV_MSBS, 0x67, TVP7002_WRITE },
        { TVP7002_HPLL_FDBK_DIV_LSBS, 0x20, TVP7002_WRITE },
        { TVP7002_HPLL_CRTL, 0xa0, TVP7002_WRITE },
        { TVP7002_HPLL_PHASE_SEL, 0x80, TVP7002_WRITE },
        { TVP7002_CLAMP_START, 0x32, TVP7002_WRITE },
        { TVP7002_CLAMP_W, 0x20, TVP7002_WRITE },
        { TVP7002_HSYNC_OUT_W, 0x60, TVP7002_WRITE },
        { TVP7002_B_FINE_GAIN, 0x00, TVP7002_WRITE },
        { TVP7002_G_FINE_GAIN, 0x00, TVP7002_WRITE },
        { TVP7002_R_FINE_GAIN, 0x00, TVP7002_WRITE },
        { TVP7002_B_FINE_OFF_MSBS, 0x80, TVP7002_WRITE },
        { TVP7002_G_FINE_OFF_MSBS, 0x80, TVP7002_WRITE },
        { TVP7002_R_FINE_OFF_MSBS, 0x80, TVP7002_WRITE },
        { TVP7002_SYNC_CTL_1, 0x20, TVP7002_WRITE },
        { TVP7002_HPLL_AND_CLAMP_CTL, 0x2e, TVP7002_WRITE },
        { TVP7002_SYNC_ON_G_THRS, 0x5d, TVP7002_WRITE },
        { TVP7002_SYNC_SEPARATOR_THRS, 0x47, TVP7002_WRITE },
        { TVP7002_HPLL_PRE_COAST, 0x00, TVP7002_WRITE },
        { TVP7002_HPLL_POST_COAST, 0x00, TVP7002_WRITE },
        { TVP7002_SYNC_DETECT_STAT, 0xff, TVP7002_READ },
        { TVP7002_OUT_FORMATTER, 0x47, TVP7002_WRITE },
        { TVP7002_MISC_CTL_1, 0x01, TVP7002_WRITE },
        { TVP7002_MISC_CTL_2, 0x00, TVP7002_WRITE },
        { TVP7002_MISC_CTL_3, 0x01, TVP7002_WRITE },
        { TVP7002_IN_MUX_SEL_1, 0x00, TVP7002_WRITE },
        { TVP7002_IN_MUX_SEL_2, 0x67, TVP7002_WRITE },
        { TVP7002_B_AND_G_COARSE_GAIN, 0x77, TVP7002_WRITE },
        { TVP7002_R_COARSE_GAIN, 0x07, TVP7002_WRITE },
        { TVP7002_FINE_OFF_LSBS, 0x00, TVP7002_WRITE },
        { TVP7002_B_COARSE_OFF, 0x10, TVP7002_WRITE },
        { TVP7002_G_COARSE_OFF, 0x10, TVP7002_WRITE },
        { TVP7002_R_COARSE_OFF, 0x10, TVP7002_WRITE },
        { TVP7002_HSOUT_OUT_START, 0x08, TVP7002_WRITE },
        { TVP7002_MISC_CTL_4, 0x00, TVP7002_WRITE },
        { TVP7002_B_DGTL_ALC_OUT_LSBS, 0xff, TVP7002_READ },
        { TVP7002_G_DGTL_ALC_OUT_LSBS, 0xff, TVP7002_READ },
        { TVP7002_R_DGTL_ALC_OUT_LSBS, 0xff, TVP7002_READ },
        { TVP7002_AUTO_LVL_CTL_ENABLE, 0x80, TVP7002_WRITE },
        { TVP7002_DGTL_ALC_OUT_MSBS, 0xff, TVP7002_READ },
        { TVP7002_AUTO_LVL_CTL_FILTER, 0x53, TVP7002_WRITE },
        { 0x29, 0x08, TVP7002_RESERVED },
        { TVP7002_FINE_CLAMP_CTL, 0x07, TVP7002_WRITE },
        /* PWR_CTL is controlled only by the probe and reset functions */
        { TVP7002_PWR_CTL, 0x00, TVP7002_RESERVED },
        { TVP7002_ADC_SETUP, 0x50, TVP7002_WRITE },
        { TVP7002_COARSE_CLAMP_CTL, 0x00, TVP7002_WRITE },
        { TVP7002_SOG_CLAMP, 0x80, TVP7002_WRITE },
        { TVP7002_RGB_COARSE_CLAMP_CTL, 0x8c, TVP7002_WRITE },
        { TVP7002_SOG_COARSE_CLAMP_CTL, 0x04, TVP7002_WRITE },
        { TVP7002_ALC_PLACEMENT, 0x5a, TVP7002_WRITE },
        { 0x32, 0x18, TVP7002_RESERVED },
        { 0x33, 0x60, TVP7002_RESERVED },
        { TVP7002_MVIS_STRIPPER_W, 0xff, TVP7002_RESERVED },
        { TVP7002_VSYNC_ALGN, 0x10, TVP7002_WRITE },
        { TVP7002_SYNC_BYPASS, 0x00, TVP7002_WRITE },
        { TVP7002_L_FRAME_STAT_LSBS, 0xff, TVP7002_READ },
        { TVP7002_L_FRAME_STAT_MSBS, 0xff, TVP7002_READ },
        { TVP7002_CLK_L_STAT_LSBS, 0xff, TVP7002_READ },
        { TVP7002_CLK_L_STAT_MSBS, 0xff, TVP7002_READ },
        { TVP7002_HSYNC_W, 0xff, TVP7002_READ },
        { TVP7002_VSYNC_W, 0xff, TVP7002_READ },
        { TVP7002_L_LENGTH_TOL, 0x03, TVP7002_WRITE },
        { 0x3e, 0x60, TVP7002_RESERVED },
        { TVP7002_VIDEO_BWTH_CTL, 0x01, TVP7002_WRITE },
        { TVP7002_AVID_START_PIXEL_LSBS, 0x01, TVP7002_WRITE },
        { TVP7002_AVID_START_PIXEL_MSBS, 0x2c, TVP7002_WRITE },
        { TVP7002_AVID_STOP_PIXEL_LSBS, 0x06, TVP7002_WRITE },
        { TVP7002_AVID_STOP_PIXEL_MSBS, 0x2c, TVP7002_WRITE },
        { TVP7002_VBLK_F_0_START_L_OFF, 0x05, TVP7002_WRITE },
        { TVP7002_VBLK_F_1_START_L_OFF, 0x00, TVP7002_WRITE },
        { TVP7002_VBLK_F_0_DURATION, 0x1e, TVP7002_WRITE },
        { TVP7002_VBLK_F_1_DURATION, 0x00, TVP7002_WRITE },
        { TVP7002_FBIT_F_0_START_L_OFF, 0x00, TVP7002_WRITE },
        { TVP7002_FBIT_F_1_START_L_OFF, 0x00, TVP7002_WRITE },
        { TVP7002_YUV_Y_G_COEF_LSBS, 0xe3, TVP7002_WRITE },
        { TVP7002_YUV_Y_G_COEF_MSBS, 0x16, TVP7002_WRITE },
        { TVP7002_YUV_Y_B_COEF_LSBS, 0x4f, TVP7002_WRITE },
        { TVP7002_YUV_Y_B_COEF_MSBS, 0x02, TVP7002_WRITE },
        { TVP7002_YUV_Y_R_COEF_LSBS, 0xce, TVP7002_WRITE },
        { TVP7002_YUV_Y_R_COEF_MSBS, 0x06, TVP7002_WRITE },
        { TVP7002_YUV_U_G_COEF_LSBS, 0xab, TVP7002_WRITE },
        { TVP7002_YUV_U_G_COEF_MSBS, 0xf3, TVP7002_WRITE },
        { TVP7002_YUV_U_B_COEF_LSBS, 0x00, TVP7002_WRITE },
        { TVP7002_YUV_U_B_COEF_MSBS, 0x10, TVP7002_WRITE },
        { TVP7002_YUV_U_R_COEF_LSBS, 0x55, TVP7002_WRITE },
        { TVP7002_YUV_U_R_COEF_MSBS, 0xfc, TVP7002_WRITE },
        { TVP7002_YUV_V_G_COEF_LSBS, 0x78, TVP7002_WRITE },
        { TVP7002_YUV_V_G_COEF_MSBS, 0xf1, TVP7002_WRITE },
        { TVP7002_YUV_V_B_COEF_LSBS, 0x88, TVP7002_WRITE },
        { TVP7002_YUV_V_B_COEF_MSBS, 0xfe, TVP7002_WRITE },
        { TVP7002_YUV_V_R_COEF_LSBS, 0x00, TVP7002_WRITE },
        { TVP7002_YUV_V_R_COEF_MSBS, 0x10, TVP7002_WRITE },
        /* This signals end of register values */
        { TVP7002_EOR, 0xff, TVP7002_RESERVED }
};

/* Register parameters for 480P */
static const struct i2c_reg_value tvp7002_parms_480P[] = {
        { TVP7002_HPLL_FDBK_DIV_MSBS, 0x35, TVP7002_WRITE },
        { TVP7002_HPLL_FDBK_DIV_LSBS, 0xa0, TVP7002_WRITE },
        { TVP7002_HPLL_CRTL, 0x02, TVP7002_WRITE },
        { TVP7002_AVID_START_PIXEL_LSBS, 0x91, TVP7002_WRITE },
        { TVP7002_AVID_START_PIXEL_MSBS, 0x00, TVP7002_WRITE },
        { TVP7002_AVID_STOP_PIXEL_LSBS, 0x0B, TVP7002_WRITE },
        { TVP7002_AVID_STOP_PIXEL_MSBS, 0x00, TVP7002_WRITE },
        { TVP7002_VBLK_F_0_START_L_OFF, 0x03, TVP7002_WRITE },
        { TVP7002_VBLK_F_1_START_L_OFF, 0x01, TVP7002_WRITE },
        { TVP7002_VBLK_F_0_DURATION, 0x13, TVP7002_WRITE },
        { TVP7002_VBLK_F_1_DURATION, 0x13, TVP7002_WRITE },
        { TVP7002_ALC_PLACEMENT, 0x18, TVP7002_WRITE },
        { TVP7002_CLAMP_START, 0x06, TVP7002_WRITE },
        { TVP7002_CLAMP_W, 0x10, TVP7002_WRITE },
        { TVP7002_HPLL_PRE_COAST, 0x03, TVP7002_WRITE },
        { TVP7002_HPLL_POST_COAST, 0x03, TVP7002_WRITE },
        { TVP7002_EOR, 0xff, TVP7002_RESERVED }
};

/* Register parameters for 576P */
static const struct i2c_reg_value tvp7002_parms_576P[] = {
        { TVP7002_HPLL_FDBK_DIV_MSBS, 0x36, TVP7002_WRITE },
        { TVP7002_HPLL_FDBK_DIV_LSBS, 0x00, TVP7002_WRITE },
        { TVP7002_HPLL_CRTL, 0x18, TVP7002_WRITE },
        { TVP7002_AVID_START_PIXEL_LSBS, 0x9B, TVP7002_WRITE },
        { TVP7002_AVID_START_PIXEL_MSBS, 0x00, TVP7002_WRITE },
        { TVP7002_AVID_STOP_PIXEL_LSBS, 0x0F, TVP7002_WRITE },
        { TVP7002_AVID_STOP_PIXEL_MSBS, 0x00, TVP7002_WRITE },
        { TVP7002_VBLK_F_0_START_L_OFF, 0x00, TVP7002_WRITE },
        { TVP7002_VBLK_F_1_START_L_OFF, 0x00, TVP7002_WRITE },
        { TVP7002_VBLK_F_0_DURATION, 0x2D, TVP7002_WRITE },
        { TVP7002_VBLK_F_1_DURATION, 0x00, TVP7002_WRITE },
        { TVP7002_ALC_PLACEMENT, 0x18, TVP7002_WRITE },
        { TVP7002_CLAMP_START, 0x06, TVP7002_WRITE },
        { TVP7002_CLAMP_W, 0x10, TVP7002_WRITE },
        { TVP7002_HPLL_PRE_COAST, 0x03, TVP7002_WRITE },
        { TVP7002_HPLL_POST_COAST, 0x03, TVP7002_WRITE },
        { TVP7002_EOR, 0xff, TVP7002_RESERVED }
};

/* Register parameters for 1080I60 */
static const struct i2c_reg_value tvp7002_parms_1080I60[] = {
        { TVP7002_HPLL_FDBK_DIV_MSBS, 0x89, TVP7002_WRITE },
        { TVP7002_HPLL_FDBK_DIV_LSBS, 0x80, TVP7002_WRITE },
        { TVP7002_HPLL_CRTL, 0x98, TVP7002_WRITE },
        { TVP7002_AVID_START_PIXEL_LSBS, 0x06, TVP7002_WRITE },
        { TVP7002_AVID_START_PIXEL_MSBS, 0x01, TVP7002_WRITE },
        { TVP7002_AVID_STOP_PIXEL_LSBS, 0x8a, TVP7002_WRITE },
        { TVP7002_AVID_STOP_PIXEL_MSBS, 0x08, TVP7002_WRITE },
        { TVP7002_VBLK_F_0_START_L_OFF, 0x02, TVP7002_WRITE },
        { TVP7002_VBLK_F_1_START_L_OFF, 0x02, TVP7002_WRITE },
        { TVP7002_VBLK_F_0_DURATION, 0x16, TVP7002_WRITE },
        { TVP7002_VBLK_F_1_DURATION, 0x17, TVP7002_WRITE },
        { TVP7002_ALC_PLACEMENT, 0x5a, TVP7002_WRITE },
        { TVP7002_CLAMP_START, 0x32, TVP7002_WRITE },
        { TVP7002_CLAMP_W, 0x20, TVP7002_WRITE },
        { TVP7002_HPLL_PRE_COAST, 0x01, TVP7002_WRITE },
        { TVP7002_HPLL_POST_COAST, 0x00, TVP7002_WRITE },
        { TVP7002_EOR, 0xff, TVP7002_RESERVED }
};

/* Register parameters for 1080P60 */
static const struct i2c_reg_value tvp7002_parms_1080P60[] = {
        { TVP7002_HPLL_FDBK_DIV_MSBS, 0x89, TVP7002_WRITE },
        { TVP7002_HPLL_FDBK_DIV_LSBS, 0x80, TVP7002_WRITE },
        { TVP7002_HPLL_CRTL, 0xE0, TVP7002_WRITE },
        { TVP7002_AVID_START_PIXEL_LSBS, 0x06, TVP7002_WRITE },
        { TVP7002_AVID_START_PIXEL_MSBS, 0x01, TVP7002_WRITE },
        { TVP7002_AVID_STOP_PIXEL_LSBS, 0x8a, TVP7002_WRITE },
        { TVP7002_AVID_STOP_PIXEL_MSBS, 0x08, TVP7002_WRITE },
        { TVP7002_VBLK_F_0_START_L_OFF, 0x02, TVP7002_WRITE },
        { TVP7002_VBLK_F_1_START_L_OFF, 0x02, TVP7002_WRITE },
        { TVP7002_VBLK_F_0_DURATION, 0x16, TVP7002_WRITE },
        { TVP7002_VBLK_F_1_DURATION, 0x17, TVP7002_WRITE },
        { TVP7002_ALC_PLACEMENT, 0x5a, TVP7002_WRITE },
        { TVP7002_CLAMP_START, 0x32, TVP7002_WRITE },
        { TVP7002_CLAMP_W, 0x20, TVP7002_WRITE },
        { TVP7002_HPLL_PRE_COAST, 0x01, TVP7002_WRITE },
        { TVP7002_HPLL_POST_COAST, 0x00, TVP7002_WRITE },
        { TVP7002_EOR, 0xff, TVP7002_RESERVED }
};

/* Register parameters for 1080I50 */
static const struct i2c_reg_value tvp7002_parms_1080I50[] = {
        { TVP7002_HPLL_FDBK_DIV_MSBS, 0xa5, TVP7002_WRITE },
        { TVP7002_HPLL_FDBK_DIV_LSBS, 0x00, TVP7002_WRITE },
        { TVP7002_HPLL_CRTL, 0x98, TVP7002_WRITE },
        { TVP7002_AVID_START_PIXEL_LSBS, 0x06, TVP7002_WRITE },
        { TVP7002_AVID_START_PIXEL_MSBS, 0x01, TVP7002_WRITE },
        { TVP7002_AVID_STOP_PIXEL_LSBS, 0x8a, TVP7002_WRITE },
        { TVP7002_AVID_STOP_PIXEL_MSBS, 0x08, TVP7002_WRITE },
        { TVP7002_VBLK_F_0_START_L_OFF, 0x02, TVP7002_WRITE },
        { TVP7002_VBLK_F_1_START_L_OFF, 0x02, TVP7002_WRITE },
        { TVP7002_VBLK_F_0_DURATION, 0x16, TVP7002_WRITE },
        { TVP7002_VBLK_F_1_DURATION, 0x17, TVP7002_WRITE },
        { TVP7002_ALC_PLACEMENT, 0x5a, TVP7002_WRITE },
        { TVP7002_CLAMP_START, 0x32, TVP7002_WRITE },
        { TVP7002_CLAMP_W, 0x20, TVP7002_WRITE },
        { TVP7002_HPLL_PRE_COAST, 0x01, TVP7002_WRITE },
        { TVP7002_HPLL_POST_COAST, 0x00, TVP7002_WRITE },
        { TVP7002_EOR, 0xff, TVP7002_RESERVED }
};

/* Register parameters for 720P60 */
static const struct i2c_reg_value tvp7002_parms_720P60[] = {
        { TVP7002_HPLL_FDBK_DIV_MSBS, 0x67, TVP7002_WRITE },
        { TVP7002_HPLL_FDBK_DIV_LSBS, 0x20, TVP7002_WRITE },
        { TVP7002_HPLL_CRTL, 0xa0, TVP7002_WRITE },
        { TVP7002_AVID_START_PIXEL_LSBS, 0x47, TVP7002_WRITE },
        { TVP7002_AVID_START_PIXEL_MSBS, 0x01, TVP7002_WRITE },
        { TVP7002_AVID_STOP_PIXEL_LSBS, 0x4B, TVP7002_WRITE },
        { TVP7002_AVID_STOP_PIXEL_MSBS, 0x06, TVP7002_WRITE },
        { TVP7002_VBLK_F_0_START_L_OFF, 0x05, TVP7002_WRITE },
        { TVP7002_VBLK_F_1_START_L_OFF, 0x00, TVP7002_WRITE },
        { TVP7002_VBLK_F_0_DURATION, 0x2D, TVP7002_WRITE },
        { TVP7002_VBLK_F_1_DURATION, 0x00, TVP7002_WRITE },
        { TVP7002_ALC_PLACEMENT, 0x5a, TVP7002_WRITE },
        { TVP7002_CLAMP_START, 0x32, TVP7002_WRITE },
        { TVP7002_CLAMP_W, 0x20, TVP7002_WRITE },
        { TVP7002_HPLL_PRE_COAST, 0x00, TVP7002_WRITE },
        { TVP7002_HPLL_POST_COAST, 0x00, TVP7002_WRITE },
        { TVP7002_EOR, 0xff, TVP7002_RESERVED }
};

/* Register parameters for 720P50 */
static const struct i2c_reg_value tvp7002_parms_720P50[] = {
        { TVP7002_HPLL_FDBK_DIV_MSBS, 0x7b, TVP7002_WRITE },
        { TVP7002_HPLL_FDBK_DIV_LSBS, 0xc0, TVP7002_WRITE },
        { TVP7002_HPLL_CRTL, 0x98, TVP7002_WRITE },
        { TVP7002_AVID_START_PIXEL_LSBS, 0x47, TVP7002_WRITE },
        { TVP7002_AVID_START_PIXEL_MSBS, 0x01, TVP7002_WRITE },
        { TVP7002_AVID_STOP_PIXEL_LSBS, 0x4B, TVP7002_WRITE },
        { TVP7002_AVID_STOP_PIXEL_MSBS, 0x06, TVP7002_WRITE },
        { TVP7002_VBLK_F_0_START_L_OFF, 0x05, TVP7002_WRITE },
        { TVP7002_VBLK_F_1_START_L_OFF, 0x00, TVP7002_WRITE },
        { TVP7002_VBLK_F_0_DURATION, 0x2D, TVP7002_WRITE },
        { TVP7002_VBLK_F_1_DURATION, 0x00, TVP7002_WRITE },
        { TVP7002_ALC_PLACEMENT, 0x5a, TVP7002_WRITE },
        { TVP7002_CLAMP_START, 0x32, TVP7002_WRITE },
        { TVP7002_CLAMP_W, 0x20, TVP7002_WRITE },
        { TVP7002_HPLL_PRE_COAST, 0x01, TVP7002_WRITE },
        { TVP7002_HPLL_POST_COAST, 0x00, TVP7002_WRITE },
        { TVP7002_EOR, 0xff, TVP7002_RESERVED }
};

/* Timings definition for handling device operation */
struct tvp7002_timings_definition {
        struct v4l2_dv_timings timings;
        const struct i2c_reg_value *p_settings;
        enum v4l2_colorspace color_space;
        enum v4l2_field scanmode;
        u16 progressive;
        u16 lines_per_frame;
        u16 cpl_min;
        u16 cpl_max;
};

/* Struct list for digital video timings */
static const struct tvp7002_timings_definition tvp7002_timings[] = {
        {
                V4L2_DV_BT_CEA_1280X720P60,
                tvp7002_parms_720P60,
                V4L2_COLORSPACE_REC709,
                V4L2_FIELD_NONE,
                1,
                0x2EE,
                135,
                153
        },
        {
                V4L2_DV_BT_CEA_1920X1080I60,
                tvp7002_parms_1080I60,
                V4L2_COLORSPACE_REC709,
                V4L2_FIELD_INTERLACED,
                0,
                0x465,
                181,
                205
        },
        {
                V4L2_DV_BT_CEA_1920X1080I50,
                tvp7002_parms_1080I50,
                V4L2_COLORSPACE_REC709,
                V4L2_FIELD_INTERLACED,
                0,
                0x465,
                217,
                245
        },
        {
                V4L2_DV_BT_CEA_1280X720P50,
                tvp7002_parms_720P50,
                V4L2_COLORSPACE_REC709,
                V4L2_FIELD_NONE,
                1,
                0x2EE,
                163,
                183
        },
        {
                V4L2_DV_BT_CEA_1920X1080P60,
                tvp7002_parms_1080P60,
                V4L2_COLORSPACE_REC709,
                V4L2_FIELD_NONE,
                1,
                0x465,
                90,
                102
        },
        {
                V4L2_DV_BT_CEA_720X480P59_94,
                tvp7002_parms_480P,
                V4L2_COLORSPACE_SMPTE170M,
                V4L2_FIELD_NONE,
                1,
                0x20D,
                0xffff,
                0xffff
        },
        {
                V4L2_DV_BT_CEA_720X576P50,
                tvp7002_parms_576P,
                V4L2_COLORSPACE_SMPTE170M,
                V4L2_FIELD_NONE,
                1,
                0x271,
                0xffff,
                0xffff
        }
};

#define NUM_TIMINGS ARRAY_SIZE(tvp7002_timings)

/* Device definition */
struct tvp7002 {
        struct v4l2_subdev sd;
        struct v4l2_ctrl_handler hdl;
        const struct tvp7002_config *pdata;

        int ver;
        int streaming;

        const struct tvp7002_timings_definition *current_timings;
        struct media_pad pad;
};

/*
 * to_tvp7002 - Obtain device handler TVP7002
 * @sd: ptr to v4l2_subdev struct
 *
 * Returns device handler tvp7002.
 */
static inline struct tvp7002 *to_tvp7002(struct v4l2_subdev *sd)
{
        return container_of(sd, struct tvp7002, sd);
}

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

/*
 * tvp7002_read - Read a value from a register in an TVP7002
 * @sd: ptr to v4l2_subdev struct
 * @addr: TVP7002 register address
 * @dst: pointer to 8-bit destination
 *
 * Returns value read if successful, or non-zero (-1) otherwise.
 */
static int tvp7002_read(struct v4l2_subdev *sd, u8 addr, u8 *dst)
{
        struct i2c_client *c = v4l2_get_subdevdata(sd);
        int retry;
        int error;

        for (retry = 0; retry < I2C_RETRY_COUNT; retry++) {
                error = i2c_smbus_read_byte_data(c, addr);

                if (error >= 0) {
                        *dst = (u8)error;
                        return 0;
                }

                msleep_interruptible(10);
        }
        v4l2_err(sd, "TVP7002 read error %d\n", error);
        return error;
}

/*
 * tvp7002_read_err() - Read a register value with error code
 * @sd: pointer to standard V4L2 sub-device structure
 * @reg: destination register
 * @val: value to be read
 * @err: pointer to error value
 *
 * Read a value in a register and save error value in pointer.
 * Also update the register table if successful
 */
static inline void tvp7002_read_err(struct v4l2_subdev *sd, u8 reg,
                                                        u8 *dst, int *err)
{
        if (!*err)
                *err = tvp7002_read(sd, reg, dst);
}

/*
 * tvp7002_write() - Write a value to a register in TVP7002
 * @sd: ptr to v4l2_subdev struct
 * @addr: TVP7002 register address
 * @value: value to be written to the register
 *
 * Write a value to a register in an TVP7002 decoder device.
 * Returns zero if successful, or non-zero otherwise.
 */
static int tvp7002_write(struct v4l2_subdev *sd, u8 addr, u8 value)
{
        struct i2c_client *c;
        int retry;
        int error;

        c = v4l2_get_subdevdata(sd);

        for (retry = 0; retry < I2C_RETRY_COUNT; retry++) {
                error = i2c_smbus_write_byte_data(c, addr, value);

                if (error >= 0)
                        return 0;

                v4l2_warn(sd, "Write: retry ... %d\n", retry);
                msleep_interruptible(10);
        }
        v4l2_err(sd, "TVP7002 write error %d\n", error);
        return error;
}

/*
 * tvp7002_write_err() - Write a register value with error code
 * @sd: pointer to standard V4L2 sub-device structure
 * @reg: destination register
 * @val: value to be written
 * @err: pointer to error value
 *
 * Write a value in a register and save error value in pointer.
 * Also update the register table if successful
 */
static inline void tvp7002_write_err(struct v4l2_subdev *sd, u8 reg,
                                                        u8 val, int *err)
{
        if (!*err)
                *err = tvp7002_write(sd, reg, val);
}

/*
 * tvp7002_write_inittab() - Write initialization values
 * @sd: ptr to v4l2_subdev struct
 * @regs: ptr to i2c_reg_value struct
 *
 * Write initialization values.
 * Returns zero or -EINVAL if read operation fails.
 */
static int tvp7002_write_inittab(struct v4l2_subdev *sd,
                                        const struct i2c_reg_value *regs)
{
        int error = 0;

        /* Initialize the first (defined) registers */
        while (TVP7002_EOR != regs->reg) {
                if (TVP7002_WRITE == regs->type)
                        tvp7002_write_err(sd, regs->reg, regs->value, &error);
                regs++;
        }

        return error;
}

static int tvp7002_s_dv_timings(struct v4l2_subdev *sd, unsigned int pad,
                                struct v4l2_dv_timings *dv_timings)
{
        struct tvp7002 *device = to_tvp7002(sd);
        const struct v4l2_bt_timings *bt = &dv_timings->bt;
        int i;

        if (pad != 0)
                return -EINVAL;

        if (dv_timings->type != V4L2_DV_BT_656_1120)
                return -EINVAL;
        for (i = 0; i < NUM_TIMINGS; i++) {
                const struct v4l2_bt_timings *t = &tvp7002_timings[i].timings.bt;

                if (!memcmp(bt, t, &bt->standards - &bt->width)) {
                        device->current_timings = &tvp7002_timings[i];
                        return tvp7002_write_inittab(sd, tvp7002_timings[i].p_settings);
                }
        }
        return -EINVAL;
}

static int tvp7002_g_dv_timings(struct v4l2_subdev *sd, unsigned int pad,
                                struct v4l2_dv_timings *dv_timings)
{
        struct tvp7002 *device = to_tvp7002(sd);

        if (pad != 0)
                return -EINVAL;

        *dv_timings = device->current_timings->timings;
        return 0;
}

/*
 * tvp7002_s_ctrl() - Set a control
 * @ctrl: ptr to v4l2_ctrl struct
 *
 * Set a control in TVP7002 decoder device.
 * Returns zero when successful or -EINVAL if register access fails.
 */
static int tvp7002_s_ctrl(struct v4l2_ctrl *ctrl)
{
        struct v4l2_subdev *sd = to_sd(ctrl);
        int error = 0;

        switch (ctrl->id) {
        case V4L2_CID_GAIN:
                tvp7002_write_err(sd, TVP7002_R_FINE_GAIN, ctrl->val, &error);
                tvp7002_write_err(sd, TVP7002_G_FINE_GAIN, ctrl->val, &error);
                tvp7002_write_err(sd, TVP7002_B_FINE_GAIN, ctrl->val, &error);
                return error;
        }
        return -EINVAL;
}

/*
 * tvp7002_query_dv() - query DV timings
 * @sd: pointer to standard V4L2 sub-device structure
 * @index: index into the tvp7002_timings array
 *
 * Returns the current DV timings detected by TVP7002. If no active input is
 * detected, returns -EINVAL
 */
static int tvp7002_query_dv(struct v4l2_subdev *sd, int *index)
{
        const struct tvp7002_timings_definition *timings = tvp7002_timings;
        u8 progressive;
        u32 lpfr;
        u32 cpln;
        int error = 0;
        u8 lpf_lsb;
        u8 lpf_msb;
        u8 cpl_lsb;
        u8 cpl_msb;

        /* Return invalid index if no active input is detected */
        *index = NUM_TIMINGS;

        /* Read standards from device registers */
        tvp7002_read_err(sd, TVP7002_L_FRAME_STAT_LSBS, &lpf_lsb, &error);
        tvp7002_read_err(sd, TVP7002_L_FRAME_STAT_MSBS, &lpf_msb, &error);

        if (error < 0)
                return error;

        tvp7002_read_err(sd, TVP7002_CLK_L_STAT_LSBS, &cpl_lsb, &error);
        tvp7002_read_err(sd, TVP7002_CLK_L_STAT_MSBS, &cpl_msb, &error);

        if (error < 0)
                return error;

        /* Get lines per frame, clocks per line and interlaced/progresive */
        lpfr = lpf_lsb | ((TVP7002_CL_MASK & lpf_msb) << TVP7002_CL_SHIFT);
        cpln = cpl_lsb | ((TVP7002_CL_MASK & cpl_msb) << TVP7002_CL_SHIFT);
        progressive = (lpf_msb & TVP7002_INPR_MASK) >> TVP7002_IP_SHIFT;

        /* Do checking of video modes */
        for (*index = 0; *index < NUM_TIMINGS; (*index)++, timings++)
                if (lpfr == timings->lines_per_frame &&
                        progressive == timings->progressive) {
                        if (timings->cpl_min == 0xffff)
                                break;
                        if (cpln >= timings->cpl_min && cpln <= timings->cpl_max)
                                break;
                }

        if (*index == NUM_TIMINGS) {
                v4l2_dbg(1, debug, sd, "detection failed: lpf = %x, cpl = %x\n",
                                                                lpfr, cpln);
                return -ENOLINK;
        }

        /* Update lines per frame and clocks per line info */
        v4l2_dbg(1, debug, sd, "detected timings: %d\n", *index);
        return 0;
}

static int tvp7002_query_dv_timings(struct v4l2_subdev *sd, unsigned int pad,
                                    struct v4l2_dv_timings *timings)
{
        int index;
        int err;

        if (pad != 0)
                return -EINVAL;

        err = tvp7002_query_dv(sd, &index);
        if (err)
                return err;
        *timings = tvp7002_timings[index].timings;
        return 0;
}

#ifdef CONFIG_VIDEO_ADV_DEBUG
/*
 * tvp7002_g_register() - Get the value of a register
 * @sd: ptr to v4l2_subdev struct
 * @reg: ptr to v4l2_dbg_register struct
 *
 * Get the value of a TVP7002 decoder device register.
 * Returns zero when successful, -EINVAL if register read fails or
 * access to I2C client fails.
 */
static int tvp7002_g_register(struct v4l2_subdev *sd,
                                                struct v4l2_dbg_register *reg)
{
        u8 val;
        int ret;

        ret = tvp7002_read(sd, reg->reg & 0xff, &val);
        if (ret < 0)
                return ret;
        reg->val = val;
        reg->size = 1;
        return 0;
}

/*
 * tvp7002_s_register() - set a control
 * @sd: ptr to v4l2_subdev struct
 * @reg: ptr to v4l2_dbg_register struct
 *
 * Get the value of a TVP7002 decoder device register.
 * Returns zero when successful, -EINVAL if register read fails.
 */
static int tvp7002_s_register(struct v4l2_subdev *sd,
                                                const struct v4l2_dbg_register *reg)
{
        return tvp7002_write(sd, reg->reg & 0xff, reg->val & 0xff);
}
#endif

/*
 * tvp7002_s_stream() - V4L2 decoder i/f handler for s_stream
 * @sd: pointer to standard V4L2 sub-device structure
 * @enable: streaming enable or disable
 *
 * Sets streaming to enable or disable, if possible.
 */
static int tvp7002_s_stream(struct v4l2_subdev *sd, int enable)
{
        struct tvp7002 *device = to_tvp7002(sd);
        int error;

        if (device->streaming == enable)
                return 0;

        /* low impedance: on, high impedance: off */
        error = tvp7002_write(sd, TVP7002_MISC_CTL_2, enable ? 0x00 : 0x03);
        if (error) {
                v4l2_dbg(1, debug, sd, "Fail to set streaming\n");
                return error;
        }

        device->streaming = enable;
        return 0;
}

/*
 * tvp7002_log_status() - Print information about register settings
 * @sd: ptr to v4l2_subdev struct
 *
 * Log register values of a TVP7002 decoder device.
 * Returns zero or -EINVAL if read operation fails.
 */
static int tvp7002_log_status(struct v4l2_subdev *sd)
{
        struct tvp7002 *device = to_tvp7002(sd);
        const struct v4l2_bt_timings *bt;
        int detected;

        /* Find my current timings */
        tvp7002_query_dv(sd, &detected);

        bt = &device->current_timings->timings.bt;
        v4l2_info(sd, "Selected DV Timings: %ux%u\n", bt->width, bt->height);
        if (detected == NUM_TIMINGS) {
                v4l2_info(sd, "Detected DV Timings: None\n");
        } else {
                bt = &tvp7002_timings[detected].timings.bt;
                v4l2_info(sd, "Detected DV Timings: %ux%u\n",
                                bt->width, bt->height);
        }
        v4l2_info(sd, "Streaming enabled: %s\n",
                                        device->streaming ? "yes" : "no");

        /* Print the current value of the gain control */
        v4l2_ctrl_handler_log_status(&device->hdl, sd->name);

        return 0;
}

static int tvp7002_enum_dv_timings(struct v4l2_subdev *sd,
                struct v4l2_enum_dv_timings *timings)
{
        if (timings->pad != 0)
                return -EINVAL;

        /* Check requested format index is within range */
        if (timings->index >= NUM_TIMINGS)
                return -EINVAL;

        timings->timings = tvp7002_timings[timings->index].timings;
        return 0;
}

static const struct v4l2_ctrl_ops tvp7002_ctrl_ops = {
        .s_ctrl = tvp7002_s_ctrl,
};

/*
 * tvp7002_enum_mbus_code() - Enum supported digital video format on pad
 * @sd: pointer to standard V4L2 sub-device structure
 * @sd_state: V4L2 subdev state
 * @code: pointer to subdev enum mbus code struct
 *
 * Enumerate supported digital video formats for pad.
 */
static int
tvp7002_enum_mbus_code(struct v4l2_subdev *sd,
                       struct v4l2_subdev_state *sd_state,
                       struct v4l2_subdev_mbus_code_enum *code)
{
        /* Check requested format index is within range */
        if (code->index != 0)
                return -EINVAL;

        code->code = MEDIA_BUS_FMT_YUYV10_1X20;

        return 0;
}

/*
 * tvp7002_get_pad_format() - get video format on pad
 * @sd: pointer to standard V4L2 sub-device structure
 * @sd_state: V4L2 subdev state
 * @fmt: pointer to subdev format struct
 *
 * get video format for pad.
 */
static int
tvp7002_get_pad_format(struct v4l2_subdev *sd,
                       struct v4l2_subdev_state *sd_state,
                       struct v4l2_subdev_format *fmt)
{
        struct tvp7002 *tvp7002 = to_tvp7002(sd);

        fmt->format.code = MEDIA_BUS_FMT_YUYV10_1X20;
        fmt->format.width = tvp7002->current_timings->timings.bt.width;
        fmt->format.height = tvp7002->current_timings->timings.bt.height;
        fmt->format.field = tvp7002->current_timings->scanmode;
        fmt->format.colorspace = tvp7002->current_timings->color_space;

        return 0;
}

/*
 * tvp7002_set_pad_format() - set video format on pad
 * @sd: pointer to standard V4L2 sub-device structure
 * @sd_state: V4L2 subdev state
 * @fmt: pointer to subdev format struct
 *
 * set video format for pad.
 */
static int
tvp7002_set_pad_format(struct v4l2_subdev *sd,
                       struct v4l2_subdev_state *sd_state,
                       struct v4l2_subdev_format *fmt)
{
        return tvp7002_get_pad_format(sd, sd_state, fmt);
}

/* V4L2 core operation handlers */
static const struct v4l2_subdev_core_ops tvp7002_core_ops = {
        .log_status = tvp7002_log_status,
#ifdef CONFIG_VIDEO_ADV_DEBUG
        .g_register = tvp7002_g_register,
        .s_register = tvp7002_s_register,
#endif
};

/* Specific video subsystem operation handlers */
static const struct v4l2_subdev_video_ops tvp7002_video_ops = {
        .s_stream = tvp7002_s_stream,
};

/* media pad related operation handlers */
static const struct v4l2_subdev_pad_ops tvp7002_pad_ops = {
        .enum_mbus_code = tvp7002_enum_mbus_code,
        .get_fmt = tvp7002_get_pad_format,
        .set_fmt = tvp7002_set_pad_format,
        .g_dv_timings = tvp7002_g_dv_timings,
        .s_dv_timings = tvp7002_s_dv_timings,
        .query_dv_timings = tvp7002_query_dv_timings,
        .enum_dv_timings = tvp7002_enum_dv_timings,
};

/* V4L2 top level operation handlers */
static const struct v4l2_subdev_ops tvp7002_ops = {
        .core = &tvp7002_core_ops,
        .video = &tvp7002_video_ops,
        .pad = &tvp7002_pad_ops,
};

static struct tvp7002_config *
tvp7002_get_pdata(struct i2c_client *client)
{
        struct v4l2_fwnode_endpoint bus_cfg = { .bus_type = 0 };
        struct tvp7002_config *pdata = NULL;
        struct device_node *endpoint;
        unsigned int flags;

        if (!IS_ENABLED(CONFIG_OF) || !client->dev.of_node)
                return client->dev.platform_data;

        endpoint = of_graph_get_endpoint_by_regs(client->dev.of_node, 0, -1);
        if (!endpoint)
                return NULL;

        if (v4l2_fwnode_endpoint_parse(of_fwnode_handle(endpoint), &bus_cfg))
                goto done;

        pdata = devm_kzalloc(&client->dev, sizeof(*pdata), GFP_KERNEL);
        if (!pdata)
                goto done;

        flags = bus_cfg.bus.parallel.flags;

        if (flags & V4L2_MBUS_HSYNC_ACTIVE_HIGH)
                pdata->hs_polarity = 1;

        if (flags & V4L2_MBUS_VSYNC_ACTIVE_HIGH)
                pdata->vs_polarity = 1;

        if (flags & V4L2_MBUS_PCLK_SAMPLE_RISING)
                pdata->clk_polarity = 1;

        if (flags & V4L2_MBUS_FIELD_EVEN_HIGH)
                pdata->fid_polarity = 1;

        if (flags & V4L2_MBUS_VIDEO_SOG_ACTIVE_HIGH)
                pdata->sog_polarity = 1;

done:
        of_node_put(endpoint);
        return pdata;
}

/*
 * tvp7002_probe - Probe a TVP7002 device
 * @c: ptr to i2c_client struct
 * @id: ptr to i2c_device_id struct
 *
 * Initialize the TVP7002 device
 * Returns zero when successful, -EINVAL if register read fails or
 * -EIO if i2c access is not available.
 */
static int tvp7002_probe(struct i2c_client *c)
{
        struct tvp7002_config *pdata = tvp7002_get_pdata(c);
        struct v4l2_subdev *sd;
        struct tvp7002 *device;
        struct v4l2_dv_timings timings;
        int polarity_a;
        int polarity_b;
        u8 revision;
        int error;

        if (pdata == NULL) {
                dev_err(&c->dev, "No platform data\n");
                return -EINVAL;
        }

        /* Check if the adapter supports the needed features */
        if (!i2c_check_functionality(c->adapter,
                I2C_FUNC_SMBUS_READ_BYTE | I2C_FUNC_SMBUS_WRITE_BYTE_DATA))
                return -EIO;

        device = devm_kzalloc(&c->dev, sizeof(struct tvp7002), GFP_KERNEL);

        if (!device)
                return -ENOMEM;

        sd = &device->sd;
        device->pdata = pdata;
        device->current_timings = tvp7002_timings;

        /* Tell v4l2 the device is ready */
        v4l2_i2c_subdev_init(sd, c, &tvp7002_ops);
        v4l_info(c, "tvp7002 found @ 0x%02x (%s)\n",
                                        c->addr, c->adapter->name);

        error = tvp7002_read(sd, TVP7002_CHIP_REV, &revision);
        if (error < 0)
                return error;

        /* Get revision number */
        v4l2_info(sd, "Rev. %02x detected.\n", revision);
        if (revision != 0x02)
                v4l2_info(sd, "Unknown revision detected.\n");

        /* Initializes TVP7002 to its default values */
        error = tvp7002_write_inittab(sd, tvp7002_init_default);

        if (error < 0)
                return error;

        /* Set polarity information after registers have been set */
        polarity_a = 0x20 | device->pdata->hs_polarity << 5
                        | device->pdata->vs_polarity << 2;
        error = tvp7002_write(sd, TVP7002_SYNC_CTL_1, polarity_a);
        if (error < 0)
                return error;

        polarity_b = 0x01  | device->pdata->fid_polarity << 2
                        | device->pdata->sog_polarity << 1
                        | device->pdata->clk_polarity;
        error = tvp7002_write(sd, TVP7002_MISC_CTL_3, polarity_b);
        if (error < 0)
                return error;

        /* Set registers according to default video mode */
        timings = device->current_timings->timings;
        error = tvp7002_s_dv_timings(sd, 0, &timings);

#if defined(CONFIG_MEDIA_CONTROLLER)
        device->pad.flags = MEDIA_PAD_FL_SOURCE;
        device->sd.flags |= V4L2_SUBDEV_FL_HAS_DEVNODE;
        device->sd.entity.function = MEDIA_ENT_F_ATV_DECODER;

        error = media_entity_pads_init(&device->sd.entity, 1, &device->pad);
        if (error < 0)
                return error;
#endif

        v4l2_ctrl_handler_init(&device->hdl, 1);
        v4l2_ctrl_new_std(&device->hdl, &tvp7002_ctrl_ops,
                        V4L2_CID_GAIN, 0, 255, 1, 0);
        sd->ctrl_handler = &device->hdl;
        if (device->hdl.error) {
                error = device->hdl.error;
                goto error;
        }
        v4l2_ctrl_handler_setup(&device->hdl);

        error = v4l2_async_register_subdev(&device->sd);
        if (error)
                goto error;

        return 0;

error:
        v4l2_ctrl_handler_free(&device->hdl);
#if defined(CONFIG_MEDIA_CONTROLLER)
        media_entity_cleanup(&device->sd.entity);
#endif
        return error;
}

/*
 * tvp7002_remove - Remove TVP7002 device support
 * @c: ptr to i2c_client struct
 *
 * Reset the TVP7002 device
 * Returns zero.
 */
static void tvp7002_remove(struct i2c_client *c)
{
        struct v4l2_subdev *sd = i2c_get_clientdata(c);
        struct tvp7002 *device = to_tvp7002(sd);

        v4l2_dbg(1, debug, sd, "Removing tvp7002 adapter"
                                "on address 0x%x\n", c->addr);
        v4l2_async_unregister_subdev(&device->sd);
#if defined(CONFIG_MEDIA_CONTROLLER)
        media_entity_cleanup(&device->sd.entity);
#endif
        v4l2_ctrl_handler_free(&device->hdl);
}

/* I2C Device ID table */
static const struct i2c_device_id tvp7002_id[] = {
        { .name = "tvp7002" },
        { }
};
MODULE_DEVICE_TABLE(i2c, tvp7002_id);

#if IS_ENABLED(CONFIG_OF)
static const struct of_device_id tvp7002_of_match[] = {
        { .compatible = "ti,tvp7002", },
        { /* sentinel */ },
};
MODULE_DEVICE_TABLE(of, tvp7002_of_match);
#endif

/* I2C driver data */
static struct i2c_driver tvp7002_driver = {
        .driver = {
                .of_match_table = of_match_ptr(tvp7002_of_match),
                .name = TVP7002_MODULE_NAME,
        },
        .probe = tvp7002_probe,
        .remove = tvp7002_remove,
        .id_table = tvp7002_id,
};

module_i2c_driver(tvp7002_driver);