mbed official / mbed-src

mbed library sources

Dependents:   Encrypted my_mbed lklk CyaSSL_DTLS_Cellular ... more

Superseded

This library was superseded by mbed-dev - https://os.mbed.com/users/mbed_official/code/mbed-dev/.

Development branch of the mbed library sources. This library is kept in synch with the latest changes from the mbed SDK and it is not guaranteed to work.

If you are looking for a stable and tested release, please import one of the official mbed library releases:

Import librarymbed

The official Mbed 2 C/C++ SDK provides the software platform and libraries to build your applications.

Last commit 20 Feb 2019 by mbed official

targets/cmsis/TARGET_STM/TARGET_NUCLEO_F401RE/stm32f4xx_hal_dac.c@87:085cde657901, 2014-02-08 (annotated)

Committer:
mbed_official
Date:
Sat Feb 08 19:45:06 2014 +0000
Revision:
87:085cde657901
Child:
106:ced8cbb51063
Synchronized with git revision 9272cdeb45ec7e6077641536509413da8fd2ebc2



Full URL: https://github.com/mbedmicro/mbed/commit/9272cdeb45ec7e6077641536509413da8fd2ebc2/



Add NUCLEO_F401RE, improvements

Who changed what in which revision?

UserRevisionLine numberNew contents of line
mbed_official 87:085cde657901 1 /**
mbed_official 87:085cde657901 2 ******************************************************************************
mbed_official 87:085cde657901 3 * @file stm32f4xx_hal_dac.c
mbed_official 87:085cde657901 4 * @author MCD Application Team
mbed_official 87:085cde657901 5 * @version V1.0.0RC2
mbed_official 87:085cde657901 6 * @date 04-February-2014
mbed_official 87:085cde657901 7 * @brief DAC HAL module driver.
mbed_official 87:085cde657901 8 * This file provides firmware functions to manage the following
mbed_official 87:085cde657901 9 * functionalities of the Digital to Analog Converter (DAC) peripheral:
mbed_official 87:085cde657901 10 * + Initialization and de-initialization functions
mbed_official 87:085cde657901 11 * + IO operation functions
mbed_official 87:085cde657901 12 * + Peripheral Control functions
mbed_official 87:085cde657901 13 * + Peripheral State and Errors functions
mbed_official 87:085cde657901 14 *
mbed_official 87:085cde657901 15 *
mbed_official 87:085cde657901 16 @verbatim
mbed_official 87:085cde657901 17 ==============================================================================
mbed_official 87:085cde657901 18 ##### DAC Peripheral features #####
mbed_official 87:085cde657901 19 ==============================================================================
mbed_official 87:085cde657901 20 [..]
mbed_official 87:085cde657901 21 *** DAC Channels ***
mbed_official 87:085cde657901 22 ====================
mbed_official 87:085cde657901 23 [..]
mbed_official 87:085cde657901 24 The device integrates two 12-bit Digital Analog Converters that can
mbed_official 87:085cde657901 25 be used independently or simultaneously (dual mode):
mbed_official 87:085cde657901 26 (#) DAC channel1 with DAC_OUT1 (PA4) as output
mbed_official 87:085cde657901 27 (#) DAC channel2 with DAC_OUT2 (PA5) as output
mbed_official 87:085cde657901 28
mbed_official 87:085cde657901 29 *** DAC Triggers ***
mbed_official 87:085cde657901 30 ====================
mbed_official 87:085cde657901 31 [..]
mbed_official 87:085cde657901 32 Digital to Analog conversion can be non-triggered using DAC_Trigger_None
mbed_official 87:085cde657901 33 and DAC_OUT1/DAC_OUT2 is available once writing to DHRx register.
mbed_official 87:085cde657901 34 [..]
mbed_official 87:085cde657901 35 Digital to Analog conversion can be triggered by:
mbed_official 87:085cde657901 36 (#) External event: EXTI Line 9 (any GPIOx_Pin9) using DAC_Trigger_Ext_IT9.
mbed_official 87:085cde657901 37 The used pin (GPIOx_Pin9) must be configured in input mode.
mbed_official 87:085cde657901 38
mbed_official 87:085cde657901 39 (#) Timers TRGO: TIM2, TIM4, TIM5, TIM6, TIM7 and TIM8
mbed_official 87:085cde657901 40 (DAC_Trigger_T2_TRGO, DAC_Trigger_T4_TRGO...)
mbed_official 87:085cde657901 41
mbed_official 87:085cde657901 42 (#) Software using DAC_Trigger_Software
mbed_official 87:085cde657901 43
mbed_official 87:085cde657901 44 *** DAC Buffer mode feature ***
mbed_official 87:085cde657901 45 ===============================
mbed_official 87:085cde657901 46 [..]
mbed_official 87:085cde657901 47 Each DAC channel integrates an output buffer that can be used to
mbed_official 87:085cde657901 48 reduce the output impedance, and to drive external loads directly
mbed_official 87:085cde657901 49 without having to add an external operational amplifier.
mbed_official 87:085cde657901 50 To enable, the output buffer use
mbed_official 87:085cde657901 51 sConfig.DAC_OutputBuffer = DAC_OutputBuffer_Enable;
mbed_official 87:085cde657901 52 [..]
mbed_official 87:085cde657901 53 (@) Refer to the device datasheet for more details about output
mbed_official 87:085cde657901 54 impedance value with and without output buffer.
mbed_official 87:085cde657901 55
mbed_official 87:085cde657901 56 *** DAC wave generation feature ***
mbed_official 87:085cde657901 57 ===================================
mbed_official 87:085cde657901 58 [..]
mbed_official 87:085cde657901 59 Both DAC channels can be used to generate
mbed_official 87:085cde657901 60 (#) Noise wave
mbed_official 87:085cde657901 61 (#) Triangle wave
mbed_official 87:085cde657901 62
mbed_official 87:085cde657901 63 *** DAC data format ***
mbed_official 87:085cde657901 64 =======================
mbed_official 87:085cde657901 65 [..]
mbed_official 87:085cde657901 66 The DAC data format can be:
mbed_official 87:085cde657901 67 (#) 8-bit right alignment using DAC_ALIGN_8B_R
mbed_official 87:085cde657901 68 (#) 12-bit left alignment using DAC_ALIGN_12B_L
mbed_official 87:085cde657901 69 (#) 12-bit right alignment using DAC_ALIGN_12B_R
mbed_official 87:085cde657901 70
mbed_official 87:085cde657901 71 *** DAC data value to voltage correspondence ***
mbed_official 87:085cde657901 72 ================================================
mbed_official 87:085cde657901 73 [..]
mbed_official 87:085cde657901 74 The analog output voltage on each DAC channel pin is determined
mbed_official 87:085cde657901 75 by the following equation:
mbed_official 87:085cde657901 76 DAC_OUTx = VREF+ * DOR / 4095
mbed_official 87:085cde657901 77 with DOR is the Data Output Register
mbed_official 87:085cde657901 78 VEF+ is the input voltage reference (refer to the device datasheet)
mbed_official 87:085cde657901 79 e.g. To set DAC_OUT1 to 0.7V, use
mbed_official 87:085cde657901 80 Assuming that VREF+ = 3.3V, DAC_OUT1 = (3.3 * 868) / 4095 = 0.7V
mbed_official 87:085cde657901 81
mbed_official 87:085cde657901 82 *** DMA requests ***
mbed_official 87:085cde657901 83 =====================
mbed_official 87:085cde657901 84 [..]
mbed_official 87:085cde657901 85 A DMA1 request can be generated when an external trigger (but not
mbed_official 87:085cde657901 86 a software trigger) occurs if DMA1 requests are enabled using
mbed_official 87:085cde657901 87 HAL_DAC_Start_DMA()
mbed_official 87:085cde657901 88 [..]
mbed_official 87:085cde657901 89 DMA1 requests are mapped as following:
mbed_official 87:085cde657901 90 (#) DAC channel1 : mapped on DMA1 Stream5 channel7 which must be
mbed_official 87:085cde657901 91 already configured
mbed_official 87:085cde657901 92 (#) DAC channel2 : mapped on DMA1 Stream6 channel7 which must be
mbed_official 87:085cde657901 93 already configured
mbed_official 87:085cde657901 94
mbed_official 87:085cde657901 95 -@- For Dual mode and specific signal (Triangle and noise) generation please
mbed_official 87:085cde657901 96 refer to Extension Features Driver description
mbed_official 87:085cde657901 97
mbed_official 87:085cde657901 98
mbed_official 87:085cde657901 99 ##### How to use this driver #####
mbed_official 87:085cde657901 100 ==============================================================================
mbed_official 87:085cde657901 101 [..]
mbed_official 87:085cde657901 102 (+) DAC APB clock must be enabled to get write access to DAC
mbed_official 87:085cde657901 103 registers using HAL_DAC_Init()
mbed_official 87:085cde657901 104 (+) Configure DAC_OUTx (DAC_OUT1: PA4, DAC_OUT2: PA5) in analog mode.
mbed_official 87:085cde657901 105 (+) Configure the DAC channel using HAL_DAC_ConfigChannel() function.
mbed_official 87:085cde657901 106 (+) Enable the DAC channel using HAL_DAC_Start() or HAL_DAC_Start_DMA functions
mbed_official 87:085cde657901 107
mbed_official 87:085cde657901 108 *** Polling mode IO operation ***
mbed_official 87:085cde657901 109 =================================
mbed_official 87:085cde657901 110 [..]
mbed_official 87:085cde657901 111 (+) Start the DAC peripheral using HAL_DAC_Start()
mbed_official 87:085cde657901 112 (+) To read the DAC last data output value value, use the HAL_DAC_GetValue() function.
mbed_official 87:085cde657901 113 (+) Stop the DAC peripheral using HAL_DAC_Stop()
mbed_official 87:085cde657901 114
mbed_official 87:085cde657901 115 *** DMA mode IO operation ***
mbed_official 87:085cde657901 116 ==============================
mbed_official 87:085cde657901 117 [..]
mbed_official 87:085cde657901 118 (+) Start the DAC peripheral using HAL_DAC_Start_DMA(), at this stage the user specify the length
mbed_official 87:085cde657901 119 of data to be transfered at each end of conversion
mbed_official 87:085cde657901 120 (+) At The end of data transfer HAL_DAC_ConvCpltCallbackCh1()or HAL_DAC_ConvCpltCallbackCh2()
mbed_official 87:085cde657901 121 function is executed and user can add his own code by customization of function pointer
mbed_official 87:085cde657901 122 HAL_DAC_ConvCpltCallbackCh1 or HAL_DAC_ConvCpltCallbackCh2
mbed_official 87:085cde657901 123 (+) In case of transfer Error, HAL_DAC_ErrorCallbackCh1() function is executed and user can
mbed_official 87:085cde657901 124 add his own code by customization of function pointer HAL_DAC_ErrorCallbackCh1
mbed_official 87:085cde657901 125 (+) Stop the DAC peripheral using HAL_DAC_Stop_DMA()
mbed_official 87:085cde657901 126
mbed_official 87:085cde657901 127 *** DAC HAL driver macros list ***
mbed_official 87:085cde657901 128 =============================================
mbed_official 87:085cde657901 129 [..]
mbed_official 87:085cde657901 130 Below the list of most used macros in DAC HAL driver.
mbed_official 87:085cde657901 131
mbed_official 87:085cde657901 132 (+) __HAL_DAC_ENABLE : Enable the DAC peripheral
mbed_official 87:085cde657901 133 (+) __HAL_DAC_DISABLE : Disable the DAC peripheral
mbed_official 87:085cde657901 134 (+) __HAL_DAC_CLEAR_FLAG: Clear the DAC's pending flags
mbed_official 87:085cde657901 135 (+) __HAL_DAC_GET_FLAG: Get the selected DAC's flag status
mbed_official 87:085cde657901 136
mbed_official 87:085cde657901 137 [..]
mbed_official 87:085cde657901 138 (@) You can refer to the DAC HAL driver header file for more useful macros
mbed_official 87:085cde657901 139
mbed_official 87:085cde657901 140 @endverbatim
mbed_official 87:085cde657901 141 ******************************************************************************
mbed_official 87:085cde657901 142 * @attention
mbed_official 87:085cde657901 143 *
mbed_official 87:085cde657901 144 * <h2><center>&copy; COPYRIGHT(c) 2014 STMicroelectronics</center></h2>
mbed_official 87:085cde657901 145 *
mbed_official 87:085cde657901 146 * Redistribution and use in source and binary forms, with or without modification,
mbed_official 87:085cde657901 147 * are permitted provided that the following conditions are met:
mbed_official 87:085cde657901 148 * 1. Redistributions of source code must retain the above copyright notice,
mbed_official 87:085cde657901 149 * this list of conditions and the following disclaimer.
mbed_official 87:085cde657901 150 * 2. Redistributions in binary form must reproduce the above copyright notice,
mbed_official 87:085cde657901 151 * this list of conditions and the following disclaimer in the documentation
mbed_official 87:085cde657901 152 * and/or other materials provided with the distribution.
mbed_official 87:085cde657901 153 * 3. Neither the name of STMicroelectronics nor the names of its contributors
mbed_official 87:085cde657901 154 * may be used to endorse or promote products derived from this software
mbed_official 87:085cde657901 155 * without specific prior written permission.
mbed_official 87:085cde657901 156 *
mbed_official 87:085cde657901 157 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
mbed_official 87:085cde657901 158 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
mbed_official 87:085cde657901 159 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
mbed_official 87:085cde657901 160 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
mbed_official 87:085cde657901 161 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
mbed_official 87:085cde657901 162 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
mbed_official 87:085cde657901 163 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
mbed_official 87:085cde657901 164 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
mbed_official 87:085cde657901 165 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
mbed_official 87:085cde657901 166 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
mbed_official 87:085cde657901 167 *
mbed_official 87:085cde657901 168 ******************************************************************************
mbed_official 87:085cde657901 169 */
mbed_official 87:085cde657901 170
mbed_official 87:085cde657901 171
mbed_official 87:085cde657901 172 /* Includes ------------------------------------------------------------------*/
mbed_official 87:085cde657901 173 #include "stm32f4xx_hal.h"
mbed_official 87:085cde657901 174
mbed_official 87:085cde657901 175 /** @addtogroup STM32F4xx_HAL_Driver
mbed_official 87:085cde657901 176 * @{
mbed_official 87:085cde657901 177 */
mbed_official 87:085cde657901 178
mbed_official 87:085cde657901 179 /** @defgroup DAC
mbed_official 87:085cde657901 180 * @brief DAC driver modules
mbed_official 87:085cde657901 181 * @{
mbed_official 87:085cde657901 182 */
mbed_official 87:085cde657901 183
mbed_official 87:085cde657901 184 #ifdef HAL_DAC_MODULE_ENABLED
mbed_official 87:085cde657901 185
mbed_official 87:085cde657901 186 #if defined(STM32F405xx) || defined(STM32F415xx) || defined(STM32F407xx) || defined(STM32F417xx) || defined(STM32F427xx) || defined(STM32F437xx) || defined(STM32F429xx) || defined(STM32F439xx)
mbed_official 87:085cde657901 187 /* Private typedef -----------------------------------------------------------*/
mbed_official 87:085cde657901 188 /* Private define ------------------------------------------------------------*/
mbed_official 87:085cde657901 189 /* Private macro -------------------------------------------------------------*/
mbed_official 87:085cde657901 190 /* Private variables ---------------------------------------------------------*/
mbed_official 87:085cde657901 191 /* Private function prototypes -----------------------------------------------*/
mbed_official 87:085cde657901 192 static void DAC_DMAConvCpltCh1(DMA_HandleTypeDef *hdma);
mbed_official 87:085cde657901 193 static void DAC_DMAErrorCh1(DMA_HandleTypeDef *hdma);
mbed_official 87:085cde657901 194 static void DAC_DMAHalfConvCpltCh1(DMA_HandleTypeDef *hdma);
mbed_official 87:085cde657901 195
mbed_official 87:085cde657901 196 /* Private functions ---------------------------------------------------------*/
mbed_official 87:085cde657901 197
mbed_official 87:085cde657901 198 /** @defgroup DAC_Private_Functions
mbed_official 87:085cde657901 199 * @{
mbed_official 87:085cde657901 200 */
mbed_official 87:085cde657901 201
mbed_official 87:085cde657901 202 /** @defgroup DAC_Group1 Initialization and de-initialization functions
mbed_official 87:085cde657901 203 * @brief Initialization and Configuration functions
mbed_official 87:085cde657901 204 *
mbed_official 87:085cde657901 205 @verbatim
mbed_official 87:085cde657901 206 ==============================================================================
mbed_official 87:085cde657901 207 ##### Initialization and de-initialization functions #####
mbed_official 87:085cde657901 208 ==============================================================================
mbed_official 87:085cde657901 209 [..] This section provides functions allowing to:
mbed_official 87:085cde657901 210 (+) Initialize and configure the DAC.
mbed_official 87:085cde657901 211 (+) De-initialize the DAC.
mbed_official 87:085cde657901 212
mbed_official 87:085cde657901 213 @endverbatim
mbed_official 87:085cde657901 214 * @{
mbed_official 87:085cde657901 215 */
mbed_official 87:085cde657901 216
mbed_official 87:085cde657901 217 /**
mbed_official 87:085cde657901 218 * @brief Initializes the DAC peripheral according to the specified parameters
mbed_official 87:085cde657901 219 * in the DAC_InitStruct.
mbed_official 87:085cde657901 220 * @param hdac: pointer to a DAC_HandleTypeDef structure that contains
mbed_official 87:085cde657901 221 * the configuration information for the specified DAC.
mbed_official 87:085cde657901 222 * @retval HAL status
mbed_official 87:085cde657901 223 */
mbed_official 87:085cde657901 224 HAL_StatusTypeDef HAL_DAC_Init(DAC_HandleTypeDef* hdac)
mbed_official 87:085cde657901 225 {
mbed_official 87:085cde657901 226 /* Check DAC handle */
mbed_official 87:085cde657901 227 if(hdac == NULL)
mbed_official 87:085cde657901 228 {
mbed_official 87:085cde657901 229 return HAL_ERROR;
mbed_official 87:085cde657901 230 }
mbed_official 87:085cde657901 231 /* Check the parameters */
mbed_official 87:085cde657901 232 assert_param(IS_DAC_ALL_INSTANCE(hdac->Instance));
mbed_official 87:085cde657901 233
mbed_official 87:085cde657901 234 if(hdac->State == HAL_DAC_STATE_RESET)
mbed_official 87:085cde657901 235 {
mbed_official 87:085cde657901 236 /* Init the low level hardware */
mbed_official 87:085cde657901 237 HAL_DAC_MspInit(hdac);
mbed_official 87:085cde657901 238 }
mbed_official 87:085cde657901 239
mbed_official 87:085cde657901 240 /* Initialize the DAC state*/
mbed_official 87:085cde657901 241 hdac->State = HAL_DAC_STATE_BUSY;
mbed_official 87:085cde657901 242
mbed_official 87:085cde657901 243 /* Set DAC error code to none */
mbed_official 87:085cde657901 244 hdac->ErrorCode = HAL_DAC_ERROR_NONE;
mbed_official 87:085cde657901 245
mbed_official 87:085cde657901 246 /* Initialize the DAC state*/
mbed_official 87:085cde657901 247 hdac->State = HAL_DAC_STATE_READY;
mbed_official 87:085cde657901 248
mbed_official 87:085cde657901 249 /* Return function status */
mbed_official 87:085cde657901 250 return HAL_OK;
mbed_official 87:085cde657901 251 }
mbed_official 87:085cde657901 252
mbed_official 87:085cde657901 253 /**
mbed_official 87:085cde657901 254 * @brief Deinitializes the DAC peripheral registers to their default reset values.
mbed_official 87:085cde657901 255 * @param hdac: pointer to a DAC_HandleTypeDef structure that contains
mbed_official 87:085cde657901 256 * the configuration information for the specified DAC.
mbed_official 87:085cde657901 257 * @retval HAL status
mbed_official 87:085cde657901 258 */
mbed_official 87:085cde657901 259 HAL_StatusTypeDef HAL_DAC_DeInit(DAC_HandleTypeDef* hdac)
mbed_official 87:085cde657901 260 {
mbed_official 87:085cde657901 261 /* Check DAC handle */
mbed_official 87:085cde657901 262 if(hdac == NULL)
mbed_official 87:085cde657901 263 {
mbed_official 87:085cde657901 264 return HAL_ERROR;
mbed_official 87:085cde657901 265 }
mbed_official 87:085cde657901 266
mbed_official 87:085cde657901 267 /* Check the parameters */
mbed_official 87:085cde657901 268 assert_param(IS_DAC_ALL_INSTANCE(hdac->Instance));
mbed_official 87:085cde657901 269
mbed_official 87:085cde657901 270 /* Change DAC state */
mbed_official 87:085cde657901 271 hdac->State = HAL_DAC_STATE_BUSY;
mbed_official 87:085cde657901 272
mbed_official 87:085cde657901 273 /* DeInit the low level hardware */
mbed_official 87:085cde657901 274 HAL_DAC_MspDeInit(hdac);
mbed_official 87:085cde657901 275
mbed_official 87:085cde657901 276 /* Set DAC error code to none */
mbed_official 87:085cde657901 277 hdac->ErrorCode = HAL_DAC_ERROR_NONE;
mbed_official 87:085cde657901 278
mbed_official 87:085cde657901 279 /* Change DAC state */
mbed_official 87:085cde657901 280 hdac->State = HAL_DAC_STATE_RESET;
mbed_official 87:085cde657901 281
mbed_official 87:085cde657901 282 /* Return function status */
mbed_official 87:085cde657901 283 return HAL_OK;
mbed_official 87:085cde657901 284 }
mbed_official 87:085cde657901 285
mbed_official 87:085cde657901 286 /**
mbed_official 87:085cde657901 287 * @brief Initializes the DAC MSP.
mbed_official 87:085cde657901 288 * @param hdac: pointer to a DAC_HandleTypeDef structure that contains
mbed_official 87:085cde657901 289 * the configuration information for the specified DAC.
mbed_official 87:085cde657901 290 * @retval None
mbed_official 87:085cde657901 291 */
mbed_official 87:085cde657901 292 __weak void HAL_DAC_MspInit(DAC_HandleTypeDef* hdac)
mbed_official 87:085cde657901 293 {
mbed_official 87:085cde657901 294 /* NOTE : This function Should not be modified, when the callback is needed,
mbed_official 87:085cde657901 295 the HAL_DAC_MspInit could be implemented in the user file
mbed_official 87:085cde657901 296 */
mbed_official 87:085cde657901 297 }
mbed_official 87:085cde657901 298
mbed_official 87:085cde657901 299 /**
mbed_official 87:085cde657901 300 * @brief DeInitializes the DAC MSP.
mbed_official 87:085cde657901 301 * @param hdac: pointer to a DAC_HandleTypeDef structure that contains
mbed_official 87:085cde657901 302 * the configuration information for the specified DAC.
mbed_official 87:085cde657901 303 * @retval None
mbed_official 87:085cde657901 304 */
mbed_official 87:085cde657901 305 __weak void HAL_DAC_MspDeInit(DAC_HandleTypeDef* hdac)
mbed_official 87:085cde657901 306 {
mbed_official 87:085cde657901 307 /* NOTE : This function Should not be modified, when the callback is needed,
mbed_official 87:085cde657901 308 the HAL_DAC_MspDeInit could be implemented in the user file
mbed_official 87:085cde657901 309 */
mbed_official 87:085cde657901 310 }
mbed_official 87:085cde657901 311
mbed_official 87:085cde657901 312 /**
mbed_official 87:085cde657901 313 * @}
mbed_official 87:085cde657901 314 */
mbed_official 87:085cde657901 315
mbed_official 87:085cde657901 316 /** @defgroup DAC_Group2 IO operation functions
mbed_official 87:085cde657901 317 * @brief IO operation functions
mbed_official 87:085cde657901 318 *
mbed_official 87:085cde657901 319 @verbatim
mbed_official 87:085cde657901 320 ==============================================================================
mbed_official 87:085cde657901 321 ##### IO operation functions #####
mbed_official 87:085cde657901 322 ==============================================================================
mbed_official 87:085cde657901 323 [..] This section provides functions allowing to:
mbed_official 87:085cde657901 324 (+) Start conversion.
mbed_official 87:085cde657901 325 (+) Stop conversion.
mbed_official 87:085cde657901 326 (+) Start conversion and enable DMA transfer.
mbed_official 87:085cde657901 327 (+) Stop conversion and disable DMA transfer.
mbed_official 87:085cde657901 328 (+) Get result of conversion.
mbed_official 87:085cde657901 329
mbed_official 87:085cde657901 330 @endverbatim
mbed_official 87:085cde657901 331 * @{
mbed_official 87:085cde657901 332 */
mbed_official 87:085cde657901 333
mbed_official 87:085cde657901 334 /**
mbed_official 87:085cde657901 335 * @brief Enables DAC and starts conversion of channel.
mbed_official 87:085cde657901 336 * @param hdac: pointer to a DAC_HandleTypeDef structure that contains
mbed_official 87:085cde657901 337 * the configuration information for the specified DAC.
mbed_official 87:085cde657901 338 * @param Channel: The selected DAC channel.
mbed_official 87:085cde657901 339 * This parameter can be one of the following values:
mbed_official 87:085cde657901 340 * @arg DAC_CHANNEL_1: DAC Channel1 selected
mbed_official 87:085cde657901 341 * @arg DAC_CHANNEL_2: DAC Channel2 selected
mbed_official 87:085cde657901 342 * @retval HAL status
mbed_official 87:085cde657901 343 */
mbed_official 87:085cde657901 344 HAL_StatusTypeDef HAL_DAC_Start(DAC_HandleTypeDef* hdac, uint32_t Channel)
mbed_official 87:085cde657901 345 {
mbed_official 87:085cde657901 346 uint32_t tmp1 = 0, tmp2 = 0;
mbed_official 87:085cde657901 347
mbed_official 87:085cde657901 348 /* Check the parameters */
mbed_official 87:085cde657901 349 assert_param(IS_DAC_CHANNEL(Channel));
mbed_official 87:085cde657901 350
mbed_official 87:085cde657901 351 /* Process locked */
mbed_official 87:085cde657901 352 __HAL_LOCK(hdac);
mbed_official 87:085cde657901 353
mbed_official 87:085cde657901 354 /* Change DAC state */
mbed_official 87:085cde657901 355 hdac->State = HAL_DAC_STATE_BUSY;
mbed_official 87:085cde657901 356
mbed_official 87:085cde657901 357 /* Enable the Peripharal */
mbed_official 87:085cde657901 358 __HAL_DAC_ENABLE(hdac, Channel);
mbed_official 87:085cde657901 359
mbed_official 87:085cde657901 360 if(Channel == DAC_CHANNEL_1)
mbed_official 87:085cde657901 361 {
mbed_official 87:085cde657901 362 tmp1 = hdac->Instance->CR & DAC_CR_TEN1;
mbed_official 87:085cde657901 363 tmp2 = hdac->Instance->CR & DAC_CR_TSEL1;
mbed_official 87:085cde657901 364 /* Check if software trigger enabled */
mbed_official 87:085cde657901 365 if((tmp1 == DAC_CR_TEN1) && (tmp2 == DAC_CR_TSEL1))
mbed_official 87:085cde657901 366 {
mbed_official 87:085cde657901 367 /* Enable the selected DAC software conversion */
mbed_official 87:085cde657901 368 hdac->Instance->SWTRIGR |= (uint32_t)DAC_SWTRIGR_SWTRIG1;
mbed_official 87:085cde657901 369 }
mbed_official 87:085cde657901 370 }
mbed_official 87:085cde657901 371 else
mbed_official 87:085cde657901 372 {
mbed_official 87:085cde657901 373 tmp1 = hdac->Instance->CR & DAC_CR_TEN2;
mbed_official 87:085cde657901 374 tmp2 = hdac->Instance->CR & DAC_CR_TSEL2;
mbed_official 87:085cde657901 375 /* Check if software trigger enabled */
mbed_official 87:085cde657901 376 if((tmp1 == DAC_CR_TEN2) && (tmp2 == DAC_CR_TSEL2))
mbed_official 87:085cde657901 377 {
mbed_official 87:085cde657901 378 /* Enable the selected DAC software conversion*/
mbed_official 87:085cde657901 379 hdac->Instance->SWTRIGR |= (uint32_t)DAC_SWTRIGR_SWTRIG2;
mbed_official 87:085cde657901 380 }
mbed_official 87:085cde657901 381 }
mbed_official 87:085cde657901 382
mbed_official 87:085cde657901 383 /* Change DAC state */
mbed_official 87:085cde657901 384 hdac->State = HAL_DAC_STATE_READY;
mbed_official 87:085cde657901 385
mbed_official 87:085cde657901 386 /* Process unlocked */
mbed_official 87:085cde657901 387 __HAL_UNLOCK(hdac);
mbed_official 87:085cde657901 388
mbed_official 87:085cde657901 389 /* Return function status */
mbed_official 87:085cde657901 390 return HAL_OK;
mbed_official 87:085cde657901 391 }
mbed_official 87:085cde657901 392
mbed_official 87:085cde657901 393 /**
mbed_official 87:085cde657901 394 * @brief Disables DAC and stop conversion of channel.
mbed_official 87:085cde657901 395 * @param hdac: pointer to a DAC_HandleTypeDef structure that contains
mbed_official 87:085cde657901 396 * the configuration information for the specified DAC.
mbed_official 87:085cde657901 397 * @param Channel: The selected DAC channel.
mbed_official 87:085cde657901 398 * This parameter can be one of the following values:
mbed_official 87:085cde657901 399 * @arg DAC_CHANNEL_1: DAC Channel1 selected
mbed_official 87:085cde657901 400 * @arg DAC_CHANNEL_2: DAC Channel2 selected
mbed_official 87:085cde657901 401 * @retval HAL status
mbed_official 87:085cde657901 402 */
mbed_official 87:085cde657901 403 HAL_StatusTypeDef HAL_DAC_Stop(DAC_HandleTypeDef* hdac, uint32_t Channel)
mbed_official 87:085cde657901 404 {
mbed_official 87:085cde657901 405 /* Check the parameters */
mbed_official 87:085cde657901 406 assert_param(IS_DAC_CHANNEL(Channel));
mbed_official 87:085cde657901 407
mbed_official 87:085cde657901 408 /* Disable the Peripheral */
mbed_official 87:085cde657901 409 __HAL_DAC_DISABLE(hdac, Channel);
mbed_official 87:085cde657901 410
mbed_official 87:085cde657901 411 /* Change DAC state */
mbed_official 87:085cde657901 412 hdac->State = HAL_DAC_STATE_READY;
mbed_official 87:085cde657901 413
mbed_official 87:085cde657901 414 /* Return function status */
mbed_official 87:085cde657901 415 return HAL_OK;
mbed_official 87:085cde657901 416 }
mbed_official 87:085cde657901 417
mbed_official 87:085cde657901 418 /**
mbed_official 87:085cde657901 419 * @brief Enables DAC and starts conversion of channel.
mbed_official 87:085cde657901 420 * @param hdac: pointer to a DAC_HandleTypeDef structure that contains
mbed_official 87:085cde657901 421 * the configuration information for the specified DAC.
mbed_official 87:085cde657901 422 * @param Channel: The selected DAC channel.
mbed_official 87:085cde657901 423 * This parameter can be one of the following values:
mbed_official 87:085cde657901 424 * @arg DAC_CHANNEL_1: DAC Channel1 selected
mbed_official 87:085cde657901 425 * @arg DAC_CHANNEL_2: DAC Channel2 selected
mbed_official 87:085cde657901 426 * @param pData: The destination peripheral Buffer address.
mbed_official 87:085cde657901 427 * @param Length: The length of data to be transferred from memory to DAC peripheral
mbed_official 87:085cde657901 428 * @param Alignment: Specifies the data alignment for DAC channel.
mbed_official 87:085cde657901 429 * This parameter can be one of the following values:
mbed_official 87:085cde657901 430 * @arg DAC_Align_8b_R: 8bit right data alignment selected
mbed_official 87:085cde657901 431 * @arg DAC_Align_12b_L: 12bit left data alignment selected
mbed_official 87:085cde657901 432 * @arg DAC_Align_12b_R: 12bit right data alignment selected
mbed_official 87:085cde657901 433 * @retval HAL status
mbed_official 87:085cde657901 434 */
mbed_official 87:085cde657901 435 HAL_StatusTypeDef HAL_DAC_Start_DMA(DAC_HandleTypeDef* hdac, uint32_t Channel, uint32_t* pData, uint32_t Length, uint32_t Alignment)
mbed_official 87:085cde657901 436 {
mbed_official 87:085cde657901 437 uint32_t tmpreg = 0;
mbed_official 87:085cde657901 438
mbed_official 87:085cde657901 439 /* Check the parameters */
mbed_official 87:085cde657901 440 assert_param(IS_DAC_CHANNEL(Channel));
mbed_official 87:085cde657901 441 assert_param(IS_DAC_ALIGN(Alignment));
mbed_official 87:085cde657901 442
mbed_official 87:085cde657901 443 /* Process locked */
mbed_official 87:085cde657901 444 __HAL_LOCK(hdac);
mbed_official 87:085cde657901 445
mbed_official 87:085cde657901 446 /* Change DAC state */
mbed_official 87:085cde657901 447 hdac->State = HAL_DAC_STATE_BUSY;
mbed_official 87:085cde657901 448
mbed_official 87:085cde657901 449 /* Set the DMA transfer complete callback for channel1 */
mbed_official 87:085cde657901 450 hdac->DMA_Handle1->XferCpltCallback = DAC_DMAConvCpltCh1;
mbed_official 87:085cde657901 451
mbed_official 87:085cde657901 452 /* Set the DMA half transfer complete callback for channel1 */
mbed_official 87:085cde657901 453 hdac->DMA_Handle1->XferHalfCpltCallback = DAC_DMAHalfConvCpltCh1;
mbed_official 87:085cde657901 454
mbed_official 87:085cde657901 455 /* Set the DMA error callback for channel1 */
mbed_official 87:085cde657901 456 hdac->DMA_Handle1->XferErrorCallback = DAC_DMAErrorCh1;
mbed_official 87:085cde657901 457
mbed_official 87:085cde657901 458 /* Set the DMA transfer complete callback for channel2 */
mbed_official 87:085cde657901 459 hdac->DMA_Handle2->XferCpltCallback = DAC_DMAConvCpltCh2;
mbed_official 87:085cde657901 460
mbed_official 87:085cde657901 461 /* Set the DMA half transfer complete callback for channel2 */
mbed_official 87:085cde657901 462 hdac->DMA_Handle2->XferHalfCpltCallback = DAC_DMAHalfConvCpltCh2;
mbed_official 87:085cde657901 463
mbed_official 87:085cde657901 464 /* Set the DMA error callback for channel2 */
mbed_official 87:085cde657901 465 hdac->DMA_Handle2->XferErrorCallback = DAC_DMAErrorCh2;
mbed_official 87:085cde657901 466
mbed_official 87:085cde657901 467 if(Channel == DAC_CHANNEL_1)
mbed_official 87:085cde657901 468 {
mbed_official 87:085cde657901 469 /* Enable the selected DAC channel1 DMA request */
mbed_official 87:085cde657901 470 hdac->Instance->CR |= DAC_CR_DMAEN1;
mbed_official 87:085cde657901 471
mbed_official 87:085cde657901 472 /* Case of use of channel 1 */
mbed_official 87:085cde657901 473 switch(Alignment)
mbed_official 87:085cde657901 474 {
mbed_official 87:085cde657901 475 case DAC_ALIGN_12B_R:
mbed_official 87:085cde657901 476 /* Get DHR12R1 address */
mbed_official 87:085cde657901 477 tmpreg = (uint32_t)&hdac->Instance->DHR12R1;
mbed_official 87:085cde657901 478 break;
mbed_official 87:085cde657901 479 case DAC_ALIGN_12B_L:
mbed_official 87:085cde657901 480 /* Get DHR12L1 address */
mbed_official 87:085cde657901 481 tmpreg = (uint32_t)&hdac->Instance->DHR12L1;
mbed_official 87:085cde657901 482 break;
mbed_official 87:085cde657901 483 case DAC_ALIGN_8B_R:
mbed_official 87:085cde657901 484 /* Get DHR8R1 address */
mbed_official 87:085cde657901 485 tmpreg = (uint32_t)&hdac->Instance->DHR8R1;
mbed_official 87:085cde657901 486 break;
mbed_official 87:085cde657901 487 default:
mbed_official 87:085cde657901 488 break;
mbed_official 87:085cde657901 489 }
mbed_official 87:085cde657901 490 }
mbed_official 87:085cde657901 491 else
mbed_official 87:085cde657901 492 {
mbed_official 87:085cde657901 493 /* Enable the selected DAC channel2 DMA request */
mbed_official 87:085cde657901 494 hdac->Instance->CR |= DAC_CR_DMAEN2;
mbed_official 87:085cde657901 495
mbed_official 87:085cde657901 496 /* Case of use of channel 2 */
mbed_official 87:085cde657901 497 switch(Alignment)
mbed_official 87:085cde657901 498 {
mbed_official 87:085cde657901 499 case DAC_ALIGN_12B_R:
mbed_official 87:085cde657901 500 /* Get DHR12R2 address */
mbed_official 87:085cde657901 501 tmpreg = (uint32_t)&hdac->Instance->DHR12R2;
mbed_official 87:085cde657901 502 break;
mbed_official 87:085cde657901 503 case DAC_ALIGN_12B_L:
mbed_official 87:085cde657901 504 /* Get DHR12L2 address */
mbed_official 87:085cde657901 505 tmpreg = (uint32_t)&hdac->Instance->DHR12L2;
mbed_official 87:085cde657901 506 break;
mbed_official 87:085cde657901 507 case DAC_ALIGN_8B_R:
mbed_official 87:085cde657901 508 /* Get DHR8R2 address */
mbed_official 87:085cde657901 509 tmpreg = (uint32_t)&hdac->Instance->DHR8R2;
mbed_official 87:085cde657901 510 break;
mbed_official 87:085cde657901 511 default:
mbed_official 87:085cde657901 512 break;
mbed_official 87:085cde657901 513 }
mbed_official 87:085cde657901 514 }
mbed_official 87:085cde657901 515
mbed_official 87:085cde657901 516 /* Enable the DMA Stream */
mbed_official 87:085cde657901 517 if(Channel == DAC_CHANNEL_1)
mbed_official 87:085cde657901 518 {
mbed_official 87:085cde657901 519 /* Enable the DAC DMA underrun interrupt */
mbed_official 87:085cde657901 520 __HAL_DAC_ENABLE_IT(hdac, DAC_IT_DMAUDR1);
mbed_official 87:085cde657901 521
mbed_official 87:085cde657901 522 /* Enable the DMA Stream */
mbed_official 87:085cde657901 523 HAL_DMA_Start_IT(hdac->DMA_Handle1, (uint32_t)pData, tmpreg, Length);
mbed_official 87:085cde657901 524 }
mbed_official 87:085cde657901 525 else
mbed_official 87:085cde657901 526 {
mbed_official 87:085cde657901 527 /* Enable the DAC DMA underrun interrupt */
mbed_official 87:085cde657901 528 __HAL_DAC_ENABLE_IT(hdac, DAC_IT_DMAUDR2);
mbed_official 87:085cde657901 529
mbed_official 87:085cde657901 530 /* Enable the DMA Stream */
mbed_official 87:085cde657901 531 HAL_DMA_Start_IT(hdac->DMA_Handle2, (uint32_t)pData, tmpreg, Length);
mbed_official 87:085cde657901 532 }
mbed_official 87:085cde657901 533
mbed_official 87:085cde657901 534 /* Enable the Peripharal */
mbed_official 87:085cde657901 535 __HAL_DAC_ENABLE(hdac, Channel);
mbed_official 87:085cde657901 536
mbed_official 87:085cde657901 537 /* Process Unlocked */
mbed_official 87:085cde657901 538 __HAL_UNLOCK(hdac);
mbed_official 87:085cde657901 539
mbed_official 87:085cde657901 540 /* Return function status */
mbed_official 87:085cde657901 541 return HAL_OK;
mbed_official 87:085cde657901 542 }
mbed_official 87:085cde657901 543
mbed_official 87:085cde657901 544 /**
mbed_official 87:085cde657901 545 * @brief Disables DAC and stop conversion of channel.
mbed_official 87:085cde657901 546 * @param hdac: pointer to a DAC_HandleTypeDef structure that contains
mbed_official 87:085cde657901 547 * the configuration information for the specified DAC.
mbed_official 87:085cde657901 548 * @param Channel: The selected DAC channel.
mbed_official 87:085cde657901 549 * This parameter can be one of the following values:
mbed_official 87:085cde657901 550 * @arg DAC_CHANNEL_1: DAC Channel1 selected
mbed_official 87:085cde657901 551 * @arg DAC_CHANNEL_2: DAC Channel2 selected
mbed_official 87:085cde657901 552 * @retval HAL status
mbed_official 87:085cde657901 553 */
mbed_official 87:085cde657901 554 HAL_StatusTypeDef HAL_DAC_Stop_DMA(DAC_HandleTypeDef* hdac, uint32_t Channel)
mbed_official 87:085cde657901 555 {
mbed_official 87:085cde657901 556 /* Check the parameters */
mbed_official 87:085cde657901 557 assert_param(IS_DAC_CHANNEL(Channel));
mbed_official 87:085cde657901 558
mbed_official 87:085cde657901 559 /* Disable the selected DAC channel DMA request */
mbed_official 87:085cde657901 560 hdac->Instance->CR &= ~(DAC_CR_DMAEN1 << Channel);
mbed_official 87:085cde657901 561
mbed_official 87:085cde657901 562 /* Disable the Peripharal */
mbed_official 87:085cde657901 563 __HAL_DAC_DISABLE(hdac, Channel);
mbed_official 87:085cde657901 564
mbed_official 87:085cde657901 565 /* Change DAC state */
mbed_official 87:085cde657901 566 hdac->State = HAL_DAC_STATE_READY;
mbed_official 87:085cde657901 567
mbed_official 87:085cde657901 568 /* Return function status */
mbed_official 87:085cde657901 569 return HAL_OK;
mbed_official 87:085cde657901 570 }
mbed_official 87:085cde657901 571
mbed_official 87:085cde657901 572 /**
mbed_official 87:085cde657901 573 * @brief Returns the last data output value of the selected DAC channel.
mbed_official 87:085cde657901 574 * @param hdac: pointer to a DAC_HandleTypeDef structure that contains
mbed_official 87:085cde657901 575 * the configuration information for the specified DAC.
mbed_official 87:085cde657901 576 * @param Channel: The selected DAC channel.
mbed_official 87:085cde657901 577 * This parameter can be one of the following values:
mbed_official 87:085cde657901 578 * @arg DAC_CHANNEL_1: DAC Channel1 selected
mbed_official 87:085cde657901 579 * @arg DAC_CHANNEL_2: DAC Channel2 selected
mbed_official 87:085cde657901 580 * @retval The selected DAC channel data output value.
mbed_official 87:085cde657901 581 */
mbed_official 87:085cde657901 582 uint32_t HAL_DAC_GetValue(DAC_HandleTypeDef* hdac, uint32_t Channel)
mbed_official 87:085cde657901 583 {
mbed_official 87:085cde657901 584 /* Check the parameters */
mbed_official 87:085cde657901 585 assert_param(IS_DAC_CHANNEL(Channel));
mbed_official 87:085cde657901 586
mbed_official 87:085cde657901 587 /* Returns the DAC channel data output register value */
mbed_official 87:085cde657901 588 if(Channel == DAC_CHANNEL_1)
mbed_official 87:085cde657901 589 {
mbed_official 87:085cde657901 590 return hdac->Instance->DOR1;
mbed_official 87:085cde657901 591 }
mbed_official 87:085cde657901 592 else
mbed_official 87:085cde657901 593 {
mbed_official 87:085cde657901 594 return hdac->Instance->DOR2;
mbed_official 87:085cde657901 595 }
mbed_official 87:085cde657901 596 }
mbed_official 87:085cde657901 597
mbed_official 87:085cde657901 598 /**
mbed_official 87:085cde657901 599 * @brief Handles DAC interrupt request
mbed_official 87:085cde657901 600 * @param hdac: pointer to a DAC_HandleTypeDef structure that contains
mbed_official 87:085cde657901 601 * the configuration information for the specified DAC.
mbed_official 87:085cde657901 602 * @retval None
mbed_official 87:085cde657901 603 */
mbed_official 87:085cde657901 604 void HAL_DAC_IRQHandler(DAC_HandleTypeDef* hdac)
mbed_official 87:085cde657901 605 {
mbed_official 87:085cde657901 606 /* Check Overrun flag */
mbed_official 87:085cde657901 607 if(__HAL_DAC_GET_FLAG(hdac, DAC_FLAG_DMAUDR1))
mbed_official 87:085cde657901 608 {
mbed_official 87:085cde657901 609 /* Change DAC state to error state */
mbed_official 87:085cde657901 610 hdac->State = HAL_DAC_STATE_ERROR;
mbed_official 87:085cde657901 611
mbed_official 87:085cde657901 612 /* Set DAC error code to chanel1 DMA underrun error */
mbed_official 87:085cde657901 613 hdac->ErrorCode |= HAL_DAC_ERROR_DMAUNDERRUNCH1;
mbed_official 87:085cde657901 614
mbed_official 87:085cde657901 615 /* Clear the underrun flag */
mbed_official 87:085cde657901 616 __HAL_DAC_CLEAR_FLAG(hdac,DAC_FLAG_DMAUDR1);
mbed_official 87:085cde657901 617
mbed_official 87:085cde657901 618 /* Disable the selected DAC channel1 DMA request */
mbed_official 87:085cde657901 619 hdac->Instance->CR &= ~DAC_CR_DMAEN1;
mbed_official 87:085cde657901 620
mbed_official 87:085cde657901 621 /* Error callback */
mbed_official 87:085cde657901 622 HAL_DAC_DMAUnderrunCallbackCh1(hdac);
mbed_official 87:085cde657901 623 }
mbed_official 87:085cde657901 624 else
mbed_official 87:085cde657901 625 {
mbed_official 87:085cde657901 626 /* Change DAC state to error state */
mbed_official 87:085cde657901 627 hdac->State = HAL_DAC_STATE_ERROR;
mbed_official 87:085cde657901 628
mbed_official 87:085cde657901 629 /* Set DAC error code to channel2 DMA underrun error */
mbed_official 87:085cde657901 630 hdac->ErrorCode |= HAL_DAC_ERROR_DMAUNDERRUNCH2;
mbed_official 87:085cde657901 631
mbed_official 87:085cde657901 632 /* Clear the underrun flag */
mbed_official 87:085cde657901 633 __HAL_DAC_CLEAR_FLAG(hdac,DAC_FLAG_DMAUDR2);
mbed_official 87:085cde657901 634
mbed_official 87:085cde657901 635 /* Disable the selected DAC channel1 DMA request */
mbed_official 87:085cde657901 636 hdac->Instance->CR &= ~DAC_CR_DMAEN2;
mbed_official 87:085cde657901 637
mbed_official 87:085cde657901 638 /* Error callback */
mbed_official 87:085cde657901 639 HAL_DACEx_DMAUnderrunCallbackCh2(hdac);
mbed_official 87:085cde657901 640 }
mbed_official 87:085cde657901 641 }
mbed_official 87:085cde657901 642
mbed_official 87:085cde657901 643 /**
mbed_official 87:085cde657901 644 * @brief Conversion complete callback in non blocking mode for Channel1
mbed_official 87:085cde657901 645 * @param hdac: pointer to a DAC_HandleTypeDef structure that contains
mbed_official 87:085cde657901 646 * the configuration information for the specified DAC.
mbed_official 87:085cde657901 647 * @retval None
mbed_official 87:085cde657901 648 */
mbed_official 87:085cde657901 649 __weak void HAL_DAC_ConvCpltCallbackCh1(DAC_HandleTypeDef* hdac)
mbed_official 87:085cde657901 650 {
mbed_official 87:085cde657901 651 /* NOTE : This function Should not be modified, when the callback is needed,
mbed_official 87:085cde657901 652 the HAL_DAC_ConvCpltCallback could be implemented in the user file
mbed_official 87:085cde657901 653 */
mbed_official 87:085cde657901 654 }
mbed_official 87:085cde657901 655
mbed_official 87:085cde657901 656 /**
mbed_official 87:085cde657901 657 * @brief Conversion half DMA transfer callback in non blocking mode for Channel1
mbed_official 87:085cde657901 658 * @param hdac: pointer to a DAC_HandleTypeDef structure that contains
mbed_official 87:085cde657901 659 * the configuration information for the specified DAC.
mbed_official 87:085cde657901 660 * @retval None
mbed_official 87:085cde657901 661 */
mbed_official 87:085cde657901 662 __weak void HAL_DAC_ConvHalfCpltCallbackCh1(DAC_HandleTypeDef* hdac)
mbed_official 87:085cde657901 663 {
mbed_official 87:085cde657901 664 /* NOTE : This function Should not be modified, when the callback is needed,
mbed_official 87:085cde657901 665 the HAL_DAC_ConvHalfCpltCallbackCh1 could be implemented in the user file
mbed_official 87:085cde657901 666 */
mbed_official 87:085cde657901 667 }
mbed_official 87:085cde657901 668
mbed_official 87:085cde657901 669 /**
mbed_official 87:085cde657901 670 * @brief Error DAC callback for Channel1.
mbed_official 87:085cde657901 671 * @param hdac: pointer to a DAC_HandleTypeDef structure that contains
mbed_official 87:085cde657901 672 * the configuration information for the specified DAC.
mbed_official 87:085cde657901 673 * @retval None
mbed_official 87:085cde657901 674 */
mbed_official 87:085cde657901 675 __weak void HAL_DAC_ErrorCallbackCh1(DAC_HandleTypeDef *hdac)
mbed_official 87:085cde657901 676 {
mbed_official 87:085cde657901 677 /* NOTE : This function Should not be modified, when the callback is needed,
mbed_official 87:085cde657901 678 the HAL_DAC_ErrorCallback could be implemented in the user file
mbed_official 87:085cde657901 679 */
mbed_official 87:085cde657901 680 }
mbed_official 87:085cde657901 681
mbed_official 87:085cde657901 682 /**
mbed_official 87:085cde657901 683 * @brief DMA underrun DAC callback for channel1.
mbed_official 87:085cde657901 684 * @param hdac: pointer to a DAC_HandleTypeDef structure that contains
mbed_official 87:085cde657901 685 * the configuration information for the specified DAC.
mbed_official 87:085cde657901 686 * @retval None
mbed_official 87:085cde657901 687 */
mbed_official 87:085cde657901 688 __weak void HAL_DAC_DMAUnderrunCallbackCh1(DAC_HandleTypeDef *hdac)
mbed_official 87:085cde657901 689 {
mbed_official 87:085cde657901 690 /* NOTE : This function Should not be modified, when the callback is needed,
mbed_official 87:085cde657901 691 the HAL_DAC_DMAUnderrunCallbackCh1 could be implemented in the user file
mbed_official 87:085cde657901 692 */
mbed_official 87:085cde657901 693 }
mbed_official 87:085cde657901 694
mbed_official 87:085cde657901 695 /**
mbed_official 87:085cde657901 696 * @}
mbed_official 87:085cde657901 697 */
mbed_official 87:085cde657901 698
mbed_official 87:085cde657901 699 /** @defgroup DAC_Group3 Peripheral Control functions
mbed_official 87:085cde657901 700 * @brief Peripheral Control functions
mbed_official 87:085cde657901 701 *
mbed_official 87:085cde657901 702 @verbatim
mbed_official 87:085cde657901 703 ==============================================================================
mbed_official 87:085cde657901 704 ##### Peripheral Control functions #####
mbed_official 87:085cde657901 705 ==============================================================================
mbed_official 87:085cde657901 706 [..] This section provides functions allowing to:
mbed_official 87:085cde657901 707 (+) Configure channels.
mbed_official 87:085cde657901 708 (+) Set the specified data holding register value for DAC channel.
mbed_official 87:085cde657901 709
mbed_official 87:085cde657901 710 @endverbatim
mbed_official 87:085cde657901 711 * @{
mbed_official 87:085cde657901 712 */
mbed_official 87:085cde657901 713
mbed_official 87:085cde657901 714 /**
mbed_official 87:085cde657901 715 * @brief Configures the selected DAC channel.
mbed_official 87:085cde657901 716 * @param hdac: pointer to a DAC_HandleTypeDef structure that contains
mbed_official 87:085cde657901 717 * the configuration information for the specified DAC.
mbed_official 87:085cde657901 718 * @param sConfig: DAC configuration structure.
mbed_official 87:085cde657901 719 * @param Channel: The selected DAC channel.
mbed_official 87:085cde657901 720 * This parameter can be one of the following values:
mbed_official 87:085cde657901 721 * @arg DAC_CHANNEL_1: DAC Channel1 selected
mbed_official 87:085cde657901 722 * @arg DAC_CHANNEL_2: DAC Channel2 selected
mbed_official 87:085cde657901 723 * @retval HAL status
mbed_official 87:085cde657901 724 */
mbed_official 87:085cde657901 725 HAL_StatusTypeDef HAL_DAC_ConfigChannel(DAC_HandleTypeDef* hdac, DAC_ChannelConfTypeDef* sConfig, uint32_t Channel)
mbed_official 87:085cde657901 726 {
mbed_official 87:085cde657901 727 uint32_t tmpreg1 = 0, tmpreg2 = 0;
mbed_official 87:085cde657901 728
mbed_official 87:085cde657901 729 /* Check the DAC parameters */
mbed_official 87:085cde657901 730 assert_param(IS_DAC_TRIGGER(sConfig->DAC_Trigger));
mbed_official 87:085cde657901 731 assert_param(IS_DAC_OUTPUT_BUFFER_STATE(sConfig->DAC_OutputBuffer));
mbed_official 87:085cde657901 732 assert_param(IS_DAC_TRIGGER(sConfig->DAC_Trigger));
mbed_official 87:085cde657901 733 assert_param(IS_DAC_CHANNEL(Channel));
mbed_official 87:085cde657901 734
mbed_official 87:085cde657901 735 /* Process locked */
mbed_official 87:085cde657901 736 __HAL_LOCK(hdac);
mbed_official 87:085cde657901 737
mbed_official 87:085cde657901 738 /* Change DAC state */
mbed_official 87:085cde657901 739 hdac->State = HAL_DAC_STATE_BUSY;
mbed_official 87:085cde657901 740
mbed_official 87:085cde657901 741 /* Get the DAC CR value */
mbed_official 87:085cde657901 742 tmpreg1 = DAC->CR;
mbed_official 87:085cde657901 743 /* Clear BOFFx, TENx, TSELx, WAVEx and MAMPx bits */
mbed_official 87:085cde657901 744 tmpreg1 &= ~(((uint32_t)(DAC_CR_MAMP1 | DAC_CR_WAVE1 | DAC_CR_TSEL1 | DAC_CR_TEN1 | DAC_CR_BOFF1)) << Channel);
mbed_official 87:085cde657901 745 /* Configure for the selected DAC channel: buffer output, trigger */
mbed_official 87:085cde657901 746 /* Set TSELx and TENx bits according to DAC_Trigger value */
mbed_official 87:085cde657901 747 /* Set BOFFx bit according to DAC_OutputBuffer value */
mbed_official 87:085cde657901 748 tmpreg2 = (sConfig->DAC_Trigger | sConfig->DAC_OutputBuffer);
mbed_official 87:085cde657901 749 /* Calculate CR register value depending on DAC_Channel */
mbed_official 87:085cde657901 750 tmpreg1 |= tmpreg2 << Channel;
mbed_official 87:085cde657901 751 /* Write to DAC CR */
mbed_official 87:085cde657901 752 DAC->CR = tmpreg1;
mbed_official 87:085cde657901 753 /* Disable wave generation */
mbed_official 87:085cde657901 754 DAC->CR &= ~(DAC_CR_WAVE1 << Channel);
mbed_official 87:085cde657901 755
mbed_official 87:085cde657901 756 /* Change DAC state */
mbed_official 87:085cde657901 757 hdac->State = HAL_DAC_STATE_READY;
mbed_official 87:085cde657901 758
mbed_official 87:085cde657901 759 /* Process unlocked */
mbed_official 87:085cde657901 760 __HAL_UNLOCK(hdac);
mbed_official 87:085cde657901 761
mbed_official 87:085cde657901 762 /* Return function status */
mbed_official 87:085cde657901 763 return HAL_OK;
mbed_official 87:085cde657901 764 }
mbed_official 87:085cde657901 765
mbed_official 87:085cde657901 766 /**
mbed_official 87:085cde657901 767 * @brief Set the specified data holding register value for DAC channel.
mbed_official 87:085cde657901 768 * @param hdac: pointer to a DAC_HandleTypeDef structure that contains
mbed_official 87:085cde657901 769 * the configuration information for the specified DAC.
mbed_official 87:085cde657901 770 * @param Channel: The selected DAC channel.
mbed_official 87:085cde657901 771 * This parameter can be one of the following values:
mbed_official 87:085cde657901 772 * @arg DAC_CHANNEL_1: DAC Channel1 selected
mbed_official 87:085cde657901 773 * @arg DAC_CHANNEL_2: DAC Channel2 selected
mbed_official 87:085cde657901 774 * @param Alignment: Specifies the data alignment.
mbed_official 87:085cde657901 775 * This parameter can be one of the following values:
mbed_official 87:085cde657901 776 * @arg DAC_Align_8b_R: 8bit right data alignment selected
mbed_official 87:085cde657901 777 * @arg DAC_Align_12b_L: 12bit left data alignment selected
mbed_official 87:085cde657901 778 * @arg DAC_Align_12b_R: 12bit right data alignment selected
mbed_official 87:085cde657901 779 * @param Data: Data to be loaded in the selected data holding register.
mbed_official 87:085cde657901 780 * @retval HAL status
mbed_official 87:085cde657901 781 */
mbed_official 87:085cde657901 782 HAL_StatusTypeDef HAL_DAC_SetValue(DAC_HandleTypeDef* hdac, uint32_t Channel, uint32_t Alignment, uint32_t Data)
mbed_official 87:085cde657901 783 {
mbed_official 87:085cde657901 784 __IO uint32_t tmp = 0;
mbed_official 87:085cde657901 785
mbed_official 87:085cde657901 786 /* Check the parameters */
mbed_official 87:085cde657901 787 assert_param(IS_DAC_CHANNEL(Channel));
mbed_official 87:085cde657901 788 assert_param(IS_DAC_ALIGN(Alignment));
mbed_official 87:085cde657901 789 assert_param(IS_DAC_DATA(Data));
mbed_official 87:085cde657901 790
mbed_official 87:085cde657901 791 tmp = (uint32_t)hdac->Instance;
mbed_official 87:085cde657901 792 if(Channel == DAC_CHANNEL_1)
mbed_official 87:085cde657901 793 {
mbed_official 87:085cde657901 794 tmp += __HAL_DHR12R1_ALIGNEMENT(Alignment);
mbed_official 87:085cde657901 795 }
mbed_official 87:085cde657901 796 else
mbed_official 87:085cde657901 797 {
mbed_official 87:085cde657901 798 tmp += __HAL_DHR12R2_ALIGNEMENT(Alignment);
mbed_official 87:085cde657901 799 }
mbed_official 87:085cde657901 800
mbed_official 87:085cde657901 801 /* Set the DAC channel1 selected data holding register */
mbed_official 87:085cde657901 802 *(__IO uint32_t *) tmp = Data;
mbed_official 87:085cde657901 803
mbed_official 87:085cde657901 804 /* Return function status */
mbed_official 87:085cde657901 805 return HAL_OK;
mbed_official 87:085cde657901 806 }
mbed_official 87:085cde657901 807
mbed_official 87:085cde657901 808 /**
mbed_official 87:085cde657901 809 * @}
mbed_official 87:085cde657901 810 */
mbed_official 87:085cde657901 811
mbed_official 87:085cde657901 812 /** @defgroup DAC_Group4 Peripheral State and Errors functions
mbed_official 87:085cde657901 813 * @brief Peripheral State and Errors functions
mbed_official 87:085cde657901 814 *
mbed_official 87:085cde657901 815 @verbatim
mbed_official 87:085cde657901 816 ==============================================================================
mbed_official 87:085cde657901 817 ##### Peripheral State and Errors functions #####
mbed_official 87:085cde657901 818 ==============================================================================
mbed_official 87:085cde657901 819 [..]
mbed_official 87:085cde657901 820 This subsection provides functions allowing to
mbed_official 87:085cde657901 821 (+) Check the DAC state.
mbed_official 87:085cde657901 822 (+) Check the DAC Errors.
mbed_official 87:085cde657901 823
mbed_official 87:085cde657901 824 @endverbatim
mbed_official 87:085cde657901 825 * @{
mbed_official 87:085cde657901 826 */
mbed_official 87:085cde657901 827
mbed_official 87:085cde657901 828 /**
mbed_official 87:085cde657901 829 * @brief return the DAC state
mbed_official 87:085cde657901 830 * @param hdac: pointer to a DAC_HandleTypeDef structure that contains
mbed_official 87:085cde657901 831 * the configuration information for the specified DAC.
mbed_official 87:085cde657901 832 * @retval HAL state
mbed_official 87:085cde657901 833 */
mbed_official 87:085cde657901 834 HAL_DAC_StateTypeDef HAL_DAC_GetState(DAC_HandleTypeDef* hdac)
mbed_official 87:085cde657901 835 {
mbed_official 87:085cde657901 836 /* Return DAC state */
mbed_official 87:085cde657901 837 return hdac->State;
mbed_official 87:085cde657901 838 }
mbed_official 87:085cde657901 839
mbed_official 87:085cde657901 840
mbed_official 87:085cde657901 841 /**
mbed_official 87:085cde657901 842 * @brief Return the DAC error code
mbed_official 87:085cde657901 843 * @param hdac: pointer to a DAC_HandleTypeDef structure that contains
mbed_official 87:085cde657901 844 * the configuration information for the specified DAC.
mbed_official 87:085cde657901 845 * @retval DAC Error Code
mbed_official 87:085cde657901 846 */
mbed_official 87:085cde657901 847 uint32_t HAL_DAC_GetError(DAC_HandleTypeDef *hdac)
mbed_official 87:085cde657901 848 {
mbed_official 87:085cde657901 849 return hdac->ErrorCode;
mbed_official 87:085cde657901 850 }
mbed_official 87:085cde657901 851
mbed_official 87:085cde657901 852 /**
mbed_official 87:085cde657901 853 * @}
mbed_official 87:085cde657901 854 */
mbed_official 87:085cde657901 855
mbed_official 87:085cde657901 856 /**
mbed_official 87:085cde657901 857 * @brief DMA conversion complete callback.
mbed_official 87:085cde657901 858 * @param hdma: pointer to DMA handle.
mbed_official 87:085cde657901 859 * @retval None
mbed_official 87:085cde657901 860 */
mbed_official 87:085cde657901 861 static void DAC_DMAConvCpltCh1(DMA_HandleTypeDef *hdma)
mbed_official 87:085cde657901 862 {
mbed_official 87:085cde657901 863 DAC_HandleTypeDef* hdac = ( DAC_HandleTypeDef* )((DMA_HandleTypeDef* )hdma)->Parent;
mbed_official 87:085cde657901 864
mbed_official 87:085cde657901 865 HAL_DAC_ConvCpltCallbackCh1(hdac);
mbed_official 87:085cde657901 866
mbed_official 87:085cde657901 867 hdac->State= HAL_DAC_STATE_READY;
mbed_official 87:085cde657901 868 }
mbed_official 87:085cde657901 869
mbed_official 87:085cde657901 870 /**
mbed_official 87:085cde657901 871 * @brief DMA half transfer complete callback.
mbed_official 87:085cde657901 872 * @param hdma: pointer to DMA handle.
mbed_official 87:085cde657901 873 * @retval None
mbed_official 87:085cde657901 874 */
mbed_official 87:085cde657901 875 static void DAC_DMAHalfConvCpltCh1(DMA_HandleTypeDef *hdma)
mbed_official 87:085cde657901 876 {
mbed_official 87:085cde657901 877 DAC_HandleTypeDef* hdac = ( DAC_HandleTypeDef* )((DMA_HandleTypeDef* )hdma)->Parent;
mbed_official 87:085cde657901 878 /* Conversion complete callback */
mbed_official 87:085cde657901 879 HAL_DAC_ConvHalfCpltCallbackCh1(hdac);
mbed_official 87:085cde657901 880 }
mbed_official 87:085cde657901 881
mbed_official 87:085cde657901 882 /**
mbed_official 87:085cde657901 883 * @brief DMA error callback
mbed_official 87:085cde657901 884 * @param hdma: pointer to DMA handle.
mbed_official 87:085cde657901 885 * @retval None
mbed_official 87:085cde657901 886 */
mbed_official 87:085cde657901 887 static void DAC_DMAErrorCh1(DMA_HandleTypeDef *hdma)
mbed_official 87:085cde657901 888 {
mbed_official 87:085cde657901 889 DAC_HandleTypeDef* hdac = ( DAC_HandleTypeDef* )((DMA_HandleTypeDef* )hdma)->Parent;
mbed_official 87:085cde657901 890
mbed_official 87:085cde657901 891 /* Set DAC error code to DMA error */
mbed_official 87:085cde657901 892 hdac->ErrorCode |= HAL_DAC_ERROR_DMA;
mbed_official 87:085cde657901 893
mbed_official 87:085cde657901 894 HAL_DAC_ErrorCallbackCh1(hdac);
mbed_official 87:085cde657901 895
mbed_official 87:085cde657901 896 hdac->State= HAL_DAC_STATE_READY;
mbed_official 87:085cde657901 897 }
mbed_official 87:085cde657901 898
mbed_official 87:085cde657901 899 /**
mbed_official 87:085cde657901 900 * @}
mbed_official 87:085cde657901 901 */
mbed_official 87:085cde657901 902 #endif /* STM32F405xx || STM32F415xx || STM32F407xx || STM32F417xx || STM32F427xx || STM32F437xx || STM32F429xx || STM32F439xx */
mbed_official 87:085cde657901 903 #endif /* HAL_DAC_MODULE_ENABLED */
mbed_official 87:085cde657901 904
mbed_official 87:085cde657901 905 /**
mbed_official 87:085cde657901 906 * @}
mbed_official 87:085cde657901 907 */
mbed_official 87:085cde657901 908
mbed_official 87:085cde657901 909 /**
mbed_official 87:085cde657901 910 * @}
mbed_official 87:085cde657901 911 */
mbed_official 87:085cde657901 912
mbed_official 87:085cde657901 913 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/