1 /****************************************************************************//**
2 * @file usci_spi.c
3 * @version V3.00
4 * @brief M480 series USCI_SPI driver source file
5 *
6 * SPDX-License-Identifier: Apache-2.0
7 * @copyright (C) 2016-2020 Nuvoton Technology Corp. All rights reserved.
8 *****************************************************************************/
9 #include "NuMicro.h"
10
11 /** @addtogroup Standard_Driver Standard Driver
12 @{
13 */
14
15 /** @addtogroup USCI_SPI_Driver USCI_SPI Driver
16 @{
17 */
18
19
20 /** @addtogroup USCI_SPI_EXPORTED_FUNCTIONS USCI_SPI Exported Functions
21 @{
22 */
23
24 /**
25 * @brief This function make USCI_SPI module be ready to transfer.
26 * By default, the USCI_SPI transfer sequence is MSB first, the slave selection
27 * signal is active low and the automatic slave select function is disabled. In
28 * Slave mode, the u32BusClock must be NULL and the USCI_SPI clock
29 * divider setting will be 0.
30 * @param[in] uspi The pointer of the specified USCI_SPI module.
31 * @param[in] u32MasterSlave Decide the USCI_SPI module is operating in master mode or in slave mode. Valid values are:
32 * - \ref USPI_SLAVE
33 * - \ref USPI_MASTER
34 * @param[in] u32SPIMode Decide the transfer timing. Valid values are:
35 * - \ref USPI_MODE_0
36 * - \ref USPI_MODE_1
37 * - \ref USPI_MODE_2
38 * - \ref USPI_MODE_3
39 * @param[in] u32DataWidth The data width of a USCI_SPI transaction.
40 * @param[in] u32BusClock The expected frequency of USCI_SPI bus clock in Hz.
41 * @return Actual frequency of USCI_SPI peripheral clock.
42 */
USPI_Open(USPI_T * uspi,uint32_t u32MasterSlave,uint32_t u32SPIMode,uint32_t u32DataWidth,uint32_t u32BusClock)43 uint32_t USPI_Open(USPI_T *uspi, uint32_t u32MasterSlave, uint32_t u32SPIMode, uint32_t u32DataWidth, uint32_t u32BusClock)
44 {
45 uint32_t u32ClkDiv = 0ul;
46 uint32_t u32Pclk;
47 uint32_t u32UspiClk = 0ul;
48
49 if(uspi == (USPI_T *)USPI0)
50 {
51 u32Pclk = CLK_GetPCLK0Freq();
52 }
53 else
54 {
55 u32Pclk = CLK_GetPCLK1Freq();
56 }
57
58 if(u32BusClock != 0ul)
59 {
60 u32ClkDiv = (uint32_t) ((((((u32Pclk/2ul)*10ul)/(u32BusClock))+5ul)/10ul)-1ul); /* Compute proper divider for USCI_SPI clock */
61 }
62 else {}
63
64 /* Enable USCI_SPI protocol */
65 uspi->CTL &= ~USPI_CTL_FUNMODE_Msk;
66 uspi->CTL = 1ul << USPI_CTL_FUNMODE_Pos;
67
68 /* Data format configuration */
69 if(u32DataWidth == 16ul)
70 {
71 u32DataWidth = 0ul;
72 }
73 else {}
74 uspi->LINECTL &= ~USPI_LINECTL_DWIDTH_Msk;
75 uspi->LINECTL |= (u32DataWidth << USPI_LINECTL_DWIDTH_Pos);
76
77 /* MSB data format */
78 uspi->LINECTL &= ~USPI_LINECTL_LSB_Msk;
79
80 /* Set slave selection signal active low */
81 if(u32MasterSlave == USPI_MASTER)
82 {
83 uspi->LINECTL |= USPI_LINECTL_CTLOINV_Msk;
84 }
85 else
86 {
87 uspi->CTLIN0 |= USPI_CTLIN0_ININV_Msk;
88 }
89
90 /* Set operating mode and transfer timing */
91 uspi->PROTCTL &= ~(USPI_PROTCTL_SCLKMODE_Msk | USPI_PROTCTL_AUTOSS_Msk | USPI_PROTCTL_SLAVE_Msk);
92 uspi->PROTCTL |= (u32MasterSlave | u32SPIMode);
93
94 /* Set USCI_SPI bus clock */
95 uspi->BRGEN &= ~USPI_BRGEN_CLKDIV_Msk;
96 uspi->BRGEN |= (u32ClkDiv << USPI_BRGEN_CLKDIV_Pos);
97 uspi->PROTCTL |= USPI_PROTCTL_PROTEN_Msk;
98
99 if(u32BusClock != 0ul)
100 {
101 u32UspiClk = (uint32_t)( u32Pclk / ((u32ClkDiv+1ul)<<1) );
102 }
103 else {}
104
105 return u32UspiClk;
106 }
107
108 /**
109 * @brief Disable USCI_SPI function mode.
110 * @param[in] uspi The pointer of the specified USCI_SPI module.
111 * @return None
112 */
USPI_Close(USPI_T * uspi)113 void USPI_Close(USPI_T *uspi)
114 {
115 uspi->CTL &= ~USPI_CTL_FUNMODE_Msk;
116 }
117
118 /**
119 * @brief Clear Rx buffer.
120 * @param[in] uspi The pointer of the specified USCI_SPI module.
121 * @return None
122 */
USPI_ClearRxBuf(USPI_T * uspi)123 void USPI_ClearRxBuf(USPI_T *uspi)
124 {
125 uspi->BUFCTL |= USPI_BUFCTL_RXCLR_Msk;
126 }
127
128 /**
129 * @brief Clear Tx buffer.
130 * @param[in] uspi The pointer of the specified USCI_SPI module.
131 * @return None
132 */
USPI_ClearTxBuf(USPI_T * uspi)133 void USPI_ClearTxBuf(USPI_T *uspi)
134 {
135 uspi->BUFCTL |= USPI_BUFCTL_TXCLR_Msk;
136 }
137
138 /**
139 * @brief Disable the automatic slave select function.
140 * @param[in] uspi The pointer of the specified USCI_SPI module.
141 * @return None
142 */
USPI_DisableAutoSS(USPI_T * uspi)143 void USPI_DisableAutoSS(USPI_T *uspi)
144 {
145 uspi->PROTCTL &= ~(USPI_PROTCTL_AUTOSS_Msk | USPI_PROTCTL_SS_Msk);
146 }
147
148 /**
149 * @brief Enable the automatic slave select function. Only available in Master mode.
150 * @param[in] uspi The pointer of the specified USCI_SPI module.
151 * @param[in] u32SSPinMask This parameter is not used.
152 * @param[in] u32ActiveLevel The active level of slave select signal. Valid values are:
153 * - \ref USPI_SS_ACTIVE_HIGH
154 * - \ref USPI_SS_ACTIVE_LOW
155 * @return None
156 */
USPI_EnableAutoSS(USPI_T * uspi,uint32_t u32SSPinMask,uint32_t u32ActiveLevel)157 void USPI_EnableAutoSS(USPI_T *uspi, uint32_t u32SSPinMask, uint32_t u32ActiveLevel)
158 {
159 uspi->LINECTL = (uspi->LINECTL & ~USPI_LINECTL_CTLOINV_Msk) | u32ActiveLevel;
160 uspi->PROTCTL |= USPI_PROTCTL_AUTOSS_Msk;
161 }
162
163 /**
164 * @brief Set the USCI_SPI bus clock. Only available in Master mode.
165 * @param[in] uspi The pointer of the specified USCI_SPI module.
166 * @param[in] u32BusClock The expected frequency of USCI_SPI bus clock.
167 * @return Actual frequency of USCI_SPI peripheral clock.
168 */
USPI_SetBusClock(USPI_T * uspi,uint32_t u32BusClock)169 uint32_t USPI_SetBusClock(USPI_T *uspi, uint32_t u32BusClock)
170 {
171 uint32_t u32ClkDiv;
172 uint32_t u32Pclk;
173
174 if(uspi == USPI0)
175 {
176 u32Pclk = CLK_GetPCLK0Freq();
177 }
178 else
179 {
180 u32Pclk = CLK_GetPCLK1Freq();
181 }
182
183 u32ClkDiv = (uint32_t) ((((((u32Pclk/2ul)*10ul)/(u32BusClock))+5ul)/10ul)-1ul); /* Compute proper divider for USCI_SPI clock */
184
185 /* Set USCI_SPI bus clock */
186 uspi->BRGEN &= ~USPI_BRGEN_CLKDIV_Msk;
187 uspi->BRGEN |= (u32ClkDiv << USPI_BRGEN_CLKDIV_Pos);
188
189 return ( u32Pclk / ((u32ClkDiv+1ul)<<1) );
190 }
191
192 /**
193 * @brief Get the actual frequency of USCI_SPI bus clock. Only available in Master mode.
194 * @param[in] uspi The pointer of the specified USCI_SPI module.
195 * @return Actual USCI_SPI bus clock frequency.
196 */
USPI_GetBusClock(USPI_T * uspi)197 uint32_t USPI_GetBusClock(USPI_T *uspi)
198 {
199 uint32_t u32BusClk;
200 uint32_t u32ClkDiv;
201
202 u32ClkDiv = (uspi->BRGEN & USPI_BRGEN_CLKDIV_Msk) >> USPI_BRGEN_CLKDIV_Pos;
203
204 if(uspi == USPI0)
205 {
206 u32BusClk = (uint32_t)( CLK_GetPCLK0Freq() / ((u32ClkDiv+1ul)<<1) );
207 }
208 else
209 {
210 u32BusClk = (uint32_t)( CLK_GetPCLK1Freq() / ((u32ClkDiv+1ul)<<1) );
211 }
212
213 return u32BusClk;
214 }
215
216 /**
217 * @brief Enable related interrupts specified by u32Mask parameter.
218 * @param[in] uspi The pointer of the specified USCI_SPI module.
219 * @param[in] u32Mask The combination of all related interrupt enable bits.
220 * Each bit corresponds to a interrupt bit.
221 * This parameter decides which interrupts will be enabled. Valid values are:
222 * - \ref USPI_SSINACT_INT_MASK
223 * - \ref USPI_SSACT_INT_MASK
224 * - \ref USPI_SLVTO_INT_MASK
225 * - \ref USPI_SLVBE_INT_MASK
226 * - \ref USPI_TXUDR_INT_MASK
227 * - \ref USPI_RXOV_INT_MASK
228 * - \ref USPI_TXST_INT_MASK
229 * - \ref USPI_TXEND_INT_MASK
230 * - \ref USPI_RXST_INT_MASK
231 * - \ref USPI_RXEND_INT_MASK
232 * @return None
233 */
USPI_EnableInt(USPI_T * uspi,uint32_t u32Mask)234 void USPI_EnableInt(USPI_T *uspi, uint32_t u32Mask)
235 {
236 /* Enable slave selection signal inactive interrupt flag */
237 if((u32Mask & USPI_SSINACT_INT_MASK) == USPI_SSINACT_INT_MASK)
238 {
239 uspi->PROTIEN |= USPI_PROTIEN_SSINAIEN_Msk;
240 }
241 else {}
242 /* Enable slave selection signal active interrupt flag */
243 if((u32Mask & USPI_SSACT_INT_MASK) == USPI_SSACT_INT_MASK)
244 {
245 uspi->PROTIEN |= USPI_PROTIEN_SSACTIEN_Msk;
246 }
247 else {}
248 /* Enable slave time-out interrupt flag */
249 if((u32Mask & USPI_SLVTO_INT_MASK) == USPI_SLVTO_INT_MASK)
250 {
251 uspi->PROTIEN |= USPI_PROTIEN_SLVTOIEN_Msk;
252 }
253 else {}
254
255 /* Enable slave bit count error interrupt flag */
256 if((u32Mask & USPI_SLVBE_INT_MASK) == USPI_SLVBE_INT_MASK)
257 {
258 uspi->PROTIEN |= USPI_PROTIEN_SLVBEIEN_Msk;
259 }
260 else {}
261 /* Enable TX under run interrupt flag */
262 if((u32Mask & USPI_TXUDR_INT_MASK) == USPI_TXUDR_INT_MASK)
263 {
264 uspi->BUFCTL |= USPI_BUFCTL_TXUDRIEN_Msk;
265 }
266 else {}
267 /* Enable RX overrun interrupt flag */
268 if((u32Mask & USPI_RXOV_INT_MASK) == USPI_RXOV_INT_MASK)
269 {
270 uspi->BUFCTL |= USPI_BUFCTL_RXOVIEN_Msk;
271 }
272 else {}
273 /* Enable TX start interrupt flag */
274 if((u32Mask & USPI_TXST_INT_MASK) == USPI_TXST_INT_MASK)
275 {
276 uspi->INTEN |= USPI_INTEN_TXSTIEN_Msk;
277 }
278 else {}
279 /* Enable TX end interrupt flag */
280 if((u32Mask & USPI_TXEND_INT_MASK) == USPI_TXEND_INT_MASK)
281 {
282 uspi->INTEN |= USPI_INTEN_TXENDIEN_Msk;
283 }
284 else {}
285 /* Enable RX start interrupt flag */
286 if((u32Mask & USPI_RXST_INT_MASK) == USPI_RXST_INT_MASK)
287 {
288 uspi->INTEN |= USPI_INTEN_RXSTIEN_Msk;
289 }
290 else {}
291 /* Enable RX end interrupt flag */
292 if((u32Mask & USPI_RXEND_INT_MASK) == USPI_RXEND_INT_MASK)
293 {
294 uspi->INTEN |= USPI_INTEN_RXENDIEN_Msk;
295 }
296 else {}
297 }
298
299 /**
300 * @brief Disable related interrupts specified by u32Mask parameter.
301 * @param[in] uspi The pointer of the specified USCI_SPI module.
302 * @param[in] u32Mask The combination of all related interrupt enable bits.
303 * Each bit corresponds to a interrupt bit.
304 * This parameter decides which interrupts will be disabled. Valid values are:
305 * - \ref USPI_SSINACT_INT_MASK
306 * - \ref USPI_SSACT_INT_MASK
307 * - \ref USPI_SLVTO_INT_MASK
308 * - \ref USPI_SLVBE_INT_MASK
309 * - \ref USPI_TXUDR_INT_MASK
310 * - \ref USPI_RXOV_INT_MASK
311 * - \ref USPI_TXST_INT_MASK
312 * - \ref USPI_TXEND_INT_MASK
313 * - \ref USPI_RXST_INT_MASK
314 * - \ref USPI_RXEND_INT_MASK
315 * @return None
316 */
USPI_DisableInt(USPI_T * uspi,uint32_t u32Mask)317 void USPI_DisableInt(USPI_T *uspi, uint32_t u32Mask)
318 {
319 /* Disable slave selection signal inactive interrupt flag */
320 if((u32Mask & USPI_SSINACT_INT_MASK) == USPI_SSINACT_INT_MASK)
321 {
322 uspi->PROTIEN &= ~USPI_PROTIEN_SSINAIEN_Msk;
323 }
324 else {}
325 /* Disable slave selection signal active interrupt flag */
326 if((u32Mask & USPI_SSACT_INT_MASK) == USPI_SSACT_INT_MASK)
327 {
328 uspi->PROTIEN &= ~USPI_PROTIEN_SSACTIEN_Msk;
329 }
330 else {}
331 /* Disable slave time-out interrupt flag */
332 if((u32Mask & USPI_SLVTO_INT_MASK) == USPI_SLVTO_INT_MASK)
333 {
334 uspi->PROTIEN &= ~USPI_PROTIEN_SLVTOIEN_Msk;
335 }
336 else {}
337 /* Disable slave bit count error interrupt flag */
338 if((u32Mask & USPI_SLVBE_INT_MASK) == USPI_SLVBE_INT_MASK)
339 {
340 uspi->PROTIEN &= ~USPI_PROTIEN_SLVBEIEN_Msk;
341 }
342 else {}
343 /* Disable TX under run interrupt flag */
344 if((u32Mask & USPI_TXUDR_INT_MASK) == USPI_TXUDR_INT_MASK)
345 {
346 uspi->BUFCTL &= ~USPI_BUFCTL_TXUDRIEN_Msk;
347 }
348 else {}
349 /* Disable RX overrun interrupt flag */
350 if((u32Mask & USPI_RXOV_INT_MASK) == USPI_RXOV_INT_MASK)
351 {
352 uspi->BUFCTL &= ~USPI_BUFCTL_RXOVIEN_Msk;
353 }
354 else {}
355 /* Disable TX start interrupt flag */
356 if((u32Mask & USPI_TXST_INT_MASK) == USPI_TXST_INT_MASK)
357 {
358 uspi->INTEN &= ~USPI_INTEN_TXSTIEN_Msk;
359 }
360 else {}
361 /* Disable TX end interrupt flag */
362 if((u32Mask & USPI_TXEND_INT_MASK) == USPI_TXEND_INT_MASK)
363 {
364 uspi->INTEN &= ~USPI_INTEN_TXENDIEN_Msk;
365 }
366 else {}
367 /* Disable RX start interrupt flag */
368 if((u32Mask & USPI_RXST_INT_MASK) == USPI_RXST_INT_MASK)
369 {
370 uspi->INTEN &= ~USPI_INTEN_RXSTIEN_Msk;
371 }
372 else {}
373 /* Disable RX end interrupt flag */
374 if((u32Mask & USPI_RXEND_INT_MASK) == USPI_RXEND_INT_MASK)
375 {
376 uspi->INTEN &= ~USPI_INTEN_RXENDIEN_Msk;
377 }
378 else {}
379 }
380
381 /**
382 * @brief Get interrupt flag.
383 * @param[in] uspi The pointer of the specified USCI_SPI module.
384 * @param[in] u32Mask The combination of all related interrupt sources.
385 * Each bit corresponds to a interrupt source.
386 * This parameter decides which interrupt flags will be read. It is combination of:
387 * - \ref USPI_SSINACT_INT_MASK
388 * - \ref USPI_SSACT_INT_MASK
389 * - \ref USPI_SLVTO_INT_MASK
390 * - \ref USPI_SLVBE_INT_MASK
391 * - \ref USPI_TXUDR_INT_MASK
392 * - \ref USPI_RXOV_INT_MASK
393 * - \ref USPI_TXST_INT_MASK
394 * - \ref USPI_TXEND_INT_MASK
395 * - \ref USPI_RXST_INT_MASK
396 * - \ref USPI_RXEND_INT_MASK
397 * @return Interrupt flags of selected sources.
398 */
USPI_GetIntFlag(USPI_T * uspi,uint32_t u32Mask)399 uint32_t USPI_GetIntFlag(USPI_T *uspi, uint32_t u32Mask)
400 {
401 uint32_t u32TmpFlag;
402 uint32_t u32IntFlag = 0ul;
403
404 /* Check slave selection signal inactive interrupt flag */
405 u32TmpFlag = uspi->PROTSTS & USPI_PROTSTS_SSINAIF_Msk;
406 if(((u32Mask & USPI_SSINACT_INT_MASK)==USPI_SSINACT_INT_MASK) && (u32TmpFlag==USPI_PROTSTS_SSINAIF_Msk) )
407 {
408 u32IntFlag |= USPI_SSINACT_INT_MASK;
409 }
410 else {}
411 /* Check slave selection signal active interrupt flag */
412
413 u32TmpFlag = uspi->PROTSTS & USPI_PROTSTS_SSACTIF_Msk;
414 if(((u32Mask & USPI_SSACT_INT_MASK)==USPI_SSACT_INT_MASK) && (u32TmpFlag == USPI_PROTSTS_SSACTIF_Msk))
415 {
416 u32IntFlag |= USPI_SSACT_INT_MASK;
417 }
418 else {}
419
420 /* Check slave time-out interrupt flag */
421 u32TmpFlag = uspi->PROTSTS & USPI_PROTSTS_SLVTOIF_Msk;
422 if(((u32Mask & USPI_SLVTO_INT_MASK)==USPI_SLVTO_INT_MASK) && (u32TmpFlag == USPI_PROTSTS_SLVTOIF_Msk))
423 {
424 u32IntFlag |= USPI_SLVTO_INT_MASK;
425 }
426 else {}
427
428 /* Check slave bit count error interrupt flag */
429 u32TmpFlag = uspi->PROTSTS & USPI_PROTSTS_SLVBEIF_Msk;
430 if(((u32Mask & USPI_SLVBE_INT_MASK)==USPI_SLVBE_INT_MASK) && (u32TmpFlag == USPI_PROTSTS_SLVBEIF_Msk))
431 {
432 u32IntFlag |= USPI_SLVBE_INT_MASK;
433 }
434 else {}
435
436 /* Check TX under run interrupt flag */
437 u32TmpFlag = uspi->BUFSTS & USPI_BUFSTS_TXUDRIF_Msk;
438 if(((u32Mask & USPI_TXUDR_INT_MASK)==USPI_TXUDR_INT_MASK) && (u32TmpFlag == USPI_BUFSTS_TXUDRIF_Msk))
439 {
440 u32IntFlag |= USPI_TXUDR_INT_MASK;
441 }
442 else {}
443
444 /* Check RX overrun interrupt flag */
445 u32TmpFlag = uspi->BUFSTS & USPI_BUFSTS_RXOVIF_Msk;
446 if(((u32Mask & USPI_RXOV_INT_MASK)==USPI_RXOV_INT_MASK) && (u32TmpFlag == USPI_BUFSTS_RXOVIF_Msk))
447 {
448 u32IntFlag |= USPI_RXOV_INT_MASK;
449 }
450 else {}
451
452 /* Check TX start interrupt flag */
453 u32TmpFlag = uspi->PROTSTS & USPI_PROTSTS_TXSTIF_Msk;
454 if(((u32Mask & USPI_TXST_INT_MASK)==USPI_TXST_INT_MASK) && (u32TmpFlag == USPI_PROTSTS_TXSTIF_Msk))
455 {
456 u32IntFlag |= USPI_TXST_INT_MASK;
457 }
458 else {}
459
460 /* Check TX end interrupt flag */
461 u32TmpFlag = uspi->PROTSTS & USPI_PROTSTS_TXENDIF_Msk;
462 if(((u32Mask & USPI_TXEND_INT_MASK)==USPI_TXEND_INT_MASK) && (u32TmpFlag == USPI_PROTSTS_TXENDIF_Msk))
463 {
464 u32IntFlag |= USPI_TXEND_INT_MASK;
465 }
466 else {}
467
468 /* Check RX start interrupt flag */
469 u32TmpFlag = uspi->PROTSTS & USPI_PROTSTS_RXSTIF_Msk;
470 if(((u32Mask & USPI_RXST_INT_MASK)==USPI_RXST_INT_MASK) && (u32TmpFlag == USPI_PROTSTS_RXSTIF_Msk))
471 {
472 u32IntFlag |= USPI_RXST_INT_MASK;
473 }
474 else {}
475
476 /* Check RX end interrupt flag */
477 u32TmpFlag = uspi->PROTSTS & USPI_PROTSTS_RXENDIF_Msk;
478 if(((u32Mask & USPI_RXEND_INT_MASK)==USPI_RXEND_INT_MASK) && (u32TmpFlag == USPI_PROTSTS_RXENDIF_Msk))
479 {
480 u32IntFlag |= USPI_RXEND_INT_MASK;
481 }
482 else {}
483 return u32IntFlag;
484 }
485
486 /**
487 * @brief Clear interrupt flag.
488 * @param[in] uspi The pointer of the specified USCI_SPI module.
489 * @param[in] u32Mask The combination of all related interrupt sources.
490 * Each bit corresponds to a interrupt source.
491 * This parameter decides which interrupt flags will be cleared. It could be the combination of:
492 * - \ref USPI_SSINACT_INT_MASK
493 * - \ref USPI_SSACT_INT_MASK
494 * - \ref USPI_SLVTO_INT_MASK
495 * - \ref USPI_SLVBE_INT_MASK
496 * - \ref USPI_TXUDR_INT_MASK
497 * - \ref USPI_RXOV_INT_MASK
498 * - \ref USPI_TXST_INT_MASK
499 * - \ref USPI_TXEND_INT_MASK
500 * - \ref USPI_RXST_INT_MASK
501 * - \ref USPI_RXEND_INT_MASK
502 * @return None
503 */
USPI_ClearIntFlag(USPI_T * uspi,uint32_t u32Mask)504 void USPI_ClearIntFlag(USPI_T *uspi, uint32_t u32Mask)
505 {
506 /* Clear slave selection signal inactive interrupt flag */
507 if((u32Mask & USPI_SSINACT_INT_MASK)==USPI_SSINACT_INT_MASK)
508 {
509 uspi->PROTSTS = USPI_PROTSTS_SSINAIF_Msk;
510 }
511 else {}
512 /* Clear slave selection signal active interrupt flag */
513 if((u32Mask & USPI_SSACT_INT_MASK)==USPI_SSACT_INT_MASK)
514 {
515 uspi->PROTSTS = USPI_PROTSTS_SSACTIF_Msk;
516 }
517 else {}
518 /* Clear slave time-out interrupt flag */
519 if((u32Mask & USPI_SLVTO_INT_MASK)==USPI_SLVTO_INT_MASK)
520 {
521 uspi->PROTSTS = USPI_PROTSTS_SLVTOIF_Msk;
522 }
523 else {}
524 /* Clear slave bit count error interrupt flag */
525 if((u32Mask & USPI_SLVBE_INT_MASK)==USPI_SLVBE_INT_MASK)
526 {
527 uspi->PROTSTS = USPI_PROTSTS_SLVBEIF_Msk;
528 }
529 else {}
530 /* Clear TX under run interrupt flag */
531 if((u32Mask & USPI_TXUDR_INT_MASK)==USPI_TXUDR_INT_MASK)
532 {
533 uspi->BUFSTS = USPI_BUFSTS_TXUDRIF_Msk;
534 }
535 else {}
536 /* Clear RX overrun interrupt flag */
537 if((u32Mask & USPI_RXOV_INT_MASK)==USPI_RXOV_INT_MASK)
538 {
539 uspi->BUFSTS = USPI_BUFSTS_RXOVIF_Msk;
540 }
541 else {}
542 /* Clear TX start interrupt flag */
543 if((u32Mask & USPI_TXST_INT_MASK)==USPI_TXST_INT_MASK)
544 {
545 uspi->PROTSTS = USPI_PROTSTS_TXSTIF_Msk;
546 }
547 else {}
548 /* Clear TX end interrupt flag */
549 if((u32Mask & USPI_TXEND_INT_MASK)==USPI_TXEND_INT_MASK)
550 {
551 uspi->PROTSTS = USPI_PROTSTS_TXENDIF_Msk;
552 }
553 else {}
554 /* Clear RX start interrupt flag */
555 if((u32Mask & USPI_RXST_INT_MASK)==USPI_RXST_INT_MASK)
556 {
557 uspi->PROTSTS = USPI_PROTSTS_RXSTIF_Msk;
558 }
559 else {}
560
561 /* Clear RX end interrupt flag */
562 if((u32Mask & USPI_RXEND_INT_MASK)==USPI_RXEND_INT_MASK)
563 {
564 uspi->PROTSTS = USPI_PROTSTS_RXENDIF_Msk;
565 }
566 else {}
567 }
568
569 /**
570 * @brief Get USCI_SPI status.
571 * @param[in] uspi The pointer of the specified USCI_SPI module.
572 * @param[in] u32Mask The combination of all related sources.
573 * Each bit corresponds to a source.
574 * This parameter decides which flags will be read. It is combination of:
575 * - \ref USPI_BUSY_MASK
576 * - \ref USPI_RX_EMPTY_MASK
577 * - \ref USPI_RX_FULL_MASK
578 * - \ref USPI_TX_EMPTY_MASK
579 * - \ref USPI_TX_FULL_MASK
580 * - \ref USPI_SSLINE_STS_MASK
581 * @return Flags of selected sources.
582 */
USPI_GetStatus(USPI_T * uspi,uint32_t u32Mask)583 uint32_t USPI_GetStatus(USPI_T *uspi, uint32_t u32Mask)
584 {
585 uint32_t u32Flag = 0ul;
586 uint32_t u32TmpFlag;
587
588 /* Check busy status */
589 u32TmpFlag = uspi->PROTSTS & USPI_PROTSTS_BUSY_Msk;
590 if(((u32Mask & USPI_BUSY_MASK)==USPI_BUSY_MASK) && (u32TmpFlag & USPI_PROTSTS_BUSY_Msk))
591 {
592 u32Flag |= USPI_BUSY_MASK;
593 }
594 else {}
595
596 /* Check RX empty flag */
597 u32TmpFlag = uspi->BUFSTS & USPI_BUFSTS_RXEMPTY_Msk;
598 if(((u32Mask & USPI_RX_EMPTY_MASK)==USPI_RX_EMPTY_MASK) && (u32TmpFlag == USPI_BUFSTS_RXEMPTY_Msk))
599 {
600 u32Flag |= USPI_RX_EMPTY_MASK;
601 }
602 else {}
603
604 /* Check RX full flag */
605 u32TmpFlag = uspi->BUFSTS & USPI_BUFSTS_RXFULL_Msk;
606 if(((u32Mask & USPI_RX_FULL_MASK)==USPI_RX_FULL_MASK) && (u32TmpFlag == USPI_BUFSTS_RXFULL_Msk))
607 {
608 u32Flag |= USPI_RX_FULL_MASK;
609 }
610 else {}
611
612 /* Check TX empty flag */
613 u32TmpFlag = uspi->BUFSTS & USPI_BUFSTS_TXEMPTY_Msk;
614 if(((u32Mask & USPI_TX_EMPTY_MASK)==USPI_TX_EMPTY_MASK) && (u32TmpFlag == USPI_BUFSTS_TXEMPTY_Msk))
615 {
616 u32Flag |= USPI_TX_EMPTY_MASK;
617 }
618 else {}
619
620 /* Check TX full flag */
621 u32TmpFlag = uspi->BUFSTS & USPI_BUFSTS_TXFULL_Msk;
622 if(((u32Mask & USPI_TX_FULL_MASK)==USPI_TX_FULL_MASK) && (u32TmpFlag == USPI_BUFSTS_TXFULL_Msk))
623 {
624 u32Flag |= USPI_TX_FULL_MASK;
625 }
626 else {}
627
628 /* Check USCI_SPI_SS line status */
629 u32TmpFlag = uspi->PROTSTS & USPI_PROTSTS_SSLINE_Msk;
630 if(((u32Mask & USPI_SSLINE_STS_MASK)==USPI_SSLINE_STS_MASK) && (u32TmpFlag & USPI_PROTSTS_SSLINE_Msk))
631 {
632 u32Flag |= USPI_SSLINE_STS_MASK;
633 }
634 else {}
635 return u32Flag;
636 }
637
638 /**
639 * @brief Enable USCI_SPI Wake-up Function.
640 * @param[in] uspi The pointer of the specified USCI_SPI module.
641 * @return None
642 */
USPI_EnableWakeup(USPI_T * uspi)643 void USPI_EnableWakeup(USPI_T *uspi)
644 {
645 uspi->WKCTL |= USPI_WKCTL_WKEN_Msk;
646 }
647
648 /**
649 * @brief Disable USCI_SPI Wake-up Function.
650 * @param[in] uspi The pointer of the specified USCI_SPI module.
651 * @return None
652 */
USPI_DisableWakeup(USPI_T * uspi)653 void USPI_DisableWakeup(USPI_T *uspi)
654 {
655 uspi->WKCTL &= ~USPI_WKCTL_WKEN_Msk;
656 }
657
658 /*@}*/ /* end of group USCI_SPI_EXPORTED_FUNCTIONS */
659
660 /*@}*/ /* end of group USCI_SPI_Driver */
661
662 /*@}*/ /* end of group Standard_Driver */
663
664 /*** (C) COPYRIGHT 2016 Nuvoton Technology Corp. ***/
665
