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.
 
 
 

293 lines
12 KiB

  1. /**
  2. ******************************************************************************
  3. * @file stm32f0xx_ll_dac.c
  4. * @author MCD Application Team
  5. * @brief DAC LL module driver
  6. ******************************************************************************
  7. * @attention
  8. *
  9. * <h2><center>&copy; COPYRIGHT(c) 2016 STMicroelectronics</center></h2>
  10. *
  11. * Redistribution and use in source and binary forms, with or without modification,
  12. * are permitted provided that the following conditions are met:
  13. * 1. Redistributions of source code must retain the above copyright notice,
  14. * this list of conditions and the following disclaimer.
  15. * 2. Redistributions in binary form must reproduce the above copyright notice,
  16. * this list of conditions and the following disclaimer in the documentation
  17. * and/or other materials provided with the distribution.
  18. * 3. Neither the name of STMicroelectronics nor the names of its contributors
  19. * may be used to endorse or promote products derived from this software
  20. * without specific prior written permission.
  21. *
  22. * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
  23. * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  24. * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
  25. * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
  26. * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  27. * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
  28. * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
  29. * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
  30. * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  31. * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  32. *
  33. ******************************************************************************
  34. */
  35. #if defined(USE_FULL_LL_DRIVER)
  36. /* Includes ------------------------------------------------------------------*/
  37. #include "stm32f0xx_ll_dac.h"
  38. #include "stm32f0xx_ll_bus.h"
  39. #ifdef USE_FULL_ASSERT
  40. #include "stm32_assert.h"
  41. #else
  42. #define assert_param(expr) ((void)0U)
  43. #endif
  44. /** @addtogroup STM32F0xx_LL_Driver
  45. * @{
  46. */
  47. #if defined (DAC1)
  48. /** @addtogroup DAC_LL DAC
  49. * @{
  50. */
  51. /* Private types -------------------------------------------------------------*/
  52. /* Private variables ---------------------------------------------------------*/
  53. /* Private constants ---------------------------------------------------------*/
  54. /* Private macros ------------------------------------------------------------*/
  55. /** @addtogroup DAC_LL_Private_Macros
  56. * @{
  57. */
  58. #if defined(DAC_CHANNEL2_SUPPORT)
  59. #define IS_LL_DAC_CHANNEL(__DACX__, __DAC_CHANNEL__) \
  60. ( \
  61. ((__DAC_CHANNEL__) == LL_DAC_CHANNEL_1) \
  62. || ((__DAC_CHANNEL__) == LL_DAC_CHANNEL_2) \
  63. )
  64. #else
  65. #define IS_LL_DAC_CHANNEL(__DACX__, __DAC_CHANNEL__) \
  66. ( \
  67. ((__DAC_CHANNEL__) == LL_DAC_CHANNEL_1) \
  68. )
  69. #endif /* DAC_CHANNEL2_SUPPORT */
  70. #define IS_LL_DAC_TRIGGER_SOURCE(__TRIGGER_SOURCE__) \
  71. ( ((__TRIGGER_SOURCE__) == LL_DAC_TRIG_SOFTWARE) \
  72. || ((__TRIGGER_SOURCE__) == LL_DAC_TRIG_EXT_TIM2_TRGO) \
  73. || ((__TRIGGER_SOURCE__) == LL_DAC_TRIG_EXT_TIM3_TRGO) \
  74. || ((__TRIGGER_SOURCE__) == LL_DAC_TRIG_EXT_TIM4_TRGO) \
  75. || ((__TRIGGER_SOURCE__) == LL_DAC_TRIG_EXT_TIM6_TRGO) \
  76. || ((__TRIGGER_SOURCE__) == LL_DAC_TRIG_EXT_TIM7_TRGO) \
  77. || ((__TRIGGER_SOURCE__) == LL_DAC_TRIG_EXT_TIM15_TRGO) \
  78. || ((__TRIGGER_SOURCE__) == LL_DAC_TRIG_EXT_EXTI_LINE9) \
  79. )
  80. #if defined(DAC_CR_WAVE1)
  81. #define IS_LL_DAC_WAVE_AUTO_GENER_MODE(__WAVE_AUTO_GENERATION_MODE__) \
  82. ( ((__WAVE_AUTO_GENERATION_MODE__) == LL_DAC_WAVE_AUTO_GENERATION_NONE) \
  83. || ((__WAVE_AUTO_GENERATION_MODE__) == LL_DAC_WAVE_AUTO_GENERATION_NOISE) \
  84. || ((__WAVE_AUTO_GENERATION_MODE__) == LL_DAC_WAVE_AUTO_GENERATION_TRIANGLE) \
  85. )
  86. #define IS_LL_DAC_WAVE_AUTO_GENER_CONFIG(__WAVE_AUTO_GENERATION_CONFIG__) \
  87. ( ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_NOISE_LFSR_UNMASK_BIT0) \
  88. || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_NOISE_LFSR_UNMASK_BITS1_0) \
  89. || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_NOISE_LFSR_UNMASK_BITS2_0) \
  90. || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_NOISE_LFSR_UNMASK_BITS3_0) \
  91. || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_NOISE_LFSR_UNMASK_BITS4_0) \
  92. || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_NOISE_LFSR_UNMASK_BITS5_0) \
  93. || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_NOISE_LFSR_UNMASK_BITS6_0) \
  94. || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_NOISE_LFSR_UNMASK_BITS7_0) \
  95. || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_NOISE_LFSR_UNMASK_BITS8_0) \
  96. || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_NOISE_LFSR_UNMASK_BITS9_0) \
  97. || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_NOISE_LFSR_UNMASK_BITS10_0) \
  98. || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_NOISE_LFSR_UNMASK_BITS11_0) \
  99. || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_TRIANGLE_AMPLITUDE_1) \
  100. || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_TRIANGLE_AMPLITUDE_3) \
  101. || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_TRIANGLE_AMPLITUDE_7) \
  102. || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_TRIANGLE_AMPLITUDE_15) \
  103. || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_TRIANGLE_AMPLITUDE_31) \
  104. || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_TRIANGLE_AMPLITUDE_63) \
  105. || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_TRIANGLE_AMPLITUDE_127) \
  106. || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_TRIANGLE_AMPLITUDE_255) \
  107. || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_TRIANGLE_AMPLITUDE_511) \
  108. || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_TRIANGLE_AMPLITUDE_1023) \
  109. || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_TRIANGLE_AMPLITUDE_2047) \
  110. || ((__WAVE_AUTO_GENERATION_CONFIG__) == LL_DAC_TRIANGLE_AMPLITUDE_4095) \
  111. )
  112. #endif
  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 DAC clock */
  141. LL_APB1_GRP1_ForceReset(LL_APB1_GRP1_PERIPH_DAC1);
  142. /* Release reset of DAC 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. #if defined(DAC_CR_WAVE1)
  172. assert_param(IS_LL_DAC_WAVE_AUTO_GENER_MODE(DAC_InitStruct->WaveAutoGeneration));
  173. if (DAC_InitStruct->WaveAutoGeneration != LL_DAC_WAVE_AUTO_GENERATION_NONE)
  174. {
  175. assert_param(IS_LL_DAC_WAVE_AUTO_GENER_CONFIG(DAC_InitStruct->WaveAutoGenerationConfig));
  176. }
  177. #endif
  178. /* Note: Hardware constraint (refer to description of this function) */
  179. /* DAC instance must be disabled. */
  180. if(LL_DAC_IsEnabled(DACx, DAC_Channel) == 0U)
  181. {
  182. /* Configuration of DAC channel: */
  183. /* - TriggerSource */
  184. #if defined(DAC_CR_WAVE1)
  185. /* - WaveAutoGeneration */
  186. #endif
  187. /* - OutputBuffer */
  188. #if defined(DAC_CR_WAVE1)
  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. #endif
  220. }
  221. else
  222. {
  223. /* Initialization error: DAC instance is not disabled. */
  224. status = ERROR;
  225. }
  226. return status;
  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. */
  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. #if defined(DAC_CR_WAVE1)
  239. DAC_InitStruct->WaveAutoGeneration = LL_DAC_WAVE_AUTO_GENERATION_NONE;
  240. /* Note: Parameter discarded if wave auto generation is disabled, */
  241. /* set anyway to its default value. */
  242. DAC_InitStruct->WaveAutoGenerationConfig = LL_DAC_NOISE_LFSR_UNMASK_BIT0;
  243. #endif
  244. DAC_InitStruct->OutputBuffer = LL_DAC_OUTPUT_BUFFER_ENABLE;
  245. }
  246. /**
  247. * @}
  248. */
  249. /**
  250. * @}
  251. */
  252. /**
  253. * @}
  254. */
  255. #endif /* DAC1 */
  256. /**
  257. * @}
  258. */
  259. #endif /* USE_FULL_LL_DRIVER */
  260. /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/