STM32L4xx_HAL_Driver  1.14.0
stm32l4xx_ll_dac.c
Go to the documentation of this file.
1 
19 #if defined(USE_FULL_LL_DRIVER)
20 
21 /* Includes ------------------------------------------------------------------*/
22 #include "stm32l4xx_ll_dac.h"
23 #include "stm32l4xx_ll_bus.h"
24 
25 #ifdef USE_FULL_ASSERT
26  #include "stm32_assert.h"
27 #else
28  #define assert_param(expr) ((void)0U)
29 #endif
30 
35 #if defined (DAC1)
36 
41 /* Private types -------------------------------------------------------------*/
42 /* Private variables ---------------------------------------------------------*/
43 /* Private constants ---------------------------------------------------------*/
44 /* Private macros ------------------------------------------------------------*/
45 
50 #if defined(DAC_CHANNEL2_SUPPORT)
51 #define IS_LL_DAC_CHANNEL(__DAC_CHANNEL__) \
52  ( \
53  ((__DAC_CHANNEL__) == LL_DAC_CHANNEL_1) \
54  || ((__DAC_CHANNEL__) == LL_DAC_CHANNEL_2) \
55  )
56 #else
57 #define IS_LL_DAC_CHANNEL(__DAC_CHANNEL__) \
58  ( \
59  ((__DAC_CHANNEL__) == LL_DAC_CHANNEL_1) \
60  )
61 #endif /* DAC_CHANNEL2_SUPPORT */
62 
63 #if defined (DAC_CR_TSEL1_3)
64 #define IS_LL_DAC_TRIGGER_SOURCE(__TRIGGER_SOURCE__) \
65  ( ((__TRIGGER_SOURCE__) == LL_DAC_TRIG_EXT_TIM1_TRGO) \
66  || ((__TRIGGER_SOURCE__) == LL_DAC_TRIG_EXT_TIM2_TRGO) \
67  || ((__TRIGGER_SOURCE__) == LL_DAC_TRIG_EXT_TIM4_TRGO) \
68  || ((__TRIGGER_SOURCE__) == LL_DAC_TRIG_EXT_TIM5_TRGO) \
69  || ((__TRIGGER_SOURCE__) == LL_DAC_TRIG_EXT_TIM6_TRGO) \
70  || ((__TRIGGER_SOURCE__) == LL_DAC_TRIG_EXT_TIM7_TRGO) \
71  || ((__TRIGGER_SOURCE__) == LL_DAC_TRIG_EXT_TIM8_TRGO) \
72  || ((__TRIGGER_SOURCE__) == LL_DAC_TRIG_EXT_TIM15_TRGO) \
73  || ((__TRIGGER_SOURCE__) == LL_DAC_TRIG_EXT_LPTIM1_OUT) \
74  || ((__TRIGGER_SOURCE__) == LL_DAC_TRIG_EXT_LPTIM2_OUT) \
75  || ((__TRIGGER_SOURCE__) == LL_DAC_TRIG_EXT_EXTI_LINE9) \
76  || ((__TRIGGER_SOURCE__) == LL_DAC_TRIG_SOFTWARE) \
77  )
78 #else
79 #define IS_LL_DAC_TRIGGER_SOURCE(__TRIGGER_SOURCE__) \
80  ( ((__TRIGGER_SOURCE__) == LL_DAC_TRIG_SOFTWARE) \
81  || ((__TRIGGER_SOURCE__) == LL_DAC_TRIG_EXT_TIM2_TRGO) \
82  || ((__TRIGGER_SOURCE__) == LL_DAC_TRIG_EXT_TIM4_TRGO) \
83  || ((__TRIGGER_SOURCE__) == LL_DAC_TRIG_EXT_TIM5_TRGO) \
84  || ((__TRIGGER_SOURCE__) == LL_DAC_TRIG_EXT_TIM6_TRGO) \
85  || ((__TRIGGER_SOURCE__) == LL_DAC_TRIG_EXT_TIM7_TRGO) \
86  || ((__TRIGGER_SOURCE__) == LL_DAC_TRIG_EXT_TIM8_TRGO) \
87  || ((__TRIGGER_SOURCE__) == LL_DAC_TRIG_EXT_EXTI_LINE9) \
88  )
89 #endif /* DAC_CR_TSEL1_3 */
90 
91 #define IS_LL_DAC_WAVE_AUTO_GENER_MODE(__WAVE_AUTO_GENERATION_MODE__) \
92  ( ((__WAVE_AUTO_GENERATION_MODE__) == LL_DAC_WAVE_AUTO_GENERATION_NONE) \
93  || ((__WAVE_AUTO_GENERATION_MODE__) == LL_DAC_WAVE_AUTO_GENERATION_NOISE) \
94  || ((__WAVE_AUTO_GENERATION_MODE__) == LL_DAC_WAVE_AUTO_GENERATION_TRIANGLE) \
95  )
96 
97 #define IS_LL_DAC_WAVE_AUTO_GENER_CONFIG(__WAVE_AUTO_GENERATION_MODE__, __WAVE_AUTO_GENERATION_CONFIG__) \
98  ( (((__WAVE_AUTO_GENERATION_MODE__) == LL_DAC_WAVE_AUTO_GENERATION_NOISE) \
99  && ( ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_NOISE_LFSR_UNMASK_BIT0) \
100  || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_NOISE_LFSR_UNMASK_BITS1_0) \
101  || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_NOISE_LFSR_UNMASK_BITS2_0) \
102  || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_NOISE_LFSR_UNMASK_BITS3_0) \
103  || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_NOISE_LFSR_UNMASK_BITS4_0) \
104  || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_NOISE_LFSR_UNMASK_BITS5_0) \
105  || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_NOISE_LFSR_UNMASK_BITS6_0) \
106  || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_NOISE_LFSR_UNMASK_BITS7_0) \
107  || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_NOISE_LFSR_UNMASK_BITS8_0) \
108  || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_NOISE_LFSR_UNMASK_BITS9_0) \
109  || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_NOISE_LFSR_UNMASK_BITS10_0) \
110  || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_NOISE_LFSR_UNMASK_BITS11_0)) \
111  ) \
112  ||(((__WAVE_AUTO_GENERATION_MODE__) == LL_DAC_WAVE_AUTO_GENERATION_TRIANGLE) \
113  && ( ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_TRIANGLE_AMPLITUDE_1) \
114  || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_TRIANGLE_AMPLITUDE_3) \
115  || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_TRIANGLE_AMPLITUDE_7) \
116  || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_TRIANGLE_AMPLITUDE_15) \
117  || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_TRIANGLE_AMPLITUDE_31) \
118  || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_TRIANGLE_AMPLITUDE_63) \
119  || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_TRIANGLE_AMPLITUDE_127) \
120  || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_TRIANGLE_AMPLITUDE_255) \
121  || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_TRIANGLE_AMPLITUDE_511) \
122  || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_TRIANGLE_AMPLITUDE_1023) \
123  || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_TRIANGLE_AMPLITUDE_2047) \
124  || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_TRIANGLE_AMPLITUDE_4095)) \
125  ) \
126  )
127 
128 #define IS_LL_DAC_OUTPUT_BUFFER(__OUTPUT_BUFFER__) \
129  ( ((__OUTPUT_BUFFER__) == LL_DAC_OUTPUT_BUFFER_ENABLE) \
130  || ((__OUTPUT_BUFFER__) == LL_DAC_OUTPUT_BUFFER_DISABLE) \
131  )
132 
133 #define IS_LL_DAC_OUTPUT_CONNECTION(__OUTPUT_CONNECTION__) \
134  ( ((__OUTPUT_CONNECTION__) == LL_DAC_OUTPUT_CONNECT_GPIO) \
135  || ((__OUTPUT_CONNECTION__) == LL_DAC_OUTPUT_CONNECT_INTERNAL) \
136  )
137 
138 #define IS_LL_DAC_OUTPUT_MODE(__OUTPUT_MODE__) \
139  ( ((__OUTPUT_MODE__) == LL_DAC_OUTPUT_MODE_NORMAL) \
140  || ((__OUTPUT_MODE__) == LL_DAC_OUTPUT_MODE_SAMPLE_AND_HOLD) \
141  )
142 
148 /* Private function prototypes -----------------------------------------------*/
149 
150 /* Exported functions --------------------------------------------------------*/
167 ErrorStatus LL_DAC_DeInit(DAC_TypeDef *DACx)
168 {
169  /* Check the parameters */
170  assert_param(IS_DAC_ALL_INSTANCE(DACx));
171 
172  /* Force reset of DAC clock */
173  LL_APB1_GRP1_ForceReset(LL_APB1_GRP1_PERIPH_DAC1);
174 
175  /* Release reset of DAC clock */
176  LL_APB1_GRP1_ReleaseReset(LL_APB1_GRP1_PERIPH_DAC1);
177 
178  return SUCCESS;
179 }
180 
209 ErrorStatus LL_DAC_Init(DAC_TypeDef *DACx, uint32_t DAC_Channel, LL_DAC_InitTypeDef *DAC_InitStruct)
210 {
211  ErrorStatus status = SUCCESS;
212 
213  /* Check the parameters */
214  assert_param(IS_DAC_ALL_INSTANCE(DACx));
215  assert_param(IS_LL_DAC_CHANNEL(DAC_Channel));
216  assert_param(IS_LL_DAC_TRIGGER_SOURCE(DAC_InitStruct->TriggerSource));
217  assert_param(IS_LL_DAC_OUTPUT_BUFFER(DAC_InitStruct->OutputBuffer));
218  assert_param(IS_LL_DAC_OUTPUT_CONNECTION(DAC_InitStruct->OutputConnection));
219  assert_param(IS_LL_DAC_OUTPUT_MODE(DAC_InitStruct->OutputMode));
220  assert_param(IS_LL_DAC_WAVE_AUTO_GENER_MODE(DAC_InitStruct->WaveAutoGeneration));
221  if (DAC_InitStruct->WaveAutoGeneration != LL_DAC_WAVE_AUTO_GENERATION_NONE)
222  {
223  assert_param(IS_LL_DAC_WAVE_AUTO_GENER_CONFIG(DAC_InitStruct->WaveAutoGeneration,
224  DAC_InitStruct->WaveAutoGenerationConfig));
225  }
226 
227  /* Note: Hardware constraint (refer to description of this function) */
228  /* DAC instance must be disabled. */
229  if (LL_DAC_IsEnabled(DACx, DAC_Channel) == 0U)
230  {
231  /* Configuration of DAC channel: */
232  /* - TriggerSource */
233  /* - WaveAutoGeneration */
234  /* - OutputBuffer */
235  /* - OutputConnection */
236  /* - OutputMode */
237  if (DAC_InitStruct->WaveAutoGeneration != LL_DAC_WAVE_AUTO_GENERATION_NONE)
238  {
239  MODIFY_REG(DACx->CR,
240  (DAC_CR_TSEL1
241  | DAC_CR_WAVE1
242  | DAC_CR_MAMP1
243  ) << (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK)
244  ,
245  (DAC_InitStruct->TriggerSource
246  | DAC_InitStruct->WaveAutoGeneration
247  | DAC_InitStruct->WaveAutoGenerationConfig
248  ) << (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK)
249  );
250  }
251  else
252  {
253  MODIFY_REG(DACx->CR,
254  (DAC_CR_TSEL1
255  | DAC_CR_WAVE1
256  ) << (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK)
257  ,
258  (DAC_InitStruct->TriggerSource
259  | LL_DAC_WAVE_AUTO_GENERATION_NONE
260  ) << (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK)
261  );
262  }
263  MODIFY_REG(DACx->MCR,
264  (DAC_MCR_MODE1_1
265  | DAC_MCR_MODE1_0
266  | DAC_MCR_MODE1_2
267  ) << (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK)
268  ,
269  (DAC_InitStruct->OutputBuffer
270  | DAC_InitStruct->OutputConnection
271  | DAC_InitStruct->OutputMode
272  ) << (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK)
273  );
274  }
275  else
276  {
277  /* Initialization error: DAC instance is not disabled. */
278  status = ERROR;
279  }
280  return status;
281 }
282 
289 void LL_DAC_StructInit(LL_DAC_InitTypeDef *DAC_InitStruct)
290 {
291  /* Set DAC_InitStruct fields to default values */
292  DAC_InitStruct->TriggerSource = LL_DAC_TRIG_SOFTWARE;
293  DAC_InitStruct->WaveAutoGeneration = LL_DAC_WAVE_AUTO_GENERATION_NONE;
294  /* Note: Parameter discarded if wave auto generation is disabled, */
295  /* set anyway to its default value. */
296  DAC_InitStruct->WaveAutoGenerationConfig = LL_DAC_NOISE_LFSR_UNMASK_BIT0;
297  DAC_InitStruct->OutputBuffer = LL_DAC_OUTPUT_BUFFER_ENABLE;
298  DAC_InitStruct->OutputConnection = LL_DAC_OUTPUT_CONNECT_GPIO;
299  DAC_InitStruct->OutputMode = LL_DAC_OUTPUT_MODE_NORMAL;
300 }
301 
314 #endif /* DAC1 */
315 
320 #endif /* USE_FULL_LL_DRIVER */
321 
322 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
LL_DAC_InitTypeDef
Structure definition of some features of DAC instance.
Definition: stm32l4xx_ll_dac.h:152
stm32l4xx_ll_dac.h
Header file of DAC LL module.
LL_DAC_StructInit
void LL_DAC_StructInit(LL_DAC_InitTypeDef *DAC_InitStruct)
Set each LL_DAC_InitTypeDef field to default value.
Definition: stm32l4xx_ll_dac.c:289
LL_DAC_DeInit
ErrorStatus LL_DAC_DeInit(DAC_TypeDef *DACx)
De-initialize registers of the selected DAC instance to their default reset values.
Definition: stm32l4xx_ll_dac.c:167
LL_APB1_GRP1_ReleaseReset
__STATIC_INLINE void LL_APB1_GRP1_ReleaseReset(uint32_t Periphs)
Release APB1 peripherals reset. APB1RSTR1 TIM2RST LL_APB1_GRP1_ReleaseReset APB1RSTR1 TIM3RST LL_AP...
Definition: stm32l4xx_ll_bus.h:1425
LL_DAC_InitTypeDef::TriggerSource
uint32_t TriggerSource
Definition: stm32l4xx_ll_dac.h:154
LL_DAC_InitTypeDef::WaveAutoGeneration
uint32_t WaveAutoGeneration
Definition: stm32l4xx_ll_dac.h:159
stm32l4xx_ll_bus.h
Header file of BUS LL module.
LL_DAC_InitTypeDef::OutputMode
uint32_t OutputMode
Definition: stm32l4xx_ll_dac.h:182
LL_DAC_InitTypeDef::OutputBuffer
uint32_t OutputBuffer
Definition: stm32l4xx_ll_dac.h:172
LL_APB1_GRP1_ForceReset
__STATIC_INLINE void LL_APB1_GRP1_ForceReset(uint32_t Periphs)
Force APB1 peripherals reset. APB1RSTR1 TIM2RST LL_APB1_GRP1_ForceReset APB1RSTR1 TIM3RST LL_APB1_G...
Definition: stm32l4xx_ll_bus.h:1343
LL_DAC_Init
ErrorStatus LL_DAC_Init(DAC_TypeDef *DACx, uint32_t DAC_Channel, LL_DAC_InitTypeDef *DAC_InitStruct)
Initialize some features of DAC channel.
Definition: stm32l4xx_ll_dac.c:209
LL_DAC_InitTypeDef::WaveAutoGenerationConfig
uint32_t WaveAutoGenerationConfig
Definition: stm32l4xx_ll_dac.h:164
LL_DAC_InitTypeDef::OutputConnection
uint32_t OutputConnection
Definition: stm32l4xx_ll_dac.h:177
MODIFY_REG
MODIFY_REG(hrtc->Instance->CR, RTC_CR_WUCKSEL,(uint32_t) WakeUpClock)
assert_param
assert_param(IS_RTC_WAKEUP_CLOCK(WakeUpClock))
LL_DAC_IsEnabled
__STATIC_INLINE uint32_t LL_DAC_IsEnabled(DAC_TypeDef *DACx, uint32_t DAC_Channel)
Get DAC enable state of the selected channel. (0: DAC channel is disabled, 1: DAC channel is enabled)...
Definition: stm32l4xx_ll_dac.h:1497