You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 

284 lines
12 KiB

  1. /**
  2. ******************************************************************************
  3. * @file stm32f4xx_ll_dac.c
  4. * @author MCD Application Team
  5. * @version V1.7.1
  6. * @date 14-April-2017
  7. * @brief DAC LL module driver
  8. ******************************************************************************
  9. * @attention
  10. *
  11. * <h2><center>&copy; COPYRIGHT(c) 2017 STMicroelectronics</center></h2>
  12. *
  13. * Redistribution and use in source and binary forms, with or without modification,
  14. * are permitted provided that the following conditions are met:
  15. * 1. Redistributions of source code must retain the above copyright notice,
  16. * this list of conditions and the following disclaimer.
  17. * 2. Redistributions in binary form must reproduce the above copyright notice,
  18. * this list of conditions and the following disclaimer in the documentation
  19. * and/or other materials provided with the distribution.
  20. * 3. Neither the name of STMicroelectronics nor the names of its contributors
  21. * may be used to endorse or promote products derived from this software
  22. * without specific prior written permission.
  23. *
  24. * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
  25. * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  26. * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
  27. * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
  28. * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  29. * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
  30. * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
  31. * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
  32. * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  33. * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  34. *
  35. ******************************************************************************
  36. */
  37. #if defined(USE_FULL_LL_DRIVER)
  38. /* Includes ------------------------------------------------------------------*/
  39. #include "stm32f4xx_ll_dac.h"
  40. #include "stm32f4xx_ll_bus.h"
  41. #ifdef USE_FULL_ASSERT
  42. #include "stm32_assert.h"
  43. #else
  44. #define assert_param(expr) ((void)0U)
  45. #endif
  46. /** @addtogroup STM32F4xx_LL_Driver
  47. * @{
  48. */
  49. #if defined(DAC)
  50. /** @addtogroup DAC_LL DAC
  51. * @{
  52. */
  53. /* Private types -------------------------------------------------------------*/
  54. /* Private variables ---------------------------------------------------------*/
  55. /* Private constants ---------------------------------------------------------*/
  56. /* Private macros ------------------------------------------------------------*/
  57. /** @addtogroup DAC_LL_Private_Macros
  58. * @{
  59. */
  60. #if defined(DAC_CHANNEL2_SUPPORT)
  61. #define IS_LL_DAC_CHANNEL(__DACX__, __DAC_CHANNEL__) \
  62. ( \
  63. ((__DAC_CHANNEL__) == LL_DAC_CHANNEL_1) \
  64. || ((__DAC_CHANNEL__) == LL_DAC_CHANNEL_2) \
  65. )
  66. #else
  67. #define IS_LL_DAC_CHANNEL(__DACX__, __DAC_CHANNEL__) \
  68. ( \
  69. ((__DAC_CHANNEL__) == LL_DAC_CHANNEL_1) \
  70. )
  71. #endif /* DAC_CHANNEL2_SUPPORT */
  72. #define IS_LL_DAC_TRIGGER_SOURCE(__TRIGGER_SOURCE__) \
  73. ( ((__TRIGGER_SOURCE__) == LL_DAC_TRIG_SOFTWARE) \
  74. || ((__TRIGGER_SOURCE__) == LL_DAC_TRIG_EXT_TIM2_TRGO) \
  75. || ((__TRIGGER_SOURCE__) == LL_DAC_TRIG_EXT_TIM4_TRGO) \
  76. || ((__TRIGGER_SOURCE__) == LL_DAC_TRIG_EXT_TIM5_TRGO) \
  77. || ((__TRIGGER_SOURCE__) == LL_DAC_TRIG_EXT_TIM6_TRGO) \
  78. || ((__TRIGGER_SOURCE__) == LL_DAC_TRIG_EXT_TIM7_TRGO) \
  79. || ((__TRIGGER_SOURCE__) == LL_DAC_TRIG_EXT_TIM8_TRGO) \
  80. || ((__TRIGGER_SOURCE__) == LL_DAC_TRIG_EXT_EXTI_LINE9) \
  81. )
  82. #define IS_LL_DAC_WAVE_AUTO_GENER_MODE(__WAVE_AUTO_GENERATION_MODE__) \
  83. ( ((__WAVE_AUTO_GENERATION_MODE__) == LL_DAC_WAVE_AUTO_GENERATION_NONE) \
  84. || ((__WAVE_AUTO_GENERATION_MODE__) == LL_DAC_WAVE_AUTO_GENERATION_NOISE) \
  85. || ((__WAVE_AUTO_GENERATION_MODE__) == LL_DAC_WAVE_AUTO_GENERATION_TRIANGLE) \
  86. )
  87. #define IS_LL_DAC_WAVE_AUTO_GENER_CONFIG(__WAVE_AUTO_GENERATION_CONFIG__) \
  88. ( ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_NOISE_LFSR_UNMASK_BIT0) \
  89. || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_NOISE_LFSR_UNMASK_BITS1_0) \
  90. || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_NOISE_LFSR_UNMASK_BITS2_0) \
  91. || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_NOISE_LFSR_UNMASK_BITS3_0) \
  92. || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_NOISE_LFSR_UNMASK_BITS4_0) \
  93. || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_NOISE_LFSR_UNMASK_BITS5_0) \
  94. || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_NOISE_LFSR_UNMASK_BITS6_0) \
  95. || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_NOISE_LFSR_UNMASK_BITS7_0) \
  96. || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_NOISE_LFSR_UNMASK_BITS8_0) \
  97. || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_NOISE_LFSR_UNMASK_BITS9_0) \
  98. || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_NOISE_LFSR_UNMASK_BITS10_0) \
  99. || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_NOISE_LFSR_UNMASK_BITS11_0) \
  100. || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_TRIANGLE_AMPLITUDE_1) \
  101. || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_TRIANGLE_AMPLITUDE_3) \
  102. || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_TRIANGLE_AMPLITUDE_7) \
  103. || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_TRIANGLE_AMPLITUDE_15) \
  104. || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_TRIANGLE_AMPLITUDE_31) \
  105. || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_TRIANGLE_AMPLITUDE_63) \
  106. || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_TRIANGLE_AMPLITUDE_127) \
  107. || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_TRIANGLE_AMPLITUDE_255) \
  108. || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_TRIANGLE_AMPLITUDE_511) \
  109. || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_TRIANGLE_AMPLITUDE_1023) \
  110. || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_TRIANGLE_AMPLITUDE_2047) \
  111. || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_TRIANGLE_AMPLITUDE_4095) \
  112. )
  113. #define IS_LL_DAC_OUTPUT_BUFFER(__OUTPUT_BUFFER__) \
  114. ( ((__OUTPUT_BUFFER__) == LL_DAC_OUTPUT_BUFFER_ENABLE) \
  115. || ((__OUTPUT_BUFFER__) == LL_DAC_OUTPUT_BUFFER_DISABLE) \
  116. )
  117. /**
  118. * @}
  119. */
  120. /* Private function prototypes -----------------------------------------------*/
  121. /* Exported functions --------------------------------------------------------*/
  122. /** @addtogroup DAC_LL_Exported_Functions
  123. * @{
  124. */
  125. /** @addtogroup DAC_LL_EF_Init
  126. * @{
  127. */
  128. /**
  129. * @brief De-initialize registers of the selected DAC instance
  130. * to their default reset values.
  131. * @param DACx DAC instance
  132. * @retval An ErrorStatus enumeration value:
  133. * - SUCCESS: DAC registers are de-initialized
  134. * - ERROR: not applicable
  135. */
  136. ErrorStatus LL_DAC_DeInit(DAC_TypeDef *DACx)
  137. {
  138. /* Check the parameters */
  139. assert_param(IS_DAC_ALL_INSTANCE(DACx));
  140. /* Force reset of DAC1 clock */
  141. LL_APB1_GRP1_ForceReset(LL_APB1_GRP1_PERIPH_DAC1);
  142. /* Release reset of DAC1 clock */
  143. LL_APB1_GRP1_ReleaseReset(LL_APB1_GRP1_PERIPH_DAC1);
  144. return SUCCESS;
  145. }
  146. /**
  147. * @brief Initialize some features of DAC instance.
  148. * @note The setting of these parameters by function @ref LL_DAC_Init()
  149. * is conditioned to DAC state:
  150. * DAC instance must be disabled.
  151. * @param DACx DAC instance
  152. * @param DAC_Channel This parameter can be one of the following values:
  153. * @arg @ref LL_DAC_CHANNEL_1
  154. * @arg @ref LL_DAC_CHANNEL_2 (1)
  155. *
  156. * (1) On this STM32 serie, parameter not available on all devices.
  157. * Refer to device datasheet for channels availability.
  158. * @param DAC_InitStruct Pointer to a @ref LL_DAC_InitTypeDef structure
  159. * @retval An ErrorStatus enumeration value:
  160. * - SUCCESS: DAC registers are initialized
  161. * - ERROR: DAC registers are not initialized
  162. */
  163. ErrorStatus LL_DAC_Init(DAC_TypeDef *DACx, uint32_t DAC_Channel, LL_DAC_InitTypeDef *DAC_InitStruct)
  164. {
  165. ErrorStatus status = SUCCESS;
  166. /* Check the parameters */
  167. assert_param(IS_DAC_ALL_INSTANCE(DACx));
  168. assert_param(IS_LL_DAC_CHANNEL(DACx, DAC_Channel));
  169. assert_param(IS_LL_DAC_TRIGGER_SOURCE(DAC_InitStruct->TriggerSource));
  170. assert_param(IS_LL_DAC_OUTPUT_BUFFER(DAC_InitStruct->OutputBuffer));
  171. assert_param(IS_LL_DAC_WAVE_AUTO_GENER_MODE(DAC_InitStruct->WaveAutoGeneration));
  172. if (DAC_InitStruct->WaveAutoGeneration != LL_DAC_WAVE_AUTO_GENERATION_NONE)
  173. {
  174. assert_param(IS_LL_DAC_WAVE_AUTO_GENER_CONFIG(DAC_InitStruct->WaveAutoGenerationConfig));
  175. }
  176. /* Note: Hardware constraint (refer to description of this function) */
  177. /* DAC instance must be disabled. */
  178. if(LL_DAC_IsEnabled(DACx, DAC_Channel) == 0U)
  179. {
  180. /* Configuration of DAC channel: */
  181. /* - TriggerSource */
  182. /* - WaveAutoGeneration */
  183. /* - OutputBuffer */
  184. if (DAC_InitStruct->WaveAutoGeneration != LL_DAC_WAVE_AUTO_GENERATION_NONE)
  185. {
  186. MODIFY_REG(DACx->CR,
  187. ( DAC_CR_TSEL1
  188. | DAC_CR_WAVE1
  189. | DAC_CR_MAMP1
  190. | DAC_CR_BOFF1
  191. ) << (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK)
  192. ,
  193. ( DAC_InitStruct->TriggerSource
  194. | DAC_InitStruct->WaveAutoGeneration
  195. | DAC_InitStruct->WaveAutoGenerationConfig
  196. | DAC_InitStruct->OutputBuffer
  197. ) << (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK)
  198. );
  199. }
  200. else
  201. {
  202. MODIFY_REG(DACx->CR,
  203. ( DAC_CR_TSEL1
  204. | DAC_CR_WAVE1
  205. | DAC_CR_BOFF1
  206. ) << (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK)
  207. ,
  208. ( DAC_InitStruct->TriggerSource
  209. | LL_DAC_WAVE_AUTO_GENERATION_NONE
  210. | DAC_InitStruct->OutputBuffer
  211. ) << (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK)
  212. );
  213. }
  214. }
  215. else
  216. {
  217. /* Initialization error: DAC instance is not disabled. */
  218. status = ERROR;
  219. }
  220. return status;
  221. }
  222. /**
  223. * @brief Set each @ref LL_DAC_InitTypeDef field to default value.
  224. * @param DAC_InitStruct pointer to a @ref LL_DAC_InitTypeDef structure
  225. * whose fields will be set to default values.
  226. * @retval None
  227. */
  228. void LL_DAC_StructInit(LL_DAC_InitTypeDef *DAC_InitStruct)
  229. {
  230. /* Set DAC_InitStruct fields to default values */
  231. DAC_InitStruct->TriggerSource = LL_DAC_TRIG_SOFTWARE;
  232. DAC_InitStruct->WaveAutoGeneration = LL_DAC_WAVE_AUTO_GENERATION_NONE;
  233. /* Note: Parameter discarded if wave auto generation is disabled, */
  234. /* set anyway to its default value. */
  235. DAC_InitStruct->WaveAutoGenerationConfig = LL_DAC_NOISE_LFSR_UNMASK_BIT0;
  236. DAC_InitStruct->OutputBuffer = LL_DAC_OUTPUT_BUFFER_ENABLE;
  237. }
  238. /**
  239. * @}
  240. */
  241. /**
  242. * @}
  243. */
  244. /**
  245. * @}
  246. */
  247. #endif /* DAC */
  248. /**
  249. * @}
  250. */
  251. #endif /* USE_FULL_LL_DRIVER */
  252. /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/