xref: /linux/sound/pci/hda/hda_jack.c (revision b43ab901d671e3e3cad425ea5e9a3c74e266dcdd)
1 /*
2  * Jack-detection handling for HD-audio
3  *
4  * Copyright (c) 2011 Takashi Iwai <tiwai@suse.de>
5  *
6  * This driver is free software; you can redistribute it and/or modify
7  * it under the terms of the GNU General Public License as published by
8  * the Free Software Foundation; either version 2 of the License, or
9  * (at your option) any later version.
10  */
11 
12 #include <linux/init.h>
13 #include <linux/slab.h>
14 #include <linux/export.h>
15 #include <sound/core.h>
16 #include <sound/control.h>
17 #include <sound/jack.h>
18 #include "hda_codec.h"
19 #include "hda_local.h"
20 #include "hda_jack.h"
21 
22 /* execute pin sense measurement */
23 static u32 read_pin_sense(struct hda_codec *codec, hda_nid_t nid)
24 {
25 	u32 pincap;
26 
27 	if (!codec->no_trigger_sense) {
28 		pincap = snd_hda_query_pin_caps(codec, nid);
29 		if (pincap & AC_PINCAP_TRIG_REQ) /* need trigger? */
30 			snd_hda_codec_read(codec, nid, 0,
31 					AC_VERB_SET_PIN_SENSE, 0);
32 	}
33 	return snd_hda_codec_read(codec, nid, 0,
34 				  AC_VERB_GET_PIN_SENSE, 0);
35 }
36 
37 /**
38  * snd_hda_jack_tbl_get - query the jack-table entry for the given NID
39  */
40 struct hda_jack_tbl *
41 snd_hda_jack_tbl_get(struct hda_codec *codec, hda_nid_t nid)
42 {
43 	struct hda_jack_tbl *jack = codec->jacktbl.list;
44 	int i;
45 
46 	if (!nid || !jack)
47 		return NULL;
48 	for (i = 0; i < codec->jacktbl.used; i++, jack++)
49 		if (jack->nid == nid)
50 			return jack;
51 	return NULL;
52 }
53 EXPORT_SYMBOL_HDA(snd_hda_jack_tbl_get);
54 
55 /**
56  * snd_hda_jack_tbl_get_from_tag - query the jack-table entry for the given tag
57  */
58 struct hda_jack_tbl *
59 snd_hda_jack_tbl_get_from_tag(struct hda_codec *codec, unsigned char tag)
60 {
61 	struct hda_jack_tbl *jack = codec->jacktbl.list;
62 	int i;
63 
64 	if (!tag || !jack)
65 		return NULL;
66 	for (i = 0; i < codec->jacktbl.used; i++, jack++)
67 		if (jack->tag == tag)
68 			return jack;
69 	return NULL;
70 }
71 EXPORT_SYMBOL_HDA(snd_hda_jack_tbl_get_from_tag);
72 
73 /**
74  * snd_hda_jack_tbl_new - create a jack-table entry for the given NID
75  */
76 struct hda_jack_tbl *
77 snd_hda_jack_tbl_new(struct hda_codec *codec, hda_nid_t nid)
78 {
79 	struct hda_jack_tbl *jack = snd_hda_jack_tbl_get(codec, nid);
80 	if (jack)
81 		return jack;
82 	snd_array_init(&codec->jacktbl, sizeof(*jack), 16);
83 	jack = snd_array_new(&codec->jacktbl);
84 	if (!jack)
85 		return NULL;
86 	jack->nid = nid;
87 	jack->jack_dirty = 1;
88 	jack->tag = codec->jacktbl.used;
89 	return jack;
90 }
91 EXPORT_SYMBOL_HDA(snd_hda_jack_tbl_new);
92 
93 void snd_hda_jack_tbl_clear(struct hda_codec *codec)
94 {
95 #ifdef CONFIG_SND_HDA_INPUT_JACK
96 	/* free jack instances manually when clearing/reconfiguring */
97 	if (!codec->bus->shutdown && codec->jacktbl.list) {
98 		struct hda_jack_tbl *jack = codec->jacktbl.list;
99 		int i;
100 		for (i = 0; i < codec->jacktbl.used; i++, jack++) {
101 			if (jack->jack)
102 				snd_device_free(codec->bus->card, jack->jack);
103 		}
104 	}
105 #endif
106 	snd_array_free(&codec->jacktbl);
107 }
108 
109 /* update the cached value and notification flag if needed */
110 static void jack_detect_update(struct hda_codec *codec,
111 			       struct hda_jack_tbl *jack)
112 {
113 	if (jack->jack_dirty || !jack->jack_detect) {
114 		jack->pin_sense = read_pin_sense(codec, jack->nid);
115 		jack->jack_dirty = 0;
116 	}
117 }
118 
119 /**
120  * snd_hda_set_dirty_all - Mark all the cached as dirty
121  *
122  * This function sets the dirty flag to all entries of jack table.
123  * It's called from the resume path in hda_codec.c.
124  */
125 void snd_hda_jack_set_dirty_all(struct hda_codec *codec)
126 {
127 	struct hda_jack_tbl *jack = codec->jacktbl.list;
128 	int i;
129 
130 	for (i = 0; i < codec->jacktbl.used; i++, jack++)
131 		if (jack->nid)
132 			jack->jack_dirty = 1;
133 }
134 EXPORT_SYMBOL_HDA(snd_hda_jack_set_dirty_all);
135 
136 /**
137  * snd_hda_pin_sense - execute pin sense measurement
138  * @codec: the CODEC to sense
139  * @nid: the pin NID to sense
140  *
141  * Execute necessary pin sense measurement and return its Presence Detect,
142  * Impedance, ELD Valid etc. status bits.
143  */
144 u32 snd_hda_pin_sense(struct hda_codec *codec, hda_nid_t nid)
145 {
146 	struct hda_jack_tbl *jack = snd_hda_jack_tbl_get(codec, nid);
147 	if (jack) {
148 		jack_detect_update(codec, jack);
149 		return jack->pin_sense;
150 	}
151 	return read_pin_sense(codec, nid);
152 }
153 EXPORT_SYMBOL_HDA(snd_hda_pin_sense);
154 
155 #define get_jack_plug_state(sense) !!(sense & AC_PINSENSE_PRESENCE)
156 
157 /**
158  * snd_hda_jack_detect - query pin Presence Detect status
159  * @codec: the CODEC to sense
160  * @nid: the pin NID to sense
161  *
162  * Query and return the pin's Presence Detect status.
163  */
164 int snd_hda_jack_detect(struct hda_codec *codec, hda_nid_t nid)
165 {
166 	u32 sense = snd_hda_pin_sense(codec, nid);
167 	return get_jack_plug_state(sense);
168 }
169 EXPORT_SYMBOL_HDA(snd_hda_jack_detect);
170 
171 /**
172  * snd_hda_jack_detect_enable - enable the jack-detection
173  */
174 int snd_hda_jack_detect_enable(struct hda_codec *codec, hda_nid_t nid,
175 			       unsigned char action)
176 {
177 	struct hda_jack_tbl *jack = snd_hda_jack_tbl_new(codec, nid);
178 	if (!jack)
179 		return -ENOMEM;
180 	if (jack->jack_detect)
181 		return 0; /* already registered */
182 	jack->jack_detect = 1;
183 	if (action)
184 		jack->action = action;
185 	return snd_hda_codec_write_cache(codec, nid, 0,
186 					 AC_VERB_SET_UNSOLICITED_ENABLE,
187 					 AC_USRSP_EN | jack->tag);
188 }
189 EXPORT_SYMBOL_HDA(snd_hda_jack_detect_enable);
190 
191 /**
192  * snd_hda_jack_report_sync - sync the states of all jacks and report if changed
193  */
194 void snd_hda_jack_report_sync(struct hda_codec *codec)
195 {
196 	struct hda_jack_tbl *jack = codec->jacktbl.list;
197 	int i, state;
198 
199 	for (i = 0; i < codec->jacktbl.used; i++, jack++)
200 		if (jack->nid) {
201 			jack_detect_update(codec, jack);
202 			if (!jack->kctl)
203 				continue;
204 			state = get_jack_plug_state(jack->pin_sense);
205 			snd_kctl_jack_report(codec->bus->card, jack->kctl, state);
206 #ifdef CONFIG_SND_HDA_INPUT_JACK
207 			if (jack->jack)
208 				snd_jack_report(jack->jack,
209 						state ? jack->type : 0);
210 #endif
211 		}
212 }
213 EXPORT_SYMBOL_HDA(snd_hda_jack_report_sync);
214 
215 #ifdef CONFIG_SND_HDA_INPUT_JACK
216 /* guess the jack type from the pin-config */
217 static int get_input_jack_type(struct hda_codec *codec, hda_nid_t nid)
218 {
219 	unsigned int def_conf = snd_hda_codec_get_pincfg(codec, nid);
220 	switch (get_defcfg_device(def_conf)) {
221 	case AC_JACK_LINE_OUT:
222 	case AC_JACK_SPEAKER:
223 		return SND_JACK_LINEOUT;
224 	case AC_JACK_HP_OUT:
225 		return SND_JACK_HEADPHONE;
226 	case AC_JACK_SPDIF_OUT:
227 	case AC_JACK_DIG_OTHER_OUT:
228 		return SND_JACK_AVOUT;
229 	case AC_JACK_MIC_IN:
230 		return SND_JACK_MICROPHONE;
231 	default:
232 		return SND_JACK_LINEIN;
233 	}
234 }
235 
236 static void hda_free_jack_priv(struct snd_jack *jack)
237 {
238 	struct hda_jack_tbl *jacks = jack->private_data;
239 	jacks->nid = 0;
240 	jacks->jack = NULL;
241 }
242 #endif
243 
244 /**
245  * snd_hda_jack_add_kctl - Add a kctl for the given pin
246  *
247  * This assigns a jack-detection kctl to the given pin.  The kcontrol
248  * will have the given name and index.
249  */
250 int snd_hda_jack_add_kctl(struct hda_codec *codec, hda_nid_t nid,
251 			  const char *name, int idx)
252 {
253 	struct hda_jack_tbl *jack;
254 	struct snd_kcontrol *kctl;
255 	int err, state;
256 
257 	jack = snd_hda_jack_tbl_new(codec, nid);
258 	if (!jack)
259 		return 0;
260 	if (jack->kctl)
261 		return 0; /* already created */
262 	kctl = snd_kctl_jack_new(name, idx, codec);
263 	if (!kctl)
264 		return -ENOMEM;
265 	err = snd_hda_ctl_add(codec, nid, kctl);
266 	if (err < 0)
267 		return err;
268 	jack->kctl = kctl;
269 	state = snd_hda_jack_detect(codec, nid);
270 	snd_kctl_jack_report(codec->bus->card, kctl, state);
271 #ifdef CONFIG_SND_HDA_INPUT_JACK
272 	jack->type = get_input_jack_type(codec, nid);
273 	err = snd_jack_new(codec->bus->card, name, jack->type, &jack->jack);
274 	if (err < 0)
275 		return err;
276 	jack->jack->private_data = jack;
277 	jack->jack->private_free = hda_free_jack_priv;
278 	snd_jack_report(jack->jack, state ? jack->type : 0);
279 #endif
280 	return 0;
281 }
282 EXPORT_SYMBOL_HDA(snd_hda_jack_add_kctl);
283 
284 static int add_jack_kctl(struct hda_codec *codec, hda_nid_t nid,
285 			 const struct auto_pin_cfg *cfg)
286 {
287 	unsigned int def_conf, conn;
288 	char name[44];
289 	int idx, err;
290 
291 	if (!nid)
292 		return 0;
293 	if (!is_jack_detectable(codec, nid))
294 		return 0;
295 	def_conf = snd_hda_codec_get_pincfg(codec, nid);
296 	conn = get_defcfg_connect(def_conf);
297 	if (conn != AC_JACK_PORT_COMPLEX)
298 		return 0;
299 
300 	snd_hda_get_pin_label(codec, nid, cfg, name, sizeof(name), &idx);
301 	err = snd_hda_jack_add_kctl(codec, nid, name, idx);
302 	if (err < 0)
303 		return err;
304 	return snd_hda_jack_detect_enable(codec, nid, 0);
305 }
306 
307 /**
308  * snd_hda_jack_add_kctls - Add kctls for all pins included in the given pincfg
309  */
310 int snd_hda_jack_add_kctls(struct hda_codec *codec,
311 			   const struct auto_pin_cfg *cfg)
312 {
313 	const hda_nid_t *p;
314 	int i, err;
315 
316 	for (i = 0, p = cfg->line_out_pins; i < cfg->line_outs; i++, p++) {
317 		err = add_jack_kctl(codec, *p, cfg);
318 		if (err < 0)
319 			return err;
320 	}
321 	for (i = 0, p = cfg->hp_pins; i < cfg->hp_outs; i++, p++) {
322 		if (*p == *cfg->line_out_pins) /* might be duplicated */
323 			break;
324 		err = add_jack_kctl(codec, *p, cfg);
325 		if (err < 0)
326 			return err;
327 	}
328 	for (i = 0, p = cfg->speaker_pins; i < cfg->speaker_outs; i++, p++) {
329 		if (*p == *cfg->line_out_pins) /* might be duplicated */
330 			break;
331 		err = add_jack_kctl(codec, *p, cfg);
332 		if (err < 0)
333 			return err;
334 	}
335 	for (i = 0; i < cfg->num_inputs; i++) {
336 		err = add_jack_kctl(codec, cfg->inputs[i].pin, cfg);
337 		if (err < 0)
338 			return err;
339 	}
340 	for (i = 0, p = cfg->dig_out_pins; i < cfg->dig_outs; i++, p++) {
341 		err = add_jack_kctl(codec, *p, cfg);
342 		if (err < 0)
343 			return err;
344 	}
345 	err = add_jack_kctl(codec, cfg->dig_in_pin, cfg);
346 	if (err < 0)
347 		return err;
348 	err = add_jack_kctl(codec, cfg->mono_out_pin, cfg);
349 	if (err < 0)
350 		return err;
351 	return 0;
352 }
353 EXPORT_SYMBOL_HDA(snd_hda_jack_add_kctls);
354