STM32L4xx_HAL_Driver  1.14.0
stm32l4xx_hal_dac_ex.h
Go to the documentation of this file.
1 
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 
32 /* Includes ------------------------------------------------------------------*/
33 #include "stm32l4xx_hal_def.h"
34 
35 #if defined(DAC1)
36 
41 /* Exported types ------------------------------------------------------------*/
42 
47 /* Exported constants --------------------------------------------------------*/
48 
56 #define DAC_LFSRUNMASK_BIT0 0x00000000U
57 #define DAC_LFSRUNMASK_BITS1_0 ( DAC_CR_MAMP1_0)
58 #define DAC_LFSRUNMASK_BITS2_0 ( DAC_CR_MAMP1_1 )
59 #define DAC_LFSRUNMASK_BITS3_0 ( DAC_CR_MAMP1_1 | DAC_CR_MAMP1_0)
60 #define DAC_LFSRUNMASK_BITS4_0 ( DAC_CR_MAMP1_2 )
61 #define DAC_LFSRUNMASK_BITS5_0 ( DAC_CR_MAMP1_2 | DAC_CR_MAMP1_0)
62 #define DAC_LFSRUNMASK_BITS6_0 ( DAC_CR_MAMP1_2 | DAC_CR_MAMP1_1 )
63 #define DAC_LFSRUNMASK_BITS7_0 ( DAC_CR_MAMP1_2 | DAC_CR_MAMP1_1 | DAC_CR_MAMP1_0)
64 #define DAC_LFSRUNMASK_BITS8_0 (DAC_CR_MAMP1_3 )
65 #define DAC_LFSRUNMASK_BITS9_0 (DAC_CR_MAMP1_3 | DAC_CR_MAMP1_0)
66 #define DAC_LFSRUNMASK_BITS10_0 (DAC_CR_MAMP1_3 | DAC_CR_MAMP1_1 )
67 #define DAC_LFSRUNMASK_BITS11_0 (DAC_CR_MAMP1_3 | DAC_CR_MAMP1_1 | DAC_CR_MAMP1_0)
68 #define DAC_TRIANGLEAMPLITUDE_1 0x00000000U
69 #define DAC_TRIANGLEAMPLITUDE_3 ( DAC_CR_MAMP1_0)
70 #define DAC_TRIANGLEAMPLITUDE_7 ( DAC_CR_MAMP1_1 )
71 #define DAC_TRIANGLEAMPLITUDE_15 ( DAC_CR_MAMP1_1 | DAC_CR_MAMP1_0)
72 #define DAC_TRIANGLEAMPLITUDE_31 ( DAC_CR_MAMP1_2 )
73 #define DAC_TRIANGLEAMPLITUDE_63 ( DAC_CR_MAMP1_2 | DAC_CR_MAMP1_0)
74 #define DAC_TRIANGLEAMPLITUDE_127 ( DAC_CR_MAMP1_2 | DAC_CR_MAMP1_1 )
75 #define DAC_TRIANGLEAMPLITUDE_255 ( DAC_CR_MAMP1_2 | DAC_CR_MAMP1_1 | DAC_CR_MAMP1_0)
76 #define DAC_TRIANGLEAMPLITUDE_511 (DAC_CR_MAMP1_3 )
77 #define DAC_TRIANGLEAMPLITUDE_1023 (DAC_CR_MAMP1_3 | DAC_CR_MAMP1_0)
78 #define DAC_TRIANGLEAMPLITUDE_2047 (DAC_CR_MAMP1_3 | DAC_CR_MAMP1_1 )
79 #define DAC_TRIANGLEAMPLITUDE_4095 (DAC_CR_MAMP1_3 | DAC_CR_MAMP1_1 | DAC_CR_MAMP1_0)
89 /* Exported macro ------------------------------------------------------------*/
90 
91 
92 /* Private macro -------------------------------------------------------------*/
93 
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 (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 /* 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 
192 /* Exported functions --------------------------------------------------------*/
193 /* Extended features functions ***********************************************/
194 
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 (STM32L4R5xx) || defined (STM32L4R7xx) || defined (STM32L4R9xx) || defined (STM32L4S5xx) || defined (STM32L4S7xx) || defined(STM32L4S9xx)
210 HAL_StatusTypeDef HAL_DACEx_DualSetValue(DAC_HandleTypeDef* hdac, uint32_t Alignment, uint32_t Data1, uint32_t Data2);
211 uint32_t HAL_DACEx_DualGetValue(DAC_HandleTypeDef* hdac);
212 #endif /* STM32L431xx STM32L432xx STM32L433xx STM32L442xx STM32L443xx */
213  /* STM32L471xx STM32L475xx STM32L476xx STM32L485xx STM32L486xx STM32L496xx STM32L4A6xx */
214  /* STM32L4R5xx STM32L4R7xx STM32L4R9xx STM32L4S5xx STM32L4S7xx STM32L4S9xx */
215 #if defined (STM32L431xx) || defined (STM32L432xx) || defined (STM32L433xx) || defined (STM32L442xx) || defined (STM32L443xx) || \
216  defined (STM32L471xx) || defined (STM32L475xx) || defined (STM32L476xx) || defined (STM32L485xx) || defined (STM32L486xx) || defined (STM32L496xx) || defined (STM32L4A6xx) || \
217  defined (STM32L4R5xx) || defined (STM32L4R7xx) || defined (STM32L4R9xx) || defined (STM32L4S5xx) || defined (STM32L4S7xx) || defined(STM32L4S9xx)
218 void HAL_DACEx_ConvCpltCallbackCh2(DAC_HandleTypeDef* hdac);
219 void HAL_DACEx_ConvHalfCpltCallbackCh2(DAC_HandleTypeDef* hdac);
220 void HAL_DACEx_ErrorCallbackCh2(DAC_HandleTypeDef* hdac);
221 void HAL_DACEx_DMAUnderrunCallbackCh2(DAC_HandleTypeDef* hdac);
222 #endif /* STM32L431xx STM32L432xx STM32L433xx STM32L442xx STM32L443xx */
223  /* STM32L471xx STM32L475xx STM32L476xx STM32L485xx STM32L486xx STM32L496xx STM32L4A6xx */
224  /* STM32L4R5xx STM32L4R7xx STM32L4R9xx STM32L4S5xx STM32L4S7xx STM32L4S9xx */
225 
226 
234 /* Peripheral Control functions ***********************************************/
235 
236 HAL_StatusTypeDef HAL_DACEx_SelfCalibrate(DAC_HandleTypeDef *hdac, DAC_ChannelConfTypeDef *sConfig, uint32_t Channel);
237 HAL_StatusTypeDef HAL_DACEx_SetUserTrimming(DAC_HandleTypeDef *hdac, DAC_ChannelConfTypeDef *sConfig, uint32_t Channel, uint32_t NewTrimmingValue);
238 uint32_t HAL_DACEx_GetTrimOffset (DAC_HandleTypeDef *hdac, uint32_t Channel);
239 
248 #if defined (STM32L431xx) || defined (STM32L432xx) || defined (STM32L433xx) || defined (STM32L442xx) || defined (STM32L443xx) || \
249  defined (STM32L471xx) || defined (STM32L475xx) || defined (STM32L476xx) || defined (STM32L485xx) || defined (STM32L486xx) || defined (STM32L496xx) || defined (STM32L4A6xx) || \
250  defined (STM32L4R5xx) || defined (STM32L4R7xx) || defined (STM32L4R9xx) || defined (STM32L4S5xx) || defined (STM32L4S7xx) || defined(STM32L4S9xx)
251 
256 /* DAC_DMAConvCpltCh2 / DAC_DMAErrorCh2 / DAC_DMAHalfConvCpltCh2 */
257 /* are called by HAL_DAC_Start_DMA */
258 void DAC_DMAConvCpltCh2(DMA_HandleTypeDef *hdma);
259 void DAC_DMAErrorCh2(DMA_HandleTypeDef *hdma);
260 void DAC_DMAHalfConvCpltCh2(DMA_HandleTypeDef *hdma);
261 
265 #endif /* STM32L431xx STM32L432xx STM32L433xx STM32L442xx STM32L443xx */
266  /* STM32L471xx STM32L475xx STM32L476xx STM32L485xx STM32L486xx STM32L496xx STM32L4A6xx */
267  /* STM32L4R5xx STM32L4R7xx STM32L4R9xx STM32L4S5xx STM32L4S7xx STM32L4S9xx */
272 #endif /* DAC1 */
273 
278 #ifdef __cplusplus
279 }
280 #endif
281 
282 #endif /*STM32L4xx_HAL_DAC_EX_H */
283 
284 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
DAC_HandleTypeDef
struct __DAC_HandleTypeDef else typedef struct endif DAC_HandleTypeDef
DAC handle Structure definition.
HAL_DACEx_ConvCpltCallbackCh2
void HAL_DACEx_ConvCpltCallbackCh2(DAC_HandleTypeDef *hdac)
Conversion complete callback in non-blocking mode for Channel2.
Definition: stm32l4xx_hal_dac_ex.c:248
__DMA_HandleTypeDef
DMA handle Structure definition.
Definition: stm32l4xx_hal_dma.h:113
HAL_DACEx_NoiseWaveGenerate
HAL_StatusTypeDef HAL_DACEx_NoiseWaveGenerate(DAC_HandleTypeDef *hdac, uint32_t Channel, uint32_t Amplitude)
Enable or disable the selected DAC channel wave generation.
Definition: stm32l4xx_hal_dac_ex.c:168
HAL_DACEx_ConvHalfCpltCallbackCh2
void HAL_DACEx_ConvHalfCpltCallbackCh2(DAC_HandleTypeDef *hdac)
Conversion half DMA transfer callback in non-blocking mode for Channel2.
Definition: stm32l4xx_hal_dac_ex.c:264
DAC_ChannelConfTypeDef
DAC Configuration regular Channel structure definition.
Definition: stm32l4xx_hal_dac.h:118
stm32l4xx_hal_def.h
This file contains HAL common defines, enumeration, macros and structures definitions.
DAC_DMAErrorCh2
void DAC_DMAErrorCh2(DMA_HandleTypeDef *hdma)
DMA error callback.
Definition: stm32l4xx_hal_dac_ex.c:616
HAL_DACEx_GetTrimOffset
uint32_t HAL_DACEx_GetTrimOffset(DAC_HandleTypeDef *hdac, uint32_t Channel)
Return the DAC trimming value.
Definition: stm32l4xx_hal_dac_ex.c:503
HAL_DACEx_TriangleWaveGenerate
HAL_StatusTypeDef HAL_DACEx_TriangleWaveGenerate(DAC_HandleTypeDef *hdac, uint32_t Channel, uint32_t Amplitude)
Enable or disable the selected DAC channel wave generation.
Definition: stm32l4xx_hal_dac_ex.c:119
HAL_DACEx_SelfCalibrate
HAL_StatusTypeDef HAL_DACEx_SelfCalibrate(DAC_HandleTypeDef *hdac, DAC_ChannelConfTypeDef *sConfig, uint32_t Channel)
Run the self calibration of one DAC channel.
Definition: stm32l4xx_hal_dac_ex.c:323
HAL_DACEx_DualSetValue
HAL_StatusTypeDef HAL_DACEx_DualSetValue(DAC_HandleTypeDef *hdac, uint32_t Alignment, uint32_t Data1, uint32_t Data2)
Set the specified data holding register value for dual DAC channel.
Definition: stm32l4xx_hal_dac_ex.c:212
HAL_DACEx_DMAUnderrunCallbackCh2
void HAL_DACEx_DMAUnderrunCallbackCh2(DAC_HandleTypeDef *hdac)
DMA underrun DAC callback for Channel2.
Definition: stm32l4xx_hal_dac_ex.c:296
DAC_DMAConvCpltCh2
void DAC_DMAConvCpltCh2(DMA_HandleTypeDef *hdma)
DMA conversion complete callback.
Definition: stm32l4xx_hal_dac_ex.c:580
DAC_DMAHalfConvCpltCh2
void DAC_DMAHalfConvCpltCh2(DMA_HandleTypeDef *hdma)
DMA half transfer complete callback.
Definition: stm32l4xx_hal_dac_ex.c:599
HAL_DACEx_DualGetValue
uint32_t HAL_DACEx_DualGetValue(DAC_HandleTypeDef *hdac)
Return the last data output value of the selected DAC channel.
Definition: stm32l4xx_hal_dac_ex.c:540
HAL_DACEx_ErrorCallbackCh2
void HAL_DACEx_ErrorCallbackCh2(DAC_HandleTypeDef *hdac)
Error DAC callback for Channel2.
Definition: stm32l4xx_hal_dac_ex.c:280
HAL_DACEx_SetUserTrimming
HAL_StatusTypeDef HAL_DACEx_SetUserTrimming(DAC_HandleTypeDef *hdac, DAC_ChannelConfTypeDef *sConfig, uint32_t Channel, uint32_t NewTrimmingValue)
Set the trimming mode and trimming value (user trimming mode applied).
Definition: stm32l4xx_hal_dac_ex.c:460