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