docs: 补充核心分层中文注释

2026-09-29 18:18:44 +08:00
parent a77471a7b1
commit 9fd01bb61b
81 changed files with 1189 additions and 112 deletions
@@ -10,6 +10,12 @@

 #include "driver/gpio.h"

+/*
+ * 控制面内部事件总线的数据契约：输入驱动只负责生成“发生了什么”，系统事件任务再决定
+ * “应该做什么”。这种拆分避免在 GPIO 中断或按键扫描任务里直接执行联网、播放、旋转等
+ * 可能阻塞的业务动作。这里的结构体会按值放入 FreeRTOS 队列，因此字段必须保持轻量，
+ * 不得加入需要跨任务管理生命周期的裸指针。
+ */
 typedef enum {
    CONTROL_PLANE_EVENT_FAMILY_KEY = 0,
    CONTROL_PLANE_EVENT_FAMILY_WIFI,