kernel/include/media/adv7842.h

   1 /*
   2  * adv7842 - Analog Devices ADV7842 video decoder driver
   3  *
   4  * Copyright 2013 Cisco Systems, Inc. and/or its affiliates. All rights reserved.
   5  *
   6  * This program is free software; you may redistribute it and/or modify
   7  * it under the terms of the GNU General Public License as published by
   8  * the Free Software Foundation; version 2 of the License.
   9  *
  10  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
  11  * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
  12  * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
  13  * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
  14  * BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
  15  * ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
  16  * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  17  * SOFTWARE.
  18  *
  19  */
  20
  21 #ifndef _ADV7842_
  22 #define _ADV7842_
  23
  24 /* Analog input muxing modes (AFE register 0x02, [2:0]) */
  25 enum adv7842_ain_sel {
  26         ADV7842_AIN1_2_3_NC_SYNC_1_2 = 0,
  27         ADV7842_AIN4_5_6_NC_SYNC_2_1 = 1,
  28         ADV7842_AIN7_8_9_NC_SYNC_3_1 = 2,
  29         ADV7842_AIN10_11_12_NC_SYNC_4_1 = 3,
  30         ADV7842_AIN9_4_5_6_SYNC_2_1 = 4,
  31 };
  32
  33 /*
  34  * Bus rotation and reordering. This is used to specify component reordering on
  35  * the board and describes the components order on the bus when the ADV7842
  36  * outputs RGB.
  37  */
  38 enum adv7842_bus_order {
  39         ADV7842_BUS_ORDER_RGB,          /* No operation */
  40         ADV7842_BUS_ORDER_GRB,          /* Swap 1-2     */
  41         ADV7842_BUS_ORDER_RBG,          /* Swap 2-3     */
  42         ADV7842_BUS_ORDER_BGR,          /* Swap 1-3     */
  43         ADV7842_BUS_ORDER_BRG,          /* Rotate right */
  44         ADV7842_BUS_ORDER_GBR,          /* Rotate left  */
  45 };
  46
  47 /* Input Color Space (IO register 0x02, [7:4]) */
  48 enum adv7842_inp_color_space {
  49         ADV7842_INP_COLOR_SPACE_LIM_RGB = 0,
  50         ADV7842_INP_COLOR_SPACE_FULL_RGB = 1,
  51         ADV7842_INP_COLOR_SPACE_LIM_YCbCr_601 = 2,
  52         ADV7842_INP_COLOR_SPACE_LIM_YCbCr_709 = 3,
  53         ADV7842_INP_COLOR_SPACE_XVYCC_601 = 4,
  54         ADV7842_INP_COLOR_SPACE_XVYCC_709 = 5,
  55         ADV7842_INP_COLOR_SPACE_FULL_YCbCr_601 = 6,
  56         ADV7842_INP_COLOR_SPACE_FULL_YCbCr_709 = 7,
  57         ADV7842_INP_COLOR_SPACE_AUTO = 0xf,
  58 };
  59
  60 /* Select output format (IO register 0x03, [4:2]) */
  61 enum adv7842_op_format_mode_sel {
  62         ADV7842_OP_FORMAT_MODE0 = 0x00,
  63         ADV7842_OP_FORMAT_MODE1 = 0x04,
  64         ADV7842_OP_FORMAT_MODE2 = 0x08,
  65 };
  66
  67 /* Mode of operation */
  68 enum adv7842_mode {
  69         ADV7842_MODE_SDP,
  70         ADV7842_MODE_COMP,
  71         ADV7842_MODE_RGB,
  72         ADV7842_MODE_HDMI
  73 };
  74
  75 /* Video standard select (IO register 0x00, [5:0]) */
  76 enum adv7842_vid_std_select {
  77         /* SDP */
  78         ADV7842_SDP_VID_STD_CVBS_SD_4x1 = 0x01,
  79         ADV7842_SDP_VID_STD_YC_SD4_x1 = 0x09,
  80         /* RGB */
  81         ADV7842_RGB_VID_STD_AUTO_GRAPH_MODE = 0x07,
  82         /* HDMI GR */
  83         ADV7842_HDMI_GR_VID_STD_AUTO_GRAPH_MODE = 0x02,
  84         /* HDMI COMP */
  85         ADV7842_HDMI_COMP_VID_STD_HD_1250P = 0x1e,
  86 };
  87
  88 enum adv7842_select_input {
  89         ADV7842_SELECT_HDMI_PORT_A,
  90         ADV7842_SELECT_HDMI_PORT_B,
  91         ADV7842_SELECT_VGA_RGB,
  92         ADV7842_SELECT_VGA_COMP,
  93         ADV7842_SELECT_SDP_CVBS,
  94         ADV7842_SELECT_SDP_YC,
  95 };
  96
  97 enum adv7842_drive_strength {
  98         ADV7842_DR_STR_LOW = 0,
  99         ADV7842_DR_STR_MEDIUM_LOW = 1,
 100         ADV7842_DR_STR_MEDIUM_HIGH = 2,
 101         ADV7842_DR_STR_HIGH = 3,
 102 };
 103
 104 struct adv7842_sdp_csc_coeff {
 105         bool manual;
 106         u16 scaling;
 107         u16 A1;
 108         u16 A2;
 109         u16 A3;
 110         u16 A4;
 111         u16 B1;
 112         u16 B2;
 113         u16 B3;
 114         u16 B4;
 115         u16 C1;
 116         u16 C2;
 117         u16 C3;
 118         u16 C4;
 119 };
 120
 121 struct adv7842_sdp_io_sync_adjustment {
 122         bool adjust;
 123         u16 hs_beg;
 124         u16 hs_width;
 125         u16 de_beg;
 126         u16 de_end;
 127         u8 vs_beg_o;
 128         u8 vs_beg_e;
 129         u8 vs_end_o;
 130         u8 vs_end_e;
 131         u8 de_v_beg_o;
 132         u8 de_v_beg_e;
 133         u8 de_v_end_o;
 134         u8 de_v_end_e;
 135 };
 136
 137 /* Platform dependent definition */
 138 struct adv7842_platform_data {
 139         /* chip reset during probe */
 140         unsigned chip_reset:1;
 141
 142         /* DIS_PWRDNB: 1 if the PWRDNB pin is unused and unconnected */
 143         unsigned disable_pwrdnb:1;
 144
 145         /* DIS_CABLE_DET_RST: 1 if the 5V pins are unused and unconnected */
 146         unsigned disable_cable_det_rst:1;
 147
 148         /* Analog input muxing mode */
 149         enum adv7842_ain_sel ain_sel;
 150
 151         /* Bus rotation and reordering */
 152         enum adv7842_bus_order bus_order;
 153
 154         /* Select output format mode */
 155         enum adv7842_op_format_mode_sel op_format_mode_sel;
 156
 157         /* Default mode */
 158         enum adv7842_mode mode;
 159
 160         /* Default input */
 161         unsigned input;
 162
 163         /* Video standard */
 164         enum adv7842_vid_std_select vid_std_select;
 165
 166         /* IO register 0x02 */
 167         unsigned alt_gamma:1;
 168         unsigned op_656_range:1;
 169         unsigned alt_data_sat:1;
 170
 171         /* IO register 0x05 */
 172         unsigned blank_data:1;
 173         unsigned insert_av_codes:1;
 174         unsigned replicate_av_codes:1;
 175
 176         /* IO register 0x30 */
 177         unsigned output_bus_lsb_to_msb:1;
 178
 179         /* IO register 0x14 */
 180         enum adv7842_drive_strength dr_str_data;
 181         enum adv7842_drive_strength dr_str_clk;
 182         enum adv7842_drive_strength dr_str_sync;
 183
 184         /*
 185          * IO register 0x19: Adjustment to the LLC DLL phase in
 186          * increments of 1/32 of a clock period.
 187          */
 188         unsigned llc_dll_phase:5;
 189
 190         /* External RAM for 3-D comb or frame synchronizer */
 191         unsigned sd_ram_size; /* ram size in MB */
 192         unsigned sd_ram_ddr:1; /* ddr or sdr sdram */
 193
 194         /* HDMI free run, CP-reg 0xBA */
 195         unsigned hdmi_free_run_enable:1;
 196         /* 0 = Mode 0: run when there is no TMDS clock
 197            1 = Mode 1: run when there is no TMDS clock or the
 198                video resolution does not match programmed one. */
 199         unsigned hdmi_free_run_mode:1;
 200
 201         /* SDP free run, CP-reg 0xDD */
 202         unsigned sdp_free_run_auto:1;
 203         unsigned sdp_free_run_man_col_en:1;
 204         unsigned sdp_free_run_cbar_en:1;
 205         unsigned sdp_free_run_force:1;
 206
 207         /* HPA manual (0) or auto (1), affects HDMI register 0x69 */
 208         unsigned hpa_auto:1;
 209
 210         struct adv7842_sdp_csc_coeff sdp_csc_coeff;
 211
 212         struct adv7842_sdp_io_sync_adjustment sdp_io_sync_625;
 213         struct adv7842_sdp_io_sync_adjustment sdp_io_sync_525;
 214
 215         /* i2c addresses */
 216         u8 i2c_sdp_io;
 217         u8 i2c_sdp;
 218         u8 i2c_cp;
 219         u8 i2c_vdp;
 220         u8 i2c_afe;
 221         u8 i2c_hdmi;
 222         u8 i2c_repeater;
 223         u8 i2c_edid;
 224         u8 i2c_infoframe;
 225         u8 i2c_cec;
 226         u8 i2c_avlink;
 227 };
 228
 229 #define V4L2_CID_ADV_RX_ANALOG_SAMPLING_PHASE   (V4L2_CID_DV_CLASS_BASE + 0x1000)
 230 #define V4L2_CID_ADV_RX_FREE_RUN_COLOR_MANUAL   (V4L2_CID_DV_CLASS_BASE + 0x1001)
 231 #define V4L2_CID_ADV_RX_FREE_RUN_COLOR          (V4L2_CID_DV_CLASS_BASE + 0x1002)
 232
 233 /* custom ioctl, used to test the external RAM that's used by the
 234  * deinterlacer. */
 235 #define ADV7842_CMD_RAM_TEST _IO('V', BASE_VIDIOC_PRIVATE)
 236
 237 #define ADV7842_EDID_PORT_A   0
 238 #define ADV7842_EDID_PORT_B   1
 239 #define ADV7842_EDID_PORT_VGA 2
 240 #define ADV7842_PAD_SOURCE    3
 241
 242 #endif