mirror of
				https://github.com/espressif/esp-idf.git
				synced 2025-11-04 06:11:06 +00:00 
			
		
		
		
	Many files in the HAL layer depended on SOC_ macros without explicitly including soc_caps.h
		
			
				
	
	
		
			275 lines
		
	
	
		
			8.7 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			275 lines
		
	
	
		
			8.7 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
// Copyright 2015-2019 Espressif Systems (Shanghai) PTE LTD
 | 
						|
//
 | 
						|
// Licensed under the Apache License, Version 2.0 (the "License");
 | 
						|
// you may not use this file except in compliance with the License.
 | 
						|
// You may obtain a copy of the License at
 | 
						|
//
 | 
						|
//     http://www.apache.org/licenses/LICENSE-2.0
 | 
						|
//
 | 
						|
// Unless required by applicable law or agreed to in writing, software
 | 
						|
// distributed under the License is distributed on an "AS IS" BASIS,
 | 
						|
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 | 
						|
// See the License for the specific language governing permissions and
 | 
						|
// limitations under the License.
 | 
						|
 | 
						|
// The HAL layer for I2S (common part)
 | 
						|
 | 
						|
#include "soc/soc.h"
 | 
						|
#include "soc/soc_caps.h"
 | 
						|
#include "hal/i2s_hal.h"
 | 
						|
 | 
						|
#define I2S_TX_PDM_FP_DEF  960   // Set to the recommended value(960) in TRM
 | 
						|
#define I2S_RX_PDM_DSR_DEF 0
 | 
						|
 | 
						|
void i2s_hal_set_tx_mode(i2s_hal_context_t *hal, i2s_channel_t ch, i2s_bits_per_sample_t bits)
 | 
						|
{
 | 
						|
    if (bits <= I2S_BITS_PER_SAMPLE_16BIT) {
 | 
						|
        i2s_ll_set_tx_fifo_mod(hal->dev, (ch == I2S_CHANNEL_STEREO) ? 0 : 1);
 | 
						|
    } else {
 | 
						|
        i2s_ll_set_tx_fifo_mod(hal->dev, (ch == I2S_CHANNEL_STEREO) ? 2 : 3);
 | 
						|
    }
 | 
						|
    i2s_ll_set_tx_chan_mod(hal->dev, (ch == I2S_CHANNEL_STEREO) ? 0 : 1);
 | 
						|
#if SOC_I2S_SUPPORTS_DMA_EQUAL
 | 
						|
    i2s_ll_set_tx_dma_equal(hal->dev, (ch == I2S_CHANNEL_STEREO) ? 0 : 1);
 | 
						|
#endif
 | 
						|
}
 | 
						|
 | 
						|
void i2s_hal_set_rx_mode(i2s_hal_context_t *hal, i2s_channel_t ch, i2s_bits_per_sample_t bits)
 | 
						|
{
 | 
						|
    if (bits <= I2S_BITS_PER_SAMPLE_16BIT) {
 | 
						|
        i2s_ll_set_rx_fifo_mod(hal->dev, (ch == I2S_CHANNEL_STEREO) ? 0 : 1);
 | 
						|
    } else {
 | 
						|
        i2s_ll_set_rx_fifo_mod(hal->dev, (ch == I2S_CHANNEL_STEREO) ? 2 : 3);
 | 
						|
    }
 | 
						|
    i2s_ll_set_rx_chan_mod(hal->dev, (ch == I2S_CHANNEL_STEREO) ? 0 : 1);
 | 
						|
#if SOC_I2S_SUPPORTS_DMA_EQUAL
 | 
						|
    i2s_ll_set_rx_dma_equal(hal->dev, (ch == I2S_CHANNEL_STEREO) ? 0 : 1);
 | 
						|
#endif
 | 
						|
}
 | 
						|
 | 
						|
void i2s_hal_set_in_link(i2s_hal_context_t *hal, uint32_t bytes_num, uint32_t addr)
 | 
						|
{
 | 
						|
    i2s_ll_set_in_link_addr(hal->dev, addr);
 | 
						|
    i2s_ll_set_rx_eof_num(hal->dev, bytes_num);
 | 
						|
}
 | 
						|
 | 
						|
#if SOC_I2S_SUPPORTS_PDM
 | 
						|
void i2s_hal_tx_pdm_cfg(i2s_hal_context_t *hal, uint32_t fp, uint32_t fs)
 | 
						|
{
 | 
						|
    i2s_ll_tx_pdm_cfg(hal->dev, fp, fs);
 | 
						|
}
 | 
						|
 | 
						|
void i2s_hal_get_tx_pdm(i2s_hal_context_t *hal, uint32_t *fp, uint32_t *fs)
 | 
						|
{
 | 
						|
    i2s_ll_get_tx_pdm(hal->dev, fp, fs);
 | 
						|
}
 | 
						|
 | 
						|
void i2s_hal_rx_pdm_cfg(i2s_hal_context_t *hal, uint32_t dsr)
 | 
						|
{
 | 
						|
    i2s_ll_rx_pdm_cfg(hal->dev, dsr);
 | 
						|
}
 | 
						|
 | 
						|
void i2s_hal_get_rx_pdm(i2s_hal_context_t *hal, uint32_t *dsr)
 | 
						|
{
 | 
						|
    i2s_ll_get_rx_pdm(hal->dev, dsr);
 | 
						|
}
 | 
						|
#endif
 | 
						|
 | 
						|
void i2s_hal_set_clk_div(i2s_hal_context_t *hal, int div_num, int div_a, int div_b, int tx_bck_div, int rx_bck_div)
 | 
						|
{
 | 
						|
    i2s_ll_set_clkm_div_num(hal->dev, div_num);
 | 
						|
    i2s_ll_set_clkm_div_a(hal->dev, div_a);
 | 
						|
    i2s_ll_set_clkm_div_b(hal->dev, div_b);
 | 
						|
    i2s_ll_set_tx_bck_div_num(hal->dev, tx_bck_div);
 | 
						|
    i2s_ll_set_rx_bck_div_num(hal->dev, rx_bck_div);
 | 
						|
}
 | 
						|
 | 
						|
void i2s_hal_set_tx_bits_mod(i2s_hal_context_t *hal, i2s_bits_per_sample_t bits)
 | 
						|
{
 | 
						|
    i2s_ll_set_tx_bits_mod(hal->dev, bits);
 | 
						|
}
 | 
						|
 | 
						|
void i2s_hal_set_rx_bits_mod(i2s_hal_context_t *hal, i2s_bits_per_sample_t bits)
 | 
						|
{
 | 
						|
    i2s_ll_set_rx_bits_mod(hal->dev, bits);
 | 
						|
}
 | 
						|
 | 
						|
void i2s_hal_reset(i2s_hal_context_t *hal)
 | 
						|
{
 | 
						|
    // Reset I2S TX/RX module first, and then, reset DMA and FIFO.
 | 
						|
    i2s_ll_reset_tx(hal->dev);
 | 
						|
    i2s_ll_reset_rx(hal->dev);
 | 
						|
    i2s_ll_reset_dma_in(hal->dev);
 | 
						|
    i2s_ll_reset_dma_out(hal->dev);
 | 
						|
    i2s_ll_reset_rx_fifo(hal->dev);
 | 
						|
    i2s_ll_reset_tx_fifo(hal->dev);
 | 
						|
}
 | 
						|
 | 
						|
void i2s_hal_start_tx(i2s_hal_context_t *hal)
 | 
						|
{
 | 
						|
    i2s_ll_start_out_link(hal->dev);
 | 
						|
    i2s_ll_start_tx(hal->dev);
 | 
						|
}
 | 
						|
 | 
						|
void i2s_hal_start_rx(i2s_hal_context_t *hal)
 | 
						|
{
 | 
						|
    i2s_ll_start_in_link(hal->dev);
 | 
						|
    i2s_ll_start_rx(hal->dev);
 | 
						|
}
 | 
						|
 | 
						|
void i2s_hal_stop_tx(i2s_hal_context_t *hal)
 | 
						|
{
 | 
						|
    i2s_ll_stop_out_link(hal->dev);
 | 
						|
    i2s_ll_stop_tx(hal->dev);
 | 
						|
}
 | 
						|
 | 
						|
void i2s_hal_stop_rx(i2s_hal_context_t *hal)
 | 
						|
{
 | 
						|
    i2s_ll_stop_in_link(hal->dev);
 | 
						|
    i2s_ll_stop_rx(hal->dev);
 | 
						|
}
 | 
						|
 | 
						|
void i2s_hal_format_config(i2s_hal_context_t *hal, const i2s_config_t *i2s_config)
 | 
						|
{
 | 
						|
    switch (i2s_config->communication_format) {
 | 
						|
        case I2S_COMM_FORMAT_STAND_MSB:
 | 
						|
            if (i2s_config->mode & I2S_MODE_TX) {
 | 
						|
                i2s_ll_set_tx_format_msb_align(hal->dev);
 | 
						|
            }
 | 
						|
            if (i2s_config->mode & I2S_MODE_RX) {
 | 
						|
                i2s_ll_set_rx_format_msb_align(hal->dev);
 | 
						|
            }
 | 
						|
            break;
 | 
						|
        case I2S_COMM_FORMAT_STAND_PCM_SHORT:
 | 
						|
            if (i2s_config->mode & I2S_MODE_TX) {
 | 
						|
                i2s_ll_set_tx_pcm_long(hal->dev);
 | 
						|
            }
 | 
						|
            if (i2s_config->mode & I2S_MODE_RX) {
 | 
						|
                i2s_ll_set_rx_pcm_long(hal->dev);
 | 
						|
            }
 | 
						|
            break;
 | 
						|
        case I2S_COMM_FORMAT_STAND_PCM_LONG:
 | 
						|
            if (i2s_config->mode & I2S_MODE_TX) {
 | 
						|
                i2s_ll_set_tx_pcm_short(hal->dev);
 | 
						|
            }
 | 
						|
            if (i2s_config->mode & I2S_MODE_RX) {
 | 
						|
                i2s_ll_set_rx_pcm_short(hal->dev);
 | 
						|
            }
 | 
						|
            break;
 | 
						|
        default: //I2S_COMM_FORMAT_STAND_I2S
 | 
						|
            if (i2s_config->mode & I2S_MODE_TX) {
 | 
						|
                i2s_ll_set_tx_format_philip(hal->dev);
 | 
						|
            }
 | 
						|
            if (i2s_config->mode & I2S_MODE_RX) {
 | 
						|
                i2s_ll_set_rx_format_philip(hal->dev);
 | 
						|
            }
 | 
						|
            break;
 | 
						|
    }
 | 
						|
}
 | 
						|
 | 
						|
void i2s_hal_config_param(i2s_hal_context_t *hal, const i2s_config_t *i2s_config)
 | 
						|
{
 | 
						|
    //reset i2s
 | 
						|
    i2s_ll_reset_tx(hal->dev);
 | 
						|
    i2s_ll_reset_rx(hal->dev);
 | 
						|
 | 
						|
    //reset dma
 | 
						|
    i2s_ll_reset_dma_in(hal->dev);
 | 
						|
    i2s_ll_reset_dma_out(hal->dev);
 | 
						|
 | 
						|
    i2s_ll_enable_dma(hal->dev);
 | 
						|
 | 
						|
    i2s_ll_set_lcd_en(hal->dev, 0);
 | 
						|
    i2s_ll_set_camera_en(hal->dev, 0);
 | 
						|
 | 
						|
    i2s_ll_set_dscr_en(hal->dev, 0);
 | 
						|
 | 
						|
    i2s_ll_set_tx_chan_mod(hal->dev, i2s_config->channel_format < I2S_CHANNEL_FMT_ONLY_RIGHT ? i2s_config->channel_format : (i2s_config->channel_format >> 1)); // 0-two channel;1-right;2-left;3-righ;4-left
 | 
						|
    i2s_ll_set_tx_fifo_mod(hal->dev, i2s_config->channel_format < I2S_CHANNEL_FMT_ONLY_RIGHT ? 0 : 1); // 0-right&left channel;1-one channel
 | 
						|
    i2s_ll_set_tx_mono(hal->dev, 0);
 | 
						|
 | 
						|
    i2s_ll_set_rx_chan_mod(hal->dev, i2s_config->channel_format < I2S_CHANNEL_FMT_ONLY_RIGHT ? i2s_config->channel_format : (i2s_config->channel_format >> 1)); // 0-two channel;1-right;2-left;3-righ;4-left
 | 
						|
    i2s_ll_set_rx_fifo_mod(hal->dev, i2s_config->channel_format < I2S_CHANNEL_FMT_ONLY_RIGHT ? 0 : 1); // 0-right&left channel;1-one channel
 | 
						|
    i2s_ll_set_rx_mono(hal->dev, 0);
 | 
						|
 | 
						|
    i2s_ll_set_dscr_en(hal->dev, 1); //connect dma to fifo
 | 
						|
 | 
						|
    i2s_ll_stop_tx(hal->dev);
 | 
						|
    i2s_ll_stop_rx(hal->dev);
 | 
						|
 | 
						|
    if (i2s_config->mode & I2S_MODE_TX) {
 | 
						|
        i2s_ll_set_tx_msb_right(hal->dev, 0);
 | 
						|
        i2s_ll_set_tx_right_first(hal->dev, 0);
 | 
						|
 | 
						|
        i2s_ll_set_tx_slave_mod(hal->dev, 0); // Master
 | 
						|
        i2s_ll_set_tx_fifo_mod_force_en(hal->dev, 1);
 | 
						|
 | 
						|
        if (i2s_config->mode & I2S_MODE_SLAVE) {
 | 
						|
            i2s_ll_set_tx_slave_mod(hal->dev, 1); //TX Slave
 | 
						|
        }
 | 
						|
    }
 | 
						|
 | 
						|
    if (i2s_config->mode & I2S_MODE_RX) {
 | 
						|
        i2s_ll_set_rx_msb_right(hal->dev, 0);
 | 
						|
        i2s_ll_set_rx_right_first(hal->dev, 0);
 | 
						|
        i2s_ll_set_rx_slave_mod(hal->dev, 0); // Master
 | 
						|
        i2s_ll_set_rx_fifo_mod_force_en(hal->dev, 1);
 | 
						|
 | 
						|
        if (i2s_config->mode & I2S_MODE_SLAVE) {
 | 
						|
            i2s_ll_set_rx_slave_mod(hal->dev, 1); //RX Slave
 | 
						|
        }
 | 
						|
    }
 | 
						|
 | 
						|
#if SOC_I2S_SUPPORTS_PDM
 | 
						|
    if (!(i2s_config->mode & I2S_MODE_PDM)) {
 | 
						|
        i2s_ll_set_rx_pdm_en(hal->dev, 0);
 | 
						|
        i2s_ll_set_tx_pdm_en(hal->dev, 0);
 | 
						|
    } else {
 | 
						|
        if (i2s_config->mode & I2S_MODE_TX) {
 | 
						|
            i2s_ll_tx_pdm_cfg(hal->dev, I2S_TX_PDM_FP_DEF, i2s_config->sample_rate/100);
 | 
						|
        }
 | 
						|
        if(i2s_config->mode & I2S_MODE_RX) {
 | 
						|
            i2s_ll_rx_pdm_cfg(hal->dev, I2S_RX_PDM_DSR_DEF);
 | 
						|
        }
 | 
						|
        // PDM mode have nothing to do with communication format configuration.
 | 
						|
        return;
 | 
						|
    }
 | 
						|
#endif
 | 
						|
 | 
						|
#if SOC_I2S_SUPPORTS_ADC_DAC
 | 
						|
    if (i2s_config->mode & (I2S_MODE_DAC_BUILT_IN | I2S_MODE_ADC_BUILT_IN)) {
 | 
						|
        if (i2s_config->mode & I2S_MODE_DAC_BUILT_IN) {
 | 
						|
            i2s_ll_build_in_dac_ena(hal->dev);
 | 
						|
        }
 | 
						|
        if (i2s_config->mode & I2S_MODE_ADC_BUILT_IN) {
 | 
						|
            i2s_ll_build_in_adc_ena(hal->dev);
 | 
						|
            i2s_ll_set_rx_chan_mod(hal->dev, 1);
 | 
						|
            i2s_ll_set_rx_fifo_mod(hal->dev, 1);
 | 
						|
            i2s_ll_set_rx_mono(hal->dev, 0);
 | 
						|
        }
 | 
						|
        // Buildin ADC and DAC have nothing to do with communication format configuration.
 | 
						|
        return;
 | 
						|
    }
 | 
						|
#endif
 | 
						|
 | 
						|
    i2s_hal_format_config(hal, i2s_config);
 | 
						|
}
 | 
						|
 | 
						|
void i2s_hal_enable_master_mode(i2s_hal_context_t *hal)
 | 
						|
{
 | 
						|
    i2s_ll_set_tx_slave_mod(hal->dev, 0); //MASTER Slave
 | 
						|
    i2s_ll_set_rx_slave_mod(hal->dev, 1); //RX Slave
 | 
						|
}
 | 
						|
 | 
						|
void i2s_hal_enable_slave_mode(i2s_hal_context_t *hal)
 | 
						|
{
 | 
						|
    i2s_ll_set_tx_slave_mod(hal->dev, 1); //TX Slave
 | 
						|
    i2s_ll_set_rx_slave_mod(hal->dev, 1); //RX Slave
 | 
						|
}
 | 
						|
 | 
						|
void i2s_hal_init(i2s_hal_context_t *hal, int i2s_num)
 | 
						|
{
 | 
						|
    //Get hardware instance.
 | 
						|
    hal->dev = I2S_LL_GET_HW(i2s_num);
 | 
						|
}
 |