mbed official / mbed

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

Dependents:   hello SerialTestv11 SerialTestv12 Sierpinski ... more

mbed 2

This is the mbed 2 library. If you'd like to learn about Mbed OS please see the mbed-os docs.

TARGET_FF_LPC546XX/TOOLCHAIN_IAR/fsl_adc.h@172:65be27845400, 2019-02-20 (annotated)

Committer:
AnnaBridge
Date:
Wed Feb 20 20:53:29 2019 +0000
Revision:
172:65be27845400
Parent:
171:3a7713b1edbc 
mbed library release version 165

Who changed what in which revision?

UserRevisionLine numberNew contents of line
AnnaBridge 171:3a7713b1edbc 1 /*
AnnaBridge 171:3a7713b1edbc 2 * The Clear BSD License
AnnaBridge 171:3a7713b1edbc 3 * Copyright (c) 2016, Freescale Semiconductor, Inc.
AnnaBridge 171:3a7713b1edbc 4 * Copyright 2016-2017 NXP
AnnaBridge 171:3a7713b1edbc 5 * All rights reserved.
AnnaBridge 171:3a7713b1edbc 6 *
AnnaBridge 171:3a7713b1edbc 7 * Redistribution and use in source and binary forms, with or without modification,
AnnaBridge 171:3a7713b1edbc 8 * are permitted (subject to the limitations in the disclaimer below) provided
AnnaBridge 171:3a7713b1edbc 9 * that the following conditions are met:
AnnaBridge 171:3a7713b1edbc 10 *
AnnaBridge 171:3a7713b1edbc 11 * o Redistributions of source code must retain the above copyright notice, this list
AnnaBridge 171:3a7713b1edbc 12 * of conditions and the following disclaimer.
AnnaBridge 171:3a7713b1edbc 13 *
AnnaBridge 171:3a7713b1edbc 14 * o Redistributions in binary form must reproduce the above copyright notice, this
AnnaBridge 171:3a7713b1edbc 15 * list of conditions and the following disclaimer in the documentation and/or
AnnaBridge 171:3a7713b1edbc 16 * other materials provided with the distribution.
AnnaBridge 171:3a7713b1edbc 17 *
AnnaBridge 171:3a7713b1edbc 18 * o Neither the name of the copyright holder nor the names of its
AnnaBridge 171:3a7713b1edbc 19 * contributors may be used to endorse or promote products derived from this
AnnaBridge 171:3a7713b1edbc 20 * software without specific prior written permission.
AnnaBridge 171:3a7713b1edbc 21 *
AnnaBridge 171:3a7713b1edbc 22 * NO EXPRESS OR IMPLIED LICENSES TO ANY PARTY'S PATENT RIGHTS ARE GRANTED BY THIS LICENSE.
AnnaBridge 171:3a7713b1edbc 23 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
AnnaBridge 171:3a7713b1edbc 24 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
AnnaBridge 171:3a7713b1edbc 25 * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
AnnaBridge 171:3a7713b1edbc 26 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
AnnaBridge 171:3a7713b1edbc 27 * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
AnnaBridge 171:3a7713b1edbc 28 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
AnnaBridge 171:3a7713b1edbc 29 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
AnnaBridge 171:3a7713b1edbc 30 * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
AnnaBridge 171:3a7713b1edbc 31 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
AnnaBridge 171:3a7713b1edbc 32 * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
AnnaBridge 171:3a7713b1edbc 33 */
AnnaBridge 171:3a7713b1edbc 34
AnnaBridge 171:3a7713b1edbc 35 #ifndef __FSL_ADC_H__
AnnaBridge 171:3a7713b1edbc 36 #define __FSL_ADC_H__
AnnaBridge 171:3a7713b1edbc 37
AnnaBridge 171:3a7713b1edbc 38 #include "fsl_common.h"
AnnaBridge 171:3a7713b1edbc 39
AnnaBridge 171:3a7713b1edbc 40 /*!
AnnaBridge 171:3a7713b1edbc 41 * @addtogroup lpc_adc
AnnaBridge 171:3a7713b1edbc 42 * @{
AnnaBridge 171:3a7713b1edbc 43 */
AnnaBridge 171:3a7713b1edbc 44
AnnaBridge 171:3a7713b1edbc 45 /*! @file */
AnnaBridge 171:3a7713b1edbc 46
AnnaBridge 171:3a7713b1edbc 47 /*******************************************************************************
AnnaBridge 171:3a7713b1edbc 48 * Definitions
AnnaBridge 171:3a7713b1edbc 49 ******************************************************************************/
AnnaBridge 171:3a7713b1edbc 50
AnnaBridge 171:3a7713b1edbc 51 /*! @name Driver version */
AnnaBridge 171:3a7713b1edbc 52 /*@{*/
AnnaBridge 171:3a7713b1edbc 53 /*! @brief ADC driver version 2.1.0. */
AnnaBridge 171:3a7713b1edbc 54 #define LPC_ADC_DRIVER_VERSION (MAKE_VERSION(2, 1, 0))
AnnaBridge 171:3a7713b1edbc 55 /*@}*/
AnnaBridge 171:3a7713b1edbc 56
AnnaBridge 171:3a7713b1edbc 57 /*!
AnnaBridge 171:3a7713b1edbc 58 * @brief Flags
AnnaBridge 171:3a7713b1edbc 59 */
AnnaBridge 171:3a7713b1edbc 60 enum _adc_status_flags
AnnaBridge 171:3a7713b1edbc 61 {
AnnaBridge 171:3a7713b1edbc 62 kADC_ThresholdCompareFlagOnChn0 = 1U << 0U, /*!< Threshold comparison event on Channel 0. */
AnnaBridge 171:3a7713b1edbc 63 kADC_ThresholdCompareFlagOnChn1 = 1U << 1U, /*!< Threshold comparison event on Channel 1. */
AnnaBridge 171:3a7713b1edbc 64 kADC_ThresholdCompareFlagOnChn2 = 1U << 2U, /*!< Threshold comparison event on Channel 2. */
AnnaBridge 171:3a7713b1edbc 65 kADC_ThresholdCompareFlagOnChn3 = 1U << 3U, /*!< Threshold comparison event on Channel 3. */
AnnaBridge 171:3a7713b1edbc 66 kADC_ThresholdCompareFlagOnChn4 = 1U << 4U, /*!< Threshold comparison event on Channel 4. */
AnnaBridge 171:3a7713b1edbc 67 kADC_ThresholdCompareFlagOnChn5 = 1U << 5U, /*!< Threshold comparison event on Channel 5. */
AnnaBridge 171:3a7713b1edbc 68 kADC_ThresholdCompareFlagOnChn6 = 1U << 6U, /*!< Threshold comparison event on Channel 6. */
AnnaBridge 171:3a7713b1edbc 69 kADC_ThresholdCompareFlagOnChn7 = 1U << 7U, /*!< Threshold comparison event on Channel 7. */
AnnaBridge 171:3a7713b1edbc 70 kADC_ThresholdCompareFlagOnChn8 = 1U << 8U, /*!< Threshold comparison event on Channel 8. */
AnnaBridge 171:3a7713b1edbc 71 kADC_ThresholdCompareFlagOnChn9 = 1U << 9U, /*!< Threshold comparison event on Channel 9. */
AnnaBridge 171:3a7713b1edbc 72 kADC_ThresholdCompareFlagOnChn10 = 1U << 10U, /*!< Threshold comparison event on Channel 10. */
AnnaBridge 171:3a7713b1edbc 73 kADC_ThresholdCompareFlagOnChn11 = 1U << 11U, /*!< Threshold comparison event on Channel 11. */
AnnaBridge 171:3a7713b1edbc 74 kADC_OverrunFlagForChn0 =
AnnaBridge 171:3a7713b1edbc 75 1U << 12U, /*!< Mirror the OVERRUN status flag from the result register for ADC channel 0. */
AnnaBridge 171:3a7713b1edbc 76 kADC_OverrunFlagForChn1 =
AnnaBridge 171:3a7713b1edbc 77 1U << 13U, /*!< Mirror the OVERRUN status flag from the result register for ADC channel 1. */
AnnaBridge 171:3a7713b1edbc 78 kADC_OverrunFlagForChn2 =
AnnaBridge 171:3a7713b1edbc 79 1U << 14U, /*!< Mirror the OVERRUN status flag from the result register for ADC channel 2. */
AnnaBridge 171:3a7713b1edbc 80 kADC_OverrunFlagForChn3 =
AnnaBridge 171:3a7713b1edbc 81 1U << 15U, /*!< Mirror the OVERRUN status flag from the result register for ADC channel 3. */
AnnaBridge 171:3a7713b1edbc 82 kADC_OverrunFlagForChn4 =
AnnaBridge 171:3a7713b1edbc 83 1U << 16U, /*!< Mirror the OVERRUN status flag from the result register for ADC channel 4. */
AnnaBridge 171:3a7713b1edbc 84 kADC_OverrunFlagForChn5 =
AnnaBridge 171:3a7713b1edbc 85 1U << 17U, /*!< Mirror the OVERRUN status flag from the result register for ADC channel 5. */
AnnaBridge 171:3a7713b1edbc 86 kADC_OverrunFlagForChn6 =
AnnaBridge 171:3a7713b1edbc 87 1U << 18U, /*!< Mirror the OVERRUN status flag from the result register for ADC channel 6. */
AnnaBridge 171:3a7713b1edbc 88 kADC_OverrunFlagForChn7 =
AnnaBridge 171:3a7713b1edbc 89 1U << 19U, /*!< Mirror the OVERRUN status flag from the result register for ADC channel 7. */
AnnaBridge 171:3a7713b1edbc 90 kADC_OverrunFlagForChn8 =
AnnaBridge 171:3a7713b1edbc 91 1U << 20U, /*!< Mirror the OVERRUN status flag from the result register for ADC channel 8. */
AnnaBridge 171:3a7713b1edbc 92 kADC_OverrunFlagForChn9 =
AnnaBridge 171:3a7713b1edbc 93 1U << 21U, /*!< Mirror the OVERRUN status flag from the result register for ADC channel 9. */
AnnaBridge 171:3a7713b1edbc 94 kADC_OverrunFlagForChn10 =
AnnaBridge 171:3a7713b1edbc 95 1U << 22U, /*!< Mirror the OVERRUN status flag from the result register for ADC channel 10. */
AnnaBridge 171:3a7713b1edbc 96 kADC_OverrunFlagForChn11 =
AnnaBridge 171:3a7713b1edbc 97 1U << 23U, /*!< Mirror the OVERRUN status flag from the result register for ADC channel 11. */
AnnaBridge 171:3a7713b1edbc 98 kADC_GlobalOverrunFlagForSeqA = 1U << 24U, /*!< Mirror the glabal OVERRUN status flag for conversion sequence A. */
AnnaBridge 171:3a7713b1edbc 99 kADC_GlobalOverrunFlagForSeqB = 1U << 25U, /*!< Mirror the global OVERRUN status flag for conversion sequence B. */
AnnaBridge 171:3a7713b1edbc 100 kADC_ConvSeqAInterruptFlag = 1U << 28U, /*!< Sequence A interrupt/DMA trigger. */
AnnaBridge 171:3a7713b1edbc 101 kADC_ConvSeqBInterruptFlag = 1U << 29U, /*!< Sequence B interrupt/DMA trigger. */
AnnaBridge 171:3a7713b1edbc 102 kADC_ThresholdCompareInterruptFlag = 1U << 30U, /*!< Threshold comparision interrupt flag. */
AnnaBridge 171:3a7713b1edbc 103 kADC_OverrunInterruptFlag = 1U << 31U, /*!< Overrun interrupt flag. */
AnnaBridge 171:3a7713b1edbc 104 };
AnnaBridge 171:3a7713b1edbc 105
AnnaBridge 171:3a7713b1edbc 106 /*!
AnnaBridge 171:3a7713b1edbc 107 * @brief Interrupts
AnnaBridge 171:3a7713b1edbc 108 * @note Not all the interrupt options are listed here
AnnaBridge 171:3a7713b1edbc 109 */
AnnaBridge 171:3a7713b1edbc 110 enum _adc_interrupt_enable
AnnaBridge 171:3a7713b1edbc 111 {
AnnaBridge 171:3a7713b1edbc 112 kADC_ConvSeqAInterruptEnable = ADC_INTEN_SEQA_INTEN_MASK, /*!< Enable interrupt upon completion of each individual
AnnaBridge 171:3a7713b1edbc 113 conversion in sequence A, or entire sequence. */
AnnaBridge 171:3a7713b1edbc 114 kADC_ConvSeqBInterruptEnable = ADC_INTEN_SEQB_INTEN_MASK, /*!< Enable interrupt upon completion of each individual
AnnaBridge 171:3a7713b1edbc 115 conversion in sequence B, or entire sequence. */
AnnaBridge 171:3a7713b1edbc 116 kADC_OverrunInterruptEnable = ADC_INTEN_OVR_INTEN_MASK, /*!< Enable the detection of an overrun condition on any of
AnnaBridge 171:3a7713b1edbc 117 the channel data registers will cause an overrun
AnnaBridge 171:3a7713b1edbc 118 interrupt/DMA trigger. */
AnnaBridge 171:3a7713b1edbc 119 };
AnnaBridge 171:3a7713b1edbc 120
AnnaBridge 171:3a7713b1edbc 121 /*!
AnnaBridge 171:3a7713b1edbc 122 * @brief Define selection of clock mode.
AnnaBridge 171:3a7713b1edbc 123 */
AnnaBridge 171:3a7713b1edbc 124 typedef enum _adc_clock_mode
AnnaBridge 171:3a7713b1edbc 125 {
AnnaBridge 171:3a7713b1edbc 126 kADC_ClockSynchronousMode =
AnnaBridge 171:3a7713b1edbc 127 0U, /*!< The ADC clock would be derived from the system clock based on "clockDividerNumber". */
AnnaBridge 171:3a7713b1edbc 128 kADC_ClockAsynchronousMode = 1U, /*!< The ADC clock would be based on the SYSCON block's divider. */
AnnaBridge 171:3a7713b1edbc 129 } adc_clock_mode_t;
AnnaBridge 171:3a7713b1edbc 130
AnnaBridge 171:3a7713b1edbc 131 /*!
AnnaBridge 171:3a7713b1edbc 132 * @brief Define selection of resolution.
AnnaBridge 171:3a7713b1edbc 133 */
AnnaBridge 171:3a7713b1edbc 134 typedef enum _adc_resolution
AnnaBridge 171:3a7713b1edbc 135 {
AnnaBridge 171:3a7713b1edbc 136 kADC_Resolution6bit = 0U, /*!< 6-bit resolution. */
AnnaBridge 171:3a7713b1edbc 137 kADC_Resolution8bit = 1U, /*!< 8-bit resolution. */
AnnaBridge 171:3a7713b1edbc 138 kADC_Resolution10bit = 2U, /*!< 10-bit resolution. */
AnnaBridge 171:3a7713b1edbc 139 kADC_Resolution12bit = 3U, /*!< 12-bit resolution. */
AnnaBridge 171:3a7713b1edbc 140 } adc_resolution_t;
AnnaBridge 171:3a7713b1edbc 141
AnnaBridge 171:3a7713b1edbc 142 /*!
AnnaBridge 171:3a7713b1edbc 143 * @brief Define selection of polarity of selected input trigger for conversion sequence.
AnnaBridge 171:3a7713b1edbc 144 */
AnnaBridge 171:3a7713b1edbc 145 typedef enum _adc_trigger_polarity
AnnaBridge 171:3a7713b1edbc 146 {
AnnaBridge 171:3a7713b1edbc 147 kADC_TriggerPolarityNegativeEdge = 0U, /*!< A negative edge launches the conversion sequence on the trigger(s). */
AnnaBridge 171:3a7713b1edbc 148 kADC_TriggerPolarityPositiveEdge = 1U, /*!< A positive edge launches the conversion sequence on the trigger(s). */
AnnaBridge 171:3a7713b1edbc 149 } adc_trigger_polarity_t;
AnnaBridge 171:3a7713b1edbc 150
AnnaBridge 171:3a7713b1edbc 151 /*!
AnnaBridge 171:3a7713b1edbc 152 * @brief Define selection of conversion sequence's priority.
AnnaBridge 171:3a7713b1edbc 153 */
AnnaBridge 171:3a7713b1edbc 154 typedef enum _adc_priority
AnnaBridge 171:3a7713b1edbc 155 {
AnnaBridge 171:3a7713b1edbc 156 kADC_PriorityLow = 0U, /*!< This sequence would be preempted when another sequence is started. */
AnnaBridge 171:3a7713b1edbc 157 kADC_PriorityHigh = 1U, /*!< This sequence would preempt other sequence even when it is started. */
AnnaBridge 171:3a7713b1edbc 158 } adc_priority_t;
AnnaBridge 171:3a7713b1edbc 159
AnnaBridge 171:3a7713b1edbc 160 /*!
AnnaBridge 171:3a7713b1edbc 161 * @brief Define selection of conversion sequence's interrupt.
AnnaBridge 171:3a7713b1edbc 162 */
AnnaBridge 171:3a7713b1edbc 163 typedef enum _adc_seq_interrupt_mode
AnnaBridge 171:3a7713b1edbc 164 {
AnnaBridge 171:3a7713b1edbc 165 kADC_InterruptForEachConversion = 0U, /*!< The sequence interrupt/DMA trigger will be set at the end of each
AnnaBridge 171:3a7713b1edbc 166 individual ADC conversion inside this conversion sequence. */
AnnaBridge 171:3a7713b1edbc 167 kADC_InterruptForEachSequence = 1U, /*!< The sequence interrupt/DMA trigger will be set when the entire set of
AnnaBridge 171:3a7713b1edbc 168 this sequence conversions completes. */
AnnaBridge 171:3a7713b1edbc 169 } adc_seq_interrupt_mode_t;
AnnaBridge 171:3a7713b1edbc 170
AnnaBridge 171:3a7713b1edbc 171 /*!
AnnaBridge 171:3a7713b1edbc 172 * @brief Define status of threshold compare result.
AnnaBridge 171:3a7713b1edbc 173 */
AnnaBridge 171:3a7713b1edbc 174 typedef enum _adc_threshold_compare_status
AnnaBridge 171:3a7713b1edbc 175 {
AnnaBridge 171:3a7713b1edbc 176 kADC_ThresholdCompareInRange = 0U, /*!< LOW threshold <= conversion value <= HIGH threshold. */
AnnaBridge 171:3a7713b1edbc 177 kADC_ThresholdCompareBelowRange = 1U, /*!< conversion value < LOW threshold. */
AnnaBridge 171:3a7713b1edbc 178 kADC_ThresholdCompareAboveRange = 2U, /*!< conversion value > HIGH threshold. */
AnnaBridge 171:3a7713b1edbc 179 } adc_threshold_compare_status_t;
AnnaBridge 171:3a7713b1edbc 180
AnnaBridge 171:3a7713b1edbc 181 /*!
AnnaBridge 171:3a7713b1edbc 182 * @brief Define status of threshold crossing detection result.
AnnaBridge 171:3a7713b1edbc 183 */
AnnaBridge 171:3a7713b1edbc 184 typedef enum _adc_threshold_crossing_status
AnnaBridge 171:3a7713b1edbc 185 {
AnnaBridge 171:3a7713b1edbc 186 /* The conversion on this channel had the same relationship (above or below) to the threshold value established by
AnnaBridge 171:3a7713b1edbc 187 * the designated LOW threshold value as did the previous conversion on this channel. */
AnnaBridge 171:3a7713b1edbc 188 kADC_ThresholdCrossingNoDetected = 0U, /*!< No threshold Crossing detected. */
AnnaBridge 171:3a7713b1edbc 189
AnnaBridge 171:3a7713b1edbc 190 /* Indicates that a threshold crossing in the downward direction has occurred - i.e. the previous sample on this
AnnaBridge 171:3a7713b1edbc 191 * channel was above the threshold value established by the designated LOW threshold value and the current sample is
AnnaBridge 171:3a7713b1edbc 192 * below that threshold. */
AnnaBridge 171:3a7713b1edbc 193 kADC_ThresholdCrossingDownward = 2U, /*!< Downward Threshold Crossing detected. */
AnnaBridge 171:3a7713b1edbc 194
AnnaBridge 171:3a7713b1edbc 195 /* Indicates that a thre shold crossing in the upward direction has occurred - i.e. the previous sample on this
AnnaBridge 171:3a7713b1edbc 196 * channel was below the threshold value established by the designated LOW threshold value and the current sample is
AnnaBridge 171:3a7713b1edbc 197 * above that threshold. */
AnnaBridge 171:3a7713b1edbc 198 kADC_ThresholdCrossingUpward = 3U, /*!< Upward Threshold Crossing Detected. */
AnnaBridge 171:3a7713b1edbc 199 } adc_threshold_crossing_status_t;
AnnaBridge 171:3a7713b1edbc 200
AnnaBridge 171:3a7713b1edbc 201 /*!
AnnaBridge 171:3a7713b1edbc 202 * @brief Define interrupt mode for threshold compare event.
AnnaBridge 171:3a7713b1edbc 203 */
AnnaBridge 171:3a7713b1edbc 204 typedef enum _adc_threshold_interrupt_mode
AnnaBridge 171:3a7713b1edbc 205 {
AnnaBridge 171:3a7713b1edbc 206 kADC_ThresholdInterruptDisabled = 0U, /*!< Threshold comparison interrupt is disabled. */
AnnaBridge 171:3a7713b1edbc 207 kADC_ThresholdInterruptOnOutside = 1U, /*!< Threshold comparison interrupt is enabled on outside threshold. */
AnnaBridge 171:3a7713b1edbc 208 kADC_ThresholdInterruptOnCrossing = 2U, /*!< Threshold comparison interrupt is enabled on crossing threshold. */
AnnaBridge 171:3a7713b1edbc 209 } adc_threshold_interrupt_mode_t;
AnnaBridge 171:3a7713b1edbc 210
AnnaBridge 171:3a7713b1edbc 211 /*!
AnnaBridge 171:3a7713b1edbc 212 * @brief Define structure for configuring the block.
AnnaBridge 171:3a7713b1edbc 213 */
AnnaBridge 171:3a7713b1edbc 214 typedef struct _adc_config
AnnaBridge 171:3a7713b1edbc 215 {
AnnaBridge 171:3a7713b1edbc 216 adc_clock_mode_t clockMode; /*!< Select the clock mode for ADC converter. */
AnnaBridge 171:3a7713b1edbc 217 uint32_t clockDividerNumber; /*!< This field is only available when using kADC_ClockSynchronousMode for "clockMode"
AnnaBridge 171:3a7713b1edbc 218 field. The divider would be plused by 1 based on the value in this field. The
AnnaBridge 171:3a7713b1edbc 219 available range is in 8 bits. */
AnnaBridge 171:3a7713b1edbc 220 adc_resolution_t resolution; /*!< Select the conversion bits. */
AnnaBridge 171:3a7713b1edbc 221 bool enableBypassCalibration; /*!< By default, a calibration cycle must be performed each time the chip is
AnnaBridge 171:3a7713b1edbc 222 powered-up. Re-calibration may be warranted periodically - especially if
AnnaBridge 171:3a7713b1edbc 223 operating conditions have changed. To enable this option would avoid the need to
AnnaBridge 171:3a7713b1edbc 224 calibrate if offset error is not a concern in the application. */
AnnaBridge 171:3a7713b1edbc 225 uint32_t sampleTimeNumber; /*!< By default, with value as "0U", the sample period would be 2.5 ADC clocks. Then,
AnnaBridge 171:3a7713b1edbc 226 to plus the "sampleTimeNumber" value here. The available value range is in 3 bits.*/
AnnaBridge 171:3a7713b1edbc 227 } adc_config_t;
AnnaBridge 171:3a7713b1edbc 228
AnnaBridge 171:3a7713b1edbc 229 /*!
AnnaBridge 171:3a7713b1edbc 230 * @brief Define structure for configuring conversion sequence.
AnnaBridge 171:3a7713b1edbc 231 */
AnnaBridge 171:3a7713b1edbc 232 typedef struct _adc_conv_seq_config
AnnaBridge 171:3a7713b1edbc 233 {
AnnaBridge 171:3a7713b1edbc 234 uint32_t channelMask; /*!< Selects which one or more of the ADC channels will be sampled and converted when this
AnnaBridge 171:3a7713b1edbc 235 sequence is launched. The masked channels would be involved in current conversion
AnnaBridge 171:3a7713b1edbc 236 sequence, beginning with the lowest-order. The available range is in 12-bit. */
AnnaBridge 171:3a7713b1edbc 237 uint32_t triggerMask; /*!< Selects which one or more of the available hardware trigger sources will cause this
AnnaBridge 171:3a7713b1edbc 238 conversion sequence to be initiated. The available range is 6-bit.*/
AnnaBridge 171:3a7713b1edbc 239 adc_trigger_polarity_t triggerPolarity; /*!< Select the trigger to lauch conversion sequence. */
AnnaBridge 171:3a7713b1edbc 240 bool enableSyncBypass; /*!< To enable this feature allows the hardware trigger input to bypass synchronization
AnnaBridge 171:3a7713b1edbc 241 flip-flop stages and therefore shorten the time between the trigger input signal and the
AnnaBridge 171:3a7713b1edbc 242 start of a conversion. */
AnnaBridge 171:3a7713b1edbc 243 bool enableSingleStep; /*!< When enabling this feature, a trigger will launch a single conversion on the next
AnnaBridge 171:3a7713b1edbc 244 channel in the sequence instead of the default response of launching an entire sequence
AnnaBridge 171:3a7713b1edbc 245 of conversions. */
AnnaBridge 171:3a7713b1edbc 246 adc_seq_interrupt_mode_t interruptMode; /*!< Select the interrpt/DMA trigger mode. */
AnnaBridge 171:3a7713b1edbc 247 } adc_conv_seq_config_t;
AnnaBridge 171:3a7713b1edbc 248
AnnaBridge 171:3a7713b1edbc 249 /*!
AnnaBridge 171:3a7713b1edbc 250 * @brief Define structure of keeping conversion result information.
AnnaBridge 171:3a7713b1edbc 251 */
AnnaBridge 171:3a7713b1edbc 252 typedef struct _adc_result_info
AnnaBridge 171:3a7713b1edbc 253 {
AnnaBridge 171:3a7713b1edbc 254 uint32_t result; /*!< Keep the conversion data value. */
AnnaBridge 171:3a7713b1edbc 255 adc_threshold_compare_status_t thresholdCompareStatus; /*!< Keep the threshold compare status. */
AnnaBridge 171:3a7713b1edbc 256 adc_threshold_crossing_status_t thresholdCorssingStatus; /*!< Keep the threshold crossing status. */
AnnaBridge 171:3a7713b1edbc 257 uint32_t channelNumber; /*!< Keep the channel number for this conversion. */
AnnaBridge 171:3a7713b1edbc 258 bool overrunFlag; /*!< Keep the status whether the conversion is overrun or not. */
AnnaBridge 171:3a7713b1edbc 259 /* The data available flag would be returned by the reading result API. */
AnnaBridge 171:3a7713b1edbc 260 } adc_result_info_t;
AnnaBridge 171:3a7713b1edbc 261
AnnaBridge 171:3a7713b1edbc 262 #if defined(__cplusplus)
AnnaBridge 171:3a7713b1edbc 263 extern "C" {
AnnaBridge 171:3a7713b1edbc 264 #endif
AnnaBridge 171:3a7713b1edbc 265
AnnaBridge 171:3a7713b1edbc 266 /*******************************************************************************
AnnaBridge 171:3a7713b1edbc 267 * API
AnnaBridge 171:3a7713b1edbc 268 ******************************************************************************/
AnnaBridge 171:3a7713b1edbc 269
AnnaBridge 171:3a7713b1edbc 270 /*!
AnnaBridge 171:3a7713b1edbc 271 * @name Initialization and Deinitialization
AnnaBridge 171:3a7713b1edbc 272 * @{
AnnaBridge 171:3a7713b1edbc 273 */
AnnaBridge 171:3a7713b1edbc 274
AnnaBridge 171:3a7713b1edbc 275 /*!
AnnaBridge 171:3a7713b1edbc 276 * @brief Initialize the ADC module.
AnnaBridge 171:3a7713b1edbc 277 *
AnnaBridge 171:3a7713b1edbc 278 * @param base ADC peripheral base address.
AnnaBridge 171:3a7713b1edbc 279 * @param config Pointer to configuration structure, see to #adc_config_t.
AnnaBridge 171:3a7713b1edbc 280 */
AnnaBridge 171:3a7713b1edbc 281 void ADC_Init(ADC_Type *base, const adc_config_t *config);
AnnaBridge 171:3a7713b1edbc 282
AnnaBridge 171:3a7713b1edbc 283 /*!
AnnaBridge 171:3a7713b1edbc 284 * @brief Deinitialize the ADC module.
AnnaBridge 171:3a7713b1edbc 285 *
AnnaBridge 171:3a7713b1edbc 286 * @param base ADC peripheral base address.
AnnaBridge 171:3a7713b1edbc 287 */
AnnaBridge 171:3a7713b1edbc 288 void ADC_Deinit(ADC_Type *base);
AnnaBridge 171:3a7713b1edbc 289
AnnaBridge 171:3a7713b1edbc 290 /*!
AnnaBridge 171:3a7713b1edbc 291 * @brief Gets an available pre-defined settings for initial configuration.
AnnaBridge 171:3a7713b1edbc 292 *
AnnaBridge 171:3a7713b1edbc 293 * This function initializes the initial configuration structure with an available settings. The default values are:
AnnaBridge 171:3a7713b1edbc 294 * @code
AnnaBridge 171:3a7713b1edbc 295 * config->clockMode = kADC_ClockSynchronousMode;
AnnaBridge 171:3a7713b1edbc 296 * config->clockDividerNumber = 0U;
AnnaBridge 171:3a7713b1edbc 297 * config->resolution = kADC_Resolution12bit;
AnnaBridge 171:3a7713b1edbc 298 * config->enableBypassCalibration = false;
AnnaBridge 171:3a7713b1edbc 299 * config->sampleTimeNumber = 0U;
AnnaBridge 171:3a7713b1edbc 300 * @endcode
AnnaBridge 171:3a7713b1edbc 301 * @param config Pointer to configuration structure.
AnnaBridge 171:3a7713b1edbc 302 */
AnnaBridge 171:3a7713b1edbc 303 void ADC_GetDefaultConfig(adc_config_t *config);
AnnaBridge 171:3a7713b1edbc 304
AnnaBridge 171:3a7713b1edbc 305 /*!
AnnaBridge 171:3a7713b1edbc 306 * @brief Do the self hardware calibration.
AnnaBridge 171:3a7713b1edbc 307 *
AnnaBridge 171:3a7713b1edbc 308 * @param base ADC peripheral base address.
AnnaBridge 171:3a7713b1edbc 309 * @retval true Calibration succeed.
AnnaBridge 171:3a7713b1edbc 310 * @retval false Calibration failed.
AnnaBridge 171:3a7713b1edbc 311 */
AnnaBridge 171:3a7713b1edbc 312 bool ADC_DoSelfCalibration(ADC_Type *base);
AnnaBridge 171:3a7713b1edbc 313
AnnaBridge 171:3a7713b1edbc 314 #if !(defined(FSL_FEATURE_ADC_HAS_NO_INSEL) && FSL_FEATURE_ADC_HAS_NO_INSEL)
AnnaBridge 171:3a7713b1edbc 315 /*!
AnnaBridge 171:3a7713b1edbc 316 * @brief Enable the internal temperature sensor measurement.
AnnaBridge 171:3a7713b1edbc 317 *
AnnaBridge 171:3a7713b1edbc 318 * When enabling the internal temperature sensor measurement, the channel 0 would be connected to internal sensor
AnnaBridge 171:3a7713b1edbc 319 * instead of external pin.
AnnaBridge 171:3a7713b1edbc 320 *
AnnaBridge 171:3a7713b1edbc 321 * @param base ADC peripheral base address.
AnnaBridge 171:3a7713b1edbc 322 * @param enable Switcher to enable the feature or not.
AnnaBridge 171:3a7713b1edbc 323 */
AnnaBridge 171:3a7713b1edbc 324 static inline void ADC_EnableTemperatureSensor(ADC_Type *base, bool enable)
AnnaBridge 171:3a7713b1edbc 325 {
AnnaBridge 171:3a7713b1edbc 326 if (enable)
AnnaBridge 171:3a7713b1edbc 327 {
AnnaBridge 171:3a7713b1edbc 328 base->INSEL = (base->INSEL & ~ADC_INSEL_SEL_MASK) | ADC_INSEL_SEL(0x3);
AnnaBridge 171:3a7713b1edbc 329 }
AnnaBridge 171:3a7713b1edbc 330 else
AnnaBridge 171:3a7713b1edbc 331 {
AnnaBridge 171:3a7713b1edbc 332 base->INSEL = (base->INSEL & ~ADC_INSEL_SEL_MASK) | ADC_INSEL_SEL(0);
AnnaBridge 171:3a7713b1edbc 333 }
AnnaBridge 171:3a7713b1edbc 334 }
AnnaBridge 171:3a7713b1edbc 335 #endif /* FSL_FEATURE_ADC_HAS_NO_INSEL. */
AnnaBridge 171:3a7713b1edbc 336 /* @} */
AnnaBridge 171:3a7713b1edbc 337
AnnaBridge 171:3a7713b1edbc 338 /*!
AnnaBridge 171:3a7713b1edbc 339 * @name Control conversion sequence A.
AnnaBridge 171:3a7713b1edbc 340 * @{
AnnaBridge 171:3a7713b1edbc 341 */
AnnaBridge 171:3a7713b1edbc 342
AnnaBridge 171:3a7713b1edbc 343 /*!
AnnaBridge 171:3a7713b1edbc 344 * @brief Enable the conversion sequence A.
AnnaBridge 171:3a7713b1edbc 345 *
AnnaBridge 171:3a7713b1edbc 346 * In order to avoid spuriously triggering the sequence, the trigger to conversion sequence should be ready before the
AnnaBridge 171:3a7713b1edbc 347 * sequence is ready. when the sequence is disabled, the trigger would be ignored. Also, it is suggested to disable the
AnnaBridge 171:3a7713b1edbc 348 * sequence during changing the sequence's setting.
AnnaBridge 171:3a7713b1edbc 349 *
AnnaBridge 171:3a7713b1edbc 350 * @param base ADC peripheral base address.
AnnaBridge 171:3a7713b1edbc 351 * @param enable Switcher to enable the feature or not.
AnnaBridge 171:3a7713b1edbc 352 */
AnnaBridge 171:3a7713b1edbc 353 static inline void ADC_EnableConvSeqA(ADC_Type *base, bool enable)
AnnaBridge 171:3a7713b1edbc 354 {
AnnaBridge 171:3a7713b1edbc 355 if (enable)
AnnaBridge 171:3a7713b1edbc 356 {
AnnaBridge 171:3a7713b1edbc 357 base->SEQ_CTRL[0] |= ADC_SEQ_CTRL_SEQ_ENA_MASK;
AnnaBridge 171:3a7713b1edbc 358 }
AnnaBridge 171:3a7713b1edbc 359 else
AnnaBridge 171:3a7713b1edbc 360 {
AnnaBridge 171:3a7713b1edbc 361 base->SEQ_CTRL[0] &= ~ADC_SEQ_CTRL_SEQ_ENA_MASK;
AnnaBridge 171:3a7713b1edbc 362 }
AnnaBridge 171:3a7713b1edbc 363 }
AnnaBridge 171:3a7713b1edbc 364
AnnaBridge 171:3a7713b1edbc 365 /*!
AnnaBridge 171:3a7713b1edbc 366 * @brief Configure the conversion sequence A.
AnnaBridge 171:3a7713b1edbc 367 *
AnnaBridge 171:3a7713b1edbc 368 * @param base ADC peripheral base address.
AnnaBridge 171:3a7713b1edbc 369 * @param config Pointer to configuration structure, see to #adc_conv_seq_config_t.
AnnaBridge 171:3a7713b1edbc 370 */
AnnaBridge 171:3a7713b1edbc 371 void ADC_SetConvSeqAConfig(ADC_Type *base, const adc_conv_seq_config_t *config);
AnnaBridge 171:3a7713b1edbc 372
AnnaBridge 171:3a7713b1edbc 373 /*!
AnnaBridge 171:3a7713b1edbc 374 * @brief Do trigger the sequence's conversion by software.
AnnaBridge 171:3a7713b1edbc 375 *
AnnaBridge 171:3a7713b1edbc 376 * @param base ADC peripheral base address.
AnnaBridge 171:3a7713b1edbc 377 */
AnnaBridge 171:3a7713b1edbc 378 static inline void ADC_DoSoftwareTriggerConvSeqA(ADC_Type *base)
AnnaBridge 171:3a7713b1edbc 379 {
AnnaBridge 171:3a7713b1edbc 380 base->SEQ_CTRL[0] |= ADC_SEQ_CTRL_START_MASK;
AnnaBridge 171:3a7713b1edbc 381 }
AnnaBridge 171:3a7713b1edbc 382
AnnaBridge 171:3a7713b1edbc 383 /*!
AnnaBridge 171:3a7713b1edbc 384 * @brief Enable the burst conversion of sequence A.
AnnaBridge 171:3a7713b1edbc 385 *
AnnaBridge 171:3a7713b1edbc 386 * Enable the burst mode would cause the conversion sequence to be cntinuously cycled through. Other triggers would be
AnnaBridge 171:3a7713b1edbc 387 * ignored while this mode is enabled. Repeated conversions could be halted by disabling this mode. And the sequence
AnnaBridge 171:3a7713b1edbc 388 * currently in process will be completed before cnversions are terminated.
AnnaBridge 171:3a7713b1edbc 389 * Note that a new sequence could begin just before the burst mode is disabled.
AnnaBridge 171:3a7713b1edbc 390 *
AnnaBridge 171:3a7713b1edbc 391 * @param base ADC peripheral base address.
AnnaBridge 171:3a7713b1edbc 392 * @param enable Switcher to enable this feature.
AnnaBridge 171:3a7713b1edbc 393 */
AnnaBridge 171:3a7713b1edbc 394 static inline void ADC_EnableConvSeqABurstMode(ADC_Type *base, bool enable)
AnnaBridge 171:3a7713b1edbc 395 {
AnnaBridge 171:3a7713b1edbc 396 if (enable)
AnnaBridge 171:3a7713b1edbc 397 {
AnnaBridge 171:3a7713b1edbc 398 base->SEQ_CTRL[0] |= ADC_SEQ_CTRL_BURST_MASK;
AnnaBridge 171:3a7713b1edbc 399 }
AnnaBridge 171:3a7713b1edbc 400 else
AnnaBridge 171:3a7713b1edbc 401 {
AnnaBridge 171:3a7713b1edbc 402 base->SEQ_CTRL[0] &= ~ADC_SEQ_CTRL_BURST_MASK;
AnnaBridge 171:3a7713b1edbc 403 }
AnnaBridge 171:3a7713b1edbc 404 }
AnnaBridge 171:3a7713b1edbc 405
AnnaBridge 171:3a7713b1edbc 406 /*!
AnnaBridge 171:3a7713b1edbc 407 * @brief Set the high priority for conversion sequence A.
AnnaBridge 171:3a7713b1edbc 408 *
AnnaBridge 171:3a7713b1edbc 409 * @param base ADC peripheral bass address.
AnnaBridge 171:3a7713b1edbc 410 */
AnnaBridge 171:3a7713b1edbc 411 static inline void ADC_SetConvSeqAHighPriority(ADC_Type *base)
AnnaBridge 171:3a7713b1edbc 412 {
AnnaBridge 171:3a7713b1edbc 413 base->SEQ_CTRL[0] |= ADC_SEQ_CTRL_LOWPRIO_MASK;
AnnaBridge 171:3a7713b1edbc 414 }
AnnaBridge 171:3a7713b1edbc 415
AnnaBridge 171:3a7713b1edbc 416 /* @} */
AnnaBridge 171:3a7713b1edbc 417
AnnaBridge 171:3a7713b1edbc 418 /*!
AnnaBridge 171:3a7713b1edbc 419 * @name Control conversion sequence B.
AnnaBridge 171:3a7713b1edbc 420 * @{
AnnaBridge 171:3a7713b1edbc 421 */
AnnaBridge 171:3a7713b1edbc 422
AnnaBridge 171:3a7713b1edbc 423 /*!
AnnaBridge 171:3a7713b1edbc 424 * @brief Enable the conversion sequence B.
AnnaBridge 171:3a7713b1edbc 425 *
AnnaBridge 171:3a7713b1edbc 426 * In order to avoid spuriously triggering the sequence, the trigger to conversion sequence should be ready before the
AnnaBridge 171:3a7713b1edbc 427 * sequence is ready. when the sequence is disabled, the trigger would be ignored. Also, it is suggested to disable the
AnnaBridge 171:3a7713b1edbc 428 * sequence during changing the sequence's setting.
AnnaBridge 171:3a7713b1edbc 429 *
AnnaBridge 171:3a7713b1edbc 430 * @param base ADC peripheral base address.
AnnaBridge 171:3a7713b1edbc 431 * @param enable Switcher to enable the feature or not.
AnnaBridge 171:3a7713b1edbc 432 */
AnnaBridge 171:3a7713b1edbc 433 static inline void ADC_EnableConvSeqB(ADC_Type *base, bool enable)
AnnaBridge 171:3a7713b1edbc 434 {
AnnaBridge 171:3a7713b1edbc 435 if (enable)
AnnaBridge 171:3a7713b1edbc 436 {
AnnaBridge 171:3a7713b1edbc 437 base->SEQ_CTRL[1] |= ADC_SEQ_CTRL_SEQ_ENA_MASK;
AnnaBridge 171:3a7713b1edbc 438 }
AnnaBridge 171:3a7713b1edbc 439 else
AnnaBridge 171:3a7713b1edbc 440 {
AnnaBridge 171:3a7713b1edbc 441 base->SEQ_CTRL[1] &= ~ADC_SEQ_CTRL_SEQ_ENA_MASK;
AnnaBridge 171:3a7713b1edbc 442 }
AnnaBridge 171:3a7713b1edbc 443 }
AnnaBridge 171:3a7713b1edbc 444
AnnaBridge 171:3a7713b1edbc 445 /*!
AnnaBridge 171:3a7713b1edbc 446 * @brief Configure the conversion sequence B.
AnnaBridge 171:3a7713b1edbc 447 *
AnnaBridge 171:3a7713b1edbc 448 * @param base ADC peripheral base address.
AnnaBridge 171:3a7713b1edbc 449 * @param config Pointer to configuration structure, see to #adc_conv_seq_config_t.
AnnaBridge 171:3a7713b1edbc 450 */
AnnaBridge 171:3a7713b1edbc 451 void ADC_SetConvSeqBConfig(ADC_Type *base, const adc_conv_seq_config_t *config);
AnnaBridge 171:3a7713b1edbc 452
AnnaBridge 171:3a7713b1edbc 453 /*!
AnnaBridge 171:3a7713b1edbc 454 * @brief Do trigger the sequence's conversion by software.
AnnaBridge 171:3a7713b1edbc 455 *
AnnaBridge 171:3a7713b1edbc 456 * @param base ADC peripheral base address.
AnnaBridge 171:3a7713b1edbc 457 */
AnnaBridge 171:3a7713b1edbc 458 static inline void ADC_DoSoftwareTriggerConvSeqB(ADC_Type *base)
AnnaBridge 171:3a7713b1edbc 459 {
AnnaBridge 171:3a7713b1edbc 460 base->SEQ_CTRL[1] |= ADC_SEQ_CTRL_START_MASK;
AnnaBridge 171:3a7713b1edbc 461 }
AnnaBridge 171:3a7713b1edbc 462
AnnaBridge 171:3a7713b1edbc 463 /*!
AnnaBridge 171:3a7713b1edbc 464 * @brief Enable the burst conversion of sequence B.
AnnaBridge 171:3a7713b1edbc 465 *
AnnaBridge 171:3a7713b1edbc 466 * Enable the burst mode would cause the conversion sequence to be continuously cycled through. Other triggers would be
AnnaBridge 171:3a7713b1edbc 467 * ignored while this mode is enabled. Repeated conversions could be halted by disabling this mode. And the sequence
AnnaBridge 171:3a7713b1edbc 468 * currently in process will be completed before cnversions are terminated.
AnnaBridge 171:3a7713b1edbc 469 * Note that a new sequence could begin just before the burst mode is disabled.
AnnaBridge 171:3a7713b1edbc 470 *
AnnaBridge 171:3a7713b1edbc 471 * @param base ADC peripheral base address.
AnnaBridge 171:3a7713b1edbc 472 * @param enable Switcher to enable this feature.
AnnaBridge 171:3a7713b1edbc 473 */
AnnaBridge 171:3a7713b1edbc 474 static inline void ADC_EnableConvSeqBBurstMode(ADC_Type *base, bool enable)
AnnaBridge 171:3a7713b1edbc 475 {
AnnaBridge 171:3a7713b1edbc 476 if (enable)
AnnaBridge 171:3a7713b1edbc 477 {
AnnaBridge 171:3a7713b1edbc 478 base->SEQ_CTRL[1] |= ADC_SEQ_CTRL_BURST_MASK;
AnnaBridge 171:3a7713b1edbc 479 }
AnnaBridge 171:3a7713b1edbc 480 else
AnnaBridge 171:3a7713b1edbc 481 {
AnnaBridge 171:3a7713b1edbc 482 base->SEQ_CTRL[1] &= ~ADC_SEQ_CTRL_BURST_MASK;
AnnaBridge 171:3a7713b1edbc 483 }
AnnaBridge 171:3a7713b1edbc 484 }
AnnaBridge 171:3a7713b1edbc 485
AnnaBridge 171:3a7713b1edbc 486 /*!
AnnaBridge 171:3a7713b1edbc 487 * @brief Set the high priority for conversion sequence B.
AnnaBridge 171:3a7713b1edbc 488 *
AnnaBridge 171:3a7713b1edbc 489 * @param base ADC peripheral bass address.
AnnaBridge 171:3a7713b1edbc 490 */
AnnaBridge 171:3a7713b1edbc 491 static inline void ADC_SetConvSeqBHighPriority(ADC_Type *base)
AnnaBridge 171:3a7713b1edbc 492 {
AnnaBridge 171:3a7713b1edbc 493 base->SEQ_CTRL[0] &= ~ADC_SEQ_CTRL_LOWPRIO_MASK;
AnnaBridge 171:3a7713b1edbc 494 }
AnnaBridge 171:3a7713b1edbc 495
AnnaBridge 171:3a7713b1edbc 496 /* @} */
AnnaBridge 171:3a7713b1edbc 497
AnnaBridge 171:3a7713b1edbc 498 /*!
AnnaBridge 171:3a7713b1edbc 499 * @name Data result.
AnnaBridge 171:3a7713b1edbc 500 * @{
AnnaBridge 171:3a7713b1edbc 501 */
AnnaBridge 171:3a7713b1edbc 502
AnnaBridge 171:3a7713b1edbc 503 /*!
AnnaBridge 171:3a7713b1edbc 504 * @brief Get the global ADC conversion infomation of sequence A.
AnnaBridge 171:3a7713b1edbc 505 *
AnnaBridge 171:3a7713b1edbc 506 * @param base ADC peripheral base address.
AnnaBridge 171:3a7713b1edbc 507 * @param info Pointer to information structure, see to #adc_result_info_t;
AnnaBridge 171:3a7713b1edbc 508 * @retval true The conversion result is ready.
AnnaBridge 171:3a7713b1edbc 509 * @retval false The conversion result is not ready yet.
AnnaBridge 171:3a7713b1edbc 510 */
AnnaBridge 171:3a7713b1edbc 511 bool ADC_GetConvSeqAGlobalConversionResult(ADC_Type *base, adc_result_info_t *info);
AnnaBridge 171:3a7713b1edbc 512
AnnaBridge 171:3a7713b1edbc 513 /*!
AnnaBridge 171:3a7713b1edbc 514 * @brief Get the global ADC conversion infomation of sequence B.
AnnaBridge 171:3a7713b1edbc 515 *
AnnaBridge 171:3a7713b1edbc 516 * @param base ADC peripheral base address.
AnnaBridge 171:3a7713b1edbc 517 * @param info Pointer to information structure, see to #adc_result_info_t;
AnnaBridge 171:3a7713b1edbc 518 * @retval true The conversion result is ready.
AnnaBridge 171:3a7713b1edbc 519 * @retval false The conversion result is not ready yet.
AnnaBridge 171:3a7713b1edbc 520 */
AnnaBridge 171:3a7713b1edbc 521 bool ADC_GetConvSeqBGlobalConversionResult(ADC_Type *base, adc_result_info_t *info);
AnnaBridge 171:3a7713b1edbc 522
AnnaBridge 171:3a7713b1edbc 523 /*!
AnnaBridge 171:3a7713b1edbc 524 * @brief Get the channel's ADC conversion completed under each conversion sequence.
AnnaBridge 171:3a7713b1edbc 525 *
AnnaBridge 171:3a7713b1edbc 526 * @param base ADC peripheral base address.
AnnaBridge 171:3a7713b1edbc 527 * @param channel The indicated channel number.
AnnaBridge 171:3a7713b1edbc 528 * @param info Pointer to information structure, see to #adc_result_info_t;
AnnaBridge 171:3a7713b1edbc 529 * @retval true The conversion result is ready.
AnnaBridge 171:3a7713b1edbc 530 * @retval false The conversion result is not ready yet.
AnnaBridge 171:3a7713b1edbc 531 */
AnnaBridge 171:3a7713b1edbc 532 bool ADC_GetChannelConversionResult(ADC_Type *base, uint32_t channel, adc_result_info_t *info);
AnnaBridge 171:3a7713b1edbc 533
AnnaBridge 171:3a7713b1edbc 534 /* @} */
AnnaBridge 171:3a7713b1edbc 535
AnnaBridge 171:3a7713b1edbc 536 /*!
AnnaBridge 171:3a7713b1edbc 537 * @name Threshold function.
AnnaBridge 171:3a7713b1edbc 538 * @{
AnnaBridge 171:3a7713b1edbc 539 */
AnnaBridge 171:3a7713b1edbc 540
AnnaBridge 171:3a7713b1edbc 541 /*!
AnnaBridge 171:3a7713b1edbc 542 * @brief Set the threshhold pair 0 with low and high value.
AnnaBridge 171:3a7713b1edbc 543 *
AnnaBridge 171:3a7713b1edbc 544 * @param base ADC peripheral base address.
AnnaBridge 171:3a7713b1edbc 545 * @param lowValue LOW threshold value.
AnnaBridge 171:3a7713b1edbc 546 * @param highValue HIGH threshold value.
AnnaBridge 171:3a7713b1edbc 547 */
AnnaBridge 171:3a7713b1edbc 548 static inline void ADC_SetThresholdPair0(ADC_Type *base, uint32_t lowValue, uint32_t highValue)
AnnaBridge 171:3a7713b1edbc 549 {
AnnaBridge 171:3a7713b1edbc 550 base->THR0_LOW = ADC_THR0_LOW_THRLOW(lowValue);
AnnaBridge 171:3a7713b1edbc 551 base->THR0_HIGH = ADC_THR0_HIGH_THRHIGH(highValue);
AnnaBridge 171:3a7713b1edbc 552 }
AnnaBridge 171:3a7713b1edbc 553
AnnaBridge 171:3a7713b1edbc 554 /*!
AnnaBridge 171:3a7713b1edbc 555 * @brief Set the threshhold pair 1 with low and high value.
AnnaBridge 171:3a7713b1edbc 556 *
AnnaBridge 171:3a7713b1edbc 557 * @param base ADC peripheral base address.
AnnaBridge 171:3a7713b1edbc 558 * @param lowValue LOW threshold value. The available value is with 12-bit.
AnnaBridge 171:3a7713b1edbc 559 * @param highValue HIGH threshold value. The available value is with 12-bit.
AnnaBridge 171:3a7713b1edbc 560 */
AnnaBridge 171:3a7713b1edbc 561 static inline void ADC_SetThresholdPair1(ADC_Type *base, uint32_t lowValue, uint32_t highValue)
AnnaBridge 171:3a7713b1edbc 562 {
AnnaBridge 171:3a7713b1edbc 563 base->THR1_LOW = ADC_THR1_LOW_THRLOW(lowValue);
AnnaBridge 171:3a7713b1edbc 564 base->THR1_HIGH = ADC_THR1_HIGH_THRHIGH(highValue);
AnnaBridge 171:3a7713b1edbc 565 }
AnnaBridge 171:3a7713b1edbc 566
AnnaBridge 171:3a7713b1edbc 567 /*!
AnnaBridge 171:3a7713b1edbc 568 * @brief Set given channels to apply the threshold pare 0.
AnnaBridge 171:3a7713b1edbc 569 *
AnnaBridge 171:3a7713b1edbc 570 * @param base ADC peripheral base address.
AnnaBridge 171:3a7713b1edbc 571 * @param channelMask Indicated channels' mask.
AnnaBridge 171:3a7713b1edbc 572 */
AnnaBridge 171:3a7713b1edbc 573 static inline void ADC_SetChannelWithThresholdPair0(ADC_Type *base, uint32_t channelMask)
AnnaBridge 171:3a7713b1edbc 574 {
AnnaBridge 171:3a7713b1edbc 575 base->CHAN_THRSEL &= ~(channelMask);
AnnaBridge 171:3a7713b1edbc 576 }
AnnaBridge 171:3a7713b1edbc 577
AnnaBridge 171:3a7713b1edbc 578 /*!
AnnaBridge 171:3a7713b1edbc 579 * @brief Set given channels to apply the threshold pare 1.
AnnaBridge 171:3a7713b1edbc 580 *
AnnaBridge 171:3a7713b1edbc 581 * @param base ADC peripheral base address.
AnnaBridge 171:3a7713b1edbc 582 * @param channelMask Indicated channels' mask.
AnnaBridge 171:3a7713b1edbc 583 */
AnnaBridge 171:3a7713b1edbc 584 static inline void ADC_SetChannelWithThresholdPair1(ADC_Type *base, uint32_t channelMask)
AnnaBridge 171:3a7713b1edbc 585 {
AnnaBridge 171:3a7713b1edbc 586 base->CHAN_THRSEL |= channelMask;
AnnaBridge 171:3a7713b1edbc 587 }
AnnaBridge 171:3a7713b1edbc 588
AnnaBridge 171:3a7713b1edbc 589 /* @} */
AnnaBridge 171:3a7713b1edbc 590
AnnaBridge 171:3a7713b1edbc 591 /*!
AnnaBridge 171:3a7713b1edbc 592 * @name Interrupts.
AnnaBridge 171:3a7713b1edbc 593 * @{
AnnaBridge 171:3a7713b1edbc 594 */
AnnaBridge 171:3a7713b1edbc 595
AnnaBridge 171:3a7713b1edbc 596 /*!
AnnaBridge 171:3a7713b1edbc 597 * @brief Enable interrupts for conversion sequences.
AnnaBridge 171:3a7713b1edbc 598 *
AnnaBridge 171:3a7713b1edbc 599 * @param base ADC peripheral base address.
AnnaBridge 171:3a7713b1edbc 600 * @param mask Mask of interrupt mask value for global block except each channal, see to #_adc_interrupt_enable.
AnnaBridge 171:3a7713b1edbc 601 */
AnnaBridge 171:3a7713b1edbc 602 static inline void ADC_EnableInterrupts(ADC_Type *base, uint32_t mask)
AnnaBridge 171:3a7713b1edbc 603 {
AnnaBridge 171:3a7713b1edbc 604 base->INTEN |= (0x7 & mask);
AnnaBridge 171:3a7713b1edbc 605 }
AnnaBridge 171:3a7713b1edbc 606
AnnaBridge 171:3a7713b1edbc 607 /*!
AnnaBridge 171:3a7713b1edbc 608 * @brief Disable interrupts for conversion sequence.
AnnaBridge 171:3a7713b1edbc 609 *
AnnaBridge 171:3a7713b1edbc 610 * @param base ADC peripheral base address.
AnnaBridge 171:3a7713b1edbc 611 * @param mask Mask of interrupt mask value for global block except each channel, see to #_adc_interrupt_enable.
AnnaBridge 171:3a7713b1edbc 612 */
AnnaBridge 171:3a7713b1edbc 613 static inline void ADC_DisableInterrupts(ADC_Type *base, uint32_t mask)
AnnaBridge 171:3a7713b1edbc 614 {
AnnaBridge 171:3a7713b1edbc 615 base->INTEN &= ~(0x7 & mask);
AnnaBridge 171:3a7713b1edbc 616 }
AnnaBridge 171:3a7713b1edbc 617
AnnaBridge 171:3a7713b1edbc 618 /*!
AnnaBridge 171:3a7713b1edbc 619 * @brief Enable the interrupt of threshold compare event for each channel.
AnnaBridge 171:3a7713b1edbc 620 * @deprecated Do not use this function. It has been superceded by @ADC_EnableThresholdCompareInterrupt
AnnaBridge 171:3a7713b1edbc 621 */
AnnaBridge 171:3a7713b1edbc 622 static inline void ADC_EnableShresholdCompareInterrupt(ADC_Type *base,
AnnaBridge 171:3a7713b1edbc 623 uint32_t channel,
AnnaBridge 171:3a7713b1edbc 624 adc_threshold_interrupt_mode_t mode)
AnnaBridge 171:3a7713b1edbc 625 {
AnnaBridge 171:3a7713b1edbc 626 base->INTEN = (base->INTEN & ~(0x3U << ((channel << 1U) + 3U))) | ((uint32_t)(mode) << ((channel << 1U) + 3U));
AnnaBridge 171:3a7713b1edbc 627 }
AnnaBridge 171:3a7713b1edbc 628
AnnaBridge 171:3a7713b1edbc 629 /*!
AnnaBridge 171:3a7713b1edbc 630 * @brief Enable the interrupt of threshold compare event for each channel.
AnnaBridge 171:3a7713b1edbc 631 *
AnnaBridge 171:3a7713b1edbc 632 * @param base ADC peripheral base address.
AnnaBridge 171:3a7713b1edbc 633 * @param channel Channel number.
AnnaBridge 171:3a7713b1edbc 634 * @param mode Interrupt mode for threshold compare event, see to #adc_threshold_interrupt_mode_t.
AnnaBridge 171:3a7713b1edbc 635 */
AnnaBridge 171:3a7713b1edbc 636 static inline void ADC_EnableThresholdCompareInterrupt(ADC_Type *base,
AnnaBridge 171:3a7713b1edbc 637 uint32_t channel,
AnnaBridge 171:3a7713b1edbc 638 adc_threshold_interrupt_mode_t mode)
AnnaBridge 171:3a7713b1edbc 639 {
AnnaBridge 171:3a7713b1edbc 640 base->INTEN = (base->INTEN & ~(0x3U << ((channel << 1U) + 3U))) | ((uint32_t)(mode) << ((channel << 1U) + 3U));
AnnaBridge 171:3a7713b1edbc 641 }
AnnaBridge 171:3a7713b1edbc 642
AnnaBridge 171:3a7713b1edbc 643 /* @} */
AnnaBridge 171:3a7713b1edbc 644
AnnaBridge 171:3a7713b1edbc 645 /*!
AnnaBridge 171:3a7713b1edbc 646 * @name Status.
AnnaBridge 171:3a7713b1edbc 647 * @{
AnnaBridge 171:3a7713b1edbc 648 */
AnnaBridge 171:3a7713b1edbc 649
AnnaBridge 171:3a7713b1edbc 650 /*!
AnnaBridge 171:3a7713b1edbc 651 * @brief Get status flags of ADC module.
AnnaBridge 171:3a7713b1edbc 652 *
AnnaBridge 171:3a7713b1edbc 653 * @param base ADC peripheral base address.
AnnaBridge 171:3a7713b1edbc 654 * @return Mask of status flags of module, see to #_adc_status_flags.
AnnaBridge 171:3a7713b1edbc 655 */
AnnaBridge 171:3a7713b1edbc 656 static inline uint32_t ADC_GetStatusFlags(ADC_Type *base)
AnnaBridge 171:3a7713b1edbc 657 {
AnnaBridge 171:3a7713b1edbc 658 return base->FLAGS;
AnnaBridge 171:3a7713b1edbc 659 }
AnnaBridge 171:3a7713b1edbc 660
AnnaBridge 171:3a7713b1edbc 661 /*!
AnnaBridge 171:3a7713b1edbc 662 * @brief Clear status flags of ADC module.
AnnaBridge 171:3a7713b1edbc 663 *
AnnaBridge 171:3a7713b1edbc 664 * @param base ADC peripheral base address.
AnnaBridge 171:3a7713b1edbc 665 * @param mask Mask of status flags of module, see to #_adc_status_flags.
AnnaBridge 171:3a7713b1edbc 666 */
AnnaBridge 171:3a7713b1edbc 667 static inline void ADC_ClearStatusFlags(ADC_Type *base, uint32_t mask)
AnnaBridge 171:3a7713b1edbc 668 {
AnnaBridge 171:3a7713b1edbc 669 base->FLAGS = mask; /* Write 1 to clear. */
AnnaBridge 171:3a7713b1edbc 670 }
AnnaBridge 171:3a7713b1edbc 671
AnnaBridge 171:3a7713b1edbc 672 /* @} */
AnnaBridge 171:3a7713b1edbc 673
AnnaBridge 171:3a7713b1edbc 674 #if defined(__cplusplus)
AnnaBridge 171:3a7713b1edbc 675 }
AnnaBridge 171:3a7713b1edbc 676 #endif
AnnaBridge 171:3a7713b1edbc 677
AnnaBridge 171:3a7713b1edbc 678 /* @} */
AnnaBridge 171:3a7713b1edbc 679
AnnaBridge 171:3a7713b1edbc 680 #endif /* __FSL_ADC_H__ */