261 lines
8.9 KiB
C
261 lines
8.9 KiB
C
/*
|
|
* 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;
|
|
}
|