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 */
190struct 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 */
203struct 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 */
209struct snd_soc_tplg_vendor_value_elem {
210 __le32 token;
211 __le32 value;
212} __attribute__((packed));
213
214/* vendor tuple for string */
215struct snd_soc_tplg_vendor_string_elem {
216 __le32 token;
217 char string[SNDRV_CTL_ELEM_ID_NAME_MAXLEN];
218} __attribute__((packed));
219
220struct 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 */
236struct 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 */
247struct snd_soc_tplg_tlv_dbscale {
248 __le32 min;
249 __le32 step;
250 __le32 mute;
251} __attribute__((packed));
252
253struct 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 */
265struct 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 */
277struct snd_soc_tplg_io_ops {
278 __le32 get;
279 __le32 put;
280 __le32 info;
281} __attribute__((packed));
282
283/*
284 * kcontrol header
285 */
286struct 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 */
298struct 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 */
319struct 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 */
334struct 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 */
370struct 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 */
392struct 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 */
414struct 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 */
437struct 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 */
458struct 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 */
480struct 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 */
513struct 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 */
541struct 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 */
567struct 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 */
584struct 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 */
595struct 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 */
613struct 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 */
628struct 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

source code of linux/include/uapi/sound/asoc.h