From 93019ef48212df9c325707e3174727c73c55db77 Mon Sep 17 00:00:00 2001 From: "DESKTOP-PUHFO60\\dsx2016" Date: Fri, 23 Oct 2026 15:49:07 +0800 Subject: [PATCH] Document BLE screen layout and refresh firmware metadata. Describe scrollable log above buttons; sync meta.json and VERSION.txt. Co-authored-by: Cursor --- README.md | 15 ++++++++++++++- firmware/README.md | 4 +++- firmware/cyd/VERSION.txt | 2 +- firmware/cyd/meta.json | 2 +- 4 files changed, 19 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index ae3c7ec..678fc98 100644 --- a/README.md +++ b/README.md @@ -22,6 +22,19 @@ - TX `6E400003-…`：板子 → 手机（Notify，先 Enable） 4. 默认 **Echo ON**：手机发什么，板子原样 Notify 回来；屏上 **Ping** 会发 `Hello from CYD`。 +## 屏上操作 + +横屏 320×240：上方状态（State / Name / Addr / Peer / Echo），中间 **可滚动日志框**（不盖住按钮），底栏四键： + +| 按钮 | 作用 | +|------|------| +| **Start/Stop Adv** | 未连接时开/停广播；已连接时需先在手机断开 | +| **Echo** | 开关收包自动回显 | +| **Ping** | 经 NUS TX 发 `Hello from CYD` | +| **Clear** | 清空日志 | + +收发内容显示在中间日志区，过长可在框内上下滑。 + ## 刷写（无需每次编译） 预编译包在 [`firmware/cyd/`](firmware/cyd/)： @@ -93,7 +106,7 @@ ble_core_set_rx_cb([](const uint8_t *data, size_t len, void *) { - `touch.*` / `pins.h` — CYD 硬件（与 tftest 同校准） - `ble_core.*` — NimBLE、NUS、广播、收发、断线重广播 -- `ble_ui.*` — LVGL 状态页 + Adv / Echo / Ping +- `ble_ui.*` — LVGL 状态页 + 中间滚动日志 + Adv / Echo / Ping / Clear - `main.cpp` — 演示入口 ## 与 WiFi 的关系 diff --git a/firmware/README.md b/firmware/README.md index 74ba3c4..ca654ac 100644 --- a/firmware/README.md +++ b/firmware/README.md @@ -3,7 +3,9 @@ 当前归档目录：[`cyd/`](cyd/) 对应板子：**CYD ESP32-2432S028R**（ILI9341） -功能：**BLE 外设**（NimBLE + Nordic UART + 屏上状态） +功能：**BLE 外设**（NimBLE + Nordic UART；屏上状态 + 滚动日志 + Adv/Echo/Ping） +分区：`min_spiffs`（约 1.9MB APP） + 版本信息见 [`cyd/VERSION.txt`](cyd/VERSION.txt)。 也可在 [`../../cydweb`](../../cydweb)（CYD Flasher）里通过浏览器串口刷写本目录固件。 diff --git a/firmware/cyd/VERSION.txt b/firmware/cyd/VERSION.txt index c84e379..1bafc3a 100644 --- a/firmware/cyd/VERSION.txt +++ b/firmware/cyd/VERSION.txt @@ -1,5 +1,5 @@ name: CYD BLE (cyd) -git: e987685 +git: 87120b8 date: 2026-10-23 board: ESP32-2432S028R (ILI9341) features: NimBLE Nordic UART, LVGL status UI, SoftSPI touch diff --git a/firmware/cyd/meta.json b/firmware/cyd/meta.json index b28c2d8..973b8e0 100644 --- a/firmware/cyd/meta.json +++ b/firmware/cyd/meta.json @@ -2,6 +2,6 @@ "boardId": "esp32-2432s028", "name": "CYD BLE", "summary": "NimBLE Nordic UART peripheral with LVGL status UI", - "description": "Advertise as CYD-BLE, Nordic UART Service for phone apps (nRF Connect / Serial Bluetooth Terminal). Echo, Ping, advertise control on touchscreen.", + "description": "Advertise as CYD-BLE with Nordic UART Service. Touch UI: status, scrollable RX/TX log above button bar (Adv / Echo / Ping / Clear). Works with nRF Connect and Serial Bluetooth Terminal.", "tags": ["ble", "nimble", "nus", "uart", "touch"] }