rt-thread/bsp/hc32/libraries/hc32_drivers/drv_adc.h

/*
 * Copyright (C) 2022-2024, Xiaohua Semiconductor Co., Ltd.
 *
 * SPDX-License-Identifier: Apache-2.0
 *
 * Change Logs:
 * Date           Author       Notes
 * 2022-04-28     CDT          first version
 * 2024-02-20     CDT          add structure for associating with the dma
 */

#ifndef __DRV_ADC_H__
#define __DRV_ADC_H__

/*******************************************************************************
 * Include files
 ******************************************************************************/
#include <rtthread.h>
#include <rtdevice.h>
#include "board_config.h"
#include "drv_irq.h"
#include "drv_dma.h"

#include "hc32_ll.h"

/* C binding of definitions if building with C++ compiler */
#ifdef __cplusplus
extern "C"
{
#endif


/*******************************************************************************
 * Global type definitions ('typedef')
 ******************************************************************************/
struct adc_dev_init_params
{
    char name[8];
    uint16_t vref;                      /*!< Specifies the ADC reference voltage, unit is mv */
    uint16_t resolution;                /*!< Specifies the ADC resolution.
                                             This parameter can be a value of @ref ADC_Resolution */
    uint16_t data_align;                /*!< Specifies ADC data alignment.
                                             This parameter can be a value of @ref ADC_Data_Align */
    rt_bool_t hard_trig_enable;

    uint32_t hard_trig_src;             /*a value of @ref ADC_Hard_Trigger_Sel */
    rt_bool_t internal_trig0_comtrg0_enable;
    rt_bool_t internal_trig0_comtrg1_enable;
    en_event_src_t internal_trig0_sel;         /*@ref en_event_src_t in details */
    rt_bool_t internal_trig1_comtrg0_enable;
    rt_bool_t internal_trig1_comtrg1_enable;
    en_event_src_t internal_trig1_sel;         /*@ref en_event_src_t in details */

    rt_bool_t continue_conv_mode_enable;
    rt_bool_t data_reg_auto_clear;
    uint32_t eoc_poll_time_max;
    struct dma_config *adc_eoca_dma;
};

struct adc_dev_dma_priv_ops
{
    rt_err_t (*dma_trig_start)(void);
    rt_err_t (*dma_trig_stop)(void);
    rt_err_t (*dma_trig_config)(void);
};

struct adc_dev_priv_params
{
    uint32_t flag;
    struct adc_dev_dma_priv_ops *ops;
};

/*******************************************************************************
 * Global pre-processor symbols/macros ('#define')
 ******************************************************************************/
#define ADC_USING_EOCA_DMA_FLAG     (1U)

/*******************************************************************************
 * Global variable definitions ('extern')
 ******************************************************************************/

/*******************************************************************************
 * Global function prototypes (definition in C source)
 ******************************************************************************/
int rt_hw_adc_init(void);


#ifdef __cplusplus
}
#endif

#endif /* __DRV_ADC_H__ */

/*******************************************************************************
 * EOF (not truncated)
 ******************************************************************************/