/**************************************************************************//** * @file tk.h * @version V1.00 * @brief TK Driver Header File * * SPDX-License-Identifier: Apache-2.0 * @copyright (C) 2020 Nuvoton Technology Corp. All rights reserved. ******************************************************************************/ #ifndef __TK_H__ #define __TK_H__ #include "NuMicro.h" #ifdef __cplusplus extern "C" { #endif /** @addtogroup Standard_Driver Standard Driver @{ */ /** @addtogroup TK_Driver TK Driver @{ */ /** @addtogroup TK_EXPORTED_CONSTANTS TK Exported Constants @{ */ #define TK_SCAN_MODE_SINGLE (0UL) /*!< Touch key single scan mode */ #define TK_SCAN_MODE_PERIODIC (TK_SCANC_TRG_EN_Msk) /*!< Touch key periodic scan mode */ #define TK_SCAN_MODE_ALL_KEY (TK_REFC_SCAN_ALL_Msk) /*!< Touch key all keys scan mode */ #define TK_SCAN_MODE_PERIODIC_ALL_KEY (TK_SCANC_TRG_EN_Msk | TK_REFC_SCAN_ALL_Msk) /*!< Touch key periodic with all keys scan mode */ #define TK_SCAN_TRIGGER_SOURCE_TMR0 (1 << TK_SCANC_TMRTRG_EN_Pos) #define TK_SCAN_TRIGGER_SOURCE_TMR1 (2 << TK_SCANC_TMRTRG_EN_Pos) #define TK_SCAN_TRIGGER_SOURCE_TMR2 (3 << TK_SCANC_TMRTRG_EN_Pos) #define TK_SCAN_TRIGGER_SOURCE_TMR3 (4 << TK_SCANC_TMRTRG_EN_Pos) #define TK_SCAN_TRIGGER_SOURCE_LPTMR0 (8 << TK_SCANC_TMRTRG_EN_Pos) #define TK_SCAN_TRIGGER_SOURCE_LPTMR1 (9 << TK_SCANC_TMRTRG_EN_Pos) #define TK_SCAN_TRIGGER_SOURCE_TICKTMR0 (10 << TK_SCANC_TMRTRG_EN_Pos) #define TK_SCAN_TRIGGER_SOURCE_TICKTMR1 (11 << TK_SCANC_TMRTRG_EN_Pos) #define TK_SENSE_PULSE_1 (0UL << TK_REFC_PULSET_Pos) /*!< Touch key sensing pulse width is 1us */ #define TK_SENSE_PULSE_2 (1UL << TK_REFC_PULSET_Pos) /*!< Touch key sensing pulse width is 2us */ #define TK_SENSE_PULSE_4 (2UL << TK_REFC_PULSET_Pos) /*!< Touch key sensing pulse width is 4us */ #define TK_SENSE_PULSE_8 (3UL << TK_REFC_PULSET_Pos) /*!< Touch key sensing pulse width is 8us */ #define TK_SENSE_PULSE_250NS (6UL << TK_REFC_PULSET_Pos) /*!< Touch key sensing pulse width is 250ns */ #define TK_SENSE_PULSE_500NS (7UL << TK_REFC_PULSET_Pos) /*!< Touch key sensing pulse width is 500ns */ #define TK_SENSE_CNT_128 (0UL << TK_REFC_SENSET_Pos) /*!< Touch key sensing count is 128 */ #define TK_SENSE_CNT_255 (1UL << TK_REFC_SENSET_Pos) /*!< Touch key sensing count is 255 */ #define TK_SENSE_CNT_511 (2UL << TK_REFC_SENSET_Pos) /*!< Touch key sensing count is 511 */ #define TK_SENSE_CNT_1023 (3UL << TK_REFC_SENSET_Pos) /*!< Touch key sensing count is 1023 */ #define TK_SENSE_CNT_8 (4UL << TK_REFC_SENSET_Pos) /*!< Touch key sensing count is 8 */ #define TK_SENSE_CNT_16 (5UL << TK_REFC_SENSET_Pos) /*!< Touch key sensing count is 16 */ #define TK_SENSE_CNT_32 (6UL << TK_REFC_SENSET_Pos) /*!< Touch key sensing count is 32 */ #define TK_SENSE_CNT_64 (7UL << TK_REFC_SENSET_Pos) /*!< Touch key sensing count is 64 */ #define TK_AVCCH_1_DIV_16 (0UL << TK_SCANC_AVDDH_S_Pos) /*!< Touch key AVCCH voltage is 1/16 VDD */ #define TK_AVCCH_1_DIV_8 (1UL << TK_SCANC_AVDDH_S_Pos) /*!< Touch key AVCCH voltage is 1/8 VDD */ #define TK_AVCCH_3_DIV_16 (2UL << TK_SCANC_AVDDH_S_Pos) /*!< Touch key AVCCH voltage is 3/16 VDD */ #define TK_AVCCH_1_DIV_4 (3UL << TK_SCANC_AVDDH_S_Pos) /*!< Touch key AVCCH voltage is 1/4 VDD */ #define TK_AVCCH_5_DIV_16 (4UL << TK_SCANC_AVDDH_S_Pos) /*!< Touch key AVCCH voltage is 5/16 VDD */ #define TK_AVCCH_3_DIV_8 (5UL << TK_SCANC_AVDDH_S_Pos) /*!< Touch key AVCCH voltage is 3/8 VDD */ #define TK_AVCCH_7_DIV_16 (6UL << TK_SCANC_AVDDH_S_Pos) /*!< Touch key AVCCH voltage is 7/16 VDD */ #define TK_AVCCH_1_DIV_2 (7UL << TK_SCANC_AVDDH_S_Pos) /*!< Touch key AVCCH voltage is 1/2 VDD */ #define TK_AVCCH_1_DIV_32 (8UL << TK_SCANC_AVDDH_S_Pos) /*!< Touch key AVCCH voltage is 1/32 VDD */ #define TK_AVCCH_2_DIV_32 (9UL << TK_SCANC_AVDDH_S_Pos) /*!< Touch key AVCCH voltage is 2/32 VDD */ #define TK_AVCCH_3_DIV_32 (0xAUL << TK_SCANC_AVDDH_S_Pos) /*!< Touch key AVCCH voltage is 3/32 VDD */ #define TK_AVCCH_4_DIV_32 (0xBUL << TK_SCANC_AVDDH_S_Pos) /*!< Touch key AVCCH voltage is 4/32 VDD */ #define TK_AVCCH_5_DIV_32 (0xCUL << TK_SCANC_AVDDH_S_Pos) /*!< Touch key AVCCH voltage is 5/32 VDD */ #define TK_AVCCH_6_DIV_32 (0xDUL << TK_SCANC_AVDDH_S_Pos) /*!< Touch key AVCCH voltage is 6/32 VDD */ #define TK_AVCCH_7_DIV_32 (0xEUL << TK_SCANC_AVDDH_S_Pos) /*!< Touch key AVCCH voltage is 7/32 VDD */ #define TK_AVCCH_8_DIV_32 (0xFUL << TK_SCANC_AVDDH_S_Pos) /*!< Touch key AVCCH voltage is 8/32 VDD */ #define TK_TRG_EN_DISABLED (0UL << TK_SCANC_TMRTRG_EN_Pos) /*!< Touch key periodic trigger source selction disabled */ #define TK_TRG_EN_TMR0 (1UL << TK_SCANC_TMRTRG_EN_Pos) /*!< Touch key periodic trigger source selction Timer0 */ #define TK_TRG_EN_TMR1 (2UL << TK_SCANC_TMRTRG_EN_Pos) /*!< Touch key periodic trigger source selction Timer1 */ #define TK_TRG_EN_TMR2 (3UL << TK_SCANC_TMRTRG_EN_Pos) /*!< Touch key periodic trigger source selction Timer2 */ #define TK_TRG_EN_TMR3 (4UL << TK_SCANC_TMRTRG_EN_Pos) /*!< Touch key periodic trigger source selction Timer3 */ #define TK_TRG_EN_RTC (5UL << TK_SCANC_TMRTRG_EN_Pos) /*!< Touch key periodic trigger source selction RTC */ #define TK_TRG_EN_LPTMR0 (8UL << TK_SCANC_TMRTRG_EN_Pos) /*!< Touch key periodic trigger source selction LP Timer0 */ #define TK_TRG_EN_LPTMR1 (9UL << TK_SCANC_TMRTRG_EN_Pos) /*!< Touch key periodic trigger source selction LP Timer1 */ #define TK_TRG_EN_TICKTMR0 (0xAUL << TK_SCANC_TMRTRG_EN_Pos) /*!< Touch key periodic trigger source selction Tick Timer0 */ #define TK_TRG_EN_TICKTMR1 (0xBUL << TK_SCANC_TMRTRG_EN_Pos) /*!< Touch key periodic trigger source selction Tick Timer1 */ #define TK_CAP_BANK_POL_SEL_GND (0UL) /*!< Touch key capacitor bank polarity is GND */ #define TK_CAP_BANK_POL_SEL_AVCCH (1UL) /*!< Touch key capacitor bank polarity is AVCCH */ #define TK_CAP_BANK_POL_SEL_VDD (2UL) /*!< Touch key capacitor bank polarity is VDD */ #define TK_TKn_POL_SEL_GND (0UL) /*!< Touch key polarity is GND */ #define TK_TKn_POL_SEL_AVCCH (1UL) /*!< Touch key polarity is AVCCH */ #define TK_TKn_POL_SEL_VDD (2UL) /*!< Touch key polarity is VDD */ #define TK_INT_EN_SCAN_COMPLETE (TK_INTEN_SCIE_Msk) /*!< Touch key enable scan complete interrupt */ #define TK_INT_EN_SCAN_COMPLETE_LEVEL_TH (TK_INTEN_SCIE_Msk | TK_INTEN_SCTHIE_Msk) /*!< Touch key enable scan complete with threshold interrupt of level trigger mode */ #define TK_INT_SCAN_COMPLETE (TK_STA_SCIF_Msk) /*!< Touch key scan complete interrupt */ #define TK_INT_SCAN_COMPLETE_TH_ALL (0x1FFFF02UL) /*!< Touch key scan complete or all touch keys threshold control interrupt */ #define TK_INT_SCAN_TH_ALL (0x1FFFF00UL) /*!< ALL Touch key threshold control interrupt */ #define TK_INT_SCAN_TH_ALL1 (0x000001FUL) /*!< ALL Touch key threshold control interrupt */ #define TK_INT_SCAN_TH_TK0 (TK_STA_TKIF0_Msk) /*!< Touch key 0 threshold control interrupt */ #define TK_INT_SCAN_TH_TK1 (TK_STA_TKIF1_Msk) /*!< Touch key 1 threshold control interrupt */ #define TK_INT_SCAN_TH_TK2 (TK_STA_TKIF2_Msk) /*!< Touch key 2 threshold control interrupt */ #define TK_INT_SCAN_TH_TK3 (TK_STA_TKIF3_Msk) /*!< Touch key 3 threshold control interrupt */ #define TK_INT_SCAN_TH_TK4 (TK_STA_TKIF4_Msk) /*!< Touch key 4 threshold control interrupt */ #define TK_INT_SCAN_TH_TK5 (TK_STA_TKIF5_Msk) /*!< Touch key 5 threshold control interrupt */ #define TK_INT_SCAN_TH_TK6 (TK_STA_TKIF6_Msk) /*!< Touch key 6 threshold control interrupt */ #define TK_INT_SCAN_TH_TK7 (TK_STA_TKIF7_Msk) /*!< Touch key 7 threshold control interrupt */ #define TK_INT_SCAN_TH_TK8 (TK_STA_TKIF8_Msk) /*!< Touch key 8 threshold control interrupt */ #define TK_INT_SCAN_TH_TK9 (TK_STA_TKIF9_Msk) /*!< Touch key 9 threshold control interrupt */ #define TK_INT_SCAN_TH_TK10 (TK_STA_TKIF10_Msk) /*!< Touch key 10 threshold control interrupt */ #define TK_INT_SCAN_TH_TK11 (TK_STA_TKIF11_Msk) /*!< Touch key 11 threshold control interrupt */ #define TK_INT_SCAN_TH_TK12 (TK_STA_TKIF12_Msk) /*!< Touch key 12 threshold control interrupt */ #define TK_INT_SCAN_TH_TK13 (TK_STA_TKIF13_Msk) /*!< Touch key 13 threshold control interrupt */ #define TK_INT_SCAN_TH_TK14 (TK_STA_TKIF14_Msk) /*!< Touch key 14 threshold control interrupt */ #define TK_INT_SCAN_TH_TK15 (TK_STA_TKIF15_Msk) /*!< Touch key 15 threshold control interrupt */ #define TK_INT_SCAN_TH_TK16 (TK_STA_TKIF16_Msk) /*!< Touch key 16 threshold control interrupt */ #define TK_INT_SCAN_TH_TK17 (TK_STA_TKIF17_Msk) /*!< Touch key 17 threshold control interrupt */ #define TK_INT_SCAN_TH_TK18 (TK_STA_TKIF18_Msk) /*!< Touch key 18 threshold control interrupt */ #define TK_INT_SCAN_TH_TK19 (TK_STA_TKIF19_Msk) /*!< Touch key 19 threshold control interrupt */ #define TK_INT_SCAN_TH_TK20 (TK_STA_TKIF20_Msk) /*!< Touch key 20 threshold control interrupt */ #define TK_INT_SCAN_TH_TK21 (TK_STA_TKIF21_Msk) /*!< Touch key 21 threshold control interrupt */ #define TK_INT_SCAN_TH_TK22 (TK_STA_TKIF22_Msk) /*!< Touch key 22 threshold control interrupt */ #define TK_INT_SCAN_TH_TK23 (TK_STA_TKIF23_Msk) /*!< Touch key 23 threshold control interrupt */ #define TK_INT_SCAN_TH_TK24 (TK_STA_TKIF24_Msk) /*!< Touch key 24 threshold control interrupt */ #define TK_INT_SCAN_TH_TK25 (TK_STA_TKIF25_Msk) /*!< Touch key 25 threshold control interrupt */ #define TK_SCANALL_NUM (31) /*!< Touch key scan all number */ /*@}*/ /* end of group TK_EXPORTED_CONSTANTS */ /** @addtogroup TK_EXPORTED_FUNCTIONS TK Exported Functions @{ */ /** * @brief Enable scan key(s) * @param[in] u32Mask Combination of enabled scan keys. Each bit corresponds to a touch key. * Bit 0 represents touch key 0, bit 1 represents touch key 1... * @return None * @note Touch key 16 is the default reference key, so touch key 16 is enabled. * \hideinitializer */ #define TK_ENABLE_SCAN_KEY(u32Mask) (TK->SCANC |= (u32Mask&0x1FFFF)); \ (TK->SCANC1 |= ((u32Mask)>>17)) /** * @brief Disable scan key(s) * @param[in] u32Mask Combination of disabled scan keys. Each bit corresponds to a touch key. * Bit 0 represents touch key 0, bit 1 represents touch key 1... * @return None * \hideinitializer */ #define TK_DISABLE_SCAN_KEY(u32Mask) (TK->SCANC &= ~(u32Mask&0x1FFFF)); \ (TK->SCANC1 &= ~((u32Mask)>>17)) /** * @brief Enable reference key(s) * @param[in] u32Mask Combination of enabled reference keys. Each bit corresponds to a touch key. * Bit 0 represents touch key 0, bit 1 represents touch key 1... * @return None * @note Touch key 16 is the default reference key, so touch key 16 is enabled. * \hideinitializer */ #define TK_ENABLE_REF_KEY(u32Mask) (TK->REFC |= (u32Mask&0x1FFFF)); \ (TK->REFC1 |= (u32Mask>>17)) /** * @brief Disable reference key(s) * @param[in] u32Mask Combination of disabled reference keys. Each bit corresponds to a touch key. * Bit 0 represents touch key 0, bit 1 represents touch key 1... * @return None * @note It must enable a reference key and touch key 16 is the default reference key. * If no any one touch key as reference key except touch key 16, then reference Touch key 16 can't be disable. * \hideinitializer */ #define TK_DISABLE_REF_KEY(u32Mask) (TK->REFC &= ~(u32Mask&0x1FFFF)); \ (TK->REFC1 &= ~(u32Mask>>17)) /** * @brief Initiate enabled key(s) scan immediately. * @param None * @return None * \hideinitializer */ #define TK_START_SCAN() (TK->SCANC |= TK_SCANC_SCAN_Msk) /** * @brief Set touch key Sensing pulse width. * @param[in] u32PulseWidth Sensing pulse width. * - \ref TK_SENSE_PULSE_1 * - \ref TK_SENSE_PULSE_2 * - \ref TK_SENSE_PULSE_4 * - \ref TK_SENSE_PULSE_8 * - \ref TK_SENSE_PULSE_250NS * - \ref TK_SENSE_PULSE_500NS * @return None * \hideinitializer */ #define TK_SET_PULSE_WIDTH(u32PulseWidth) (TK->REFC = (TK->REFC & ~TK_REFC_PULSET_Msk) | (u32PulseWidth)) /** * @brief Set touch key Sensing count. * @param[in] u32SenseCnt Sensing count. * - \ref TK_SENSE_CNT_128 * - \ref TK_SENSE_CNT_255 * - \ref TK_SENSE_CNT_511 * - \ref TK_SENSE_CNT_1023 * - \ref TK_SENSE_CNT_8 * - \ref TK_SENSE_CNT_16 * - \ref TK_SENSE_CNT_32 * - \ref TK_SENSE_CNT_64 * @return None * \hideinitializer */ #define TK_SET_SENSING_CNT(u32SenseCnt) (TK->REFC = (TK->REFC & ~TK_REFC_SENSET_Msk) | (u32SenseCnt)) /** * @brief Set touch key AVCCH voltage. * @param[in] u32AVCCHSel voltage selection. * - \ref TK_AVCCH_1_DIV_16 * - \ref TK_AVCCH_1_DIV_8 * - \ref TK_AVCCH_3_DIV_16 * - \ref TK_AVCCH_1_DIV_4 * - \ref TK_AVCCH_5_DIV_16 * - \ref TK_AVCCH_3_DIV_8 * - \ref TK_AVCCH_7_DIV_16 * - \ref TK_AVCCH_1_DIV_2 * - \ref TK_AVCCH_1_DIV_32 * - \ref TK_AVCCH_2_DIV_32 * - \ref TK_AVCCH_3_DIV_32 * - \ref TK_AVCCH_4_DIV_32 * - \ref TK_AVCCH_5_DIV_32 * - \ref TK_AVCCH_6_DIV_32 * - \ref TK_AVCCH_7_DIV_32 * - \ref TK_AVCCH_8_DIV_32 * @return None * \hideinitializer */ #define TK_SET_AVCCH(u32AVCCHSel) (TK->SCANC = (TK->SCANC & ~TK_SCANC_AVDDH_S_Msk) | (u32AVCCHSel)) /** * @brief Get touch key complement capacitor bank data. * @param[in] u32TKNum Touch key number. The valid value is 0~25. * @return Complement capacitor bank data * \hideinitializer */ #define TK_GET_COMP_CAP_BANK_DATA(u32TKNum) ((u32TKNum<=16) ? (((*(__IO uint32_t *) (&(TK->CCBD0) + ((u32TKNum%17) >> 2))) >> ((u32TKNum%17) % 4 * 8) & TK_CCBD0_CCBD0_Msk)):(((*(__IO uint32_t *) (&(TK->CCBD5) + ((u32TKNum%17) >> 2))) >> ((u32TKNum%17) % 4 * 8) & TK_CCBD0_CCBD0_Msk))) /** * @brief Get touch key sensing result data. * @param[in] u32TKNum Touch key number. The valid value is 0~25. * @return Sensing result data * \hideinitializer */ #define TK_GET_SENSE_DATA(u32TKNum) ((u32TKNum<=16) ? (((*(__IO uint32_t *) (&(TK->DAT0) + ((u32TKNum%17) >> 2))) >> ((u32TKNum%17) % 4 * 8) & TK_DAT0_TKDAT0_Msk)):(((*(__IO uint32_t *) (&(TK->DAT5) + ((u32TKNum%17) >> 2))) >> ((u32TKNum%17) % 4 * 8) & TK_DAT0_TKDAT0_Msk))) /** * @brief Get touch key sensing result data. * @param[in] u32TKNum Touch key number. The valid value is 17~25. * @return Sensing result data * \hideinitializer */ #define TK_GET_SCANALL_SENSE_DATA() ((TK->DAT4 >> TK_DAT4_TKDAT_ALL_Pos) & TK_DAT0_TKDAT0_Msk) /** * @brief Get touch key busy status. * @param None * @retval 0 Touch key is scan completed or stopped. * @retval 1 Touch key is busy. * \hideinitializer */ #define TK_IS_BUSY() ((TK->STA & TK_STA_BUSY_Msk) ? 1: 0) /** * @brief Get touch key interrupt flag. * @param[in] u32Mask Interrupt flag type selection. * - \ref TK_INT_SCAN_COMPLETE * - \ref TK_INT_SCAN_COMPLETE_TH_ALL * - \ref TK_INT_SCAN_TH_ALL * - \ref TK_INT_SCAN_TH_TK0 * - \ref TK_INT_SCAN_TH_TK1 * - \ref TK_INT_SCAN_TH_TK2 * - \ref TK_INT_SCAN_TH_TK3 * - \ref TK_INT_SCAN_TH_TK4 * - \ref TK_INT_SCAN_TH_TK5 * - \ref TK_INT_SCAN_TH_TK6 * - \ref TK_INT_SCAN_TH_TK7 * - \ref TK_INT_SCAN_TH_TK8 * - \ref TK_INT_SCAN_TH_TK9 * - \ref TK_INT_SCAN_TH_TK10 * - \ref TK_INT_SCAN_TH_TK11 * - \ref TK_INT_SCAN_TH_TK12 * - \ref TK_INT_SCAN_TH_TK13 * - \ref TK_INT_SCAN_TH_TK14 * - \ref TK_INT_SCAN_TH_TK15 * - \ref TK_INT_SCAN_TH_TK16 * @retval 0 Touch key has no interrupt. * @retval 1 Touch key is scan completed or threshold control event occurs. * \hideinitializer */ #define TK_GET_INT_STATUS(u32Mask) ((TK->STA & (u32Mask)) ? 1: 0) /** * @brief Get touch key interrupt flag 1. * @param[in] u32Mask Interrupt flag type selection. * - \ref TK_INT_SCAN_TH_ALL1 * - \ref TK_INT_SCAN_TH_TK17 * - \ref TK_INT_SCAN_TH_TK18 * - \ref TK_INT_SCAN_TH_TK19 * - \ref TK_INT_SCAN_TH_TK20 * - \ref TK_INT_SCAN_TH_TK21 * - \ref TK_INT_SCAN_TH_TK22 * - \ref TK_INT_SCAN_TH_TK23 * - \ref TK_INT_SCAN_TH_TK24 * - \ref TK_INT_SCAN_TH_TK25 * @retval 0 Touch key has no interrupt. * @retval 1 Touch key is scan completed or threshold control event occurs. * \hideinitializer */ #define TK_GET_INT_STATUS1(u32Mask) ((TK->STA1 & (u32Mask)) ? 1: 0) /** * @brief Clear touch key interrupt flag. * @param[in] u32Mask Interrupt flag type selection. * - \ref TK_INT_SCAN_COMPLETE * - \ref TK_INT_SCAN_COMPLETE_TH_ALL * - \ref TK_INT_SCAN_TH_ALL * - \ref TK_INT_SCAN_TH_TK0 * - \ref TK_INT_SCAN_TH_TK1 * - \ref TK_INT_SCAN_TH_TK2 * - \ref TK_INT_SCAN_TH_TK3 * - \ref TK_INT_SCAN_TH_TK4 * - \ref TK_INT_SCAN_TH_TK5 * - \ref TK_INT_SCAN_TH_TK6 * - \ref TK_INT_SCAN_TH_TK7 * - \ref TK_INT_SCAN_TH_TK8 * - \ref TK_INT_SCAN_TH_TK9 * - \ref TK_INT_SCAN_TH_TK10 * - \ref TK_INT_SCAN_TH_TK11 * - \ref TK_INT_SCAN_TH_TK12 * - \ref TK_INT_SCAN_TH_TK13 * - \ref TK_INT_SCAN_TH_TK14 * - \ref TK_INT_SCAN_TH_TK15 * - \ref TK_INT_SCAN_TH_TK16 * - \ref TK_INT_SCAN_TH_TK17 * @return None * \hideinitializer */ #define TK_CLR_INT_FLAG(u32Mask) (TK->STA = (u32Mask)) /** * @brief Clear touch key interrupt flag 1. * @param[in] u32Mask Interrupt flag type selection. * - \ref TK_INT_SCAN_TH_ALL1 * - \ref TK_INT_SCAN_TH_TK17 * - \ref TK_INT_SCAN_TH_TK18 * - \ref TK_INT_SCAN_TH_TK19 * - \ref TK_INT_SCAN_TH_TK20 * - \ref TK_INT_SCAN_TH_TK21 * - \ref TK_INT_SCAN_TH_TK22 * - \ref TK_INT_SCAN_TH_TK23 * - \ref TK_INT_SCAN_TH_TK24 * - \ref TK_INT_SCAN_TH_TK25 * @return None * \hideinitializer */ #define TK_CLR_INT_FLAG1(u32Mask) (TK->STA1 = (u32Mask)) #define TK_INITIAL_POTENTIAL_GND (0UL << TK_POLC_POL_INIT_Pos) #define TK_INITIAL_POTENTIAL_AVDDH (1UL << TK_POLC_POL_INIT_Pos) /** * @brief Set TK Sensing Initial Potential Level * @param[in] u32Level Sensing Initial Potential Level. * - \ref TK_INITIAL_POTENTIAL_GND * - \ref TK_INITIAL_POTENTIAL_AVDDH * @return None * \hideinitializer */ #define TK_SET_INITIAL_POTENTIAL_LEVEL(u32Level) (TK->REFC = (TK->REFC & ~TK_POLC_POL_INIT_Msk) | (u32Level)) #define TK_CAPACITOR_BANK_SEL_MODE0 (0UL << TK_EXTCBC_EXT_CBSEL_Pos) #define TK_CAPACITOR_BANK_SEL_MODE1 (1UL << TK_EXTCBC_EXT_CBSEL_Pos) #define TK_CAPACITOR_BANK_SEL_MODE2 (2UL << TK_EXTCBC_EXT_CBSEL_Pos) /** * @brief Set TK Capacitor Bank Select Mode * @param[in] u32Level Capacitor Bank Select Mode * - \ref TK_CAPACITOR_BANK_SEL_MODE0 * - \ref TK_CAPACITOR_BANK_SEL_MODE1 * - \ref TK_CAPACITOR_BANK_SEL_MODE2 * @return None * \hideinitializer */ #define TK_EXTEND_CAPACITOR_BANK_SEL(u32CapBankSel) (TK->EXTCBC = (TK->EXTCBC & ~TK_EXTCBC_EXT_CBSEL_Msk) | (u32CapBankSel)) /*---------------------------------------------------------------------------------------------------------*/ /* Define TK functions prototype */ /*---------------------------------------------------------------------------------------------------------*/ void TK_Open(void); void TK_Close(void); void TK_SetScanMode(uint32_t u32Mode); void TK_ConfigSensitivity(uint32_t u32PulseWidth, uint32_t u32SenseCnt, uint32_t u32AVCCHSel); void TK_SetCapBankPol(uint32_t u32CapBankPolSel); void TK_EnableTkPolarity(uint32_t u32Mask); void TK_DisableTkPolarity(uint32_t u32Mask); void TK_SetCompCapBankData(uint32_t u32TKNum, uint32_t u32CapData); void TK_SetTkPol(uint32_t u32Mask, uint32_t u32PolSel); void TK_SetRefKeyCapBankData(uint32_t u32CapData); void TK_SetRefCapBankData(uint32_t u32TKNum, uint32_t u32CapData); void TK_SetScanThreshold(uint32_t u32TKNum, uint32_t u32HighLevel); void TK_EnableInt(uint32_t u32Msk); void TK_DisableInt(uint32_t u32Msk); void TK_DisableScanAll(void); void TK_EnableScanAll(uint8_t u8RefcbAll, uint8_t u8CcbAll, uint8_t u8HThAll); void TK_DisableAllChannel(void); void TK_ClearTKIF(void); void TK_ConfigPowerDown(uint8_t u8Sensitivity); /*@}*/ /* end of group TK_EXPORTED_FUNCTIONS */ /*@}*/ /* end of group TK_Driver */ /*@}*/ /* end of group Standard_Driver */ #ifdef __cplusplus } #endif #endif //__TK_H__