/******************************************************************************
 * @file    app_boot.h
 * @brief   CBR3 上电按键判定：3s 开机，5s 配对，12s OTA，不足 3s 松手再睡
 * @author  cyWu <1917507415@qq.com>
 * @date    2026.08.29
 * @version V1.0.0
 * @history
 * - V1.0.0, 2026.08.29, cyWu, 首次发布（移植门夹：删 USB 直通开机、删低电拒绝开机）
 *
 * @note    必须在 BLE 协议栈起来、业务定时器启动之前调用。杰理 jiffies 此时
 *          往往 10ms 才跳一次，所以内部一律用 timer_get_ms 直接量时间。
 *          ⚠ 本产品 USB 常电、无电池：插电/冷启动【不会】自动进入工作态，
 *          必须按住 3s（规格书 5.1/5.2）。门夹的 USB 直通开机逻辑禁止移植。
 ******************************************************************************/

#ifndef __APP_BOOT_H__
#define __APP_BOOT_H__

/**
 * @brief  等待并判定开机按键：不足 3s 松手、或全程未按键，直接原地深睡（不返回）；
 *         满 3s 视为正常开机；按满 5s 绿灯改快闪提示"松手即配网"，真正清绑定 /
 *         开绑定广播仍等松手（内部调用 app_pair_start）；持续按满 12s 直接开机
 *         并进入 OTA（调用 usr_app_ota_init）。
 * @return 无（深睡分支通过 while(1) 喂狗不返回；其余情况正常返回）
 */
void app_boot_wait_key(void);

#endif /* __APP_BOOT_H__ */