sound/soc/generic/simple-card.c

   1 /*
   2  * ASoC simple sound card support
   3  *
   4  * Copyright (C) 2012 Renesas Solutions Corp.
   5  * Kuninori Morimoto <kuninori.morimoto.gx@renesas.com>
   6  *
   7  * This program is free software; you can redistribute it and/or modify
   8  * it under the terms of the GNU General Public License version 2 as
   9  * published by the Free Software Foundation.
  10  */
  11 #include <linux/clk.h>
  12 #include <linux/device.h>
  13 #include <linux/gpio.h>
  14 #include <linux/module.h>
  15 #include <linux/of.h>
  16 #include <linux/of_gpio.h>
  17 #include <linux/platform_device.h>
  18 #include <linux/string.h>
  19 #include <sound/jack.h>
  20 #include <sound/simple_card.h>
  21 #include <sound/soc-dai.h>
  22 #include <sound/soc.h>
  23
  24 struct asoc_simple_jack {
  25         struct snd_soc_jack jack;
  26         struct snd_soc_jack_pin pin;
  27         struct snd_soc_jack_gpio gpio;
  28 };
  29
  30 struct simple_card_data {
  31         struct snd_soc_card snd_card;
  32         struct simple_dai_props {
  33                 struct asoc_simple_dai cpu_dai;
  34                 struct asoc_simple_dai codec_dai;
  35                 unsigned int mclk_fs;
  36         } *dai_props;
  37         unsigned int mclk_fs;
  38         struct asoc_simple_jack hp_jack;
  39         struct asoc_simple_jack mic_jack;
  40         struct snd_soc_dai_link dai_link[];     /* dynamically allocated */
  41 };
  42
  43 #define simple_priv_to_dev(priv) ((priv)->snd_card.dev)
  44 #define simple_priv_to_link(priv, i) ((priv)->snd_card.dai_link + i)
  45 #define simple_priv_to_props(priv, i) ((priv)->dai_props + i)
  46
  47 #define PREFIX  "simple-audio-card,"
  48
  49 #define asoc_simple_card_init_hp(card, sjack, prefix)\
  50         asoc_simple_card_init_jack(card, sjack, 1, prefix)
  51 #define asoc_simple_card_init_mic(card, sjack, prefix)\
  52         asoc_simple_card_init_jack(card, sjack, 0, prefix)
  53 static int asoc_simple_card_init_jack(struct snd_soc_card *card,
  54                                       struct asoc_simple_jack *sjack,
  55                                       int is_hp, char *prefix)
  56 {
  57         struct device *dev = card->dev;
  58         enum of_gpio_flags flags;
  59         char prop[128];
  60         char *pin_name;
  61         char *gpio_name;
  62         int mask;
  63         int det;
  64
  65         sjack->gpio.gpio = -ENOENT;
  66
  67         if (is_hp) {
  68                 snprintf(prop, sizeof(prop), "%shp-det-gpio", prefix);
  69                 pin_name        = "Headphones";
  70                 gpio_name       = "Headphone detection";
  71                 mask            = SND_JACK_HEADPHONE;
  72         } else {
  73                 snprintf(prop, sizeof(prop), "%smic-det-gpio", prefix);
  74                 pin_name        = "Mic Jack";
  75                 gpio_name       = "Mic detection";
  76                 mask            = SND_JACK_MICROPHONE;
  77         }
  78
  79         det = of_get_named_gpio_flags(dev->of_node, prop, 0, &flags);
  80         if (det == -EPROBE_DEFER)
  81                 return -EPROBE_DEFER;
  82
  83         if (gpio_is_valid(det)) {
  84                 sjack->pin.pin          = pin_name;
  85                 sjack->pin.mask         = mask;
  86
  87                 sjack->gpio.name        = gpio_name;
  88                 sjack->gpio.report      = mask;
  89                 sjack->gpio.gpio        = det;
  90                 sjack->gpio.invert      = !!(flags & OF_GPIO_ACTIVE_LOW);
  91                 sjack->gpio.debounce_time = 150;
  92
  93                 snd_soc_card_jack_new(card, pin_name, mask,
  94                                       &sjack->jack,
  95                                       &sjack->pin, 1);
  96
  97                 snd_soc_jack_add_gpios(&sjack->jack, 1,
  98                                        &sjack->gpio);
  99         }
 100
 101         return 0;
 102 }
 103
 104 static void asoc_simple_card_remove_jack(struct asoc_simple_jack *sjack)
 105 {
 106         if (gpio_is_valid(sjack->gpio.gpio))
 107                 snd_soc_jack_free_gpios(&sjack->jack, 1, &sjack->gpio);
 108 }
 109
 110 static int asoc_simple_card_startup(struct snd_pcm_substream *substream)
 111 {
 112         struct snd_soc_pcm_runtime *rtd = substream->private_data;
 113         struct simple_card_data *priv = snd_soc_card_get_drvdata(rtd->card);
 114         struct simple_dai_props *dai_props =
 115                 &priv->dai_props[rtd->num];
 116         int ret;
 117
 118         ret = clk_prepare_enable(dai_props->cpu_dai.clk);
 119         if (ret)
 120                 return ret;
 121
 122         ret = clk_prepare_enable(dai_props->codec_dai.clk);
 123         if (ret)
 124                 clk_disable_unprepare(dai_props->cpu_dai.clk);
 125
 126         return ret;
 127 }
 128
 129 static void asoc_simple_card_shutdown(struct snd_pcm_substream *substream)
 130 {
 131         struct snd_soc_pcm_runtime *rtd = substream->private_data;
 132         struct simple_card_data *priv = snd_soc_card_get_drvdata(rtd->card);
 133         struct simple_dai_props *dai_props =
 134                 &priv->dai_props[rtd->num];
 135
 136         clk_disable_unprepare(dai_props->cpu_dai.clk);
 137
 138         clk_disable_unprepare(dai_props->codec_dai.clk);
 139 }
 140
 141 static int asoc_simple_card_hw_params(struct snd_pcm_substream *substream,
 142                                       struct snd_pcm_hw_params *params)
 143 {
 144         struct snd_soc_pcm_runtime *rtd = substream->private_data;
 145         struct snd_soc_dai *codec_dai = rtd->codec_dai;
 146         struct snd_soc_dai *cpu_dai = rtd->cpu_dai;
 147         struct simple_card_data *priv = snd_soc_card_get_drvdata(rtd->card);
 148         struct simple_dai_props *dai_props = &priv->dai_props[rtd->num];
 149         unsigned int mclk, mclk_fs = 0;
 150         int ret = 0;
 151
 152         if (priv->mclk_fs)
 153                 mclk_fs = priv->mclk_fs;
 154         else if (dai_props->mclk_fs)
 155                 mclk_fs = dai_props->mclk_fs;
 156
 157         if (mclk_fs) {
 158                 mclk = params_rate(params) * mclk_fs;
 159                 ret = snd_soc_dai_set_sysclk(codec_dai, 0, mclk,
 160                                              SND_SOC_CLOCK_IN);
 161                 if (ret && ret != -ENOTSUPP)
 162                         goto err;
 163
 164                 ret = snd_soc_dai_set_sysclk(cpu_dai, 0, mclk,
 165                                              SND_SOC_CLOCK_OUT);
 166                 if (ret && ret != -ENOTSUPP)
 167                         goto err;
 168         }
 169         return 0;
 170 err:
 171         return ret;
 172 }
 173
 174 static struct snd_soc_ops asoc_simple_card_ops = {
 175         .startup = asoc_simple_card_startup,
 176         .shutdown = asoc_simple_card_shutdown,
 177         .hw_params = asoc_simple_card_hw_params,
 178 };
 179
 180 static int __asoc_simple_card_dai_init(struct snd_soc_dai *dai,
 181                                        struct asoc_simple_dai *set)
 182 {
 183         int ret;
 184
 185         if (set->sysclk) {
 186                 ret = snd_soc_dai_set_sysclk(dai, 0, set->sysclk, 0);
 187                 if (ret && ret != -ENOTSUPP) {
 188                         dev_err(dai->dev, "simple-card: set_sysclk error\n");
 189                         goto err;
 190                 }
 191         }
 192
 193         if (set->slots) {
 194                 ret = snd_soc_dai_set_tdm_slot(dai,
 195                                                set->tx_slot_mask,
 196                                                set->rx_slot_mask,
 197                                                 set->slots,
 198                                                 set->slot_width);
 199                 if (ret && ret != -ENOTSUPP) {
 200                         dev_err(dai->dev, "simple-card: set_tdm_slot error\n");
 201                         goto err;
 202                 }
 203         }
 204
 205         ret = 0;
 206
 207 err:
 208         return ret;
 209 }
 210
 211 static int asoc_simple_card_dai_init(struct snd_soc_pcm_runtime *rtd)
 212 {
 213         struct simple_card_data *priv = snd_soc_card_get_drvdata(rtd->card);
 214         struct snd_soc_dai *codec = rtd->codec_dai;
 215         struct snd_soc_dai *cpu = rtd->cpu_dai;
 216         struct simple_dai_props *dai_props;
 217         int ret;
 218
 219         dai_props = &priv->dai_props[rtd->num];
 220         ret = __asoc_simple_card_dai_init(codec, &dai_props->codec_dai);
 221         if (ret < 0)
 222                 return ret;
 223
 224         ret = __asoc_simple_card_dai_init(cpu, &dai_props->cpu_dai);
 225         if (ret < 0)
 226                 return ret;
 227
 228         ret = asoc_simple_card_init_hp(rtd->card, &priv->hp_jack, PREFIX);
 229         if (ret < 0)
 230                 return ret;
 231
 232         ret = asoc_simple_card_init_mic(rtd->card, &priv->hp_jack, PREFIX);
 233         if (ret < 0)
 234                 return ret;
 235
 236         return 0;
 237 }
 238
 239 static int
 240 asoc_simple_card_sub_parse_of(struct device_node *np,
 241                               struct asoc_simple_dai *dai,
 242                               struct device_node **p_node,
 243                               const char **name,
 244                               int *args_count)
 245 {
 246         struct of_phandle_args args;
 247         struct clk *clk;
 248         u32 val;
 249         int ret;
 250
 251         if (!np)
 252                 return 0;
 253
 254         /*
 255          * Get node via "sound-dai = <&phandle port>"
 256          * it will be used as xxx_of_node on soc_bind_dai_link()
 257          */
 258         ret = of_parse_phandle_with_args(np, "sound-dai",
 259                                          "#sound-dai-cells", 0, &args);
 260         if (ret)
 261                 return ret;
 262
 263         *p_node = args.np;
 264
 265         if (args_count)
 266                 *args_count = args.args_count;
 267
 268         /* Get dai->name */
 269         if (name) {
 270                 ret = snd_soc_of_get_dai_name(np, name);
 271                 if (ret < 0)
 272                         return ret;
 273         }
 274
 275         if (!dai)
 276                 return 0;
 277
 278         /* Parse TDM slot */
 279         ret = snd_soc_of_parse_tdm_slot(np, &dai->tx_slot_mask,
 280                                         &dai->rx_slot_mask,
 281                                         &dai->slots, &dai->slot_width);
 282         if (ret)
 283                 return ret;
 284
 285         /*
 286          * Parse dai->sysclk come from "clocks = <&xxx>"
 287          * (if system has common clock)
 288          *  or "system-clock-frequency = <xxx>"
 289          *  or device's module clock.
 290          */
 291         if (of_property_read_bool(np, "clocks")) {
 292                 clk = of_clk_get(np, 0);
 293                 if (IS_ERR(clk)) {
 294                         ret = PTR_ERR(clk);
 295                         return ret;
 296                 }
 297
 298                 dai->sysclk = clk_get_rate(clk);
 299                 dai->clk = clk;
 300         } else if (!of_property_read_u32(np, "system-clock-frequency", &val)) {
 301                 dai->sysclk = val;
 302         } else {
 303                 clk = of_clk_get(args.np, 0);
 304                 if (!IS_ERR(clk))
 305                         dai->sysclk = clk_get_rate(clk);
 306         }
 307
 308         return 0;
 309 }
 310
 311 static int asoc_simple_card_dai_link_of(struct device_node *node,
 312                                         struct simple_card_data *priv,
 313                                         int idx,
 314                                         bool is_top_level_node)
 315 {
 316         struct device *dev = simple_priv_to_dev(priv);
 317         struct snd_soc_dai_link *dai_link = simple_priv_to_link(priv, idx);
 318         struct simple_dai_props *dai_props = simple_priv_to_props(priv, idx);
 319         struct device_node *cpu = NULL;
 320         struct device_node *plat = NULL;
 321         struct device_node *codec = NULL;
 322         char prop[128];
 323         char *prefix = "";
 324         int ret, cpu_args;
 325         u32 val;
 326
 327         /* For single DAI link & old style of DT node */
 328         if (is_top_level_node)
 329                 prefix = PREFIX;
 330
 331         snprintf(prop, sizeof(prop), "%scpu", prefix);
 332         cpu = of_get_child_by_name(node, prop);
 333
 334         snprintf(prop, sizeof(prop), "%splat", prefix);
 335         plat = of_get_child_by_name(node, prop);
 336
 337         snprintf(prop, sizeof(prop), "%scodec", prefix);
 338         codec = of_get_child_by_name(node, prop);
 339
 340         if (!cpu || !codec) {
 341                 ret = -EINVAL;
 342                 dev_err(dev, "%s: Can't find %s DT node\n", __func__, prop);
 343                 goto dai_link_of_err;
 344         }
 345
 346         ret = asoc_simple_card_parse_daifmt(dev, node, codec,
 347                                             prefix, &dai_link->dai_fmt);
 348         if (ret < 0)
 349                 goto dai_link_of_err;
 350
 351         if (!of_property_read_u32(node, "mclk-fs", &val))
 352                 dai_props->mclk_fs = val;
 353
 354         ret = asoc_simple_card_sub_parse_of(cpu, &dai_props->cpu_dai,
 355                                             &dai_link->cpu_of_node,
 356                                             &dai_link->cpu_dai_name,
 357                                             &cpu_args);
 358         if (ret < 0)
 359                 goto dai_link_of_err;
 360
 361         ret = asoc_simple_card_sub_parse_of(codec, &dai_props->codec_dai,
 362                                             &dai_link->codec_of_node,
 363                                             &dai_link->codec_dai_name, NULL);
 364         if (ret < 0)
 365                 goto dai_link_of_err;
 366
 367         ret = asoc_simple_card_sub_parse_of(plat, NULL,
 368                                             &dai_link->platform_of_node,
 369                                             NULL, NULL);
 370         if (ret < 0)
 371                 goto dai_link_of_err;
 372
 373         if (!dai_link->cpu_dai_name || !dai_link->codec_dai_name) {
 374                 ret = -EINVAL;
 375                 goto dai_link_of_err;
 376         }
 377
 378         /* Assumes platform == cpu */
 379         if (!dai_link->platform_of_node)
 380                 dai_link->platform_of_node = dai_link->cpu_of_node;
 381
 382         ret = asoc_simple_card_set_dailink_name(dev, dai_link,
 383                                                 "%s-%s",
 384                                                 dai_link->cpu_dai_name,
 385                                                 dai_link->codec_dai_name);
 386         if (ret < 0)
 387                 goto dai_link_of_err;
 388
 389         dai_link->ops = &asoc_simple_card_ops;
 390         dai_link->init = asoc_simple_card_dai_init;
 391
 392         dev_dbg(dev, "\tname : %s\n", dai_link->stream_name);
 393         dev_dbg(dev, "\tformat : %04x\n", dai_link->dai_fmt);
 394         dev_dbg(dev, "\tcpu : %s / %d\n",
 395                 dai_link->cpu_dai_name,
 396                 dai_props->cpu_dai.sysclk);
 397         dev_dbg(dev, "\tcodec : %s / %d\n",
 398                 dai_link->codec_dai_name,
 399                 dai_props->codec_dai.sysclk);
 400
 401         /*
 402          * In soc_bind_dai_link() will check cpu name after
 403          * of_node matching if dai_link has cpu_dai_name.
 404          * but, it will never match if name was created by
 405          * fmt_single_name() remove cpu_dai_name if cpu_args
 406          * was 0. See:
 407          *      fmt_single_name()
 408          *      fmt_multiple_name()
 409          */
 410         if (!cpu_args)
 411                 dai_link->cpu_dai_name = NULL;
 412
 413 dai_link_of_err:
 414         of_node_put(cpu);
 415         of_node_put(codec);
 416
 417         return ret;
 418 }
 419
 420 static int asoc_simple_card_parse_of(struct device_node *node,
 421                                      struct simple_card_data *priv)
 422 {
 423         struct device *dev = simple_priv_to_dev(priv);
 424         u32 val;
 425         int ret;
 426
 427         if (!node)
 428                 return -EINVAL;
 429
 430         /* Parse the card name from DT */
 431         snd_soc_of_parse_card_name(&priv->snd_card, PREFIX "name");
 432
 433         /* The off-codec widgets */
 434         if (of_property_read_bool(node, PREFIX "widgets")) {
 435                 ret = snd_soc_of_parse_audio_simple_widgets(&priv->snd_card,
 436                                         PREFIX "widgets");
 437                 if (ret)
 438                         return ret;
 439         }
 440
 441         /* DAPM routes */
 442         if (of_property_read_bool(node, PREFIX "routing")) {
 443                 ret = snd_soc_of_parse_audio_routing(&priv->snd_card,
 444                                         PREFIX "routing");
 445                 if (ret)
 446                         return ret;
 447         }
 448
 449         /* Factor to mclk, used in hw_params() */
 450         ret = of_property_read_u32(node, PREFIX "mclk-fs", &val);
 451         if (ret == 0)
 452                 priv->mclk_fs = val;
 453
 454         dev_dbg(dev, "New simple-card: %s\n", priv->snd_card.name ?
 455                 priv->snd_card.name : "");
 456
 457         /* Single/Muti DAI link(s) & New style of DT node */
 458         if (of_get_child_by_name(node, PREFIX "dai-link")) {
 459                 struct device_node *np = NULL;
 460                 int i = 0;
 461
 462                 for_each_child_of_node(node, np) {
 463                         dev_dbg(dev, "\tlink %d:\n", i);
 464                         ret = asoc_simple_card_dai_link_of(np, priv,
 465                                                            i, false);
 466                         if (ret < 0) {
 467                                 of_node_put(np);
 468                                 return ret;
 469                         }
 470                         i++;
 471                 }
 472         } else {
 473                 /* For single DAI link & old style of DT node */
 474                 ret = asoc_simple_card_dai_link_of(node, priv, 0, true);
 475                 if (ret < 0)
 476                         return ret;
 477         }
 478
 479         if (!priv->snd_card.name)
 480                 priv->snd_card.name = priv->snd_card.dai_link->name;
 481
 482         return 0;
 483 }
 484
 485 /* Decrease the reference count of the device nodes */
 486 static int asoc_simple_card_unref(struct snd_soc_card *card)
 487 {
 488         struct snd_soc_dai_link *dai_link;
 489         int num_links;
 490
 491         for (num_links = 0, dai_link = card->dai_link;
 492              num_links < card->num_links;
 493              num_links++, dai_link++) {
 494                 of_node_put(dai_link->cpu_of_node);
 495                 of_node_put(dai_link->codec_of_node);
 496         }
 497         return 0;
 498 }
 499
 500 static int asoc_simple_card_probe(struct platform_device *pdev)
 501 {
 502         struct simple_card_data *priv;
 503         struct snd_soc_dai_link *dai_link;
 504         struct device_node *np = pdev->dev.of_node;
 505         struct device *dev = &pdev->dev;
 506         int num_links, ret;
 507
 508         /* Get the number of DAI links */
 509         if (np && of_get_child_by_name(np, PREFIX "dai-link"))
 510                 num_links = of_get_child_count(np);
 511         else
 512                 num_links = 1;
 513
 514         /* Allocate the private data and the DAI link array */
 515         priv = devm_kzalloc(dev,
 516                         sizeof(*priv) + sizeof(*dai_link) * num_links,
 517                         GFP_KERNEL);
 518         if (!priv)
 519                 return -ENOMEM;
 520
 521         /* Init snd_soc_card */
 522         priv->snd_card.owner = THIS_MODULE;
 523         priv->snd_card.dev = dev;
 524         dai_link = priv->dai_link;
 525         priv->snd_card.dai_link = dai_link;
 526         priv->snd_card.num_links = num_links;
 527
 528         /* Get room for the other properties */
 529         priv->dai_props = devm_kzalloc(dev,
 530                         sizeof(*priv->dai_props) * num_links,
 531                         GFP_KERNEL);
 532         if (!priv->dai_props)
 533                 return -ENOMEM;
 534
 535         if (np && of_device_is_available(np)) {
 536
 537                 ret = asoc_simple_card_parse_of(np, priv);
 538                 if (ret < 0) {
 539                         if (ret != -EPROBE_DEFER)
 540                                 dev_err(dev, "parse error %d\n", ret);
 541                         goto err;
 542                 }
 543
 544         } else {
 545                 struct asoc_simple_card_info *cinfo;
 546
 547                 cinfo = dev->platform_data;
 548                 if (!cinfo) {
 549                         dev_err(dev, "no info for asoc-simple-card\n");
 550                         return -EINVAL;
 551                 }
 552
 553                 if (!cinfo->name ||
 554                     !cinfo->codec_dai.name ||
 555                     !cinfo->codec ||
 556                     !cinfo->platform ||
 557                     !cinfo->cpu_dai.name) {
 558                         dev_err(dev, "insufficient asoc_simple_card_info settings\n");
 559                         return -EINVAL;
 560                 }
 561
 562                 priv->snd_card.name     = (cinfo->card) ? cinfo->card : cinfo->name;
 563                 dai_link->name          = cinfo->name;
 564                 dai_link->stream_name   = cinfo->name;
 565                 dai_link->platform_name = cinfo->platform;
 566                 dai_link->codec_name    = cinfo->codec;
 567                 dai_link->cpu_dai_name  = cinfo->cpu_dai.name;
 568                 dai_link->codec_dai_name = cinfo->codec_dai.name;
 569                 dai_link->dai_fmt       = cinfo->daifmt;
 570                 dai_link->init          = asoc_simple_card_dai_init;
 571                 memcpy(&priv->dai_props->cpu_dai, &cinfo->cpu_dai,
 572                                         sizeof(priv->dai_props->cpu_dai));
 573                 memcpy(&priv->dai_props->codec_dai, &cinfo->codec_dai,
 574                                         sizeof(priv->dai_props->codec_dai));
 575
 576         }
 577
 578         snd_soc_card_set_drvdata(&priv->snd_card, priv);
 579
 580         ret = devm_snd_soc_register_card(&pdev->dev, &priv->snd_card);
 581         if (ret >= 0)
 582                 return ret;
 583
 584 err:
 585         asoc_simple_card_unref(&priv->snd_card);
 586         return ret;
 587 }
 588
 589 static int asoc_simple_card_remove(struct platform_device *pdev)
 590 {
 591         struct snd_soc_card *card = platform_get_drvdata(pdev);
 592         struct simple_card_data *priv = snd_soc_card_get_drvdata(card);
 593
 594         asoc_simple_card_remove_jack(&priv->hp_jack);
 595         asoc_simple_card_remove_jack(&priv->mic_jack);
 596
 597         return asoc_simple_card_unref(card);
 598 }
 599
 600 static const struct of_device_id asoc_simple_of_match[] = {
 601         { .compatible = "simple-audio-card", },
 602         {},
 603 };
 604 MODULE_DEVICE_TABLE(of, asoc_simple_of_match);
 605
 606 static struct platform_driver asoc_simple_card = {
 607         .driver = {
 608                 .name = "asoc-simple-card",
 609                 .pm = &snd_soc_pm_ops,
 610                 .of_match_table = asoc_simple_of_match,
 611         },
 612         .probe = asoc_simple_card_probe,
 613         .remove = asoc_simple_card_remove,
 614 };
 615
 616 module_platform_driver(asoc_simple_card);
 617
 618 MODULE_ALIAS("platform:asoc-simple-card");
 619 MODULE_LICENSE("GPL");
 620 MODULE_DESCRIPTION("ASoC Simple Sound Card");
 621 MODULE_AUTHOR("Kuninori Morimoto <kuninori.morimoto.gx@renesas.com>");