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	0x5	/* 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  		__DECLARE_FLEX_ARRAY(struct snd_soc_tplg_vendor_uuid_elem, uuid);
226  		__DECLARE_FLEX_ARRAY(struct snd_soc_tplg_vendor_value_elem, value);
227  		__DECLARE_FLEX_ARRAY(struct snd_soc_tplg_vendor_string_elem, string);
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  #endif
580