From 3b918bc7b0cddfa07f5a60634c5e18bdad81431c Mon Sep 17 00:00:00 2001 From: DrDavidDa Date: Mon, 14 Sep 2026 12:22:32 +0800 Subject: [PATCH 1/4] docs: clarify M5Burner WiFi setup Add a beginner-friendly phone provisioning guide and a verified SD config template. Clarify offline use, SD card paths, file naming, and the fact that M5Burner does not configure WiFi automatically.\n\nCo-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- CHANGELOG.md | 4 + README.md | 28 ++- config.ini.example | 19 ++ docs/m5burner-quick-start.md | 58 ++++++ platformio.ini | 1 + src/main.cpp | 393 ++++++++++++++++++++++++++++++++++- 6 files changed, 496 insertions(+), 7 deletions(-) create mode 100644 config.ini.example create mode 100644 docs/m5burner-quick-start.md diff --git a/CHANGELOG.md b/CHANGELOG.md index 9c7a0f6..67d34cf 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -5,6 +5,9 @@ ## [Unreleased] ### 新增 +- **M5Burner 小白教程与 SD 配置模板**:新增 `docs/m5burner-quick-start.md` 和 `config.ini.example`,明确 M5Burner 烧录后优先用手机配网、离线使用操作、SD 卡根目录/文件名/格式要求,避免误建 `config.ini.txt` 或放错目录 +- **设备端 WiFi 配网页(SoftAP 热点 + captive portal)**:换 WiFi 不再依赖电脑/脚本/改代码——屏幕二维码页长按 B(或开机无凭据自动进入、串口 `#WIFIAP`)开启热点 `PaperColor-XXXXXX`,手机连上后浏览器自动弹出配置页,选 WiFi 输密码即完成;支持在线扫描周边 WiFi、实时连接状态轮询;凭据 NVS+SD 双写(NVS 优先级低,`#CFGDONE` 脚本全量写仍以 SD 为准并清 NVS);配网成功自动校时(NTP + HTTP 兜底)后 10 秒自动退出收摊 +- `platformio.ini` 新增 `ricmoo/QRCode` 依赖(配网页面绘制连接地址二维码,手机扫码直达) - **天气多城市**:config.ini 新增 `weather_lat` / `weather_lon` / `weather_city`(默认北京);日历页天气卡显示城市名;`write_config.py` 支持可选 `weather.txt`(lat= / lon= / city= 每行一条) - **WiFi 重连失败自动重试**:待机唤醒后重连失败 → 30 秒后自动重试(热点晚开/切换中场景),连上后立即拉智谱额度 - `#POLL` 命令与 `#WX` 同路径:WiFi 未连先重连再触发 @@ -12,6 +15,7 @@ - README 更换实机照片(待机页大图 + 七页实拍画廊) ### 修复 +- **开机不上网修复**:`setup()` 末尾按已存凭据置 `wifiReconnectPending`,开机即自动连 WiFi 并校时(此前开机只进待机、等唤醒才连);无任何凭据则自动进入配网模式 - **RTC 日期不同步**:SNTP(UDP123) 在 iPhone 热点下不可靠 → 日期停在旧值。新增 HTTP Date 兜底校准(`fetchHttpTimeSync` 拉 www.baidu.com 响应头 → settimeofday + 写回 RTC 芯片),开机/待机唤醒 SNTP 后兜底执行,实测 RTC=真实日期 - 新增 `#TIME` 诊断命令:对比系统 `time()` 与 RTC 芯片当前值 - `verify_audit.py` 增强:`ser.write` 加 `write_timeout` 防 USB 卡死无限阻塞 + 异常捕获与明确提示(light sleep 后需物理重插 USB) diff --git a/README.md b/README.md index e9488f0..c36d6b4 100644 --- a/README.md +++ b/README.md @@ -207,8 +207,9 @@ flowchart LR 1. 下载 [M5Burner](https://m5stack.com/pages/m5burner) → 右上角登录 M5Stack 社区账号 2. 左下角 **USER CUSTOM** → 搜索 **PaperColor**(PaperColor eInk Desk Terminal)(类别 paper · 作者 DrDavid)→ Burn 3. 或点 **Share Burn** 输入分享码:`uqzYX4i61TQriRrU` +4. 烧录完成后,**不需要先创建 TF 卡文件**:设备无 WiFi 凭据时会自动显示配网说明,按屏幕提示用手机连接 `PaperColor-XXXXXX`,打开 `http://192.168.4.1` 完成配置 -> 首次使用需向设备 SD 卡写入 `/config.ini`(WiFi + token),见下方「配置」。 +> M5Burner 只负责烧录固件,不会自动读取电脑 WiFi。普通用户请优先使用手机配网;SD 卡 `config.ini` 是备用配置方式,详见 [`docs/m5burner-quick-start.md`](docs/m5burner-quick-start.md)。 ### 1. 环境 @@ -224,7 +225,29 @@ USB-C 直连即可。PaperColor 板载按键、麦克风、扬声器、SD、温 ### 3. 配置 -编辑 `src/main.cpp` 顶部的集中配置区: +**WiFi 三种配法,推荐 A(全程只用手机,无需电脑/无需改代码):** + +**A. 手机配网(SoftAP 热点 + 网页配置)** + +1. 进入配网模式(任选其一): + - 开机检测到从未配置过 WiFi → **自动进入**配网模式 + - 二维码页(第 6 页)**长按 B** + - 串口发送 `#WIFIAP` +2. 屏幕显示热点名 + 网址二维码 → 手机连接热点 `PaperColor-XXXXXX`(开放网络) +3. 手机浏览器会自动弹出配置页(或手动打开 `http://192.168.4.1`)→ 可点"重新扫描附近WiFi"→ 选择家里 WiFi → 输密码 → **保存并连接** +4. 设备自动连接;成功后屏幕提示并**10 秒后自动退出**配网模式,手机自动回连家里 WiFi + +> 凭据双写:NVS(设备内部)+ SD `/config.ini`(`wifi_ssid=` / `wifi_pass=` 行,与脚本配置互通)。配网成功即自动校时(NTP + HTTP 兜底)。 + +完整小白教程:[`docs/m5burner-quick-start.md`](docs/m5burner-quick-start.md)。如果用 SD 卡备用方式,请复制 [`config.ini.example`](config.ini.example) 到 SD 卡根目录并改名为 `config.ini`。 + +**B. 编译期写入**(下述 `WIFI_SSID` / `WIFI_PASS`) + +**C. 电脑脚本**(下述 `write_config.py`,插上 USB 自动跟随电脑 WiFi) + +--- + +编译期方式:编辑 `src/main.cpp` 顶部的集中配置区: ```cpp #define WIFI_SSID "你的WiFi" @@ -251,6 +274,7 @@ pio run -j 1 -t upload --upload-port COM4 - 短按 A/B 翻页,长按 A/B 触发功能 - **长按 C = 全局语音命令** +- **二维码页长按 B = WiFi 配网模式**(换 WiFi/改密码不用重烧固件) - 5 分钟无操作自动进待机页,任意键唤醒 --- diff --git a/config.ini.example b/config.ini.example new file mode 100644 index 0000000..db789d6 --- /dev/null +++ b/config.ini.example @@ -0,0 +1,19 @@ +# PaperColor WiFi 配置示例 +# 复制本文件到 SD 卡根目录,并重命名为 config.ini。 +# Windows 请确认文件不是 config.ini.txt。 + +use_wifi=true +wifi_ssid=你的WiFi名称 +wifi_pass=你的WiFi密码 + +# 可选:第二、第三组 WiFi +# wifi_ssid2=备用WiFi +# wifi_pass2=备用WiFi密码 +# wifi_ssid3=手机热点 +# wifi_pass3=手机热点密码 + +# 可选:智谱 Coding Plan +# zhipu_cookie=你的token + +# 可选:语音转文字 +# sf_api_key=你的key diff --git a/docs/m5burner-quick-start.md b/docs/m5burner-quick-start.md new file mode 100644 index 0000000..e43cbd7 --- /dev/null +++ b/docs/m5burner-quick-start.md @@ -0,0 +1,58 @@ +# M5Burner 小白上手教程 + +## 先记住一件事 + +烧录完成后,**不需要先在 TF/microSD 卡上建文件才能配置 WiFi**。最简单的方法是用手机配网: + +1. 设备开机。如果没有保存过 WiFi,设备会自动显示 WiFi 配网说明。 +2. 手机连接设备屏幕显示的热点,例如 `PaperColor-XXXXXX`。 +3. 如果手机提示“此网络无互联网”,选择“继续连接/保持连接”。 +4. 扫描设备上的二维码,或在手机浏览器打开 `http://192.168.4.1`。 +5. 选择家里的 WiFi,输入密码,点击“保存并连接”。 +6. 等待设备显示连接成功。约 10 秒后设备关闭临时热点,手机再切回家里的 WiFi。 + +没有自动弹出网页时,直接打开 `http://192.168.4.1`。以后要重新配置 WiFi,进入二维码页并长按 B。 + +## 只想离线使用 + +在设备的 WiFi 配网页面,**短按 C 键**选择“离线使用”。设备会记住这个选择,以后开机直接进入本地模式,不再反复打开配网页面。 + +离线模式仍可使用日历、内置考点、SD 卡内容、传感器和本地语音;天气、新闻、网络时间和云端服务需要 WiFi。以后进入二维码页长按 B 即可重新配置。 + +## 使用 SD 卡文件配置(备用方法) + +只有需要通过文件配置时,才使用此方法: + +1. 将 SD 卡格式化为 FAT32。 +2. 在 SD 卡**根目录**放置一个文件,文件名必须是 `config.ini`。 +3. 可以复制仓库中的 [`config.ini.example`](../config.ini.example) 作为模板。 +4. Windows 需要打开“显示文件扩展名”,确认文件不是 `config.ini.txt`。 +5. 至少填写以下两行,然后保存、弹出 SD 卡、插入设备并重启: + +```ini +use_wifi=true +wifi_ssid=你的WiFi名称 +wifi_pass=你的WiFi密码 +``` + +SSID 和密码必须替换成实际内容。文件不能叫 `wifi.ini`、`config.txt`,也不能放在 `config/` 子目录中。 + +## SD 卡内容目录 + +SD 卡不是烧录固件的必要条件,但自定义内容需要它: + +```text +SD卡根目录/ +├── config.ini +├── cards/ # 自定义考点卡片 +├── qr/ # png / jpg / bmp 二维码图片 +├── voice/ # 语音文件 +├── todo.txt # 语音待办文字 +└── reminders.txt # 定时提醒 +``` + +SD 卡没有插好时,设备仍可使用手机配网和内置功能;只是无法读取这些自定义文件。 + +## M5Burner 说明 + +M5Burner 只负责烧录固件,不会自动读取电脑 WiFi,也不会替用户生成 SD 卡上的 `config.ini`。烧录后请优先使用上面的手机配网流程。 diff --git a/platformio.ini b/platformio.ini index bae6b3c..86a93dd 100644 --- a/platformio.ini +++ b/platformio.ini @@ -51,3 +51,4 @@ lib_deps = m5stack/M5GFX @ ^0.2.7 bblanchon/ArduinoJson @ ^7.0.0 adafruit/Adafruit NeoPixel @ ^1.10.0 + ricmoo/QRCode @ ^0.0.1 diff --git a/src/main.cpp b/src/main.cpp index bcf6d97..7dc66aa 100644 --- a/src/main.cpp +++ b/src/main.cpp @@ -28,6 +28,9 @@ #include #include #include +#include +#include +#include #include #include #include @@ -117,6 +120,9 @@ RuntimeCard* kpCards = nullptr; // 运行时卡片存储(PSRAM 动态分 size_t kpCount = 0; // 实际加载卡片数(0=使用内置) void loadCardsFromSD(); // 前向声明 void stopVoicePlayback(); // 前向声明(playCurrentTodoVoice 调用) +void startWifiSetup(); // 前向声明(二维码页长按B / 串口#WIFIAP / 开机无凭据自动进入) +void stopWifiSetup(); // 前向声明(配网模式下按键退出) +void clearWifiNVS(); // 前向声明(串口 #CFGDONE 全量写完 config.ini 后清 NVS 凭据) struct NewsItem { const char* const tag; // 标签 @@ -3588,7 +3594,12 @@ void handleCodingPlanSerial() { } } loadCodingPlanConfig(); + clearWifiNVS(); // 脚本全量写完 config.ini:SD 为唯一 WiFi 来源,清网页配网存的 NVS 凭据 Serial.printf("[OK] config saved (token_len=%d)\n", (int)cpTokenLen); + } else if (strncmp(cpSerialBuf, "#WIFIAP", 7) == 0) { + // 主机命令开 WiFi 配网模式(热点+手机网页配置,免电脑免脚本) + startWifiSetup(); + Serial.println("[OK] wifi setup ap started"); } else if (strncmp(cpSerialBuf, "#LED|", 5) == 0) { // #LED|r,g,b 亮灯3秒(确认 LED 硬件是否工作)+ 诊断 int rr = 255, gg = 0, bb = 0; @@ -4276,6 +4287,327 @@ void drawPowerMenu() { M5.Display.setTextDatum(textdatum_t::top_left); } +// ==================================================================== +// WiFi 配网模式:SoftAP 热点 + captive portal 配置页(全程无需电脑) +// 入口:二维码页(6)长按B / 开机检测到从未配置过WiFi自动进入 / 串口 #WIFIAP +// 流程:手机连热点 PaperColor-XXXXXX → 浏览器打开(或自动弹出) http://192.168.4.1 +// → 扫描选择 WiFi 输密码 → 保存 NVS + 同步 SD /config.ini → 设备直连 +// 凭据双写策略:网页保存=NVS+SD 双写;串口脚本全量写(#CFGDONE)=SD 为准并清 NVS。 +// ==================================================================== +bool wifiSetupActive = false; // 配网模式总开关(loop 每轮跑 captive DNS + HTTP) +uint8_t wifiSetupPhase = 0; // 0=AP就绪等待手机 1=已保存正在连STA 2=连接成功 3=连接失败 +unsigned long wifiSetupPhaseAt = 0; // 当前阶段起始时刻(成功延迟收摊/失败提示用) +DNSServer* wifiSetupDns = nullptr; // captive portal DNS(通配解析全部指向本机) +WebServer* wifiSetupWeb = nullptr; // 配置页 HTTP 服务 +char wifiSetupApSsid[40] = ""; // 热点名 PaperColor-XXXXXX +String wifiSetupScanHtml = ""; // 周边 WiFi 扫描结果(配置页 datalist) +bool wifiSetupStaStarted = false; // /save 后 STA 试连是否已启动(重活挪到状态机,HTTP 处理器只保存并秒回) +bool wifiOfflineMode = false; // 用户明确选择离线使用后持久化,开机不再自动进入配网 + +bool hasWifiCredentials() { + for (int i = 0; i < 3; i++) if (cpWifiSsid[i][0] != '\0') return true; + return (strlen(WIFI_SSID) > 0 && strcmp(WIFI_SSID, "Your_WiFi_SSID") != 0); +} + +// WiFi 凭据 NVS 读写(不依赖 SD 卡,无卡设备也能完成配网) +// 开机顺序:先读 NVS,再读 SD /config.ini 覆盖 → 脚本配置始终可覆盖网页配置 +void loadWifiFromNVS() { + Preferences p; + if (!p.begin("wificfg", true)) return; + if (p.isKey("ssid")) { + String s = p.getString("ssid", ""); + strncpy(cpWifiSsid[0], s.c_str(), sizeof(cpWifiSsid[0]) - 1); + cpWifiSsid[0][sizeof(cpWifiSsid[0]) - 1] = '\0'; + } + if (p.isKey("pass")) { + String s = p.getString("pass", ""); + strncpy(cpWifiPass[0], s.c_str(), sizeof(cpWifiPass[0]) - 1); + cpWifiPass[0][sizeof(cpWifiPass[0]) - 1] = '\0'; + } + wifiOfflineMode = p.getBool("offline", false); + p.end(); +} + +void saveWifiToNVS(const char* ssid, const char* pass) { + Preferences p; + if (!p.begin("wificfg", false)) return; + p.putString("ssid", ssid); + p.putString("pass", pass); + p.putBool("offline", false); + p.end(); +} + +void saveWifiOfflineMode() { + Preferences p; + if (!p.begin("wificfg", false)) return; + p.putBool("offline", true); + p.end(); +} + +// 脚本全量写 config.ini 完成时调用:清 NVS 凭据,保证 SD 配置是唯一来源(避免残留旧配网凭据反向覆盖) +void clearWifiNVS() { + Preferences p; + if (!p.begin("wificfg", false)) return; + p.clear(); + p.end(); +} + +// 配网页保存后同步 SD /config.ini 的 WiFi 行(与桌面脚本配置保持一致;无SD/无文件则静默跳过,NVS 已足够) +void wifiSetupUpdateSdConfig(const char* ssid, const char* pass) { + if (!initSDCard() || !SD.exists("/config.ini")) return; + File in = SD.open("/config.ini", FILE_READ); + if (!in) return; + String out; + bool hasS = false, hasP = false; + while (in.available()) { + String ln = in.readStringUntil('\n'); + ln.trim(); + if (ln.startsWith("wifi_ssid=")) { out += String("wifi_ssid=") + ssid + "\n"; hasS = true; } + else if (ln.startsWith("wifi_pass=")) { out += String("wifi_pass=") + pass + "\n"; hasP = true; } + else if (ln.length() > 0) out += ln + "\n"; + } + in.close(); + if (!hasS) out += String("wifi_ssid=") + ssid + "\n"; + if (!hasP) out += String("wifi_pass=") + pass + "\n"; + File ou = SD.open("/config.ini", FILE_WRITE); + if (!ou) return; + ou.print(out); + ou.close(); + Serial.println("[WIFISTP] 已同步 SD /config.ini WiFi 行"); +} + +static String wifiHtmlEscape(const String& s) { + String o; + for (size_t i = 0; i < s.length(); i++) { + char c = s.charAt(i); + if (c == '&') o += "&"; + else if (c == '<') o += "<"; + else if (c == '>') o += ">"; + else if (c == '"') o += """; + else o += c; + } + return o; +} + +// 同步扫描周边 WiFi 并填充配置页下拉候选(APSTA 模式下可扫描;用户点"重新扫描"时短暂停顿属预期) +void wifiSetupFillScan() { + wifiSetupScanHtml = ""; + int n = WiFi.scanNetworks(); + for (int i = 0; i < n && i < 15; i++) { + wifiSetupScanHtml += ""; + } + WiFi.scanDelete(); +} + +// ------ 配置页 HTTP 处理(captive portal) ------ +void handleSetupRoot() { + String html = String("") + + "" + + "PaperColor WiFi设置" + + "" + + "

PaperColor WiFi 设置

" + + "
" + + "请按下面步骤操作
" + + "1. 手机保持连接设备热点 " + wifiHtmlEscape(String(wifiSetupApSsid)) + "
" + + "2. 如果手机提示“无互联网”,请选择“继续保持连接”
" + + "3. 选择家里的 WiFi,输入密码
" + + "4. 点击“保存并连接”,等待约 25 秒
" + + "5. 连接成功后,设备约 10 秒后关闭热点,手机再切回家里 WiFi" + + "
" + + "
" + + "

第 3 步:选择家里的 WiFi
WiFi名称(SSID)
" + wifiSetupScanHtml + "

" + + "

密码

" + + "

" + + "

重新扫描附近WiFi

" + + "

" + + "不想连接 WiFi?
请按设备上的 C 键,选择离线使用。设备会进入本地模式,之后可到二维码页长按 B 再配置 WiFi。

" + + "

当前已保存: " + wifiHtmlEscape(String(cpWifiSsid[0])) + "

" + + ""; + wifiSetupWeb->send(200, "text/html; charset=utf-8", html); +} + +void handleSetupScan() { + wifiSetupFillScan(); + wifiSetupWeb->sendHeader("Location", "/", true); + wifiSetupWeb->send(302, "text/plain", ""); +} + +void handleSetupSave() { + String ssid = wifiSetupWeb->arg("ssid"); + String pass = wifiSetupWeb->arg("pass"); + ssid.trim(); + if (ssid.length() == 0) { + wifiSetupWeb->send(200, "text/html; charset=utf-8", + "SSID 不能为空。返回"); + return; + } + saveWifiToNVS(ssid.c_str(), pass.c_str()); + strncpy(cpWifiSsid[0], ssid.c_str(), sizeof(cpWifiSsid[0]) - 1); + cpWifiSsid[0][sizeof(cpWifiSsid[0]) - 1] = '\0'; + strncpy(cpWifiPass[0], pass.c_str(), sizeof(cpWifiPass[0]) - 1); + cpWifiPass[0][sizeof(cpWifiPass[0]) - 1] = '\0'; + wifiSetupPhase = 1; + wifiSetupPhaseAt = millis(); + wifiSetupStaStarted = false; // SD 同步/WiFi.begin/刷屏由状态机执行,本处理器只保存凭据并立即响应(手机端绝不超时) + Serial.printf("[WIFISTP] 已保存 WiFi: %s(密码 %u 位)\n", ssid.c_str(), pass.length()); + wifiSetupWeb->send(200, "text/html; charset=utf-8", + String("") + + "已保存: " + wifiHtmlEscape(ssid) + ",设备正在连接...
查看连接状态"); +} + +void handleSetupStatus() { + String st; + if (wifiSetupPhase == 2) + st = "✅ 连接成功!设备IP: " + WiFi.localIP().toString() + "。按设备任意键退出配网。"; + else if (wifiSetupPhase == 1) + st = "⏳ 正在连接 WiFi,请稍候(最长 25 秒)..."; + else if (wifiSetupPhase == 3) + st = "❌ 连接失败。请检查 WiFi 名称、密码和信号,返回重新输入"; + else + st = "等待配置..."; + wifiSetupWeb->send(200, "text/html; charset=utf-8", + String("") + st); +} + +void handleSetupCaptive() { + // captive portal:操作系统联网检测等一切非配置页请求 → 重定向回配置页(手机自动弹窗的关键) + wifiSetupWeb->sendHeader("Location", String("http://") + WiFi.softAPIP().toString() + "/", true); + wifiSetupWeb->send(302, "text/plain", ""); +} + +// 绘制配网页面:热点名/地址大字 + URL 二维码 + 实时状态行(renderScreen 分支调用) +void drawWifiSetupPage() { + // 顶栏标题(顶栏区已清为藏青) + M5.Display.setFont(&fonts::efontCN_16_b); + M5.Display.setTextColor(TFT_WHITE, TFT_NAVY); + M5.Display.setTextDatum(textdatum_t::top_left); + M5.Display.drawString("WiFi 配置模式", MARGIN_X, 10); + + int startY = STATUS_BAR_HEIGHT; + M5.Display.setFont(&fonts::efontCN_16_b); + M5.Display.setTextColor(TFT_BLACK, TFT_WHITE); + M5.Display.drawString("1. 打开手机 WiFi", MARGIN_X, startY + 16); + M5.Display.drawString("2. 连接热点: " + String(wifiSetupApSsid), MARGIN_X, startY + 43); + M5.Display.drawString("3. 扫码或打开配置页", MARGIN_X, startY + 70); + M5.Display.drawString("4. 选家里WiFi,输密码并保存", MARGIN_X, startY + 97); + M5.Display.drawString("5. 成功后约10秒关闭热点", MARGIN_X, startY + 124); + M5.Display.setTextColor(TFT_NAVY, TFT_WHITE); + M5.Display.drawString("网址: http://192.168.4.1", MARGIN_X, startY + 151); + + // 配置页地址二维码(version2=25x25 模块 ×4px=100px;手机扫码直达配置页) + uint8_t qrBuf[qrcode_getBufferSize(2)]; + QRCode qrcode; + qrcode_initText(&qrcode, qrBuf, 2, ECC_LOW, "http://192.168.4.1"); + const int qs = 4; + int qx = SCREEN_WIDTH - MARGIN_X - 25 * qs - 8, qy = startY + 28; + M5.Display.drawRect(qx - 4, qy - 4, 25 * qs + 8, 25 * qs + 8, TFT_BLACK); + for (uint8_t yy = 0; yy < qrcode.size; yy++) + for (uint8_t xx = 0; xx < qrcode.size; xx++) + if (qrcode_getModule(&qrcode, xx, yy)) + M5.Display.fillRect(qx + xx * qs, qy + yy * qs, qs, qs, TFT_BLACK); + M5.Display.setFont(&fonts::efontCN_14_b); + M5.Display.setTextColor(TFT_BLACK, TFT_WHITE); + M5.Display.drawString("扫码直达配置页", qx - 20, qy + 25 * qs + 10); + + // 实时状态行 + M5.Display.setFont(&fonts::efontCN_16_b); + String st; + if (wifiSetupPhase == 0) st = "4.网页选家里WiFi→输密码→保存"; + else if (wifiSetupPhase == 1) st = String("正在连接: ") + cpWifiSsid[0] + "(约25秒)"; + else if (wifiSetupPhase == 2) st = String("连接成功! IP: ") + WiFi.localIP().toString(); + else st = "连接失败:回网页检查密码后重试"; + M5.Display.setTextColor(wifiSetupPhase == 2 ? TFT_DARKGREEN : (wifiSetupPhase == 3 ? TFT_RED : TFT_BLACK), TFT_WHITE); + M5.Display.drawString(st, MARGIN_X, startY + 185); + + M5.Display.setFont(&fonts::efontCN_16_b); + M5.Display.setTextColor(TFT_RED, TFT_WHITE); + M5.Display.drawString("不配 WiFi:短按 C 键 = 离线使用", MARGIN_X, startY + 225); + + // 底部操作条提示(底栏区已清为藏青) + M5.Display.setFont(&fonts::efontCN_16_b); + M5.Display.setTextColor(TFT_WHITE, TFT_NAVY); + M5.Display.setTextDatum(textdatum_t::middle_center); + M5.Display.drawString("C=离线使用 A/B=退出本次配置", + SCREEN_WIDTH / 2, STATUS_BAR_HEIGHT + MAIN_AREA_HEIGHT + ACTION_BAR_HEIGHT / 2); + M5.Display.setTextDatum(textdatum_t::top_left); +} + +void startWifiSetup() { + if (wifiSetupActive) return; + wifiOfflineMode = false; // 手动重新进入配网即表示用户想恢复联网 + if (standbyMode) wakeFromStandby(); // 待机中收到 #WIFIAP:先恢复 240MHz/屏幕,才能显示配网页 + if (WiFi.status() == WL_CONNECTED) { WiFi.disconnect(); wifiConnected = false; } + uint64_t mac = ESP.getEfuseMac(); + snprintf(wifiSetupApSsid, sizeof(wifiSetupApSsid), "PaperColor-%06X", (unsigned)(mac & 0xFFFFFF)); + WiFi.mode(WIFI_AP_STA); // APSTA:开热点同时保留 STA 能力(扫描/试连不断热点) + WiFi.softAP(wifiSetupApSsid); // 开放热点,仅提供配置页 + wifiSetupDns = new DNSServer(); + wifiSetupDns->start(53, "*", WiFi.softAPIP()); + wifiSetupWeb = new WebServer(80); + wifiSetupWeb->on("/", handleSetupRoot); + wifiSetupWeb->on("/scan", handleSetupScan); + wifiSetupWeb->on("/save", HTTP_POST, handleSetupSave); + wifiSetupWeb->on("/status", handleSetupStatus); + wifiSetupWeb->onNotFound(handleSetupCaptive); + wifiSetupWeb->begin(); + wifiSetupPhase = 0; + wifiSetupPhaseAt = millis(); + wifiSetupStaStarted = false; + wifiSetupActive = true; + Serial.printf("[WIFISTP] 配网模式启动 热点=%s IP=%s\n", + wifiSetupApSsid, WiFi.softAPIP().toString().c_str()); + renderScreen(false); // 先刷屏再扫描(扫描阻塞约2~3秒) + wifiSetupFillScan(); +} + +void stopWifiSetup() { + if (!wifiSetupActive) return; + wifiSetupActive = false; + if (wifiSetupWeb) { wifiSetupWeb->stop(); delete wifiSetupWeb; wifiSetupWeb = nullptr; } + if (wifiSetupDns) { wifiSetupDns->stop(); delete wifiSetupDns; wifiSetupDns = nullptr; } + WiFi.softAPdisconnect(true); + WiFi.mode(WIFI_STA); // 回站点模式,由既有重连机制接管 + wifiReconnectPending = true; // STA已连则秒回true,未连则按已存凭据重试 + Serial.println("[WIFISTP] 退出配网模式"); + renderScreen(false); +} + +// 配网连接状态机:/save 后轮询 STA 结果(loop 每轮调用) +void wifiSetupTick() { + if (!wifiSetupActive) return; + unsigned long now = millis(); + if (wifiSetupPhase == 1) { + if (!wifiSetupStaStarted) { // 一次性启动:同步SD → 发起连接 → 刷"正在连接"页(HTTP 处理器已秒回手机) + wifiSetupStaStarted = true; + wifiSetupUpdateSdConfig(cpWifiSsid[0], cpWifiPass[0]); + if (WiFi.status() == WL_CONNECTED) WiFi.disconnect(); + WiFi.begin(cpWifiSsid[0], cpWifiPass[0]); // APSTA:手机保持连着热点围观连接结果 + wifiSetupPhaseAt = now; // 重置计时:SD 同步/刷屏耗时不算连接等待 + Serial.printf("[WIFISTP] 开始连接 STA: %s\n", cpWifiSsid[0]); + renderScreen(false); + } + if (WiFi.status() == WL_CONNECTED && now - wifiSetupPhaseAt > 2000UL) { + wifiSetupPhase = 2; + wifiSetupPhaseAt = now; + configTime(8 * 3600, 0, "ntp.aliyun.com", "cn.pool.ntp.org", "pool.ntp.org"); + syncRtcFromNTP(); // 配网成功即校准 RTC(旧逻辑只有脚本+编译期SSID路径会校时) + Serial.printf("[WIFISTP] 连接成功 IP=%s\n", WiFi.localIP().toString().c_str()); + renderScreen(false); + } else if (now - wifiSetupPhaseAt > 25000UL) { + wifiSetupPhase = 3; + wifiSetupPhaseAt = now; + WiFi.disconnect(); // 回纯 AP 等待用户重试 + Serial.println("[WIFISTP] 连接超时失败"); + renderScreen(false); + } + } else if (wifiSetupPhase == 2 && now - wifiSetupPhaseAt > 10000UL) { + stopWifiSetup(); // 成功展示10秒后自动收摊回主界面 + } +} + // ==================================================================== // 刷新管控核心:全屏渲染唯一入口(事件驱动,白名单制) // forceQuality=true → 请求全彩刷新(受 30 分钟冷却限制,冷却期内自动降级黑白快刷) @@ -4325,6 +4657,14 @@ void renderScreen(bool forceQuality) { return; } + // WiFi 配网模式:独立页面(无需 SD 卡数据;按键在 loop 中拦截,不落下方页面切换逻辑) + if (wifiSetupActive) { + drawWifiSetupPage(); + M5.Display.endWrite(); + M5.Display.display(); + return; + } + drawTopBar(); switch (currentPage) { @@ -4391,7 +4731,8 @@ void setup() { loadCardsFromSD(); // 先加载 SD 考点卡片(kpCount 决定后续用 SD 还是内置) loadTodoFromSD(); loadReminders(); // 加载定时提醒(/reminders.txt) - loadCodingPlanConfig(); // 读取 Coding Plan 配置(缺失则默认) + loadWifiFromNVS(); // 先读 NVS 配网凭据(无 SD 卡也能有 WiFi 配置) + loadCodingPlanConfig(); // 读取 Coding Plan 配置(缺失则默认);若 SD 有 wifi_ssid 行会覆盖 NVS loadMemoryStates(); // 依赖 cardTotal(),必须在 loadCardsFromSD 之后 initTTS(); // 中文语音合成(模型来自 flash voice_data 分区;失败静默降级) @@ -4407,6 +4748,19 @@ void setup() { renderScreen(false); lastScreenUpdate = millis(); lastActivityMs = millis(); // 开机即视为活动:闲置 5 分钟自动待机(否则 lastActivityMs=0 永不待机) + + // 开机 WiFi 决策: + // 1) 已有凭据(NVS 或 SD config.ini)→ 交给 loop 既有重连机制直连(修复:原 initWiFiNTP 只认 + // 编译期 WIFI_SSID 占位符,导致配置了 WiFi 也永不开机直连,只能等闲置后手动触发) + // 2) 从未配置过 WiFi(无 NVS 无 SD 配置且编译期 SSID 是占位符)→ 自动进入配网模式, + // 屏幕出热点二维码,手机扫码即配,全程无需电脑 + if (wifiOfflineMode) { + Serial.println("[WIFI] 用户选择离线模式,跳过自动配网"); + } else if (hasWifiCredentials()) { + wifiReconnectPending = true; + } else { + startWifiSetup(); + } } // ==================================================================== @@ -4441,6 +4795,13 @@ void loop() { // 串口接收 Coding Plan 数据(仅更新内存变量,绝不刷屏) handleCodingPlanSerial(); + // WiFi 配网模式:captive DNS + 配置页 HTTP + 连接状态机(优先级最高,屏蔽常规网络任务) + if (wifiSetupActive) { + if (wifiSetupDns) wifiSetupDns->processNextRequest(); + if (wifiSetupWeb) wifiSetupWeb->handleClient(); + wifiSetupTick(); + } + // 按键事件待处理时,跳过阻塞型定时任务(智谱/RSS/天气),让按键优先响应 bool keyBusy = keyA.clickPending || keyB.clickPending || keyC.clickPending || keyA.holdPending || keyB.holdPending || keyC.holdPending; @@ -4456,7 +4817,7 @@ void loop() { // 闲置自动待机(省电):无操作超时 → 待机页 + 降频 + 断WiFi;任意键唤醒 // 转写排队中(asrPending)禁止待机:否则录音后 5 分钟无操作进 light sleep,转写任务永不执行 - if (!standbyMode && !asrPending && !isRecordingNow && !voiceCmdMode && !voicePlaying && lastActivityMs != 0 && now - lastActivityMs > IDLE_SLEEP_MS) { + if (!standbyMode && !asrPending && !isRecordingNow && !voiceCmdMode && !voicePlaying && !wifiSetupActive && lastActivityMs != 0 && now - lastActivityMs > IDLE_SLEEP_MS) { standbyMode = true; setCpuFrequencyMhz(80); if (WiFi.status() == WL_CONNECTED) { WiFi.disconnect(); wifiConnected = false; } @@ -4488,7 +4849,7 @@ void loop() { // 待机页不定时刷新:只显示当天日期+天气缓存(无时钟),省电 + 保护墨水屏寿命 // 待机唤醒后延迟重连 WiFi:等按键处理完再连(不阻塞按键响应),避开录音/上传/新闻加载 - if (wifiReconnectPending && !keyBusy && !isRecordingNow && !voiceCmdMode && !fileReceiving && !newsLoading) { + if (wifiReconnectPending && !wifiSetupActive && !keyBusy && !isRecordingNow && !voiceCmdMode && !fileReceiving && !newsLoading) { wifiReconnectPending = false; bool wasConn = wifiConnected; reconnectWifiFromConfig(); // 成功 → wifiConnected=true + NTP 同步 @@ -4500,7 +4861,7 @@ void loop() { } } // WiFi 重连失败定时重试(非阻塞;连上后与唤醒同路径:cpLastPollAt=0 立即拉额度) - if (!wifiReconnectPending && !wifiConnected && wifiRetryAt != 0 && now >= wifiRetryAt + if (!wifiReconnectPending && !wifiConnected && !wifiSetupActive && wifiRetryAt != 0 && now >= wifiRetryAt && !standbyMode && !isRecordingNow && !voiceCmdMode && !fileReceiving && !newsLoading && !keyBusy) { wifiRetryAt = 0; wifiReconnectPending = true; @@ -4509,7 +4870,7 @@ void loop() { // WiFi 直连智谱轮询(按配置间隔;仅更新内存,绝不刷屏,不阻塞主循环) // 开机首次立即轮询一次(cpLastPollAt==0),之后按 poll_interval_sec 周期轮询 // 录音/上传文件/待机期间禁止轮询(避免阻塞 loop 导致录音丢采样/串口溢出/待机耗电) - if (cpUseWifi && !standbyMode && !isRecordingNow && !voiceCmdMode && !fileReceiving && !keyBusy && (cpLastPollAt == 0 || now - cpLastPollAt >= (unsigned long)cpPollIntervalSec * 1000UL)) { + if (cpUseWifi && !standbyMode && !wifiSetupActive && !isRecordingNow && !voiceCmdMode && !fileReceiving && !keyBusy && (cpLastPollAt == 0 || now - cpLastPollAt >= (unsigned long)cpPollIntervalSec * 1000UL)) { cpLastPollAt = now; pollZhipuCodingPlan(); } @@ -4805,6 +5166,26 @@ void loop() { return; } + // ===== WiFi 配网模式:C=记住离线并退出,A/B=仅退出本次配网 ===== + // 配网期间页面切换/录音/语音命令/关机菜单均不生效,专注配网 + if (wifiSetupActive) { + bool exitByKey = keyA.clickPending || keyB.clickPending || keyC.clickPending || + keyA.holdPending || keyB.holdPending || keyC.holdPending; + if (exitByKey) { + bool offlineByC = wifiSetupPhase == 0 && + (keyC.clickPending || keyC.holdPending); + keyA.clickPending = keyB.clickPending = keyC.clickPending = false; + keyA.holdPending = keyB.holdPending = keyC.holdPending = false; + if (offlineByC) { + saveWifiOfflineMode(); + wifiOfflineMode = true; + Serial.println("[WIFISTP] 用户选择离线使用"); + } + stopWifiSetup(); // 收摊热点;C 键选择离线,A/B 仅取消本次配置 + } + return; + } + // 长按 C: 待办页=切页;二维码页=关机菜单;其他页=全局语音命令(最小路径:不刷屏+蓝灯,识别后一次刷屏进页) if (keyC.holdPending) { if (now - keyCLast >= BUTTON_DEBOUNCE_MS) { @@ -4876,6 +5257,8 @@ void loop() { speakCurrentKnowledge(); } else if (currentPage == 4) { deleteCurrentTodo(); // 待办页长按B=删除当前待办(语音待办同时删 WAV) + } else if (currentPage == 6) { + startWifiSetup(); // 二维码页长按B = WiFi 配网模式(热点+手机网页配置,无需电脑) } } return; From fa0c9902e816a593146bc18943d6cc4310896388 Mon Sep 17 00:00:00 2001 From: DrDavidDa Date: Mon, 14 Sep 2026 12:23:34 +0800 Subject: [PATCH 2/4] chore: align M5Burner release metadata Prepare the publisher for v3.1.0 and describe the phone provisioning flow.\n\nCo-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- publish_m5burner.py | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/publish_m5burner.py b/publish_m5burner.py index 6287ab8..f564206 100644 --- a/publish_m5burner.py +++ b/publish_m5burner.py @@ -27,7 +27,7 @@ CREDS = os.path.join(HERE, 'm5_credentials.txt') NAME = 'PaperColor eInk Desk Terminal' -VERSION = 'v1.0.0' +VERSION = 'v3.1.0' CATEGORY = 'paper' # M5Burner 官方 PaperColor 类别 GITHUB = 'https://github.com/DrDavidDa/PaperColor-Desk-Terminal' FID = '0fc711c40244fb17a7df65c434deda4d' # 首次上传分配的固件 ID(meta-only 按它定位) @@ -37,7 +37,8 @@ '🎙 全离线中文 TTS + 全局语音助手「小彩」:任意页长按 C,说「打开日历」「开始番茄」,' '一句话直达,彻底解放双手。\n' '🌙 真·2mA 超低功耗待机,续航 25~50 天;墨水屏不闪烁、不烧屏,摆桌上常亮一整年。\n' - '⚡ M5Burner 一键烧录,SD 卡写入 WiFi 即联网,开箱即玩!\n' + '⚡ M5Burner 一键烧录;烧录后用手机连接 PaperColor-XXXXXX 热点即可配网,' + '也支持 SD 卡根目录 config.ini 备用配置;开箱即玩!\n' 'English: Turn your 4" Spectra 6 full-color eInk into an all-in-one desk terminal — ' 'lunar calendar & weather, tech news RSS, spaced-repetition flashcards, Pomodoro, ' 'voice memos & dashboard. Fully offline Chinese TTS + voice assistant (long-press C), ' From 80085b2c5b391a60af6afec9cd891d6b6d3209e1 Mon Sep 17 00:00:00 2001 From: DrDavidDa Date: Mon, 14 Sep 2026 14:19:36 +0800 Subject: [PATCH 3/4] fix: verify M5Burner publication state Handle the API response where an already-published version returns HTTP 400, and verify the authoritative version list before reporting success.\n\nCo-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- publish_m5burner.py | 57 +++++++++++++++++++++++++++++++++++++++++---- 1 file changed, 53 insertions(+), 4 deletions(-) diff --git a/publish_m5burner.py b/publish_m5burner.py index f564206..74e4f42 100644 --- a/publish_m5burner.py +++ b/publish_m5burner.py @@ -132,7 +132,9 @@ def set_public(token, fid, file_hash): # 注意:端点第2参数是 versionInfo.file(内部文件名hash.bin),不是版本字符串(逆向 UI 源码确认) r = requests.put(API + '/api/admin/firmware/%s/publish/%s/1' % (fid, file_hash), json={}, headers={'m5_auth_token': token}, timeout=30) - print('[%s] 公开 HTTP %d %s' % ('OK' if r.status_code == 200 else '??', r.status_code, r.text[:200])) + ok = r.status_code == 200 + print('[%s] 公开 HTTP %d %s' % ('OK' if ok else 'FAIL', r.status_code, r.text[:200])) + return ok def share_code(token, fid, version): @@ -142,6 +144,31 @@ def share_code(token, fid, version): return r.text +def update_firmware(token, fid, old_file): + """Upload the new firmware as a new version while preserving the M5Burner fid.""" + if not os.path.exists(IMAGE): + print('[FAIL] 缺少镜像 %s' % IMAGE) + sys.exit(1) + data = { + 'name': NAME, + 'description': DESCRIPTION, + 'category': CATEGORY, + 'author': 'DrDavidDa', + 'version': VERSION, + 'github': GITHUB, + } + with open(IMAGE, 'rb') as firmware: + files = {'firmware': ('firmware.bin', firmware, 'application/octet-stream')} + r = requests.put(API + '/api/admin/firmware/%s/version/%s' % (fid, old_file), + data=data, files=files, + headers={'m5_auth_token': token}, timeout=900) + print('[%s] 上传 v%s HTTP %d %s' % + ('OK' if r.status_code == 200 else 'FAIL', VERSION, r.status_code, r.text[:300])) + if r.status_code != 200: + sys.exit(1) + return r.json() if r.text else {} + + def update_meta(token): """只更新名称/介绍/封面(fid 不变,分享码不失效,不重传 16MB 固件)""" own = get_own(token) @@ -194,7 +221,7 @@ def main(): print('[DONE] 元数据更新完成') return - # 已存在则跳过重复上传(按名称在"我的固件"里查) + # 已存在则复用 fid,并把最新镜像作为新版本上传 own = get_own(token) fid = None if isinstance(own, list): @@ -218,7 +245,7 @@ def main(): print('[FAIL] 上传后在"我的固件"中未找到,手动核对响应:', str(resp)[:400]) sys.exit(1) - # 公开端点的第2参数是内部文件名(fid+file 定位具体版本),从"我的固件"里取最新版本 + # 对已有固件上传新版本;新上传返回的内部文件名由列表接口确认 own = get_own(token) file_hash = None if isinstance(own, list): @@ -226,12 +253,34 @@ def main(): if (item.get('fid') or item.get('_id')) == fid: vers = item.get('versions') or [] if vers: + latest = vers[-1] + if latest.get('version') != VERSION: + update_firmware(token, fid, latest.get('file')) + own = get_own(token) + for refreshed in (own or []): + if (refreshed.get('fid') or refreshed.get('_id')) == fid: + vers = refreshed.get('versions') or [] + break file_hash = vers[-1].get('file') break if not file_hash: print('[FAIL] 未取到版本内部文件名') sys.exit(1) - set_public(token, fid, file_hash) + if not set_public(token, fid, file_hash): + # Some API versions return 400 when the newly uploaded version is + # already marked published; verify the authoritative list before failing. + verified = False + refreshed = get_own(token) + if isinstance(refreshed, list): + for item in refreshed: + if (item.get('fid') or item.get('_id')) == fid: + versions = item.get('versions') or [] + verified = any(v.get('file') == file_hash and v.get('published') for v in versions) + break + if not verified: + print('[FAIL] M5Burner 未确认版本已公开') + sys.exit(1) + print('[OK] 列表接口确认版本已公开(忽略重复公开返回的 400)') share_code(token, fid, file_hash) print('[DONE] 全流程完成:固件已发布并公开') From ba86018ec31b646088ca9ac0644c3ee8fa7b8f86 Mon Sep 17 00:00:00 2001 From: DrDavidDa Date: Mon, 14 Sep 2026 15:45:54 +0800 Subject: [PATCH 4/4] docs: remove incorrect QR page number Refer to the device QR page without assigning the unrelated personal QR page number.\n\nCo-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- README.md | 2 +- src/main.cpp | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index c36d6b4..91388fe 100644 --- a/README.md +++ b/README.md @@ -231,7 +231,7 @@ USB-C 直连即可。PaperColor 板载按键、麦克风、扬声器、SD、温 1. 进入配网模式(任选其一): - 开机检测到从未配置过 WiFi → **自动进入**配网模式 - - 二维码页(第 6 页)**长按 B** + - 设备的二维码页面**长按 B** - 串口发送 `#WIFIAP` 2. 屏幕显示热点名 + 网址二维码 → 手机连接热点 `PaperColor-XXXXXX`(开放网络) 3. 手机浏览器会自动弹出配置页(或手动打开 `http://192.168.4.1`)→ 可点"重新扫描附近WiFi"→ 选择家里 WiFi → 输密码 → **保存并连接** diff --git a/src/main.cpp b/src/main.cpp index 7dc66aa..765a652 100644 --- a/src/main.cpp +++ b/src/main.cpp @@ -5326,7 +5326,7 @@ void loop() { renderScreen(false); } } else if (currentPage == 5) { - currentPage = 4; // 第6页(仪表盘) → 上一页(待办) + currentPage = 4; // 仪表盘页 → 上一页(待办) refreshPageData(); renderScreen(false); } else if (currentPage == 6) {