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__ */
127