/* * Copyright (c) 2016, Freescale Semiconductor, Inc. * Copyright 2016-2019 NXP * All rights reserved. * * SPDX-License-Identifier: BSD-3-Clause */ #include "fsl_tsc.h" /* Component ID definition, used by tools. */ #ifndef FSL_COMPONENT_ID #define FSL_COMPONENT_ID "platform.drivers.tsc" #endif /******************************************************************************* * Prototypes ******************************************************************************/ /*! * @brief Get instance number for TSC module. * * @param base TSC peripheral base address */ static uint32_t TSC_GetInstance(TSC_Type *base); /******************************************************************************* * Variables ******************************************************************************/ /*! @brief Pointers to TSC bases for each instance. */ static TSC_Type *const s_tscBases[] = TSC_BASE_PTRS; #if !(defined(FSL_SDK_DISABLE_DRIVER_CLOCK_CONTROL) && FSL_SDK_DISABLE_DRIVER_CLOCK_CONTROL) /*! @brief Pointers to ADC clocks for each instance. */ static const clock_ip_name_t s_tscClocks[] = TSC_CLOCKS; #endif /******************************************************************************* * Code ******************************************************************************/ static uint32_t TSC_GetInstance(TSC_Type *base) { uint32_t instance; /* Find the instance index from base address mappings. */ for (instance = 0; instance < ARRAY_SIZE(s_tscBases); instance++) { if (s_tscBases[instance] == base) { break; } } assert(instance < ARRAY_SIZE(s_tscBases)); return instance; } /*! * brief Initialize the TSC module. * * param base TSC peripheral base address. * param config Pointer to "tsc_config_t" structure. */ void TSC_Init(TSC_Type *base, const tsc_config_t *config) { assert(NULL != config); assert(config->measureDelayTime <= 0xFFFFFFU); uint32_t tmp32; #if !(defined(FSL_SDK_DISABLE_DRIVER_CLOCK_CONTROL) && FSL_SDK_DISABLE_DRIVER_CLOCK_CONTROL) /* Enable the TSC clock. */ CLOCK_EnableClock(s_tscClocks[TSC_GetInstance(base)]); #endif /* FSL_SDK_DISABLE_DRIVER_CLOCK_CONTROL */ /* Configure TSC_BASIC_SETTING register. */ tmp32 = TSC_BASIC_SETTING_MEASURE_DELAY_TIME(config->measureDelayTime) | TSC_BASIC_SETTING__4_5_WIRE(config->detectionMode); if (config->enableAutoMeasure) { tmp32 |= TSC_BASIC_SETTING_AUTO_MEASURE_MASK; } base->BASIC_SETTING = tmp32; /* Configure TSC_PS_INPUT_BUFFER_ADDR register. */ base->PRE_CHARGE_TIME = TSC_PRE_CHARGE_TIME_PRE_CHARGE_TIME(config->prechargeTime); } /*! * brief De-initializes the TSC module. * * param base TSC peripheral base address. */ void TSC_Deinit(TSC_Type *base) { #if !(defined(FSL_SDK_DISABLE_DRIVER_CLOCK_CONTROL) && FSL_SDK_DISABLE_DRIVER_CLOCK_CONTROL) /* Disable the TSC clcok. */ CLOCK_DisableClock(s_tscClocks[TSC_GetInstance(base)]); #endif /* FSL_SDK_DISABLE_DRIVER_CLOCK_CONTROL */ } /*! * brief Gets an available pre-defined settings for the controller's configuration. * * This function initializes the converter configuration structure with available settings. * The default values of measureDelayTime and prechargeTime is tested on LCD8000-43T screen and work normally. * The default values are: * code * config->enableAutoMeausre = false; * config->measureDelayTime = 0xFFFFU; * config->prechargeTime = 0xFFFFU; * config->detectionMode = kTSC_4WireDetectionMode; * endCode * param config Pointer to "tsc_config_t" structure. */ void TSC_GetDefaultConfig(tsc_config_t *config) { /* Initializes the configure structure to zero. */ (void)memset(config, 0, sizeof(*config)); config->enableAutoMeasure = false; config->measureDelayTime = 0xFFFFU; config->prechargeTime = 0xFFFFU; config->detectionMode = kTSC_Detection4WireMode; } /*! * brief Get Y coordinate value or X coordinate value. The value is an ADC conversion value. * * param base TSC peripheral base address. * param selection Select alternative measure value which is Y coordinate value or X coordinate value. * See "tsc_corrdinate_value_selection_t". * return If selection is "kTSC_XCoordinateValueSelection", the API returns x-coordinate vlaue. * If selection is "kTSC_YCoordinateValueSelection", the API returns y-coordinate vlaue. */ uint32_t TSC_GetMeasureValue(TSC_Type *base, tsc_corrdinate_value_selection_t selection) { uint32_t tmp32 = 0; if (selection == kTSC_XCoordinateValueSelection) { tmp32 = ((base->MEASEURE_VALUE) & TSC_MEASEURE_VALUE_X_VALUE_MASK) >> TSC_MEASEURE_VALUE_X_VALUE_SHIFT; } else if (selection == kTSC_YCoordinateValueSelection) { tmp32 = ((base->MEASEURE_VALUE) & TSC_MEASEURE_VALUE_Y_VALUE_MASK) >> TSC_MEASEURE_VALUE_Y_VALUE_SHIFT; } else { /* Intentional empty */ } return tmp32; } /*! * brief Send hardware trigger signal to ADC in debug mode. The trigger signal must last at least 1 ips clock period. * * param base TSC peripheral base address. * param hwts Hardware trigger select signal, select which channel to start conversion. See "tsc_trigger_signal_t". * On ADC side, HWTS = 1 << x indicates the x logic channel is selected to start hardware ADC conversion. * param enable Switcher of the trigger signal. "true" means generate trigger signal, "false" means don't generate * trigger signal. */ void TSC_DebugTriggerSignalToADC(TSC_Type *base, tsc_trigger_signal_t hwts, bool enable) { if (enable) { /* TSC_DEBUG_MODE_EXT_HWTS field should be writed before writing TSC_DEBUG_MODE_TRIGGER field. If the two fields are writed at the same time, the trigger couldn't work as expect. */ base->DEBUG_MODE &= ~TSC_DEBUG_MODE_EXT_HWTS_MASK; base->DEBUG_MODE |= TSC_DEBUG_MODE_EXT_HWTS(hwts); base->DEBUG_MODE |= TSC_DEBUG_MODE_TRIGGER_MASK; } else { base->DEBUG_MODE &= ~TSC_DEBUG_MODE_TRIGGER_MASK; } } /*! * brief Enable/Disable detection in debug mode. * * param base TSC peripheral base address. * param detectionMode Set detect mode. See "tsc_detection_mode_t" * param enable Switcher of detect enable. "true" means enable detection, "false" means disable detection. */ void TSC_DebugEnableDetection(TSC_Type *base, tsc_detection_mode_t detectionMode, bool enable) { if (detectionMode == kTSC_Detection4WireMode) { if (enable) { base->DEBUG_MODE2 |= TSC_DEBUG_MODE2_DETECT_ENABLE_FOUR_WIRE_MASK; } else { base->DEBUG_MODE2 &= ~TSC_DEBUG_MODE2_DETECT_ENABLE_FOUR_WIRE_MASK; } } else if (detectionMode == kTSC_Detection5WireMode) { if (enable) { base->DEBUG_MODE2 |= TSC_DEBUG_MODE2_DETECT_ENABLE_FIVE_WIRE_MASK; } else { base->DEBUG_MODE2 &= ~TSC_DEBUG_MODE2_DETECT_ENABLE_FIVE_WIRE_MASK; } } else { /* Intentional empty */ } } /*! * brief Set TSC port mode in debug mode.(pull down, pull up and 200k-pull up) * * param base TSC peripheral base address. * param port TSC controller ports. * param mode TSC port mode.(pull down, pull up and 200k-pull up) */ void TSC_DebugSetPortMode(TSC_Type *base, tsc_port_source_t port, tsc_port_mode_t mode) { uint32_t tmp32; tmp32 = base->DEBUG_MODE2; switch (port) { case kTSC_WiperPortSource: tmp32 &= ~(TSC_DEBUG_MODE2_WIPER_200K_PULL_UP_MASK | TSC_DEBUG_MODE2_WIPER_PULL_UP_MASK | TSC_DEBUG_MODE2_WIPER_PULL_DOWN_MASK); tmp32 |= ((uint32_t)mode << TSC_DEBUG_MODE2_WIPER_PULL_DOWN_SHIFT); break; case kTSC_YnlrPortSource: tmp32 &= ~(TSC_DEBUG_MODE2_YNLR_200K_PULL_UP_MASK | TSC_DEBUG_MODE2_YNLR_PULL_UP_MASK | TSC_DEBUG_MODE2_YNLR_PULL_DOWN_MASK); tmp32 |= ((uint32_t)mode << TSC_DEBUG_MODE2_YNLR_PULL_DOWN_SHIFT); break; case kTSC_YpllPortSource: tmp32 &= ~(TSC_DEBUG_MODE2_YPLL_200K_PULL_UP_MASK | TSC_DEBUG_MODE2_YPLL_PULL_UP_MASK | TSC_DEBUG_MODE2_YPLL_PULL_DOWN_MASK); tmp32 |= ((uint32_t)mode << TSC_DEBUG_MODE2_YPLL_PULL_DOWN_SHIFT); break; case kTSC_XnurPortSource: tmp32 &= ~(TSC_DEBUG_MODE2_XNUR_200K_PULL_UP_MASK | TSC_DEBUG_MODE2_XNUR_PULL_UP_MASK | TSC_DEBUG_MODE2_XNUR_PULL_DOWN_MASK); tmp32 |= ((uint32_t)mode << TSC_DEBUG_MODE2_XNUR_PULL_DOWN_SHIFT); break; case kTSC_XpulPortSource: tmp32 &= ~(TSC_DEBUG_MODE2_XPUL_200K_PULL_UP_MASK | TSC_DEBUG_MODE2_XPUL_PULL_UP_MASK | TSC_DEBUG_MODE2_XPUL_PULL_DOWN_MASK); tmp32 |= ((uint32_t)mode << TSC_DEBUG_MODE2_XPUL_PULL_DOWN_SHIFT); break; default: assert(false); break; } base->DEBUG_MODE2 = tmp32; }