sound/soc/stm/stm32_sai.h

   1 /*
   2  * STM32 ALSA SoC Digital Audio Interface (SAI) driver.
   3  *
   4  * Copyright (C) 2016, STMicroelectronics - All Rights Reserved
   5  * Author(s): Olivier Moysan <olivier.moysan@st.com> for STMicroelectronics.
   6  *
   7  * License terms: GPL V2.0.
   8  *
   9  * This program is free software; you can redistribute it and/or modify it
  10  * under the terms of the GNU General Public License version 2 as published by
  11  * the Free Software Foundation.
  12  *
  13  * This program is distributed in the hope that it will be useful, but
  14  * WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  15  * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
  16  * details.
  17  */
  18
  19 #include <linux/bitfield.h>
  20
  21 /******************** SAI Register Map **************************************/
  22
  23 /* Global configuration register */
  24 #define STM_SAI_GCR             0x00
  25
  26 /* Sub-block A&B registers offsets, relative to A&B sub-block addresses */
  27 #define STM_SAI_CR1_REGX        0x00    /* A offset: 0x04. B offset: 0x24 */
  28 #define STM_SAI_CR2_REGX        0x04
  29 #define STM_SAI_FRCR_REGX       0x08
  30 #define STM_SAI_SLOTR_REGX      0x0C
  31 #define STM_SAI_IMR_REGX        0x10
  32 #define STM_SAI_SR_REGX         0x14
  33 #define STM_SAI_CLRFR_REGX      0x18
  34 #define STM_SAI_DR_REGX         0x1C
  35
  36 /* Sub-block A registers, relative to sub-block A address */
  37 #define STM_SAI_PDMCR_REGX      0x40
  38 #define STM_SAI_PDMLY_REGX      0x44
  39
  40 /******************** Bit definition for SAI_GCR register *******************/
  41 #define SAI_GCR_SYNCIN_SHIFT    0
  42 #define SAI_GCR_SYNCIN_WDTH     2
  43 #define SAI_GCR_SYNCIN_MASK     GENMASK(1, SAI_GCR_SYNCIN_SHIFT)
  44 #define SAI_GCR_SYNCIN_MAX      FIELD_GET(SAI_GCR_SYNCIN_MASK,\
  45                                 SAI_GCR_SYNCIN_MASK)
  46
  47 #define SAI_GCR_SYNCOUT_SHIFT   4
  48 #define SAI_GCR_SYNCOUT_MASK    GENMASK(5, SAI_GCR_SYNCOUT_SHIFT)
  49
  50 /******************* Bit definition for SAI_XCR1 register *******************/
  51 #define SAI_XCR1_RX_TX_SHIFT    0
  52 #define SAI_XCR1_RX_TX          BIT(SAI_XCR1_RX_TX_SHIFT)
  53 #define SAI_XCR1_SLAVE_SHIFT    1
  54 #define SAI_XCR1_SLAVE          BIT(SAI_XCR1_SLAVE_SHIFT)
  55
  56 #define SAI_XCR1_PRTCFG_SHIFT   2
  57 #define SAI_XCR1_PRTCFG_MASK    GENMASK(3, SAI_XCR1_PRTCFG_SHIFT)
  58 #define SAI_XCR1_PRTCFG_SET(x)  ((x) << SAI_XCR1_PRTCFG_SHIFT)
  59
  60 #define SAI_XCR1_DS_SHIFT       5
  61 #define SAI_XCR1_DS_MASK        GENMASK(7, SAI_XCR1_DS_SHIFT)
  62 #define SAI_XCR1_DS_SET(x)      ((x) << SAI_XCR1_DS_SHIFT)
  63
  64 #define SAI_XCR1_LSBFIRST_SHIFT 8
  65 #define SAI_XCR1_LSBFIRST       BIT(SAI_XCR1_LSBFIRST_SHIFT)
  66 #define SAI_XCR1_CKSTR_SHIFT    9
  67 #define SAI_XCR1_CKSTR          BIT(SAI_XCR1_CKSTR_SHIFT)
  68
  69 #define SAI_XCR1_SYNCEN_SHIFT   10
  70 #define SAI_XCR1_SYNCEN_MASK    GENMASK(11, SAI_XCR1_SYNCEN_SHIFT)
  71 #define SAI_XCR1_SYNCEN_SET(x)  ((x) << SAI_XCR1_SYNCEN_SHIFT)
  72
  73 #define SAI_XCR1_MONO_SHIFT     12
  74 #define SAI_XCR1_MONO           BIT(SAI_XCR1_MONO_SHIFT)
  75 #define SAI_XCR1_OUTDRIV_SHIFT  13
  76 #define SAI_XCR1_OUTDRIV        BIT(SAI_XCR1_OUTDRIV_SHIFT)
  77 #define SAI_XCR1_SAIEN_SHIFT    16
  78 #define SAI_XCR1_SAIEN          BIT(SAI_XCR1_SAIEN_SHIFT)
  79 #define SAI_XCR1_DMAEN_SHIFT    17
  80 #define SAI_XCR1_DMAEN          BIT(SAI_XCR1_DMAEN_SHIFT)
  81 #define SAI_XCR1_NODIV_SHIFT    19
  82 #define SAI_XCR1_NODIV          BIT(SAI_XCR1_NODIV_SHIFT)
  83
  84 #define SAI_XCR1_MCKDIV_SHIFT   20
  85 #define SAI_XCR1_MCKDIV_WIDTH(x)        (((x) == SAI_STM32F4) ? 4 : 6)
  86 #define SAI_XCR1_MCKDIV_MASK(x) GENMASK((SAI_XCR1_MCKDIV_SHIFT + (x) - 1),\
  87                                 SAI_XCR1_MCKDIV_SHIFT)
  88 #define SAI_XCR1_MCKDIV_SET(x)  ((x) << SAI_XCR1_MCKDIV_SHIFT)
  89 #define SAI_XCR1_MCKDIV_MAX(x)  ((1 << SAI_XCR1_MCKDIV_WIDTH(x)) - 1)
  90
  91 #define SAI_XCR1_OSR_SHIFT      26
  92 #define SAI_XCR1_OSR            BIT(SAI_XCR1_OSR_SHIFT)
  93
  94 #define SAI_XCR1_MCKEN_SHIFT    27
  95 #define SAI_XCR1_MCKEN          BIT(SAI_XCR1_MCKEN_SHIFT)
  96
  97 /******************* Bit definition for SAI_XCR2 register *******************/
  98 #define SAI_XCR2_FTH_SHIFT      0
  99 #define SAI_XCR2_FTH_MASK       GENMASK(2, SAI_XCR2_FTH_SHIFT)
 100 #define SAI_XCR2_FTH_SET(x)     ((x) << SAI_XCR2_FTH_SHIFT)
 101
 102 #define SAI_XCR2_FFLUSH_SHIFT   3
 103 #define SAI_XCR2_FFLUSH         BIT(SAI_XCR2_FFLUSH_SHIFT)
 104 #define SAI_XCR2_TRIS_SHIFT     4
 105 #define SAI_XCR2_TRIS           BIT(SAI_XCR2_TRIS_SHIFT)
 106 #define SAI_XCR2_MUTE_SHIFT     5
 107 #define SAI_XCR2_MUTE           BIT(SAI_XCR2_MUTE_SHIFT)
 108 #define SAI_XCR2_MUTEVAL_SHIFT  6
 109 #define SAI_XCR2_MUTEVAL        BIT(SAI_XCR2_MUTEVAL_SHIFT)
 110
 111 #define SAI_XCR2_MUTECNT_SHIFT  7
 112 #define SAI_XCR2_MUTECNT_MASK   GENMASK(12, SAI_XCR2_MUTECNT_SHIFT)
 113 #define SAI_XCR2_MUTECNT_SET(x) ((x) << SAI_XCR2_MUTECNT_SHIFT)
 114
 115 #define SAI_XCR2_CPL_SHIFT      13
 116 #define SAI_XCR2_CPL            BIT(SAI_XCR2_CPL_SHIFT)
 117
 118 #define SAI_XCR2_COMP_SHIFT     14
 119 #define SAI_XCR2_COMP_MASK      GENMASK(15, SAI_XCR2_COMP_SHIFT)
 120 #define SAI_XCR2_COMP_SET(x)    ((x) << SAI_XCR2_COMP_SHIFT)
 121
 122 /****************** Bit definition for SAI_XFRCR register *******************/
 123 #define SAI_XFRCR_FRL_SHIFT     0
 124 #define SAI_XFRCR_FRL_MASK      GENMASK(7, SAI_XFRCR_FRL_SHIFT)
 125 #define SAI_XFRCR_FRL_SET(x)    ((x) << SAI_XFRCR_FRL_SHIFT)
 126
 127 #define SAI_XFRCR_FSALL_SHIFT   8
 128 #define SAI_XFRCR_FSALL_MASK    GENMASK(14, SAI_XFRCR_FSALL_SHIFT)
 129 #define SAI_XFRCR_FSALL_SET(x)  ((x) << SAI_XFRCR_FSALL_SHIFT)
 130
 131 #define SAI_XFRCR_FSDEF_SHIFT   16
 132 #define SAI_XFRCR_FSDEF         BIT(SAI_XFRCR_FSDEF_SHIFT)
 133 #define SAI_XFRCR_FSPOL_SHIFT   17
 134 #define SAI_XFRCR_FSPOL         BIT(SAI_XFRCR_FSPOL_SHIFT)
 135 #define SAI_XFRCR_FSOFF_SHIFT   18
 136 #define SAI_XFRCR_FSOFF         BIT(SAI_XFRCR_FSOFF_SHIFT)
 137
 138 /****************** Bit definition for SAI_XSLOTR register ******************/
 139 #define SAI_XSLOTR_FBOFF_SHIFT  0
 140 #define SAI_XSLOTR_FBOFF_MASK   GENMASK(4, SAI_XSLOTR_FBOFF_SHIFT)
 141 #define SAI_XSLOTR_FBOFF_SET(x) ((x) << SAI_XSLOTR_FBOFF_SHIFT)
 142
 143 #define SAI_XSLOTR_SLOTSZ_SHIFT 6
 144 #define SAI_XSLOTR_SLOTSZ_MASK  GENMASK(7, SAI_XSLOTR_SLOTSZ_SHIFT)
 145 #define SAI_XSLOTR_SLOTSZ_SET(x)        ((x) << SAI_XSLOTR_SLOTSZ_SHIFT)
 146
 147 #define SAI_XSLOTR_NBSLOT_SHIFT 8
 148 #define SAI_XSLOTR_NBSLOT_MASK  GENMASK(11, SAI_XSLOTR_NBSLOT_SHIFT)
 149 #define SAI_XSLOTR_NBSLOT_SET(x) ((x) << SAI_XSLOTR_NBSLOT_SHIFT)
 150
 151 #define SAI_XSLOTR_SLOTEN_SHIFT 16
 152 #define SAI_XSLOTR_SLOTEN_WIDTH 16
 153 #define SAI_XSLOTR_SLOTEN_MASK  GENMASK(31, SAI_XSLOTR_SLOTEN_SHIFT)
 154 #define SAI_XSLOTR_SLOTEN_SET(x) ((x) << SAI_XSLOTR_SLOTEN_SHIFT)
 155
 156 /******************* Bit definition for SAI_XIMR register *******************/
 157 #define SAI_XIMR_OVRUDRIE       BIT(0)
 158 #define SAI_XIMR_MUTEDETIE      BIT(1)
 159 #define SAI_XIMR_WCKCFGIE       BIT(2)
 160 #define SAI_XIMR_FREQIE         BIT(3)
 161 #define SAI_XIMR_CNRDYIE        BIT(4)
 162 #define SAI_XIMR_AFSDETIE       BIT(5)
 163 #define SAI_XIMR_LFSDETIE       BIT(6)
 164
 165 #define SAI_XIMR_SHIFT  0
 166 #define SAI_XIMR_MASK           GENMASK(6, SAI_XIMR_SHIFT)
 167
 168 /******************** Bit definition for SAI_XSR register *******************/
 169 #define SAI_XSR_OVRUDR          BIT(0)
 170 #define SAI_XSR_MUTEDET         BIT(1)
 171 #define SAI_XSR_WCKCFG          BIT(2)
 172 #define SAI_XSR_FREQ            BIT(3)
 173 #define SAI_XSR_CNRDY           BIT(4)
 174 #define SAI_XSR_AFSDET          BIT(5)
 175 #define SAI_XSR_LFSDET          BIT(6)
 176
 177 #define SAI_XSR_SHIFT   0
 178 #define SAI_XSR_MASK            GENMASK(6, SAI_XSR_SHIFT)
 179
 180 /****************** Bit definition for SAI_XCLRFR register ******************/
 181 #define SAI_XCLRFR_COVRUDR      BIT(0)
 182 #define SAI_XCLRFR_CMUTEDET     BIT(1)
 183 #define SAI_XCLRFR_CWCKCFG      BIT(2)
 184 #define SAI_XCLRFR_CFREQ        BIT(3)
 185 #define SAI_XCLRFR_CCNRDY       BIT(4)
 186 #define SAI_XCLRFR_CAFSDET      BIT(5)
 187 #define SAI_XCLRFR_CLFSDET      BIT(6)
 188
 189 #define SAI_XCLRFR_SHIFT        0
 190 #define SAI_XCLRFR_MASK         GENMASK(6, SAI_XCLRFR_SHIFT)
 191
 192 /****************** Bit definition for SAI_PDMCR register ******************/
 193 #define SAI_PDMCR_PDMEN         BIT(0)
 194
 195 #define SAI_PDMCR_MICNBR_SHIFT  4
 196 #define SAI_PDMCR_MICNBR_MASK   GENMASK(5, SAI_PDMCR_MICNBR_SHIFT)
 197 #define SAI_PDMCR_MICNBR_SET(x) ((x) << SAI_PDMCR_MICNBR_SHIFT)
 198
 199 #define SAI_PDMCR_CKEN1         BIT(8)
 200 #define SAI_PDMCR_CKEN2         BIT(9)
 201 #define SAI_PDMCR_CKEN3         BIT(10)
 202 #define SAI_PDMCR_CKEN4         BIT(11)
 203
 204 /****************** Bit definition for (SAI_PDMDLY register ****************/
 205 #define SAI_PDMDLY_1L_SHIFT     0
 206 #define SAI_PDMDLY_1L_MASK      GENMASK(2, SAI_PDMDLY_1L_SHIFT)
 207 #define SAI_PDMDLY_1L_WIDTH     3
 208
 209 #define SAI_PDMDLY_1R_SHIFT     4
 210 #define SAI_PDMDLY_1R_MASK      GENMASK(6, SAI_PDMDLY_1R_SHIFT)
 211 #define SAI_PDMDLY_1R_WIDTH     3
 212
 213 #define SAI_PDMDLY_2L_SHIFT     8
 214 #define SAI_PDMDLY_2L_MASK      GENMASK(10, SAI_PDMDLY_2L_SHIFT)
 215 #define SAI_PDMDLY_2L_WIDTH     3
 216
 217 #define SAI_PDMDLY_2R_SHIFT     12
 218 #define SAI_PDMDLY_2R_MASK      GENMASK(14, SAI_PDMDLY_2R_SHIFT)
 219 #define SAI_PDMDLY_2R_WIDTH     3
 220
 221 #define SAI_PDMDLY_3L_SHIFT     16
 222 #define SAI_PDMDLY_3L_MASK      GENMASK(18, SAI_PDMDLY_3L_SHIFT)
 223 #define SAI_PDMDLY_3L_WIDTH     3
 224
 225 #define SAI_PDMDLY_3R_SHIFT     20
 226 #define SAI_PDMDLY_3R_MASK      GENMASK(22, SAI_PDMDLY_3R_SHIFT)
 227 #define SAI_PDMDLY_3R_WIDTH     3
 228
 229 #define SAI_PDMDLY_4L_SHIFT     24
 230 #define SAI_PDMDLY_4L_MASK      GENMASK(26, SAI_PDMDLY_4L_SHIFT)
 231 #define SAI_PDMDLY_4L_WIDTH     3
 232
 233 #define SAI_PDMDLY_4R_SHIFT     28
 234 #define SAI_PDMDLY_4R_MASK      GENMASK(30, SAI_PDMDLY_4R_SHIFT)
 235 #define SAI_PDMDLY_4R_WIDTH     3
 236
 237 #define STM_SAI_IS_F4(ip)       ((ip)->conf->version == SAI_STM32F4)
 238 #define STM_SAI_IS_H7(ip)       ((ip)->conf->version == SAI_STM32H7)
 239
 240 enum stm32_sai_syncout {
 241         STM_SAI_SYNC_OUT_NONE,
 242         STM_SAI_SYNC_OUT_A,
 243         STM_SAI_SYNC_OUT_B,
 244 };
 245
 246 enum stm32_sai_version {
 247         SAI_STM32F4,
 248         SAI_STM32H7
 249 };
 250
 251 /**
 252  * struct stm32_sai_conf - SAI configuration
 253  * @version: SAI version
 254  * @has_spdif: SAI S/PDIF support flag
 255  */
 256 struct stm32_sai_conf {
 257         int version;
 258         bool has_spdif;
 259 };
 260
 261 /**
 262  * struct stm32_sai_data - private data of SAI instance driver
 263  * @pdev: device data pointer
 264  * @base: common register bank virtual base address
 265  * @pclk: SAI bus clock
 266  * @clk_x8k: SAI parent clock for sampling frequencies multiple of 8kHz
 267  * @clk_x11k: SAI parent clock for sampling frequencies multiple of 11kHz
 268  * @version: SOC version
 269  * @irq: SAI interrupt line
 270  * @set_sync: pointer to synchro mode configuration callback
 271  * @gcr: SAI Global Configuration Register
 272  */
 273 struct stm32_sai_data {
 274         struct platform_device *pdev;
 275         void __iomem *base;
 276         struct clk *pclk;
 277         struct clk *clk_x8k;
 278         struct clk *clk_x11k;
 279         struct stm32_sai_conf *conf;
 280         int irq;
 281         int (*set_sync)(struct stm32_sai_data *sai,
 282                         struct device_node *np_provider, int synco, int synci);
 283         u32 gcr;
 284 };