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

新增 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,120 @@
+/******************************************************************************
+ * @file    led.h
+ * @brief   LED 事件框架：按通道掩码独立开关
+ * @author  cyWu <1917507415@qq.com>
+ * @date    2026.08.31
+ * @version V1.2.0
+ * @history
+ * - V1.0.0, 2026.08.25, cyWu, 首次发布，实现按通道掩码独立开关的 LED 事件框架
+ * - V1.1.0, 2026.08.27, cyWu, 新增 LED_EVENT_BOOT_REJECT
+ * - V1.2.0, 2026.08.31, cyWu, CBR3 单灯：裁掉充电/低电/空电等门夹事件
+ ******************************************************************************/
+
+#ifndef __LED_H__
+#define __LED_H__
+
+#include <stdint.h>
+#include <string.h>
+
+/*============================================================================*/
+/* 宏定义                                                                     */
+/*============================================================================*/
+
+#define BLINK_ENABLE             1
+#define ALTERNATING_BLINK_ENABLE 0
+#define BREATH_ENABLE            0
+#define RUNNING_ENABLE           0
+#define MARQUEE_ENABLE           0
+
+#define LED_ON  1
+#define LED_OFF 0
+
+#define LED_CHANNEL(user_led) (1u << (user_led))
+
+#define ledPrintf(level, fmt, ...) ((void)0)
+
+/*============================================================================*/
+/* 类型                                                                       */
+/*============================================================================*/
+
+typedef enum {
+    LED_LIGHT = 0,           /**< 常亮 */
+    LED_BLINKING,            /**< 闪烁 */
+    LED_ALTERNATING_BLINK    /**< 交替闪（本产品未用） */
+} LED_State_t;
+
+typedef enum {
+    LED_EVENT_NONE = 0,
+    LED_EVENT_STANDBY,       /**< 开机常亮 */
+    LED_EVENT_PAIRING,       /**< 配对快闪 */
+    LED_EVENT_PAIR_OK,       /**< 配对成功常亮若干秒 */
+    LED_EVENT_PAIR_FAIL,     /**< 配对失败闪若干秒 */
+    LED_EVENT_OTA,           /**< OTA 闪，直到升级结束/复位 */
+    LED_EVENT_MAX
+} LED_Event_t;
+
+/**
+ * 同优先级会互相覆盖
+ */
+typedef enum {
+    PRIORITY_1 = 0,          /**< 开机常亮 */
+    PRIORITY_2,              /**< 配对中 / 配对结果 */
+    PRIORITY_3,              /**< OTA */
+    PRIORITY_MAX
+} LED_EventPriority_t;
+
+#if (BLINK_ENABLE)
+typedef struct {
+    uint8_t orDer;           /**< 1=先灭后亮，0=先亮后灭 */
+    uint32_t onTime;         /**< 亮时间 ms */
+    uint32_t offTime;        /**< 灭时间 ms */
+} LED_BlinkParams_t;
+#endif
+
+#if (ALTERNATING_BLINK_ENABLE)
+#define ALTERNAT_GROUP 2
+typedef struct {
+    uint16_t Group[ALTERNAT_GROUP]; /**< 交替两组的通道掩码 */
+    uint32_t Cycle;                 /**< 一整轮交替周期 ms */
+} LED_AlternatingBlinkParams_t;
+#endif
+
+typedef struct {
+    LED_State_t state;
+    uint16_t ledMask;        /**< 本事件只动这些通道，其它灯不受影响 */
+    uint16_t runNum;         /**< 0=无限；常亮按秒计，闪烁按周期计 */
+    uint32_t currentTime;
+#if (BLINK_ENABLE)
+    LED_BlinkParams_t blinkParams;
+#endif
+#if (ALTERNATING_BLINK_ENABLE)
+    LED_AlternatingBlinkParams_t alternatingBlinkParams;
+#endif
+} LED_Config_t;
+
+typedef struct {
+    LED_Event_t event;
+    LED_EventPriority_t priority;
+    LED_Config_t config;
+    uint8_t (*ledEventHandler)(LED_Config_t *config);
+} LED_EventTableItem_t;
+
+typedef void (*LED_SetState_t)(uint16_t led, uint8_t state);
+typedef uint32_t (*TIME_Get_t)(void);
+
+/*============================================================================*/
+/* 外部接口                                                                   */
+/*============================================================================*/
+
+void LED_SetStateInit(LED_SetState_t setState);
+void SET_TimeGetInit(TIME_Get_t getTime);
+void LED_EventTableInit(LED_EventTableItem_t ledEvent[]);
+void LED_EventAdd(LED_Event_t ledEvent);
+void LED_EventDelete(LED_Event_t ledEvent);
+void LED_EventAllDelete(void);
+void LED_EventHandle(void);
+uint8_t LED_IsEventActive(void);
+uint8_t LED_IsEventExist(LED_Event_t ledEvent);
+uint8_t LED_Update(LED_Config_t *led);
+
+#endif /* __LED_H__ */