NANO103 BSP V3.01.004
The Board Support Package for Nano103 Series
spi.h
Go to the documentation of this file.
1/****************************************************************************/
12#ifndef __SPI_H__
13#define __SPI_H__
14
15#ifdef __cplusplus
16extern "C"
17{
18#endif
19
20
34#define SPI_MODE_0 (SPI_CTL_TXNEG_Msk)
35#define SPI_MODE_1 (SPI_CTL_RXNEG_Msk)
36#define SPI_MODE_2 (SPI_CTL_CLKPOL_Msk | SPI_CTL_RXNEG_Msk)
37#define SPI_MODE_3 (SPI_CTL_CLKPOL_Msk | SPI_CTL_TXNEG_Msk)
39#define SPI_SLAVE (SPI_CTL_SLAVE_Msk)
40#define SPI_MASTER (0x0)
42#define SPI_SS0 (0x1)
43#define SPI_SS0_ACTIVE_HIGH (SPI_SSCTL_SSACTPOL_Msk)
44#define SPI_SS0_ACTIVE_LOW (0x0)
46#define SPI_SS1 (0x2)
47#define SPI_SS1_ACTIVE_HIGH (SPI_SSCTL_SSACTPOL_Msk)
48#define SPI_SS1_ACTIVE_LOW (0x0)
50#define SPI_IE_MASK (0x01)
51#define SPI_SSTAIEN_MASK (0x04)
52#define SPI_FIFO_TXTHIEN_MASK (0x08)
53#define SPI_FIFO_RXTHIEN_MASK (0x10)
54#define SPI_FIFO_RXOVIEN_MASK (0x20)
55#define SPI_FIFO_TIMEOUIEN_MASK (0x40) /* end of group NANO103_SPI_EXPORTED_CONSTANTS */
59
60
71#define SPI_ABORT_3WIRE_TRANSFER(spi) ( (spi)->SSCTL |= SPI_SSCTL_SLVABORT_Msk )
72
79#define SPI_CLR_3WIRE_START_INT_FLAG(spi) ( (spi)->STATUS = SPI_STATUS_SLVSTAIF_Msk )
80
87#define SPI_CLR_UNIT_TRANS_INT_FLAG(spi) ( (spi)->STATUS = SPI_STATUS_UNITIF_Msk )
88
95#define SPI_DISABLE_3WIRE_MODE(spi) ( (spi)->SSCTL &= ~SPI_SSCTL_SLV3WIRE_Msk )
96
103#define SPI_ENABLE_3WIRE_MODE(spi) ( (spi)->SSCTL |= SPI_SSCTL_SLV3WIRE_Msk )
104
111#define SPI_GET_RX_FIFO_COUNT(spi) ( (((spi)->STATUS & SPI_STATUS_RXCNT_Msk) >> SPI_STATUS_RXCNT_Pos) & 0xf )
112
121#define SPI_GET_RX_FIFO_EMPTY_FLAG(spi) ( ((spi)->STATUS & SPI_STATUS_RXEMPTY_Msk) == SPI_STATUS_RXEMPTY_Msk ? 1:0)
122
131#define SPI_GET_TX_FIFO_EMPTY_FLAG(spi) ( ((spi)->STATUS & SPI_STATUS_TXEMPTY_Msk) == SPI_STATUS_TXEMPTY_Msk ? 1:0)
132
141#define SPI_GET_TX_FIFO_FULL_FLAG(spi) ( ((spi)->STATUS & SPI_STATUS_TXFULL_Msk) == SPI_STATUS_TXFULL_Msk ? 1:0)
142
149#define SPI_READ_RX0(spi) ((spi)->RX0)
150
156#define SPI_READ_RX1(spi) ((spi)->RX1)
157
165#define SPI_WRITE_TX0(spi, u32TxData) ( (spi)->TX0 = u32TxData )
166
174#define SPI_WRITE_TX1(spi, u32TxData) ( (spi)->TX1 = u32TxData )
175
183#define SPI_SET_SS0_HIGH(spi) ((spi)->SSCTL = ((spi)->SSCTL & ~(SPI_SSCTL_AUTOSS_Msk|SPI_SSCTL_SSACTPOL_Msk|SPI_SS0)))
184
192#define SPI_SET_SS0_LOW(spi) ((spi)->SSCTL = ((spi)->SSCTL & ~(SPI_SSCTL_AUTOSS_Msk|SPI_SSCTL_SSACTPOL_Msk|SPI_SS0)) | SPI_SS0)
193
201#define SPI_SET_SS1_HIGH(spi) ((spi)->SSCTL = ((spi)->SSCTL & ~(SPI_SSCTL_AUTOSS_Msk|SPI_SSCTL_SSACTPOL_Msk|SPI_SS1)))
202
210#define SPI_SET_SS1_LOW(spi) ((spi)->SSCTL = ((spi)->SSCTL & ~(SPI_SSCTL_AUTOSS_Msk|SPI_SSCTL_SSACTPOL_Msk|SPI_SS1)) | SPI_SS1)
211
221#define SPI_SET_SS_LEVEL(spi, ss0, ss1) ((spi)->SSCTL = ((spi)->SSCTL & ~(SPI_SSCTL_AUTOSS_Msk|SPI_SSCTL_SSACTPOL_Msk|SPI_SSCTL_SS_Msk)) | (((ss1)^1) << 1) | ((ss0)^1))
222
229#define SPI_ENABLE_BYTE_REORDER(spi) ( (spi)->CTL |= SPI_CTL_REORDER_Msk )
230
237#define SPI_DISABLE_BYTE_REORDER(spi) ( (spi)->CTL &= ~SPI_CTL_REORDER_Msk )
238
246#define SPI_SET_SUSPEND_CYCLE(spi, u32SuspCycle) ( (spi)->CTL = ((spi)->CTL & ~SPI_CTL_SUSPITV_Msk) | (u32SuspCycle << SPI_CTL_SUSPITV_Pos) )
247
254#define SPI_SET_LSB_FIRST(spi) ( (spi)->CTL |= SPI_CTL_LSB_Msk )
255
262#define SPI_SET_MSB_FIRST(spi) ( (spi)->CTL &= ~SPI_CTL_LSB_Msk )
263
271static __INLINE void SPI_SET_DATA_WIDTH(SPI_T *spi, uint32_t u32Width)
272{
273 if(u32Width == 32)
274 u32Width = 0;
275
276 spi->CTL = (spi->CTL & ~SPI_CTL_DWIDTH_Msk) | (u32Width << SPI_CTL_DWIDTH_Pos);
277}
278
287#define SPI_IS_BUSY(spi) ( ((spi)->CTL & SPI_CTL_GOBUSY_Msk) == SPI_CTL_GOBUSY_Msk ? 1:0 )
288
295#define SPI_TRIGGER(spi) ( (spi)->CTL |= SPI_CTL_GOBUSY_Msk )
296
303#define SPI_ENABLE_DUAL_MODE(spi) ( (spi)->CTL |= SPI_CTL_DUALIOEN_Msk )
304
311#define SPI_DISABLE_DUAL_MODE(spi) ( (spi)->CTL &= ~SPI_CTL_DUALIOEN_Msk )
312
319#define SPI_ENABLE_DUAL_INPUT_MODE(spi) ( (spi)->CTL &= ~SPI_CTL_DUALDIR_Msk )
320
327#define SPI_ENABLE_DUAL_OUTPUT_MODE(spi) ( (spi)->CTL |= SPI_CTL_DUALDIR_Msk )
328
335#define SPI_TRIGGER_RX_PDMA(spi) ( (spi)->PDMACTL |= SPI_PDMACTL_RXPDMAEN_Msk )
336
343#define SPI_TRIGGER_TX_PDMA(spi) ( (spi)->PDMACTL |= SPI_PDMACTL_TXPDMAEN_Msk )
344
351#define SPI_ENABLE_2BIT_MODE(spi) ( (spi)->CTL |= SPI_CTL_TWOBIT_Msk )
352
359#define SPI_DISABLE_2BIT_MODE(spi) ( (spi)->CTL &= ~SPI_CTL_TWOBIT_Msk )
360
367#define SPI_GET_STATUS(spi) ((spi)->STATUS)
368
369uint32_t SPI_Open(SPI_T *spi, uint32_t u32MasterSlave, uint32_t u32SPIMode, uint32_t u32DataWidth, uint32_t u32BusClock);
370void SPI_Close(SPI_T *spi);
371void SPI_ClearRxFIFO(SPI_T *spi);
372void SPI_ClearTxFIFO(SPI_T *spi);
373void SPI_DisableAutoSS(SPI_T *spi);
374void SPI_EnableAutoSS(SPI_T *spi, uint32_t u32SSPinMask, uint32_t u32ActiveLevel);
375uint32_t SPI_SetBusClock(SPI_T *spi, uint32_t u32BusClock);
376void SPI_EnableFIFO(SPI_T *spi, uint32_t u32TxThreshold, uint32_t u32RxThreshold);
377void SPI_DisableFIFO(SPI_T *spi);
378uint32_t SPI_GetBusClock(SPI_T *spi);
379void SPI_EnableInt(SPI_T *spi, uint32_t u32Mask);
380void SPI_DisableInt(SPI_T *spi, uint32_t u32Mask);
381void SPI_EnableWakeup(SPI_T *spi);
382void SPI_DisableWakeup(SPI_T *spi); /* end of group NANO103_SPI_EXPORTED_FUNCTIONS */
384 /* end of group NANO103_SPI_Driver */
386 /* end of group NANO103_Device_Driver */
388
389#ifdef __cplusplus
390}
391#endif
392
393#endif //__SPI_H__
394
395/*** (C) COPYRIGHT 2015 Nuvoton Technology Corp. ***/
#define SPI_CTL_DWIDTH_Pos
Definition: Nano103.h:12854
void SPI_DisableInt(SPI_T *spi, uint32_t u32Mask)
Disable FIFO related interrupts specified by u32Mask parameter.
Definition: spi.c:374
static __INLINE void SPI_SET_DATA_WIDTH(SPI_T *spi, uint32_t u32Width)
Set the data width of a SPI transaction.
Definition: spi.h:271
void SPI_DisableFIFO(SPI_T *spi)
Disable FIFO mode.
Definition: spi.c:277
void SPI_EnableInt(SPI_T *spi, uint32_t u32Mask)
Enable FIFO related interrupts specified by u32Mask parameter.
Definition: spi.c:339
void SPI_EnableAutoSS(SPI_T *spi, uint32_t u32SSPinMask, uint32_t u32ActiveLevel)
Enable the automatic slave select function. Only available in Master mode.
Definition: spi.c:140
void SPI_EnableFIFO(SPI_T *spi, uint32_t u32TxThreshold, uint32_t u32RxThreshold)
Enable FIFO mode with user-specified Tx FIFO threshold and Rx FIFO threshold configurations.
Definition: spi.c:263
void SPI_DisableAutoSS(SPI_T *spi)
Disable the automatic slave select function.
Definition: spi.c:124
uint32_t SPI_SetBusClock(SPI_T *spi, uint32_t u32BusClock)
Set the SPI bus clock. Only available in Master mode.
Definition: spi.c:151
void SPI_Close(SPI_T *spi)
Reset SPI module and disable SPI peripheral clock.
Definition: spi.c:66
void SPI_EnableWakeup(SPI_T *spi)
Enable wake-up function.
Definition: spi.c:400
void SPI_ClearTxFIFO(SPI_T *spi)
Clear Tx FIFO buffer.
Definition: spi.c:114
uint32_t SPI_Open(SPI_T *spi, uint32_t u32MasterSlave, uint32_t u32SPIMode, uint32_t u32DataWidth, uint32_t u32BusClock)
This function make SPI module be ready to transfer. By default, the SPI transfer sequence is MSB firs...
Definition: spi.c:47
uint32_t SPI_GetBusClock(SPI_T *spi)
Get the actual frequency of SPI bus clock. Only available in Master mode.
Definition: spi.c:287
void SPI_ClearRxFIFO(SPI_T *spi)
Clear Rx FIFO buffer.
Definition: spi.c:104
void SPI_DisableWakeup(SPI_T *spi)
Disable wake-up function.
Definition: spi.c:410
__IO uint32_t CTL
Definition: Nano103.h:12822