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_LPC546XX/TOOLCHAIN_ARM_STD/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?
User | Revision | Line number | New 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__ */ |