diff options
Diffstat (limited to 'lib/hc32f460/driver/src/hc32f460_keyscan.c')
| -rw-r--r-- | lib/hc32f460/driver/src/hc32f460_keyscan.c | 203 |
1 files changed, 203 insertions, 0 deletions
diff --git a/lib/hc32f460/driver/src/hc32f460_keyscan.c b/lib/hc32f460/driver/src/hc32f460_keyscan.c new file mode 100644 index 00000000..5da482cd --- /dev/null +++ b/lib/hc32f460/driver/src/hc32f460_keyscan.c @@ -0,0 +1,203 @@ +/*******************************************************************************
+ * Copyright (C) 2020, Huada Semiconductor Co., Ltd. All rights reserved.
+ *
+ * This software component is licensed by HDSC under BSD 3-Clause license
+ * (the "License"); You may not use this file except in compliance with the
+ * License. You may obtain a copy of the License at:
+ * opensource.org/licenses/BSD-3-Clause
+ */
+/******************************************************************************/
+/** \file hc32f460_keyscan.c
+ **
+ ** A detailed description is available at
+ ** @link KeyscanGroup Keyscan module description @endlink
+ **
+ ** - 2018-10-17 CDT First version for Device Driver Library of keyscan.
+ **
+ ******************************************************************************/
+
+/*******************************************************************************
+ * Include files
+ ******************************************************************************/
+#include "hc32f460_keyscan.h"
+#include "hc32f460_utility.h"
+
+/**
+ *******************************************************************************
+ ** \addtogroup KeyscanGroup
+ ******************************************************************************/
+//@{
+/*******************************************************************************
+ * Local type definitions ('typedef')
+ ******************************************************************************/
+
+/*******************************************************************************
+ * Local pre-processor symbols/macros ('#define')
+ ******************************************************************************/
+/*! Parameter validity check for Hiz cycle */
+#define IS_VALID_HIZ_CLCYE(x) \
+( ((x) == Hiz4) || \
+ ((x) == Hiz8) || \
+ ((x) == Hiz16) || \
+ ((x) == Hiz32) || \
+ ((x) == Hiz64) || \
+ ((x) == Hiz256) || \
+ ((x) == Hiz512) || \
+ ((x) == Hiz1K))
+
+/*! Parameter validity check for Low cycle */
+#define IS_VALID_LOW_CLCYE(x) \
+( ((x) == Low8) || \
+ ((x) == Low16) || \
+ ((x) == Low32) || \
+ ((x) == Low64) || \
+ ((x) == Low128) || \
+ ((x) == Low256) || \
+ ((x) == Low512) || \
+ ((x) == Low1K) || \
+ ((x) == Low2K) || \
+ ((x) == Low4K) || \
+ ((x) == Low8K) || \
+ ((x) == Low16K) || \
+ ((x) == Low32K) || \
+ ((x) == Low64K) || \
+ ((x) == Low128K) || \
+ ((x) == Low256K) || \
+ ((x) == Low512K) || \
+ ((x) == Low1M) || \
+ ((x) == Low2M) || \
+ ((x) == Low4M) || \
+ ((x) == Low8M) || \
+ ((x) == Low16M))
+
+/*! Parameter validity check for scan clock */
+#define IS_VALID_SCAN_CLK(x) \
+( ((x) == KeyscanHclk) || \
+ ((x) == KeyscanLrc) || \
+ ((x) == KeyscanXtal32))
+
+/*! Parameter validity check for keyout selection */
+#define IS_VALID_KEY_OUT(x) \
+( ((x) == Keyout0To1) || \
+ ((x) == Keyout0To2) || \
+ ((x) == Keyout0To3) || \
+ ((x) == Keyout0To4) || \
+ ((x) == Keyout0To5) || \
+ ((x) == Keyout0To6) || \
+ ((x) == Keyout0To7))
+
+/*******************************************************************************
+ * Global variable definitions (declared in header file with 'extern')
+ ******************************************************************************/
+
+/*******************************************************************************
+ * Local function prototypes ('static')
+ ******************************************************************************/
+
+/*******************************************************************************
+ * Local variable definitions ('static')
+ ******************************************************************************/
+
+/*******************************************************************************
+ * Function implementation - global ('extern') and local ('static')
+ ******************************************************************************/
+/**
+ *******************************************************************************
+ ** \brief KEYSCAN initialization
+ **
+ ** \param [in] pstcKeyscanConfig KEYSCAN configure structure
+ **
+ ** \retval Ok KEYSCAN initialized
+ ** ErrorInvalidMode Uninitialized, cannot configure it properly
+ **
+ ******************************************************************************/
+en_result_t KEYSCAN_Init(const stc_keyscan_config_t *pstcKeyscanConfig)
+{
+ en_result_t enRet = Ok;
+
+ DDL_ASSERT(IS_VALID_HIZ_CLCYE(pstcKeyscanConfig->enHizCycle));
+ DDL_ASSERT(IS_VALID_LOW_CLCYE(pstcKeyscanConfig->enLowCycle));
+ DDL_ASSERT(IS_VALID_SCAN_CLK(pstcKeyscanConfig->enKeyscanClk));
+ DDL_ASSERT(IS_VALID_KEY_OUT(pstcKeyscanConfig->enKeyoutSel));
+
+ /* cannot configure keyscan control register when running */
+ if (Set == M4_KEYSCAN->SER_f.SEN)
+ {
+ enRet = ErrorInvalidMode;
+ }
+ else
+ {
+ M4_KEYSCAN->SCR_f.T_HIZ = pstcKeyscanConfig->enHizCycle;
+ M4_KEYSCAN->SCR_f.T_LLEVEL = pstcKeyscanConfig->enLowCycle;
+ M4_KEYSCAN->SCR_f.CKSEL = pstcKeyscanConfig->enKeyscanClk;
+ M4_KEYSCAN->SCR_f.KEYOUTSEL = pstcKeyscanConfig->enKeyoutSel;
+ M4_KEYSCAN->SCR_f.KEYINSEL = pstcKeyscanConfig->u16KeyinSel;
+ }
+ return enRet;
+}
+
+/**
+ *******************************************************************************
+ ** \brief KEYSCAN de-initialization
+ **
+ ** \param None
+ **
+ ** \retval Ok KEYSCAN de-initialized
+ **
+ ******************************************************************************/
+en_result_t KEYSCAN_DeInit(void)
+{
+ M4_KEYSCAN->SER = 0ul;
+ M4_KEYSCAN->SCR = 0ul;
+ return Ok;
+}
+
+/**
+ *******************************************************************************
+ ** \brief Start keyscan function
+ **
+ ** \param None
+ **
+ ** \retval Ok Keyscan function started
+ **
+ ******************************************************************************/
+en_result_t KEYSCAN_Start(void)
+{
+ M4_KEYSCAN->SER_f.SEN = Set;
+ return Ok;
+}
+
+/**
+ *******************************************************************************
+ ** \brief Stop keyscan function
+ **
+ ** \param None
+ **
+ ** \retval Ok Keyscan function stopped
+ **
+ ******************************************************************************/
+en_result_t KEYSCAN_Stop(void)
+{
+ M4_KEYSCAN->SER_f.SEN = Reset;
+ return Ok;
+}
+
+/**
+ *******************************************************************************
+ ** \brief Get Key column index
+ **
+ ** \param None
+ **
+ ** \retval uint8_t Index of KEYOUT
+ **
+ ******************************************************************************/
+uint8_t KEYSCAN_GetColIdx(void)
+{
+ return (uint8_t)(M4_KEYSCAN->SSR_f.INDEX);
+}
+
+//@} // KeyscanGroup
+
+/*******************************************************************************
+ * EOF (not truncated)
+ ******************************************************************************/
|