166 lines
6.9 KiB
C
166 lines
6.9 KiB
C
/**************************************************************************//**
|
|
* @file adc.c
|
|
* @version V3.00
|
|
* $Revision: 10 $
|
|
* $Date: 15/05/04 3:59p $
|
|
* @brief ADC driver source file
|
|
*
|
|
* @note
|
|
* SPDX-License-Identifier: Apache-2.0
|
|
* Copyright (C) 2014 Nuvoton Technology Corp. All rights reserved.
|
|
*****************************************************************************/
|
|
#include "NUC200Series.h"
|
|
|
|
/** @addtogroup Standard_Driver Standard Driver
|
|
@{
|
|
*/
|
|
|
|
/** @addtogroup ADC_Driver ADC Driver
|
|
@{
|
|
*/
|
|
|
|
/** @addtogroup ADC_EXPORTED_FUNCTIONS ADC Exported Functions
|
|
@{
|
|
*/
|
|
|
|
/**
|
|
* @brief This function configures ADC module to be ready for convert the input from selected channel.
|
|
* @param[in] adc The pointer of the specified ADC module.
|
|
* @param[in] u32InputMode Decides the ADC analog input mode. Valid values are:
|
|
* - \ref ADC_ADCR_DIFFEN_SINGLE_END :Single end input mode.
|
|
* - \ref ADC_ADCR_DIFFEN_DIFFERENTIAL :Differential input type.
|
|
* @param[in] u32OpMode Decides the ADC operation mode. Valid values are:
|
|
* - \ref ADC_ADCR_ADMD_SINGLE :Single mode.
|
|
* - \ref ADC_ADCR_ADMD_SINGLE_CYCLE :Single cycle scan mode.
|
|
* - \ref ADC_ADCR_ADMD_CONTINUOUS :Continuous scan mode.
|
|
* @param[in] u32ChMask Channel enable bit. Each bit corresponds to a input channel. Bit 0 is channel 0, bit 1 is channel 1..., bit 7 is channel 7.
|
|
* @return None
|
|
* @details Before starting A/D conversion function, ADEN(ADCR[0]) should be set to 1.
|
|
* @note NUC200 series MCU ADC can only convert 1 channel at a time. If more than 1 channels are enabled, only channel
|
|
* with smallest number will be convert.
|
|
* @note This function does not turn on ADC power nor does trigger ADC conversion.
|
|
*/
|
|
void ADC_Open(ADC_T *adc,
|
|
uint32_t u32InputMode,
|
|
uint32_t u32OpMode,
|
|
uint32_t u32ChMask)
|
|
{
|
|
(adc)->ADCR = ((adc)->ADCR & (~(ADC_ADCR_DIFFEN_Msk | ADC_ADCR_ADMD_Msk))) | \
|
|
(u32InputMode) | \
|
|
(u32OpMode);
|
|
|
|
(adc)->ADCHER = ((adc)->ADCHER & ~ADC_ADCHER_CHEN_Msk) | (u32ChMask);
|
|
|
|
return;
|
|
}
|
|
|
|
/**
|
|
* @brief Disable ADC module.
|
|
* @param[in] adc The pointer of the specified ADC module.
|
|
* @return None
|
|
* @details Disable A/D converter analog circuit for saving power consumption.
|
|
*/
|
|
void ADC_Close(ADC_T *adc)
|
|
{
|
|
(adc)->ADCR &= (~ADC_ADCR_ADEN_Msk);
|
|
return;
|
|
}
|
|
|
|
/**
|
|
* @brief Configure the hardware trigger condition and enable hardware trigger.
|
|
* @param[in] adc The pointer of the specified ADC module.
|
|
* @param[in] u32Source Decides the hardware trigger source. Valid values are:
|
|
* - \ref ADC_ADCR_TRGS_STADC :A/D conversion is started by external STADC pin.
|
|
* - \ref ADC_ADCR_TRGS_PWM :A/D conversion is started by PWM.
|
|
* @param[in] u32Param ADC trigger by external pin, this parameter is used to set trigger condition. Valid values are:
|
|
* - \ref ADC_ADCR_TRGCOND_LOW_LEVEL :STADC Low level active.
|
|
* - \ref ADC_ADCR_TRGCOND_HIGH_LEVEL :STADC High level active.
|
|
* - \ref ADC_ADCR_TRGCOND_FALLING_EDGE :STADC Falling edge active.
|
|
* - \ref ADC_ADCR_TRGCOND_RISING_EDGE :STADC Rising edge active.
|
|
* @return None
|
|
* @details Software should disable TRGEN (ADCR[8]) and ADST (ADCR[11]) before change TRGS(ADCR[5:4]).
|
|
*/
|
|
void ADC_EnableHWTrigger(ADC_T *adc,
|
|
uint32_t u32Source,
|
|
uint32_t u32Param)
|
|
{
|
|
(adc)->ADCR &= ~(ADC_ADCR_TRGS_Msk | ADC_ADCR_TRGCOND_Msk | ADC_ADCR_TRGEN_Msk);
|
|
|
|
(adc)->ADCR |= (u32Source) | (u32Param) | ADC_ADCR_TRGEN_Msk;
|
|
|
|
return;
|
|
}
|
|
|
|
/**
|
|
* @brief Disable hardware trigger ADC function.
|
|
* @param[in] adc The pointer of the specified ADC module.
|
|
* @return None
|
|
* @details Disable triggering of A/D conversion by hardware (external STADC pin or PWM Center-aligned trigger).
|
|
*/
|
|
void ADC_DisableHWTrigger(ADC_T *adc)
|
|
{
|
|
(adc)->ADCR &= ~(ADC_ADCR_TRGS_Msk | ADC_ADCR_TRGCOND_Msk | ADC_ADCR_TRGEN_Msk);
|
|
return;
|
|
}
|
|
|
|
/**
|
|
* @brief Enable the interrupt(s) selected by u32Mask parameter.
|
|
* @param[in] adc The pointer of the specified ADC module.
|
|
* @param[in] u32Mask The combination of interrupt status bits listed below. Each bit
|
|
* corresponds to a interrupt status. This parameter decides which
|
|
* interrupts will be enabled.
|
|
* - \ref ADC_ADF_INT :ADC convert complete interrupt.
|
|
* - \ref ADC_CMP0_INT :ADC comparator 0 interrupt.
|
|
* - \ref ADC_CMP1_INT :ADC comparator 1 interrupt.
|
|
* @return None
|
|
* @details A/D conversion end interrupt request is generated if ADIE bit (ADCR[1]) is set to 1.
|
|
* If the compare function is enabled and the compare condition matches the setting of CMPCOND (ADCMPR0/1[2])
|
|
* and CMPMATCNT (ADCMPR0/1[11:8]), CMPF0/1 bit (ADSR[1]/[2]) will be asserted, in the meanwhile,
|
|
* if CMPIE (ADCMPR0/1[1]) is set to 1, a compare interrupt request is generated.
|
|
*/
|
|
void ADC_EnableInt(ADC_T *adc, uint32_t u32Mask)
|
|
{
|
|
if((u32Mask) & ADC_ADF_INT)
|
|
(adc)->ADCR |= ADC_ADCR_ADIE_Msk;
|
|
if((u32Mask) & ADC_CMP0_INT)
|
|
(adc)->ADCMPR[0] |= ADC_ADCMPR_CMPIE_Msk;
|
|
if((u32Mask) & ADC_CMP1_INT)
|
|
(adc)->ADCMPR[1] |= ADC_ADCMPR_CMPIE_Msk;
|
|
|
|
return;
|
|
}
|
|
|
|
/**
|
|
* @brief Disable the interrupt(s) selected by u32Mask parameter.
|
|
* @param[in] adc The pointer of the specified ADC module.
|
|
* @param[in] u32Mask The combination of interrupt status bits listed below. Each bit
|
|
* corresponds to a interrupt status. This parameter decides which
|
|
* interrupts will be disabled.
|
|
* - \ref ADC_ADF_INT :ADC convert complete interrupt.
|
|
* - \ref ADC_CMP0_INT :ADC comparator 0 interrupt.
|
|
* - \ref ADC_CMP1_INT :ADC comparator 1 interrupt.
|
|
* @return None
|
|
* @details The function is used to disable convert complete interrupt, comparator 0 interrupt or comparator 1 interrupt.
|
|
*/
|
|
void ADC_DisableInt(ADC_T *adc, uint32_t u32Mask)
|
|
{
|
|
if((u32Mask) & ADC_ADF_INT)
|
|
(adc)->ADCR &= ~ADC_ADCR_ADIE_Msk;
|
|
if((u32Mask) & ADC_CMP0_INT)
|
|
(adc)->ADCMPR[0] &= ~ADC_ADCMPR_CMPIE_Msk;
|
|
if((u32Mask) & ADC_CMP1_INT)
|
|
(adc)->ADCMPR[1] &= ~ADC_ADCMPR_CMPIE_Msk;
|
|
|
|
return;
|
|
}
|
|
|
|
|
|
|
|
/*@}*/ /* end of group ADC_EXPORTED_FUNCTIONS */
|
|
|
|
/*@}*/ /* end of group ADC_Driver */
|
|
|
|
/*@}*/ /* end of group Device_Driver */
|
|
|
|
/*** (C) COPYRIGHT 2014 Nuvoton Technology Corp. ***/
|