git.sur5r.net Git - freertos/blob - FreeRTOS/Demo/CORTEX_MPU_M23_Nuvoton_NuMaker_PFM_M2351_IAR_GCC/Nuvoton_Code/StdDriver/src/dac.c

   1 /**************************************************************************//**\r
   2  * @file     dac.c\r
   3  * @version  V1.00\r
   4  * @brief    M2351 series DAC driver source file\r
   5  *\r
   6  * @note\r
   7  * Copyright (C) 2017 Nuvoton Technology Corp. All rights reserved.\r
   8 *****************************************************************************/\r
   9 #include "NuMicro.h"\r
  10 \r
  11 /** @addtogroup Standard_Driver Standard Driver\r
  12   @{\r
  13 */\r
  14 \r
  15 /** @addtogroup DAC_Driver DAC Driver\r
  16   @{\r
  17 */\r
  18 \r
  19 /** @addtogroup DAC_EXPORTED_FUNCTIONS DAC Exported Functions\r
  20   @{\r
  21 */\r
  22 \r
  23 /**\r
  24   * @brief This function make DAC module be ready to convert.\r
  25   * @param[in] dac The pointer of the specified DAC module.\r
  26   * @param[in] u32Ch Not used in M2351 Series DAC.\r
  27   * @param[in] u32TrgSrc Decides the trigger source. Valid values are:\r
  28   *                      - \ref DAC_WRITE_DAT_TRIGGER             :Write DAC_DAT trigger\r
  29   *                      - \ref DAC_SOFTWARE_TRIGGER              :Software trigger\r
  30   *                      - \ref DAC_LOW_LEVEL_TRIGGER             :STDAC pin low level trigger\r
  31   *                      - \ref DAC_HIGH_LEVEL_TRIGGER            :STDAC pin high level trigger\r
  32   *                      - \ref DAC_FALLING_EDGE_TRIGGER          :STDAC pin falling edge trigger\r
  33   *                      - \ref DAC_RISING_EDGE_TRIGGER           :STDAC pin rising edge trigger\r
  34   *                      - \ref DAC_TIMER0_TRIGGER                :Timer 0 trigger\r
  35   *                      - \ref DAC_TIMER1_TRIGGER                :Timer 1 trigger\r
  36   *                      - \ref DAC_TIMER2_TRIGGER                :Timer 2 trigger\r
  37   *                      - \ref DAC_TIMER3_TRIGGER                :Timer 3 trigger\r
  38   *                      - \ref DAC_EPWM0_TRIGGER                 :EPWM0 trigger\r
  39   *                      - \ref DAC_EPWM1_TRIGGER                 :EPWM1 trigger\r
  40   * @return None\r
  41   * @details The DAC conversion can be started by writing DAC_DAT, software trigger or hardware trigger.\r
  42   *         When TRGEN (DAC_CTL[4]) is 0, the data conversion is started by writing DAC_DAT register.\r
  43   *         When TRGEN (DAC_CTL[4]) is 1, the data conversion is started by SWTRG (DAC_SWTRG[0]) is set to 1,\r
  44   *         external STDAC pin, timer event, or EPWM event.\r
  45   */\r
  46 void DAC_Open(DAC_T *dac,\r
  47               uint32_t u32Ch,\r
  48               uint32_t u32TrgSrc)\r
  49 {\r
  50     dac->CTL &= ~(DAC_CTL_ETRGSEL_Msk | DAC_CTL_TRGSEL_Msk | DAC_CTL_TRGEN_Msk);\r
  51 \r
  52     dac->CTL |= (u32TrgSrc | DAC_CTL_DACEN_Msk);\r
  53 }\r
  54 \r
  55 /**\r
  56   * @brief Disable DAC analog power.\r
  57   * @param[in] dac The pointer of the specified DAC module.\r
  58   * @param[in] u32Ch Not used in M2351 Series DAC.\r
  59   * @return None\r
  60   * @details Disable DAC analog power for saving power consumption.\r
  61   */\r
  62 void DAC_Close(DAC_T *dac, uint32_t u32Ch)\r
  63 {\r
  64     dac->CTL &= (~DAC_CTL_DACEN_Msk);\r
  65 }\r
  66 \r
  67 /**\r
  68   * @brief Set delay time for DAC to become stable.\r
  69   * @param[in] dac The pointer of the specified DAC module.\r
  70   * @param[in] u32Delay Decides the DAC conversion settling time, the range is from 0~(1023/PCLK1*1000000) micro seconds.\r
  71   * @return Real DAC conversion settling time (micro second).\r
  72   * @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.\r
  73   * @note User needs to write appropriate value to meet DAC conversion settling time base on PCLK (APB clock) speed.\r
  74   */\r
  75 uint32_t DAC_SetDelayTime(DAC_T *dac, uint32_t u32Delay)\r
  76 {\r
  77 \r
  78     dac->TCTL = ((CLK_GetPCLK1Freq() * u32Delay / 1000000UL) & 0x3FFUL);\r
  79 \r
  80     return ((dac->TCTL) * 1000000UL / CLK_GetPCLK1Freq());\r
  81 }\r
  82 \r
  83 \r
  84 \r
  85 /*@}*/ /* end of group DAC_EXPORTED_FUNCTIONS */\r
  86 \r
  87 /*@}*/ /* end of group DAC_Driver */\r
  88 \r
  89 /*@}*/ /* end of group Standard_Driver */\r
  90 \r
  91 /*** (C) COPYRIGHT 2017 Nuvoton Technology Corp. ***/\r