Add KY-009 RGB LED test with SoftSPI touch and LVGL.

R/G/B color switch (GPIO22/27/4), PWM brightness, and flashable firmware/cyd package. Co-authored-by: Cursor <cursoragent@cursor.com>
2026-10-23 11:17:31 +08:00
commit 53c57f1cfd
23 changed files with 1958 additions and 0 deletions
--- a/.gitignore
+++ b/.gitignore
@@ -0,0 +1,13 @@
+.pio/
+.vscode/.browse.c_cpp.db*
+.vscode/c_cpp_properties.json
+.vscode/launch.json
+.vscode/ipch
+*.pyc
+__pycache__/
+.DS_Store
+Thumbs.db
+assets/
+*.elf
+# 构建目录里的 bin 不入库；firmware/ 预编译包要入库
+!firmware/**/*.bin
--- a/README.md
+++ b/README.md
@@ -0,0 +1,43 @@
+# KY-009 SMD LED（CYD）
+
+触控 + LVGL 参考 `hw269test` / `tftest`。一次只亮一路颜色，可切换 R/G/B + 调亮度。
+
+## 硬件
+
+| 项目 | 说明 |
+|------|------|
+| 板子 | CYD ESP32-2432S028R |
+| 模块 | KY-009 SMD RGB LED |
+| R | **GPIO22** |
+| G | **GPIO27** |
+| B | **GPIO4**（未接则蓝灯无输出） |
+
+接线：`R→GPIO22`，`G→GPIO27`，`B→GPIO4`，`GND→GND`（共阴）；若共阳需改 duty 极性。
+
+## 操作
+
+- **R / G / B** 按钮：切换当前颜色（其它路关断）
+- 滑条：当前颜色亮度 0–100%
+- 底部按钮：总开关
+
+## 构建 / 上传
+
+```bash
+pio run -e cyd -t upload
+```
+
+## 预编译固件
+
+随时可刷（无需编译）：
+
+```powershell
+cd firmware\cyd
+.\flash.ps1
+# 或 .\flash.ps1 -Port COM3
+```
+
+重新从构建导出：
+
+```powershell
+.\firmware\export_from_build.ps1
+```
--- a/copy_lv_conf.py
+++ b/copy_lv_conf.py
@@ -0,0 +1,13 @@
+Import("env")  # noqa: F821
+from pathlib import Path
+
+src = Path(env["PROJECT_DIR"]) / "include" / "lv_conf.h"  # noqa: F821
+dst_dir = Path(env["PROJECT_LIBDEPS_DIR"]) / env["PIOENV"]  # noqa: F821
+dst_dir.mkdir(parents=True, exist_ok=True)
+dst = dst_dir / "lv_conf.h"
+if src.exists():
+    dst.write_text(src.read_text(encoding="utf-8"), encoding="utf-8")
+    lvgl = dst_dir / "lvgl" / "lv_conf.h"
+    if (dst_dir / "lvgl").exists():
+        lvgl.write_text(src.read_text(encoding="utf-8"), encoding="utf-8")
+    print(f"copy_lv_conf: synced -> {dst}")
--- a/firmware/README.md
+++ b/firmware/README.md
@@ -0,0 +1,21 @@
+# 预编译固件
+
+目录：[`cyd/`](cyd/)
+
+板子：**CYD ESP32-2432S028R**（ILI9341）  
+功能：KY-009（R22 / G27 / B4）颜色切换 + PWM 亮度 + SoftSPI 触控 + LVGL
+
+## 刷写
+
+```powershell
+cd firmware\cyd
+.\flash.ps1
+# 或 .\flash.ps1 -Port COM3
+```
+
+## 重新打包
+
+```powershell
+.\firmware\export_from_build.ps1
+.\firmware\export_from_build.ps1 -SkipBuild
+```
--- a/firmware/cyd/VERSION.txt
+++ b/firmware/cyd/VERSION.txt
@@ -0,0 +1,16 @@
+name: CYD KY-009 (cyd)
+git: unknown
+date: 2026-10-23
+board: ESP32-2432S028R (ILI9341)
+features: SoftSPI touch, LVGL, KY-009 R=GPIO22 G=GPIO27 B=GPIO4 color switch + PWM
+flash_size: 4MB
+offsets:
+  0x1000  bootloader.bin
+  0x8000  partitions.bin
+  0xe000  boot_app0.bin
+  0x10000 firmware.bin
+sha256:
+  bootloader.bin  3D234A7471F67B013686DABD4DEE7C1FA915C9928463616A94BC9297ACF1ABF8
+  boot_app0.bin   F94C5D786A7A8FAB06AC5D10E33BF37711A6697636DC037559EA19CC410A17F0
+  firmware.bin    24E93839EC7783C79BF0198B573318ECD878FFB9BB1C4715F1B00E3B908F113B
+  partitions.bin  148B959CBFF1C38AA8E1D5C0BA9D612C54997B945E56A63F41223EEF650653A1
--- a/firmware/cyd/boot_app0.bin
+++ b/firmware/cyd/boot_app0.bin
--- a/firmware/cyd/bootloader.bin
+++ b/firmware/cyd/bootloader.bin
--- a/firmware/cyd/firmware.bin
+++ b/firmware/cyd/firmware.bin
--- a/firmware/cyd/flash.bat
+++ b/firmware/cyd/flash.bat
@@ -0,0 +1,5 @@
+@echo off
+setlocal
+cd /d "%~dp0"
+powershell -NoProfile -ExecutionPolicy Bypass -File "%~dp0flash.ps1" %*
+exit /b %ERRORLEVEL%
--- a/firmware/cyd/flash.ps1
+++ b/firmware/cyd/flash.ps1
@@ -0,0 +1,98 @@
+# Flash archived CYD KY-009 firmware (no rebuild needed)
+# Usage:
+#   .\flash.ps1
+#   .\flash.ps1 -Port COM5
+#   .\flash.ps1 -Port COM5 -Baud 460800
+
+param(
+  [string]$Port = "",
+  [int]$Baud = 921600
+)
+
+$ErrorActionPreference = "Stop"
+$here = Split-Path -Parent $MyInvocation.MyCommand.Path
+Set-Location $here
+
+function Find-Esptool {
+  $pio = Get-Command pio -ErrorAction SilentlyContinue
+  if (-not $pio) {
+    $pioPath = Join-Path $env:USERPROFILE "AppData\Local\Programs\Python\Python312\Scripts\pio.exe"
+    if (Test-Path $pioPath) {
+      $env:Path = "$(Split-Path $pioPath);$env:Path"
+      $pio = Get-Command pio -ErrorAction SilentlyContinue
+    }
+  }
+  if ($pio) {
+    $pkg = Join-Path $env:USERPROFILE ".platformio\packages\tool-esptoolpy\esptool.py"
+    if (Test-Path $pkg) { return @{ Kind = "py"; Path = $pkg } }
+  }
+  $py = Get-Command python -ErrorAction SilentlyContinue
+  if ($py) {
+    try {
+      & python -c "import esptool" 2>$null
+      if ($LASTEXITCODE -eq 0) { return @{ Kind = "mod"; Path = "esptool" } }
+    } catch {}
+  }
+  $esp = Get-Command esptool.py -ErrorAction SilentlyContinue
+  if ($esp) { return @{ Kind = "py"; Path = $esp.Source } }
+  return $null
+}
+
+if (-not $Port) {
+  $ports = @()
+  try {
+    Add-Type -AssemblyName System.IO.Ports -ErrorAction SilentlyContinue | Out-Null
+    $ports = [System.IO.Ports.SerialPort]::GetPortNames() | Sort-Object
+  } catch {}
+  if (-not $ports -or $ports.Count -eq 0) {
+    $ports = Get-CimInstance Win32_SerialPort -ErrorAction SilentlyContinue |
+      Select-Object -ExpandProperty DeviceID | Sort-Object
+  }
+  if (-not $ports -or $ports.Count -eq 0) {
+    Write-Error "No serial ports found. Plug in the CYD USB cable, then retry with -Port COMx"
+  }
+  if ($ports.Count -eq 1) {
+    $Port = $ports[0]
+  } else {
+    Write-Host "Available ports: $($ports -join ', ')"
+    $Port = $ports[-1]
+    Write-Host "Using last port: $Port (override with -Port)"
+  }
+}
+
+$tool = Find-Esptool
+if (-not $tool) {
+  Write-Error "esptool not found. Install PlatformIO (`pio`) or: pip install esptool"
+}
+
+$needed = @("bootloader.bin", "partitions.bin", "boot_app0.bin", "firmware.bin")
+foreach ($f in $needed) {
+  if (-not (Test-Path (Join-Path $here $f))) {
+    Write-Error "Missing $f â€?run ..\export_from_build.ps1 from repo root first"
+  }
+}
+
+$argsCommon = @(
+  "--chip", "esp32",
+  "--port", $Port,
+  "--baud", "$Baud",
+  "--before", "default_reset",
+  "--after", "hard_reset",
+  "write_flash", "-z",
+  "--flash_mode", "dio",
+  "--flash_freq", "40m",
+  "--flash_size", "4MB",
+  "0x1000", "bootloader.bin",
+  "0x8000", "partitions.bin",
+  "0xe000", "boot_app0.bin",
+  "0x10000", "firmware.bin"
+)
+
+Write-Host "Flashing $here -> $Port @ $Baud"
+if ($tool.Kind -eq "mod") {
+  & python -m esptool @argsCommon
+} else {
+  & python $tool.Path @argsCommon
+}
+if ($LASTEXITCODE -ne 0) { exit $LASTEXITCODE }
+Write-Host "Done. Open serial monitor at 115200 if needed."
--- a/firmware/cyd/meta.json
+++ b/firmware/cyd/meta.json
@@ -0,0 +1,7 @@
+{
+  "boardId": "esp32-2432s028",
+  "name": "CYD KY-009",
+  "summary": "KY-009 RGB LED: R=GPIO22 G=GPIO27 B=GPIO4, color switch + PWM brightness",
+  "description": "SoftSPI touch + LVGL. One color at a time (R/G/B buttons) + brightness slider + on/off.",
+  "tags": ["ky009", "rgb", "led", "pwm", "touch", "lvgl"]
+}
--- a/firmware/cyd/partitions.bin
+++ b/firmware/cyd/partitions.bin
--- a/firmware/export_from_build.ps1
+++ b/firmware/export_from_build.ps1
@@ -0,0 +1,57 @@
+# Rebuild (optional) and refresh firmware/cyd from PlatformIO build output.
+# Usage:
+#   .\firmware\export_from_build.ps1
+#   .\firmware\export_from_build.ps1 -SkipBuild
+
+param([switch]$SkipBuild)
+
+$ErrorActionPreference = "Stop"
+$root = Split-Path -Parent (Split-Path -Parent $MyInvocation.MyCommand.Path)
+Set-Location $root
+
+$env:Path = "C:\Users\dsx2016\AppData\Local\Programs\Python\Python312\Scripts;" + $env:Path
+
+if (-not $SkipBuild) {
+  pio run -e cyd
+  if ($LASTEXITCODE -ne 0) { exit $LASTEXITCODE }
+}
+
+$src = Join-Path $root ".pio\build\cyd"
+$dst = Join-Path $root "firmware\cyd"
+New-Item -ItemType Directory -Force -Path $dst | Out-Null
+
+foreach ($f in @("bootloader.bin", "partitions.bin", "firmware.bin")) {
+  $p = Join-Path $src $f
+  if (-not (Test-Path $p)) { Write-Error "Missing build artifact: $p" }
+  Copy-Item $p $dst -Force
+}
+
+$bootApp = Join-Path $env:USERPROFILE ".platformio\packages\framework-arduinoespressif32\tools\partitions\boot_app0.bin"
+if (-not (Test-Path $bootApp)) {
+  Write-Error "boot_app0.bin not found under PlatformIO packages"
+}
+Copy-Item $bootApp (Join-Path $dst "boot_app0.bin") -Force
+
+$git = ""
+try { $git = (git -C $root rev-parse --short HEAD).Trim() } catch { $git = "unknown" }
+$date = Get-Date -Format "yyyy-MM-dd"
+$hashes = Get-ChildItem (Join-Path $dst "*.bin") | Get-FileHash -Algorithm SHA256
+$lines = @(
+  "name: CYD KY-009 (cyd)",
+  "git: $git",
+  "date: $date",
+  "board: ESP32-2432S028R (ILI9341)",
+  "features: SoftSPI touch, LVGL, KY-009 R=GPIO22 G=GPIO27 B=GPIO4 color switch + PWM",
+  "flash_size: 4MB",
+  "offsets:",
+  "  0x1000  bootloader.bin",
+  "  0x8000  partitions.bin",
+  "  0xe000  boot_app0.bin",
+  "  0x10000 firmware.bin",
+  "sha256:"
+)
+foreach ($h in $hashes) {
+  $lines += ("  {0,-15} {1}" -f (Split-Path $h.Path -Leaf), $h.Hash)
+}
+$lines | Set-Content -Encoding utf8 (Join-Path $dst "VERSION.txt")
+Write-Host "Exported -> $dst (git $git)"
--- a/include/lamp.h
+++ b/include/lamp.h
@@ -0,0 +1,17 @@
+#pragma once
+
+#include <stdint.h>
+
+enum lamp_color_t : uint8_t {
+  LAMP_COLOR_R = 0,
+  LAMP_COLOR_G = 1,
+  LAMP_COLOR_B = 2,
+};
+
+void lamp_init();
+void lamp_set_on(bool on);
+bool lamp_is_on();
+void lamp_set_color(lamp_color_t c);
+lamp_color_t lamp_color();
+void lamp_set_brightness(uint8_t percent); // 0..100，只作用于当前颜色
+uint8_t lamp_brightness();
--- a/include/lv_conf.h
+++ b/include/lv_conf.h
--- a/include/pins.h
+++ b/include/pins.h
@@ -0,0 +1,21 @@
+#pragma once
+
+// CYD ESP32-2432S028R — 触控/屏脚与 tftest / hw269test 一致
+
+#define TFT_BL_PIN 21
+
+#define CYD_TOUCH_IRQ  36
+#define CYD_TOUCH_MOSI 32
+#define CYD_TOUCH_MISO 39
+#define CYD_TOUCH_CLK  25
+#define CYD_TOUCH_CS   33
+
+// KY-009 SMD RGB LED（26 留给喇叭，B 用 4）
+#define KY009_R_PIN 22  // R -> GPIO22
+#define KY009_G_PIN 27  // G -> GPIO27
+#define KY009_B_PIN 4   // B -> GPIO4
+
+#define SCREEN_WIDTH  240
+#define SCREEN_HEIGHT 320
+#define UI_HOR_RES    320
+#define UI_VER_RES    240
--- a/include/touch.h
+++ b/include/touch.h
@@ -0,0 +1,12 @@
+#pragma once
+
+#include <lvgl.h>
+#include <stdint.h>
+
+void touch_init();
+void touch_read_cb(lv_indev_t *indev, lv_indev_data_t *data);
+
+// 调试：最近一次触点（物理 / LVGL 旋转后逻辑）
+extern int16_t g_dbg_phys_x, g_dbg_phys_y;
+extern int16_t g_dbg_logic_x, g_dbg_logic_y;
+extern bool g_dbg_touch_down;
--- a/include/ui.h
+++ b/include/ui.h
@@ -0,0 +1,4 @@
+#pragma once
+
+void ui_create();
+void ui_refresh_lamp();
--- a/platformio.ini
+++ b/platformio.ini
@@ -0,0 +1,56 @@
+; CYD ESP32-2432S028 — KY-009 RGB LED (R=22, G=27, B=4) + SoftSPI 触控 + LVGL
+; 触控/屏配置参考 tftest / hw269test
+[env:cyd]
+platform = espressif32
+board = esp32dev
+framework = arduino
+monitor_speed = 460800
+upload_speed = 460800
+board_build.partitions = default.csv
+
+lib_deps =
+  bodmer/TFT_eSPI@^2.5.43
+  lvgl/lvgl@9.2.2
+
+build_flags =
+  -DCORE_DEBUG_LEVEL=0
+  -DUSER_SETUP_LOADED=1
+  -DILI9341_2_DRIVER=1
+  -DTFT_WIDTH=240
+  -DTFT_HEIGHT=320
+  -DTFT_MISO=12
+  -DTFT_MOSI=13
+  -DTFT_SCLK=14
+  -DTFT_CS=15
+  -DTFT_DC=2
+  -DTFT_RST=-1
+  -DTFT_BL=21
+  -DTFT_BACKLIGHT_ON=HIGH
+  -DTOUCH_CS=-1
+  -DLOAD_GLCD=1
+  -DLOAD_FONT2=1
+  -DLOAD_FONT4=1
+  -DLOAD_FONT6=1
+  -DLOAD_FONT7=1
+  -DLOAD_FONT8=1
+  -DLOAD_GFXFF=1
+  -DSMOOTH_FONT=1
+  -DSPI_FREQUENCY=40000000
+  -DSPI_READ_FREQUENCY=20000000
+  -DLV_CONF_SKIP
+  -DLV_COLOR_DEPTH=16
+  -DLV_MEM_SIZE=49152
+  -DLV_FONT_MONTSERRAT_14=1
+  -DLV_FONT_MONTSERRAT_16=1
+  -DLV_FONT_MONTSERRAT_18=1
+  -DLV_FONT_MONTSERRAT_20=1
+  -DLV_FONT_MONTSERRAT_28=1
+  -DLV_USE_TFT_ESPI=1
+  -DLV_USE_FLEX=1
+  -DLV_USE_BUTTON=1
+  -DLV_USE_LABEL=1
+  -DLV_USE_BAR=1
+  -DLV_USE_SLIDER=1
+  -I${PROJECT_DIR}/include
+
+extra_scripts = pre:copy_lv_conf.py
--- a/src/lamp.cpp
+++ b/src/lamp.cpp
@@ -0,0 +1,84 @@
+#include "lamp.h"
+#include "pins.h"
+
+#include <Arduino.h>
+
+static constexpr int LEDC_CH_R = 1;
+static constexpr int LEDC_CH_G = 2;
+static constexpr int LEDC_CH_B = 3;
+static constexpr int LEDC_FREQ = 5000;
+static constexpr int LEDC_RES = 8; // 0..255
+
+static bool g_on = true;
+static lamp_color_t g_color = LAMP_COLOR_R;
+static uint8_t g_pct[3] = {60, 60, 60}; // R/G/B 各自记住亮度
+
+static uint8_t duty_from_pct(uint8_t pct) {
+  if (pct > 100) {
+    pct = 100;
+  }
+  return (uint8_t)((pct * 255U) / 100U);
+}
+
+static void apply() {
+  uint8_t dr = 0, dg = 0, db = 0;
+  if (g_on) {
+    const uint8_t d = duty_from_pct(g_pct[g_color]);
+    if (g_color == LAMP_COLOR_R) {
+      dr = d;
+    } else if (g_color == LAMP_COLOR_G) {
+      dg = d;
+    } else {
+      db = d;
+    }
+  }
+  ledcWrite(LEDC_CH_R, dr);
+  ledcWrite(LEDC_CH_G, dg);
+  ledcWrite(LEDC_CH_B, db);
+}
+
+void lamp_init() {
+  ledcSetup(LEDC_CH_R, LEDC_FREQ, LEDC_RES);
+  ledcSetup(LEDC_CH_G, LEDC_FREQ, LEDC_RES);
+  ledcSetup(LEDC_CH_B, LEDC_FREQ, LEDC_RES);
+  ledcAttachPin(KY009_R_PIN, LEDC_CH_R);
+  ledcAttachPin(KY009_G_PIN, LEDC_CH_G);
+  ledcAttachPin(KY009_B_PIN, LEDC_CH_B);
+  g_on = true;
+  g_color = LAMP_COLOR_R;
+  g_pct[0] = g_pct[1] = g_pct[2] = 60;
+  apply();
+  Serial.printf("KY-009 R=%d G=%d B=%d mode=R %u%%\n", KY009_R_PIN, KY009_G_PIN,
+                KY009_B_PIN, (unsigned)g_pct[g_color]);
+}
+
+void lamp_set_on(bool on) {
+  g_on = on;
+  apply();
+  Serial.printf("Lamp %s\n", g_on ? "ON" : "OFF");
+}
+
+bool lamp_is_on() { return g_on; }
+
+void lamp_set_color(lamp_color_t c) {
+  if (c > LAMP_COLOR_B) {
+    c = LAMP_COLOR_R;
+  }
+  g_color = c;
+  apply();
+  static const char *names[] = {"R", "G", "B"};
+  Serial.printf("Color %s %u%%\n", names[g_color], (unsigned)g_pct[g_color]);
+}
+
+lamp_color_t lamp_color() { return g_color; }
+
+void lamp_set_brightness(uint8_t percent) {
+  if (percent > 100) {
+    percent = 100;
+  }
+  g_pct[g_color] = percent;
+  apply();
+  Serial.printf("Bright %u%%\n", (unsigned)g_pct[g_color]);
+}
+
+uint8_t lamp_brightness() { return g_pct[g_color]; }
--- a/src/main.cpp
+++ b/src/main.cpp
@@ -0,0 +1,46 @@
+#include <Arduino.h>
+#include <lvgl.h>
+
+#include "lamp.h"
+#include "pins.h"
+#include "touch.h"
+#include "ui.h"
+
+static constexpr uint32_t DRAW_BUF_SIZE =
+    (SCREEN_WIDTH * SCREEN_HEIGHT / 10 * (LV_COLOR_DEPTH / 8));
+static uint32_t draw_buf[DRAW_BUF_SIZE / 4];
+
+void setup() {
+  Serial.begin(460800);
+  delay(200);
+  Serial.println();
+  Serial.printf("LVGL %d.%d.%d | KY-009 R=%d G=%d B=%d\n", lv_version_major(),
+                lv_version_minor(), lv_version_patch(), KY009_R_PIN, KY009_G_PIN,
+                KY009_B_PIN);
+  Serial.println("BOOT_OK");
+
+  pinMode(TFT_BL_PIN, OUTPUT);
+  digitalWrite(TFT_BL_PIN, HIGH);
+
+  touch_init();
+  lamp_init();
+
+  lv_init();
+
+  lv_display_t *disp =
+      lv_tft_espi_create(SCREEN_WIDTH, SCREEN_HEIGHT, draw_buf, sizeof(draw_buf));
+  lv_display_set_rotation(disp, LV_DISPLAY_ROTATION_270);
+
+  lv_indev_t *indev = lv_indev_create();
+  lv_indev_set_type(indev, LV_INDEV_TYPE_POINTER);
+  lv_indev_set_read_cb(indev, touch_read_cb);
+  lv_indev_set_display(indev, disp);
+
+  ui_create();
+}
+
+void loop() {
+  lv_timer_handler();
+  lv_tick_inc(5);
+  delay(5);
+}
--- a/src/touch.cpp
+++ b/src/touch.cpp
@@ -0,0 +1,125 @@
+#include "touch.h"
+#include "pins.h"
+
+#include <Arduino.h>
+
+/**
+ * SoftSPI XPT2046
+ * BL↔TR 是矩形主对角线镜像（XY 对调），不是 180°（180° 会搞成 TL↔BR）。
+ * 先按 rot2 得到旧 UI，再做对角修正，反变换喂给 LVGL 270。
+ */
+
+int16_t g_dbg_phys_x = -1;
+int16_t g_dbg_phys_y = -1;
+int16_t g_dbg_logic_x = -1;
+int16_t g_dbg_logic_y = -1;
+bool g_dbg_touch_down = false;
+
+static void soft_write(uint8_t data) {
+  for (int i = 7; i >= 0; --i) {
+    digitalWrite(CYD_TOUCH_MOSI, (data >> i) & 1);
+    digitalWrite(CYD_TOUCH_CLK, HIGH);
+    delayMicroseconds(2);
+    digitalWrite(CYD_TOUCH_CLK, LOW);
+    delayMicroseconds(2);
+  }
+}
+
+static uint16_t soft_read12() {
+  uint16_t v = 0;
+  digitalWrite(CYD_TOUCH_CLK, HIGH);
+  delayMicroseconds(2);
+  digitalWrite(CYD_TOUCH_CLK, LOW);
+  delayMicroseconds(2);
+  for (int i = 0; i < 12; ++i) {
+    digitalWrite(CYD_TOUCH_CLK, HIGH);
+    delayMicroseconds(2);
+    v = (uint16_t)((v << 1) | (digitalRead(CYD_TOUCH_MISO) ? 1u : 0u));
+    digitalWrite(CYD_TOUCH_CLK, LOW);
+    delayMicroseconds(2);
+  }
+  return v;
+}
+
+static uint16_t xpt_read(uint8_t cmd) {
+  digitalWrite(CYD_TOUCH_CS, LOW);
+  soft_write(cmd);
+  uint16_t v = soft_read12();
+  digitalWrite(CYD_TOUCH_CS, HIGH);
+  return v;
+}
+
+static int16_t clampi(int32_t v, int32_t lo, int32_t hi) {
+  if (v < lo) {
+    return (int16_t)lo;
+  }
+  if (v > hi) {
+    return (int16_t)hi;
+  }
+  return (int16_t)v;
+}
+
+void touch_init() {
+  pinMode(CYD_TOUCH_CS, OUTPUT);
+  pinMode(CYD_TOUCH_CLK, OUTPUT);
+  pinMode(CYD_TOUCH_MOSI, OUTPUT);
+  pinMode(CYD_TOUCH_MISO, INPUT);
+  pinMode(CYD_TOUCH_IRQ, INPUT);
+  digitalWrite(CYD_TOUCH_CS, HIGH);
+  digitalWrite(CYD_TOUCH_CLK, LOW);
+  Serial.println("Touch: SoftSPI + diagonal fix (BL/TR)");
+}
+
+void touch_read_cb(lv_indev_t * /*indev*/, lv_indev_data_t *data) {
+  uint16_t adc_x = xpt_read(0x90);
+  uint16_t adc_y = xpt_read(0xD0);
+  adc_x = (uint16_t)((adc_x + xpt_read(0x90)) / 2);
+  adc_y = (uint16_t)((adc_y + xpt_read(0xD0)) / 2);
+
+  const bool irq = (digitalRead(CYD_TOUCH_IRQ) == LOW);
+  const bool in_range =
+      (adc_x > 80 && adc_x < 4000 && adc_y > 80 && adc_y < 4000);
+
+  if (!in_range || (!irq && (adc_x < 200 || adc_y < 200))) {
+    data->state = LV_INDEV_STATE_RELEASED;
+    g_dbg_touch_down = false;
+    return;
+  }
+
+  const int16_t p_x = (int16_t)adc_x;
+  const int16_t p_y = (int16_t)(4095 - adc_y);
+
+  int16_t x = map(p_x, 200, 3700, 1, SCREEN_WIDTH);
+  int16_t y = map(p_y, 240, 3800, 1, SCREEN_HEIGHT);
+  x = clampi(x, 0, SCREEN_WIDTH - 1);
+  y = clampi(y, 0, SCREEN_HEIGHT - 1);
+
+  // 旧 UI（LVGL270）：(y, 239-x) — 该空间里 BL↔TR，做主对角线镜像
+  // (ux,uy) -> (uy*(319/239), ux*(239/319))
+  const int32_t old_ux = y;
+  const int32_t old_uy = (SCREEN_WIDTH - 1) - x;
+  int16_t ui_x = clampi((old_uy * (UI_HOR_RES - 1)) / (UI_VER_RES - 1), 0,
+                        UI_HOR_RES - 1);
+  int16_t ui_y = clampi((old_ux * (UI_VER_RES - 1)) / (UI_HOR_RES - 1), 0,
+                        UI_VER_RES - 1);
+
+  // 反变换喂 LVGL，使最终落在 (ui_x, ui_y)
+  const int16_t feed_x = (int16_t)((SCREEN_WIDTH - 1) - ui_y);
+  const int16_t feed_y = ui_x;
+
+  g_dbg_phys_x = x;
+  g_dbg_phys_y = y;
+  g_dbg_logic_x = ui_x;
+  g_dbg_logic_y = ui_y;
+  g_dbg_touch_down = true;
+
+  static uint32_t last_log = 0;
+  if (millis() - last_log > 80) {
+    last_log = millis();
+    Serial.printf("Touch UI(%d,%d)\n", ui_x, ui_y);
+  }
+
+  data->point.x = feed_x;
+  data->point.y = feed_y;
+  data->state = LV_INDEV_STATE_PRESSED;
+}
--- a/src/ui.cpp
+++ b/src/ui.cpp
@@ -0,0 +1,193 @@
+#include "ui.h"
+#include "lamp.h"
+#include "pins.h"
+
+#include <Arduino.h>
+#include <lvgl.h>
+#include <stdio.h>
+
+static constexpr uint32_t COL_BG = 0x0A1016;
+static constexpr uint32_t COL_INK = 0xEAF0F6;
+static constexpr uint32_t COL_MUTED = 0x7A8B9C;
+static constexpr uint32_t COL_BTN = 0x243140;
+static constexpr uint32_t COL_ON = 0x1B5E4A;
+static constexpr uint32_t COL_R = 0xE85D4C;
+static constexpr uint32_t COL_G = 0x3DDC97;
+static constexpr uint32_t COL_B = 0x4FC3F7;
+
+static lv_obj_t *lbl_state;
+static lv_obj_t *lbl_bright;
+static lv_obj_t *slider;
+static lv_obj_t *btn_r;
+static lv_obj_t *btn_g;
+static lv_obj_t *btn_b;
+static lv_obj_t *lbl_r;
+static lv_obj_t *lbl_g;
+static lv_obj_t *lbl_b;
+static lv_obj_t *btn_light;
+static lv_obj_t *lbl_light;
+
+static void style_btn(lv_obj_t *btn, uint32_t bg) {
+  lv_obj_set_style_radius(btn, 10, 0);
+  lv_obj_set_style_bg_color(btn, lv_color_hex(bg), 0);
+  lv_obj_set_style_bg_opa(btn, LV_OPA_COVER, 0);
+  lv_obj_set_style_shadow_width(btn, 0, 0);
+  lv_obj_set_style_border_width(btn, 0, 0);
+  lv_obj_set_style_pad_all(btn, 0, 0);
+}
+
+static uint32_t accent_for(lamp_color_t c) {
+  if (c == LAMP_COLOR_R) {
+    return COL_R;
+  }
+  if (c == LAMP_COLOR_G) {
+    return COL_G;
+  }
+  return COL_B;
+}
+
+void ui_refresh_lamp() {
+  const bool on = lamp_is_on();
+  const lamp_color_t c = lamp_color();
+  const uint8_t pct = lamp_brightness();
+  const uint32_t accent = accent_for(c);
+
+  if (lbl_state) {
+    static const char *names[] = {"RED", "GREEN", "BLUE"};
+    lv_label_set_text_fmt(lbl_state, "%s %s", names[c], on ? "ON" : "OFF");
+    lv_obj_set_style_text_color(lbl_state, lv_color_hex(on ? accent : 0xE85D4C),
+                                0);
+  }
+  if (lbl_bright) {
+    lv_label_set_text_fmt(lbl_bright, "Brightness %u%%", (unsigned)pct);
+  }
+  if (slider) {
+    lv_slider_set_value(slider, pct, LV_ANIM_OFF);
+    lv_obj_set_style_bg_color(slider, lv_color_hex(accent), LV_PART_INDICATOR);
+    lv_obj_set_style_bg_opa(slider, on ? LV_OPA_COVER : LV_OPA_50, LV_PART_MAIN);
+  }
+
+  style_btn(btn_r, c == LAMP_COLOR_R ? COL_R : COL_BTN);
+  style_btn(btn_g, c == LAMP_COLOR_G ? COL_G : COL_BTN);
+  style_btn(btn_b, c == LAMP_COLOR_B ? COL_B : COL_BTN);
+
+  if (lbl_light) {
+    lv_label_set_text(lbl_light, on ? "Turn OFF" : "Turn ON");
+  }
+  if (btn_light) {
+    style_btn(btn_light, on ? COL_ON : COL_BTN);
+  }
+}
+
+static void on_light(lv_event_t *e) {
+  if (lv_event_get_code(e) != LV_EVENT_CLICKED) {
+    return;
+  }
+  lamp_set_on(!lamp_is_on());
+  ui_refresh_lamp();
+}
+
+static void on_color(lv_event_t *e) {
+  if (lv_event_get_code(e) != LV_EVENT_CLICKED) {
+    return;
+  }
+  const lamp_color_t c =
+      (lamp_color_t)(uintptr_t)lv_event_get_user_data(e);
+  lamp_set_color(c);
+  if (!lamp_is_on()) {
+    lamp_set_on(true);
+  }
+  ui_refresh_lamp();
+}
+
+static void on_slider(lv_event_t *e) {
+  const lv_event_code_t code = lv_event_get_code(e);
+  if (code != LV_EVENT_VALUE_CHANGED && code != LV_EVENT_RELEASED) {
+    return;
+  }
+  lv_obj_t *obj = (lv_obj_t *)lv_event_get_target(e);
+  const int32_t v = lv_slider_get_value(obj);
+  lamp_set_brightness((uint8_t)v);
+  if (!lamp_is_on() && v > 0) {
+    lamp_set_on(true);
+  }
+  ui_refresh_lamp();
+}
+
+static lv_obj_t *make_color_btn(lv_obj_t *scr, const char *txt, int x,
+                                lamp_color_t c, lv_obj_t **out_lbl) {
+  lv_obj_t *btn = lv_button_create(scr);
+  lv_obj_set_size(btn, 88, 40);
+  lv_obj_align(btn, LV_ALIGN_TOP_LEFT, x, 72);
+  style_btn(btn, COL_BTN);
+  lv_obj_add_event_cb(btn, on_color, LV_EVENT_CLICKED, (void *)(uintptr_t)c);
+  lv_obj_t *lbl = lv_label_create(btn);
+  lv_label_set_text(lbl, txt);
+  lv_obj_set_style_text_color(lbl, lv_color_hex(COL_INK), 0);
+  lv_obj_set_style_text_font(lbl, &lv_font_montserrat_18, 0);
+  lv_obj_center(lbl);
+  if (out_lbl) {
+    *out_lbl = lbl;
+  }
+  return btn;
+}
+
+void ui_create() {
+  lv_obj_t *scr = lv_screen_active();
+  lv_obj_set_style_bg_color(scr, lv_color_hex(COL_BG), 0);
+  lv_obj_set_style_bg_opa(scr, LV_OPA_COVER, 0);
+
+  lv_obj_t *lbl_title = lv_label_create(scr);
+  lv_label_set_text(lbl_title, "KY-009");
+  lv_obj_set_style_text_color(lbl_title, lv_color_hex(COL_INK), 0);
+  lv_obj_set_style_text_font(lbl_title, &lv_font_montserrat_20, 0);
+  lv_obj_align(lbl_title, LV_ALIGN_TOP_MID, 0, 4);
+
+  lv_obj_t *lbl_pin = lv_label_create(scr);
+  lv_label_set_text_fmt(lbl_pin, "R%d G%d B%d", KY009_R_PIN, KY009_G_PIN,
+                        KY009_B_PIN);
+  lv_obj_set_style_text_color(lbl_pin, lv_color_hex(COL_MUTED), 0);
+  lv_obj_set_style_text_font(lbl_pin, &lv_font_montserrat_14, 0);
+  lv_obj_align(lbl_pin, LV_ALIGN_TOP_MID, 0, 28);
+
+  lbl_state = lv_label_create(scr);
+  lv_label_set_text(lbl_state, "RED ON");
+  lv_obj_set_style_text_color(lbl_state, lv_color_hex(COL_R), 0);
+  lv_obj_set_style_text_font(lbl_state, &lv_font_montserrat_16, 0);
+  lv_obj_align(lbl_state, LV_ALIGN_TOP_MID, 0, 48);
+
+  btn_r = make_color_btn(scr, "R", 24, LAMP_COLOR_R, &lbl_r);
+  btn_g = make_color_btn(scr, "G", 116, LAMP_COLOR_G, &lbl_g);
+  btn_b = make_color_btn(scr, "B", 208, LAMP_COLOR_B, &lbl_b);
+
+  lbl_bright = lv_label_create(scr);
+  lv_label_set_text(lbl_bright, "Brightness 60%");
+  lv_obj_set_style_text_color(lbl_bright, lv_color_hex(COL_INK), 0);
+  lv_obj_set_style_text_font(lbl_bright, &lv_font_montserrat_16, 0);
+  lv_obj_align(lbl_bright, LV_ALIGN_TOP_MID, 0, 124);
+
+  slider = lv_slider_create(scr);
+  lv_obj_set_size(slider, UI_HOR_RES - 48, 28);
+  lv_slider_set_range(slider, 0, 100);
+  lv_slider_set_value(slider, 60, LV_ANIM_OFF);
+  lv_obj_align(slider, LV_ALIGN_TOP_MID, 0, 150);
+  lv_obj_set_style_bg_color(slider, lv_color_hex(COL_BTN), LV_PART_MAIN);
+  lv_obj_set_style_bg_color(slider, lv_color_hex(COL_R), LV_PART_INDICATOR);
+  lv_obj_set_style_bg_color(slider, lv_color_hex(COL_INK), LV_PART_KNOB);
+  lv_obj_set_ext_click_area(slider, 12);
+  lv_obj_add_event_cb(slider, on_slider, LV_EVENT_VALUE_CHANGED, nullptr);
+  lv_obj_add_event_cb(slider, on_slider, LV_EVENT_RELEASED, nullptr);
+
+  btn_light = lv_button_create(scr);
+  lv_obj_set_size(btn_light, UI_HOR_RES - 48, 44);
+  lv_obj_align(btn_light, LV_ALIGN_TOP_MID, 0, 190);
+  style_btn(btn_light, COL_ON);
+  lv_obj_add_event_cb(btn_light, on_light, LV_EVENT_CLICKED, nullptr);
+  lbl_light = lv_label_create(btn_light);
+  lv_label_set_text(lbl_light, "Turn OFF");
+  lv_obj_set_style_text_color(lbl_light, lv_color_hex(COL_INK), 0);
+  lv_obj_set_style_text_font(lbl_light, &lv_font_montserrat_18, 0);
+  lv_obj_center(lbl_light);
+
+  ui_refresh_lamp();
+}