47 lines
1.4 KiB
C
47 lines
1.4 KiB
C
/******************************************************************************
|
|
* @file app_pair.h
|
|
* @brief 配对会话计时：开机配对窗口是否成功/超时
|
|
* @author cyWu <1917507415@qq.com>
|
|
* @date 2026.09.10
|
|
* @version V1.1.0
|
|
* @history
|
|
* - V1.0.0, 2026.08.25, cyWu, 首次发布，实现配对会话计时与成功/超时判定
|
|
* - V1.1.0, 2026.09.10, cyWu, 窗口超时停止绑定广播
|
|
*
|
|
* @note 真正的 BLE 广播/绑定逻辑在 usr_le_code；本模块负责进入配对后
|
|
* 120s 内 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__ */
|