Fix 3.5 KY-009: backlight GPIO27 and G on GPIO21.

Align cyd_35r with CYD_PROJECT_GUIDE (ST7796/GT911), export flashable firmware/cyd_35r.

Co-authored-by: Cursor <cursoragent@cursor.com>

firmware/README.md

@@ -1,14 +1,14 @@
 # 预编译固件
 
-目录：[`cyd/`](cyd/)
-
-板子：**CYD ESP32-2432S028R**（ILI9341）  
-功能：KY-009（R22 / G27 / B4）颜色切换 + PWM 亮度 + SoftSPI 触控 + LVGL
+| 目录 | 板子 |
+|------|------|
+| [`cyd/`](cyd/) | 2.8" ESP32-2432S028R（ILI9341）KY-009 R22/G27/B4 |
+| [`cyd_35r/`](cyd_35r/) | 3.5" ESP32-3248S035C（ST7796）KY-009 R22/G21/B4 |
 
 ## 刷写
 
 ```powershell
-cd firmware\cyd
+cd firmware\cyd        # 或 cyd_35r
 .\flash.ps1
 # 或 .\flash.ps1 -Port COM3
 ```
@@ -17,5 +17,6 @@ cd firmware\cyd
 
 ```powershell
 .\firmware\export_from_build.ps1
-.\firmware\export_from_build.ps1 -SkipBuild
+.\firmware\export_from_build.ps1 -Env cyd_35r
+.\firmware\export_from_build.ps1 -Env cyd_35r -SkipBuild
 ```

firmware/cyd_35r/VERSION.txt

@@ -0,0 +1,16 @@
+name: CYD smdky009ledtest (cyd_35r)
+git: 9f8d827
+date: 2026-10-25
+board: ESP32-3248S035 (ST7796)
+features: ST7796, GT911, BL27, KY009 R22/G21/B4
+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    0164D517555D2AE1C76A754564FE10B15BE72144230E611B0DA894108E6A199A
+  partitions.bin  148B959CBFF1C38AA8E1D5C0BA9D612C54997B945E56A63F41223EEF650653A1

firmware/cyd_35r/flash.bat

@@ -0,0 +1,5 @@
+@echo off
+setlocal
+cd /d "%~dp0"
+powershell -NoProfile -ExecutionPolicy Bypass -File "%~dp0flash.ps1" %*
+exit /b %ERRORLEVEL%

firmware/cyd_35r/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."

firmware/cyd_35r/media/preview.html

@@ -0,0 +1,55 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="utf-8" />
+<title>KY-009</title>
+<style>
+
+  *{box-sizing:border-box;margin:0;padding:0}
+  html,body{width:320px;height:240px;overflow:hidden;background:#000;margin:0}
+  .bezel{width:320px;height:240px;background:#1a1408}
+  .screen{width:320px;height:240px;background:#0A1016;color:#EAF0F6;font:12px/1.2 system-ui,sans-serif;position:relative;overflow:hidden}
+  .muted{color:#7A8B9C}.ok{color:#3DDC97}.bad{color:#E85D4C}.acc{color:#4FC3F7}.amber{color:#FFB74D}
+  .btn{border:0;border-radius:8px;background:#243140;color:#EAF0F6;font-weight:600}
+  .btn.acc{background:#1A4A6E}.btn.on{background:#1B5E4A}.btn.warn{background:#6B3A1E}
+
+
+  .t{position:absolute;left:0;right:0;top:4px;text-align:center;font-size:20px;font-weight:700}
+  .pin{position:absolute;left:0;right:0;top:32px;text-align:center}
+  .st{position:absolute;left:0;right:0;top:52px;text-align:center;font-size:18px;font-weight:700;color:#E85D4C}
+  .rgb{position:absolute;left:24px;right:24px;top:78px;display:flex;gap:8px}
+  .rgb .btn{flex:1;height:40px}
+  .rgb .r{background:#E85D4C}.rgb .g{background:#243140}.rgb .b{background:#243140}
+  .br{position:absolute;left:16px;top:134px}
+  .slider{position:absolute;left:110px;right:16px;top:138px;height:12px;border-radius:4px;background:#243140;overflow:hidden}
+  .slider>i{display:block;height:100%;width:60%;background:#E85D4C}
+  .act{position:absolute;left:24px;right:24px;bottom:10px;height:44px}
+
+
+/* CYD 3.5" full-bleed: non-uniform scale matches firmware UX()/UY(). */
+html,body{width:480px!important;height:320px!important;overflow:hidden!important;background:#000!important;margin:0!important;padding:0!important}
+.cyd35-scale{width:320px;height:240px;transform:scale(1.5,1.3333333333);transform-origin:0 0;overflow:hidden}
+</style>
+</head>
+<body>
+<div class="cyd35-scale">
+
+<div class="bezel"><div class="screen" id="s">
+
+  <div class="t">KY-009</div>
+  <div class="pin muted">R22 G27 B4</div>
+  <div class="st">RED ON</div>
+  <div class="rgb">
+    <button class="btn r" type="button">R</button>
+    <button class="btn g" type="button">G</button>
+    <button class="btn b" type="button">B</button>
+  </div>
+  <div class="br muted">Brightness 60%</div>
+  <div class="slider"><i></i></div>
+  <button class="btn on act" type="button">Turn OFF</button>
+
+</div></div>
+
+</div>
+</body>
+</html>

firmware/cyd_35r/meta.json

@@ -0,0 +1,7 @@
+{
+  "boardId": "esp32-3248s035",
+  "name": "CYD KY-009 (3.5\")",
+  "summary": "KY-009 RGB: R=GPIO22 G=GPIO21 B=GPIO4 on 3.5C (BL=27, GT911)",
+  "description": "ST7796 + GT911 + LVGL. Color switch R/G/B + brightness. G is GPIO21 (not 27 — 27 is backlight).",
+  "tags": ["ky009", "rgb", "led", "pwm", "touch", "lvgl", "3.5", "3248s035"]
+}

firmware/export_from_build.ps1

@@ -49,11 +49,17 @@ $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
+$feat = if ($Env -eq "cyd_35r") {
+  "features: ST7796, GT911, BL27, KY009 R22/G21/B4"
+} else {
+  "features: ILI9341, SoftSPI, BL21, KY009 R22/G27/B4"
+}
 $lines = @(
   "name: CYD smdky009ledtest ($dstName)",
   "git: $git",
   "date: $date",
   $boardLine,
+  $feat,
   "flash_size: 4MB",
   "offsets:",
   "  0x1000  bootloader.bin",
@@ -67,21 +73,5 @@ foreach ($h in $hashes) {
 }
 $lines | Set-Content -Encoding utf8 (Join-Path $dst "VERSION.txt")
 
-# Keep / refresh meta.json boardId for catalog filtering
-$metaPath = Join-Path $dst "meta.json"
-if (Test-Path $metaPath) {
-  try {
-    $meta = Get-Content $metaPath -Raw | ConvertFrom-Json
-    $meta.boardId = $boardIdHint
-    if ($Env -eq "cyd_35r" -and $meta.name -notmatch "3\.5") {
-      $meta.name = ($meta.name -replace "\s*$","") + " (3.5\")"
-    }
-    $meta | ConvertTo-Json -Depth 8 | Set-Content -Encoding utf8 $metaPath
-  } catch {
-    Write-Host "meta.json update skipped: $_"
-  }
-} elseif ($Env -eq "cyd_35r") {
-  Write-Host "Note: add firmware/cyd_35r/meta.json with boardId=$boardIdHint for the web catalog"
-}
 
 Write-Host "Exported -> $dst (env=$Env git=$git)"