1 /** 2 ****************************************************************************** 3 * @file stm32l4xx_hal_dac_ex.h 4 * @author MCD Application Team 5 * @brief Header file of DAC HAL Extended module. 6 ****************************************************************************** 7 * @attention 8 * 9 * <h2><center>© Copyright (c) 2017 STMicroelectronics. 10 * All rights reserved.</center></h2> 11 * 12 * This software component is licensed by ST under BSD 3-Clause license, 13 * the "License"; You may not use this file except in compliance with the 14 * License. You may obtain a copy of the License at: 15 * opensource.org/licenses/BSD-3-Clause 16 * 17 ****************************************************************************** 18 */ 19 20 /* Define to prevent recursive inclusion -------------------------------------*/ 21 #ifndef STM32L4xx_HAL_DAC_EX_H 22 #define STM32L4xx_HAL_DAC_EX_H 23 24 #ifdef __cplusplus 25 extern "C" { 26 #endif 27 28 /** @addtogroup STM32L4xx_HAL_Driver 29 * @{ 30 */ 31 32 /* Includes ------------------------------------------------------------------*/ 33 #include "stm32l4xx_hal_def.h" 34 35 #if defined(DAC1) 36 37 /** @addtogroup DACEx 38 * @{ 39 */ 40 41 /* Exported types ------------------------------------------------------------*/ 42 43 /** 44 * @brief HAL State structures definition 45 */ 46 47 /* Exported constants --------------------------------------------------------*/ 48 49 /** @defgroup DACEx_Exported_Constants DACEx Exported Constants 50 * @{ 51 */ 52 53 /** @defgroup DACEx_lfsrunmask_triangleamplitude DACEx lfsrunmask triangle amplitude 54 * @{ 55 */ 56 #define DAC_LFSRUNMASK_BIT0 0x00000000U /*!< Unmask DAC channel LFSR bit0 for noise wave generation */ 57 #define DAC_LFSRUNMASK_BITS1_0 ( DAC_CR_MAMP1_0) /*!< Unmask DAC channel LFSR bit[1:0] for noise wave generation */ 58 #define DAC_LFSRUNMASK_BITS2_0 ( DAC_CR_MAMP1_1 ) /*!< Unmask DAC channel LFSR bit[2:0] for noise wave generation */ 59 #define DAC_LFSRUNMASK_BITS3_0 ( DAC_CR_MAMP1_1 | DAC_CR_MAMP1_0) /*!< Unmask DAC channel LFSR bit[3:0] for noise wave generation */ 60 #define DAC_LFSRUNMASK_BITS4_0 ( DAC_CR_MAMP1_2 ) /*!< Unmask DAC channel LFSR bit[4:0] for noise wave generation */ 61 #define DAC_LFSRUNMASK_BITS5_0 ( DAC_CR_MAMP1_2 | DAC_CR_MAMP1_0) /*!< Unmask DAC channel LFSR bit[5:0] for noise wave generation */ 62 #define DAC_LFSRUNMASK_BITS6_0 ( DAC_CR_MAMP1_2 | DAC_CR_MAMP1_1 ) /*!< Unmask DAC channel LFSR bit[6:0] for noise wave generation */ 63 #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 */ 64 #define DAC_LFSRUNMASK_BITS8_0 (DAC_CR_MAMP1_3 ) /*!< Unmask DAC channel LFSR bit[8:0] for noise wave generation */ 65 #define DAC_LFSRUNMASK_BITS9_0 (DAC_CR_MAMP1_3 | DAC_CR_MAMP1_0) /*!< Unmask DAC channel LFSR bit[9:0] for noise wave generation */ 66 #define DAC_LFSRUNMASK_BITS10_0 (DAC_CR_MAMP1_3 | DAC_CR_MAMP1_1 ) /*!< Unmask DAC channel LFSR bit[10:0] for noise wave generation */ 67 #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 */ 68 #define DAC_TRIANGLEAMPLITUDE_1 0x00000000U /*!< Select max triangle amplitude of 1 */ 69 #define DAC_TRIANGLEAMPLITUDE_3 ( DAC_CR_MAMP1_0) /*!< Select max triangle amplitude of 3 */ 70 #define DAC_TRIANGLEAMPLITUDE_7 ( DAC_CR_MAMP1_1 ) /*!< Select max triangle amplitude of 7 */ 71 #define DAC_TRIANGLEAMPLITUDE_15 ( DAC_CR_MAMP1_1 | DAC_CR_MAMP1_0) /*!< Select max triangle amplitude of 15 */ 72 #define DAC_TRIANGLEAMPLITUDE_31 ( DAC_CR_MAMP1_2 ) /*!< Select max triangle amplitude of 31 */ 73 #define DAC_TRIANGLEAMPLITUDE_63 ( DAC_CR_MAMP1_2 | DAC_CR_MAMP1_0) /*!< Select max triangle amplitude of 63 */ 74 #define DAC_TRIANGLEAMPLITUDE_127 ( DAC_CR_MAMP1_2 | DAC_CR_MAMP1_1 ) /*!< Select max triangle amplitude of 127 */ 75 #define DAC_TRIANGLEAMPLITUDE_255 ( DAC_CR_MAMP1_2 | DAC_CR_MAMP1_1 | DAC_CR_MAMP1_0) /*!< Select max triangle amplitude of 255 */ 76 #define DAC_TRIANGLEAMPLITUDE_511 (DAC_CR_MAMP1_3 ) /*!< Select max triangle amplitude of 511 */ 77 #define DAC_TRIANGLEAMPLITUDE_1023 (DAC_CR_MAMP1_3 | DAC_CR_MAMP1_0) /*!< Select max triangle amplitude of 1023 */ 78 #define DAC_TRIANGLEAMPLITUDE_2047 (DAC_CR_MAMP1_3 | DAC_CR_MAMP1_1 ) /*!< Select max triangle amplitude of 2047 */ 79 #define DAC_TRIANGLEAMPLITUDE_4095 (DAC_CR_MAMP1_3 | DAC_CR_MAMP1_1 | DAC_CR_MAMP1_0) /*!< Select max triangle amplitude of 4095 */ 80 81 /** 82 * @} 83 */ 84 85 /** 86 * @} 87 */ 88 89 /* Exported macro ------------------------------------------------------------*/ 90 91 92 /* Private macro -------------------------------------------------------------*/ 93 94 /** @defgroup DACEx_Private_Macros DACEx Private Macros 95 * @{ 96 */ 97 #if defined (STM32L431xx) || defined (STM32L432xx) || defined (STM32L433xx) || defined (STM32L442xx) || defined (STM32L443xx) 98 #define IS_DAC_TRIGGER(TRIGGER) (((TRIGGER) == DAC_TRIGGER_NONE) || \ 99 ((TRIGGER) == DAC_TRIGGER_T2_TRGO) || \ 100 ((TRIGGER) == DAC_TRIGGER_T6_TRGO) || \ 101 ((TRIGGER) == DAC_TRIGGER_T7_TRGO) || \ 102 ((TRIGGER) == DAC_TRIGGER_EXT_IT9) || \ 103 ((TRIGGER) == DAC_TRIGGER_SOFTWARE)) 104 #endif /* STM32L431xx STM32L432xx STM32L433xx STM32L442xx STM32L443xx */ 105 106 #if defined (STM32L451xx) || defined (STM32L452xx) || defined (STM32L462xx) 107 #define IS_DAC_TRIGGER(TRIGGER) (((TRIGGER) == DAC_TRIGGER_NONE) || \ 108 ((TRIGGER) == DAC_TRIGGER_T2_TRGO) || \ 109 ((TRIGGER) == DAC_TRIGGER_T6_TRGO) || \ 110 ((TRIGGER) == DAC_TRIGGER_EXT_IT9) || \ 111 ((TRIGGER) == DAC_TRIGGER_SOFTWARE)) 112 #endif /* STM32L451xx STM32L452xx STM32L462xx */ 113 114 #if defined (STM32L471xx) || defined (STM32L475xx) || defined (STM32L476xx) || defined (STM32L485xx) || defined (STM32L486xx) || defined (STM32L496xx) || defined (STM32L4A6xx) 115 #define IS_DAC_TRIGGER(TRIGGER) (((TRIGGER) == DAC_TRIGGER_NONE) || \ 116 ((TRIGGER) == DAC_TRIGGER_T2_TRGO) || \ 117 ((TRIGGER) == DAC_TRIGGER_T4_TRGO) || \ 118 ((TRIGGER) == DAC_TRIGGER_T5_TRGO) || \ 119 ((TRIGGER) == DAC_TRIGGER_T6_TRGO) || \ 120 ((TRIGGER) == DAC_TRIGGER_T7_TRGO) || \ 121 ((TRIGGER) == DAC_TRIGGER_T8_TRGO) || \ 122 ((TRIGGER) == DAC_TRIGGER_EXT_IT9) || \ 123 ((TRIGGER) == DAC_TRIGGER_SOFTWARE)) 124 #endif /* STM32L471xx STM32L475xx STM32L476xx STM32L485xx STM32L486xx STM32L496xx STM32L4A6xx */ 125 126 #if defined (STM32L4P5xx) || defined (STM32L4Q5xx) || defined (STM32L4R5xx) || defined (STM32L4R7xx) || defined (STM32L4R9xx) || defined (STM32L4S5xx) || defined (STM32L4S7xx) || defined(STM32L4S9xx) 127 #define IS_DAC_TRIGGER(TRIGGER) (((TRIGGER) == DAC_TRIGGER_NONE) || \ 128 ((TRIGGER) == DAC_TRIGGER_T1_TRGO) || \ 129 ((TRIGGER) == DAC_TRIGGER_T2_TRGO) || \ 130 ((TRIGGER) == DAC_TRIGGER_T4_TRGO) || \ 131 ((TRIGGER) == DAC_TRIGGER_T5_TRGO) || \ 132 ((TRIGGER) == DAC_TRIGGER_T6_TRGO) || \ 133 ((TRIGGER) == DAC_TRIGGER_T7_TRGO) || \ 134 ((TRIGGER) == DAC_TRIGGER_T8_TRGO) || \ 135 ((TRIGGER) == DAC_TRIGGER_T15_TRGO) || \ 136 ((TRIGGER) == DAC_TRIGGER_LPTIM1_OUT) || \ 137 ((TRIGGER) == DAC_TRIGGER_LPTIM2_OUT) || \ 138 ((TRIGGER) == DAC_TRIGGER_EXT_IT9) || \ 139 ((TRIGGER) == DAC_TRIGGER_SOFTWARE)) 140 141 #define IS_DAC_HIGH_FREQUENCY_MODE(MODE) (((MODE) == DAC_HIGH_FREQUENCY_INTERFACE_MODE_DISABLE) || \ 142 ((MODE) == DAC_HIGH_FREQUENCY_INTERFACE_MODE_ABOVE_80MHZ) || \ 143 ((MODE) == DAC_HIGH_FREQUENCY_INTERFACE_MODE_AUTOMATIC)) 144 145 #endif /* STM32L4P5xx STM32L4Q5xx STM32L4R5xx STM32L4R7xx STM32L4R9xx STM32L4S5xx STM32L4S7xx STM32L4S9xx */ 146 147 #define IS_DAC_SAMPLETIME(TIME) ((TIME) <= 0x000003FFU) 148 149 #define IS_DAC_HOLDTIME(TIME) ((TIME) <= 0x000003FFU) 150 151 #define IS_DAC_SAMPLEANDHOLD(MODE) (((MODE) == DAC_SAMPLEANDHOLD_DISABLE) || \ 152 ((MODE) == DAC_SAMPLEANDHOLD_ENABLE)) 153 154 #define IS_DAC_TRIMMINGVALUE(TRIMMINGVALUE) ((TRIMMINGVALUE) <= 0x1FU) 155 156 #define IS_DAC_NEWTRIMMINGVALUE(TRIMMINGVALUE) ((TRIMMINGVALUE) <= 0x1FU) 157 158 #define IS_DAC_CHIP_CONNECTION(CONNECT) (((CONNECT) == DAC_CHIPCONNECT_DISABLE) || \ 159 ((CONNECT) == DAC_CHIPCONNECT_ENABLE)) 160 161 #define IS_DAC_TRIMMING(TRIMMING) (((TRIMMING) == DAC_TRIMMING_FACTORY) || \ 162 ((TRIMMING) == DAC_TRIMMING_USER)) 163 164 #define IS_DAC_LFSR_UNMASK_TRIANGLE_AMPLITUDE(VALUE) (((VALUE) == DAC_LFSRUNMASK_BIT0) || \ 165 ((VALUE) == DAC_LFSRUNMASK_BITS1_0) || \ 166 ((VALUE) == DAC_LFSRUNMASK_BITS2_0) || \ 167 ((VALUE) == DAC_LFSRUNMASK_BITS3_0) || \ 168 ((VALUE) == DAC_LFSRUNMASK_BITS4_0) || \ 169 ((VALUE) == DAC_LFSRUNMASK_BITS5_0) || \ 170 ((VALUE) == DAC_LFSRUNMASK_BITS6_0) || \ 171 ((VALUE) == DAC_LFSRUNMASK_BITS7_0) || \ 172 ((VALUE) == DAC_LFSRUNMASK_BITS8_0) || \ 173 ((VALUE) == DAC_LFSRUNMASK_BITS9_0) || \ 174 ((VALUE) == DAC_LFSRUNMASK_BITS10_0) || \ 175 ((VALUE) == DAC_LFSRUNMASK_BITS11_0) || \ 176 ((VALUE) == DAC_TRIANGLEAMPLITUDE_1) || \ 177 ((VALUE) == DAC_TRIANGLEAMPLITUDE_3) || \ 178 ((VALUE) == DAC_TRIANGLEAMPLITUDE_7) || \ 179 ((VALUE) == DAC_TRIANGLEAMPLITUDE_15) || \ 180 ((VALUE) == DAC_TRIANGLEAMPLITUDE_31) || \ 181 ((VALUE) == DAC_TRIANGLEAMPLITUDE_63) || \ 182 ((VALUE) == DAC_TRIANGLEAMPLITUDE_127) || \ 183 ((VALUE) == DAC_TRIANGLEAMPLITUDE_255) || \ 184 ((VALUE) == DAC_TRIANGLEAMPLITUDE_511) || \ 185 ((VALUE) == DAC_TRIANGLEAMPLITUDE_1023) || \ 186 ((VALUE) == DAC_TRIANGLEAMPLITUDE_2047) || \ 187 ((VALUE) == DAC_TRIANGLEAMPLITUDE_4095)) 188 /** 189 * @} 190 */ 191 192 /* Exported functions --------------------------------------------------------*/ 193 /* Extended features functions ***********************************************/ 194 195 /** @addtogroup DACEx_Exported_Functions 196 * @{ 197 */ 198 199 /** @addtogroup DACEx_Exported_Functions_Group2 200 * @{ 201 */ 202 /* IO operation functions *****************************************************/ 203 204 HAL_StatusTypeDef HAL_DACEx_TriangleWaveGenerate(DAC_HandleTypeDef* hdac, uint32_t Channel, uint32_t Amplitude); 205 HAL_StatusTypeDef HAL_DACEx_NoiseWaveGenerate(DAC_HandleTypeDef* hdac, uint32_t Channel, uint32_t Amplitude); 206 207 #if defined (STM32L431xx) || defined (STM32L432xx) || defined (STM32L433xx) || defined (STM32L442xx) || defined (STM32L443xx) || \ 208 defined (STM32L471xx) || defined (STM32L475xx) || defined (STM32L476xx) || defined (STM32L485xx) || defined (STM32L486xx) || defined (STM32L496xx) || defined (STM32L4A6xx) || \ 209 defined (STM32L4P5xx) || defined (STM32L4Q5xx) || \ 210 defined (STM32L4R5xx) || defined (STM32L4R7xx) || defined (STM32L4R9xx) || defined (STM32L4S5xx) || defined (STM32L4S7xx) || defined(STM32L4S9xx) 211 HAL_StatusTypeDef HAL_DACEx_DualSetValue(DAC_HandleTypeDef* hdac, uint32_t Alignment, uint32_t Data1, uint32_t Data2); 212 uint32_t HAL_DACEx_DualGetValue(DAC_HandleTypeDef* hdac); 213 #endif /* STM32L431xx STM32L432xx STM32L433xx STM32L442xx STM32L443xx */ 214 /* STM32L471xx STM32L475xx STM32L476xx STM32L485xx STM32L486xx STM32L496xx STM32L4A6xx */ 215 /* STM32L4P5xx STM32L4Q5xx */ 216 /* STM32L4R5xx STM32L4R7xx STM32L4R9xx STM32L4S5xx STM32L4S7xx STM32L4S9xx */ 217 #if defined (STM32L431xx) || defined (STM32L432xx) || defined (STM32L433xx) || defined (STM32L442xx) || defined (STM32L443xx) || \ 218 defined (STM32L471xx) || defined (STM32L475xx) || defined (STM32L476xx) || defined (STM32L485xx) || defined (STM32L486xx) || defined (STM32L496xx) || defined (STM32L4A6xx) || \ 219 defined (STM32L4P5xx) || defined (STM32L4Q5xx) || \ 220 defined (STM32L4R5xx) || defined (STM32L4R7xx) || defined (STM32L4R9xx) || defined (STM32L4S5xx) || defined (STM32L4S7xx) || defined(STM32L4S9xx) 221 void HAL_DACEx_ConvCpltCallbackCh2(DAC_HandleTypeDef* hdac); 222 void HAL_DACEx_ConvHalfCpltCallbackCh2(DAC_HandleTypeDef* hdac); 223 void HAL_DACEx_ErrorCallbackCh2(DAC_HandleTypeDef* hdac); 224 void HAL_DACEx_DMAUnderrunCallbackCh2(DAC_HandleTypeDef* hdac); 225 #endif /* STM32L431xx STM32L432xx STM32L433xx STM32L442xx STM32L443xx */ 226 /* STM32L471xx STM32L475xx STM32L476xx STM32L485xx STM32L486xx STM32L496xx STM32L4A6xx */ 227 /* STM32L4P5xx STM32L4Q5xx */ 228 /* STM32L4R5xx STM32L4R7xx STM32L4R9xx STM32L4S5xx STM32L4S7xx STM32L4S9xx */ 229 230 231 /** 232 * @} 233 */ 234 235 /** @addtogroup DACEx_Exported_Functions_Group3 236 * @{ 237 */ 238 /* Peripheral Control functions ***********************************************/ 239 240 HAL_StatusTypeDef HAL_DACEx_SelfCalibrate(DAC_HandleTypeDef *hdac, DAC_ChannelConfTypeDef *sConfig, uint32_t Channel); 241 HAL_StatusTypeDef HAL_DACEx_SetUserTrimming(DAC_HandleTypeDef *hdac, DAC_ChannelConfTypeDef *sConfig, uint32_t Channel, uint32_t NewTrimmingValue); 242 uint32_t HAL_DACEx_GetTrimOffset (DAC_HandleTypeDef *hdac, uint32_t Channel); 243 244 /** 245 * @} 246 */ 247 248 /** 249 * @} 250 */ 251 252 #if defined (STM32L431xx) || defined (STM32L432xx) || defined (STM32L433xx) || defined (STM32L442xx) || defined (STM32L443xx) || \ 253 defined (STM32L471xx) || defined (STM32L475xx) || defined (STM32L476xx) || defined (STM32L485xx) || defined (STM32L486xx) || defined (STM32L496xx) || defined (STM32L4A6xx) || \ 254 defined (STM32L4P5xx) || defined (STM32L4Q5xx) || \ 255 defined (STM32L4R5xx) || defined (STM32L4R7xx) || defined (STM32L4R9xx) || defined (STM32L4S5xx) || defined (STM32L4S7xx) || defined(STM32L4S9xx) 256 257 /** @addtogroup DACEx_Private_Functions 258 * @{ 259 */ 260 261 /* DAC_DMAConvCpltCh2 / DAC_DMAErrorCh2 / DAC_DMAHalfConvCpltCh2 */ 262 /* are called by HAL_DAC_Start_DMA */ 263 void DAC_DMAConvCpltCh2(DMA_HandleTypeDef *hdma); 264 void DAC_DMAErrorCh2(DMA_HandleTypeDef *hdma); 265 void DAC_DMAHalfConvCpltCh2(DMA_HandleTypeDef *hdma); 266 267 /** 268 * @} 269 */ 270 #endif /* STM32L431xx STM32L432xx STM32L433xx STM32L442xx STM32L443xx */ 271 /* STM32L471xx STM32L475xx STM32L476xx STM32L485xx STM32L486xx STM32L496xx STM32L4A6xx */ 272 /* STM32L4P5xx STM32L4Q5xx */ 273 /* STM32L4R5xx STM32L4R7xx STM32L4R9xx STM32L4S5xx STM32L4S7xx STM32L4S9xx */ 274 /** 275 * @} 276 */ 277 278 #endif /* DAC1 */ 279 280 /** 281 * @} 282 */ 283 284 #ifdef __cplusplus 285 } 286 #endif 287 288 #endif /*STM32L4xx_HAL_DAC_EX_H */ 289 290 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ 291