1 /**
2 ******************************************************************************
3 * @file stm32l4xx_ll_dac.c
4 * @author MCD Application Team
5 * @brief DAC LL module driver
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 #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
31 /** @addtogroup STM32L4xx_LL_Driver
32 * @{
33 */
34
35 #if defined (DAC1)
36
37 /** @addtogroup DAC_LL DAC
38 * @{
39 */
40
41 /* Private types -------------------------------------------------------------*/
42 /* Private variables ---------------------------------------------------------*/
43 /* Private constants ---------------------------------------------------------*/
44 /* Private macros ------------------------------------------------------------*/
45
46 /** @addtogroup DAC_LL_Private_Macros
47 * @{
48 */
49
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
143 /**
144 * @}
145 */
146
147
148 /* Private function prototypes -----------------------------------------------*/
149
150 /* Exported functions --------------------------------------------------------*/
151 /** @addtogroup DAC_LL_Exported_Functions
152 * @{
153 */
154
155 /** @addtogroup DAC_LL_EF_Init
156 * @{
157 */
158
159 /**
160 * @brief De-initialize registers of the selected DAC instance
161 * to their default reset values.
162 * @param DACx DAC instance
163 * @retval An ErrorStatus enumeration value:
164 * - SUCCESS: DAC registers are de-initialized
165 * - ERROR: not applicable
166 */
LL_DAC_DeInit(DAC_TypeDef * DACx)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
181 /**
182 * @brief Initialize some features of DAC channel.
183 * @note @ref LL_DAC_Init() aims to ease basic configuration of a DAC channel.
184 * Leaving it ready to be enabled and output:
185 * a level by calling one of
186 * @ref LL_DAC_ConvertData12RightAligned
187 * @ref LL_DAC_ConvertData12LeftAligned
188 * @ref LL_DAC_ConvertData8RightAligned
189 * or one of the supported autogenerated wave.
190 * @note This function allows configuration of:
191 * - Output mode
192 * - Trigger
193 * - Wave generation
194 * @note The setting of these parameters by function @ref LL_DAC_Init()
195 * is conditioned to DAC state:
196 * DAC channel must be disabled.
197 * @param DACx DAC instance
198 * @param DAC_Channel This parameter can be one of the following values:
199 * @arg @ref LL_DAC_CHANNEL_1
200 * @arg @ref LL_DAC_CHANNEL_2 (1)
201 *
202 * (1) On this STM32 serie, parameter not available on all devices.
203 * Refer to device datasheet for channels availability.
204 * @param DAC_InitStruct Pointer to a @ref LL_DAC_InitTypeDef structure
205 * @retval An ErrorStatus enumeration value:
206 * - SUCCESS: DAC registers are initialized
207 * - ERROR: DAC registers are not initialized
208 */
LL_DAC_Init(DAC_TypeDef * DACx,uint32_t DAC_Channel,LL_DAC_InitTypeDef * DAC_InitStruct)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
283 /**
284 * @brief Set each @ref LL_DAC_InitTypeDef field to default value.
285 * @param DAC_InitStruct pointer to a @ref LL_DAC_InitTypeDef structure
286 * whose fields will be set to default values.
287 * @retval None
288 */
LL_DAC_StructInit(LL_DAC_InitTypeDef * DAC_InitStruct)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
302 /**
303 * @}
304 */
305
306 /**
307 * @}
308 */
309
310 /**
311 * @}
312 */
313
314 #endif /* DAC1 */
315
316 /**
317 * @}
318 */
319
320 #endif /* USE_FULL_LL_DRIVER */
321
322 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
323