1 /* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
2 /*
3  * uapi/sound/asoc.h -- ALSA SoC Firmware Controls and DAPM
4  *
5  * Copyright (C) 2012 Texas Instruments Inc.
6  * Copyright (C) 2015 Intel Corporation.
7  *
8  * Simple file API to load FW that includes mixers, coefficients, DAPM graphs,
9  * algorithms, equalisers, DAIs, widgets etc.
10 */
11 
12 #ifndef __LINUX_UAPI_SND_ASOC_H
13 #define __LINUX_UAPI_SND_ASOC_H
14 
15 #include <linux/types.h>
16 #include <sound/asound.h>
17 
18 /*
19  * Maximum number of channels topology kcontrol can represent.
20  */
21 #define SND_SOC_TPLG_MAX_CHAN		8
22 
23 /*
24  * Maximum number of PCM formats capability
25  */
26 #define SND_SOC_TPLG_MAX_FORMATS	16
27 
28 /*
29  * Maximum number of PCM stream configs
30  */
31 #define SND_SOC_TPLG_STREAM_CONFIG_MAX  8
32 
33 /*
34  * Maximum number of physical link's hardware configs
35  */
36 #define SND_SOC_TPLG_HW_CONFIG_MAX	8
37 
38 /* individual kcontrol info types - can be mixed with other types */
39 #define SND_SOC_TPLG_CTL_VOLSW		1
40 #define SND_SOC_TPLG_CTL_VOLSW_SX	2
41 #define SND_SOC_TPLG_CTL_VOLSW_XR_SX	3
42 #define SND_SOC_TPLG_CTL_ENUM		4
43 #define SND_SOC_TPLG_CTL_BYTES		5
44 #define SND_SOC_TPLG_CTL_ENUM_VALUE	6
45 #define SND_SOC_TPLG_CTL_RANGE		7
46 #define SND_SOC_TPLG_CTL_STROBE		8
47 
48 
49 /* individual widget kcontrol info types - can be mixed with other types */
50 #define SND_SOC_TPLG_DAPM_CTL_VOLSW		64
51 #define SND_SOC_TPLG_DAPM_CTL_ENUM_DOUBLE	65
52 #define SND_SOC_TPLG_DAPM_CTL_ENUM_VIRT		66
53 #define SND_SOC_TPLG_DAPM_CTL_ENUM_VALUE	67
54 #define SND_SOC_TPLG_DAPM_CTL_PIN		68
55 
56 /* DAPM widget types - add new items to the end */
57 #define SND_SOC_TPLG_DAPM_INPUT		0
58 #define SND_SOC_TPLG_DAPM_OUTPUT	1
59 #define SND_SOC_TPLG_DAPM_MUX		2
60 #define SND_SOC_TPLG_DAPM_MIXER		3
61 #define SND_SOC_TPLG_DAPM_PGA		4
62 #define SND_SOC_TPLG_DAPM_OUT_DRV	5
63 #define SND_SOC_TPLG_DAPM_ADC		6
64 #define SND_SOC_TPLG_DAPM_DAC		7
65 #define SND_SOC_TPLG_DAPM_SWITCH	8
66 #define SND_SOC_TPLG_DAPM_PRE		9
67 #define SND_SOC_TPLG_DAPM_POST		10
68 #define SND_SOC_TPLG_DAPM_AIF_IN	11
69 #define SND_SOC_TPLG_DAPM_AIF_OUT	12
70 #define SND_SOC_TPLG_DAPM_DAI_IN	13
71 #define SND_SOC_TPLG_DAPM_DAI_OUT	14
72 #define SND_SOC_TPLG_DAPM_DAI_LINK	15
73 #define SND_SOC_TPLG_DAPM_BUFFER	16
74 #define SND_SOC_TPLG_DAPM_SCHEDULER	17
75 #define SND_SOC_TPLG_DAPM_EFFECT	18
76 #define SND_SOC_TPLG_DAPM_SIGGEN	19
77 #define SND_SOC_TPLG_DAPM_SRC		20
78 #define SND_SOC_TPLG_DAPM_ASRC		21
79 #define SND_SOC_TPLG_DAPM_ENCODER	22
80 #define SND_SOC_TPLG_DAPM_DECODER	23
81 #define SND_SOC_TPLG_DAPM_LAST		SND_SOC_TPLG_DAPM_DECODER
82 
83 /* Header magic number and string sizes */
84 #define SND_SOC_TPLG_MAGIC		0x41536F43 /* ASoC */
85 
86 /* string sizes */
87 #define SND_SOC_TPLG_NUM_TEXTS		16
88 
89 /* ABI version */
90 #define SND_SOC_TPLG_ABI_VERSION	0x5	/* current version */
91 #define SND_SOC_TPLG_ABI_VERSION_MIN	0x4	/* oldest version supported */
92 
93 /* Max size of TLV data */
94 #define SND_SOC_TPLG_TLV_SIZE		32
95 
96 /*
97  * File and Block header data types.
98  * Add new generic and vendor types to end of list.
99  * Generic types are handled by the core whilst vendors types are passed
100  * to the component drivers for handling.
101  */
102 #define SND_SOC_TPLG_TYPE_MIXER		1
103 #define SND_SOC_TPLG_TYPE_BYTES		2
104 #define SND_SOC_TPLG_TYPE_ENUM		3
105 #define SND_SOC_TPLG_TYPE_DAPM_GRAPH	4
106 #define SND_SOC_TPLG_TYPE_DAPM_WIDGET	5
107 #define SND_SOC_TPLG_TYPE_DAI_LINK	6
108 #define SND_SOC_TPLG_TYPE_PCM		7
109 #define SND_SOC_TPLG_TYPE_MANIFEST	8
110 #define SND_SOC_TPLG_TYPE_CODEC_LINK	9
111 #define SND_SOC_TPLG_TYPE_BACKEND_LINK	10
112 #define SND_SOC_TPLG_TYPE_PDATA		11
113 #define SND_SOC_TPLG_TYPE_DAI		12
114 #define SND_SOC_TPLG_TYPE_MAX		SND_SOC_TPLG_TYPE_DAI
115 
116 /* vendor block IDs - please add new vendor types to end */
117 #define SND_SOC_TPLG_TYPE_VENDOR_FW	1000
118 #define SND_SOC_TPLG_TYPE_VENDOR_CONFIG	1001
119 #define SND_SOC_TPLG_TYPE_VENDOR_COEFF	1002
120 #define SND_SOC_TPLG_TYPEVENDOR_CODEC	1003
121 
122 #define SND_SOC_TPLG_STREAM_PLAYBACK	0
123 #define SND_SOC_TPLG_STREAM_CAPTURE	1
124 
125 /* vendor tuple types */
126 #define SND_SOC_TPLG_TUPLE_TYPE_UUID	0
127 #define SND_SOC_TPLG_TUPLE_TYPE_STRING	1
128 #define SND_SOC_TPLG_TUPLE_TYPE_BOOL	2
129 #define SND_SOC_TPLG_TUPLE_TYPE_BYTE	3
130 #define SND_SOC_TPLG_TUPLE_TYPE_WORD	4
131 #define SND_SOC_TPLG_TUPLE_TYPE_SHORT	5
132 
133 /* DAI flags */
134 #define SND_SOC_TPLG_DAI_FLGBIT_SYMMETRIC_RATES         (1 << 0)
135 #define SND_SOC_TPLG_DAI_FLGBIT_SYMMETRIC_CHANNELS      (1 << 1)
136 #define SND_SOC_TPLG_DAI_FLGBIT_SYMMETRIC_SAMPLEBITS    (1 << 2)
137 
138 /* DAI clock gating */
139 #define SND_SOC_TPLG_DAI_CLK_GATE_UNDEFINED	0
140 #define SND_SOC_TPLG_DAI_CLK_GATE_GATED	1
141 #define SND_SOC_TPLG_DAI_CLK_GATE_CONT		2
142 
143 /* DAI mclk_direction */
144 #define SND_SOC_TPLG_MCLK_CO            0 /* for codec, mclk is output */
145 #define SND_SOC_TPLG_MCLK_CI            1 /* for codec, mclk is input */
146 
147 /* DAI physical PCM data formats.
148  * Add new formats to the end of the list.
149  */
150 #define SND_SOC_DAI_FORMAT_I2S          1 /* I2S mode */
151 #define SND_SOC_DAI_FORMAT_RIGHT_J      2 /* Right Justified mode */
152 #define SND_SOC_DAI_FORMAT_LEFT_J       3 /* Left Justified mode */
153 #define SND_SOC_DAI_FORMAT_DSP_A        4 /* L data MSB after FRM LRC */
154 #define SND_SOC_DAI_FORMAT_DSP_B        5 /* L data MSB during FRM LRC */
155 #define SND_SOC_DAI_FORMAT_AC97         6 /* AC97 */
156 #define SND_SOC_DAI_FORMAT_PDM          7 /* Pulse density modulation */
157 
158 /* left and right justified also known as MSB and LSB respectively */
159 #define SND_SOC_DAI_FORMAT_MSB          SND_SOC_DAI_FORMAT_LEFT_J
160 #define SND_SOC_DAI_FORMAT_LSB          SND_SOC_DAI_FORMAT_RIGHT_J
161 
162 /* DAI link flags */
163 #define SND_SOC_TPLG_LNK_FLGBIT_SYMMETRIC_RATES         (1 << 0)
164 #define SND_SOC_TPLG_LNK_FLGBIT_SYMMETRIC_CHANNELS      (1 << 1)
165 #define SND_SOC_TPLG_LNK_FLGBIT_SYMMETRIC_SAMPLEBITS    (1 << 2)
166 #define SND_SOC_TPLG_LNK_FLGBIT_VOICE_WAKEUP            (1 << 3)
167 
168 /* DAI topology BCLK parameter
169  * For the backwards capability, by default codec is bclk provider
170  */
171 #define SND_SOC_TPLG_BCLK_CP         0 /* codec is bclk provider */
172 #define SND_SOC_TPLG_BCLK_CC         1 /* codec is bclk consumer */
173 /* keep previous definitions for compatibility */
174 #define SND_SOC_TPLG_BCLK_CM         SND_SOC_TPLG_BCLK_CP
175 #define SND_SOC_TPLG_BCLK_CS         SND_SOC_TPLG_BCLK_CC
176 
177 /* DAI topology FSYNC parameter
178  * For the backwards capability, by default codec is fsync provider
179  */
180 #define SND_SOC_TPLG_FSYNC_CP         0 /* codec is fsync provider */
181 #define SND_SOC_TPLG_FSYNC_CC         1 /* codec is fsync consumer */
182 /* keep previous definitions for compatibility */
183 #define SND_SOC_TPLG_FSYNC_CM         SND_SOC_TPLG_FSYNC_CP
184 #define SND_SOC_TPLG_FSYNC_CS         SND_SOC_TPLG_FSYNC_CC
185 
186 /*
187  * Block Header.
188  * This header precedes all object and object arrays below.
189  */
190 struct snd_soc_tplg_hdr {
191 	__le32 magic;		/* magic number */
192 	__le32 abi;		/* ABI version */
193 	__le32 version;		/* optional vendor specific version details */
194 	__le32 type;		/* SND_SOC_TPLG_TYPE_ */
195 	__le32 size;		/* size of this structure */
196 	__le32 vendor_type;	/* optional vendor specific type info */
197 	__le32 payload_size;	/* data bytes, excluding this header */
198 	__le32 index;		/* identifier for block */
199 	__le32 count;		/* number of elements in block */
200 } __attribute__((packed));
201 
202 /* vendor tuple for uuid */
203 struct snd_soc_tplg_vendor_uuid_elem {
204 	__le32 token;
205 	char uuid[16];
206 } __attribute__((packed));
207 
208 /* vendor tuple for a bool/byte/short/word value */
209 struct snd_soc_tplg_vendor_value_elem {
210 	__le32 token;
211 	__le32 value;
212 } __attribute__((packed));
213 
214 /* vendor tuple for string */
215 struct snd_soc_tplg_vendor_string_elem {
216 	__le32 token;
217 	char string[SNDRV_CTL_ELEM_ID_NAME_MAXLEN];
218 } __attribute__((packed));
219 
220 struct snd_soc_tplg_vendor_array {
221 	__le32 size;	/* size in bytes of the array, including all elements */
222 	__le32 type;	/* SND_SOC_TPLG_TUPLE_TYPE_ */
223 	__le32 num_elems;	/* number of elements in array */
224 	union {
225 		struct snd_soc_tplg_vendor_uuid_elem uuid[0];
226 		struct snd_soc_tplg_vendor_value_elem value[0];
227 		struct snd_soc_tplg_vendor_string_elem string[0];
228 	};
229 } __attribute__((packed));
230 
231 /*
232  * Private data.
233  * All topology objects may have private data that can be used by the driver or
234  * firmware. Core will ignore this data.
235  */
236 struct snd_soc_tplg_private {
237 	__le32 size;	/* in bytes of private data */
238 	union {
239 		__DECLARE_FLEX_ARRAY(char, data);
240 		__DECLARE_FLEX_ARRAY(struct snd_soc_tplg_vendor_array, array);
241 	};
242 } __attribute__((packed));
243 
244 /*
245  * Kcontrol TLV data.
246  */
247 struct snd_soc_tplg_tlv_dbscale {
248 	__le32 min;
249 	__le32 step;
250 	__le32 mute;
251 } __attribute__((packed));
252 
253 struct snd_soc_tplg_ctl_tlv {
254 	__le32 size;	/* in bytes of this structure */
255 	__le32 type;	/* SNDRV_CTL_TLVT_*, type of TLV */
256 	union {
257 		__le32 data[SND_SOC_TPLG_TLV_SIZE];
258 		struct snd_soc_tplg_tlv_dbscale scale;
259 	};
260 } __attribute__((packed));
261 
262 /*
263  * Kcontrol channel data
264  */
265 struct snd_soc_tplg_channel {
266 	__le32 size;	/* in bytes of this structure */
267 	__le32 reg;
268 	__le32 shift;
269 	__le32 id;	/* ID maps to Left, Right, LFE etc */
270 } __attribute__((packed));
271 
272 /*
273  * Genericl Operations IDs, for binding Kcontrol or Bytes ext ops
274  * Kcontrol ops need get/put/info.
275  * Bytes ext ops need get/put.
276  */
277 struct snd_soc_tplg_io_ops {
278 	__le32 get;
279 	__le32 put;
280 	__le32 info;
281 } __attribute__((packed));
282 
283 /*
284  * kcontrol header
285  */
286 struct snd_soc_tplg_ctl_hdr {
287 	__le32 size;	/* in bytes of this structure */
288 	__le32 type;
289 	char name[SNDRV_CTL_ELEM_ID_NAME_MAXLEN];
290 	__le32 access;
291 	struct snd_soc_tplg_io_ops ops;
292 	struct snd_soc_tplg_ctl_tlv tlv;
293 } __attribute__((packed));
294 
295 /*
296  * Stream Capabilities
297  */
298 struct snd_soc_tplg_stream_caps {
299 	__le32 size;		/* in bytes of this structure */
300 	char name[SNDRV_CTL_ELEM_ID_NAME_MAXLEN];
301 	__le64 formats;	/* supported formats SNDRV_PCM_FMTBIT_* */
302 	__le32 rates;		/* supported rates SNDRV_PCM_RATE_* */
303 	__le32 rate_min;	/* min rate */
304 	__le32 rate_max;	/* max rate */
305 	__le32 channels_min;	/* min channels */
306 	__le32 channels_max;	/* max channels */
307 	__le32 periods_min;	/* min number of periods */
308 	__le32 periods_max;	/* max number of periods */
309 	__le32 period_size_min;	/* min period size bytes */
310 	__le32 period_size_max;	/* max period size bytes */
311 	__le32 buffer_size_min;	/* min buffer size bytes */
312 	__le32 buffer_size_max;	/* max buffer size bytes */
313 	__le32 sig_bits;        /* number of bits of content */
314 } __attribute__((packed));
315 
316 /*
317  * FE or BE Stream configuration supported by SW/FW
318  */
319 struct snd_soc_tplg_stream {
320 	__le32 size;		/* in bytes of this structure */
321 	char name[SNDRV_CTL_ELEM_ID_NAME_MAXLEN]; /* Name of the stream */
322 	__le64 format;		/* SNDRV_PCM_FMTBIT_* */
323 	__le32 rate;		/* SNDRV_PCM_RATE_* */
324 	__le32 period_bytes;	/* size of period in bytes */
325 	__le32 buffer_bytes;	/* size of buffer in bytes */
326 	__le32 channels;	/* channels */
327 } __attribute__((packed));
328 
329 
330 /*
331  * Describes a physical link's runtime supported hardware config,
332  * i.e. hardware audio formats.
333  */
334 struct snd_soc_tplg_hw_config {
335 	__le32 size;            /* in bytes of this structure */
336 	__le32 id;		/* unique ID - - used to match */
337 	__le32 fmt;		/* SND_SOC_DAI_FORMAT_ format value */
338 	__u8 clock_gated;	/* SND_SOC_TPLG_DAI_CLK_GATE_ value */
339 	__u8 invert_bclk;	/* 1 for inverted BCLK, 0 for normal */
340 	__u8 invert_fsync;	/* 1 for inverted frame clock, 0 for normal */
341 	__u8 bclk_provider;	/* SND_SOC_TPLG_BCLK_ value */
342 	__u8 fsync_provider;	/* SND_SOC_TPLG_FSYNC_ value */
343 	__u8 mclk_direction;    /* SND_SOC_TPLG_MCLK_ value */
344 	__le16 reserved;	/* for 32bit alignment */
345 	__le32 mclk_rate;	/* MCLK or SYSCLK freqency in Hz */
346 	__le32 bclk_rate;	/* BCLK freqency in Hz */
347 	__le32 fsync_rate;	/* frame clock in Hz */
348 	__le32 tdm_slots;	/* number of TDM slots in use */
349 	__le32 tdm_slot_width;	/* width in bits for each slot */
350 	__le32 tx_slots;	/* bit mask for active Tx slots */
351 	__le32 rx_slots;	/* bit mask for active Rx slots */
352 	__le32 tx_channels;	/* number of Tx channels */
353 	__le32 tx_chanmap[SND_SOC_TPLG_MAX_CHAN]; /* array of slot number */
354 	__le32 rx_channels;	/* number of Rx channels */
355 	__le32 rx_chanmap[SND_SOC_TPLG_MAX_CHAN]; /* array of slot number */
356 } __attribute__((packed));
357 
358 /*
359  * Manifest. List totals for each payload type. Not used in parsing, but will
360  * be passed to the component driver before any other objects in order for any
361  * global component resource allocations.
362  *
363  * File block representation for manifest :-
364  * +-----------------------------------+----+
365  * | struct snd_soc_tplg_hdr           |  1 |
366  * +-----------------------------------+----+
367  * | struct snd_soc_tplg_manifest      |  1 |
368  * +-----------------------------------+----+
369  */
370 struct snd_soc_tplg_manifest {
371 	__le32 size;		/* in bytes of this structure */
372 	__le32 control_elems;	/* number of control elements */
373 	__le32 widget_elems;	/* number of widget elements */
374 	__le32 graph_elems;	/* number of graph elements */
375 	__le32 pcm_elems;	/* number of PCM elements */
376 	__le32 dai_link_elems;	/* number of DAI link elements */
377 	__le32 dai_elems;	/* number of physical DAI elements */
378 	__le32 reserved[20];	/* reserved for new ABI element types */
379 	struct snd_soc_tplg_private priv;
380 } __attribute__((packed));
381 
382 /*
383  * Mixer kcontrol.
384  *
385  * File block representation for mixer kcontrol :-
386  * +-----------------------------------+----+
387  * | struct snd_soc_tplg_hdr           |  1 |
388  * +-----------------------------------+----+
389  * | struct snd_soc_tplg_mixer_control |  N |
390  * +-----------------------------------+----+
391  */
392 struct snd_soc_tplg_mixer_control {
393 	struct snd_soc_tplg_ctl_hdr hdr;
394 	__le32 size;	/* in bytes of this structure */
395 	__le32 min;
396 	__le32 max;
397 	__le32 platform_max;
398 	__le32 invert;
399 	__le32 num_channels;
400 	struct snd_soc_tplg_channel channel[SND_SOC_TPLG_MAX_CHAN];
401 	struct snd_soc_tplg_private priv;
402 } __attribute__((packed));
403 
404 /*
405  * Enumerated kcontrol
406  *
407  * File block representation for enum kcontrol :-
408  * +-----------------------------------+----+
409  * | struct snd_soc_tplg_hdr           |  1 |
410  * +-----------------------------------+----+
411  * | struct snd_soc_tplg_enum_control  |  N |
412  * +-----------------------------------+----+
413  */
414 struct snd_soc_tplg_enum_control {
415 	struct snd_soc_tplg_ctl_hdr hdr;
416 	__le32 size;	/* in bytes of this structure */
417 	__le32 num_channels;
418 	struct snd_soc_tplg_channel channel[SND_SOC_TPLG_MAX_CHAN];
419 	__le32 items;
420 	__le32 mask;
421 	__le32 count;
422 	char texts[SND_SOC_TPLG_NUM_TEXTS][SNDRV_CTL_ELEM_ID_NAME_MAXLEN];
423 	__le32 values[SND_SOC_TPLG_NUM_TEXTS * SNDRV_CTL_ELEM_ID_NAME_MAXLEN / 4];
424 	struct snd_soc_tplg_private priv;
425 } __attribute__((packed));
426 
427 /*
428  * Bytes kcontrol
429  *
430  * File block representation for bytes kcontrol :-
431  * +-----------------------------------+----+
432  * | struct snd_soc_tplg_hdr           |  1 |
433  * +-----------------------------------+----+
434  * | struct snd_soc_tplg_bytes_control |  N |
435  * +-----------------------------------+----+
436  */
437 struct snd_soc_tplg_bytes_control {
438 	struct snd_soc_tplg_ctl_hdr hdr;
439 	__le32 size;	/* in bytes of this structure */
440 	__le32 max;
441 	__le32 mask;
442 	__le32 base;
443 	__le32 num_regs;
444 	struct snd_soc_tplg_io_ops ext_ops;
445 	struct snd_soc_tplg_private priv;
446 } __attribute__((packed));
447 
448 /*
449  * DAPM Graph Element
450  *
451  * File block representation for DAPM graph elements :-
452  * +-------------------------------------+----+
453  * | struct snd_soc_tplg_hdr             |  1 |
454  * +-------------------------------------+----+
455  * | struct snd_soc_tplg_dapm_graph_elem |  N |
456  * +-------------------------------------+----+
457  */
458 struct snd_soc_tplg_dapm_graph_elem {
459 	char sink[SNDRV_CTL_ELEM_ID_NAME_MAXLEN];
460 	char control[SNDRV_CTL_ELEM_ID_NAME_MAXLEN];
461 	char source[SNDRV_CTL_ELEM_ID_NAME_MAXLEN];
462 } __attribute__((packed));
463 
464 /*
465  * DAPM Widget.
466  *
467  * File block representation for DAPM widget :-
468  * +-------------------------------------+-----+
469  * | struct snd_soc_tplg_hdr             |  1  |
470  * +-------------------------------------+-----+
471  * | struct snd_soc_tplg_dapm_widget     |  N  |
472  * +-------------------------------------+-----+
473  * |   struct snd_soc_tplg_enum_control  | 0|1 |
474  * |   struct snd_soc_tplg_mixer_control | 0|N |
475  * +-------------------------------------+-----+
476  *
477  * Optional enum or mixer control can be appended to the end of each widget
478  * in the block.
479  */
480 struct snd_soc_tplg_dapm_widget {
481 	__le32 size;		/* in bytes of this structure */
482 	__le32 id;		/* SND_SOC_DAPM_CTL */
483 	char name[SNDRV_CTL_ELEM_ID_NAME_MAXLEN];
484 	char sname[SNDRV_CTL_ELEM_ID_NAME_MAXLEN];
485 
486 	__le32 reg;		/* negative reg = no direct dapm */
487 	__le32 shift;		/* bits to shift */
488 	__le32 mask;		/* non-shifted mask */
489 	__le32 subseq;		/* sort within widget type */
490 	__le32 invert;		/* invert the power bit */
491 	__le32 ignore_suspend;	/* kept enabled over suspend */
492 	__le16 event_flags;
493 	__le16 event_type;
494 	__le32 num_kcontrols;
495 	struct snd_soc_tplg_private priv;
496 	/*
497 	 * kcontrols that relate to this widget
498 	 * follow here after widget private data
499 	 */
500 } __attribute__((packed));
501 
502 
503 /*
504  * Describes SW/FW specific features of PCM (FE DAI & DAI link).
505  *
506  * File block representation for PCM :-
507  * +-----------------------------------+-----+
508  * | struct snd_soc_tplg_hdr           |  1  |
509  * +-----------------------------------+-----+
510  * | struct snd_soc_tplg_pcm           |  N  |
511  * +-----------------------------------+-----+
512  */
513 struct snd_soc_tplg_pcm {
514 	__le32 size;		/* in bytes of this structure */
515 	char pcm_name[SNDRV_CTL_ELEM_ID_NAME_MAXLEN];
516 	char dai_name[SNDRV_CTL_ELEM_ID_NAME_MAXLEN];
517 	__le32 pcm_id;		/* unique ID - used to match with DAI link */
518 	__le32 dai_id;		/* unique ID - used to match */
519 	__le32 playback;	/* supports playback mode */
520 	__le32 capture;		/* supports capture mode */
521 	__le32 compress;	/* 1 = compressed; 0 = PCM */
522 	struct snd_soc_tplg_stream stream[SND_SOC_TPLG_STREAM_CONFIG_MAX]; /* for DAI link */
523 	__le32 num_streams;	/* number of streams */
524 	struct snd_soc_tplg_stream_caps caps[2]; /* playback and capture for DAI */
525 	__le32 flag_mask;       /* bitmask of flags to configure */
526 	__le32 flags;           /* SND_SOC_TPLG_LNK_FLGBIT_* flag value */
527 	struct snd_soc_tplg_private priv;
528 } __attribute__((packed));
529 
530 
531 /*
532  * Describes the physical link runtime supported configs or params
533  *
534  * File block representation for physical link config :-
535  * +-----------------------------------+-----+
536  * | struct snd_soc_tplg_hdr           |  1  |
537  * +-----------------------------------+-----+
538  * | struct snd_soc_tplg_link_config   |  N  |
539  * +-----------------------------------+-----+
540  */
541 struct snd_soc_tplg_link_config {
542 	__le32 size;            /* in bytes of this structure */
543 	__le32 id;              /* unique ID - used to match */
544 	char name[SNDRV_CTL_ELEM_ID_NAME_MAXLEN]; /* name - used to match */
545 	char stream_name[SNDRV_CTL_ELEM_ID_NAME_MAXLEN]; /* stream name - used to match */
546 	struct snd_soc_tplg_stream stream[SND_SOC_TPLG_STREAM_CONFIG_MAX]; /* supported configs playback and captrure */
547 	__le32 num_streams;     /* number of streams */
548 	struct snd_soc_tplg_hw_config hw_config[SND_SOC_TPLG_HW_CONFIG_MAX]; /* hw configs */
549 	__le32 num_hw_configs;         /* number of hw configs */
550 	__le32 default_hw_config_id;   /* default hw config ID for init */
551 	__le32 flag_mask;       /* bitmask of flags to configure */
552 	__le32 flags;           /* SND_SOC_TPLG_LNK_FLGBIT_* flag value */
553 	struct snd_soc_tplg_private priv;
554 } __attribute__((packed));
555 
556 /*
557  * Describes SW/FW specific features of physical DAI.
558  * It can be used to configure backend DAIs for DPCM.
559  *
560  * File block representation for physical DAI :-
561  * +-----------------------------------+-----+
562  * | struct snd_soc_tplg_hdr           |  1  |
563  * +-----------------------------------+-----+
564  * | struct snd_soc_tplg_dai           |  N  |
565  * +-----------------------------------+-----+
566  */
567 struct snd_soc_tplg_dai {
568 	__le32 size;            /* in bytes of this structure */
569 	char dai_name[SNDRV_CTL_ELEM_ID_NAME_MAXLEN]; /* name - used to match */
570 	__le32 dai_id;          /* unique ID - used to match */
571 	__le32 playback;        /* supports playback mode */
572 	__le32 capture;         /* supports capture mode */
573 	struct snd_soc_tplg_stream_caps caps[2]; /* playback and capture for DAI */
574 	__le32 flag_mask;       /* bitmask of flags to configure */
575 	__le32 flags;           /* SND_SOC_TPLG_DAI_FLGBIT_* */
576 	struct snd_soc_tplg_private priv;
577 } __attribute__((packed));
578 
579 /*
580  * Old version of ABI structs, supported for backward compatibility.
581  */
582 
583 /* Manifest v4 */
584 struct snd_soc_tplg_manifest_v4 {
585 	__le32 size;		/* in bytes of this structure */
586 	__le32 control_elems;	/* number of control elements */
587 	__le32 widget_elems;	/* number of widget elements */
588 	__le32 graph_elems;	/* number of graph elements */
589 	__le32 pcm_elems;	/* number of PCM elements */
590 	__le32 dai_link_elems;	/* number of DAI link elements */
591 	struct snd_soc_tplg_private priv;
592 } __packed;
593 
594 /* Stream Capabilities v4 */
595 struct snd_soc_tplg_stream_caps_v4 {
596 	__le32 size;		/* in bytes of this structure */
597 	char name[SNDRV_CTL_ELEM_ID_NAME_MAXLEN];
598 	__le64 formats;	/* supported formats SNDRV_PCM_FMTBIT_* */
599 	__le32 rates;		/* supported rates SNDRV_PCM_RATE_* */
600 	__le32 rate_min;	/* min rate */
601 	__le32 rate_max;	/* max rate */
602 	__le32 channels_min;	/* min channels */
603 	__le32 channels_max;	/* max channels */
604 	__le32 periods_min;	/* min number of periods */
605 	__le32 periods_max;	/* max number of periods */
606 	__le32 period_size_min;	/* min period size bytes */
607 	__le32 period_size_max;	/* max period size bytes */
608 	__le32 buffer_size_min;	/* min buffer size bytes */
609 	__le32 buffer_size_max;	/* max buffer size bytes */
610 } __packed;
611 
612 /* PCM v4 */
613 struct snd_soc_tplg_pcm_v4 {
614 	__le32 size;		/* in bytes of this structure */
615 	char pcm_name[SNDRV_CTL_ELEM_ID_NAME_MAXLEN];
616 	char dai_name[SNDRV_CTL_ELEM_ID_NAME_MAXLEN];
617 	__le32 pcm_id;		/* unique ID - used to match with DAI link */
618 	__le32 dai_id;		/* unique ID - used to match */
619 	__le32 playback;	/* supports playback mode */
620 	__le32 capture;		/* supports capture mode */
621 	__le32 compress;	/* 1 = compressed; 0 = PCM */
622 	struct snd_soc_tplg_stream stream[SND_SOC_TPLG_STREAM_CONFIG_MAX]; /* for DAI link */
623 	__le32 num_streams;	/* number of streams */
624 	struct snd_soc_tplg_stream_caps_v4 caps[2]; /* playback and capture for DAI */
625 } __packed;
626 
627 /* Physical link config v4 */
628 struct snd_soc_tplg_link_config_v4 {
629 	__le32 size;            /* in bytes of this structure */
630 	__le32 id;              /* unique ID - used to match */
631 	struct snd_soc_tplg_stream stream[SND_SOC_TPLG_STREAM_CONFIG_MAX]; /* supported configs playback and captrure */
632 	__le32 num_streams;     /* number of streams */
633 } __packed;
634 
635 #endif
636