1 /** 2 ****************************************************************************** 3 * @file stm32f10x_dac.h 4 * @author MCD Application Team 5 * @version V3.1.2 6 * @date 09/28/2009 7 * @brief This file contains all the functions prototypes for the DAC firmware 8 * library. 9 ****************************************************************************** 10 * @copy 11 * 12 * THE PRESENT FIRMWARE WHICH IS FOR GUIDANCE ONLY AIMS AT PROVIDING CUSTOMERS 13 * WITH CODING INFORMATION REGARDING THEIR PRODUCTS IN ORDER FOR THEM TO SAVE 14 * TIME. AS A RESULT, STMICROELECTRONICS SHALL NOT BE HELD LIABLE FOR ANY 15 * DIRECT, INDIRECT OR CONSEQUENTIAL DAMAGES WITH RESPECT TO ANY CLAIMS ARISING 16 * FROM THE CONTENT OF SUCH FIRMWARE AND/OR THE USE MADE BY CUSTOMERS OF THE 17 * CODING INFORMATION CONTAINED HEREIN IN CONNECTION WITH THEIR PRODUCTS. 18 * 19 * <h2><center>© COPYRIGHT 2009 STMicroelectronics</center></h2> 20 */ 21 22 /* Define to prevent recursive inclusion -------------------------------------*/ 23 #ifndef __STM32F10x_DAC_H 24 #define __STM32F10x_DAC_H 25 26 #ifdef __cplusplus 27 extern "C" { 28 #endif 29 30 /* Includes ------------------------------------------------------------------*/ 31 #include "stm32f10x.h" 32 33 /** @addtogroup STM32F10x_StdPeriph_Driver 34 * @{ 35 */ 36 37 /** @addtogroup DAC 38 * @{ 39 */ 40 41 /** @defgroup DAC_Exported_Types 42 * @{ 43 */ 44 45 /** 46 * @brief DAC Init structure definition 47 */ 48 49 typedef struct 50 { 51 uint32_t DAC_Trigger; /*!< Specifies the external trigger for the selected DAC channel. 52 This parameter can be a value of @ref DAC_trigger_selection */ 53 54 uint32_t DAC_WaveGeneration; /*!< Specifies whether DAC channel noise waves or triangle waves 55 are generated, or whether no wave is generated. 56 This parameter can be a value of @ref DAC_wave_generation */ 57 58 uint32_t DAC_LFSRUnmask_TriangleAmplitude; /*!< Specifies the LFSR mask for noise wave generation or 59 the maximum amplitude triangle generation for the DAC channel. 60 This parameter can be a value of @ref DAC_lfsrunmask_triangleamplitude */ 61 62 uint32_t DAC_OutputBuffer; /*!< Specifies whether the DAC channel output buffer is enabled or disabled. 63 This parameter can be a value of @ref DAC_output_buffer */ 64 }DAC_InitTypeDef; 65 66 /** 67 * @} 68 */ 69 70 /** @defgroup DAC_Exported_Constants 71 * @{ 72 */ 73 74 /** @defgroup DAC_trigger_selection 75 * @{ 76 */ 77 78 #define DAC_Trigger_None ((uint32_t)0x00000000) /*!< Conversion is automatic once the DAC1_DHRxxxx register 79 has been loaded, and not by external trigger */ 80 #define DAC_Trigger_T6_TRGO ((uint32_t)0x00000004) /*!< TIM6 TRGO selected as external conversion trigger for DAC channel */ 81 #define DAC_Trigger_T8_TRGO ((uint32_t)0x0000000C) /*!< TIM8 TRGO selected as external conversion trigger for DAC channel 82 only in High-density devices*/ 83 #define DAC_Trigger_T3_TRGO ((uint32_t)0x0000000C) /*!< TIM8 TRGO selected as external conversion trigger for DAC channel 84 only in Connectivity line devices */ 85 #define DAC_Trigger_T7_TRGO ((uint32_t)0x00000014) /*!< TIM7 TRGO selected as external conversion trigger for DAC channel */ 86 #define DAC_Trigger_T5_TRGO ((uint32_t)0x0000001C) /*!< TIM5 TRGO selected as external conversion trigger for DAC channel */ 87 #define DAC_Trigger_T2_TRGO ((uint32_t)0x00000024) /*!< TIM2 TRGO selected as external conversion trigger for DAC channel */ 88 #define DAC_Trigger_T4_TRGO ((uint32_t)0x0000002C) /*!< TIM4 TRGO selected as external conversion trigger for DAC channel */ 89 #define DAC_Trigger_Ext_IT9 ((uint32_t)0x00000034) /*!< EXTI Line9 event selected as external conversion trigger for DAC channel */ 90 #define DAC_Trigger_Software ((uint32_t)0x0000003C) /*!< Conversion started by software trigger for DAC channel */ 91 92 #define IS_DAC_TRIGGER(TRIGGER) (((TRIGGER) == DAC_Trigger_None) || \ 93 ((TRIGGER) == DAC_Trigger_T6_TRGO) || \ 94 ((TRIGGER) == DAC_Trigger_T8_TRGO) || \ 95 ((TRIGGER) == DAC_Trigger_T7_TRGO) || \ 96 ((TRIGGER) == DAC_Trigger_T5_TRGO) || \ 97 ((TRIGGER) == DAC_Trigger_T2_TRGO) || \ 98 ((TRIGGER) == DAC_Trigger_T4_TRGO) || \ 99 ((TRIGGER) == DAC_Trigger_Ext_IT9) || \ 100 ((TRIGGER) == DAC_Trigger_Software)) 101 102 /** 103 * @} 104 */ 105 106 /** @defgroup DAC_wave_generation 107 * @{ 108 */ 109 110 #define DAC_WaveGeneration_None ((uint32_t)0x00000000) 111 #define DAC_WaveGeneration_Noise ((uint32_t)0x00000040) 112 #define DAC_WaveGeneration_Triangle ((uint32_t)0x00000080) 113 #define IS_DAC_GENERATE_WAVE(WAVE) (((WAVE) == DAC_WaveGeneration_None) || \ 114 ((WAVE) == DAC_WaveGeneration_Noise) || \ 115 ((WAVE) == DAC_WaveGeneration_Triangle)) 116 /** 117 * @} 118 */ 119 120 /** @defgroup DAC_lfsrunmask_triangleamplitude 121 * @{ 122 */ 123 124 #define DAC_LFSRUnmask_Bit0 ((uint32_t)0x00000000) /*!< Unmask DAC channel LFSR bit0 for noise wave generation */ 125 #define DAC_LFSRUnmask_Bits1_0 ((uint32_t)0x00000100) /*!< Unmask DAC channel LFSR bit[1:0] for noise wave generation */ 126 #define DAC_LFSRUnmask_Bits2_0 ((uint32_t)0x00000200) /*!< Unmask DAC channel LFSR bit[2:0] for noise wave generation */ 127 #define DAC_LFSRUnmask_Bits3_0 ((uint32_t)0x00000300) /*!< Unmask DAC channel LFSR bit[3:0] for noise wave generation */ 128 #define DAC_LFSRUnmask_Bits4_0 ((uint32_t)0x00000400) /*!< Unmask DAC channel LFSR bit[4:0] for noise wave generation */ 129 #define DAC_LFSRUnmask_Bits5_0 ((uint32_t)0x00000500) /*!< Unmask DAC channel LFSR bit[5:0] for noise wave generation */ 130 #define DAC_LFSRUnmask_Bits6_0 ((uint32_t)0x00000600) /*!< Unmask DAC channel LFSR bit[6:0] for noise wave generation */ 131 #define DAC_LFSRUnmask_Bits7_0 ((uint32_t)0x00000700) /*!< Unmask DAC channel LFSR bit[7:0] for noise wave generation */ 132 #define DAC_LFSRUnmask_Bits8_0 ((uint32_t)0x00000800) /*!< Unmask DAC channel LFSR bit[8:0] for noise wave generation */ 133 #define DAC_LFSRUnmask_Bits9_0 ((uint32_t)0x00000900) /*!< Unmask DAC channel LFSR bit[9:0] for noise wave generation */ 134 #define DAC_LFSRUnmask_Bits10_0 ((uint32_t)0x00000A00) /*!< Unmask DAC channel LFSR bit[10:0] for noise wave generation */ 135 #define DAC_LFSRUnmask_Bits11_0 ((uint32_t)0x00000B00) /*!< Unmask DAC channel LFSR bit[11:0] for noise wave generation */ 136 #define DAC_TriangleAmplitude_1 ((uint32_t)0x00000000) /*!< Select max triangle amplitude of 1 */ 137 #define DAC_TriangleAmplitude_3 ((uint32_t)0x00000100) /*!< Select max triangle amplitude of 3 */ 138 #define DAC_TriangleAmplitude_7 ((uint32_t)0x00000200) /*!< Select max triangle amplitude of 7 */ 139 #define DAC_TriangleAmplitude_15 ((uint32_t)0x00000300) /*!< Select max triangle amplitude of 15 */ 140 #define DAC_TriangleAmplitude_31 ((uint32_t)0x00000400) /*!< Select max triangle amplitude of 31 */ 141 #define DAC_TriangleAmplitude_63 ((uint32_t)0x00000500) /*!< Select max triangle amplitude of 63 */ 142 #define DAC_TriangleAmplitude_127 ((uint32_t)0x00000600) /*!< Select max triangle amplitude of 127 */ 143 #define DAC_TriangleAmplitude_255 ((uint32_t)0x00000700) /*!< Select max triangle amplitude of 255 */ 144 #define DAC_TriangleAmplitude_511 ((uint32_t)0x00000800) /*!< Select max triangle amplitude of 511 */ 145 #define DAC_TriangleAmplitude_1023 ((uint32_t)0x00000900) /*!< Select max triangle amplitude of 1023 */ 146 #define DAC_TriangleAmplitude_2047 ((uint32_t)0x00000A00) /*!< Select max triangle amplitude of 2047 */ 147 #define DAC_TriangleAmplitude_4095 ((uint32_t)0x00000B00) /*!< Select max triangle amplitude of 4095 */ 148 149 #define IS_DAC_LFSR_UNMASK_TRIANGLE_AMPLITUDE(VALUE) (((VALUE) == DAC_LFSRUnmask_Bit0) || \ 150 ((VALUE) == DAC_LFSRUnmask_Bits1_0) || \ 151 ((VALUE) == DAC_LFSRUnmask_Bits2_0) || \ 152 ((VALUE) == DAC_LFSRUnmask_Bits3_0) || \ 153 ((VALUE) == DAC_LFSRUnmask_Bits4_0) || \ 154 ((VALUE) == DAC_LFSRUnmask_Bits5_0) || \ 155 ((VALUE) == DAC_LFSRUnmask_Bits6_0) || \ 156 ((VALUE) == DAC_LFSRUnmask_Bits7_0) || \ 157 ((VALUE) == DAC_LFSRUnmask_Bits8_0) || \ 158 ((VALUE) == DAC_LFSRUnmask_Bits9_0) || \ 159 ((VALUE) == DAC_LFSRUnmask_Bits10_0) || \ 160 ((VALUE) == DAC_LFSRUnmask_Bits11_0) || \ 161 ((VALUE) == DAC_TriangleAmplitude_1) || \ 162 ((VALUE) == DAC_TriangleAmplitude_3) || \ 163 ((VALUE) == DAC_TriangleAmplitude_7) || \ 164 ((VALUE) == DAC_TriangleAmplitude_15) || \ 165 ((VALUE) == DAC_TriangleAmplitude_31) || \ 166 ((VALUE) == DAC_TriangleAmplitude_63) || \ 167 ((VALUE) == DAC_TriangleAmplitude_127) || \ 168 ((VALUE) == DAC_TriangleAmplitude_255) || \ 169 ((VALUE) == DAC_TriangleAmplitude_511) || \ 170 ((VALUE) == DAC_TriangleAmplitude_1023) || \ 171 ((VALUE) == DAC_TriangleAmplitude_2047) || \ 172 ((VALUE) == DAC_TriangleAmplitude_4095)) 173 /** 174 * @} 175 */ 176 177 /** @defgroup DAC_output_buffer 178 * @{ 179 */ 180 181 #define DAC_OutputBuffer_Enable ((uint32_t)0x00000000) 182 #define DAC_OutputBuffer_Disable ((uint32_t)0x00000002) 183 #define IS_DAC_OUTPUT_BUFFER_STATE(STATE) (((STATE) == DAC_OutputBuffer_Enable) || \ 184 ((STATE) == DAC_OutputBuffer_Disable)) 185 /** 186 * @} 187 */ 188 189 /** @defgroup DAC_Channel_selection 190 * @{ 191 */ 192 193 #define DAC_Channel_1 ((uint32_t)0x00000000) 194 #define DAC_Channel_2 ((uint32_t)0x00000010) 195 #define IS_DAC_CHANNEL(CHANNEL) (((CHANNEL) == DAC_Channel_1) || \ 196 ((CHANNEL) == DAC_Channel_2)) 197 /** 198 * @} 199 */ 200 201 /** @defgroup DAC_data_alignement 202 * @{ 203 */ 204 205 #define DAC_Align_12b_R ((uint32_t)0x00000000) 206 #define DAC_Align_12b_L ((uint32_t)0x00000004) 207 #define DAC_Align_8b_R ((uint32_t)0x00000008) 208 #define IS_DAC_ALIGN(ALIGN) (((ALIGN) == DAC_Align_12b_R) || \ 209 ((ALIGN) == DAC_Align_12b_L) || \ 210 ((ALIGN) == DAC_Align_8b_R)) 211 /** 212 * @} 213 */ 214 215 /** @defgroup DAC_wave_generation 216 * @{ 217 */ 218 219 #define DAC_Wave_Noise ((uint32_t)0x00000040) 220 #define DAC_Wave_Triangle ((uint32_t)0x00000080) 221 #define IS_DAC_WAVE(WAVE) (((WAVE) == DAC_Wave_Noise) || \ 222 ((WAVE) == DAC_Wave_Triangle)) 223 /** 224 * @} 225 */ 226 227 /** @defgroup DAC_data 228 * @{ 229 */ 230 231 #define IS_DAC_DATA(DATA) ((DATA) <= 0xFFF0) 232 /** 233 * @} 234 */ 235 236 /** 237 * @} 238 */ 239 240 /** @defgroup DAC_Exported_Macros 241 * @{ 242 */ 243 244 /** 245 * @} 246 */ 247 248 /** @defgroup DAC_Exported_Functions 249 * @{ 250 */ 251 252 void DAC_DeInit(void); 253 void DAC_Init(uint32_t DAC_Channel, DAC_InitTypeDef* DAC_InitStruct); 254 void DAC_StructInit(DAC_InitTypeDef* DAC_InitStruct); 255 void DAC_Cmd(uint32_t DAC_Channel, FunctionalState NewState); 256 void DAC_DMACmd(uint32_t DAC_Channel, FunctionalState NewState); 257 void DAC_SoftwareTriggerCmd(uint32_t DAC_Channel, FunctionalState NewState); 258 void DAC_DualSoftwareTriggerCmd(FunctionalState NewState); 259 void DAC_WaveGenerationCmd(uint32_t DAC_Channel, uint32_t DAC_Wave, FunctionalState NewState); 260 void DAC_SetChannel1Data(uint32_t DAC_Align, uint16_t Data); 261 void DAC_SetChannel2Data(uint32_t DAC_Align, uint16_t Data); 262 void DAC_SetDualChannelData(uint32_t DAC_Align, uint16_t Data2, uint16_t Data1); 263 uint16_t DAC_GetDataOutputValue(uint32_t DAC_Channel); 264 265 #ifdef __cplusplus 266 } 267 #endif 268 269 #endif /*__STM32F10x_DAC_H */ 270 /** 271 * @} 272 */ 273 274 /** 275 * @} 276 */ 277 278 /** 279 * @} 280 */ 281 282 /******************* (C) COPYRIGHT 2009 STMicroelectronics *****END OF FILE****/ 283