1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
|
#ifndef _BFLB_ADC_H
#define _BFLB_ADC_H
#include "bflb_core.h"
/** @addtogroup LHAL
* @{
*/
/** @addtogroup ADC
* @{
*/
/** @defgroup ADC_CHANNEL adc channel definition
* @{
*/
#define ADC_CHANNEL_0 0
#define ADC_CHANNEL_1 1
#define ADC_CHANNEL_2 2
#define ADC_CHANNEL_3 3
#define ADC_CHANNEL_4 4
#define ADC_CHANNEL_5 5
#define ADC_CHANNEL_6 6
#define ADC_CHANNEL_7 7
#define ADC_CHANNEL_8 8
#define ADC_CHANNEL_9 9
#define ADC_CHANNEL_10 10
#define ADC_CHANNEL_11 11
#define ADC_CHANNEL_DACA 12
#define ADC_CHANNEL_DACB 13
#define ADC_CHANNEL_TSEN_P 14
#define ADC_CHANNEL_TSEN_N 15
#define ADC_CHANNEL_VREF 16
#define ADC_CHANNEL_VABT_HALF 18
#define ADC_CHANNEL_GND 23
/**
* @}
*/
/** @defgroup ADC_CLK_DIV adc clock divison definition
* @{
*/
#define ADC_CLK_DIV_4 1
#define ADC_CLK_DIV_8 2
#define ADC_CLK_DIV_12 3
#define ADC_CLK_DIV_16 4
#define ADC_CLK_DIV_20 5
#define ADC_CLK_DIV_24 6
#define ADC_CLK_DIV_32 7
/**
* @}
*/
/** @defgroup ADC_RESOLUTION adc resolution definition
* @{
*/
#define ADC_RESOLUTION_12B 0
#define ADC_RESOLUTION_14B 2
#define ADC_RESOLUTION_16B 4
/**
* @}
*/
/** @defgroup ADC_VREF adc reference select definition
* @{
*/
#define ADC_VREF_3P2V 0
#define ADC_VREF_2P0V 1
/**
* @}
*/
/** @defgroup ADC_TSEN_MOD adc tsen mode definition
* @{
*/
#define ADC_TSEN_MOD_INTERNAL_DIODE 0
#define ADC_TSEN_MOD_EXTERNAL_DIODE 1
/**
* @}
*/
/** @defgroup ADC_INTSTS adc interrupt status definition
* @{
*/
#define ADC_INTSTS_NEG_SATURATION (1 << 0)
#define ADC_INTSTS_POS_SATURATION (1 << 1)
#define ADC_INTSTS_FIFO_UNDERRUN (1 << 2)
#define ADC_INTSTS_FIFO_OVERRUN (1 << 3)
#define ADC_INTSTS_ADC_READY (1 << 4)
/**
* @}
*/
/** @defgroup ADC_INTCLR adc interrupt clear definition
* @{
*/
#define ADC_INTCLR_NEG_SATURATION (1 << 0)
#define ADC_INTCLR_POS_SATURATION (1 << 1)
#define ADC_INTCLR_FIFO_UNDERRUN (1 << 2)
#define ADC_INTCLR_FIFO_OVERRUN (1 << 3)
#define ADC_INTCLR_ADC_READY (1 << 4)
/**
* @}
*/
/**
* @brief ADC configuration structure
*
* @param clk_div ADC clock divison, use @ref ADC_CLK_DIV
* @param scan_conv_mode ADC scan mode enable
* @param continuous_conv_mode ADC continuous conversion enable
* @param differential_mode ADC differential mode enable
* @param resolution ADC resolution, use @ref ADC_RESOLUTION
* @param vref ADC reference select, use @ref ADC_VREF
*/
struct bflb_adc_config_s {
uint8_t clk_div;
uint8_t scan_conv_mode;
uint8_t continuous_conv_mode;
uint8_t differential_mode;
uint8_t resolution;
uint8_t vref;
};
/**
* @brief ADC channel select
*
* @param pos_chan Select ADC positive input in none-scan mode
* @param neg_chan Select ADC negative input in none-scan mode
*/
struct bflb_adc_channel_s {
uint8_t pos_chan;
uint8_t neg_chan;
};
/**
* @brief ADC result select
*
* @param pos_chan ADC positive channel
* @param neg_chan ADC negative channel
* @param value ADC value
* @param millivolt ADC voltage result
*/
struct bflb_adc_result_s {
int8_t pos_chan;
int8_t neg_chan;
int32_t value;
int32_t millivolt;
};
#ifdef __cplusplus
extern "C" {
#endif
/**
* @brief Initialize adc.
*
* @param [in] dev device handle
* @param [in] config pointer to save adc configuration
*/
void bflb_adc_init(struct bflb_device_s *dev, const struct bflb_adc_config_s *config);
/**
* @brief Deinitialize adc.
*
* @param [in] dev device handle
*/
void bflb_adc_deinit(struct bflb_device_s *dev);
/**
* @brief Enable adc rx dma.
*
* @param [in] dev device handle
* @param [in] enable true means enable, otherwise disable.
*/
void bflb_adc_link_rxdma(struct bflb_device_s *dev, bool enable);
/**
* @brief Config adc channels to sample.
*
* @param [in] dev device handle
* @param [in] chan pointer to the channel configurations.
* @param [in] channels pair number of channels
* @return Zero on success; a negated errno value on failure
*/
int bflb_adc_channel_config(struct bflb_device_s *dev, struct bflb_adc_channel_s *chan, uint8_t channels);
/**
* @brief Start adc conversion
*
* @param [in] dev device handle
*/
void bflb_adc_start_conversion(struct bflb_device_s *dev);
/**
* @brief Stop adc conversion
*
* @param [in] dev device handle
*/
void bflb_adc_stop_conversion(struct bflb_device_s *dev);
/**
* @brief Get adc number of completed conversions
*
* @param [in] dev device handle
* @return number of completed conversions
*/
uint8_t bflb_adc_get_count(struct bflb_device_s *dev);
/**
* @brief Read adc conversion value
*
* @param [in] dev device handle
* @return conversion value
*/
uint32_t bflb_adc_read_raw(struct bflb_device_s *dev);
/**
* @brief Enable or disable adc conversion completion interrupt.
* Triggerring when a channel conversion is completed.
*
* @param [in] dev device handle
* @param [in] mask true means disable, false means enable
*/
void bflb_adc_rxint_mask(struct bflb_device_s *dev, bool mask);
/**
* @brief Enable or disable adc error interrupt.
*
* @param [in] dev device handle
* @param [in] mask true means disable, false means enable
*/
void bflb_adc_errint_mask(struct bflb_device_s *dev, bool mask);
/**
* @brief Get adc interrupt instatus.
*
* @param [in] dev device handle
* @return interrupt instatus value, use @ref ADC_INTSTS
*/
uint32_t bflb_adc_get_intstatus(struct bflb_device_s *dev);
/**
* @brief Clear adc interrupt instatus.
*
* @param [in] dev device handle
* @param [in] int_clear interrupt clear value, use @ref ADC_INTCLR
*/
void bflb_adc_int_clear(struct bflb_device_s *dev, uint32_t int_clear);
/**
* @brief Parse adc conversion value into millivolt and actual numerical value.
*
* @param [in] dev device handle
* @param [in] buffer pointer to adc original value from bflb_adc_read_raw api
* @param [out] result pointer to save parse result
* @param [in] count count to parse
*/
void bflb_adc_parse_result(struct bflb_device_s *dev, uint32_t *buffer, struct bflb_adc_result_s *result, uint16_t count);
/**
* @brief Initialize adc temperature sensor
*
* @param [in] dev device handle
* @param [in] tsen_mod temperature sensor mode, use @ref ADC_TSEN_MOD
*/
void bflb_adc_tsen_init(struct bflb_device_s *dev, uint8_t tsen_mod);
/**
* @brief Get adc temperature
*
* @param [in] dev device handle
* @return temperature
*/
float bflb_adc_tsen_get_temp(struct bflb_device_s *dev);
/**
* @brief Enable adc vbat power.
*
* @param [in] dev device handle
*/
void bflb_adc_vbat_enable(struct bflb_device_s *dev);
/**
* @brief Disable adc vbat power.
*
* @param [in] dev device handle
*/
void bflb_adc_vbat_disable(struct bflb_device_s *dev);
#ifdef __cplusplus
}
#endif
/**
* @}
*/
/**
* @}
*/
#endif
|
