1 /******************************************************************************
2  *
3  * Copyright (C) 2022-2023 Maxim Integrated Products, Inc. (now owned by
4  * Analog Devices, Inc.),
5  * Copyright (C) 2023-2024 Analog Devices, Inc.
6  *
7  * Licensed under the Apache License, Version 2.0 (the "License");
8  * you may not use this file except in compliance with the License.
9  * You may obtain a copy of the License at
10  *
11  *     http://www.apache.org/licenses/LICENSE-2.0
12  *
13  * Unless required by applicable law or agreed to in writing, software
14  * distributed under the License is distributed on an "AS IS" BASIS,
15  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
16  * See the License for the specific language governing permissions and
17  * limitations under the License.
18  *
19  ******************************************************************************/
20 
21 #include <stdio.h>
22 #include <stddef.h>
23 #include <stdint.h>
24 #include "mxc_device.h"
25 #include "mxc_assert.h"
26 #include "mxc_lock.h"
27 #include "mxc_sys.h"
28 #include "mxc_delay.h"
29 #include "spi_reva1.h"
30 #include "dma.h"
31 
32 /* **** Functions **** */
MXC_SPI_Init(mxc_spi_regs_t * spi,int masterMode,int quadModeUsed,int numSlaves,unsigned ssPolarity,unsigned int hz)33 int MXC_SPI_Init(mxc_spi_regs_t *spi, int masterMode, int quadModeUsed, int numSlaves,
34                  unsigned ssPolarity, unsigned int hz)
35 {
36     int spi_num;
37 
38     spi_num = MXC_SPI_GET_IDX(spi);
39     MXC_ASSERT(spi_num >= 0);
40 
41     if (numSlaves > MXC_SPI_SS_INSTANCES) {
42         return E_BAD_PARAM;
43     }
44 
45     // Check if frequency is too high
46     if (hz > PeripheralClock) {
47         return E_BAD_PARAM;
48     }
49 
50     // Configure GPIO for spi
51     if (spi == MXC_SPI0) {
52         MXC_SYS_ClockEnable(MXC_SYS_PERIPH_CLOCK_SPI0);
53         MXC_SYS_Reset_Periph(MXC_SYS_RESET_SPI0);
54         MXC_GPIO_Config(&gpio_cfg_spi0);
55     } else if (spi == MXC_SPI1) {
56         MXC_SYS_ClockEnable(MXC_SYS_PERIPH_CLOCK_SPI1);
57         MXC_SYS_Reset_Periph(MXC_SYS_RESET_SPI1);
58         MXC_GPIO_Config(&gpio_cfg_spi1);
59     } else {
60         return E_NO_DEVICE;
61     }
62 
63     return MXC_SPI_RevA1_Init((mxc_spi_reva_regs_t *)spi, masterMode, quadModeUsed, numSlaves,
64                               ssPolarity, hz);
65 }
66 
MXC_SPI_Shutdown(mxc_spi_regs_t * spi)67 int MXC_SPI_Shutdown(mxc_spi_regs_t *spi)
68 {
69     int spi_num;
70     spi_num = MXC_SPI_GET_IDX(spi);
71     MXC_ASSERT(spi_num >= 0);
72 
73     MXC_SPI_RevA1_Shutdown((mxc_spi_reva_regs_t *)spi);
74 
75     if (spi == MXC_SPI0) {
76         MXC_SYS_ClockDisable(MXC_SYS_PERIPH_CLOCK_SPI0);
77     } else if (spi == MXC_SPI1) {
78         MXC_SYS_ClockDisable(MXC_SYS_PERIPH_CLOCK_SPI1);
79     } else {
80         return E_INVALID;
81     }
82 
83     return E_NO_ERROR;
84 }
85 
MXC_SPI_ReadyForSleep(mxc_spi_regs_t * spi)86 int MXC_SPI_ReadyForSleep(mxc_spi_regs_t *spi)
87 {
88     return MXC_SPI_RevA1_ReadyForSleep((mxc_spi_reva_regs_t *)spi);
89 }
90 
MXC_SPI_GetPeripheralClock(mxc_spi_regs_t * spi)91 int MXC_SPI_GetPeripheralClock(mxc_spi_regs_t *spi)
92 {
93     if (spi == MXC_SPI0 || spi == MXC_SPI1) {
94         return PeripheralClock;
95     } else {
96         return E_BAD_PARAM;
97     }
98     return E_NO_ERROR;
99 }
100 
MXC_SPI_SetFrequency(mxc_spi_regs_t * spi,unsigned int hz)101 int MXC_SPI_SetFrequency(mxc_spi_regs_t *spi, unsigned int hz)
102 {
103     return MXC_SPI_RevA1_SetFrequency((mxc_spi_reva_regs_t *)spi, hz);
104 }
105 
MXC_SPI_GetFrequency(mxc_spi_regs_t * spi)106 unsigned int MXC_SPI_GetFrequency(mxc_spi_regs_t *spi)
107 {
108     return MXC_SPI_RevA1_GetFrequency((mxc_spi_reva_regs_t *)spi);
109 }
110 
MXC_SPI_SetDataSize(mxc_spi_regs_t * spi,int dataSize)111 int MXC_SPI_SetDataSize(mxc_spi_regs_t *spi, int dataSize)
112 {
113     return MXC_SPI_RevA1_SetDataSize((mxc_spi_reva_regs_t *)spi, dataSize);
114 }
115 
MXC_SPI_GetDataSize(mxc_spi_regs_t * spi)116 int MXC_SPI_GetDataSize(mxc_spi_regs_t *spi)
117 {
118     return MXC_SPI_RevA1_GetDataSize((mxc_spi_reva_regs_t *)spi);
119 }
120 
MXC_SPI_SetSlave(mxc_spi_regs_t * spi,int ssIdx)121 int MXC_SPI_SetSlave(mxc_spi_regs_t *spi, int ssIdx)
122 {
123     return MXC_SPI_RevA1_SetSlave((mxc_spi_reva_regs_t *)spi, ssIdx);
124 }
125 
MXC_SPI_GetSlave(mxc_spi_regs_t * spi)126 int MXC_SPI_GetSlave(mxc_spi_regs_t *spi)
127 {
128     return MXC_SPI_RevA1_GetSlave((mxc_spi_reva_regs_t *)spi);
129 }
130 
MXC_SPI_SetWidth(mxc_spi_regs_t * spi,mxc_spi_width_t spiWidth)131 int MXC_SPI_SetWidth(mxc_spi_regs_t *spi, mxc_spi_width_t spiWidth)
132 {
133     return MXC_SPI_RevA1_SetWidth((mxc_spi_reva_regs_t *)spi, spiWidth);
134 }
135 
MXC_SPI_GetWidth(mxc_spi_regs_t * spi)136 mxc_spi_width_t MXC_SPI_GetWidth(mxc_spi_regs_t *spi)
137 {
138     return MXC_SPI_RevA1_GetWidth((mxc_spi_reva_regs_t *)spi);
139 }
140 
MXC_SPI_SetMode(mxc_spi_regs_t * spi,mxc_spi_mode_t spiMode)141 int MXC_SPI_SetMode(mxc_spi_regs_t *spi, mxc_spi_mode_t spiMode)
142 {
143     return MXC_SPI_RevA1_SetMode((mxc_spi_reva_regs_t *)spi, spiMode);
144 }
145 
MXC_SPI_GetMode(mxc_spi_regs_t * spi)146 mxc_spi_mode_t MXC_SPI_GetMode(mxc_spi_regs_t *spi)
147 {
148     return MXC_SPI_RevA1_GetMode((mxc_spi_reva_regs_t *)spi);
149 }
150 
MXC_SPI_StartTransmission(mxc_spi_regs_t * spi)151 int MXC_SPI_StartTransmission(mxc_spi_regs_t *spi)
152 {
153     return MXC_SPI_RevA1_StartTransmission((mxc_spi_reva_regs_t *)spi);
154 }
155 
MXC_SPI_GetActive(mxc_spi_regs_t * spi)156 int MXC_SPI_GetActive(mxc_spi_regs_t *spi)
157 {
158     return MXC_SPI_RevA1_GetActive((mxc_spi_reva_regs_t *)spi);
159 }
160 
MXC_SPI_AbortTransmission(mxc_spi_regs_t * spi)161 int MXC_SPI_AbortTransmission(mxc_spi_regs_t *spi)
162 {
163     return MXC_SPI_RevA1_AbortTransmission((mxc_spi_reva_regs_t *)spi);
164 }
165 
MXC_SPI_ReadRXFIFO(mxc_spi_regs_t * spi,unsigned char * bytes,unsigned int len)166 unsigned int MXC_SPI_ReadRXFIFO(mxc_spi_regs_t *spi, unsigned char *bytes, unsigned int len)
167 {
168     return MXC_SPI_RevA1_ReadRXFIFO((mxc_spi_reva_regs_t *)spi, bytes, len);
169 }
170 
MXC_SPI_GetRXFIFOAvailable(mxc_spi_regs_t * spi)171 unsigned int MXC_SPI_GetRXFIFOAvailable(mxc_spi_regs_t *spi)
172 {
173     return MXC_SPI_RevA1_GetRXFIFOAvailable((mxc_spi_reva_regs_t *)spi);
174 }
175 
MXC_SPI_WriteTXFIFO(mxc_spi_regs_t * spi,unsigned char * bytes,unsigned int len)176 unsigned int MXC_SPI_WriteTXFIFO(mxc_spi_regs_t *spi, unsigned char *bytes, unsigned int len)
177 {
178     return MXC_SPI_RevA1_WriteTXFIFO((mxc_spi_reva_regs_t *)spi, bytes, len);
179 }
180 
MXC_SPI_GetTXFIFOAvailable(mxc_spi_regs_t * spi)181 unsigned int MXC_SPI_GetTXFIFOAvailable(mxc_spi_regs_t *spi)
182 {
183     return MXC_SPI_RevA1_GetTXFIFOAvailable((mxc_spi_reva_regs_t *)spi);
184 }
185 
MXC_SPI_ClearRXFIFO(mxc_spi_regs_t * spi)186 void MXC_SPI_ClearRXFIFO(mxc_spi_regs_t *spi)
187 {
188     MXC_SPI_RevA1_ClearRXFIFO((mxc_spi_reva_regs_t *)spi);
189 }
190 
MXC_SPI_ClearTXFIFO(mxc_spi_regs_t * spi)191 void MXC_SPI_ClearTXFIFO(mxc_spi_regs_t *spi)
192 {
193     MXC_SPI_RevA1_ClearTXFIFO((mxc_spi_reva_regs_t *)spi);
194 }
195 
MXC_SPI_SetRXThreshold(mxc_spi_regs_t * spi,unsigned int numBytes)196 int MXC_SPI_SetRXThreshold(mxc_spi_regs_t *spi, unsigned int numBytes)
197 {
198     return MXC_SPI_RevA1_SetRXThreshold((mxc_spi_reva_regs_t *)spi, numBytes);
199 }
200 
MXC_SPI_GetRXThreshold(mxc_spi_regs_t * spi)201 unsigned int MXC_SPI_GetRXThreshold(mxc_spi_regs_t *spi)
202 {
203     return MXC_SPI_RevA1_GetRXThreshold((mxc_spi_reva_regs_t *)spi);
204 }
205 
MXC_SPI_SetTXThreshold(mxc_spi_regs_t * spi,unsigned int numBytes)206 int MXC_SPI_SetTXThreshold(mxc_spi_regs_t *spi, unsigned int numBytes)
207 {
208     return MXC_SPI_RevA1_SetTXThreshold((mxc_spi_reva_regs_t *)spi, numBytes);
209 }
210 
MXC_SPI_GetTXThreshold(mxc_spi_regs_t * spi)211 unsigned int MXC_SPI_GetTXThreshold(mxc_spi_regs_t *spi)
212 {
213     return MXC_SPI_RevA1_GetTXThreshold((mxc_spi_reva_regs_t *)spi);
214 }
215 
MXC_SPI_GetFlags(mxc_spi_regs_t * spi)216 unsigned int MXC_SPI_GetFlags(mxc_spi_regs_t *spi)
217 {
218     return MXC_SPI_RevA1_GetFlags((mxc_spi_reva_regs_t *)spi);
219 }
220 
MXC_SPI_ClearFlags(mxc_spi_regs_t * spi)221 void MXC_SPI_ClearFlags(mxc_spi_regs_t *spi)
222 {
223     MXC_SPI_RevA1_ClearFlags((mxc_spi_reva_regs_t *)spi);
224 }
225 
MXC_SPI_EnableInt(mxc_spi_regs_t * spi,unsigned int mask)226 void MXC_SPI_EnableInt(mxc_spi_regs_t *spi, unsigned int mask)
227 {
228     MXC_SPI_RevA1_EnableInt((mxc_spi_reva_regs_t *)spi, mask);
229 }
230 
MXC_SPI_DisableInt(mxc_spi_regs_t * spi,unsigned int mask)231 void MXC_SPI_DisableInt(mxc_spi_regs_t *spi, unsigned int mask)
232 {
233     MXC_SPI_RevA1_DisableInt((mxc_spi_reva_regs_t *)spi, mask);
234 }
235 
MXC_SPI_MasterTransaction(mxc_spi_req_t * req)236 int MXC_SPI_MasterTransaction(mxc_spi_req_t *req)
237 {
238     return MXC_SPI_RevA1_MasterTransaction((mxc_spi_reva_req_t *)req);
239 }
240 
MXC_SPI_MasterTransactionAsync(mxc_spi_req_t * req)241 int MXC_SPI_MasterTransactionAsync(mxc_spi_req_t *req)
242 {
243     return MXC_SPI_RevA1_MasterTransactionAsync((mxc_spi_reva_req_t *)req);
244 }
245 
MXC_SPI_MasterTransactionDMA(mxc_spi_req_t * req)246 int MXC_SPI_MasterTransactionDMA(mxc_spi_req_t *req)
247 {
248     int reqselTx = -1;
249     int reqselRx = -1;
250     int spi_num;
251 
252     spi_num = MXC_SPI_GET_IDX(req->spi);
253     MXC_ASSERT(spi_num >= 0);
254 
255     if (req->txData != NULL) {
256         switch (spi_num) {
257         case 0:
258             reqselTx = MXC_DMA_REQUEST_SPI0TX;
259             break;
260 
261         case 1:
262             reqselTx = MXC_DMA_REQUEST_SPI1TX;
263             break;
264 
265         default:
266             return E_BAD_PARAM;
267         }
268     }
269 
270     //tx
271     if (req->rxData != NULL) {
272         switch (spi_num) {
273         case 0:
274             reqselRx = MXC_DMA_REQUEST_SPI0RX;
275             break;
276 
277         case 1:
278             reqselRx = MXC_DMA_REQUEST_SPI1RX;
279             break;
280 
281         default:
282             return E_BAD_PARAM;
283         }
284     }
285 
286     return MXC_SPI_RevA1_MasterTransactionDMA((mxc_spi_reva_req_t *)req, reqselTx, reqselRx,
287                                               MXC_DMA);
288 }
289 
MXC_SPI_SlaveTransaction(mxc_spi_req_t * req)290 int MXC_SPI_SlaveTransaction(mxc_spi_req_t *req)
291 {
292     return MXC_SPI_RevA1_SlaveTransaction((mxc_spi_reva_req_t *)req);
293 }
294 
MXC_SPI_SlaveTransactionAsync(mxc_spi_req_t * req)295 int MXC_SPI_SlaveTransactionAsync(mxc_spi_req_t *req)
296 {
297     return MXC_SPI_RevA1_SlaveTransactionAsync((mxc_spi_reva_req_t *)req);
298 }
299 
MXC_SPI_SlaveTransactionDMA(mxc_spi_req_t * req)300 int MXC_SPI_SlaveTransactionDMA(mxc_spi_req_t *req)
301 {
302     int reqselTx = -1;
303     int reqselRx = -1;
304 
305     int spi_num;
306 
307     spi_num = MXC_SPI_GET_IDX(req->spi);
308     MXC_ASSERT(spi_num >= 0);
309 
310     if (req->txData != NULL) {
311         switch (spi_num) {
312         case 0:
313             reqselTx = MXC_DMA_REQUEST_SPI0TX;
314             break;
315 
316         case 1:
317             reqselTx = MXC_DMA_REQUEST_SPI1TX;
318             break;
319 
320         default:
321             return E_BAD_PARAM;
322         }
323     }
324 
325     if (req->rxData != NULL) {
326         switch (spi_num) {
327         case 0:
328             reqselRx = MXC_DMA_REQUEST_SPI0RX;
329             break;
330 
331         case 1:
332             reqselRx = MXC_DMA_REQUEST_SPI1RX;
333             break;
334 
335         default:
336             return E_BAD_PARAM;
337         }
338     }
339 
340     return MXC_SPI_RevA1_SlaveTransactionDMA((mxc_spi_reva_req_t *)req, reqselTx, reqselRx,
341                                              MXC_DMA);
342 }
343 
MXC_SPI_SetDefaultTXData(mxc_spi_regs_t * spi,unsigned int defaultTXData)344 int MXC_SPI_SetDefaultTXData(mxc_spi_regs_t *spi, unsigned int defaultTXData)
345 {
346     return MXC_SPI_RevA1_SetDefaultTXData((mxc_spi_reva_regs_t *)spi, defaultTXData);
347 }
348 
MXC_SPI_AbortAsync(mxc_spi_regs_t * spi)349 void MXC_SPI_AbortAsync(mxc_spi_regs_t *spi)
350 {
351     MXC_SPI_RevA1_AbortAsync((mxc_spi_reva_regs_t *)spi);
352 }
353 
MXC_SPI_AsyncHandler(mxc_spi_regs_t * spi)354 void MXC_SPI_AsyncHandler(mxc_spi_regs_t *spi)
355 {
356     MXC_SPI_RevA1_AsyncHandler((mxc_spi_reva_regs_t *)spi);
357 }
358 
MXC_SPI_HWSSControl(mxc_spi_regs_t * spi,int state)359 void MXC_SPI_HWSSControl(mxc_spi_regs_t *spi, int state)
360 {
361     MXC_SPI_RevA1_HWSSControl((mxc_spi_reva_regs_t *)spi, state);
362 }
363