P0功能已实现，按键、LED、过零检测、配网、OTA都已正常实现

2026-09-04 18:49:07 +08:00
parent 2fb61a6458
commit 0de88083ba
47 changed files with 5184 additions and 26 deletions
@@ -0,0 +1,190 @@
+/******************************************************************************
+ * @file    app_led.c
+ * @brief   灯效：跟继电器实际态；OTA / 配对优先（规格书第 6 章）
+ * @author  cyWu <1917507415@qq.com>
+ * @date    2026.09.04
+ * @version V1.1.0
+ * @history
+ * - V1.1.0, 2026.09.04, cyWu, 精简注释
+ * - V1.0.0, 2026.09.04, cyWu, 首次发布
+ ******************************************************************************/
+
+#include "app_led.h"
+#include "led_manager.h"
+#include "bsp_hw.h"
+#include "board_pin.h"
+#include "app_pair.h"
+#include "app_relay.h"
+#include "system/includes.h"
+
+#define LOG_TAG_CONST APP
+#define LOG_TAG       "[APP_LED]"
+#define LOG_INFO_ENABLE
+#include "debug.h"
+
+typedef struct {
+    uint8_t inited;    /**< 1=已初始化 */
+    uint8_t ota;       /**< 1=OTA 灯效中，app_led_run 只跑交替 */
+    uint8_t pair_hint; /**< 1=长按已满 5s 但还没松手提交配对，维持配对快闪 */
+} AppLedCtx_t;
+
+static AppLedCtx_t s_led;
+
+/**
+ * @brief  重新播放一次「一次性/限时」灯效，让它从第 0 帧重新开始
+ * @note   先 Delete 清空槽位再 Add，强制重新计时（见 led.c LED_EventAdd 语义）
+ * @param  evt 要重启的事件
+ * @return 无
+ */
+static void led_restart(LED_Event_t evt)
+{
+    LED_EventDelete(evt);
+    LED_EventAdd(evt);
+}
+
+/**
+ * @brief  灯效初始化
+ * @return APP_LED_OK=成功
+ */
+AppLed_Ret_t app_led_init(void)
+{
+    if (s_led.inited) {
+        return APP_LED_OK;
+    }
+#if BOARD_LED_ENABLE
+    user_led_init();
+    s_led.ota = 0;
+    s_led.pair_hint = 0;
+    s_led.inited = 1;
+#else
+    log_info("led disabled\n");
+#endif
+    return APP_LED_OK;
+}
+
+/**
+ * @brief  查询模块是否已初始化
+ * @return APP_LED_OK=已初始化，APP_LED_ERR_NOT_INIT=未初始化
+ */
+AppLed_Ret_t app_led_get_status(void)
+{
+    return s_led.inited ? APP_LED_OK : APP_LED_ERR_NOT_INIT;
+}
+
+/**
+ * @brief  长按满 5s：绿灯 100ms 快闪提示（红灯灭）
+ * @return 无
+ */
+void app_led_hint_pair(void)
+{
+    if (!s_led.inited || s_led.ota) {
+        return;
+    }
+    s_led.pair_hint = 1;
+    LED_EventAllDelete(); /* 清掉跟继电器灯，避免红绿混色 */
+    bsp_led_all_off();
+    LED_EventAdd(LED_EVENT_PAIRING);
+}
+
+/**
+ * @brief  结束"将配网"提示，交回 app_led_run 按 app_pair 状态接管
+ * @return 无
+ */
+void app_led_clear_pair_hint(void)
+{
+    s_led.pair_hint = 0;
+}
+
+/**
+ * @brief  进入 OTA：清掉其它灯，挂红绿交替一直闪
+ * @return 无
+ */
+void app_led_request_ota(void)
+{
+    if (!s_led.inited) {
+        return;
+    }
+    s_led.ota = 1;
+    s_led.pair_hint = 0; /* 已改判 OTA，撤销配网提示 */
+    LED_EventAllDelete();
+    bsp_led_all_off();
+    LED_EventAdd(LED_EVENT_OTA);
+}
+
+/**
+ * @brief  查询是否处于 OTA 灯效
+ * @return 1=OTA 灯效中，0=否
+ */
+uint8_t app_led_is_ota(void)
+{
+    return s_led.ota;
+}
+
+/**
+ * @brief  按优先级刷新灯（20ms 业务节拍）
+ * @param  dt 距上次调用的毫秒数
+ * @return 无
+ */
+void app_led_run(uint16_t dt)
+{
+    AppPairEvt_t pair_evt;
+
+    if (!s_led.inited) {
+        return;
+    }
+
+#if BOARD_LED_ENABLE
+    /* OTA 期间只跑红绿交替 */
+    if (s_led.ota) {
+        LED_EventAdd(LED_EVENT_OTA);
+        user_led_handle();
+        return;
+    }
+
+    /* 配对成功/失败是边沿事件，只在那一拍切灯效（先撤跟继电器灯避免混色） */
+    pair_evt = app_pair_tick_1ms(dt);
+    if (pair_evt == APP_PAIR_EVT_OK) {
+        LED_EventDelete(LED_EVENT_HEAT_ON);
+        LED_EventDelete(LED_EVENT_HEAT_OFF);
+        LED_EventDelete(LED_EVENT_PAIRING);
+        led_restart(LED_EVENT_PAIR_OK);
+        log_info("led pair ok 3s\n");
+    } else if (pair_evt == APP_PAIR_EVT_FAIL) {
+        LED_EventDelete(LED_EVENT_HEAT_ON);
+        LED_EventDelete(LED_EVENT_HEAT_OFF);
+        LED_EventDelete(LED_EVENT_PAIRING);
+        led_restart(LED_EVENT_PAIR_FAIL);
+        log_info("led pair fail 3s\n");
+    }
+
+    /* 配对提示 / 配对中：维持绿灯快闪（add 幂等，不重置计时） */
+    if (s_led.pair_hint || app_pair_is_active()) {
+        if (!LED_IsEventExist(LED_EVENT_PAIR_OK) &&
+            !LED_IsEventExist(LED_EVENT_PAIR_FAIL)) {
+            LED_EventAdd(LED_EVENT_PAIRING);
+        }
+    } else if (!LED_IsEventExist(LED_EVENT_PAIR_OK) &&
+               !LED_IsEventExist(LED_EVENT_PAIR_FAIL)) {
+        /* 无高事件：灯跟继电器实际态（过零完成之后） */
+        if (app_relay_get_actual()) {
+            LED_EventAdd(LED_EVENT_HEAT_ON);
+        } else {
+            LED_EventAdd(LED_EVENT_HEAT_OFF);
+        }
+    }
+
+    user_led_handle();
+#endif
+}
+
+/**
+ * @brief  清空全部灯事件并灭灯
+ * @return 无
+ */
+void app_led_clear(void)
+{
+#if BOARD_LED_ENABLE
+    LED_EventAllDelete();
+    bsp_led_all_off();
+#endif
+}