Go to the documentation of this file.
52 #ifndef __GR55xx_HAL_ADC_H__
53 #define __GR55xx_HAL_ADC_H__
205 #define HAL_ADC_ERROR_NONE ((uint32_t)0x00000000)
206 #define HAL_ADC_ERROR_TIMEOUT ((uint32_t)0x00000001)
207 #define HAL_ADC_ERROR_DMA ((uint32_t)0x00000004)
208 #define HAL_ADC_ERROR_INVALID_PARAM ((uint32_t)0x00000008)
215 #define ADC_CLK_16M LL_ADC_CLK_16M
216 #define ADC_CLK_8M LL_ADC_CLK_8M
217 #define ADC_CLK_4M LL_ADC_CLK_4M
218 #define ADC_CLK_1M LL_ADC_CLK_1M
219 #define ADC_CLK_16K LL_ADC_CLK_16K
220 #define ADC_CLK_8K LL_ADC_CLK_8K
221 #define ADC_CLK_4K LL_ADC_CLK_4K
222 #define ADC_CLK_NONE LL_ADC_CLK_NONE
229 #define ADC_REF_VALUE_0P8 LL_ADC_REF_VALUE_0P8
230 #define ADC_REF_VALUE_1P2 LL_ADC_REF_VALUE_1P2
231 #define ADC_REF_VALUE_1P6 LL_ADC_REF_VALUE_1P6
232 #define ADC_REF_VALUE_2P0 LL_ADC_REF_VALUE_2P0
239 #define ADC_INPUT_SINGLE LL_ADC_INPUT_SINGLE
240 #define ADC_INPUT_DIFFERENTIAL LL_ADC_INPUT_DIFFERENTIAL
246 #define ADC_INPUT_SRC_IO0 LL_ADC_INPUT_SRC_IO0
247 #define ADC_INPUT_SRC_IO1 LL_ADC_INPUT_SRC_IO1
248 #define ADC_INPUT_SRC_IO2 LL_ADC_INPUT_SRC_IO2
249 #define ADC_INPUT_SRC_IO3 LL_ADC_INPUT_SRC_IO3
250 #define ADC_INPUT_SRC_IO4 LL_ADC_INPUT_SRC_IO4
251 #define ADC_INPUT_SRC_IO5 LL_ADC_INPUT_SRC_IO5
252 #define ADC_INPUT_SRC_IO6 LL_ADC_INPUT_SRC_IO6
253 #define ADC_INPUT_SRC_IO7 LL_ADC_INPUT_SRC_IO7
254 #define ADC_INPUT_SRC_TMP LL_ADC_INPUT_SRC_TMP
255 #define ADC_INPUT_SRC_BAT LL_ADC_INPUT_SRC_BAT
256 #define ADC_INPUT_SRC_REF LL_ADC_INPUT_SRC_REF
263 #define ADC_REF_SRC_BUF_INT LL_ADC_REF_SRC_BUF_INT
264 #define ADC_REF_SRC_IO0 LL_ADC_REF_SRC_IO0
265 #define ADC_REF_SRC_IO1 LL_ADC_REF_SRC_IO1
266 #define ADC_REF_SRC_IO2 LL_ADC_REF_SRC_IO2
267 #define ADC_REF_SRC_IO3 LL_ADC_REF_SRC_IO3
273 #define ADC_DEFAULT_CONFIG LL_ADC_DEFAULT_CONFIG
285 #define __HAL_ADC_RESET_HANDLE_STATE(__HANDLE__) ((__HANDLE__)->state = HAL_ADC_STATE_RESET)
291 #define __HAL_ADC_ENABLE(__HANDLE__) ll_adc_enable()
297 #define __HAL_ADC_DISABLE(__HANDLE__) ll_adc_disable()
303 #define __HAL_ADC_GET_FLAG_NOTEMPTY(__HANDLE__) ll_adc_is_fifo_notempty()
309 #define __HAL_ADC_TRY_SWTOKEN_LOCK(__HANDLE__) ll_adc_try_lock_sw_token()
315 #define __HAL_ADC_FLUSH_FIFO(__HANDLE__) do { \
316 while(ll_adc_is_fifo_notempty()) \
318 ll_adc_flush_fifo(); \
334 #define IS_ADC_INPUT(__INPUT__) (((__INPUT__) == ADC_INPUT_SRC_IO0) || \
335 ((__INPUT__) == ADC_INPUT_SRC_IO1) || \
336 ((__INPUT__) == ADC_INPUT_SRC_IO2) || \
337 ((__INPUT__) == ADC_INPUT_SRC_IO3) || \
338 ((__INPUT__) == ADC_INPUT_SRC_IO4) || \
339 ((__INPUT__) == ADC_INPUT_SRC_IO5) || \
340 ((__INPUT__) == ADC_INPUT_SRC_IO6) || \
341 ((__INPUT__) == ADC_INPUT_SRC_IO7) || \
342 ((__INPUT__) == ADC_INPUT_SRC_TMP) || \
343 ((__INPUT__) == ADC_INPUT_SRC_BAT) || \
344 ((__INPUT__) == ADC_INPUT_SRC_REF))
351 #define IS_ADC_INPUT_MODE(__MODE__) (((__MODE__) == ADC_INPUT_SINGLE) || \
352 ((__MODE__) == ADC_INPUT_DIFFERENTIAL)
359 #define IS_ADC_REF(__INPUT__) (((__INPUT__) == ADC_REF_SRC_BUF_INT) || \
360 ((__INPUT__) == ADC_REF_SRC_INT) || \
361 ((__INPUT__) == ADC_REF_SRC_IO0) || \
362 ((__INPUT__) == ADC_REF_SRC_IO1) || \
363 ((__INPUT__) == ADC_REF_SRC_IO2) || \
364 ((__INPUT__) == ADC_REF_SRC_IO3))
371 #define IS_ADC_REF_VALUE(__VALUE__) (((__VALUE__) >= ADC_REF_VALUE_0P5) && \
372 ((__VALUE__) <= ADC_REF_VALUE_2P0))
380 #define IS_ADC_CLOCK(__CLOCK__) (((__CLOCK__) == ADC_CLK_16M) || \
381 ((__CLOCK__) == ADC_CLK_8M) || \
382 ((__CLOCK__) == ADC_CLK_1M) || \
383 ((__CLOCK__) == ADC_CLK_250K)|| \
384 ((__CLOCK__) == ADC_CLK_16K)|| \
385 ((__CLOCK__) == ADC_CLK_8K)|| \
386 ((__CLOCK__) == ADC_CLK_1K)|| \
387 ((__CLOCK__) == ADC_CLK_NONE))
389 #define IS_ADC_CLOCK(__CLOCK__) (((__CLOCK__) == ADC_CLK_16M) || \
390 ((__CLOCK__) == ADC_CLK_8M) || \
391 ((__CLOCK__) == ADC_CLK_4M) || \
392 ((__CLOCK__) == ADC_CLK_2M) || \
393 ((__CLOCK__) == ADC_CLK_1M) || \
394 ((__CLOCK__) == ADC_CLK_1P6M))
void hal_adc_temperature_conv(adc_handle_t *hadc, uint16_t *inbuf, double *outbuf, uint32_t buflen)
Convert the ADC conversion results to temperature value.
hal_status_t hal_adc_poll_for_conversion(adc_handle_t *p_adc, uint16_t *p_data, uint32_t length)
Polling for conversion.
void(* adc_conv_cplt_callback)(adc_handle_t *p_adc)
uint32_t hal_adc_get_error(adc_handle_t *p_adc)
Return the ADC error code.
uint16_t adc_get_trim_func(adc_trim_info_t *p_adc_trim)
adc_get_trim_func.
hal_lock_t
HAL Lock structures definition.
hal_status_t hal_adc_start_dma_sg_llp(adc_handle_t *p_adc, uint16_t *p_data, uint32_t length, dma_sg_llp_config_t *sg_llp_config)
DMA for conversion.
void(* adc_msp_init)(adc_handle_t *p_adc)
Header file containing functions prototypes of ADC LL library.
hal_status_t hal_adc_stop_dma(adc_handle_t *p_adc)
Abort ongoing conversion (blocking mode).
void hal_adc_vbat_conv(adc_handle_t *hadc, uint16_t *inbuf, double *outbuf, uint32_t buflen)
Convert the ADC conversion results to battery value.
hal_status_t hal_adc_init(adc_handle_t *p_adc)
Initialize the ADC according to the specified parameters in the adc_init_t and initialize the associa...
void hal_adc_voltage_intern(adc_handle_t *hadc, uint16_t *inbuf, double *outbuf, uint32_t buflen)
Convert the ADC conversion results to a voltage value(internal reference).
hal_status_t hal_adc_resume_reg(adc_handle_t *p_adc)
Restore some registers related to ADC configuration after sleep. This function must be used in conjun...
void hal_adc_voltage_extern(adc_handle_t *hadc, double vref, uint16_t *inbuf, double *outbuf, uint32_t buflen)
Convert the ADC conversion results to a voltage value(external reference).
LL DMA sg and llp config definition.
hal_status_t hal_adc_set_dma_threshold(adc_handle_t *p_adc, uint32_t threshold)
Set the FIFO threshold for DMA trigger.
struct _adc_handle adc_handle_t
ADC handle Structure definition.
hal_status_t hal_adc_suspend_reg(adc_handle_t *p_adc)
Suspend some registers related to ADC configuration before sleep.
hal_adc_state_t
HAL ADC State Enumerations definition.
void hal_adc_msp_init(adc_handle_t *p_adc)
Initialize the ADC MSP.
__IO hal_adc_state_t state
void hal_adc_conv_cplt_callback(adc_handle_t *p_adc)
Conversion completed callback.
uint16_t(* adc_get_trim_func)(adc_trim_info_t *p_adc_trim)
ADC handle Structure definition.
Header file containing functions prototypes of DMA HAL library.
uint32_t hal_adc_get_dma_threshold(adc_handle_t *p_adc)
Get the FIFO threshold for DMA trigger.
hal_status_t
HAL Status structures definition.
void hal_adc_msp_deinit(adc_handle_t *p_adc)
De-initialize the ADC MSP.
ADC trim parameter information definition.
ll_adc_init_t adc_init_t
ADC init structure definition.
hal_status_t hal_adc_start_dma(adc_handle_t *p_adc, uint16_t *p_data, uint32_t length)
DMA for conversion.
struct _hal_adc_callback hal_adc_callback_t
HAL ADC Callback function definition.
hal_status_t hal_adc_change_channels(adc_handle_t *p_adc)
Set the new channels parameter to ADC.
hal_status_t hal_adc_deinit(adc_handle_t *p_adc)
De-initialize the ADC peripheral.
DMA handle Structure definition.
This file contains HAL common definitions, enumeration, macros and structures definitions.
HAL ADC Callback function definition.
hal_adc_state_t hal_adc_get_state(adc_handle_t *p_adc)
Return the ADC handle state.
void(* adc_msp_deinit)(adc_handle_t *p_adc)