2 * BIOS auto-parser helper functions for HD-audio
4 * Copyright (c) 2012 Takashi Iwai <tiwai@suse.de>
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.
12 #include <linux/slab.h>
13 #include <linux/export.h>
14 #include <linux/sort.h>
15 #include <sound/core.h>
16 #include "hda_codec.h"
17 #include "hda_local.h"
18 #include "hda_auto_parser.h"
21 * Helper for automatic pin configuration
24 static int is_in_nid_list(hda_nid_t nid
, const hda_nid_t
*list
)
32 /* a pair of input pin and its sequence */
38 static int compare_seq(const void *ap
, const void *bp
)
40 const struct auto_out_pin
*a
= ap
;
41 const struct auto_out_pin
*b
= bp
;
42 return (int)(a
->seq
- b
->seq
);
46 * Sort an associated group of pins according to their sequence numbers.
47 * then store it to a pin array.
49 static void sort_pins_by_sequence(hda_nid_t
*pins
, struct auto_out_pin
*list
,
53 sort(list
, num_pins
, sizeof(list
[0]), compare_seq
, NULL
);
54 for (i
= 0; i
< num_pins
; i
++)
55 pins
[i
] = list
[i
].pin
;
59 /* add the found input-pin to the cfg->inputs[] table */
60 static void add_auto_cfg_input_pin(struct hda_codec
*codec
, struct auto_pin_cfg
*cfg
,
61 hda_nid_t nid
, int type
)
63 if (cfg
->num_inputs
< AUTO_CFG_MAX_INS
) {
64 cfg
->inputs
[cfg
->num_inputs
].pin
= nid
;
65 cfg
->inputs
[cfg
->num_inputs
].type
= type
;
66 cfg
->inputs
[cfg
->num_inputs
].has_boost_on_pin
=
67 nid_has_volume(codec
, nid
, HDA_INPUT
);
72 static int compare_input_type(const void *ap
, const void *bp
)
74 const struct auto_pin_cfg_item
*a
= ap
;
75 const struct auto_pin_cfg_item
*b
= bp
;
76 if (a
->type
!= b
->type
)
77 return (int)(a
->type
- b
->type
);
79 /* In case one has boost and the other one has not,
80 pick the one with boost first. */
81 return (int)(b
->has_boost_on_pin
- a
->has_boost_on_pin
);
84 /* Reorder the surround channels
85 * ALSA sequence is front/surr/clfe/side
87 * 4-ch: front/surr => OK as it is
88 * 6-ch: front/clfe/surr
89 * 8-ch: front/clfe/rear/side|fc
91 static void reorder_outputs(unsigned int nums
, hda_nid_t
*pins
)
105 /* check whether the given pin has a proper pin I/O capability bit */
106 static bool check_pincap_validity(struct hda_codec
*codec
, hda_nid_t pin
,
109 unsigned int pincap
= snd_hda_query_pin_caps(codec
, pin
);
111 /* some old hardware don't return the proper pincaps */
116 case AC_JACK_LINE_OUT
:
117 case AC_JACK_SPEAKER
:
119 case AC_JACK_SPDIF_OUT
:
120 case AC_JACK_DIG_OTHER_OUT
:
121 return !!(pincap
& AC_PINCAP_OUT
);
123 return !!(pincap
& AC_PINCAP_IN
);
127 static bool can_be_headset_mic(struct hda_codec
*codec
,
128 struct auto_pin_cfg_item
*item
,
132 unsigned int def_conf
;
133 if (item
->type
!= AUTO_PIN_MIC
)
136 if (item
->is_headset_mic
|| item
->is_headphone_mic
)
137 return false; /* Already assigned */
139 def_conf
= snd_hda_codec_get_pincfg(codec
, item
->pin
);
140 attr
= snd_hda_get_input_pin_attr(def_conf
);
141 if (attr
<= INPUT_PIN_ATTR_DOCK
)
144 if (seq_number
>= 0) {
145 int seq
= get_defcfg_sequence(def_conf
);
146 if (seq
!= seq_number
)
154 * Parse all pin widgets and store the useful pin nids to cfg
156 * The number of line-outs or any primary output is stored in line_outs,
157 * and the corresponding output pins are assigned to line_out_pins[],
158 * in the order of front, rear, CLFE, side, ...
160 * If more extra outputs (speaker and headphone) are found, the pins are
161 * assisnged to hp_pins[] and speaker_pins[], respectively. If no line-out jack
162 * is detected, one of speaker of HP pins is assigned as the primary
163 * output, i.e. to line_out_pins[0]. So, line_outs is always positive
164 * if any analog output exists.
166 * The analog input pins are assigned to inputs array.
167 * The digital input/output pins are assigned to dig_in_pin and dig_out_pin,
170 int snd_hda_parse_pin_defcfg(struct hda_codec
*codec
,
171 struct auto_pin_cfg
*cfg
,
172 const hda_nid_t
*ignore_nids
,
173 unsigned int cond_flags
)
175 hda_nid_t nid
, end_nid
;
176 short seq
, assoc_line_out
;
177 struct auto_out_pin line_out
[ARRAY_SIZE(cfg
->line_out_pins
)];
178 struct auto_out_pin speaker_out
[ARRAY_SIZE(cfg
->speaker_pins
)];
179 struct auto_out_pin hp_out
[ARRAY_SIZE(cfg
->hp_pins
)];
182 if (!snd_hda_get_int_hint(codec
, "parser_flags", &i
))
185 memset(cfg
, 0, sizeof(*cfg
));
187 memset(line_out
, 0, sizeof(line_out
));
188 memset(speaker_out
, 0, sizeof(speaker_out
));
189 memset(hp_out
, 0, sizeof(hp_out
));
192 end_nid
= codec
->start_nid
+ codec
->num_nodes
;
193 for (nid
= codec
->start_nid
; nid
< end_nid
; nid
++) {
194 unsigned int wid_caps
= get_wcaps(codec
, nid
);
195 unsigned int wid_type
= get_wcaps_type(wid_caps
);
196 unsigned int def_conf
;
197 short assoc
, loc
, conn
, dev
;
199 /* read all default configuration for pin complex */
200 if (wid_type
!= AC_WID_PIN
)
202 /* ignore the given nids (e.g. pc-beep returns error) */
203 if (ignore_nids
&& is_in_nid_list(nid
, ignore_nids
))
206 def_conf
= snd_hda_codec_get_pincfg(codec
, nid
);
207 conn
= get_defcfg_connect(def_conf
);
208 if (conn
== AC_JACK_PORT_NONE
)
210 loc
= get_defcfg_location(def_conf
);
211 dev
= get_defcfg_device(def_conf
);
213 /* workaround for buggy BIOS setups */
214 if (dev
== AC_JACK_LINE_OUT
) {
215 if (conn
== AC_JACK_PORT_FIXED
||
216 conn
== AC_JACK_PORT_BOTH
)
217 dev
= AC_JACK_SPEAKER
;
220 if (!check_pincap_validity(codec
, nid
, dev
))
224 case AC_JACK_LINE_OUT
:
225 seq
= get_defcfg_sequence(def_conf
);
226 assoc
= get_defcfg_association(def_conf
);
228 if (!(wid_caps
& AC_WCAP_STEREO
))
229 if (!cfg
->mono_out_pin
)
230 cfg
->mono_out_pin
= nid
;
234 assoc_line_out
= assoc
;
235 else if (assoc_line_out
!= assoc
) {
237 "ignore pin 0x%x with mismatching assoc# 0x%x vs 0x%x\n",
238 nid
, assoc
, assoc_line_out
);
241 if (cfg
->line_outs
>= ARRAY_SIZE(cfg
->line_out_pins
)) {
243 "ignore pin 0x%x, too many assigned pins\n",
247 line_out
[cfg
->line_outs
].pin
= nid
;
248 line_out
[cfg
->line_outs
].seq
= seq
;
251 case AC_JACK_SPEAKER
:
252 seq
= get_defcfg_sequence(def_conf
);
253 assoc
= get_defcfg_association(def_conf
);
254 if (cfg
->speaker_outs
>= ARRAY_SIZE(cfg
->speaker_pins
)) {
256 "ignore pin 0x%x, too many assigned pins\n",
260 speaker_out
[cfg
->speaker_outs
].pin
= nid
;
261 speaker_out
[cfg
->speaker_outs
].seq
= (assoc
<< 4) | seq
;
265 seq
= get_defcfg_sequence(def_conf
);
266 assoc
= get_defcfg_association(def_conf
);
267 if (cfg
->hp_outs
>= ARRAY_SIZE(cfg
->hp_pins
)) {
269 "ignore pin 0x%x, too many assigned pins\n",
273 hp_out
[cfg
->hp_outs
].pin
= nid
;
274 hp_out
[cfg
->hp_outs
].seq
= (assoc
<< 4) | seq
;
278 add_auto_cfg_input_pin(codec
, cfg
, nid
, AUTO_PIN_MIC
);
280 case AC_JACK_LINE_IN
:
281 add_auto_cfg_input_pin(codec
, cfg
, nid
, AUTO_PIN_LINE_IN
);
284 add_auto_cfg_input_pin(codec
, cfg
, nid
, AUTO_PIN_CD
);
287 add_auto_cfg_input_pin(codec
, cfg
, nid
, AUTO_PIN_AUX
);
289 case AC_JACK_SPDIF_OUT
:
290 case AC_JACK_DIG_OTHER_OUT
:
291 if (cfg
->dig_outs
>= ARRAY_SIZE(cfg
->dig_out_pins
)) {
293 "ignore pin 0x%x, too many assigned pins\n",
297 cfg
->dig_out_pins
[cfg
->dig_outs
] = nid
;
298 cfg
->dig_out_type
[cfg
->dig_outs
] =
299 (loc
== AC_JACK_LOC_HDMI
) ?
300 HDA_PCM_TYPE_HDMI
: HDA_PCM_TYPE_SPDIF
;
303 case AC_JACK_SPDIF_IN
:
304 case AC_JACK_DIG_OTHER_IN
:
305 cfg
->dig_in_pin
= nid
;
306 if (loc
== AC_JACK_LOC_HDMI
)
307 cfg
->dig_in_type
= HDA_PCM_TYPE_HDMI
;
309 cfg
->dig_in_type
= HDA_PCM_TYPE_SPDIF
;
314 /* Find a pin that could be a headset or headphone mic */
315 if (cond_flags
& HDA_PINCFG_HEADSET_MIC
|| cond_flags
& HDA_PINCFG_HEADPHONE_MIC
) {
316 bool hsmic
= !!(cond_flags
& HDA_PINCFG_HEADSET_MIC
);
317 bool hpmic
= !!(cond_flags
& HDA_PINCFG_HEADPHONE_MIC
);
318 for (i
= 0; (hsmic
|| hpmic
) && (i
< cfg
->num_inputs
); i
++)
319 if (hsmic
&& can_be_headset_mic(codec
, &cfg
->inputs
[i
], 0xc)) {
320 cfg
->inputs
[i
].is_headset_mic
= 1;
322 } else if (hpmic
&& can_be_headset_mic(codec
, &cfg
->inputs
[i
], 0xd)) {
323 cfg
->inputs
[i
].is_headphone_mic
= 1;
327 /* If we didn't find our sequence number mark, fall back to any sequence number */
328 for (i
= 0; (hsmic
|| hpmic
) && (i
< cfg
->num_inputs
); i
++) {
329 if (!can_be_headset_mic(codec
, &cfg
->inputs
[i
], -1))
332 cfg
->inputs
[i
].is_headset_mic
= 1;
335 cfg
->inputs
[i
].is_headphone_mic
= 1;
341 codec_dbg(codec
, "Told to look for a headset mic, but didn't find any.\n");
343 codec_dbg(codec
, "Told to look for a headphone mic, but didn't find any.\n");
347 * If no line-out is defined but multiple HPs are found,
348 * some of them might be the real line-outs.
350 if (!cfg
->line_outs
&& cfg
->hp_outs
> 1 &&
351 !(cond_flags
& HDA_PINCFG_NO_HP_FIXUP
)) {
353 while (i
< cfg
->hp_outs
) {
354 /* The real HPs should have the sequence 0x0f */
355 if ((hp_out
[i
].seq
& 0x0f) == 0x0f) {
359 /* Move it to the line-out table */
360 line_out
[cfg
->line_outs
++] = hp_out
[i
];
362 memmove(hp_out
+ i
, hp_out
+ i
+ 1,
363 sizeof(hp_out
[0]) * (cfg
->hp_outs
- i
));
365 memset(hp_out
+ cfg
->hp_outs
, 0,
366 sizeof(hp_out
[0]) * (AUTO_CFG_MAX_OUTS
- cfg
->hp_outs
));
368 cfg
->line_out_type
= AUTO_PIN_HP_OUT
;
372 /* sort by sequence */
373 sort_pins_by_sequence(cfg
->line_out_pins
, line_out
, cfg
->line_outs
);
374 sort_pins_by_sequence(cfg
->speaker_pins
, speaker_out
,
376 sort_pins_by_sequence(cfg
->hp_pins
, hp_out
, cfg
->hp_outs
);
379 * FIX-UP: if no line-outs are detected, try to use speaker or HP pin
380 * as a primary output
382 if (!cfg
->line_outs
&&
383 !(cond_flags
& HDA_PINCFG_NO_LO_FIXUP
)) {
384 if (cfg
->speaker_outs
) {
385 cfg
->line_outs
= cfg
->speaker_outs
;
386 memcpy(cfg
->line_out_pins
, cfg
->speaker_pins
,
387 sizeof(cfg
->speaker_pins
));
388 cfg
->speaker_outs
= 0;
389 memset(cfg
->speaker_pins
, 0, sizeof(cfg
->speaker_pins
));
390 cfg
->line_out_type
= AUTO_PIN_SPEAKER_OUT
;
391 } else if (cfg
->hp_outs
) {
392 cfg
->line_outs
= cfg
->hp_outs
;
393 memcpy(cfg
->line_out_pins
, cfg
->hp_pins
,
394 sizeof(cfg
->hp_pins
));
396 memset(cfg
->hp_pins
, 0, sizeof(cfg
->hp_pins
));
397 cfg
->line_out_type
= AUTO_PIN_HP_OUT
;
401 reorder_outputs(cfg
->line_outs
, cfg
->line_out_pins
);
402 reorder_outputs(cfg
->hp_outs
, cfg
->hp_pins
);
403 reorder_outputs(cfg
->speaker_outs
, cfg
->speaker_pins
);
405 /* sort inputs in the order of AUTO_PIN_* type */
406 sort(cfg
->inputs
, cfg
->num_inputs
, sizeof(cfg
->inputs
[0]),
407 compare_input_type
, NULL
);
410 * debug prints of the parsed results
412 codec_info(codec
, "autoconfig for %s: line_outs=%d (0x%x/0x%x/0x%x/0x%x/0x%x) type:%s\n",
413 codec
->chip_name
, cfg
->line_outs
, cfg
->line_out_pins
[0],
414 cfg
->line_out_pins
[1], cfg
->line_out_pins
[2],
415 cfg
->line_out_pins
[3], cfg
->line_out_pins
[4],
416 cfg
->line_out_type
== AUTO_PIN_HP_OUT
? "hp" :
417 (cfg
->line_out_type
== AUTO_PIN_SPEAKER_OUT
?
418 "speaker" : "line"));
419 codec_info(codec
, " speaker_outs=%d (0x%x/0x%x/0x%x/0x%x/0x%x)\n",
420 cfg
->speaker_outs
, cfg
->speaker_pins
[0],
421 cfg
->speaker_pins
[1], cfg
->speaker_pins
[2],
422 cfg
->speaker_pins
[3], cfg
->speaker_pins
[4]);
423 codec_info(codec
, " hp_outs=%d (0x%x/0x%x/0x%x/0x%x/0x%x)\n",
424 cfg
->hp_outs
, cfg
->hp_pins
[0],
425 cfg
->hp_pins
[1], cfg
->hp_pins
[2],
426 cfg
->hp_pins
[3], cfg
->hp_pins
[4]);
427 codec_info(codec
, " mono: mono_out=0x%x\n", cfg
->mono_out_pin
);
429 codec_info(codec
, " dig-out=0x%x/0x%x\n",
430 cfg
->dig_out_pins
[0], cfg
->dig_out_pins
[1]);
431 codec_info(codec
, " inputs:\n");
432 for (i
= 0; i
< cfg
->num_inputs
; i
++) {
433 codec_info(codec
, " %s=0x%x\n",
434 hda_get_autocfg_input_label(codec
, cfg
, i
),
438 codec_info(codec
, " dig-in=0x%x\n", cfg
->dig_in_pin
);
442 EXPORT_SYMBOL_GPL(snd_hda_parse_pin_defcfg
);
445 * snd_hda_get_input_pin_attr - Get the input pin attribute from pin config
446 * @def_conf: pin configuration value
448 * Guess the input pin attribute (INPUT_PIN_ATTR_XXX) from the given
449 * default pin configuration value.
451 int snd_hda_get_input_pin_attr(unsigned int def_conf
)
453 unsigned int loc
= get_defcfg_location(def_conf
);
454 unsigned int conn
= get_defcfg_connect(def_conf
);
455 if (conn
== AC_JACK_PORT_NONE
)
456 return INPUT_PIN_ATTR_UNUSED
;
457 /* Windows may claim the internal mic to be BOTH, too */
458 if (conn
== AC_JACK_PORT_FIXED
|| conn
== AC_JACK_PORT_BOTH
)
459 return INPUT_PIN_ATTR_INT
;
460 if ((loc
& 0x30) == AC_JACK_LOC_INTERNAL
)
461 return INPUT_PIN_ATTR_INT
;
462 if ((loc
& 0x30) == AC_JACK_LOC_SEPARATE
)
463 return INPUT_PIN_ATTR_DOCK
;
464 if (loc
== AC_JACK_LOC_REAR
)
465 return INPUT_PIN_ATTR_REAR
;
466 if (loc
== AC_JACK_LOC_FRONT
)
467 return INPUT_PIN_ATTR_FRONT
;
468 return INPUT_PIN_ATTR_NORMAL
;
470 EXPORT_SYMBOL_GPL(snd_hda_get_input_pin_attr
);
473 * hda_get_input_pin_label - Give a label for the given input pin
474 * @codec: the HDA codec
475 * @item: ping config item to refer
477 * @check_location: flag to add the jack location prefix
479 * When @check_location is true, the function checks the pin location
480 * for mic and line-in pins, and set an appropriate prefix like "Front",
481 * "Rear", "Internal".
483 static const char *hda_get_input_pin_label(struct hda_codec
*codec
,
484 const struct auto_pin_cfg_item
*item
,
485 hda_nid_t pin
, bool check_location
)
487 unsigned int def_conf
;
488 static const char * const mic_names
[] = {
489 "Internal Mic", "Dock Mic", "Mic", "Rear Mic", "Front Mic"
493 def_conf
= snd_hda_codec_get_pincfg(codec
, pin
);
495 switch (get_defcfg_device(def_conf
)) {
497 if (item
&& item
->is_headset_mic
)
498 return "Headset Mic";
499 if (item
&& item
->is_headphone_mic
)
500 return "Headphone Mic";
503 attr
= snd_hda_get_input_pin_attr(def_conf
);
506 return mic_names
[attr
- 1];
507 case AC_JACK_LINE_IN
:
510 attr
= snd_hda_get_input_pin_attr(def_conf
);
513 if (attr
== INPUT_PIN_ATTR_DOCK
)
520 case AC_JACK_SPDIF_IN
:
522 case AC_JACK_DIG_OTHER_IN
:
525 return "Headphone Mic";
531 /* Check whether the location prefix needs to be added to the label.
532 * If all mic-jacks are in the same location (e.g. rear panel), we don't
533 * have to put "Front" prefix to each label. In such a case, returns false.
535 static int check_mic_location_need(struct hda_codec
*codec
,
536 const struct auto_pin_cfg
*cfg
,
542 defc
= snd_hda_codec_get_pincfg(codec
, cfg
->inputs
[input
].pin
);
543 attr
= snd_hda_get_input_pin_attr(defc
);
544 /* for internal or docking mics, we need locations */
545 if (attr
<= INPUT_PIN_ATTR_NORMAL
)
549 for (i
= 0; i
< cfg
->num_inputs
; i
++) {
550 defc
= snd_hda_codec_get_pincfg(codec
, cfg
->inputs
[i
].pin
);
551 attr2
= snd_hda_get_input_pin_attr(defc
);
552 if (attr2
>= INPUT_PIN_ATTR_NORMAL
) {
553 if (attr
&& attr
!= attr2
)
554 return 1; /* different locations found */
562 * hda_get_autocfg_input_label - Get a label for the given input
563 * @codec: the HDA codec
564 * @cfg: the parsed pin configuration
565 * @input: the input index number
567 * Get a label for the given input pin defined by the autocfg item.
568 * Unlike hda_get_input_pin_label(), this function checks all inputs
569 * defined in autocfg and avoids the redundant mic/line prefix as much as
572 const char *hda_get_autocfg_input_label(struct hda_codec
*codec
,
573 const struct auto_pin_cfg
*cfg
,
576 int type
= cfg
->inputs
[input
].type
;
577 int has_multiple_pins
= 0;
579 if ((input
> 0 && cfg
->inputs
[input
- 1].type
== type
) ||
580 (input
< cfg
->num_inputs
- 1 && cfg
->inputs
[input
+ 1].type
== type
))
581 has_multiple_pins
= 1;
582 if (has_multiple_pins
&& type
== AUTO_PIN_MIC
)
583 has_multiple_pins
&= check_mic_location_need(codec
, cfg
, input
);
584 return hda_get_input_pin_label(codec
, &cfg
->inputs
[input
],
585 cfg
->inputs
[input
].pin
,
588 EXPORT_SYMBOL_GPL(hda_get_autocfg_input_label
);
590 /* return the position of NID in the list, or -1 if not found */
591 static int find_idx_in_nid_list(hda_nid_t nid
, const hda_nid_t
*list
, int nums
)
594 for (i
= 0; i
< nums
; i
++)
600 /* get a unique suffix or an index number */
601 static const char *check_output_sfx(hda_nid_t nid
, const hda_nid_t
*pins
,
602 int num_pins
, int *indexp
)
604 static const char * const channel_sfx
[] = {
605 " Front", " Surround", " CLFE", " Side"
609 i
= find_idx_in_nid_list(nid
, pins
, num_pins
);
614 if (num_pins
> ARRAY_SIZE(channel_sfx
)) {
619 return channel_sfx
[i
];
622 static const char *check_output_pfx(struct hda_codec
*codec
, hda_nid_t nid
)
624 unsigned int def_conf
= snd_hda_codec_get_pincfg(codec
, nid
);
625 int attr
= snd_hda_get_input_pin_attr(def_conf
);
627 /* check the location */
629 case INPUT_PIN_ATTR_DOCK
:
631 case INPUT_PIN_ATTR_FRONT
:
637 static int get_hp_label_index(struct hda_codec
*codec
, hda_nid_t nid
,
638 const hda_nid_t
*pins
, int num_pins
)
642 const char *pfx
= check_output_pfx(codec
, nid
);
644 i
= find_idx_in_nid_list(nid
, pins
, num_pins
);
647 for (j
= 0; j
< i
; j
++)
648 if (pfx
== check_output_pfx(codec
, pins
[j
]))
654 static int fill_audio_out_name(struct hda_codec
*codec
, hda_nid_t nid
,
655 const struct auto_pin_cfg
*cfg
,
656 const char *name
, char *label
, int maxlen
,
659 unsigned int def_conf
= snd_hda_codec_get_pincfg(codec
, nid
);
660 int attr
= snd_hda_get_input_pin_attr(def_conf
);
661 const char *pfx
, *sfx
= "";
663 /* handle as a speaker if it's a fixed line-out */
664 if (!strcmp(name
, "Line Out") && attr
== INPUT_PIN_ATTR_INT
)
666 pfx
= check_output_pfx(codec
, nid
);
669 /* try to give a unique suffix if needed */
670 sfx
= check_output_sfx(nid
, cfg
->line_out_pins
, cfg
->line_outs
,
673 sfx
= check_output_sfx(nid
, cfg
->speaker_pins
, cfg
->speaker_outs
,
676 /* don't add channel suffix for Headphone controls */
677 int idx
= get_hp_label_index(codec
, nid
, cfg
->hp_pins
,
679 if (idx
>= 0 && indexp
)
684 snprintf(label
, maxlen
, "%s%s%s", pfx
, name
, sfx
);
688 #define is_hdmi_cfg(conf) \
689 (get_defcfg_location(conf) == AC_JACK_LOC_HDMI)
692 * snd_hda_get_pin_label - Get a label for the given I/O pin
693 * @codec: the HDA codec
695 * @cfg: the parsed pin configuration
696 * @label: the string buffer to store
697 * @maxlen: the max length of string buffer (including termination)
698 * @indexp: the pointer to return the index number (for multiple ctls)
700 * Get a label for the given pin. This function works for both input and
701 * output pins. When @cfg is given as non-NULL, the function tries to get
702 * an optimized label using hda_get_autocfg_input_label().
704 * This function tries to give a unique label string for the pin as much as
705 * possible. For example, when the multiple line-outs are present, it adds
706 * the channel suffix like "Front", "Surround", etc (only when @cfg is given).
707 * If no unique name with a suffix is available and @indexp is non-NULL, the
708 * index number is stored in the pointer.
710 int snd_hda_get_pin_label(struct hda_codec
*codec
, hda_nid_t nid
,
711 const struct auto_pin_cfg
*cfg
,
712 char *label
, int maxlen
, int *indexp
)
714 unsigned int def_conf
= snd_hda_codec_get_pincfg(codec
, nid
);
715 const char *name
= NULL
;
721 if (get_defcfg_connect(def_conf
) == AC_JACK_PORT_NONE
)
724 switch (get_defcfg_device(def_conf
)) {
725 case AC_JACK_LINE_OUT
:
726 return fill_audio_out_name(codec
, nid
, cfg
, "Line Out",
727 label
, maxlen
, indexp
);
728 case AC_JACK_SPEAKER
:
729 return fill_audio_out_name(codec
, nid
, cfg
, "Speaker",
730 label
, maxlen
, indexp
);
732 return fill_audio_out_name(codec
, nid
, cfg
, "Headphone",
733 label
, maxlen
, indexp
);
734 case AC_JACK_SPDIF_OUT
:
735 case AC_JACK_DIG_OTHER_OUT
:
736 hdmi
= is_hdmi_cfg(def_conf
);
737 name
= hdmi
? "HDMI" : "SPDIF";
739 for (i
= 0; i
< cfg
->dig_outs
; i
++) {
740 hda_nid_t pin
= cfg
->dig_out_pins
[i
];
744 c
= snd_hda_codec_get_pincfg(codec
, pin
);
745 if (hdmi
== is_hdmi_cfg(c
))
751 for (i
= 0; i
< cfg
->num_inputs
; i
++) {
752 if (cfg
->inputs
[i
].pin
!= nid
)
754 name
= hda_get_autocfg_input_label(codec
, cfg
, i
);
760 name
= hda_get_input_pin_label(codec
, NULL
, nid
, true);
765 strlcpy(label
, name
, maxlen
);
768 EXPORT_SYMBOL_GPL(snd_hda_get_pin_label
);
771 * snd_hda_add_verbs - Add verbs to the init list
772 * @codec: the HDA codec
773 * @list: zero-terminated verb list to add
775 * Append the given verb list to the execution list. The verbs will be
776 * performed at init and resume time via snd_hda_apply_verbs().
778 int snd_hda_add_verbs(struct hda_codec
*codec
,
779 const struct hda_verb
*list
)
781 const struct hda_verb
**v
;
782 v
= snd_array_new(&codec
->verbs
);
788 EXPORT_SYMBOL_GPL(snd_hda_add_verbs
);
791 * snd_hda_apply_verbs - Execute the init verb lists
792 * @codec: the HDA codec
794 void snd_hda_apply_verbs(struct hda_codec
*codec
)
797 for (i
= 0; i
< codec
->verbs
.used
; i
++) {
798 struct hda_verb
**v
= snd_array_elem(&codec
->verbs
, i
);
799 snd_hda_sequence_write(codec
, *v
);
802 EXPORT_SYMBOL_GPL(snd_hda_apply_verbs
);
805 * snd_hda_apply_pincfgs - Set each pin config in the given list
806 * @codec: the HDA codec
807 * @cfg: NULL-terminated pin config table
809 void snd_hda_apply_pincfgs(struct hda_codec
*codec
,
810 const struct hda_pintbl
*cfg
)
812 for (; cfg
->nid
; cfg
++)
813 snd_hda_codec_set_pincfg(codec
, cfg
->nid
, cfg
->val
);
815 EXPORT_SYMBOL_GPL(snd_hda_apply_pincfgs
);
817 static void set_pin_targets(struct hda_codec
*codec
,
818 const struct hda_pintbl
*cfg
)
820 for (; cfg
->nid
; cfg
++)
821 snd_hda_set_pin_ctl_cache(codec
, cfg
->nid
, cfg
->val
);
824 static void apply_fixup(struct hda_codec
*codec
, int id
, int action
, int depth
)
826 const char *modelname
= codec
->fixup_name
;
829 const struct hda_fixup
*fix
= codec
->fixup_list
+ id
;
831 if (fix
->chained_before
)
832 apply_fixup(codec
, fix
->chain_id
, action
, depth
+ 1);
836 if (action
!= HDA_FIXUP_ACT_PRE_PROBE
|| !fix
->v
.pins
)
838 codec_dbg(codec
, "%s: Apply pincfg for %s\n",
839 codec
->chip_name
, modelname
);
840 snd_hda_apply_pincfgs(codec
, fix
->v
.pins
);
842 case HDA_FIXUP_VERBS
:
843 if (action
!= HDA_FIXUP_ACT_PROBE
|| !fix
->v
.verbs
)
845 codec_dbg(codec
, "%s: Apply fix-verbs for %s\n",
846 codec
->chip_name
, modelname
);
847 snd_hda_add_verbs(codec
, fix
->v
.verbs
);
852 codec_dbg(codec
, "%s: Apply fix-func for %s\n",
853 codec
->chip_name
, modelname
);
854 fix
->v
.func(codec
, fix
, action
);
856 case HDA_FIXUP_PINCTLS
:
857 if (action
!= HDA_FIXUP_ACT_PROBE
|| !fix
->v
.pins
)
859 codec_dbg(codec
, "%s: Apply pinctl for %s\n",
860 codec
->chip_name
, modelname
);
861 set_pin_targets(codec
, fix
->v
.pins
);
864 codec_err(codec
, "%s: Invalid fixup type %d\n",
865 codec
->chip_name
, fix
->type
);
868 if (!fix
->chained
|| fix
->chained_before
)
877 * snd_hda_apply_fixup - Apply the fixup chain with the given action
878 * @codec: the HDA codec
879 * @action: fixup action (HDA_FIXUP_ACT_XXX)
881 void snd_hda_apply_fixup(struct hda_codec
*codec
, int action
)
883 if (codec
->fixup_list
)
884 apply_fixup(codec
, codec
->fixup_id
, action
, 0);
886 EXPORT_SYMBOL_GPL(snd_hda_apply_fixup
);
888 static bool pin_config_match(struct hda_codec
*codec
,
889 const struct hda_pintbl
*pins
)
891 for (; pins
->nid
; pins
++) {
892 u32 def_conf
= snd_hda_codec_get_pincfg(codec
, pins
->nid
);
893 if (pins
->val
!= def_conf
)
900 * snd_hda_pick_pin_fixup - Pick up a fixup matching with the pin quirk list
901 * @codec: the HDA codec
902 * @pin_quirk: zero-terminated pin quirk list
903 * @fixlist: the fixup list
905 void snd_hda_pick_pin_fixup(struct hda_codec
*codec
,
906 const struct snd_hda_pin_quirk
*pin_quirk
,
907 const struct hda_fixup
*fixlist
)
909 const struct snd_hda_pin_quirk
*pq
;
911 if (codec
->fixup_id
!= HDA_FIXUP_ID_NOT_SET
)
914 for (pq
= pin_quirk
; pq
->subvendor
; pq
++) {
915 if ((codec
->subsystem_id
& 0xffff0000) != (pq
->subvendor
<< 16))
917 if (codec
->vendor_id
!= pq
->codec
)
919 if (pin_config_match(codec
, pq
->pins
)) {
920 codec
->fixup_id
= pq
->value
;
921 #ifdef CONFIG_SND_DEBUG_VERBOSE
922 codec
->fixup_name
= pq
->name
;
923 codec_dbg(codec
, "%s: picked fixup %s (pin match)\n",
924 codec
->chip_name
, codec
->fixup_name
);
926 codec
->fixup_list
= fixlist
;
931 EXPORT_SYMBOL_GPL(snd_hda_pick_pin_fixup
);
934 * snd_hda_pick_fixup - Pick up a fixup matching with PCI/codec SSID or model string
935 * @codec: the HDA codec
936 * @models: NULL-terminated model string list
937 * @quirk: zero-terminated PCI/codec SSID quirk list
938 * @fixlist: the fixup list
940 * Pick up a fixup entry matching with the given model string or SSID.
941 * If a fixup was already set beforehand, the function doesn't do anything.
942 * When a special model string "nofixup" is given, also no fixup is applied.
944 * The function tries to find the matching model name at first, if given.
945 * If nothing matched, try to look up the PCI SSID.
946 * If still nothing matched, try to look up the codec SSID.
948 void snd_hda_pick_fixup(struct hda_codec
*codec
,
949 const struct hda_model_fixup
*models
,
950 const struct snd_pci_quirk
*quirk
,
951 const struct hda_fixup
*fixlist
)
953 const struct snd_pci_quirk
*q
;
954 int id
= HDA_FIXUP_ID_NOT_SET
;
955 const char *name
= NULL
;
957 if (codec
->fixup_id
!= HDA_FIXUP_ID_NOT_SET
)
960 /* when model=nofixup is given, don't pick up any fixups */
961 if (codec
->modelname
&& !strcmp(codec
->modelname
, "nofixup")) {
962 codec
->fixup_list
= NULL
;
963 codec
->fixup_name
= NULL
;
964 codec
->fixup_id
= HDA_FIXUP_ID_NO_FIXUP
;
965 codec_dbg(codec
, "%s: picked no fixup (nofixup specified)\n",
970 if (codec
->modelname
&& models
) {
971 while (models
->name
) {
972 if (!strcmp(codec
->modelname
, models
->name
)) {
973 codec
->fixup_id
= models
->id
;
974 codec
->fixup_name
= models
->name
;
975 codec
->fixup_list
= fixlist
;
976 codec_dbg(codec
, "%s: picked fixup %s (model specified)\n",
977 codec
->chip_name
, codec
->fixup_name
);
984 q
= snd_pci_quirk_lookup(codec
->bus
->pci
, quirk
);
987 #ifdef CONFIG_SND_DEBUG_VERBOSE
989 codec_dbg(codec
, "%s: picked fixup %s (PCI SSID%s)\n",
990 codec
->chip_name
, name
, q
->subdevice_mask
? "" : " - vendor generic");
994 if (id
< 0 && quirk
) {
995 for (q
= quirk
; q
->subvendor
|| q
->subdevice
; q
++) {
996 unsigned int vendorid
=
997 q
->subdevice
| (q
->subvendor
<< 16);
998 unsigned int mask
= 0xffff0000 | q
->subdevice_mask
;
999 if ((codec
->subsystem_id
& mask
) == (vendorid
& mask
)) {
1001 #ifdef CONFIG_SND_DEBUG_VERBOSE
1003 codec_dbg(codec
, "%s: picked fixup %s (codec SSID)\n",
1004 codec
->chip_name
, name
);
1011 codec
->fixup_id
= id
;
1013 codec
->fixup_list
= fixlist
;
1014 codec
->fixup_name
= name
;
1017 EXPORT_SYMBOL_GPL(snd_hda_pick_fixup
);