URL
https://opencores.org/ocsvn/openrisc/openrisc/trunk
Subversion Repositories openrisc
[/] [openrisc/] [trunk/] [rtos/] [freertos-6.1.1/] [Demo/] [ARM7_STR75x_IAR/] [STLibrary/] [src/] [75x_ssp.c] - Rev 592
Go to most recent revision | Compare with Previous | Blame | View Log
/******************** (C) COPYRIGHT 2006 STMicroelectronics ******************** * File Name : 75x_ssp.c * Author : MCD Application Team * Date First Issued : 03/10/2006 * Description : This file provides all the SSP software functions. ******************************************************************************** * History: * 07/17/2006 : V1.0 * 03/10/2006 : V0.1 ******************************************************************************** * THE PRESENT SOFTWARE WHICH IS FOR GUIDANCE ONLY AIMS AT PROVIDING CUSTOMERS * WITH CODING INFORMATION REGARDING THEIR PRODUCTS IN ORDER FOR THEM TO SAVE TIME. * AS A RESULT, STMICROELECTRONICS SHALL NOT BE HELD LIABLE FOR ANY DIRECT, * INDIRECT OR CONSEQUENTIAL DAMAGES WITH RESPECT TO ANY CLAIMS ARISING FROM THE * CONTENT OF SUCH SOFTWARE AND/OR THE USE MADE BY CUSTOMERS OF THE CODING * INFORMATION CONTAINED HEREIN IN CONNECTION WITH THEIR PRODUCTS. *******************************************************************************/ /* Includes ------------------------------------------------------------------*/ #include "75x_ssp.h" #include "75x_mrcc.h" /* Private typedef -----------------------------------------------------------*/ /* Private define ------------------------------------------------------------*/ /* Private macro -------------------------------------------------------------*/ /* Private variables ---------------------------------------------------------*/ /* SSP peripheral Enable */ #define SSP_Enable 0x0002 #define SSP_Disable 0xFFFD /* SSP Loop Back Mode Enable */ #define SSP_LoopBackMode_Enable 0x0001 #define SSP_LoopBackMode_Disable 0xFFFE /* SSP Flag Mask */ #define SSP_Flag_Mask 0x001F /* SSP DMA transmit/ receive enable/disable Masks */ #define SSP0_DMA_TransmitEnable 0x0002 #define SSP0_DMA_TransmitDisable 0xFFFD #define SSP0_DMA_ReceiveEnable 0x0001 #define SSP0_DMA_ReceiveDisable 0xFFFE /* SSP Masks */ #define SSP_FrameFormat_Mask 0xFFCF #define SSP_DataSize_Mask 0xFFF0 #define SSP_ClockRate_Mask 0x00FF #define SSP_ClockPrescaler_Mask 0xFF00 #define SSP_SSI_Set_Mask 0x0020 #define SSP_SSI_Reset_Mask 0xFFDF /* Private function prototypes -----------------------------------------------*/ /* Private functions ---------------------------------------------------------*/ /******************************************************************************* * Function Name : SSP_DeInit * Description : Deinitializes the SSPx peripheral registers to their default * reset values. * Input : SSPx: where x can be 0 or 1 to select the SSP peripheral. * Output : None * Return : None *******************************************************************************/ void SSP_DeInit(SSP_TypeDef* SSPx) { if(SSPx == SSP0) { /* Reset the SSP0 registers values*/ MRCC_PeripheralSWResetConfig(MRCC_Peripheral_SSP0,ENABLE); MRCC_PeripheralSWResetConfig(MRCC_Peripheral_SSP0,DISABLE); } else if (SSPx == SSP1) { /* Reset the SSP1 registers values*/ MRCC_PeripheralSWResetConfig(MRCC_Peripheral_SSP1,ENABLE); MRCC_PeripheralSWResetConfig(MRCC_Peripheral_SSP1,DISABLE); } } /******************************************************************************* * Function Name : SSP_Init * Description : Initializes the SSPx peripheral according to the specified * parameters in the SSP_InitTypeDef structure. * Input : - SSPx: where x can be 0 or 1 to select the SSP peripheral. * - SSP_InitStruct: pointer to a SSP_InitTypeDef structure that * contains the configuration information for the specified SSP * peripheral. * Output : None * Return : None *******************************************************************************/ void SSP_Init(SSP_TypeDef* SSPx, SSP_InitTypeDef* SSP_InitStruct) { /* Configure the Frame format */ if(SSP_InitStruct->SSP_FrameFormat == SSP_FrameFormat_TI) { /* Clear the FRF[1:0] bits */ SSPx->CR0 &= SSP_FrameFormat_Mask; /* Set the TI frame format */ SSPx->CR0 |= SSP_FrameFormat_TI; } else { /* Set the Motorola frame format */ SSPx->CR0 &= SSP_FrameFormat_Motorola; /* Configure the Clock polarity */ if(SSP_InitStruct->SSP_CPOL == SSP_CPOL_High) { /* SCK is held high when no data is being transfered */ SSPx->CR0 |= SSP_CPOL_High; } else { /* SCK is held low when no data is being transfered */ SSPx->CR0 &= SSP_CPOL_Low; } /* Configure the Clock Phase */ if(SSP_InitStruct->SSP_CPHA == SSP_CPHA_2Edge) { /* Data captured on second clock edge */ SSPx->CR0 |= SSP_CPHA_2Edge; } else { /* Data captured on first clock edge */ SSPx->CR0 &= SSP_CPHA_1Edge; } } /* Configure the Mode */ if(SSP_InitStruct->SSP_Mode == SSP_Mode_Slave) { /* Set the slave mode */ SSPx->CR1 |= SSP_Mode_Slave; /* Configure the Slave output */ if(SSP_InitStruct->SSP_SlaveOutput == SSP_SlaveOutput_Disable) { /* Slave output disabled */ SSPx->CR1 |= SSP_SlaveOutput_Disable; } else { /* Slave output enabled */ SSPx->CR1 &= SSP_SlaveOutput_Enable; } /* Configure the NSS pin */ if(SSP_InitStruct->SSP_NSS == SSP_NSS_Soft) { /* Slave selected by software through SSI bit */ SSPx->CR1 |= SSP_NSS_Soft; SSPx->CR1 &= SSP_SSI_Reset_Mask; } else { /* Slave selected by hardware through external SSpin */ SSPx->CR1 &= SSP_NSS_Hard; } /* Configure the Clock rate and prescaler in TI slave mode */ if(SSP_InitStruct->SSP_FrameFormat == SSP_FrameFormat_TI) { /* Clear clock rate SCR[7:0] bits */ SSPx->CR0 &= SSP_ClockRate_Mask; /* Set the serial clock rate */ SSPx->CR0 |= (SSP_InitStruct->SSP_ClockRate<<8); /* Clear clock prescaler CPSDVSR[7:0] bits */ SSPx->PR &= SSP_ClockPrescaler_Mask; /* Set the serial clock prescaler */ SSPx->PR |= SSP_InitStruct->SSP_ClockPrescaler; } } else { /* Set the master mode */ SSPx->CR1 &= SSP_Mode_Master; /* Configure the NSS pin */ if(SSP_InitStruct->SSP_NSS == SSP_NSS_Soft) { /* Master selected by software through SSI bit */ SSPx->CR1 |= SSP_NSS_Soft; SSPx->CR1 |= SSP_SSI_Set_Mask; } else { /* Master selected by hardware through external SSpin */ SSPx->CR1 &= SSP_NSS_Hard; } /* Clear clock rate SCR[7:0] bits */ SSPx->CR0 &= SSP_ClockRate_Mask; /* Set the serial clock rate */ SSPx->CR0 |= (SSP_InitStruct->SSP_ClockRate<<8); /* Clear clock prescaler CPSDVSR[7:0] bits */ SSPx->PR &= SSP_ClockPrescaler_Mask; /* Set the serial clock prescaler */ SSPx->PR |= SSP_InitStruct->SSP_ClockPrescaler; } /* Clear data size DSS[3:0] bits */ SSPx->CR0 &= SSP_DataSize_Mask; /* Set the data size */ SSPx->CR0 |= SSP_InitStruct->SSP_DataSize; } /******************************************************************************* * Function Name : SSP_StructInit * Description : Fills each SSP_InitStruct member with its default value. * Input : SSP_InitStruct : pointer to a SSP_InitTypeDef structure which will be initialized. * Output : None * Return : None *******************************************************************************/ void SSP_StructInit(SSP_InitTypeDef* SSP_InitStruct) { /* Initialize the SSP_FrameFormat member */ SSP_InitStruct->SSP_FrameFormat = SSP_FrameFormat_Motorola; /* Initialize the SSP_Mode member */ SSP_InitStruct->SSP_Mode = SSP_Mode_Master; /* Initialize the SSP_CPOL member */ SSP_InitStruct->SSP_CPOL = SSP_CPOL_Low; /* Initialize the SSP_CPHA member */ SSP_InitStruct->SSP_CPHA = SSP_CPHA_1Edge; /* Initialize the SSP_DataSize member */ SSP_InitStruct->SSP_DataSize = SSP_DataSize_8b; /* Initialize the SSP_NSS member */ SSP_InitStruct->SSP_NSS = SSP_NSS_Hard; /* Initialize the SSP_SlaveOutput member */ SSP_InitStruct->SSP_SlaveOutput = SSP_SlaveOutput_Enable; /* Initialize the SSP_ClockRate member */ SSP_InitStruct->SSP_ClockRate = 0; /* Initialize the SSP_ClockPrescaler member */ SSP_InitStruct->SSP_ClockPrescaler = 0; } /******************************************************************************* * Function Name : SSP_Cmd * Description : Enables or disables the specified SSP peripheral. * Input : - SSPx: where x can be 0 or 1 to select the SSP peripheral. * - NewState: new state of the SSPx peripheral. * This parameter can be: ENABLE or DISABLE. * Output : None * Return : None *******************************************************************************/ void SSP_Cmd(SSP_TypeDef* SSPx, FunctionalState NewState) { if(NewState == ENABLE) { /* Enable the SSP peripheral */ SSPx->CR1 |= SSP_Enable; } else { /* Disable the SSP peripheral */ SSPx->CR1 &= SSP_Disable; } } /******************************************************************************* * Function Name : SSP_ITConfig * Description : Enables or disables the specified SSP interrupts. * Input : - SSPx: where x can be 0 or 1 to select the SSP peripheral. * - SSP_IT: specifies the SSP interrupts sources to be enabled * or disabled. This parameter can be any combination 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 * - NewState: new state of the specified SSP interrupts. * This parameter can be: ENABLE or DISABLE. * Output : None * Return : None *******************************************************************************/ void SSP_ITConfig(SSP_TypeDef* SSPx, u16 SSP_IT, FunctionalState NewState) { if(NewState == ENABLE) { /* Enable the selected SSP interrupts */ SSPx->IMSCR |= SSP_IT; } else { /* Disable the selected SSP interrupts */ SSPx->IMSCR &= ~SSP_IT; } } /******************************************************************************* * Function Name : SSP_DMACmd * 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’s 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’s 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****/
Go to most recent revision | Compare with Previous | Blame | View Log