/* * Copyright 2017, 2019 NXP * All rights reserved. * * SPDX-License-Identifier: BSD-3-Clause */ #include "fsl_kpp.h" /******************************************************************************* * Definitions ******************************************************************************/ /* Component ID definition, used by tools. */ #ifndef FSL_COMPONENT_ID #define FSL_COMPONENT_ID "platform.drivers.kpp" #endif #define KPP_KEYPAD_SCAN_TIMES (3U) /******************************************************************************* * Prototypes ******************************************************************************/ /******************************************************************************* * Variables ******************************************************************************/ #if !(defined(FSL_SDK_DISABLE_DRIVER_CLOCK_CONTROL) && FSL_SDK_DISABLE_DRIVER_CLOCK_CONTROL) /*! @brief Pointers to SEMC clocks for each instance. */ static const clock_ip_name_t s_kppClock[FSL_FEATURE_SOC_KPP_COUNT] = KPP_CLOCKS; #endif /* FSL_SDK_DISABLE_DRIVER_CLOCK_CONTROL */ /*! @brief Pointers to SEMC bases for each instance. */ static KPP_Type *const s_kppBases[] = KPP_BASE_PTRS; /*! @brief Pointers to KPP IRQ number for each instance. */ static const IRQn_Type s_kppIrqs[] = KPP_IRQS; /******************************************************************************* * Code ******************************************************************************/ static uint32_t KPP_GetInstance(KPP_Type *base) { uint32_t instance; /* Find the instance index from base address mappings. */ for (instance = 0; instance < ARRAY_SIZE(s_kppBases); instance++) { if (s_kppBases[instance] == base) { break; } } assert(instance < ARRAY_SIZE(s_kppBases)); return instance; } static void KPP_Mdelay(uint64_t tickets) { while ((tickets--) != 0UL) { __NOP(); } } /*! * brief KPP initialize. * This function ungates the KPP clock and initializes KPP. * This function must be called before calling any other KPP driver functions. * * param base KPP peripheral base address. * param configure The KPP configuration structure pointer. */ void KPP_Init(KPP_Type *base, kpp_config_t *configure) { assert(configure); uint32_t instance = KPP_GetInstance(base); #if !(defined(FSL_SDK_DISABLE_DRIVER_CLOCK_CONTROL) && FSL_SDK_DISABLE_DRIVER_CLOCK_CONTROL) /* Un-gate sdram controller clock. */ CLOCK_EnableClock(s_kppClock[KPP_GetInstance(base)]); #endif /* FSL_SDK_DISABLE_DRIVER_CLOCK_CONTROL */ /* Clear all. */ base->KPSR &= (uint16_t)(~(KPP_KPSR_KRIE_MASK | KPP_KPSR_KDIE_MASK)); /* Enable the keypad row and set the column strobe output to open drain. */ base->KPCR = KPP_KPCR_KRE(configure->activeRow); base->KPDR = KPP_KPDR_KCD((uint8_t) ~(configure->activeColumn)); base->KPCR |= KPP_KPCR_KCO(configure->activeColumn); /* Set the input direction for row and output direction for column. */ base->KDDR = KPP_KDDR_KCDD(configure->activeColumn) | KPP_KDDR_KRDD((uint8_t) ~(configure->activeRow)); /* Clear the status flag and enable the interrupt. */ base->KPSR = KPP_KPSR_KPKR_MASK | KPP_KPSR_KPKD_MASK | KPP_KPSR_KDSC_MASK | configure->interrupt; if ((configure->interrupt) != 0U) { /* Enable at the Interrupt */ (void)EnableIRQ(s_kppIrqs[instance]); } } /*! * brief Deinitializes the KPP module and gates the clock. * This function gates the KPP clock. As a result, the KPP * module doesn't work after calling this function. * * param base KPP peripheral base address. */ void KPP_Deinit(KPP_Type *base) { /* Disable interrupts and disable all rows. */ base->KPSR &= (uint16_t)(~(KPP_KPSR_KRIE_MASK | KPP_KPSR_KDIE_MASK)); base->KPCR = 0; #if !(defined(FSL_SDK_DISABLE_DRIVER_CLOCK_CONTROL) && FSL_SDK_DISABLE_DRIVER_CLOCK_CONTROL) /* Disable KPP clock. */ CLOCK_DisableClock(s_kppClock[KPP_GetInstance(base)]); #endif /* FSL_SDK_DISABLE_DRIVER_CLOCK_CONTROL */ } /*! * brief Keypad press scanning. * * This function will scanning all columns and rows. so * all scanning data will be stored in the data pointer. * * param base KPP peripheral base address. * param data KPP key press scanning data. The data buffer should be prepared with * length at least equal to KPP_KEYPAD_COLUMNNUM_MAX * KPP_KEYPAD_ROWNUM_MAX. * the data pointer is recommended to be a array like uint8_t data[KPP_KEYPAD_COLUMNNUM_MAX]. * for example the data[2] = 4, that means in column 1 row 2 has a key press event. * param clockSrc_Hz Source clock. */ void KPP_keyPressScanning(KPP_Type *base, uint8_t *data, uint32_t clockSrc_Hz) { assert(data); uint16_t kppKCO = base->KPCR & KPP_KPCR_KCO_MASK; uint8_t columIndex = 0; uint8_t activeColumn = (uint8_t)((base->KPCR & KPP_KPCR_KCO_MASK) >> KPP_KPCR_KCO_SHIFT); uint8_t times; uint8_t rowData[KPP_KEYPAD_SCAN_TIMES][KPP_KEYPAD_COLUMNNUM_MAX]; bool press = false; uint8_t column; /* Initialize row data to zero. */ (void)memset(&rowData[0][0], 0, sizeof(rowData)); /* Scanning. */ /* Configure the column data to 1 according to column numbers. */ base->KPDR = KPP_KPDR_KCD_MASK; /* Configure column to totem pole for quick discharge of keypad capacitance. */ base->KPCR &= (uint16_t)(((uint16_t)~kppKCO) | KPP_KPCR_KRE_MASK); /* Recover. */ base->KPCR |= kppKCO; /* Three times scanning. */ for (times = 0; times < KPP_KEYPAD_SCAN_TIMES; times++) { for (columIndex = 0; columIndex < KPP_KEYPAD_COLUMNNUM_MAX; columIndex++) { column = activeColumn & (1U << columIndex); if (column != 0U) { /* Set the single column line to 0. */ base->KPDR = KPP_KPDR_KCD(~(uint16_t)column); /* Take 100us delays. */ KPP_Mdelay(((uint64_t)clockSrc_Hz / 10000000UL)); /* Read row data. */ rowData[times][columIndex] = (uint8_t)(~(base->KPDR & KPP_KPDR_KRD_MASK)); } else { /* Read row data. */ rowData[times][columIndex] = 0; } } } /* Return all columns to 0 in preparation for standby mode. */ base->KPDR &= (uint16_t)(~KPP_KPDR_KCD_MASK); /* Check if three time scan data is the same. */ for (columIndex = 0; columIndex < KPP_KEYPAD_COLUMNNUM_MAX; columIndex++) { if (((uint8_t)(rowData[0][columIndex] & rowData[1][columIndex]) & rowData[2][columIndex]) != 0U) { press = true; } } if (press) { (void)memcpy(data, &rowData[0][0], sizeof(rowData[0])); } else { (void)memset(data, 0, sizeof(rowData[0])); } }