AM263Px MCU+ SDK  09.01.00
mcspi_lld.h
Go to the documentation of this file.
1 /*
2  * Copyright (C) 2023 Texas Instruments Incorporated
3  *
4  * Redistribution and use in source and binary forms, with or without
5  * modification, are permitted provided that the following conditions
6  * are met:
7  *
8  * Redistributions of source code must retain the above copyright
9  * notice, this list of conditions and the following disclaimer.
10  *
11  * Redistributions in binary form must reproduce the above copyright
12  * notice, this list of conditions and the following disclaimer in the
13  * documentation and/or other materials provided with the
14  * distribution.
15  *
16  * Neither the name of Texas Instruments Incorporated nor the names of
17  * its contributors may be used to endorse or promote products derived
18  * from this software without specific prior written permission.
19  *
20  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
21  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
22  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
23  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
24  * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
25  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
26  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
27  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
28  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
29  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
30  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
31  */
32 
50 #ifndef MCSPI_LLD_H_
51 #define MCSPI_LLD_H_
52 
53 /* ========================================================================== */
54 /* Include Files */
55 /* ========================================================================== */
56 #include <stdint.h>
57 #include <stdbool.h>
58 #include <drivers/hw_include/csl_types.h>
59 #include <drivers/hw_include/cslr_mcspi.h>
60 #include <drivers/hw_include/cslr.h>
61 
62 #ifdef __cplusplus
63 extern "C" {
64 #endif
65 
66 /* ========================================================================== */
67 /* Macros & Typedefs */
68 /* ========================================================================== */
69 
70 /* pointer for DMA Handle */
71 typedef void *MCSPI_DmaHandle;
72 /* pointer for DMA Channel Config */
73 typedef void *MCSPI_DmaChConfig;
74 
75 /* function pointer to get clock ticks */
76 typedef uint32_t (*MCSPI_clockGet) (void);
77 
78 
85 #define MCSPI_STATUS_SUCCESS ((int32_t)0)
86 
90 #define MCSPI_STATUS_FAILURE ((int32_t)-1)
91 
95 #define MCSPI_TIMEOUT ((int32_t)-2)
96 
100 #define MCSPI_INVALID_PARAM ((int32_t)-3)
101 
105 #define MCSPI_STATUS_BUSY ((int32_t)-4)
106 
110 #define MCSPI_INVALID_STATE ((int32_t)-5)
111 
120 #define MCSPI_NO_WAIT ((uint32_t)0)
121 
125 #define MCSPI_WAIT_FOREVER ((uint32_t)-1)
126 
134 #define MCSPI_STATE_RESET ((uint32_t)0U)
135 
139 #define MCSPI_STATE_READY ((uint32_t)1U)
140 
144 #define MCSPI_STATE_BUSY ((uint32_t)2U)
145 
149 #define MCSPI_STATE_ERROR ((uint32_t)3U)
150 
161 #define MCSPI_CHANNEL_0 (0U)
162 #define MCSPI_CHANNEL_1 (1U)
163 #define MCSPI_CHANNEL_2 (2U)
164 #define MCSPI_CHANNEL_3 (3U)
165 
175 #define MCSPI_OPER_MODE_POLLED (0U)
176 #define MCSPI_OPER_MODE_INTERRUPT (1U)
177 #define MCSPI_OPER_MODE_DMA (2U)
178 
181 #define MCSPI_MAX_NUM_CHANNELS (4U)
182 
191 #define MCSPI_TRANSFER_COMPLETED ((int32_t)0U)
192 #define MCSPI_TRANSFER_STARTED ((int32_t)1U)
193 #define MCSPI_TRANSFER_CANCELLED ((int32_t)2U)
194 #define MCSPI_TRANSFER_FAILED ((int32_t)3U)
195 #define MCSPI_TRANSFER_CSN_DEASSERT ((int32_t)4U)
196 #define MCSPI_TRANSFER_TIMEOUT ((int32_t)5U)
197 
215 #define MCSPI_MS_MODE_CONTROLLER (CSL_MCSPI_MODULCTRL_MS_MASTER)
216 
217 #define MCSPI_MS_MODE_PERIPHERAL (CSL_MCSPI_MODULCTRL_MS_SLAVE)
218 
234 #define MCSPI_FF_POL0_PHA0 (0U)
235 #define MCSPI_FF_POL0_PHA1 (1U)
236 #define MCSPI_FF_POL1_PHA0 (2U)
237 #define MCSPI_FF_POL1_PHA1 (3U)
238 
249 #define MCSPI_CS_POL_HIGH (CSL_MCSPI_CH0CONF_EPOL_ACTIVEHIGH)
250 
251 #define MCSPI_CS_POL_LOW (CSL_MCSPI_CH0CONF_EPOL_ACTIVELOW)
252 
260 #define MCSPI_TR_MODE_TX_RX (CSL_MCSPI_CH0CONF_TRM_TRANSRECEI)
261 #define MCSPI_TR_MODE_RX_ONLY (CSL_MCSPI_CH0CONF_TRM_RECEIVONLY)
262 #define MCSPI_TR_MODE_TX_ONLY (CSL_MCSPI_CH0CONF_TRM_TRANSONLY)
263 
272 #define MCSPI_IS_D0 (CSL_MCSPI_CH0CONF_IS_LINE0)
273 
274 #define MCSPI_IS_D1 (CSL_MCSPI_CH0CONF_IS_LINE1)
275 
284 #define MCSPI_DPE_ENABLE (CSL_MCSPI_CH0CONF_DPE0_ENABLED)
285 
286 #define MCSPI_DPE_DISABLE (CSL_MCSPI_CH0CONF_DPE0_DISABLED)
287 
295 #define MCSPI_SLV_CS_SELECT_0 (CSL_MCSPI_CH0CONF_SPIENSLV_SPIEN0)
296 #define MCSPI_SLV_CS_SELECT_1 (CSL_MCSPI_CH0CONF_SPIENSLV_SPIEN1)
297 #define MCSPI_SLV_CS_SELECT_2 (CSL_MCSPI_CH0CONF_SPIENSLV_SPIEN2)
298 #define MCSPI_SLV_CS_SELECT_3 (CSL_MCSPI_CH0CONF_SPIENSLV_SPIEN3)
299 
308 #define MCSPI_SB_POL_HIGH (CSL_MCSPI_CH0CONF_SBPOL_HIGHLEVEL)
309 
310 #define MCSPI_SB_POL_LOW (CSL_MCSPI_CH0CONF_SBPOL_LOWLEVEL)
311 
322 #define MCSPI_TCS0_0_CLK (CSL_MCSPI_CH0CONF_TCS0_ZEROCYCLEDLY)
323 
324 #define MCSPI_TCS0_1_CLK (CSL_MCSPI_CH0CONF_TCS0_ONECYCLEDLY)
325 
326 #define MCSPI_TCS0_2_CLK (CSL_MCSPI_CH0CONF_TCS0_TWOCYCLEDLY)
327 
328 #define MCSPI_TCS0_3_CLK (CSL_MCSPI_CH0CONF_TCS0_THREECYCLEDLY)
329 
341 #define MCSPI_CH_MODE_SINGLE (CSL_MCSPI_MODULCTRL_SINGLE_SINGLE)
342 
343 #define MCSPI_CH_MODE_MULTI (CSL_MCSPI_MODULCTRL_SINGLE_MULTI)
344 
356 #define MCSPI_PINMODE_3PIN (CSL_MCSPI_MODULCTRL_PIN34_3PINMODE)
357 #define MCSPI_PINMODE_4PIN (CSL_MCSPI_MODULCTRL_PIN34_4PINMODE)
358 
369 #define MCSPI_INITDLY_0 (CSL_MCSPI_MODULCTRL_INITDLY_NODELAY)
370 
371 #define MCSPI_INITDLY_4 (CSL_MCSPI_MODULCTRL_INITDLY_4CLKDLY)
372 
373 #define MCSPI_INITDLY_8 (CSL_MCSPI_MODULCTRL_INITDLY_8CLKDLY)
374 
375 #define MCSPI_INITDLY_16 (CSL_MCSPI_MODULCTRL_INITDLY_16CLKDLY)
376 
377 #define MCSPI_INITDLY_32 (CSL_MCSPI_MODULCTRL_INITDLY_32CLKDLY)
378 
381 #define MCSPI_ERROR_TX_UNDERFLOW (0x00000001U)
382 #define MCSPI_ERROR_RX_OVERFLOW (0x00000002U)
383 
384 /* ========================================================================== */
385 /* Advanced Macros & Typedefs */
386 /* ========================================================================== */
387 
389 #define MCSPI_FIFO_LENGTH (64U)
390 
393 #define MCSPI_RX_FIFO_ENABLE ((uint32_t) CSL_MCSPI_CH0CONF_FFER_FFENABLED \
394  << \
395  CSL_MCSPI_CH0CONF_FFER_SHIFT)
396 
400 #define MCSPI_RX_FIFO_DISABLE ((uint32_t) CSL_MCSPI_CH0CONF_FFER_FFDISABLED \
401  << CSL_MCSPI_CH0CONF_FFER_SHIFT)
402 
406 #define MCSPI_TX_FIFO_ENABLE ((uint32_t) CSL_MCSPI_CH0CONF_FFEW_FFENABLED \
407  << CSL_MCSPI_CH0CONF_FFEW_SHIFT)
408 
412 #define MCSPI_TX_FIFO_DISABLE ((uint32_t) CSL_MCSPI_CH0CONF_FFEW_FFDISABLED \
413  << CSL_MCSPI_CH0CONF_FFEW_SHIFT)
414 
418 #define MCSPI_REG_OFFSET (0x14U)
419 
420 #define MCSPI_CHCONF(x) ((uint32_t) CSL_MCSPI_CH0CONF + \
421  (uint32_t) ((uint32_t) MCSPI_REG_OFFSET * \
422  (uint32_t) (x)))
423 
424 #define MCSPI_CHSTAT(x) ((uint32_t) CSL_MCSPI_CH0STAT + \
425  (uint32_t) ((uint32_t) MCSPI_REG_OFFSET * \
426  (uint32_t) (x)))
427 
428 #define MCSPI_CHCTRL(x) ((uint32_t) CSL_MCSPI_CH0CTRL + \
429  (uint32_t) ((uint32_t) MCSPI_REG_OFFSET * \
430  (uint32_t) (x)))
431 
432 #define MCSPI_CHTX(x) ((uint32_t) CSL_MCSPI_TX0 + \
433  (uint32_t) ((uint32_t) MCSPI_REG_OFFSET * \
434  (uint32_t) (x)))
435 
436 #define MCSPI_CHRX(x) ((uint32_t) CSL_MCSPI_RX0 + \
437  (uint32_t) ((uint32_t) MCSPI_REG_OFFSET * \
438  (uint32_t) (x)))
439 
440 #define MCSPI_CLKD_MASK (0x0FU)
441 
443 #define MCSPI_IRQSTATUS_CLEAR_ALL (CSL_MCSPI_IRQSTATUS_EOW_MASK | \
444  CSL_MCSPI_IRQSTATUS_WKS_MASK | \
445  CSL_MCSPI_IRQSTATUS_RX3_FULL_MASK | \
446  CSL_MCSPI_IRQSTATUS_TX3_UNDERFLOW_MASK | \
447  CSL_MCSPI_IRQSTATUS_TX3_EMPTY_MASK | \
448  CSL_MCSPI_IRQSTATUS_RX2_FULL_MASK | \
449  CSL_MCSPI_IRQSTATUS_TX2_UNDERFLOW_MASK | \
450  CSL_MCSPI_IRQSTATUS_TX2_EMPTY_MASK | \
451  CSL_MCSPI_IRQSTATUS_RX1_FULL_MASK | \
452  CSL_MCSPI_IRQSTATUS_TX1_UNDERFLOW_MASK | \
453  CSL_MCSPI_IRQSTATUS_TX1_EMPTY_MASK | \
454  CSL_MCSPI_IRQSTATUS_RX0_OVERFLOW_MASK | \
455  CSL_MCSPI_IRQSTATUS_RX0_FULL_MASK | \
456  CSL_MCSPI_IRQSTATUS_TX0_UNDERFLOW_MASK | \
457  CSL_MCSPI_IRQSTATUS_TX0_EMPTY_MASK)
458 
459 /* ========================================================================== */
460 /* Structure Declarations */
461 /* ========================================================================== */
462 
471 typedef struct
472 {
473  uint32_t channel;
476  uint32_t csDisable;
482  uint32_t dataSize;
493  uint32_t count;
496  void *txBuf;
507  void *rxBuf;
514  void *args;
516  uint32_t timeout;
518  uint32_t status;
521 
528 typedef struct MCSPI_ExtendedParams_s
529 {
530  uint32_t channel;
533  uint32_t csDisable;
539  uint32_t dataSize;
551 
563 typedef struct
564 {
565  uint32_t chNum;
567  uint32_t frameFormat;
569  uint32_t bitRate;
571  uint32_t csPolarity;
573  uint32_t trMode;
575  uint32_t inputSelect;
577  uint32_t dpe0;
579  uint32_t dpe1;
581  uint32_t slvCsSelect;
584  uint32_t startBitEnable;
590  uint32_t turboEnable;
592  uint32_t csIdleTime;
595  uint32_t defaultTxData;
598  uint32_t txFifoTrigLvl;
600  uint32_t rxFifoTrigLvl;
603 
604 /* ========================================================================== */
605 /* Function pointers Declarations */
606 /* ========================================================================== */
607 
614 typedef void (*MCSPI_transferCallbackFxn) (void *args, uint32_t tansferStatus);
615 
622 typedef void (*MCSPI_errorCallbackFxn) (void *args);
623 
624 /* ========================================================================== */
625 /* Internal/Private Structure Declarations */
626 /* ========================================================================== */
627 
631 typedef struct
632 {
633  /*
634  * User parameters
635  */
639  /*
640  * State variables
641  */
642  uint32_t isOpen;
644  uint32_t csDisable;
646  uint32_t csEnable;
648  uint8_t *curTxBufPtr;
650  uint8_t *curRxBufPtr;
652  uint32_t curTxWords;
656  uint32_t curRxWords;
659  /*
660  * MCSPI derived variables
661  */
662  uint8_t bufWidthShift;
670  uint32_t effTxFifoDepth;
672  uint32_t effRxFifoDepth;
674  uint32_t intrMask;
678  uint32_t chConfRegVal;
680  uint32_t chCtrlRegVal;
682  uint32_t systRegVal;
684 
688 typedef struct
689 {
690  uint32_t inputClkFreq;
692  uint32_t intrNum;
694  uint32_t operMode;
696  uint8_t intrPriority;
698  uint32_t chMode;
700  uint32_t pinMode;
702  uint32_t initDelay;
704  uint32_t multiWordAccess;
706  uint32_t msMode;
708  uint32_t chCnt;
715  /* clock usec to tick */
721 
725 typedef struct
726 {
727  uint32_t baseAddr;
730  /*
731  * User parameters
732  */
733  uint32_t state;
739  uint32_t errorFlag;
742  /*
743  * Transfer parameters
744  */
745  uint32_t transferChannel;
753  void* args;
756 
757 /* ========================================================================== */
758 /* Function Declarations */
759 /* ========================================================================== */
760 
761 /* Low level HW functions */
762 void MCSPI_reset(uint32_t baseAddr);
763 void MCSPI_clearAllIrqStatus(uint32_t baseAddr);
764 void MCSPI_stop(MCSPILLD_Handle hMcspi, MCSPI_ChObject *chObj, uint32_t chNum);
765 void MCSPI_setChDataSize(uint32_t baseAddr, MCSPI_ChObject *chObj,
766  uint32_t dataSize, uint32_t csDisable);
767 
768 static inline void MCSPI_intrStatusClear(const MCSPI_ChObject *chObj,
769  uint32_t baseAddr, uint32_t intFlags)
770 {
771  /* Clear the SSB bit in the MCSPI_SYST register. */
772  CSL_REG32_WR(baseAddr + CSL_MCSPI_SYST, chObj->systRegVal);
773  /* Clear the interrupt status. */
774  CSL_REG32_WR(baseAddr + CSL_MCSPI_IRQSTATUS, intFlags);
775 }
776 
777 /* ========================================================================== */
778 /* Function Declarations */
779 /* ========================================================================== */
780 
790 
809 
819 
832 int32_t MCSPI_lld_write(MCSPILLD_Handle hMcspi, void *txBuf, uint32_t count, uint32_t timeout,
833  const MCSPI_ExtendedParams *extendedParams);
834 
847 int32_t MCSPI_lld_writeIntr(MCSPILLD_Handle hMcspi, void *txBuf, uint32_t count, uint32_t timeout,
848  const MCSPI_ExtendedParams *extendedParams);
849 
862 int32_t MCSPI_lld_writeDma(MCSPILLD_Handle hMcspi, void * txBuf, uint32_t count,
863  uint32_t timeout, const MCSPI_ExtendedParams *extendedParams);
864 
877 int32_t MCSPI_lld_read(MCSPILLD_Handle hMcspi, void * rxBuf, uint32_t count, uint32_t timeout,
878  const MCSPI_ExtendedParams *extendedParams);
879 
892 int32_t MCSPI_lld_readIntr(MCSPILLD_Handle hMcspi, void * rxBuf, uint32_t count, uint32_t timeout,
893  const MCSPI_ExtendedParams *extendedParams);
894 
908 int32_t MCSPI_lld_readDma(MCSPILLD_Handle hMcspi, void * rxBuf, uint32_t count,
909  uint32_t timeout, const MCSPI_ExtendedParams *extendedParams);
922 int32_t MCSPI_lld_readWrite(MCSPILLD_Handle hMcspi, void *txBuf, void *rxBuf, uint32_t count,
923  uint32_t timeout, const MCSPI_ExtendedParams *extendedParams);
936 int32_t MCSPI_lld_readWriteIntr(MCSPILLD_Handle hMcspi, void *txBuf, void *rxBuf, uint32_t count,
937  uint32_t timeout, const MCSPI_ExtendedParams *extendedParams);
950 int32_t MCSPI_lld_readWriteDma(MCSPILLD_Handle hMcspi, void *txBuf, void *rxBuf, uint32_t count,
951  uint32_t timeout, const MCSPI_ExtendedParams *extendedParams);
952 
962 
972 
983 
994 
1005 
1013 
1021 
1029 
1039 
1049 
1056 static inline void MCSPI_lld_ChConfig_init(MCSPI_ChConfig *chConfig);
1057 
1064 static inline void MCSPI_lld_Transaction_init(MCSPI_Transaction *trans);
1065 
1075 
1088  uint32_t chNum,
1089  uint32_t numWordsRxTx);
1090 
1105 static inline uint8_t MCSPI_getBufWidthShift(uint32_t dataSize);
1106 
1130 static inline uint32_t MCSPI_readChStatusReg(uint32_t baseAddr, uint32_t chNum);
1131 
1142 static inline uint32_t MCSPI_readChCtrlReg(uint32_t baseAddr, uint32_t chNum);
1143 
1153 static inline void MCSPI_writeChCtrlReg(uint32_t baseAddr, uint32_t chNum,
1154  uint32_t regVal);
1155 
1166 static inline uint32_t MCSPI_readChConf(uint32_t baseAddr, uint32_t chNum);
1167 
1177 static inline void MCSPI_writeChConfReg(uint32_t baseAddr, uint32_t chNum,
1178  uint32_t regVal);
1179 
1196 static inline void MCSPI_writeTxDataReg(uint32_t baseAddr,
1197  uint32_t txData,
1198  uint32_t chNum);
1199 
1219 static inline void MCSPI_enableTxFIFO(uint32_t baseAddr, uint32_t chNum,
1220  uint32_t enableFlag);
1221 
1241 static inline void MCSPI_enableRxFIFO(uint32_t baseAddr, uint32_t chNum,
1242  uint32_t enableFlag);
1243 
1259 static inline uint32_t MCSPI_readRxDataReg(uint32_t baseAddr,
1260  uint32_t chNum);
1261 
1278 static inline void MCSPI_setDataWidth(uint32_t baseAddr, uint32_t chNum,
1279  uint32_t dataWidth);
1280 
1281 /* ========================================================================== */
1282 /* Static Function Definitions */
1283 /* ========================================================================== */
1284 
1285 static inline void MCSPI_lld_ChConfig_init(MCSPI_ChConfig *chConfig)
1286 {
1287  if(chConfig != NULL)
1288  {
1289  chConfig->chNum = MCSPI_CHANNEL_0;
1290  chConfig->frameFormat = MCSPI_FF_POL0_PHA0;
1291  chConfig->bitRate = 1000000U;
1292  chConfig->csPolarity = MCSPI_CS_POL_LOW;
1293  chConfig->trMode = MCSPI_TR_MODE_TX_RX;
1294  chConfig->inputSelect = MCSPI_IS_D1;
1295  chConfig->dpe0 = MCSPI_DPE_ENABLE;
1296  chConfig->dpe1 = MCSPI_DPE_DISABLE;
1297  chConfig->slvCsSelect = MCSPI_SLV_CS_SELECT_0;
1298  chConfig->startBitEnable = FALSE;
1299  chConfig->startBitPolarity = MCSPI_SB_POL_LOW;
1300  chConfig->csIdleTime = MCSPI_TCS0_0_CLK;
1301  chConfig->defaultTxData = 0x00000000U;
1302  }
1303 }
1304 
1306 {
1307  if(trans != NULL)
1308  {
1309  trans->channel = 0U;
1310  trans->csDisable = TRUE;
1311  trans->dataSize = 8U;
1312  trans->count = 0U;
1313  trans->txBuf = NULL;
1314  trans->rxBuf = NULL;
1315  trans->args = NULL;
1316  trans->timeout = MCSPI_WAIT_FOREVER;
1317  }
1318 }
1319 
1320 static inline uint8_t MCSPI_getBufWidthShift(uint32_t dataSize)
1321 {
1322  uint8_t bufWidthShift = 0U;
1323 
1324  if(dataSize <= 8U)
1325  {
1326  bufWidthShift = 0U;
1327  }
1328  else if(dataSize <= 16U)
1329  {
1330  bufWidthShift = 1U;
1331  }
1332  else
1333  {
1334  bufWidthShift = 2U;
1335  }
1336 
1337  return bufWidthShift;
1338 }
1339 
1340 static inline uint32_t MCSPI_readChStatusReg(uint32_t baseAddr, uint32_t chNum)
1341 {
1342  /* Return the status from MCSPI_CHSTAT register. */
1343  return (CSL_REG32_RD(baseAddr + MCSPI_CHSTAT(chNum)));
1344 }
1345 
1346 static inline uint32_t MCSPI_readChCtrlReg(uint32_t baseAddr, uint32_t chNum)
1347 {
1348  return CSL_REG32_RD(baseAddr + MCSPI_CHCTRL(chNum));
1349 }
1350 
1351 static inline void MCSPI_writeChCtrlReg(uint32_t baseAddr, uint32_t chNum,
1352  uint32_t regVal)
1353 {
1354  CSL_REG32_WR(baseAddr + MCSPI_CHCTRL(chNum), regVal);
1355 }
1356 
1357 static inline uint32_t MCSPI_readChConf(uint32_t baseAddr, uint32_t chNum)
1358 {
1359  return CSL_REG32_RD(baseAddr + MCSPI_CHCONF(chNum));
1360 }
1361 
1362 static inline void MCSPI_writeChConfReg(uint32_t baseAddr, uint32_t chNum,
1363  uint32_t regVal)
1364 {
1365  CSL_REG32_WR(baseAddr + MCSPI_CHCONF(chNum), regVal);
1366 }
1367 
1368 static inline void MCSPI_writeTxDataReg(uint32_t baseAddr,
1369  uint32_t txData,
1370  uint32_t chNum)
1371 {
1372  /* Load the MCSPI_TX register with the data to be transmitted */
1373  CSL_REG32_WR(baseAddr + MCSPI_CHTX(chNum), txData);
1374 }
1375 
1376 static inline void MCSPI_enableTxFIFO(uint32_t baseAddr,
1377  uint32_t chNum,
1378  uint32_t enableFlag)
1379 {
1380  /* Set the FFEW field with user sent value. */
1381  CSL_REG32_FINS(
1382  baseAddr + MCSPI_CHCONF(chNum),
1383  MCSPI_CH0CONF_FFEW,
1384  enableFlag >> CSL_MCSPI_CH0CONF_FFEW_SHIFT);
1385 }
1386 
1387 static inline void MCSPI_enableRxFIFO(uint32_t baseAddr,
1388  uint32_t chNum,
1389  uint32_t enableFlag)
1390 {
1391  /* Set the FFER field with the user sent value. */
1392  CSL_REG32_FINS(
1393  baseAddr + MCSPI_CHCONF(chNum),
1394  MCSPI_CH0CONF_FFER,
1395  enableFlag >> CSL_MCSPI_CH0CONF_FFER_SHIFT);
1396 }
1397 
1398 static inline uint32_t MCSPI_readRxDataReg(uint32_t baseAddr, uint32_t chNum)
1399 {
1400  /* Return the data present in the MCSPI_RX register. */
1401  return (CSL_REG32_RD(baseAddr + MCSPI_CHRX(chNum)));
1402 }
1403 
1404 static inline void MCSPI_setDataWidth(uint32_t baseAddr, uint32_t chNum,
1405  uint32_t dataWidth)
1406 {
1407  uint32_t regVal;
1408 
1409  regVal = CSL_REG32_RD(baseAddr + MCSPI_CHCONF(chNum));
1410  CSL_FINS(regVal, MCSPI_CH0CONF_WL, (dataWidth - 1U));
1411  CSL_REG32_WR(baseAddr + MCSPI_CHCONF(chNum), regVal);
1412 }
1413 
1414 #ifdef __cplusplus
1415 }
1416 #endif
1417 
1418 #endif /* #ifndef MCSPI_LLD_H_ */
1419 
MCSPI_lld_readWriteDmaCancel
int32_t MCSPI_lld_readWriteDmaCancel(MCSPILLD_Handle hMcspi)
This API cancels current McSPI transfer in DMA mode.
MCSPILLD_InitObject::pinMode
uint32_t pinMode
Definition: mcspi_lld.h:700
MCSPI_getBufWidthShift
static uint8_t MCSPI_getBufWidthShift(uint32_t dataSize)
This API will return the buffer width in bytes based on dataSize.
Definition: mcspi_lld.h:1320
args
void * args
Definition: hsmclient_msg.h:4
MCSPI_clockGet
uint32_t(* MCSPI_clockGet)(void)
Definition: mcspi_lld.h:76
MCSPI_ChObject::curTxBufPtr
uint8_t * curTxBufPtr
Definition: mcspi_lld.h:648
MCSPILLD_InitObject
MCSPI driver initialization object.
Definition: mcspi_lld.h:689
MCSPI_ChObject
MCSPI channel object.
Definition: mcspi_lld.h:632
MCSPI_Transaction::count
uint32_t count
Definition: mcspi_lld.h:493
MCSPI_ChConfig::txFifoTrigLvl
uint32_t txFifoTrigLvl
Definition: mcspi_lld.h:598
MCSPI_CHTX
#define MCSPI_CHTX(x)
Base address of McSPI_CHTX(x)
Definition: mcspi_lld.h:432
MCSPI_FF_POL0_PHA0
#define MCSPI_FF_POL0_PHA0
Definition: mcspi_lld.h:234
MCSPI_ChConfig::rxFifoTrigLvl
uint32_t rxFifoTrigLvl
Definition: mcspi_lld.h:600
MCSPILLD_InitObject::intrNum
uint32_t intrNum
Definition: mcspi_lld.h:692
MCSPI_lld_readWriteCancel
int32_t MCSPI_lld_readWriteCancel(MCSPILLD_Handle hMcspi)
This API cancels current McSPI transfer.
MCSPI_DPE_DISABLE
#define MCSPI_DPE_DISABLE
No transmission on Data Line.
Definition: mcspi_lld.h:286
MCSPI_Transaction::status
uint32_t status
Definition: mcspi_lld.h:518
MCSPI_Transaction
Data structure used with MCSPI_transfer()
Definition: mcspi_lld.h:472
MCSPI_ChObject::effTxFifoDepth
uint32_t effTxFifoDepth
Definition: mcspi_lld.h:670
MCSPI_TCS0_0_CLK
#define MCSPI_TCS0_0_CLK
0.5 clock cycles delay
Definition: mcspi_lld.h:322
MCSPI_writeTxDataReg
static void MCSPI_writeTxDataReg(uint32_t baseAddr, uint32_t txData, uint32_t chNum)
This API will put the data on to the McSPI Channel transmit register.
Definition: mcspi_lld.h:1368
MCSPILLD_Object::transferDataSize
uint32_t transferDataSize
Definition: mcspi_lld.h:749
MCSPI_lld_getBaseAddr
uint32_t MCSPI_lld_getBaseAddr(MCSPILLD_Handle handle)
Function to get base address of MCSPI instance of a particular handle.
MCSPI_ChObject::intrMask
uint32_t intrMask
Definition: mcspi_lld.h:674
MCSPILLD_InitObject::clockP_get
MCSPI_clockGet clockP_get
Definition: mcspi_lld.h:714
MCSPI_WAIT_FOREVER
#define MCSPI_WAIT_FOREVER
Value to use when needing a timeout of infinity or wait forver until resource is available.
Definition: mcspi_lld.h:125
MCSPI_ChObject::chConfRegVal
uint32_t chConfRegVal
Definition: mcspi_lld.h:678
MCSPI_enableTxFIFO
static void MCSPI_enableTxFIFO(uint32_t baseAddr, uint32_t chNum, uint32_t enableFlag)
This API will enable/disable the Tx FIFOs of McSPI peripheral.
Definition: mcspi_lld.h:1376
MCSPI_lld_transferCancel
int32_t MCSPI_lld_transferCancel(MCSPILLD_Handle hMcspi)
This API cancels current McSPI transfer.
MCSPILLD_Object::errorFlag
uint32_t errorFlag
Definition: mcspi_lld.h:739
MCSPI_SLV_CS_SELECT_0
#define MCSPI_SLV_CS_SELECT_0
Definition: mcspi_lld.h:295
MCSPILLD_InitObject::intrPriority
uint8_t intrPriority
Definition: mcspi_lld.h:696
MCSPI_CHCONF
#define MCSPI_CHCONF(x)
Base address of McSPI_CHCONF(x)
Definition: mcspi_lld.h:420
MCSPI_lld_controllerIsr
void MCSPI_lld_controllerIsr(void *args)
This is the McSPI Controller ISR and can be used as IRQ handler in Controller mode.
MCSPI_lld_readWriteIntr
int32_t MCSPI_lld_readWriteIntr(MCSPILLD_Handle hMcspi, void *txBuf, void *rxBuf, uint32_t count, uint32_t timeout, const MCSPI_ExtendedParams *extendedParams)
This API reads writes data from the McSPI instance in Interrupt mode.
MCSPI_ChConfig::bitRate
uint32_t bitRate
Definition: mcspi_lld.h:569
MCSPILLD_InitObject::transferCallbackFxn
MCSPI_transferCallbackFxn transferCallbackFxn
Definition: mcspi_lld.h:716
MCSPI_lld_read
int32_t MCSPI_lld_read(MCSPILLD_Handle hMcspi, void *rxBuf, uint32_t count, uint32_t timeout, const MCSPI_ExtendedParams *extendedParams)
This API reads data from the McSPI instance in Polling mode.
MCSPI_lld_Transaction_init
static void MCSPI_lld_Transaction_init(MCSPI_Transaction *trans)
Function to initialize the MCSPI_Transaction struct to its defaults.
Definition: mcspi_lld.h:1305
MCSPILLD_Object
MCSPI driver object.
Definition: mcspi_lld.h:726
MCSPI_SB_POL_LOW
#define MCSPI_SB_POL_LOW
Start-bit polarity is held to 0 during MCSPI transfer.
Definition: mcspi_lld.h:310
MCSPI_Transaction::timeout
uint32_t timeout
Definition: mcspi_lld.h:516
MCSPI_errorCallbackFxn
void(* MCSPI_errorCallbackFxn)(void *args)
The definition of a error callback function used by the SPI driver when used in MCSPI_TRANSFER_MODE_C...
Definition: mcspi_lld.h:622
MCSPI_readRxDataReg
static uint32_t MCSPI_readRxDataReg(uint32_t baseAddr, uint32_t chNum)
This API will return the data present in the MCSPI_RX register.
Definition: mcspi_lld.h:1398
MCSPI_DPE_ENABLE
#define MCSPI_DPE_ENABLE
Data line selected for transmission.
Definition: mcspi_lld.h:284
MCSPI_DmaHandle
void * MCSPI_DmaHandle
Definition: mcspi_lld.h:71
MCSPI_Transaction::csDisable
uint32_t csDisable
Definition: mcspi_lld.h:476
MCSPI_IS_D1
#define MCSPI_IS_D1
Data line 1 (SPIDAT[1]) selected for reception.
Definition: mcspi_lld.h:274
MCSPI_ChObject::chCtrlRegVal
uint32_t chCtrlRegVal
Definition: mcspi_lld.h:680
MCSPILLD_InitHandle
struct MCSPILLD_InitObject * MCSPILLD_InitHandle
MCSPI_lld_peripheralIsr
void MCSPI_lld_peripheralIsr(void *args)
This is the McSPI Peripheral ISR and can be used as IRQ handler in Peripheral mode.
MCSPI_CHRX
#define MCSPI_CHRX(x)
Base address of McSPI_CHRX(x)
Definition: mcspi_lld.h:436
MCSPI_lld_writeDma
int32_t MCSPI_lld_writeDma(MCSPILLD_Handle hMcspi, void *txBuf, uint32_t count, uint32_t timeout, const MCSPI_ExtendedParams *extendedParams)
This API writes data to the McSPI instance in DMA mode.
MCSPI_ChConfig::trMode
uint32_t trMode
Definition: mcspi_lld.h:573
MCSPILLD_Object::hMcspiInit
MCSPILLD_InitHandle hMcspiInit
Definition: mcspi_lld.h:737
MCSPI_TR_MODE_TX_RX
#define MCSPI_TR_MODE_TX_RX
Definition: mcspi_lld.h:260
MCSPI_CHSTAT
#define MCSPI_CHSTAT(x)
Base address of McSPI_CHSTAT(x)
Definition: mcspi_lld.h:424
MCSPI_CHANNEL_0
#define MCSPI_CHANNEL_0
Definition: mcspi_lld.h:161
MCSPILLD_Object::transferChannel
uint32_t transferChannel
Definition: mcspi_lld.h:745
MCSPI_lld_ChConfig_init
static void MCSPI_lld_ChConfig_init(MCSPI_ChConfig *chConfig)
Function to initialize the MCSPI_ChConfig struct to its defaults.
Definition: mcspi_lld.h:1285
MCSPI_ChObject::isOpen
uint32_t isOpen
Definition: mcspi_lld.h:642
MCSPI_readChCtrlReg
static uint32_t MCSPI_readChCtrlReg(uint32_t baseAddr, uint32_t chNum)
This API returns Channel control register value.
Definition: mcspi_lld.h:1346
MCSPILLD_Object::state
uint32_t state
Definition: mcspi_lld.h:733
MCSPI_lld_initDma
int32_t MCSPI_lld_initDma(MCSPILLD_Handle hMcspi)
This API Initializes the McSPI instance in DMA Mode.
MCSPI_lld_deInitDma
int32_t MCSPI_lld_deInitDma(MCSPILLD_Handle hMcspi)
This API De-Initializes the McSPI instance in DMA mode.
MCSPI_lld_transfer
int32_t MCSPI_lld_transfer(MCSPILLD_Handle hMcspi, MCSPI_Transaction *transaction)
This API transfers data from the McSPI instance in Polling mode.
MCSPI_ChObject::curRxWords
uint32_t curRxWords
Definition: mcspi_lld.h:656
MCSPI_lld_transferDmaCancel
int32_t MCSPI_lld_transferDmaCancel(MCSPILLD_Handle hMcspi)
This API cancels current McSPI transfer in DMA mode.
MCSPI_lld_init
int32_t MCSPI_lld_init(MCSPILLD_Handle hMcspi)
This API Initializes the McSPI instance.
MCSPI_clearAllIrqStatus
void MCSPI_clearAllIrqStatus(uint32_t baseAddr)
MCSPI_lld_transferDma
int32_t MCSPI_lld_transferDma(MCSPILLD_Handle hMcspi, MCSPI_Transaction *transaction)
This API reads data from the McSPI instance in DMA mode.
MCSPI_enableRxFIFO
static void MCSPI_enableRxFIFO(uint32_t baseAddr, uint32_t chNum, uint32_t enableFlag)
This API will enable/disable the Rx FIFOs of McSPI peripheral.
Definition: mcspi_lld.h:1387
MCSPI_intrStatusClear
static void MCSPI_intrStatusClear(const MCSPI_ChObject *chObj, uint32_t baseAddr, uint32_t intFlags)
Definition: mcspi_lld.h:768
MCSPI_ChConfig::csPolarity
uint32_t csPolarity
Definition: mcspi_lld.h:571
MCSPI_ChConfig::startBitPolarity
uint32_t startBitPolarity
Definition: mcspi_lld.h:587
MCSPI_ChConfig::turboEnable
uint32_t turboEnable
Definition: mcspi_lld.h:590
MCSPI_ExtendedParams::channel
uint32_t channel
Definition: mcspi_lld.h:530
MCSPILLD_Object::transferMutex
void * transferMutex
Definition: mcspi_lld.h:735
MCSPILLD_InitObject::multiWordAccess
uint32_t multiWordAccess
Definition: mcspi_lld.h:704
MCSPI_reset
void MCSPI_reset(uint32_t baseAddr)
MCSPI_lld_writeIntr
int32_t MCSPI_lld_writeIntr(MCSPILLD_Handle hMcspi, void *txBuf, uint32_t count, uint32_t timeout, const MCSPI_ExtendedParams *extendedParams)
This API writes data to the McSPI instance in Interrupt mode.
MCSPI_ChObject::csDisable
uint32_t csDisable
Definition: mcspi_lld.h:644
MCSPI_Transaction::args
void * args
Definition: mcspi_lld.h:514
MCSPI_ChObject::dataWidthBitMask
uint32_t dataWidthBitMask
Definition: mcspi_lld.h:668
MCSPI_ExtendedParams
Data structure used with MCSPI_lld_read(), MCSPI_lld_readIntr(), MCSPI_lld_readDma(),...
Definition: mcspi_lld.h:529
MCSPI_ExtendedParams::dataSize
uint32_t dataSize
Definition: mcspi_lld.h:539
MCSPI_ChConfig::startBitEnable
uint32_t startBitEnable
Definition: mcspi_lld.h:584
MCSPI_Transaction::txBuf
void * txBuf
Definition: mcspi_lld.h:496
MCSPI_CHCTRL
#define MCSPI_CHCTRL(x)
Base address of McSPI_CHCTRL(x)
Definition: mcspi_lld.h:428
MCSPILLD_InitObject::chMode
uint32_t chMode
Definition: mcspi_lld.h:698
MCSPI_lld_reConfigFifo
int32_t MCSPI_lld_reConfigFifo(MCSPILLD_Handle handle, uint32_t chNum, uint32_t numWordsRxTx)
Function to re-configure Effective FIFO Words.
MCSPI_Transaction::rxBuf
void * rxBuf
Definition: mcspi_lld.h:507
MCSPI_ChObject::systRegVal
uint32_t systRegVal
Definition: mcspi_lld.h:682
MCSPI_ChObject::effRxFifoDepth
uint32_t effRxFifoDepth
Definition: mcspi_lld.h:672
MCSPI_MAX_NUM_CHANNELS
#define MCSPI_MAX_NUM_CHANNELS
Max number of channels/Chip Select (CS) supported.
Definition: mcspi_lld.h:181
MCSPI_Transaction::dataSize
uint32_t dataSize
Definition: mcspi_lld.h:482
MCSPI_lld_write
int32_t MCSPI_lld_write(MCSPILLD_Handle hMcspi, void *txBuf, uint32_t count, uint32_t timeout, const MCSPI_ExtendedParams *extendedParams)
This API writes data to the McSPI instance in Polling mode.
MCSPI_ChObject::curTxWords
uint32_t curTxWords
Definition: mcspi_lld.h:652
MCSPILLD_InitObject::mcspiDmaHandle
MCSPI_DmaHandle mcspiDmaHandle
Definition: mcspi_lld.h:712
MCSPI_ChConfig::slvCsSelect
uint32_t slvCsSelect
Definition: mcspi_lld.h:581
MCSPI_lld_deInit
int32_t MCSPI_lld_deInit(MCSPILLD_Handle hMcspi)
This API De-Initializes the McSPI instance.
MCSPI_readChStatusReg
static uint32_t MCSPI_readChStatusReg(uint32_t baseAddr, uint32_t chNum)
This API will return the status of the McSPI channel currently in use.
Definition: mcspi_lld.h:1340
MCSPI_stop
void MCSPI_stop(MCSPILLD_Handle hMcspi, MCSPI_ChObject *chObj, uint32_t chNum)
MCSPI_ChObject::bufWidthShift
uint8_t bufWidthShift
Definition: mcspi_lld.h:662
MCSPILLD_Object::transaction
MCSPI_Transaction transaction
Definition: mcspi_lld.h:751
MCSPILLD_Handle
struct MCSPILLD_Object * MCSPILLD_Handle
MCSPI_lld_readWriteDma
int32_t MCSPI_lld_readWriteDma(MCSPILLD_Handle hMcspi, void *txBuf, void *rxBuf, uint32_t count, uint32_t timeout, const MCSPI_ExtendedParams *extendedParams)
This API reads writes data from the McSPI instance in DMA mode.
MCSPI_ExtendedParams::csDisable
uint32_t csDisable
Definition: mcspi_lld.h:533
MCSPI_ChObject::curRxBufPtr
uint8_t * curRxBufPtr
Definition: mcspi_lld.h:650
MCSPI_lld_readIntr
int32_t MCSPI_lld_readIntr(MCSPILLD_Handle hMcspi, void *rxBuf, uint32_t count, uint32_t timeout, const MCSPI_ExtendedParams *extendedParams)
This API reads data from the McSPI instance in Interrupt mode.
MCSPI_CS_POL_LOW
#define MCSPI_CS_POL_LOW
SPIEN (CS) is held low during the ACTIVE state.
Definition: mcspi_lld.h:251
MCSPILLD_Object::args
void * args
Definition: mcspi_lld.h:753
MCSPI_lld_readWrite
int32_t MCSPI_lld_readWrite(MCSPILLD_Handle hMcspi, void *txBuf, void *rxBuf, uint32_t count, uint32_t timeout, const MCSPI_ExtendedParams *extendedParams)
This API reads writes data from the McSPI instance in polling mode.
MCSPI_ChConfig::defaultTxData
uint32_t defaultTxData
Definition: mcspi_lld.h:595
MCSPI_ChConfig::dpe1
uint32_t dpe1
Definition: mcspi_lld.h:579
MCSPILLD_InitObject::msMode
uint32_t msMode
Definition: mcspi_lld.h:706
MCSPI_ChObject::csEnable
uint32_t csEnable
Definition: mcspi_lld.h:646
MCSPILLD_InitObject::operMode
uint32_t operMode
Definition: mcspi_lld.h:694
MCSPI_writeChCtrlReg
static void MCSPI_writeChCtrlReg(uint32_t baseAddr, uint32_t chNum, uint32_t regVal)
This API sets Channel control register value.
Definition: mcspi_lld.h:1351
MCSPI_ChObject::chCfg
MCSPI_ChConfig * chCfg
Definition: mcspi_lld.h:636
MCSPI_readChConf
static uint32_t MCSPI_readChConf(uint32_t baseAddr, uint32_t chNum)
This API returns Channel Config register value.
Definition: mcspi_lld.h:1357
MCSPI_ChObject::dmaChCfg
MCSPI_DmaChConfig dmaChCfg
Definition: mcspi_lld.h:676
MCSPI_Transaction::channel
uint32_t channel
Definition: mcspi_lld.h:473
MCSPI_transferCallbackFxn
void(* MCSPI_transferCallbackFxn)(void *args, uint32_t tansferStatus)
The definition of a transfer completion callback function used by the SPI driver when used in MCSPI_T...
Definition: mcspi_lld.h:614
MCSPI_lld_readDma
int32_t MCSPI_lld_readDma(MCSPILLD_Handle hMcspi, void *rxBuf, uint32_t count, uint32_t timeout, const MCSPI_ExtendedParams *extendedParams)
This API reads data from the McSPI instance in DMA mode.
MCSPI_lld_transferIntr
int32_t MCSPI_lld_transferIntr(MCSPILLD_Handle hMcspi, MCSPI_Transaction *transaction)
This API reads data from the McSPI instance in Interrupt mode.
MCSPI_ChConfig::inputSelect
uint32_t inputSelect
Definition: mcspi_lld.h:575
MCSPILLD_Object::baseAddr
uint32_t baseAddr
Definition: mcspi_lld.h:727
MCSPI_ChConfig::dpe0
uint32_t dpe0
Definition: mcspi_lld.h:577
MCSPI_setChDataSize
void MCSPI_setChDataSize(uint32_t baseAddr, MCSPI_ChObject *chObj, uint32_t dataSize, uint32_t csDisable)
MCSPI_lld_getState
int32_t MCSPI_lld_getState(MCSPILLD_Handle hMcspi)
This API returns the driver state.
MCSPI_ChConfig
MCSPI configuration parameters for the channel.
Definition: mcspi_lld.h:564
MCSPI_writeChConfReg
static void MCSPI_writeChConfReg(uint32_t baseAddr, uint32_t chNum, uint32_t regVal)
This API sets Channel Config register value.
Definition: mcspi_lld.h:1362
MCSPILLD_InitObject::errorCallbackFxn
MCSPI_errorCallbackFxn errorCallbackFxn
Definition: mcspi_lld.h:718
MCSPILLD_Object::transferCsDisable
uint32_t transferCsDisable
Definition: mcspi_lld.h:747
MCSPILLD_InitObject::initDelay
uint32_t initDelay
Definition: mcspi_lld.h:702
MCSPI_setDataWidth
static void MCSPI_setDataWidth(uint32_t baseAddr, uint32_t chNum, uint32_t dataWidth)
This API will set the data width in the channel config register.
Definition: mcspi_lld.h:1404
MCSPILLD_InitObject::chCnt
uint32_t chCnt
Definition: mcspi_lld.h:708
MCSPILLD_InitObject::inputClkFreq
uint32_t inputClkFreq
Definition: mcspi_lld.h:690
MCSPI_ChConfig::frameFormat
uint32_t frameFormat
Definition: mcspi_lld.h:567
MCSPI_ChConfig::csIdleTime
uint32_t csIdleTime
Definition: mcspi_lld.h:592
MCSPI_DmaChConfig
void * MCSPI_DmaChConfig
Definition: mcspi_lld.h:73
MCSPI_ChConfig::chNum
uint32_t chNum
Definition: mcspi_lld.h:565