18#ifndef __VSF_TEMPLATE_ADC_H__
19#define __VSF_TEMPLATE_ADC_H__
39#ifndef VSF_ADC_CFG_MULTI_CLASS
40# define VSF_ADC_CFG_MULTI_CLASS ENABLED
50#if defined(VSF_HW_ADC_COUNT) && !defined(VSF_HW_ADC_MASK)
51# define VSF_HW_ADC_MASK VSF_HAL_COUNT_TO_MASK(VSF_HW_ADC_COUNT)
61#if defined(VSF_HW_ADC_MASK) && !defined(VSF_HW_ADC_COUNT)
62# define VSF_HW_ADC_COUNT VSF_HAL_MASK_TO_COUNT(VSF_HW_ADC_MASK)
74#ifndef VSF_ADC_CFG_PREFIX
75# if VSF_ADC_CFG_MULTI_CLASS == ENABLED
76# define VSF_ADC_CFG_PREFIX vsf
77# elif defined(VSF_HW_ADC_COUNT) && (VSF_HW_ADC_COUNT != 0)
78# define VSF_ADC_CFG_PREFIX vsf_hw
80# define VSF_ADC_CFG_PREFIX vsf
93#ifndef VSF_ADC_CFG_FUNCTION_RENAME
94# define VSF_ADC_CFG_FUNCTION_RENAME ENABLED
105#ifndef VSF_ADC_CFG_REIMPLEMENT_TYPE_MODE
106# define VSF_ADC_CFG_REIMPLEMENT_TYPE_MODE DISABLED
117#ifndef VSF_ADC_CFG_REIMPLEMENT_TYPE_CHANNEL_MODE
118# define VSF_ADC_CFG_REIMPLEMENT_TYPE_CHANNEL_MODE DISABLED
129#ifndef VSF_ADC_CFG_REIMPLEMENT_TYPE_IRQ_MASK
130# define VSF_ADC_CFG_REIMPLEMENT_TYPE_IRQ_MASK DISABLED
144#ifndef VSF_ADC_CFG_REIMPLEMENT_TYPE_CHANNEL_CFG
145# define VSF_ADC_CFG_REIMPLEMENT_TYPE_CHANNEL_CFG DISABLED
160#ifndef VSF_ADC_CFG_REIMPLEMENT_TYPE_CFG
161# define VSF_ADC_CFG_REIMPLEMENT_TYPE_CFG DISABLED
173#ifndef VSF_ADC_CFG_REIMPLEMENT_TYPE_CAPABILITY
174# define VSF_ADC_CFG_REIMPLEMENT_TYPE_CAPABILITY DISABLED
186#ifndef VSF_ADC_CFG_INHERIT_HAL_CAPABILITY
187# define VSF_ADC_CFG_INHERIT_HAL_CAPABILITY ENABLED
201#define VSF_ADC_APIS(__prefix_name) \
202 __VSF_HAL_TEMPLATE_API(__prefix_name, vsf_err_t, adc, init, VSF_MCONNECT(__prefix_name, _t) *adc_ptr, vsf_adc_cfg_t *cfg_ptr) \
203 __VSF_HAL_TEMPLATE_API(__prefix_name, void, adc, fini, VSF_MCONNECT(__prefix_name, _t) *adc_ptr) \
204 __VSF_HAL_TEMPLATE_API(__prefix_name, vsf_err_t, adc, get_configuration, VSF_MCONNECT(__prefix_name, _t) *adc_ptr, vsf_adc_cfg_t *cfg_ptr) \
205 __VSF_HAL_TEMPLATE_API(__prefix_name, fsm_rt_t, adc, enable, VSF_MCONNECT(__prefix_name, _t) *adc_ptr) \
206 __VSF_HAL_TEMPLATE_API(__prefix_name, fsm_rt_t, adc, disable, VSF_MCONNECT(__prefix_name, _t) *adc_ptr) \
207 __VSF_HAL_TEMPLATE_API(__prefix_name, vsf_adc_status_t, adc, status, VSF_MCONNECT(__prefix_name, _t) *adc_ptr) \
208 __VSF_HAL_TEMPLATE_API(__prefix_name, vsf_adc_capability_t, adc, capability, VSF_MCONNECT(__prefix_name, _t) *adc_ptr) \
209 __VSF_HAL_TEMPLATE_API(__prefix_name, void, adc, irq_enable, VSF_MCONNECT(__prefix_name, _t) *adc_ptr, vsf_adc_irq_mask_t irq_mask) \
210 __VSF_HAL_TEMPLATE_API(__prefix_name, void, adc, irq_disable, VSF_MCONNECT(__prefix_name, _t) *adc_ptr, vsf_adc_irq_mask_t irq_mask) \
211 __VSF_HAL_TEMPLATE_API(__prefix_name, vsf_err_t, adc, channel_request_once, VSF_MCONNECT(__prefix_name, _t) *adc_ptr, vsf_adc_channel_cfg_t *channel_cfg, void *buffer_ptr) \
212 __VSF_HAL_TEMPLATE_API(__prefix_name, vsf_err_t, adc, channel_config, VSF_MCONNECT(__prefix_name, _t) *adc_ptr, vsf_adc_channel_cfg_t *channel_cfgs_ptr, uint32_t channel_cfgs_cnt) \
213 __VSF_HAL_TEMPLATE_API(__prefix_name, vsf_err_t, adc, channel_request, VSF_MCONNECT(__prefix_name, _t) *adc_ptr, void *buffer_ptr, uint_fast32_t count)
217#if VSF_ADC_CFG_REIMPLEMENT_TYPE_MODE == DISABLED
402#if VSF_ADC_CFG_REIMPLEMENT_TYPE_CHANNEL_MODE == DISABLED
570#if VSF_ADC_CFG_REIMPLEMENT_TYPE_IRQ_MASK == DISABLED
605#if VSF_ADC_CFG_REIMPLEMENT_TYPE_CHANNEL_CFG == DISABLED
620#if VSF_ADC_CFG_REIMPLEMENT_TYPE_CFG == DISABLED
646#if VSF_ADC_CFG_REIMPLEMENT_TYPE_STATUS == DISABLED
672#if VSF_ADC_CFG_REIMPLEMENT_TYPE_CAPABILITY == DISABLED
690#if VSF_ADC_CFG_INHERIT_HAL_CAPABILITY == ENABLED
702#undef __VSF_HAL_TEMPLATE_API
703#define __VSF_HAL_TEMPLATE_API VSF_HAL_TEMPLATE_API_FP
709#if VSF_ADC_CFG_MULTI_CLASS == ENABLED
914#if VSF_ADC_CFG_FUNCTION_RENAME == ENABLED
915# define __vsf_adc_t VSF_MCONNECT(VSF_ADC_CFG_PREFIX, _adc_t)
916# define vsf_adc_init(__ADC, ...) VSF_MCONNECT(VSF_ADC_CFG_PREFIX, _adc_init) ((__vsf_adc_t *)(__ADC), ##__VA_ARGS__)
917# define vsf_adc_fini(__ADC) VSF_MCONNECT(VSF_ADC_CFG_PREFIX, _adc_fini) ((__vsf_adc_t *)(__ADC))
918# define vsf_adc_get_configuration(__ADC, ...) VSF_MCONNECT(VSF_ADC_CFG_PREFIX, _adc_get_configuration) ((__vsf_adc_t *)(__ADC), ##__VA_ARGS__)
919# define vsf_adc_enable(__ADC) VSF_MCONNECT(VSF_ADC_CFG_PREFIX, _adc_enable) ((__vsf_adc_t *)(__ADC))
920# define vsf_adc_disable(__ADC) VSF_MCONNECT(VSF_ADC_CFG_PREFIX, _adc_disable) ((__vsf_adc_t *)(__ADC))
921# define vsf_adc_status(__ADC) VSF_MCONNECT(VSF_ADC_CFG_PREFIX, _adc_status) ((__vsf_adc_t *)(__ADC))
922# define vsf_adc_capability(__ADC) VSF_MCONNECT(VSF_ADC_CFG_PREFIX, _adc_capability) ((__vsf_adc_t *)(__ADC))
923# define vsf_adc_irq_enable(__ADC, ...) VSF_MCONNECT(VSF_ADC_CFG_PREFIX, _adc_irq_enable) ((__vsf_adc_t *)(__ADC), ##__VA_ARGS__)
924# define vsf_adc_irq_disable(__ADC, ...) VSF_MCONNECT(VSF_ADC_CFG_PREFIX, _adc_irq_disable) ((__vsf_adc_t *)(__ADC), ##__VA_ARGS__)
925# define vsf_adc_channel_request_once(__ADC, ...) VSF_MCONNECT(VSF_ADC_CFG_PREFIX, _adc_channel_request_once) ((__vsf_adc_t *)(__ADC), ##__VA_ARGS__)
926# define vsf_adc_channel_config(__ADC, ...) VSF_MCONNECT(VSF_ADC_CFG_PREFIX, _adc_channel_config) ((__vsf_adc_t *)(__ADC), ##__VA_ARGS__)
927# define vsf_adc_channel_request(__ADC, ...) VSF_MCONNECT(VSF_ADC_CFG_PREFIX, _adc_channel_request) ((__vsf_adc_t *)(__ADC), ##__VA_ARGS__)
vsf_err_t
Definition __type.h:42
vsf_arch_prio_t
Definition cortex_a_generic.h:88
const i_spi_t vsf_spi_irq_mask_t irq_mask
Definition spi_interface.h:38
unsigned short uint16_t
Definition stdint.h:7
unsigned uint32_t
Definition stdint.h:9
unsigned int uint_fast32_t
Definition stdint.h:27
unsigned char uint8_t
Definition stdint.h:5
Predefined VSF ADC capability that can be reimplemented in specific HAL drivers.
Definition vsf_template_adc.h:689
inherit(vsf_peripheral_capability_t) vsf_adc_irq_mask_t irq_mask
uint8_t max_data_bits
Definition vsf_template_adc.h:695
uint8_t channel_count
Definition vsf_template_adc.h:696
Configuration structure for ADC.
Definition vsf_template_adc.h:639
vsf_adc_isr_t isr
Interrupt service routine configuration.
Definition vsf_template_adc.h:641
uint32_t clock_hz
Clock frequency in Hertz.
Definition vsf_template_adc.h:642
vsf_adc_mode_t mode
ADC working mode.
Definition vsf_template_adc.h:640
adc channel configuration
Definition vsf_template_adc.h:613
vsf_adc_channel_mode_t mode
Channel mode.
Definition vsf_template_adc.h:614
uint16_t sample_cycles
Sample cycles.
Definition vsf_template_adc.h:615
uint8_t channel
Channel Index.
Definition vsf_template_adc.h:616
adc isr for api
Definition vsf_template_adc.h:626
vsf_arch_prio_t prio
Definition vsf_template_adc.h:629
void * target_ptr
Definition vsf_template_adc.h:628
vsf_adc_isr_handler_t * handler_fn
Definition vsf_template_adc.h:627
Definition vsf_template_adc.h:700
Predefined VSF ADC status that can be reimplemented in specific HAL drivers.
Definition vsf_template_adc.h:661
uint32_t value
Definition vsf_template_adc.h:667
Definition vsf_template_adc.h:710
const vsf_adc_op_t * op
Definition vsf_template_adc.h:711
Definition vsf_template_hal_driver.h:203
Definition vsf_template_hal_driver.h:196
void vsf_adc_isr_handler_t(void *target_ptr, vsf_adc_t *adc_ptr, vsf_adc_irq_mask_t irq_mask)
Definition adc.h:149
vsf_adc_irq_mask_t
Definition adc.h:130
vsf_adc_mode_t
Definition adc.h:114
fsm_rt_t
Definition vsf_fsm.h:315
void vsf_adc_isr_handler_t(void *target_ptr, vsf_adc_t *adc_ptr, vsf_adc_irq_mask_t irq_mask)
Definition vsf_template_adc.h:622
vsf_adc_capability_t vsf_adc_capability(vsf_adc_t *adc_ptr)
Get the capability of ADC instance.
Definition adc_common.c:111
fsm_rt_t vsf_adc_disable(vsf_adc_t *adc_ptr)
Disable an ADC instance.
Definition adc_common.c:75
vsf_err_t vsf_adc_channel_request_once(vsf_adc_t *adc_ptr, vsf_adc_channel_cfg_t *channel_cfg, void *buffer_ptr)
ADC request sampling once.
Definition adc_common.c:120
void vsf_adc_irq_enable(vsf_adc_t *adc_ptr, vsf_adc_irq_mask_t irq_mask)
Enable interrupt masks of ADC instance.
Definition adc_common.c:84
struct vsf_adc_capability_t vsf_adc_capability_t
Predefined VSF ADC capability that can be reimplemented in specific HAL drivers.
@ VSF_ADC_IRQ_COUNT
Definition vsf_template_adc.h:600
@ VSF_ADC_IRQ_ALL_BITS_MASK
Definition vsf_template_adc.h:601
struct vsf_adc_status_t vsf_adc_status_t
Predefined VSF ADC status that can be reimplemented in specific HAL drivers.
vsf_err_t vsf_adc_channel_request(vsf_adc_t *adc_ptr, void *buffer_ptr, uint_fast32_t count)
ADC channel request.
Definition adc_common.c:138
vsf_adc_status_t vsf_adc_status(vsf_adc_t *adc_ptr)
Get the status of ADC instance.
Definition adc_common.c:102
vsf_err_t vsf_adc_channel_config(vsf_adc_t *adc_ptr, vsf_adc_channel_cfg_t *cfgs_ptr, uint32_t cnt)
ADC channel configuration.
Definition adc_common.c:129
fsm_rt_t vsf_adc_enable(vsf_adc_t *adc_ptr)
Enable an ADC instance.
Definition adc_common.c:66
@ VSF_ADC_CHANNEL_GAIN_MASK
Definition vsf_template_adc.h:551
@ VSF_ADC_CHANNEL_MODE_ALL_BITS_MASK
Definition vsf_template_adc.h:565
@ VSF_ADC_CHANNEL_MODE_MASK_COUNT
Definition vsf_template_adc.h:564
@ VSF_ADC_CHANNEL_REF_VDD_MASK
Definition vsf_template_adc.h:559
@ VSF_ADC_CHANNEL_GAIN_COUNT
Definition vsf_template_adc.h:550
@ VSF_ADC_CHANNEL_REF_VDD_COUNT
Definition vsf_template_adc.h:558
vsf_adc_irq_mask_t
Predefined VSF ADC interrupt that can be reimplemented in specific HAL drivers.
Definition vsf_template_adc.h:594
@ VSF_ADC_IRQ_MASK_CPL
Conversion complete interrupt.
Definition vsf_template_adc.h:595
@ VSF_ADC_MODE_ALL_BITS_MASK
Definition vsf_template_adc.h:396
@ VSF_ADC_EXTERN_TRIGGER_COUNT
Definition vsf_template_adc.h:390
@ VSF_ADC_MODE_MASK_COUNT
Definition vsf_template_adc.h:395
@ VSF_ADC_REF_VDD_MASK
Definition vsf_template_adc.h:377
@ VSF_ADC_REF_VDD_COUNT
Definition vsf_template_adc.h:376
@ VSF_ADC_DATA_ALIGN_MASK
Definition vsf_template_adc.h:383
@ VSF_ADC_DATA_ALIGN_COUNT
Definition vsf_template_adc.h:382
@ VSF_ADC_SCAN_CONV_MASK
Definition vsf_template_adc.h:387
@ VSF_ADC_EXTERN_TRIGGER_MASK
Definition vsf_template_adc.h:391
@ VSF_ADC_SCAN_CONV_COUNT
Definition vsf_template_adc.h:386
vsf_adc_channel_mode_t
Predefined VSF ADC channel modes that can be reimplemented in specific HAL drivers.
Definition vsf_template_adc.h:446
@ VSF_ADC_CHANNEL_REF_VDD_1_3
Channel reference voltage set to VDD/1.3. Uses VDD/1.3 as reference voltage for this channel.
Definition vsf_template_adc.h:535
@ VSF_ADC_CHANNEL_REF_VDD_1_2
Channel reference voltage set to VDD/1.2. Uses VDD/1.2 as reference voltage for this channel.
Definition vsf_template_adc.h:525
@ VSF_ADC_CHANNEL_REF_VDD_1
Channel reference voltage set to VDD/1. Uses the full supply voltage as reference for this channel.
Definition vsf_template_adc.h:515
@ VSF_ADC_CHANNEL_GAIN_1_4
Channel gain set to 1/4. Input signal is attenuated to 1/4 of its original value.
Definition vsf_template_adc.h:475
@ VSF_ADC_CHANNEL_GAIN_1_5
Channel gain set to 1/5. Input signal is attenuated to 1/5 of its original value.
Definition vsf_template_adc.h:465
@ VSF_ADC_CHANNEL_GAIN_1_2
Channel gain set to 1/2. Input signal is attenuated to 1/2 of its original value.
Definition vsf_template_adc.h:495
@ VSF_ADC_CHANNEL_GAIN_1
Channel gain set to 1. Input signal remains at its original value (no amplification or attenuation).
Definition vsf_template_adc.h:505
@ VSF_ADC_CHANNEL_REF_VDD_1_4
Channel reference voltage set to VDD/1.4. Uses VDD/1.4 as reference voltage for this channel.
Definition vsf_template_adc.h:545
@ VSF_ADC_CHANNEL_GAIN_1_3
Channel gain set to 1/3. Input signal is attenuated to 1/3 of its original value.
Definition vsf_template_adc.h:485
@ VSF_ADC_CHANNEL_GAIN_1_6
Channel gain set to 1/6. Input signal is attenuated to 1/6 of its original value.
Definition vsf_template_adc.h:455
vsf_err_t vsf_adc_init(vsf_adc_t *adc_ptr, vsf_adc_cfg_t *cfg_ptr)
Initialize an ADC instance.
Definition adc_common.c:38
vsf_adc_mode_t
Predefined VSF ADC modes that can be reimplemented in specific HAL drivers.
Definition vsf_template_adc.h:262
@ VSF_ADC_EXTERN_TRIGGER_2
External trigger source 2. Selects the third external event source to trigger conversion.
Definition vsf_template_adc.h:371
@ VSF_ADC_DATA_ALIGN_LEFT
Data alignment set to left. The converted data is left-aligned in the data register.
Definition vsf_template_adc.h:321
@ VSF_ADC_REF_VDD_1_2
Reference voltage set to VDD/2. Uses half of the supply voltage as reference for ADC conversion.
Definition vsf_template_adc.h:281
@ VSF_ADC_DATA_ALIGN_RIGHT
Data alignment set to right. The converted data is right-aligned in the data register.
Definition vsf_template_adc.h:311
@ VSF_ADC_REF_VDD_1_4
Reference voltage set to VDD/4. Uses one-fourth of the supply voltage as reference for ADC conversion...
Definition vsf_template_adc.h:301
@ VSF_ADC_EXTERN_TRIGGER_1
External trigger source 1. Selects the second external event source to trigger conversion.
Definition vsf_template_adc.h:361
@ VSF_ADC_REF_VDD_1_3
Reference voltage set to VDD/3. Uses one-third of the supply voltage as reference for ADC conversion.
Definition vsf_template_adc.h:291
@ VSF_ADC_EXTERN_TRIGGER_0
External trigger source 0. Selects the first external event source to trigger conversion.
Definition vsf_template_adc.h:351
@ VSF_ADC_SCAN_CONV_SINGLE_MODE
Single conversion mode. Conversion is performed once for a single channel.
Definition vsf_template_adc.h:331
@ VSF_ADC_SCAN_CONV_SEQUENCE_MODE
Sequence conversion mode. Conversions are performed in sequence for multiple channels.
Definition vsf_template_adc.h:341
@ VSF_ADC_REF_VDD_1
Reference voltage set to VDD. Uses the full supply voltage as reference for ADC conversion.
Definition vsf_template_adc.h:271
vsf_err_t vsf_adc_get_configuration(vsf_adc_t *adc_ptr, vsf_adc_cfg_t *cfg_ptr)
Get current configuration of an ADC instance.
Definition adc_common.c:56
#define VSF_ADC_APIS(__prefix_name)
ADC API template, used to generate ADC type, specific prefix function declarations,...
Definition vsf_template_adc.h:201
struct vsf_adc_isr_t vsf_adc_isr_t
adc isr for api
void vsf_adc_fini(vsf_adc_t *adc_ptr)
Finalize an ADC instance.
Definition adc_common.c:47
void vsf_adc_irq_disable(vsf_adc_t *adc_ptr, vsf_adc_irq_mask_t irq_mask)
Disable interrupt masks of ADC instance.
Definition adc_common.c:93
struct vsf_adc_cfg_t vsf_adc_cfg_t
Configuration structure for ADC.