// SPDX-License-Identifier: GPL-2.0+ // // soc-topology.c -- ALSA SoC Topology // // Copyright (C) 2012 Texas Instruments Inc. // Copyright (C) 2015 Intel Corporation. // // Authors: Liam Girdwood <[email protected]> // K, Mythri P <[email protected]> // Prusty, Subhransu S <[email protected]> // B, Jayachandran <[email protected]> // Abdullah, Omair M <[email protected]> // Jin, Yao <[email protected]> // Lin, Mengdong <[email protected]> // // Add support to read audio firmware topology alongside firmware text. The // topology data can contain kcontrols, DAPM graphs, widgets, DAIs, DAI links, // equalizers, firmware, coefficients etc. // // This file only manages the core ALSA and ASoC components, all other bespoke // firmware topology data is passed to component drivers for bespoke handling. #include <linux/kernel.h> #include <linux/export.h> #include <linux/list.h> #include <linux/firmware.h> #include <linux/slab.h> #include <sound/soc.h> #include <sound/soc-dapm.h> #include <sound/soc-topology.h> #include <sound/tlv.h> #define SOC_TPLG_MAGIC_BIG_ENDIAN … /* * We make several passes over the data (since it wont necessarily be ordered) * and process objects in the following order. This guarantees the component * drivers will be ready with any vendor data before the mixers and DAPM objects * are loaded (that may make use of the vendor data). */ #define SOC_TPLG_PASS_MANIFEST … #define SOC_TPLG_PASS_VENDOR … #define SOC_TPLG_PASS_CONTROL … #define SOC_TPLG_PASS_WIDGET … #define SOC_TPLG_PASS_PCM_DAI … #define SOC_TPLG_PASS_GRAPH … #define SOC_TPLG_PASS_BE_DAI … #define SOC_TPLG_PASS_LINK … #define SOC_TPLG_PASS_START … #define SOC_TPLG_PASS_END … /* topology context */ struct soc_tplg { … }; /* check we dont overflow the data for this control chunk */ static int soc_tplg_check_elem_count(struct soc_tplg *tplg, size_t elem_size, unsigned int count, size_t bytes, const char *elem_type) { … } static inline bool soc_tplg_is_eof(struct soc_tplg *tplg) { … } static inline unsigned long soc_tplg_get_hdr_offset(struct soc_tplg *tplg) { … } static inline unsigned long soc_tplg_get_offset(struct soc_tplg *tplg) { … } /* mapping of Kcontrol types and associated operations. */ static const struct snd_soc_tplg_kcontrol_ops io_ops[] = …; struct soc_tplg_map { … }; /* mapping of widget types from UAPI IDs to kernel IDs */ static const struct soc_tplg_map dapm_map[] = …; static int tplg_chan_get_reg(struct soc_tplg *tplg, struct snd_soc_tplg_channel *chan, int map) { … } static int tplg_chan_get_shift(struct soc_tplg *tplg, struct snd_soc_tplg_channel *chan, int map) { … } static int get_widget_id(int tplg_type) { … } static inline void soc_bind_err(struct soc_tplg *tplg, struct snd_soc_tplg_ctl_hdr *hdr, int index) { … } static inline void soc_control_err(struct soc_tplg *tplg, struct snd_soc_tplg_ctl_hdr *hdr, const char *name) { … } /* pass vendor data to component driver for processing */ static int soc_tplg_vendor_load(struct soc_tplg *tplg, struct snd_soc_tplg_hdr *hdr) { … } /* optionally pass new dynamic widget to component driver. This is mainly for * external widgets where we can assign private data/ops */ static int soc_tplg_widget_load(struct soc_tplg *tplg, struct snd_soc_dapm_widget *w, struct snd_soc_tplg_dapm_widget *tplg_w) { … } /* optionally pass new dynamic widget to component driver. This is mainly for * external widgets where we can assign private data/ops */ static int soc_tplg_widget_ready(struct soc_tplg *tplg, struct snd_soc_dapm_widget *w, struct snd_soc_tplg_dapm_widget *tplg_w) { … } /* pass DAI configurations to component driver for extra initialization */ static int soc_tplg_dai_load(struct soc_tplg *tplg, struct snd_soc_dai_driver *dai_drv, struct snd_soc_tplg_pcm *pcm, struct snd_soc_dai *dai) { … } /* pass link configurations to component driver for extra initialization */ static int soc_tplg_dai_link_load(struct soc_tplg *tplg, struct snd_soc_dai_link *link, struct snd_soc_tplg_link_config *cfg) { … } /* tell the component driver that all firmware has been loaded in this request */ static int soc_tplg_complete(struct soc_tplg *tplg) { … } /* add a dynamic kcontrol */ static int soc_tplg_add_dcontrol(struct snd_card *card, struct device *dev, const struct snd_kcontrol_new *control_new, const char *prefix, void *data, struct snd_kcontrol **kcontrol) { … } /* add a dynamic kcontrol for component driver */ static int soc_tplg_add_kcontrol(struct soc_tplg *tplg, struct snd_kcontrol_new *k, struct snd_kcontrol **kcontrol) { … } /* remove kcontrol */ static void soc_tplg_remove_kcontrol(struct snd_soc_component *comp, struct snd_soc_dobj *dobj, int pass) { … } /* remove a route */ static void soc_tplg_remove_route(struct snd_soc_component *comp, struct snd_soc_dobj *dobj, int pass) { … } /* remove a widget and it's kcontrols - routes must be removed first */ static void soc_tplg_remove_widget(struct snd_soc_component *comp, struct snd_soc_dobj *dobj, int pass) { … } /* remove DAI configurations */ static void soc_tplg_remove_dai(struct snd_soc_component *comp, struct snd_soc_dobj *dobj, int pass) { … } /* remove link configurations */ static void soc_tplg_remove_link(struct snd_soc_component *comp, struct snd_soc_dobj *dobj, int pass) { … } /* unload dai link */ static void remove_backend_link(struct snd_soc_component *comp, struct snd_soc_dobj *dobj, int pass) { … } /* bind a kcontrol to it's IO handlers */ static int soc_tplg_kcontrol_bind_io(struct snd_soc_tplg_ctl_hdr *hdr, struct snd_kcontrol_new *k, const struct soc_tplg *tplg) { … } /* bind a widgets to it's evnt handlers */ int snd_soc_tplg_widget_bind_event(struct snd_soc_dapm_widget *w, const struct snd_soc_tplg_widget_events *events, int num_events, u16 event_type) { … } EXPORT_SYMBOL_GPL(…); /* optionally pass new dynamic kcontrol to component driver. */ static int soc_tplg_control_load(struct soc_tplg *tplg, struct snd_kcontrol_new *k, struct snd_soc_tplg_ctl_hdr *hdr) { … } static int soc_tplg_create_tlv_db_scale(struct soc_tplg *tplg, struct snd_kcontrol_new *kc, struct snd_soc_tplg_tlv_dbscale *scale) { … } static int soc_tplg_create_tlv(struct soc_tplg *tplg, struct snd_kcontrol_new *kc, struct snd_soc_tplg_ctl_hdr *tc) { … } static int soc_tplg_control_dmixer_create(struct soc_tplg *tplg, struct snd_kcontrol_new *kc) { … } static int soc_tplg_denum_create_texts(struct soc_tplg *tplg, struct soc_enum *se, struct snd_soc_tplg_enum_control *ec) { … } static int soc_tplg_denum_create_values(struct soc_tplg *tplg, struct soc_enum *se, struct snd_soc_tplg_enum_control *ec) { … } static int soc_tplg_control_denum_create(struct soc_tplg *tplg, struct snd_kcontrol_new *kc) { … } static int soc_tplg_control_dbytes_create(struct soc_tplg *tplg, struct snd_kcontrol_new *kc) { … } static int soc_tplg_dbytes_create(struct soc_tplg *tplg, size_t size) { … } static int soc_tplg_dmixer_create(struct soc_tplg *tplg, size_t size) { … } static int soc_tplg_denum_create(struct soc_tplg *tplg, size_t size) { … } static int soc_tplg_kcontrol_elems_load(struct soc_tplg *tplg, struct snd_soc_tplg_hdr *hdr) { … } /* optionally pass new dynamic kcontrol to component driver. */ static int soc_tplg_add_route(struct soc_tplg *tplg, struct snd_soc_dapm_route *route) { … } static int soc_tplg_dapm_graph_elems_load(struct soc_tplg *tplg, struct snd_soc_tplg_hdr *hdr) { … } static int soc_tplg_dapm_widget_create(struct soc_tplg *tplg, struct snd_soc_tplg_dapm_widget *w) { … } static int soc_tplg_dapm_widget_elems_load(struct soc_tplg *tplg, struct snd_soc_tplg_hdr *hdr) { … } static int soc_tplg_dapm_complete(struct soc_tplg *tplg) { … } static int set_stream_info(struct soc_tplg *tplg, struct snd_soc_pcm_stream *stream, struct snd_soc_tplg_stream_caps *caps) { … } static void set_dai_flags(struct snd_soc_dai_driver *dai_drv, unsigned int flag_mask, unsigned int flags) { … } static const struct snd_soc_dai_ops tplg_dai_ops = …; static int soc_tplg_dai_create(struct soc_tplg *tplg, struct snd_soc_tplg_pcm *pcm) { … } static void set_link_flags(struct snd_soc_dai_link *link, unsigned int flag_mask, unsigned int flags) { … } /* create the FE DAI link */ static int soc_tplg_fe_link_create(struct soc_tplg *tplg, struct snd_soc_tplg_pcm *pcm) { … } /* create a FE DAI and DAI link from the PCM object */ static int soc_tplg_pcm_create(struct soc_tplg *tplg, struct snd_soc_tplg_pcm *pcm) { … } static int soc_tplg_pcm_elems_load(struct soc_tplg *tplg, struct snd_soc_tplg_hdr *hdr) { … } /** * set_link_hw_format - Set the HW audio format of the physical DAI link. * @link: &snd_soc_dai_link which should be updated * @cfg: physical link configs. * * Topology context contains a list of supported HW formats (configs) and * a default format ID for the physical link. This function will use this * default ID to choose the HW format to set the link's DAI format for init. */ static void set_link_hw_format(struct snd_soc_dai_link *link, struct snd_soc_tplg_link_config *cfg) { … } /** * snd_soc_find_dai_link - Find a DAI link * * @card: soc card * @id: DAI link ID to match * @name: DAI link name to match, optional * @stream_name: DAI link stream name to match, optional * * This function will search all existing DAI links of the soc card to * find the link of the same ID. Since DAI links may not have their * unique ID, so name and stream name should also match if being * specified. * * Return: pointer of DAI link, or NULL if not found. */ static struct snd_soc_dai_link *snd_soc_find_dai_link(struct snd_soc_card *card, int id, const char *name, const char *stream_name) { … } /* Find and configure an existing physical DAI link */ static int soc_tplg_link_config(struct soc_tplg *tplg, struct snd_soc_tplg_link_config *cfg) { … } /* Load physical link config elements from the topology context */ static int soc_tplg_link_elems_load(struct soc_tplg *tplg, struct snd_soc_tplg_hdr *hdr) { … } /** * soc_tplg_dai_config - Find and configure an existing physical DAI. * @tplg: topology context * @d: physical DAI configs. * * The physical dai should already be registered by the platform driver. * The platform driver should specify the DAI name and ID for matching. */ static int soc_tplg_dai_config(struct soc_tplg *tplg, struct snd_soc_tplg_dai *d) { … } /* load physical DAI elements */ static int soc_tplg_dai_elems_load(struct soc_tplg *tplg, struct snd_soc_tplg_hdr *hdr) { … } static int soc_tplg_manifest_load(struct soc_tplg *tplg, struct snd_soc_tplg_hdr *hdr) { … } /* validate header magic, size and type */ static int soc_tplg_valid_header(struct soc_tplg *tplg, struct snd_soc_tplg_hdr *hdr) { … } /* check header type and call appropriate handler */ static int soc_tplg_load_header(struct soc_tplg *tplg, struct snd_soc_tplg_hdr *hdr) { … } /* process the topology file headers */ static int soc_tplg_process_headers(struct soc_tplg *tplg) { … } static int soc_tplg_load(struct soc_tplg *tplg) { … } /* load audio component topology from "firmware" file */ int snd_soc_tplg_component_load(struct snd_soc_component *comp, const struct snd_soc_tplg_ops *ops, const struct firmware *fw) { … } EXPORT_SYMBOL_GPL(…); /* remove dynamic controls from the component driver */ int snd_soc_tplg_component_remove(struct snd_soc_component *comp) { … } EXPORT_SYMBOL_GPL(…);
Codebase Browser
linux