xref: /linux/sound/soc/intel/avs/topology.h (revision 908fc4c2)
1 /* SPDX-License-Identifier: GPL-2.0-only */
2 /*
3  * Copyright(c) 2021 Intel Corporation. All rights reserved.
4  *
5  * Authors: Cezary Rojewski <cezary.rojewski@intel.com>
6  *          Amadeusz Slawinski <amadeuszx.slawinski@linux.intel.com>
7  */
8 
9 #ifndef __SOUND_SOC_INTEL_AVS_TPLG_H
10 #define __SOUND_SOC_INTEL_AVS_TPLG_H
11 
12 #include <linux/list.h>
13 #include "messages.h"
14 
15 #define INVALID_OBJECT_ID	UINT_MAX
16 
17 struct snd_soc_component;
18 
19 struct avs_tplg {
20 	char name[SNDRV_CTL_ELEM_ID_NAME_MAXLEN];
21 	u32 version;
22 	struct snd_soc_component *comp;
23 
24 	struct avs_tplg_library *libs;
25 	u32 num_libs;
26 	struct avs_audio_format *fmts;
27 	u32 num_fmts;
28 	struct avs_tplg_modcfg_base *modcfgs_base;
29 	u32 num_modcfgs_base;
30 	struct avs_tplg_modcfg_ext *modcfgs_ext;
31 	u32 num_modcfgs_ext;
32 	struct avs_tplg_pplcfg *pplcfgs;
33 	u32 num_pplcfgs;
34 	struct avs_tplg_binding *bindings;
35 	u32 num_bindings;
36 
37 	struct list_head path_tmpl_list;
38 };
39 
40 struct avs_tplg_library {
41 	char name[SNDRV_CTL_ELEM_ID_NAME_MAXLEN];
42 };
43 
44 /* Matches header of struct avs_mod_cfg_base. */
45 struct avs_tplg_modcfg_base {
46 	u32 cpc;
47 	u32 ibs;
48 	u32 obs;
49 	u32 is_pages;
50 };
51 
52 struct avs_tplg_pin_format {
53 	u32 pin_index;
54 	u32 iobs;
55 	struct avs_audio_format *fmt;
56 };
57 
58 struct avs_tplg_modcfg_ext {
59 	guid_t type;
60 
61 	union {
62 		struct {
63 			u16 num_input_pins;
64 			u16 num_output_pins;
65 			struct avs_tplg_pin_format *pin_fmts;
66 		} generic;
67 		struct {
68 			struct avs_audio_format *out_fmt;
69 			struct avs_audio_format *blob_fmt; /* optional override */
70 			u32 feature_mask;
71 			union avs_virtual_index vindex;
72 			u32 dma_type;
73 			u32 dma_buffer_size;
74 			u32 config_length;
75 			/* config_data part of priv data */
76 		} copier;
77 		struct {
78 			u32 out_channel_config;
79 			u32 coefficients_select;
80 			s32 coefficients[AVS_CHANNELS_MAX];
81 			u32 channel_map;
82 		} updown_mix;
83 		struct {
84 			u32 out_freq;
85 		} src;
86 		struct {
87 			u32 out_freq;
88 			u8 mode;
89 			u8 disable_jitter_buffer;
90 		} asrc;
91 		struct {
92 			u32 cpc_lp_mode;
93 		} wov;
94 		struct {
95 			struct avs_audio_format *ref_fmt;
96 			struct avs_audio_format *out_fmt;
97 			u32 cpc_lp_mode;
98 		} aec;
99 		struct {
100 			struct avs_audio_format *ref_fmt;
101 			struct avs_audio_format *out_fmt;
102 		} mux;
103 		struct {
104 			struct avs_audio_format *out_fmt;
105 		} micsel;
106 	};
107 };
108 
109 /* Specifies path behaviour during PCM ->trigger(START) command. */
110 enum avs_tplg_trigger {
111 	AVS_TPLG_TRIGGER_AUTO = 0,
112 };
113 
114 struct avs_tplg_pplcfg {
115 	u16 req_size;
116 	u8 priority;
117 	bool lp;
118 	u16 attributes;
119 	enum avs_tplg_trigger trigger;
120 };
121 
122 struct avs_tplg_binding {
123 	char target_tplg_name[SNDRV_CTL_ELEM_ID_NAME_MAXLEN];
124 	u32 target_path_tmpl_id;
125 	u32 target_ppl_id;
126 	u32 target_mod_id;
127 	u8 target_mod_pin;
128 	u32 mod_id;
129 	u8 mod_pin;
130 	u8 is_sink;
131 };
132 
133 struct avs_tplg_path_template_id {
134 	u32 id;
135 	char tplg_name[SNDRV_CTL_ELEM_ID_NAME_MAXLEN];
136 };
137 
138 struct avs_tplg_path_template {
139 	u32 id;
140 
141 	struct list_head path_list;
142 
143 	struct avs_tplg *owner;
144 	/* Driver path templates management. */
145 	struct list_head node;
146 };
147 
148 struct avs_tplg_path {
149 	u32 id;
150 
151 	/* Path format requirements. */
152 	struct avs_audio_format *fe_fmt;
153 	struct avs_audio_format *be_fmt;
154 
155 	struct list_head ppl_list;
156 
157 	struct avs_tplg_path_template *owner;
158 	/* Path template path-variants management. */
159 	struct list_head node;
160 };
161 
162 struct avs_tplg_pipeline {
163 	u32 id;
164 
165 	struct avs_tplg_pplcfg *cfg;
166 	struct avs_tplg_binding **bindings;
167 	u32 num_bindings;
168 	struct list_head mod_list;
169 
170 	struct avs_tplg_path *owner;
171 	/* Path pipelines management. */
172 	struct list_head node;
173 };
174 
175 struct avs_tplg_module {
176 	u32 id;
177 
178 	struct avs_tplg_modcfg_base *cfg_base;
179 	struct avs_audio_format *in_fmt;
180 	u8 core_id;
181 	u8 domain;
182 	struct avs_tplg_modcfg_ext *cfg_ext;
183 
184 	struct avs_tplg_pipeline *owner;
185 	/* Pipeline modules management. */
186 	struct list_head node;
187 };
188 
189 struct avs_tplg *avs_tplg_new(struct snd_soc_component *comp);
190 
191 int avs_load_topology(struct snd_soc_component *comp, const char *filename);
192 int avs_remove_topology(struct snd_soc_component *comp);
193 
194 #endif
195