stm32g0xx_ll_dac.h 85 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799
  1. /**
  2. ******************************************************************************
  3. * @file stm32g0xx_ll_dac.h
  4. * @author MCD Application Team
  5. * @brief Header file of DAC LL module.
  6. ******************************************************************************
  7. * @attention
  8. *
  9. * Copyright (c) 2018 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. /* Define to prevent recursive inclusion -------------------------------------*/
  19. #ifndef STM32G0xx_LL_DAC_H
  20. #define STM32G0xx_LL_DAC_H
  21. #ifdef __cplusplus
  22. extern "C" {
  23. #endif
  24. /* Includes ------------------------------------------------------------------*/
  25. #include "stm32g0xx.h"
  26. /** @addtogroup STM32G0xx_LL_Driver
  27. * @{
  28. */
  29. #if defined(DAC1)
  30. /** @defgroup DAC_LL DAC
  31. * @{
  32. */
  33. /* Private types -------------------------------------------------------------*/
  34. /* Private variables ---------------------------------------------------------*/
  35. /* Private constants ---------------------------------------------------------*/
  36. /** @defgroup DAC_LL_Private_Constants DAC Private Constants
  37. * @{
  38. */
  39. /* Internal masks for DAC channels definition */
  40. /* To select into literal LL_DAC_CHANNEL_x the relevant bits for: */
  41. /* - channel bits position into registers CR, MCR, CCR, SHHR, SHRR */
  42. /* - channel bits position into register SWTRIG */
  43. /* - channel register offset of data holding register DHRx */
  44. /* - channel register offset of data output register DORx */
  45. /* - channel register offset of sample-and-hold sample time register SHSRx */
  46. #define DAC_CR_CH1_BITOFFSET 0UL /* Position of channel bits into registers
  47. CR, MCR, CCR, SHHR, SHRR of channel 1 */
  48. #define DAC_CR_CH2_BITOFFSET 16UL /* Position of channel bits into registers
  49. CR, MCR, CCR, SHHR, SHRR of channel 2 */
  50. #define DAC_CR_CHX_BITOFFSET_MASK (DAC_CR_CH1_BITOFFSET | DAC_CR_CH2_BITOFFSET)
  51. #define DAC_SWTR_CH1 (DAC_SWTRIGR_SWTRIG1) /* Channel bit into register SWTRIGR of channel 1. */
  52. #define DAC_SWTR_CH2 (DAC_SWTRIGR_SWTRIG2) /* Channel bit into register SWTRIGR of channel 2. */
  53. #define DAC_SWTR_CHX_MASK (DAC_SWTR_CH1 | DAC_SWTR_CH2)
  54. #define DAC_REG_DHR12R1_REGOFFSET 0x00000000UL /* Register DHR12Rx channel 1 taken as reference */
  55. #define DAC_REG_DHR12L1_REGOFFSET 0x00100000UL /* Register offset of DHR12Lx channel 1 versus
  56. DHR12Rx channel 1 (shifted left of 20 bits) */
  57. #define DAC_REG_DHR8R1_REGOFFSET 0x02000000UL /* Register offset of DHR8Rx channel 1 versus
  58. DHR12Rx channel 1 (shifted left of 24 bits) */
  59. #define DAC_REG_DHR12R2_REGOFFSET 0x30000000UL /* Register offset of DHR12Rx channel 2 versus
  60. DHR12Rx channel 1 (shifted left of 28 bits) */
  61. #define DAC_REG_DHR12L2_REGOFFSET 0x00400000UL /* Register offset of DHR12Lx channel 2 versus
  62. DHR12Rx channel 1 (shifted left of 20 bits) */
  63. #define DAC_REG_DHR8R2_REGOFFSET 0x05000000UL /* Register offset of DHR8Rx channel 2 versus
  64. DHR12Rx channel 1 (shifted left of 24 bits) */
  65. #define DAC_REG_DHR12RX_REGOFFSET_MASK 0xF0000000UL
  66. #define DAC_REG_DHR12LX_REGOFFSET_MASK 0x00F00000UL
  67. #define DAC_REG_DHR8RX_REGOFFSET_MASK 0x0F000000UL
  68. #define DAC_REG_DHRX_REGOFFSET_MASK (DAC_REG_DHR12RX_REGOFFSET_MASK\
  69. | DAC_REG_DHR12LX_REGOFFSET_MASK | DAC_REG_DHR8RX_REGOFFSET_MASK)
  70. #define DAC_REG_DOR1_REGOFFSET 0x00000000UL /* Register DORx channel 1 taken as reference */
  71. #define DAC_REG_DOR2_REGOFFSET 0x00000020UL /* Register offset of DORx channel 1 versus
  72. DORx channel 2 (shifted left of 5 bits) */
  73. #define DAC_REG_DORX_REGOFFSET_MASK (DAC_REG_DOR1_REGOFFSET | DAC_REG_DOR2_REGOFFSET)
  74. #define DAC_REG_SHSR1_REGOFFSET 0x00000000UL /* Register SHSRx channel 1 taken as reference */
  75. #define DAC_REG_SHSR2_REGOFFSET 0x00000040UL /* Register offset of SHSRx channel 1 versus
  76. SHSRx channel 2 (shifted left of 6 bits) */
  77. #define DAC_REG_SHSRX_REGOFFSET_MASK (DAC_REG_SHSR1_REGOFFSET | DAC_REG_SHSR2_REGOFFSET)
  78. #define DAC_REG_DHR_REGOFFSET_MASK_POSBIT0 0x0000000FUL /* Mask of data hold registers offset (DHR12Rx,
  79. DHR12Lx, DHR8Rx, ...) when shifted to position 0 */
  80. #define DAC_REG_DORX_REGOFFSET_MASK_POSBIT0 0x00000001UL /* Mask of DORx registers offset when shifted
  81. to position 0 */
  82. #define DAC_REG_SHSRX_REGOFFSET_MASK_POSBIT0 0x00000001UL /* Mask of SHSRx registers offset when shifted
  83. to position 0 */
  84. #define DAC_REG_DHR12RX_REGOFFSET_BITOFFSET_POS 28UL /* Position of bits register offset of DHR12Rx
  85. channel 1 or 2 versus DHR12Rx channel 1
  86. (shifted left of 28 bits) */
  87. #define DAC_REG_DHR12LX_REGOFFSET_BITOFFSET_POS 20UL /* Position of bits register offset of DHR12Lx
  88. channel 1 or 2 versus DHR12Rx channel 1
  89. (shifted left of 20 bits) */
  90. #define DAC_REG_DHR8RX_REGOFFSET_BITOFFSET_POS 24UL /* Position of bits register offset of DHR8Rx
  91. channel 1 or 2 versus DHR12Rx channel 1
  92. (shifted left of 24 bits) */
  93. #define DAC_REG_DORX_REGOFFSET_BITOFFSET_POS 5UL /* Position of bits register offset of DORx
  94. channel 1 or 2 versus DORx channel 1
  95. (shifted left of 5 bits) */
  96. #define DAC_REG_SHSRX_REGOFFSET_BITOFFSET_POS 6UL /* Position of bits register offset of SHSRx
  97. channel 1 or 2 versus SHSRx channel 1
  98. (shifted left of 6 bits) */
  99. /* DAC registers bits positions */
  100. #define DAC_DHR12RD_DACC2DHR_BITOFFSET_POS DAC_DHR12RD_DACC2DHR_Pos
  101. #define DAC_DHR12LD_DACC2DHR_BITOFFSET_POS DAC_DHR12LD_DACC2DHR_Pos
  102. #define DAC_DHR8RD_DACC2DHR_BITOFFSET_POS DAC_DHR8RD_DACC2DHR_Pos
  103. /* Miscellaneous data */
  104. #define DAC_DIGITAL_SCALE_12BITS 4095UL /* Full-scale digital value with a resolution of 12
  105. bits (voltage range determined by analog voltage
  106. references Vref+ and Vref-, refer to reference manual) */
  107. /**
  108. * @}
  109. */
  110. /* Private macros ------------------------------------------------------------*/
  111. /** @defgroup DAC_LL_Private_Macros DAC Private Macros
  112. * @{
  113. */
  114. /**
  115. * @brief Driver macro reserved for internal use: set a pointer to
  116. * a register from a register basis from which an offset
  117. * is applied.
  118. * @param __REG__ Register basis from which the offset is applied.
  119. * @param __REG_OFFFSET__ Offset to be applied (unit: number of registers).
  120. * @retval Pointer to register address
  121. */
  122. #define __DAC_PTR_REG_OFFSET(__REG__, __REG_OFFFSET__) \
  123. ((uint32_t *)((uint32_t) ((uint32_t)(&(__REG__)) + ((__REG_OFFFSET__) << 2UL))))
  124. /**
  125. * @}
  126. */
  127. /* Exported types ------------------------------------------------------------*/
  128. #if defined(USE_FULL_LL_DRIVER)
  129. /** @defgroup DAC_LL_ES_INIT DAC Exported Init structure
  130. * @{
  131. */
  132. /**
  133. * @brief Structure definition of some features of DAC instance.
  134. */
  135. typedef struct
  136. {
  137. uint32_t TriggerSource; /*!< Set the conversion trigger source for the selected DAC channel:
  138. internal (SW start) or from external peripheral
  139. (timer event, external interrupt line).
  140. This parameter can be a value of @ref DAC_LL_EC_TRIGGER_SOURCE
  141. This feature can be modified afterwards using unitary
  142. function @ref LL_DAC_SetTriggerSource(). */
  143. uint32_t WaveAutoGeneration; /*!< Set the waveform automatic generation mode for the selected DAC channel.
  144. This parameter can be a value of @ref DAC_LL_EC_WAVE_AUTO_GENERATION_MODE
  145. This feature can be modified afterwards using unitary
  146. function @ref LL_DAC_SetWaveAutoGeneration(). */
  147. uint32_t WaveAutoGenerationConfig; /*!< Set the waveform automatic generation mode for the selected DAC channel.
  148. If waveform automatic generation mode is set to noise, this parameter
  149. can be a value of @ref DAC_LL_EC_WAVE_NOISE_LFSR_UNMASK_BITS
  150. If waveform automatic generation mode is set to triangle,
  151. this parameter can be a value of @ref DAC_LL_EC_WAVE_TRIANGLE_AMPLITUDE
  152. @note If waveform automatic generation mode is disabled,
  153. this parameter is discarded.
  154. This feature can be modified afterwards using unitary
  155. function @ref LL_DAC_SetWaveNoiseLFSR(),
  156. @ref LL_DAC_SetWaveTriangleAmplitude()
  157. depending on the wave automatic generation selected. */
  158. uint32_t OutputBuffer; /*!< Set the output buffer for the selected DAC channel.
  159. This parameter can be a value of @ref DAC_LL_EC_OUTPUT_BUFFER
  160. This feature can be modified afterwards using unitary
  161. function @ref LL_DAC_SetOutputBuffer(). */
  162. uint32_t OutputConnection; /*!< Set the output connection for the selected DAC channel.
  163. This parameter can be a value of @ref DAC_LL_EC_OUTPUT_CONNECTION
  164. This feature can be modified afterwards using unitary
  165. function @ref LL_DAC_SetOutputConnection(). */
  166. uint32_t OutputMode; /*!< Set the output mode normal or sample-and-hold for the selected DAC
  167. channel. This parameter can be a value of @ref DAC_LL_EC_OUTPUT_MODE
  168. This feature can be modified afterwards using unitary
  169. function @ref LL_DAC_SetOutputMode(). */
  170. } LL_DAC_InitTypeDef;
  171. /**
  172. * @}
  173. */
  174. #endif /* USE_FULL_LL_DRIVER */
  175. /* Exported constants --------------------------------------------------------*/
  176. /** @defgroup DAC_LL_Exported_Constants DAC Exported Constants
  177. * @{
  178. */
  179. /** @defgroup DAC_LL_EC_GET_FLAG DAC flags
  180. * @brief Flags defines which can be used with LL_DAC_ReadReg function
  181. * @{
  182. */
  183. /* DAC channel 1 flags */
  184. #define LL_DAC_FLAG_DMAUDR1 (DAC_SR_DMAUDR1) /*!< DAC channel 1 flag DMA underrun */
  185. #define LL_DAC_FLAG_CAL1 (DAC_SR_CAL_FLAG1) /*!< DAC channel 1 flag offset calibration status */
  186. #define LL_DAC_FLAG_BWST1 (DAC_SR_BWST1) /*!< DAC channel 1 flag busy writing sample time */
  187. /* DAC channel 2 flags */
  188. #define LL_DAC_FLAG_DMAUDR2 (DAC_SR_DMAUDR2) /*!< DAC channel 2 flag DMA underrun */
  189. #define LL_DAC_FLAG_CAL2 (DAC_SR_CAL_FLAG2) /*!< DAC channel 2 flag offset calibration status */
  190. #define LL_DAC_FLAG_BWST2 (DAC_SR_BWST2) /*!< DAC channel 2 flag busy writing sample time */
  191. /**
  192. * @}
  193. */
  194. /** @defgroup DAC_LL_EC_IT DAC interruptions
  195. * @brief IT defines which can be used with LL_DAC_ReadReg and LL_DAC_WriteReg functions
  196. * @{
  197. */
  198. #define LL_DAC_IT_DMAUDRIE1 (DAC_CR_DMAUDRIE1) /*!< DAC channel 1 interruption DMA underrun */
  199. #define LL_DAC_IT_DMAUDRIE2 (DAC_CR_DMAUDRIE2) /*!< DAC channel 2 interruption DMA underrun */
  200. /**
  201. * @}
  202. */
  203. /** @defgroup DAC_LL_EC_CHANNEL DAC channels
  204. * @{
  205. */
  206. #define LL_DAC_CHANNEL_1 (DAC_REG_SHSR1_REGOFFSET | DAC_REG_DOR1_REGOFFSET | DAC_REG_DHR12R1_REGOFFSET | DAC_REG_DHR12L1_REGOFFSET | DAC_REG_DHR8R1_REGOFFSET | DAC_CR_CH1_BITOFFSET | DAC_SWTR_CH1) /*!< DAC channel 1 */
  207. #define LL_DAC_CHANNEL_2 (DAC_REG_SHSR2_REGOFFSET | DAC_REG_DOR2_REGOFFSET | DAC_REG_DHR12R2_REGOFFSET | DAC_REG_DHR12L2_REGOFFSET | DAC_REG_DHR8R2_REGOFFSET | DAC_CR_CH2_BITOFFSET | DAC_SWTR_CH2) /*!< DAC channel 2 */
  208. /**
  209. * @}
  210. */
  211. /** @defgroup DAC_LL_EC_OPERATING_MODE DAC operating mode
  212. * @{
  213. */
  214. #define LL_DAC_MODE_NORMAL_OPERATION 0x00000000UL /*!< DAC channel in mode normal operation */
  215. #define LL_DAC_MODE_CALIBRATION (DAC_CR_CEN1) /*!< DAC channel in mode calibration */
  216. /**
  217. * @}
  218. */
  219. /** @defgroup DAC_LL_EC_TRIGGER_SOURCE DAC trigger source
  220. * @{
  221. */
  222. #define LL_DAC_TRIG_SOFTWARE 0x00000000UL /*!< DAC channel conversion trigger internal (SW start) */
  223. #define LL_DAC_TRIG_EXT_TIM1_TRGO ( DAC_CR_TSEL1_0) /*!< DAC channel conversion trigger from external peripheral: TIM1 TRGO. */
  224. #define LL_DAC_TRIG_EXT_TIM2_TRGO ( DAC_CR_TSEL1_1 ) /*!< DAC channel conversion trigger from external peripheral: TIM2 TRGO. */
  225. #define LL_DAC_TRIG_EXT_TIM3_TRGO ( DAC_CR_TSEL1_1 | DAC_CR_TSEL1_0) /*!< DAC channel conversion trigger from external peripheral: TIM3 TRGO. */
  226. #define LL_DAC_TRIG_EXT_TIM6_TRGO ( DAC_CR_TSEL1_2 | DAC_CR_TSEL1_0) /*!< DAC channel conversion trigger from external peripheral: TIM6 TRGO. */
  227. #define LL_DAC_TRIG_EXT_TIM7_TRGO ( DAC_CR_TSEL1_2 | DAC_CR_TSEL1_1 ) /*!< DAC channel conversion trigger from external peripheral: TIM7 TRGO. */
  228. #define LL_DAC_TRIG_EXT_TIM15_TRGO (DAC_CR_TSEL1_3 ) /*!< DAC channel conversion trigger from external peripheral: TIM15 TRGO. */
  229. #define LL_DAC_TRIG_EXT_LPTIM1_OUT (DAC_CR_TSEL1_3 | DAC_CR_TSEL1_1 | DAC_CR_TSEL1_0) /*!< DAC channel conversion trigger from external peripheral: LPTIM1 TRGO. */
  230. #define LL_DAC_TRIG_EXT_LPTIM2_OUT (DAC_CR_TSEL1_3 | DAC_CR_TSEL1_2 ) /*!< DAC channel conversion trigger from external peripheral: LPTIM2 TRGO. */
  231. #define LL_DAC_TRIG_EXT_EXTI_LINE9 (DAC_CR_TSEL1_3 | DAC_CR_TSEL1_2 | DAC_CR_TSEL1_0) /*!< DAC channel conversion trigger from external peripheral: external interrupt line 9. */
  232. /**
  233. * @}
  234. */
  235. /** @defgroup DAC_LL_EC_WAVE_AUTO_GENERATION_MODE DAC waveform automatic generation mode
  236. * @{
  237. */
  238. #define LL_DAC_WAVE_AUTO_GENERATION_NONE 0x00000000UL /*!< DAC channel wave auto generation mode disabled. */
  239. #define LL_DAC_WAVE_AUTO_GENERATION_NOISE ( DAC_CR_WAVE1_0) /*!< DAC channel wave auto generation mode enabled, set generated noise waveform. */
  240. #define LL_DAC_WAVE_AUTO_GENERATION_TRIANGLE (DAC_CR_WAVE1_1 ) /*!< DAC channel wave auto generation mode enabled, set generated triangle waveform. */
  241. /**
  242. * @}
  243. */
  244. /** @defgroup DAC_LL_EC_WAVE_NOISE_LFSR_UNMASK_BITS DAC wave generation - Noise LFSR unmask bits
  245. * @{
  246. */
  247. #define LL_DAC_NOISE_LFSR_UNMASK_BIT0 0x00000000UL /*!< Noise wave generation, unmask LFSR bit0, for the selected DAC channel */
  248. #define LL_DAC_NOISE_LFSR_UNMASK_BITS1_0 ( DAC_CR_MAMP1_0) /*!< Noise wave generation, unmask LFSR bits[1:0], for the selected DAC channel */
  249. #define LL_DAC_NOISE_LFSR_UNMASK_BITS2_0 ( DAC_CR_MAMP1_1 ) /*!< Noise wave generation, unmask LFSR bits[2:0], for the selected DAC channel */
  250. #define LL_DAC_NOISE_LFSR_UNMASK_BITS3_0 ( DAC_CR_MAMP1_1 | DAC_CR_MAMP1_0) /*!< Noise wave generation, unmask LFSR bits[3:0], for the selected DAC channel */
  251. #define LL_DAC_NOISE_LFSR_UNMASK_BITS4_0 ( DAC_CR_MAMP1_2 ) /*!< Noise wave generation, unmask LFSR bits[4:0], for the selected DAC channel */
  252. #define LL_DAC_NOISE_LFSR_UNMASK_BITS5_0 ( DAC_CR_MAMP1_2 | DAC_CR_MAMP1_0) /*!< Noise wave generation, unmask LFSR bits[5:0], for the selected DAC channel */
  253. #define LL_DAC_NOISE_LFSR_UNMASK_BITS6_0 ( DAC_CR_MAMP1_2 | DAC_CR_MAMP1_1 ) /*!< Noise wave generation, unmask LFSR bits[6:0], for the selected DAC channel */
  254. #define LL_DAC_NOISE_LFSR_UNMASK_BITS7_0 ( DAC_CR_MAMP1_2 | DAC_CR_MAMP1_1 | DAC_CR_MAMP1_0) /*!< Noise wave generation, unmask LFSR bits[7:0], for the selected DAC channel */
  255. #define LL_DAC_NOISE_LFSR_UNMASK_BITS8_0 (DAC_CR_MAMP1_3 ) /*!< Noise wave generation, unmask LFSR bits[8:0], for the selected DAC channel */
  256. #define LL_DAC_NOISE_LFSR_UNMASK_BITS9_0 (DAC_CR_MAMP1_3 | DAC_CR_MAMP1_0) /*!< Noise wave generation, unmask LFSR bits[9:0], for the selected DAC channel */
  257. #define LL_DAC_NOISE_LFSR_UNMASK_BITS10_0 (DAC_CR_MAMP1_3 | DAC_CR_MAMP1_1 ) /*!< Noise wave generation, unmask LFSR bits[10:0], for the selected DAC channel */
  258. #define LL_DAC_NOISE_LFSR_UNMASK_BITS11_0 (DAC_CR_MAMP1_3 | DAC_CR_MAMP1_1 | DAC_CR_MAMP1_0) /*!< Noise wave generation, unmask LFSR bits[11:0], for the selected DAC channel */
  259. /**
  260. * @}
  261. */
  262. /** @defgroup DAC_LL_EC_WAVE_TRIANGLE_AMPLITUDE DAC wave generation - Triangle amplitude
  263. * @{
  264. */
  265. #define LL_DAC_TRIANGLE_AMPLITUDE_1 0x00000000UL /*!< Triangle wave generation, amplitude of 1 LSB of DAC output range, for the selected DAC channel */
  266. #define LL_DAC_TRIANGLE_AMPLITUDE_3 ( DAC_CR_MAMP1_0) /*!< Triangle wave generation, amplitude of 3 LSB of DAC output range, for the selected DAC channel */
  267. #define LL_DAC_TRIANGLE_AMPLITUDE_7 ( DAC_CR_MAMP1_1 ) /*!< Triangle wave generation, amplitude of 7 LSB of DAC output range, for the selected DAC channel */
  268. #define LL_DAC_TRIANGLE_AMPLITUDE_15 ( DAC_CR_MAMP1_1 | DAC_CR_MAMP1_0) /*!< Triangle wave generation, amplitude of 15 LSB of DAC output range, for the selected DAC channel */
  269. #define LL_DAC_TRIANGLE_AMPLITUDE_31 ( DAC_CR_MAMP1_2 ) /*!< Triangle wave generation, amplitude of 31 LSB of DAC output range, for the selected DAC channel */
  270. #define LL_DAC_TRIANGLE_AMPLITUDE_63 ( DAC_CR_MAMP1_2 | DAC_CR_MAMP1_0) /*!< Triangle wave generation, amplitude of 63 LSB of DAC output range, for the selected DAC channel */
  271. #define LL_DAC_TRIANGLE_AMPLITUDE_127 ( DAC_CR_MAMP1_2 | DAC_CR_MAMP1_1 ) /*!< Triangle wave generation, amplitude of 127 LSB of DAC output range, for the selected DAC channel */
  272. #define LL_DAC_TRIANGLE_AMPLITUDE_255 ( DAC_CR_MAMP1_2 | DAC_CR_MAMP1_1 | DAC_CR_MAMP1_0) /*!< Triangle wave generation, amplitude of 255 LSB of DAC output range, for the selected DAC channel */
  273. #define LL_DAC_TRIANGLE_AMPLITUDE_511 (DAC_CR_MAMP1_3 ) /*!< Triangle wave generation, amplitude of 512 LSB of DAC output range, for the selected DAC channel */
  274. #define LL_DAC_TRIANGLE_AMPLITUDE_1023 (DAC_CR_MAMP1_3 | DAC_CR_MAMP1_0) /*!< Triangle wave generation, amplitude of 1023 LSB of DAC output range, for the selected DAC channel */
  275. #define LL_DAC_TRIANGLE_AMPLITUDE_2047 (DAC_CR_MAMP1_3 | DAC_CR_MAMP1_1 ) /*!< Triangle wave generation, amplitude of 2047 LSB of DAC output range, for the selected DAC channel */
  276. #define LL_DAC_TRIANGLE_AMPLITUDE_4095 (DAC_CR_MAMP1_3 | DAC_CR_MAMP1_1 | DAC_CR_MAMP1_0) /*!< Triangle wave generation, amplitude of 4095 LSB of DAC output range, for the selected DAC channel */
  277. /**
  278. * @}
  279. */
  280. /** @defgroup DAC_LL_EC_OUTPUT_MODE DAC channel output mode
  281. * @{
  282. */
  283. #define LL_DAC_OUTPUT_MODE_NORMAL 0x00000000UL /*!< The selected DAC channel output is on mode normal. */
  284. #define LL_DAC_OUTPUT_MODE_SAMPLE_AND_HOLD (DAC_MCR_MODE1_2) /*!< The selected DAC channel output is on mode sample-and-hold. Mode sample-and-hold requires an external capacitor, refer to description of function @ref LL_DAC_ConfigOutput() or @ref LL_DAC_SetOutputMode(). */
  285. /**
  286. * @}
  287. */
  288. /** @defgroup DAC_LL_EC_OUTPUT_BUFFER DAC channel output buffer
  289. * @{
  290. */
  291. #define LL_DAC_OUTPUT_BUFFER_ENABLE 0x00000000UL /*!< The selected DAC channel output is buffered: higher drive current capability, but also higher current consumption */
  292. #define LL_DAC_OUTPUT_BUFFER_DISABLE (DAC_MCR_MODE1_1) /*!< The selected DAC channel output is not buffered: lower drive current capability, but also lower current consumption */
  293. /**
  294. * @}
  295. */
  296. /** @defgroup DAC_LL_EC_OUTPUT_CONNECTION DAC channel output connection
  297. * @{
  298. */
  299. #define LL_DAC_OUTPUT_CONNECT_GPIO 0x00000000UL /*!< The selected DAC channel output is connected to external pin */
  300. #define LL_DAC_OUTPUT_CONNECT_INTERNAL (DAC_MCR_MODE1_0) /*!< The selected DAC channel output is connected to on-chip peripherals via internal paths. On this STM32 series, output connection depends on output mode (normal or sample and hold) and output buffer state. Refer to comments of function @ref LL_DAC_SetOutputConnection(). */
  301. /**
  302. * @}
  303. */
  304. /** @defgroup DAC_LL_EC_RESOLUTION DAC channel output resolution
  305. * @{
  306. */
  307. #define LL_DAC_RESOLUTION_12B 0x00000000UL /*!< DAC channel resolution 12 bits */
  308. #define LL_DAC_RESOLUTION_8B 0x00000002UL /*!< DAC channel resolution 8 bits */
  309. /**
  310. * @}
  311. */
  312. /** @defgroup DAC_LL_EC_REGISTERS DAC registers compliant with specific purpose
  313. * @{
  314. */
  315. /* List of DAC registers intended to be used (most commonly) with */
  316. /* DMA transfer. */
  317. /* Refer to function @ref LL_DAC_DMA_GetRegAddr(). */
  318. #define LL_DAC_DMA_REG_DATA_12BITS_RIGHT_ALIGNED DAC_REG_DHR12RX_REGOFFSET_BITOFFSET_POS /*!< DAC channel data holding register 12 bits right aligned */
  319. #define LL_DAC_DMA_REG_DATA_12BITS_LEFT_ALIGNED DAC_REG_DHR12LX_REGOFFSET_BITOFFSET_POS /*!< DAC channel data holding register 12 bits left aligned */
  320. #define LL_DAC_DMA_REG_DATA_8BITS_RIGHT_ALIGNED DAC_REG_DHR8RX_REGOFFSET_BITOFFSET_POS /*!< DAC channel data holding register 8 bits right aligned */
  321. /**
  322. * @}
  323. */
  324. /** @defgroup DAC_LL_EC_HW_DELAYS Definitions of DAC hardware constraints delays
  325. * @note Only DAC peripheral HW delays are defined in DAC LL driver driver,
  326. * not timeout values.
  327. * For details on delays values, refer to descriptions in source code
  328. * above each literal definition.
  329. * @{
  330. */
  331. /* Delay for DAC channel voltage settling time from DAC channel startup */
  332. /* (transition from disable to enable). */
  333. /* Note: DAC channel startup time depends on board application environment: */
  334. /* impedance connected to DAC channel output. */
  335. /* The delay below is specified under conditions: */
  336. /* - voltage maximum transition (lowest to highest value) */
  337. /* - until voltage reaches final value +-1LSB */
  338. /* - DAC channel output buffer enabled */
  339. /* - load impedance of 5kOhm (min), 50pF (max) */
  340. /* Literal set to maximum value (refer to device datasheet, */
  341. /* parameter "tWAKEUP"). */
  342. /* Unit: us */
  343. #define LL_DAC_DELAY_STARTUP_VOLTAGE_SETTLING_US 8UL /*!< Delay for DAC channel voltage settling time from DAC channel startup (transition from disable to enable) */
  344. /* Delay for DAC channel voltage settling time. */
  345. /* Note: DAC channel startup time depends on board application environment: */
  346. /* impedance connected to DAC channel output. */
  347. /* The delay below is specified under conditions: */
  348. /* - voltage maximum transition (lowest to highest value) */
  349. /* - until voltage reaches final value +-1LSB */
  350. /* - DAC channel output buffer enabled */
  351. /* - load impedance of 5kOhm min, 50pF max */
  352. /* Literal set to maximum value (refer to device datasheet, */
  353. /* parameter "tSETTLING"). */
  354. /* Unit: us */
  355. #define LL_DAC_DELAY_VOLTAGE_SETTLING_US 3UL /*!< Delay for DAC channel voltage settling time */
  356. /**
  357. * @}
  358. */
  359. /**
  360. * @}
  361. */
  362. /* Exported macro ------------------------------------------------------------*/
  363. /** @defgroup DAC_LL_Exported_Macros DAC Exported Macros
  364. * @{
  365. */
  366. /** @defgroup DAC_LL_EM_WRITE_READ Common write and read registers macros
  367. * @{
  368. */
  369. /**
  370. * @brief Write a value in DAC register
  371. * @param __INSTANCE__ DAC Instance
  372. * @param __REG__ Register to be written
  373. * @param __VALUE__ Value to be written in the register
  374. * @retval None
  375. */
  376. #define LL_DAC_WriteReg(__INSTANCE__, __REG__, __VALUE__) WRITE_REG(__INSTANCE__->__REG__, (__VALUE__))
  377. /**
  378. * @brief Read a value in DAC register
  379. * @param __INSTANCE__ DAC Instance
  380. * @param __REG__ Register to be read
  381. * @retval Register value
  382. */
  383. #define LL_DAC_ReadReg(__INSTANCE__, __REG__) READ_REG(__INSTANCE__->__REG__)
  384. /**
  385. * @}
  386. */
  387. /** @defgroup DAC_LL_EM_HELPER_MACRO DAC helper macro
  388. * @{
  389. */
  390. /**
  391. * @brief Helper macro to get DAC channel number in decimal format
  392. * from literals LL_DAC_CHANNEL_x.
  393. * Example:
  394. * __LL_DAC_CHANNEL_TO_DECIMAL_NB(LL_DAC_CHANNEL_1)
  395. * will return decimal number "1".
  396. * @note The input can be a value from functions where a channel
  397. * number is returned.
  398. * @param __CHANNEL__ This parameter can be one of the following values:
  399. * @arg @ref LL_DAC_CHANNEL_1
  400. * @arg @ref LL_DAC_CHANNEL_2
  401. * @retval 1...2
  402. */
  403. #define __LL_DAC_CHANNEL_TO_DECIMAL_NB(__CHANNEL__) \
  404. ((__CHANNEL__) & DAC_SWTR_CHX_MASK)
  405. /**
  406. * @brief Helper macro to get DAC channel in literal format LL_DAC_CHANNEL_x
  407. * from number in decimal format.
  408. * Example:
  409. * __LL_DAC_DECIMAL_NB_TO_CHANNEL(1)
  410. * will return a data equivalent to "LL_DAC_CHANNEL_1".
  411. * @note If the input parameter does not correspond to a DAC channel,
  412. * this macro returns value '0'.
  413. * @param __DECIMAL_NB__ 1...2
  414. * @retval Returned value can be one of the following values:
  415. * @arg @ref LL_DAC_CHANNEL_1
  416. * @arg @ref LL_DAC_CHANNEL_2
  417. */
  418. #define __LL_DAC_DECIMAL_NB_TO_CHANNEL(__DECIMAL_NB__)\
  419. (((__DECIMAL_NB__) == 1UL)? (LL_DAC_CHANNEL_1 ):(((__DECIMAL_NB__) == 2UL) ? ( LL_DAC_CHANNEL_2):(0UL)))
  420. /**
  421. * @brief Helper macro to define the DAC conversion data full-scale digital
  422. * value corresponding to the selected DAC resolution.
  423. * @note DAC conversion data full-scale corresponds to voltage range
  424. * determined by analog voltage references Vref+ and Vref-
  425. * (refer to reference manual).
  426. * @param __DAC_RESOLUTION__ This parameter can be one of the following values:
  427. * @arg @ref LL_DAC_RESOLUTION_12B
  428. * @arg @ref LL_DAC_RESOLUTION_8B
  429. * @retval ADC conversion data equivalent voltage value (unit: mVolt)
  430. */
  431. #define __LL_DAC_DIGITAL_SCALE(__DAC_RESOLUTION__) \
  432. ((0x00000FFFUL) >> ((__DAC_RESOLUTION__) << 1UL))
  433. /**
  434. * @brief Helper macro to calculate the DAC conversion data (unit: digital
  435. * value) corresponding to a voltage (unit: mVolt).
  436. * @note This helper macro is intended to provide input data in voltage
  437. * rather than digital value,
  438. * to be used with LL DAC functions such as
  439. * @ref LL_DAC_ConvertData12RightAligned().
  440. * @note Analog reference voltage (Vref+) must be either known from
  441. * user board environment or can be calculated using ADC measurement
  442. * and ADC helper macro __LL_ADC_CALC_VREFANALOG_VOLTAGE().
  443. * @param __VREFANALOG_VOLTAGE__ Analog reference voltage (unit: mV)
  444. * @param __DAC_VOLTAGE__ Voltage to be generated by DAC channel
  445. * (unit: mVolt).
  446. * @param __DAC_RESOLUTION__ This parameter can be one of the following values:
  447. * @arg @ref LL_DAC_RESOLUTION_12B
  448. * @arg @ref LL_DAC_RESOLUTION_8B
  449. * @retval DAC conversion data (unit: digital value)
  450. */
  451. #define __LL_DAC_CALC_VOLTAGE_TO_DATA(__VREFANALOG_VOLTAGE__, __DAC_VOLTAGE__, __DAC_RESOLUTION__) \
  452. ((__DAC_VOLTAGE__) * __LL_DAC_DIGITAL_SCALE(__DAC_RESOLUTION__) \
  453. / (__VREFANALOG_VOLTAGE__) \
  454. )
  455. /**
  456. * @}
  457. */
  458. /**
  459. * @}
  460. */
  461. /* Exported functions --------------------------------------------------------*/
  462. /** @defgroup DAC_LL_Exported_Functions DAC Exported Functions
  463. * @{
  464. */
  465. /** @defgroup DAC_LL_EF_Configuration Configuration of DAC channels
  466. * @{
  467. */
  468. /**
  469. * @brief Set the operating mode for the selected DAC channel:
  470. * calibration or normal operating mode.
  471. * @rmtoll CR CEN1 LL_DAC_SetMode\n
  472. * CR CEN2 LL_DAC_SetMode
  473. * @param DACx DAC instance
  474. * @param DAC_Channel This parameter can be one of the following values:
  475. * @arg @ref LL_DAC_CHANNEL_1
  476. * @arg @ref LL_DAC_CHANNEL_2
  477. * @param ChannelMode This parameter can be one of the following values:
  478. * @arg @ref LL_DAC_MODE_NORMAL_OPERATION
  479. * @arg @ref LL_DAC_MODE_CALIBRATION
  480. * @retval None
  481. */
  482. __STATIC_INLINE void LL_DAC_SetMode(DAC_TypeDef *DACx, uint32_t DAC_Channel, uint32_t ChannelMode)
  483. {
  484. MODIFY_REG(DACx->CR,
  485. DAC_CR_CEN1 << (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK),
  486. ChannelMode << (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK));
  487. }
  488. /**
  489. * @brief Get the operating mode for the selected DAC channel:
  490. * calibration or normal operating mode.
  491. * @rmtoll CR CEN1 LL_DAC_GetMode\n
  492. * CR CEN2 LL_DAC_GetMode
  493. * @param DACx DAC instance
  494. * @param DAC_Channel This parameter can be one of the following values:
  495. * @arg @ref LL_DAC_CHANNEL_1
  496. * @arg @ref LL_DAC_CHANNEL_2
  497. * @retval Returned value can be one of the following values:
  498. * @arg @ref LL_DAC_MODE_NORMAL_OPERATION
  499. * @arg @ref LL_DAC_MODE_CALIBRATION
  500. */
  501. __STATIC_INLINE uint32_t LL_DAC_GetMode(const DAC_TypeDef *DACx, uint32_t DAC_Channel)
  502. {
  503. return (uint32_t)(READ_BIT(DACx->CR, DAC_CR_CEN1 << (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK))
  504. >> (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK)
  505. );
  506. }
  507. /**
  508. * @brief Set the offset trimming value for the selected DAC channel.
  509. * Trimming has an impact when output buffer is enabled
  510. * and is intended to replace factory calibration default values.
  511. * @rmtoll CCR OTRIM1 LL_DAC_SetTrimmingValue\n
  512. * CCR OTRIM2 LL_DAC_SetTrimmingValue
  513. * @param DACx DAC instance
  514. * @param DAC_Channel This parameter can be one of the following values:
  515. * @arg @ref LL_DAC_CHANNEL_1
  516. * @arg @ref LL_DAC_CHANNEL_2
  517. * @param TrimmingValue Value between Min_Data=0x00 and Max_Data=0x1F
  518. * @retval None
  519. */
  520. __STATIC_INLINE void LL_DAC_SetTrimmingValue(DAC_TypeDef *DACx, uint32_t DAC_Channel, uint32_t TrimmingValue)
  521. {
  522. MODIFY_REG(DACx->CCR,
  523. DAC_CCR_OTRIM1 << (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK),
  524. TrimmingValue << (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK));
  525. }
  526. /**
  527. * @brief Get the offset trimming value for the selected DAC channel.
  528. * Trimming has an impact when output buffer is enabled
  529. * and is intended to replace factory calibration default values.
  530. * @rmtoll CCR OTRIM1 LL_DAC_GetTrimmingValue\n
  531. * CCR OTRIM2 LL_DAC_GetTrimmingValue
  532. * @param DACx DAC instance
  533. * @param DAC_Channel This parameter can be one of the following values:
  534. * @arg @ref LL_DAC_CHANNEL_1
  535. * @arg @ref LL_DAC_CHANNEL_2
  536. * @retval TrimmingValue Value between Min_Data=0x00 and Max_Data=0x1F
  537. */
  538. __STATIC_INLINE uint32_t LL_DAC_GetTrimmingValue(const DAC_TypeDef *DACx, uint32_t DAC_Channel)
  539. {
  540. return (uint32_t)(READ_BIT(DACx->CCR, DAC_CCR_OTRIM1 << (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK))
  541. >> (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK)
  542. );
  543. }
  544. /**
  545. * @brief Set the conversion trigger source for the selected DAC channel.
  546. * @note For conversion trigger source to be effective, DAC trigger
  547. * must be enabled using function @ref LL_DAC_EnableTrigger().
  548. * @note To set conversion trigger source, DAC channel must be disabled.
  549. * Otherwise, the setting is discarded.
  550. * @note Availability of parameters of trigger sources from timer
  551. * depends on timers availability on the selected device.
  552. * @rmtoll CR TSEL1 LL_DAC_SetTriggerSource\n
  553. * CR TSEL2 LL_DAC_SetTriggerSource
  554. * @param DACx DAC instance
  555. * @param DAC_Channel This parameter can be one of the following values:
  556. * @arg @ref LL_DAC_CHANNEL_1
  557. * @arg @ref LL_DAC_CHANNEL_2
  558. * @param TriggerSource This parameter can be one of the following values:
  559. * @arg @ref LL_DAC_TRIG_SOFTWARE
  560. * @arg @ref LL_DAC_TRIG_EXT_TIM1_TRGO
  561. * @arg @ref LL_DAC_TRIG_EXT_TIM2_TRGO
  562. * @arg @ref LL_DAC_TRIG_EXT_TIM3_TRGO
  563. * @arg @ref LL_DAC_TRIG_EXT_TIM6_TRGO
  564. * @arg @ref LL_DAC_TRIG_EXT_TIM7_TRGO
  565. * @arg @ref LL_DAC_TRIG_EXT_TIM15_TRGO
  566. * @arg @ref LL_DAC_TRIG_EXT_LPTIM1_OUT
  567. * @arg @ref LL_DAC_TRIG_EXT_LPTIM2_OUT
  568. * @arg @ref LL_DAC_TRIG_EXT_EXTI_LINE9
  569. * @retval None
  570. */
  571. __STATIC_INLINE void LL_DAC_SetTriggerSource(DAC_TypeDef *DACx, uint32_t DAC_Channel, uint32_t TriggerSource)
  572. {
  573. MODIFY_REG(DACx->CR,
  574. DAC_CR_TSEL1 << (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK),
  575. TriggerSource << (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK));
  576. }
  577. /**
  578. * @brief Get the conversion trigger source for the selected DAC channel.
  579. * @note For conversion trigger source to be effective, DAC trigger
  580. * must be enabled using function @ref LL_DAC_EnableTrigger().
  581. * @note Availability of parameters of trigger sources from timer
  582. * depends on timers availability on the selected device.
  583. * @rmtoll CR TSEL1 LL_DAC_GetTriggerSource\n
  584. * CR TSEL2 LL_DAC_GetTriggerSource
  585. * @param DACx DAC instance
  586. * @param DAC_Channel This parameter can be one of the following values:
  587. * @arg @ref LL_DAC_CHANNEL_1
  588. * @arg @ref LL_DAC_CHANNEL_2
  589. * @retval Returned value can be one of the following values:
  590. * @arg @ref LL_DAC_TRIG_SOFTWARE
  591. * @arg @ref LL_DAC_TRIG_EXT_TIM1_TRGO
  592. * @arg @ref LL_DAC_TRIG_EXT_TIM2_TRGO
  593. * @arg @ref LL_DAC_TRIG_EXT_TIM3_TRGO
  594. * @arg @ref LL_DAC_TRIG_EXT_TIM6_TRGO
  595. * @arg @ref LL_DAC_TRIG_EXT_TIM7_TRGO
  596. * @arg @ref LL_DAC_TRIG_EXT_TIM15_TRGO
  597. * @arg @ref LL_DAC_TRIG_EXT_LPTIM1_OUT
  598. * @arg @ref LL_DAC_TRIG_EXT_LPTIM2_OUT
  599. * @arg @ref LL_DAC_TRIG_EXT_EXTI_LINE9
  600. */
  601. __STATIC_INLINE uint32_t LL_DAC_GetTriggerSource(const DAC_TypeDef *DACx, uint32_t DAC_Channel)
  602. {
  603. return (uint32_t)(READ_BIT(DACx->CR, DAC_CR_TSEL1 << (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK))
  604. >> (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK)
  605. );
  606. }
  607. /**
  608. * @brief Set the waveform automatic generation mode
  609. * for the selected DAC channel.
  610. * @rmtoll CR WAVE1 LL_DAC_SetWaveAutoGeneration\n
  611. * CR WAVE2 LL_DAC_SetWaveAutoGeneration
  612. * @param DACx DAC instance
  613. * @param DAC_Channel This parameter can be one of the following values:
  614. * @arg @ref LL_DAC_CHANNEL_1
  615. * @arg @ref LL_DAC_CHANNEL_2
  616. * @param WaveAutoGeneration This parameter can be one of the following values:
  617. * @arg @ref LL_DAC_WAVE_AUTO_GENERATION_NONE
  618. * @arg @ref LL_DAC_WAVE_AUTO_GENERATION_NOISE
  619. * @arg @ref LL_DAC_WAVE_AUTO_GENERATION_TRIANGLE
  620. * @retval None
  621. */
  622. __STATIC_INLINE void LL_DAC_SetWaveAutoGeneration(DAC_TypeDef *DACx, uint32_t DAC_Channel, uint32_t WaveAutoGeneration)
  623. {
  624. MODIFY_REG(DACx->CR,
  625. DAC_CR_WAVE1 << (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK),
  626. WaveAutoGeneration << (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK));
  627. }
  628. /**
  629. * @brief Get the waveform automatic generation mode
  630. * for the selected DAC channel.
  631. * @rmtoll CR WAVE1 LL_DAC_GetWaveAutoGeneration\n
  632. * CR WAVE2 LL_DAC_GetWaveAutoGeneration
  633. * @param DACx DAC instance
  634. * @param DAC_Channel This parameter can be one of the following values:
  635. * @arg @ref LL_DAC_CHANNEL_1
  636. * @arg @ref LL_DAC_CHANNEL_2
  637. * @retval Returned value can be one of the following values:
  638. * @arg @ref LL_DAC_WAVE_AUTO_GENERATION_NONE
  639. * @arg @ref LL_DAC_WAVE_AUTO_GENERATION_NOISE
  640. * @arg @ref LL_DAC_WAVE_AUTO_GENERATION_TRIANGLE
  641. */
  642. __STATIC_INLINE uint32_t LL_DAC_GetWaveAutoGeneration(const DAC_TypeDef *DACx, uint32_t DAC_Channel)
  643. {
  644. return (uint32_t)(READ_BIT(DACx->CR, DAC_CR_WAVE1 << (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK))
  645. >> (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK)
  646. );
  647. }
  648. /**
  649. * @brief Set the noise waveform generation for the selected DAC channel:
  650. * Noise mode and parameters LFSR (linear feedback shift register).
  651. * @note For wave generation to be effective, DAC channel
  652. * wave generation mode must be enabled using
  653. * function @ref LL_DAC_SetWaveAutoGeneration().
  654. * @note This setting can be set when the selected DAC channel is disabled
  655. * (otherwise, the setting operation is ignored).
  656. * @rmtoll CR MAMP1 LL_DAC_SetWaveNoiseLFSR\n
  657. * CR MAMP2 LL_DAC_SetWaveNoiseLFSR
  658. * @param DACx DAC instance
  659. * @param DAC_Channel This parameter can be one of the following values:
  660. * @arg @ref LL_DAC_CHANNEL_1
  661. * @arg @ref LL_DAC_CHANNEL_2
  662. * @param NoiseLFSRMask This parameter can be one of the following values:
  663. * @arg @ref LL_DAC_NOISE_LFSR_UNMASK_BIT0
  664. * @arg @ref LL_DAC_NOISE_LFSR_UNMASK_BITS1_0
  665. * @arg @ref LL_DAC_NOISE_LFSR_UNMASK_BITS2_0
  666. * @arg @ref LL_DAC_NOISE_LFSR_UNMASK_BITS3_0
  667. * @arg @ref LL_DAC_NOISE_LFSR_UNMASK_BITS4_0
  668. * @arg @ref LL_DAC_NOISE_LFSR_UNMASK_BITS5_0
  669. * @arg @ref LL_DAC_NOISE_LFSR_UNMASK_BITS6_0
  670. * @arg @ref LL_DAC_NOISE_LFSR_UNMASK_BITS7_0
  671. * @arg @ref LL_DAC_NOISE_LFSR_UNMASK_BITS8_0
  672. * @arg @ref LL_DAC_NOISE_LFSR_UNMASK_BITS9_0
  673. * @arg @ref LL_DAC_NOISE_LFSR_UNMASK_BITS10_0
  674. * @arg @ref LL_DAC_NOISE_LFSR_UNMASK_BITS11_0
  675. * @retval None
  676. */
  677. __STATIC_INLINE void LL_DAC_SetWaveNoiseLFSR(DAC_TypeDef *DACx, uint32_t DAC_Channel, uint32_t NoiseLFSRMask)
  678. {
  679. MODIFY_REG(DACx->CR,
  680. DAC_CR_MAMP1 << (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK),
  681. NoiseLFSRMask << (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK));
  682. }
  683. /**
  684. * @brief Get the noise waveform generation for the selected DAC channel:
  685. * Noise mode and parameters LFSR (linear feedback shift register).
  686. * @rmtoll CR MAMP1 LL_DAC_GetWaveNoiseLFSR\n
  687. * CR MAMP2 LL_DAC_GetWaveNoiseLFSR
  688. * @param DACx DAC instance
  689. * @param DAC_Channel This parameter can be one of the following values:
  690. * @arg @ref LL_DAC_CHANNEL_1
  691. * @arg @ref LL_DAC_CHANNEL_2
  692. * @retval Returned value can be one of the following values:
  693. * @arg @ref LL_DAC_NOISE_LFSR_UNMASK_BIT0
  694. * @arg @ref LL_DAC_NOISE_LFSR_UNMASK_BITS1_0
  695. * @arg @ref LL_DAC_NOISE_LFSR_UNMASK_BITS2_0
  696. * @arg @ref LL_DAC_NOISE_LFSR_UNMASK_BITS3_0
  697. * @arg @ref LL_DAC_NOISE_LFSR_UNMASK_BITS4_0
  698. * @arg @ref LL_DAC_NOISE_LFSR_UNMASK_BITS5_0
  699. * @arg @ref LL_DAC_NOISE_LFSR_UNMASK_BITS6_0
  700. * @arg @ref LL_DAC_NOISE_LFSR_UNMASK_BITS7_0
  701. * @arg @ref LL_DAC_NOISE_LFSR_UNMASK_BITS8_0
  702. * @arg @ref LL_DAC_NOISE_LFSR_UNMASK_BITS9_0
  703. * @arg @ref LL_DAC_NOISE_LFSR_UNMASK_BITS10_0
  704. * @arg @ref LL_DAC_NOISE_LFSR_UNMASK_BITS11_0
  705. */
  706. __STATIC_INLINE uint32_t LL_DAC_GetWaveNoiseLFSR(const DAC_TypeDef *DACx, uint32_t DAC_Channel)
  707. {
  708. return (uint32_t)(READ_BIT(DACx->CR, DAC_CR_MAMP1 << (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK))
  709. >> (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK)
  710. );
  711. }
  712. /**
  713. * @brief Set the triangle waveform generation for the selected DAC channel:
  714. * triangle mode and amplitude.
  715. * @note For wave generation to be effective, DAC channel
  716. * wave generation mode must be enabled using
  717. * function @ref LL_DAC_SetWaveAutoGeneration().
  718. * @note This setting can be set when the selected DAC channel is disabled
  719. * (otherwise, the setting operation is ignored).
  720. * @rmtoll CR MAMP1 LL_DAC_SetWaveTriangleAmplitude\n
  721. * CR MAMP2 LL_DAC_SetWaveTriangleAmplitude
  722. * @param DACx DAC instance
  723. * @param DAC_Channel This parameter can be one of the following values:
  724. * @arg @ref LL_DAC_CHANNEL_1
  725. * @arg @ref LL_DAC_CHANNEL_2
  726. * @param TriangleAmplitude This parameter can be one of the following values:
  727. * @arg @ref LL_DAC_TRIANGLE_AMPLITUDE_1
  728. * @arg @ref LL_DAC_TRIANGLE_AMPLITUDE_3
  729. * @arg @ref LL_DAC_TRIANGLE_AMPLITUDE_7
  730. * @arg @ref LL_DAC_TRIANGLE_AMPLITUDE_15
  731. * @arg @ref LL_DAC_TRIANGLE_AMPLITUDE_31
  732. * @arg @ref LL_DAC_TRIANGLE_AMPLITUDE_63
  733. * @arg @ref LL_DAC_TRIANGLE_AMPLITUDE_127
  734. * @arg @ref LL_DAC_TRIANGLE_AMPLITUDE_255
  735. * @arg @ref LL_DAC_TRIANGLE_AMPLITUDE_511
  736. * @arg @ref LL_DAC_TRIANGLE_AMPLITUDE_1023
  737. * @arg @ref LL_DAC_TRIANGLE_AMPLITUDE_2047
  738. * @arg @ref LL_DAC_TRIANGLE_AMPLITUDE_4095
  739. * @retval None
  740. */
  741. __STATIC_INLINE void LL_DAC_SetWaveTriangleAmplitude(DAC_TypeDef *DACx, uint32_t DAC_Channel,
  742. uint32_t TriangleAmplitude)
  743. {
  744. MODIFY_REG(DACx->CR,
  745. DAC_CR_MAMP1 << (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK),
  746. TriangleAmplitude << (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK));
  747. }
  748. /**
  749. * @brief Get the triangle waveform generation for the selected DAC channel:
  750. * triangle mode and amplitude.
  751. * @rmtoll CR MAMP1 LL_DAC_GetWaveTriangleAmplitude\n
  752. * CR MAMP2 LL_DAC_GetWaveTriangleAmplitude
  753. * @param DACx DAC instance
  754. * @param DAC_Channel This parameter can be one of the following values:
  755. * @arg @ref LL_DAC_CHANNEL_1
  756. * @arg @ref LL_DAC_CHANNEL_2
  757. * @retval Returned value can be one of the following values:
  758. * @arg @ref LL_DAC_TRIANGLE_AMPLITUDE_1
  759. * @arg @ref LL_DAC_TRIANGLE_AMPLITUDE_3
  760. * @arg @ref LL_DAC_TRIANGLE_AMPLITUDE_7
  761. * @arg @ref LL_DAC_TRIANGLE_AMPLITUDE_15
  762. * @arg @ref LL_DAC_TRIANGLE_AMPLITUDE_31
  763. * @arg @ref LL_DAC_TRIANGLE_AMPLITUDE_63
  764. * @arg @ref LL_DAC_TRIANGLE_AMPLITUDE_127
  765. * @arg @ref LL_DAC_TRIANGLE_AMPLITUDE_255
  766. * @arg @ref LL_DAC_TRIANGLE_AMPLITUDE_511
  767. * @arg @ref LL_DAC_TRIANGLE_AMPLITUDE_1023
  768. * @arg @ref LL_DAC_TRIANGLE_AMPLITUDE_2047
  769. * @arg @ref LL_DAC_TRIANGLE_AMPLITUDE_4095
  770. */
  771. __STATIC_INLINE uint32_t LL_DAC_GetWaveTriangleAmplitude(const DAC_TypeDef *DACx, uint32_t DAC_Channel)
  772. {
  773. return (uint32_t)(READ_BIT(DACx->CR, DAC_CR_MAMP1 << (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK))
  774. >> (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK)
  775. );
  776. }
  777. /**
  778. * @brief Set the output for the selected DAC channel.
  779. * @note This function set several features:
  780. * - mode normal or sample-and-hold
  781. * - buffer
  782. * - connection to GPIO or internal path.
  783. * These features can also be set individually using
  784. * dedicated functions:
  785. * - @ref LL_DAC_SetOutputBuffer()
  786. * - @ref LL_DAC_SetOutputMode()
  787. * - @ref LL_DAC_SetOutputConnection()
  788. * @note On this STM32 series, output connection depends on output mode
  789. * (normal or sample and hold) and output buffer state.
  790. * - if output connection is set to internal path and output buffer
  791. * is enabled (whatever output mode):
  792. * output connection is also connected to GPIO pin
  793. * (both connections to GPIO pin and internal path).
  794. * - if output connection is set to GPIO pin, output buffer
  795. * is disabled, output mode set to sample and hold:
  796. * output connection is also connected to internal path
  797. * (both connections to GPIO pin and internal path).
  798. * @note Mode sample-and-hold requires an external capacitor
  799. * to be connected between DAC channel output and ground.
  800. * Capacitor value depends on load on DAC channel output and
  801. * sample-and-hold timings configured.
  802. * As indication, capacitor typical value is 100nF
  803. * (refer to device datasheet, parameter "CSH").
  804. * @rmtoll CR MODE1 LL_DAC_ConfigOutput\n
  805. * CR MODE2 LL_DAC_ConfigOutput
  806. * @param DACx DAC instance
  807. * @param DAC_Channel This parameter can be one of the following values:
  808. * @arg @ref LL_DAC_CHANNEL_1
  809. * @arg @ref LL_DAC_CHANNEL_2
  810. * @param OutputMode This parameter can be one of the following values:
  811. * @arg @ref LL_DAC_OUTPUT_MODE_NORMAL
  812. * @arg @ref LL_DAC_OUTPUT_MODE_SAMPLE_AND_HOLD
  813. * @param OutputBuffer This parameter can be one of the following values:
  814. * @arg @ref LL_DAC_OUTPUT_BUFFER_ENABLE
  815. * @arg @ref LL_DAC_OUTPUT_BUFFER_DISABLE
  816. * @param OutputConnection This parameter can be one of the following values:
  817. * @arg @ref LL_DAC_OUTPUT_CONNECT_GPIO
  818. * @arg @ref LL_DAC_OUTPUT_CONNECT_INTERNAL
  819. * @retval None
  820. */
  821. __STATIC_INLINE void LL_DAC_ConfigOutput(DAC_TypeDef *DACx, uint32_t DAC_Channel, uint32_t OutputMode,
  822. uint32_t OutputBuffer, uint32_t OutputConnection)
  823. {
  824. MODIFY_REG(DACx->MCR,
  825. (DAC_MCR_MODE1_2 | DAC_MCR_MODE1_1 | DAC_MCR_MODE1_0) << (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK),
  826. (OutputMode | OutputBuffer | OutputConnection) << (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK));
  827. }
  828. /**
  829. * @brief Set the output mode normal or sample-and-hold
  830. * for the selected DAC channel.
  831. * @note Mode sample-and-hold requires an external capacitor
  832. * to be connected between DAC channel output and ground.
  833. * Capacitor value depends on load on DAC channel output and
  834. * sample-and-hold timings configured.
  835. * As indication, capacitor typical value is 100nF
  836. * (refer to device datasheet, parameter "CSH").
  837. * @rmtoll CR MODE1 LL_DAC_SetOutputMode\n
  838. * CR MODE2 LL_DAC_SetOutputMode
  839. * @param DACx DAC instance
  840. * @param DAC_Channel This parameter can be one of the following values:
  841. * @arg @ref LL_DAC_CHANNEL_1
  842. * @arg @ref LL_DAC_CHANNEL_2
  843. * @param OutputMode This parameter can be one of the following values:
  844. * @arg @ref LL_DAC_OUTPUT_MODE_NORMAL
  845. * @arg @ref LL_DAC_OUTPUT_MODE_SAMPLE_AND_HOLD
  846. * @retval None
  847. */
  848. __STATIC_INLINE void LL_DAC_SetOutputMode(DAC_TypeDef *DACx, uint32_t DAC_Channel, uint32_t OutputMode)
  849. {
  850. MODIFY_REG(DACx->MCR,
  851. (uint32_t)DAC_MCR_MODE1_2 << (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK),
  852. OutputMode << (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK));
  853. }
  854. /**
  855. * @brief Get the output mode normal or sample-and-hold for the selected DAC channel.
  856. * @rmtoll CR MODE1 LL_DAC_GetOutputMode\n
  857. * CR MODE2 LL_DAC_GetOutputMode
  858. * @param DACx DAC instance
  859. * @param DAC_Channel This parameter can be one of the following values:
  860. * @arg @ref LL_DAC_CHANNEL_1
  861. * @arg @ref LL_DAC_CHANNEL_2
  862. * @retval Returned value can be one of the following values:
  863. * @arg @ref LL_DAC_OUTPUT_MODE_NORMAL
  864. * @arg @ref LL_DAC_OUTPUT_MODE_SAMPLE_AND_HOLD
  865. */
  866. __STATIC_INLINE uint32_t LL_DAC_GetOutputMode(const DAC_TypeDef *DACx, uint32_t DAC_Channel)
  867. {
  868. return (uint32_t)(READ_BIT(DACx->MCR, (uint32_t)DAC_MCR_MODE1_2 << (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK))
  869. >> (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK)
  870. );
  871. }
  872. /**
  873. * @brief Set the output buffer for the selected DAC channel.
  874. * @note On this STM32 series, when buffer is enabled, its offset can be
  875. * trimmed: factory calibration default values can be
  876. * replaced by user trimming values, using function
  877. * @ref LL_DAC_SetTrimmingValue().
  878. * @rmtoll CR MODE1 LL_DAC_SetOutputBuffer\n
  879. * CR MODE2 LL_DAC_SetOutputBuffer
  880. * @param DACx DAC instance
  881. * @param DAC_Channel This parameter can be one of the following values:
  882. * @arg @ref LL_DAC_CHANNEL_1
  883. * @arg @ref LL_DAC_CHANNEL_2
  884. * @param OutputBuffer This parameter can be one of the following values:
  885. * @arg @ref LL_DAC_OUTPUT_BUFFER_ENABLE
  886. * @arg @ref LL_DAC_OUTPUT_BUFFER_DISABLE
  887. * @retval None
  888. */
  889. __STATIC_INLINE void LL_DAC_SetOutputBuffer(DAC_TypeDef *DACx, uint32_t DAC_Channel, uint32_t OutputBuffer)
  890. {
  891. MODIFY_REG(DACx->MCR,
  892. (uint32_t)DAC_MCR_MODE1_1 << (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK),
  893. OutputBuffer << (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK));
  894. }
  895. /**
  896. * @brief Get the output buffer state for the selected DAC channel.
  897. * @rmtoll CR MODE1 LL_DAC_GetOutputBuffer\n
  898. * CR MODE2 LL_DAC_GetOutputBuffer
  899. * @param DACx DAC instance
  900. * @param DAC_Channel This parameter can be one of the following values:
  901. * @arg @ref LL_DAC_CHANNEL_1
  902. * @arg @ref LL_DAC_CHANNEL_2
  903. * @retval Returned value can be one of the following values:
  904. * @arg @ref LL_DAC_OUTPUT_BUFFER_ENABLE
  905. * @arg @ref LL_DAC_OUTPUT_BUFFER_DISABLE
  906. */
  907. __STATIC_INLINE uint32_t LL_DAC_GetOutputBuffer(const DAC_TypeDef *DACx, uint32_t DAC_Channel)
  908. {
  909. return (uint32_t)(READ_BIT(DACx->MCR, (uint32_t)DAC_MCR_MODE1_1 << (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK))
  910. >> (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK)
  911. );
  912. }
  913. /**
  914. * @brief Set the output connection for the selected DAC channel.
  915. * @note On this STM32 series, output connection depends on output mode (normal or
  916. * sample and hold) and output buffer state.
  917. * - if output connection is set to internal path and output buffer
  918. * is enabled (whatever output mode):
  919. * output connection is also connected to GPIO pin
  920. * (both connections to GPIO pin and internal path).
  921. * - if output connection is set to GPIO pin, output buffer
  922. * is disabled, output mode set to sample and hold:
  923. * output connection is also connected to internal path
  924. * (both connections to GPIO pin and internal path).
  925. * @rmtoll CR MODE1 LL_DAC_SetOutputConnection\n
  926. * CR MODE2 LL_DAC_SetOutputConnection
  927. * @param DACx DAC instance
  928. * @param DAC_Channel This parameter can be one of the following values:
  929. * @arg @ref LL_DAC_CHANNEL_1
  930. * @arg @ref LL_DAC_CHANNEL_2
  931. * @param OutputConnection This parameter can be one of the following values:
  932. * @arg @ref LL_DAC_OUTPUT_CONNECT_GPIO
  933. * @arg @ref LL_DAC_OUTPUT_CONNECT_INTERNAL
  934. * @retval None
  935. */
  936. __STATIC_INLINE void LL_DAC_SetOutputConnection(DAC_TypeDef *DACx, uint32_t DAC_Channel, uint32_t OutputConnection)
  937. {
  938. MODIFY_REG(DACx->MCR,
  939. (uint32_t)DAC_MCR_MODE1_0 << (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK),
  940. OutputConnection << (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK));
  941. }
  942. /**
  943. * @brief Get the output connection for the selected DAC channel.
  944. * @note On this STM32 series, output connection depends on output mode (normal or
  945. * sample and hold) and output buffer state.
  946. * - if output connection is set to internal path and output buffer
  947. * is enabled (whatever output mode):
  948. * output connection is also connected to GPIO pin
  949. * (both connections to GPIO pin and internal path).
  950. * - if output connection is set to GPIO pin, output buffer
  951. * is disabled, output mode set to sample and hold:
  952. * output connection is also connected to internal path
  953. * (both connections to GPIO pin and internal path).
  954. * @rmtoll CR MODE1 LL_DAC_GetOutputConnection\n
  955. * CR MODE2 LL_DAC_GetOutputConnection
  956. * @param DACx DAC instance
  957. * @param DAC_Channel This parameter can be one of the following values:
  958. * @arg @ref LL_DAC_CHANNEL_1
  959. * @arg @ref LL_DAC_CHANNEL_2
  960. * @retval Returned value can be one of the following values:
  961. * @arg @ref LL_DAC_OUTPUT_CONNECT_GPIO
  962. * @arg @ref LL_DAC_OUTPUT_CONNECT_INTERNAL
  963. */
  964. __STATIC_INLINE uint32_t LL_DAC_GetOutputConnection(const DAC_TypeDef *DACx, uint32_t DAC_Channel)
  965. {
  966. return (uint32_t)(READ_BIT(DACx->MCR, (uint32_t)DAC_MCR_MODE1_0 << (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK))
  967. >> (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK)
  968. );
  969. }
  970. /**
  971. * @brief Set the sample-and-hold timing for the selected DAC channel:
  972. * sample time
  973. * @note Sample time must be set when DAC channel is disabled
  974. * or during DAC operation when DAC channel flag BWSTx is reset,
  975. * otherwise the setting is ignored.
  976. * Check BWSTx flag state using function "LL_DAC_IsActiveFlag_BWSTx()".
  977. * @rmtoll SHSR1 TSAMPLE1 LL_DAC_SetSampleAndHoldSampleTime\n
  978. * SHSR2 TSAMPLE2 LL_DAC_SetSampleAndHoldSampleTime
  979. * @param DACx DAC instance
  980. * @param DAC_Channel This parameter can be one of the following values:
  981. * @arg @ref LL_DAC_CHANNEL_1
  982. * @arg @ref LL_DAC_CHANNEL_2
  983. * @param SampleTime Value between Min_Data=0x000 and Max_Data=0x3FF
  984. * @retval None
  985. */
  986. __STATIC_INLINE void LL_DAC_SetSampleAndHoldSampleTime(DAC_TypeDef *DACx, uint32_t DAC_Channel, uint32_t SampleTime)
  987. {
  988. __IO uint32_t *preg = __DAC_PTR_REG_OFFSET(DACx->SHSR1, (DAC_Channel >> DAC_REG_SHSRX_REGOFFSET_BITOFFSET_POS)
  989. & DAC_REG_SHSRX_REGOFFSET_MASK_POSBIT0);
  990. MODIFY_REG(*preg, DAC_SHSR1_TSAMPLE1, SampleTime);
  991. }
  992. /**
  993. * @brief Get the sample-and-hold timing for the selected DAC channel:
  994. * sample time
  995. * @rmtoll SHSR1 TSAMPLE1 LL_DAC_GetSampleAndHoldSampleTime\n
  996. * SHSR2 TSAMPLE2 LL_DAC_GetSampleAndHoldSampleTime
  997. * @param DACx DAC instance
  998. * @param DAC_Channel This parameter can be one of the following values:
  999. * @arg @ref LL_DAC_CHANNEL_1
  1000. * @arg @ref LL_DAC_CHANNEL_2
  1001. * @retval Value between Min_Data=0x000 and Max_Data=0x3FF
  1002. */
  1003. __STATIC_INLINE uint32_t LL_DAC_GetSampleAndHoldSampleTime(const DAC_TypeDef *DACx, uint32_t DAC_Channel)
  1004. {
  1005. __IO uint32_t const *preg = __DAC_PTR_REG_OFFSET(DACx->SHSR1, (DAC_Channel >> DAC_REG_SHSRX_REGOFFSET_BITOFFSET_POS)
  1006. & DAC_REG_SHSRX_REGOFFSET_MASK_POSBIT0);
  1007. return (uint32_t) READ_BIT(*preg, DAC_SHSR1_TSAMPLE1);
  1008. }
  1009. /**
  1010. * @brief Set the sample-and-hold timing for the selected DAC channel:
  1011. * hold time
  1012. * @rmtoll SHHR THOLD1 LL_DAC_SetSampleAndHoldHoldTime\n
  1013. * SHHR THOLD2 LL_DAC_SetSampleAndHoldHoldTime
  1014. * @param DACx DAC instance
  1015. * @param DAC_Channel This parameter can be one of the following values:
  1016. * @arg @ref LL_DAC_CHANNEL_1
  1017. * @arg @ref LL_DAC_CHANNEL_2
  1018. * @param HoldTime Value between Min_Data=0x000 and Max_Data=0x3FF
  1019. * @retval None
  1020. */
  1021. __STATIC_INLINE void LL_DAC_SetSampleAndHoldHoldTime(DAC_TypeDef *DACx, uint32_t DAC_Channel, uint32_t HoldTime)
  1022. {
  1023. MODIFY_REG(DACx->SHHR,
  1024. DAC_SHHR_THOLD1 << (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK),
  1025. HoldTime << (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK));
  1026. }
  1027. /**
  1028. * @brief Get the sample-and-hold timing for the selected DAC channel:
  1029. * hold time
  1030. * @rmtoll SHHR THOLD1 LL_DAC_GetSampleAndHoldHoldTime\n
  1031. * SHHR THOLD2 LL_DAC_GetSampleAndHoldHoldTime
  1032. * @param DACx DAC instance
  1033. * @param DAC_Channel This parameter can be one of the following values:
  1034. * @arg @ref LL_DAC_CHANNEL_1
  1035. * @arg @ref LL_DAC_CHANNEL_2
  1036. * @retval Value between Min_Data=0x000 and Max_Data=0x3FF
  1037. */
  1038. __STATIC_INLINE uint32_t LL_DAC_GetSampleAndHoldHoldTime(const DAC_TypeDef *DACx, uint32_t DAC_Channel)
  1039. {
  1040. return (uint32_t)(READ_BIT(DACx->SHHR, DAC_SHHR_THOLD1 << (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK))
  1041. >> (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK)
  1042. );
  1043. }
  1044. /**
  1045. * @brief Set the sample-and-hold timing for the selected DAC channel:
  1046. * refresh time
  1047. * @rmtoll SHRR TREFRESH1 LL_DAC_SetSampleAndHoldRefreshTime\n
  1048. * SHRR TREFRESH2 LL_DAC_SetSampleAndHoldRefreshTime
  1049. * @param DACx DAC instance
  1050. * @param DAC_Channel This parameter can be one of the following values:
  1051. * @arg @ref LL_DAC_CHANNEL_1
  1052. * @arg @ref LL_DAC_CHANNEL_2
  1053. * @param RefreshTime Value between Min_Data=0x00 and Max_Data=0xFF
  1054. * @retval None
  1055. */
  1056. __STATIC_INLINE void LL_DAC_SetSampleAndHoldRefreshTime(DAC_TypeDef *DACx, uint32_t DAC_Channel, uint32_t RefreshTime)
  1057. {
  1058. MODIFY_REG(DACx->SHRR,
  1059. DAC_SHRR_TREFRESH1 << (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK),
  1060. RefreshTime << (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK));
  1061. }
  1062. /**
  1063. * @brief Get the sample-and-hold timing for the selected DAC channel:
  1064. * refresh time
  1065. * @rmtoll SHRR TREFRESH1 LL_DAC_GetSampleAndHoldRefreshTime\n
  1066. * SHRR TREFRESH2 LL_DAC_GetSampleAndHoldRefreshTime
  1067. * @param DACx DAC instance
  1068. * @param DAC_Channel This parameter can be one of the following values:
  1069. * @arg @ref LL_DAC_CHANNEL_1
  1070. * @arg @ref LL_DAC_CHANNEL_2
  1071. * @retval Value between Min_Data=0x00 and Max_Data=0xFF
  1072. */
  1073. __STATIC_INLINE uint32_t LL_DAC_GetSampleAndHoldRefreshTime(const DAC_TypeDef *DACx, uint32_t DAC_Channel)
  1074. {
  1075. return (uint32_t)(READ_BIT(DACx->SHRR, DAC_SHRR_TREFRESH1 << (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK))
  1076. >> (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK)
  1077. );
  1078. }
  1079. /**
  1080. * @}
  1081. */
  1082. /** @defgroup DAC_LL_EF_DMA_Management DMA Management
  1083. * @{
  1084. */
  1085. /**
  1086. * @brief Enable DAC DMA transfer request of the selected channel.
  1087. * @note To configure DMA source address (peripheral address),
  1088. * use function @ref LL_DAC_DMA_GetRegAddr().
  1089. * @rmtoll CR DMAEN1 LL_DAC_EnableDMAReq\n
  1090. * CR DMAEN2 LL_DAC_EnableDMAReq
  1091. * @param DACx DAC instance
  1092. * @param DAC_Channel This parameter can be one of the following values:
  1093. * @arg @ref LL_DAC_CHANNEL_1
  1094. * @arg @ref LL_DAC_CHANNEL_2
  1095. * @retval None
  1096. */
  1097. __STATIC_INLINE void LL_DAC_EnableDMAReq(DAC_TypeDef *DACx, uint32_t DAC_Channel)
  1098. {
  1099. SET_BIT(DACx->CR,
  1100. DAC_CR_DMAEN1 << (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK));
  1101. }
  1102. /**
  1103. * @brief Disable DAC DMA transfer request of the selected channel.
  1104. * @note To configure DMA source address (peripheral address),
  1105. * use function @ref LL_DAC_DMA_GetRegAddr().
  1106. * @rmtoll CR DMAEN1 LL_DAC_DisableDMAReq\n
  1107. * CR DMAEN2 LL_DAC_DisableDMAReq
  1108. * @param DACx DAC instance
  1109. * @param DAC_Channel This parameter can be one of the following values:
  1110. * @arg @ref LL_DAC_CHANNEL_1
  1111. * @arg @ref LL_DAC_CHANNEL_2
  1112. * @retval None
  1113. */
  1114. __STATIC_INLINE void LL_DAC_DisableDMAReq(DAC_TypeDef *DACx, uint32_t DAC_Channel)
  1115. {
  1116. CLEAR_BIT(DACx->CR,
  1117. DAC_CR_DMAEN1 << (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK));
  1118. }
  1119. /**
  1120. * @brief Get DAC DMA transfer request state of the selected channel.
  1121. * (0: DAC DMA transfer request is disabled, 1: DAC DMA transfer request is enabled)
  1122. * @rmtoll CR DMAEN1 LL_DAC_IsDMAReqEnabled\n
  1123. * CR DMAEN2 LL_DAC_IsDMAReqEnabled
  1124. * @param DACx DAC instance
  1125. * @param DAC_Channel This parameter can be one of the following values:
  1126. * @arg @ref LL_DAC_CHANNEL_1
  1127. * @arg @ref LL_DAC_CHANNEL_2
  1128. * @retval State of bit (1 or 0).
  1129. */
  1130. __STATIC_INLINE uint32_t LL_DAC_IsDMAReqEnabled(const DAC_TypeDef *DACx, uint32_t DAC_Channel)
  1131. {
  1132. return ((READ_BIT(DACx->CR,
  1133. DAC_CR_DMAEN1 << (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK))
  1134. == (DAC_CR_DMAEN1 << (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK))) ? 1UL : 0UL);
  1135. }
  1136. /**
  1137. * @brief Function to help to configure DMA transfer to DAC: retrieve the
  1138. * DAC register address from DAC instance and a list of DAC registers
  1139. * intended to be used (most commonly) with DMA transfer.
  1140. * @note These DAC registers are data holding registers:
  1141. * when DAC conversion is requested, DAC generates a DMA transfer
  1142. * request to have data available in DAC data holding registers.
  1143. * @note This macro is intended to be used with LL DMA driver, refer to
  1144. * function "LL_DMA_ConfigAddresses()".
  1145. * Example:
  1146. * LL_DMA_ConfigAddresses(DMA1,
  1147. * LL_DMA_CHANNEL_1,
  1148. * (uint32_t)&< array or variable >,
  1149. * LL_DAC_DMA_GetRegAddr(DAC1, LL_DAC_CHANNEL_1,
  1150. * LL_DAC_DMA_REG_DATA_12BITS_RIGHT_ALIGNED),
  1151. * LL_DMA_DIRECTION_MEMORY_TO_PERIPH);
  1152. * @rmtoll DHR12R1 DACC1DHR LL_DAC_DMA_GetRegAddr\n
  1153. * DHR12L1 DACC1DHR LL_DAC_DMA_GetRegAddr\n
  1154. * DHR8R1 DACC1DHR LL_DAC_DMA_GetRegAddr\n
  1155. * DHR12R2 DACC2DHR LL_DAC_DMA_GetRegAddr\n
  1156. * DHR12L2 DACC2DHR LL_DAC_DMA_GetRegAddr\n
  1157. * DHR8R2 DACC2DHR LL_DAC_DMA_GetRegAddr
  1158. * @param DACx DAC instance
  1159. * @param DAC_Channel This parameter can be one of the following values:
  1160. * @arg @ref LL_DAC_CHANNEL_1
  1161. * @arg @ref LL_DAC_CHANNEL_2
  1162. * @param Register This parameter can be one of the following values:
  1163. * @arg @ref LL_DAC_DMA_REG_DATA_12BITS_RIGHT_ALIGNED
  1164. * @arg @ref LL_DAC_DMA_REG_DATA_12BITS_LEFT_ALIGNED
  1165. * @arg @ref LL_DAC_DMA_REG_DATA_8BITS_RIGHT_ALIGNED
  1166. * @retval DAC register address
  1167. */
  1168. __STATIC_INLINE uint32_t LL_DAC_DMA_GetRegAddr(const DAC_TypeDef *DACx, uint32_t DAC_Channel, uint32_t Register)
  1169. {
  1170. /* Retrieve address of register DHR12Rx, DHR12Lx or DHR8Rx depending on */
  1171. /* DAC channel selected. */
  1172. return ((uint32_t)(__DAC_PTR_REG_OFFSET((DACx)->DHR12R1, ((DAC_Channel >> (Register & 0x1FUL))
  1173. & DAC_REG_DHR_REGOFFSET_MASK_POSBIT0))));
  1174. }
  1175. /**
  1176. * @}
  1177. */
  1178. /** @defgroup DAC_LL_EF_Operation Operation on DAC channels
  1179. * @{
  1180. */
  1181. /**
  1182. * @brief Enable DAC selected channel.
  1183. * @rmtoll CR EN1 LL_DAC_Enable\n
  1184. * CR EN2 LL_DAC_Enable
  1185. * @note After enable from off state, DAC channel requires a delay
  1186. * for output voltage to reach accuracy +/- 1 LSB.
  1187. * Refer to device datasheet, parameter "tWAKEUP".
  1188. * @param DACx DAC instance
  1189. * @param DAC_Channel This parameter can be one of the following values:
  1190. * @arg @ref LL_DAC_CHANNEL_1
  1191. * @arg @ref LL_DAC_CHANNEL_2
  1192. * @retval None
  1193. */
  1194. __STATIC_INLINE void LL_DAC_Enable(DAC_TypeDef *DACx, uint32_t DAC_Channel)
  1195. {
  1196. SET_BIT(DACx->CR,
  1197. DAC_CR_EN1 << (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK));
  1198. }
  1199. /**
  1200. * @brief Disable DAC selected channel.
  1201. * @rmtoll CR EN1 LL_DAC_Disable\n
  1202. * CR EN2 LL_DAC_Disable
  1203. * @param DACx DAC instance
  1204. * @param DAC_Channel This parameter can be one of the following values:
  1205. * @arg @ref LL_DAC_CHANNEL_1
  1206. * @arg @ref LL_DAC_CHANNEL_2
  1207. * @retval None
  1208. */
  1209. __STATIC_INLINE void LL_DAC_Disable(DAC_TypeDef *DACx, uint32_t DAC_Channel)
  1210. {
  1211. CLEAR_BIT(DACx->CR,
  1212. DAC_CR_EN1 << (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK));
  1213. }
  1214. /**
  1215. * @brief Get DAC enable state of the selected channel.
  1216. * (0: DAC channel is disabled, 1: DAC channel is enabled)
  1217. * @rmtoll CR EN1 LL_DAC_IsEnabled\n
  1218. * CR EN2 LL_DAC_IsEnabled
  1219. * @param DACx DAC instance
  1220. * @param DAC_Channel This parameter can be one of the following values:
  1221. * @arg @ref LL_DAC_CHANNEL_1
  1222. * @arg @ref LL_DAC_CHANNEL_2
  1223. * @retval State of bit (1 or 0).
  1224. */
  1225. __STATIC_INLINE uint32_t LL_DAC_IsEnabled(const DAC_TypeDef *DACx, uint32_t DAC_Channel)
  1226. {
  1227. return ((READ_BIT(DACx->CR,
  1228. DAC_CR_EN1 << (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK))
  1229. == (DAC_CR_EN1 << (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK))) ? 1UL : 0UL);
  1230. }
  1231. /**
  1232. * @brief Enable DAC trigger of the selected channel.
  1233. * @note - If DAC trigger is disabled, DAC conversion is performed
  1234. * automatically once the data holding register is updated,
  1235. * using functions "LL_DAC_ConvertData{8; 12}{Right; Left} Aligned()":
  1236. * @ref LL_DAC_ConvertData12RightAligned(), ...
  1237. * - If DAC trigger is enabled, DAC conversion is performed
  1238. * only when a hardware of software trigger event is occurring.
  1239. * Select trigger source using
  1240. * function @ref LL_DAC_SetTriggerSource().
  1241. * @rmtoll CR TEN1 LL_DAC_EnableTrigger\n
  1242. * CR TEN2 LL_DAC_EnableTrigger
  1243. * @param DACx DAC instance
  1244. * @param DAC_Channel This parameter can be one of the following values:
  1245. * @arg @ref LL_DAC_CHANNEL_1
  1246. * @arg @ref LL_DAC_CHANNEL_2
  1247. * @retval None
  1248. */
  1249. __STATIC_INLINE void LL_DAC_EnableTrigger(DAC_TypeDef *DACx, uint32_t DAC_Channel)
  1250. {
  1251. SET_BIT(DACx->CR,
  1252. DAC_CR_TEN1 << (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK));
  1253. }
  1254. /**
  1255. * @brief Disable DAC trigger of the selected channel.
  1256. * @rmtoll CR TEN1 LL_DAC_DisableTrigger\n
  1257. * CR TEN2 LL_DAC_DisableTrigger
  1258. * @param DACx DAC instance
  1259. * @param DAC_Channel This parameter can be one of the following values:
  1260. * @arg @ref LL_DAC_CHANNEL_1
  1261. * @arg @ref LL_DAC_CHANNEL_2
  1262. * @retval None
  1263. */
  1264. __STATIC_INLINE void LL_DAC_DisableTrigger(DAC_TypeDef *DACx, uint32_t DAC_Channel)
  1265. {
  1266. CLEAR_BIT(DACx->CR,
  1267. DAC_CR_TEN1 << (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK));
  1268. }
  1269. /**
  1270. * @brief Get DAC trigger state of the selected channel.
  1271. * (0: DAC trigger is disabled, 1: DAC trigger is enabled)
  1272. * @rmtoll CR TEN1 LL_DAC_IsTriggerEnabled\n
  1273. * CR TEN2 LL_DAC_IsTriggerEnabled
  1274. * @param DACx DAC instance
  1275. * @param DAC_Channel This parameter can be one of the following values:
  1276. * @arg @ref LL_DAC_CHANNEL_1
  1277. * @arg @ref LL_DAC_CHANNEL_2
  1278. * @retval State of bit (1 or 0).
  1279. */
  1280. __STATIC_INLINE uint32_t LL_DAC_IsTriggerEnabled(const DAC_TypeDef *DACx, uint32_t DAC_Channel)
  1281. {
  1282. return ((READ_BIT(DACx->CR,
  1283. DAC_CR_TEN1 << (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK))
  1284. == (DAC_CR_TEN1 << (DAC_Channel & DAC_CR_CHX_BITOFFSET_MASK))) ? 1UL : 0UL);
  1285. }
  1286. /**
  1287. * @brief Trig DAC conversion by software for the selected DAC channel.
  1288. * @note Preliminarily, DAC trigger must be set to software trigger
  1289. * using function
  1290. * @ref LL_DAC_Init()
  1291. * @ref LL_DAC_SetTriggerSource()
  1292. * with parameter "LL_DAC_TRIGGER_SOFTWARE".
  1293. * and DAC trigger must be enabled using
  1294. * function @ref LL_DAC_EnableTrigger().
  1295. * @note For devices featuring DAC with 2 channels: this function
  1296. * can perform a SW start of both DAC channels simultaneously.
  1297. * Two channels can be selected as parameter.
  1298. * Example: (LL_DAC_CHANNEL_1 | LL_DAC_CHANNEL_2)
  1299. * @rmtoll SWTRIGR SWTRIG1 LL_DAC_TrigSWConversion\n
  1300. * SWTRIGR SWTRIG2 LL_DAC_TrigSWConversion
  1301. * @param DACx DAC instance
  1302. * @param DAC_Channel This parameter can a combination of the following values:
  1303. * @arg @ref LL_DAC_CHANNEL_1
  1304. * @arg @ref LL_DAC_CHANNEL_2
  1305. * @retval None
  1306. */
  1307. __STATIC_INLINE void LL_DAC_TrigSWConversion(DAC_TypeDef *DACx, uint32_t DAC_Channel)
  1308. {
  1309. SET_BIT(DACx->SWTRIGR,
  1310. (DAC_Channel & DAC_SWTR_CHX_MASK));
  1311. }
  1312. /**
  1313. * @brief Set the data to be loaded in the data holding register
  1314. * in format 12 bits left alignment (LSB aligned on bit 0),
  1315. * for the selected DAC channel.
  1316. * @rmtoll DHR12R1 DACC1DHR LL_DAC_ConvertData12RightAligned\n
  1317. * DHR12R2 DACC2DHR LL_DAC_ConvertData12RightAligned
  1318. * @param DACx DAC instance
  1319. * @param DAC_Channel This parameter can be one of the following values:
  1320. * @arg @ref LL_DAC_CHANNEL_1
  1321. * @arg @ref LL_DAC_CHANNEL_2
  1322. * @param Data Value between Min_Data=0x000 and Max_Data=0xFFF
  1323. * @retval None
  1324. */
  1325. __STATIC_INLINE void LL_DAC_ConvertData12RightAligned(DAC_TypeDef *DACx, uint32_t DAC_Channel, uint32_t Data)
  1326. {
  1327. __IO uint32_t *preg = __DAC_PTR_REG_OFFSET(DACx->DHR12R1, (DAC_Channel >> DAC_REG_DHR12RX_REGOFFSET_BITOFFSET_POS)
  1328. & DAC_REG_DHR_REGOFFSET_MASK_POSBIT0);
  1329. MODIFY_REG(*preg, DAC_DHR12R1_DACC1DHR, Data);
  1330. }
  1331. /**
  1332. * @brief Set the data to be loaded in the data holding register
  1333. * in format 12 bits left alignment (MSB aligned on bit 15),
  1334. * for the selected DAC channel.
  1335. * @rmtoll DHR12L1 DACC1DHR LL_DAC_ConvertData12LeftAligned\n
  1336. * DHR12L2 DACC2DHR LL_DAC_ConvertData12LeftAligned
  1337. * @param DACx DAC instance
  1338. * @param DAC_Channel This parameter can be one of the following values:
  1339. * @arg @ref LL_DAC_CHANNEL_1
  1340. * @arg @ref LL_DAC_CHANNEL_2
  1341. * @param Data Value between Min_Data=0x000 and Max_Data=0xFFF
  1342. * @retval None
  1343. */
  1344. __STATIC_INLINE void LL_DAC_ConvertData12LeftAligned(DAC_TypeDef *DACx, uint32_t DAC_Channel, uint32_t Data)
  1345. {
  1346. __IO uint32_t *preg = __DAC_PTR_REG_OFFSET(DACx->DHR12R1, (DAC_Channel >> DAC_REG_DHR12LX_REGOFFSET_BITOFFSET_POS)
  1347. & DAC_REG_DHR_REGOFFSET_MASK_POSBIT0);
  1348. MODIFY_REG(*preg, DAC_DHR12L1_DACC1DHR, Data);
  1349. }
  1350. /**
  1351. * @brief Set the data to be loaded in the data holding register
  1352. * in format 8 bits left alignment (LSB aligned on bit 0),
  1353. * for the selected DAC channel.
  1354. * @rmtoll DHR8R1 DACC1DHR LL_DAC_ConvertData8RightAligned\n
  1355. * DHR8R2 DACC2DHR LL_DAC_ConvertData8RightAligned
  1356. * @param DACx DAC instance
  1357. * @param DAC_Channel This parameter can be one of the following values:
  1358. * @arg @ref LL_DAC_CHANNEL_1
  1359. * @arg @ref LL_DAC_CHANNEL_2
  1360. * @param Data Value between Min_Data=0x00 and Max_Data=0xFF
  1361. * @retval None
  1362. */
  1363. __STATIC_INLINE void LL_DAC_ConvertData8RightAligned(DAC_TypeDef *DACx, uint32_t DAC_Channel, uint32_t Data)
  1364. {
  1365. __IO uint32_t *preg = __DAC_PTR_REG_OFFSET(DACx->DHR12R1, (DAC_Channel >> DAC_REG_DHR8RX_REGOFFSET_BITOFFSET_POS)
  1366. & DAC_REG_DHR_REGOFFSET_MASK_POSBIT0);
  1367. MODIFY_REG(*preg, DAC_DHR8R1_DACC1DHR, Data);
  1368. }
  1369. /**
  1370. * @brief Set the data to be loaded in the data holding register
  1371. * in format 12 bits left alignment (LSB aligned on bit 0),
  1372. * for both DAC channels.
  1373. * @rmtoll DHR12RD DACC1DHR LL_DAC_ConvertDualData12RightAligned\n
  1374. * DHR12RD DACC2DHR LL_DAC_ConvertDualData12RightAligned
  1375. * @param DACx DAC instance
  1376. * @param DataChannel1 Value between Min_Data=0x000 and Max_Data=0xFFF
  1377. * @param DataChannel2 Value between Min_Data=0x000 and Max_Data=0xFFF
  1378. * @retval None
  1379. */
  1380. __STATIC_INLINE void LL_DAC_ConvertDualData12RightAligned(DAC_TypeDef *DACx, uint32_t DataChannel1,
  1381. uint32_t DataChannel2)
  1382. {
  1383. MODIFY_REG(DACx->DHR12RD,
  1384. (DAC_DHR12RD_DACC2DHR | DAC_DHR12RD_DACC1DHR),
  1385. ((DataChannel2 << DAC_DHR12RD_DACC2DHR_BITOFFSET_POS) | DataChannel1));
  1386. }
  1387. /**
  1388. * @brief Set the data to be loaded in the data holding register
  1389. * in format 12 bits left alignment (MSB aligned on bit 15),
  1390. * for both DAC channels.
  1391. * @rmtoll DHR12LD DACC1DHR LL_DAC_ConvertDualData12LeftAligned\n
  1392. * DHR12LD DACC2DHR LL_DAC_ConvertDualData12LeftAligned
  1393. * @param DACx DAC instance
  1394. * @param DataChannel1 Value between Min_Data=0x000 and Max_Data=0xFFF
  1395. * @param DataChannel2 Value between Min_Data=0x000 and Max_Data=0xFFF
  1396. * @retval None
  1397. */
  1398. __STATIC_INLINE void LL_DAC_ConvertDualData12LeftAligned(DAC_TypeDef *DACx, uint32_t DataChannel1,
  1399. uint32_t DataChannel2)
  1400. {
  1401. /* Note: Data of DAC channel 2 shift value subtracted of 4 because */
  1402. /* data on 16 bits and DAC channel 2 bits field is on the 12 MSB, */
  1403. /* the 4 LSB must be taken into account for the shift value. */
  1404. MODIFY_REG(DACx->DHR12LD,
  1405. (DAC_DHR12LD_DACC2DHR | DAC_DHR12LD_DACC1DHR),
  1406. ((DataChannel2 << (DAC_DHR12LD_DACC2DHR_BITOFFSET_POS - 4U)) | DataChannel1));
  1407. }
  1408. /**
  1409. * @brief Set the data to be loaded in the data holding register
  1410. * in format 8 bits left alignment (LSB aligned on bit 0),
  1411. * for both DAC channels.
  1412. * @rmtoll DHR8RD DACC1DHR LL_DAC_ConvertDualData8RightAligned\n
  1413. * DHR8RD DACC2DHR LL_DAC_ConvertDualData8RightAligned
  1414. * @param DACx DAC instance
  1415. * @param DataChannel1 Value between Min_Data=0x00 and Max_Data=0xFF
  1416. * @param DataChannel2 Value between Min_Data=0x00 and Max_Data=0xFF
  1417. * @retval None
  1418. */
  1419. __STATIC_INLINE void LL_DAC_ConvertDualData8RightAligned(DAC_TypeDef *DACx, uint32_t DataChannel1,
  1420. uint32_t DataChannel2)
  1421. {
  1422. MODIFY_REG(DACx->DHR8RD,
  1423. (DAC_DHR8RD_DACC2DHR | DAC_DHR8RD_DACC1DHR),
  1424. ((DataChannel2 << DAC_DHR8RD_DACC2DHR_BITOFFSET_POS) | DataChannel1));
  1425. }
  1426. /**
  1427. * @brief Retrieve output data currently generated for the selected DAC channel.
  1428. * @note Whatever alignment and resolution settings
  1429. * (using functions "LL_DAC_ConvertData{8; 12}{Right; Left} Aligned()":
  1430. * @ref LL_DAC_ConvertData12RightAligned(), ...),
  1431. * output data format is 12 bits right aligned (LSB aligned on bit 0).
  1432. * @rmtoll DOR1 DACC1DOR LL_DAC_RetrieveOutputData\n
  1433. * DOR2 DACC2DOR LL_DAC_RetrieveOutputData
  1434. * @param DACx DAC instance
  1435. * @param DAC_Channel This parameter can be one of the following values:
  1436. * @arg @ref LL_DAC_CHANNEL_1
  1437. * @arg @ref LL_DAC_CHANNEL_2
  1438. * @retval Value between Min_Data=0x000 and Max_Data=0xFFF
  1439. */
  1440. __STATIC_INLINE uint32_t LL_DAC_RetrieveOutputData(const DAC_TypeDef *DACx, uint32_t DAC_Channel)
  1441. {
  1442. __IO uint32_t const *preg = __DAC_PTR_REG_OFFSET(DACx->DOR1, (DAC_Channel >> DAC_REG_DORX_REGOFFSET_BITOFFSET_POS)
  1443. & DAC_REG_DORX_REGOFFSET_MASK_POSBIT0);
  1444. return (uint16_t) READ_BIT(*preg, DAC_DOR1_DACC1DOR);
  1445. }
  1446. /**
  1447. * @}
  1448. */
  1449. /** @defgroup DAC_LL_EF_FLAG_Management FLAG Management
  1450. * @{
  1451. */
  1452. /**
  1453. * @brief Get DAC calibration offset flag for DAC channel 1
  1454. * @rmtoll SR CAL_FLAG1 LL_DAC_IsActiveFlag_CAL1
  1455. * @param DACx DAC instance
  1456. * @retval State of bit (1 or 0).
  1457. */
  1458. __STATIC_INLINE uint32_t LL_DAC_IsActiveFlag_CAL1(const DAC_TypeDef *DACx)
  1459. {
  1460. return ((READ_BIT(DACx->SR, LL_DAC_FLAG_CAL1) == (LL_DAC_FLAG_CAL1)) ? 1UL : 0UL);
  1461. }
  1462. /**
  1463. * @brief Get DAC calibration offset flag for DAC channel 2
  1464. * @rmtoll SR CAL_FLAG2 LL_DAC_IsActiveFlag_CAL2
  1465. * @param DACx DAC instance
  1466. * @retval State of bit (1 or 0).
  1467. */
  1468. __STATIC_INLINE uint32_t LL_DAC_IsActiveFlag_CAL2(const DAC_TypeDef *DACx)
  1469. {
  1470. return ((READ_BIT(DACx->SR, LL_DAC_FLAG_CAL2) == (LL_DAC_FLAG_CAL2)) ? 1UL : 0UL);
  1471. }
  1472. /**
  1473. * @brief Get DAC busy writing sample time flag for DAC channel 1
  1474. * @rmtoll SR BWST1 LL_DAC_IsActiveFlag_BWST1
  1475. * @param DACx DAC instance
  1476. * @retval State of bit (1 or 0).
  1477. */
  1478. __STATIC_INLINE uint32_t LL_DAC_IsActiveFlag_BWST1(const DAC_TypeDef *DACx)
  1479. {
  1480. return ((READ_BIT(DACx->SR, LL_DAC_FLAG_BWST1) == (LL_DAC_FLAG_BWST1)) ? 1UL : 0UL);
  1481. }
  1482. /**
  1483. * @brief Get DAC busy writing sample time flag for DAC channel 2
  1484. * @rmtoll SR BWST2 LL_DAC_IsActiveFlag_BWST2
  1485. * @param DACx DAC instance
  1486. * @retval State of bit (1 or 0).
  1487. */
  1488. __STATIC_INLINE uint32_t LL_DAC_IsActiveFlag_BWST2(const DAC_TypeDef *DACx)
  1489. {
  1490. return ((READ_BIT(DACx->SR, LL_DAC_FLAG_BWST2) == (LL_DAC_FLAG_BWST2)) ? 1UL : 0UL);
  1491. }
  1492. /**
  1493. * @brief Get DAC underrun flag for DAC channel 1
  1494. * @rmtoll SR DMAUDR1 LL_DAC_IsActiveFlag_DMAUDR1
  1495. * @param DACx DAC instance
  1496. * @retval State of bit (1 or 0).
  1497. */
  1498. __STATIC_INLINE uint32_t LL_DAC_IsActiveFlag_DMAUDR1(const DAC_TypeDef *DACx)
  1499. {
  1500. return ((READ_BIT(DACx->SR, LL_DAC_FLAG_DMAUDR1) == (LL_DAC_FLAG_DMAUDR1)) ? 1UL : 0UL);
  1501. }
  1502. /**
  1503. * @brief Get DAC underrun flag for DAC channel 2
  1504. * @rmtoll SR DMAUDR2 LL_DAC_IsActiveFlag_DMAUDR2
  1505. * @param DACx DAC instance
  1506. * @retval State of bit (1 or 0).
  1507. */
  1508. __STATIC_INLINE uint32_t LL_DAC_IsActiveFlag_DMAUDR2(const DAC_TypeDef *DACx)
  1509. {
  1510. return ((READ_BIT(DACx->SR, LL_DAC_FLAG_DMAUDR2) == (LL_DAC_FLAG_DMAUDR2)) ? 1UL : 0UL);
  1511. }
  1512. /**
  1513. * @brief Clear DAC underrun flag for DAC channel 1
  1514. * @rmtoll SR DMAUDR1 LL_DAC_ClearFlag_DMAUDR1
  1515. * @param DACx DAC instance
  1516. * @retval None
  1517. */
  1518. __STATIC_INLINE void LL_DAC_ClearFlag_DMAUDR1(DAC_TypeDef *DACx)
  1519. {
  1520. WRITE_REG(DACx->SR, LL_DAC_FLAG_DMAUDR1);
  1521. }
  1522. /**
  1523. * @brief Clear DAC underrun flag for DAC channel 2
  1524. * @rmtoll SR DMAUDR2 LL_DAC_ClearFlag_DMAUDR2
  1525. * @param DACx DAC instance
  1526. * @retval None
  1527. */
  1528. __STATIC_INLINE void LL_DAC_ClearFlag_DMAUDR2(DAC_TypeDef *DACx)
  1529. {
  1530. WRITE_REG(DACx->SR, LL_DAC_FLAG_DMAUDR2);
  1531. }
  1532. /**
  1533. * @}
  1534. */
  1535. /** @defgroup DAC_LL_EF_IT_Management IT management
  1536. * @{
  1537. */
  1538. /**
  1539. * @brief Enable DMA underrun interrupt for DAC channel 1
  1540. * @rmtoll CR DMAUDRIE1 LL_DAC_EnableIT_DMAUDR1
  1541. * @param DACx DAC instance
  1542. * @retval None
  1543. */
  1544. __STATIC_INLINE void LL_DAC_EnableIT_DMAUDR1(DAC_TypeDef *DACx)
  1545. {
  1546. SET_BIT(DACx->CR, LL_DAC_IT_DMAUDRIE1);
  1547. }
  1548. /**
  1549. * @brief Enable DMA underrun interrupt for DAC channel 2
  1550. * @rmtoll CR DMAUDRIE2 LL_DAC_EnableIT_DMAUDR2
  1551. * @param DACx DAC instance
  1552. * @retval None
  1553. */
  1554. __STATIC_INLINE void LL_DAC_EnableIT_DMAUDR2(DAC_TypeDef *DACx)
  1555. {
  1556. SET_BIT(DACx->CR, LL_DAC_IT_DMAUDRIE2);
  1557. }
  1558. /**
  1559. * @brief Disable DMA underrun interrupt for DAC channel 1
  1560. * @rmtoll CR DMAUDRIE1 LL_DAC_DisableIT_DMAUDR1
  1561. * @param DACx DAC instance
  1562. * @retval None
  1563. */
  1564. __STATIC_INLINE void LL_DAC_DisableIT_DMAUDR1(DAC_TypeDef *DACx)
  1565. {
  1566. CLEAR_BIT(DACx->CR, LL_DAC_IT_DMAUDRIE1);
  1567. }
  1568. /**
  1569. * @brief Disable DMA underrun interrupt for DAC channel 2
  1570. * @rmtoll CR DMAUDRIE2 LL_DAC_DisableIT_DMAUDR2
  1571. * @param DACx DAC instance
  1572. * @retval None
  1573. */
  1574. __STATIC_INLINE void LL_DAC_DisableIT_DMAUDR2(DAC_TypeDef *DACx)
  1575. {
  1576. CLEAR_BIT(DACx->CR, LL_DAC_IT_DMAUDRIE2);
  1577. }
  1578. /**
  1579. * @brief Get DMA underrun interrupt for DAC channel 1
  1580. * @rmtoll CR DMAUDRIE1 LL_DAC_IsEnabledIT_DMAUDR1
  1581. * @param DACx DAC instance
  1582. * @retval State of bit (1 or 0).
  1583. */
  1584. __STATIC_INLINE uint32_t LL_DAC_IsEnabledIT_DMAUDR1(const DAC_TypeDef *DACx)
  1585. {
  1586. return ((READ_BIT(DACx->CR, LL_DAC_IT_DMAUDRIE1) == (LL_DAC_IT_DMAUDRIE1)) ? 1UL : 0UL);
  1587. }
  1588. /**
  1589. * @brief Get DMA underrun interrupt for DAC channel 2
  1590. * @rmtoll CR DMAUDRIE2 LL_DAC_IsEnabledIT_DMAUDR2
  1591. * @param DACx DAC instance
  1592. * @retval State of bit (1 or 0).
  1593. */
  1594. __STATIC_INLINE uint32_t LL_DAC_IsEnabledIT_DMAUDR2(const DAC_TypeDef *DACx)
  1595. {
  1596. return ((READ_BIT(DACx->CR, LL_DAC_IT_DMAUDRIE2) == (LL_DAC_IT_DMAUDRIE2)) ? 1UL : 0UL);
  1597. }
  1598. /**
  1599. * @}
  1600. */
  1601. #if defined(USE_FULL_LL_DRIVER)
  1602. /** @defgroup DAC_LL_EF_Init Initialization and de-initialization functions
  1603. * @{
  1604. */
  1605. ErrorStatus LL_DAC_DeInit(const DAC_TypeDef *DACx);
  1606. ErrorStatus LL_DAC_Init(DAC_TypeDef *DACx, uint32_t DAC_Channel, const LL_DAC_InitTypeDef *DAC_InitStruct);
  1607. void LL_DAC_StructInit(LL_DAC_InitTypeDef *DAC_InitStruct);
  1608. /**
  1609. * @}
  1610. */
  1611. #endif /* USE_FULL_LL_DRIVER */
  1612. /**
  1613. * @}
  1614. */
  1615. /**
  1616. * @}
  1617. */
  1618. #endif /* DAC1 */
  1619. /**
  1620. * @}
  1621. */
  1622. #ifdef __cplusplus
  1623. }
  1624. #endif
  1625. #endif /* STM32G0xx_LL_DAC_H */