/******************************************************************************
 * @file    app_pair.h
 * @brief   配对会话计时：开机配对窗口是否成功/超时，与 BLE 配对本身解耦
 * @author  cyWu <1917507415@qq.com>
 * @date    2026.08.25
 * @version V1.0.0
 * @history
 * - V1.0.0, 2026.08.25, cyWu, 从 usr_jb_main 拆出
 *
 * @note    真正的 BLE 广播/绑定逻辑在 usr_le_code；本模块只负责“进入配对后
 *          60s 内 usr_get_pair_flag() 是否变 1”这件事，纯状态，不碰灯/按键。
 ******************************************************************************/

#ifndef __APP_PAIR_H__
#define __APP_PAIR_H__

#include <stdint.h>

/** 配对结果边沿事件，仅在状态变化那一次返回一次 */
typedef enum {
    APP_PAIR_EVT_NONE = 0,
    APP_PAIR_EVT_OK,
    APP_PAIR_EVT_FAIL
} AppPairEvt_t;

/**
 * @brief  开始一次配对会话（计时清零）
 * @return 无
 */
void app_pair_start(void);

/**
 * @brief  推进配对计时并检查结果，每个业务 tick 调用一次
 * @param  dt 距上次调用的毫秒数
 * @return APP_PAIR_EVT_OK=配对成功，APP_PAIR_EVT_FAIL=超时，否则 NONE
 */
AppPairEvt_t app_pair_tick_1ms(uint16_t dt);

/**
 * @brief  查询是否仍在配对会话中
 * @return 1=进行中，0=未在配对
 */
uint8_t app_pair_is_active(void);

#endif /* __APP_PAIR_H__ */