1 /**
2   ******************************************************************************
3   * @file    stm32l1xx_hal_dac_ex.h
4   * @author  MCD Application Team
5   * @brief   Header file of DAC HAL Extended module.
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 
19 /* Define to prevent recursive inclusion -------------------------------------*/
20 #ifndef STM32L1xx_HAL_DAC_EX_H
21 #define STM32L1xx_HAL_DAC_EX_H
22 
23 #ifdef __cplusplus
24 extern "C" {
25 #endif
26 
27 /** @addtogroup STM32L1xx_HAL_Driver
28   * @{
29   */
30 
31 /* Includes ------------------------------------------------------------------*/
32 #include "stm32l1xx_hal_def.h"
33 
34 #if defined(DAC1)
35 
36 /** @addtogroup DACEx
37   * @{
38   */
39 
40 /* Exported types ------------------------------------------------------------*/
41 
42 /**
43   * @brief  HAL State structures definition
44   */
45 
46 /* Exported constants --------------------------------------------------------*/
47 
48 /** @defgroup DACEx_Exported_Constants DACEx Exported Constants
49   * @{
50   */
51 
52 /** @defgroup DACEx_lfsrunmask_triangleamplitude DACEx lfsrunmask triangle amplitude
53   * @{
54   */
55 #define DAC_LFSRUNMASK_BIT0                0x00000000UL                                                        /*!< Unmask DAC channel LFSR bit0 for noise wave generation */
56 #define DAC_LFSRUNMASK_BITS1_0             (                                                   DAC_CR_MAMP1_0) /*!< Unmask DAC channel LFSR bit[1:0] for noise wave generation */
57 #define DAC_LFSRUNMASK_BITS2_0             (                                  DAC_CR_MAMP1_1                 ) /*!< Unmask DAC channel LFSR bit[2:0] for noise wave generation */
58 #define DAC_LFSRUNMASK_BITS3_0             (                                  DAC_CR_MAMP1_1 | DAC_CR_MAMP1_0) /*!< Unmask DAC channel LFSR bit[3:0] for noise wave generation */
59 #define DAC_LFSRUNMASK_BITS4_0             (                 DAC_CR_MAMP1_2                                  ) /*!< Unmask DAC channel LFSR bit[4:0] for noise wave generation */
60 #define DAC_LFSRUNMASK_BITS5_0             (                 DAC_CR_MAMP1_2                  | DAC_CR_MAMP1_0) /*!< Unmask DAC channel LFSR bit[5:0] for noise wave generation */
61 #define DAC_LFSRUNMASK_BITS6_0             (                 DAC_CR_MAMP1_2 | DAC_CR_MAMP1_1                 ) /*!< Unmask DAC channel LFSR bit[6:0] for noise wave generation */
62 #define DAC_LFSRUNMASK_BITS7_0             (                 DAC_CR_MAMP1_2 | DAC_CR_MAMP1_1 | DAC_CR_MAMP1_0) /*!< Unmask DAC channel LFSR bit[7:0] for noise wave generation */
63 #define DAC_LFSRUNMASK_BITS8_0             (DAC_CR_MAMP1_3                                                   ) /*!< Unmask DAC channel LFSR bit[8:0] for noise wave generation */
64 #define DAC_LFSRUNMASK_BITS9_0             (DAC_CR_MAMP1_3                                   | DAC_CR_MAMP1_0) /*!< Unmask DAC channel LFSR bit[9:0] for noise wave generation */
65 #define DAC_LFSRUNMASK_BITS10_0            (DAC_CR_MAMP1_3                  | DAC_CR_MAMP1_1                 ) /*!< Unmask DAC channel LFSR bit[10:0] for noise wave generation */
66 #define DAC_LFSRUNMASK_BITS11_0            (DAC_CR_MAMP1_3                  | DAC_CR_MAMP1_1 | DAC_CR_MAMP1_0) /*!< Unmask DAC channel LFSR bit[11:0] for noise wave generation */
67 #define DAC_TRIANGLEAMPLITUDE_1            0x00000000UL                                                        /*!< Select max triangle amplitude of 1 */
68 #define DAC_TRIANGLEAMPLITUDE_3            (                                                   DAC_CR_MAMP1_0) /*!< Select max triangle amplitude of 3 */
69 #define DAC_TRIANGLEAMPLITUDE_7            (                                  DAC_CR_MAMP1_1                 ) /*!< Select max triangle amplitude of 7 */
70 #define DAC_TRIANGLEAMPLITUDE_15           (                                  DAC_CR_MAMP1_1 | DAC_CR_MAMP1_0) /*!< Select max triangle amplitude of 15 */
71 #define DAC_TRIANGLEAMPLITUDE_31           (                 DAC_CR_MAMP1_2                                  ) /*!< Select max triangle amplitude of 31 */
72 #define DAC_TRIANGLEAMPLITUDE_63           (                 DAC_CR_MAMP1_2                  | DAC_CR_MAMP1_0) /*!< Select max triangle amplitude of 63 */
73 #define DAC_TRIANGLEAMPLITUDE_127          (                 DAC_CR_MAMP1_2 | DAC_CR_MAMP1_1                 ) /*!< Select max triangle amplitude of 127 */
74 #define DAC_TRIANGLEAMPLITUDE_255          (                 DAC_CR_MAMP1_2 | DAC_CR_MAMP1_1 | DAC_CR_MAMP1_0) /*!< Select max triangle amplitude of 255 */
75 #define DAC_TRIANGLEAMPLITUDE_511          (DAC_CR_MAMP1_3                                                   ) /*!< Select max triangle amplitude of 511 */
76 #define DAC_TRIANGLEAMPLITUDE_1023         (DAC_CR_MAMP1_3                                   | DAC_CR_MAMP1_0) /*!< Select max triangle amplitude of 1023 */
77 #define DAC_TRIANGLEAMPLITUDE_2047         (DAC_CR_MAMP1_3                  | DAC_CR_MAMP1_1                 ) /*!< Select max triangle amplitude of 2047 */
78 #define DAC_TRIANGLEAMPLITUDE_4095         (DAC_CR_MAMP1_3                  | DAC_CR_MAMP1_1 | DAC_CR_MAMP1_0) /*!< Select max triangle amplitude of 4095 */
79 
80 /**
81   * @}
82   */
83 
84 
85 /**
86   * @}
87   */
88 
89 /* Exported macro ------------------------------------------------------------*/
90 
91 
92 /* Private macro -------------------------------------------------------------*/
93 
94 /** @defgroup DACEx_Private_Macros DACEx Private Macros
95   * @{
96   */
97 #define IS_DAC_TRIGGER(TRIGGER) (((TRIGGER) == DAC_TRIGGER_NONE)    || \
98                                  ((TRIGGER) == DAC_TRIGGER_T6_TRGO) || \
99                                  ((TRIGGER) == DAC_TRIGGER_T7_TRGO) || \
100                                  ((TRIGGER) == DAC_TRIGGER_T9_TRGO) || \
101                                  ((TRIGGER) == DAC_TRIGGER_T2_TRGO) || \
102                                  ((TRIGGER) == DAC_TRIGGER_T4_TRGO) || \
103                                  ((TRIGGER) == DAC_TRIGGER_EXT_IT9) || \
104                                  ((TRIGGER) == DAC_TRIGGER_SOFTWARE))
105 
106 #define IS_DAC_LFSR_UNMASK_TRIANGLE_AMPLITUDE(VALUE) (((VALUE) == DAC_LFSRUNMASK_BIT0) || \
107                                                       ((VALUE) == DAC_LFSRUNMASK_BITS1_0) || \
108                                                       ((VALUE) == DAC_LFSRUNMASK_BITS2_0) || \
109                                                       ((VALUE) == DAC_LFSRUNMASK_BITS3_0) || \
110                                                       ((VALUE) == DAC_LFSRUNMASK_BITS4_0) || \
111                                                       ((VALUE) == DAC_LFSRUNMASK_BITS5_0) || \
112                                                       ((VALUE) == DAC_LFSRUNMASK_BITS6_0) || \
113                                                       ((VALUE) == DAC_LFSRUNMASK_BITS7_0) || \
114                                                       ((VALUE) == DAC_LFSRUNMASK_BITS8_0) || \
115                                                       ((VALUE) == DAC_LFSRUNMASK_BITS9_0) || \
116                                                       ((VALUE) == DAC_LFSRUNMASK_BITS10_0) || \
117                                                       ((VALUE) == DAC_LFSRUNMASK_BITS11_0) || \
118                                                       ((VALUE) == DAC_TRIANGLEAMPLITUDE_1) || \
119                                                       ((VALUE) == DAC_TRIANGLEAMPLITUDE_3) || \
120                                                       ((VALUE) == DAC_TRIANGLEAMPLITUDE_7) || \
121                                                       ((VALUE) == DAC_TRIANGLEAMPLITUDE_15) || \
122                                                       ((VALUE) == DAC_TRIANGLEAMPLITUDE_31) || \
123                                                       ((VALUE) == DAC_TRIANGLEAMPLITUDE_63) || \
124                                                       ((VALUE) == DAC_TRIANGLEAMPLITUDE_127) || \
125                                                       ((VALUE) == DAC_TRIANGLEAMPLITUDE_255) || \
126                                                       ((VALUE) == DAC_TRIANGLEAMPLITUDE_511) || \
127                                                       ((VALUE) == DAC_TRIANGLEAMPLITUDE_1023) || \
128                                                       ((VALUE) == DAC_TRIANGLEAMPLITUDE_2047) || \
129                                                       ((VALUE) == DAC_TRIANGLEAMPLITUDE_4095))
130 /**
131   * @}
132   */
133 
134 /* Exported functions --------------------------------------------------------*/
135 /* Extended features functions ***********************************************/
136 
137 /** @addtogroup DACEx_Exported_Functions
138   * @{
139   */
140 
141 /** @addtogroup DACEx_Exported_Functions_Group2
142   * @{
143   */
144 /* IO operation functions *****************************************************/
145 
146 HAL_StatusTypeDef HAL_DACEx_TriangleWaveGenerate(DAC_HandleTypeDef *hdac, uint32_t Channel, uint32_t Amplitude);
147 HAL_StatusTypeDef HAL_DACEx_NoiseWaveGenerate(DAC_HandleTypeDef *hdac, uint32_t Channel, uint32_t Amplitude);
148 
149 HAL_StatusTypeDef HAL_DACEx_DualStart(DAC_HandleTypeDef *hdac);
150 HAL_StatusTypeDef HAL_DACEx_DualStop(DAC_HandleTypeDef *hdac);
151 HAL_StatusTypeDef HAL_DACEx_DualSetValue(DAC_HandleTypeDef *hdac, uint32_t Alignment, uint32_t Data1, uint32_t Data2);
152 uint32_t HAL_DACEx_DualGetValue(const DAC_HandleTypeDef *hdac);
153 
154 void HAL_DACEx_ConvCpltCallbackCh2(DAC_HandleTypeDef *hdac);
155 void HAL_DACEx_ConvHalfCpltCallbackCh2(DAC_HandleTypeDef *hdac);
156 void HAL_DACEx_ErrorCallbackCh2(DAC_HandleTypeDef *hdac);
157 void HAL_DACEx_DMAUnderrunCallbackCh2(DAC_HandleTypeDef *hdac);
158 
159 
160 /**
161   * @}
162   */
163 
164 /**
165   * @}
166   */
167 
168 /**
169   * @}
170   */
171 
172 /** @addtogroup DACEx_Private_Functions
173   * @{
174   */
175 
176 /* DAC_DMAConvCpltCh2 / DAC_DMAErrorCh2 / DAC_DMAHalfConvCpltCh2 */
177 /* are called by HAL_DAC_Start_DMA */
178 void DAC_DMAConvCpltCh2(DMA_HandleTypeDef *hdma);
179 void DAC_DMAErrorCh2(DMA_HandleTypeDef *hdma);
180 void DAC_DMAHalfConvCpltCh2(DMA_HandleTypeDef *hdma);
181 
182 /**
183   * @}
184   */
185 
186 /**
187   * @}
188   */
189 
190 #endif /* DAC1 */
191 
192 /**
193   * @}
194   */
195 
196 #ifdef __cplusplus
197 }
198 #endif
199 
200 #endif /* STM32L1xx_HAL_DAC_EX_H */
201