Revert "unicode: Don't special case ignorable code points"
[linux.git] / sound / soc / soc-topology.c
blob43003d2d3666733673b7a63565a25c0f1af44165
1 // SPDX-License-Identifier: GPL-2.0+
2 //
3 // soc-topology.c -- ALSA SoC Topology
4 //
5 // Copyright (C) 2012 Texas Instruments Inc.
6 // Copyright (C) 2015 Intel Corporation.
7 //
8 // Authors: Liam Girdwood <liam.r.girdwood@linux.intel.com>
9 // K, Mythri P <mythri.p.k@intel.com>
10 // Prusty, Subhransu S <subhransu.s.prusty@intel.com>
11 // B, Jayachandran <jayachandran.b@intel.com>
12 // Abdullah, Omair M <omair.m.abdullah@intel.com>
13 // Jin, Yao <yao.jin@intel.com>
14 // Lin, Mengdong <mengdong.lin@intel.com>
16 // Add support to read audio firmware topology alongside firmware text. The
17 // topology data can contain kcontrols, DAPM graphs, widgets, DAIs, DAI links,
18 // equalizers, firmware, coefficients etc.
20 // This file only manages the core ALSA and ASoC components, all other bespoke
21 // firmware topology data is passed to component drivers for bespoke handling.
23 #include <linux/kernel.h>
24 #include <linux/export.h>
25 #include <linux/list.h>
26 #include <linux/firmware.h>
27 #include <linux/slab.h>
28 #include <sound/soc.h>
29 #include <sound/soc-dapm.h>
30 #include <sound/soc-topology.h>
31 #include <sound/tlv.h>
33 #define SOC_TPLG_MAGIC_BIG_ENDIAN 0x436F5341 /* ASoC in reverse */
36 * We make several passes over the data (since it wont necessarily be ordered)
37 * and process objects in the following order. This guarantees the component
38 * drivers will be ready with any vendor data before the mixers and DAPM objects
39 * are loaded (that may make use of the vendor data).
41 #define SOC_TPLG_PASS_MANIFEST 0
42 #define SOC_TPLG_PASS_VENDOR 1
43 #define SOC_TPLG_PASS_CONTROL 2
44 #define SOC_TPLG_PASS_WIDGET 3
45 #define SOC_TPLG_PASS_PCM_DAI 4
46 #define SOC_TPLG_PASS_GRAPH 5
47 #define SOC_TPLG_PASS_BE_DAI 6
48 #define SOC_TPLG_PASS_LINK 7
50 #define SOC_TPLG_PASS_START SOC_TPLG_PASS_MANIFEST
51 #define SOC_TPLG_PASS_END SOC_TPLG_PASS_LINK
53 /* topology context */
54 struct soc_tplg {
55 const struct firmware *fw;
57 /* runtime FW parsing */
58 const u8 *pos; /* read position */
59 const u8 *hdr_pos; /* header position */
60 unsigned int pass; /* pass number */
62 /* component caller */
63 struct device *dev;
64 struct snd_soc_component *comp;
65 u32 index; /* current block index */
67 /* vendor specific kcontrol operations */
68 const struct snd_soc_tplg_kcontrol_ops *io_ops;
69 int io_ops_count;
71 /* vendor specific bytes ext handlers, for TLV bytes controls */
72 const struct snd_soc_tplg_bytes_ext_ops *bytes_ext_ops;
73 int bytes_ext_ops_count;
75 /* optional fw loading callbacks to component drivers */
76 const struct snd_soc_tplg_ops *ops;
79 /* check we dont overflow the data for this control chunk */
80 static int soc_tplg_check_elem_count(struct soc_tplg *tplg, size_t elem_size,
81 unsigned int count, size_t bytes, const char *elem_type)
83 const u8 *end = tplg->pos + elem_size * count;
85 if (end > tplg->fw->data + tplg->fw->size) {
86 dev_err(tplg->dev, "ASoC: %s overflow end of data\n",
87 elem_type);
88 return -EINVAL;
91 /* check there is enough room in chunk for control.
92 extra bytes at the end of control are for vendor data here */
93 if (elem_size * count > bytes) {
94 dev_err(tplg->dev,
95 "ASoC: %s count %d of size %zu is bigger than chunk %zu\n",
96 elem_type, count, elem_size, bytes);
97 return -EINVAL;
100 return 0;
103 static inline bool soc_tplg_is_eof(struct soc_tplg *tplg)
105 const u8 *end = tplg->hdr_pos;
107 if (end >= tplg->fw->data + tplg->fw->size)
108 return true;
109 return false;
112 static inline unsigned long soc_tplg_get_hdr_offset(struct soc_tplg *tplg)
114 return (unsigned long)(tplg->hdr_pos - tplg->fw->data);
117 static inline unsigned long soc_tplg_get_offset(struct soc_tplg *tplg)
119 return (unsigned long)(tplg->pos - tplg->fw->data);
122 /* mapping of Kcontrol types and associated operations. */
123 static const struct snd_soc_tplg_kcontrol_ops io_ops[] = {
124 {SND_SOC_TPLG_CTL_VOLSW, snd_soc_get_volsw,
125 snd_soc_put_volsw, snd_soc_info_volsw},
126 {SND_SOC_TPLG_CTL_VOLSW_SX, snd_soc_get_volsw_sx,
127 snd_soc_put_volsw_sx, NULL},
128 {SND_SOC_TPLG_CTL_ENUM, snd_soc_get_enum_double,
129 snd_soc_put_enum_double, snd_soc_info_enum_double},
130 {SND_SOC_TPLG_CTL_ENUM_VALUE, snd_soc_get_enum_double,
131 snd_soc_put_enum_double, NULL},
132 {SND_SOC_TPLG_CTL_BYTES, snd_soc_bytes_get,
133 snd_soc_bytes_put, snd_soc_bytes_info},
134 {SND_SOC_TPLG_CTL_RANGE, snd_soc_get_volsw_range,
135 snd_soc_put_volsw_range, snd_soc_info_volsw_range},
136 {SND_SOC_TPLG_CTL_VOLSW_XR_SX, snd_soc_get_xr_sx,
137 snd_soc_put_xr_sx, snd_soc_info_xr_sx},
138 {SND_SOC_TPLG_CTL_STROBE, snd_soc_get_strobe,
139 snd_soc_put_strobe, NULL},
140 {SND_SOC_TPLG_DAPM_CTL_VOLSW, snd_soc_dapm_get_volsw,
141 snd_soc_dapm_put_volsw, snd_soc_info_volsw},
142 {SND_SOC_TPLG_DAPM_CTL_ENUM_DOUBLE, snd_soc_dapm_get_enum_double,
143 snd_soc_dapm_put_enum_double, snd_soc_info_enum_double},
144 {SND_SOC_TPLG_DAPM_CTL_ENUM_VIRT, snd_soc_dapm_get_enum_double,
145 snd_soc_dapm_put_enum_double, NULL},
146 {SND_SOC_TPLG_DAPM_CTL_ENUM_VALUE, snd_soc_dapm_get_enum_double,
147 snd_soc_dapm_put_enum_double, NULL},
148 {SND_SOC_TPLG_DAPM_CTL_PIN, snd_soc_dapm_get_pin_switch,
149 snd_soc_dapm_put_pin_switch, snd_soc_dapm_info_pin_switch},
152 struct soc_tplg_map {
153 int uid;
154 int kid;
157 /* mapping of widget types from UAPI IDs to kernel IDs */
158 static const struct soc_tplg_map dapm_map[] = {
159 {SND_SOC_TPLG_DAPM_INPUT, snd_soc_dapm_input},
160 {SND_SOC_TPLG_DAPM_OUTPUT, snd_soc_dapm_output},
161 {SND_SOC_TPLG_DAPM_MUX, snd_soc_dapm_mux},
162 {SND_SOC_TPLG_DAPM_MIXER, snd_soc_dapm_mixer},
163 {SND_SOC_TPLG_DAPM_PGA, snd_soc_dapm_pga},
164 {SND_SOC_TPLG_DAPM_OUT_DRV, snd_soc_dapm_out_drv},
165 {SND_SOC_TPLG_DAPM_ADC, snd_soc_dapm_adc},
166 {SND_SOC_TPLG_DAPM_DAC, snd_soc_dapm_dac},
167 {SND_SOC_TPLG_DAPM_SWITCH, snd_soc_dapm_switch},
168 {SND_SOC_TPLG_DAPM_PRE, snd_soc_dapm_pre},
169 {SND_SOC_TPLG_DAPM_POST, snd_soc_dapm_post},
170 {SND_SOC_TPLG_DAPM_AIF_IN, snd_soc_dapm_aif_in},
171 {SND_SOC_TPLG_DAPM_AIF_OUT, snd_soc_dapm_aif_out},
172 {SND_SOC_TPLG_DAPM_DAI_IN, snd_soc_dapm_dai_in},
173 {SND_SOC_TPLG_DAPM_DAI_OUT, snd_soc_dapm_dai_out},
174 {SND_SOC_TPLG_DAPM_DAI_LINK, snd_soc_dapm_dai_link},
175 {SND_SOC_TPLG_DAPM_BUFFER, snd_soc_dapm_buffer},
176 {SND_SOC_TPLG_DAPM_SCHEDULER, snd_soc_dapm_scheduler},
177 {SND_SOC_TPLG_DAPM_EFFECT, snd_soc_dapm_effect},
178 {SND_SOC_TPLG_DAPM_SIGGEN, snd_soc_dapm_siggen},
179 {SND_SOC_TPLG_DAPM_SRC, snd_soc_dapm_src},
180 {SND_SOC_TPLG_DAPM_ASRC, snd_soc_dapm_asrc},
181 {SND_SOC_TPLG_DAPM_ENCODER, snd_soc_dapm_encoder},
182 {SND_SOC_TPLG_DAPM_DECODER, snd_soc_dapm_decoder},
185 static int tplg_chan_get_reg(struct soc_tplg *tplg,
186 struct snd_soc_tplg_channel *chan, int map)
188 int i;
190 for (i = 0; i < SND_SOC_TPLG_MAX_CHAN; i++) {
191 if (le32_to_cpu(chan[i].id) == map)
192 return le32_to_cpu(chan[i].reg);
195 return -EINVAL;
198 static int tplg_chan_get_shift(struct soc_tplg *tplg,
199 struct snd_soc_tplg_channel *chan, int map)
201 int i;
203 for (i = 0; i < SND_SOC_TPLG_MAX_CHAN; i++) {
204 if (le32_to_cpu(chan[i].id) == map)
205 return le32_to_cpu(chan[i].shift);
208 return -EINVAL;
211 static int get_widget_id(int tplg_type)
213 int i;
215 for (i = 0; i < ARRAY_SIZE(dapm_map); i++) {
216 if (tplg_type == dapm_map[i].uid)
217 return dapm_map[i].kid;
220 return -EINVAL;
223 static inline void soc_bind_err(struct soc_tplg *tplg,
224 struct snd_soc_tplg_ctl_hdr *hdr, int index)
226 dev_err(tplg->dev,
227 "ASoC: invalid control type (g,p,i) %d:%d:%d index %d at 0x%lx\n",
228 hdr->ops.get, hdr->ops.put, hdr->ops.info, index,
229 soc_tplg_get_offset(tplg));
232 static inline void soc_control_err(struct soc_tplg *tplg,
233 struct snd_soc_tplg_ctl_hdr *hdr, const char *name)
235 dev_err(tplg->dev,
236 "ASoC: no complete control IO handler for %s type (g,p,i) %d:%d:%d at 0x%lx\n",
237 name, hdr->ops.get, hdr->ops.put, hdr->ops.info,
238 soc_tplg_get_offset(tplg));
241 /* pass vendor data to component driver for processing */
242 static int soc_tplg_vendor_load(struct soc_tplg *tplg,
243 struct snd_soc_tplg_hdr *hdr)
245 int ret = 0;
247 if (tplg->ops && tplg->ops->vendor_load)
248 ret = tplg->ops->vendor_load(tplg->comp, tplg->index, hdr);
249 else {
250 dev_err(tplg->dev, "ASoC: no vendor load callback for ID %d\n",
251 hdr->vendor_type);
252 return -EINVAL;
255 if (ret < 0)
256 dev_err(tplg->dev,
257 "ASoC: vendor load failed at hdr offset %ld/0x%lx for type %d:%d\n",
258 soc_tplg_get_hdr_offset(tplg),
259 soc_tplg_get_hdr_offset(tplg),
260 hdr->type, hdr->vendor_type);
261 return ret;
264 /* optionally pass new dynamic widget to component driver. This is mainly for
265 * external widgets where we can assign private data/ops */
266 static int soc_tplg_widget_load(struct soc_tplg *tplg,
267 struct snd_soc_dapm_widget *w, struct snd_soc_tplg_dapm_widget *tplg_w)
269 if (tplg->ops && tplg->ops->widget_load)
270 return tplg->ops->widget_load(tplg->comp, tplg->index, w,
271 tplg_w);
273 return 0;
276 /* optionally pass new dynamic widget to component driver. This is mainly for
277 * external widgets where we can assign private data/ops */
278 static int soc_tplg_widget_ready(struct soc_tplg *tplg,
279 struct snd_soc_dapm_widget *w, struct snd_soc_tplg_dapm_widget *tplg_w)
281 if (tplg->ops && tplg->ops->widget_ready)
282 return tplg->ops->widget_ready(tplg->comp, tplg->index, w,
283 tplg_w);
285 return 0;
288 /* pass DAI configurations to component driver for extra initialization */
289 static int soc_tplg_dai_load(struct soc_tplg *tplg,
290 struct snd_soc_dai_driver *dai_drv,
291 struct snd_soc_tplg_pcm *pcm, struct snd_soc_dai *dai)
293 if (tplg->ops && tplg->ops->dai_load)
294 return tplg->ops->dai_load(tplg->comp, tplg->index, dai_drv,
295 pcm, dai);
297 return 0;
300 /* pass link configurations to component driver for extra initialization */
301 static int soc_tplg_dai_link_load(struct soc_tplg *tplg,
302 struct snd_soc_dai_link *link, struct snd_soc_tplg_link_config *cfg)
304 if (tplg->ops && tplg->ops->link_load)
305 return tplg->ops->link_load(tplg->comp, tplg->index, link, cfg);
307 return 0;
310 /* tell the component driver that all firmware has been loaded in this request */
311 static int soc_tplg_complete(struct soc_tplg *tplg)
313 if (tplg->ops && tplg->ops->complete)
314 return tplg->ops->complete(tplg->comp);
316 return 0;
319 /* add a dynamic kcontrol */
320 static int soc_tplg_add_dcontrol(struct snd_card *card, struct device *dev,
321 const struct snd_kcontrol_new *control_new, const char *prefix,
322 void *data, struct snd_kcontrol **kcontrol)
324 int err;
326 *kcontrol = snd_soc_cnew(control_new, data, control_new->name, prefix);
327 if (*kcontrol == NULL) {
328 dev_err(dev, "ASoC: Failed to create new kcontrol %s\n",
329 control_new->name);
330 return -ENOMEM;
333 err = snd_ctl_add(card, *kcontrol);
334 if (err < 0) {
335 dev_err(dev, "ASoC: Failed to add %s: %d\n",
336 control_new->name, err);
337 return err;
340 return 0;
343 /* add a dynamic kcontrol for component driver */
344 static int soc_tplg_add_kcontrol(struct soc_tplg *tplg,
345 struct snd_kcontrol_new *k, struct snd_kcontrol **kcontrol)
347 struct snd_soc_component *comp = tplg->comp;
349 return soc_tplg_add_dcontrol(comp->card->snd_card,
350 tplg->dev, k, comp->name_prefix, comp, kcontrol);
353 /* remove kcontrol */
354 static void soc_tplg_remove_kcontrol(struct snd_soc_component *comp, struct snd_soc_dobj *dobj,
355 int pass)
357 struct snd_card *card = comp->card->snd_card;
359 if (pass != SOC_TPLG_PASS_CONTROL)
360 return;
362 if (dobj->unload)
363 dobj->unload(comp, dobj);
365 snd_ctl_remove(card, dobj->control.kcontrol);
366 list_del(&dobj->list);
369 /* remove a route */
370 static void soc_tplg_remove_route(struct snd_soc_component *comp,
371 struct snd_soc_dobj *dobj, int pass)
373 if (pass != SOC_TPLG_PASS_GRAPH)
374 return;
376 if (dobj->unload)
377 dobj->unload(comp, dobj);
379 list_del(&dobj->list);
382 /* remove a widget and it's kcontrols - routes must be removed first */
383 static void soc_tplg_remove_widget(struct snd_soc_component *comp,
384 struct snd_soc_dobj *dobj, int pass)
386 struct snd_card *card = comp->card->snd_card;
387 struct snd_soc_dapm_widget *w =
388 container_of(dobj, struct snd_soc_dapm_widget, dobj);
389 int i;
391 if (pass != SOC_TPLG_PASS_WIDGET)
392 return;
394 if (dobj->unload)
395 dobj->unload(comp, dobj);
397 if (w->kcontrols)
398 for (i = 0; i < w->num_kcontrols; i++)
399 snd_ctl_remove(card, w->kcontrols[i]);
401 list_del(&dobj->list);
403 /* widget w is freed by soc-dapm.c */
406 /* remove DAI configurations */
407 static void soc_tplg_remove_dai(struct snd_soc_component *comp,
408 struct snd_soc_dobj *dobj, int pass)
410 struct snd_soc_dai_driver *dai_drv =
411 container_of(dobj, struct snd_soc_dai_driver, dobj);
412 struct snd_soc_dai *dai, *_dai;
414 if (pass != SOC_TPLG_PASS_PCM_DAI)
415 return;
417 if (dobj->unload)
418 dobj->unload(comp, dobj);
420 for_each_component_dais_safe(comp, dai, _dai)
421 if (dai->driver == dai_drv)
422 snd_soc_unregister_dai(dai);
424 list_del(&dobj->list);
427 /* remove link configurations */
428 static void soc_tplg_remove_link(struct snd_soc_component *comp,
429 struct snd_soc_dobj *dobj, int pass)
431 struct snd_soc_dai_link *link =
432 container_of(dobj, struct snd_soc_dai_link, dobj);
434 if (pass != SOC_TPLG_PASS_PCM_DAI)
435 return;
437 if (dobj->unload)
438 dobj->unload(comp, dobj);
440 list_del(&dobj->list);
441 snd_soc_remove_pcm_runtime(comp->card,
442 snd_soc_get_pcm_runtime(comp->card, link));
445 /* unload dai link */
446 static void remove_backend_link(struct snd_soc_component *comp,
447 struct snd_soc_dobj *dobj, int pass)
449 if (pass != SOC_TPLG_PASS_LINK)
450 return;
452 if (dobj->unload)
453 dobj->unload(comp, dobj);
456 * We don't free the link here as what soc_tplg_remove_link() do since BE
457 * links are not allocated by topology.
458 * We however need to reset the dobj type to its initial values
460 dobj->type = SND_SOC_DOBJ_NONE;
461 list_del(&dobj->list);
464 /* bind a kcontrol to it's IO handlers */
465 static int soc_tplg_kcontrol_bind_io(struct snd_soc_tplg_ctl_hdr *hdr,
466 struct snd_kcontrol_new *k,
467 const struct soc_tplg *tplg)
469 const struct snd_soc_tplg_kcontrol_ops *ops;
470 const struct snd_soc_tplg_bytes_ext_ops *ext_ops;
471 int num_ops, i;
473 if (le32_to_cpu(hdr->ops.info) == SND_SOC_TPLG_CTL_BYTES
474 && k->iface & SNDRV_CTL_ELEM_IFACE_MIXER
475 && (k->access & SNDRV_CTL_ELEM_ACCESS_TLV_READ
476 || k->access & SNDRV_CTL_ELEM_ACCESS_TLV_WRITE)
477 && k->access & SNDRV_CTL_ELEM_ACCESS_TLV_CALLBACK) {
478 struct soc_bytes_ext *sbe;
479 struct snd_soc_tplg_bytes_control *be;
481 sbe = (struct soc_bytes_ext *)k->private_value;
482 be = container_of(hdr, struct snd_soc_tplg_bytes_control, hdr);
484 /* TLV bytes controls need standard kcontrol info handler,
485 * TLV callback and extended put/get handlers.
487 k->info = snd_soc_bytes_info_ext;
488 k->tlv.c = snd_soc_bytes_tlv_callback;
491 * When a topology-based implementation abuses the
492 * control interface and uses bytes_ext controls of
493 * more than 512 bytes, we need to disable the size
494 * checks, otherwise accesses to such controls will
495 * return an -EINVAL error and prevent the card from
496 * being configured.
498 if (sbe->max > 512)
499 k->access |= SNDRV_CTL_ELEM_ACCESS_SKIP_CHECK;
501 ext_ops = tplg->bytes_ext_ops;
502 num_ops = tplg->bytes_ext_ops_count;
503 for (i = 0; i < num_ops; i++) {
504 if (!sbe->put &&
505 ext_ops[i].id == le32_to_cpu(be->ext_ops.put))
506 sbe->put = ext_ops[i].put;
507 if (!sbe->get &&
508 ext_ops[i].id == le32_to_cpu(be->ext_ops.get))
509 sbe->get = ext_ops[i].get;
512 if ((k->access & SNDRV_CTL_ELEM_ACCESS_TLV_READ) && !sbe->get)
513 return -EINVAL;
514 if ((k->access & SNDRV_CTL_ELEM_ACCESS_TLV_WRITE) && !sbe->put)
515 return -EINVAL;
516 return 0;
519 /* try and map vendor specific kcontrol handlers first */
520 ops = tplg->io_ops;
521 num_ops = tplg->io_ops_count;
522 for (i = 0; i < num_ops; i++) {
524 if (k->put == NULL && ops[i].id == le32_to_cpu(hdr->ops.put))
525 k->put = ops[i].put;
526 if (k->get == NULL && ops[i].id == le32_to_cpu(hdr->ops.get))
527 k->get = ops[i].get;
528 if (k->info == NULL && ops[i].id == le32_to_cpu(hdr->ops.info))
529 k->info = ops[i].info;
532 /* vendor specific handlers found ? */
533 if (k->put && k->get && k->info)
534 return 0;
536 /* none found so try standard kcontrol handlers */
537 ops = io_ops;
538 num_ops = ARRAY_SIZE(io_ops);
539 for (i = 0; i < num_ops; i++) {
541 if (k->put == NULL && ops[i].id == le32_to_cpu(hdr->ops.put))
542 k->put = ops[i].put;
543 if (k->get == NULL && ops[i].id == le32_to_cpu(hdr->ops.get))
544 k->get = ops[i].get;
545 if (k->info == NULL && ops[i].id == le32_to_cpu(hdr->ops.info))
546 k->info = ops[i].info;
549 /* standard handlers found ? */
550 if (k->put && k->get && k->info)
551 return 0;
553 /* nothing to bind */
554 return -EINVAL;
557 /* bind a widgets to it's evnt handlers */
558 int snd_soc_tplg_widget_bind_event(struct snd_soc_dapm_widget *w,
559 const struct snd_soc_tplg_widget_events *events,
560 int num_events, u16 event_type)
562 int i;
564 w->event = NULL;
566 for (i = 0; i < num_events; i++) {
567 if (event_type == events[i].type) {
569 /* found - so assign event */
570 w->event = events[i].event_handler;
571 return 0;
575 /* not found */
576 return -EINVAL;
578 EXPORT_SYMBOL_GPL(snd_soc_tplg_widget_bind_event);
580 /* optionally pass new dynamic kcontrol to component driver. */
581 static int soc_tplg_control_load(struct soc_tplg *tplg,
582 struct snd_kcontrol_new *k, struct snd_soc_tplg_ctl_hdr *hdr)
584 int ret = 0;
586 if (tplg->ops && tplg->ops->control_load)
587 ret = tplg->ops->control_load(tplg->comp, tplg->index, k, hdr);
589 if (ret)
590 dev_err(tplg->dev, "ASoC: failed to init %s\n", hdr->name);
592 return ret;
596 static int soc_tplg_create_tlv_db_scale(struct soc_tplg *tplg,
597 struct snd_kcontrol_new *kc, struct snd_soc_tplg_tlv_dbscale *scale)
599 unsigned int item_len = 2 * sizeof(unsigned int);
600 unsigned int *p;
602 p = devm_kzalloc(tplg->dev, item_len + 2 * sizeof(unsigned int), GFP_KERNEL);
603 if (!p)
604 return -ENOMEM;
606 p[0] = SNDRV_CTL_TLVT_DB_SCALE;
607 p[1] = item_len;
608 p[2] = le32_to_cpu(scale->min);
609 p[3] = (le32_to_cpu(scale->step) & TLV_DB_SCALE_MASK)
610 | (le32_to_cpu(scale->mute) ? TLV_DB_SCALE_MUTE : 0);
612 kc->tlv.p = (void *)p;
613 return 0;
616 static int soc_tplg_create_tlv(struct soc_tplg *tplg,
617 struct snd_kcontrol_new *kc, struct snd_soc_tplg_ctl_hdr *tc)
619 struct snd_soc_tplg_ctl_tlv *tplg_tlv;
620 u32 access = le32_to_cpu(tc->access);
622 if (!(access & SNDRV_CTL_ELEM_ACCESS_TLV_READWRITE))
623 return 0;
625 if (!(access & SNDRV_CTL_ELEM_ACCESS_TLV_CALLBACK)) {
626 tplg_tlv = &tc->tlv;
627 switch (le32_to_cpu(tplg_tlv->type)) {
628 case SNDRV_CTL_TLVT_DB_SCALE:
629 return soc_tplg_create_tlv_db_scale(tplg, kc,
630 &tplg_tlv->scale);
632 /* TODO: add support for other TLV types */
633 default:
634 dev_dbg(tplg->dev, "Unsupported TLV type %d\n",
635 tplg_tlv->type);
636 return -EINVAL;
640 return 0;
643 static int soc_tplg_control_dmixer_create(struct soc_tplg *tplg, struct snd_kcontrol_new *kc)
645 struct snd_soc_tplg_mixer_control *mc;
646 struct soc_mixer_control *sm;
647 int err;
649 mc = (struct snd_soc_tplg_mixer_control *)tplg->pos;
651 /* validate kcontrol */
652 if (strnlen(mc->hdr.name, SNDRV_CTL_ELEM_ID_NAME_MAXLEN) == SNDRV_CTL_ELEM_ID_NAME_MAXLEN)
653 return -EINVAL;
655 sm = devm_kzalloc(tplg->dev, sizeof(*sm), GFP_KERNEL);
656 if (!sm)
657 return -ENOMEM;
659 tplg->pos += sizeof(struct snd_soc_tplg_mixer_control) + le32_to_cpu(mc->priv.size);
661 dev_dbg(tplg->dev, "ASoC: adding mixer kcontrol %s with access 0x%x\n",
662 mc->hdr.name, mc->hdr.access);
664 kc->name = devm_kstrdup(tplg->dev, mc->hdr.name, GFP_KERNEL);
665 if (!kc->name)
666 return -ENOMEM;
667 kc->private_value = (long)sm;
668 kc->iface = SNDRV_CTL_ELEM_IFACE_MIXER;
669 kc->access = le32_to_cpu(mc->hdr.access);
671 /* we only support FL/FR channel mapping atm */
672 sm->reg = tplg_chan_get_reg(tplg, mc->channel, SNDRV_CHMAP_FL);
673 sm->rreg = tplg_chan_get_reg(tplg, mc->channel, SNDRV_CHMAP_FR);
674 sm->shift = tplg_chan_get_shift(tplg, mc->channel, SNDRV_CHMAP_FL);
675 sm->rshift = tplg_chan_get_shift(tplg, mc->channel, SNDRV_CHMAP_FR);
677 sm->max = le32_to_cpu(mc->max);
678 sm->min = le32_to_cpu(mc->min);
679 sm->invert = le32_to_cpu(mc->invert);
680 sm->platform_max = le32_to_cpu(mc->platform_max);
682 /* map io handlers */
683 err = soc_tplg_kcontrol_bind_io(&mc->hdr, kc, tplg);
684 if (err) {
685 soc_control_err(tplg, &mc->hdr, mc->hdr.name);
686 return err;
689 /* create any TLV data */
690 err = soc_tplg_create_tlv(tplg, kc, &mc->hdr);
691 if (err < 0) {
692 dev_err(tplg->dev, "ASoC: failed to create TLV %s\n", mc->hdr.name);
693 return err;
696 /* pass control to driver for optional further init */
697 return soc_tplg_control_load(tplg, kc, &mc->hdr);
700 static int soc_tplg_denum_create_texts(struct soc_tplg *tplg, struct soc_enum *se,
701 struct snd_soc_tplg_enum_control *ec)
703 int i, ret;
705 if (le32_to_cpu(ec->items) > ARRAY_SIZE(ec->texts))
706 return -EINVAL;
708 se->dobj.control.dtexts =
709 devm_kcalloc(tplg->dev, le32_to_cpu(ec->items), sizeof(char *), GFP_KERNEL);
710 if (se->dobj.control.dtexts == NULL)
711 return -ENOMEM;
713 for (i = 0; i < le32_to_cpu(ec->items); i++) {
715 if (strnlen(ec->texts[i], SNDRV_CTL_ELEM_ID_NAME_MAXLEN) ==
716 SNDRV_CTL_ELEM_ID_NAME_MAXLEN) {
717 ret = -EINVAL;
718 goto err;
721 se->dobj.control.dtexts[i] = devm_kstrdup(tplg->dev, ec->texts[i], GFP_KERNEL);
722 if (!se->dobj.control.dtexts[i]) {
723 ret = -ENOMEM;
724 goto err;
728 se->items = le32_to_cpu(ec->items);
729 se->texts = (const char * const *)se->dobj.control.dtexts;
730 return 0;
732 err:
733 return ret;
736 static int soc_tplg_denum_create_values(struct soc_tplg *tplg, struct soc_enum *se,
737 struct snd_soc_tplg_enum_control *ec)
739 int i;
742 * Following "if" checks if we have at most SND_SOC_TPLG_NUM_TEXTS
743 * values instead of using ARRAY_SIZE(ec->values) due to the fact that
744 * it is oversized for its purpose. Additionally it is done so because
745 * it is defined in UAPI header where it can't be easily changed.
747 if (le32_to_cpu(ec->items) > SND_SOC_TPLG_NUM_TEXTS)
748 return -EINVAL;
750 se->dobj.control.dvalues = devm_kcalloc(tplg->dev, le32_to_cpu(ec->items),
751 sizeof(*se->dobj.control.dvalues),
752 GFP_KERNEL);
753 if (!se->dobj.control.dvalues)
754 return -ENOMEM;
756 /* convert from little-endian */
757 for (i = 0; i < le32_to_cpu(ec->items); i++) {
758 se->dobj.control.dvalues[i] = le32_to_cpu(ec->values[i]);
761 se->items = le32_to_cpu(ec->items);
762 se->values = (const unsigned int *)se->dobj.control.dvalues;
763 return 0;
766 static int soc_tplg_control_denum_create(struct soc_tplg *tplg, struct snd_kcontrol_new *kc)
768 struct snd_soc_tplg_enum_control *ec;
769 struct soc_enum *se;
770 int err;
772 ec = (struct snd_soc_tplg_enum_control *)tplg->pos;
774 /* validate kcontrol */
775 if (strnlen(ec->hdr.name, SNDRV_CTL_ELEM_ID_NAME_MAXLEN) == SNDRV_CTL_ELEM_ID_NAME_MAXLEN)
776 return -EINVAL;
778 se = devm_kzalloc(tplg->dev, sizeof(*se), GFP_KERNEL);
779 if (!se)
780 return -ENOMEM;
782 tplg->pos += (sizeof(struct snd_soc_tplg_enum_control) + le32_to_cpu(ec->priv.size));
784 dev_dbg(tplg->dev, "ASoC: adding enum kcontrol %s size %d\n", ec->hdr.name, ec->items);
786 kc->name = devm_kstrdup(tplg->dev, ec->hdr.name, GFP_KERNEL);
787 if (!kc->name)
788 return -ENOMEM;
789 kc->private_value = (long)se;
790 kc->iface = SNDRV_CTL_ELEM_IFACE_MIXER;
791 kc->access = le32_to_cpu(ec->hdr.access);
793 /* we only support FL/FR channel mapping atm */
794 se->reg = tplg_chan_get_reg(tplg, ec->channel, SNDRV_CHMAP_FL);
795 se->shift_l = tplg_chan_get_shift(tplg, ec->channel, SNDRV_CHMAP_FL);
796 se->shift_r = tplg_chan_get_shift(tplg, ec->channel, SNDRV_CHMAP_FR);
798 se->mask = le32_to_cpu(ec->mask);
800 switch (le32_to_cpu(ec->hdr.ops.info)) {
801 case SND_SOC_TPLG_CTL_ENUM_VALUE:
802 case SND_SOC_TPLG_DAPM_CTL_ENUM_VALUE:
803 err = soc_tplg_denum_create_values(tplg, se, ec);
804 if (err < 0) {
805 dev_err(tplg->dev, "ASoC: could not create values for %s\n", ec->hdr.name);
806 return err;
808 fallthrough;
809 case SND_SOC_TPLG_CTL_ENUM:
810 case SND_SOC_TPLG_DAPM_CTL_ENUM_DOUBLE:
811 case SND_SOC_TPLG_DAPM_CTL_ENUM_VIRT:
812 err = soc_tplg_denum_create_texts(tplg, se, ec);
813 if (err < 0) {
814 dev_err(tplg->dev, "ASoC: could not create texts for %s\n", ec->hdr.name);
815 return err;
817 break;
818 default:
819 dev_err(tplg->dev, "ASoC: invalid enum control type %d for %s\n",
820 ec->hdr.ops.info, ec->hdr.name);
821 return -EINVAL;
824 /* map io handlers */
825 err = soc_tplg_kcontrol_bind_io(&ec->hdr, kc, tplg);
826 if (err) {
827 soc_control_err(tplg, &ec->hdr, ec->hdr.name);
828 return err;
831 /* pass control to driver for optional further init */
832 return soc_tplg_control_load(tplg, kc, &ec->hdr);
835 static int soc_tplg_control_dbytes_create(struct soc_tplg *tplg, struct snd_kcontrol_new *kc)
837 struct snd_soc_tplg_bytes_control *be;
838 struct soc_bytes_ext *sbe;
839 int err;
841 be = (struct snd_soc_tplg_bytes_control *)tplg->pos;
843 /* validate kcontrol */
844 if (strnlen(be->hdr.name, SNDRV_CTL_ELEM_ID_NAME_MAXLEN) == SNDRV_CTL_ELEM_ID_NAME_MAXLEN)
845 return -EINVAL;
847 sbe = devm_kzalloc(tplg->dev, sizeof(*sbe), GFP_KERNEL);
848 if (!sbe)
849 return -ENOMEM;
851 tplg->pos += (sizeof(struct snd_soc_tplg_bytes_control) + le32_to_cpu(be->priv.size));
853 dev_dbg(tplg->dev, "ASoC: adding bytes kcontrol %s with access 0x%x\n",
854 be->hdr.name, be->hdr.access);
856 kc->name = devm_kstrdup(tplg->dev, be->hdr.name, GFP_KERNEL);
857 if (!kc->name)
858 return -ENOMEM;
859 kc->private_value = (long)sbe;
860 kc->iface = SNDRV_CTL_ELEM_IFACE_MIXER;
861 kc->access = le32_to_cpu(be->hdr.access);
863 sbe->max = le32_to_cpu(be->max);
865 /* map standard io handlers and check for external handlers */
866 err = soc_tplg_kcontrol_bind_io(&be->hdr, kc, tplg);
867 if (err) {
868 soc_control_err(tplg, &be->hdr, be->hdr.name);
869 return err;
872 /* pass control to driver for optional further init */
873 return soc_tplg_control_load(tplg, kc, &be->hdr);
876 static int soc_tplg_dbytes_create(struct soc_tplg *tplg, size_t size)
878 struct snd_kcontrol_new kc = {0};
879 struct soc_bytes_ext *sbe;
880 int ret;
882 if (soc_tplg_check_elem_count(tplg,
883 sizeof(struct snd_soc_tplg_bytes_control),
884 1, size, "mixer bytes"))
885 return -EINVAL;
887 ret = soc_tplg_control_dbytes_create(tplg, &kc);
888 if (ret)
889 return ret;
891 /* register dynamic object */
892 sbe = (struct soc_bytes_ext *)kc.private_value;
894 INIT_LIST_HEAD(&sbe->dobj.list);
895 sbe->dobj.type = SND_SOC_DOBJ_BYTES;
896 sbe->dobj.index = tplg->index;
897 if (tplg->ops)
898 sbe->dobj.unload = tplg->ops->control_unload;
900 /* create control directly */
901 ret = soc_tplg_add_kcontrol(tplg, &kc, &sbe->dobj.control.kcontrol);
902 if (ret < 0)
903 return ret;
905 list_add(&sbe->dobj.list, &tplg->comp->dobj_list);
907 return ret;
910 static int soc_tplg_dmixer_create(struct soc_tplg *tplg, size_t size)
912 struct snd_kcontrol_new kc = {0};
913 struct soc_mixer_control *sm;
914 int ret;
916 if (soc_tplg_check_elem_count(tplg,
917 sizeof(struct snd_soc_tplg_mixer_control),
918 1, size, "mixers"))
919 return -EINVAL;
921 ret = soc_tplg_control_dmixer_create(tplg, &kc);
922 if (ret)
923 return ret;
925 /* register dynamic object */
926 sm = (struct soc_mixer_control *)kc.private_value;
928 INIT_LIST_HEAD(&sm->dobj.list);
929 sm->dobj.type = SND_SOC_DOBJ_MIXER;
930 sm->dobj.index = tplg->index;
931 if (tplg->ops)
932 sm->dobj.unload = tplg->ops->control_unload;
934 /* create control directly */
935 ret = soc_tplg_add_kcontrol(tplg, &kc, &sm->dobj.control.kcontrol);
936 if (ret < 0)
937 return ret;
939 list_add(&sm->dobj.list, &tplg->comp->dobj_list);
941 return ret;
944 static int soc_tplg_denum_create(struct soc_tplg *tplg, size_t size)
946 struct snd_kcontrol_new kc = {0};
947 struct soc_enum *se;
948 int ret;
950 if (soc_tplg_check_elem_count(tplg,
951 sizeof(struct snd_soc_tplg_enum_control),
952 1, size, "enums"))
953 return -EINVAL;
955 ret = soc_tplg_control_denum_create(tplg, &kc);
956 if (ret)
957 return ret;
959 /* register dynamic object */
960 se = (struct soc_enum *)kc.private_value;
962 INIT_LIST_HEAD(&se->dobj.list);
963 se->dobj.type = SND_SOC_DOBJ_ENUM;
964 se->dobj.index = tplg->index;
965 if (tplg->ops)
966 se->dobj.unload = tplg->ops->control_unload;
968 /* create control directly */
969 ret = soc_tplg_add_kcontrol(tplg, &kc, &se->dobj.control.kcontrol);
970 if (ret < 0)
971 return ret;
973 list_add(&se->dobj.list, &tplg->comp->dobj_list);
975 return ret;
978 static int soc_tplg_kcontrol_elems_load(struct soc_tplg *tplg,
979 struct snd_soc_tplg_hdr *hdr)
981 int ret;
982 int i;
984 dev_dbg(tplg->dev, "ASoC: adding %d kcontrols at 0x%lx\n", hdr->count,
985 soc_tplg_get_offset(tplg));
987 for (i = 0; i < le32_to_cpu(hdr->count); i++) {
988 struct snd_soc_tplg_ctl_hdr *control_hdr = (struct snd_soc_tplg_ctl_hdr *)tplg->pos;
990 if (le32_to_cpu(control_hdr->size) != sizeof(*control_hdr)) {
991 dev_err(tplg->dev, "ASoC: invalid control size\n");
992 return -EINVAL;
995 switch (le32_to_cpu(control_hdr->ops.info)) {
996 case SND_SOC_TPLG_CTL_VOLSW:
997 case SND_SOC_TPLG_CTL_STROBE:
998 case SND_SOC_TPLG_CTL_VOLSW_SX:
999 case SND_SOC_TPLG_CTL_VOLSW_XR_SX:
1000 case SND_SOC_TPLG_CTL_RANGE:
1001 case SND_SOC_TPLG_DAPM_CTL_VOLSW:
1002 case SND_SOC_TPLG_DAPM_CTL_PIN:
1003 ret = soc_tplg_dmixer_create(tplg, le32_to_cpu(hdr->payload_size));
1004 break;
1005 case SND_SOC_TPLG_CTL_ENUM:
1006 case SND_SOC_TPLG_CTL_ENUM_VALUE:
1007 case SND_SOC_TPLG_DAPM_CTL_ENUM_DOUBLE:
1008 case SND_SOC_TPLG_DAPM_CTL_ENUM_VIRT:
1009 case SND_SOC_TPLG_DAPM_CTL_ENUM_VALUE:
1010 ret = soc_tplg_denum_create(tplg, le32_to_cpu(hdr->payload_size));
1011 break;
1012 case SND_SOC_TPLG_CTL_BYTES:
1013 ret = soc_tplg_dbytes_create(tplg, le32_to_cpu(hdr->payload_size));
1014 break;
1015 default:
1016 soc_bind_err(tplg, control_hdr, i);
1017 return -EINVAL;
1019 if (ret < 0) {
1020 dev_err(tplg->dev, "ASoC: invalid control\n");
1021 return ret;
1026 return 0;
1029 /* optionally pass new dynamic kcontrol to component driver. */
1030 static int soc_tplg_add_route(struct soc_tplg *tplg,
1031 struct snd_soc_dapm_route *route)
1033 if (tplg->ops && tplg->ops->dapm_route_load)
1034 return tplg->ops->dapm_route_load(tplg->comp, tplg->index,
1035 route);
1037 return 0;
1040 static int soc_tplg_dapm_graph_elems_load(struct soc_tplg *tplg,
1041 struct snd_soc_tplg_hdr *hdr)
1043 struct snd_soc_dapm_context *dapm = &tplg->comp->dapm;
1044 const size_t maxlen = SNDRV_CTL_ELEM_ID_NAME_MAXLEN;
1045 struct snd_soc_tplg_dapm_graph_elem *elem;
1046 struct snd_soc_dapm_route *route;
1047 int count, i;
1048 int ret = 0;
1050 count = le32_to_cpu(hdr->count);
1052 if (soc_tplg_check_elem_count(tplg,
1053 sizeof(struct snd_soc_tplg_dapm_graph_elem),
1054 count, le32_to_cpu(hdr->payload_size), "graph"))
1055 return -EINVAL;
1057 dev_dbg(tplg->dev, "ASoC: adding %d DAPM routes for index %d\n", count,
1058 hdr->index);
1060 for (i = 0; i < count; i++) {
1061 route = devm_kzalloc(tplg->dev, sizeof(*route), GFP_KERNEL);
1062 if (!route)
1063 return -ENOMEM;
1064 elem = (struct snd_soc_tplg_dapm_graph_elem *)tplg->pos;
1065 tplg->pos += sizeof(struct snd_soc_tplg_dapm_graph_elem);
1067 /* validate routes */
1068 if ((strnlen(elem->source, maxlen) == maxlen) ||
1069 (strnlen(elem->sink, maxlen) == maxlen) ||
1070 (strnlen(elem->control, maxlen) == maxlen)) {
1071 ret = -EINVAL;
1072 break;
1075 route->source = devm_kstrdup(tplg->dev, elem->source, GFP_KERNEL);
1076 route->sink = devm_kstrdup(tplg->dev, elem->sink, GFP_KERNEL);
1077 if (!route->source || !route->sink) {
1078 ret = -ENOMEM;
1079 break;
1082 if (strnlen(elem->control, maxlen) != 0) {
1083 route->control = devm_kstrdup(tplg->dev, elem->control, GFP_KERNEL);
1084 if (!route->control) {
1085 ret = -ENOMEM;
1086 break;
1090 /* add route dobj to dobj_list */
1091 route->dobj.type = SND_SOC_DOBJ_GRAPH;
1092 if (tplg->ops)
1093 route->dobj.unload = tplg->ops->dapm_route_unload;
1094 route->dobj.index = tplg->index;
1095 list_add(&route->dobj.list, &tplg->comp->dobj_list);
1097 ret = soc_tplg_add_route(tplg, route);
1098 if (ret < 0) {
1099 dev_err(tplg->dev, "ASoC: topology: add_route failed: %d\n", ret);
1100 break;
1103 ret = snd_soc_dapm_add_routes(dapm, route, 1);
1104 if (ret) {
1105 if (!dapm->card->disable_route_checks) {
1106 dev_err(tplg->dev, "ASoC: dapm_add_routes failed: %d\n", ret);
1107 break;
1109 dev_info(tplg->dev,
1110 "ASoC: disable_route_checks set, ignoring dapm_add_routes errors\n");
1114 return ret;
1117 static int soc_tplg_dapm_widget_create(struct soc_tplg *tplg,
1118 struct snd_soc_tplg_dapm_widget *w)
1120 struct snd_soc_dapm_context *dapm = &tplg->comp->dapm;
1121 struct snd_soc_dapm_widget template, *widget;
1122 struct snd_soc_tplg_ctl_hdr *control_hdr;
1123 struct snd_soc_card *card = tplg->comp->card;
1124 unsigned int *kcontrol_type = NULL;
1125 struct snd_kcontrol_new *kc;
1126 int mixer_count = 0;
1127 int bytes_count = 0;
1128 int enum_count = 0;
1129 int ret = 0;
1130 int i;
1132 if (strnlen(w->name, SNDRV_CTL_ELEM_ID_NAME_MAXLEN) ==
1133 SNDRV_CTL_ELEM_ID_NAME_MAXLEN)
1134 return -EINVAL;
1135 if (strnlen(w->sname, SNDRV_CTL_ELEM_ID_NAME_MAXLEN) ==
1136 SNDRV_CTL_ELEM_ID_NAME_MAXLEN)
1137 return -EINVAL;
1139 dev_dbg(tplg->dev, "ASoC: creating DAPM widget %s id %d\n",
1140 w->name, w->id);
1142 memset(&template, 0, sizeof(template));
1144 /* map user to kernel widget ID */
1145 template.id = get_widget_id(le32_to_cpu(w->id));
1146 if ((int)template.id < 0)
1147 return template.id;
1149 /* strings are allocated here, but used and freed by the widget */
1150 template.name = kstrdup(w->name, GFP_KERNEL);
1151 if (!template.name)
1152 return -ENOMEM;
1153 template.sname = kstrdup(w->sname, GFP_KERNEL);
1154 if (!template.sname) {
1155 ret = -ENOMEM;
1156 goto err;
1158 template.reg = le32_to_cpu(w->reg);
1159 template.shift = le32_to_cpu(w->shift);
1160 template.mask = le32_to_cpu(w->mask);
1161 template.subseq = le32_to_cpu(w->subseq);
1162 template.on_val = w->invert ? 0 : 1;
1163 template.off_val = w->invert ? 1 : 0;
1164 template.ignore_suspend = le32_to_cpu(w->ignore_suspend);
1165 template.event_flags = le16_to_cpu(w->event_flags);
1166 template.dobj.index = tplg->index;
1168 tplg->pos +=
1169 (sizeof(struct snd_soc_tplg_dapm_widget) +
1170 le32_to_cpu(w->priv.size));
1172 if (w->num_kcontrols == 0) {
1173 template.num_kcontrols = 0;
1174 goto widget;
1177 template.num_kcontrols = le32_to_cpu(w->num_kcontrols);
1178 kc = devm_kcalloc(tplg->dev, le32_to_cpu(w->num_kcontrols), sizeof(*kc), GFP_KERNEL);
1179 if (!kc) {
1180 ret = -ENOMEM;
1181 goto hdr_err;
1184 kcontrol_type = devm_kcalloc(tplg->dev, le32_to_cpu(w->num_kcontrols), sizeof(unsigned int),
1185 GFP_KERNEL);
1186 if (!kcontrol_type) {
1187 ret = -ENOMEM;
1188 goto hdr_err;
1191 for (i = 0; i < le32_to_cpu(w->num_kcontrols); i++) {
1192 control_hdr = (struct snd_soc_tplg_ctl_hdr *)tplg->pos;
1193 switch (le32_to_cpu(control_hdr->ops.info)) {
1194 case SND_SOC_TPLG_CTL_VOLSW:
1195 case SND_SOC_TPLG_CTL_STROBE:
1196 case SND_SOC_TPLG_CTL_VOLSW_SX:
1197 case SND_SOC_TPLG_CTL_VOLSW_XR_SX:
1198 case SND_SOC_TPLG_CTL_RANGE:
1199 case SND_SOC_TPLG_DAPM_CTL_VOLSW:
1200 /* volume mixer */
1201 kc[i].index = mixer_count;
1202 kcontrol_type[i] = SND_SOC_TPLG_TYPE_MIXER;
1203 mixer_count++;
1204 ret = soc_tplg_control_dmixer_create(tplg, &kc[i]);
1205 if (ret < 0)
1206 goto hdr_err;
1207 break;
1208 case SND_SOC_TPLG_CTL_ENUM:
1209 case SND_SOC_TPLG_CTL_ENUM_VALUE:
1210 case SND_SOC_TPLG_DAPM_CTL_ENUM_DOUBLE:
1211 case SND_SOC_TPLG_DAPM_CTL_ENUM_VIRT:
1212 case SND_SOC_TPLG_DAPM_CTL_ENUM_VALUE:
1213 /* enumerated mixer */
1214 kc[i].index = enum_count;
1215 kcontrol_type[i] = SND_SOC_TPLG_TYPE_ENUM;
1216 enum_count++;
1217 ret = soc_tplg_control_denum_create(tplg, &kc[i]);
1218 if (ret < 0)
1219 goto hdr_err;
1220 break;
1221 case SND_SOC_TPLG_CTL_BYTES:
1222 /* bytes control */
1223 kc[i].index = bytes_count;
1224 kcontrol_type[i] = SND_SOC_TPLG_TYPE_BYTES;
1225 bytes_count++;
1226 ret = soc_tplg_control_dbytes_create(tplg, &kc[i]);
1227 if (ret < 0)
1228 goto hdr_err;
1229 break;
1230 default:
1231 dev_err(tplg->dev, "ASoC: invalid widget control type %d:%d:%d\n",
1232 control_hdr->ops.get, control_hdr->ops.put,
1233 le32_to_cpu(control_hdr->ops.info));
1234 ret = -EINVAL;
1235 goto hdr_err;
1239 template.kcontrol_news = kc;
1240 dev_dbg(tplg->dev, "ASoC: template %s with %d/%d/%d (mixer/enum/bytes) control\n",
1241 w->name, mixer_count, enum_count, bytes_count);
1243 widget:
1244 ret = soc_tplg_widget_load(tplg, &template, w);
1245 if (ret < 0)
1246 goto hdr_err;
1248 /* card dapm mutex is held by the core if we are loading topology
1249 * data during sound card init. */
1250 if (snd_soc_card_is_instantiated(card))
1251 widget = snd_soc_dapm_new_control(dapm, &template);
1252 else
1253 widget = snd_soc_dapm_new_control_unlocked(dapm, &template);
1254 if (IS_ERR(widget)) {
1255 ret = PTR_ERR(widget);
1256 goto hdr_err;
1259 widget->dobj.type = SND_SOC_DOBJ_WIDGET;
1260 widget->dobj.widget.kcontrol_type = kcontrol_type;
1261 if (tplg->ops)
1262 widget->dobj.unload = tplg->ops->widget_unload;
1263 widget->dobj.index = tplg->index;
1264 list_add(&widget->dobj.list, &tplg->comp->dobj_list);
1266 ret = soc_tplg_widget_ready(tplg, widget, w);
1267 if (ret < 0)
1268 goto ready_err;
1270 kfree(template.sname);
1271 kfree(template.name);
1273 return 0;
1275 ready_err:
1276 soc_tplg_remove_widget(widget->dapm->component, &widget->dobj, SOC_TPLG_PASS_WIDGET);
1277 snd_soc_dapm_free_widget(widget);
1278 hdr_err:
1279 kfree(template.sname);
1280 err:
1281 kfree(template.name);
1282 return ret;
1285 static int soc_tplg_dapm_widget_elems_load(struct soc_tplg *tplg,
1286 struct snd_soc_tplg_hdr *hdr)
1288 int count, i;
1290 count = le32_to_cpu(hdr->count);
1292 dev_dbg(tplg->dev, "ASoC: adding %d DAPM widgets\n", count);
1294 for (i = 0; i < count; i++) {
1295 struct snd_soc_tplg_dapm_widget *widget = (struct snd_soc_tplg_dapm_widget *) tplg->pos;
1296 int ret;
1299 * check if widget itself fits within topology file
1300 * use sizeof instead of widget->size, as we can't be sure
1301 * it is set properly yet (file may end before it is present)
1303 if (soc_tplg_get_offset(tplg) + sizeof(*widget) >= tplg->fw->size) {
1304 dev_err(tplg->dev, "ASoC: invalid widget data size\n");
1305 return -EINVAL;
1308 /* check if widget has proper size */
1309 if (le32_to_cpu(widget->size) != sizeof(*widget)) {
1310 dev_err(tplg->dev, "ASoC: invalid widget size\n");
1311 return -EINVAL;
1314 /* check if widget private data fits within topology file */
1315 if (soc_tplg_get_offset(tplg) + le32_to_cpu(widget->priv.size) >= tplg->fw->size) {
1316 dev_err(tplg->dev, "ASoC: invalid widget private data size\n");
1317 return -EINVAL;
1320 ret = soc_tplg_dapm_widget_create(tplg, widget);
1321 if (ret < 0) {
1322 dev_err(tplg->dev, "ASoC: failed to load widget %s\n",
1323 widget->name);
1324 return ret;
1328 return 0;
1331 static int soc_tplg_dapm_complete(struct soc_tplg *tplg)
1333 struct snd_soc_card *card = tplg->comp->card;
1334 int ret;
1336 /* Card might not have been registered at this point.
1337 * If so, just return success.
1339 if (!snd_soc_card_is_instantiated(card)) {
1340 dev_warn(tplg->dev, "ASoC: Parent card not yet available, widget card binding deferred\n");
1341 return 0;
1344 ret = snd_soc_dapm_new_widgets(card);
1345 if (ret < 0)
1346 dev_err(tplg->dev, "ASoC: failed to create new widgets %d\n", ret);
1348 return ret;
1351 static int set_stream_info(struct soc_tplg *tplg, struct snd_soc_pcm_stream *stream,
1352 struct snd_soc_tplg_stream_caps *caps)
1354 stream->stream_name = devm_kstrdup(tplg->dev, caps->name, GFP_KERNEL);
1355 if (!stream->stream_name)
1356 return -ENOMEM;
1358 stream->channels_min = le32_to_cpu(caps->channels_min);
1359 stream->channels_max = le32_to_cpu(caps->channels_max);
1360 stream->rates = le32_to_cpu(caps->rates);
1361 stream->rate_min = le32_to_cpu(caps->rate_min);
1362 stream->rate_max = le32_to_cpu(caps->rate_max);
1363 stream->formats = le64_to_cpu(caps->formats);
1364 stream->sig_bits = le32_to_cpu(caps->sig_bits);
1366 return 0;
1369 static void set_dai_flags(struct snd_soc_dai_driver *dai_drv,
1370 unsigned int flag_mask, unsigned int flags)
1372 if (flag_mask & SND_SOC_TPLG_DAI_FLGBIT_SYMMETRIC_RATES)
1373 dai_drv->symmetric_rate =
1374 (flags & SND_SOC_TPLG_DAI_FLGBIT_SYMMETRIC_RATES) ? 1 : 0;
1376 if (flag_mask & SND_SOC_TPLG_DAI_FLGBIT_SYMMETRIC_CHANNELS)
1377 dai_drv->symmetric_channels =
1378 (flags & SND_SOC_TPLG_DAI_FLGBIT_SYMMETRIC_CHANNELS) ?
1379 1 : 0;
1381 if (flag_mask & SND_SOC_TPLG_DAI_FLGBIT_SYMMETRIC_SAMPLEBITS)
1382 dai_drv->symmetric_sample_bits =
1383 (flags & SND_SOC_TPLG_DAI_FLGBIT_SYMMETRIC_SAMPLEBITS) ?
1384 1 : 0;
1387 static const struct snd_soc_dai_ops tplg_dai_ops = {
1388 .compress_new = snd_soc_new_compress,
1391 static int soc_tplg_dai_create(struct soc_tplg *tplg,
1392 struct snd_soc_tplg_pcm *pcm)
1394 struct snd_soc_dai_driver *dai_drv;
1395 struct snd_soc_pcm_stream *stream;
1396 struct snd_soc_tplg_stream_caps *caps;
1397 struct snd_soc_dai *dai;
1398 struct snd_soc_dapm_context *dapm =
1399 snd_soc_component_get_dapm(tplg->comp);
1400 int ret;
1402 dai_drv = devm_kzalloc(tplg->dev, sizeof(struct snd_soc_dai_driver), GFP_KERNEL);
1403 if (dai_drv == NULL)
1404 return -ENOMEM;
1406 if (strlen(pcm->dai_name)) {
1407 dai_drv->name = devm_kstrdup(tplg->dev, pcm->dai_name, GFP_KERNEL);
1408 if (!dai_drv->name) {
1409 ret = -ENOMEM;
1410 goto err;
1413 dai_drv->id = le32_to_cpu(pcm->dai_id);
1415 if (pcm->playback) {
1416 stream = &dai_drv->playback;
1417 caps = &pcm->caps[SND_SOC_TPLG_STREAM_PLAYBACK];
1418 ret = set_stream_info(tplg, stream, caps);
1419 if (ret < 0)
1420 goto err;
1423 if (pcm->capture) {
1424 stream = &dai_drv->capture;
1425 caps = &pcm->caps[SND_SOC_TPLG_STREAM_CAPTURE];
1426 ret = set_stream_info(tplg, stream, caps);
1427 if (ret < 0)
1428 goto err;
1431 if (pcm->compress)
1432 dai_drv->ops = &tplg_dai_ops;
1434 /* pass control to component driver for optional further init */
1435 ret = soc_tplg_dai_load(tplg, dai_drv, pcm, NULL);
1436 if (ret < 0) {
1437 dev_err(tplg->dev, "ASoC: DAI loading failed\n");
1438 goto err;
1441 dai_drv->dobj.index = tplg->index;
1442 dai_drv->dobj.type = SND_SOC_DOBJ_PCM;
1443 if (tplg->ops)
1444 dai_drv->dobj.unload = tplg->ops->dai_unload;
1445 list_add(&dai_drv->dobj.list, &tplg->comp->dobj_list);
1447 /* register the DAI to the component */
1448 dai = snd_soc_register_dai(tplg->comp, dai_drv, false);
1449 if (!dai)
1450 return -ENOMEM;
1452 /* Create the DAI widgets here */
1453 ret = snd_soc_dapm_new_dai_widgets(dapm, dai);
1454 if (ret != 0) {
1455 dev_err(dai->dev, "Failed to create DAI widgets %d\n", ret);
1456 snd_soc_unregister_dai(dai);
1457 return ret;
1460 return 0;
1462 err:
1463 return ret;
1466 static void set_link_flags(struct snd_soc_dai_link *link,
1467 unsigned int flag_mask, unsigned int flags)
1469 if (flag_mask & SND_SOC_TPLG_LNK_FLGBIT_SYMMETRIC_RATES)
1470 link->symmetric_rate =
1471 (flags & SND_SOC_TPLG_LNK_FLGBIT_SYMMETRIC_RATES) ? 1 : 0;
1473 if (flag_mask & SND_SOC_TPLG_LNK_FLGBIT_SYMMETRIC_CHANNELS)
1474 link->symmetric_channels =
1475 (flags & SND_SOC_TPLG_LNK_FLGBIT_SYMMETRIC_CHANNELS) ?
1476 1 : 0;
1478 if (flag_mask & SND_SOC_TPLG_LNK_FLGBIT_SYMMETRIC_SAMPLEBITS)
1479 link->symmetric_sample_bits =
1480 (flags & SND_SOC_TPLG_LNK_FLGBIT_SYMMETRIC_SAMPLEBITS) ?
1481 1 : 0;
1483 if (flag_mask & SND_SOC_TPLG_LNK_FLGBIT_VOICE_WAKEUP)
1484 link->ignore_suspend =
1485 (flags & SND_SOC_TPLG_LNK_FLGBIT_VOICE_WAKEUP) ?
1486 1 : 0;
1489 /* create the FE DAI link */
1490 static int soc_tplg_fe_link_create(struct soc_tplg *tplg,
1491 struct snd_soc_tplg_pcm *pcm)
1493 struct snd_soc_dai_link *link;
1494 struct snd_soc_dai_link_component *dlc;
1495 int ret;
1497 /* link + cpu + codec + platform */
1498 link = devm_kzalloc(tplg->dev, sizeof(*link) + (3 * sizeof(*dlc)), GFP_KERNEL);
1499 if (link == NULL)
1500 return -ENOMEM;
1502 dlc = (struct snd_soc_dai_link_component *)(link + 1);
1504 link->cpus = &dlc[0];
1505 link->num_cpus = 1;
1507 link->dobj.index = tplg->index;
1508 link->dobj.type = SND_SOC_DOBJ_DAI_LINK;
1509 if (tplg->ops)
1510 link->dobj.unload = tplg->ops->link_unload;
1512 if (strlen(pcm->pcm_name)) {
1513 link->name = devm_kstrdup(tplg->dev, pcm->pcm_name, GFP_KERNEL);
1514 link->stream_name = devm_kstrdup(tplg->dev, pcm->pcm_name, GFP_KERNEL);
1515 if (!link->name || !link->stream_name) {
1516 ret = -ENOMEM;
1517 goto err;
1520 link->id = le32_to_cpu(pcm->pcm_id);
1522 if (strlen(pcm->dai_name)) {
1523 link->cpus->dai_name = devm_kstrdup(tplg->dev, pcm->dai_name, GFP_KERNEL);
1524 if (!link->cpus->dai_name) {
1525 ret = -ENOMEM;
1526 goto err;
1531 * Many topology are assuming link has Codec / Platform, and
1532 * these might be overwritten at soc_tplg_dai_link_load().
1533 * Don't use &snd_soc_dummy_dlc here.
1535 link->codecs = &dlc[1]; /* Don't use &snd_soc_dummy_dlc here */
1536 link->codecs->name = "snd-soc-dummy";
1537 link->codecs->dai_name = "snd-soc-dummy-dai";
1538 link->num_codecs = 1;
1540 link->platforms = &dlc[2]; /* Don't use &snd_soc_dummy_dlc here */
1541 link->platforms->name = "snd-soc-dummy";
1542 link->num_platforms = 1;
1544 /* enable DPCM */
1545 link->dynamic = 1;
1546 link->ignore_pmdown_time = 1;
1547 link->playback_only = le32_to_cpu(pcm->playback) && !le32_to_cpu(pcm->capture);
1548 link->capture_only = !le32_to_cpu(pcm->playback) && le32_to_cpu(pcm->capture);
1549 if (pcm->flag_mask)
1550 set_link_flags(link,
1551 le32_to_cpu(pcm->flag_mask),
1552 le32_to_cpu(pcm->flags));
1554 /* pass control to component driver for optional further init */
1555 ret = soc_tplg_dai_link_load(tplg, link, NULL);
1556 if (ret < 0) {
1557 dev_err(tplg->dev, "ASoC: FE link loading failed\n");
1558 goto err;
1561 ret = snd_soc_add_pcm_runtimes(tplg->comp->card, link, 1);
1562 if (ret < 0) {
1563 if (ret != -EPROBE_DEFER)
1564 dev_err(tplg->dev, "ASoC: adding FE link failed\n");
1565 goto err;
1568 list_add(&link->dobj.list, &tplg->comp->dobj_list);
1570 return 0;
1571 err:
1572 return ret;
1575 /* create a FE DAI and DAI link from the PCM object */
1576 static int soc_tplg_pcm_create(struct soc_tplg *tplg,
1577 struct snd_soc_tplg_pcm *pcm)
1579 int ret;
1581 ret = soc_tplg_dai_create(tplg, pcm);
1582 if (ret < 0)
1583 return ret;
1585 return soc_tplg_fe_link_create(tplg, pcm);
1588 static int soc_tplg_pcm_elems_load(struct soc_tplg *tplg,
1589 struct snd_soc_tplg_hdr *hdr)
1591 struct snd_soc_tplg_pcm *pcm;
1592 int count;
1593 int size;
1594 int i;
1595 int ret;
1597 count = le32_to_cpu(hdr->count);
1599 /* check the element size and count */
1600 pcm = (struct snd_soc_tplg_pcm *)tplg->pos;
1601 size = le32_to_cpu(pcm->size);
1602 if (size > sizeof(struct snd_soc_tplg_pcm)) {
1603 dev_err(tplg->dev, "ASoC: invalid size %d for PCM elems\n",
1604 size);
1605 return -EINVAL;
1608 if (soc_tplg_check_elem_count(tplg,
1609 size, count,
1610 le32_to_cpu(hdr->payload_size),
1611 "PCM DAI"))
1612 return -EINVAL;
1614 for (i = 0; i < count; i++) {
1615 pcm = (struct snd_soc_tplg_pcm *)tplg->pos;
1616 size = le32_to_cpu(pcm->size);
1618 /* check ABI version by size, create a new version of pcm
1619 * if abi not match.
1621 if (size != sizeof(*pcm))
1622 return -EINVAL;
1624 /* create the FE DAIs and DAI links */
1625 ret = soc_tplg_pcm_create(tplg, pcm);
1626 if (ret < 0)
1627 return ret;
1629 /* offset by version-specific struct size and
1630 * real priv data size
1632 tplg->pos += size + le32_to_cpu(pcm->priv.size);
1635 dev_dbg(tplg->dev, "ASoC: adding %d PCM DAIs\n", count);
1637 return 0;
1641 * set_link_hw_format - Set the HW audio format of the physical DAI link.
1642 * @link: &snd_soc_dai_link which should be updated
1643 * @cfg: physical link configs.
1645 * Topology context contains a list of supported HW formats (configs) and
1646 * a default format ID for the physical link. This function will use this
1647 * default ID to choose the HW format to set the link's DAI format for init.
1649 static void set_link_hw_format(struct snd_soc_dai_link *link,
1650 struct snd_soc_tplg_link_config *cfg)
1652 struct snd_soc_tplg_hw_config *hw_config;
1653 unsigned char bclk_provider, fsync_provider;
1654 unsigned char invert_bclk, invert_fsync;
1655 int i;
1657 for (i = 0; i < le32_to_cpu(cfg->num_hw_configs); i++) {
1658 hw_config = &cfg->hw_config[i];
1659 if (hw_config->id != cfg->default_hw_config_id)
1660 continue;
1662 link->dai_fmt = le32_to_cpu(hw_config->fmt) &
1663 SND_SOC_DAIFMT_FORMAT_MASK;
1665 /* clock gating */
1666 switch (hw_config->clock_gated) {
1667 case SND_SOC_TPLG_DAI_CLK_GATE_GATED:
1668 link->dai_fmt |= SND_SOC_DAIFMT_GATED;
1669 break;
1671 case SND_SOC_TPLG_DAI_CLK_GATE_CONT:
1672 link->dai_fmt |= SND_SOC_DAIFMT_CONT;
1673 break;
1675 default:
1676 /* ignore the value */
1677 break;
1680 /* clock signal polarity */
1681 invert_bclk = hw_config->invert_bclk;
1682 invert_fsync = hw_config->invert_fsync;
1683 if (!invert_bclk && !invert_fsync)
1684 link->dai_fmt |= SND_SOC_DAIFMT_NB_NF;
1685 else if (!invert_bclk && invert_fsync)
1686 link->dai_fmt |= SND_SOC_DAIFMT_NB_IF;
1687 else if (invert_bclk && !invert_fsync)
1688 link->dai_fmt |= SND_SOC_DAIFMT_IB_NF;
1689 else
1690 link->dai_fmt |= SND_SOC_DAIFMT_IB_IF;
1692 /* clock masters */
1693 bclk_provider = (hw_config->bclk_provider ==
1694 SND_SOC_TPLG_BCLK_CP);
1695 fsync_provider = (hw_config->fsync_provider ==
1696 SND_SOC_TPLG_FSYNC_CP);
1697 if (bclk_provider && fsync_provider)
1698 link->dai_fmt |= SND_SOC_DAIFMT_CBP_CFP;
1699 else if (!bclk_provider && fsync_provider)
1700 link->dai_fmt |= SND_SOC_DAIFMT_CBC_CFP;
1701 else if (bclk_provider && !fsync_provider)
1702 link->dai_fmt |= SND_SOC_DAIFMT_CBP_CFC;
1703 else
1704 link->dai_fmt |= SND_SOC_DAIFMT_CBC_CFC;
1709 * snd_soc_find_dai_link - Find a DAI link
1711 * @card: soc card
1712 * @id: DAI link ID to match
1713 * @name: DAI link name to match, optional
1714 * @stream_name: DAI link stream name to match, optional
1716 * This function will search all existing DAI links of the soc card to
1717 * find the link of the same ID. Since DAI links may not have their
1718 * unique ID, so name and stream name should also match if being
1719 * specified.
1721 * Return: pointer of DAI link, or NULL if not found.
1723 static struct snd_soc_dai_link *snd_soc_find_dai_link(struct snd_soc_card *card,
1724 int id, const char *name,
1725 const char *stream_name)
1727 struct snd_soc_pcm_runtime *rtd;
1729 for_each_card_rtds(card, rtd) {
1730 struct snd_soc_dai_link *link = rtd->dai_link;
1732 if (link->id != id)
1733 continue;
1735 if (name && (!link->name || !strstr(link->name, name)))
1736 continue;
1738 if (stream_name && (!link->stream_name ||
1739 !strstr(link->stream_name, stream_name)))
1740 continue;
1742 return link;
1745 return NULL;
1748 /* Find and configure an existing physical DAI link */
1749 static int soc_tplg_link_config(struct soc_tplg *tplg,
1750 struct snd_soc_tplg_link_config *cfg)
1752 struct snd_soc_dai_link *link;
1753 const char *name, *stream_name;
1754 size_t len;
1755 int ret;
1757 len = strnlen(cfg->name, SNDRV_CTL_ELEM_ID_NAME_MAXLEN);
1758 if (len == SNDRV_CTL_ELEM_ID_NAME_MAXLEN)
1759 return -EINVAL;
1760 else if (len)
1761 name = cfg->name;
1762 else
1763 name = NULL;
1765 len = strnlen(cfg->stream_name, SNDRV_CTL_ELEM_ID_NAME_MAXLEN);
1766 if (len == SNDRV_CTL_ELEM_ID_NAME_MAXLEN)
1767 return -EINVAL;
1768 else if (len)
1769 stream_name = cfg->stream_name;
1770 else
1771 stream_name = NULL;
1773 link = snd_soc_find_dai_link(tplg->comp->card, le32_to_cpu(cfg->id),
1774 name, stream_name);
1775 if (!link) {
1776 dev_err(tplg->dev, "ASoC: physical link %s (id %d) not exist\n",
1777 name, cfg->id);
1778 return -EINVAL;
1781 /* hw format */
1782 if (cfg->num_hw_configs)
1783 set_link_hw_format(link, cfg);
1785 /* flags */
1786 if (cfg->flag_mask)
1787 set_link_flags(link,
1788 le32_to_cpu(cfg->flag_mask),
1789 le32_to_cpu(cfg->flags));
1791 /* pass control to component driver for optional further init */
1792 ret = soc_tplg_dai_link_load(tplg, link, cfg);
1793 if (ret < 0) {
1794 dev_err(tplg->dev, "ASoC: physical link loading failed\n");
1795 return ret;
1798 /* for unloading it in snd_soc_tplg_component_remove */
1799 link->dobj.index = tplg->index;
1800 link->dobj.type = SND_SOC_DOBJ_BACKEND_LINK;
1801 if (tplg->ops)
1802 link->dobj.unload = tplg->ops->link_unload;
1803 list_add(&link->dobj.list, &tplg->comp->dobj_list);
1805 return 0;
1809 /* Load physical link config elements from the topology context */
1810 static int soc_tplg_link_elems_load(struct soc_tplg *tplg,
1811 struct snd_soc_tplg_hdr *hdr)
1813 struct snd_soc_tplg_link_config *link;
1814 int count;
1815 int size;
1816 int i, ret;
1818 count = le32_to_cpu(hdr->count);
1820 /* check the element size and count */
1821 link = (struct snd_soc_tplg_link_config *)tplg->pos;
1822 size = le32_to_cpu(link->size);
1823 if (size > sizeof(struct snd_soc_tplg_link_config)) {
1824 dev_err(tplg->dev, "ASoC: invalid size %d for physical link elems\n",
1825 size);
1826 return -EINVAL;
1829 if (soc_tplg_check_elem_count(tplg, size, count,
1830 le32_to_cpu(hdr->payload_size),
1831 "physical link config"))
1832 return -EINVAL;
1834 /* config physical DAI links */
1835 for (i = 0; i < count; i++) {
1836 link = (struct snd_soc_tplg_link_config *)tplg->pos;
1837 size = le32_to_cpu(link->size);
1838 if (size != sizeof(*link))
1839 return -EINVAL;
1841 ret = soc_tplg_link_config(tplg, link);
1842 if (ret < 0)
1843 return ret;
1845 /* offset by version-specific struct size and
1846 * real priv data size
1848 tplg->pos += size + le32_to_cpu(link->priv.size);
1851 return 0;
1855 * soc_tplg_dai_config - Find and configure an existing physical DAI.
1856 * @tplg: topology context
1857 * @d: physical DAI configs.
1859 * The physical dai should already be registered by the platform driver.
1860 * The platform driver should specify the DAI name and ID for matching.
1862 static int soc_tplg_dai_config(struct soc_tplg *tplg,
1863 struct snd_soc_tplg_dai *d)
1865 struct snd_soc_dai_link_component dai_component;
1866 struct snd_soc_dai *dai;
1867 struct snd_soc_dai_driver *dai_drv;
1868 struct snd_soc_pcm_stream *stream;
1869 struct snd_soc_tplg_stream_caps *caps;
1870 int ret;
1872 memset(&dai_component, 0, sizeof(dai_component));
1874 dai_component.dai_name = d->dai_name;
1875 dai = snd_soc_find_dai(&dai_component);
1876 if (!dai) {
1877 dev_err(tplg->dev, "ASoC: physical DAI %s not registered\n",
1878 d->dai_name);
1879 return -EINVAL;
1882 if (le32_to_cpu(d->dai_id) != dai->id) {
1883 dev_err(tplg->dev, "ASoC: physical DAI %s id mismatch\n",
1884 d->dai_name);
1885 return -EINVAL;
1888 dai_drv = dai->driver;
1889 if (!dai_drv)
1890 return -EINVAL;
1892 if (d->playback) {
1893 stream = &dai_drv->playback;
1894 caps = &d->caps[SND_SOC_TPLG_STREAM_PLAYBACK];
1895 ret = set_stream_info(tplg, stream, caps);
1896 if (ret < 0)
1897 return ret;
1900 if (d->capture) {
1901 stream = &dai_drv->capture;
1902 caps = &d->caps[SND_SOC_TPLG_STREAM_CAPTURE];
1903 ret = set_stream_info(tplg, stream, caps);
1904 if (ret < 0)
1905 return ret;
1908 if (d->flag_mask)
1909 set_dai_flags(dai_drv,
1910 le32_to_cpu(d->flag_mask),
1911 le32_to_cpu(d->flags));
1913 /* pass control to component driver for optional further init */
1914 ret = soc_tplg_dai_load(tplg, dai_drv, NULL, dai);
1915 if (ret < 0) {
1916 dev_err(tplg->dev, "ASoC: DAI loading failed\n");
1917 return ret;
1920 return 0;
1923 /* load physical DAI elements */
1924 static int soc_tplg_dai_elems_load(struct soc_tplg *tplg,
1925 struct snd_soc_tplg_hdr *hdr)
1927 int count;
1928 int i;
1930 count = le32_to_cpu(hdr->count);
1932 /* config the existing BE DAIs */
1933 for (i = 0; i < count; i++) {
1934 struct snd_soc_tplg_dai *dai = (struct snd_soc_tplg_dai *)tplg->pos;
1935 int ret;
1937 if (le32_to_cpu(dai->size) != sizeof(*dai)) {
1938 dev_err(tplg->dev, "ASoC: invalid physical DAI size\n");
1939 return -EINVAL;
1942 ret = soc_tplg_dai_config(tplg, dai);
1943 if (ret < 0) {
1944 dev_err(tplg->dev, "ASoC: failed to configure DAI\n");
1945 return ret;
1948 tplg->pos += (sizeof(*dai) + le32_to_cpu(dai->priv.size));
1951 dev_dbg(tplg->dev, "ASoC: Configure %d BE DAIs\n", count);
1952 return 0;
1955 static int soc_tplg_manifest_load(struct soc_tplg *tplg,
1956 struct snd_soc_tplg_hdr *hdr)
1958 struct snd_soc_tplg_manifest *manifest;
1959 int ret = 0;
1961 manifest = (struct snd_soc_tplg_manifest *)tplg->pos;
1963 /* check ABI version by size, create a new manifest if abi not match */
1964 if (le32_to_cpu(manifest->size) != sizeof(*manifest))
1965 return -EINVAL;
1967 /* pass control to component driver for optional further init */
1968 if (tplg->ops && tplg->ops->manifest)
1969 ret = tplg->ops->manifest(tplg->comp, tplg->index, manifest);
1971 return ret;
1974 /* validate header magic, size and type */
1975 static int soc_tplg_valid_header(struct soc_tplg *tplg,
1976 struct snd_soc_tplg_hdr *hdr)
1978 if (le32_to_cpu(hdr->size) != sizeof(*hdr)) {
1979 dev_err(tplg->dev,
1980 "ASoC: invalid header size for type %d at offset 0x%lx size 0x%zx.\n",
1981 le32_to_cpu(hdr->type), soc_tplg_get_hdr_offset(tplg),
1982 tplg->fw->size);
1983 return -EINVAL;
1986 if (soc_tplg_get_hdr_offset(tplg) + le32_to_cpu(hdr->payload_size) >= tplg->fw->size) {
1987 dev_err(tplg->dev,
1988 "ASoC: invalid header of type %d at offset %ld payload_size %d\n",
1989 le32_to_cpu(hdr->type), soc_tplg_get_hdr_offset(tplg),
1990 hdr->payload_size);
1991 return -EINVAL;
1994 /* big endian firmware objects not supported atm */
1995 if (le32_to_cpu(hdr->magic) == SOC_TPLG_MAGIC_BIG_ENDIAN) {
1996 dev_err(tplg->dev,
1997 "ASoC: pass %d big endian not supported header got %x at offset 0x%lx size 0x%zx.\n",
1998 tplg->pass, hdr->magic,
1999 soc_tplg_get_hdr_offset(tplg), tplg->fw->size);
2000 return -EINVAL;
2003 if (le32_to_cpu(hdr->magic) != SND_SOC_TPLG_MAGIC) {
2004 dev_err(tplg->dev,
2005 "ASoC: pass %d does not have a valid header got %x at offset 0x%lx size 0x%zx.\n",
2006 tplg->pass, hdr->magic,
2007 soc_tplg_get_hdr_offset(tplg), tplg->fw->size);
2008 return -EINVAL;
2011 /* Support ABI from version 4 */
2012 if (le32_to_cpu(hdr->abi) > SND_SOC_TPLG_ABI_VERSION ||
2013 le32_to_cpu(hdr->abi) < SND_SOC_TPLG_ABI_VERSION_MIN) {
2014 dev_err(tplg->dev,
2015 "ASoC: pass %d invalid ABI version got 0x%x need 0x%x at offset 0x%lx size 0x%zx.\n",
2016 tplg->pass, hdr->abi,
2017 SND_SOC_TPLG_ABI_VERSION, soc_tplg_get_hdr_offset(tplg),
2018 tplg->fw->size);
2019 return -EINVAL;
2022 if (hdr->payload_size == 0) {
2023 dev_err(tplg->dev, "ASoC: header has 0 size at offset 0x%lx.\n",
2024 soc_tplg_get_hdr_offset(tplg));
2025 return -EINVAL;
2028 return 0;
2031 /* check header type and call appropriate handler */
2032 static int soc_tplg_load_header(struct soc_tplg *tplg,
2033 struct snd_soc_tplg_hdr *hdr)
2035 int (*elem_load)(struct soc_tplg *tplg,
2036 struct snd_soc_tplg_hdr *hdr);
2037 unsigned int hdr_pass;
2039 tplg->pos = tplg->hdr_pos + sizeof(struct snd_soc_tplg_hdr);
2041 tplg->index = le32_to_cpu(hdr->index);
2043 switch (le32_to_cpu(hdr->type)) {
2044 case SND_SOC_TPLG_TYPE_MIXER:
2045 case SND_SOC_TPLG_TYPE_ENUM:
2046 case SND_SOC_TPLG_TYPE_BYTES:
2047 hdr_pass = SOC_TPLG_PASS_CONTROL;
2048 elem_load = soc_tplg_kcontrol_elems_load;
2049 break;
2050 case SND_SOC_TPLG_TYPE_DAPM_GRAPH:
2051 hdr_pass = SOC_TPLG_PASS_GRAPH;
2052 elem_load = soc_tplg_dapm_graph_elems_load;
2053 break;
2054 case SND_SOC_TPLG_TYPE_DAPM_WIDGET:
2055 hdr_pass = SOC_TPLG_PASS_WIDGET;
2056 elem_load = soc_tplg_dapm_widget_elems_load;
2057 break;
2058 case SND_SOC_TPLG_TYPE_PCM:
2059 hdr_pass = SOC_TPLG_PASS_PCM_DAI;
2060 elem_load = soc_tplg_pcm_elems_load;
2061 break;
2062 case SND_SOC_TPLG_TYPE_DAI:
2063 hdr_pass = SOC_TPLG_PASS_BE_DAI;
2064 elem_load = soc_tplg_dai_elems_load;
2065 break;
2066 case SND_SOC_TPLG_TYPE_DAI_LINK:
2067 case SND_SOC_TPLG_TYPE_BACKEND_LINK:
2068 /* physical link configurations */
2069 hdr_pass = SOC_TPLG_PASS_LINK;
2070 elem_load = soc_tplg_link_elems_load;
2071 break;
2072 case SND_SOC_TPLG_TYPE_MANIFEST:
2073 hdr_pass = SOC_TPLG_PASS_MANIFEST;
2074 elem_load = soc_tplg_manifest_load;
2075 break;
2076 default:
2077 /* bespoke vendor data object */
2078 hdr_pass = SOC_TPLG_PASS_VENDOR;
2079 elem_load = soc_tplg_vendor_load;
2080 break;
2083 if (tplg->pass == hdr_pass) {
2084 dev_dbg(tplg->dev,
2085 "ASoC: Got 0x%x bytes of type %d version %d vendor %d at pass %d\n",
2086 hdr->payload_size, hdr->type, hdr->version,
2087 hdr->vendor_type, tplg->pass);
2088 return elem_load(tplg, hdr);
2091 return 0;
2094 /* process the topology file headers */
2095 static int soc_tplg_process_headers(struct soc_tplg *tplg)
2097 int ret;
2099 /* process the header types from start to end */
2100 for (tplg->pass = SOC_TPLG_PASS_START; tplg->pass <= SOC_TPLG_PASS_END; tplg->pass++) {
2101 struct snd_soc_tplg_hdr *hdr;
2103 tplg->hdr_pos = tplg->fw->data;
2104 hdr = (struct snd_soc_tplg_hdr *)tplg->hdr_pos;
2106 while (!soc_tplg_is_eof(tplg)) {
2108 /* make sure header is valid before loading */
2109 ret = soc_tplg_valid_header(tplg, hdr);
2110 if (ret < 0)
2111 return ret;
2113 /* load the header object */
2114 ret = soc_tplg_load_header(tplg, hdr);
2115 if (ret < 0) {
2116 if (ret != -EPROBE_DEFER) {
2117 dev_err(tplg->dev,
2118 "ASoC: topology: could not load header: %d\n",
2119 ret);
2121 return ret;
2124 /* goto next header */
2125 tplg->hdr_pos += le32_to_cpu(hdr->payload_size) +
2126 sizeof(struct snd_soc_tplg_hdr);
2127 hdr = (struct snd_soc_tplg_hdr *)tplg->hdr_pos;
2132 /* signal DAPM we are complete */
2133 ret = soc_tplg_dapm_complete(tplg);
2135 return ret;
2138 static int soc_tplg_load(struct soc_tplg *tplg)
2140 int ret;
2142 ret = soc_tplg_process_headers(tplg);
2143 if (ret == 0)
2144 return soc_tplg_complete(tplg);
2146 return ret;
2149 /* load audio component topology from "firmware" file */
2150 int snd_soc_tplg_component_load(struct snd_soc_component *comp,
2151 const struct snd_soc_tplg_ops *ops, const struct firmware *fw)
2153 struct soc_tplg tplg;
2154 int ret;
2157 * check if we have sane parameters:
2158 * comp - needs to exist to keep and reference data while parsing
2159 * comp->card - used for setting card related parameters
2160 * comp->card->dev - used for resource management and prints
2161 * fw - we need it, as it is the very thing we parse
2163 if (!comp || !comp->card || !comp->card->dev || !fw)
2164 return -EINVAL;
2166 /* setup parsing context */
2167 memset(&tplg, 0, sizeof(tplg));
2168 tplg.fw = fw;
2169 tplg.dev = comp->card->dev;
2170 tplg.comp = comp;
2171 if (ops) {
2172 tplg.ops = ops;
2173 tplg.io_ops = ops->io_ops;
2174 tplg.io_ops_count = ops->io_ops_count;
2175 tplg.bytes_ext_ops = ops->bytes_ext_ops;
2176 tplg.bytes_ext_ops_count = ops->bytes_ext_ops_count;
2179 ret = soc_tplg_load(&tplg);
2180 /* free the created components if fail to load topology */
2181 if (ret)
2182 snd_soc_tplg_component_remove(comp);
2184 return ret;
2186 EXPORT_SYMBOL_GPL(snd_soc_tplg_component_load);
2188 /* remove dynamic controls from the component driver */
2189 int snd_soc_tplg_component_remove(struct snd_soc_component *comp)
2191 struct snd_soc_dobj *dobj, *next_dobj;
2192 int pass;
2194 /* process the header types from end to start */
2195 for (pass = SOC_TPLG_PASS_END; pass >= SOC_TPLG_PASS_START; pass--) {
2197 /* remove mixer controls */
2198 list_for_each_entry_safe(dobj, next_dobj, &comp->dobj_list,
2199 list) {
2201 switch (dobj->type) {
2202 case SND_SOC_DOBJ_BYTES:
2203 case SND_SOC_DOBJ_ENUM:
2204 case SND_SOC_DOBJ_MIXER:
2205 soc_tplg_remove_kcontrol(comp, dobj, pass);
2206 break;
2207 case SND_SOC_DOBJ_GRAPH:
2208 soc_tplg_remove_route(comp, dobj, pass);
2209 break;
2210 case SND_SOC_DOBJ_WIDGET:
2211 soc_tplg_remove_widget(comp, dobj, pass);
2212 break;
2213 case SND_SOC_DOBJ_PCM:
2214 soc_tplg_remove_dai(comp, dobj, pass);
2215 break;
2216 case SND_SOC_DOBJ_DAI_LINK:
2217 soc_tplg_remove_link(comp, dobj, pass);
2218 break;
2219 case SND_SOC_DOBJ_BACKEND_LINK:
2221 * call link_unload ops if extra
2222 * deinitialization is needed.
2224 remove_backend_link(comp, dobj, pass);
2225 break;
2226 default:
2227 dev_err(comp->dev, "ASoC: invalid component type %d for removal\n",
2228 dobj->type);
2229 break;
2234 /* let caller know if FW can be freed when no objects are left */
2235 return !list_empty(&comp->dobj_list);
2237 EXPORT_SYMBOL_GPL(snd_soc_tplg_component_remove);