nu_qspi.c 21 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598
  1. /**************************************************************************//**
  2. * @file qspi.c
  3. * @brief NUC980 series QSPI driver source file
  4. *
  5. * SPDX-License-Identifier: Apache-2.0
  6. * @copyright (C) 2018 Nuvoton Technology Corp. All rights reserved.
  7. *****************************************************************************/
  8. #include "nuc980.h"
  9. #include "nu_qspi.h"
  10. /** @addtogroup Standard_Driver Standard Driver
  11. @{
  12. */
  13. /** @addtogroup QSPI_Driver QSPI Driver
  14. @{
  15. */
  16. /** @addtogroup QSPI_EXPORTED_FUNCTIONS QSPI Exported Functions
  17. @{
  18. */
  19. /**
  20. * @brief This function make QSPI module be ready to transfer.
  21. * @param[in] qspi The pointer of the specified QSPI module.
  22. * @param[in] u32MasterSlave Decides the QSPI module is operating in master mode or in slave mode. (QSPI_SLAVE, QSPI_MASTER)
  23. * @param[in] u32QSPIMode Decides the transfer timing. (QSPI_MODE_0, QSPI_MODE_1, QSPI_MODE_2, QSPI_MODE_3)
  24. * @param[in] u32DataWidth Decides the data width of a QSPI transaction.
  25. * @param[in] u32BusClock The expected frequency of QSPI bus clock in Hz.
  26. * @return Actual frequency of QSPI peripheral clock.
  27. * @details By default, the QSPI transfer sequence is MSB first, the slave selection signal is active low and the automatic
  28. * slave selection function is disabled.
  29. * In Slave mode, the u32BusClock shall be NULL and the QSPI clock divider setting will be 0.
  30. * The actual clock rate may be different from the target QSPI clock rate.
  31. * For example, if the QSPI source clock rate is 12 MHz and the target QSPI bus clock rate is 7 MHz, the
  32. * actual QSPI clock rate will be 6MHz.
  33. * @note If u32BusClock = 0, DIVIDER setting will be set to the maximum value.
  34. * @note If u32BusClock >= system clock frequency, QSPI peripheral clock source will be set to APB clock and DIVIDER will be set to 0.
  35. * @note If u32BusClock >= QSPI peripheral clock source, DIVIDER will be set to 0.
  36. * @note In slave mode, the QSPI peripheral clock rate will be equal to APB clock rate.
  37. */
  38. uint32_t QSPI_Open(QSPI_T *qspi,
  39. uint32_t u32MasterSlave,
  40. uint32_t u32QSPIMode,
  41. uint32_t u32DataWidth,
  42. uint32_t u32BusClock)
  43. {
  44. uint32_t u32RetValue = 0U;
  45. if (u32DataWidth == 32U)
  46. {
  47. u32DataWidth = 0U;
  48. }
  49. if (u32MasterSlave == QSPI_MASTER)
  50. {
  51. /* Default setting: slave selection signal is active low; disable automatic slave selection function. */
  52. qspi->SSCTL = QSPI_SS_ACTIVE_LOW;
  53. /* Default setting: MSB first, disable unit transfer interrupt, SP_CYCLE = 0. */
  54. qspi->CTL = u32MasterSlave | (u32DataWidth << QSPI_CTL_DWIDTH_Pos) | (u32QSPIMode) | QSPI_CTL_QSPIEN_Msk;
  55. /* Set DIVIDER */
  56. qspi->CLKDIV = ((150000000U / u32BusClock) - 1U);
  57. }
  58. else /* For slave mode, force the QSPI peripheral clock rate to equal APB clock rate. */
  59. {
  60. /* Default setting: slave selection signal is low level active. */
  61. qspi->SSCTL = QSPI_SS_ACTIVE_LOW;
  62. /* Default setting: MSB first, disable unit transfer interrupt, SP_CYCLE = 0. */
  63. qspi->CTL = u32MasterSlave | (u32DataWidth << QSPI_CTL_DWIDTH_Pos) | (u32QSPIMode) | QSPI_CTL_QSPIEN_Msk;
  64. /* Set DIVIDER = 0 */
  65. qspi->CLKDIV = 0U;
  66. }
  67. return u32RetValue;
  68. }
  69. /**
  70. * @brief Disable QSPI controller.
  71. * @param[in] qspi The pointer of the specified QSPI module.
  72. * @return None
  73. * @details This function will reset QSPI controller.
  74. */
  75. void QSPI_Close(QSPI_T *qspi)
  76. {
  77. /* Reset QSPI */
  78. }
  79. /**
  80. * @brief Clear RX FIFO buffer.
  81. * @param[in] qspi The pointer of the specified QSPI module.
  82. * @return None
  83. * @details This function will clear QSPI RX FIFO buffer. The RXEMPTY (QSPI_STATUS[8]) will be set to 1.
  84. */
  85. void QSPI_ClearRxFIFO(QSPI_T *qspi)
  86. {
  87. qspi->FIFOCTL |= QSPI_FIFOCTL_RXFBCLR_Msk;
  88. }
  89. /**
  90. * @brief Clear TX FIFO buffer.
  91. * @param[in] qspi The pointer of the specified QSPI module.
  92. * @return None
  93. * @details This function will clear QSPI TX FIFO buffer. The TXEMPTY (QSPI_STATUS[16]) will be set to 1.
  94. * @note The TX shift register will not be cleared.
  95. */
  96. void QSPI_ClearTxFIFO(QSPI_T *qspi)
  97. {
  98. qspi->FIFOCTL |= QSPI_FIFOCTL_TXFBCLR_Msk;
  99. }
  100. /**
  101. * @brief Disable the automatic slave selection function.
  102. * @param[in] qspi The pointer of the specified QSPI module.
  103. * @return None
  104. * @details This function will disable the automatic slave selection function and set slave selection signal to inactive state.
  105. */
  106. void QSPI_DisableAutoSS(QSPI_T *qspi)
  107. {
  108. qspi->SSCTL &= ~(QSPI_SSCTL_AUTOSS_Msk | QSPI_SSCTL_SS_Msk);
  109. }
  110. /**
  111. * @brief Enable the automatic slave selection function.
  112. * @param[in] qspi The pointer of the specified QSPI module.
  113. * @param[in] u32SSPinMask Specifies slave selection pins. (QSPI_SS)
  114. * @param[in] u32ActiveLevel Specifies the active level of slave selection signal. (QSPI_SS_ACTIVE_HIGH, QSPI_SS_ACTIVE_LOW)
  115. * @return None
  116. * @details This function will enable the automatic slave selection function. Only available in Master mode.
  117. * The slave selection pin and the active level will be set in this function.
  118. */
  119. void QSPI_EnableAutoSS(QSPI_T *qspi, uint32_t u32SSPinMask, uint32_t u32ActiveLevel)
  120. {
  121. qspi->SSCTL = (qspi->SSCTL & (~(QSPI_SSCTL_AUTOSS_Msk | QSPI_SSCTL_SSACTPOL_Msk | QSPI_SSCTL_SS_Msk))) | (u32SSPinMask | u32ActiveLevel | QSPI_SSCTL_AUTOSS_Msk);
  122. }
  123. /**
  124. * @brief Set the QSPI bus clock.
  125. * @param[in] qspi The pointer of the specified QSPI module.
  126. * @param[in] u32BusClock The expected frequency of QSPI bus clock in Hz.
  127. * @return Actual frequency of QSPI bus clock.
  128. * @details This function is only available in Master mode. The actual clock rate may be different from the target QSPI bus clock rate.
  129. * For example, if the QSPI source clock rate is 12 MHz and the target QSPI bus clock rate is 7 MHz, the actual QSPI bus clock
  130. * rate will be 6 MHz.
  131. * @note If u32BusClock = 0, DIVIDER setting will be set to the maximum value.
  132. * @note If u32BusClock >= system clock frequency, QSPI peripheral clock source will be set to APB clock and DIVIDER will be set to 0.
  133. * @note If u32BusClock >= QSPI peripheral clock source, DIVIDER will be set to 0.
  134. */
  135. uint32_t QSPI_SetBusClock(QSPI_T *qspi, uint32_t u32BusClock)
  136. {
  137. return 0;
  138. }
  139. /**
  140. * @brief Configure FIFO threshold setting.
  141. * @param[in] qspi The pointer of the specified QSPI module.
  142. * @param[in] u32TxThreshold Decides the TX FIFO threshold. It could be 0 ~ 3.
  143. * @param[in] u32RxThreshold Decides the RX FIFO threshold. It could be 0 ~ 3.
  144. * @return None
  145. * @details Set TX FIFO threshold and RX FIFO threshold configurations.
  146. */
  147. void QSPI_SetFIFO(QSPI_T *qspi, uint32_t u32TxThreshold, uint32_t u32RxThreshold)
  148. {
  149. qspi->FIFOCTL = (qspi->FIFOCTL & ~(QSPI_FIFOCTL_TXTH_Msk | QSPI_FIFOCTL_RXTH_Msk)) |
  150. (u32TxThreshold << QSPI_FIFOCTL_TXTH_Pos) |
  151. (u32RxThreshold << QSPI_FIFOCTL_RXTH_Pos);
  152. }
  153. /**
  154. * @brief Get the actual frequency of QSPI bus clock. Only available in Master mode.
  155. * @param[in] qspi The pointer of the specified QSPI module.
  156. * @return Actual QSPI bus clock frequency in Hz.
  157. * @details This function will calculate the actual QSPI bus clock rate according to the QSPInSEL and DIVIDER settings. Only available in Master mode.
  158. */
  159. uint32_t QSPI_GetBusClock(QSPI_T *qspi)
  160. {
  161. /* Return QSPI bus clock rate */
  162. return 0;
  163. }
  164. /**
  165. * @brief Enable interrupt function.
  166. * @param[in] qspi The pointer of the specified QSPI module.
  167. * @param[in] u32Mask The combination of all related interrupt enable bits.
  168. * Each bit corresponds to a interrupt enable bit.
  169. * This parameter decides which interrupts will be enabled. It is combination of:
  170. * - \ref QSPI_UNIT_INT_MASK
  171. * - \ref QSPI_SSACT_INT_MASK
  172. * - \ref QSPI_SSINACT_INT_MASK
  173. * - \ref QSPI_SLVUR_INT_MASK
  174. * - \ref QSPI_SLVBE_INT_MASK
  175. * - \ref QSPI_TXUF_INT_MASK
  176. * - \ref QSPI_FIFO_TXTH_INT_MASK
  177. * - \ref QSPI_FIFO_RXTH_INT_MASK
  178. * - \ref QSPI_FIFO_RXOV_INT_MASK
  179. * - \ref QSPI_FIFO_RXTO_INT_MASK
  180. *
  181. * @return None
  182. * @details Enable QSPI related interrupts specified by u32Mask parameter.
  183. */
  184. void QSPI_EnableInt(QSPI_T *qspi, uint32_t u32Mask)
  185. {
  186. /* Enable unit transfer interrupt flag */
  187. if ((u32Mask & QSPI_UNIT_INT_MASK) == QSPI_UNIT_INT_MASK)
  188. {
  189. qspi->CTL |= QSPI_CTL_UNITIEN_Msk;
  190. }
  191. /* Enable slave selection signal active interrupt flag */
  192. if ((u32Mask & QSPI_SSACT_INT_MASK) == QSPI_SSACT_INT_MASK)
  193. {
  194. qspi->SSCTL |= QSPI_SSCTL_SSACTIEN_Msk;
  195. }
  196. /* Enable slave selection signal inactive interrupt flag */
  197. if ((u32Mask & QSPI_SSINACT_INT_MASK) == QSPI_SSINACT_INT_MASK)
  198. {
  199. qspi->SSCTL |= QSPI_SSCTL_SSINAIEN_Msk;
  200. }
  201. /* Enable slave TX under run interrupt flag */
  202. if ((u32Mask & QSPI_SLVUR_INT_MASK) == QSPI_SLVUR_INT_MASK)
  203. {
  204. qspi->SSCTL |= QSPI_SSCTL_SLVURIEN_Msk;
  205. }
  206. /* Enable slave bit count error interrupt flag */
  207. if ((u32Mask & QSPI_SLVBE_INT_MASK) == QSPI_SLVBE_INT_MASK)
  208. {
  209. qspi->SSCTL |= QSPI_SSCTL_SLVBEIEN_Msk;
  210. }
  211. /* Enable slave TX underflow interrupt flag */
  212. if ((u32Mask & QSPI_TXUF_INT_MASK) == QSPI_TXUF_INT_MASK)
  213. {
  214. qspi->FIFOCTL |= QSPI_FIFOCTL_TXUFIEN_Msk;
  215. }
  216. /* Enable TX threshold interrupt flag */
  217. if ((u32Mask & QSPI_FIFO_TXTH_INT_MASK) == QSPI_FIFO_TXTH_INT_MASK)
  218. {
  219. qspi->FIFOCTL |= QSPI_FIFOCTL_TXTHIEN_Msk;
  220. }
  221. /* Enable RX threshold interrupt flag */
  222. if ((u32Mask & QSPI_FIFO_RXTH_INT_MASK) == QSPI_FIFO_RXTH_INT_MASK)
  223. {
  224. qspi->FIFOCTL |= QSPI_FIFOCTL_RXTHIEN_Msk;
  225. }
  226. /* Enable RX overrun interrupt flag */
  227. if ((u32Mask & QSPI_FIFO_RXOV_INT_MASK) == QSPI_FIFO_RXOV_INT_MASK)
  228. {
  229. qspi->FIFOCTL |= QSPI_FIFOCTL_RXOVIEN_Msk;
  230. }
  231. /* Enable RX time-out interrupt flag */
  232. if ((u32Mask & QSPI_FIFO_RXTO_INT_MASK) == QSPI_FIFO_RXTO_INT_MASK)
  233. {
  234. qspi->FIFOCTL |= QSPI_FIFOCTL_RXTOIEN_Msk;
  235. }
  236. }
  237. /**
  238. * @brief Disable interrupt function.
  239. * @param[in] qspi The pointer of the specified QSPI module.
  240. * @param[in] u32Mask The combination of all related interrupt enable bits.
  241. * Each bit corresponds to a interrupt bit.
  242. * This parameter decides which interrupts will be disabled. It is combination of:
  243. * - \ref QSPI_UNIT_INT_MASK
  244. * - \ref QSPI_SSACT_INT_MASK
  245. * - \ref QSPI_SSINACT_INT_MASK
  246. * - \ref QSPI_SLVUR_INT_MASK
  247. * - \ref QSPI_SLVBE_INT_MASK
  248. * - \ref QSPI_TXUF_INT_MASK
  249. * - \ref QSPI_FIFO_TXTH_INT_MASK
  250. * - \ref QSPI_FIFO_RXTH_INT_MASK
  251. * - \ref QSPI_FIFO_RXOV_INT_MASK
  252. * - \ref QSPI_FIFO_RXTO_INT_MASK
  253. *
  254. * @return None
  255. * @details Disable QSPI related interrupts specified by u32Mask parameter.
  256. */
  257. void QSPI_DisableInt(QSPI_T *qspi, uint32_t u32Mask)
  258. {
  259. /* Disable unit transfer interrupt flag */
  260. if ((u32Mask & QSPI_UNIT_INT_MASK) == QSPI_UNIT_INT_MASK)
  261. {
  262. qspi->CTL &= ~QSPI_CTL_UNITIEN_Msk;
  263. }
  264. /* Disable slave selection signal active interrupt flag */
  265. if ((u32Mask & QSPI_SSACT_INT_MASK) == QSPI_SSACT_INT_MASK)
  266. {
  267. qspi->SSCTL &= ~QSPI_SSCTL_SSACTIEN_Msk;
  268. }
  269. /* Disable slave selection signal inactive interrupt flag */
  270. if ((u32Mask & QSPI_SSINACT_INT_MASK) == QSPI_SSINACT_INT_MASK)
  271. {
  272. qspi->SSCTL &= ~QSPI_SSCTL_SSINAIEN_Msk;
  273. }
  274. /* Disable slave TX under run interrupt flag */
  275. if ((u32Mask & QSPI_SLVUR_INT_MASK) == QSPI_SLVUR_INT_MASK)
  276. {
  277. qspi->SSCTL &= ~QSPI_SSCTL_SLVURIEN_Msk;
  278. }
  279. /* Disable slave bit count error interrupt flag */
  280. if ((u32Mask & QSPI_SLVBE_INT_MASK) == QSPI_SLVBE_INT_MASK)
  281. {
  282. qspi->SSCTL &= ~QSPI_SSCTL_SLVBEIEN_Msk;
  283. }
  284. /* Disable slave TX underflow interrupt flag */
  285. if ((u32Mask & QSPI_TXUF_INT_MASK) == QSPI_TXUF_INT_MASK)
  286. {
  287. qspi->FIFOCTL &= ~QSPI_FIFOCTL_TXUFIEN_Msk;
  288. }
  289. /* Disable TX threshold interrupt flag */
  290. if ((u32Mask & QSPI_FIFO_TXTH_INT_MASK) == QSPI_FIFO_TXTH_INT_MASK)
  291. {
  292. qspi->FIFOCTL &= ~QSPI_FIFOCTL_TXTHIEN_Msk;
  293. }
  294. /* Disable RX threshold interrupt flag */
  295. if ((u32Mask & QSPI_FIFO_RXTH_INT_MASK) == QSPI_FIFO_RXTH_INT_MASK)
  296. {
  297. qspi->FIFOCTL &= ~QSPI_FIFOCTL_RXTHIEN_Msk;
  298. }
  299. /* Disable RX overrun interrupt flag */
  300. if ((u32Mask & QSPI_FIFO_RXOV_INT_MASK) == QSPI_FIFO_RXOV_INT_MASK)
  301. {
  302. qspi->FIFOCTL &= ~QSPI_FIFOCTL_RXOVIEN_Msk;
  303. }
  304. /* Disable RX time-out interrupt flag */
  305. if ((u32Mask & QSPI_FIFO_RXTO_INT_MASK) == QSPI_FIFO_RXTO_INT_MASK)
  306. {
  307. qspi->FIFOCTL &= ~QSPI_FIFOCTL_RXTOIEN_Msk;
  308. }
  309. }
  310. /**
  311. * @brief Get interrupt flag.
  312. * @param[in] qspi The pointer of the specified QSPI module.
  313. * @param[in] u32Mask The combination of all related interrupt sources.
  314. * Each bit corresponds to a interrupt source.
  315. * This parameter decides which interrupt flags will be read. It is combination of:
  316. * - \ref QSPI_UNIT_INT_MASK
  317. * - \ref QSPI_SSACT_INT_MASK
  318. * - \ref QSPI_SSINACT_INT_MASK
  319. * - \ref QSPI_SLVUR_INT_MASK
  320. * - \ref QSPI_SLVBE_INT_MASK
  321. * - \ref QSPI_TXUF_INT_MASK
  322. * - \ref QSPI_FIFO_TXTH_INT_MASK
  323. * - \ref QSPI_FIFO_RXTH_INT_MASK
  324. * - \ref QSPI_FIFO_RXOV_INT_MASK
  325. * - \ref QSPI_FIFO_RXTO_INT_MASK
  326. *
  327. * @return Interrupt flags of selected sources.
  328. * @details Get QSPI related interrupt flags specified by u32Mask parameter.
  329. */
  330. uint32_t QSPI_GetIntFlag(QSPI_T *qspi, uint32_t u32Mask)
  331. {
  332. uint32_t u32IntFlag = 0U, u32TmpVal;
  333. u32TmpVal = qspi->STATUS & QSPI_STATUS_UNITIF_Msk;
  334. /* Check unit transfer interrupt flag */
  335. if ((u32Mask & QSPI_UNIT_INT_MASK) && (u32TmpVal))
  336. {
  337. u32IntFlag |= QSPI_UNIT_INT_MASK;
  338. }
  339. u32TmpVal = qspi->STATUS & QSPI_STATUS_SSACTIF_Msk;
  340. /* Check slave selection signal active interrupt flag */
  341. if ((u32Mask & QSPI_SSACT_INT_MASK) && (u32TmpVal))
  342. {
  343. u32IntFlag |= QSPI_SSACT_INT_MASK;
  344. }
  345. u32TmpVal = qspi->STATUS & QSPI_STATUS_SSINAIF_Msk;
  346. /* Check slave selection signal inactive interrupt flag */
  347. if ((u32Mask & QSPI_SSINACT_INT_MASK) && (u32TmpVal))
  348. {
  349. u32IntFlag |= QSPI_SSINACT_INT_MASK;
  350. }
  351. u32TmpVal = qspi->STATUS & QSPI_STATUS_SLVURIF_Msk;
  352. /* Check slave TX under run interrupt flag */
  353. if ((u32Mask & QSPI_SLVUR_INT_MASK) && (u32TmpVal))
  354. {
  355. u32IntFlag |= QSPI_SLVUR_INT_MASK;
  356. }
  357. u32TmpVal = qspi->STATUS & QSPI_STATUS_SLVBEIF_Msk;
  358. /* Check slave bit count error interrupt flag */
  359. if ((u32Mask & QSPI_SLVBE_INT_MASK) && (u32TmpVal))
  360. {
  361. u32IntFlag |= QSPI_SLVBE_INT_MASK;
  362. }
  363. u32TmpVal = qspi->STATUS & QSPI_STATUS_TXUFIF_Msk;
  364. /* Check slave TX underflow interrupt flag */
  365. if ((u32Mask & QSPI_TXUF_INT_MASK) && (u32TmpVal))
  366. {
  367. u32IntFlag |= QSPI_TXUF_INT_MASK;
  368. }
  369. u32TmpVal = qspi->STATUS & QSPI_STATUS_TXTHIF_Msk;
  370. /* Check TX threshold interrupt flag */
  371. if ((u32Mask & QSPI_FIFO_TXTH_INT_MASK) && (u32TmpVal))
  372. {
  373. u32IntFlag |= QSPI_FIFO_TXTH_INT_MASK;
  374. }
  375. u32TmpVal = qspi->STATUS & QSPI_STATUS_RXTHIF_Msk;
  376. /* Check RX threshold interrupt flag */
  377. if ((u32Mask & QSPI_FIFO_RXTH_INT_MASK) && (u32TmpVal))
  378. {
  379. u32IntFlag |= QSPI_FIFO_RXTH_INT_MASK;
  380. }
  381. u32TmpVal = qspi->STATUS & QSPI_STATUS_RXOVIF_Msk;
  382. /* Check RX overrun interrupt flag */
  383. if ((u32Mask & QSPI_FIFO_RXOV_INT_MASK) && (u32TmpVal))
  384. {
  385. u32IntFlag |= QSPI_FIFO_RXOV_INT_MASK;
  386. }
  387. u32TmpVal = qspi->STATUS & QSPI_STATUS_RXTOIF_Msk;
  388. /* Check RX time-out interrupt flag */
  389. if ((u32Mask & QSPI_FIFO_RXTO_INT_MASK) && (u32TmpVal))
  390. {
  391. u32IntFlag |= QSPI_FIFO_RXTO_INT_MASK;
  392. }
  393. return u32IntFlag;
  394. }
  395. /**
  396. * @brief Clear interrupt flag.
  397. * @param[in] qspi The pointer of the specified QSPI module.
  398. * @param[in] u32Mask The combination of all related interrupt sources.
  399. * Each bit corresponds to a interrupt source.
  400. * This parameter decides which interrupt flags will be cleared. It could be the combination of:
  401. * - \ref QSPI_UNIT_INT_MASK
  402. * - \ref QSPI_SSACT_INT_MASK
  403. * - \ref QSPI_SSINACT_INT_MASK
  404. * - \ref QSPI_SLVUR_INT_MASK
  405. * - \ref QSPI_SLVBE_INT_MASK
  406. * - \ref QSPI_TXUF_INT_MASK
  407. * - \ref QSPI_FIFO_RXOV_INT_MASK
  408. * - \ref QSPI_FIFO_RXTO_INT_MASK
  409. *
  410. * @return None
  411. * @details Clear QSPI related interrupt flags specified by u32Mask parameter.
  412. */
  413. void QSPI_ClearIntFlag(QSPI_T *qspi, uint32_t u32Mask)
  414. {
  415. if (u32Mask & QSPI_UNIT_INT_MASK)
  416. {
  417. qspi->STATUS = QSPI_STATUS_UNITIF_Msk; /* Clear unit transfer interrupt flag */
  418. }
  419. if (u32Mask & QSPI_SSACT_INT_MASK)
  420. {
  421. qspi->STATUS = QSPI_STATUS_SSACTIF_Msk; /* Clear slave selection signal active interrupt flag */
  422. }
  423. if (u32Mask & QSPI_SSINACT_INT_MASK)
  424. {
  425. qspi->STATUS = QSPI_STATUS_SSINAIF_Msk; /* Clear slave selection signal inactive interrupt flag */
  426. }
  427. if (u32Mask & QSPI_SLVUR_INT_MASK)
  428. {
  429. qspi->STATUS = QSPI_STATUS_SLVURIF_Msk; /* Clear slave TX under run interrupt flag */
  430. }
  431. if (u32Mask & QSPI_SLVBE_INT_MASK)
  432. {
  433. qspi->STATUS = QSPI_STATUS_SLVBEIF_Msk; /* Clear slave bit count error interrupt flag */
  434. }
  435. if (u32Mask & QSPI_TXUF_INT_MASK)
  436. {
  437. qspi->STATUS = QSPI_STATUS_TXUFIF_Msk; /* Clear slave TX underflow interrupt flag */
  438. }
  439. if (u32Mask & QSPI_FIFO_RXOV_INT_MASK)
  440. {
  441. qspi->STATUS = QSPI_STATUS_RXOVIF_Msk; /* Clear RX overrun interrupt flag */
  442. }
  443. if (u32Mask & QSPI_FIFO_RXTO_INT_MASK)
  444. {
  445. qspi->STATUS = QSPI_STATUS_RXTOIF_Msk; /* Clear RX time-out interrupt flag */
  446. }
  447. }
  448. /**
  449. * @brief Get QSPI status.
  450. * @param[in] qspi The pointer of the specified QSPI module.
  451. * @param[in] u32Mask The combination of all related sources.
  452. * Each bit corresponds to a source.
  453. * This parameter decides which flags will be read. It is combination of:
  454. * - \ref QSPI_BUSY_MASK
  455. * - \ref QSPI_RX_EMPTY_MASK
  456. * - \ref QSPI_RX_FULL_MASK
  457. * - \ref QSPI_TX_EMPTY_MASK
  458. * - \ref QSPI_TX_FULL_MASK
  459. * - \ref QSPI_TXRX_RESET_MASK
  460. * - \ref QSPI_QSPIEN_STS_MASK
  461. * - \ref QSPI_SSLINE_STS_MASK
  462. *
  463. * @return Flags of selected sources.
  464. * @details Get QSPI related status specified by u32Mask parameter.
  465. */
  466. uint32_t QSPI_GetStatus(QSPI_T *qspi, uint32_t u32Mask)
  467. {
  468. uint32_t u32Flag = 0U, u32TmpValue;
  469. u32TmpValue = qspi->STATUS & QSPI_STATUS_BUSY_Msk;
  470. /* Check busy status */
  471. if ((u32Mask & QSPI_BUSY_MASK) && (u32TmpValue))
  472. {
  473. u32Flag |= QSPI_BUSY_MASK;
  474. }
  475. u32TmpValue = qspi->STATUS & QSPI_STATUS_RXEMPTY_Msk;
  476. /* Check RX empty flag */
  477. if ((u32Mask & QSPI_RX_EMPTY_MASK) && (u32TmpValue))
  478. {
  479. u32Flag |= QSPI_RX_EMPTY_MASK;
  480. }
  481. u32TmpValue = qspi->STATUS & QSPI_STATUS_RXFULL_Msk;
  482. /* Check RX full flag */
  483. if ((u32Mask & QSPI_RX_FULL_MASK) && (u32TmpValue))
  484. {
  485. u32Flag |= QSPI_RX_FULL_MASK;
  486. }
  487. u32TmpValue = qspi->STATUS & QSPI_STATUS_TXEMPTY_Msk;
  488. /* Check TX empty flag */
  489. if ((u32Mask & QSPI_TX_EMPTY_MASK) && (u32TmpValue))
  490. {
  491. u32Flag |= QSPI_TX_EMPTY_MASK;
  492. }
  493. u32TmpValue = qspi->STATUS & QSPI_STATUS_TXFULL_Msk;
  494. /* Check TX full flag */
  495. if ((u32Mask & QSPI_TX_FULL_MASK) && (u32TmpValue))
  496. {
  497. u32Flag |= QSPI_TX_FULL_MASK;
  498. }
  499. u32TmpValue = qspi->STATUS & QSPI_STATUS_TXRXRST_Msk;
  500. /* Check TX/RX reset flag */
  501. if ((u32Mask & QSPI_TXRX_RESET_MASK) && (u32TmpValue))
  502. {
  503. u32Flag |= QSPI_TXRX_RESET_MASK;
  504. }
  505. u32TmpValue = qspi->STATUS & QSPI_STATUS_QSPIENSTS_Msk;
  506. /* Check QSPIEN flag */
  507. if ((u32Mask & QSPI_QSPIEN_STS_MASK) && (u32TmpValue))
  508. {
  509. u32Flag |= QSPI_QSPIEN_STS_MASK;
  510. }
  511. u32TmpValue = qspi->STATUS & QSPI_STATUS_SSLINE_Msk;
  512. /* Check QSPIx_SS line status */
  513. if ((u32Mask & QSPI_SSLINE_STS_MASK) && (u32TmpValue))
  514. {
  515. u32Flag |= QSPI_SSLINE_STS_MASK;
  516. }
  517. return u32Flag;
  518. }
  519. /*@}*/ /* end of group QSPI_EXPORTED_FUNCTIONS */
  520. /*@}*/ /* end of group QSPI_Driver */
  521. /*@}*/ /* end of group Standard_Driver */
  522. /*** (C) COPYRIGHT 2018 Nuvoton Technology Corp. ***/