4 #include <drm/drm_connector.h>
6 #include <sound/dmaengine_pcm.h>
12 struct vc4_hdmi_register;
13 struct vc4_hdmi_connector_state;
15 enum vc4_hdmi_phy_channel {
22 struct vc4_hdmi_variant {
23 /* Encoder Type for that controller */
24 enum vc4_encoder_type encoder_type;
27 const char *card_name;
29 /* Filename to expose the registers in debugfs */
30 const char *debugfs_name;
32 /* Maximum pixel clock supported by the controller (in Hz) */
33 unsigned long long max_pixel_clock;
35 /* List of the registers available on that variant */
36 const struct vc4_hdmi_register *registers;
38 /* Number of registers on that variant */
39 unsigned int num_registers;
42 * The variants don't map the lane in the same order in the
43 * PHY, so this is an array mapping the HDMI channel (index)
44 * to the PHY lane (value).
46 enum vc4_hdmi_phy_channel phy_lane_mapping[4];
48 /* The BCM2711 cannot deal with odd horizontal pixel timings */
49 bool unsupported_odd_h_timings;
52 * The BCM2711 CEC/hotplug IRQ controller is shared between the
53 * two HDMI controllers, and we have a proper irqchip driver for
56 bool external_irq_controller;
58 /* Callback to get the resources (memory region, interrupts,
59 * clocks, etc) for that variant.
61 int (*init_resources)(struct drm_device *drm,
62 struct vc4_hdmi *vc4_hdmi);
64 /* Callback to reset the HDMI block */
65 void (*reset)(struct vc4_hdmi *vc4_hdmi);
67 /* Callback to enable / disable the CSC */
68 void (*csc_setup)(struct vc4_hdmi *vc4_hdmi,
69 struct drm_connector_state *state,
70 const struct drm_display_mode *mode);
72 /* Callback to configure the video timings in the HDMI block */
73 void (*set_timings)(struct vc4_hdmi *vc4_hdmi,
74 struct drm_connector_state *state,
75 struct drm_display_mode *mode);
77 /* Callback to initialize the PHY according to the connector state */
78 void (*phy_init)(struct vc4_hdmi *vc4_hdmi,
79 struct vc4_hdmi_connector_state *vc4_conn_state);
81 /* Callback to disable the PHY */
82 void (*phy_disable)(struct vc4_hdmi *vc4_hdmi);
84 /* Callback to enable the RNG in the PHY */
85 void (*phy_rng_enable)(struct vc4_hdmi *vc4_hdmi);
87 /* Callback to disable the RNG in the PHY */
88 void (*phy_rng_disable)(struct vc4_hdmi *vc4_hdmi);
90 /* Callback to get channel map */
91 u32 (*channel_map)(struct vc4_hdmi *vc4_hdmi, u32 channel_mask);
93 /* Enables HDR metadata */
96 /* Callback for hardware specific hotplug detect */
97 bool (*hp_detect)(struct vc4_hdmi *vc4_hdmi);
100 /* HDMI audio information */
101 struct vc4_hdmi_audio {
102 struct snd_soc_card card;
103 struct snd_soc_dai_link link;
104 struct snd_soc_dai_link_component cpu;
105 struct snd_soc_dai_link_component codec;
106 struct snd_soc_dai_link_component platform;
107 struct snd_dmaengine_dai_dma_data dma_data;
108 struct hdmi_audio_infoframe infoframe;
109 struct platform_device *codec_pdev;
113 enum vc4_hdmi_output_format {
115 VC4_HDMI_OUTPUT_YUV422,
116 VC4_HDMI_OUTPUT_YUV444,
117 VC4_HDMI_OUTPUT_YUV420,
120 /* General HDMI hardware state. */
122 struct vc4_hdmi_audio audio;
124 struct platform_device *pdev;
125 const struct vc4_hdmi_variant *variant;
127 struct vc4_encoder encoder;
128 struct drm_connector connector;
130 struct delayed_work scrambling_work;
132 struct drm_property *broadcast_rgb_property;
134 struct i2c_adapter *ddc;
135 void __iomem *hdmicore_regs;
136 void __iomem *hd_regs;
139 void __iomem *cec_regs;
141 void __iomem *csc_regs;
143 void __iomem *dvp_regs;
145 void __iomem *phy_regs;
147 void __iomem *ram_regs;
149 void __iomem *rm_regs;
151 struct gpio_desc *hpd_gpio;
154 * On some systems (like the RPi4), some modes are in the same
155 * frequency range than the WiFi channels (1440p@60Hz for
156 * example). Should we take evasive actions because that system
157 * has a wifi adapter?
159 bool disable_wifi_frequencies;
161 struct cec_adapter *cec_adap;
162 struct cec_msg cec_rx_msg;
166 struct clk *cec_clock;
167 struct clk *pixel_clock;
168 struct clk *hsm_clock;
169 struct clk *audio_clock;
170 struct clk *pixel_bvb_clock;
172 struct reset_control *reset;
174 struct debugfs_regset32 hdmi_regset;
175 struct debugfs_regset32 hd_regset;
178 * @hw_lock: Spinlock protecting device register access.
183 * @mutex: Mutex protecting the driver access across multiple
184 * frameworks (KMS, ALSA).
186 * NOTE: While supported, CEC has been left out since
187 * cec_s_phys_addr_from_edid() might call .adap_enable and lead to a
188 * reentrancy issue between .get_modes (or .detect) and .adap_enable.
189 * Since we don't share any state between the CEC hooks and KMS', it's
190 * not a big deal. The only trouble might come from updating the CEC
191 * clock divider which might be affected by a modeset, but CEC should
192 * be resilient to that.
197 * @saved_adjusted_mode: Copy of @drm_crtc_state.adjusted_mode
198 * for use by ALSA hooks and interrupt handlers. Protected by @mutex.
200 struct drm_display_mode saved_adjusted_mode;
203 * @output_enabled: Is the HDMI controller currently active?
204 * Protected by @mutex.
209 * @scdc_enabled: Is the HDMI controller currently running with
210 * the scrambler on? Protected by @mutex.
215 * @output_bpc: Copy of @vc4_connector_state.output_bpc for use
216 * outside of KMS hooks. Protected by @mutex.
218 unsigned int output_bpc;
221 * @output_format: Copy of @vc4_connector_state.output_format
222 * for use outside of KMS hooks. Protected by @mutex.
224 enum vc4_hdmi_output_format output_format;
227 * @broadcast_rgb: Copy of @vc4_connector_state.broadcast_rgb
228 * for use outside of KMS hooks. Protected by @mutex.
232 /* VC5 debugfs regset */
233 struct debugfs_regset32 cec_regset;
234 struct debugfs_regset32 csc_regset;
235 struct debugfs_regset32 dvp_regset;
236 struct debugfs_regset32 phy_regset;
237 struct debugfs_regset32 ram_regset;
238 struct debugfs_regset32 rm_regset;
241 static inline struct vc4_hdmi *
242 connector_to_vc4_hdmi(struct drm_connector *connector)
244 return container_of(connector, struct vc4_hdmi, connector);
247 static inline struct vc4_hdmi *
248 encoder_to_vc4_hdmi(struct drm_encoder *encoder)
250 struct vc4_encoder *_encoder = to_vc4_encoder(encoder);
251 return container_of(_encoder, struct vc4_hdmi, encoder);
254 struct vc4_hdmi_connector_state {
255 struct drm_connector_state base;
256 unsigned long long pixel_rate;
257 unsigned int output_bpc;
258 enum vc4_hdmi_output_format output_format;
262 static inline struct vc4_hdmi_connector_state *
263 conn_state_to_vc4_hdmi_conn_state(struct drm_connector_state *conn_state)
265 return container_of(conn_state, struct vc4_hdmi_connector_state, base);
268 static inline const struct vc4_hdmi_connector_state *
269 const_conn_state_to_vc4_hdmi_conn_state(const struct drm_connector_state *conn_state)
271 return container_of(conn_state, struct vc4_hdmi_connector_state, base);
274 void vc4_hdmi_phy_init(struct vc4_hdmi *vc4_hdmi,
275 struct vc4_hdmi_connector_state *vc4_conn_state);
276 void vc4_hdmi_phy_disable(struct vc4_hdmi *vc4_hdmi);
277 void vc4_hdmi_phy_rng_enable(struct vc4_hdmi *vc4_hdmi);
278 void vc4_hdmi_phy_rng_disable(struct vc4_hdmi *vc4_hdmi);
280 void vc5_hdmi_phy_init(struct vc4_hdmi *vc4_hdmi,
281 struct vc4_hdmi_connector_state *vc4_conn_state);
282 void vc5_hdmi_phy_disable(struct vc4_hdmi *vc4_hdmi);
283 void vc5_hdmi_phy_rng_enable(struct vc4_hdmi *vc4_hdmi);
284 void vc5_hdmi_phy_rng_disable(struct vc4_hdmi *vc4_hdmi);
286 #endif /* _VC4_HDMI_H_ */