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
)
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 for_each_hda_codec_node(nid
, codec
) {
193 unsigned int wid_caps
= get_wcaps(codec
, nid
);
194 unsigned int wid_type
= get_wcaps_type(wid_caps
);
195 unsigned int def_conf
;
196 short assoc
, loc
, conn
, dev
;
198 /* read all default configuration for pin complex */
199 if (wid_type
!= AC_WID_PIN
)
201 /* ignore the given nids (e.g. pc-beep returns error) */
202 if (ignore_nids
&& is_in_nid_list(nid
, ignore_nids
))
205 def_conf
= snd_hda_codec_get_pincfg(codec
, nid
);
206 conn
= get_defcfg_connect(def_conf
);
207 if (conn
== AC_JACK_PORT_NONE
)
209 loc
= get_defcfg_location(def_conf
);
210 dev
= get_defcfg_device(def_conf
);
212 /* workaround for buggy BIOS setups */
213 if (dev
== AC_JACK_LINE_OUT
) {
214 if (conn
== AC_JACK_PORT_FIXED
||
215 conn
== AC_JACK_PORT_BOTH
)
216 dev
= AC_JACK_SPEAKER
;
219 if (!check_pincap_validity(codec
, nid
, dev
))
223 case AC_JACK_LINE_OUT
:
224 seq
= get_defcfg_sequence(def_conf
);
225 assoc
= get_defcfg_association(def_conf
);
227 if (!(wid_caps
& AC_WCAP_STEREO
))
228 if (!cfg
->mono_out_pin
)
229 cfg
->mono_out_pin
= nid
;
233 assoc_line_out
= assoc
;
234 else if (assoc_line_out
!= assoc
) {
236 "ignore pin 0x%x with mismatching assoc# 0x%x vs 0x%x\n",
237 nid
, assoc
, assoc_line_out
);
240 if (cfg
->line_outs
>= ARRAY_SIZE(cfg
->line_out_pins
)) {
242 "ignore pin 0x%x, too many assigned pins\n",
246 line_out
[cfg
->line_outs
].pin
= nid
;
247 line_out
[cfg
->line_outs
].seq
= seq
;
250 case AC_JACK_SPEAKER
:
251 seq
= get_defcfg_sequence(def_conf
);
252 assoc
= get_defcfg_association(def_conf
);
253 if (cfg
->speaker_outs
>= ARRAY_SIZE(cfg
->speaker_pins
)) {
255 "ignore pin 0x%x, too many assigned pins\n",
259 speaker_out
[cfg
->speaker_outs
].pin
= nid
;
260 speaker_out
[cfg
->speaker_outs
].seq
= (assoc
<< 4) | seq
;
264 seq
= get_defcfg_sequence(def_conf
);
265 assoc
= get_defcfg_association(def_conf
);
266 if (cfg
->hp_outs
>= ARRAY_SIZE(cfg
->hp_pins
)) {
268 "ignore pin 0x%x, too many assigned pins\n",
272 hp_out
[cfg
->hp_outs
].pin
= nid
;
273 hp_out
[cfg
->hp_outs
].seq
= (assoc
<< 4) | seq
;
277 add_auto_cfg_input_pin(codec
, cfg
, nid
, AUTO_PIN_MIC
);
279 case AC_JACK_LINE_IN
:
280 add_auto_cfg_input_pin(codec
, cfg
, nid
, AUTO_PIN_LINE_IN
);
283 add_auto_cfg_input_pin(codec
, cfg
, nid
, AUTO_PIN_CD
);
286 add_auto_cfg_input_pin(codec
, cfg
, nid
, AUTO_PIN_AUX
);
288 case AC_JACK_SPDIF_OUT
:
289 case AC_JACK_DIG_OTHER_OUT
:
290 if (cfg
->dig_outs
>= ARRAY_SIZE(cfg
->dig_out_pins
)) {
292 "ignore pin 0x%x, too many assigned pins\n",
296 cfg
->dig_out_pins
[cfg
->dig_outs
] = nid
;
297 cfg
->dig_out_type
[cfg
->dig_outs
] =
298 (loc
== AC_JACK_LOC_HDMI
) ?
299 HDA_PCM_TYPE_HDMI
: HDA_PCM_TYPE_SPDIF
;
302 case AC_JACK_SPDIF_IN
:
303 case AC_JACK_DIG_OTHER_IN
:
304 cfg
->dig_in_pin
= nid
;
305 if (loc
== AC_JACK_LOC_HDMI
)
306 cfg
->dig_in_type
= HDA_PCM_TYPE_HDMI
;
308 cfg
->dig_in_type
= HDA_PCM_TYPE_SPDIF
;
313 /* Find a pin that could be a headset or headphone mic */
314 if (cond_flags
& HDA_PINCFG_HEADSET_MIC
|| cond_flags
& HDA_PINCFG_HEADPHONE_MIC
) {
315 bool hsmic
= !!(cond_flags
& HDA_PINCFG_HEADSET_MIC
);
316 bool hpmic
= !!(cond_flags
& HDA_PINCFG_HEADPHONE_MIC
);
317 for (i
= 0; (hsmic
|| hpmic
) && (i
< cfg
->num_inputs
); i
++)
318 if (hsmic
&& can_be_headset_mic(codec
, &cfg
->inputs
[i
], 0xc)) {
319 cfg
->inputs
[i
].is_headset_mic
= 1;
321 } else if (hpmic
&& can_be_headset_mic(codec
, &cfg
->inputs
[i
], 0xd)) {
322 cfg
->inputs
[i
].is_headphone_mic
= 1;
326 /* If we didn't find our sequence number mark, fall back to any sequence number */
327 for (i
= 0; (hsmic
|| hpmic
) && (i
< cfg
->num_inputs
); i
++) {
328 if (!can_be_headset_mic(codec
, &cfg
->inputs
[i
], -1))
331 cfg
->inputs
[i
].is_headset_mic
= 1;
334 cfg
->inputs
[i
].is_headphone_mic
= 1;
340 codec_dbg(codec
, "Told to look for a headset mic, but didn't find any.\n");
342 codec_dbg(codec
, "Told to look for a headphone mic, but didn't find any.\n");
346 * If no line-out is defined but multiple HPs are found,
347 * some of them might be the real line-outs.
349 if (!cfg
->line_outs
&& cfg
->hp_outs
> 1 &&
350 !(cond_flags
& HDA_PINCFG_NO_HP_FIXUP
)) {
352 while (i
< cfg
->hp_outs
) {
353 /* The real HPs should have the sequence 0x0f */
354 if ((hp_out
[i
].seq
& 0x0f) == 0x0f) {
358 /* Move it to the line-out table */
359 line_out
[cfg
->line_outs
++] = hp_out
[i
];
361 memmove(hp_out
+ i
, hp_out
+ i
+ 1,
362 sizeof(hp_out
[0]) * (cfg
->hp_outs
- i
));
364 memset(hp_out
+ cfg
->hp_outs
, 0,
365 sizeof(hp_out
[0]) * (AUTO_CFG_MAX_OUTS
- cfg
->hp_outs
));
367 cfg
->line_out_type
= AUTO_PIN_HP_OUT
;
371 /* sort by sequence */
372 sort_pins_by_sequence(cfg
->line_out_pins
, line_out
, cfg
->line_outs
);
373 sort_pins_by_sequence(cfg
->speaker_pins
, speaker_out
,
375 sort_pins_by_sequence(cfg
->hp_pins
, hp_out
, cfg
->hp_outs
);
378 * FIX-UP: if no line-outs are detected, try to use speaker or HP pin
379 * as a primary output
381 if (!cfg
->line_outs
&&
382 !(cond_flags
& HDA_PINCFG_NO_LO_FIXUP
)) {
383 if (cfg
->speaker_outs
) {
384 cfg
->line_outs
= cfg
->speaker_outs
;
385 memcpy(cfg
->line_out_pins
, cfg
->speaker_pins
,
386 sizeof(cfg
->speaker_pins
));
387 cfg
->speaker_outs
= 0;
388 memset(cfg
->speaker_pins
, 0, sizeof(cfg
->speaker_pins
));
389 cfg
->line_out_type
= AUTO_PIN_SPEAKER_OUT
;
390 } else if (cfg
->hp_outs
) {
391 cfg
->line_outs
= cfg
->hp_outs
;
392 memcpy(cfg
->line_out_pins
, cfg
->hp_pins
,
393 sizeof(cfg
->hp_pins
));
395 memset(cfg
->hp_pins
, 0, sizeof(cfg
->hp_pins
));
396 cfg
->line_out_type
= AUTO_PIN_HP_OUT
;
400 reorder_outputs(cfg
->line_outs
, cfg
->line_out_pins
);
401 reorder_outputs(cfg
->hp_outs
, cfg
->hp_pins
);
402 reorder_outputs(cfg
->speaker_outs
, cfg
->speaker_pins
);
404 /* sort inputs in the order of AUTO_PIN_* type */
405 sort(cfg
->inputs
, cfg
->num_inputs
, sizeof(cfg
->inputs
[0]),
406 compare_input_type
, NULL
);
409 * debug prints of the parsed results
411 codec_info(codec
, "autoconfig for %s: line_outs=%d (0x%x/0x%x/0x%x/0x%x/0x%x) type:%s\n",
412 codec
->core
.chip_name
, cfg
->line_outs
, cfg
->line_out_pins
[0],
413 cfg
->line_out_pins
[1], cfg
->line_out_pins
[2],
414 cfg
->line_out_pins
[3], cfg
->line_out_pins
[4],
415 cfg
->line_out_type
== AUTO_PIN_HP_OUT
? "hp" :
416 (cfg
->line_out_type
== AUTO_PIN_SPEAKER_OUT
?
417 "speaker" : "line"));
418 codec_info(codec
, " speaker_outs=%d (0x%x/0x%x/0x%x/0x%x/0x%x)\n",
419 cfg
->speaker_outs
, cfg
->speaker_pins
[0],
420 cfg
->speaker_pins
[1], cfg
->speaker_pins
[2],
421 cfg
->speaker_pins
[3], cfg
->speaker_pins
[4]);
422 codec_info(codec
, " hp_outs=%d (0x%x/0x%x/0x%x/0x%x/0x%x)\n",
423 cfg
->hp_outs
, cfg
->hp_pins
[0],
424 cfg
->hp_pins
[1], cfg
->hp_pins
[2],
425 cfg
->hp_pins
[3], cfg
->hp_pins
[4]);
426 codec_info(codec
, " mono: mono_out=0x%x\n", cfg
->mono_out_pin
);
428 codec_info(codec
, " dig-out=0x%x/0x%x\n",
429 cfg
->dig_out_pins
[0], cfg
->dig_out_pins
[1]);
430 codec_info(codec
, " inputs:\n");
431 for (i
= 0; i
< cfg
->num_inputs
; i
++) {
432 codec_info(codec
, " %s=0x%x\n",
433 hda_get_autocfg_input_label(codec
, cfg
, i
),
437 codec_info(codec
, " dig-in=0x%x\n", cfg
->dig_in_pin
);
441 EXPORT_SYMBOL_GPL(snd_hda_parse_pin_defcfg
);
444 * snd_hda_get_input_pin_attr - Get the input pin attribute from pin config
445 * @def_conf: pin configuration value
447 * Guess the input pin attribute (INPUT_PIN_ATTR_XXX) from the given
448 * default pin configuration value.
450 int snd_hda_get_input_pin_attr(unsigned int def_conf
)
452 unsigned int loc
= get_defcfg_location(def_conf
);
453 unsigned int conn
= get_defcfg_connect(def_conf
);
454 if (conn
== AC_JACK_PORT_NONE
)
455 return INPUT_PIN_ATTR_UNUSED
;
456 /* Windows may claim the internal mic to be BOTH, too */
457 if (conn
== AC_JACK_PORT_FIXED
|| conn
== AC_JACK_PORT_BOTH
)
458 return INPUT_PIN_ATTR_INT
;
459 if ((loc
& 0x30) == AC_JACK_LOC_INTERNAL
)
460 return INPUT_PIN_ATTR_INT
;
461 if ((loc
& 0x30) == AC_JACK_LOC_SEPARATE
)
462 return INPUT_PIN_ATTR_DOCK
;
463 if (loc
== AC_JACK_LOC_REAR
)
464 return INPUT_PIN_ATTR_REAR
;
465 if (loc
== AC_JACK_LOC_FRONT
)
466 return INPUT_PIN_ATTR_FRONT
;
467 return INPUT_PIN_ATTR_NORMAL
;
469 EXPORT_SYMBOL_GPL(snd_hda_get_input_pin_attr
);
472 * hda_get_input_pin_label - Give a label for the given input pin
473 * @codec: the HDA codec
474 * @item: ping config item to refer
476 * @check_location: flag to add the jack location prefix
478 * When @check_location is true, the function checks the pin location
479 * for mic and line-in pins, and set an appropriate prefix like "Front",
480 * "Rear", "Internal".
482 static const char *hda_get_input_pin_label(struct hda_codec
*codec
,
483 const struct auto_pin_cfg_item
*item
,
484 hda_nid_t pin
, bool check_location
)
486 unsigned int def_conf
;
487 static const char * const mic_names
[] = {
488 "Internal Mic", "Dock Mic", "Mic", "Rear Mic", "Front Mic"
492 def_conf
= snd_hda_codec_get_pincfg(codec
, pin
);
494 switch (get_defcfg_device(def_conf
)) {
496 if (item
&& item
->is_headset_mic
)
497 return "Headset Mic";
498 if (item
&& item
->is_headphone_mic
)
499 return "Headphone Mic";
502 attr
= snd_hda_get_input_pin_attr(def_conf
);
505 return mic_names
[attr
- 1];
506 case AC_JACK_LINE_IN
:
509 attr
= snd_hda_get_input_pin_attr(def_conf
);
512 if (attr
== INPUT_PIN_ATTR_DOCK
)
519 case AC_JACK_SPDIF_IN
:
521 case AC_JACK_DIG_OTHER_IN
:
524 return "Headphone Mic";
530 /* Check whether the location prefix needs to be added to the label.
531 * If all mic-jacks are in the same location (e.g. rear panel), we don't
532 * have to put "Front" prefix to each label. In such a case, returns false.
534 static int check_mic_location_need(struct hda_codec
*codec
,
535 const struct auto_pin_cfg
*cfg
,
541 defc
= snd_hda_codec_get_pincfg(codec
, cfg
->inputs
[input
].pin
);
542 attr
= snd_hda_get_input_pin_attr(defc
);
543 /* for internal or docking mics, we need locations */
544 if (attr
<= INPUT_PIN_ATTR_NORMAL
)
548 for (i
= 0; i
< cfg
->num_inputs
; i
++) {
549 defc
= snd_hda_codec_get_pincfg(codec
, cfg
->inputs
[i
].pin
);
550 attr2
= snd_hda_get_input_pin_attr(defc
);
551 if (attr2
>= INPUT_PIN_ATTR_NORMAL
) {
552 if (attr
&& attr
!= attr2
)
553 return 1; /* different locations found */
561 * hda_get_autocfg_input_label - Get a label for the given input
562 * @codec: the HDA codec
563 * @cfg: the parsed pin configuration
564 * @input: the input index number
566 * Get a label for the given input pin defined by the autocfg item.
567 * Unlike hda_get_input_pin_label(), this function checks all inputs
568 * defined in autocfg and avoids the redundant mic/line prefix as much as
571 const char *hda_get_autocfg_input_label(struct hda_codec
*codec
,
572 const struct auto_pin_cfg
*cfg
,
575 int type
= cfg
->inputs
[input
].type
;
576 int has_multiple_pins
= 0;
578 if ((input
> 0 && cfg
->inputs
[input
- 1].type
== type
) ||
579 (input
< cfg
->num_inputs
- 1 && cfg
->inputs
[input
+ 1].type
== type
))
580 has_multiple_pins
= 1;
581 if (has_multiple_pins
&& type
== AUTO_PIN_MIC
)
582 has_multiple_pins
&= check_mic_location_need(codec
, cfg
, input
);
583 has_multiple_pins
|= codec
->force_pin_prefix
;
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
)
796 const struct hda_verb
**v
;
799 snd_array_for_each(&codec
->verbs
, i
, v
)
800 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
;
833 if (fix
->chained_before
)
834 apply_fixup(codec
, fix
->chain_id
, action
, depth
+ 1);
838 if (action
!= HDA_FIXUP_ACT_PRE_PROBE
|| !fix
->v
.pins
)
840 codec_dbg(codec
, "%s: Apply pincfg for %s\n",
841 codec
->core
.chip_name
, modelname
);
842 snd_hda_apply_pincfgs(codec
, fix
->v
.pins
);
844 case HDA_FIXUP_VERBS
:
845 if (action
!= HDA_FIXUP_ACT_PROBE
|| !fix
->v
.verbs
)
847 codec_dbg(codec
, "%s: Apply fix-verbs for %s\n",
848 codec
->core
.chip_name
, modelname
);
849 snd_hda_add_verbs(codec
, fix
->v
.verbs
);
854 codec_dbg(codec
, "%s: Apply fix-func for %s\n",
855 codec
->core
.chip_name
, modelname
);
856 fix
->v
.func(codec
, fix
, action
);
858 case HDA_FIXUP_PINCTLS
:
859 if (action
!= HDA_FIXUP_ACT_PROBE
|| !fix
->v
.pins
)
861 codec_dbg(codec
, "%s: Apply pinctl for %s\n",
862 codec
->core
.chip_name
, modelname
);
863 set_pin_targets(codec
, fix
->v
.pins
);
866 codec_err(codec
, "%s: Invalid fixup type %d\n",
867 codec
->core
.chip_name
, fix
->type
);
870 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 #define IGNORE_SEQ_ASSOC (~(AC_DEFCFG_SEQUENCE | AC_DEFCFG_DEF_ASSOC))
890 static bool pin_config_match(struct hda_codec
*codec
,
891 const struct hda_pintbl
*pins
)
893 const struct hda_pincfg
*pin
;
896 snd_array_for_each(&codec
->init_pins
, i
, pin
) {
897 hda_nid_t nid
= pin
->nid
;
899 const struct hda_pintbl
*t_pins
;
904 for (; t_pins
->nid
; t_pins
++) {
905 if (t_pins
->nid
== nid
) {
907 if ((t_pins
->val
& IGNORE_SEQ_ASSOC
) == (cfg
& IGNORE_SEQ_ASSOC
))
909 else if ((cfg
& 0xf0000000) == 0x40000000 && (t_pins
->val
& 0xf0000000) == 0x40000000)
915 if (!found
&& (cfg
& 0xf0000000) != 0x40000000)
923 * snd_hda_pick_pin_fixup - Pick up a fixup matching with the pin quirk list
924 * @codec: the HDA codec
925 * @pin_quirk: zero-terminated pin quirk list
926 * @fixlist: the fixup list
928 void snd_hda_pick_pin_fixup(struct hda_codec
*codec
,
929 const struct snd_hda_pin_quirk
*pin_quirk
,
930 const struct hda_fixup
*fixlist
)
932 const struct snd_hda_pin_quirk
*pq
;
934 if (codec
->fixup_id
!= HDA_FIXUP_ID_NOT_SET
)
937 for (pq
= pin_quirk
; pq
->subvendor
; pq
++) {
938 if ((codec
->core
.subsystem_id
& 0xffff0000) != (pq
->subvendor
<< 16))
940 if (codec
->core
.vendor_id
!= pq
->codec
)
942 if (pin_config_match(codec
, pq
->pins
)) {
943 codec
->fixup_id
= pq
->value
;
944 #ifdef CONFIG_SND_DEBUG_VERBOSE
945 codec
->fixup_name
= pq
->name
;
946 codec_dbg(codec
, "%s: picked fixup %s (pin match)\n",
947 codec
->core
.chip_name
, codec
->fixup_name
);
949 codec
->fixup_list
= fixlist
;
954 EXPORT_SYMBOL_GPL(snd_hda_pick_pin_fixup
);
957 * snd_hda_pick_fixup - Pick up a fixup matching with PCI/codec SSID or model string
958 * @codec: the HDA codec
959 * @models: NULL-terminated model string list
960 * @quirk: zero-terminated PCI/codec SSID quirk list
961 * @fixlist: the fixup list
963 * Pick up a fixup entry matching with the given model string or SSID.
964 * If a fixup was already set beforehand, the function doesn't do anything.
965 * When a special model string "nofixup" is given, also no fixup is applied.
967 * The function tries to find the matching model name at first, if given.
968 * If nothing matched, try to look up the PCI SSID.
969 * If still nothing matched, try to look up the codec SSID.
971 void snd_hda_pick_fixup(struct hda_codec
*codec
,
972 const struct hda_model_fixup
*models
,
973 const struct snd_pci_quirk
*quirk
,
974 const struct hda_fixup
*fixlist
)
976 const struct snd_pci_quirk
*q
;
977 int id
= HDA_FIXUP_ID_NOT_SET
;
978 const char *name
= NULL
;
980 if (codec
->fixup_id
!= HDA_FIXUP_ID_NOT_SET
)
983 /* when model=nofixup is given, don't pick up any fixups */
984 if (codec
->modelname
&& !strcmp(codec
->modelname
, "nofixup")) {
985 codec
->fixup_list
= NULL
;
986 codec
->fixup_name
= NULL
;
987 codec
->fixup_id
= HDA_FIXUP_ID_NO_FIXUP
;
988 codec_dbg(codec
, "%s: picked no fixup (nofixup specified)\n",
989 codec
->core
.chip_name
);
993 if (codec
->modelname
&& models
) {
994 while (models
->name
) {
995 if (!strcmp(codec
->modelname
, models
->name
)) {
996 codec
->fixup_id
= models
->id
;
997 codec
->fixup_name
= models
->name
;
998 codec
->fixup_list
= fixlist
;
999 codec_dbg(codec
, "%s: picked fixup %s (model specified)\n",
1000 codec
->core
.chip_name
, codec
->fixup_name
);
1007 q
= snd_pci_quirk_lookup(codec
->bus
->pci
, quirk
);
1010 #ifdef CONFIG_SND_DEBUG_VERBOSE
1012 codec_dbg(codec
, "%s: picked fixup %s (PCI SSID%s)\n",
1013 codec
->core
.chip_name
, name
, q
->subdevice_mask
? "" : " - vendor generic");
1017 if (id
< 0 && quirk
) {
1018 for (q
= quirk
; q
->subvendor
|| q
->subdevice
; q
++) {
1019 unsigned int vendorid
=
1020 q
->subdevice
| (q
->subvendor
<< 16);
1021 unsigned int mask
= 0xffff0000 | q
->subdevice_mask
;
1022 if ((codec
->core
.subsystem_id
& mask
) == (vendorid
& mask
)) {
1024 #ifdef CONFIG_SND_DEBUG_VERBOSE
1026 codec_dbg(codec
, "%s: picked fixup %s (codec SSID)\n",
1027 codec
->core
.chip_name
, name
);
1034 codec
->fixup_id
= id
;
1036 codec
->fixup_list
= fixlist
;
1037 codec
->fixup_name
= name
;
1040 EXPORT_SYMBOL_GPL(snd_hda_pick_fixup
);