【花雕动手做】MimiClaw 集成 WS2812 全彩 LED 灯带实战：从舵机到炫彩灯效的 AI 控制

// 灯珠核心配置
#define LED_NUM     9       // 灯珠总数
#define LED_GPIO    48      // 数据控制引脚
#define LED_MAX_BRIGHTNESS 255  // 最大亮度

// 全局静态变量
static led_strip_handle_t s_led_strip = NULL;    // LED 设备句柄
static uint8_t s_brightness = LED_MAX_BRIGHTNESS; // 当前亮度
static TaskHandle_t s_animation_task = NULL;      // 动画任务句柄
static bool s_animation_stop = false;             // 动画停止标志位

// 应用亮度缩放（统一调节所有灯珠亮度）
static void apply_brightness(uint8_t *r, uint8_t *g, uint8_t *b) {
    *r = (*r * s_brightness) / LED_MAX_BRIGHTNESS;
    *g = (*g * s_brightness) / LED_MAX_BRIGHTNESS;
    *b = (*b * s_brightness) / LED_MAX_BRIGHTNESS;
}

// 设置所有灯珠为指定颜色
esp_err_t tool_ws2812_set_all(uint8_t r, uint8_t g, uint8_t b) {
    // 自动初始化（未初始化时执行）
    if (s_led_strip == NULL) {
        tool_ws2812_init();
    }
    // 应用亮度参数
    apply_brightness(&r, &g, &b);
    // 遍历设置所有灯珠
    for (int i = 0; i < LED_NUM; i++) {
        led_strip_set_pixel(s_led_strip, i, r, g, b);
    }
    // 刷新显示
    return led_strip_refresh(s_led_strip);
}

// 清空所有灯珠（关灯）
esp_err_t tool_ws2812_clear(void) {
    led_strip_clear(s_led_strip);
    return led_strip_refresh(s_led_strip);
}

// 呼吸灯动画任务
static void breathing_task(void *arg) {
    // 解析传入的 RGB 颜色参数
    uint8_t r = ((uint32_t)arg >> 16) & 0xFF;
    uint8_t g = ((uint32_t)arg >> 8) & 0xFF;
    uint8_t b = (uint32_t)arg & 0xFF;
    
    int dir = 1;    // 亮度变化方向：1=递增，-1=递减
    int val = 0;    // 当前亮度值
    
    // 循环执行呼吸效果，直到收到停止信号
    while (!s_animation_stop) {
        val += dir * 5;
        // 边界控制：0~255 范围内循环
        if (val >= 255) { val = 255; dir = -1; }
        else if (val <= 0) { val = 0; dir = 1; }
        
        // 计算当前亮度下的颜色并设置
        tool_ws2812_set_all((r*val)/255, (g*val)/255, (b*val)/255);
        vTaskDelay(pdMS_TO_TICKS(20)); // 20ms 刷新一次
    }
    
    // 动画停止后关灯并销毁任务
    tool_ws2812_clear();
    vTaskDelete(NULL);
}

// 停止当前运行的动画任务
static void stop_animation(void) {
    if (s_animation_task != NULL) {
        s_animation_stop = true;
        // 等待任务安全退出
        vTaskDelay(pdMS_TO_TICKS(50));
        s_animation_task = NULL;
    }
}

// 统一启动动画接口（自动处理旧任务停止）
static esp_err_t start_animation(void (*task_func)(void *), uint32_t arg, char *out, size_t out_len) {
    // 先停止现有动画，避免冲突
    if (s_animation_task) {
        stop_animation();
    }
    s_animation_stop = false;
    // 创建新动画任务
    xTaskCreate(task_func, "led_anim", 4096, (void*)arg, 5, &s_animation_task);
    snprintf(out, out_len, "LED 动画已启动");
    return ESP_OK;
}

// 开灯工具（支持颜色名/自定义 RGB）
mimi_tool_t led_on = {
    .name = "led_on",
    .description = "开启 LED 灯，支持颜色名（red/green/blue/white）或自定义 RGB",
    .execute = tool_ws2812_on_execute,
};

// 关灯工具
mimi_tool_t led_off = {
    .name = "led_off",
    .description = "关闭所有 LED 灯",
    .execute = tool_ws2812_off_execute,
};

// 呼吸灯工具
mimi_tool_t led_breathing = {
    .name = "led_breathing",
    .description = "启动呼吸灯效果，支持指定颜色",
    .execute = tool_ws2812_breathing_execute,
};

// 额外注册：彩虹灯、流水灯、停止动画、亮度调节工具
mimi_tool_t led_rainbow = {...};
mimi_tool_t led_flow = {...};
mimi_tool_t led_stop = {...};
mimi_tool_t led_brightness = {...};

// 新增颜色映射逻辑
if (strcmp(color, "white") == 0) { r=255,g=255,b=255; }
else if (strcmp(color, "yellow") == 0) { r=255,g=255,b=0; }
else if (strcmp(color, "cyan") == 0) { r=0,g=255,b=255; }
else if (strcmp(color, "magenta") == 0) { r=255,g=0,b=255; }