接入温湿度风扇产品固件（仲裁/条件/定时/显示），并补齐规格书与外设驱动

新增 usr_app 产品逻辑：手动>定时>条件仲裁、条件控温湿、定时任务、数码管显示、按键/LED、风扇档位、NVM 掉电恢复、配对与开关机，上电按规格恢复上次状态。新增 usr_periph：AHT20、CT1642、板级引脚与硬件封装；见宝协议 cond_config 改为 7 字节编解码，并接入产品 DP。补充《温湿度风扇_固件需求规格书》，工程加入对应源文件。 .gitignore 忽略 WorkBuddy/Cursor 本地会话
2026-08-31 15:17:27 +08:00
parent 4cb7418a02
commit 5cc7e9dbd6
53 changed files with 7028 additions and 513 deletions
@@ -0,0 +1,82 @@
+/******************************************************************************
+ * @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__ */