114 lines
5.1 KiB
C
114 lines
5.1 KiB
C
/**************************************************************************//**
|
|
* @file dac.c
|
|
* @version V1.00
|
|
* @brief M261 series DAC driver source file
|
|
*
|
|
* @note
|
|
* @copyright (C) 2019 Nuvoton Technology Corp. All rights reserved.
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without modification,
|
|
* are permitted provided that the following conditions are met:
|
|
* 1. Redistributions of source code must retain the above copyright notice,
|
|
* this list of conditions and the following disclaimer.
|
|
* 2. Redistributions in binary form must reproduce the above copyright notice,
|
|
* this list of conditions and the following disclaimer in the documentation
|
|
* and/or other materials provided with the distribution.
|
|
* 3. Neither the name of Nuvoton Technology Corp. nor the names of its contributors
|
|
* may be used to endorse or promote products derived from this software
|
|
* without specific prior written permission.
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
|
|
* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
|
* DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
|
|
* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
|
|
* SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
|
|
* CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
|
|
* OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
|
|
* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
*****************************************************************************/
|
|
#include "NuMicro.h"
|
|
|
|
/** @addtogroup Standard_Driver Standard Driver
|
|
@{
|
|
*/
|
|
|
|
/** @addtogroup DAC_Driver DAC Driver
|
|
@{
|
|
*/
|
|
|
|
/** @addtogroup DAC_EXPORTED_FUNCTIONS DAC Exported Functions
|
|
@{
|
|
*/
|
|
|
|
/**
|
|
* @brief This function make DAC module be ready to convert.
|
|
* @param[in] dac The pointer of the specified DAC module.
|
|
* @param[in] u32Ch Not used in M261 Series DAC.
|
|
* @param[in] u32TrgSrc Decides the trigger source. Valid values are:
|
|
* - \ref DAC_WRITE_DAT_TRIGGER :Write DAC_DAT trigger
|
|
* - \ref DAC_SOFTWARE_TRIGGER :Software trigger
|
|
* - \ref DAC_LOW_LEVEL_TRIGGER :STDAC pin low level trigger
|
|
* - \ref DAC_HIGH_LEVEL_TRIGGER :STDAC pin high level trigger
|
|
* - \ref DAC_FALLING_EDGE_TRIGGER :STDAC pin falling edge trigger
|
|
* - \ref DAC_RISING_EDGE_TRIGGER :STDAC pin rising edge trigger
|
|
* - \ref DAC_TIMER0_TRIGGER :Timer 0 trigger
|
|
* - \ref DAC_TIMER1_TRIGGER :Timer 1 trigger
|
|
* - \ref DAC_TIMER2_TRIGGER :Timer 2 trigger
|
|
* - \ref DAC_TIMER3_TRIGGER :Timer 3 trigger
|
|
* - \ref DAC_EPWM0_TRIGGER :EPWM0 trigger
|
|
* - \ref DAC_EPWM1_TRIGGER :EPWM1 trigger
|
|
* @return None
|
|
* @details The DAC conversion can be started by writing DAC_DAT, software trigger or hardware trigger.
|
|
* When TRGEN (DAC_CTL[4]) is 0, the data conversion is started by writing DAC_DAT register.
|
|
* When TRGEN (DAC_CTL[4]) is 1, the data conversion is started by SWTRG (DAC_SWTRG[0]) is set to 1,
|
|
* external STDAC pin, timer event, or EPWM event.
|
|
*/
|
|
void DAC_Open(DAC_T *dac,
|
|
uint32_t u32Ch,
|
|
uint32_t u32TrgSrc)
|
|
{
|
|
dac->CTL &= ~(DAC_CTL_ETRGSEL_Msk | DAC_CTL_TRGSEL_Msk | DAC_CTL_TRGEN_Msk);
|
|
|
|
dac->CTL |= (u32TrgSrc | DAC_CTL_DACEN_Msk);
|
|
}
|
|
|
|
/**
|
|
* @brief Disable DAC analog power.
|
|
* @param[in] dac The pointer of the specified DAC module.
|
|
* @param[in] u32Ch Not used in M261 Series DAC.
|
|
* @return None
|
|
* @details Disable DAC analog power for saving power consumption.
|
|
*/
|
|
void DAC_Close(DAC_T *dac, uint32_t u32Ch)
|
|
{
|
|
dac->CTL &= (~DAC_CTL_DACEN_Msk);
|
|
}
|
|
|
|
/**
|
|
* @brief Set delay time for DAC to become stable.
|
|
* @param[in] dac The pointer of the specified DAC module.
|
|
* @param[in] u32Delay Decides the DAC conversion settling time, the range is from 0~(1023/PCLK1*1000000) micro seconds.
|
|
* @return Real DAC conversion settling time (micro second).
|
|
* @details For example, DAC controller clock speed is 64MHz and DAC conversion setting time is 1 us, SETTLET (DAC_TCTL[9:0]) value must be greater than 0x40.
|
|
* @note User needs to write appropriate value to meet DAC conversion settling time base on PCLK (APB clock) speed.
|
|
*/
|
|
uint32_t DAC_SetDelayTime(DAC_T *dac, uint32_t u32Delay)
|
|
{
|
|
|
|
dac->TCTL = ((CLK_GetPCLK1Freq() * u32Delay / 1000000UL) & 0x3FFUL);
|
|
|
|
return ((dac->TCTL) * 1000000UL / CLK_GetPCLK1Freq());
|
|
}
|
|
|
|
|
|
|
|
/*@}*/ /* end of group DAC_EXPORTED_FUNCTIONS */
|
|
|
|
/*@}*/ /* end of group DAC_Driver */
|
|
|
|
/*@}*/ /* end of group Standard_Driver */
|
|
|
|
/*** (C) COPYRIGHT 2019 Nuvoton Technology Corp. ***/
|