libs/rt-thread-official
libs
/
rt-thread-official
mirror of https://github.com/RT-Thread/rt-thread.git
4
0
Fork 0
Code Issues Releases Wiki Activity
rt-thread-official/bsp/acm32f4xx-nucleo/libraries/HAL_Driver/Src/HAL_I2S.c

492 lines
15 KiB
C
Raw Normal View History

ACM32F4XX bsp add
2021-09-22 17:14:47 +08:00
/*
******************************************************************************
* @file HAL_I2S.c
* @version V1.0.0
* @date 2020
* @brief I2S HAL module driver.
* This file provides firmware functions to manage the following
* functionalities of the Integrated Interchip Sound (I2S) peripheral:
* + Initialization functions
* + IO operation functions
* + Peripheral State
******************************************************************************
*/
#include "ACM32Fxx_HAL.h"
/*********************************************************************************
* Function : HAL_I2S_IRQHandler
* Description : This function handles I2S interrupt request.
* Input :
* Outpu :
* Author : Chris_Kyle Data : 2020<EFBFBD><EFBFBD>
**********************************************************************************/
void HAL_I2S_IRQHandler(I2S_HandleTypeDef *hi2s)
{
/* Tx Buffer empty */
if (hi2s->Instance->STATUS & I2S_STATUS_TXBE)
{
if (hi2s->u32_Tx_Count < hi2s->u32_Tx_Size)
{
hi2s->Instance->DAT = hi2s->u32_Tx_Buffer[hi2s->u32_Tx_Count++];
}
else
{
hi2s->Instance->IE &= ~I2S_DIE_TBEIE;
hi2s->I2S_Status = HAL_I2S_STATE_READY;
}
}
/* Rx Buffer not empty */
if (hi2s->Instance->STATUS & I2S_STATUS_RXBNE)
{
if (hi2s->u32_Rx_Count < hi2s->u32_Rx_Size)
{
hi2s->u32_Tx_Buffer[hi2s->u32_Rx_Count++] = hi2s->Instance->DAT;
}
else
{
/* Disable I2S */
hi2s->Instance->CTL &= ~I2S_CTL_I2SEN;
hi2s->Instance->IE &= ~I2S_DIE_RBNEIE;
hi2s->I2S_Status = HAL_I2S_STATE_READY;
}
}
}
/*********************************************************************************
* Function : HAL_I2S_MspInit
* Description :
* Input :
* Outpu :
* Author : Chris_Kyle Data : 2020<EFBFBD><EFBFBD>
**********************************************************************************/
__weak void HAL_I2S_MspInit(I2S_HandleTypeDef *hi2s)
{
/*
NOTE : This function should be modified by the user.
*/
/* For Example */
GPIO_InitTypeDef GPIO_Handle;
if (hi2s->Instance == I2S1)
{
/* Enable Clock */
System_Module_Enable(EN_I2S1);
System_Module_Enable(EN_GPIOAB);
/* I2S1 WS PortA Pin4 */
/* I2S1 CLK PortA Pin5 */
/* I2S1 MCK PortA Pin6 */
/* I2S1 SD PortA Pin7 */
GPIO_Handle.Pin = GPIO_PIN_4 | GPIO_PIN_5 | GPIO_PIN_6 | GPIO_PIN_7;
GPIO_Handle.Mode = GPIO_MODE_AF_PP;
GPIO_Handle.Pull = GPIO_PULLUP;
GPIO_Handle.Alternate = GPIO_FUNCTION_8;
HAL_GPIO_Init(GPIOA, &GPIO_Handle);
/* Clear Pending Interrupt */
NVIC_ClearPendingIRQ(I2S_IRQn);
/* Enable External Interrupt */
NVIC_EnableIRQ(I2S_IRQn);
}
}
/*********************************************************************************
* Function : HAL_I2S_MspDeInit
* Description :
* Input :
* Outpu :
* Author : Chris_Kyle Data : 2020<EFBFBD><EFBFBD>
**********************************************************************************/
__weak void HAL_I2S_MspDeInit(I2S_HandleTypeDef *hi2s)
{
/*
NOTE : This function should be modified by the user.
*/
/* For Example */
if (hi2s->Instance == I2S1)
{
/* I2S1 WS PortA Pin4 */
/* I2S1 CLK PortA Pin5 */
/* I2S1 MCK PortA Pin6 */
/* I2S1 SD PortA Pin7 */
HAL_GPIO_DeInit(GPIOA, GPIO_PIN_4 | GPIO_PIN_5 | GPIO_PIN_6 | GPIO_PIN_7);
/* Clear Pending Interrupt */
NVIC_ClearPendingIRQ(I2S_IRQn);
/* Disable External Interrupt */
NVIC_DisableIRQ(I2S_IRQn);
}
}
/*********************************************************************************
* Function : HAL_I2S_Init
* Description : Initializes the I2S according to the specified parameters
* in the I2S_InitTypeDef and create the associated handle.
* Input : hi2s: pointer to a I2S_HandleTypeDef structure that contains
* the configuration information for I2S module
* Outpu :
* Author : Chris_Kyle Data : 2020<EFBFBD><EFBFBD>
**********************************************************************************/
HAL_StatusTypeDef HAL_I2S_Init(I2S_HandleTypeDef *hi2s)
{
#if (USE_FULL_ASSERT == 1)
/* Check I2S Parameter */
if (!IS_I2S_MODE(hi2s->Init.u32_Mode)) return HAL_ERROR;
if (!IS_I2S_STANDARD(hi2s->Init.u32_Standard)) return HAL_ERROR;
if (!IS_I2S_DATAFORMAT(hi2s->Init.u32_DataFormat)) return HAL_ERROR;
if (!IS_I2S_MCLK_OUTPUT(hi2s->Init.u32_MCLKOutput)) return HAL_ERROR;
if (!IS_I2S_MCLK_CPOL(hi2s->Init.u32_CPOL)) return HAL_ERROR;
if (!IS_I2S_OF(hi2s->Init.u32_FreqOF)) return HAL_ERROR;
if (!IS_I2S_DIV(hi2s->Init.u32_FreqDIV)) return HAL_ERROR;
#endif
/* Init the low level hardware : GPIO, CLOCK, CORTEX...etc */
HAL_I2S_MspInit(hi2s);
/* Clear Config */
hi2s->Instance->CTL = 0x00000000;
hi2s->Instance->PSC = 0x00000000;
/* Mode<64><65>Standard<72><64>CPOL<4F><4C>Dataformat */
hi2s->Instance->CTL = hi2s->Init.u32_Mode | hi2s->Init.u32_Standard | hi2s->Init.u32_CPOL | hi2s->Init.u32_DataFormat;
/* Frequency */
hi2s->Instance->PSC = hi2s->Init.u32_MCLKOutput | hi2s->Init.u32_FreqOF | hi2s->Init.u32_FreqDIV;
/* I2S Enable */
if (hi2s->Init.u32_Mode != I2S_MODE_MASTER_RX)
{
hi2s->Instance->CTL |= I2S_CTL_I2SEN;
}
/* I2S Status ready */
hi2s->I2S_Status = HAL_I2S_STATE_READY;
return HAL_OK;
}
/*********************************************************************************
* Function : HAL_I2S_DeInit
* Description : DeInitializes the I2S peripheral
* Input : hi2s: pointer to a I2S_HandleTypeDef structure that contains
* the configuration information for I2S module
* Outpu :
* Author : Chris_Kyle Data : 2020<EFBFBD><EFBFBD>
**********************************************************************************/
HAL_StatusTypeDef HAL_I2S_DeInit(I2S_HandleTypeDef *hi2s)
{
/* Check the I2S handle allocation */
if (hi2s == NULL)
{
return HAL_ERROR;
}
/* DeInit the low level hardware: GPIO, CLOCK, NVIC... */
HAL_I2S_MspDeInit(hi2s);
System_Module_Reset(RST_I2S1);
return HAL_OK;
}
/*********************************************************************************
* Function : HAL_I2S_Transmit
* Description : Transmit an amount of data in blocking mode
* Input : hi2s: pointer to a I2S_HandleTypeDef structure that contains
* the configuration information for I2S module
* Input : fp32_Data: 32-bit pointer to data buffer.
* Input : Size: number of data sample to be sent
* Input : fu32_Timeout: Timeout duration
* Outpu :
* Author : Chris_Kyle Data : 2020<EFBFBD><EFBFBD>
**********************************************************************************/
HAL_StatusTypeDef HAL_I2S_Transmit(I2S_HandleTypeDef *hi2s, uint32_t *fp32_Data, uint32_t fu32_Size, uint32_t fu32_Timeout)
{
uint32_t i;
uint32_t lu32_Timeout;
/* Parameter Check */
if ((fp32_Data == NULL) || (fu32_Size == 0U))
{
return HAL_ERROR;
}
/* I2S Ready? */
if (hi2s->I2S_Status != HAL_I2S_STATE_READY)
{
return HAL_BUSY;
}
hi2s->I2S_Status = HAL_I2S_STATE_BUSY_TX;
/* transmit */
for (i = 0; i < fu32_Size; i++)
{
hi2s->Instance->DAT = fp32_Data[i];
/* have no timeout */
if (fu32_Timeout == 0)
{
while(!(hi2s->Instance->STATUS & I2S_STATUS_TXBE));
}
else
{
lu32_Timeout = fu32_Timeout * 0xFF;
while(!(hi2s->Instance->STATUS & I2S_STATUS_TXBE))
{
if (lu32_Timeout-- == 0)
{
hi2s->I2S_Status = HAL_I2S_STATE_READY;
return HAL_TIMEOUT;
}
}
}
}
/* Wait for the last Byte */
while (hi2s->Instance->STATUS & I2S_STATUS_TRANS);
hi2s->I2S_Status = HAL_I2S_STATE_READY;
return HAL_OK;
}
/*********************************************************************************
* Function : HAL_I2S_Receive
* Description : Receive an amount of data in blocking mode
* Input : hi2s pointer to a I2S_HandleTypeDef structure that contains
* the configuration information for I2S module
* Input : fp32_Data: a 32-bit pointer to data buffer.
* Input : Size: number of data sample to be Receive
* Input : fu32_Timeout: Timeout duration
* Outpu :
* Author : Chris_Kyle Data : 2020<EFBFBD><EFBFBD>
**********************************************************************************/
HAL_StatusTypeDef HAL_I2S_Receive(I2S_HandleTypeDef *hi2s, uint32_t *fp32_Data, uint32_t fu32_Size, uint32_t fu32_Timeout)
{
uint32_t i;
uint32_t lu32_Timeout;
/* Parameter Check */
if ((fp32_Data == NULL) || (fu32_Size == 0U))
{
return HAL_ERROR;
}
/* I2S Ready? */
if (hi2s->I2S_Status != HAL_I2S_STATE_READY)
{
return HAL_BUSY;
}
hi2s->I2S_Status = HAL_I2S_STATE_BUSY_RX;
/* I2S Enable */
hi2s->Instance->CTL |= I2S_CTL_I2SEN;
/* Receive */
for (i = 0; i < fu32_Size; i++)
{
/* have no timeout */
if (fu32_Timeout == 0)
{
while(!(hi2s->Instance->STATUS & I2S_STATUS_RXBNE));
fp32_Data[i] = hi2s->Instance->DAT;
}
else
{
lu32_Timeout = fu32_Timeout * 0xFF;
while(!(hi2s->Instance->STATUS & I2S_STATUS_RXBNE))
{
if (lu32_Timeout-- == 0)
{
hi2s->I2S_Status = HAL_I2S_STATE_READY;
return HAL_TIMEOUT;
}
}
fp32_Data[i] = hi2s->Instance->DAT;
}
}
/* Disable I2S */
hi2s->Instance->CTL &= ~I2S_CTL_I2SEN;
hi2s->I2S_Status = HAL_I2S_STATE_READY;
return HAL_OK;
}
/*********************************************************************************
* Function : HAL_I2S_Transmit_IT
* Description : Transmit an amount of data in non-blocking mode with Interrupt
* Input : hi2s pointer to a I2S_HandleTypeDef structure that contains
* the configuration information for I2S module
* Input : fp32_Data: a 32-bit pointer to data buffer.
* Input : Size: number of data sample to be send
* Outpu :
* Author : Chris_Kyle Data : 2020<EFBFBD><EFBFBD>
**********************************************************************************/
HAL_StatusTypeDef HAL_I2S_Transmit_IT(I2S_HandleTypeDef *hi2s, uint32_t *fp32_Data, uint32_t fu32_Size)
{
/* Parameter Check */
if ((fp32_Data == NULL) || (fu32_Size == 0U))
{
return HAL_ERROR;
}
/* I2S Ready? */
if (hi2s->I2S_Status != HAL_I2S_STATE_READY)
{
return HAL_BUSY;
}
hi2s->I2S_Status = HAL_I2S_STATE_BUSY_TX;
hi2s->u32_Tx_Buffer = fp32_Data;
hi2s->u32_Tx_Size = fu32_Size;
hi2s->u32_Tx_Count = 0;
hi2s->Instance->IE |= I2S_DIE_TBEIE;
return HAL_OK;
}
/*********************************************************************************
* Function : HAL_I2S_Receive_IT
* Description : Receive an amount of data in non-blocking mode with Interrupt
* Input : hi2s pointer to a I2S_HandleTypeDef structure that contains
* the configuration information for I2S module
* Input : fp32_Data: a 32-bit pointer to data buffer.
* Input : Size: number of data sample to be Receive
* Outpu :
* Author : Chris_Kyle Data : 2020<EFBFBD><EFBFBD>
**********************************************************************************/
HAL_StatusTypeDef HAL_I2S_Receive_IT(I2S_HandleTypeDef *hi2s, uint32_t *fp32_Data, uint32_t fu32_Size)
{
uint32_t lu32_Tempvalue;
/* Parameter Check */
if ((fp32_Data == NULL) || (fu32_Size == 0U))
{
return HAL_ERROR;
}
/* I2S Ready? */
if (hi2s->I2S_Status != HAL_I2S_STATE_READY)
{
return HAL_BUSY;
}
/* Clear Rx Buffer */
while (hi2s->Instance->STATUS & I2S_STATUS_RXBNE)
{
lu32_Tempvalue = hi2s->Instance->DAT;
}
hi2s->I2S_Status = HAL_I2S_STATE_BUSY_RX;
hi2s->u32_Rx_Buffer = fp32_Data;
hi2s->u32_Rx_Size = fu32_Size;
hi2s->u32_Rx_Count = 0;
hi2s->Instance->IE |= I2S_DIE_RBNEIE;
/* I2S Enable */
hi2s->Instance->CTL |= I2S_CTL_I2SEN;
return HAL_OK;
}
/*********************************************************************************
* Function : HAL_I2S_Transmit_DMA
* Description : Transmit an amount of data in non-blocking mode with DMA
* Input : hi2s: pointer to a I2S_HandleTypeDef structure that contains
* the configuration information for I2S module
* Input : fp32_Data: 32-bit pointer to data buffer.
* Input : Size: number of data sample to be sent
* Outpu :
* Author : Chris_Kyle Data : 2020<EFBFBD><EFBFBD>
**********************************************************************************/
HAL_StatusTypeDef HAL_I2S_Transmit_DMA(I2S_HandleTypeDef *hi2s, uint32_t *fp32_Data, uint32_t fu32_Size)
{
/* Parameter Check */
if ((fp32_Data == NULL) || (fu32_Size == 0U))
{
return HAL_ERROR;
}
/* DMA transfer complete */
if (!(hi2s->I2S_Status & I2S_STATUS_TRANS))
{
hi2s->I2S_Status = HAL_I2S_STATE_READY;
}
/* I2S Ready? */
if (hi2s->I2S_Status != HAL_I2S_STATE_READY)
{
return HAL_BUSY;
}
hi2s->I2S_Status = HAL_I2S_STATE_BUSY_TX;
hi2s->Instance->IE |= I2S_DIE_DMATEN;
HAL_DMA_Start_IT(hi2s->HDMA_Tx, (uint32_t)fp32_Data, (uint32_t)&hi2s->Instance->DAT, fu32_Size);
return HAL_OK;
}
/*********************************************************************************
* Function : HAL_I2S_Receive_DMA
* Description : Receive an amount of data in non-blocking mode with DMA
* Input : hi2s pointer to a I2S_HandleTypeDef structure that contains
* the configuration information for I2S module
* Input : fp32_Data: a 32-bit pointer to data buffer.
* Input : Size: number of data sample to be Receive
* Outpu :
* Author : Chris_Kyle Data : 2020<EFBFBD><EFBFBD>
**********************************************************************************/
HAL_StatusTypeDef HAL_I2S_Receive_DMA(I2S_HandleTypeDef *hi2s, uint32_t *fp32_Data, uint32_t fu32_Size)
{
/* Parameter Check */
if ((fp32_Data == NULL) || (fu32_Size == 0U))
{
return HAL_ERROR;
}
/* DMA transfer complete */
if (!(hi2s->I2S_Status & I2S_STATUS_TRANS))
{
hi2s->I2S_Status = HAL_I2S_STATE_READY;
}
/* I2S Ready? */
if (hi2s->I2S_Status != HAL_I2S_STATE_READY)
{
return HAL_BUSY;
}
hi2s->I2S_Status = HAL_I2S_STATE_BUSY_RX;
hi2s->Instance->IE |= I2S_DIE_DMATEN;
HAL_DMA_Start_IT(hi2s->HDMA_Rx, (uint32_t)&hi2s->Instance->DAT, (uint32_t)fp32_Data, fu32_Size);
return HAL_OK;
}