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 __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 /* 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