/******************************************************************************
 * @file    app_function.h
 * @brief   CBR3 功能总装：按键动作（短按切档/长按关机）+ DP 同步
 * @author  cyWu <1917507415@qq.com>
 * @date    2026.08.29
 * @version V1.0.0
 * @history
 * - V1.0.0, 2026.08.29, cyWu, 首次发布（移植门夹语义重写）
 *
 * @note    本模块只做"按键 → 动作"和"状态 → DP"，不写业务算法。
 *          档位/模式/条件的执行在各自 app_* 模块（规格书第 0 章第 2 条）。
 ******************************************************************************/

#ifndef __APP_FUNCTION_H__
#define __APP_FUNCTION_H__

#include <stdint.h>

/**
 * @brief  初始化功能模块状态
 * @return 无
 */
void app_function_init(void);

/**
 * @brief  同步 DP（power 恒 1、fan_gear、mode、fault_code），每个业务 tick 调用
 * @return 无
 */
void app_function_poll(void);

/**
 * @brief  任务上下文周期处理（由 usr_timer_loop 500ms 调用）
 * @note   ⚠ VM 落盘（syscfg_write）与关机收口只允许在这里做：usr_timer_loop
 *         跑在 BLE 线程（任务上下文，栈充足）；usr_timer_tick 是硬件定时器
 *         中断上下文，做这两件事会栈溢出复位。
 * @return 无
 */
void app_function_loop(void);

/**
 * @brief  停手动 + 模式，风扇关（关机请求 / 软关时用）
 * @return 无
 */
void app_function_stop_all(void);

/**
 * @brief  软关：风扇停、DP0=0（本产品 DP0 写忽略，软关仅按键 3s 触发）
 * @return 无
 */
void app_function_soft_off(void);

/**
 * @brief  上电默认开启功能（DP0=1），不带开机灯效提示
 * @return 无
 */
void app_function_power_on_silent(void);

/**
 * @brief  查询功能开关状态（DP0）
 * @return 1=开，0=关
 */
uint8_t app_function_is_power_on(void);

/**
 * @brief  业务层短按回调（key_manager 触发）：档位 1→2→3→0→1…
 * @return 无
 */
void usr_on_key_short(void);

/**
 * @brief  业务层长按 3s 回调（key_manager 触发）：请求软关机
 * @return 无
 */
void usr_on_key_long(void);

/**
 * @brief  出厂重置：清业务 VM 与 RAM，保留 BLE 配对（规格书 14 章）
 * @return 无
 */
void app_function_factory_reset(void);

#endif /* __APP_FUNCTION_H__ */