1 /**
2   ******************************************************************************
3   * @file    stm32l0xx_ll_dac.c
4   * @author  MCD Application Team
5   * @brief   DAC LL module driver
6   ******************************************************************************
7   * @attention
8   *
9   * Copyright (c) 2016 STMicroelectronics.
10   * All rights reserved.
11   *
12   * This software is licensed under terms that can be found in the LICENSE file
13   * in the root directory of this software component.
14   * If no LICENSE file comes with this software, it is provided AS-IS.
15   *
16   ******************************************************************************
17   */
18 #if defined(USE_FULL_LL_DRIVER)
19 
20 /* Includes ------------------------------------------------------------------*/
21 #include "stm32l0xx_ll_dac.h"
22 #include "stm32l0xx_ll_bus.h"
23 
24 #ifdef USE_FULL_ASSERT
25   #include "stm32_assert.h"
26 #else
27   #define assert_param(expr) ((void)0U)
28 #endif
29 
30 /** @addtogroup STM32L0xx_LL_Driver
31   * @{
32   */
33 
34 #if defined (DAC1)
35 
36 /** @addtogroup DAC_LL DAC
37   * @{
38   */
39 
40 /* Private types -------------------------------------------------------------*/
41 /* Private variables ---------------------------------------------------------*/
42 /* Private constants ---------------------------------------------------------*/
43 /* Private macros ------------------------------------------------------------*/
44 
45 /** @addtogroup DAC_LL_Private_Macros
46   * @{
47   */
48 
49 #if defined(DAC_CHANNEL2_SUPPORT)
50 #define IS_LL_DAC_CHANNEL(__DACX__, __DAC_CHANNEL__)                           \
51   (                                                                            \
52       ((__DAC_CHANNEL__) == LL_DAC_CHANNEL_1)                                  \
53    || ((__DAC_CHANNEL__) == LL_DAC_CHANNEL_2)                                  \
54   )
55 #else
56 #define IS_LL_DAC_CHANNEL(__DACX__, __DAC_CHANNEL__)                           \
57   (                                                                            \
58    ((__DAC_CHANNEL__) == LL_DAC_CHANNEL_1)                                     \
59   )
60 #endif /* DAC_CHANNEL2_SUPPORT */
61 
62 #define IS_LL_DAC_TRIGGER_SOURCE(__TRIGGER_SOURCE__)                           \
63   (   ((__TRIGGER_SOURCE__) == LL_DAC_TRIG_SOFTWARE)                           \
64    || ((__TRIGGER_SOURCE__) == LL_DAC_TRIG_EXT_TIM2_TRGO)                      \
65    || ((__TRIGGER_SOURCE__) == LL_DAC_TRIG_EXT_TIM3_TRGO)                      \
66    || ((__TRIGGER_SOURCE__) == LL_DAC_TRIG_EXT_TIM3_CH3)                       \
67    || ((__TRIGGER_SOURCE__) == LL_DAC_TRIG_EXT_TIM6_TRGO)                      \
68    || ((__TRIGGER_SOURCE__) == LL_DAC_TRIG_EXT_TIM7_TRGO)                      \
69    || ((__TRIGGER_SOURCE__) == LL_DAC_TRIG_EXT_TIM21_TRGO)                     \
70    || ((__TRIGGER_SOURCE__) == LL_DAC_TRIG_EXT_EXTI_LINE9)                     \
71   )
72 
73 #define IS_LL_DAC_WAVE_AUTO_GENER_MODE(__WAVE_AUTO_GENERATION_MODE__)           \
74   (   ((__WAVE_AUTO_GENERATION_MODE__) == LL_DAC_WAVE_AUTO_GENERATION_NONE)     \
75    || ((__WAVE_AUTO_GENERATION_MODE__) == LL_DAC_WAVE_AUTO_GENERATION_NOISE)    \
76    || ((__WAVE_AUTO_GENERATION_MODE__) == LL_DAC_WAVE_AUTO_GENERATION_TRIANGLE) \
77   )
78 
79 #define IS_LL_DAC_WAVE_AUTO_GENER_CONFIG(__WAVE_AUTO_GENERATION_CONFIG__)      \
80   (   ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_NOISE_LFSR_UNMASK_BIT0)     \
81    || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_NOISE_LFSR_UNMASK_BITS1_0)  \
82    || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_NOISE_LFSR_UNMASK_BITS2_0)  \
83    || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_NOISE_LFSR_UNMASK_BITS3_0)  \
84    || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_NOISE_LFSR_UNMASK_BITS4_0)  \
85    || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_NOISE_LFSR_UNMASK_BITS5_0)  \
86    || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_NOISE_LFSR_UNMASK_BITS6_0)  \
87    || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_NOISE_LFSR_UNMASK_BITS7_0)  \
88    || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_NOISE_LFSR_UNMASK_BITS8_0)  \
89    || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_NOISE_LFSR_UNMASK_BITS9_0)  \
90    || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_NOISE_LFSR_UNMASK_BITS10_0) \
91    || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_NOISE_LFSR_UNMASK_BITS11_0) \
92    || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_TRIANGLE_AMPLITUDE_1)       \
93    || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_TRIANGLE_AMPLITUDE_3)       \
94    || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_TRIANGLE_AMPLITUDE_7)       \
95    || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_TRIANGLE_AMPLITUDE_15)      \
96    || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_TRIANGLE_AMPLITUDE_31)      \
97    || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_TRIANGLE_AMPLITUDE_63)      \
98    || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_TRIANGLE_AMPLITUDE_127)     \
99    || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_TRIANGLE_AMPLITUDE_255)     \
100    || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_TRIANGLE_AMPLITUDE_511)     \
101    || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_TRIANGLE_AMPLITUDE_1023)    \
102    || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_TRIANGLE_AMPLITUDE_2047)    \
103    || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_TRIANGLE_AMPLITUDE_4095)    \
104   )
105 
106 #define IS_LL_DAC_OUTPUT_BUFFER(__OUTPUT_BUFFER__)                             \
107   (   ((__OUTPUT_BUFFER__) == LL_DAC_OUTPUT_BUFFER_ENABLE)                     \
108    || ((__OUTPUT_BUFFER__) == LL_DAC_OUTPUT_BUFFER_DISABLE)                    \
109   )
110 
111 /**
112   * @}
113   */
114 
115 
116 /* Private function prototypes -----------------------------------------------*/
117 
118 /* Exported functions --------------------------------------------------------*/
119 /** @addtogroup DAC_LL_Exported_Functions
120   * @{
121   */
122 
123 /** @addtogroup DAC_LL_EF_Init
124   * @{
125   */
126 
127 /**
128   * @brief  De-initialize registers of the selected DAC instance
129   *         to their default reset values.
130   * @param  DACx DAC instance
131   * @retval An ErrorStatus enumeration value:
132   *          - SUCCESS: DAC registers are de-initialized
133   *          - ERROR: not applicable
134   */
LL_DAC_DeInit(DAC_TypeDef * DACx)135 ErrorStatus LL_DAC_DeInit(DAC_TypeDef *DACx)
136 {
137   /* Check the parameters */
138   assert_param(IS_DAC_ALL_INSTANCE(DACx));
139 
140   /* Force reset of DAC clock */
141   LL_APB1_GRP1_ForceReset(LL_APB1_GRP1_PERIPH_DAC1);
142 
143   /* Release reset of DAC clock */
144   LL_APB1_GRP1_ReleaseReset(LL_APB1_GRP1_PERIPH_DAC1);
145 
146   return SUCCESS;
147 }
148 
149 /**
150   * @brief  Initialize some features of DAC instance.
151   * @note   The setting of these parameters by function @ref LL_DAC_Init()
152   *         is conditioned to DAC state:
153   *         DAC instance must be disabled.
154   * @param  DACx DAC instance
155   * @param  DAC_Channel This parameter can be one of the following values:
156   *         @arg @ref LL_DAC_CHANNEL_1
157   *         @arg @ref LL_DAC_CHANNEL_2 (1)
158   *
159   *         (1) On this STM32 series, parameter not available on all devices.
160   *             Refer to device datasheet for channels availability.
161   * @param  DAC_InitStruct Pointer to a @ref LL_DAC_InitTypeDef structure
162   * @retval An ErrorStatus enumeration value:
163   *          - SUCCESS: DAC registers are initialized
164   *          - ERROR: DAC registers are not initialized
165   */
LL_DAC_Init(DAC_TypeDef * DACx,uint32_t DAC_Channel,LL_DAC_InitTypeDef * DAC_InitStruct)166 ErrorStatus LL_DAC_Init(DAC_TypeDef *DACx, uint32_t DAC_Channel, LL_DAC_InitTypeDef *DAC_InitStruct)
167 {
168   ErrorStatus status = SUCCESS;
169 
170   /* Check the parameters */
171   assert_param(IS_DAC_ALL_INSTANCE(DACx));
172   assert_param(IS_LL_DAC_CHANNEL(DACx, DAC_Channel));
173   assert_param(IS_LL_DAC_TRIGGER_SOURCE(DAC_InitStruct->TriggerSource));
174   assert_param(IS_LL_DAC_OUTPUT_BUFFER(DAC_InitStruct->OutputBuffer));
175   assert_param(IS_LL_DAC_WAVE_AUTO_GENER_MODE(DAC_InitStruct->WaveAutoGeneration));
176   if (DAC_InitStruct->WaveAutoGeneration != LL_DAC_WAVE_AUTO_GENERATION_NONE)
177   {
178     assert_param(IS_LL_DAC_WAVE_AUTO_GENER_CONFIG(DAC_InitStruct->WaveAutoGenerationConfig));
179   }
180 
181   /* Note: Hardware constraint (refer to description of this function)        */
182   /*       DAC instance must be disabled.                                     */
183   if(LL_DAC_IsEnabled(DACx, DAC_Channel) == 0U)
184   {
185     /* Configuration of DAC channel:                                          */
186     /*  - TriggerSource                                                       */
187     /*  - WaveAutoGeneration                                                  */
188     /*  - OutputBuffer                                                        */
189     if (DAC_InitStruct->WaveAutoGeneration != LL_DAC_WAVE_AUTO_GENERATION_NONE)
190     {
191       MODIFY_REG(DACx->CR,
192                  (  DAC_CR_TSEL1
193                   | DAC_CR_WAVE1
194                   | DAC_CR_MAMP1
195                   | DAC_CR_BOFF1
196                  ) << (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK)
197                 ,
198                  (  DAC_InitStruct->TriggerSource
199                   | DAC_InitStruct->WaveAutoGeneration
200                   | DAC_InitStruct->WaveAutoGenerationConfig
201                   | DAC_InitStruct->OutputBuffer
202                  ) << (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK)
203                 );
204     }
205     else
206     {
207       MODIFY_REG(DACx->CR,
208                  (  DAC_CR_TSEL1
209                   | DAC_CR_WAVE1
210                   | DAC_CR_BOFF1
211                  ) << (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK)
212                 ,
213                  (  DAC_InitStruct->TriggerSource
214                   | LL_DAC_WAVE_AUTO_GENERATION_NONE
215                   | DAC_InitStruct->OutputBuffer
216                  ) << (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK)
217                 );
218     }
219   }
220   else
221   {
222     /* Initialization error: DAC instance is not disabled.                    */
223     status = ERROR;
224   }
225   return status;
226 }
227 
228 /**
229   * @brief Set each @ref LL_DAC_InitTypeDef field to default value.
230   * @param DAC_InitStruct pointer to a @ref LL_DAC_InitTypeDef structure
231   *                       whose fields will be set to default values.
232   * @retval None
233   */
LL_DAC_StructInit(LL_DAC_InitTypeDef * DAC_InitStruct)234 void LL_DAC_StructInit(LL_DAC_InitTypeDef *DAC_InitStruct)
235 {
236   /* Set DAC_InitStruct fields to default values */
237   DAC_InitStruct->TriggerSource            = LL_DAC_TRIG_SOFTWARE;
238   DAC_InitStruct->WaveAutoGeneration       = LL_DAC_WAVE_AUTO_GENERATION_NONE;
239   /* Note: Parameter discarded if wave auto generation is disabled,           */
240   /*       set anyway to its default value.                                   */
241   DAC_InitStruct->WaveAutoGenerationConfig = LL_DAC_NOISE_LFSR_UNMASK_BIT0;
242   DAC_InitStruct->OutputBuffer             = LL_DAC_OUTPUT_BUFFER_ENABLE;
243 }
244 
245 /**
246   * @}
247   */
248 
249 /**
250   * @}
251   */
252 
253 /**
254   * @}
255   */
256 
257 #endif /* DAC1 */
258 
259 /**
260   * @}
261   */
262 
263 #endif /* USE_FULL_LL_DRIVER */
264 
265