[J-u-boot.git] / include / i2s.h

/* SPDX-License-Identifier: GPL-2.0+ */
/*
 * Copyright (C) 2012 Samsung Electronics
 * R. Chandrasekar <[email protected]>
 */

#ifndef __I2S_H__
#define __I2S_H__

/*
 * DAI hardware audio formats.
 *
 * Describes the physical PCM data formating and clocking. Add new formats
 * to the end.
 */
#define SND_SOC_DAIFMT_I2S		1 /* I2S mode */
#define SND_SOC_DAIFMT_RIGHT_J		2 /* Right Justified mode */
#define SND_SOC_DAIFMT_LEFT_J		3 /* Left Justified mode */
#define SND_SOC_DAIFMT_DSP_A		4 /* L data MSB after FRM LRC */
#define SND_SOC_DAIFMT_DSP_B		5 /* L data MSB during FRM LRC */
#define SND_SOC_DAIFMT_AC97		6 /* AC97 */
#define SND_SOC_DAIFMT_PDM		7 /* Pulse density modulation */

/* left and right justified also known as MSB and LSB respectively */
#define SND_SOC_DAIFMT_MSB		SND_SOC_DAIFMT_LEFT_J
#define SND_SOC_DAIFMT_LSB		SND_SOC_DAIFMT_RIGHT_J

/*
 * DAI hardware signal inversions.
 *
 * Specifies whether the DAI can also support inverted clocks for the specified
 * format.
 */
#define SND_SOC_DAIFMT_NB_NF	(1 << 8) /* normal bit clock + frame */
#define SND_SOC_DAIFMT_NB_IF	(2 << 8) /* normal BCLK + inv FRM */
#define SND_SOC_DAIFMT_IB_NF	(3 << 8) /* invert BCLK + nor FRM */
#define SND_SOC_DAIFMT_IB_IF	(4 << 8) /* invert BCLK + FRM */

/*
 * DAI hardware clock masters.
 *
 * 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 slave.
 */
#define SND_SOC_DAIFMT_CBM_CFM	(1 << 12) /* codec clk & FRM master */
#define SND_SOC_DAIFMT_CBS_CFM	(2 << 12) /* codec clk slave & FRM master */
#define SND_SOC_DAIFMT_CBM_CFS	(3 << 12) /* codec clk master & frame slave */
#define SND_SOC_DAIFMT_CBS_CFS	(4 << 12) /* codec clk & FRM slave */

#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

/*
 * Master Clock Directions
 */
#define SND_SOC_CLOCK_IN		0
#define SND_SOC_CLOCK_OUT		1

/* I2S Tx Control */
#define I2S_TX_ON	1
#define I2S_TX_OFF	0

#define FIFO_LENGTH	64

/* I2s Registers */
struct i2s_reg {
	unsigned int con;	/* base + 0 , Control register */
	unsigned int mod;	/* Mode register */
	unsigned int fic;	/* FIFO control register */
	unsigned int psr;	/* Reserved */
	unsigned int txd;	/* Transmit data register */
	unsigned int rxd;	/* Receive Data Register */
};

/* This structure stores the i2s related information */
struct i2s_uc_priv {
	unsigned int rfs;		/* LR clock frame size */
	unsigned int bfs;		/* Bit clock frame size */
	unsigned int audio_pll_clk;	/* Audio pll frequency in Hz */
	unsigned int samplingrate;	/* sampling rate */
	unsigned int bitspersample;	/* bits per sample */
	unsigned int channels;		/* audio channels */
	unsigned int base_address;	/* I2S Register Base */
	unsigned int id;		/* I2S controller id */
};

/* Operations for i2s devices */
struct i2s_ops {
	/**
	 * tx_data() - Transmit audio data
	 *
	 * @dev: I2C device
	 * @data: Data buffer to play
	 * @data_size: Size of data buffer in bytes
	 * @return 0 if OK, -ve on error
	 */
	int (*tx_data)(struct udevice *dev, void *data, uint data_size);
};

#define i2s_get_ops(dev)	((struct i2s_ops *)(dev)->driver->ops)

/**
 * i2s_tx_data() - Transmit audio data
 *
 * @dev: I2C device
 * @data: Data buffer to play
 * @data_size: Size of data buffer in bytes
 * Return: 0 if OK, -ve on error
 */
int i2s_tx_data(struct udevice *dev, void *data, uint data_size);

/*
 * Sends the given data through i2s tx
 *
 * @param pi2s_tx	pointer of i2s transmitter parameter structure.
 * @param data		address of the data buffer
 * @param data_size	size of the data (in bytes)
 * Return:		int value 0 for success, -1 in case of error
 */
int i2s_transfer_tx_data(struct i2s_uc_priv *pi2s_tx, void *data,
			 uint data_size);

#endif /* __I2S_H__ */
Commit	Line	Data
83d290c5	1	/* SPDX-License-Identifier: GPL-2.0+ */
511ed5fd RS	2	/*
	3	* Copyright (C) 2012 Samsung Electronics
	4	* R. Chandrasekar <[email protected]>
511ed5fd RS	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 */
45863db5	79	struct i2s_uc_priv {
511ed5fd	80	unsigned int rfs; /* LR clock frame size */
f0b02f3d	81	unsigned int bfs; /* Bit clock frame size */
511ed5fd RS	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 */
d981d80d	87	unsigned int id; /* I2S controller id */
511ed5fd RS	88	};
511ed5fd RS	89
e96fa6c9 SG	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
185f812c	111	* Return: 0 if OK, -ve on error
e96fa6c9 SG	112	*/
	113	int i2s_tx_data(struct udevice dev, void data, uint data_size);
	114
511ed5fd RS	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
e96fa6c9	120	* @param data_size size of the data (in bytes)
185f812c	121	* Return: int value 0 for success, -1 in case of error
511ed5fd	122	*/
e96fa6c9 SG	123	int i2s_transfer_tx_data(struct i2s_uc_priv pi2s_tx, void data,
e96fa6c9 SG	124	uint data_size);
511ed5fd	125
511ed5fd	126	#endif /* __I2S_H__ */