ASoC: topology: use inclusive language for bclk and fsync
authorPierre-Louis Bossart <pierre-louis.bossart@linux.intel.com>
Thu, 12 Nov 2020 16:30:57 +0000 (10:30 -0600)
committerMark Brown <broonie@kernel.org>
Fri, 13 Nov 2020 14:22:05 +0000 (14:22 +0000)
Mirror suggested changes in alsa-lib.

Signed-off-by: Pierre-Louis Bossart <pierre-louis.bossart@linux.intel.com>
Link: https://lore.kernel.org/r/20201112163100.5081-2-pierre-louis.bossart@linux.intel.com
Signed-off-by: Mark Brown <broonie@kernel.org>
include/sound/soc-dai.h
include/uapi/sound/asoc.h
sound/soc/soc-topology.c
sound/soc/sof/topology.c

index 7a85a6f..4bf759f 100644 (file)
@@ -72,21 +72,29 @@ struct snd_compr_stream;
 #define SND_SOC_DAIFMT_IB_IF           (4 << 8) /* invert BCLK + FRM */
 
 /*
- * DAI hardware clock masters.
+ * DAI hardware clock providers/consumers
  *
  * This is wrt the codec, the inverse is true for the interface
- * i.e. if the codec is clk and FRM master then the interface is
- * clk and frame secondary.
+ * i.e. if the codec is clk and FRM provider then the interface is
+ * clk and frame consumer.
  */
-#define SND_SOC_DAIFMT_CBM_CFM         (1 << 12) /* codec clk & FRM master */
-#define SND_SOC_DAIFMT_CBS_CFM         (2 << 12) /* codec clk secondary & FRM master */
-#define SND_SOC_DAIFMT_CBM_CFS         (3 << 12) /* codec clk master & frame secondary */
-#define SND_SOC_DAIFMT_CBS_CFS         (4 << 12) /* codec clk & FRM secondary */
-
-#define SND_SOC_DAIFMT_FORMAT_MASK     0x000f
-#define SND_SOC_DAIFMT_CLOCK_MASK      0x00f0
-#define SND_SOC_DAIFMT_INV_MASK                0x0f00
-#define SND_SOC_DAIFMT_MASTER_MASK     0xf000
+#define SND_SOC_DAIFMT_CBP_CFP         (1 << 12) /* codec clk provider & frame provider */
+#define SND_SOC_DAIFMT_CBC_CFP         (2 << 12) /* codec clk consumer & frame provider */
+#define SND_SOC_DAIFMT_CBP_CFC         (3 << 12) /* codec clk provider & frame consumer */
+#define SND_SOC_DAIFMT_CBC_CFC         (4 << 12) /* codec clk consumer & frame follower */
+
+/* previous definitions kept for backwards-compatibility, do not use in new contributions */
+#define SND_SOC_DAIFMT_CBM_CFM         SND_SOC_DAIFMT_CBP_CFP
+#define SND_SOC_DAIFMT_CBS_CFM         SND_SOC_DAIFMT_CBC_CFP
+#define SND_SOC_DAIFMT_CBM_CFS         SND_SOC_DAIFMT_CBP_CFC
+#define SND_SOC_DAIFMT_CBS_CFS         SND_SOC_DAIFMT_CBC_CFC
+
+#define SND_SOC_DAIFMT_FORMAT_MASK             0x000f
+#define SND_SOC_DAIFMT_CLOCK_MASK              0x00f0
+#define SND_SOC_DAIFMT_INV_MASK                        0x0f00
+#define SND_SOC_DAIFMT_CLOCK_PROVIDER_MASK     0xf000
+
+#define SND_SOC_DAIFMT_MASTER_MASK     SND_SOC_DAIFMT_CLOCK_PROVIDER_MASK
 
 /*
  * Master Clock Directions
index a74ca23..da61398 100644 (file)
 #define SND_SOC_TPLG_LNK_FLGBIT_VOICE_WAKEUP            (1 << 3)
 
 /* DAI topology BCLK parameter
- * For the backwards capability, by default codec is bclk master
+ * For the backwards capability, by default codec is bclk provider
  */
-#define SND_SOC_TPLG_BCLK_CM         0 /* codec is bclk master */
-#define SND_SOC_TPLG_BCLK_CS         1 /* codec is bclk slave */
+#define SND_SOC_TPLG_BCLK_CP         0 /* codec is bclk provider */
+#define SND_SOC_TPLG_BCLK_CC         1 /* codec is bclk consumer */
+/* keep previous definitions for compatibility */
+#define SND_SOC_TPLG_BCLK_CM         SND_SOC_TPLG_BCLK_CP
+#define SND_SOC_TPLG_BCLK_CS         SND_SOC_TPLG_BCLK_CC
 
 /* DAI topology FSYNC parameter
- * For the backwards capability, by default codec is fsync master
+ * For the backwards capability, by default codec is fsync provider
  */
-#define SND_SOC_TPLG_FSYNC_CM         0 /* codec is fsync master */
-#define SND_SOC_TPLG_FSYNC_CS         1 /* codec is fsync slave */
+#define SND_SOC_TPLG_FSYNC_CP         0 /* codec is fsync provider */
+#define SND_SOC_TPLG_FSYNC_CC         1 /* codec is fsync consumer */
+/* keep previous definitions for compatibility */
+#define SND_SOC_TPLG_FSYNC_CM         SND_SOC_TPLG_FSYNC_CP
+#define SND_SOC_TPLG_FSYNC_CS         SND_SOC_TPLG_FSYNC_CC
 
 /*
  * Block Header.
@@ -336,8 +342,8 @@ struct snd_soc_tplg_hw_config {
        __u8 clock_gated;       /* SND_SOC_TPLG_DAI_CLK_GATE_ value */
        __u8 invert_bclk;       /* 1 for inverted BCLK, 0 for normal */
        __u8 invert_fsync;      /* 1 for inverted frame clock, 0 for normal */
-       __u8 bclk_master;       /* SND_SOC_TPLG_BCLK_ value */
-       __u8 fsync_master;      /* SND_SOC_TPLG_FSYNC_ value */
+       __u8 bclk_provider;     /* SND_SOC_TPLG_BCLK_ value */
+       __u8 fsync_provider;    /* SND_SOC_TPLG_FSYNC_ value */
        __u8 mclk_direction;    /* SND_SOC_TPLG_MCLK_ value */
        __le16 reserved;        /* for 32bit alignment */
        __le32 mclk_rate;       /* MCLK or SYSCLK freqency in Hz */
index 07c6018..eb2633d 100644 (file)
@@ -2017,7 +2017,7 @@ static void set_link_hw_format(struct snd_soc_dai_link *link,
                        struct snd_soc_tplg_link_config *cfg)
 {
        struct snd_soc_tplg_hw_config *hw_config;
-       unsigned char bclk_master, fsync_master;
+       unsigned char bclk_provider, fsync_provider;
        unsigned char invert_bclk, invert_fsync;
        int i;
 
@@ -2057,18 +2057,18 @@ static void set_link_hw_format(struct snd_soc_dai_link *link,
                        link->dai_fmt |= SND_SOC_DAIFMT_IB_IF;
 
                /* clock masters */
-               bclk_master = (hw_config->bclk_master ==
-                              SND_SOC_TPLG_BCLK_CM);
-               fsync_master = (hw_config->fsync_master ==
-                               SND_SOC_TPLG_FSYNC_CM);
-               if (bclk_master && fsync_master)
-                       link->dai_fmt |= SND_SOC_DAIFMT_CBM_CFM;
-               else if (!bclk_master && fsync_master)
-                       link->dai_fmt |= SND_SOC_DAIFMT_CBS_CFM;
-               else if (bclk_master && !fsync_master)
-                       link->dai_fmt |= SND_SOC_DAIFMT_CBM_CFS;
+               bclk_provider = (hw_config->bclk_provider ==
+                              SND_SOC_TPLG_BCLK_CP);
+               fsync_provider = (hw_config->fsync_provider ==
+                               SND_SOC_TPLG_FSYNC_CP);
+               if (bclk_provider && fsync_provider)
+                       link->dai_fmt |= SND_SOC_DAIFMT_CBP_CFP;
+               else if (!bclk_provider && fsync_provider)
+                       link->dai_fmt |= SND_SOC_DAIFMT_CBC_CFP;
+               else if (bclk_provider && !fsync_provider)
+                       link->dai_fmt |= SND_SOC_DAIFMT_CBP_CFC;
                else
-                       link->dai_fmt |= SND_SOC_DAIFMT_CBS_CFS;
+                       link->dai_fmt |= SND_SOC_DAIFMT_CBC_CFC;
        }
 }
 
index 44fdded..d708c64 100644 (file)
@@ -2777,15 +2777,15 @@ static void sof_dai_set_format(struct snd_soc_tplg_hw_config *hw_config,
                               struct sof_ipc_dai_config *config)
 {
        /* clock directions wrt codec */
-       if (hw_config->bclk_master == SND_SOC_TPLG_BCLK_CM) {
+       if (hw_config->bclk_provider == SND_SOC_TPLG_BCLK_CM) {
                /* codec is bclk master */
-               if (hw_config->fsync_master == SND_SOC_TPLG_FSYNC_CM)
+               if (hw_config->fsync_provider == SND_SOC_TPLG_FSYNC_CM)
                        config->format |= SOF_DAI_FMT_CBM_CFM;
                else
                        config->format |= SOF_DAI_FMT_CBM_CFS;
        } else {
                /* codec is bclk slave */
-               if (hw_config->fsync_master == SND_SOC_TPLG_FSYNC_CM)
+               if (hw_config->fsync_provider == SND_SOC_TPLG_FSYNC_CM)
                        config->format |= SOF_DAI_FMT_CBS_CFM;
                else
                        config->format |= SOF_DAI_FMT_CBS_CFS;