小龙虾
5db3f66b8e
- 将SPI OTA帧格式升级为SPI Link v2，采用新的帧格式： | SOF0 0xA5 | SOF1 0x5A | VER 0x02 | FLAGS | SESSION 4B LE | TX_SEQ | ACK_SEQ | CREDIT | TYPE | LEN 2B LE | RSV 2B | PAYLOAD | CRC32 4B LE | - 新增V2_OVERHEAD=20字节开销，APP最大payload为236字节，BOOT为108字节 - 修改帧类型定义：ENTER_BOOT从0xB5合并至0xB0，新增CAN业务类型0xC0~C3 - 更新CAN协议文档，支持SPI Link v2-only模式，调整最大业务payload计算 - 扩展0xC1帧功能，支持双向通信和1Hz主动推送ID快照 - 添加0xC3完整ID快照帧类型，包含seq/rx_count等完整字段 - 更新协议文档中的错误码定义和反馈payload格式 refactor(main): 重构主程序入口并添加CAN反馈任务 - 在main.cpp中添加CAN反馈任务，更新启动流程注释 - 创建createCriticalTask辅助函数，统一关键任务创建逻辑 - 调整SPI初始化顺序，确保CAN反馈任务依赖正确 - 优化错误处理机制，关键任务失败时立即重启 - 将GD32版本探测移至ota_relay任务处理 - 更新版本号至0.3.48，调整编译时间和Git哈希 config: 更新SPI和BLE配置参数 - 添加SPI主机相关配置参数，包括CS GPIO、READY GPIO等引脚定义 - 配置SPI缓冲区大小：APP为256字节，BOOT为128字节 - 更新BLE滑动窗口参数，ACK窗口设为32，数据队列深度为72 - 调整SPI工作队列大小至5120字节，增加任务堆栈监控说明
368 lines
18 KiB
JavaScript
368 lines
18 KiB
JavaScript
/**
|
||
* polling.js - 轮询状态 + Page Visibility 补偿 + ESP32 实时日志拉取
|
||
*
|
||
* 递归 setTimeout 调度 /system/status + setInterval 调度 /logs，避免 setInterval 慢响应被 abort。
|
||
*
|
||
* 模块级状态（仅本模块使用，不导出）：
|
||
* statusTimerId / logsTimerId / statusAbortCtrl / statusPollInFlight / statusPollIntervalMs
|
||
* uploadPollChip / lastLogTimestamp / pageVisible
|
||
*
|
||
* 共享状态（通过 window.* 引用）：
|
||
* window.pollingPausedForUpload — 上传期间暂停轮询标志
|
||
* window.consecutivePollFailures — 连续轮询失败计数（connection.js 也写入）
|
||
* window.lastSysStateCode — 上次成功的 sys_state_code（connection.js 写入）
|
||
* window.lastRelayState — 上次成功的 relay_state（connection.js 写入）
|
||
* window.isEsp32Rebooting — ESP32 重启中标志
|
||
* window.rebootStartTime — 重启开始时间戳
|
||
* window.rebootObservedDown — 已观察到设备下线
|
||
* window.otaSessionState — OTA 会话状态机当前状态
|
||
* window.OtaSessionState — OTA 会话状态枚举
|
||
* window.activeUploadChip — 当前上传目标芯片
|
||
* window.currentOtaTarget — 当前 OTA 目标
|
||
*
|
||
* 复用的函数（通过 window.* 引用）：
|
||
* window.getEspIp / window.getBaseUrl
|
||
* window.updateSystemStatusUi / window.updateEsp32StagesFromPhase
|
||
* window.applyRebootingRuntimeState / window.applyDisconnectedRuntimeState / window.applyUploadingRuntimeState
|
||
* window.otaSessionActive / window.otaSessionTransition / window.otaSessionReset
|
||
* window.updateUploadButtonLabel
|
||
*/
|
||
import { addLog } from './log.js';
|
||
import { showToast } from './toast.js';
|
||
import { updateConnectionUi, diagnoseNetwork } from './connection.js';
|
||
|
||
// ==================== 轮询状态 ====================
|
||
// 共享状态（初始化到 window，供 connection.js 等其他模块读写）
|
||
window.consecutivePollFailures = 0;
|
||
window.lastSysStateCode = -1; // 上次成功的 sys_state_code，用于失败时判断设备是否在忙
|
||
window.lastRelayState = 0; // 上次成功的 relay_state
|
||
|
||
// 模块级状态（仅本模块使用）
|
||
var statusTimerId = null;
|
||
var logsTimerId = null;
|
||
var statusAbortCtrl = null; // 当前 /system/status 请求的 AbortController（3s 超时用）
|
||
var statusPollIntervalMs = 1000; // 状态轮询目标间隔（中继期可由 setStatusPollIntervalMs 降到 400ms）
|
||
var statusPollInFlight = false; // 是否正在请求 /system/status，防止重叠
|
||
var pageVisible = !document.hidden; // 页面可见性：切到后台/最小化/切标签会变 false
|
||
var uploadPollChip = null; // 当前暂停轮询的上传目标，用于区分 WiFi/日志策略
|
||
|
||
/**
|
||
* 调整 /system/status 目标间隔。GD32 中继期用 400ms 缩小「转发 N/M」相对设备日志的滞后；
|
||
* 结束后恢复 1000ms，避免常态堆/栈卡片过刷。
|
||
*/
|
||
export function setStatusPollIntervalMs(ms) {
|
||
var n = Number(ms);
|
||
if (!Number.isFinite(n) || n < 200) n = 1000;
|
||
if (n > 5000) n = 5000;
|
||
statusPollIntervalMs = n;
|
||
}
|
||
|
||
/** @description 调度下一次 /system/status 轮询（递归 setTimeout）。
|
||
* 默认 delay = statusPollIntervalMs；pollStatus 完成后会按「固定周期」
|
||
* 传入 max(0, interval - 本轮耗时)，使 CPU 采样窗口 sample_ms ≈ interval，
|
||
* 而不是「完成后 + interval」（会稳定偏到 1100+ ms）。
|
||
* 仍保证 in-flight 不重叠，避免 setInterval 慢响应被 abort。
|
||
*/
|
||
export function scheduleStatusPoll(delayMs) {
|
||
if (statusTimerId) clearTimeout(statusTimerId);
|
||
var interval = statusPollIntervalMs;
|
||
statusTimerId = setTimeout(function() {
|
||
statusTimerId = null;
|
||
pollStatus();
|
||
}, delayMs !== undefined ? delayMs : interval);
|
||
}
|
||
|
||
/** @description 启动定时轮询（状态 + 日志）。 */
|
||
|
||
export function startPolling() {
|
||
window.consecutivePollFailures = 0;
|
||
statusPollIntervalMs = 1000;
|
||
if (statusTimerId) clearTimeout(statusTimerId);
|
||
if (logsTimerId) clearInterval(logsTimerId);
|
||
scheduleStatusPoll(0); // 立即开始第一次，完成后按 interval 递归调度
|
||
logsTimerId = setInterval(pollLogs, 1000);
|
||
}
|
||
export function pausePollingForUpload() {
|
||
if (window.pollingPausedForUpload) return;
|
||
window.pollingPausedForUpload = true;
|
||
uploadPollChip = window.activeUploadChip || window.flashTarget || null;
|
||
window.consecutivePollFailures = 0;
|
||
// ★ 上传大固件期间必须停掉 status/logs 轮询。
|
||
// httpd max_open_sockets=4 + lru_purge：轮询会再占 socket，LRU 可能踢掉
|
||
// 正在写 Flash 的 /ota/upload 连接 → 浏览器 upload 进度已 100%（发完），
|
||
// 但永远等不到 HTTP 响应，卡在「已上传 xxx / xxx」。
|
||
if (statusTimerId) {
|
||
clearTimeout(statusTimerId);
|
||
statusTimerId = null;
|
||
}
|
||
if (logsTimerId) {
|
||
clearInterval(logsTimerId);
|
||
logsTimerId = null;
|
||
}
|
||
if (statusAbortCtrl) {
|
||
try { statusAbortCtrl.abort(); } catch (e) { /* ignore */ }
|
||
statusAbortCtrl = null;
|
||
statusPollInFlight = false;
|
||
}
|
||
}
|
||
export function resumePollingAfterUpload() {
|
||
if (!window.pollingPausedForUpload) return;
|
||
window.pollingPausedForUpload = false;
|
||
uploadPollChip = null;
|
||
window.consecutivePollFailures = 0;
|
||
statusPollIntervalMs = 1000;
|
||
if (logsTimerId) clearInterval(logsTimerId);
|
||
logsTimerId = setInterval(pollLogs, statusPollIntervalMs);
|
||
// 上传结束立即刷新一次状态；若当前已在请求中，则让它完成后按新间隔继续
|
||
if (statusPollInFlight) {
|
||
if (statusTimerId) clearTimeout(statusTimerId);
|
||
} else {
|
||
scheduleStatusPoll(0);
|
||
}
|
||
pollLogs();
|
||
}
|
||
/** @description 轮询 ESP32 系统状态（GET /status）并更新 UI。 */
|
||
export async function pollStatus() {
|
||
// 递归 setTimeout 调度，正常情况下不会重叠；做个保险避免并发请求
|
||
if (statusPollInFlight) return;
|
||
statusPollInFlight = true;
|
||
var pollStartedAt = Date.now();
|
||
statusAbortCtrl = new AbortController();
|
||
var pollTimer = setTimeout(function() { try { statusAbortCtrl.abort(); } catch(_e) {} }, 5000);
|
||
try {
|
||
var resp = await fetch(window.getBaseUrl() + '/system/status', {
|
||
signal: statusAbortCtrl.signal
|
||
});
|
||
if (resp.ok) {
|
||
var data = await resp.json();
|
||
// 恢复：之前有失败计数，说明设备曾离线，现在恢复在线
|
||
if (window.consecutivePollFailures > 0) {
|
||
window.consecutivePollFailures = 0;
|
||
addLog('I', '系统', '设备已恢复在线，轮询恢复正常');
|
||
showToast('设备已恢复在线', 'success');
|
||
// 仅清理终态残留。禁止对活跃会话 otaSessionReset：
|
||
// 旧逻辑任意非 IDLE 都 reset -> 中继中一次 status 超时恢复后会把 RELAYING
|
||
// 清成 IDLE，UI 不再跟踪；REBOOTING 被清掉后永远进不了启动完成。
|
||
var ssRec = window.otaSessionState;
|
||
if (ssRec === window.OtaSessionState.FAILED ||
|
||
ssRec === window.OtaSessionState.DONE) {
|
||
window.otaSessionReset();
|
||
addLog('I', '系统', '已清理终态 OTA 会话残留');
|
||
}
|
||
}
|
||
if (window.isEsp32Rebooting ||
|
||
window.otaSessionState === window.OtaSessionState.REBOOTING) {
|
||
var rbElapsed = Math.round((Date.now() - window.rebootStartTime) / 1000);
|
||
if (!window.rebootObservedDown && rbElapsed < 10) {
|
||
// pre-reboot 窗口：后端发响应后约 1s 才 esp_restart，期间设备仍响应轮询
|
||
// 保持"重启中"状态，不清除标志，不推进阶段
|
||
// ★ 真正的"重启完成"由 pollLogs 收到启动 banner（MAIN: ESP32-C3 OTA Relay v1.0 启动）触发
|
||
} else {
|
||
// 设备已重启并恢复在线（rebootObservedDown=true）
|
||
// 或超 10s 安全阈值仍未观察到下线（重启过快未捕获或未重启）——接受恢复
|
||
window.isEsp32Rebooting = false;
|
||
window.rebootObservedDown = false;
|
||
window.updateEsp32StagesFromPhase(6); // 启动完成
|
||
addLog('I', '系统', 'ESP32 已恢复在线');
|
||
showToast('ESP32 已恢复在线', 'success');
|
||
// ★ 状态机：ESP32 重启完成 → DONE
|
||
if (window.otaSessionState === window.OtaSessionState.REBOOTING) {
|
||
window.otaSessionTransition(window.OtaSessionState.DONE);
|
||
}
|
||
if (typeof window.updateUploadButtonLabel === 'function') {
|
||
window.updateUploadButtonLabel();
|
||
}
|
||
}
|
||
}
|
||
try { window.updateSystemStatusUi(data); } catch (e2) { console.warn('updateSystemStatusUi 异常:', e2); }
|
||
// pre-reboot 窗口内 updateSystemStatusUi 会把连接胶囊刷成"已连接"，需覆盖回"重启中"
|
||
if (window.isEsp32Rebooting) {
|
||
window.applyRebootingRuntimeState();
|
||
}
|
||
}
|
||
clearTimeout(pollTimer);
|
||
} catch (e) {
|
||
clearTimeout(pollTimer);
|
||
// 自身 AbortController 触发的取消不算失败，静默返回
|
||
if (e && e.name === "AbortError") return;
|
||
// 后台期间 setInterval 会被 Chrome/Edge 节流到最低 1 分钟/次，
|
||
// 因此后台累积的失败计数不应递增，避免切回前台瞬间误触发 5-fail 诊断。
|
||
if (pageVisible) window.consecutivePollFailures++;
|
||
// 判断设备是否处于"已知忙/重启"状态（依据最近一次成功轮询的 sys_state_code）：
|
||
// 1=GD32_STORING, 3=GD32_RELAYING, 5=ESP32_RECEIVING,
|
||
// 6=ESP32_FINALIZING, 7=ESP32_REBOOTING
|
||
// 也包含 relay_state 非 IDLE（1-4 表示握手/协商/传输/收尾）
|
||
var lastDeviceBusy =
|
||
window.lastSysStateCode === 1 || window.lastSysStateCode === 3 ||
|
||
window.lastSysStateCode === 5 || window.lastSysStateCode === 6 ||
|
||
window.lastSysStateCode === 7 ||
|
||
(window.lastRelayState >= 1 && window.lastRelayState <= 4);
|
||
// OTA/传输/重启中屏蔽网关无响应的检测功能（设备忙或正在重启，无法响应轮询是正常的）
|
||
// 设备已知忙时：保持 1s 轮询，不触发降速诊断，避免错过设备恢复的即时反馈
|
||
// ★ 状态机：用统一的会话活跃/失败判断替代散布的标志。
|
||
// FAILED 态不触发诊断降速（让用户尽快看到设备恢复），但也不覆盖失败 UI。
|
||
var sessionActive = window.otaSessionActive();
|
||
var sessionFailed = window.otaSessionState === window.OtaSessionState.FAILED;
|
||
if (pageVisible && window.consecutivePollFailures >= 5 && !sessionActive && !window.isEsp32Rebooting && !window.currentOtaTarget && !lastDeviceBusy && !sessionFailed) {
|
||
addLog('W', '诊断', '设备连续 5 次无响应，正在诊断网络...');
|
||
var diag = await diagnoseNetwork();
|
||
addLog('W', '诊断', diag);
|
||
updateConnectionUi(false, '未连接');
|
||
window.applyDisconnectedRuntimeState();
|
||
var cst = document.getElementById('connStatusTxt');
|
||
if (cst) cst.textContent = '诊断中: ' + diag;
|
||
}
|
||
// ★ 状态机优先：会话已 FAILED → 保持失败 UI，仅标连接胶囊为"设备忙/未连接"
|
||
if (sessionFailed) {
|
||
if (lastDeviceBusy) {
|
||
// 设备端仍在跑（中继没停），标"设备忙"但不覆盖进度/阶段
|
||
var pcF = document.getElementById('pillConn');
|
||
var pctF = document.getElementById('pillConnTxt');
|
||
if (pcF) pcF.className = 'pill processing';
|
||
if (pctF) pctF.textContent = '设备忙';
|
||
var csF = document.getElementById('connStatus');
|
||
var cstF = document.getElementById('connStatusTxt');
|
||
if (csF) csF.className = 'conn-indicator warn';
|
||
if (cstF) cstF.textContent = '设备忙（OTA 后台运行中），等待回 IDLE';
|
||
updateConnectionUi(true, '设备忙');
|
||
} else {
|
||
// 设备已回 IDLE：连接胶囊显示未连接，但失败进度保留
|
||
updateConnectionUi(false, '未连接');
|
||
}
|
||
} else if (window.otaSessionState === window.OtaSessionState.UPLOADING) {
|
||
window.applyUploadingRuntimeState();
|
||
} else if (window.otaSessionState === window.OtaSessionState.REBOOTING || window.isEsp32Rebooting) {
|
||
window.rebootObservedDown = true; // 确认设备已下线（正在重启）
|
||
var elapsed = Math.round((Date.now() - window.rebootStartTime) / 1000);
|
||
if (elapsed > 60) {
|
||
// ★ 统一走 cleanupAfterOtaFailure：清 xhr/定时器/按钮/阶段，避免只改 state 留下假死 UI
|
||
addLog('E', '系统', 'ESP32 重启超时，设备未恢复');
|
||
showToast('ESP32 重启超时，请检查设备', 'error');
|
||
if (typeof window.cleanupAfterOtaFailure === 'function') {
|
||
window.cleanupAfterOtaFailure('ESP32 重启超时');
|
||
} else {
|
||
window.otaSessionTransition(window.OtaSessionState.FAILED, 'ESP32 重启超时');
|
||
window.isEsp32Rebooting = false;
|
||
window.rebootObservedDown = false;
|
||
}
|
||
updateConnectionUi(false, '未连接');
|
||
window.applyDisconnectedRuntimeState();
|
||
} else {
|
||
window.applyRebootingRuntimeState();
|
||
}
|
||
} else if (sessionActive || lastDeviceBusy) {
|
||
// 设备在 OTA/中继/重启期间不响应是正常的：保持 1s 轮询，UI 标记为"设备忙"
|
||
// 不调用 applyRebootingRuntimeState（避免显示"重启中 Xs"误导）
|
||
var pc = document.getElementById('pillConn');
|
||
var pct = document.getElementById('pillConnTxt');
|
||
if (pc) pc.className = 'pill processing';
|
||
if (pct) pct.textContent = '设备忙';
|
||
var cs = document.getElementById('connStatus');
|
||
var cst = document.getElementById('connStatusTxt');
|
||
if (cs) cs.className = 'conn-indicator warn';
|
||
if (cst) cst.textContent = '设备忙（OTA/重启中），保持 1s 轮询';
|
||
updateConnectionUi(true, '设备忙');
|
||
} else {
|
||
updateConnectionUi(false, '未连接');
|
||
window.applyDisconnectedRuntimeState();
|
||
}
|
||
} finally {
|
||
statusPollInFlight = false;
|
||
statusAbortCtrl = null;
|
||
/* 固定周期调度：interval 从本轮开始计时扣减请求耗时。
|
||
* 旧逻辑「完成后 + 1000ms」→ 窗口稳定 1100+；现 sample_ms 贴近 1000/400。
|
||
* 本轮超时/很慢时 delay=0，立即补下一轮，仍不重叠。 */
|
||
var elapsed = Date.now() - pollStartedAt;
|
||
var delay = Math.max(0, statusPollIntervalMs - elapsed);
|
||
scheduleStatusPoll(delay);
|
||
}
|
||
}
|
||
// 注意：startPoll() 由入口模块（app.js / ble_ota.js）在所有模块加载完成后调用，
|
||
// 此处不在模块顶层自动启动，避免 ESM 求值顺序导致 window.OtaSessionState 尚未初始化。
|
||
// ==================== Page Visibility 补偿 ====================
|
||
// Chrome/Edge 在标签隐藏/窗口最小化时会把 setInterval 节流到最低 1 分钟/次。
|
||
// 切回前台时立即拉一次状态 + 日志，并清零后台期间累积的失败计数，
|
||
// 避免在"刚切回前台那一轮"被误判为 5-fail 离线。
|
||
document.addEventListener('visibilitychange', function () {
|
||
pageVisible = !document.hidden;
|
||
if (!pageVisible) return;
|
||
window.consecutivePollFailures = 0;
|
||
// 切回前台立即刷新状态；若当前已在请求中，取消等待中的下一次让它尽快重排
|
||
if (statusPollInFlight) {
|
||
if (statusTimerId) clearTimeout(statusTimerId);
|
||
} else {
|
||
if (statusTimerId) clearTimeout(statusTimerId);
|
||
scheduleStatusPoll(0);
|
||
}
|
||
pollLogs();
|
||
});
|
||
// ==================== ESP32 实时日志拉取 (增量) ====================
|
||
var lastLogTimestamp = 0;
|
||
/** @description 轮询 ESP32 日志（GET /logs）并追加到日志面板。 */
|
||
export async function pollLogs() {
|
||
// ★ ESP32 上传期间也允许日志轮询
|
||
try {
|
||
var resp = await fetch(window.getBaseUrl() + '/logs', {
|
||
signal: AbortSignal.timeout(5000)
|
||
});
|
||
if (!resp.ok) return;
|
||
var logs = await resp.json();
|
||
if (!Array.isArray(logs) || logs.length === 0) return;
|
||
var levelMap = { E: 'E', W: 'W', I: 'I', D: 'D' };
|
||
logs.forEach(function (line) {
|
||
var m = line.match(/^\[([EWID])\]\[([^\]]+)\]\s*(.*)$/);
|
||
if (m) {
|
||
addLog(levelMap[m[1]] || 'I', m[2], m[3].trimEnd());
|
||
// ★ 复用设备启动 banner 作为 ESP32 重启完成的权威信号。
|
||
// esp_restart() 是硬件复位，不保证 TCP FIN/RST；靠轮询超时/网络错误判断
|
||
// "已下线"不可靠。设备启动后会推 [I][MAIN] ESP32-C3 OTA Relay v1.0 启动，
|
||
// 收到这行即说明设备已重启回来，直接推进到阶段 6（启动完成）。
|
||
/* 与 main 启动 banner 对齐：ESP32-C3 OTA Relay <FW_VERSION> 启动（勿写死 v1.0） */
|
||
if (window.isEsp32Rebooting && m[2] === 'MAIN' && /OTA Relay .*启动/.test(m[3])) {
|
||
window.isEsp32Rebooting = false;
|
||
window.rebootObservedDown = false;
|
||
window.updateEsp32StagesFromPhase(6); // 启动完成
|
||
addLog('I', '系统', 'ESP32 已恢复在线（启动 banner 收到）');
|
||
showToast('ESP32 已恢复在线', 'success');
|
||
if (window.otaSessionState === window.OtaSessionState.REBOOTING) {
|
||
window.otaSessionTransition(window.OtaSessionState.DONE);
|
||
}
|
||
if (typeof window.updateUploadButtonLabel === 'function') {
|
||
window.updateUploadButtonLabel();
|
||
}
|
||
}
|
||
/*
|
||
* 设备已报「全部数据包已转发」时，立刻补 UI 100% 进度。
|
||
* status 轮询可能仍停在旧 relay_seq，否则会出现 FINISH 日志之后还刷 94%。
|
||
*/
|
||
if (m[2] === 'OTA' && /全部数据包已转发/.test(m[3]) &&
|
||
typeof window.emitRelayProgress === 'function') {
|
||
var otaSnap = (window.latestSystemStatus && window.latestSystemStatus.ota) || {};
|
||
var tot = Number(otaSnap.relay_total_packets) || 0;
|
||
if (tot > 0) {
|
||
window.emitRelayProgress(tot, tot, { force100: true });
|
||
}
|
||
}
|
||
} else {
|
||
addLog('I', 'ESP32', line.trimEnd());
|
||
}
|
||
});
|
||
} catch (e) { /* 静默 */ }
|
||
}
|
||
setTimeout(function () {
|
||
window.updateUploadButtonLabel();
|
||
addLog('I', '系统', '控制台初始化完成，等待固件文件...');
|
||
// IP 输入变化时清零失败计数并立即刷新状态
|
||
var ipInput = document.getElementById('espIp');
|
||
if (ipInput) {
|
||
ipInput.addEventListener('change', function () {
|
||
window.consecutivePollFailures = 0;
|
||
addLog('I', '系统', 'IP 已修改，重新启动轮询...');
|
||
if (!statusPollInFlight) {
|
||
if (statusTimerId) clearTimeout(statusTimerId);
|
||
scheduleStatusPoll(0);
|
||
}
|
||
});
|
||
}
|
||
}, 500);
|