linux/sound/pci/hda/hda_auto_parser.c
<<
>>
Prefs
   1// SPDX-License-Identifier: GPL-2.0-or-later
   2/*
   3 * BIOS auto-parser helper functions for HD-audio
   4 *
   5 * Copyright (c) 2012 Takashi Iwai <tiwai@suse.de>
   6 */
   7
   8#include <linux/slab.h>
   9#include <linux/export.h>
  10#include <linux/sort.h>
  11#include <sound/core.h>
  12#include <sound/hda_codec.h>
  13#include "hda_local.h"
  14#include "hda_auto_parser.h"
  15
  16/*
  17 * Helper for automatic pin configuration
  18 */
  19
  20static int is_in_nid_list(hda_nid_t nid, const hda_nid_t *list)
  21{
  22        for (; *list; list++)
  23                if (*list == nid)
  24                        return 1;
  25        return 0;
  26}
  27
  28/* a pair of input pin and its sequence */
  29struct auto_out_pin {
  30        hda_nid_t pin;
  31        short seq;
  32};
  33
  34static int compare_seq(const void *ap, const void *bp)
  35{
  36        const struct auto_out_pin *a = ap;
  37        const struct auto_out_pin *b = bp;
  38        return (int)(a->seq - b->seq);
  39}
  40
  41/*
  42 * Sort an associated group of pins according to their sequence numbers.
  43 * then store it to a pin array.
  44 */
  45static void sort_pins_by_sequence(hda_nid_t *pins, struct auto_out_pin *list,
  46                                  int num_pins)
  47{
  48        int i;
  49        sort(list, num_pins, sizeof(list[0]), compare_seq, NULL);
  50        for (i = 0; i < num_pins; i++)
  51                pins[i] = list[i].pin;
  52}
  53
  54
  55/* add the found input-pin to the cfg->inputs[] table */
  56static void add_auto_cfg_input_pin(struct hda_codec *codec, struct auto_pin_cfg *cfg,
  57                                   hda_nid_t nid, int type)
  58{
  59        if (cfg->num_inputs < AUTO_CFG_MAX_INS) {
  60                cfg->inputs[cfg->num_inputs].pin = nid;
  61                cfg->inputs[cfg->num_inputs].type = type;
  62                cfg->inputs[cfg->num_inputs].has_boost_on_pin =
  63                        nid_has_volume(codec, nid, HDA_INPUT);
  64                cfg->num_inputs++;
  65        }
  66}
  67
  68static int compare_input_type(const void *ap, const void *bp)
  69{
  70        const struct auto_pin_cfg_item *a = ap;
  71        const struct auto_pin_cfg_item *b = bp;
  72        if (a->type != b->type)
  73                return (int)(a->type - b->type);
  74
  75        /* If has both hs_mic and hp_mic, pick the hs_mic ahead of hp_mic. */
  76        if (a->is_headset_mic && b->is_headphone_mic)
  77                return -1; /* don't swap */
  78        else if (a->is_headphone_mic && b->is_headset_mic)
  79                return 1; /* swap */
  80
  81        /* In case one has boost and the other one has not,
  82           pick the one with boost first. */
  83        return (int)(b->has_boost_on_pin - a->has_boost_on_pin);
  84}
  85
  86/* Reorder the surround channels
  87 * ALSA sequence is front/surr/clfe/side
  88 * HDA sequence is:
  89 *    4-ch: front/surr  =>  OK as it is
  90 *    6-ch: front/clfe/surr
  91 *    8-ch: front/clfe/rear/side|fc
  92 */
  93static void reorder_outputs(unsigned int nums, hda_nid_t *pins)
  94{
  95        hda_nid_t nid;
  96
  97        switch (nums) {
  98        case 3:
  99        case 4:
 100                nid = pins[1];
 101                pins[1] = pins[2];
 102                pins[2] = nid;
 103                break;
 104        }
 105}
 106
 107/* check whether the given pin has a proper pin I/O capability bit */
 108static bool check_pincap_validity(struct hda_codec *codec, hda_nid_t pin,
 109                                  unsigned int dev)
 110{
 111        unsigned int pincap = snd_hda_query_pin_caps(codec, pin);
 112
 113        /* some old hardware don't return the proper pincaps */
 114        if (!pincap)
 115                return true;
 116
 117        switch (dev) {
 118        case AC_JACK_LINE_OUT:
 119        case AC_JACK_SPEAKER:
 120        case AC_JACK_HP_OUT:
 121        case AC_JACK_SPDIF_OUT:
 122        case AC_JACK_DIG_OTHER_OUT:
 123                return !!(pincap & AC_PINCAP_OUT);
 124        default:
 125                return !!(pincap & AC_PINCAP_IN);
 126        }
 127}
 128
 129static bool can_be_headset_mic(struct hda_codec *codec,
 130                               struct auto_pin_cfg_item *item,
 131                               int seq_number)
 132{
 133        int attr;
 134        unsigned int def_conf;
 135        if (item->type != AUTO_PIN_MIC)
 136                return false;
 137
 138        if (item->is_headset_mic || item->is_headphone_mic)
 139                return false; /* Already assigned */
 140
 141        def_conf = snd_hda_codec_get_pincfg(codec, item->pin);
 142        attr = snd_hda_get_input_pin_attr(def_conf);
 143        if (attr <= INPUT_PIN_ATTR_DOCK)
 144                return false;
 145
 146        if (seq_number >= 0) {
 147                int seq = get_defcfg_sequence(def_conf);
 148                if (seq != seq_number)
 149                        return false;
 150        }
 151
 152        return true;
 153}
 154
 155/*
 156 * Parse all pin widgets and store the useful pin nids to cfg
 157 *
 158 * The number of line-outs or any primary output is stored in line_outs,
 159 * and the corresponding output pins are assigned to line_out_pins[],
 160 * in the order of front, rear, CLFE, side, ...
 161 *
 162 * If more extra outputs (speaker and headphone) are found, the pins are
 163 * assisnged to hp_pins[] and speaker_pins[], respectively.  If no line-out jack
 164 * is detected, one of speaker of HP pins is assigned as the primary
 165 * output, i.e. to line_out_pins[0].  So, line_outs is always positive
 166 * if any analog output exists.
 167 *
 168 * The analog input pins are assigned to inputs array.
 169 * The digital input/output pins are assigned to dig_in_pin and dig_out_pin,
 170 * respectively.
 171 */
 172int snd_hda_parse_pin_defcfg(struct hda_codec *codec,
 173                             struct auto_pin_cfg *cfg,
 174                             const hda_nid_t *ignore_nids,
 175                             unsigned int cond_flags)
 176{
 177        hda_nid_t nid;
 178        short seq, assoc_line_out;
 179        struct auto_out_pin line_out[ARRAY_SIZE(cfg->line_out_pins)];
 180        struct auto_out_pin speaker_out[ARRAY_SIZE(cfg->speaker_pins)];
 181        struct auto_out_pin hp_out[ARRAY_SIZE(cfg->hp_pins)];
 182        int i;
 183
 184        if (!snd_hda_get_int_hint(codec, "parser_flags", &i))
 185                cond_flags = i;
 186
 187        memset(cfg, 0, sizeof(*cfg));
 188
 189        memset(line_out, 0, sizeof(line_out));
 190        memset(speaker_out, 0, sizeof(speaker_out));
 191        memset(hp_out, 0, sizeof(hp_out));
 192        assoc_line_out = 0;
 193
 194        for_each_hda_codec_node(nid, codec) {
 195                unsigned int wid_caps = get_wcaps(codec, nid);
 196                unsigned int wid_type = get_wcaps_type(wid_caps);
 197                unsigned int def_conf;
 198                short assoc, loc, conn, dev;
 199
 200                /* read all default configuration for pin complex */
 201                if (wid_type != AC_WID_PIN)
 202                        continue;
 203                /* ignore the given nids (e.g. pc-beep returns error) */
 204                if (ignore_nids && is_in_nid_list(nid, ignore_nids))
 205                        continue;
 206
 207                def_conf = snd_hda_codec_get_pincfg(codec, nid);
 208                conn = get_defcfg_connect(def_conf);
 209                if (conn == AC_JACK_PORT_NONE)
 210                        continue;
 211                loc = get_defcfg_location(def_conf);
 212                dev = get_defcfg_device(def_conf);
 213
 214                /* workaround for buggy BIOS setups */
 215                if (dev == AC_JACK_LINE_OUT) {
 216                        if (conn == AC_JACK_PORT_FIXED ||
 217                            conn == AC_JACK_PORT_BOTH)
 218                                dev = AC_JACK_SPEAKER;
 219                }
 220
 221                if (!check_pincap_validity(codec, nid, dev))
 222                        continue;
 223
 224                switch (dev) {
 225                case AC_JACK_LINE_OUT:
 226                        seq = get_defcfg_sequence(def_conf);
 227                        assoc = get_defcfg_association(def_conf);
 228
 229                        if (!(wid_caps & AC_WCAP_STEREO))
 230                                if (!cfg->mono_out_pin)
 231                                        cfg->mono_out_pin = nid;
 232                        if (!assoc)
 233                                continue;
 234                        if (!assoc_line_out)
 235                                assoc_line_out = assoc;
 236                        else if (assoc_line_out != assoc) {
 237                                codec_info(codec,
 238                                           "ignore pin 0x%x with mismatching assoc# 0x%x vs 0x%x\n",
 239                                           nid, assoc, assoc_line_out);
 240                                continue;
 241                        }
 242                        if (cfg->line_outs >= ARRAY_SIZE(cfg->line_out_pins)) {
 243                                codec_info(codec,
 244                                           "ignore pin 0x%x, too many assigned pins\n",
 245                                           nid);
 246                                continue;
 247                        }
 248                        line_out[cfg->line_outs].pin = nid;
 249                        line_out[cfg->line_outs].seq = seq;
 250                        cfg->line_outs++;
 251                        break;
 252                case AC_JACK_SPEAKER:
 253                        seq = get_defcfg_sequence(def_conf);
 254                        assoc = get_defcfg_association(def_conf);
 255                        if (cfg->speaker_outs >= ARRAY_SIZE(cfg->speaker_pins)) {
 256                                codec_info(codec,
 257                                           "ignore pin 0x%x, too many assigned pins\n",
 258                                           nid);
 259                                continue;
 260                        }
 261                        speaker_out[cfg->speaker_outs].pin = nid;
 262                        speaker_out[cfg->speaker_outs].seq = (assoc << 4) | seq;
 263                        cfg->speaker_outs++;
 264                        break;
 265                case AC_JACK_HP_OUT:
 266                        seq = get_defcfg_sequence(def_conf);
 267                        assoc = get_defcfg_association(def_conf);
 268                        if (cfg->hp_outs >= ARRAY_SIZE(cfg->hp_pins)) {
 269                                codec_info(codec,
 270                                           "ignore pin 0x%x, too many assigned pins\n",
 271                                           nid);
 272                                continue;
 273                        }
 274                        hp_out[cfg->hp_outs].pin = nid;
 275                        hp_out[cfg->hp_outs].seq = (assoc << 4) | seq;
 276                        cfg->hp_outs++;
 277                        break;
 278                case AC_JACK_MIC_IN:
 279                        add_auto_cfg_input_pin(codec, cfg, nid, AUTO_PIN_MIC);
 280                        break;
 281                case AC_JACK_LINE_IN:
 282                        add_auto_cfg_input_pin(codec, cfg, nid, AUTO_PIN_LINE_IN);
 283                        break;
 284                case AC_JACK_CD:
 285                        add_auto_cfg_input_pin(codec, cfg, nid, AUTO_PIN_CD);
 286                        break;
 287                case AC_JACK_AUX:
 288                        add_auto_cfg_input_pin(codec, cfg, nid, AUTO_PIN_AUX);
 289                        break;
 290                case AC_JACK_SPDIF_OUT:
 291                case AC_JACK_DIG_OTHER_OUT:
 292                        if (cfg->dig_outs >= ARRAY_SIZE(cfg->dig_out_pins)) {
 293                                codec_info(codec,
 294                                           "ignore pin 0x%x, too many assigned pins\n",
 295                                           nid);
 296                                continue;
 297                        }
 298                        cfg->dig_out_pins[cfg->dig_outs] = nid;
 299                        cfg->dig_out_type[cfg->dig_outs] =
 300                                (loc == AC_JACK_LOC_HDMI) ?
 301                                HDA_PCM_TYPE_HDMI : HDA_PCM_TYPE_SPDIF;
 302                        cfg->dig_outs++;
 303                        break;
 304                case AC_JACK_SPDIF_IN:
 305                case AC_JACK_DIG_OTHER_IN:
 306                        cfg->dig_in_pin = nid;
 307                        if (loc == AC_JACK_LOC_HDMI)
 308                                cfg->dig_in_type = HDA_PCM_TYPE_HDMI;
 309                        else
 310                                cfg->dig_in_type = HDA_PCM_TYPE_SPDIF;
 311                        break;
 312                }
 313        }
 314
 315        /* Find a pin that could be a headset or headphone mic */
 316        if (cond_flags & HDA_PINCFG_HEADSET_MIC || cond_flags & HDA_PINCFG_HEADPHONE_MIC) {
 317                bool hsmic = !!(cond_flags & HDA_PINCFG_HEADSET_MIC);
 318                bool hpmic = !!(cond_flags & HDA_PINCFG_HEADPHONE_MIC);
 319                for (i = 0; (hsmic || hpmic) && (i < cfg->num_inputs); i++)
 320                        if (hsmic && can_be_headset_mic(codec, &cfg->inputs[i], 0xc)) {
 321                                cfg->inputs[i].is_headset_mic = 1;
 322                                hsmic = false;
 323                        } else if (hpmic && can_be_headset_mic(codec, &cfg->inputs[i], 0xd)) {
 324                                cfg->inputs[i].is_headphone_mic = 1;
 325                                hpmic = false;
 326                        }
 327
 328                /* If we didn't find our sequence number mark, fall back to any sequence number */
 329                for (i = 0; (hsmic || hpmic) && (i < cfg->num_inputs); i++) {
 330                        if (!can_be_headset_mic(codec, &cfg->inputs[i], -1))
 331                                continue;
 332                        if (hsmic) {
 333                                cfg->inputs[i].is_headset_mic = 1;
 334                                hsmic = false;
 335                        } else if (hpmic) {
 336                                cfg->inputs[i].is_headphone_mic = 1;
 337                                hpmic = false;
 338                        }
 339                }
 340
 341                if (hsmic)
 342                        codec_dbg(codec, "Told to look for a headset mic, but didn't find any.\n");
 343                if (hpmic)
 344                        codec_dbg(codec, "Told to look for a headphone mic, but didn't find any.\n");
 345        }
 346
 347        /* FIX-UP:
 348         * If no line-out is defined but multiple HPs are found,
 349         * some of them might be the real line-outs.
 350         */
 351        if (!cfg->line_outs && cfg->hp_outs > 1 &&
 352            !(cond_flags & HDA_PINCFG_NO_HP_FIXUP)) {
 353                i = 0;
 354                while (i < cfg->hp_outs) {
 355                        /* The real HPs should have the sequence 0x0f */
 356                        if ((hp_out[i].seq & 0x0f) == 0x0f) {
 357                                i++;
 358                                continue;
 359                        }
 360                        /* Move it to the line-out table */
 361                        line_out[cfg->line_outs++] = hp_out[i];
 362                        cfg->hp_outs--;
 363                        memmove(hp_out + i, hp_out + i + 1,
 364                                sizeof(hp_out[0]) * (cfg->hp_outs - i));
 365                }
 366                memset(hp_out + cfg->hp_outs, 0,
 367                       sizeof(hp_out[0]) * (AUTO_CFG_MAX_OUTS - cfg->hp_outs));
 368                if (!cfg->hp_outs)
 369                        cfg->line_out_type = AUTO_PIN_HP_OUT;
 370
 371        }
 372
 373        /* sort by sequence */
 374        sort_pins_by_sequence(cfg->line_out_pins, line_out, cfg->line_outs);
 375        sort_pins_by_sequence(cfg->speaker_pins, speaker_out,
 376                              cfg->speaker_outs);
 377        sort_pins_by_sequence(cfg->hp_pins, hp_out, cfg->hp_outs);
 378
 379        /*
 380         * FIX-UP: if no line-outs are detected, try to use speaker or HP pin
 381         * as a primary output
 382         */
 383        if (!cfg->line_outs &&
 384            !(cond_flags & HDA_PINCFG_NO_LO_FIXUP)) {
 385                if (cfg->speaker_outs) {
 386                        cfg->line_outs = cfg->speaker_outs;
 387                        memcpy(cfg->line_out_pins, cfg->speaker_pins,
 388                               sizeof(cfg->speaker_pins));
 389                        cfg->speaker_outs = 0;
 390                        memset(cfg->speaker_pins, 0, sizeof(cfg->speaker_pins));
 391                        cfg->line_out_type = AUTO_PIN_SPEAKER_OUT;
 392                } else if (cfg->hp_outs) {
 393                        cfg->line_outs = cfg->hp_outs;
 394                        memcpy(cfg->line_out_pins, cfg->hp_pins,
 395                               sizeof(cfg->hp_pins));
 396                        cfg->hp_outs = 0;
 397                        memset(cfg->hp_pins, 0, sizeof(cfg->hp_pins));
 398                        cfg->line_out_type = AUTO_PIN_HP_OUT;
 399                }
 400        }
 401
 402        reorder_outputs(cfg->line_outs, cfg->line_out_pins);
 403        reorder_outputs(cfg->hp_outs, cfg->hp_pins);
 404        reorder_outputs(cfg->speaker_outs, cfg->speaker_pins);
 405
 406        /* sort inputs in the order of AUTO_PIN_* type */
 407        sort(cfg->inputs, cfg->num_inputs, sizeof(cfg->inputs[0]),
 408             compare_input_type, NULL);
 409
 410        /*
 411         * debug prints of the parsed results
 412         */
 413        codec_info(codec, "autoconfig for %s: line_outs=%d (0x%x/0x%x/0x%x/0x%x/0x%x) type:%s\n",
 414                   codec->core.chip_name, cfg->line_outs, cfg->line_out_pins[0],
 415                   cfg->line_out_pins[1], cfg->line_out_pins[2],
 416                   cfg->line_out_pins[3], cfg->line_out_pins[4],
 417                   cfg->line_out_type == AUTO_PIN_HP_OUT ? "hp" :
 418                   (cfg->line_out_type == AUTO_PIN_SPEAKER_OUT ?
 419                    "speaker" : "line"));
 420        codec_info(codec, "   speaker_outs=%d (0x%x/0x%x/0x%x/0x%x/0x%x)\n",
 421                   cfg->speaker_outs, cfg->speaker_pins[0],
 422                   cfg->speaker_pins[1], cfg->speaker_pins[2],
 423                   cfg->speaker_pins[3], cfg->speaker_pins[4]);
 424        codec_info(codec, "   hp_outs=%d (0x%x/0x%x/0x%x/0x%x/0x%x)\n",
 425                   cfg->hp_outs, cfg->hp_pins[0],
 426                   cfg->hp_pins[1], cfg->hp_pins[2],
 427                   cfg->hp_pins[3], cfg->hp_pins[4]);
 428        codec_info(codec, "   mono: mono_out=0x%x\n", cfg->mono_out_pin);
 429        if (cfg->dig_outs)
 430                codec_info(codec, "   dig-out=0x%x/0x%x\n",
 431                           cfg->dig_out_pins[0], cfg->dig_out_pins[1]);
 432        codec_info(codec, "   inputs:\n");
 433        for (i = 0; i < cfg->num_inputs; i++) {
 434                codec_info(codec, "     %s=0x%x\n",
 435                            hda_get_autocfg_input_label(codec, cfg, i),
 436                            cfg->inputs[i].pin);
 437        }
 438        if (cfg->dig_in_pin)
 439                codec_info(codec, "   dig-in=0x%x\n", cfg->dig_in_pin);
 440
 441        return 0;
 442}
 443EXPORT_SYMBOL_GPL(snd_hda_parse_pin_defcfg);
 444
 445/**
 446 * snd_hda_get_input_pin_attr - Get the input pin attribute from pin config
 447 * @def_conf: pin configuration value
 448 *
 449 * Guess the input pin attribute (INPUT_PIN_ATTR_XXX) from the given
 450 * default pin configuration value.
 451 */
 452int snd_hda_get_input_pin_attr(unsigned int def_conf)
 453{
 454        unsigned int loc = get_defcfg_location(def_conf);
 455        unsigned int conn = get_defcfg_connect(def_conf);
 456        if (conn == AC_JACK_PORT_NONE)
 457                return INPUT_PIN_ATTR_UNUSED;
 458        /* Windows may claim the internal mic to be BOTH, too */
 459        if (conn == AC_JACK_PORT_FIXED || conn == AC_JACK_PORT_BOTH)
 460                return INPUT_PIN_ATTR_INT;
 461        if ((loc & 0x30) == AC_JACK_LOC_INTERNAL)
 462                return INPUT_PIN_ATTR_INT;
 463        if ((loc & 0x30) == AC_JACK_LOC_SEPARATE)
 464                return INPUT_PIN_ATTR_DOCK;
 465        if (loc == AC_JACK_LOC_REAR)
 466                return INPUT_PIN_ATTR_REAR;
 467        if (loc == AC_JACK_LOC_FRONT)
 468                return INPUT_PIN_ATTR_FRONT;
 469        return INPUT_PIN_ATTR_NORMAL;
 470}
 471EXPORT_SYMBOL_GPL(snd_hda_get_input_pin_attr);
 472
 473/**
 474 * hda_get_input_pin_label - Give a label for the given input pin
 475 * @codec: the HDA codec
 476 * @item: ping config item to refer
 477 * @pin: the pin NID
 478 * @check_location: flag to add the jack location prefix
 479 *
 480 * When @check_location is true, the function checks the pin location
 481 * for mic and line-in pins, and set an appropriate prefix like "Front",
 482 * "Rear", "Internal".
 483 */
 484static const char *hda_get_input_pin_label(struct hda_codec *codec,
 485                                           const struct auto_pin_cfg_item *item,
 486                                           hda_nid_t pin, bool check_location)
 487{
 488        unsigned int def_conf;
 489        static const char * const mic_names[] = {
 490                "Internal Mic", "Dock Mic", "Mic", "Rear Mic", "Front Mic"
 491        };
 492        int attr;
 493
 494        def_conf = snd_hda_codec_get_pincfg(codec, pin);
 495
 496        switch (get_defcfg_device(def_conf)) {
 497        case AC_JACK_MIC_IN:
 498                if (item && item->is_headset_mic)
 499                        return "Headset Mic";
 500                if (item && item->is_headphone_mic)
 501                        return "Headphone Mic";
 502                if (!check_location)
 503                        return "Mic";
 504                attr = snd_hda_get_input_pin_attr(def_conf);
 505                if (!attr)
 506                        return "None";
 507                return mic_names[attr - 1];
 508        case AC_JACK_LINE_IN:
 509                if (!check_location)
 510                        return "Line";
 511                attr = snd_hda_get_input_pin_attr(def_conf);
 512                if (!attr)
 513                        return "None";
 514                if (attr == INPUT_PIN_ATTR_DOCK)
 515                        return "Dock Line";
 516                return "Line";
 517        case AC_JACK_AUX:
 518                return "Aux";
 519        case AC_JACK_CD:
 520                return "CD";
 521        case AC_JACK_SPDIF_IN:
 522                return "SPDIF In";
 523        case AC_JACK_DIG_OTHER_IN:
 524                return "Digital In";
 525        case AC_JACK_HP_OUT:
 526                return "Headphone Mic";
 527        default:
 528                return "Misc";
 529        }
 530}
 531
 532/* Check whether the location prefix needs to be added to the label.
 533 * If all mic-jacks are in the same location (e.g. rear panel), we don't
 534 * have to put "Front" prefix to each label.  In such a case, returns false.
 535 */
 536static int check_mic_location_need(struct hda_codec *codec,
 537                                   const struct auto_pin_cfg *cfg,
 538                                   int input)
 539{
 540        unsigned int defc;
 541        int i, attr, attr2;
 542
 543        defc = snd_hda_codec_get_pincfg(codec, cfg->inputs[input].pin);
 544        attr = snd_hda_get_input_pin_attr(defc);
 545        /* for internal or docking mics, we need locations */
 546        if (attr <= INPUT_PIN_ATTR_NORMAL)
 547                return 1;
 548
 549        attr = 0;
 550        for (i = 0; i < cfg->num_inputs; i++) {
 551                defc = snd_hda_codec_get_pincfg(codec, cfg->inputs[i].pin);
 552                attr2 = snd_hda_get_input_pin_attr(defc);
 553                if (attr2 >= INPUT_PIN_ATTR_NORMAL) {
 554                        if (attr && attr != attr2)
 555                                return 1; /* different locations found */
 556                        attr = attr2;
 557                }
 558        }
 559        return 0;
 560}
 561
 562/**
 563 * hda_get_autocfg_input_label - Get a label for the given input
 564 * @codec: the HDA codec
 565 * @cfg: the parsed pin configuration
 566 * @input: the input index number
 567 *
 568 * Get a label for the given input pin defined by the autocfg item.
 569 * Unlike hda_get_input_pin_label(), this function checks all inputs
 570 * defined in autocfg and avoids the redundant mic/line prefix as much as
 571 * possible.
 572 */
 573const char *hda_get_autocfg_input_label(struct hda_codec *codec,
 574                                        const struct auto_pin_cfg *cfg,
 575                                        int input)
 576{
 577        int type = cfg->inputs[input].type;
 578        int has_multiple_pins = 0;
 579
 580        if ((input > 0 && cfg->inputs[input - 1].type == type) ||
 581            (input < cfg->num_inputs - 1 && cfg->inputs[input + 1].type == type))
 582                has_multiple_pins = 1;
 583        if (has_multiple_pins && type == AUTO_PIN_MIC)
 584                has_multiple_pins &= check_mic_location_need(codec, cfg, input);
 585        has_multiple_pins |= codec->force_pin_prefix;
 586        return hda_get_input_pin_label(codec, &cfg->inputs[input],
 587                                       cfg->inputs[input].pin,
 588                                       has_multiple_pins);
 589}
 590EXPORT_SYMBOL_GPL(hda_get_autocfg_input_label);
 591
 592/* return the position of NID in the list, or -1 if not found */
 593static int find_idx_in_nid_list(hda_nid_t nid, const hda_nid_t *list, int nums)
 594{
 595        int i;
 596        for (i = 0; i < nums; i++)
 597                if (list[i] == nid)
 598                        return i;
 599        return -1;
 600}
 601
 602/* get a unique suffix or an index number */
 603static const char *check_output_sfx(hda_nid_t nid, const hda_nid_t *pins,
 604                                    int num_pins, int *indexp)
 605{
 606        static const char * const channel_sfx[] = {
 607                " Front", " Surround", " CLFE", " Side"
 608        };
 609        int i;
 610
 611        i = find_idx_in_nid_list(nid, pins, num_pins);
 612        if (i < 0)
 613                return NULL;
 614        if (num_pins == 1)
 615                return "";
 616        if (num_pins > ARRAY_SIZE(channel_sfx)) {
 617                if (indexp)
 618                        *indexp = i;
 619                return "";
 620        }
 621        return channel_sfx[i];
 622}
 623
 624static const char *check_output_pfx(struct hda_codec *codec, hda_nid_t nid)
 625{
 626        unsigned int def_conf = snd_hda_codec_get_pincfg(codec, nid);
 627        int attr = snd_hda_get_input_pin_attr(def_conf);
 628
 629        /* check the location */
 630        switch (attr) {
 631        case INPUT_PIN_ATTR_DOCK:
 632                return "Dock ";
 633        case INPUT_PIN_ATTR_FRONT:
 634                return "Front ";
 635        }
 636        return "";
 637}
 638
 639static int get_hp_label_index(struct hda_codec *codec, hda_nid_t nid,
 640                              const hda_nid_t *pins, int num_pins)
 641{
 642        int i, j, idx = 0;
 643
 644        const char *pfx = check_output_pfx(codec, nid);
 645
 646        i = find_idx_in_nid_list(nid, pins, num_pins);
 647        if (i < 0)
 648                return -1;
 649        for (j = 0; j < i; j++)
 650                if (pfx == check_output_pfx(codec, pins[j]))
 651                        idx++;
 652
 653        return idx;
 654}
 655
 656static int fill_audio_out_name(struct hda_codec *codec, hda_nid_t nid,
 657                               const struct auto_pin_cfg *cfg,
 658                               const char *name, char *label, int maxlen,
 659                               int *indexp)
 660{
 661        unsigned int def_conf = snd_hda_codec_get_pincfg(codec, nid);
 662        int attr = snd_hda_get_input_pin_attr(def_conf);
 663        const char *pfx, *sfx = "";
 664
 665        /* handle as a speaker if it's a fixed line-out */
 666        if (!strcmp(name, "Line Out") && attr == INPUT_PIN_ATTR_INT)
 667                name = "Speaker";
 668        pfx = check_output_pfx(codec, nid);
 669
 670        if (cfg) {
 671                /* try to give a unique suffix if needed */
 672                sfx = check_output_sfx(nid, cfg->line_out_pins, cfg->line_outs,
 673                                       indexp);
 674                if (!sfx)
 675                        sfx = check_output_sfx(nid, cfg->speaker_pins, cfg->speaker_outs,
 676                                               indexp);
 677                if (!sfx) {
 678                        /* don't add channel suffix for Headphone controls */
 679                        int idx = get_hp_label_index(codec, nid, cfg->hp_pins,
 680                                                     cfg->hp_outs);
 681                        if (idx >= 0 && indexp)
 682                                *indexp = idx;
 683                        sfx = "";
 684                }
 685        }
 686        snprintf(label, maxlen, "%s%s%s", pfx, name, sfx);
 687        return 1;
 688}
 689
 690#define is_hdmi_cfg(conf) \
 691        (get_defcfg_location(conf) == AC_JACK_LOC_HDMI)
 692
 693/**
 694 * snd_hda_get_pin_label - Get a label for the given I/O pin
 695 * @codec: the HDA codec
 696 * @nid: pin NID
 697 * @cfg: the parsed pin configuration
 698 * @label: the string buffer to store
 699 * @maxlen: the max length of string buffer (including termination)
 700 * @indexp: the pointer to return the index number (for multiple ctls)
 701 *
 702 * Get a label for the given pin.  This function works for both input and
 703 * output pins.  When @cfg is given as non-NULL, the function tries to get
 704 * an optimized label using hda_get_autocfg_input_label().
 705 *
 706 * This function tries to give a unique label string for the pin as much as
 707 * possible.  For example, when the multiple line-outs are present, it adds
 708 * the channel suffix like "Front", "Surround", etc (only when @cfg is given).
 709 * If no unique name with a suffix is available and @indexp is non-NULL, the
 710 * index number is stored in the pointer.
 711 */
 712int snd_hda_get_pin_label(struct hda_codec *codec, hda_nid_t nid,
 713                          const struct auto_pin_cfg *cfg,
 714                          char *label, int maxlen, int *indexp)
 715{
 716        unsigned int def_conf = snd_hda_codec_get_pincfg(codec, nid);
 717        const char *name = NULL;
 718        int i;
 719        bool hdmi;
 720
 721        if (indexp)
 722                *indexp = 0;
 723        if (get_defcfg_connect(def_conf) == AC_JACK_PORT_NONE)
 724                return 0;
 725
 726        switch (get_defcfg_device(def_conf)) {
 727        case AC_JACK_LINE_OUT:
 728                return fill_audio_out_name(codec, nid, cfg, "Line Out",
 729                                           label, maxlen, indexp);
 730        case AC_JACK_SPEAKER:
 731                return fill_audio_out_name(codec, nid, cfg, "Speaker",
 732                                           label, maxlen, indexp);
 733        case AC_JACK_HP_OUT:
 734                return fill_audio_out_name(codec, nid, cfg, "Headphone",
 735                                           label, maxlen, indexp);
 736        case AC_JACK_SPDIF_OUT:
 737        case AC_JACK_DIG_OTHER_OUT:
 738                hdmi = is_hdmi_cfg(def_conf);
 739                name = hdmi ? "HDMI" : "SPDIF";
 740                if (cfg && indexp)
 741                        for (i = 0; i < cfg->dig_outs; i++) {
 742                                hda_nid_t pin = cfg->dig_out_pins[i];
 743                                unsigned int c;
 744                                if (pin == nid)
 745                                        break;
 746                                c = snd_hda_codec_get_pincfg(codec, pin);
 747                                if (hdmi == is_hdmi_cfg(c))
 748                                        (*indexp)++;
 749                        }
 750                break;
 751        default:
 752                if (cfg) {
 753                        for (i = 0; i < cfg->num_inputs; i++) {
 754                                if (cfg->inputs[i].pin != nid)
 755                                        continue;
 756                                name = hda_get_autocfg_input_label(codec, cfg, i);
 757                                if (name)
 758                                        break;
 759                        }
 760                }
 761                if (!name)
 762                        name = hda_get_input_pin_label(codec, NULL, nid, true);
 763                break;
 764        }
 765        if (!name)
 766                return 0;
 767        strscpy(label, name, maxlen);
 768        return 1;
 769}
 770EXPORT_SYMBOL_GPL(snd_hda_get_pin_label);
 771
 772/**
 773 * snd_hda_add_verbs - Add verbs to the init list
 774 * @codec: the HDA codec
 775 * @list: zero-terminated verb list to add
 776 *
 777 * Append the given verb list to the execution list.  The verbs will be
 778 * performed at init and resume time via snd_hda_apply_verbs().
 779 */
 780int snd_hda_add_verbs(struct hda_codec *codec,
 781                      const struct hda_verb *list)
 782{
 783        const struct hda_verb **v;
 784        v = snd_array_new(&codec->verbs);
 785        if (!v)
 786                return -ENOMEM;
 787        *v = list;
 788        return 0;
 789}
 790EXPORT_SYMBOL_GPL(snd_hda_add_verbs);
 791
 792/**
 793 * snd_hda_apply_verbs - Execute the init verb lists
 794 * @codec: the HDA codec
 795 */
 796void snd_hda_apply_verbs(struct hda_codec *codec)
 797{
 798        const struct hda_verb **v;
 799        int i;
 800
 801        snd_array_for_each(&codec->verbs, i, v)
 802                snd_hda_sequence_write(codec, *v);
 803}
 804EXPORT_SYMBOL_GPL(snd_hda_apply_verbs);
 805
 806/**
 807 * snd_hda_apply_pincfgs - Set each pin config in the given list
 808 * @codec: the HDA codec
 809 * @cfg: NULL-terminated pin config table
 810 */
 811void snd_hda_apply_pincfgs(struct hda_codec *codec,
 812                           const struct hda_pintbl *cfg)
 813{
 814        for (; cfg->nid; cfg++)
 815                snd_hda_codec_set_pincfg(codec, cfg->nid, cfg->val);
 816}
 817EXPORT_SYMBOL_GPL(snd_hda_apply_pincfgs);
 818
 819static void set_pin_targets(struct hda_codec *codec,
 820                            const struct hda_pintbl *cfg)
 821{
 822        for (; cfg->nid; cfg++)
 823                snd_hda_set_pin_ctl_cache(codec, cfg->nid, cfg->val);
 824}
 825
 826static void apply_fixup(struct hda_codec *codec, int id, int action, int depth)
 827{
 828        const char *modelname = codec->fixup_name;
 829
 830        while (id >= 0) {
 831                const struct hda_fixup *fix = codec->fixup_list + id;
 832
 833                if (++depth > 10)
 834                        break;
 835                if (fix->chained_before)
 836                        apply_fixup(codec, fix->chain_id, action, depth + 1);
 837
 838                switch (fix->type) {
 839                case HDA_FIXUP_PINS:
 840                        if (action != HDA_FIXUP_ACT_PRE_PROBE || !fix->v.pins)
 841                                break;
 842                        codec_dbg(codec, "%s: Apply pincfg for %s\n",
 843                                    codec->core.chip_name, modelname);
 844                        snd_hda_apply_pincfgs(codec, fix->v.pins);
 845                        break;
 846                case HDA_FIXUP_VERBS:
 847                        if (action != HDA_FIXUP_ACT_PROBE || !fix->v.verbs)
 848                                break;
 849                        codec_dbg(codec, "%s: Apply fix-verbs for %s\n",
 850                                    codec->core.chip_name, modelname);
 851                        snd_hda_add_verbs(codec, fix->v.verbs);
 852                        break;
 853                case HDA_FIXUP_FUNC:
 854                        if (!fix->v.func)
 855                                break;
 856                        codec_dbg(codec, "%s: Apply fix-func for %s\n",
 857                                    codec->core.chip_name, modelname);
 858                        fix->v.func(codec, fix, action);
 859                        break;
 860                case HDA_FIXUP_PINCTLS:
 861                        if (action != HDA_FIXUP_ACT_PROBE || !fix->v.pins)
 862                                break;
 863                        codec_dbg(codec, "%s: Apply pinctl for %s\n",
 864                                    codec->core.chip_name, modelname);
 865                        set_pin_targets(codec, fix->v.pins);
 866                        break;
 867                default:
 868                        codec_err(codec, "%s: Invalid fixup type %d\n",
 869                                   codec->core.chip_name, fix->type);
 870                        break;
 871                }
 872                if (!fix->chained || fix->chained_before)
 873                        break;
 874                id = fix->chain_id;
 875        }
 876}
 877
 878/**
 879 * snd_hda_apply_fixup - Apply the fixup chain with the given action
 880 * @codec: the HDA codec
 881 * @action: fixup action (HDA_FIXUP_ACT_XXX)
 882 */
 883void snd_hda_apply_fixup(struct hda_codec *codec, int action)
 884{
 885        if (codec->fixup_list)
 886                apply_fixup(codec, codec->fixup_id, action, 0);
 887}
 888EXPORT_SYMBOL_GPL(snd_hda_apply_fixup);
 889
 890#define IGNORE_SEQ_ASSOC (~(AC_DEFCFG_SEQUENCE | AC_DEFCFG_DEF_ASSOC))
 891
 892static bool pin_config_match(struct hda_codec *codec,
 893                             const struct hda_pintbl *pins,
 894                             bool match_all_pins)
 895{
 896        const struct hda_pincfg *pin;
 897        int i;
 898
 899        snd_array_for_each(&codec->init_pins, i, pin) {
 900                hda_nid_t nid = pin->nid;
 901                u32 cfg = pin->cfg;
 902                const struct hda_pintbl *t_pins;
 903                int found;
 904
 905                t_pins = pins;
 906                found = 0;
 907                for (; t_pins->nid; t_pins++) {
 908                        if (t_pins->nid == nid) {
 909                                found = 1;
 910                                if ((t_pins->val & IGNORE_SEQ_ASSOC) == (cfg & IGNORE_SEQ_ASSOC))
 911                                        break;
 912                                else if ((cfg & 0xf0000000) == 0x40000000 && (t_pins->val & 0xf0000000) == 0x40000000)
 913                                        break;
 914                                else
 915                                        return false;
 916                        }
 917                }
 918                if (match_all_pins &&
 919                    !found && (cfg & 0xf0000000) != 0x40000000)
 920                        return false;
 921        }
 922
 923        return true;
 924}
 925
 926/**
 927 * snd_hda_pick_pin_fixup - Pick up a fixup matching with the pin quirk list
 928 * @codec: the HDA codec
 929 * @pin_quirk: zero-terminated pin quirk list
 930 * @fixlist: the fixup list
 931 * @match_all_pins: all valid pins must match with the table entries
 932 */
 933void snd_hda_pick_pin_fixup(struct hda_codec *codec,
 934                            const struct snd_hda_pin_quirk *pin_quirk,
 935                            const struct hda_fixup *fixlist,
 936                            bool match_all_pins)
 937{
 938        const struct snd_hda_pin_quirk *pq;
 939
 940        if (codec->fixup_id != HDA_FIXUP_ID_NOT_SET)
 941                return;
 942
 943        for (pq = pin_quirk; pq->subvendor; pq++) {
 944                if ((codec->core.subsystem_id & 0xffff0000) != (pq->subvendor << 16))
 945                        continue;
 946                if (codec->core.vendor_id != pq->codec)
 947                        continue;
 948                if (pin_config_match(codec, pq->pins, match_all_pins)) {
 949                        codec->fixup_id = pq->value;
 950#ifdef CONFIG_SND_DEBUG_VERBOSE
 951                        codec->fixup_name = pq->name;
 952                        codec_dbg(codec, "%s: picked fixup %s (pin match)\n",
 953                                  codec->core.chip_name, codec->fixup_name);
 954#endif
 955                        codec->fixup_list = fixlist;
 956                        return;
 957                }
 958        }
 959}
 960EXPORT_SYMBOL_GPL(snd_hda_pick_pin_fixup);
 961
 962/**
 963 * snd_hda_pick_fixup - Pick up a fixup matching with PCI/codec SSID or model string
 964 * @codec: the HDA codec
 965 * @models: NULL-terminated model string list
 966 * @quirk: zero-terminated PCI/codec SSID quirk list
 967 * @fixlist: the fixup list
 968 *
 969 * Pick up a fixup entry matching with the given model string or SSID.
 970 * If a fixup was already set beforehand, the function doesn't do anything.
 971 * When a special model string "nofixup" is given, also no fixup is applied.
 972 *
 973 * The function tries to find the matching model name at first, if given.
 974 * If nothing matched, try to look up the PCI SSID.
 975 * If still nothing matched, try to look up the codec SSID.
 976 */
 977void snd_hda_pick_fixup(struct hda_codec *codec,
 978                        const struct hda_model_fixup *models,
 979                        const struct snd_pci_quirk *quirk,
 980                        const struct hda_fixup *fixlist)
 981{
 982        const struct snd_pci_quirk *q;
 983        int id = HDA_FIXUP_ID_NOT_SET;
 984        const char *name = NULL;
 985
 986        if (codec->fixup_id != HDA_FIXUP_ID_NOT_SET)
 987                return;
 988
 989        /* when model=nofixup is given, don't pick up any fixups */
 990        if (codec->modelname && !strcmp(codec->modelname, "nofixup")) {
 991                codec->fixup_list = NULL;
 992                codec->fixup_name = NULL;
 993                codec->fixup_id = HDA_FIXUP_ID_NO_FIXUP;
 994                codec_dbg(codec, "%s: picked no fixup (nofixup specified)\n",
 995                          codec->core.chip_name);
 996                return;
 997        }
 998
 999        if (codec->modelname && models) {
1000                while (models->name) {
1001                        if (!strcmp(codec->modelname, models->name)) {
1002                                codec->fixup_id = models->id;
1003                                codec->fixup_name = models->name;
1004                                codec->fixup_list = fixlist;
1005                                codec_dbg(codec, "%s: picked fixup %s (model specified)\n",
1006                                          codec->core.chip_name, codec->fixup_name);
1007                                return;
1008                        }
1009                        models++;
1010                }
1011        }
1012        if (quirk) {
1013                q = snd_pci_quirk_lookup(codec->bus->pci, quirk);
1014                if (q) {
1015                        id = q->value;
1016#ifdef CONFIG_SND_DEBUG_VERBOSE
1017                        name = q->name;
1018                        codec_dbg(codec, "%s: picked fixup %s (PCI SSID%s)\n",
1019                                  codec->core.chip_name, name, q->subdevice_mask ? "" : " - vendor generic");
1020#endif
1021                }
1022        }
1023        if (id < 0 && quirk) {
1024                for (q = quirk; q->subvendor || q->subdevice; q++) {
1025                        unsigned int vendorid =
1026                                q->subdevice | (q->subvendor << 16);
1027                        unsigned int mask = 0xffff0000 | q->subdevice_mask;
1028                        if ((codec->core.subsystem_id & mask) == (vendorid & mask)) {
1029                                id = q->value;
1030#ifdef CONFIG_SND_DEBUG_VERBOSE
1031                                name = q->name;
1032                                codec_dbg(codec, "%s: picked fixup %s (codec SSID)\n",
1033                                          codec->core.chip_name, name);
1034#endif
1035                                break;
1036                        }
1037                }
1038        }
1039
1040        codec->fixup_id = id;
1041        if (id >= 0) {
1042                codec->fixup_list = fixlist;
1043                codec->fixup_name = name;
1044        }
1045}
1046EXPORT_SYMBOL_GPL(snd_hda_pick_fixup);
1047