path: root/include/linux/intel_mid_i2s_common.h

/*
 * <Driver for I2S protocol on SSP (Moorestown and Medfield hardware)>
 * Copyright (c) 2010, Intel Corporation.
 * Louis LE GALL <louis.le.gall intel.com>
 *
 * This program is free software; you can redistribute it and/or modify it
 * under the terms and conditions of the GNU General Public License,
 * version 2, as published by the Free Software Foundation.
 *
 * This program is distributed in the hope it will be useful, but WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
 * more details.
 *
 * You should have received a copy of the GNU General Public License along with
 * this program; if not, write to the Free Software Foundation, Inc.,
 * 51 Franklin St - Fifth Floor, Boston, MA 02110-1301 USA.
 */
#ifndef MID_I2S_COMMON_H_
#define MID_I2S_COMMON_H_

#include <linux/types.h>

/*
 *	SSCR0 settings
 */

enum mrst_ssp_mode {
	SSP_IN_NORMAL_MODE = 0x0,
	SSP_IN_NETWORK_MODE,
	SSP_INVALID_MODE = 0xF
};

enum mrst_ssp_rx_fifo_over_run_int_mask {
	SSP_RX_FIFO_OVER_INT_ENABLE = 0x0,
	SSP_RX_FIFO_OVER_INT_DISABLE
};

enum mrst_ssp_tx_fifo_under_run_int_mask {
	SSP_TX_FIFO_UNDER_INT_ENABLE = 0x0,
	SSP_TX_FIFO_UNDER_INT_DISABLE
};

enum mrst_ssp_frame_format {
	MOTOROLA_SPI_FORMAT = 0x0,
	TI_SSP_FORMAT,
	MICROWIRE_FORMAT,
	PSP_FORMAT

};

enum mrst_ssp_master_mode_clock_selection {
	SSP_ONCHIP_CLOCK = 0x0,
	SSP_NETWORK_CLOCK,
	SSP_EXTERNAL_CLOCK,
	SSP_ONCHIP_AUDIO_CLOCK,
	SSP_MASTER_CLOCK_UNDEFINED = 0xFF
};

/*
 * Following enum and define are for frequency calculation in master mode...
 */

enum mrst_ssp_frm_freq {
	SSP_FRM_FREQ_UNDEFINED = 0,
	SSP_FRM_FREQ_48_000,
	SSP_FRM_FREQ_44_100,
	SSP_FRM_FREQ_22_050,
	SSP_FRM_FREQ_16_000,
	SSP_FRM_FREQ_11_025,
	SSP_FRM_FREQ_8_000,
	SSP_FRM_FREQ_SIZE
};

/*
 *	SSCR1 settings
 */
enum mrst_ssp_txd_tristate_last_phase {
	TXD_TRISTATE_LAST_PHASE_OFF =  0x0,
	TXD_TRISTATE_LAST_PHASE_ON
};

enum mrst_ssp_txd_tristate_enable {
	TXD_TRISTATE_OFF =  0x0,
	TXD_TRISTATE_ON
};

enum mrst_ssp_slave_sspclk_free_running {
	SLAVE_SSPCLK_ON_ALWAYS =  0x0,
	SLAVE_SSPCLK_ON_DURING_TRANSFER_ONLY
};

enum mrst_ssp_sspsclk_direction {
	SSPSCLK_MASTER_MODE = 0x0,
	SSPSCLK_SLAVE_MODE
};

enum mrst_ssp_sspsfrm_direction {
	SSPSFRM_MASTER_MODE = 0x0,
	SSPSFRM_SLAVE_MODE
};

enum mrst_ssp_rx_without_tx {
	RX_AND_TX_MODE = 0x0,
	RX_WITHOUT_TX_MODE
};

enum mrst_trailing_byte_mode {
	SSP_TRAILING_BYTE_HDL_BY_IA = 0x0,
	SSP_TRAILING_BYTE_HDL_BY_DMA
};

enum mrst_ssp_tx_dma_status {
	SSP_TX_DMA_MASK = 0x0,
	SSP_TX_DMA_ENABLE
};

enum mrst_ssp_rx_dma_status {
	SSP_RX_DMA_MASK = 0x0,
	SSP_RX_DMA_ENABLE
};

enum mrst_ssp_rx_timeout_int_status {
	SSP_RX_TIMEOUT_INT_DISABLE = 0x0,
	SSP_RX_TIMEOUT_INT_ENABLE
};

enum mrst_ssp_trailing_byte_int_status {
	SSP_TRAILING_BYTE_INT_DISABLE = 0x0,
	SSP_TRAILING_BYTE_INT_ENABLE
};

enum mrst_ssp_loopback_mode_status {
	SSP_LOOPBACK_OFF = 0x0,
	SSP_LOOPBACK_ON
};

/*
 *	SSPSP settings: for PSP Format ONLY!!!!!!!!
 */

enum mrst_ssp_frame_sync_relative_timing_bit {
	NEXT_FRMS_ASS_AFTER_END_OF_T4 =  0x0,
	NEXT_FRMS_ASS_WITH_LSB_PREVIOUS_FRM
};

enum mrst_ssp_frame_sync_polarity_bit {
	SSP_FRMS_ACTIVE_LOW =  0x0,
	SSP_FRMS_ACTIVE_HIGH
};

enum mrst_ssp_end_of_transfer_data_state {
	SSP_END_DATA_TRANSFER_STATE_LOW = 0x0,
	SSP_END_DATA_TRANSFER_STATE_PEVIOUS_BIT
};

enum mrst_ssp_clk_mode {
	SSP_CLK_MODE_0 = 0x0,
	SSP_CLK_MODE_1,
	SSP_CLK_MODE_2,
	SSP_CLK_MODE_3
};

#ifdef CONFIG_ACPI

#define ACPI_FREQ_LEN 4

struct intel_mid_i2s_ssp_config {
	__u8   ssp_psp_T1;
	__u8   ssp_psp_T2;
	__u8   ssp_psp_T4;   /* DMYSTOP */
	__u8   ssp_psp_T5;   /* SFRMDLY */
	__u8   ssp_psp_T6;   /* SFRMWDTH */
	bool   valid;
};

enum ssp_config_type {
	SSPCONF_NONE = 0,
	SSPCONF_PCM0,
	SSPCONF_PCM1,
	SSPCONF_I2S0
};

#define CONFIG_C08K "C08K"
#define CONFIG_C16K "C16K"
#define CONFIG_C48K "C48K"

struct name_to_config_type {
	char config_name[ACPI_FREQ_LEN+1];
	enum ssp_config_type type;
};

#endif

/*
 *	Structure used to configure the SSP Port
 *	Please note that only the PSP format and the DMA transfer are supported
 *
 *      mode : Normal or Network (Network typically used in systems where
 *       several devices are connected to same TX, RX, FRMS, CLK...
 *      rx_fifo_interrupt : mask fifo over run interrupts.
 *      tx_fifo_interrupt : mask fifo under run interrupts.
 *      frame_format : 4 format available. PSP is Programmable Serial Protocol
 *	master_mode_clk_selection : select which clock will be used to generate
 *        the clock in master mode.
 *      frame_rate_divider_control : number of time slots used in network mode.
 *	 however, this is second priority vs doing required framesync clock in
 *	 master mode (this number may be increased to reach correct framesync
 *	 rate). The active tx & rx slot map will be limit the real active slots.
 *	master_mode_standard_freq : in master mode, select which standard frame
 *	 frequency you want to be generated by SSP.
 *	data_size : size in bits of each sample. In master mode only 8, 16 or 32
 *	 data sizes are supported.
 *	tx_tristate_phase : tri state phase (see langwell spec...)
 *	tx_tristate_enable : enable tri state of tx when not transmitting data.
 *
 */
struct intel_mid_i2s_settings {
	enum mrst_ssp_mode                        mode;
	enum mrst_ssp_rx_fifo_over_run_int_mask   rx_fifo_interrupt;
	enum mrst_ssp_tx_fifo_under_run_int_mask  tx_fifo_interrupt;
	enum mrst_ssp_frame_format                frame_format;
	/* below for Master Mode Only */
	enum mrst_ssp_master_mode_clock_selection master_mode_clk_selection;
	__u8                                      frame_rate_divider_control;
	/* below for Master Mode Only */
	enum mrst_ssp_frm_freq                    master_mode_standard_freq;

	__u16                                     data_size;

	enum mrst_ssp_txd_tristate_last_phase     tx_tristate_phase;
	enum mrst_ssp_txd_tristate_enable         tx_tristate_enable;
	enum mrst_ssp_slave_sspclk_free_running   slave_clk_free_running_status;
	enum mrst_ssp_sspsclk_direction           sspslclk_direction;
	enum mrst_ssp_sspsfrm_direction           sspsfrm_direction;
	enum mrst_ssp_rx_without_tx               ssp_duplex_mode;
	enum mrst_trailing_byte_mode              ssp_trailing_byte_mode;
	enum mrst_ssp_tx_dma_status               ssp_tx_dma;
	enum mrst_ssp_rx_dma_status               ssp_rx_dma;
	enum mrst_ssp_rx_timeout_int_status
					ssp_rx_timeout_interrupt_status;
	enum mrst_ssp_trailing_byte_int_status
					ssp_trailing_byte_interrupt_status;
	enum mrst_ssp_loopback_mode_status        ssp_loopback_mode_status;
	__u8                                      ssp_rx_fifo_threshold;
	__u8                                      ssp_tx_fifo_threshold;

	enum mrst_ssp_frame_sync_relative_timing_bit  ssp_frmsync_timing_bit;
	enum mrst_ssp_frame_sync_polarity_bit     ssp_frmsync_pol_bit;
	enum mrst_ssp_end_of_transfer_data_state  ssp_end_transfer_state;
	enum mrst_ssp_clk_mode                    ssp_serial_clk_mode;
	__u8                                      ssp_psp_T1;
	__u8                                      ssp_psp_T2;
	__u8                                      ssp_psp_T4;   /* DMYSTOP */
	__u8                                      ssp_psp_T5;   /* SFRMDLY */
	__u8                                      ssp_psp_T6;   /* SFRMWDTH */

	__u8                                      ssp_active_tx_slots_map;
	__u8                                      ssp_active_rx_slots_map;
};

#endif /* MID_I2S_COMMON_H_*/