#ifndef __KEY_H__
#define __KEY_H__

#ifdef __cplusplus
extern "C" {
#endif

#pragma once

#include "main.h"
#include <stdint.h>
#include <stdbool.h>

// 时间参数（单位：ms）

#define KEY_LONG_THRESHOLD_MS    500 // 长按判定时间
#define KEY_REPEAT_INTERVAL_MS   150 // 连发间隔时间
#define KEY_DEBOUNCE_MS          3   // 消抖时间

/* 掩码工具（位索引即 key_id_t） */
#define KEY_BIT(id)             (1U << (uint8_t)(id))
#define KEY_ALL_MASK            ((uint32_t)((KEY_ID_MAX >= 32) ? 0xFFFFFFFFu : ((1u << KEY_ID_MAX) - 1)))

//KEYB
#define KEYB_PORT	GPIOA
#define KEYB_PIN	GPIO_PIN_0

//KEYN
#define KEYN_PORT	GPIOA
#define KEYN_PIN	GPIO_PIN_4

//KEYL
#define KEYL_PORT	GPIOA
#define KEYL_PIN	GPIO_PIN_3

//KEYR
#define KEYR_PORT	GPIOA
#define KEYR_PIN	GPIO_PIN_2

//KEYY
#define KEYY_PORT	GPIOA
#define KEYY_PIN	GPIO_PIN_1

/**
 * @brief 按键ID（与掩码位索引一致）
 */
typedef enum {
    KEY_ID_B = 0,  // KEYB
    KEY_ID_Y,      // KEYY
    KEY_ID_L,      // KEYL
    KEY_ID_R,      // KEYR
    KEY_ID_N,      // KEYN
    KEY_ID_MAX
} key_id_t;

/**
 * @brief 事件类型
 */
typedef enum {
    KEY_EVT_NONE    = 0,
    KEY_EVT_DOWN    = 1,   // 去抖后稳定按下
    KEY_EVT_UP      = 2,   // 去抖后稳定释放
    KEY_EVT_CLICK   = 3,   // 短按（一次按下->释放，且未触发长按）
    KEY_EVT_LONG    = 4,   // 达到长按阈值触发一次
    KEY_EVT_REPEAT  = 5    // 长按连发周期事件
} key_evt_type_t;

/**
 * @brief 事件对象
 */
typedef struct {
    key_id_t        id;
    key_evt_type_t  type;
} key_event_t;

/**
 * @brief 扫描模式（可用位或"|"组合）
 */
typedef enum {
    KEY_MODE_REPORT_DOWN_UP   = 0x01,   // 上报 DOWN/UP
    KEY_MODE_CLICK_ON_RELEASE = 0x02,   // 释放时若未长按，上报 CLICK
    KEY_MODE_LONG_ONCE        = 0x04,   // 达到阈值上报一次 LONG
    KEY_MODE_REPEAT           = 0x08    // 达到阈值后周期性上报 REPEAT
} key_mode_t;

/**
 * @brief 时序参数（单位：ms），可运行时修改
 */
typedef struct {
    uint16_t debounce_ms;        // 消抖时间，建议 3~20
    uint16_t long_ms;            // 长按判定时间，建议 400~800
    uint16_t repeat_ms;          // 连发间隔，建议 80~200
} key_timing_t;


void Key_Init(void);
bool Key_Scan(key_event_t* out_evt);

#ifdef __cplusplus
}
#endif
#endif