75x_ssp.c

FreeRTOS is a portable, open source, mini Real Time Kernel - a free to download and royalty free RTO

* Description    : Configures the SSP0 DMA interface.
* Input          : - SSP0_DMAtransfer : specifies the DMA transfer to be 
*                    enabled or disabled. This parameter can be one of the
*                    following values:
*                         - SSP0_DMA_Transmit: transmit Fifo DMA transfer
*                         - SSP0_DMA_Receive: receive Fifo DMA transfer 
*                  - NewState: new state of SSP0 DMA transfer.
*                    This parameter can be: ENABLE or DISABLE.
* Output         : None
* Return         : None
*******************************************************************************/
void SSP_DMACmd(u16 SSP0_DMAtransfer, FunctionalState NewState)
{
  if(NewState == ENABLE) 
  {
    if(SSP0_DMAtransfer == SSP0_DMA_Transmit) 
    {
      /* Enable DMA for the transmit FIFO */
      SSP0->DMACR |= SSP0_DMA_TransmitEnable;
    }
    else 
    {
      /* Enable DMA for the receive FIFO */
      SSP0->DMACR |= SSP0_DMA_ReceiveEnable;
    }
  }
  else 
  {
    if(SSP0_DMAtransfer == SSP0_DMA_Transmit) 
    {
      /* Disable DMA for the transmit FIFO */
      SSP0->DMACR &= SSP0_DMA_TransmitDisable;
    }
    else 
    {
      /* Disable DMA for the receive FIFO */
      SSP0->DMACR &= SSP0_DMA_ReceiveDisable;
    }
  }
}

/*******************************************************************************
* Function Name  : SSP_DMATxConfig
* Description    : Configures the SSP0 DMA transmit transfer.
* Input          : - SSP0_DMATxReq : specifies the SSP0 DMA transmit request to  
*                    be enabled. This parameter can be one of the following
*                    values:
*                         - SSP0_DMATxReq_Single: Transmit FIFO DMA single 
*                           request enabled
*                         - SSP0_DMATxReq_Burst: Transmit FIFO DMA burst request
*                           enabled
* Output         : None
* Return         : None
*******************************************************************************/
void SSP_DMATxConfig(u16 SSP0_DMATxReq)
{
  if(SSP0_DMATxReq == SSP0_DMATxReq_Burst) 
  {
    /* Enable DMA transmit burst request */
    SSP0->DMACR |= SSP0_DMATxReq_Burst;
  }
  else   
  {
    /* Enable DMA transmit single request */
    SSP0->DMACR &= SSP0_DMATxReq_Single;
  }
}

/*******************************************************************************
* Function Name  : SSP_DMARxConfig
* Description    : Configures the SSP0 DMA receive transfer.
* Input          : - SSP0_DMARxReq : specifies the SSP0 DMA receive request to  
*                    be enabled. This parameter can be one of the following
*                    values:
*                         - SSP0_DMARxReq_Single: Receive FIFO DMA burst request
*                           enabled
*                         - SSP0_DMARxReq_Burst: Receive FIFO DMA single request
*                          enabled
* Output         : None
* Return         : None
*******************************************************************************/
void SSP_DMARxConfig(u16 SSP0_DMARxReq)
{
  if(SSP0_DMARxReq == SSP0_DMARxReq_Burst) 
  {
    /* Enable DMA receive burst request */
    SSP0->DMACR |= SSP0_DMARxReq_Burst;
  }
  else   
  {
    /* Enable DMA receive single request */
    SSP0->DMACR &= SSP0_DMARxReq_Single;
  }  
}

/*******************************************************************************
* Function Name  : SSP_SendData
* Description    : Transmits a Data through the SSP peripheral.
* Input          : - SSPx: where x can be 0 or 1 to select the SSP peripheral.
*                  - Data : Data to be transmitted.
* Output         : None
* Return         : None
*******************************************************************************/
void SSP_SendData(SSP_TypeDef* SSPx, u16 Data)
{
  /* Write in the DR register the data to be sent */
  SSPx->DR = Data;
}

/*******************************************************************************
* Function Name  : SSP_ReceiveData
* Description    : Returns the most recent received data by the SSP peripheral.
* Input          : SSPx: where x can be 0 or 1 to select the SSP peripheral.
* Output         : None
* Return         : The value of the received data.
*******************************************************************************/
u16 SSP_ReceiveData(SSP_TypeDef* SSPx)
{
  /* Return the data in the DR register */	
  return SSPx->DR;
}

/*******************************************************************************
* Function Name  : SSP_LoopBackConfig
* Description    : Enables or disables the Loop back mode for the selected SSP
*                  peripheral.
* Input          : - SSPx: where x can be 0 or 1 to select the SSP peripheral.
*                  - NewState: new state of the Loop Back mode.
*                    This parameter can be: ENABLE or DISABLE.
* Output         : None
* Return         : None
*******************************************************************************/
void SSP_LoopBackConfig(SSP_TypeDef* SSPx, FunctionalState NewState)
{
  if(NewState == ENABLE)
  {
    /* Enable loop back mode */
    SSPx->CR1 |= SSP_LoopBackMode_Enable;
  }
  else
  {
    /* Disable loop back mode */
    SSPx->CR1 &= SSP_LoopBackMode_Disable;
  }
}

/*******************************************************************************
* Function Name  : SSP_NSSInternalConfig
* Description    : Configures by software the NSS pin.
* Input          : - SSPx: where x can be 0 or 1 to select the SSP peripheral.
*                  - SSP_NSSState: NSS internal state.This parameter can be one
*                    of the following values:
*                         - SSP_NSSInternal_Set: Set NSS pin internally
*                         - SSP_NSSInternal_Reset: Reset NSS pin internally
* Output         : None
* Return         : None
*******************************************************************************/
void SSP_NSSInternalConfig(SSP_TypeDef* SSPx, u16 SSP_NSSState)
{
  if(SSP_NSSState == SSP_NSSInternal_Set)
  {
    /* Set NSS pin internally */
    SSPx->CR1 |= SSP_NSSInternal_Set;
  }
  else
  {
    /* Reset NSS pin internally */
    SSPx->CR1 &= SSP_NSSInternal_Reset;
  }
}

/*******************************************************************************
* Function Name  : SSP_GetFlagStatus
* Description    : Checks whether the specified SSP flag is set or not.
* Input          : - SSPx: where x can be 0 or 1 to select the SSP peripheral.
*                  - SSP_FLAG: specifies the flag to check.  This parameter can 
*                    be one of the following values:
*                         - SSP_FLAG_Busy: busy flag
*                         - SSP_FLAG_RxFifoFull: Receive FIFO full flag
*                         - SSP_FLAG_RxFifoNotEmpty: Receive FIFO not empty flag 
*                         - SSP_FLAG_TxFifoNotFull: Transmit FIFO not full flag 
*                         - SSP_FLAG_TxFifoEmpty: Transmit FIFO empty flag 
*                         - SSP_FLAG_TxFifo: Transmit FIFO half empty or less flag
*                         - SSP_FLAG_RxFifo: Receive FIFO half full or less flag
*                         - SSP_FLAG_RxTimeOut: Receive timeout flag
*                         - SSP_FLAG_RxOverrun: Receive overrun flag
* Output         : None
* Return         : The new state of SSP_FLAG(SET or RESET).
*******************************************************************************/
FlagStatus SSP_GetFlagStatus(SSP_TypeDef* SSPx, u16 SSP_FLAG)
{
  u32 SSPReg = 0, FlagPos = 0;
  u32 StatusReg = 0;

  /* Get the SSP register index */
  SSPReg = SSP_FLAG >> 5;

  /* Get the flag position */
  FlagPos = SSP_FLAG & SSP_Flag_Mask;

  /* Find the register of the flag to check */
  if(SSPReg == 1) 
  {
    /* The flag to check is in SR register */
    StatusReg = SSPx->SR;  	
  }
  else if (SSPReg == 2) 
  {
    /* The flag to check is in RISR register */
    StatusReg = SSPx->RISR;
  }
  
  /* Check the status of the specified SSP flag */
  if((StatusReg & (1 << FlagPos)) != RESET)
  {
    /* Return SET if the SSP flag is set */
    return SET;
  }
  else
  {
    /* Return RESET if the SSP flag is reset */
    return RESET;
  }
}

/*******************************************************************************
* Function Name  : SSP_ClearFlag
* Description    : Clears the SSPx抯 pending flags.
* Input          : - SSPx: where x can be 0 or 1 to select the SSP peripheral.
*                  - SSP_FLAG: specifies the flag to clear.  This parameter can  
*                    be one of the following values:
*                         - SSP_FLAG_RxTimeOut: Receive timeout flag 
*                         - SSP_FLAG_RxOverrun: Receive overrun flag 
* Output         : None
* Return         : None
*******************************************************************************/
void SSP_ClearFlag(SSP_TypeDef* SSPx, u16 SSP_FLAG)
{ 
  u8 FlagPos = 0;

  /* Get the flag position */
  FlagPos = SSP_FLAG & SSP_Flag_Mask;
  
  /* Clear the selected SSP flag */  
  SSPx->ICR = (1 << FlagPos);  
}

/*******************************************************************************
* Function Name  : SSP_GetITStatus
* Description    : Checks whether the specified SSP interrupt has occurred or not.
* Input          : - SSPx: where x can be 0 or 1 to select the SSP peripheral.
*                  - SSP_IT: specifies the interrupt source to check.   
*                    This parameter can be one of the following values:
*                         - SSP_IT_TxFifo: Transmit FIFO half empty or less interrupt 
*                         - SSP_IT_RxFifo: Receive FIFO half full or less interrupt 
*                         - SSP_IT_RxTimeOut: Receive timeout interrupt 
*                         - SSP_IT_RxOverrun: Receive overrun interrupt 
* Output         : None
* Return         : The new state of SSP_IT(SET or RESET).
*******************************************************************************/
ITStatus SSP_GetITStatus(SSP_TypeDef* SSPx, u16 SSP_IT)
{
  /* Check the status of the specified interrupt flag */
  if((SSPx->MISR & SSP_IT) != RESET)
  {
    /* Return SET if the SSP interrupt flag is set */
    return SET;
  }
  else
  {
    /* Return RESET if SSP interrupt flag is reset */
    return RESET;
  }
}

/*******************************************************************************
* Function Name  : SSP_ClearITPendingBit
* Description    : Clears the SSPx抯 interrupt pending bits.
* Input          : - SSPx: where x can be 0 or 1 to select the SSP peripheral.
*                  - SSP_IT: specifies the interrupt pending bit to clear.  
*                    This parameter can be any combination of the following values:
*                         - SSP_IT_RxTimeOut: Receive timeout interrupt 
*                         - SSP_IT_RxOverrun: Receive overrun interrupt 
* Output         : None
* Return         : None
*******************************************************************************/
void SSP_ClearITPendingBit(SSP_TypeDef* SSPx, u16 SSP_IT)
{
  /* Clear the selected SSP interrupts pending bits */
  SSPx->ICR = SSP_IT;
}

/******************* (C) COPYRIGHT 2006 STMicroelectronics *****END OF FILE****/