1/*
2 * Copyright © 2014 Intel Corporation
3 *
4 * Permission is hereby granted, free of charge, to any person obtaining a
5 * copy of this software and associated documentation files (the "Software"),
6 * to deal in the Software without restriction, including without limitation
7 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
8 * and/or sell copies of the Software, and to permit persons to whom the
9 * Software is furnished to do so, subject to the following conditions:
10 *
11 * The above copyright notice and this permission notice (including the next
12 * paragraph) shall be included in all copies or substantial portions of the
13 * Software.
14 *
15 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
18 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
20 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
21 * DEALINGS IN THE SOFTWARE.
22 */
23
24#include <linux/kernel.h>
25#include <linux/component.h>
26#include <drm/i915_component.h>
27#include "intel_drv.h"
28
29#include <drm/drmP.h>
30#include <drm/drm_edid.h>
31#include "intel_drv.h"
32#include "i915_drv.h"
33
34/**
35 * DOC: High Definition Audio over HDMI and Display Port
36 *
37 * The graphics and audio drivers together support High Definition Audio over
38 * HDMI and Display Port. The audio programming sequences are divided into audio
39 * codec and controller enable and disable sequences. The graphics driver
40 * handles the audio codec sequences, while the audio driver handles the audio
41 * controller sequences.
42 *
43 * The disable sequences must be performed before disabling the transcoder or
44 * port. The enable sequences may only be performed after enabling the
45 * transcoder and port, and after completed link training.
46 *
47 * The codec and controller sequences could be done either parallel or serial,
48 * but generally the ELDV/PD change in the codec sequence indicates to the audio
49 * driver that the controller sequence should start. Indeed, most of the
50 * co-operation between the graphics and audio drivers is handled via audio
51 * related registers. (The notable exception is the power management, not
52 * covered here.)
53 */
54
55static const struct {
56	int clock;
57	u32 config;
58} hdmi_audio_clock[] = {
59	{ DIV_ROUND_UP(25200 * 1000, 1001), AUD_CONFIG_PIXEL_CLOCK_HDMI_25175 },
60	{ 25200, AUD_CONFIG_PIXEL_CLOCK_HDMI_25200 }, /* default per bspec */
61	{ 27000, AUD_CONFIG_PIXEL_CLOCK_HDMI_27000 },
62	{ 27000 * 1001 / 1000, AUD_CONFIG_PIXEL_CLOCK_HDMI_27027 },
63	{ 54000, AUD_CONFIG_PIXEL_CLOCK_HDMI_54000 },
64	{ 54000 * 1001 / 1000, AUD_CONFIG_PIXEL_CLOCK_HDMI_54054 },
65	{ DIV_ROUND_UP(74250 * 1000, 1001), AUD_CONFIG_PIXEL_CLOCK_HDMI_74176 },
66	{ 74250, AUD_CONFIG_PIXEL_CLOCK_HDMI_74250 },
67	{ DIV_ROUND_UP(148500 * 1000, 1001), AUD_CONFIG_PIXEL_CLOCK_HDMI_148352 },
68	{ 148500, AUD_CONFIG_PIXEL_CLOCK_HDMI_148500 },
69};
70
71/* get AUD_CONFIG_PIXEL_CLOCK_HDMI_* value for mode */
72static u32 audio_config_hdmi_pixel_clock(struct drm_display_mode *mode)
73{
74	int i;
75
76	for (i = 0; i < ARRAY_SIZE(hdmi_audio_clock); i++) {
77		if (mode->clock == hdmi_audio_clock[i].clock)
78			break;
79	}
80
81	if (i == ARRAY_SIZE(hdmi_audio_clock)) {
82		DRM_DEBUG_KMS("HDMI audio pixel clock setting for %d not found, falling back to defaults\n", mode->clock);
83		i = 1;
84	}
85
86	DRM_DEBUG_KMS("Configuring HDMI audio for pixel clock %d (0x%08x)\n",
87		      hdmi_audio_clock[i].clock,
88		      hdmi_audio_clock[i].config);
89
90	return hdmi_audio_clock[i].config;
91}
92
93static bool intel_eld_uptodate(struct drm_connector *connector,
94			       int reg_eldv, uint32_t bits_eldv,
95			       int reg_elda, uint32_t bits_elda,
96			       int reg_edid)
97{
98	struct drm_i915_private *dev_priv = connector->dev->dev_private;
99	uint8_t *eld = connector->eld;
100	uint32_t tmp;
101	int i;
102
103	tmp = I915_READ(reg_eldv);
104	tmp &= bits_eldv;
105
106	if (!tmp)
107		return false;
108
109	tmp = I915_READ(reg_elda);
110	tmp &= ~bits_elda;
111	I915_WRITE(reg_elda, tmp);
112
113	for (i = 0; i < drm_eld_size(eld) / 4; i++)
114		if (I915_READ(reg_edid) != *((uint32_t *)eld + i))
115			return false;
116
117	return true;
118}
119
120static void g4x_audio_codec_disable(struct intel_encoder *encoder)
121{
122	struct drm_i915_private *dev_priv = encoder->base.dev->dev_private;
123	uint32_t eldv, tmp;
124
125	DRM_DEBUG_KMS("Disable audio codec\n");
126
127	tmp = I915_READ(G4X_AUD_VID_DID);
128	if (tmp == INTEL_AUDIO_DEVBLC || tmp == INTEL_AUDIO_DEVCL)
129		eldv = G4X_ELDV_DEVCL_DEVBLC;
130	else
131		eldv = G4X_ELDV_DEVCTG;
132
133	/* Invalidate ELD */
134	tmp = I915_READ(G4X_AUD_CNTL_ST);
135	tmp &= ~eldv;
136	I915_WRITE(G4X_AUD_CNTL_ST, tmp);
137}
138
139static void g4x_audio_codec_enable(struct drm_connector *connector,
140				   struct intel_encoder *encoder,
141				   struct drm_display_mode *mode)
142{
143	struct drm_i915_private *dev_priv = connector->dev->dev_private;
144	uint8_t *eld = connector->eld;
145	uint32_t eldv;
146	uint32_t tmp;
147	int len, i;
148
149	DRM_DEBUG_KMS("Enable audio codec, %u bytes ELD\n", eld[2]);
150
151	tmp = I915_READ(G4X_AUD_VID_DID);
152	if (tmp == INTEL_AUDIO_DEVBLC || tmp == INTEL_AUDIO_DEVCL)
153		eldv = G4X_ELDV_DEVCL_DEVBLC;
154	else
155		eldv = G4X_ELDV_DEVCTG;
156
157	if (intel_eld_uptodate(connector,
158			       G4X_AUD_CNTL_ST, eldv,
159			       G4X_AUD_CNTL_ST, G4X_ELD_ADDR_MASK,
160			       G4X_HDMIW_HDMIEDID))
161		return;
162
163	tmp = I915_READ(G4X_AUD_CNTL_ST);
164	tmp &= ~(eldv | G4X_ELD_ADDR_MASK);
165	len = (tmp >> 9) & 0x1f;		/* ELD buffer size */
166	I915_WRITE(G4X_AUD_CNTL_ST, tmp);
167
168	len = min(drm_eld_size(eld) / 4, len);
169	DRM_DEBUG_DRIVER("ELD size %d\n", len);
170	for (i = 0; i < len; i++)
171		I915_WRITE(G4X_HDMIW_HDMIEDID, *((uint32_t *)eld + i));
172
173	tmp = I915_READ(G4X_AUD_CNTL_ST);
174	tmp |= eldv;
175	I915_WRITE(G4X_AUD_CNTL_ST, tmp);
176}
177
178static void hsw_audio_codec_disable(struct intel_encoder *encoder)
179{
180	struct drm_i915_private *dev_priv = encoder->base.dev->dev_private;
181	struct intel_crtc *intel_crtc = to_intel_crtc(encoder->base.crtc);
182	enum pipe pipe = intel_crtc->pipe;
183	uint32_t tmp;
184
185	DRM_DEBUG_KMS("Disable audio codec on pipe %c\n", pipe_name(pipe));
186
187	/* Disable timestamps */
188	tmp = I915_READ(HSW_AUD_CFG(pipe));
189	tmp &= ~AUD_CONFIG_N_VALUE_INDEX;
190	tmp |= AUD_CONFIG_N_PROG_ENABLE;
191	tmp &= ~AUD_CONFIG_UPPER_N_MASK;
192	tmp &= ~AUD_CONFIG_LOWER_N_MASK;
193	if (intel_pipe_has_type(intel_crtc, INTEL_OUTPUT_DISPLAYPORT))
194		tmp |= AUD_CONFIG_N_VALUE_INDEX;
195	I915_WRITE(HSW_AUD_CFG(pipe), tmp);
196
197	/* Invalidate ELD */
198	tmp = I915_READ(HSW_AUD_PIN_ELD_CP_VLD);
199	tmp &= ~AUDIO_ELD_VALID(pipe);
200	tmp &= ~AUDIO_OUTPUT_ENABLE(pipe);
201	I915_WRITE(HSW_AUD_PIN_ELD_CP_VLD, tmp);
202}
203
204static void hsw_audio_codec_enable(struct drm_connector *connector,
205				   struct intel_encoder *encoder,
206				   struct drm_display_mode *mode)
207{
208	struct drm_i915_private *dev_priv = connector->dev->dev_private;
209	struct intel_crtc *intel_crtc = to_intel_crtc(encoder->base.crtc);
210	enum pipe pipe = intel_crtc->pipe;
211	const uint8_t *eld = connector->eld;
212	uint32_t tmp;
213	int len, i;
214
215	DRM_DEBUG_KMS("Enable audio codec on pipe %c, %u bytes ELD\n",
216		      pipe_name(pipe), drm_eld_size(eld));
217
218	/* Enable audio presence detect, invalidate ELD */
219	tmp = I915_READ(HSW_AUD_PIN_ELD_CP_VLD);
220	tmp |= AUDIO_OUTPUT_ENABLE(pipe);
221	tmp &= ~AUDIO_ELD_VALID(pipe);
222	I915_WRITE(HSW_AUD_PIN_ELD_CP_VLD, tmp);
223
224	/*
225	 * FIXME: We're supposed to wait for vblank here, but we have vblanks
226	 * disabled during the mode set. The proper fix would be to push the
227	 * rest of the setup into a vblank work item, queued here, but the
228	 * infrastructure is not there yet.
229	 */
230
231	/* Reset ELD write address */
232	tmp = I915_READ(HSW_AUD_DIP_ELD_CTRL(pipe));
233	tmp &= ~IBX_ELD_ADDRESS_MASK;
234	I915_WRITE(HSW_AUD_DIP_ELD_CTRL(pipe), tmp);
235
236	/* Up to 84 bytes of hw ELD buffer */
237	len = min(drm_eld_size(eld), 84);
238	for (i = 0; i < len / 4; i++)
239		I915_WRITE(HSW_AUD_EDID_DATA(pipe), *((uint32_t *)eld + i));
240
241	/* ELD valid */
242	tmp = I915_READ(HSW_AUD_PIN_ELD_CP_VLD);
243	tmp |= AUDIO_ELD_VALID(pipe);
244	I915_WRITE(HSW_AUD_PIN_ELD_CP_VLD, tmp);
245
246	/* Enable timestamps */
247	tmp = I915_READ(HSW_AUD_CFG(pipe));
248	tmp &= ~AUD_CONFIG_N_VALUE_INDEX;
249	tmp &= ~AUD_CONFIG_N_PROG_ENABLE;
250	tmp &= ~AUD_CONFIG_PIXEL_CLOCK_HDMI_MASK;
251	if (intel_pipe_has_type(intel_crtc, INTEL_OUTPUT_DISPLAYPORT))
252		tmp |= AUD_CONFIG_N_VALUE_INDEX;
253	else
254		tmp |= audio_config_hdmi_pixel_clock(mode);
255	I915_WRITE(HSW_AUD_CFG(pipe), tmp);
256}
257
258static void ilk_audio_codec_disable(struct intel_encoder *encoder)
259{
260	struct drm_i915_private *dev_priv = encoder->base.dev->dev_private;
261	struct intel_crtc *intel_crtc = to_intel_crtc(encoder->base.crtc);
262	struct intel_digital_port *intel_dig_port =
263		enc_to_dig_port(&encoder->base);
264	enum port port = intel_dig_port->port;
265	enum pipe pipe = intel_crtc->pipe;
266	uint32_t tmp, eldv;
267	int aud_config;
268	int aud_cntrl_st2;
269
270	DRM_DEBUG_KMS("Disable audio codec on port %c, pipe %c\n",
271		      port_name(port), pipe_name(pipe));
272
273	if (HAS_PCH_IBX(dev_priv->dev)) {
274		aud_config = IBX_AUD_CFG(pipe);
275		aud_cntrl_st2 = IBX_AUD_CNTL_ST2;
276	} else if (IS_VALLEYVIEW(dev_priv)) {
277		aud_config = VLV_AUD_CFG(pipe);
278		aud_cntrl_st2 = VLV_AUD_CNTL_ST2;
279	} else {
280		aud_config = CPT_AUD_CFG(pipe);
281		aud_cntrl_st2 = CPT_AUD_CNTRL_ST2;
282	}
283
284	/* Disable timestamps */
285	tmp = I915_READ(aud_config);
286	tmp &= ~AUD_CONFIG_N_VALUE_INDEX;
287	tmp |= AUD_CONFIG_N_PROG_ENABLE;
288	tmp &= ~AUD_CONFIG_UPPER_N_MASK;
289	tmp &= ~AUD_CONFIG_LOWER_N_MASK;
290	if (intel_pipe_has_type(intel_crtc, INTEL_OUTPUT_DISPLAYPORT))
291		tmp |= AUD_CONFIG_N_VALUE_INDEX;
292	I915_WRITE(aud_config, tmp);
293
294	if (WARN_ON(!port)) {
295		eldv = IBX_ELD_VALID(PORT_B) | IBX_ELD_VALID(PORT_C) |
296			IBX_ELD_VALID(PORT_D);
297	} else {
298		eldv = IBX_ELD_VALID(port);
299	}
300
301	/* Invalidate ELD */
302	tmp = I915_READ(aud_cntrl_st2);
303	tmp &= ~eldv;
304	I915_WRITE(aud_cntrl_st2, tmp);
305}
306
307static void ilk_audio_codec_enable(struct drm_connector *connector,
308				   struct intel_encoder *encoder,
309				   struct drm_display_mode *mode)
310{
311	struct drm_i915_private *dev_priv = connector->dev->dev_private;
312	struct intel_crtc *intel_crtc = to_intel_crtc(encoder->base.crtc);
313	struct intel_digital_port *intel_dig_port =
314		enc_to_dig_port(&encoder->base);
315	enum port port = intel_dig_port->port;
316	enum pipe pipe = intel_crtc->pipe;
317	uint8_t *eld = connector->eld;
318	uint32_t eldv;
319	uint32_t tmp;
320	int len, i;
321	int hdmiw_hdmiedid;
322	int aud_config;
323	int aud_cntl_st;
324	int aud_cntrl_st2;
325
326	DRM_DEBUG_KMS("Enable audio codec on port %c, pipe %c, %u bytes ELD\n",
327		      port_name(port), pipe_name(pipe), drm_eld_size(eld));
328
329	/*
330	 * FIXME: We're supposed to wait for vblank here, but we have vblanks
331	 * disabled during the mode set. The proper fix would be to push the
332	 * rest of the setup into a vblank work item, queued here, but the
333	 * infrastructure is not there yet.
334	 */
335
336	if (HAS_PCH_IBX(connector->dev)) {
337		hdmiw_hdmiedid = IBX_HDMIW_HDMIEDID(pipe);
338		aud_config = IBX_AUD_CFG(pipe);
339		aud_cntl_st = IBX_AUD_CNTL_ST(pipe);
340		aud_cntrl_st2 = IBX_AUD_CNTL_ST2;
341	} else if (IS_VALLEYVIEW(connector->dev)) {
342		hdmiw_hdmiedid = VLV_HDMIW_HDMIEDID(pipe);
343		aud_config = VLV_AUD_CFG(pipe);
344		aud_cntl_st = VLV_AUD_CNTL_ST(pipe);
345		aud_cntrl_st2 = VLV_AUD_CNTL_ST2;
346	} else {
347		hdmiw_hdmiedid = CPT_HDMIW_HDMIEDID(pipe);
348		aud_config = CPT_AUD_CFG(pipe);
349		aud_cntl_st = CPT_AUD_CNTL_ST(pipe);
350		aud_cntrl_st2 = CPT_AUD_CNTRL_ST2;
351	}
352
353	if (WARN_ON(!port)) {
354		eldv = IBX_ELD_VALID(PORT_B) | IBX_ELD_VALID(PORT_C) |
355			IBX_ELD_VALID(PORT_D);
356	} else {
357		eldv = IBX_ELD_VALID(port);
358	}
359
360	/* Invalidate ELD */
361	tmp = I915_READ(aud_cntrl_st2);
362	tmp &= ~eldv;
363	I915_WRITE(aud_cntrl_st2, tmp);
364
365	/* Reset ELD write address */
366	tmp = I915_READ(aud_cntl_st);
367	tmp &= ~IBX_ELD_ADDRESS_MASK;
368	I915_WRITE(aud_cntl_st, tmp);
369
370	/* Up to 84 bytes of hw ELD buffer */
371	len = min(drm_eld_size(eld), 84);
372	for (i = 0; i < len / 4; i++)
373		I915_WRITE(hdmiw_hdmiedid, *((uint32_t *)eld + i));
374
375	/* ELD valid */
376	tmp = I915_READ(aud_cntrl_st2);
377	tmp |= eldv;
378	I915_WRITE(aud_cntrl_st2, tmp);
379
380	/* Enable timestamps */
381	tmp = I915_READ(aud_config);
382	tmp &= ~AUD_CONFIG_N_VALUE_INDEX;
383	tmp &= ~AUD_CONFIG_N_PROG_ENABLE;
384	tmp &= ~AUD_CONFIG_PIXEL_CLOCK_HDMI_MASK;
385	if (intel_pipe_has_type(intel_crtc, INTEL_OUTPUT_DISPLAYPORT))
386		tmp |= AUD_CONFIG_N_VALUE_INDEX;
387	else
388		tmp |= audio_config_hdmi_pixel_clock(mode);
389	I915_WRITE(aud_config, tmp);
390}
391
392/**
393 * intel_audio_codec_enable - Enable the audio codec for HD audio
394 * @intel_encoder: encoder on which to enable audio
395 *
396 * The enable sequences may only be performed after enabling the transcoder and
397 * port, and after completed link training.
398 */
399void intel_audio_codec_enable(struct intel_encoder *intel_encoder)
400{
401	struct drm_encoder *encoder = &intel_encoder->base;
402	struct intel_crtc *crtc = to_intel_crtc(encoder->crtc);
403	struct drm_display_mode *mode = &crtc->config->base.adjusted_mode;
404	struct drm_connector *connector;
405	struct drm_device *dev = encoder->dev;
406	struct drm_i915_private *dev_priv = dev->dev_private;
407
408	connector = drm_select_eld(encoder, mode);
409	if (!connector)
410		return;
411
412	DRM_DEBUG_DRIVER("ELD on [CONNECTOR:%d:%s], [ENCODER:%d:%s]\n",
413			 connector->base.id,
414			 connector->name,
415			 connector->encoder->base.id,
416			 connector->encoder->name);
417
418	/* ELD Conn_Type */
419	connector->eld[5] &= ~(3 << 2);
420	if (intel_pipe_has_type(crtc, INTEL_OUTPUT_DISPLAYPORT))
421		connector->eld[5] |= (1 << 2);
422
423	connector->eld[6] = drm_av_sync_delay(connector, mode) / 2;
424
425	if (dev_priv->display.audio_codec_enable)
426		dev_priv->display.audio_codec_enable(connector, intel_encoder, mode);
427}
428
429/**
430 * intel_audio_codec_disable - Disable the audio codec for HD audio
431 * @encoder: encoder on which to disable audio
432 *
433 * The disable sequences must be performed before disabling the transcoder or
434 * port.
435 */
436void intel_audio_codec_disable(struct intel_encoder *encoder)
437{
438	struct drm_device *dev = encoder->base.dev;
439	struct drm_i915_private *dev_priv = dev->dev_private;
440
441	if (dev_priv->display.audio_codec_disable)
442		dev_priv->display.audio_codec_disable(encoder);
443}
444
445/**
446 * intel_init_audio - Set up chip specific audio functions
447 * @dev: drm device
448 */
449void intel_init_audio(struct drm_device *dev)
450{
451	struct drm_i915_private *dev_priv = dev->dev_private;
452
453	if (IS_G4X(dev)) {
454		dev_priv->display.audio_codec_enable = g4x_audio_codec_enable;
455		dev_priv->display.audio_codec_disable = g4x_audio_codec_disable;
456	} else if (IS_VALLEYVIEW(dev)) {
457		dev_priv->display.audio_codec_enable = ilk_audio_codec_enable;
458		dev_priv->display.audio_codec_disable = ilk_audio_codec_disable;
459	} else if (IS_HASWELL(dev) || INTEL_INFO(dev)->gen >= 8) {
460		dev_priv->display.audio_codec_enable = hsw_audio_codec_enable;
461		dev_priv->display.audio_codec_disable = hsw_audio_codec_disable;
462	} else if (HAS_PCH_SPLIT(dev)) {
463		dev_priv->display.audio_codec_enable = ilk_audio_codec_enable;
464		dev_priv->display.audio_codec_disable = ilk_audio_codec_disable;
465	}
466}
467
468static void i915_audio_component_get_power(struct device *dev)
469{
470	intel_display_power_get(dev_to_i915(dev), POWER_DOMAIN_AUDIO);
471}
472
473static void i915_audio_component_put_power(struct device *dev)
474{
475	intel_display_power_put(dev_to_i915(dev), POWER_DOMAIN_AUDIO);
476}
477
478/* Get CDCLK in kHz  */
479static int i915_audio_component_get_cdclk_freq(struct device *dev)
480{
481	struct drm_i915_private *dev_priv = dev_to_i915(dev);
482	int ret;
483
484	if (WARN_ON_ONCE(!HAS_DDI(dev_priv)))
485		return -ENODEV;
486
487	intel_display_power_get(dev_priv, POWER_DOMAIN_AUDIO);
488	ret = intel_ddi_get_cdclk_freq(dev_priv);
489	intel_display_power_put(dev_priv, POWER_DOMAIN_AUDIO);
490
491	return ret;
492}
493
494static const struct i915_audio_component_ops i915_audio_component_ops = {
495	.owner		= THIS_MODULE,
496	.get_power	= i915_audio_component_get_power,
497	.put_power	= i915_audio_component_put_power,
498	.get_cdclk_freq	= i915_audio_component_get_cdclk_freq,
499};
500
501static int i915_audio_component_bind(struct device *i915_dev,
502				     struct device *hda_dev, void *data)
503{
504	struct i915_audio_component *acomp = data;
505
506	if (WARN_ON(acomp->ops || acomp->dev))
507		return -EEXIST;
508
509	acomp->ops = &i915_audio_component_ops;
510	acomp->dev = i915_dev;
511
512	return 0;
513}
514
515static void i915_audio_component_unbind(struct device *i915_dev,
516					struct device *hda_dev, void *data)
517{
518	struct i915_audio_component *acomp = data;
519
520	acomp->ops = NULL;
521	acomp->dev = NULL;
522}
523
524static const struct component_ops i915_audio_component_bind_ops = {
525	.bind	= i915_audio_component_bind,
526	.unbind	= i915_audio_component_unbind,
527};
528
529/**
530 * i915_audio_component_init - initialize and register the audio component
531 * @dev_priv: i915 device instance
532 *
533 * This will register with the component framework a child component which
534 * will bind dynamically to the snd_hda_intel driver's corresponding master
535 * component when the latter is registered. During binding the child
536 * initializes an instance of struct i915_audio_component which it receives
537 * from the master. The master can then start to use the interface defined by
538 * this struct. Each side can break the binding at any point by deregistering
539 * its own component after which each side's component unbind callback is
540 * called.
541 *
542 * We ignore any error during registration and continue with reduced
543 * functionality (i.e. without HDMI audio).
544 */
545void i915_audio_component_init(struct drm_i915_private *dev_priv)
546{
547	int ret;
548
549	ret = component_add(dev_priv->dev->dev, &i915_audio_component_bind_ops);
550	if (ret < 0) {
551		DRM_ERROR("failed to add audio component (%d)\n", ret);
552		/* continue with reduced functionality */
553		return;
554	}
555
556	dev_priv->audio_component_registered = true;
557}
558
559/**
560 * i915_audio_component_cleanup - deregister the audio component
561 * @dev_priv: i915 device instance
562 *
563 * Deregisters the audio component, breaking any existing binding to the
564 * corresponding snd_hda_intel driver's master component.
565 */
566void i915_audio_component_cleanup(struct drm_i915_private *dev_priv)
567{
568	if (!dev_priv->audio_component_registered)
569		return;
570
571	component_del(dev_priv->dev->dev, &i915_audio_component_bind_ops);
572	dev_priv->audio_component_registered = false;
573}
574