STM32F479xx HAL User Manual
stm32f4xx_hal_dac_ex.h
Go to the documentation of this file.
00001 /**
00002   ******************************************************************************
00003   * @file    stm32f4xx_hal_dac_ex.h
00004   * @author  MCD Application Team
00005   * @brief   Header file of DAC HAL Extended module.
00006   ******************************************************************************
00007   * @attention
00008   *
00009   * <h2><center>&copy; Copyright (c) 2016 STMicroelectronics.
00010   * All rights reserved.</center></h2>
00011   *
00012   * This software component is licensed by ST under BSD 3-Clause license,
00013   * the "License"; You may not use this file except in compliance with the
00014   * License. You may obtain a copy of the License at:
00015   *                        opensource.org/licenses/BSD-3-Clause
00016   *
00017   ******************************************************************************
00018   */
00019 
00020 /* Define to prevent recursive inclusion -------------------------------------*/
00021 #ifndef STM32F4xx_HAL_DAC_EX_H
00022 #define STM32F4xx_HAL_DAC_EX_H
00023 
00024 #ifdef __cplusplus
00025 extern "C" {
00026 #endif
00027 
00028 /** @addtogroup STM32F4xx_HAL_Driver
00029   * @{
00030   */
00031 
00032 /* Includes ------------------------------------------------------------------*/
00033 #include "stm32f4xx_hal_def.h"
00034 
00035 #if defined(DAC)
00036 
00037 /** @addtogroup DACEx
00038   * @{
00039   */
00040 
00041 /* Exported types ------------------------------------------------------------*/
00042 
00043 /**
00044   * @brief  HAL State structures definition
00045   */
00046 
00047 /* Exported constants --------------------------------------------------------*/
00048 
00049 /** @defgroup DACEx_Exported_Constants DACEx Exported Constants
00050   * @{
00051   */
00052 
00053 /** @defgroup DACEx_lfsrunmask_triangleamplitude DACEx lfsrunmask triangle amplitude
00054   * @{
00055   */
00056 #define DAC_LFSRUNMASK_BIT0                0x00000000UL                                                        /*!< Unmask DAC channel LFSR bit0 for noise wave generation */
00057 #define DAC_LFSRUNMASK_BITS1_0             (                                                   DAC_CR_MAMP1_0) /*!< Unmask DAC channel LFSR bit[1:0] for noise wave generation */
00058 #define DAC_LFSRUNMASK_BITS2_0             (                                  DAC_CR_MAMP1_1                 ) /*!< Unmask DAC channel LFSR bit[2:0] for noise wave generation */
00059 #define DAC_LFSRUNMASK_BITS3_0             (                                  DAC_CR_MAMP1_1 | DAC_CR_MAMP1_0) /*!< Unmask DAC channel LFSR bit[3:0] for noise wave generation */
00060 #define DAC_LFSRUNMASK_BITS4_0             (                 DAC_CR_MAMP1_2                                  ) /*!< Unmask DAC channel LFSR bit[4:0] for noise wave generation */
00061 #define DAC_LFSRUNMASK_BITS5_0             (                 DAC_CR_MAMP1_2                  | DAC_CR_MAMP1_0) /*!< Unmask DAC channel LFSR bit[5:0] for noise wave generation */
00062 #define DAC_LFSRUNMASK_BITS6_0             (                 DAC_CR_MAMP1_2 | DAC_CR_MAMP1_1                 ) /*!< Unmask DAC channel LFSR bit[6:0] for noise wave generation */
00063 #define DAC_LFSRUNMASK_BITS7_0             (                 DAC_CR_MAMP1_2 | DAC_CR_MAMP1_1 | DAC_CR_MAMP1_0) /*!< Unmask DAC channel LFSR bit[7:0] for noise wave generation */
00064 #define DAC_LFSRUNMASK_BITS8_0             (DAC_CR_MAMP1_3                                                   ) /*!< Unmask DAC channel LFSR bit[8:0] for noise wave generation */
00065 #define DAC_LFSRUNMASK_BITS9_0             (DAC_CR_MAMP1_3                                   | DAC_CR_MAMP1_0) /*!< Unmask DAC channel LFSR bit[9:0] for noise wave generation */
00066 #define DAC_LFSRUNMASK_BITS10_0            (DAC_CR_MAMP1_3                  | DAC_CR_MAMP1_1                 ) /*!< Unmask DAC channel LFSR bit[10:0] for noise wave generation */
00067 #define DAC_LFSRUNMASK_BITS11_0            (DAC_CR_MAMP1_3                  | DAC_CR_MAMP1_1 | DAC_CR_MAMP1_0) /*!< Unmask DAC channel LFSR bit[11:0] for noise wave generation */
00068 #define DAC_TRIANGLEAMPLITUDE_1            0x00000000UL                                                        /*!< Select max triangle amplitude of 1 */
00069 #define DAC_TRIANGLEAMPLITUDE_3            (                                                   DAC_CR_MAMP1_0) /*!< Select max triangle amplitude of 3 */
00070 #define DAC_TRIANGLEAMPLITUDE_7            (                                  DAC_CR_MAMP1_1                 ) /*!< Select max triangle amplitude of 7 */
00071 #define DAC_TRIANGLEAMPLITUDE_15           (                                  DAC_CR_MAMP1_1 | DAC_CR_MAMP1_0) /*!< Select max triangle amplitude of 15 */
00072 #define DAC_TRIANGLEAMPLITUDE_31           (                 DAC_CR_MAMP1_2                                  ) /*!< Select max triangle amplitude of 31 */
00073 #define DAC_TRIANGLEAMPLITUDE_63           (                 DAC_CR_MAMP1_2                  | DAC_CR_MAMP1_0) /*!< Select max triangle amplitude of 63 */
00074 #define DAC_TRIANGLEAMPLITUDE_127          (                 DAC_CR_MAMP1_2 | DAC_CR_MAMP1_1                 ) /*!< Select max triangle amplitude of 127 */
00075 #define DAC_TRIANGLEAMPLITUDE_255          (                 DAC_CR_MAMP1_2 | DAC_CR_MAMP1_1 | DAC_CR_MAMP1_0) /*!< Select max triangle amplitude of 255 */
00076 #define DAC_TRIANGLEAMPLITUDE_511          (DAC_CR_MAMP1_3                                                   ) /*!< Select max triangle amplitude of 511 */
00077 #define DAC_TRIANGLEAMPLITUDE_1023         (DAC_CR_MAMP1_3                                   | DAC_CR_MAMP1_0) /*!< Select max triangle amplitude of 1023 */
00078 #define DAC_TRIANGLEAMPLITUDE_2047         (DAC_CR_MAMP1_3                  | DAC_CR_MAMP1_1                 ) /*!< Select max triangle amplitude of 2047 */
00079 #define DAC_TRIANGLEAMPLITUDE_4095         (DAC_CR_MAMP1_3                  | DAC_CR_MAMP1_1 | DAC_CR_MAMP1_0) /*!< Select max triangle amplitude of 4095 */
00080 
00081 /**
00082   * @}
00083   */
00084 
00085 /**
00086   * @}
00087   */
00088 
00089 /* Exported macro ------------------------------------------------------------*/
00090 
00091 
00092 /* Private macro -------------------------------------------------------------*/
00093 
00094 /** @defgroup DACEx_Private_Macros DACEx Private Macros
00095   * @{
00096   */
00097 #define IS_DAC_TRIGGER(TRIGGER) (((TRIGGER) == DAC_TRIGGER_NONE)    || \
00098                                  ((TRIGGER) == DAC_TRIGGER_T2_TRGO) || \
00099                                  ((TRIGGER) == DAC_TRIGGER_T8_TRGO) || \
00100                                  ((TRIGGER) == DAC_TRIGGER_T7_TRGO) || \
00101                                  ((TRIGGER) == DAC_TRIGGER_T5_TRGO) || \
00102                                  ((TRIGGER) == DAC_TRIGGER_T6_TRGO) || \
00103                                  ((TRIGGER) == DAC_TRIGGER_T4_TRGO) || \
00104                                  ((TRIGGER) == DAC_TRIGGER_EXT_IT9) || \
00105                                  ((TRIGGER) == DAC_TRIGGER_SOFTWARE))
00106 
00107 #define IS_DAC_LFSR_UNMASK_TRIANGLE_AMPLITUDE(VALUE) (((VALUE) == DAC_LFSRUNMASK_BIT0) || \
00108                                                       ((VALUE) == DAC_LFSRUNMASK_BITS1_0) || \
00109                                                       ((VALUE) == DAC_LFSRUNMASK_BITS2_0) || \
00110                                                       ((VALUE) == DAC_LFSRUNMASK_BITS3_0) || \
00111                                                       ((VALUE) == DAC_LFSRUNMASK_BITS4_0) || \
00112                                                       ((VALUE) == DAC_LFSRUNMASK_BITS5_0) || \
00113                                                       ((VALUE) == DAC_LFSRUNMASK_BITS6_0) || \
00114                                                       ((VALUE) == DAC_LFSRUNMASK_BITS7_0) || \
00115                                                       ((VALUE) == DAC_LFSRUNMASK_BITS8_0) || \
00116                                                       ((VALUE) == DAC_LFSRUNMASK_BITS9_0) || \
00117                                                       ((VALUE) == DAC_LFSRUNMASK_BITS10_0) || \
00118                                                       ((VALUE) == DAC_LFSRUNMASK_BITS11_0) || \
00119                                                       ((VALUE) == DAC_TRIANGLEAMPLITUDE_1) || \
00120                                                       ((VALUE) == DAC_TRIANGLEAMPLITUDE_3) || \
00121                                                       ((VALUE) == DAC_TRIANGLEAMPLITUDE_7) || \
00122                                                       ((VALUE) == DAC_TRIANGLEAMPLITUDE_15) || \
00123                                                       ((VALUE) == DAC_TRIANGLEAMPLITUDE_31) || \
00124                                                       ((VALUE) == DAC_TRIANGLEAMPLITUDE_63) || \
00125                                                       ((VALUE) == DAC_TRIANGLEAMPLITUDE_127) || \
00126                                                       ((VALUE) == DAC_TRIANGLEAMPLITUDE_255) || \
00127                                                       ((VALUE) == DAC_TRIANGLEAMPLITUDE_511) || \
00128                                                       ((VALUE) == DAC_TRIANGLEAMPLITUDE_1023) || \
00129                                                       ((VALUE) == DAC_TRIANGLEAMPLITUDE_2047) || \
00130                                                       ((VALUE) == DAC_TRIANGLEAMPLITUDE_4095))
00131 /**
00132   * @}
00133   */
00134 
00135 /* Exported functions --------------------------------------------------------*/
00136 /* Extended features functions ***********************************************/
00137 
00138 /** @addtogroup DACEx_Exported_Functions
00139   * @{
00140   */
00141 
00142 /** @addtogroup DACEx_Exported_Functions_Group2
00143   * @{
00144   */
00145 /* IO operation functions *****************************************************/
00146 
00147 HAL_StatusTypeDef HAL_DACEx_TriangleWaveGenerate(DAC_HandleTypeDef *hdac, uint32_t Channel, uint32_t Amplitude);
00148 HAL_StatusTypeDef HAL_DACEx_NoiseWaveGenerate(DAC_HandleTypeDef *hdac, uint32_t Channel, uint32_t Amplitude);
00149 
00150 #if defined(DAC_CHANNEL2_SUPPORT)
00151 #endif
00152 HAL_StatusTypeDef HAL_DACEx_DualStart(DAC_HandleTypeDef *hdac);
00153 HAL_StatusTypeDef HAL_DACEx_DualStop(DAC_HandleTypeDef *hdac);
00154 HAL_StatusTypeDef HAL_DACEx_DualSetValue(DAC_HandleTypeDef *hdac, uint32_t Alignment, uint32_t Data1, uint32_t Data2);
00155 uint32_t HAL_DACEx_DualGetValue(DAC_HandleTypeDef *hdac);
00156 
00157 #if defined(DAC_CHANNEL2_SUPPORT)
00158 #endif
00159 void HAL_DACEx_ConvCpltCallbackCh2(DAC_HandleTypeDef *hdac);
00160 void HAL_DACEx_ConvHalfCpltCallbackCh2(DAC_HandleTypeDef *hdac);
00161 void HAL_DACEx_ErrorCallbackCh2(DAC_HandleTypeDef *hdac);
00162 void HAL_DACEx_DMAUnderrunCallbackCh2(DAC_HandleTypeDef *hdac);
00163 
00164 
00165 /**
00166   * @}
00167   */
00168 
00169 /**
00170   * @}
00171   */
00172 
00173 /**
00174   * @}
00175   */
00176 
00177 /** @addtogroup DACEx_Private_Functions
00178   * @{
00179   */
00180 #if defined(DAC_CHANNEL2_SUPPORT)
00181 /* DAC_DMAConvCpltCh2 / DAC_DMAErrorCh2 / DAC_DMAHalfConvCpltCh2 */
00182 /* are called by HAL_DAC_Start_DMA */
00183 void DAC_DMAConvCpltCh2(DMA_HandleTypeDef *hdma);
00184 void DAC_DMAErrorCh2(DMA_HandleTypeDef *hdma);
00185 void DAC_DMAHalfConvCpltCh2(DMA_HandleTypeDef *hdma);
00186 #endif /* DAC_CHANNEL2_SUPPORT */
00187 /**
00188   * @}
00189   */
00190 
00191 /**
00192   * @}
00193   */
00194 
00195 #endif /* DAC */
00196 
00197 /**
00198   * @}
00199   */
00200 
00201 #ifdef __cplusplus
00202 }
00203 #endif
00204 
00205 #endif /* STM32F4xx_HAL_DAC_EX_H */
00206 
00207 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/