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_MIMXRT1050_EVK/TOOLCHAIN_IAR/fsl_tsc.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 | 161:aa5281ff4a02 | 1 | /* |
AnnaBridge | 170:e95d10626187 | 2 | * The Clear BSD License |
AnnaBridge | 161:aa5281ff4a02 | 3 | * Copyright (c) 2016, Freescale Semiconductor, Inc. |
AnnaBridge | 161:aa5281ff4a02 | 4 | * Copyright 2016-2017 NXP |
AnnaBridge | 170:e95d10626187 | 5 | * All rights reserved. |
AnnaBridge | 170:e95d10626187 | 6 | * |
AnnaBridge | 161:aa5281ff4a02 | 7 | * Redistribution and use in source and binary forms, with or without modification, |
AnnaBridge | 170:e95d10626187 | 8 | * are permitted (subject to the limitations in the disclaimer below) provided |
AnnaBridge | 170:e95d10626187 | 9 | * that the following conditions are met: |
AnnaBridge | 161:aa5281ff4a02 | 10 | * |
AnnaBridge | 161:aa5281ff4a02 | 11 | * o Redistributions of source code must retain the above copyright notice, this list |
AnnaBridge | 161:aa5281ff4a02 | 12 | * of conditions and the following disclaimer. |
AnnaBridge | 161:aa5281ff4a02 | 13 | * |
AnnaBridge | 161:aa5281ff4a02 | 14 | * o Redistributions in binary form must reproduce the above copyright notice, this |
AnnaBridge | 161:aa5281ff4a02 | 15 | * list of conditions and the following disclaimer in the documentation and/or |
AnnaBridge | 161:aa5281ff4a02 | 16 | * other materials provided with the distribution. |
AnnaBridge | 161:aa5281ff4a02 | 17 | * |
AnnaBridge | 161:aa5281ff4a02 | 18 | * o Neither the name of the copyright holder nor the names of its |
AnnaBridge | 161:aa5281ff4a02 | 19 | * contributors may be used to endorse or promote products derived from this |
AnnaBridge | 161:aa5281ff4a02 | 20 | * software without specific prior written permission. |
AnnaBridge | 161:aa5281ff4a02 | 21 | * |
AnnaBridge | 170:e95d10626187 | 22 | * NO EXPRESS OR IMPLIED LICENSES TO ANY PARTY'S PATENT RIGHTS ARE GRANTED BY THIS LICENSE. |
AnnaBridge | 161:aa5281ff4a02 | 23 | * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND |
AnnaBridge | 161:aa5281ff4a02 | 24 | * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED |
AnnaBridge | 161:aa5281ff4a02 | 25 | * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE |
AnnaBridge | 161:aa5281ff4a02 | 26 | * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR |
AnnaBridge | 161:aa5281ff4a02 | 27 | * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES |
AnnaBridge | 161:aa5281ff4a02 | 28 | * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; |
AnnaBridge | 161:aa5281ff4a02 | 29 | * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON |
AnnaBridge | 161:aa5281ff4a02 | 30 | * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
AnnaBridge | 161:aa5281ff4a02 | 31 | * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS |
AnnaBridge | 161:aa5281ff4a02 | 32 | * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
AnnaBridge | 161:aa5281ff4a02 | 33 | */ |
AnnaBridge | 161:aa5281ff4a02 | 34 | |
AnnaBridge | 161:aa5281ff4a02 | 35 | #ifndef _FSL_TSC_H_ |
AnnaBridge | 161:aa5281ff4a02 | 36 | #define _FSL_TSC_H_ |
AnnaBridge | 161:aa5281ff4a02 | 37 | |
AnnaBridge | 161:aa5281ff4a02 | 38 | #include "fsl_common.h" |
AnnaBridge | 161:aa5281ff4a02 | 39 | |
AnnaBridge | 161:aa5281ff4a02 | 40 | /*! |
AnnaBridge | 161:aa5281ff4a02 | 41 | * @addtogroup tsc |
AnnaBridge | 161:aa5281ff4a02 | 42 | * @{ |
AnnaBridge | 161:aa5281ff4a02 | 43 | */ |
AnnaBridge | 161:aa5281ff4a02 | 44 | |
AnnaBridge | 161:aa5281ff4a02 | 45 | /******************************************************************************* |
AnnaBridge | 161:aa5281ff4a02 | 46 | * Definitions |
AnnaBridge | 161:aa5281ff4a02 | 47 | ******************************************************************************/ |
AnnaBridge | 161:aa5281ff4a02 | 48 | /*! @brief TSC driver version */ |
AnnaBridge | 161:aa5281ff4a02 | 49 | #define FSL_TSC_DRIVER_VERSION (MAKE_VERSION(2, 0, 0)) /*!< Version 2.0.0. */ |
AnnaBridge | 161:aa5281ff4a02 | 50 | |
AnnaBridge | 161:aa5281ff4a02 | 51 | /*! |
AnnaBridge | 161:aa5281ff4a02 | 52 | * @ Controller detection mode. |
AnnaBridge | 161:aa5281ff4a02 | 53 | */ |
AnnaBridge | 161:aa5281ff4a02 | 54 | typedef enum _tsc_detection_mode |
AnnaBridge | 161:aa5281ff4a02 | 55 | { |
AnnaBridge | 161:aa5281ff4a02 | 56 | kTSC_Detection4WireMode = 0U, /*!< 4-Wire Detection Mode. */ |
AnnaBridge | 161:aa5281ff4a02 | 57 | kTSC_Detection5WireMode = 1U, /*!< 5-Wire Detection Mode. */ |
AnnaBridge | 161:aa5281ff4a02 | 58 | } tsc_detection_mode_t; |
AnnaBridge | 161:aa5281ff4a02 | 59 | |
AnnaBridge | 161:aa5281ff4a02 | 60 | /*! |
AnnaBridge | 161:aa5281ff4a02 | 61 | * @ Coordinate value mask. |
AnnaBridge | 161:aa5281ff4a02 | 62 | */ |
AnnaBridge | 161:aa5281ff4a02 | 63 | typedef enum _tsc_corrdinate_value_selection |
AnnaBridge | 161:aa5281ff4a02 | 64 | { |
AnnaBridge | 161:aa5281ff4a02 | 65 | kTSC_XCoordinateValueSelection = 0U, /*!< X coordinate value is selected. */ |
AnnaBridge | 161:aa5281ff4a02 | 66 | kTSC_YCoordinateValueSelection = 1U, /*!< Y coordinate value is selected. */ |
AnnaBridge | 161:aa5281ff4a02 | 67 | } tsc_corrdinate_value_selection_t; |
AnnaBridge | 161:aa5281ff4a02 | 68 | |
AnnaBridge | 161:aa5281ff4a02 | 69 | /*! |
AnnaBridge | 161:aa5281ff4a02 | 70 | * @ Interrupt signal enable/disable mask. |
AnnaBridge | 161:aa5281ff4a02 | 71 | */ |
AnnaBridge | 161:aa5281ff4a02 | 72 | enum _tsc_interrupt_signal_mask |
AnnaBridge | 161:aa5281ff4a02 | 73 | { |
AnnaBridge | 161:aa5281ff4a02 | 74 | kTSC_IdleSoftwareSignalEnable = TSC_INT_SIG_EN_IDLE_SW_SIG_EN_MASK, /*!< Enable the interrupt signal when the |
AnnaBridge | 161:aa5281ff4a02 | 75 | controller has return to idle status. |
AnnaBridge | 161:aa5281ff4a02 | 76 | The signal is only valid after using |
AnnaBridge | 161:aa5281ff4a02 | 77 | TSC_ReturnToIdleStatus API. */ |
AnnaBridge | 161:aa5281ff4a02 | 78 | kTSC_ValidSignalEnable = |
AnnaBridge | 161:aa5281ff4a02 | 79 | TSC_INT_SIG_EN_VALID_SIG_EN_MASK, /*!< Enable the interrupt signal when controller receives a detect signal |
AnnaBridge | 161:aa5281ff4a02 | 80 | after measurement. */ |
AnnaBridge | 161:aa5281ff4a02 | 81 | kTSC_DetectSignalEnable = |
AnnaBridge | 161:aa5281ff4a02 | 82 | TSC_INT_SIG_EN_DETECT_SIG_EN_MASK, /*!< Enable the interrupt signal when controller receives a detect signal. */ |
AnnaBridge | 161:aa5281ff4a02 | 83 | kTSC_MeasureSignalEnable = TSC_INT_SIG_EN_MEASURE_SIG_EN_MASK, /*!< Enable the interrupt signal after the touch |
AnnaBridge | 161:aa5281ff4a02 | 84 | detection which follows measurement. */ |
AnnaBridge | 161:aa5281ff4a02 | 85 | }; |
AnnaBridge | 161:aa5281ff4a02 | 86 | |
AnnaBridge | 161:aa5281ff4a02 | 87 | /*! |
AnnaBridge | 161:aa5281ff4a02 | 88 | * @ Interrupt enable/disable mask. |
AnnaBridge | 161:aa5281ff4a02 | 89 | */ |
AnnaBridge | 161:aa5281ff4a02 | 90 | enum _tsc_interrupt_mask |
AnnaBridge | 161:aa5281ff4a02 | 91 | { |
AnnaBridge | 161:aa5281ff4a02 | 92 | kTSC_IdleSoftwareInterruptEnable = |
AnnaBridge | 161:aa5281ff4a02 | 93 | TSC_INT_EN_IDLE_SW_INT_EN_MASK, /*!< Enable the interrupt when the controller has return to idle status. |
AnnaBridge | 161:aa5281ff4a02 | 94 | The interrupt is only valid after using TSC_ReturnToIdleStatus API. */ |
AnnaBridge | 161:aa5281ff4a02 | 95 | kTSC_DetectInterruptEnable = |
AnnaBridge | 161:aa5281ff4a02 | 96 | TSC_INT_EN_DETECT_INT_EN_MASK, /*!< Enable the interrupt when controller receive a detect signal. */ |
AnnaBridge | 161:aa5281ff4a02 | 97 | kTSC_MeasureInterruptEnable = TSC_INT_EN_MEASURE_INT_EN_MASK, /*!< Enable the interrupt after the touch detection |
AnnaBridge | 161:aa5281ff4a02 | 98 | which follows measurement. */ |
AnnaBridge | 161:aa5281ff4a02 | 99 | }; |
AnnaBridge | 161:aa5281ff4a02 | 100 | |
AnnaBridge | 161:aa5281ff4a02 | 101 | /*! |
AnnaBridge | 161:aa5281ff4a02 | 102 | * @ Interrupt Status flag mask. |
AnnaBridge | 161:aa5281ff4a02 | 103 | */ |
AnnaBridge | 161:aa5281ff4a02 | 104 | enum _tsc_interrupt_status_flag_mask |
AnnaBridge | 161:aa5281ff4a02 | 105 | { |
AnnaBridge | 161:aa5281ff4a02 | 106 | kTSC_IdleSoftwareFlag = |
AnnaBridge | 161:aa5281ff4a02 | 107 | TSC_INT_STATUS_IDLE_SW_MASK, /*!< This flag is set if the controller has return to idle status. |
AnnaBridge | 161:aa5281ff4a02 | 108 | The flag is only valid after using TSC_ReturnToIdleStatus API. */ |
AnnaBridge | 161:aa5281ff4a02 | 109 | kTSC_ValidSignalFlag = |
AnnaBridge | 161:aa5281ff4a02 | 110 | TSC_INT_STATUS_VALID_MASK, /*!< This flag is set if controller receives a detect signal after measurement. */ |
AnnaBridge | 161:aa5281ff4a02 | 111 | kTSC_DetectSignalFlag = TSC_INT_STATUS_DETECT_MASK, /*!< This flag is set if controller receives a detect signal. */ |
AnnaBridge | 161:aa5281ff4a02 | 112 | kTSC_MeasureSignalFlag = |
AnnaBridge | 161:aa5281ff4a02 | 113 | TSC_INT_STATUS_MEASURE_MASK, /*!< This flag is set after the touch detection which follows measurement. |
AnnaBridge | 161:aa5281ff4a02 | 114 | Note: Valid signal falg will be cleared along with measure signal flag. */ |
AnnaBridge | 161:aa5281ff4a02 | 115 | }; |
AnnaBridge | 161:aa5281ff4a02 | 116 | |
AnnaBridge | 161:aa5281ff4a02 | 117 | /*! |
AnnaBridge | 161:aa5281ff4a02 | 118 | * @ ADC status flag mask. |
AnnaBridge | 161:aa5281ff4a02 | 119 | */ |
AnnaBridge | 161:aa5281ff4a02 | 120 | enum _tsc_adc_status_flag_mask |
AnnaBridge | 161:aa5281ff4a02 | 121 | { |
AnnaBridge | 161:aa5281ff4a02 | 122 | kTSC_ADCCOCOSignalFlag = |
AnnaBridge | 161:aa5281ff4a02 | 123 | TSC_DEBUG_MODE_ADC_COCO_MASK, /*!< This signal is generated by ADC when a conversion is completed. */ |
AnnaBridge | 161:aa5281ff4a02 | 124 | kTSC_ADCConversionValueFlag = |
AnnaBridge | 161:aa5281ff4a02 | 125 | TSC_DEBUG_MODE_ADC_CONV_VALUE_MASK, /*!< This signal is generated by ADC and indicates the result of an ADC |
AnnaBridge | 161:aa5281ff4a02 | 126 | conversion. */ |
AnnaBridge | 161:aa5281ff4a02 | 127 | }; |
AnnaBridge | 161:aa5281ff4a02 | 128 | |
AnnaBridge | 161:aa5281ff4a02 | 129 | /*! |
AnnaBridge | 161:aa5281ff4a02 | 130 | * @ TSC status flag mask. |
AnnaBridge | 161:aa5281ff4a02 | 131 | */ |
AnnaBridge | 161:aa5281ff4a02 | 132 | enum _tsc_status_flag_mask |
AnnaBridge | 161:aa5281ff4a02 | 133 | { |
AnnaBridge | 161:aa5281ff4a02 | 134 | kTSC_IntermediateStateFlag = TSC_DEBUG_MODE2_INTERMEDIATE_MASK, /*!< This flag is set if TSC is in intermediate |
AnnaBridge | 161:aa5281ff4a02 | 135 | state, between two state machine states. */ |
AnnaBridge | 161:aa5281ff4a02 | 136 | kTSC_DetectFiveWireFlag = TSC_DEBUG_MODE2_DETECT_FIVE_WIRE_MASK, /*!< This flag is set if TSC receives a 5-wire |
AnnaBridge | 161:aa5281ff4a02 | 137 | detect signal. It is only valid when the TSC in |
AnnaBridge | 161:aa5281ff4a02 | 138 | detect state and DETECT_ENABLE_FIVE_WIRE bit is |
AnnaBridge | 161:aa5281ff4a02 | 139 | set. */ |
AnnaBridge | 161:aa5281ff4a02 | 140 | kTSC_DetectFourWireFlag = TSC_DEBUG_MODE2_DETECT_FOUR_WIRE_MASK, /*!< This flag is set if TSC receives a 4-wire |
AnnaBridge | 161:aa5281ff4a02 | 141 | detect signal. It is only valid when the TSC in |
AnnaBridge | 161:aa5281ff4a02 | 142 | detect state and DETECT_ENABLE_FOUR_WIRE bit is |
AnnaBridge | 161:aa5281ff4a02 | 143 | set. */ |
AnnaBridge | 161:aa5281ff4a02 | 144 | kTSC_GlitchThresholdFlag = TSC_DEBUG_MODE2_DE_GLITCH_MASK, /*!< This field indicates glitch threshold.The threshold |
AnnaBridge | 161:aa5281ff4a02 | 145 | is defined by number of clock cycles. See |
AnnaBridge | 161:aa5281ff4a02 | 146 | "tsc_glitch_threshold_t". |
AnnaBridge | 161:aa5281ff4a02 | 147 | If value = 00, Normal function: 0x1fff ipg clock |
AnnaBridge | 161:aa5281ff4a02 | 148 | cycles, Low power mode: 0x9 low power clock cycles. |
AnnaBridge | 161:aa5281ff4a02 | 149 | If value = 01, Normal function: 0xfff ipg clock |
AnnaBridge | 161:aa5281ff4a02 | 150 | cycles, Low power mode: :0x7 low power clock cycles. |
AnnaBridge | 161:aa5281ff4a02 | 151 | If value = 10, Normal function: 0x7ff ipg clock |
AnnaBridge | 161:aa5281ff4a02 | 152 | cycles, Low power mode:0x5 low power clock cycles. |
AnnaBridge | 161:aa5281ff4a02 | 153 | If value = 11, Normal function: 0x3 ipg clock |
AnnaBridge | 161:aa5281ff4a02 | 154 | cycles, Low power mode:0x3 low power clock cycles. */ |
AnnaBridge | 161:aa5281ff4a02 | 155 | kTSC_StateMachineFlag = |
AnnaBridge | 161:aa5281ff4a02 | 156 | TSC_DEBUG_MODE2_STATE_MACHINE_MASK, /*!< This field indicates the state of TSC. See "tsc_state_machine_t"; |
AnnaBridge | 161:aa5281ff4a02 | 157 | if value = 000, Controller is in idle state. |
AnnaBridge | 161:aa5281ff4a02 | 158 | if value = 001, Controller is in 1st-Pre-charge state. |
AnnaBridge | 161:aa5281ff4a02 | 159 | if value = 010, Controller is in 1st-detect state. |
AnnaBridge | 161:aa5281ff4a02 | 160 | if value = 011, Controller is in x-measure state. |
AnnaBridge | 161:aa5281ff4a02 | 161 | if value = 100, Controller is in y-measure state. |
AnnaBridge | 161:aa5281ff4a02 | 162 | if value = 101, Controller is in 2nd-Pre-charge state. |
AnnaBridge | 161:aa5281ff4a02 | 163 | if value = 110, Controller is in 2nd-detect state. */ |
AnnaBridge | 161:aa5281ff4a02 | 164 | }; |
AnnaBridge | 161:aa5281ff4a02 | 165 | |
AnnaBridge | 161:aa5281ff4a02 | 166 | /*! |
AnnaBridge | 161:aa5281ff4a02 | 167 | * @brief TSC state machine. These seven states are TSC complete workflow. |
AnnaBridge | 161:aa5281ff4a02 | 168 | */ |
AnnaBridge | 161:aa5281ff4a02 | 169 | typedef enum _tsc_state_machine |
AnnaBridge | 161:aa5281ff4a02 | 170 | { |
AnnaBridge | 161:aa5281ff4a02 | 171 | kTSC_IdleState = 0U << TSC_DEBUG_MODE2_STATE_MACHINE_SHIFT, /*!< Controller is in idle state. */ |
AnnaBridge | 161:aa5281ff4a02 | 172 | kTSC_1stPreChargeState = 1U << TSC_DEBUG_MODE2_STATE_MACHINE_SHIFT, /*!< Controller is in 1st-Pre-charge state. */ |
AnnaBridge | 161:aa5281ff4a02 | 173 | kTSC_1stDetectState = 2U << TSC_DEBUG_MODE2_STATE_MACHINE_SHIFT, /*!< Controller is in 1st-detect state. */ |
AnnaBridge | 161:aa5281ff4a02 | 174 | kTSC_XMeasureState = 3U << TSC_DEBUG_MODE2_STATE_MACHINE_SHIFT, /*!< Controller is in x-measure state. */ |
AnnaBridge | 161:aa5281ff4a02 | 175 | kTSC_YMeasureState = 4U << TSC_DEBUG_MODE2_STATE_MACHINE_SHIFT, /*!< Controller is in y-measure state. */ |
AnnaBridge | 161:aa5281ff4a02 | 176 | kTSC_2ndPreChargeState = 5U << TSC_DEBUG_MODE2_STATE_MACHINE_SHIFT, /*!< Controller is in 2nd-Pre-charge state. */ |
AnnaBridge | 161:aa5281ff4a02 | 177 | kTSC_2ndDetectState = 6U << TSC_DEBUG_MODE2_STATE_MACHINE_SHIFT, /*!< Controller is in 2nd-detect state. */ |
AnnaBridge | 161:aa5281ff4a02 | 178 | } tsc_state_machine_t; |
AnnaBridge | 161:aa5281ff4a02 | 179 | |
AnnaBridge | 161:aa5281ff4a02 | 180 | /*! |
AnnaBridge | 161:aa5281ff4a02 | 181 | * @brief TSC glitch threshold. |
AnnaBridge | 161:aa5281ff4a02 | 182 | */ |
AnnaBridge | 161:aa5281ff4a02 | 183 | typedef enum _tsc_glitch_threshold |
AnnaBridge | 161:aa5281ff4a02 | 184 | { |
AnnaBridge | 161:aa5281ff4a02 | 185 | kTSC_glitchThresholdALT0 = |
AnnaBridge | 161:aa5281ff4a02 | 186 | 0U << TSC_DEBUG_MODE2_DE_GLITCH_SHIFT, /*!< Normal function: 0x1fff ipg clock cycles, Low power mode: 0x9 low |
AnnaBridge | 161:aa5281ff4a02 | 187 | power clock cycles. */ |
AnnaBridge | 161:aa5281ff4a02 | 188 | kTSC_glitchThresholdALT1 = |
AnnaBridge | 161:aa5281ff4a02 | 189 | 1U << TSC_DEBUG_MODE2_DE_GLITCH_SHIFT, /*!< Normal function: 0xfff ipg clock cycles, Low power mode: :0x7 low |
AnnaBridge | 161:aa5281ff4a02 | 190 | power clock cycles. */ |
AnnaBridge | 161:aa5281ff4a02 | 191 | kTSC_glitchThresholdALT2 = |
AnnaBridge | 161:aa5281ff4a02 | 192 | 2U << TSC_DEBUG_MODE2_DE_GLITCH_SHIFT, /*!< Normal function: 0x7ff ipg clock cycles, Low power mode: :0x5 low |
AnnaBridge | 161:aa5281ff4a02 | 193 | power clock cycles. */ |
AnnaBridge | 161:aa5281ff4a02 | 194 | kTSC_glitchThresholdALT3 = |
AnnaBridge | 161:aa5281ff4a02 | 195 | 3U << TSC_DEBUG_MODE2_DE_GLITCH_SHIFT, /*!< Normal function: 0x3 ipg clock cycles, Low |
AnnaBridge | 161:aa5281ff4a02 | 196 | power mode: :0x3 low power clock cycles. */ |
AnnaBridge | 161:aa5281ff4a02 | 197 | } tsc_glitch_threshold_t; |
AnnaBridge | 161:aa5281ff4a02 | 198 | |
AnnaBridge | 161:aa5281ff4a02 | 199 | /*! |
AnnaBridge | 161:aa5281ff4a02 | 200 | * @ Hardware trigger select signal, select which ADC channel to start conversion. |
AnnaBridge | 161:aa5281ff4a02 | 201 | */ |
AnnaBridge | 161:aa5281ff4a02 | 202 | typedef enum _tsc_trigger_signal |
AnnaBridge | 161:aa5281ff4a02 | 203 | { |
AnnaBridge | 161:aa5281ff4a02 | 204 | kTSC_TriggerToChannel0 = 1U << 0U, /*!< Trigger to ADC channel0. ADC_HC0 register will be used to conversion. */ |
AnnaBridge | 161:aa5281ff4a02 | 205 | kTSC_TriggerToChannel1 = 1U << 1U, /*!< Trigger to ADC channel1. ADC_HC1 register will be used to conversion. */ |
AnnaBridge | 161:aa5281ff4a02 | 206 | kTSC_TriggerToChannel2 = 1U << 2U, /*!< Trigger to ADC channel2. ADC_HC2 register will be used to conversion. */ |
AnnaBridge | 161:aa5281ff4a02 | 207 | kTSC_TriggerToChannel3 = 1U << 3U, /*!< Trigger to ADC channel3. ADC_HC3 register will be used to conversion. */ |
AnnaBridge | 161:aa5281ff4a02 | 208 | kTSC_TriggerToChannel4 = 1U << 4U, /*!< Trigger to ADC channel4. ADC_HC4 register will be used to conversion. */ |
AnnaBridge | 161:aa5281ff4a02 | 209 | } tsc_trigger_signal_t; |
AnnaBridge | 161:aa5281ff4a02 | 210 | |
AnnaBridge | 161:aa5281ff4a02 | 211 | /*! |
AnnaBridge | 161:aa5281ff4a02 | 212 | * @ TSC controller ports. |
AnnaBridge | 161:aa5281ff4a02 | 213 | */ |
AnnaBridge | 161:aa5281ff4a02 | 214 | typedef enum _tsc_port_source |
AnnaBridge | 161:aa5281ff4a02 | 215 | { |
AnnaBridge | 161:aa5281ff4a02 | 216 | kTSC_WiperPortSource = 0U, /*!< TSC controller wiper port. */ |
AnnaBridge | 161:aa5281ff4a02 | 217 | kTSC_YnlrPortSource = 1U, /*!< TSC controller ynlr port. */ |
AnnaBridge | 161:aa5281ff4a02 | 218 | kTSC_YpllPortSource = 2U, /*!< TSC controller ypll port. */ |
AnnaBridge | 161:aa5281ff4a02 | 219 | kTSC_XnurPortSource = 3U, /*!< TSC controller xnur port. */ |
AnnaBridge | 161:aa5281ff4a02 | 220 | kTSC_XpulPortSource = 4U, /*!< TSC controller xpul port. */ |
AnnaBridge | 161:aa5281ff4a02 | 221 | } tsc_port_source_t; |
AnnaBridge | 161:aa5281ff4a02 | 222 | |
AnnaBridge | 161:aa5281ff4a02 | 223 | /*! |
AnnaBridge | 161:aa5281ff4a02 | 224 | * @ TSC port mode. |
AnnaBridge | 161:aa5281ff4a02 | 225 | */ |
AnnaBridge | 161:aa5281ff4a02 | 226 | typedef enum _tsc_port_mode |
AnnaBridge | 161:aa5281ff4a02 | 227 | { |
AnnaBridge | 161:aa5281ff4a02 | 228 | kTSC_PortOffMode = 0U, /*!< Disable pull up/down mode. */ |
AnnaBridge | 161:aa5281ff4a02 | 229 | kTSC_Port200k_PullUpMode = 1U << 2U, /*!< 200k-pull up mode. */ |
AnnaBridge | 161:aa5281ff4a02 | 230 | kTSC_PortPullUpMode = 1U << 1U, /*!< Pull up mode. */ |
AnnaBridge | 161:aa5281ff4a02 | 231 | kTSC_PortPullDownMode = 1U << 0U, /*!< Pull down mode. */ |
AnnaBridge | 161:aa5281ff4a02 | 232 | } tsc_port_mode_t; |
AnnaBridge | 161:aa5281ff4a02 | 233 | |
AnnaBridge | 161:aa5281ff4a02 | 234 | /*! |
AnnaBridge | 161:aa5281ff4a02 | 235 | * @ Controller configuration. |
AnnaBridge | 161:aa5281ff4a02 | 236 | */ |
AnnaBridge | 161:aa5281ff4a02 | 237 | typedef struct _tsc_config |
AnnaBridge | 161:aa5281ff4a02 | 238 | { |
AnnaBridge | 161:aa5281ff4a02 | 239 | bool enableAutoMeasure; /*!< Enable the auto-measure. It indicates after detect touch, whether automatic start |
AnnaBridge | 161:aa5281ff4a02 | 240 | measurement */ |
AnnaBridge | 161:aa5281ff4a02 | 241 | uint32_t measureDelayTime; /*!< Set delay time(0U~0xFFFFFFU) to even potential distribution ready.It is a |
AnnaBridge | 161:aa5281ff4a02 | 242 | preparation for measure stage. If measure dalay time is too short, maybe it would |
AnnaBridge | 161:aa5281ff4a02 | 243 | have an undesired effect on measure value. */ |
AnnaBridge | 161:aa5281ff4a02 | 244 | uint32_t prechargeTime; /*!< Set pre-charge time(1U~0xFFFFFFFFU) to make the upper layer of |
AnnaBridge | 161:aa5281ff4a02 | 245 | screen to charge to positive high. It is a preparation for detection stage. |
AnnaBridge | 161:aa5281ff4a02 | 246 | Pre-charge time must is greater than 0U, otherwise TSC could not work normally. |
AnnaBridge | 161:aa5281ff4a02 | 247 | If pre-charge dalay time is too short, maybe it would have an undesired effect on |
AnnaBridge | 161:aa5281ff4a02 | 248 | generation of valid signal(kTSC_ValidSignalFlag).*/ |
AnnaBridge | 161:aa5281ff4a02 | 249 | tsc_detection_mode_t detectionMode; /*!< Select the detection mode. See "tsc_detection_mode_t". */ |
AnnaBridge | 161:aa5281ff4a02 | 250 | } tsc_config_t; |
AnnaBridge | 161:aa5281ff4a02 | 251 | |
AnnaBridge | 161:aa5281ff4a02 | 252 | /******************************************************************************* |
AnnaBridge | 161:aa5281ff4a02 | 253 | * API |
AnnaBridge | 161:aa5281ff4a02 | 254 | ******************************************************************************/ |
AnnaBridge | 161:aa5281ff4a02 | 255 | #if defined(__cplusplus) |
AnnaBridge | 161:aa5281ff4a02 | 256 | extern "C" { |
AnnaBridge | 161:aa5281ff4a02 | 257 | #endif |
AnnaBridge | 161:aa5281ff4a02 | 258 | |
AnnaBridge | 161:aa5281ff4a02 | 259 | /*! |
AnnaBridge | 161:aa5281ff4a02 | 260 | * @brief Initialize the TSC module. |
AnnaBridge | 161:aa5281ff4a02 | 261 | * |
AnnaBridge | 161:aa5281ff4a02 | 262 | * @param base TSC peripheral base address. |
AnnaBridge | 161:aa5281ff4a02 | 263 | * @param config Pointer to "tsc_config_t" structure. |
AnnaBridge | 161:aa5281ff4a02 | 264 | */ |
AnnaBridge | 161:aa5281ff4a02 | 265 | void TSC_Init(TSC_Type *base, const tsc_config_t *config); |
AnnaBridge | 161:aa5281ff4a02 | 266 | |
AnnaBridge | 161:aa5281ff4a02 | 267 | /*! |
AnnaBridge | 161:aa5281ff4a02 | 268 | * @brief De-initializes the TSC module. |
AnnaBridge | 161:aa5281ff4a02 | 269 | * |
AnnaBridge | 161:aa5281ff4a02 | 270 | * @param base TSC peripheral base address. |
AnnaBridge | 161:aa5281ff4a02 | 271 | */ |
AnnaBridge | 161:aa5281ff4a02 | 272 | void TSC_Deinit(TSC_Type *base); |
AnnaBridge | 161:aa5281ff4a02 | 273 | |
AnnaBridge | 161:aa5281ff4a02 | 274 | /*! |
AnnaBridge | 161:aa5281ff4a02 | 275 | * @brief Gets an available pre-defined settings for the controller's configuration. |
AnnaBridge | 161:aa5281ff4a02 | 276 | * |
AnnaBridge | 161:aa5281ff4a02 | 277 | * This function initializes the converter configuration structure with available settings. |
AnnaBridge | 161:aa5281ff4a02 | 278 | * The default values of measureDelayTime and prechargeTime is tested on LCD8000-43T screen and work normally. |
AnnaBridge | 161:aa5281ff4a02 | 279 | * The default values are: |
AnnaBridge | 161:aa5281ff4a02 | 280 | * @code |
AnnaBridge | 161:aa5281ff4a02 | 281 | * config->enableAutoMeausre = false; |
AnnaBridge | 161:aa5281ff4a02 | 282 | * config->measureDelayTime = 0xFFFFU; |
AnnaBridge | 161:aa5281ff4a02 | 283 | * config->prechargeTime = 0xFFFFU; |
AnnaBridge | 161:aa5281ff4a02 | 284 | * config->detectionMode = kTSC_4WireDetectionMode; |
AnnaBridge | 161:aa5281ff4a02 | 285 | * @endCode |
AnnaBridge | 161:aa5281ff4a02 | 286 | * @param config Pointer to "tsc_config_t" structure. |
AnnaBridge | 161:aa5281ff4a02 | 287 | */ |
AnnaBridge | 161:aa5281ff4a02 | 288 | void TSC_GetDefaultConfig(tsc_config_t *config); |
AnnaBridge | 161:aa5281ff4a02 | 289 | |
AnnaBridge | 161:aa5281ff4a02 | 290 | /*! |
AnnaBridge | 161:aa5281ff4a02 | 291 | * @brief Make the TSC module return to idle status after finish the current state operation. |
AnnaBridge | 161:aa5281ff4a02 | 292 | * Application could check TSC status to confirm that the controller has return to idle status. |
AnnaBridge | 161:aa5281ff4a02 | 293 | * |
AnnaBridge | 161:aa5281ff4a02 | 294 | * @param base TSC peripheral base address. |
AnnaBridge | 161:aa5281ff4a02 | 295 | */ |
AnnaBridge | 161:aa5281ff4a02 | 296 | static inline void TSC_ReturnToIdleStatus(TSC_Type *base) |
AnnaBridge | 161:aa5281ff4a02 | 297 | { |
AnnaBridge | 161:aa5281ff4a02 | 298 | /* TSC_FLOW_CONTROL_DISABLE_MASK is a HW self-clean bit. */ |
AnnaBridge | 161:aa5281ff4a02 | 299 | base->FLOW_CONTROL |= TSC_FLOW_CONTROL_DISABLE_MASK; |
AnnaBridge | 161:aa5281ff4a02 | 300 | } |
AnnaBridge | 161:aa5281ff4a02 | 301 | |
AnnaBridge | 161:aa5281ff4a02 | 302 | /*! |
AnnaBridge | 161:aa5281ff4a02 | 303 | * @brief Start sense detection and (if work in auto-measure mode) measure after detect a touch. |
AnnaBridge | 161:aa5281ff4a02 | 304 | * |
AnnaBridge | 161:aa5281ff4a02 | 305 | * @param base TSC peripheral base address. |
AnnaBridge | 161:aa5281ff4a02 | 306 | */ |
AnnaBridge | 161:aa5281ff4a02 | 307 | static inline void TSC_StartSenseDetection(TSC_Type *base) |
AnnaBridge | 161:aa5281ff4a02 | 308 | { |
AnnaBridge | 161:aa5281ff4a02 | 309 | /* TSC_FLOW_CONTROL_START_SENSE_MASK is a HW self-clean bit. */ |
AnnaBridge | 161:aa5281ff4a02 | 310 | base->FLOW_CONTROL |= TSC_FLOW_CONTROL_START_SENSE_MASK; |
AnnaBridge | 161:aa5281ff4a02 | 311 | } |
AnnaBridge | 161:aa5281ff4a02 | 312 | |
AnnaBridge | 161:aa5281ff4a02 | 313 | /*! |
AnnaBridge | 161:aa5281ff4a02 | 314 | * @brief start measure X/Y coordinate value after detect a touch. |
AnnaBridge | 161:aa5281ff4a02 | 315 | * |
AnnaBridge | 161:aa5281ff4a02 | 316 | * @param base TSC peripheral base address. |
AnnaBridge | 161:aa5281ff4a02 | 317 | */ |
AnnaBridge | 161:aa5281ff4a02 | 318 | static inline void TSC_StartMeasure(TSC_Type *base) |
AnnaBridge | 161:aa5281ff4a02 | 319 | { |
AnnaBridge | 161:aa5281ff4a02 | 320 | /* TSC_FLOW_CONTROL_START_MEASURE_MASK is a HW self-clean bit. */ |
AnnaBridge | 161:aa5281ff4a02 | 321 | base->FLOW_CONTROL |= TSC_FLOW_CONTROL_START_MEASURE_MASK; |
AnnaBridge | 161:aa5281ff4a02 | 322 | } |
AnnaBridge | 161:aa5281ff4a02 | 323 | |
AnnaBridge | 161:aa5281ff4a02 | 324 | /*! |
AnnaBridge | 161:aa5281ff4a02 | 325 | * @brief Drop measure X/Y coordinate value after detect a touch and controller return to idle status. |
AnnaBridge | 161:aa5281ff4a02 | 326 | * |
AnnaBridge | 161:aa5281ff4a02 | 327 | * @param base TSC peripheral base address. |
AnnaBridge | 161:aa5281ff4a02 | 328 | */ |
AnnaBridge | 161:aa5281ff4a02 | 329 | static inline void TSC_DropMeasure(TSC_Type *base) |
AnnaBridge | 161:aa5281ff4a02 | 330 | { |
AnnaBridge | 161:aa5281ff4a02 | 331 | /* TSC_FLOW_CONTROL_DROP_MEASURE_MASK is a HW self-clean bit. */ |
AnnaBridge | 161:aa5281ff4a02 | 332 | base->FLOW_CONTROL |= TSC_FLOW_CONTROL_DROP_MEASURE_MASK; |
AnnaBridge | 161:aa5281ff4a02 | 333 | } |
AnnaBridge | 161:aa5281ff4a02 | 334 | |
AnnaBridge | 161:aa5281ff4a02 | 335 | /*! |
AnnaBridge | 161:aa5281ff4a02 | 336 | * @brief This is a synchronization reset, which resets every register except IPS directly access ones. |
AnnaBridge | 161:aa5281ff4a02 | 337 | * |
AnnaBridge | 161:aa5281ff4a02 | 338 | * @param base TSC peripheral base address. |
AnnaBridge | 161:aa5281ff4a02 | 339 | */ |
AnnaBridge | 161:aa5281ff4a02 | 340 | static inline void TSC_SoftwareReset(TSC_Type *base) |
AnnaBridge | 161:aa5281ff4a02 | 341 | { |
AnnaBridge | 161:aa5281ff4a02 | 342 | /* TSC_FLOW_CONTROL_SW_RST_MASK is a HW self-clean bit. */ |
AnnaBridge | 161:aa5281ff4a02 | 343 | base->FLOW_CONTROL |= TSC_FLOW_CONTROL_SW_RST_MASK; |
AnnaBridge | 161:aa5281ff4a02 | 344 | } |
AnnaBridge | 161:aa5281ff4a02 | 345 | |
AnnaBridge | 161:aa5281ff4a02 | 346 | /*! |
AnnaBridge | 161:aa5281ff4a02 | 347 | * @brief Get Y coordinate value or X coordinate value. The value is an ADC conversion value. |
AnnaBridge | 161:aa5281ff4a02 | 348 | * |
AnnaBridge | 161:aa5281ff4a02 | 349 | * @param base TSC peripheral base address. |
AnnaBridge | 161:aa5281ff4a02 | 350 | * @param selection Select alternative measure value which is Y coordinate value or X coordinate value. |
AnnaBridge | 161:aa5281ff4a02 | 351 | * See "tsc_corrdinate_value_selection_t". |
AnnaBridge | 161:aa5281ff4a02 | 352 | * @return If selection is "kTSC_XCoordinateValueSelection", the API returns x-coordinate vlaue. |
AnnaBridge | 161:aa5281ff4a02 | 353 | * If selection is "kTSC_YCoordinateValueSelection", the API returns y-coordinate vlaue. |
AnnaBridge | 161:aa5281ff4a02 | 354 | */ |
AnnaBridge | 161:aa5281ff4a02 | 355 | uint32_t TSC_GetMeasureValue(TSC_Type *base, tsc_corrdinate_value_selection_t selection); |
AnnaBridge | 161:aa5281ff4a02 | 356 | |
AnnaBridge | 161:aa5281ff4a02 | 357 | /*! |
AnnaBridge | 161:aa5281ff4a02 | 358 | * @brief Enable the interrupt signals. Interrupt signal will be set when corresponding event happens. |
AnnaBridge | 161:aa5281ff4a02 | 359 | * Specific events point to "_tsc_interrupt_signal_mask" . |
AnnaBridge | 161:aa5281ff4a02 | 360 | * Specific interrupt signal point to "_tsc_interrupt_status_flag_mask"; |
AnnaBridge | 161:aa5281ff4a02 | 361 | * |
AnnaBridge | 161:aa5281ff4a02 | 362 | * @param base TSC peripheral base address. |
AnnaBridge | 161:aa5281ff4a02 | 363 | * @param mask Interrupt signals mask. See "_tsc_interrupt_signal_mask". |
AnnaBridge | 161:aa5281ff4a02 | 364 | */ |
AnnaBridge | 161:aa5281ff4a02 | 365 | static inline void TSC_EnableInterruptSignals(TSC_Type *base, uint32_t mask) |
AnnaBridge | 161:aa5281ff4a02 | 366 | { |
AnnaBridge | 161:aa5281ff4a02 | 367 | base->INT_SIG_EN |= mask; |
AnnaBridge | 161:aa5281ff4a02 | 368 | } |
AnnaBridge | 161:aa5281ff4a02 | 369 | |
AnnaBridge | 161:aa5281ff4a02 | 370 | /*! |
AnnaBridge | 161:aa5281ff4a02 | 371 | * @brief Disable the interrupt signals. Interrupt signal will be set when corresponding event happens. |
AnnaBridge | 161:aa5281ff4a02 | 372 | * Specific events point to "_tsc_interrupt_signal_mask". |
AnnaBridge | 161:aa5281ff4a02 | 373 | * Specific interrupt signal point to "_tsc_interrupt_status_flag_mask"; |
AnnaBridge | 161:aa5281ff4a02 | 374 | * |
AnnaBridge | 161:aa5281ff4a02 | 375 | * @param base TSC peripheral base address. |
AnnaBridge | 161:aa5281ff4a02 | 376 | * @param mask Interrupt signals mask. See "_tsc_interrupt_signal_mask". |
AnnaBridge | 161:aa5281ff4a02 | 377 | */ |
AnnaBridge | 161:aa5281ff4a02 | 378 | static inline void TSC_DisableInterruptSignals(TSC_Type *base, uint32_t mask) |
AnnaBridge | 161:aa5281ff4a02 | 379 | { |
AnnaBridge | 161:aa5281ff4a02 | 380 | base->INT_SIG_EN &= ~mask; |
AnnaBridge | 161:aa5281ff4a02 | 381 | } |
AnnaBridge | 161:aa5281ff4a02 | 382 | |
AnnaBridge | 161:aa5281ff4a02 | 383 | /*! |
AnnaBridge | 161:aa5281ff4a02 | 384 | * @brief Enable the interrupts. Notice: Only interrupts and signals are all enabled, interrupts |
AnnaBridge | 161:aa5281ff4a02 | 385 | * could work normally. |
AnnaBridge | 161:aa5281ff4a02 | 386 | * |
AnnaBridge | 161:aa5281ff4a02 | 387 | * @param base TSC peripheral base address. |
AnnaBridge | 161:aa5281ff4a02 | 388 | * @param mask Interrupts mask. See "_tsc_interrupt_mask". |
AnnaBridge | 161:aa5281ff4a02 | 389 | */ |
AnnaBridge | 161:aa5281ff4a02 | 390 | static inline void TSC_EnableInterrupts(TSC_Type *base, uint32_t mask) |
AnnaBridge | 161:aa5281ff4a02 | 391 | { |
AnnaBridge | 161:aa5281ff4a02 | 392 | base->INT_EN |= mask; |
AnnaBridge | 161:aa5281ff4a02 | 393 | } |
AnnaBridge | 161:aa5281ff4a02 | 394 | |
AnnaBridge | 161:aa5281ff4a02 | 395 | /*! |
AnnaBridge | 161:aa5281ff4a02 | 396 | * @brief Disable the interrupts. |
AnnaBridge | 161:aa5281ff4a02 | 397 | * |
AnnaBridge | 161:aa5281ff4a02 | 398 | * @param base TSC peripheral base address. |
AnnaBridge | 161:aa5281ff4a02 | 399 | * @param mask Interrupts mask. See "_tsc_interrupt_mask". |
AnnaBridge | 161:aa5281ff4a02 | 400 | */ |
AnnaBridge | 161:aa5281ff4a02 | 401 | static inline void TSC_DisableInterrupts(TSC_Type *base, uint32_t mask) |
AnnaBridge | 161:aa5281ff4a02 | 402 | { |
AnnaBridge | 161:aa5281ff4a02 | 403 | base->INT_EN &= ~mask; |
AnnaBridge | 161:aa5281ff4a02 | 404 | } |
AnnaBridge | 161:aa5281ff4a02 | 405 | |
AnnaBridge | 161:aa5281ff4a02 | 406 | /*! |
AnnaBridge | 161:aa5281ff4a02 | 407 | * @brief Get interrupt status flags. Interrupt status falgs are valid when corresponding |
AnnaBridge | 161:aa5281ff4a02 | 408 | * interrupt signals are enabled. |
AnnaBridge | 161:aa5281ff4a02 | 409 | * |
AnnaBridge | 161:aa5281ff4a02 | 410 | * @param base TSC peripheral base address. |
AnnaBridge | 161:aa5281ff4a02 | 411 | * @return Status flags asserted mask. See "_tsc_interrupt_status_flag_mask". |
AnnaBridge | 161:aa5281ff4a02 | 412 | */ |
AnnaBridge | 161:aa5281ff4a02 | 413 | static inline uint32_t TSC_GetInterruptStatusFlags(TSC_Type *base) |
AnnaBridge | 161:aa5281ff4a02 | 414 | { |
AnnaBridge | 161:aa5281ff4a02 | 415 | return base->INT_STATUS; |
AnnaBridge | 161:aa5281ff4a02 | 416 | } |
AnnaBridge | 161:aa5281ff4a02 | 417 | |
AnnaBridge | 161:aa5281ff4a02 | 418 | /*! |
AnnaBridge | 161:aa5281ff4a02 | 419 | * @brief Clear interrupt status flags. Interrupt status falgs are valid when corresponding |
AnnaBridge | 161:aa5281ff4a02 | 420 | * interrupt signals are enabled. |
AnnaBridge | 161:aa5281ff4a02 | 421 | * |
AnnaBridge | 161:aa5281ff4a02 | 422 | * @param base TSC peripheral base address. |
AnnaBridge | 161:aa5281ff4a02 | 423 | * @param mask Status flags mask. See "_tsc_interrupt_status_flag_mask". |
AnnaBridge | 161:aa5281ff4a02 | 424 | */ |
AnnaBridge | 161:aa5281ff4a02 | 425 | static inline void TSC_ClearInterruptStatusFlags(TSC_Type *base, uint32_t mask) |
AnnaBridge | 161:aa5281ff4a02 | 426 | { |
AnnaBridge | 161:aa5281ff4a02 | 427 | base->INT_STATUS = mask; |
AnnaBridge | 161:aa5281ff4a02 | 428 | } |
AnnaBridge | 161:aa5281ff4a02 | 429 | |
AnnaBridge | 161:aa5281ff4a02 | 430 | /*! |
AnnaBridge | 161:aa5281ff4a02 | 431 | * @brief Get the status flags of ADC working with TSC. |
AnnaBridge | 161:aa5281ff4a02 | 432 | * |
AnnaBridge | 161:aa5281ff4a02 | 433 | * @param base TSC peripheral base address. |
AnnaBridge | 161:aa5281ff4a02 | 434 | * @return Status flags asserted mask. See "_tsc_adc_status_flag_mask". |
AnnaBridge | 161:aa5281ff4a02 | 435 | */ |
AnnaBridge | 161:aa5281ff4a02 | 436 | static inline uint32_t TSC_GetADCStatusFlags(TSC_Type *base) |
AnnaBridge | 161:aa5281ff4a02 | 437 | { |
AnnaBridge | 161:aa5281ff4a02 | 438 | return base->DEBUG_MODE; |
AnnaBridge | 161:aa5281ff4a02 | 439 | } |
AnnaBridge | 161:aa5281ff4a02 | 440 | |
AnnaBridge | 161:aa5281ff4a02 | 441 | /*! |
AnnaBridge | 161:aa5281ff4a02 | 442 | * @brief Get the status flags of TSC. |
AnnaBridge | 161:aa5281ff4a02 | 443 | * |
AnnaBridge | 161:aa5281ff4a02 | 444 | * @param base TSC peripheral base address. |
AnnaBridge | 161:aa5281ff4a02 | 445 | * @return Status flags asserted mask. See "_tsc_status_flag_mask". |
AnnaBridge | 161:aa5281ff4a02 | 446 | */ |
AnnaBridge | 161:aa5281ff4a02 | 447 | static inline uint32_t TSC_GetStatusFlags(TSC_Type *base) |
AnnaBridge | 161:aa5281ff4a02 | 448 | { |
AnnaBridge | 161:aa5281ff4a02 | 449 | return base->DEBUG_MODE2; |
AnnaBridge | 161:aa5281ff4a02 | 450 | } |
AnnaBridge | 161:aa5281ff4a02 | 451 | |
AnnaBridge | 161:aa5281ff4a02 | 452 | /*! |
AnnaBridge | 161:aa5281ff4a02 | 453 | *@} |
AnnaBridge | 161:aa5281ff4a02 | 454 | */ |
AnnaBridge | 161:aa5281ff4a02 | 455 | |
AnnaBridge | 161:aa5281ff4a02 | 456 | /******************************************************************************* |
AnnaBridge | 161:aa5281ff4a02 | 457 | * Debug API |
AnnaBridge | 161:aa5281ff4a02 | 458 | ******************************************************************************/ |
AnnaBridge | 161:aa5281ff4a02 | 459 | |
AnnaBridge | 161:aa5281ff4a02 | 460 | /*! |
AnnaBridge | 161:aa5281ff4a02 | 461 | * @brief Enable/Disable debug mode. Once work in debug mode, then all |
AnnaBridge | 161:aa5281ff4a02 | 462 | * TSC outputs will be controlled by software. Software can also observe all TSC inputs |
AnnaBridge | 161:aa5281ff4a02 | 463 | * through debug interface. Furthermore, the debug registers also provides current state |
AnnaBridge | 161:aa5281ff4a02 | 464 | * machine states. Software can always check the current hardware state. |
AnnaBridge | 161:aa5281ff4a02 | 465 | * |
AnnaBridge | 161:aa5281ff4a02 | 466 | * @param base TSC peripheral base address. |
AnnaBridge | 161:aa5281ff4a02 | 467 | * @param enable Switcher of the debug mode. "true" means debug mode,"false" means non-debug mode. |
AnnaBridge | 161:aa5281ff4a02 | 468 | */ |
AnnaBridge | 161:aa5281ff4a02 | 469 | static inline void TSC_EnableDebugMode(TSC_Type *base, bool enable) |
AnnaBridge | 161:aa5281ff4a02 | 470 | { |
AnnaBridge | 161:aa5281ff4a02 | 471 | if (enable) |
AnnaBridge | 161:aa5281ff4a02 | 472 | { |
AnnaBridge | 161:aa5281ff4a02 | 473 | base->DEBUG_MODE |= TSC_DEBUG_MODE_DEBUG_EN_MASK; |
AnnaBridge | 161:aa5281ff4a02 | 474 | } |
AnnaBridge | 161:aa5281ff4a02 | 475 | else |
AnnaBridge | 161:aa5281ff4a02 | 476 | { |
AnnaBridge | 161:aa5281ff4a02 | 477 | base->DEBUG_MODE &= ~TSC_DEBUG_MODE_DEBUG_EN_MASK; |
AnnaBridge | 161:aa5281ff4a02 | 478 | } |
AnnaBridge | 161:aa5281ff4a02 | 479 | } |
AnnaBridge | 161:aa5281ff4a02 | 480 | |
AnnaBridge | 161:aa5281ff4a02 | 481 | /*! |
AnnaBridge | 161:aa5281ff4a02 | 482 | * @brief Send hardware trigger signal to ADC in debug mode. The trigger signal must last at least 1 ips clock period. |
AnnaBridge | 161:aa5281ff4a02 | 483 | * |
AnnaBridge | 161:aa5281ff4a02 | 484 | * @param base TSC peripheral base address. |
AnnaBridge | 161:aa5281ff4a02 | 485 | * @param hwts Hardware trigger select signal, select which channel to start conversion. See "tsc_trigger_signal_t". |
AnnaBridge | 161:aa5281ff4a02 | 486 | * On ADC side, HWTS = 1 << x indicates the x logic channel is selected to start hardware ADC conversion. |
AnnaBridge | 161:aa5281ff4a02 | 487 | * @param enable Switcher of the trigger signal. "true" means generate trigger signal, "false" means don't generate |
AnnaBridge | 161:aa5281ff4a02 | 488 | * trigger signal. |
AnnaBridge | 161:aa5281ff4a02 | 489 | */ |
AnnaBridge | 161:aa5281ff4a02 | 490 | void TSC_DebugTriggerSignalToADC(TSC_Type *base, tsc_trigger_signal_t hwts, bool enable); |
AnnaBridge | 161:aa5281ff4a02 | 491 | |
AnnaBridge | 161:aa5281ff4a02 | 492 | /*! |
AnnaBridge | 161:aa5281ff4a02 | 493 | * @brief Enable/Disable hardware generates an ADC COCO clear signal in debug mode. |
AnnaBridge | 161:aa5281ff4a02 | 494 | * |
AnnaBridge | 161:aa5281ff4a02 | 495 | * @param base TSC peripheral base address. |
AnnaBridge | 161:aa5281ff4a02 | 496 | * @param enable Switcher of the function of hardware generating an ADC COCO clear signal. |
AnnaBridge | 161:aa5281ff4a02 | 497 | * "true" means prevent TSC from generate ADC COCO clear signal. |
AnnaBridge | 161:aa5281ff4a02 | 498 | * "false" means allow TSC hardware generates ADC COCO clear. |
AnnaBridge | 161:aa5281ff4a02 | 499 | */ |
AnnaBridge | 161:aa5281ff4a02 | 500 | static inline void TSC_DebugDisableHWClear(TSC_Type *base, bool enable) |
AnnaBridge | 161:aa5281ff4a02 | 501 | { |
AnnaBridge | 161:aa5281ff4a02 | 502 | if (enable) |
AnnaBridge | 161:aa5281ff4a02 | 503 | { |
AnnaBridge | 161:aa5281ff4a02 | 504 | base->DEBUG_MODE |= TSC_DEBUG_MODE_ADC_COCO_CLEAR_DISABLE_MASK; |
AnnaBridge | 161:aa5281ff4a02 | 505 | } |
AnnaBridge | 161:aa5281ff4a02 | 506 | else |
AnnaBridge | 161:aa5281ff4a02 | 507 | { |
AnnaBridge | 161:aa5281ff4a02 | 508 | base->DEBUG_MODE &= ~TSC_DEBUG_MODE_ADC_COCO_CLEAR_DISABLE_MASK; |
AnnaBridge | 161:aa5281ff4a02 | 509 | } |
AnnaBridge | 161:aa5281ff4a02 | 510 | } |
AnnaBridge | 161:aa5281ff4a02 | 511 | |
AnnaBridge | 161:aa5281ff4a02 | 512 | /*! |
AnnaBridge | 161:aa5281ff4a02 | 513 | * @brief Send clear ADC COCO signal to ADC in debug mode. The signal must hold a while. |
AnnaBridge | 161:aa5281ff4a02 | 514 | * |
AnnaBridge | 161:aa5281ff4a02 | 515 | * @param base TSC peripheral base address. |
AnnaBridge | 161:aa5281ff4a02 | 516 | * @param enable Switcher of the clear signal."true" means generate clear signal, "false" means don't generate |
AnnaBridge | 161:aa5281ff4a02 | 517 | * clear signal. |
AnnaBridge | 161:aa5281ff4a02 | 518 | */ |
AnnaBridge | 161:aa5281ff4a02 | 519 | static inline void TSC_DebugClearSignalToADC(TSC_Type *base, bool enable) |
AnnaBridge | 161:aa5281ff4a02 | 520 | { |
AnnaBridge | 161:aa5281ff4a02 | 521 | if (enable) |
AnnaBridge | 161:aa5281ff4a02 | 522 | { |
AnnaBridge | 161:aa5281ff4a02 | 523 | base->DEBUG_MODE |= TSC_DEBUG_MODE_ADC_COCO_CLEAR_MASK; |
AnnaBridge | 161:aa5281ff4a02 | 524 | } |
AnnaBridge | 161:aa5281ff4a02 | 525 | else |
AnnaBridge | 161:aa5281ff4a02 | 526 | { |
AnnaBridge | 161:aa5281ff4a02 | 527 | base->DEBUG_MODE &= ~TSC_DEBUG_MODE_ADC_COCO_CLEAR_MASK; |
AnnaBridge | 161:aa5281ff4a02 | 528 | } |
AnnaBridge | 161:aa5281ff4a02 | 529 | } |
AnnaBridge | 161:aa5281ff4a02 | 530 | |
AnnaBridge | 161:aa5281ff4a02 | 531 | /*! |
AnnaBridge | 161:aa5281ff4a02 | 532 | * @brief Enable/Disable detection in debug mode. |
AnnaBridge | 161:aa5281ff4a02 | 533 | * |
AnnaBridge | 161:aa5281ff4a02 | 534 | * @param base TSC peripheral base address. |
AnnaBridge | 161:aa5281ff4a02 | 535 | * @param detectionMode Set detect mode. See "tsc_detection_mode_t" |
AnnaBridge | 161:aa5281ff4a02 | 536 | * @param enable Switcher of detect enable. "true" means enable detection, "false" means disable detection. |
AnnaBridge | 161:aa5281ff4a02 | 537 | */ |
AnnaBridge | 161:aa5281ff4a02 | 538 | void TSC_DebugEnableDetection(TSC_Type *base, tsc_detection_mode_t detectionMode, bool enable); |
AnnaBridge | 161:aa5281ff4a02 | 539 | |
AnnaBridge | 161:aa5281ff4a02 | 540 | /*! |
AnnaBridge | 161:aa5281ff4a02 | 541 | * @brief Set TSC port mode in debug mode.(pull down, pull up and 200k-pull up) |
AnnaBridge | 161:aa5281ff4a02 | 542 | * |
AnnaBridge | 161:aa5281ff4a02 | 543 | * @param base TSC peripheral base address. |
AnnaBridge | 161:aa5281ff4a02 | 544 | * @param port TSC controller ports. |
AnnaBridge | 161:aa5281ff4a02 | 545 | * @param mode TSC port mode.(pull down, pull up and 200k-pull up) |
AnnaBridge | 161:aa5281ff4a02 | 546 | */ |
AnnaBridge | 161:aa5281ff4a02 | 547 | void TSC_DebugSetPortMode(TSC_Type *base, tsc_port_source_t port, tsc_port_mode_t mode); |
AnnaBridge | 161:aa5281ff4a02 | 548 | #endif /* _FSL_TSC_H_ */ |