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 const 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 {
114 VC4_HDMI_OUTPUT_AUTO,
116 VC4_HDMI_OUTPUT_YUV422,
117 VC4_HDMI_OUTPUT_YUV444,
118 VC4_HDMI_OUTPUT_YUV420,
121 /* General HDMI hardware state. */
123 struct vc4_hdmi_audio audio;
125 struct platform_device *pdev;
126 const struct vc4_hdmi_variant *variant;
128 struct vc4_encoder encoder;
129 struct drm_connector connector;
131 struct delayed_work scrambling_work;
133 struct drm_property *broadcast_rgb_property;
134 struct drm_property *output_format_property;
136 struct i2c_adapter *ddc;
137 void __iomem *hdmicore_regs;
138 void __iomem *hd_regs;
141 void __iomem *cec_regs;
143 void __iomem *csc_regs;
145 void __iomem *dvp_regs;
147 void __iomem *phy_regs;
149 void __iomem *ram_regs;
151 void __iomem *rm_regs;
153 struct gpio_desc *hpd_gpio;
156 * On some systems (like the RPi4), some modes are in the same
157 * frequency range than the WiFi channels (1440p@60Hz for
158 * example). Should we take evasive actions because that system
159 * has a wifi adapter?
161 bool disable_wifi_frequencies;
163 struct cec_adapter *cec_adap;
164 struct cec_msg cec_rx_msg;
168 struct clk *cec_clock;
169 struct clk *pixel_clock;
170 struct clk *hsm_clock;
171 struct clk *audio_clock;
172 struct clk *pixel_bvb_clock;
174 struct reset_control *reset;
176 struct debugfs_regset32 hdmi_regset;
177 struct debugfs_regset32 hd_regset;
180 * @hw_lock: Spinlock protecting device register access.
185 * @mutex: Mutex protecting the driver access across multiple
186 * frameworks (KMS, ALSA, CEC).
191 * @saved_adjusted_mode: Copy of @drm_crtc_state.adjusted_mode
192 * for use by ALSA hooks and interrupt handlers. Protected by @mutex.
194 struct drm_display_mode saved_adjusted_mode;
197 * @output_enabled: Is the HDMI controller currently active?
198 * Protected by @mutex.
203 * @scdc_enabled: Is the HDMI controller currently running with
204 * the scrambler on? Protected by @mutex.
209 * @output_bpc: Copy of @vc4_connector_state.output_bpc for use
210 * outside of KMS hooks. Protected by @mutex.
212 unsigned int output_bpc;
215 * @output_format: Copy of @vc4_connector_state.output_format
216 * for use outside of KMS hooks. Protected by @mutex.
218 enum vc4_hdmi_output_format output_format;
220 * @requested_output_format: Copy of @vc4_connector_state.requested_output_format
221 * for use outside of KMS hooks. Protected by @mutex.
223 enum vc4_hdmi_output_format requested_output_format;
226 * @broadcast_rgb: Copy of @vc4_connector_state.broadcast_rgb
227 * for use outside of KMS hooks. Protected by @mutex.
231 /* VC5 debugfs regset */
232 struct debugfs_regset32 cec_regset;
233 struct debugfs_regset32 csc_regset;
234 struct debugfs_regset32 dvp_regset;
235 struct debugfs_regset32 phy_regset;
236 struct debugfs_regset32 ram_regset;
237 struct debugfs_regset32 rm_regset;
240 static inline struct vc4_hdmi *
241 connector_to_vc4_hdmi(struct drm_connector *connector)
243 return container_of(connector, struct vc4_hdmi, connector);
246 static inline struct vc4_hdmi *
247 encoder_to_vc4_hdmi(struct drm_encoder *encoder)
249 struct vc4_encoder *_encoder = to_vc4_encoder(encoder);
250 return container_of(_encoder, struct vc4_hdmi, encoder);
253 struct vc4_hdmi_connector_state {
254 struct drm_connector_state base;
255 unsigned long long pixel_rate;
256 unsigned int output_bpc;
257 enum vc4_hdmi_output_format output_format;
258 enum vc4_hdmi_output_format requested_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_ */