LXR linux/include/sound/simple_card

   1/* SPDX-License-Identifier: GPL-2.0
   2 *
   3 * simple_card_utils.h
   4 *
   5 * Copyright (c) 2016 Kuninori Morimoto <kuninori.morimoto.gx@renesas.com>
   6 */
   7
   8#ifndef __SIMPLE_CARD_UTILS_H
   9#define __SIMPLE_CARD_UTILS_H
  10
  11#include <linux/clk.h>
  12#include <sound/soc.h>
  13
  14#define asoc_simple_init_hp(card, sjack, prefix) \
  15        asoc_simple_init_jack(card, sjack, 1, prefix)
  16#define asoc_simple_init_mic(card, sjack, prefix) \
  17        asoc_simple_init_jack(card, sjack, 0, prefix)
  18
  19struct asoc_simple_dai {
  20        const char *name;
  21        unsigned int sysclk;
  22        int clk_direction;
  23        int slots;
  24        int slot_width;
  25        unsigned int tx_slot_mask;
  26        unsigned int rx_slot_mask;
  27        struct clk *clk;
  28};
  29
  30struct asoc_simple_data {
  31        u32 convert_rate;
  32        u32 convert_channels;
  33};
  34
  35struct asoc_simple_jack {
  36        struct snd_soc_jack jack;
  37        struct snd_soc_jack_pin pin;
  38        struct snd_soc_jack_gpio gpio;
  39};
  40
  41struct asoc_simple_priv {
  42        struct snd_soc_card snd_card;
  43        struct simple_dai_props {
  44                struct asoc_simple_dai *cpu_dai;
  45                struct asoc_simple_dai *codec_dai;
  46                struct snd_soc_dai_link_component cpus;   /* single cpu */
  47                struct snd_soc_dai_link_component codecs; /* single codec */
  48                struct snd_soc_dai_link_component platforms;
  49                struct asoc_simple_data adata;
  50                struct snd_soc_codec_conf *codec_conf;
  51                unsigned int mclk_fs;
  52        } *dai_props;
  53        struct asoc_simple_jack hp_jack;
  54        struct asoc_simple_jack mic_jack;
  55        struct snd_soc_dai_link *dai_link;
  56        struct asoc_simple_dai *dais;
  57        struct snd_soc_codec_conf *codec_conf;
  58        struct gpio_desc *pa_gpio;
  59};
  60#define simple_priv_to_card(priv)       (&(priv)->snd_card)
  61#define simple_priv_to_props(priv, i)   ((priv)->dai_props + (i))
  62#define simple_priv_to_dev(priv)        (simple_priv_to_card(priv)->dev)
  63#define simple_priv_to_link(priv, i)    (simple_priv_to_card(priv)->dai_link + (i))
  64
  65struct link_info {
  66        int dais; /* number of dai  */
  67        int link; /* number of link */
  68        int conf; /* number of codec_conf */
  69        int cpu;  /* turn for CPU / Codec */
  70};
  71
  72int asoc_simple_parse_daifmt(struct device *dev,
  73                             struct device_node *node,
  74                             struct device_node *codec,
  75                             char *prefix,
  76                             unsigned int *retfmt);
  77__printf(3, 4)
  78int asoc_simple_set_dailink_name(struct device *dev,
  79                                 struct snd_soc_dai_link *dai_link,
  80                                 const char *fmt, ...);
  81int asoc_simple_parse_card_name(struct snd_soc_card *card,
  82                                char *prefix);
  83
  84#define asoc_simple_parse_clk_cpu(dev, node, dai_link, simple_dai)              \
  85        asoc_simple_parse_clk(dev, node, simple_dai, dai_link->cpus)
  86#define asoc_simple_parse_clk_codec(dev, node, dai_link, simple_dai)    \
  87        asoc_simple_parse_clk(dev, node, simple_dai, dai_link->codecs)
  88int asoc_simple_parse_clk(struct device *dev,
  89                          struct device_node *node,
  90                          struct asoc_simple_dai *simple_dai,
  91                          struct snd_soc_dai_link_component *dlc);
  92int asoc_simple_startup(struct snd_pcm_substream *substream);
  93void asoc_simple_shutdown(struct snd_pcm_substream *substream);
  94int asoc_simple_hw_params(struct snd_pcm_substream *substream,
  95                          struct snd_pcm_hw_params *params);
  96int asoc_simple_dai_init(struct snd_soc_pcm_runtime *rtd);
  97int asoc_simple_be_hw_params_fixup(struct snd_soc_pcm_runtime *rtd,
  98                                   struct snd_pcm_hw_params *params);
  99
 100#define asoc_simple_parse_cpu(node, dai_link, is_single_link)   \
 101        asoc_simple_parse_dai(node, dai_link->cpus, is_single_link)
 102#define asoc_simple_parse_codec(node, dai_link) \
 103        asoc_simple_parse_dai(node, dai_link->codecs, NULL)
 104#define asoc_simple_parse_platform(node, dai_link)      \
 105        asoc_simple_parse_dai(node, dai_link->platforms, NULL)
 106
 107#define asoc_simple_parse_tdm(np, dai)                  \
 108        snd_soc_of_parse_tdm_slot(np,   &(dai)->tx_slot_mask,   \
 109                                        &(dai)->rx_slot_mask,   \
 110                                        &(dai)->slots,          \
 111                                        &(dai)->slot_width);
 112
 113void asoc_simple_canonicalize_platform(struct snd_soc_dai_link *dai_link);
 114void asoc_simple_canonicalize_cpu(struct snd_soc_dai_link *dai_link,
 115                                      int is_single_links);
 116
 117int asoc_simple_clean_reference(struct snd_soc_card *card);
 118
 119void asoc_simple_convert_fixup(struct asoc_simple_data *data,
 120                                      struct snd_pcm_hw_params *params);
 121void asoc_simple_parse_convert(struct device *dev,
 122                               struct device_node *np, char *prefix,
 123                               struct asoc_simple_data *data);
 124
 125int asoc_simple_parse_routing(struct snd_soc_card *card,
 126                                      char *prefix);
 127int asoc_simple_parse_widgets(struct snd_soc_card *card,
 128                                      char *prefix);
 129int asoc_simple_parse_pin_switches(struct snd_soc_card *card,
 130                                   char *prefix);
 131
 132int asoc_simple_init_jack(struct snd_soc_card *card,
 133                               struct asoc_simple_jack *sjack,
 134                               int is_hp, char *prefix);
 135int asoc_simple_init_priv(struct asoc_simple_priv *priv,
 136                               struct link_info *li);
 137
 138#ifdef DEBUG
 139static inline void asoc_simple_debug_dai(struct asoc_simple_priv *priv,
 140                                         char *name,
 141                                         struct asoc_simple_dai *dai)
 142{
 143        struct device *dev = simple_priv_to_dev(priv);
 144
 145        /* dai might be NULL */
 146        if (!dai)
 147                return;
 148
 149        if (dai->name)
 150                dev_dbg(dev, "%s dai name = %s\n",
 151                        name, dai->name);
 152        if (dai->sysclk)
 153                dev_dbg(dev, "%s sysclk = %d\n",
 154                        name, dai->sysclk);
 155
 156        dev_dbg(dev, "%s direction = %s\n",
 157                name, dai->clk_direction ? "OUT" : "IN");
 158
 159        if (dai->slots)
 160                dev_dbg(dev, "%s slots = %d\n", name, dai->slots);
 161        if (dai->slot_width)
 162                dev_dbg(dev, "%s slot width = %d\n", name, dai->slot_width);
 163        if (dai->tx_slot_mask)
 164                dev_dbg(dev, "%s tx slot mask = %d\n", name, dai->tx_slot_mask);
 165        if (dai->rx_slot_mask)
 166                dev_dbg(dev, "%s rx slot mask = %d\n", name, dai->rx_slot_mask);
 167        if (dai->clk)
 168                dev_dbg(dev, "%s clk %luHz\n", name, clk_get_rate(dai->clk));
 169}
 170
 171static inline void asoc_simple_debug_info(struct asoc_simple_priv *priv)
 172{
 173        struct snd_soc_card *card = simple_priv_to_card(priv);
 174        struct device *dev = simple_priv_to_dev(priv);
 175
 176        int i;
 177
 178        if (card->name)
 179                dev_dbg(dev, "Card Name: %s\n", card->name);
 180
 181        for (i = 0; i < card->num_links; i++) {
 182                struct simple_dai_props *props = simple_priv_to_props(priv, i);
 183                struct snd_soc_dai_link *link = simple_priv_to_link(priv, i);
 184
 185                dev_dbg(dev, "DAI%d\n", i);
 186
 187                asoc_simple_debug_dai(priv, "cpu", props->cpu_dai);
 188                asoc_simple_debug_dai(priv, "codec", props->codec_dai);
 189
 190                if (link->name)
 191                        dev_dbg(dev, "dai name = %s\n", link->name);
 192
 193                dev_dbg(dev, "dai format = %04x\n", link->dai_fmt);
 194
 195                if (props->adata.convert_rate)
 196                        dev_dbg(dev, "convert_rate = %d\n",
 197                                props->adata.convert_rate);
 198                if (props->adata.convert_channels)
 199                        dev_dbg(dev, "convert_channels = %d\n",
 200                                props->adata.convert_channels);
 201                if (props->codec_conf && props->codec_conf->name_prefix)
 202                        dev_dbg(dev, "name prefix = %s\n",
 203                                props->codec_conf->name_prefix);
 204                if (props->mclk_fs)
 205                        dev_dbg(dev, "mclk-fs = %d\n",
 206                                props->mclk_fs);
 207        }
 208}
 209#else
 210#define  asoc_simple_debug_info(priv)
 211#endif /* DEBUG */
 212
 213#endif /* __SIMPLE_CARD_UTILS_H */
 214