1 /** 2 ****************************************************************************** 3 * @file stm32g4xx_hal_dac_ex.h 4 * @author MCD Application Team 5 * @brief Header file of DAC HAL Extended module. 6 ****************************************************************************** 7 * @attention 8 * 9 * Copyright (c) 2019 STMicroelectronics. 10 * All rights reserved. 11 * 12 * This software is licensed under terms that can be found in the LICENSE file 13 * in the root directory of this software component. 14 * If no LICENSE file comes with this software, it is provided AS-IS. 15 * 16 ****************************************************************************** 17 */ 18 19 /* Define to prevent recursive inclusion -------------------------------------*/ 20 #ifndef STM32G4xx_HAL_DAC_EX_H 21 #define STM32G4xx_HAL_DAC_EX_H 22 23 #ifdef __cplusplus 24 extern "C" { 25 #endif 26 27 /** @addtogroup STM32G4xx_HAL_Driver 28 * @{ 29 */ 30 31 /* Includes ------------------------------------------------------------------*/ 32 #include "stm32g4xx_hal_def.h" 33 34 #if defined(DAC1) || defined(DAC2) || defined(DAC3) ||defined (DAC4) 35 36 /** @addtogroup DACEx 37 * @{ 38 */ 39 40 /* Exported types ------------------------------------------------------------*/ 41 42 /** 43 * @brief HAL State structures definition 44 */ 45 46 /* Exported constants --------------------------------------------------------*/ 47 48 /** @defgroup DACEx_Exported_Constants DACEx Exported Constants 49 * @{ 50 */ 51 52 /** @defgroup DACEx_lfsrunmask_triangleamplitude DACEx lfsrunmask triangle amplitude 53 * @{ 54 */ 55 #define DAC_LFSRUNMASK_BIT0 0x00000000UL /*!< Unmask DAC channel LFSR bit0 for noise wave generation */ 56 #define DAC_LFSRUNMASK_BITS1_0 ( DAC_CR_MAMP1_0) /*!< Unmask DAC channel LFSR bit[1:0] for noise wave generation */ 57 #define DAC_LFSRUNMASK_BITS2_0 ( DAC_CR_MAMP1_1 ) /*!< Unmask DAC channel LFSR bit[2:0] for noise wave generation */ 58 #define DAC_LFSRUNMASK_BITS3_0 ( DAC_CR_MAMP1_1 | DAC_CR_MAMP1_0) /*!< Unmask DAC channel LFSR bit[3:0] for noise wave generation */ 59 #define DAC_LFSRUNMASK_BITS4_0 ( DAC_CR_MAMP1_2 ) /*!< Unmask DAC channel LFSR bit[4:0] for noise wave generation */ 60 #define DAC_LFSRUNMASK_BITS5_0 ( DAC_CR_MAMP1_2 | DAC_CR_MAMP1_0) /*!< Unmask DAC channel LFSR bit[5:0] for noise wave generation */ 61 #define DAC_LFSRUNMASK_BITS6_0 ( DAC_CR_MAMP1_2 | DAC_CR_MAMP1_1 ) /*!< Unmask DAC channel LFSR bit[6:0] for noise wave generation */ 62 #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 */ 63 #define DAC_LFSRUNMASK_BITS8_0 (DAC_CR_MAMP1_3 ) /*!< Unmask DAC channel LFSR bit[8:0] for noise wave generation */ 64 #define DAC_LFSRUNMASK_BITS9_0 (DAC_CR_MAMP1_3 | DAC_CR_MAMP1_0) /*!< Unmask DAC channel LFSR bit[9:0] for noise wave generation */ 65 #define DAC_LFSRUNMASK_BITS10_0 (DAC_CR_MAMP1_3 | DAC_CR_MAMP1_1 ) /*!< Unmask DAC channel LFSR bit[10:0] for noise wave generation */ 66 #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 */ 67 #define DAC_TRIANGLEAMPLITUDE_1 0x00000000UL /*!< Select max triangle amplitude of 1 */ 68 #define DAC_TRIANGLEAMPLITUDE_3 ( DAC_CR_MAMP1_0) /*!< Select max triangle amplitude of 3 */ 69 #define DAC_TRIANGLEAMPLITUDE_7 ( DAC_CR_MAMP1_1 ) /*!< Select max triangle amplitude of 7 */ 70 #define DAC_TRIANGLEAMPLITUDE_15 ( DAC_CR_MAMP1_1 | DAC_CR_MAMP1_0) /*!< Select max triangle amplitude of 15 */ 71 #define DAC_TRIANGLEAMPLITUDE_31 ( DAC_CR_MAMP1_2 ) /*!< Select max triangle amplitude of 31 */ 72 #define DAC_TRIANGLEAMPLITUDE_63 ( DAC_CR_MAMP1_2 | DAC_CR_MAMP1_0) /*!< Select max triangle amplitude of 63 */ 73 #define DAC_TRIANGLEAMPLITUDE_127 ( DAC_CR_MAMP1_2 | DAC_CR_MAMP1_1 ) /*!< Select max triangle amplitude of 127 */ 74 #define DAC_TRIANGLEAMPLITUDE_255 ( DAC_CR_MAMP1_2 | DAC_CR_MAMP1_1 | DAC_CR_MAMP1_0) /*!< Select max triangle amplitude of 255 */ 75 #define DAC_TRIANGLEAMPLITUDE_511 (DAC_CR_MAMP1_3 ) /*!< Select max triangle amplitude of 511 */ 76 #define DAC_TRIANGLEAMPLITUDE_1023 (DAC_CR_MAMP1_3 | DAC_CR_MAMP1_0) /*!< Select max triangle amplitude of 1023 */ 77 #define DAC_TRIANGLEAMPLITUDE_2047 (DAC_CR_MAMP1_3 | DAC_CR_MAMP1_1 ) /*!< Select max triangle amplitude of 2047 */ 78 #define DAC_TRIANGLEAMPLITUDE_4095 (DAC_CR_MAMP1_3 | DAC_CR_MAMP1_1 | DAC_CR_MAMP1_0) /*!< Select max triangle amplitude of 4095 */ 79 80 /** 81 * @} 82 */ 83 84 /** @defgroup DACEx_SawtoothPolarityMode DAC Sawtooth polarity mode 85 * @{ 86 */ 87 #define DAC_SAWTOOTH_POLARITY_DECREMENT 0x00000000UL /*!< Sawtooth wave generation, polarity is decrement */ 88 #define DAC_SAWTOOTH_POLARITY_INCREMENT (DAC_STR1_STDIR1) /*!< Sawtooth wave generation, polarity is increment */ 89 90 /** 91 * @} 92 */ 93 94 /** 95 * @} 96 */ 97 98 /* Exported macro ------------------------------------------------------------*/ 99 100 101 /* Private macro -------------------------------------------------------------*/ 102 103 /** @defgroup DACEx_Private_Macros DACEx Private Macros 104 * @{ 105 */ 106 #if defined(STM32G414xx) || defined(STM32G474xx) || defined(STM32G484xx) 107 #define IS_DAC_TRIGGER(DACX, TRIGGER) \ 108 (((TRIGGER) == DAC_TRIGGER_NONE) || \ 109 ((TRIGGER) == DAC_TRIGGER_SOFTWARE) || \ 110 ((TRIGGER) == DAC_TRIGGER_T7_TRGO) || \ 111 ((TRIGGER) == DAC_TRIGGER_T15_TRGO) || \ 112 ((TRIGGER) == DAC_TRIGGER_T2_TRGO) || \ 113 ((TRIGGER) == DAC_TRIGGER_T4_TRGO) || \ 114 ((TRIGGER) == DAC_TRIGGER_EXT_IT9) || \ 115 ((TRIGGER) == DAC_TRIGGER_T6_TRGO) || \ 116 ((TRIGGER) == DAC_TRIGGER_T3_TRGO) || \ 117 ((TRIGGER) == DAC_TRIGGER_HRTIM_RST_TRG1) || \ 118 ((TRIGGER) == DAC_TRIGGER_HRTIM_RST_TRG2) || \ 119 ((TRIGGER) == DAC_TRIGGER_HRTIM_RST_TRG3) || \ 120 ((TRIGGER) == DAC_TRIGGER_HRTIM_RST_TRG4) || \ 121 ((TRIGGER) == DAC_TRIGGER_HRTIM_RST_TRG5) || \ 122 ((TRIGGER) == DAC_TRIGGER_HRTIM_RST_TRG6) || \ 123 (((DACX) == DAC1) && \ 124 (((TRIGGER) == DAC_TRIGGER_T8_TRGO) || \ 125 ((TRIGGER) == DAC_TRIGGER_HRTIM_TRG01)) \ 126 ) || \ 127 (((DACX) == DAC2) && \ 128 (((TRIGGER) == DAC_TRIGGER_T8_TRGO) || \ 129 ((TRIGGER) == DAC_TRIGGER_HRTIM_TRG02)) \ 130 ) || \ 131 (((DACX) == DAC3) && \ 132 (((TRIGGER) == DAC_TRIGGER_T1_TRGO) || \ 133 ((TRIGGER) == DAC_TRIGGER_HRTIM_TRG03)) \ 134 ) || \ 135 (((DACX) == DAC4) && \ 136 (((TRIGGER) == DAC_TRIGGER_T8_TRGO) || \ 137 ((TRIGGER) == DAC_TRIGGER_HRTIM_TRG01)) \ 138 ) \ 139 ) 140 #else 141 #define IS_DAC_TRIGGER(DACX, TRIGGER) \ 142 (((TRIGGER) == DAC_TRIGGER_NONE) || \ 143 ((TRIGGER) == DAC_TRIGGER_SOFTWARE) || \ 144 ((TRIGGER) == DAC_TRIGGER_T7_TRGO) || \ 145 ((TRIGGER) == DAC_TRIGGER_T15_TRGO) || \ 146 ((TRIGGER) == DAC_TRIGGER_T2_TRGO) || \ 147 ((TRIGGER) == DAC_TRIGGER_T4_TRGO) || \ 148 ((TRIGGER) == DAC_TRIGGER_EXT_IT9) || \ 149 ((TRIGGER) == DAC_TRIGGER_T6_TRGO) || \ 150 ((TRIGGER) == DAC_TRIGGER_T3_TRGO) || \ 151 (((DACX) == DAC3) ? \ 152 ((TRIGGER) == DAC_TRIGGER_T1_TRGO) \ 153 : ((TRIGGER) == DAC_TRIGGER_T8_TRGO) \ 154 ) \ 155 ) 156 #endif /* STM32G414xx || STM32G474xx || STM32G484xx */ 157 158 #if defined(STM32G414xx) || defined(STM32G474xx) || defined(STM32G484xx) 159 #define IS_DAC_TRIGGER2(DACX, TRIGGER) \ 160 (((TRIGGER) == DAC_TRIGGER_NONE) || \ 161 ((TRIGGER) == DAC_TRIGGER_SOFTWARE) || \ 162 ((TRIGGER) == DAC_TRIGGER_T7_TRGO) || \ 163 ((TRIGGER) == DAC_TRIGGER_T15_TRGO) || \ 164 ((TRIGGER) == DAC_TRIGGER_T2_TRGO) || \ 165 ((TRIGGER) == DAC_TRIGGER_T4_TRGO) || \ 166 ((TRIGGER) == DAC_TRIGGER_EXT_IT10) || \ 167 ((TRIGGER) == DAC_TRIGGER_T6_TRGO) || \ 168 ((TRIGGER) == DAC_TRIGGER_T3_TRGO) || \ 169 ((TRIGGER) == DAC_TRIGGER_HRTIM_STEP_TRG1) || \ 170 ((TRIGGER) == DAC_TRIGGER_HRTIM_STEP_TRG2) || \ 171 ((TRIGGER) == DAC_TRIGGER_HRTIM_STEP_TRG3) || \ 172 ((TRIGGER) == DAC_TRIGGER_HRTIM_STEP_TRG4) || \ 173 ((TRIGGER) == DAC_TRIGGER_HRTIM_STEP_TRG5) || \ 174 ((TRIGGER) == DAC_TRIGGER_HRTIM_STEP_TRG6) || \ 175 (((DACX) == DAC1) && \ 176 ((TRIGGER) == DAC_TRIGGER_T8_TRGO) \ 177 ) || \ 178 (((DACX) == DAC2) && \ 179 ((TRIGGER) == DAC_TRIGGER_T8_TRGO) \ 180 ) || \ 181 (((DACX) == DAC3) && \ 182 ((TRIGGER) == DAC_TRIGGER_T1_TRGO) \ 183 ) || \ 184 (((DACX) == DAC4) && \ 185 ((TRIGGER) == DAC_TRIGGER_T8_TRGO) \ 186 ) \ 187 ) 188 #else 189 #define IS_DAC_TRIGGER2(DACX, TRIGGER) \ 190 (((TRIGGER) == DAC_TRIGGER_NONE) || \ 191 ((TRIGGER) == DAC_TRIGGER_SOFTWARE) || \ 192 ((TRIGGER) == DAC_TRIGGER_T7_TRGO) || \ 193 ((TRIGGER) == DAC_TRIGGER_T15_TRGO) || \ 194 ((TRIGGER) == DAC_TRIGGER_T2_TRGO) || \ 195 ((TRIGGER) == DAC_TRIGGER_T4_TRGO) || \ 196 ((TRIGGER) == DAC_TRIGGER_EXT_IT10) || \ 197 ((TRIGGER) == DAC_TRIGGER_T6_TRGO) || \ 198 ((TRIGGER) == DAC_TRIGGER_T3_TRGO) || \ 199 (((DACX) == DAC3) ? \ 200 ((TRIGGER) == DAC_TRIGGER_T1_TRGO) \ 201 :((TRIGGER) == DAC_TRIGGER_T8_TRGO) \ 202 ) \ 203 ) 204 #endif /* STM32G414xx || STM32G474xx || STM32G484xx */ 205 #define IS_DAC_HIGH_FREQUENCY_MODE(MODE) (((MODE) == DAC_HIGH_FREQUENCY_INTERFACE_MODE_DISABLE) || \ 206 ((MODE) == DAC_HIGH_FREQUENCY_INTERFACE_MODE_ABOVE_80MHZ) || \ 207 ((MODE) == DAC_HIGH_FREQUENCY_INTERFACE_MODE_ABOVE_160MHZ) || \ 208 ((MODE) == DAC_HIGH_FREQUENCY_INTERFACE_MODE_AUTOMATIC)) 209 210 #define IS_DAC_SAMPLETIME(TIME) ((TIME) <= 0x000003FFU) 211 212 #define IS_DAC_HOLDTIME(TIME) ((TIME) <= 0x000003FFU) 213 214 #define IS_DAC_SAMPLEANDHOLD(MODE) (((MODE) == DAC_SAMPLEANDHOLD_DISABLE) || \ 215 ((MODE) == DAC_SAMPLEANDHOLD_ENABLE)) 216 217 #define IS_DAC_TRIMMINGVALUE(TRIMMINGVALUE) ((TRIMMINGVALUE) <= 0x1FU) 218 219 #define IS_DAC_NEWTRIMMINGVALUE(TRIMMINGVALUE) ((TRIMMINGVALUE) <= 0x1FU) 220 221 #define IS_DAC_CHIP_CONNECTION(CONNECT) (((CONNECT) == DAC_CHIPCONNECT_EXTERNAL) || \ 222 ((CONNECT) == DAC_CHIPCONNECT_INTERNAL) || \ 223 ((CONNECT) == DAC_CHIPCONNECT_BOTH)) 224 225 #define IS_DAC_TRIMMING(TRIMMING) (((TRIMMING) == DAC_TRIMMING_FACTORY) || \ 226 ((TRIMMING) == DAC_TRIMMING_USER)) 227 228 #define IS_DAC_LFSR_UNMASK_TRIANGLE_AMPLITUDE(VALUE) (((VALUE) == DAC_LFSRUNMASK_BIT0) || \ 229 ((VALUE) == DAC_LFSRUNMASK_BITS1_0) || \ 230 ((VALUE) == DAC_LFSRUNMASK_BITS2_0) || \ 231 ((VALUE) == DAC_LFSRUNMASK_BITS3_0) || \ 232 ((VALUE) == DAC_LFSRUNMASK_BITS4_0) || \ 233 ((VALUE) == DAC_LFSRUNMASK_BITS5_0) || \ 234 ((VALUE) == DAC_LFSRUNMASK_BITS6_0) || \ 235 ((VALUE) == DAC_LFSRUNMASK_BITS7_0) || \ 236 ((VALUE) == DAC_LFSRUNMASK_BITS8_0) || \ 237 ((VALUE) == DAC_LFSRUNMASK_BITS9_0) || \ 238 ((VALUE) == DAC_LFSRUNMASK_BITS10_0) || \ 239 ((VALUE) == DAC_LFSRUNMASK_BITS11_0) || \ 240 ((VALUE) == DAC_TRIANGLEAMPLITUDE_1) || \ 241 ((VALUE) == DAC_TRIANGLEAMPLITUDE_3) || \ 242 ((VALUE) == DAC_TRIANGLEAMPLITUDE_7) || \ 243 ((VALUE) == DAC_TRIANGLEAMPLITUDE_15) || \ 244 ((VALUE) == DAC_TRIANGLEAMPLITUDE_31) || \ 245 ((VALUE) == DAC_TRIANGLEAMPLITUDE_63) || \ 246 ((VALUE) == DAC_TRIANGLEAMPLITUDE_127) || \ 247 ((VALUE) == DAC_TRIANGLEAMPLITUDE_255) || \ 248 ((VALUE) == DAC_TRIANGLEAMPLITUDE_511) || \ 249 ((VALUE) == DAC_TRIANGLEAMPLITUDE_1023) || \ 250 ((VALUE) == DAC_TRIANGLEAMPLITUDE_2047) || \ 251 ((VALUE) == DAC_TRIANGLEAMPLITUDE_4095)) 252 253 #define IS_DAC_SAWTOOTH_POLARITY(POLARITY) (((POLARITY) == DAC_SAWTOOTH_POLARITY_DECREMENT) || \ 254 ((POLARITY) == DAC_SAWTOOTH_POLARITY_INCREMENT)) 255 256 #define IS_DAC_RESET_DATA(DATA) ((DATA) <= 0x00000FFFUL) 257 #define IS_DAC_STEP_DATA(DATA) ((DATA) <= 0x0000FFFFUL) 258 /** 259 * @} 260 */ 261 262 /* Exported functions --------------------------------------------------------*/ 263 /* Extended features functions ***********************************************/ 264 265 /** @addtogroup DACEx_Exported_Functions 266 * @{ 267 */ 268 269 /** @addtogroup DACEx_Exported_Functions_Group2 270 * @{ 271 */ 272 /* IO operation functions *****************************************************/ 273 274 HAL_StatusTypeDef HAL_DACEx_TriangleWaveGenerate(DAC_HandleTypeDef *hdac, uint32_t Channel, uint32_t Amplitude); 275 HAL_StatusTypeDef HAL_DACEx_NoiseWaveGenerate(DAC_HandleTypeDef *hdac, uint32_t Channel, uint32_t Amplitude); 276 HAL_StatusTypeDef HAL_DACEx_SawtoothWaveGenerate(DAC_HandleTypeDef *hdac, uint32_t Channel, uint32_t Polarity, 277 uint32_t ResetData, uint32_t StepData); 278 HAL_StatusTypeDef HAL_DACEx_SawtoothWaveDataReset(DAC_HandleTypeDef *hdac, uint32_t Channel); 279 HAL_StatusTypeDef HAL_DACEx_SawtoothWaveDataStep(DAC_HandleTypeDef *hdac, uint32_t Channel); 280 281 HAL_StatusTypeDef HAL_DACEx_DualStart(DAC_HandleTypeDef *hdac); 282 HAL_StatusTypeDef HAL_DACEx_DualStop(DAC_HandleTypeDef *hdac); 283 HAL_StatusTypeDef HAL_DACEx_DualStart_DMA(DAC_HandleTypeDef *hdac, uint32_t Channel, 284 const uint32_t *pData, uint32_t Length, uint32_t Alignment); 285 HAL_StatusTypeDef HAL_DACEx_DualStop_DMA(DAC_HandleTypeDef *hdac, uint32_t Channel); 286 HAL_StatusTypeDef HAL_DACEx_DualSetValue(DAC_HandleTypeDef *hdac, uint32_t Alignment, uint32_t Data1, uint32_t Data2); 287 uint32_t HAL_DACEx_DualGetValue(const DAC_HandleTypeDef *hdac); 288 289 void HAL_DACEx_ConvCpltCallbackCh2(DAC_HandleTypeDef *hdac); 290 void HAL_DACEx_ConvHalfCpltCallbackCh2(DAC_HandleTypeDef *hdac); 291 void HAL_DACEx_ErrorCallbackCh2(DAC_HandleTypeDef *hdac); 292 void HAL_DACEx_DMAUnderrunCallbackCh2(DAC_HandleTypeDef *hdac); 293 294 295 /** 296 * @} 297 */ 298 299 /** @addtogroup DACEx_Exported_Functions_Group3 300 * @{ 301 */ 302 /* Peripheral Control functions ***********************************************/ 303 304 HAL_StatusTypeDef HAL_DACEx_SelfCalibrate(DAC_HandleTypeDef *hdac, DAC_ChannelConfTypeDef *sConfig, uint32_t Channel); 305 HAL_StatusTypeDef HAL_DACEx_SetUserTrimming(DAC_HandleTypeDef *hdac, DAC_ChannelConfTypeDef *sConfig, uint32_t Channel, 306 uint32_t NewTrimmingValue); 307 uint32_t HAL_DACEx_GetTrimOffset(const DAC_HandleTypeDef *hdac, uint32_t Channel); 308 309 /** 310 * @} 311 */ 312 313 /** 314 * @} 315 */ 316 317 /** @addtogroup DACEx_Private_Functions 318 * @{ 319 */ 320 321 /* DAC_DMAConvCpltCh2 / DAC_DMAErrorCh2 / DAC_DMAHalfConvCpltCh2 */ 322 /* are called by HAL_DAC_Start_DMA */ 323 void DAC_DMAConvCpltCh2(DMA_HandleTypeDef *hdma); 324 void DAC_DMAErrorCh2(DMA_HandleTypeDef *hdma); 325 void DAC_DMAHalfConvCpltCh2(DMA_HandleTypeDef *hdma); 326 327 /** 328 * @} 329 */ 330 331 /** 332 * @} 333 */ 334 335 #endif /* DAC1 || DAC2 || DAC3 || DAC4 */ 336 337 /** 338 * @} 339 */ 340 341 #ifdef __cplusplus 342 } 343 #endif 344 345 #endif /* STM32G4xx_HAL_DAC_EX_H */ 346
