主流程

components/rgb/rgb.c

@@ -221,3 +221,17 @@ void rgb_off(void)
 {
     rgb_transmit(0, 0, 0);
 }
+
+/* ── 系统状态 ── */
+
+static rgb_state_t s_rgb_state = RGB_STATE_IDLE;
+
+void rgb_set_state(rgb_state_t state)
+{
+    s_rgb_state = state;
+}
+
+rgb_state_t rgb_get_state(void)
+{
+    return s_rgb_state;
+}

components/rgb/rgb.h

@@ -42,6 +42,25 @@ void rgb_set_hsv(uint16_t h, uint8_t s, uint8_t v);
  */
 void rgb_off(void);
 
+/* ================================================================
+ * 系统状态指示 (供 main 循环读取)
+ * ================================================================ */
+
+typedef enum {
+    RGB_STATE_IDLE = 0,   /* 待机: 黄灯慢闪 */
+    RGB_STATE_DONE = 1,   /* 完成: 绿灯慢闪 */
+} rgb_state_t;
+
+/**
+ * @brief   设置系统指示状态
+ */
+void rgb_set_state(rgb_state_t state);
+
+/**
+ * @brief   获取当前系统指示状态
+ */
+rgb_state_t rgb_get_state(void);
+
 #ifdef __cplusplus
 }
 #endif