mbed official / mbed-dev

mbed library sources. Supersedes mbed-src.

Dependents:   Nucleo_Hello_Encoder BLE_iBeaconScan AM1805_DEMO DISCO-F429ZI_ExportTemplate1 ... more

cmsis/BUILD/mbed/TARGET_K82F/TOOLCHAIN_IAR/fsl_dac.h@189:f392fc9709a3, 2019-02-20 (annotated)

Committer:
AnnaBridge
Date:
Wed Feb 20 22:31:08 2019 +0000
Revision:
189:f392fc9709a3
mbed library release version 165

Who changed what in which revision?

UserRevisionLine numberNew contents of line
AnnaBridge 189:f392fc9709a3 1 /*
AnnaBridge 189:f392fc9709a3 2 * Copyright (c) 2015, Freescale Semiconductor, Inc.
AnnaBridge 189:f392fc9709a3 3 * All rights reserved.
AnnaBridge 189:f392fc9709a3 4 *
AnnaBridge 189:f392fc9709a3 5 * Redistribution and use in source and binary forms, with or without modification,
AnnaBridge 189:f392fc9709a3 6 * are permitted provided that the following conditions are met:
AnnaBridge 189:f392fc9709a3 7 *
AnnaBridge 189:f392fc9709a3 8 * o Redistributions of source code must retain the above copyright notice, this list
AnnaBridge 189:f392fc9709a3 9 * of conditions and the following disclaimer.
AnnaBridge 189:f392fc9709a3 10 *
AnnaBridge 189:f392fc9709a3 11 * o Redistributions in binary form must reproduce the above copyright notice, this
AnnaBridge 189:f392fc9709a3 12 * list of conditions and the following disclaimer in the documentation and/or
AnnaBridge 189:f392fc9709a3 13 * other materials provided with the distribution.
AnnaBridge 189:f392fc9709a3 14 *
AnnaBridge 189:f392fc9709a3 15 * o Neither the name of Freescale Semiconductor, Inc. nor the names of its
AnnaBridge 189:f392fc9709a3 16 * contributors may be used to endorse or promote products derived from this
AnnaBridge 189:f392fc9709a3 17 * software without specific prior written permission.
AnnaBridge 189:f392fc9709a3 18 *
AnnaBridge 189:f392fc9709a3 19 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
AnnaBridge 189:f392fc9709a3 20 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
AnnaBridge 189:f392fc9709a3 21 * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
AnnaBridge 189:f392fc9709a3 22 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
AnnaBridge 189:f392fc9709a3 23 * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
AnnaBridge 189:f392fc9709a3 24 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
AnnaBridge 189:f392fc9709a3 25 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
AnnaBridge 189:f392fc9709a3 26 * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
AnnaBridge 189:f392fc9709a3 27 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
AnnaBridge 189:f392fc9709a3 28 * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
AnnaBridge 189:f392fc9709a3 29 */
AnnaBridge 189:f392fc9709a3 30
AnnaBridge 189:f392fc9709a3 31 #ifndef _FSL_DAC_H_
AnnaBridge 189:f392fc9709a3 32 #define _FSL_DAC_H_
AnnaBridge 189:f392fc9709a3 33
AnnaBridge 189:f392fc9709a3 34 #include "fsl_common.h"
AnnaBridge 189:f392fc9709a3 35
AnnaBridge 189:f392fc9709a3 36 /*!
AnnaBridge 189:f392fc9709a3 37 * @addtogroup dac
AnnaBridge 189:f392fc9709a3 38 * @{
AnnaBridge 189:f392fc9709a3 39 */
AnnaBridge 189:f392fc9709a3 40
AnnaBridge 189:f392fc9709a3 41
AnnaBridge 189:f392fc9709a3 42 /*******************************************************************************
AnnaBridge 189:f392fc9709a3 43 * Definitions
AnnaBridge 189:f392fc9709a3 44 ******************************************************************************/
AnnaBridge 189:f392fc9709a3 45
AnnaBridge 189:f392fc9709a3 46 /*! @name Driver version */
AnnaBridge 189:f392fc9709a3 47 /*@{*/
AnnaBridge 189:f392fc9709a3 48 /*! @brief DAC driver version 2.0.1. */
AnnaBridge 189:f392fc9709a3 49 #define FSL_DAC_DRIVER_VERSION (MAKE_VERSION(2, 0, 1))
AnnaBridge 189:f392fc9709a3 50 /*@}*/
AnnaBridge 189:f392fc9709a3 51
AnnaBridge 189:f392fc9709a3 52 /*!
AnnaBridge 189:f392fc9709a3 53 * @brief DAC buffer flags.
AnnaBridge 189:f392fc9709a3 54 */
AnnaBridge 189:f392fc9709a3 55 enum _dac_buffer_status_flags
AnnaBridge 189:f392fc9709a3 56 {
AnnaBridge 189:f392fc9709a3 57 #if defined(FSL_FEATURE_DAC_HAS_WATERMARK_DETECTION) && FSL_FEATURE_DAC_HAS_WATERMARK_DETECTION
AnnaBridge 189:f392fc9709a3 58 kDAC_BufferWatermarkFlag = DAC_SR_DACBFWMF_MASK, /*!< DAC Buffer Watermark Flag. */
AnnaBridge 189:f392fc9709a3 59 #endif /* FSL_FEATURE_DAC_HAS_WATERMARK_DETECTION */
AnnaBridge 189:f392fc9709a3 60 kDAC_BufferReadPointerTopPositionFlag = DAC_SR_DACBFRPTF_MASK, /*!< DAC Buffer Read Pointer Top Position Flag. */
AnnaBridge 189:f392fc9709a3 61 kDAC_BufferReadPointerBottomPositionFlag = DAC_SR_DACBFRPBF_MASK, /*!< DAC Buffer Read Pointer Bottom Position
AnnaBridge 189:f392fc9709a3 62 Flag. */
AnnaBridge 189:f392fc9709a3 63 };
AnnaBridge 189:f392fc9709a3 64
AnnaBridge 189:f392fc9709a3 65 /*!
AnnaBridge 189:f392fc9709a3 66 * @brief DAC buffer interrupts.
AnnaBridge 189:f392fc9709a3 67 */
AnnaBridge 189:f392fc9709a3 68 enum _dac_buffer_interrupt_enable
AnnaBridge 189:f392fc9709a3 69 {
AnnaBridge 189:f392fc9709a3 70 #if defined(FSL_FEATURE_DAC_HAS_WATERMARK_DETECTION) && FSL_FEATURE_DAC_HAS_WATERMARK_DETECTION
AnnaBridge 189:f392fc9709a3 71 kDAC_BufferWatermarkInterruptEnable = DAC_C0_DACBWIEN_MASK, /*!< DAC Buffer Watermark Interrupt Enable. */
AnnaBridge 189:f392fc9709a3 72 #endif /* FSL_FEATURE_DAC_HAS_WATERMARK_DETECTION */
AnnaBridge 189:f392fc9709a3 73 kDAC_BufferReadPointerTopInterruptEnable = DAC_C0_DACBTIEN_MASK, /*!< DAC Buffer Read Pointer Top Flag Interrupt
AnnaBridge 189:f392fc9709a3 74 Enable. */
AnnaBridge 189:f392fc9709a3 75 kDAC_BufferReadPointerBottomInterruptEnable = DAC_C0_DACBBIEN_MASK, /*!< DAC Buffer Read Pointer Bottom Flag
AnnaBridge 189:f392fc9709a3 76 Interrupt Enable */
AnnaBridge 189:f392fc9709a3 77 };
AnnaBridge 189:f392fc9709a3 78
AnnaBridge 189:f392fc9709a3 79 /*!
AnnaBridge 189:f392fc9709a3 80 * @brief DAC reference voltage source.
AnnaBridge 189:f392fc9709a3 81 */
AnnaBridge 189:f392fc9709a3 82 typedef enum _dac_reference_voltage_source
AnnaBridge 189:f392fc9709a3 83 {
AnnaBridge 189:f392fc9709a3 84 kDAC_ReferenceVoltageSourceVref1 = 0U, /*!< The DAC selects DACREF_1 as the reference voltage. */
AnnaBridge 189:f392fc9709a3 85 kDAC_ReferenceVoltageSourceVref2 = 1U, /*!< The DAC selects DACREF_2 as the reference voltage. */
AnnaBridge 189:f392fc9709a3 86 } dac_reference_voltage_source_t;
AnnaBridge 189:f392fc9709a3 87
AnnaBridge 189:f392fc9709a3 88 /*!
AnnaBridge 189:f392fc9709a3 89 * @brief DAC buffer trigger mode.
AnnaBridge 189:f392fc9709a3 90 */
AnnaBridge 189:f392fc9709a3 91 typedef enum _dac_buffer_trigger_mode
AnnaBridge 189:f392fc9709a3 92 {
AnnaBridge 189:f392fc9709a3 93 kDAC_BufferTriggerByHardwareMode = 0U, /*!< The DAC hardware trigger is selected. */
AnnaBridge 189:f392fc9709a3 94 kDAC_BufferTriggerBySoftwareMode = 1U, /*!< The DAC software trigger is selected. */
AnnaBridge 189:f392fc9709a3 95 } dac_buffer_trigger_mode_t;
AnnaBridge 189:f392fc9709a3 96
AnnaBridge 189:f392fc9709a3 97 #if defined(FSL_FEATURE_DAC_HAS_WATERMARK_SELECTION) && FSL_FEATURE_DAC_HAS_WATERMARK_SELECTION
AnnaBridge 189:f392fc9709a3 98 /*!
AnnaBridge 189:f392fc9709a3 99 * @brief DAC buffer watermark.
AnnaBridge 189:f392fc9709a3 100 */
AnnaBridge 189:f392fc9709a3 101 typedef enum _dac_buffer_watermark
AnnaBridge 189:f392fc9709a3 102 {
AnnaBridge 189:f392fc9709a3 103 #if defined(FSL_FEATURE_DAC_HAS_WATERMARK_1_WORD) && FSL_FEATURE_DAC_HAS_WATERMARK_1_WORD
AnnaBridge 189:f392fc9709a3 104 kDAC_BufferWatermark1Word = 0U, /*!< 1 word away from the upper limit. */
AnnaBridge 189:f392fc9709a3 105 #endif /* FSL_FEATURE_DAC_HAS_WATERMARK_1_WORD */
AnnaBridge 189:f392fc9709a3 106 #if defined(FSL_FEATURE_DAC_HAS_WATERMARK_2_WORDS) && FSL_FEATURE_DAC_HAS_WATERMARK_2_WORDS
AnnaBridge 189:f392fc9709a3 107 kDAC_BufferWatermark2Word = 1U, /*!< 2 words away from the upper limit. */
AnnaBridge 189:f392fc9709a3 108 #endif /* FSL_FEATURE_DAC_HAS_WATERMARK_2_WORDS */
AnnaBridge 189:f392fc9709a3 109 #if defined(FSL_FEATURE_DAC_HAS_WATERMARK_3_WORDS) && FSL_FEATURE_DAC_HAS_WATERMARK_3_WORDS
AnnaBridge 189:f392fc9709a3 110 kDAC_BufferWatermark3Word = 2U, /*!< 3 words away from the upper limit. */
AnnaBridge 189:f392fc9709a3 111 #endif /* FSL_FEATURE_DAC_HAS_WATERMARK_3_WORDS */
AnnaBridge 189:f392fc9709a3 112 #if defined(FSL_FEATURE_DAC_HAS_WATERMARK_4_WORDS) && FSL_FEATURE_DAC_HAS_WATERMARK_4_WORDS
AnnaBridge 189:f392fc9709a3 113 kDAC_BufferWatermark4Word = 3U, /*!< 4 words away from the upper limit. */
AnnaBridge 189:f392fc9709a3 114 #endif /* FSL_FEATURE_DAC_HAS_WATERMARK_4_WORDS */
AnnaBridge 189:f392fc9709a3 115 } dac_buffer_watermark_t;
AnnaBridge 189:f392fc9709a3 116 #endif /* FSL_FEATURE_DAC_HAS_WATERMARK_SELECTION */
AnnaBridge 189:f392fc9709a3 117
AnnaBridge 189:f392fc9709a3 118 /*!
AnnaBridge 189:f392fc9709a3 119 * @brief DAC buffer work mode.
AnnaBridge 189:f392fc9709a3 120 */
AnnaBridge 189:f392fc9709a3 121 typedef enum _dac_buffer_work_mode
AnnaBridge 189:f392fc9709a3 122 {
AnnaBridge 189:f392fc9709a3 123 kDAC_BufferWorkAsNormalMode = 0U, /*!< Normal mode. */
AnnaBridge 189:f392fc9709a3 124 #if defined(FSL_FEATURE_DAC_HAS_BUFFER_SWING_MODE) && FSL_FEATURE_DAC_HAS_BUFFER_SWING_MODE
AnnaBridge 189:f392fc9709a3 125 kDAC_BufferWorkAsSwingMode, /*!< Swing mode. */
AnnaBridge 189:f392fc9709a3 126 #endif /* FSL_FEATURE_DAC_HAS_BUFFER_SWING_MODE */
AnnaBridge 189:f392fc9709a3 127 kDAC_BufferWorkAsOneTimeScanMode, /*!< One-Time Scan mode. */
AnnaBridge 189:f392fc9709a3 128 #if defined(FSL_FEATURE_DAC_HAS_BUFFER_FIFO_MODE) && FSL_FEATURE_DAC_HAS_BUFFER_FIFO_MODE
AnnaBridge 189:f392fc9709a3 129 kDAC_BufferWorkAsFIFOMode, /*!< FIFO mode. */
AnnaBridge 189:f392fc9709a3 130 #endif /* FSL_FEATURE_DAC_HAS_BUFFER_FIFO_MODE */
AnnaBridge 189:f392fc9709a3 131 } dac_buffer_work_mode_t;
AnnaBridge 189:f392fc9709a3 132
AnnaBridge 189:f392fc9709a3 133 /*!
AnnaBridge 189:f392fc9709a3 134 * @brief DAC module configuration.
AnnaBridge 189:f392fc9709a3 135 */
AnnaBridge 189:f392fc9709a3 136 typedef struct _dac_config
AnnaBridge 189:f392fc9709a3 137 {
AnnaBridge 189:f392fc9709a3 138 dac_reference_voltage_source_t referenceVoltageSource; /*!< Select the DAC reference voltage source. */
AnnaBridge 189:f392fc9709a3 139 bool enableLowPowerMode; /*!< Enable the low-power mode. */
AnnaBridge 189:f392fc9709a3 140 } dac_config_t;
AnnaBridge 189:f392fc9709a3 141
AnnaBridge 189:f392fc9709a3 142 /*!
AnnaBridge 189:f392fc9709a3 143 * @brief DAC buffer configuration.
AnnaBridge 189:f392fc9709a3 144 */
AnnaBridge 189:f392fc9709a3 145 typedef struct _dac_buffer_config
AnnaBridge 189:f392fc9709a3 146 {
AnnaBridge 189:f392fc9709a3 147 dac_buffer_trigger_mode_t triggerMode; /*!< Select the buffer's trigger mode. */
AnnaBridge 189:f392fc9709a3 148 #if defined(FSL_FEATURE_DAC_HAS_WATERMARK_SELECTION) && FSL_FEATURE_DAC_HAS_WATERMARK_SELECTION
AnnaBridge 189:f392fc9709a3 149 dac_buffer_watermark_t watermark; /*!< Select the buffer's watermark. */
AnnaBridge 189:f392fc9709a3 150 #endif /* FSL_FEATURE_DAC_HAS_WATERMARK_SELECTION */
AnnaBridge 189:f392fc9709a3 151 dac_buffer_work_mode_t workMode; /*!< Select the buffer's work mode. */
AnnaBridge 189:f392fc9709a3 152 uint8_t upperLimit; /*!< Set the upper limit for the buffer index.
AnnaBridge 189:f392fc9709a3 153 Normally, 0-15 is available for a buffer with 16 items. */
AnnaBridge 189:f392fc9709a3 154 } dac_buffer_config_t;
AnnaBridge 189:f392fc9709a3 155
AnnaBridge 189:f392fc9709a3 156 /*******************************************************************************
AnnaBridge 189:f392fc9709a3 157 * API
AnnaBridge 189:f392fc9709a3 158 ******************************************************************************/
AnnaBridge 189:f392fc9709a3 159 #if defined(__cplusplus)
AnnaBridge 189:f392fc9709a3 160 extern "C" {
AnnaBridge 189:f392fc9709a3 161 #endif
AnnaBridge 189:f392fc9709a3 162
AnnaBridge 189:f392fc9709a3 163 /*!
AnnaBridge 189:f392fc9709a3 164 * @name Initialization
AnnaBridge 189:f392fc9709a3 165 * @{
AnnaBridge 189:f392fc9709a3 166 */
AnnaBridge 189:f392fc9709a3 167
AnnaBridge 189:f392fc9709a3 168 /*!
AnnaBridge 189:f392fc9709a3 169 * @brief Initializes the DAC module.
AnnaBridge 189:f392fc9709a3 170 *
AnnaBridge 189:f392fc9709a3 171 * This function initializes the DAC module including the following operations.
AnnaBridge 189:f392fc9709a3 172 * - Enabling the clock for DAC module.
AnnaBridge 189:f392fc9709a3 173 * - Configuring the DAC converter with a user configuration.
AnnaBridge 189:f392fc9709a3 174 * - Enabling the DAC module.
AnnaBridge 189:f392fc9709a3 175 *
AnnaBridge 189:f392fc9709a3 176 * @param base DAC peripheral base address.
AnnaBridge 189:f392fc9709a3 177 * @param config Pointer to the configuration structure. See "dac_config_t".
AnnaBridge 189:f392fc9709a3 178 */
AnnaBridge 189:f392fc9709a3 179 void DAC_Init(DAC_Type *base, const dac_config_t *config);
AnnaBridge 189:f392fc9709a3 180
AnnaBridge 189:f392fc9709a3 181 /*!
AnnaBridge 189:f392fc9709a3 182 * @brief De-initializes the DAC module.
AnnaBridge 189:f392fc9709a3 183 *
AnnaBridge 189:f392fc9709a3 184 * This function de-initializes the DAC module including the following operations.
AnnaBridge 189:f392fc9709a3 185 * - Disabling the DAC module.
AnnaBridge 189:f392fc9709a3 186 * - Disabling the clock for the DAC module.
AnnaBridge 189:f392fc9709a3 187 *
AnnaBridge 189:f392fc9709a3 188 * @param base DAC peripheral base address.
AnnaBridge 189:f392fc9709a3 189 */
AnnaBridge 189:f392fc9709a3 190 void DAC_Deinit(DAC_Type *base);
AnnaBridge 189:f392fc9709a3 191
AnnaBridge 189:f392fc9709a3 192 /*!
AnnaBridge 189:f392fc9709a3 193 * @brief Initializes the DAC user configuration structure.
AnnaBridge 189:f392fc9709a3 194 *
AnnaBridge 189:f392fc9709a3 195 * This function initializes the user configuration structure to a default value. The default values are as follows.
AnnaBridge 189:f392fc9709a3 196 * @code
AnnaBridge 189:f392fc9709a3 197 * config->referenceVoltageSource = kDAC_ReferenceVoltageSourceVref2;
AnnaBridge 189:f392fc9709a3 198 * config->enableLowPowerMode = false;
AnnaBridge 189:f392fc9709a3 199 * @endcode
AnnaBridge 189:f392fc9709a3 200 * @param config Pointer to the configuration structure. See "dac_config_t".
AnnaBridge 189:f392fc9709a3 201 */
AnnaBridge 189:f392fc9709a3 202 void DAC_GetDefaultConfig(dac_config_t *config);
AnnaBridge 189:f392fc9709a3 203
AnnaBridge 189:f392fc9709a3 204 /*!
AnnaBridge 189:f392fc9709a3 205 * @brief Enables the DAC module.
AnnaBridge 189:f392fc9709a3 206 *
AnnaBridge 189:f392fc9709a3 207 * @param base DAC peripheral base address.
AnnaBridge 189:f392fc9709a3 208 * @param enable Enables or disables the feature.
AnnaBridge 189:f392fc9709a3 209 */
AnnaBridge 189:f392fc9709a3 210 static inline void DAC_Enable(DAC_Type *base, bool enable)
AnnaBridge 189:f392fc9709a3 211 {
AnnaBridge 189:f392fc9709a3 212 if (enable)
AnnaBridge 189:f392fc9709a3 213 {
AnnaBridge 189:f392fc9709a3 214 base->C0 |= DAC_C0_DACEN_MASK;
AnnaBridge 189:f392fc9709a3 215 }
AnnaBridge 189:f392fc9709a3 216 else
AnnaBridge 189:f392fc9709a3 217 {
AnnaBridge 189:f392fc9709a3 218 base->C0 &= ~DAC_C0_DACEN_MASK;
AnnaBridge 189:f392fc9709a3 219 }
AnnaBridge 189:f392fc9709a3 220 }
AnnaBridge 189:f392fc9709a3 221
AnnaBridge 189:f392fc9709a3 222 /* @} */
AnnaBridge 189:f392fc9709a3 223
AnnaBridge 189:f392fc9709a3 224 /*!
AnnaBridge 189:f392fc9709a3 225 * @name Buffer
AnnaBridge 189:f392fc9709a3 226 * @{
AnnaBridge 189:f392fc9709a3 227 */
AnnaBridge 189:f392fc9709a3 228
AnnaBridge 189:f392fc9709a3 229 /*!
AnnaBridge 189:f392fc9709a3 230 * @brief Enables the DAC buffer.
AnnaBridge 189:f392fc9709a3 231 *
AnnaBridge 189:f392fc9709a3 232 * @param base DAC peripheral base address.
AnnaBridge 189:f392fc9709a3 233 * @param enable Enables or disables the feature.
AnnaBridge 189:f392fc9709a3 234 */
AnnaBridge 189:f392fc9709a3 235 static inline void DAC_EnableBuffer(DAC_Type *base, bool enable)
AnnaBridge 189:f392fc9709a3 236 {
AnnaBridge 189:f392fc9709a3 237 if (enable)
AnnaBridge 189:f392fc9709a3 238 {
AnnaBridge 189:f392fc9709a3 239 base->C1 |= DAC_C1_DACBFEN_MASK;
AnnaBridge 189:f392fc9709a3 240 }
AnnaBridge 189:f392fc9709a3 241 else
AnnaBridge 189:f392fc9709a3 242 {
AnnaBridge 189:f392fc9709a3 243 base->C1 &= ~DAC_C1_DACBFEN_MASK;
AnnaBridge 189:f392fc9709a3 244 }
AnnaBridge 189:f392fc9709a3 245 }
AnnaBridge 189:f392fc9709a3 246
AnnaBridge 189:f392fc9709a3 247 /*!
AnnaBridge 189:f392fc9709a3 248 * @brief Configures the CMP buffer.
AnnaBridge 189:f392fc9709a3 249 *
AnnaBridge 189:f392fc9709a3 250 * @param base DAC peripheral base address.
AnnaBridge 189:f392fc9709a3 251 * @param config Pointer to the configuration structure. See "dac_buffer_config_t".
AnnaBridge 189:f392fc9709a3 252 */
AnnaBridge 189:f392fc9709a3 253 void DAC_SetBufferConfig(DAC_Type *base, const dac_buffer_config_t *config);
AnnaBridge 189:f392fc9709a3 254
AnnaBridge 189:f392fc9709a3 255 /*!
AnnaBridge 189:f392fc9709a3 256 * @brief Initializes the DAC buffer configuration structure.
AnnaBridge 189:f392fc9709a3 257 *
AnnaBridge 189:f392fc9709a3 258 * This function initializes the DAC buffer configuration structure to default values. The default values are as follows.
AnnaBridge 189:f392fc9709a3 259 * @code
AnnaBridge 189:f392fc9709a3 260 * config->triggerMode = kDAC_BufferTriggerBySoftwareMode;
AnnaBridge 189:f392fc9709a3 261 * config->watermark = kDAC_BufferWatermark1Word;
AnnaBridge 189:f392fc9709a3 262 * config->workMode = kDAC_BufferWorkAsNormalMode;
AnnaBridge 189:f392fc9709a3 263 * config->upperLimit = DAC_DATL_COUNT - 1U;
AnnaBridge 189:f392fc9709a3 264 * @endcode
AnnaBridge 189:f392fc9709a3 265 * @param config Pointer to the configuration structure. See "dac_buffer_config_t".
AnnaBridge 189:f392fc9709a3 266 */
AnnaBridge 189:f392fc9709a3 267 void DAC_GetDefaultBufferConfig(dac_buffer_config_t *config);
AnnaBridge 189:f392fc9709a3 268
AnnaBridge 189:f392fc9709a3 269 /*!
AnnaBridge 189:f392fc9709a3 270 * @brief Enables the DMA for DAC buffer.
AnnaBridge 189:f392fc9709a3 271 *
AnnaBridge 189:f392fc9709a3 272 * @param base DAC peripheral base address.
AnnaBridge 189:f392fc9709a3 273 * @param enable Enables or disables the feature.
AnnaBridge 189:f392fc9709a3 274 */
AnnaBridge 189:f392fc9709a3 275 static inline void DAC_EnableBufferDMA(DAC_Type *base, bool enable)
AnnaBridge 189:f392fc9709a3 276 {
AnnaBridge 189:f392fc9709a3 277 if (enable)
AnnaBridge 189:f392fc9709a3 278 {
AnnaBridge 189:f392fc9709a3 279 base->C1 |= DAC_C1_DMAEN_MASK;
AnnaBridge 189:f392fc9709a3 280 }
AnnaBridge 189:f392fc9709a3 281 else
AnnaBridge 189:f392fc9709a3 282 {
AnnaBridge 189:f392fc9709a3 283 base->C1 &= ~DAC_C1_DMAEN_MASK;
AnnaBridge 189:f392fc9709a3 284 }
AnnaBridge 189:f392fc9709a3 285 }
AnnaBridge 189:f392fc9709a3 286
AnnaBridge 189:f392fc9709a3 287 /*!
AnnaBridge 189:f392fc9709a3 288 * @brief Sets the value for items in the buffer.
AnnaBridge 189:f392fc9709a3 289 *
AnnaBridge 189:f392fc9709a3 290 * @param base DAC peripheral base address.
AnnaBridge 189:f392fc9709a3 291 * @param index Setting the index for items in the buffer. The available index should not exceed the size of the DAC buffer.
AnnaBridge 189:f392fc9709a3 292 * @param value Setting the value for items in the buffer. 12-bits are available.
AnnaBridge 189:f392fc9709a3 293 */
AnnaBridge 189:f392fc9709a3 294 void DAC_SetBufferValue(DAC_Type *base, uint8_t index, uint16_t value);
AnnaBridge 189:f392fc9709a3 295
AnnaBridge 189:f392fc9709a3 296 /*!
AnnaBridge 189:f392fc9709a3 297 * @brief Triggers the buffer using software and updates the read pointer of the DAC buffer.
AnnaBridge 189:f392fc9709a3 298 *
AnnaBridge 189:f392fc9709a3 299 * This function triggers the function using software. The read pointer of the DAC buffer is updated with one step
AnnaBridge 189:f392fc9709a3 300 * after this function is called. Changing the read pointer depends on the buffer's work mode.
AnnaBridge 189:f392fc9709a3 301 *
AnnaBridge 189:f392fc9709a3 302 * @param base DAC peripheral base address.
AnnaBridge 189:f392fc9709a3 303 */
AnnaBridge 189:f392fc9709a3 304 static inline void DAC_DoSoftwareTriggerBuffer(DAC_Type *base)
AnnaBridge 189:f392fc9709a3 305 {
AnnaBridge 189:f392fc9709a3 306 base->C0 |= DAC_C0_DACSWTRG_MASK;
AnnaBridge 189:f392fc9709a3 307 }
AnnaBridge 189:f392fc9709a3 308
AnnaBridge 189:f392fc9709a3 309 /*!
AnnaBridge 189:f392fc9709a3 310 * @brief Gets the current read pointer of the DAC buffer.
AnnaBridge 189:f392fc9709a3 311 *
AnnaBridge 189:f392fc9709a3 312 * This function gets the current read pointer of the DAC buffer.
AnnaBridge 189:f392fc9709a3 313 * The current output value depends on the item indexed by the read pointer. It is updated either
AnnaBridge 189:f392fc9709a3 314 * by a software trigger or a hardware trigger.
AnnaBridge 189:f392fc9709a3 315 *
AnnaBridge 189:f392fc9709a3 316 * @param base DAC peripheral base address.
AnnaBridge 189:f392fc9709a3 317 *
AnnaBridge 189:f392fc9709a3 318 * @return The current read pointer of the DAC buffer.
AnnaBridge 189:f392fc9709a3 319 */
AnnaBridge 189:f392fc9709a3 320 static inline uint8_t DAC_GetBufferReadPointer(DAC_Type *base)
AnnaBridge 189:f392fc9709a3 321 {
AnnaBridge 189:f392fc9709a3 322 return ((base->C2 & DAC_C2_DACBFRP_MASK) >> DAC_C2_DACBFRP_SHIFT);
AnnaBridge 189:f392fc9709a3 323 }
AnnaBridge 189:f392fc9709a3 324
AnnaBridge 189:f392fc9709a3 325 /*!
AnnaBridge 189:f392fc9709a3 326 * @brief Sets the current read pointer of the DAC buffer.
AnnaBridge 189:f392fc9709a3 327 *
AnnaBridge 189:f392fc9709a3 328 * This function sets the current read pointer of the DAC buffer.
AnnaBridge 189:f392fc9709a3 329 * The current output value depends on the item indexed by the read pointer. It is updated either by a
AnnaBridge 189:f392fc9709a3 330 * software trigger or a hardware trigger. After the read pointer changes, the DAC output value also changes.
AnnaBridge 189:f392fc9709a3 331 *
AnnaBridge 189:f392fc9709a3 332 * @param base DAC peripheral base address.
AnnaBridge 189:f392fc9709a3 333 * @param index Setting an index value for the pointer.
AnnaBridge 189:f392fc9709a3 334 */
AnnaBridge 189:f392fc9709a3 335 void DAC_SetBufferReadPointer(DAC_Type *base, uint8_t index);
AnnaBridge 189:f392fc9709a3 336
AnnaBridge 189:f392fc9709a3 337 /*!
AnnaBridge 189:f392fc9709a3 338 * @brief Enables interrupts for the DAC buffer.
AnnaBridge 189:f392fc9709a3 339 *
AnnaBridge 189:f392fc9709a3 340 * @param base DAC peripheral base address.
AnnaBridge 189:f392fc9709a3 341 * @param mask Mask value for interrupts. See "_dac_buffer_interrupt_enable".
AnnaBridge 189:f392fc9709a3 342 */
AnnaBridge 189:f392fc9709a3 343 void DAC_EnableBufferInterrupts(DAC_Type *base, uint32_t mask);
AnnaBridge 189:f392fc9709a3 344
AnnaBridge 189:f392fc9709a3 345 /*!
AnnaBridge 189:f392fc9709a3 346 * @brief Disables interrupts for the DAC buffer.
AnnaBridge 189:f392fc9709a3 347 *
AnnaBridge 189:f392fc9709a3 348 * @param base DAC peripheral base address.
AnnaBridge 189:f392fc9709a3 349 * @param mask Mask value for interrupts. See "_dac_buffer_interrupt_enable".
AnnaBridge 189:f392fc9709a3 350 */
AnnaBridge 189:f392fc9709a3 351 void DAC_DisableBufferInterrupts(DAC_Type *base, uint32_t mask);
AnnaBridge 189:f392fc9709a3 352
AnnaBridge 189:f392fc9709a3 353 /*!
AnnaBridge 189:f392fc9709a3 354 * @brief Gets the flags of events for the DAC buffer.
AnnaBridge 189:f392fc9709a3 355 *
AnnaBridge 189:f392fc9709a3 356 * @param base DAC peripheral base address.
AnnaBridge 189:f392fc9709a3 357 *
AnnaBridge 189:f392fc9709a3 358 * @return Mask value for the asserted flags. See "_dac_buffer_status_flags".
AnnaBridge 189:f392fc9709a3 359 */
AnnaBridge 189:f392fc9709a3 360 uint32_t DAC_GetBufferStatusFlags(DAC_Type *base);
AnnaBridge 189:f392fc9709a3 361
AnnaBridge 189:f392fc9709a3 362 /*!
AnnaBridge 189:f392fc9709a3 363 * @brief Clears the flags of events for the DAC buffer.
AnnaBridge 189:f392fc9709a3 364 *
AnnaBridge 189:f392fc9709a3 365 * @param base DAC peripheral base address.
AnnaBridge 189:f392fc9709a3 366 * @param mask Mask value for flags. See "_dac_buffer_status_flags_t".
AnnaBridge 189:f392fc9709a3 367 */
AnnaBridge 189:f392fc9709a3 368 void DAC_ClearBufferStatusFlags(DAC_Type *base, uint32_t mask);
AnnaBridge 189:f392fc9709a3 369
AnnaBridge 189:f392fc9709a3 370 /* @} */
AnnaBridge 189:f392fc9709a3 371
AnnaBridge 189:f392fc9709a3 372 #if defined(__cplusplus)
AnnaBridge 189:f392fc9709a3 373 }
AnnaBridge 189:f392fc9709a3 374 #endif
AnnaBridge 189:f392fc9709a3 375 /*!
AnnaBridge 189:f392fc9709a3 376 * @}
AnnaBridge 189:f392fc9709a3 377 */
AnnaBridge 189:f392fc9709a3 378 #endif /* _FSL_DAC_H_ */