cyd-stream-deck

CYD StreamDeck

这是一个基于 ESP32-Cheap-Yellow-Display 的 StreamDeck 控制器，可以通过蓝牙控制电脑的媒体播放和音量。它完美适合需要快速控制媒体播放的场景。

🌐 语言选项

• English
• 繁體中文
• 简体中文
• 粵語
• Bahasa Melayu

---

🌟 核心功能

📟 1. 显示界面

📌 主页面：

• 播放控制：上一首、播放/暂停、下一首
• 音量控制：音量增加、音量减少
• 设置按钮：进入设置页面

📌 设置页面：

• 亮度调节：可调整屏幕亮度
• 蓝牙配对：配对/取消配对按钮
• 连接状态：显示当前蓝牙连接状态

---

📡 2. 硬件规格

• 显示器：320x240 TFT 触摸屏
• 触摸：XPT2046 触摸芯片
• 通讯：ESP32 蓝牙键盘功能
• 按钮：6 个虚拟按钮，支持触摸反馈

---

🔔 3. 媒体控制功能

• 播放控制：
  • 播放/暂停
  • 上一首
  • 下一首
• 音量控制：
  • 音量增加
  • 音量减少

---

⚙ 4. 自动化功能

• 自动亮度记忆：记住上次设定的亮度
• 自动重连：蓝牙断开时自动尝试重连
• 触摸反馈：按钮点击时有视觉反馈

---

🚨 5. 错误处理

• 蓝牙连接监控：断开时显示 “Disconnected”
• 触摸防抖：防止误触和重复触发

---

⚙ 配置说明 (PlatformIO)

本项目使用 PlatformIO 构建，支持多种硬件配置。您可以根据屏幕类型选择不同的环境（env）进行编译：

• cyd：适用于 ILI9341 屏幕（仅有 microUSB 接口）
• cyd2usb：适用于 ST7789 屏幕（有 USB-C 和 microUSB 接口），支持 RGB 反转和 BGR 色彩顺序调整

此外，platformio.ini 配置文件包含以下可自定义选项：

• 屏幕亮度
• TODO: 触摸灵敏度
• TODO: 按钮布局

---

📝 使用说明

1. 编译并上传程序到 ESP32
2. 首次使用时，进入设置页面进行蓝牙配对
3. 配对成功后，即可使用所有媒体控制功能
4. 可随时调整亮度或重新配对

---

🔧 开发者说明

• 使用 Arduino 框架开发
• 主要依赖库：
  • TFT_eSPI：屏幕驱动
  • XPT2046_Touchscreen：触摸驱动
  • ESP32 BLE Keyboard：蓝牙键盘功能