source: trunk/firmware/Drivers/STM32G0xx_HAL_Driver/Src/stm32g0xx_ll_dac.c

Last change on this file was 6, checked in by f.jahn, 8 months ago
File size: 13.2 KB
Line 
1/**
2 ******************************************************************************
3 * @file stm32g0xx_ll_dac.c
4 * @author MCD Application Team
5 * @brief DAC LL module driver
6 ******************************************************************************
7 * @attention
8 *
9 * <h2><center>&copy; Copyright (c) 2018 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 "stm32g0xx_ll_dac.h"
23#include "stm32g0xx_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 STM32G0xx_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#define IS_LL_DAC_CHANNEL(__DAC_CHANNEL__) \
50 ( \
51 ((__DAC_CHANNEL__) == LL_DAC_CHANNEL_1) \
52 || ((__DAC_CHANNEL__) == LL_DAC_CHANNEL_2) \
53 )
54
55#define IS_LL_DAC_TRIGGER_SOURCE(__TRIGGER_SOURCE__) \
56 ( ((__TRIGGER_SOURCE__) == LL_DAC_TRIG_SOFTWARE) \
57 || ((__TRIGGER_SOURCE__) == LL_DAC_TRIG_EXT_TIM1_TRGO) \
58 || ((__TRIGGER_SOURCE__) == LL_DAC_TRIG_EXT_TIM2_TRGO) \
59 || ((__TRIGGER_SOURCE__) == LL_DAC_TRIG_EXT_TIM3_TRGO) \
60 || ((__TRIGGER_SOURCE__) == LL_DAC_TRIG_EXT_TIM6_TRGO) \
61 || ((__TRIGGER_SOURCE__) == LL_DAC_TRIG_EXT_TIM7_TRGO) \
62 || ((__TRIGGER_SOURCE__) == LL_DAC_TRIG_EXT_TIM15_TRGO) \
63 || ((__TRIGGER_SOURCE__) == LL_DAC_TRIG_EXT_LPTIM1_OUT) \
64 || ((__TRIGGER_SOURCE__) == LL_DAC_TRIG_EXT_LPTIM2_OUT) \
65 || ((__TRIGGER_SOURCE__) == LL_DAC_TRIG_EXT_EXTI_LINE9) \
66 )
67
68#define IS_LL_DAC_WAVE_AUTO_GENER_MODE(__WAVE_AUTO_GENERATION_MODE__) \
69 ( ((__WAVE_AUTO_GENERATION_MODE__) == LL_DAC_WAVE_AUTO_GENERATION_NONE) \
70 || ((__WAVE_AUTO_GENERATION_MODE__) == LL_DAC_WAVE_AUTO_GENERATION_NOISE) \
71 || ((__WAVE_AUTO_GENERATION_MODE__) == LL_DAC_WAVE_AUTO_GENERATION_TRIANGLE) \
72 )
73
74#define IS_LL_DAC_WAVE_AUTO_GENER_CONFIG(__WAVE_AUTO_GENERATION_MODE__, __WAVE_AUTO_GENERATION_CONFIG__) \
75 ( (((__WAVE_AUTO_GENERATION_MODE__) == LL_DAC_WAVE_AUTO_GENERATION_NOISE) \
76 && ( ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_NOISE_LFSR_UNMASK_BIT0) \
77 || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_NOISE_LFSR_UNMASK_BITS1_0) \
78 || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_NOISE_LFSR_UNMASK_BITS2_0) \
79 || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_NOISE_LFSR_UNMASK_BITS3_0) \
80 || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_NOISE_LFSR_UNMASK_BITS4_0) \
81 || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_NOISE_LFSR_UNMASK_BITS5_0) \
82 || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_NOISE_LFSR_UNMASK_BITS6_0) \
83 || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_NOISE_LFSR_UNMASK_BITS7_0) \
84 || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_NOISE_LFSR_UNMASK_BITS8_0) \
85 || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_NOISE_LFSR_UNMASK_BITS9_0) \
86 || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_NOISE_LFSR_UNMASK_BITS10_0) \
87 || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_NOISE_LFSR_UNMASK_BITS11_0)) \
88 ) \
89 ||(((__WAVE_AUTO_GENERATION_MODE__) == LL_DAC_WAVE_AUTO_GENERATION_TRIANGLE) \
90 && ( ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_TRIANGLE_AMPLITUDE_1) \
91 || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_TRIANGLE_AMPLITUDE_3) \
92 || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_TRIANGLE_AMPLITUDE_7) \
93 || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_TRIANGLE_AMPLITUDE_15) \
94 || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_TRIANGLE_AMPLITUDE_31) \
95 || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_TRIANGLE_AMPLITUDE_63) \
96 || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_TRIANGLE_AMPLITUDE_127) \
97 || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_TRIANGLE_AMPLITUDE_255) \
98 || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_TRIANGLE_AMPLITUDE_511) \
99 || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_TRIANGLE_AMPLITUDE_1023) \
100 || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_TRIANGLE_AMPLITUDE_2047) \
101 || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_TRIANGLE_AMPLITUDE_4095)) \
102 ) \
103 )
104
105#define IS_LL_DAC_OUTPUT_BUFFER(__OUTPUT_BUFFER__) \
106 ( ((__OUTPUT_BUFFER__) == LL_DAC_OUTPUT_BUFFER_ENABLE) \
107 || ((__OUTPUT_BUFFER__) == LL_DAC_OUTPUT_BUFFER_DISABLE) \
108 )
109
110#define IS_LL_DAC_OUTPUT_CONNECTION(__OUTPUT_CONNECTION__) \
111 ( ((__OUTPUT_CONNECTION__) == LL_DAC_OUTPUT_CONNECT_GPIO) \
112 || ((__OUTPUT_CONNECTION__) == LL_DAC_OUTPUT_CONNECT_INTERNAL) \
113 )
114
115#define IS_LL_DAC_OUTPUT_MODE(__OUTPUT_MODE__) \
116 ( ((__OUTPUT_MODE__) == LL_DAC_OUTPUT_MODE_NORMAL) \
117 || ((__OUTPUT_MODE__) == LL_DAC_OUTPUT_MODE_SAMPLE_AND_HOLD) \
118 )
119
120/**
121 * @}
122 */
123
124
125/* Private function prototypes -----------------------------------------------*/
126
127/* Exported functions --------------------------------------------------------*/
128/** @addtogroup DAC_LL_Exported_Functions
129 * @{
130 */
131
132/** @addtogroup DAC_LL_EF_Init
133 * @{
134 */
135
136/**
137 * @brief De-initialize registers of the selected DAC instance
138 * to their default reset values.
139 * @param DACx DAC instance
140 * @retval An ErrorStatus enumeration value:
141 * - SUCCESS: DAC registers are de-initialized
142 * - ERROR: not applicable
143 */
144ErrorStatus LL_DAC_DeInit(DAC_TypeDef *DACx)
145{
146 /* Check the parameters */
147 assert_param(IS_DAC_ALL_INSTANCE(DACx));
148
149 /* Force reset of DAC clock */
150 LL_APB1_GRP1_ForceReset(LL_APB1_GRP1_PERIPH_DAC1);
151
152 /* Release reset of DAC clock */
153 LL_APB1_GRP1_ReleaseReset(LL_APB1_GRP1_PERIPH_DAC1);
154
155 return SUCCESS;
156}
157
158/**
159 * @brief Initialize some features of DAC channel.
160 * @note @ref LL_DAC_Init() aims to ease basic configuration of a DAC channel.
161 * Leaving it ready to be enabled and output:
162 * a level by calling one of
163 * @ref LL_DAC_ConvertData12RightAligned
164 * @ref LL_DAC_ConvertData12LeftAligned
165 * @ref LL_DAC_ConvertData8RightAligned
166 * or one of the supported autogenerated wave.
167 * @note This function allows configuration of:
168 * - Output mode
169 * - Trigger
170 * - Wave generation
171 * @note The setting of these parameters by function @ref LL_DAC_Init()
172 * is conditioned to DAC state:
173 * DAC channel must be disabled.
174 * @param DACx DAC instance
175 * @param DAC_Channel This parameter can be one of the following values:
176 * @arg @ref LL_DAC_CHANNEL_1
177 * @arg @ref LL_DAC_CHANNEL_2
178 * @param DAC_InitStruct Pointer to a @ref LL_DAC_InitTypeDef structure
179 * @retval An ErrorStatus enumeration value:
180 * - SUCCESS: DAC registers are initialized
181 * - ERROR: DAC registers are not initialized
182 */
183ErrorStatus LL_DAC_Init(DAC_TypeDef *DACx, uint32_t DAC_Channel, LL_DAC_InitTypeDef *DAC_InitStruct)
184{
185 ErrorStatus status = SUCCESS;
186
187 /* Check the parameters */
188 assert_param(IS_DAC_ALL_INSTANCE(DACx));
189 assert_param(IS_LL_DAC_CHANNEL(DAC_Channel));
190 assert_param(IS_LL_DAC_TRIGGER_SOURCE(DAC_InitStruct->TriggerSource));
191 assert_param(IS_LL_DAC_OUTPUT_BUFFER(DAC_InitStruct->OutputBuffer));
192 assert_param(IS_LL_DAC_OUTPUT_CONNECTION(DAC_InitStruct->OutputConnection));
193 assert_param(IS_LL_DAC_OUTPUT_MODE(DAC_InitStruct->OutputMode));
194 assert_param(IS_LL_DAC_WAVE_AUTO_GENER_MODE(DAC_InitStruct->WaveAutoGeneration));
195 if (DAC_InitStruct->WaveAutoGeneration != LL_DAC_WAVE_AUTO_GENERATION_NONE)
196 {
197 assert_param(IS_LL_DAC_WAVE_AUTO_GENER_CONFIG(DAC_InitStruct->WaveAutoGeneration,
198 DAC_InitStruct->WaveAutoGenerationConfig));
199 }
200
201 /* Note: Hardware constraint (refer to description of this function) */
202 /* DAC instance must be disabled. */
203 if (LL_DAC_IsEnabled(DACx, DAC_Channel) == 0U)
204 {
205 /* Configuration of DAC channel: */
206 /* - TriggerSource */
207 /* - WaveAutoGeneration */
208 /* - OutputBuffer */
209 /* - OutputConnection */
210 /* - OutputMode */
211 if (DAC_InitStruct->WaveAutoGeneration != LL_DAC_WAVE_AUTO_GENERATION_NONE)
212 {
213 MODIFY_REG(DACx->CR,
214 (DAC_CR_TSEL1
215 | DAC_CR_WAVE1
216 | DAC_CR_MAMP1
217 ) << (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK)
218 ,
219 (DAC_InitStruct->TriggerSource
220 | DAC_InitStruct->WaveAutoGeneration
221 | DAC_InitStruct->WaveAutoGenerationConfig
222 ) << (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK)
223 );
224 }
225 else
226 {
227 MODIFY_REG(DACx->CR,
228 (DAC_CR_TSEL1
229 | DAC_CR_WAVE1
230 ) << (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK)
231 ,
232 (DAC_InitStruct->TriggerSource
233 | LL_DAC_WAVE_AUTO_GENERATION_NONE
234 ) << (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK)
235 );
236 }
237 MODIFY_REG(DACx->MCR,
238 (DAC_MCR_MODE1_1
239 | DAC_MCR_MODE1_0
240 | DAC_MCR_MODE1_2
241 ) << (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK)
242 ,
243 (DAC_InitStruct->OutputBuffer
244 | DAC_InitStruct->OutputConnection
245 | DAC_InitStruct->OutputMode
246 ) << (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK)
247 );
248 }
249 else
250 {
251 /* Initialization error: DAC instance is not disabled. */
252 status = ERROR;
253 }
254 return status;
255}
256
257/**
258 * @brief Set each @ref LL_DAC_InitTypeDef field to default value.
259 * @param DAC_InitStruct pointer to a @ref LL_DAC_InitTypeDef structure
260 * whose fields will be set to default values.
261 * @retval None
262 */
263void LL_DAC_StructInit(LL_DAC_InitTypeDef *DAC_InitStruct)
264{
265 /* Set DAC_InitStruct fields to default values */
266 DAC_InitStruct->TriggerSource = LL_DAC_TRIG_SOFTWARE;
267 DAC_InitStruct->WaveAutoGeneration = LL_DAC_WAVE_AUTO_GENERATION_NONE;
268 /* Note: Parameter discarded if wave auto generation is disabled, */
269 /* set anyway to its default value. */
270 DAC_InitStruct->WaveAutoGenerationConfig = LL_DAC_NOISE_LFSR_UNMASK_BIT0;
271 DAC_InitStruct->OutputBuffer = LL_DAC_OUTPUT_BUFFER_ENABLE;
272 DAC_InitStruct->OutputConnection = LL_DAC_OUTPUT_CONNECT_GPIO;
273 DAC_InitStruct->OutputMode = LL_DAC_OUTPUT_MODE_NORMAL;
274}
275
276/**
277 * @}
278 */
279
280/**
281 * @}
282 */
283
284/**
285 * @}
286 */
287
288#endif /* DAC1 */
289
290/**
291 * @}
292 */
293
294#endif /* USE_FULL_LL_DRIVER */
295
296/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
Note: See TracBrowser for help on using the repository browser.