Context Navigation

stm32g0xx_ll_dac.c

Last change on this file was 6, checked in by f.jahn, 3 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>© 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	*/
144	ErrorStatus 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	*/
183	ErrorStatus 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	*/
263	void 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.

Context Navigation

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

Download in other formats: