Linux Audio

Check our new training course

Loading...
  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 simple_util_init_hp(card, sjack, prefix)		\
 15	simple_util_init_jack(card, sjack, 1, prefix, NULL)
 16#define simple_util_init_mic(card, sjack, prefix)		\
 17	simple_util_init_jack(card, sjack, 0, prefix, NULL)
 18
 19struct simple_util_tdm_width_map {
 20	u8 sample_bits;
 21	u8 slot_count;
 22	u16 slot_width;
 23};
 24
 25struct simple_util_dai {
 26	const char *name;
 27	unsigned int sysclk;
 28	int clk_direction;
 29	int slots;
 30	int slot_width;
 31	unsigned int tx_slot_mask;
 32	unsigned int rx_slot_mask;
 33	struct clk *clk;
 34	bool clk_fixed;
 35	struct simple_util_tdm_width_map *tdm_width_map;
 36	int n_tdm_widths;
 37};
 38
 39struct simple_util_data {
 40	u32 convert_rate;
 41	u32 convert_channels;
 42	const char *convert_sample_format;
 43};
 44
 45struct simple_util_jack {
 46	struct snd_soc_jack jack;
 47	struct snd_soc_jack_pin pin;
 48	struct snd_soc_jack_gpio gpio;
 49};
 50
 51struct prop_nums {
 52	int cpus;
 53	int codecs;
 54	int platforms;
 55};
 56
 57struct simple_util_priv {
 58	struct snd_soc_card snd_card;
 59	struct simple_dai_props {
 60		struct simple_util_dai *cpu_dai;
 61		struct simple_util_dai *codec_dai;
 62		struct simple_util_data adata;
 63		struct snd_soc_codec_conf *codec_conf;
 64		struct prop_nums num;
 65		unsigned int mclk_fs;
 66	} *dai_props;
 67	struct simple_util_jack hp_jack;
 68	struct simple_util_jack mic_jack;
 69	struct snd_soc_jack *aux_jacks;
 70	struct snd_soc_dai_link *dai_link;
 71	struct simple_util_dai *dais;
 72	struct snd_soc_dai_link_component *dlcs;
 73	struct snd_soc_codec_conf *codec_conf;
 74	struct gpio_desc *pa_gpio;
 75	const struct snd_soc_ops *ops;
 76	unsigned int dpcm_selectable:1;
 77	unsigned int force_dpcm:1;
 78};
 79#define simple_priv_to_card(priv)	(&(priv)->snd_card)
 80#define simple_priv_to_props(priv, i)	((priv)->dai_props + (i))
 81#define simple_priv_to_dev(priv)	(simple_priv_to_card(priv)->dev)
 82#define simple_priv_to_link(priv, i)	(simple_priv_to_card(priv)->dai_link + (i))
 83
 84#define simple_props_to_dlc_cpu(props, i)	((props)->cpus + i)
 85#define simple_props_to_dlc_codec(props, i)	((props)->codecs + i)
 86#define simple_props_to_dlc_platform(props, i)	((props)->platforms + i)
 87
 88#define simple_props_to_dai_cpu(props, i)	((props)->cpu_dai + i)
 89#define simple_props_to_dai_codec(props, i)	((props)->codec_dai + i)
 90#define simple_props_to_codec_conf(props, i)	((props)->codec_conf + i)
 91
 92#define for_each_prop_dlc_cpus(props, i, cpu)				\
 93	for ((i) = 0;							\
 94	     ((i) < (props)->num.cpus) &&				\
 95		     ((cpu) = simple_props_to_dlc_cpu(props, i));	\
 96	     (i)++)
 97#define for_each_prop_dlc_codecs(props, i, codec)			\
 98	for ((i) = 0;							\
 99	     ((i) < (props)->num.codecs) &&				\
100		     ((codec) = simple_props_to_dlc_codec(props, i));	\
101	     (i)++)
102#define for_each_prop_dlc_platforms(props, i, platform)			\
103	for ((i) = 0;							\
104	     ((i) < (props)->num.platforms) &&				\
105		     ((platform) = simple_props_to_dlc_platform(props, i)); \
106	     (i)++)
107#define for_each_prop_codec_conf(props, i, conf)			\
108	for ((i) = 0;							\
109	     ((i) < (props)->num.codecs) &&				\
110		     (props)->codec_conf &&				\
111		     ((conf) = simple_props_to_codec_conf(props, i));	\
112	     (i)++)
113
114#define for_each_prop_dai_cpu(props, i, cpu)				\
115	for ((i) = 0;							\
116	     ((i) < (props)->num.cpus) &&				\
117		     ((cpu) = simple_props_to_dai_cpu(props, i));	\
118	     (i)++)
119#define for_each_prop_dai_codec(props, i, codec)			\
120	for ((i) = 0;							\
121	     ((i) < (props)->num.codecs) &&				\
122		     ((codec) = simple_props_to_dai_codec(props, i));	\
123	     (i)++)
124
125#define SNDRV_MAX_LINKS 512
126
127struct link_info {
128	int link; /* number of link */
129	int cpu;  /* turn for CPU / Codec */
130	struct prop_nums num[SNDRV_MAX_LINKS];
131};
132
133int simple_util_parse_daifmt(struct device *dev,
134			     struct device_node *node,
135			     struct device_node *codec,
136			     char *prefix,
137			     unsigned int *retfmt);
138int simple_util_parse_tdm_width_map(struct device *dev, struct device_node *np,
139				    struct simple_util_dai *dai);
140
141__printf(3, 4)
142int simple_util_set_dailink_name(struct device *dev,
143				 struct snd_soc_dai_link *dai_link,
144				 const char *fmt, ...);
145int simple_util_parse_card_name(struct snd_soc_card *card,
146				char *prefix);
147
148int simple_util_parse_clk(struct device *dev,
149			  struct device_node *node,
150			  struct simple_util_dai *simple_dai,
151			  struct snd_soc_dai_link_component *dlc);
152int simple_util_startup(struct snd_pcm_substream *substream);
153void simple_util_shutdown(struct snd_pcm_substream *substream);
154int simple_util_hw_params(struct snd_pcm_substream *substream,
155			  struct snd_pcm_hw_params *params);
156int simple_util_dai_init(struct snd_soc_pcm_runtime *rtd);
157int simple_util_be_hw_params_fixup(struct snd_soc_pcm_runtime *rtd,
158				   struct snd_pcm_hw_params *params);
159
160#define simple_util_parse_tdm(np, dai)				\
161	snd_soc_of_parse_tdm_slot(np,	&(dai)->tx_slot_mask,	\
162					&(dai)->rx_slot_mask,	\
163					&(dai)->slots,		\
164					&(dai)->slot_width);
165
166void simple_util_canonicalize_platform(struct snd_soc_dai_link_component *platforms,
167				       struct snd_soc_dai_link_component *cpus);
168void simple_util_canonicalize_cpu(struct snd_soc_dai_link_component *cpus,
169				  int is_single_links);
170
171void simple_util_clean_reference(struct snd_soc_card *card);
172
173void simple_util_parse_convert(struct device_node *np, char *prefix,
174			       struct simple_util_data *data);
175bool simple_util_is_convert_required(const struct simple_util_data *data);
176
177int simple_util_parse_routing(struct snd_soc_card *card,
178				      char *prefix);
179int simple_util_parse_widgets(struct snd_soc_card *card,
180				      char *prefix);
181int simple_util_parse_pin_switches(struct snd_soc_card *card,
182				   char *prefix);
183
184int simple_util_init_jack(struct snd_soc_card *card,
185			       struct simple_util_jack *sjack,
186			       int is_hp, char *prefix, char *pin);
187int simple_util_init_aux_jacks(struct simple_util_priv *priv,
188				char *prefix);
189int simple_util_init_priv(struct simple_util_priv *priv,
190			       struct link_info *li);
191void simple_util_remove(struct platform_device *pdev);
192
193int graph_util_card_probe(struct snd_soc_card *card);
194int graph_util_is_ports0(struct device_node *port);
195int graph_util_parse_dai(struct device *dev, struct device_node *ep,
196			 struct snd_soc_dai_link_component *dlc, int *is_single_link);
197
198int graph_util_parse_link_direction(struct device_node *np,
199				    bool *is_playback_only, bool *is_capture_only);
200
201#ifdef DEBUG
202static inline void simple_util_debug_dai(struct simple_util_priv *priv,
203					 char *name,
204					 struct simple_util_dai *dai)
205{
206	struct device *dev = simple_priv_to_dev(priv);
207
208	/* dai might be NULL */
209	if (!dai)
210		return;
211
212	if (dai->name)
213		dev_dbg(dev, "%s dai name = %s\n",
214			name, dai->name);
215
216	if (dai->slots)
217		dev_dbg(dev, "%s slots = %d\n", name, dai->slots);
218	if (dai->slot_width)
219		dev_dbg(dev, "%s slot width = %d\n", name, dai->slot_width);
220	if (dai->tx_slot_mask)
221		dev_dbg(dev, "%s tx slot mask = %d\n", name, dai->tx_slot_mask);
222	if (dai->rx_slot_mask)
223		dev_dbg(dev, "%s rx slot mask = %d\n", name, dai->rx_slot_mask);
224	if (dai->clk)
225		dev_dbg(dev, "%s clk %luHz\n", name, clk_get_rate(dai->clk));
226	if (dai->sysclk)
227		dev_dbg(dev, "%s sysclk = %dHz\n",
228			name, dai->sysclk);
229	if (dai->clk || dai->sysclk)
230		dev_dbg(dev, "%s direction = %s\n",
231			name, dai->clk_direction ? "OUT" : "IN");
232}
233
234static inline void simple_util_debug_info(struct simple_util_priv *priv)
235{
236	struct snd_soc_card *card = simple_priv_to_card(priv);
237	struct device *dev = simple_priv_to_dev(priv);
238
239	int i;
240
241	if (card->name)
242		dev_dbg(dev, "Card Name: %s\n", card->name);
243
244	for (i = 0; i < card->num_links; i++) {
245		struct simple_dai_props *props = simple_priv_to_props(priv, i);
246		struct snd_soc_dai_link *link = simple_priv_to_link(priv, i);
247		struct simple_util_dai *dai;
248		struct snd_soc_codec_conf *cnf;
249		int j;
250
251		dev_dbg(dev, "DAI%d\n", i);
252
253		dev_dbg(dev, "cpu num = %d\n", link->num_cpus);
254		for_each_prop_dai_cpu(props, j, dai)
255			simple_util_debug_dai(priv, "cpu", dai);
256		dev_dbg(dev, "codec num = %d\n", link->num_codecs);
257		for_each_prop_dai_codec(props, j, dai)
258			simple_util_debug_dai(priv, "codec", dai);
259
260		if (link->name)
261			dev_dbg(dev, "dai name = %s\n", link->name);
262		if (link->dai_fmt)
263			dev_dbg(dev, "dai format = %04x\n", link->dai_fmt);
264		if (props->adata.convert_rate)
265			dev_dbg(dev, "convert_rate = %d\n", props->adata.convert_rate);
266		if (props->adata.convert_channels)
267			dev_dbg(dev, "convert_channels = %d\n", props->adata.convert_channels);
268		for_each_prop_codec_conf(props, j, cnf)
269			if (cnf->name_prefix)
270				dev_dbg(dev, "name prefix = %s\n", cnf->name_prefix);
271		if (props->mclk_fs)
272			dev_dbg(dev, "mclk-fs = %d\n", props->mclk_fs);
273	}
274}
275#else
276#define  simple_util_debug_info(priv)
277#endif /* DEBUG */
278
279#endif /* __SIMPLE_CARD_UTILS_H */