root/sound/soc/fsl/fsl_sai.h
/* SPDX-License-Identifier: GPL-2.0 */
/*
 * Copyright 2012-2013 Freescale Semiconductor, Inc.
 */

#ifndef __FSL_SAI_H
#define __FSL_SAI_H

#include <linux/dma/imx-dma.h>
#include <sound/dmaengine_pcm.h>

#define FAL_SAI_NUM_RATES  20
#define FSL_SAI_FORMATS (SNDRV_PCM_FMTBIT_S16_LE |\
                         SNDRV_PCM_FMTBIT_S20_3LE |\
                         SNDRV_PCM_FMTBIT_S24_LE |\
                         SNDRV_PCM_FMTBIT_S32_LE |\
                         SNDRV_PCM_FMTBIT_DSD_U8 |\
                         SNDRV_PCM_FMTBIT_DSD_U16_LE |\
                         SNDRV_PCM_FMTBIT_DSD_U32_LE)

/* SAI Register Map Register */
#define FSL_SAI_VERID   0x00 /* SAI Version ID Register */
#define FSL_SAI_PARAM   0x04 /* SAI Parameter Register */
#define FSL_SAI_TCSR(ofs)       (0x00 + ofs) /* SAI Transmit Control */
#define FSL_SAI_TCR1(ofs)       (0x04 + ofs) /* SAI Transmit Configuration 1 */
#define FSL_SAI_TCR2(ofs)       (0x08 + ofs) /* SAI Transmit Configuration 2 */
#define FSL_SAI_TCR3(ofs)       (0x0c + ofs) /* SAI Transmit Configuration 3 */
#define FSL_SAI_TCR4(ofs)       (0x10 + ofs) /* SAI Transmit Configuration 4 */
#define FSL_SAI_TCR5(ofs)       (0x14 + ofs) /* SAI Transmit Configuration 5 */
#define FSL_SAI_TDR0    0x20 /* SAI Transmit Data 0 */
#define FSL_SAI_TDR1    0x24 /* SAI Transmit Data 1 */
#define FSL_SAI_TDR2    0x28 /* SAI Transmit Data 2 */
#define FSL_SAI_TDR3    0x2C /* SAI Transmit Data 3 */
#define FSL_SAI_TDR4    0x30 /* SAI Transmit Data 4 */
#define FSL_SAI_TDR5    0x34 /* SAI Transmit Data 5 */
#define FSL_SAI_TDR6    0x38 /* SAI Transmit Data 6 */
#define FSL_SAI_TDR7    0x3C /* SAI Transmit Data 7 */
#define FSL_SAI_TFR0    0x40 /* SAI Transmit FIFO 0 */
#define FSL_SAI_TFR1    0x44 /* SAI Transmit FIFO 1 */
#define FSL_SAI_TFR2    0x48 /* SAI Transmit FIFO 2 */
#define FSL_SAI_TFR3    0x4C /* SAI Transmit FIFO 3 */
#define FSL_SAI_TFR4    0x50 /* SAI Transmit FIFO 4 */
#define FSL_SAI_TFR5    0x54 /* SAI Transmit FIFO 5 */
#define FSL_SAI_TFR6    0x58 /* SAI Transmit FIFO 6 */
#define FSL_SAI_TFR7    0x5C /* SAI Transmit FIFO 7 */
#define FSL_SAI_TMR     0x60 /* SAI Transmit Mask */
#define FSL_SAI_TTCTL   0x70 /* SAI Transmit Timestamp Control Register */
#define FSL_SAI_TTCTN   0x74 /* SAI Transmit Timestamp Counter Register */
#define FSL_SAI_TBCTN   0x78 /* SAI Transmit Bit Counter Register */
#define FSL_SAI_TTCAP   0x7C /* SAI Transmit Timestamp Capture */
#define FSL_SAI_RCSR(ofs)       (0x80 + ofs) /* SAI Receive Control */
#define FSL_SAI_RCR1(ofs)       (0x84 + ofs)/* SAI Receive Configuration 1 */
#define FSL_SAI_RCR2(ofs)       (0x88 + ofs) /* SAI Receive Configuration 2 */
#define FSL_SAI_RCR3(ofs)       (0x8c + ofs) /* SAI Receive Configuration 3 */
#define FSL_SAI_RCR4(ofs)       (0x90 + ofs) /* SAI Receive Configuration 4 */
#define FSL_SAI_RCR5(ofs)       (0x94 + ofs) /* SAI Receive Configuration 5 */
#define FSL_SAI_RDR0    0xa0 /* SAI Receive Data 0 */
#define FSL_SAI_RDR1    0xa4 /* SAI Receive Data 1 */
#define FSL_SAI_RDR2    0xa8 /* SAI Receive Data 2 */
#define FSL_SAI_RDR3    0xac /* SAI Receive Data 3 */
#define FSL_SAI_RDR4    0xb0 /* SAI Receive Data 4 */
#define FSL_SAI_RDR5    0xb4 /* SAI Receive Data 5 */
#define FSL_SAI_RDR6    0xb8 /* SAI Receive Data 6 */
#define FSL_SAI_RDR7    0xbc /* SAI Receive Data 7 */
#define FSL_SAI_RFR0    0xc0 /* SAI Receive FIFO 0 */
#define FSL_SAI_RFR1    0xc4 /* SAI Receive FIFO 1 */
#define FSL_SAI_RFR2    0xc8 /* SAI Receive FIFO 2 */
#define FSL_SAI_RFR3    0xcc /* SAI Receive FIFO 3 */
#define FSL_SAI_RFR4    0xd0 /* SAI Receive FIFO 4 */
#define FSL_SAI_RFR5    0xd4 /* SAI Receive FIFO 5 */
#define FSL_SAI_RFR6    0xd8 /* SAI Receive FIFO 6 */
#define FSL_SAI_RFR7    0xdc /* SAI Receive FIFO 7 */
#define FSL_SAI_RMR     0xe0 /* SAI Receive Mask */
#define FSL_SAI_RTCTL   0xf0 /* SAI Receive Timestamp Control Register */
#define FSL_SAI_RTCTN   0xf4 /* SAI Receive Timestamp Counter Register */
#define FSL_SAI_RBCTN   0xf8 /* SAI Receive Bit Counter Register */
#define FSL_SAI_RTCAP   0xfc /* SAI Receive Timestamp Capture */

#define FSL_SAI_MCTL    0x100 /* SAI MCLK Control Register */
#define FSL_SAI_MDIV    0x104 /* SAI MCLK Divide Register */

#define FSL_SAI_xCSR(tx, ofs)   (tx ? FSL_SAI_TCSR(ofs) : FSL_SAI_RCSR(ofs))
#define FSL_SAI_xCR1(tx, ofs)   (tx ? FSL_SAI_TCR1(ofs) : FSL_SAI_RCR1(ofs))
#define FSL_SAI_xCR2(tx, ofs)   (tx ? FSL_SAI_TCR2(ofs) : FSL_SAI_RCR2(ofs))
#define FSL_SAI_xCR3(tx, ofs)   (tx ? FSL_SAI_TCR3(ofs) : FSL_SAI_RCR3(ofs))
#define FSL_SAI_xCR4(tx, ofs)   (tx ? FSL_SAI_TCR4(ofs) : FSL_SAI_RCR4(ofs))
#define FSL_SAI_xCR5(tx, ofs)   (tx ? FSL_SAI_TCR5(ofs) : FSL_SAI_RCR5(ofs))
#define FSL_SAI_xDR0(tx)        (tx ? FSL_SAI_TDR0 : FSL_SAI_RDR0)
#define FSL_SAI_xFR0(tx)        (tx ? FSL_SAI_TFR0 : FSL_SAI_RFR0)
#define FSL_SAI_xMR(tx)         (tx ? FSL_SAI_TMR : FSL_SAI_RMR)

/* SAI Transmit/Receive Control Register */
#define FSL_SAI_CSR_TERE        BIT(31)
#define FSL_SAI_CSR_SE          BIT(30)
#define FSL_SAI_CSR_BCE         BIT(28)
#define FSL_SAI_CSR_FR          BIT(25)
#define FSL_SAI_CSR_SR          BIT(24)
#define FSL_SAI_CSR_xF_SHIFT    16
#define FSL_SAI_CSR_xF_W_SHIFT  18
#define FSL_SAI_CSR_xF_MASK     (0x1f << FSL_SAI_CSR_xF_SHIFT)
#define FSL_SAI_CSR_xF_W_MASK   (0x7 << FSL_SAI_CSR_xF_W_SHIFT)
#define FSL_SAI_CSR_WSF         BIT(20)
#define FSL_SAI_CSR_SEF         BIT(19)
#define FSL_SAI_CSR_FEF         BIT(18)
#define FSL_SAI_CSR_FWF         BIT(17)
#define FSL_SAI_CSR_FRF         BIT(16)
#define FSL_SAI_CSR_xIE_SHIFT   8
#define FSL_SAI_CSR_xIE_MASK    (0x1f << FSL_SAI_CSR_xIE_SHIFT)
#define FSL_SAI_CSR_WSIE        BIT(12)
#define FSL_SAI_CSR_SEIE        BIT(11)
#define FSL_SAI_CSR_FEIE        BIT(10)
#define FSL_SAI_CSR_FWIE        BIT(9)
#define FSL_SAI_CSR_FRIE        BIT(8)
#define FSL_SAI_CSR_FRDE        BIT(0)

/* SAI Transmit and Receive Configuration 1 Register */
#define FSL_SAI_CR1_RFW_MASK(x) ((x) - 1)

/* SAI Transmit and Receive Configuration 2 Register */
#define FSL_SAI_CR2_SYNC        BIT(30)
#define FSL_SAI_CR2_BCI         BIT(28)
#define FSL_SAI_CR2_MSEL_MASK   (0x3 << 26)
#define FSL_SAI_CR2_MSEL_BUS    0
#define FSL_SAI_CR2_MSEL_MCLK1  BIT(26)
#define FSL_SAI_CR2_MSEL_MCLK2  BIT(27)
#define FSL_SAI_CR2_MSEL_MCLK3  (BIT(26) | BIT(27))
#define FSL_SAI_CR2_MSEL(ID)    ((ID) << 26)
#define FSL_SAI_CR2_BCP         BIT(25)
#define FSL_SAI_CR2_BCD_MSTR    BIT(24)
#define FSL_SAI_CR2_BYP         BIT(23) /* BCLK bypass */
#define FSL_SAI_CR2_DIV_MASK    0xff

/* SAI Transmit and Receive Configuration 3 Register */
#define FSL_SAI_CR3_TRCE(x)     ((x) << 16)
#define FSL_SAI_CR3_TRCE_MASK   GENMASK(23, 16)
#define FSL_SAI_CR3_WDFL(x)     (x)
#define FSL_SAI_CR3_WDFL_MASK   0x1f

/* SAI Transmit and Receive Configuration 4 Register */

#define FSL_SAI_CR4_FCONT_MASK  BIT(28)
#define FSL_SAI_CR4_FCONT       BIT(28)
#define FSL_SAI_CR4_FCOMB_SHIFT BIT(26)
#define FSL_SAI_CR4_FCOMB_SOFT  BIT(27)
#define FSL_SAI_CR4_FCOMB_MASK  (0x3 << 26)
#define FSL_SAI_CR4_FPACK_8     (0x2 << 24)
#define FSL_SAI_CR4_FPACK_16    (0x3 << 24)
#define FSL_SAI_CR4_FRSZ(x)     (((x) - 1) << 16)
#define FSL_SAI_CR4_FRSZ_MASK   (0x1f << 16)
#define FSL_SAI_CR4_SYWD(x)     (((x) - 1) << 8)
#define FSL_SAI_CR4_SYWD_MASK   (0x1f << 8)
#define FSL_SAI_CR4_CHMOD       BIT(5)
#define FSL_SAI_CR4_CHMOD_MASK  BIT(5)
#define FSL_SAI_CR4_MF          BIT(4)
#define FSL_SAI_CR4_FSE         BIT(3)
#define FSL_SAI_CR4_FSP         BIT(1)
#define FSL_SAI_CR4_FSD_MSTR    BIT(0)

/* SAI Transmit and Receive Configuration 5 Register */
#define FSL_SAI_CR5_WNW(x)      (((x) - 1) << 24)
#define FSL_SAI_CR5_WNW_MASK    (0x1f << 24)
#define FSL_SAI_CR5_W0W(x)      (((x) - 1) << 16)
#define FSL_SAI_CR5_W0W_MASK    (0x1f << 16)
#define FSL_SAI_CR5_FBT(x)      ((x) << 8)
#define FSL_SAI_CR5_FBT_MASK    (0x1f << 8)

/* SAI MCLK Control Register */
#define FSL_SAI_MCTL_MCLK_EN    BIT(30) /* MCLK Enable */
#define FSL_SAI_MCTL_MSEL_MASK  (0x3 << 24)
#define FSL_SAI_MCTL_MSEL(ID)   ((ID) << 24)
#define FSL_SAI_MCTL_MSEL_BUS   0
#define FSL_SAI_MCTL_MSEL_MCLK1 BIT(24)
#define FSL_SAI_MCTL_MSEL_MCLK2 BIT(25)
#define FSL_SAI_MCTL_MSEL_MCLK3 (BIT(24) | BIT(25))
#define FSL_SAI_MCTL_DIV_EN     BIT(23)
#define FSL_SAI_MCTL_DIV_MASK   0xFF

/* SAI VERID Register */
#define FSL_SAI_VERID_MAJOR_SHIFT   24
#define FSL_SAI_VERID_MAJOR_MASK    GENMASK(31, 24)
#define FSL_SAI_VERID_MINOR_SHIFT   16
#define FSL_SAI_VERID_MINOR_MASK    GENMASK(23, 16)
#define FSL_SAI_VERID_FEATURE_SHIFT 0
#define FSL_SAI_VERID_FEATURE_MASK  GENMASK(15, 0)
#define FSL_SAI_VERID_EFIFO_EN      BIT(0)
#define FSL_SAI_VERID_TSTMP_EN      BIT(1)

/* SAI PARAM Register */
#define FSL_SAI_PARAM_SPF_SHIFT     16
#define FSL_SAI_PARAM_SPF_MASK      GENMASK(19, 16)
#define FSL_SAI_PARAM_WPF_SHIFT     8
#define FSL_SAI_PARAM_WPF_MASK      GENMASK(11, 8)
#define FSL_SAI_PARAM_DLN_MASK      GENMASK(3, 0)

/* SAI MCLK Divide Register */
#define FSL_SAI_MDIV_MASK           0xFFFFF

/* SAI timestamp and bitcounter */
#define FSL_SAI_xTCTL_TSEN         BIT(0)
#define FSL_SAI_xTCTL_TSINC        BIT(1)
#define FSL_SAI_xTCTL_RTSC         BIT(8)
#define FSL_SAI_xTCTL_RBC          BIT(9)

/* SAI type */
#define FSL_SAI_DMA             BIT(0)
#define FSL_SAI_USE_AC97        BIT(1)
#define FSL_SAI_NET             BIT(2)
#define FSL_SAI_TRA_SYN         BIT(3)
#define FSL_SAI_REC_SYN         BIT(4)
#define FSL_SAI_USE_I2S_SLAVE   BIT(5)

/* SAI clock sources */
#define FSL_SAI_CLK_BUS         0
#define FSL_SAI_CLK_MAST1       1
#define FSL_SAI_CLK_MAST2       2
#define FSL_SAI_CLK_MAST3       3

#define FSL_SAI_MCLK_MAX        4

/* SAI data transfer numbers per DMA request */
#define FSL_SAI_MAXBURST_TX 6
#define FSL_SAI_MAXBURST_RX 6

#define PMQOS_CPU_LATENCY   BIT(0)

/* Max number of dataline */
#define FSL_SAI_DL_NUM          (8)
/* default dataline type is zero */
#define FSL_SAI_DL_DEFAULT      (0)
#define FSL_SAI_DL_I2S          BIT(0)
#define FSL_SAI_DL_PDM          BIT(1)

#define FSL_SAI_AMIX_BYPASS     0
#define FSL_SAI_AMIX_AUDMIX     1
#define FSL_SAI_AMIX_NONE       2

struct fsl_sai_soc_data {
        bool use_imx_pcm;
        bool use_edma;
        bool mclk0_is_mclk1;
        bool mclk_with_tere;
        unsigned int fifo_depth;
        unsigned int pins;
        unsigned int reg_offset;
        unsigned int flags;
        unsigned int max_register;
        unsigned int max_burst[2];
};

/**
 * struct fsl_sai_verid - version id data
 * @version: version number
 * @feature: feature specification number
 *           0000000000000000b - Standard feature set
 *           0000000000000000b - Standard feature set
 */
struct fsl_sai_verid {
        u32 version;
        u32 feature;
};

/**
 * struct fsl_sai_param - parameter data
 * @slot_num: The maximum number of slots per frame
 * @fifo_depth: The number of words in each FIFO (depth)
 * @dataline: The number of datalines implemented
 */
struct fsl_sai_param {
        u32 slot_num;
        u32 fifo_depth;
        u32 dataline;
};

struct fsl_sai_dl_cfg {
        unsigned int type;
        unsigned int pins[2];
        unsigned int mask[2];
        unsigned int start_off[2];
        unsigned int next_off[2];
};

struct fsl_sai {
        struct platform_device *pdev;
        struct regmap *regmap;
        struct clk *bus_clk;
        struct clk *mclk_clk[FSL_SAI_MCLK_MAX];
        struct clk *pll8k_clk;
        struct clk *pll11k_clk;
        struct resource *res;

        bool is_consumer_mode[2];
        bool is_lsb_first;
        bool is_dsp_mode[2];
        bool is_pdm_mode;
        bool is_multi_fifo_dma;
        bool synchronous[2];
        struct fsl_sai_dl_cfg *dl_cfg;
        unsigned int dl_cfg_cnt;
        bool mclk_direction_output;

        unsigned int mclk_id[2];
        unsigned int mclk_streams;
        unsigned int slots[2];
        unsigned int slot_width[2];
        unsigned int bclk_ratio;

        const struct fsl_sai_soc_data *soc_data;
        struct snd_soc_dai_driver cpu_dai_drv[3];
        struct snd_dmaengine_dai_dma_data dma_params_rx;
        struct snd_dmaengine_dai_dma_data dma_params_tx;
        struct fsl_sai_verid verid;
        struct fsl_sai_param param;
        struct pm_qos_request pm_qos_req;
        struct pinctrl *pinctrl;
        struct pinctrl_state *pins_state;
        struct sdma_peripheral_config audio_config[2];
        struct snd_pcm_hw_constraint_list constraint_rates;
        unsigned int constraint_rates_list[FAL_SAI_NUM_RATES];
};

#define TX 1
#define RX 0

#endif /* __FSL_SAI_H */