ALSA project - the C library reference
 All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
topology.h
1 /*
2  *
3  * This library is free software; you can redistribute it and/or modify
4  * it under the terms of the GNU Lesser General Public License as
5  * published by the Free Software Foundation; either version 2.1 of
6  * the License, or (at your option) any later version.
7  *
8  * This program is distributed in the hope that it will be useful,
9  * but WITHOUT ANY WARRANTY; without even the implied warranty of
10  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
11  * GNU Lesser General Public License for more details.
12  *
13  * You should have received a copy of the GNU Lesser General Public
14  * License along with this library; if not, write to the Free Software
15  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
16  *
17  * Copyright (C) 2015 Intel Corporation
18  *
19  */
20 
21 #ifndef __ALSA_TOPOLOGY_H
22 #define __ALSA_TOPOLOGY_H
23 
24 #include <stdint.h>
25 
26 #ifdef __cplusplus
27 extern "C" {
28 #endif
29 
743 #define SND_TPLG_MAX_CHAN 8
744 
746 typedef struct snd_tplg snd_tplg_t;
747 
769 };
770 
772 #define SND_TPLG_INDEX_ALL 0
773 
775 #define SND_TPLG_CREATE_VERBOSE (1<<0)
776 #define SND_TPLG_CREATE_DAPM_NOSORT (1<<1)
782 const char *snd_tplg_version(void);
783 
788 snd_tplg_t *snd_tplg_new(void);
789 
794 snd_tplg_t *snd_tplg_create(int flags);
795 
800 void snd_tplg_free(snd_tplg_t *tplg);
801 
809 int snd_tplg_load(snd_tplg_t *tplg, const char *buf, size_t size);
810 
818 int snd_tplg_build_file(snd_tplg_t *tplg, const char *infile,
819  const char *outfile);
820 
826 void snd_tplg_verbose(snd_tplg_t *tplg, int verbose);
827 
832  int type;
833 };
834 
840  int min;
841  int step;
842  int mute;
843 };
844 
849  int size;
850  int reg;
851  int shift;
852  int id;
853 };
854 
861 };
862 
867  unsigned int length;
868  const void *data;
869 };
870 
875  int get;
876  int put;
877  int info;
878 };
879 
884  int type;
885  const char *name;
886  int access;
888  union {
891  };
892 };
893 
900  int min;
901  int max;
903  int invert;
904  struct snd_soc_tplg_private *priv;
905 };
906 
913  int items;
914  int mask;
915  const char **texts;
916  const int **values;
917  struct snd_soc_tplg_private *priv;
918 };
919 
925  int max;
926  int mask;
927  int base;
928  int num_regs;
930  struct snd_soc_tplg_private *priv;
931 };
932 
937  const char *src;
938  const char *ctl;
939  const char *sink;
940 };
941 
946  int count;
948 };
949 
954  int id;
955  const char *name;
956  const char *sname;
957  int reg;
958  int shift;
959  int mask;
960  int subseq;
961  unsigned int invert;
962  unsigned int ignore_suspend;
963  unsigned short event_flags;
964  unsigned short event_type;
965  struct snd_soc_tplg_private *priv;
966  int num_ctls;
968 };
969 
974  const char *name;
975  int format;
976  int rate;
979  int channels;
980 };
981 
986  const char *name;
987  uint64_t formats;
988  unsigned int rates;
989  unsigned int rate_min;
990  unsigned int rate_max;
991  unsigned int channels_min;
992  unsigned int channels_max;
993  unsigned int periods_min;
994  unsigned int periods_max;
995  unsigned int period_size_min;
996  unsigned int period_size_max;
997  unsigned int buffer_size_min;
998  unsigned int buffer_size_max;
999  unsigned int sig_bits;
1000 };
1001 
1006  const char *pcm_name;
1007  const char *dai_name;
1008  unsigned int pcm_id;
1009  unsigned int dai_id;
1010  unsigned int playback;
1011  unsigned int capture;
1012  unsigned int compress;
1014  unsigned int flag_mask;
1015  unsigned int flags;
1016  struct snd_soc_tplg_private *priv;
1019 };
1020 
1026  int id; /* unique ID - - used to match */
1027  unsigned int fmt; /* SND_SOC_DAI_FORMAT_ format value */
1028  unsigned char clock_gated; /* SND_SOC_TPLG_DAI_CLK_GATE_ value */
1029  unsigned char invert_bclk; /* 1 for inverted BCLK, 0 for normal */
1030  unsigned char invert_fsync; /* 1 for inverted frame clock, 0 for normal */
1031  unsigned char bclk_master; /* SND_SOC_TPLG_BCLK_ value */
1032  unsigned char fsync_master; /* SND_SOC_TPLG_FSYNC_ value */
1033  unsigned char mclk_direction; /* SND_SOC_TPLG_MCLK_ value */
1034  unsigned short reserved; /* for 32bit alignment */
1035  unsigned int mclk_rate; /* MCLK or SYSCLK freqency in Hz */
1036  unsigned int bclk_rate; /* BCLK freqency in Hz */
1037  unsigned int fsync_rate; /* frame clock in Hz */
1038  unsigned int tdm_slots; /* number of TDM slots in use */
1039  unsigned int tdm_slot_width; /* width in bits for each slot */
1040  unsigned int tx_slots; /* bit mask for active Tx slots */
1041  unsigned int rx_slots; /* bit mask for active Rx slots */
1042  unsigned int tx_channels; /* number of Tx channels */
1043  unsigned int *tx_chanmap; /* array of slot number */
1044  unsigned int rx_channels; /* number of Rx channels */
1045  unsigned int *rx_chanmap; /* array of slot number */
1046 };
1047 
1053  const char *dai_name;
1054  unsigned int dai_id;
1055  unsigned int playback;
1056  unsigned int capture;
1058  unsigned int flag_mask;
1059  unsigned int flags;
1060  struct snd_soc_tplg_private *priv;
1062 };
1063 
1068  const char *name;
1069  int id;
1070  const char *stream_name;
1076  int num_hw_configs; /* number of hw configs */
1077  int default_hw_config_id; /* default hw config ID for init */
1078 
1079  unsigned int flag_mask; /* bitmask of flags to configure */
1080  unsigned int flags; /* SND_SOC_TPLG_LNK_FLGBIT_* flag value */
1081  struct snd_soc_tplg_private *priv;
1082 };
1083 
1087 typedef struct snd_tplg_obj_template {
1089  int index;
1090  int version;
1092  union {
1101  };
1103 
1111 
1118 int snd_tplg_build(snd_tplg_t *tplg, const char *outfile);
1119 
1127 int snd_tplg_build_bin(snd_tplg_t *tplg, void **bin, size_t *size);
1128 
1136 int snd_tplg_set_manifest_data(snd_tplg_t *tplg, const void *data, int len);
1137 
1144 int snd_tplg_set_version(snd_tplg_t *tplg, unsigned int version);
1145 
1146 /*
1147  * Flags for the snd_tplg_save()
1148  */
1149 #define SND_TPLG_SAVE_SORT (1<<0)
1150 #define SND_TPLG_SAVE_GROUPS (1<<1)
1151 #define SND_TPLG_SAVE_NOCHECK (1<<16)
1159 int snd_tplg_save(snd_tplg_t *tplg, char **dst, int flags);
1160 
1168 int snd_tplg_decode(snd_tplg_t *tplg, void *bin, size_t size, int dflags);
1169 
1170 /* \} */
1171 
1172 #ifdef __cplusplus
1173 }
1174 #endif
1175 
1176 #endif /* __ALSA_TOPOLOGY_H */