include/i2s.h

   1 /* SPDX-License-Identifier: GPL-2.0+ */
   2 /*
   3  * Copyright (C) 2012 Samsung Electronics
   4  * R. Chandrasekar <rcsekar@samsung.com>
   5  */
   6
   7 #ifndef __I2S_H__
   8 #define __I2S_H__
   9
  10 /*
  11  * DAI hardware audio formats.
  12  *
  13  * Describes the physical PCM data formating and clocking. Add new formats
  14  * to the end.
  15  */
  16 #define SND_SOC_DAIFMT_I2S              1 /* I2S mode */
  17 #define SND_SOC_DAIFMT_RIGHT_J          2 /* Right Justified mode */
  18 #define SND_SOC_DAIFMT_LEFT_J           3 /* Left Justified mode */
  19 #define SND_SOC_DAIFMT_DSP_A            4 /* L data MSB after FRM LRC */
  20 #define SND_SOC_DAIFMT_DSP_B            5 /* L data MSB during FRM LRC */
  21 #define SND_SOC_DAIFMT_AC97             6 /* AC97 */
  22 #define SND_SOC_DAIFMT_PDM              7 /* Pulse density modulation */
  23
  24 /* left and right justified also known as MSB and LSB respectively */
  25 #define SND_SOC_DAIFMT_MSB              SND_SOC_DAIFMT_LEFT_J
  26 #define SND_SOC_DAIFMT_LSB              SND_SOC_DAIFMT_RIGHT_J
  27
  28 /*
  29  * DAI hardware signal inversions.
  30  *
  31  * Specifies whether the DAI can also support inverted clocks for the specified
  32  * format.
  33  */
  34 #define SND_SOC_DAIFMT_NB_NF    (1 << 8) /* normal bit clock + frame */
  35 #define SND_SOC_DAIFMT_NB_IF    (2 << 8) /* normal BCLK + inv FRM */
  36 #define SND_SOC_DAIFMT_IB_NF    (3 << 8) /* invert BCLK + nor FRM */
  37 #define SND_SOC_DAIFMT_IB_IF    (4 << 8) /* invert BCLK + FRM */
  38
  39 /*
  40  * DAI hardware clock masters.
  41  *
  42  * This is wrt the codec, the inverse is true for the interface
  43  * i.e. if the codec is clk and FRM master then the interface is
  44  * clk and frame slave.
  45  */
  46 #define SND_SOC_DAIFMT_CBM_CFM  (1 << 12) /* codec clk & FRM master */
  47 #define SND_SOC_DAIFMT_CBS_CFM  (2 << 12) /* codec clk slave & FRM master */
  48 #define SND_SOC_DAIFMT_CBM_CFS  (3 << 12) /* codec clk master & frame slave */
  49 #define SND_SOC_DAIFMT_CBS_CFS  (4 << 12) /* codec clk & FRM slave */
  50
  51 #define SND_SOC_DAIFMT_FORMAT_MASK      0x000f
  52 #define SND_SOC_DAIFMT_CLOCK_MASK       0x00f0
  53 #define SND_SOC_DAIFMT_INV_MASK         0x0f00
  54 #define SND_SOC_DAIFMT_MASTER_MASK      0xf000
  55
  56 /*
  57  * Master Clock Directions
  58  */
  59 #define SND_SOC_CLOCK_IN                0
  60 #define SND_SOC_CLOCK_OUT               1
  61
  62 /* I2S Tx Control */
  63 #define I2S_TX_ON       1
  64 #define I2S_TX_OFF      0
  65
  66 #define FIFO_LENGTH     64
  67
  68 /* I2s Registers */
  69 struct i2s_reg {
  70         unsigned int con;       /* base + 0 , Control register */
  71         unsigned int mod;       /* Mode register */
  72         unsigned int fic;       /* FIFO control register */
  73         unsigned int psr;       /* Reserved */
  74         unsigned int txd;       /* Transmit data register */
  75         unsigned int rxd;       /* Receive Data Register */
  76 };
  77
  78 /* This structure stores the i2s related information */
  79 struct i2s_uc_priv {
  80         unsigned int rfs;               /* LR clock frame size */
  81         unsigned int bfs;               /* Bit clock frame size */
  82         unsigned int audio_pll_clk;     /* Audio pll frequency in Hz */
  83         unsigned int samplingrate;      /* sampling rate */
  84         unsigned int bitspersample;     /* bits per sample */
  85         unsigned int channels;          /* audio channels */
  86         unsigned int base_address;      /* I2S Register Base */
  87         unsigned int id;                /* I2S controller id */
  88 };
  89
  90 /* Operations for i2s devices */
  91 struct i2s_ops {
  92         /**
  93          * tx_data() - Transmit audio data
  94          *
  95          * @dev: I2C device
  96          * @data: Data buffer to play
  97          * @data_size: Size of data buffer in bytes
  98          * @return 0 if OK, -ve on error
  99          */
 100         int (*tx_data)(struct udevice *dev, void *data, uint data_size);
 101 };
 102
 103 #define i2s_get_ops(dev)        ((struct i2s_ops *)(dev)->driver->ops)
 104
 105 /**
 106  * i2s_tx_data() - Transmit audio data
 107  *
 108  * @dev: I2C device
 109  * @data: Data buffer to play
 110  * @data_size: Size of data buffer in bytes
 111  * @return 0 if OK, -ve on error
 112  */
 113 int i2s_tx_data(struct udevice *dev, void *data, uint data_size);
 114
 115 /*
 116  * Sends the given data through i2s tx
 117  *
 118  * @param pi2s_tx       pointer of i2s transmitter parameter structure.
 119  * @param data          address of the data buffer
 120  * @param data_size     size of the data (in bytes)
 121  * @return              int value 0 for success, -1 in case of error
 122  */
 123 int i2s_transfer_tx_data(struct i2s_uc_priv *pi2s_tx, void *data,
 124                          uint data_size);
 125
 126 #endif /* __I2S_H__ */