Add HW-069 v1.1 4-digit TM1637 test with SoftSPI touch and LVGL.

CLK on GPIO22, DIO on GPIO27; value/brightness/colon controls and flashable firmware/cyd package. Co-authored-by: Cursor <cursoragent@cursor.com>
2026-10-23 14:08:51 +08:00
commit 9576c5f7d2
23 changed files with 2091 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,49 @@
+# HW-069 四位数显（CYD）
+
+触控 + LVGL 参考 `tftest` / `hw269test`。HW-069 v1.1（TM1637）两线驱动：调数值、亮度、冒号、开关。
+
+## 硬件
+
+| 项目 | 说明 |
+|------|------|
+| 板子 | CYD ESP32-2432S028R |
+| 模块 | HW-069 v1.1 四位 0.36" 数码管（TM1637） |
+| CLK | **GPIO22** |
+| DIO | **GPIO27** |
+
+接线：
+
+| HW-069 | CYD |
+|--------|-----|
+| VCC | 3.3V 或 5V |
+| GND | GND |
+| CLK | GPIO22 |
+| DIO | GPIO27 |
+
+## 操作
+
+- 大字：当前显示值（冒号开时显示 `mm:ss` 样式）
+- **-100 / -1 / +1 / +100**：改数值（0–9999）
+- 滑条：亮度 0–100%（映射 TM1637 8 档）
+- **Colon**：中间冒号开关
+- **Display ON/OFF**：熄灭 / 点亮数显
+
+## 构建 / 烧录
+
+```powershell
+pio run -e cyd -t upload
+```
+
+## 预编译固件
+
+```powershell
+cd firmware\cyd
+.\flash.ps1
+# 或 .\flash.ps1 -Port COMx
+```
+
+重新导出：
+
+```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）  
+功能：HW-069 v1.1 四位数显（CLK=GPIO22，DIO=GPIO27，TM1637）+ 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 HW069 Digit Display (cyd)
+git: unknown
+date: 2026-10-23
+board: ESP32-2432S028R (ILI9341)
+features: SoftSPI touch, LVGL, HW069 TM1637 CLK=GPIO22 DIO=GPIO27
+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    C6E7F78925D0BC248734601D6AC8D8A0F1712798857162A1A8A047E5C710A6E9
+  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 TF+Speaker 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 HW-069 Digit Display",
+  "summary": "HW-069 v1.1 TM1637 4-digit: CLK GPIO22, DIO GPIO27 — value / brightness / colon / on-off",
+  "description": "SoftSPI touch + LVGL. HW-069 4-digit 7-segment (TM1637) on CLK=22 DIO=27.",
+  "tags": ["hw069", "tm1637", "digit", "display", "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 HW069 Digit Display (cyd)",
+  "git: $git",
+  "date: $date",
+  "board: ESP32-2432S028R (ILI9341)",
+  "features: SoftSPI touch, LVGL, HW069 TM1637 CLK=GPIO22 DIO=GPIO27",
+  "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/digit.h
+++ b/include/digit.h
@@ -0,0 +1,21 @@
+#pragma once
+
+#include <stdint.h>
+
+void digit_init();
+
+void digit_set_on(bool on);
+bool digit_is_on();
+
+/** 显示数值 0..9999（超出钳位） */
+void digit_set_value(int value);
+int digit_get_value();
+
+/** 亮度 0..100，映射到 TM1637 8 档 */
+void digit_set_brightness(uint8_t percent);
+uint8_t digit_brightness();
+
+void digit_set_colon(bool on);
+bool digit_colon();
+
+void digit_clear();
--- a/include/lv_conf.h
+++ b/include/lv_conf.h
--- a/include/pins.h
+++ b/include/pins.h
@@ -0,0 +1,20 @@
+#pragma once
+
+// CYD ESP32-2432S028R — 触控/屏脚与 tftest 一致
+// HW-069 v1.1 四位数显（TM1637）：CLK=GPIO22，DIO=GPIO27
+
+#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
+
+#define HW069_CLK_PIN 22
+#define HW069_DIO_PIN 27
+
+#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_digit();
--- a/platformio.ini
+++ b/platformio.ini
@@ -0,0 +1,56 @@
+; CYD ESP32-2432S028 — HW069 四位数显(CLK22/DIO27) + 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/digit.cpp
+++ b/src/digit.cpp
@@ -0,0 +1,178 @@
+#include "digit.h"
+#include "pins.h"
+
+#include <Arduino.h>
+
+// HW-069 v1.1：TM1637 两线协议（非 I2C）
+static constexpr uint8_t CMD_DATA_AUTO = 0x40;
+static constexpr uint8_t CMD_ADDR_BASE = 0xC0;
+static constexpr uint8_t CMD_DISP_OFF = 0x80;
+static constexpr uint8_t CMD_DISP_ON = 0x88; // | brightness 0..7
+
+static const uint8_t SEG_DIGIT[10] = {
+    0x3F, 0x06, 0x5B, 0x4F, 0x66, 0x6D, 0x7D, 0x07, 0x7F, 0x6F,
+};
+
+static bool g_on = true;
+static bool g_colon = false;
+static uint8_t g_pct = 60;
+static int g_value = 1234;
+static uint8_t g_raw[4] = {0, 0, 0, 0};
+
+static void bit_delay() { delayMicroseconds(50); }
+
+static void start() {
+  digitalWrite(HW069_DIO_PIN, HIGH);
+  digitalWrite(HW069_CLK_PIN, HIGH);
+  bit_delay();
+  digitalWrite(HW069_DIO_PIN, LOW);
+  bit_delay();
+  digitalWrite(HW069_CLK_PIN, LOW);
+  bit_delay();
+}
+
+static void stop() {
+  digitalWrite(HW069_CLK_PIN, LOW);
+  digitalWrite(HW069_DIO_PIN, LOW);
+  bit_delay();
+  digitalWrite(HW069_CLK_PIN, HIGH);
+  bit_delay();
+  digitalWrite(HW069_DIO_PIN, HIGH);
+  bit_delay();
+}
+
+static void write_byte(uint8_t b) {
+  for (uint8_t i = 0; i < 8; ++i) {
+    digitalWrite(HW069_CLK_PIN, LOW);
+    bit_delay();
+    digitalWrite(HW069_DIO_PIN, (b & 0x01) ? HIGH : LOW);
+    bit_delay();
+    digitalWrite(HW069_CLK_PIN, HIGH);
+    bit_delay();
+    b >>= 1;
+  }
+  // ACK
+  digitalWrite(HW069_CLK_PIN, LOW);
+  pinMode(HW069_DIO_PIN, INPUT_PULLUP);
+  bit_delay();
+  digitalWrite(HW069_CLK_PIN, HIGH);
+  bit_delay();
+  digitalWrite(HW069_CLK_PIN, LOW);
+  pinMode(HW069_DIO_PIN, OUTPUT);
+  bit_delay();
+}
+
+static uint8_t level_from_pct(uint8_t pct) {
+  if (pct > 100) {
+    pct = 100;
+  }
+  // 0% -> 0, 100% -> 7
+  return (uint8_t)((pct * 7U) / 100U);
+}
+
+static void encode_value() {
+  int v = g_value;
+  if (v < 0) {
+    v = 0;
+  }
+  if (v > 9999) {
+    v = 9999;
+  }
+  g_raw[0] = SEG_DIGIT[(v / 1000) % 10];
+  g_raw[1] = SEG_DIGIT[(v / 100) % 10];
+  g_raw[2] = SEG_DIGIT[(v / 10) % 10];
+  g_raw[3] = SEG_DIGIT[v % 10];
+  // 时钟型模块：中间冒号挂在第 2 位的 bit7
+  if (g_colon) {
+    g_raw[1] |= 0x80;
+  }
+}
+
+static void apply() {
+  start();
+  write_byte(CMD_DATA_AUTO);
+  stop();
+
+  start();
+  write_byte(CMD_ADDR_BASE);
+  for (uint8_t i = 0; i < 4; ++i) {
+    write_byte(g_on ? g_raw[i] : 0x00);
+  }
+  stop();
+
+  start();
+  if (g_on) {
+    write_byte((uint8_t)(CMD_DISP_ON | level_from_pct(g_pct)));
+  } else {
+    write_byte(CMD_DISP_OFF);
+  }
+  stop();
+}
+
+void digit_init() {
+  pinMode(HW069_CLK_PIN, OUTPUT);
+  pinMode(HW069_DIO_PIN, OUTPUT);
+  digitalWrite(HW069_CLK_PIN, HIGH);
+  digitalWrite(HW069_DIO_PIN, HIGH);
+
+  g_on = true;
+  g_colon = false;
+  g_pct = 60;
+  g_value = 1234;
+  encode_value();
+  apply();
+  Serial.printf("HW-069 TM1637 CLK=GPIO%d DIO=GPIO%d value=%d bright=%u%%\n",
+                HW069_CLK_PIN, HW069_DIO_PIN, g_value, (unsigned)g_pct);
+}
+
+void digit_set_on(bool on) {
+  g_on = on;
+  apply();
+  Serial.printf("Digit %s\n", g_on ? "ON" : "OFF");
+}
+
+bool digit_is_on() { return g_on; }
+
+void digit_set_value(int value) {
+  if (value < 0) {
+    value = 0;
+  }
+  if (value > 9999) {
+    value = 9999;
+  }
+  g_value = value;
+  encode_value();
+  apply();
+  Serial.printf("Digit value %d\n", g_value);
+}
+
+int digit_get_value() { return g_value; }
+
+void digit_set_brightness(uint8_t percent) {
+  if (percent > 100) {
+    percent = 100;
+  }
+  g_pct = percent;
+  apply();
+  Serial.printf("Digit bright %u%% (lvl %u)\n", (unsigned)g_pct,
+                (unsigned)level_from_pct(g_pct));
+}
+
+uint8_t digit_brightness() { return g_pct; }
+
+void digit_set_colon(bool on) {
+  g_colon = on;
+  encode_value();
+  apply();
+  Serial.printf("Digit colon %s\n", g_colon ? "ON" : "OFF");
+}
+
+bool digit_colon() { return g_colon; }
+
+void digit_clear() {
+  g_value = 0;
+  g_colon = false;
+  encode_value();
+  apply();
+  Serial.println("Digit clear");
+}
--- a/src/main.cpp
+++ b/src/main.cpp
@@ -0,0 +1,45 @@
+#include <Arduino.h>
+#include <lvgl.h>
+
+#include "digit.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 | HW-069 Digit Display v1.1\n", lv_version_major(),
+                lv_version_minor(), lv_version_patch());
+  Serial.println("BOOT_OK");
+
+  pinMode(TFT_BL_PIN, OUTPUT);
+  digitalWrite(TFT_BL_PIN, HIGH);
+
+  touch_init();
+  digit_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,224 @@
+#include "ui.h"
+#include "digit.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_ACCENT = 0xFFB74D;
+static constexpr uint32_t COL_DIM = 0x3A4656;
+
+static lv_obj_t *lbl_title;
+static lv_obj_t *lbl_pin;
+static lv_obj_t *lbl_value;
+static lv_obj_t *lbl_bright;
+static lv_obj_t *slider;
+static lv_obj_t *btn_power;
+static lv_obj_t *lbl_power;
+static lv_obj_t *btn_colon;
+static lv_obj_t *lbl_colon;
+static lv_obj_t *btn_m100;
+static lv_obj_t *btn_m1;
+static lv_obj_t *btn_p1;
+static lv_obj_t *btn_p100;
+
+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 lv_obj_t *make_step_btn(lv_obj_t *parent, const char *txt, int16_t x,
+                               int16_t y, int16_t w, int16_t h,
+                               lv_event_cb_t cb, void *user) {
+  lv_obj_t *btn = lv_button_create(parent);
+  lv_obj_set_size(btn, w, h);
+  lv_obj_align(btn, LV_ALIGN_TOP_LEFT, x, y);
+  style_btn(btn, COL_BTN);
+  lv_obj_add_event_cb(btn, cb, LV_EVENT_CLICKED, user);
+  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);
+  return btn;
+}
+
+void ui_refresh_digit() {
+  const bool on = digit_is_on();
+  const bool colon = digit_colon();
+  const int value = digit_get_value();
+  const uint8_t pct = digit_brightness();
+
+  if (lbl_value) {
+    if (colon) {
+      lv_label_set_text_fmt(lbl_value, "%02d:%02d", value / 100, value % 100);
+    } else {
+      lv_label_set_text_fmt(lbl_value, "%04d", value);
+    }
+    lv_obj_set_style_text_color(lbl_value,
+                                lv_color_hex(on ? COL_ACCENT : COL_MUTED), 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_opa(slider, on ? LV_OPA_COVER : LV_OPA_50, LV_PART_MAIN);
+  }
+  if (lbl_power) {
+    lv_label_set_text(lbl_power, on ? "Display OFF" : "Display ON");
+  }
+  if (btn_power) {
+    style_btn(btn_power, on ? COL_ON : COL_BTN);
+  }
+  if (lbl_colon) {
+    lv_label_set_text(lbl_colon, colon ? "Colon ON" : "Colon OFF");
+  }
+  if (btn_colon) {
+    style_btn(btn_colon, colon ? COL_ON : COL_DIM);
+  }
+}
+
+static void on_power(lv_event_t *e) {
+  if (lv_event_get_code(e) != LV_EVENT_CLICKED) {
+    return;
+  }
+  digit_set_on(!digit_is_on());
+  ui_refresh_digit();
+}
+
+static void on_colon(lv_event_t *e) {
+  if (lv_event_get_code(e) != LV_EVENT_CLICKED) {
+    return;
+  }
+  digit_set_colon(!digit_colon());
+  ui_refresh_digit();
+}
+
+static void on_step(lv_event_t *e) {
+  if (lv_event_get_code(e) != LV_EVENT_CLICKED) {
+    return;
+  }
+  const intptr_t delta = (intptr_t)lv_event_get_user_data(e);
+  int v = digit_get_value() + (int)delta;
+  if (v < 0) {
+    v = 0;
+  }
+  if (v > 9999) {
+    v = 9999;
+  }
+  digit_set_value(v);
+  if (!digit_is_on()) {
+    digit_set_on(true);
+  }
+  ui_refresh_digit();
+}
+
+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);
+  digit_set_brightness((uint8_t)v);
+  if (!digit_is_on() && v > 0) {
+    digit_set_on(true);
+  }
+  ui_refresh_digit();
+}
+
+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);
+
+  lbl_title = lv_label_create(scr);
+  lv_label_set_text(lbl_title, "HW-069");
+  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_28, 0);
+  lv_obj_align(lbl_title, LV_ALIGN_TOP_MID, 0, 4);
+
+  lbl_pin = lv_label_create(scr);
+  lv_label_set_text_fmt(lbl_pin, "v1.1  CLK%d  DIO%d  TM1637", HW069_CLK_PIN,
+                        HW069_DIO_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, 36);
+
+  lbl_value = lv_label_create(scr);
+  lv_label_set_text(lbl_value, "1234");
+  lv_obj_set_style_text_color(lbl_value, lv_color_hex(COL_ACCENT), 0);
+  lv_obj_set_style_text_font(lbl_value, &lv_font_montserrat_28, 0);
+  lv_obj_align(lbl_value, LV_ALIGN_TOP_MID, 0, 56);
+
+  const int16_t row_y = 92;
+  const int16_t gap = 8;
+  const int16_t bw = (UI_HOR_RES - 48 - 3 * gap) / 4;
+  const int16_t bx0 = 24;
+  btn_m100 = make_step_btn(scr, "-100", bx0, row_y, bw, 40, on_step,
+                           (void *)(intptr_t)-100);
+  btn_m1 = make_step_btn(scr, "-1", bx0 + (bw + gap), row_y, bw, 40, on_step,
+                         (void *)(intptr_t)-1);
+  btn_p1 = make_step_btn(scr, "+1", bx0 + 2 * (bw + gap), row_y, bw, 40, on_step,
+                         (void *)(intptr_t)1);
+  btn_p100 = make_step_btn(scr, "+100", bx0 + 3 * (bw + gap), row_y, bw, 40,
+                           on_step, (void *)(intptr_t)100);
+  (void)btn_m100;
+  (void)btn_m1;
+  (void)btn_p1;
+  (void)btn_p100;
+
+  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_14, 0);
+  lv_obj_align(lbl_bright, LV_ALIGN_TOP_MID, 0, 140);
+
+  slider = lv_slider_create(scr);
+  lv_obj_set_size(slider, UI_HOR_RES - 48, 24);
+  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, 162);
+  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_ACCENT), 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);
+
+  const int16_t btn_w = (UI_HOR_RES - 48 - gap) / 2;
+  btn_colon = lv_button_create(scr);
+  lv_obj_set_size(btn_colon, btn_w, 40);
+  lv_obj_align(btn_colon, LV_ALIGN_TOP_LEFT, 24, 196);
+  style_btn(btn_colon, COL_DIM);
+  lv_obj_add_event_cb(btn_colon, on_colon, LV_EVENT_CLICKED, nullptr);
+  lbl_colon = lv_label_create(btn_colon);
+  lv_label_set_text(lbl_colon, "Colon OFF");
+  lv_obj_set_style_text_color(lbl_colon, lv_color_hex(COL_INK), 0);
+  lv_obj_set_style_text_font(lbl_colon, &lv_font_montserrat_16, 0);
+  lv_obj_center(lbl_colon);
+
+  btn_power = lv_button_create(scr);
+  lv_obj_set_size(btn_power, btn_w, 40);
+  lv_obj_align(btn_power, LV_ALIGN_TOP_LEFT, 24 + btn_w + gap, 196);
+  style_btn(btn_power, COL_ON);
+  lv_obj_add_event_cb(btn_power, on_power, LV_EVENT_CLICKED, nullptr);
+  lbl_power = lv_label_create(btn_power);
+  lv_label_set_text(lbl_power, "Display OFF");
+  lv_obj_set_style_text_color(lbl_power, lv_color_hex(COL_INK), 0);
+  lv_obj_set_style_text_font(lbl_power, &lv_font_montserrat_16, 0);
+  lv_obj_center(lbl_power);
+
+  ui_refresh_digit();
+}