xref: /openbmc/linux/include/media/i2c/tc358743.h (revision 82e6fdd6)
1 /*
2  * tc358743 - Toshiba HDMI to CSI-2 bridge
3  *
4  * Copyright 2015 Cisco Systems, Inc. and/or its affiliates. All rights
5  * reserved.
6  *
7  * This program is free software; you may redistribute it and/or modify
8  * it under the terms of the GNU General Public License as published by
9  * the Free Software Foundation; version 2 of the License.
10  *
11  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
12  * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
13  * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
14  * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
15  * BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
16  * ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
17  * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
18  * SOFTWARE.
19  *
20  */
21 
22 /*
23  * References (c = chapter, p = page):
24  * REF_01 - Toshiba, TC358743XBG (H2C), Functional Specification, Rev 0.60
25  * REF_02 - Toshiba, TC358743XBG_HDMI-CSI_Tv11p_nm.xls
26  */
27 
28 #ifndef _TC358743_
29 #define _TC358743_
30 
31 enum tc358743_ddc5v_delays {
32 	DDC5V_DELAY_0_MS,
33 	DDC5V_DELAY_50_MS,
34 	DDC5V_DELAY_100_MS,
35 	DDC5V_DELAY_200_MS,
36 };
37 
38 enum tc358743_hdmi_detection_delay {
39 	HDMI_MODE_DELAY_0_MS,
40 	HDMI_MODE_DELAY_25_MS,
41 	HDMI_MODE_DELAY_50_MS,
42 	HDMI_MODE_DELAY_100_MS,
43 };
44 
45 struct tc358743_platform_data {
46 	/* System clock connected to REFCLK (pin H5) */
47 	u32 refclk_hz; /* 26 MHz, 27 MHz or 42 MHz */
48 
49 	/* DDC +5V debounce delay to avoid spurious interrupts when the cable
50 	 * is connected.
51 	 * Sets DDC5V_MODE in register DDC_CTL.
52 	 * Default: DDC5V_DELAY_0_MS
53 	 */
54 	enum tc358743_ddc5v_delays ddc5v_delay;
55 
56 	bool enable_hdcp;
57 
58 	/*
59 	 * The FIFO size is 512x32, so Toshiba recommend to set the default FIFO
60 	 * level to somewhere in the middle (e.g. 300), so it can cover speed
61 	 * mismatches in input and output ports.
62 	 */
63 	u16 fifo_level;
64 
65 	/* Bps pr lane is (refclk_hz / pll_prd) * pll_fbd */
66 	u16 pll_prd;
67 	u16 pll_fbd;
68 
69 	/* CSI
70 	 * Calculate CSI parameters with REF_02 for the highest resolution your
71 	 * CSI interface can handle. The driver will adjust the number of CSI
72 	 * lanes in use according to the pixel clock.
73 	 *
74 	 * The values in brackets are calculated with REF_02 when the number of
75 	 * bps pr lane is 823.5 MHz, and can serve as a starting point.
76 	 */
77 	u32 lineinitcnt;	/* (0x00001770) */
78 	u32 lptxtimecnt;	/* (0x00000005) */
79 	u32 tclk_headercnt;	/* (0x00001d04) */
80 	u32 tclk_trailcnt;	/* (0x00000000) */
81 	u32 ths_headercnt;	/* (0x00000505) */
82 	u32 twakeup;		/* (0x00004650) */
83 	u32 tclk_postcnt;	/* (0x00000000) */
84 	u32 ths_trailcnt;	/* (0x00000004) */
85 	u32 hstxvregcnt;	/* (0x00000005) */
86 
87 	/* DVI->HDMI detection delay to avoid unnecessary switching between DVI
88 	 * and HDMI mode.
89 	 * Sets HDMI_DET_V in register HDMI_DET.
90 	 * Default: HDMI_MODE_DELAY_0_MS
91 	 */
92 	enum tc358743_hdmi_detection_delay hdmi_detection_delay;
93 
94 	/* Reset PHY automatically when TMDS clock goes from DC to AC.
95 	 * Sets PHY_AUTO_RST2 in register PHY_CTL2.
96 	 * Default: false
97 	 */
98 	bool hdmi_phy_auto_reset_tmds_detected;
99 
100 	/* Reset PHY automatically when TMDS clock passes 21 MHz.
101 	 * Sets PHY_AUTO_RST3 in register PHY_CTL2.
102 	 * Default: false
103 	 */
104 	bool hdmi_phy_auto_reset_tmds_in_range;
105 
106 	/* Reset PHY automatically when TMDS clock is detected.
107 	 * Sets PHY_AUTO_RST4 in register PHY_CTL2.
108 	 * Default: false
109 	 */
110 	bool hdmi_phy_auto_reset_tmds_valid;
111 
112 	/* Reset HDMI PHY automatically when hsync period is out of range.
113 	 * Sets H_PI_RST in register HV_RST.
114 	 * Default: false
115 	 */
116 	bool hdmi_phy_auto_reset_hsync_out_of_range;
117 
118 	/* Reset HDMI PHY automatically when vsync period is out of range.
119 	 * Sets V_PI_RST in register HV_RST.
120 	 * Default: false
121 	 */
122 	bool hdmi_phy_auto_reset_vsync_out_of_range;
123 };
124 
125 /* custom controls */
126 /* Audio sample rate in Hz */
127 #define TC358743_CID_AUDIO_SAMPLING_RATE (V4L2_CID_USER_TC358743_BASE + 0)
128 /* Audio present status */
129 #define TC358743_CID_AUDIO_PRESENT       (V4L2_CID_USER_TC358743_BASE + 1)
130 
131 #endif
132