26浏览
查看: 26|回复: 0

[K10项目分享] 基于 ESP-IDF 和行空板 K10 的智能风扇与 LED 灯带控制系统

[复制链接]
本帖最后由 云天 于 2025-9-1 13:24 编辑

在当今的智能硬件时代,将物联网技术应用于日常生活中的设备控制,不仅可以提升生活的便利性,还能增添许多乐趣。本文将介绍如何使用 ESP-IDF 开发框架和行空板 K10 开发板,实现一个智能风扇和 LED 灯带控制系统。通过这个项目,你可以远程控制风扇的开关、速度调节,以及 LED 灯带的颜色和闪烁模式,打造一个个性化的智能环境。
基于 ESP-IDF 和行空板 K10 的智能风扇与 LED 灯带控制系统图6

【项目背景】
随着智能家居概念的普及,越来越多的家庭开始尝试将各种设备接入智能控制系统。行空板 K10 是一款功能强大的开发板,它集成了 ESP32 芯片,具备强大的网络连接能力和丰富的 GPIO 接口,非常适合用于开发智能硬件项目。ESP-IDF 是 ESP32 官方的开发框架,提供了底层硬件操作和网络通信的全面支持,能够帮助开发者高效地实现各种功能。
【硬件准备】
  • 行空板 K10:作为主控制器,负责运行程序和处理各种指令。
  • 电磁继电器模块:用于控制风扇的开关,连接到行空板的 P0 引脚。
  • LED 灯带:连接到行空板的 P1 引脚,用于实现各种灯光效果。
  • 风扇(微动开关):通过电磁继电器连接到行空板,实现远程控制。
  • 电源适配器:为风扇和 LED 灯带提供稳定的电源。
  • 连接线:用于连接各个模块。
基于 ESP-IDF 和行空板 K10 的智能风扇与 LED 灯带控制系统图7

【软件环境】
  • Visual Studio Code:一个轻量级但功能强大的代码编辑器,支持 ESP-IDF 开发。
  • ESP-IDF:ESP32 的官方开发框架,提供底层硬件操作和网络通信功能。
  • MCP Server:一个用于设备控制和通信的轻量级服务器框架,方便实现远程控制功能。
学习小智AI终端控制GPIO[简单教程],完成代码修改。
基于 ESP-IDF 和行空板 K10 的智能风扇与 LED 灯带控制系统图2


【功能实现风扇控制】
风扇的控制通过电磁继电器实现。我们定义了一个 lamp_light 类来封装风扇的控制逻辑。通过 MCP Server 提供的接口,可以远程获取风扇的运行状态、打开、关闭以及调节速度。
  • 获取风扇状态:通过 风扇.获取运行状态 接口,返回风扇的当前开/关状态。
  • 打开风扇:通过 风扇.打开 接口,控制电磁继电器闭合,启动风扇。
  • 关闭风扇:通过 风扇.关闭 接口,控制电磁继电器断开,停止风扇。
  • 提速一档:通过 风扇.提速一档 接口,模拟风扇速度调节功能。
新建文件“lamp_oc.h”:
  1. #include "mcp_server.h"
  2. #include <esp_log.h>
  3. #include "freertos/FreeRTOS.h"
  4. #include "freertos/task.h"
  5. #define TAG1 "风扇事件:"
  6. class lamp_light  {          // 1. 类名改成 lamp_light
  7. private:
  8.     bool power_ = false;
  9.     gpio_num_t gpio_num_;
  10.     int bs=0;
  11. public:
  12.     explicit lamp_light (gpio_num_t gpio_num) : gpio_num_(gpio_num) {
  13.         gpio_config_t cfg = {
  14.             .pin_bit_mask = (1ULL << gpio_num_),
  15.             .mode = GPIO_MODE_OUTPUT,
  16.             .pull_up_en = GPIO_PULLUP_DISABLE,
  17.             .pull_down_en = GPIO_PULLDOWN_DISABLE,
  18.             .intr_type = GPIO_INTR_DISABLE,
  19.         };
  20.         ESP_ERROR_CHECK(gpio_config(&cfg));
  21.         gpio_set_level(gpio_num_, 0);       //初始化为低电平
  22.         /* 2. 把 MCP 工具名改成风扇相关 */
  23.         
  24.         auto& server = McpServer::GetInstance();
  25.         server.AddTool("风扇.获取运行状态", "返回风扇的开/关状态",      // 工具名称   , 工具描述   
  26.                        PropertyList(), [this](const PropertyList&) {
  27.                            ESP_LOGW(TAG1, "获取到了风扇的当前状态,当前状态为%s", power_ ? "开" : "关");     //日志记录
  28.                            return power_ ? "{"运行状态:":风扇是开着的!}" : "{"运行状态:":风扇是关着的!}";       //返回状态
  29.                        
  30.                        });
  31.    
  32.         server.AddTool("风扇.打开", "打开风扇",     // 工具名称   , 工具描述
  33.                        PropertyList(), [this](const PropertyList&) {
  34.                         if(bs==0){
  35.                            power_ = true;
  36.                            gpio_set_level(gpio_num_, 1);    //设置为高电平
  37.                            // 等待0.2秒
  38.                            vTaskDelay(0.2 / portTICK_PERIOD_MS * 1000);
  39.                            gpio_set_level(gpio_num_, 0);    //设置为低电平
  40.                            bs=1;
  41.                            ESP_LOGW(TAG1, "已打开风扇!");   //日志记录
  42.                            return true;     //返回告诉小智执行成功!
  43.                         }
  44.                         else{
  45.                             return false;     //返回告诉小智执行不成功!
  46.                         }
  47.                        });
  48.         server.AddTool("风扇.关闭", "关闭风扇",     // 工具名称   , 工具描述
  49.                        PropertyList(), [this](const PropertyList&) {
  50.                         if(bs!=0){
  51.                             power_ = false;
  52.                             switch(bs){
  53.                             case 1:gpio_set_level(gpio_num_, 1);    //设置为高电平
  54.                                   // 等待0.2秒
  55.                                   vTaskDelay(0.2 / portTICK_PERIOD_MS * 1000);
  56.                                   gpio_set_level(gpio_num_, 0);    //设置为低电平
  57.                                   vTaskDelay(0.2 / portTICK_PERIOD_MS * 1000);
  58.                                   gpio_set_level(gpio_num_, 1);    //设置为高电平
  59.                                   // 等待0.2秒
  60.                                   vTaskDelay(0.2 / portTICK_PERIOD_MS * 1000);
  61.                                   gpio_set_level(gpio_num_, 0);    //设置为低电平
  62.                                   vTaskDelay(0.2 / portTICK_PERIOD_MS * 1000);
  63.                                   gpio_set_level(gpio_num_, 1);    //设置为高电平
  64.                                   // 等待0.2秒
  65.                                   vTaskDelay(0.2 / portTICK_PERIOD_MS * 1000);
  66.                                   gpio_set_level(gpio_num_, 0);    //设置为低电平
  67.                                   break;
  68.                             case 2:gpio_set_level(gpio_num_, 1);    //设置为高电平
  69.                                   // 等待0.2秒
  70.                                   vTaskDelay(0.2 / portTICK_PERIOD_MS * 1000);
  71.                                   gpio_set_level(gpio_num_, 0);    //设置为低电平
  72.                                   vTaskDelay(0.2 / portTICK_PERIOD_MS * 1000);
  73.                                   gpio_set_level(gpio_num_, 1);    //设置为高电平
  74.                                   // 等待0.2秒
  75.                                   vTaskDelay(0.2 / portTICK_PERIOD_MS * 1000);
  76.                                   gpio_set_level(gpio_num_, 0);    //设置为低电平
  77.                                   break;
  78.                             case 3:gpio_set_level(gpio_num_, 1);    //设置为高电平
  79.                                   // 等待0.2秒
  80.                                   vTaskDelay(0.2 / portTICK_PERIOD_MS * 1000);
  81.                                   gpio_set_level(gpio_num_, 0);    //设置为低电平
  82.                                   break;
  83.                            }
  84.                            bs=0;
  85.                            ESP_LOGW(TAG1, "已关闭风扇!");    //日志记录
  86.                            return true;     //返回告诉小智执行成功!
  87.                         }
  88.                         else{
  89.                             return false;     //返回告诉小智执行不成功!
  90.                         }
  91.                        });
  92.         server.AddTool("风扇.提速一档", "提速一档",     // 工具名称   , 工具描述
  93.                         PropertyList(), [this](const PropertyList&) {
  94.                             power_ = false;
  95.                         if(bs!=0 && bs!=3 ){
  96.                             gpio_set_level(gpio_num_, 1);    //设置为高电平
  97.                             // 等待0.2秒
  98.                             vTaskDelay(0.2 / portTICK_PERIOD_MS * 1000);
  99.                             gpio_set_level(gpio_num_, 0);    //设置为低电平
  100.                             ESP_LOGW(TAG1, "已提速一档!");    //日志记录
  101.                             bs++;
  102.                             return true;     //返回告诉小智执行成功!
  103.                         }
  104.                         else{
  105.                             return false;     //返回告诉小智执行不成功!  
  106.                         }
  107.                         });
  108.     }
  109. };
复制代码
基于 ESP-IDF 和行空板 K10 的智能风扇与 LED 灯带控制系统图5
【LED 灯带控制】
LED 灯带的控制通过 LedStripControl 类实现。该类提供了多种方法来控制灯带的亮度、颜色和闪烁模式。
  • 获取亮度:通过 LED灯带.获取亮度 接口,返回当前的亮度等级。
  • 设置亮度:通过 LED灯带.设置亮度 接口,调整灯带的亮度。
  • 设置单个灯颜色:通过 LED灯带.设置单个灯颜色 接口,控制灯带上某个特定位置的灯的颜色。
  • 设置所有灯颜色:通过 LED灯带.设置所有灯颜色 接口,统一设置灯带上所有灯的颜色。
  • 闪烁:通过 LED灯带.闪烁 接口,让灯带以指定的颜色和间隔闪烁。
  • 跑马灯:通过 LED灯带.跑马灯 接口,实现跑马灯效果。
  • 关闭灯带:通过 LED灯带.关闭 接口,关闭灯带。
修改“led_control.cc”文件内容:
  1. #include "led_control.h"
  2. #include "settings.h"
  3. #include "mcp_server.h"
  4. #include <esp_log.h>
  5. #define TAG2 "灯带事件:"
  6. int LedStripControl::LevelToBrightness(int level) const {
  7.     if (level < 0) level = 0;
  8.     if (level > 8) level = 8;
  9.     return (1 << level) - 1;  // 2^n - 1
  10. }
  11. StripColor LedStripControl::RGBToColor(int red, int green, int blue) {
  12.     return {static_cast<uint8_t>(red), static_cast<uint8_t>(green), static_cast<uint8_t>(blue)};
  13. }
  14. LedStripControl::LedStripControl(CircularStrip* led_strip_my)
  15.     : led_strip_(led_strip_my) {
  16.     // 从设置中读取亮度等级
  17.     Settings settings("led_strip_my");
  18.     brightness_level_ = settings.GetInt("brightness", 4);  // 默认等级4
  19.     led_strip_->SetBrightness(LevelToBrightness(brightness_level_), 4);
  20.     auto& mcp_server = McpServer::GetInstance();
  21.     mcp_server.AddTool("LED灯带.获取亮度",
  22.         "获取LED灯带的亮度(0-8)",
  23.         PropertyList(), [this](const PropertyList& properties) -> ReturnValue {
  24.             return brightness_level_;
  25.         });
  26.     mcp_server.AddTool("LED灯带.设置亮度",
  27.         "设置LED灯带的亮度(0-8)",
  28.         PropertyList({
  29.             Property("level", kPropertyTypeInteger, 0, 8)
  30.         }), [this](const PropertyList& properties) -> ReturnValue {
  31.             int level = properties["level"].value<int>();
  32.             ESP_LOGI(TAG2, "Set LedStrip brightness level to %d", level);
  33.             brightness_level_ = level;
  34.             led_strip_->SetBrightness(LevelToBrightness(brightness_level_), 4);
  35.             // 保存设置
  36.             Settings settings("led_strip_my", true);
  37.             settings.SetInt("brightness", brightness_level_);
  38.             return true;
  39.         });
  40.     mcp_server.AddTool("LED灯带.设置单个灯颜色",
  41.         "设置单个LED灯的颜色。",
  42.         PropertyList({
  43.             Property("index", kPropertyTypeInteger, 0, 23),
  44.             Property("red", kPropertyTypeInteger, 0, 255),
  45.             Property("green", kPropertyTypeInteger, 0, 255),
  46.             Property("blue", kPropertyTypeInteger, 0, 255)
  47.         }), [this](const PropertyList& properties) -> ReturnValue {
  48.             int index = properties["index"].value<int>();
  49.             int red = properties["red"].value<int>();
  50.             int green = properties["green"].value<int>();
  51.             int blue = properties["blue"].value<int>();
  52.             ESP_LOGI(TAG2, "Set led strip single color %d to %d, %d, %d",
  53.                 index, red, green, blue);
  54.             led_strip_->SetSingleColor(index, RGBToColor(red, green, blue));
  55.             return true;
  56.         });
  57.     mcp_server.AddTool("LED灯带.设置所有灯颜色",
  58.         "设置所有LED灯的颜色。",
  59.         PropertyList({
  60.             Property("red", kPropertyTypeInteger, 0, 255),
  61.             Property("green", kPropertyTypeInteger, 0, 255),
  62.             Property("blue", kPropertyTypeInteger, 0, 255)
  63.         }), [this](const PropertyList& properties) -> ReturnValue {
  64.             int red = properties["red"].value<int>();
  65.             int green = properties["green"].value<int>();
  66.             int blue = properties["blue"].value<int>();
  67.             ESP_LOGI(TAG2, "Set led strip all color to %d, %d, %d",
  68.                 red, green, blue);
  69.             led_strip_->SetAllColor(RGBToColor(red, green, blue));
  70.             return true;
  71.         });
  72.     mcp_server.AddTool("LED灯带.闪烁",
  73.         "让LED灯带闪烁。",
  74.         PropertyList({
  75.             Property("red", kPropertyTypeInteger, 0, 255),
  76.             Property("green", kPropertyTypeInteger, 0, 255),
  77.             Property("blue", kPropertyTypeInteger, 0, 255),
  78.             Property("interval", kPropertyTypeInteger, 0, 1000)
  79.         }), [this](const PropertyList& properties) -> ReturnValue {
  80.             int red = properties["red"].value<int>();
  81.             int green = properties["green"].value<int>();
  82.             int blue = properties["blue"].value<int>();
  83.             int interval = properties["interval"].value<int>();
  84.             ESP_LOGI(TAG2, "Blink led strip with color %d, %d, %d, interval %dms",
  85.                 red, green, blue, interval);
  86.             led_strip_->Blink(RGBToColor(red, green, blue), interval);
  87.             return true;
  88.         });
  89.     mcp_server.AddTool("LED灯带.跑马灯",
  90.         "让LED灯带跑马灯。",
  91.         PropertyList({
  92.             Property("red", kPropertyTypeInteger, 0, 255),
  93.             Property("green", kPropertyTypeInteger, 0, 255),
  94.             Property("blue", kPropertyTypeInteger, 0, 255),
  95.             Property("length", kPropertyTypeInteger, 1, 7),
  96.             Property("interval", kPropertyTypeInteger, 0, 1000)
  97.         }), [this](const PropertyList& properties) -> ReturnValue {
  98.             int red = properties["red"].value<int>();
  99.             int green = properties["green"].value<int>();
  100.             int blue = properties["blue"].value<int>();
  101.             int interval = properties["interval"].value<int>();
  102.             int length = properties["length"].value<int>();
  103.             ESP_LOGI(TAG2, "Scroll led strip with color %d, %d, %d, length %d, interval %dms",
  104.                 red, green, blue, length, interval);
  105.             StripColor low = RGBToColor(4, 4, 4);
  106.             StripColor high = RGBToColor(red, green, blue);
  107.             led_strip_->Scroll(low, high, length, interval);
  108.             return true;
  109.         });
  110.         mcp_server.AddTool("LED灯带.关闭",
  111.             "关闭LED灯带",
  112.             PropertyList(), [this](const PropertyList& properties) -> ReturnValue {
  113.                 ESP_LOGI(TAG2, "Turn off led strip");
  114.                 led_strip_->clear();  // 清除所有LED灯的颜色,即关闭灯光
  115.                 return true;
  116.             });
  117. }
复制代码
基于 ESP-IDF 和行空板 K10 的智能风扇与 LED 灯带控制系统图4
【注册设备
“df_k10_board.cc”——物联网初始化,添加对 AI 可见设备
  1. #include "lamp_oc.h"
  2.     // 物联网初始化,添加对 AI 可见设备
  3.     void InitializeIot() {
  4.         led_strip_ = new CircularStrip(GPIO_NUM_2, 24);
  5.         new LedStripControl(led_strip_);
  6.         static lamp_light lamp_light(GPIO_NUM_1);
  7.         
  8.     }
复制代码

基于 ESP-IDF 和行空板 K10 的智能风扇与 LED 灯带控制系统图3
行空板k10上的P0与P1引脚对应“GPIO_NUM_1”,与“GPIO_NUM_2”。参考https://img.dfrobot.com.cn/wikicn/5cabf4771804207b131ae8cb/36b61e6635492b977df87d55fe5dca4e.pdf
基于 ESP-IDF 和行空板 K10 的智能风扇与 LED 灯带控制系统图1
另:在led/circular_strip.cc中增加“关闭LED灯”函数。
  1. void CircularStrip::clear() {
  2.     std::lock_guard<std::mutex> lock(mutex_);
  3.     led_strip_clear(led_strip_);
  4.     led_strip_refresh(led_strip_);
  5. }
复制代码
【演示视频】

【项目总结】
通过这个项目,我们成功实现了基于 ESP-IDF 和行空板 K10 的智能风扇和 LED 灯带控制系统。通过简单的代码实现,你可以远程控制风扇的开关和速度调节,以及 LED 灯带的颜色和闪烁模式。这个项目不仅展示了 ESP-IDF 和行空板的强大功能,还为智能家居爱好者提供了一个有趣的实践案例。你可以根据自己的需求进一步扩展和优化这个项目,例如添加更多的传感器或实现更复杂的控制逻辑,让智能家居生活更加丰富多彩。希望这篇文章能够激发你的创造力,推动你探索更多有趣的智能硬件项目!








您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

为本项目制作心愿单
购买心愿单
心愿单 编辑
[[wsData.name]]

硬件清单

  • [[d.name]]
btnicon
我也要做!
点击进入购买页面
上海智位机器人股份有限公司 沪ICP备09038501号-4 备案 沪公网安备31011502402448

© 2013-2025 Comsenz Inc. Powered by Discuz! X3.4 Licensed

mail