P0/P1/P2功能实现：接入业务组合根（按键/LED/过零/配网/OTA），联动、11B定时、运行记录、灯泡寿命（DP3/DP4/DP25）、CBR0 VM、512分包

2026-09-08 11:44:20 +08:00
parent 61821de0f8
commit 426bb8dab6
52 changed files with 6042 additions and 313 deletions
@@ -0,0 +1,68 @@
+/******************************************************************************
+ * @file    app_function.h
+ * @brief   功能总装：按键动作 + DP 同步（配对/OTA 只在任务上下文落地）
+ * @author  cyWu <1917507415@qq.com>
+ * @date    2026.09.04
+ * @version V1.1.0
+ ******************************************************************************/
+
+#ifndef __APP_FUNCTION_H__
+#define __APP_FUNCTION_H__
+
+#include <stdint.h>
+
+/**
+ * @brief  初始化功能模块状态
+ * @return 无
+ */
+void app_function_init(void);
+
+/**
+ * @brief  同步 DP（DP0=继电器实际态、DP23=fault_code），每个 20ms 业务 tick 调用
+ * @note   DP0 上报**实际吸合状态**（过零完成之后），让 APP 看见过零完成
+ * @return 无
+ */
+void app_function_poll(void);
+
+/**
+ * @brief  任务上下文周期处理（usr_timer_loop 500ms）
+ * @note   写 VM / 配对 / OTA 只准在此落地，禁止放进 20ms ISR
+ * @return 无
+ */
+void app_function_loop(void);
+
+/**
+ * @brief  业务层短按回调（key_manager 触发）：切换灯泡请求（开↔关，手动抢权）
+ * @return 无
+ */
+void usr_on_key_short(void);
+
+/**
+ * @brief  业务层"按住满 5s"回调（key_manager 触发，20ms 中断上下文）
+ * @note   只切提示灯（绿灯快闪），不清绑定
+ * @return 无
+ */
+void usr_on_key_pair_hint(void);
+
+/**
+ * @brief  业务层"按满 5s 后松手"回调（key_manager 触发，20ms 中断上下文）
+ * @note   只置标志：清绑定要写 VM，由 app_function_loop 在任务上下文执行
+ * @return 无
+ */
+void usr_on_key_pair_start(void);
+
+/**
+ * @brief  业务层"按住满 12s"回调（key_manager 触发，20ms 中断上下文）
+ * @note   只置标志：usr_app_ota_init 由 app_function_loop 在任务上下文执行
+ * @return 无
+ */
+void usr_on_key_ota_start(void);
+
+/**
+ * @brief  出厂重置（DP26 写 1）：清业务 VM 与 RAM（含寿命回额定），保留 BLE 配对
+ * @note   规格书第 14 章；由 jb_product DP26 调用
+ * @return 无
+ */
+void app_function_factory_reset(void);
+
+#endif /* __APP_FUNCTION_H__ */