1/* SPDX-License-Identifier: GPL-2.0-or-later */
2/*
3 * Copyright (C) 2011 Freescale Semiconductor, Inc.
4 */
5
6#ifndef __DW_HDMI__
7#define __DW_HDMI__
8
9#include <sound/hdmi-codec.h>
10
11struct drm_display_info;
12struct drm_display_mode;
13struct drm_encoder;
14struct dw_hdmi;
15struct platform_device;
16
17/**
18 * DOC: Supported input formats and encodings
19 *
20 * Depending on the Hardware configuration of the Controller IP, it supports
21 * a subset of the following input formats and encodings on its internal
22 * 48bit bus.
23 *
24 * +----------------------+----------------------------------+------------------------------+
25 * | Format Name | Format Code | Encodings |
26 * +----------------------+----------------------------------+------------------------------+
27 * | RGB 4:4:4 8bit | ``MEDIA_BUS_FMT_RGB888_1X24`` | ``V4L2_YCBCR_ENC_DEFAULT`` |
28 * +----------------------+----------------------------------+------------------------------+
29 * | RGB 4:4:4 10bits | ``MEDIA_BUS_FMT_RGB101010_1X30`` | ``V4L2_YCBCR_ENC_DEFAULT`` |
30 * +----------------------+----------------------------------+------------------------------+
31 * | RGB 4:4:4 12bits | ``MEDIA_BUS_FMT_RGB121212_1X36`` | ``V4L2_YCBCR_ENC_DEFAULT`` |
32 * +----------------------+----------------------------------+------------------------------+
33 * | RGB 4:4:4 16bits | ``MEDIA_BUS_FMT_RGB161616_1X48`` | ``V4L2_YCBCR_ENC_DEFAULT`` |
34 * +----------------------+----------------------------------+------------------------------+
35 * | YCbCr 4:4:4 8bit | ``MEDIA_BUS_FMT_YUV8_1X24`` | ``V4L2_YCBCR_ENC_601`` |
36 * | | | or ``V4L2_YCBCR_ENC_709`` |
37 * | | | or ``V4L2_YCBCR_ENC_XV601`` |
38 * | | | or ``V4L2_YCBCR_ENC_XV709`` |
39 * +----------------------+----------------------------------+------------------------------+
40 * | YCbCr 4:4:4 10bits | ``MEDIA_BUS_FMT_YUV10_1X30`` | ``V4L2_YCBCR_ENC_601`` |
41 * | | | or ``V4L2_YCBCR_ENC_709`` |
42 * | | | or ``V4L2_YCBCR_ENC_XV601`` |
43 * | | | or ``V4L2_YCBCR_ENC_XV709`` |
44 * +----------------------+----------------------------------+------------------------------+
45 * | YCbCr 4:4:4 12bits | ``MEDIA_BUS_FMT_YUV12_1X36`` | ``V4L2_YCBCR_ENC_601`` |
46 * | | | or ``V4L2_YCBCR_ENC_709`` |
47 * | | | or ``V4L2_YCBCR_ENC_XV601`` |
48 * | | | or ``V4L2_YCBCR_ENC_XV709`` |
49 * +----------------------+----------------------------------+------------------------------+
50 * | YCbCr 4:4:4 16bits | ``MEDIA_BUS_FMT_YUV16_1X48`` | ``V4L2_YCBCR_ENC_601`` |
51 * | | | or ``V4L2_YCBCR_ENC_709`` |
52 * | | | or ``V4L2_YCBCR_ENC_XV601`` |
53 * | | | or ``V4L2_YCBCR_ENC_XV709`` |
54 * +----------------------+----------------------------------+------------------------------+
55 * | YCbCr 4:2:2 8bit | ``MEDIA_BUS_FMT_UYVY8_1X16`` | ``V4L2_YCBCR_ENC_601`` |
56 * | | | or ``V4L2_YCBCR_ENC_709`` |
57 * +----------------------+----------------------------------+------------------------------+
58 * | YCbCr 4:2:2 10bits | ``MEDIA_BUS_FMT_UYVY10_1X20`` | ``V4L2_YCBCR_ENC_601`` |
59 * | | | or ``V4L2_YCBCR_ENC_709`` |
60 * +----------------------+----------------------------------+------------------------------+
61 * | YCbCr 4:2:2 12bits | ``MEDIA_BUS_FMT_UYVY12_1X24`` | ``V4L2_YCBCR_ENC_601`` |
62 * | | | or ``V4L2_YCBCR_ENC_709`` |
63 * +----------------------+----------------------------------+------------------------------+
64 * | YCbCr 4:2:0 8bit | ``MEDIA_BUS_FMT_UYYVYY8_0_5X24`` | ``V4L2_YCBCR_ENC_601`` |
65 * | | | or ``V4L2_YCBCR_ENC_709`` |
66 * +----------------------+----------------------------------+------------------------------+
67 * | YCbCr 4:2:0 10bits | ``MEDIA_BUS_FMT_UYYVYY10_0_5X30``| ``V4L2_YCBCR_ENC_601`` |
68 * | | | or ``V4L2_YCBCR_ENC_709`` |
69 * +----------------------+----------------------------------+------------------------------+
70 * | YCbCr 4:2:0 12bits | ``MEDIA_BUS_FMT_UYYVYY12_0_5X36``| ``V4L2_YCBCR_ENC_601`` |
71 * | | | or ``V4L2_YCBCR_ENC_709`` |
72 * +----------------------+----------------------------------+------------------------------+
73 * | YCbCr 4:2:0 16bits | ``MEDIA_BUS_FMT_UYYVYY16_0_5X48``| ``V4L2_YCBCR_ENC_601`` |
74 * | | | or ``V4L2_YCBCR_ENC_709`` |
75 * +----------------------+----------------------------------+------------------------------+
76 */
77
78enum {
79 DW_HDMI_RES_8,
80 DW_HDMI_RES_10,
81 DW_HDMI_RES_12,
82 DW_HDMI_RES_MAX,
83};
84
85enum dw_hdmi_phy_type {
86 DW_HDMI_PHY_DWC_HDMI_TX_PHY = 0x00,
87 DW_HDMI_PHY_DWC_MHL_PHY_HEAC = 0xb2,
88 DW_HDMI_PHY_DWC_MHL_PHY = 0xc2,
89 DW_HDMI_PHY_DWC_HDMI_3D_TX_PHY_HEAC = 0xe2,
90 DW_HDMI_PHY_DWC_HDMI_3D_TX_PHY = 0xf2,
91 DW_HDMI_PHY_DWC_HDMI20_TX_PHY = 0xf3,
92 DW_HDMI_PHY_VENDOR_PHY = 0xfe,
93};
94
95struct dw_hdmi_mpll_config {
96 unsigned long mpixelclock;
97 struct {
98 u16 cpce;
99 u16 gmp;
100 } res[DW_HDMI_RES_MAX];
101};
102
103struct dw_hdmi_curr_ctrl {
104 unsigned long mpixelclock;
105 u16 curr[DW_HDMI_RES_MAX];
106};
107
108struct dw_hdmi_phy_config {
109 unsigned long mpixelclock;
110 u16 sym_ctr; /*clock symbol and transmitter control*/
111 u16 term; /*transmission termination value*/
112 u16 vlev_ctr; /* voltage level control */
113};
114
115struct dw_hdmi_phy_ops {
116 int (*init)(struct dw_hdmi *hdmi, void *data,
117 const struct drm_display_info *display,
118 const struct drm_display_mode *mode);
119 void (*disable)(struct dw_hdmi *hdmi, void *data);
120 enum drm_connector_status (*read_hpd)(struct dw_hdmi *hdmi, void *data);
121 void (*update_hpd)(struct dw_hdmi *hdmi, void *data,
122 bool force, bool disabled, bool rxsense);
123 void (*setup_hpd)(struct dw_hdmi *hdmi, void *data);
124};
125
126struct dw_hdmi_plat_data {
127 struct regmap *regm;
128
129 unsigned int output_port;
130
131 unsigned long input_bus_encoding;
132 bool use_drm_infoframe;
133 bool ycbcr_420_allowed;
134
135 /*
136 * Private data passed to all the .mode_valid() and .configure_phy()
137 * callback functions.
138 */
139 void *priv_data;
140
141 /* Platform-specific mode validation (optional). */
142 enum drm_mode_status (*mode_valid)(struct dw_hdmi *hdmi, void *data,
143 const struct drm_display_info *info,
144 const struct drm_display_mode *mode);
145
146 /*
147 * priv_audio is specially used for additional audio device to get
148 * driver data through this dw_hdmi_plat_data.
149 */
150 void *priv_audio;
151
152 /* Platform-specific audio enable/disable (optional) */
153 void (*enable_audio)(struct dw_hdmi *hdmi, int channel,
154 int width, int rate, int non_pcm, int iec958);
155 void (*disable_audio)(struct dw_hdmi *hdmi);
156
157 /* Vendor PHY support */
158 const struct dw_hdmi_phy_ops *phy_ops;
159 const char *phy_name;
160 void *phy_data;
161 unsigned int phy_force_vendor;
162
163 /* Synopsys PHY support */
164 const struct dw_hdmi_mpll_config *mpll_cfg;
165 const struct dw_hdmi_curr_ctrl *cur_ctr;
166 const struct dw_hdmi_phy_config *phy_config;
167 int (*configure_phy)(struct dw_hdmi *hdmi, void *data,
168 unsigned long mpixelclock);
169
170 unsigned int disable_cec : 1;
171};
172
173struct dw_hdmi *dw_hdmi_probe(struct platform_device *pdev,
174 const struct dw_hdmi_plat_data *plat_data);
175void dw_hdmi_remove(struct dw_hdmi *hdmi);
176void dw_hdmi_unbind(struct dw_hdmi *hdmi);
177struct dw_hdmi *dw_hdmi_bind(struct platform_device *pdev,
178 struct drm_encoder *encoder,
179 const struct dw_hdmi_plat_data *plat_data);
180
181void dw_hdmi_resume(struct dw_hdmi *hdmi);
182
183void dw_hdmi_setup_rx_sense(struct dw_hdmi *hdmi, bool hpd, bool rx_sense);
184
185int dw_hdmi_set_plugged_cb(struct dw_hdmi *hdmi, hdmi_codec_plugged_cb fn,
186 struct device *codec_dev);
187void dw_hdmi_set_sample_non_pcm(struct dw_hdmi *hdmi, unsigned int non_pcm);
188void dw_hdmi_set_sample_iec958(struct dw_hdmi *hdmi, unsigned int iec958);
189void dw_hdmi_set_sample_width(struct dw_hdmi *hdmi, unsigned int width);
190void dw_hdmi_set_sample_rate(struct dw_hdmi *hdmi, unsigned int rate);
191void dw_hdmi_set_channel_count(struct dw_hdmi *hdmi, unsigned int cnt);
192void dw_hdmi_set_channel_status(struct dw_hdmi *hdmi, u8 *channel_status);
193void dw_hdmi_set_channel_allocation(struct dw_hdmi *hdmi, unsigned int ca);
194void dw_hdmi_audio_enable(struct dw_hdmi *hdmi);
195void dw_hdmi_audio_disable(struct dw_hdmi *hdmi);
196void dw_hdmi_set_high_tmds_clock_ratio(struct dw_hdmi *hdmi,
197 const struct drm_display_info *display);
198
199/* PHY configuration */
200void dw_hdmi_phy_i2c_set_addr(struct dw_hdmi *hdmi, u8 address);
201void dw_hdmi_phy_i2c_write(struct dw_hdmi *hdmi, unsigned short data,
202 unsigned char addr);
203
204void dw_hdmi_phy_gen1_reset(struct dw_hdmi *hdmi);
205
206void dw_hdmi_phy_gen2_pddq(struct dw_hdmi *hdmi, u8 enable);
207void dw_hdmi_phy_gen2_txpwron(struct dw_hdmi *hdmi, u8 enable);
208void dw_hdmi_phy_gen2_reset(struct dw_hdmi *hdmi);
209
210enum drm_connector_status dw_hdmi_phy_read_hpd(struct dw_hdmi *hdmi,
211 void *data);
212void dw_hdmi_phy_update_hpd(struct dw_hdmi *hdmi, void *data,
213 bool force, bool disabled, bool rxsense);
214void dw_hdmi_phy_setup_hpd(struct dw_hdmi *hdmi, void *data);
215
216bool dw_hdmi_bus_fmt_is_420(struct dw_hdmi *hdmi);
217
218const struct dw_hdmi_plat_data *dw_hdmi_to_plat_data(struct dw_hdmi *hdmi);
219
220#endif /* __IMX_HDMI_H__ */
221

source code of linux/include/drm/bridge/dw_hdmi.h