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 #include <stdio.h>
21 #include "adc.h"
22 #include "adc_regs.h"
23 #include "adc_reva.h"
24 #include "mxc_device.h"
25 #include "mxc_errors.h"
26 #include "mxc_assert.h"
27 #include "mxc_sys.h"
28 #include "mcr_regs.h"
29 #include "mxc_lock.h"
30 
MXC_ADC_Init(void)31 int MXC_ADC_Init(void)
32 {
33 #ifndef MSDK_NO_GPIO_CLK_INIT
34     MXC_GCR->rstr0 |= MXC_F_GCR_RSTR0_ADC;
35 
36     // Reset ADC block
37     while (MXC_GCR->rstr0 & MXC_F_GCR_RSTR0_ADC) {}
38 
39     // Enable ADC peripheral clock
40     MXC_GCR->perckcn0 &= ~MXC_F_GCR_PERCKCN0_ADCD;
41 #endif
42 
43     return MXC_ADC_RevA_Init((mxc_adc_reva_regs_t *)MXC_ADC);
44 }
45 
MXC_ADC_Shutdown(void)46 int MXC_ADC_Shutdown(void)
47 {
48     MXC_ADC_RevA_Shutdown((mxc_adc_reva_regs_t *)MXC_ADC);
49 
50     //Disable ADC peripheral clock
51     MXC_GCR->perckcn0 |= MXC_F_GCR_PERCKCN0_ADCD;
52 
53     return E_NO_ERROR;
54 }
55 
MXC_ADC_Busy(void)56 int MXC_ADC_Busy(void)
57 {
58     return MXC_ADC_RevA_Busy((mxc_adc_reva_regs_t *)MXC_ADC);
59 }
60 
MXC_ADC_EnableInt(uint32_t flags)61 void MXC_ADC_EnableInt(uint32_t flags)
62 {
63     MXC_ADC_RevA_EnableInt((mxc_adc_reva_regs_t *)MXC_ADC, flags);
64 }
MXC_ADC_DisableInt(uint32_t flags)65 void MXC_ADC_DisableInt(uint32_t flags)
66 {
67     MXC_ADC_RevA_DisableInt((mxc_adc_reva_regs_t *)MXC_ADC, flags);
68 }
69 
MXC_ADC_GetFlags(void)70 int MXC_ADC_GetFlags(void)
71 {
72     return MXC_ADC_RevA_GetFlags((mxc_adc_reva_regs_t *)MXC_ADC);
73 }
74 
MXC_ADC_ClearFlags(uint32_t flags)75 void MXC_ADC_ClearFlags(uint32_t flags)
76 {
77     MXC_ADC_RevA_ClearFlags((mxc_adc_reva_regs_t *)MXC_ADC, flags);
78 }
79 
MXC_ADC_SetConversionSpeed(uint32_t hz)80 int MXC_ADC_SetConversionSpeed(uint32_t hz)
81 {
82     //check for overflow
83     MXC_ASSERT(hz < ((uint32_t)((1U << 31) - 1) / 1024));
84     uint32_t adc_clock_freq = 1024 * hz;
85 
86     if (adc_clock_freq > MXC_ADC_MAX_CLOCK) {
87         return E_BAD_PARAM;
88     }
89 
90     uint8_t divider = PeripheralClock / adc_clock_freq;
91 
92     if (divider > 0xf || divider < 2) {
93         return E_BAD_PARAM;
94     }
95 
96     //disable clock
97     MXC_ADC->ctrl &= ~MXC_F_ADC_CTRL_CLK_EN;
98     //clear clock divisor
99     MXC_GCR->pckdiv &= (~MXC_F_GCR_PCKDIV_ADCFRQ);
100     //load in new clock divisor
101     MXC_GCR->pckdiv |= (divider << MXC_F_GCR_PCKDIV_ADCFRQ_POS);
102 
103     //enable clock
104     MXC_ADC_RevA_SetConversionSpeed((mxc_adc_reva_regs_t *)MXC_ADC, hz);
105 
106     return MXC_ADC_GetConversionSpeed();
107 }
108 
MXC_ADC_GetConversionSpeed(void)109 int MXC_ADC_GetConversionSpeed(void)
110 {
111     uint8_t divider = (MXC_GCR->pckdiv & MXC_F_GCR_PCKDIV_ADCFRQ) >> MXC_F_GCR_PCKDIV_ADCFRQ_POS;
112     return MXC_ADC_RevA_GetConversionSpeed(divider);
113 }
114 
MXC_ADC_SetDataAlignment(int msbJustify)115 void MXC_ADC_SetDataAlignment(int msbJustify)
116 {
117     MXC_ADC_RevA_SetDataAlignment((mxc_adc_reva_regs_t *)MXC_ADC, msbJustify);
118 }
119 
MXC_ADC_SetExtScale(mxc_adc_scale_t scale)120 void MXC_ADC_SetExtScale(mxc_adc_scale_t scale)
121 {
122     MXC_ADC_RevA_SetExtScale((mxc_adc_reva_regs_t *)MXC_ADC, scale);
123 }
124 
MXC_ADC_EnableMonitor(mxc_adc_monitor_t monitor)125 void MXC_ADC_EnableMonitor(mxc_adc_monitor_t monitor)
126 {
127     MXC_ADC_RevA_EnableMonitor((mxc_adc_reva_regs_t *)MXC_ADC, monitor);
128 }
129 
MXC_ADC_DisableMonitor(mxc_adc_monitor_t monitor)130 void MXC_ADC_DisableMonitor(mxc_adc_monitor_t monitor)
131 {
132     MXC_ADC_RevA_DisableMonitor((mxc_adc_reva_regs_t *)MXC_ADC, monitor);
133 }
134 
MXC_ADC_SetMonitorHighThreshold(mxc_adc_monitor_t monitor,uint32_t threshold)135 void MXC_ADC_SetMonitorHighThreshold(mxc_adc_monitor_t monitor, uint32_t threshold)
136 {
137     MXC_ADC_RevA_SetMonitorHighThreshold((mxc_adc_reva_regs_t *)MXC_ADC, monitor, threshold);
138 }
139 
MXC_ADC_GetMonitorHighThreshold(mxc_adc_monitor_t monitor)140 int MXC_ADC_GetMonitorHighThreshold(mxc_adc_monitor_t monitor)
141 {
142     return MXC_ADC_RevA_GetMonitorHighThreshold((mxc_adc_reva_regs_t *)MXC_ADC, monitor);
143 }
144 
MXC_ADC_SetMonitorLowThreshold(mxc_adc_monitor_t monitor,uint32_t threshold)145 void MXC_ADC_SetMonitorLowThreshold(mxc_adc_monitor_t monitor, uint32_t threshold)
146 {
147     MXC_ADC_RevA_SetMonitorLowThreshold((mxc_adc_reva_regs_t *)MXC_ADC, monitor, threshold);
148 }
149 
MXC_ADC_GetMonitorLowThreshold(mxc_adc_monitor_t monitor)150 int MXC_ADC_GetMonitorLowThreshold(mxc_adc_monitor_t monitor)
151 {
152     return MXC_ADC_RevA_GetMonitorLowThreshold((mxc_adc_reva_regs_t *)MXC_ADC, monitor);
153 }
154 
MXC_ADC_SetMonitorChannel(mxc_adc_monitor_t monitor,mxc_adc_chsel_t channel)155 void MXC_ADC_SetMonitorChannel(mxc_adc_monitor_t monitor, mxc_adc_chsel_t channel)
156 {
157     MXC_ADC_RevA_SetMonitorChannel((mxc_adc_reva_regs_t *)MXC_ADC, monitor, channel);
158 }
159 
MXC_ADC_GetMonitorChannel(mxc_adc_monitor_t monitor)160 int MXC_ADC_GetMonitorChannel(mxc_adc_monitor_t monitor)
161 {
162     return MXC_ADC_RevA_GetMonitorChannel((mxc_adc_reva_regs_t *)MXC_ADC, monitor);
163 }
164 
MXC_ADC_EnableMonitorAsync(mxc_adc_monitor_t monitor,mxc_adc_monitor_cb_t callback)165 void MXC_ADC_EnableMonitorAsync(mxc_adc_monitor_t monitor, mxc_adc_monitor_cb_t callback)
166 {
167     MXC_ADC_RevA_EnableMonitorAsync(monitor, callback);
168 }
MXC_ADC_DisableMonitorAsync(mxc_adc_monitor_t monitor)169 void MXC_ADC_DisableMonitorAsync(mxc_adc_monitor_t monitor)
170 {
171     MXC_ADC_RevA_DisableMonitorAsync(monitor);
172 }
173 
MXC_ADC_StartConversion(mxc_adc_chsel_t channel)174 int MXC_ADC_StartConversion(mxc_adc_chsel_t channel)
175 {
176     return MXC_ADC_RevA_StartConversion((mxc_adc_reva_regs_t *)MXC_ADC, channel);
177 }
178 
MXC_ADC_StartConversionAsync(mxc_adc_chsel_t channel,mxc_adc_complete_cb_t callback)179 int MXC_ADC_StartConversionAsync(mxc_adc_chsel_t channel, mxc_adc_complete_cb_t callback)
180 {
181     return MXC_ADC_RevA_StartConversionAsync((mxc_adc_reva_regs_t *)MXC_ADC, channel, callback);
182 }
183 
MXC_ADC_StartConversionDMA(mxc_adc_chsel_t channel,mxc_dma_regs_t * dma,uint16_t * data,void (* callback)(int,int))184 int MXC_ADC_StartConversionDMA(mxc_adc_chsel_t channel, mxc_dma_regs_t *dma, uint16_t *data,
185                                void (*callback)(int, int))
186 {
187     if (MXC_DMA_GET_IDX(dma) == -1) {
188         return E_BAD_PARAM;
189     }
190 
191     return MXC_ADC_RevA_StartConversionDMA((mxc_adc_reva_regs_t *)MXC_ADC, channel, dma, data,
192                                            callback);
193 }
194 
MXC_ADC_Handler(void)195 int MXC_ADC_Handler(void)
196 {
197     return MXC_ADC_RevA_Handler((mxc_adc_reva_regs_t *)MXC_ADC);
198 }
199 
MXC_ADC_Convert(mxc_adc_conversion_req_t * req)200 int MXC_ADC_Convert(mxc_adc_conversion_req_t *req)
201 {
202     return MXC_ADC_RevA_Convert((mxc_adc_reva_regs_t *)MXC_ADC, req);
203 }
204 
MXC_ADC_ConvertAsync(mxc_adc_conversion_req_t * req)205 int MXC_ADC_ConvertAsync(mxc_adc_conversion_req_t *req)
206 {
207     return MXC_ADC_RevA_ConvertAsync((mxc_adc_reva_regs_t *)MXC_ADC, req);
208 }
209 
MXC_ADC_Monitor(mxc_adc_monitor_req_t req)210 void MXC_ADC_Monitor(mxc_adc_monitor_req_t req)
211 {
212     MXC_ADC_RevA_Monitor((mxc_adc_reva_regs_t *)MXC_ADC, req);
213 }
214 
MXC_ADC_MonitorAsync(mxc_adc_monitor_req_t req)215 void MXC_ADC_MonitorAsync(mxc_adc_monitor_req_t req)
216 {
217     MXC_ADC_RevA_MonitorAsync((mxc_adc_reva_regs_t *)MXC_ADC, req);
218 }
219 
MXC_ADC_GetData(uint16_t * outdata)220 int MXC_ADC_GetData(uint16_t *outdata)
221 {
222     return MXC_ADC_RevA_GetData((mxc_adc_reva_regs_t *)MXC_ADC, outdata);
223 }
224