// ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

// File name    : spi_drv.h

// Version      : V0.1

// ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

#ifndef SPI_DRV_H_

#define SPI_DRV_H_

#include "spi_reg.h"

#include "memmap.h"

/* SPI Init structure definition */

typedef struct

{

  UINT8 SPI_Direction;

  UINT8 SPI_Mode;

  UINT8 SPI_DataSize;

  UINT8 SPI_CPOL;//SPI空闲时，时钟信号SCLK的电平（1:空闲时高电平; 0:空闲时低电平）

  UINT8 SPI_CPHA;//SPI在SCLK第几个边沿开始采样（0:第一个边沿开始; 1:第二个边沿开始）

  UINT8 SPI_BaudRatePrescaler;//SPI Baud Rate

  UINT8 SPI_FirstBit;//LSB-First Enable Bit

  UINT8 SPI_CRCPolynomial;

}SPI_InitTypeDef;

typedef enum

{

    SPI_MISO = 0,

    SPI_MOSI,

    SPI_SCK,

    SPI_SS

}SPI_PINx;

#define IS_SPI_PINx(pin) (((pin) == SPI_MISO) || \

                          ((pin) == SPI_MOSI) || \

                          ((pin) == SPI_SCK) || \

                          ((pin) == SPI_SS))

#define SPI1		((SPI_TypeDef *)(SPI1_BASE_ADDR))

#define SPI2		((SPI_TypeDef *)(SPI2_BASE_ADDR))

#define SPI3		((SPI_TypeDef *)(SPI3_BASE_ADDR))

#define IS_SPI_ALL_PERIPH(PERIPH) (((PERIPH) == SPI1) || \

		                           ((PERIPH) == SPI2) || \

                                   ((PERIPH) == SPI3))

/* SPI master/slave mode */

#define SPI_Mode_Master                 ((UINT8)0x10)

#define SPI_Mode_Slave                  ((UINT8)0x00)

#define IS_SPI_MODE(MODE) (((MODE) == SPI_Mode_Master) || \

                           ((MODE) == SPI_Mode_Slave))

/* SPI data direction mode */

#define SPI_Direction_2Lines_FullDuplex ((UINT8)0x00)

#define SPI_Direction_1Line_RxOrTx      ((UINT8)0x01)

#define IS_SPI_DIRECTION_MODE(MODE) (((MODE) == SPI_Direction_2Lines_FullDuplex) || \

                                     ((MODE) == SPI_Direction_1Line_RxOrTx))

/* SPI data size */

#define SPI_DataSize_16b             (0x0f)

#define SPI_DataSize_8b              (0x07)

#define IS_SPI_DATASIZE(DATASIZE) (((DATASIZE) == SPI_DataSize_16b) || \

                                   ((DATASIZE) == SPI_DataSize_8b))

/* SPI Clock Polarity */

#define SPI_CPOL_Low                    ((UINT8)0x00)

#define SPI_CPOL_High                   ((UINT8)0x08)

#define IS_SPI_CPOL(CPOL) (((CPOL) == SPI_CPOL_Low) || \

                           ((CPOL) == SPI_CPOL_High))

/* SPI Clock Phase */

#define SPI_CPHA_1Edge                  ((UINT16)0x00)

#define SPI_CPHA_2Edge                  ((UINT16)0x04)

#define IS_SPI_CPHA(CPHA) (((CPHA) == SPI_CPHA_1Edge) || \

                           ((CPHA) == SPI_CPHA_2Edge))

/* SPI BaudRate Prescaler  */

#define SPI_BaudRatePrescaler_2         (0x00)

#define SPI_BaudRatePrescaler_4         (0x01)

#define SPI_BaudRatePrescaler_6         (0x20)

#define SPI_BaudRatePrescaler_8         (0x02)

#define SPI_BaudRatePrescaler_10        (0x40)

#define SPI_BaudRatePrescaler_20        (0x41)

#define SPI_BaudRatePrescaler_40        (0x42)

#define SPI_BaudRatePrescaler_64        (0x05)

#define SPI_BaudRatePrescaler_256       (0x07)

#define IS_SPI_BAUDRATE_PRESCALER(PRESCALER) (((PRESCALER) == SPI_BaudRatePrescaler_2) || \

                                              ((PRESCALER) == SPI_BaudRatePrescaler_4) || \

                                              ((PRESCALER) == SPI_BaudRatePrescaler_6) || \

                                              ((PRESCALER) == SPI_BaudRatePrescaler_8) || \

                                              ((PRESCALER) == SPI_BaudRatePrescaler_10) || \

                                              ((PRESCALER) == SPI_BaudRatePrescaler_20) || \

                                              ((PRESCALER) == SPI_BaudRatePrescaler_40) || \

                                              ((PRESCALER) == SPI_BaudRatePrescaler_64))

/* SPI MSB/LSB transmission */

#define SPI_FirstBit_MSB                ((UINT8)0x00)

#define SPI_FirstBit_LSB                ((UINT8)0x01)

#define IS_SPI_FIRST_BIT(BIT) (((BIT) == SPI_FirstBit_MSB) || \

                               ((BIT) == SPI_FirstBit_LSB))

#define CR1_SPE_Set    ((UINT8)0x40)

#define CR1_SPE_Reset  ((UINT8)0xBF)

#define SPI_CS_L(x)		    do{x->SPIPORT &= 0xF7;}while(0)

#define SPI_CS_H(x)		    do{x->SPIPORT |= 0x08;}while(0)

//#define SPI1_CS_L		    do{SPI1->SPIPORT &= 0xF7;}while(0)

//#define SPI1_CS_H		    do{SPI1->SPIPORT |= 0x08;}while(0)

//#define SPI2_CS_L		    do{SPI2->SPIPORT &= 0xF7;}while(0)

//#define SPI2_CS_H		    do{SPI2->SPIPORT |= 0x08;}while(0)

//#define SPI3_CS_L		    do{SPI3->SPIPORT &= 0xF7;}while(0)

//#define SPI3_CS_H		    do{SPI3->SPIPORT |= 0x08;}while(0)

#define SPISR_TXDMAE_MASK      (0x02)

#define SPISR_RXDMAE_MASK      (0x01)

/*******************************************************************************

* Function Name  : SPI_StructInit

* Description    : Fills each SPI_InitStruct member with its default value.

* Input          : - SPI_InitStruct : pointer to a SPI_InitTypeDef structure

*                    which will be initialized.

* Output         : None

* Return         : None

*******************************************************************************/

void SPI_StructInit(UINT8 mode,SPI_InitTypeDef* SPI_InitStruct);

/*******************************************************************************

* Function Name  : SPI_Init

* Description    : SPI初始化

*

* Input          : - SPIx: where x can be 1, 2  to select the SPI peripheral.

*                  - SPI_InitStruct: pointer to a SPI_InitTypeDef structure that

*                    contains the configuration information for the specified

*                    SPI peripheral.

* Output         : None

* Return         : None

******************************************************************************/

void SPI_Init(SPI_TypeDef* SPIx, SPI_InitTypeDef* SPI_InitStruct);

/*******************************************************************************

* Function Name  : SPI_Cmd

* Description    : Enables or disables the specified SPI peripheral.

* Input          : - SPIx: where x can be 1, 2  to select the SPI peripheral.

*                  - NewState: new state of the SPIx peripheral.

*                    This parameter can be: ENABLE or DISABLE.

* Output         : None

* Return         : None

*******************************************************************************/

void SPI_Cmd(SPI_TypeDef* SPIx, FunctionalState NewState);

/*******************************************************************************

* Function Name  : SPI_MasterSendData

* Description    : SPI作为主设备发送数据

* Input          : - SPIx: where x can be 1, 2  to select the SPI peripheral.

*                  - Send: 发送数据缓冲

*                  - Len：发送数据的长度

*

* Output         : None

* Return         : None

******************************************************************************/

void SPI_MasterSendData(SPI_TypeDef* SPIx, UINT8 *Send, UINT32 Len);

/*******************************************************************************

* Function Name  : SPI_MasterFixedSendData

* Description    : SPI作为主设备发送长度Len的相同Send数据

* Input          : - SPIx: where x can be 1, 2  to select the SPI peripheral.

*                  - Send: 发送的数据

*                  - Len：发送数据的长度

*

* Output         : None

* Return         : None

******************************************************************************/

void SPI_MasterFixedSendData(SPI_TypeDef* SPIx, UINT8 Send, UINT16 Len);

/*******************************************************************************

* Function Name  : SPI_MasterReceiveData

* Description    : SPI作为主设备接收来自从设备数据

* Input          : - SPIx: where x can be 1, 2  to select the SPI peripheral.

*

*                  - Len：需要接收数据的长度

*

* Output         : - Revc: 接收数据缓冲

* Return         : None

******************************************************************************/

void SPI_MasterReceiveData(SPI_TypeDef* SPIx, UINT8 *Recv, UINT16 Len);

/*******************************************************************************

* Function Name  : SPI_MasterSendData

* Description    : SPI作为从设备发送数据

* Input          : - SPIx: where x can be 1, 2  to select the SPI peripheral.

*                  - Send: 发送数据缓冲

*                  - Len：发送数据的长度

*

* Output         : None

* Return         : None

******************************************************************************/

void SPI_SlaveSendData(SPI_TypeDef* SPIx, UINT8 *Send, UINT16 Len);

/*******************************************************************************

* Function Name  : SPI_SlaveReceiveData

* Description    : SPI作为从设备接收来自主设备数据

* Input          : - SPIx: where x can be 1, 2  to select the SPI peripheral.

*

*                  - Len：需要接收数据的长度

*

* Output         : - Revc: 接收数据缓冲

* Return         : None

******************************************************************************/

void SPI_SlaveReceiveData(SPI_TypeDef* SPIx, UINT8 *Revc, UINT16 Len);

/*******************************************************************************

* Function Name  : SPI_ConfigGpio

* Description    : SPI配置成GPIO用途

* Input          : - SPIx: where x can be 1, 2  to select the SPI peripheral.

*                  - SPI_Pin：SPI对应的PIN脚，取值SPI_MISO、SPI_MOSI、SPI_SCK、SPI_SS

*                  - SPI_Dir：设置GPIO方向   GPIO_OUTPUT：输出  GPIO_INPUT：输入

*

* Output         : None

* Return         : None

******************************************************************************/

void SPI_ConfigGpio(SPI_TypeDef* SPIx, SPI_PINx SPI_Pin, UINT8 SPI_Dir);

/*******************************************************************************

* Function Name  : SPI_ReadGpioData

* Description    : 获取SPI_Pin对应引脚的电平

* Input          : - SPIx: where x can be 1, 2  to select the SPI peripheral.

*                  - SPI_Pin：SPI对应的PIN脚，取值SPI_MISO、SPI_MOSI、SPI_SCK、SPI_SS

*

* Output         : None

* Return         : Bit_SET:高电平  Bit_RESET：低电平

******************************************************************************/

UINT8 SPI_ReadGpioData(SPI_TypeDef* SPIx, SPI_PINx SPI_Pin);

/*******************************************************************************

* Function Name  : SPI_WriteGpioData

* Description    : 设置SPI_Pin对应引脚的电平

* Input          : - SPIx: where x can be 1, 2  to select the SPI peripheral.

*                  - SPI_Pin：SPI对应的PIN脚，取值SPI_MISO、SPI_MOSI、SPI_SCK、SPI_SS

*                  - bitVal：设置的电平，Bit_SET：设置为高电平  Bit_RESET：设置为低电平

*

* Output         : None

* Return         : None

******************************************************************************/

void SPI_WriteGpioData(SPI_TypeDef* SPIx, SPI_PINx SPI_Pin, UINT8 bitVal);

/*******************************************************************************

* Function Name  : SPI_MasterReceiveDataByEDMA

* Description    : SPI作为主设备发送并接收数据

* Input          : - SPIx: where x can be 1, 2 ,3 to select the SPI peripheral.

*				   - recvAddr: 接收数据缓冲首地址

*                  - Len：发送数据的长度

*

* Output         : None

* Return         : None

******************************************************************************/

void SPI_MasterReceiveDataByEDMA(SPI_TypeDef* SPIx, UINT32 recvAddr, UINT32 Len);

/*******************************************************************************

* Function Name  : SPI_MasterOnlyReceiveDataByEDMA

* Description    : SPI作为主设备接收数据

* Input          : - SPIx: where x can be 1, 2 ,3 to select the SPI peripheral.

*                  - recvAddr: 接收数据缓冲首地址

*                  - Len：接收数据的长度

*

* Output         : None

* Return         : None

******************************************************************************/

void SPI_MasterOnlyReceiveDataByEDMA(SPI_TypeDef* SPIx, UINT32 recvAddr, UINT32 Len);

/*******************************************************************************

* Function Name  : SPI_MasterSendDataByEDMA

* Description    : SPI作为主设备发送数据

* Input          : - SPIx: where x can be 1, 2 ,3 to select the SPI peripheral.

*                  - sendAddr: 发送数据缓冲首地址

*                  - Len：发送数据的长度

*

* Output         : None

* Return         : None

******************************************************************************/

void SPI_MasterSendDataByEDMA(SPI_TypeDef* SPIx, UINT32 sendAddr, UINT32 Len);

/*******************************************************************************

* Function Name  : SPI_MasterOnlySendDataByEDMA

* Description    : SPI作为主设备发送数据

* Input          : - SPIx: where x can be 1, 2 ,3 to select the SPI peripheral.

*                  - sendAddr: 发送数据缓冲首地址

*                  - Len：发送数据的长度

*

* Output         : None

* Return         : None

******************************************************************************/

void SPI_MasterOnlySendDataByEDMA(SPI_TypeDef* SPIx, UINT32 sendAddr, UINT32 Len);

/*******************************************************************************

* Function Name  : SPI_MasterOnlySendSameDataByEDMA

* Description    : SPI作为主设备发送数据，不会改变源buf数据

* Input          : - SPIx: where x can be 1, 2 ,3 to select the SPI peripheral.

*                  - sendAddr: 发送数据缓冲首地址

*                  - Len：发送数据的长度

*

* Output         : None

* Return         : None

******************************************************************************/

void SPI_MasterOnlySendSameDataByEDMA(SPI_TypeDef* SPIx, UINT32 sendAddr, UINT32 Len);

/*******************************************************************************

* Function Name  : SPI_EnableDMA

* Description    : SPI DMA功能的使能

* Input          : - SPIx: where x can be 1, 2, 3  to select the SPI peripheral.

*				   - enable: 是否使能

*

* Output         : None

* Return         : None

******************************************************************************/

void SPI_EnableDMA(SPI_TypeDef* SPIx,bool enable);

/*******************************************************************************

* Function Name  : SPI_StructInit_NFC

* Description    : Fills each SPI_InitStruct member with its default value.

* Input          : - SPI_InitStruct : pointer to a SPI_InitTypeDef structure

*                    which will be initialized.

* Output         : None

* Return         : None

*******************************************************************************/

void SPI_StructInit_NFC(UINT8 mode,SPI_InitTypeDef* SPI_InitStruct);

#endif /* SPI_DRV_H_ */