Initial import

2026-09-01 17:31:15 +08:00
commit 3ab37b7845
958 changed files with 231015 additions and 0 deletions
@@ -0,0 +1,100 @@
+/******************************************************************************
+ * @file    key.h
+ * @brief   按键状态机：短按 / 长按 / 释放
+ * @author  cyWu <1917507415@qq.com>
+ * @date    2026.08.25
+ * @version V1.0.0
+ * @history
+ * - V1.0.0, 2026.08.25, cyWu, 首次发布，实现按键短按/长按/释放状态机
+ ******************************************************************************/
+
+#ifndef __KEY_H__
+#define __KEY_H__
+
+#include <stdint.h>
+#include <string.h>
+
+/*============================================================================*/
+/* 宏定义                                                                     */
+/*============================================================================*/
+
+#define KEY_TIMER_MS   1
+#define KEY_MAX_NUMBER 12
+#define DEBOUNCE_TIME  30
+#define KEY_INTERVAL   30
+
+#define CLICK    1
+#define DbLCLICK 2
+
+typedef enum {
+    USR_KEY_USER = 0,
+    USR_KEY_COUNT
+} keyList;
+
+typedef enum {
+    Bit_RESET = 0,
+    Bit_SET
+} BitAction_t;
+
+typedef enum {
+    KEY_ST_NULL = 0,
+    KEY_ST_RELEASE,
+    KEY_ST_SURE,
+    KEY_ST_UP,
+    KEY_ST_DOWN,
+    KEY_ST_LONG
+} keyStatus_t;
+
+typedef enum {
+    NULL_Event = 0,
+    DOWN_Event,
+    SHORT_Event,
+    LONG_Event,
+    LAST_Event,
+    DBCL_Event,
+    RELEASE_Event
+} keyEvent_t;
+
+typedef enum {
+    KEY_DISABLE = 0,
+    KEY_ENABLE = !KEY_DISABLE
+} keyEnable_t;
+
+typedef struct {
+    uint8_t keyShortFlag;
+    uint8_t keyLongFlag;
+    uint8_t keyInterval;
+    uint8_t keyFrequency;
+    uint16_t keyLongTime;
+    uint16_t keyLastTime;
+    uint32_t keyCount;
+    keyEnable_t keyShield;
+    BitAction_t keyLevel;
+    BitAction_t keyDownLevel;
+    keyStatus_t keyStatus;
+    keyEvent_t eventType;
+    uint8_t (*keyReadValue)(void);
+} keyFSM_t;
+
+typedef struct {
+    void (*nullPressCb)(void);
+    void (*releasePressCb)(void);
+    void (*downPressCb)(void);
+    void (*ShortPressCb)(void);
+    void (*longPressCb)(void);
+    void (*lastPressCb)(void);
+    void (*dbclPressCb)(void);
+} keyFunc_t;
+
+typedef struct {
+    keyFSM_t fsm;
+    keyFunc_t func;
+} keyCategory_t;
+
+void keyParaInit(keyCategory_t *keys);
+void setKeyEventParams(uint8_t key_event, keyCategory_t key_param);
+void keyCheckProcess(void);
+void keyHandle(void);
+void reset_key_Status(keyList key_index);
+
+#endif /* __KEY_H__ */