init: DCU ESP32 调试控制台前端与本地页面服务

纯前端上位机界面 + esp32_server.py 静态服务/桌面窗口外壳, 不含固件、不直接访问硬件; 业务 API 由 ESP32_COMM 固件 80 端口跨域提供。 - tabs.html 单窗口多标签外壳, iframe 承载各功能页 - index.html OTA 中继(ESP32 WiFi / GD32 relay / BLE), js/ota + js/ble - can.html / can_monitor.html CAN 通信与接收监控, js/can - motor.html 电机 CAN FD 控制台, js/motor - continuity_test.html LAN9252 通断测试, spi_test.html SPI 测速(临时, 自包含) - 三入口: esp32_app.vbs 桌面窗口 / esp32_web.vbs 浏览器 / serve.bat 控制台调试 - 补 README(页面与目录约定、?v= 缓存版本等改动须知)、.gitignore、 .gitattributes(* -text 保持 Windows 换行原样)
2026-09-03 21:30:32 +08:00
commit d2c86c425a
54 changed files with 20643 additions and 0 deletions
@@ -0,0 +1,253 @@
+// ==================== BLE OTA 文件准备与分包 ====================
+//
+// ★ 上传中拦截策略（全文件统一）：file.js 是 BLE 通道文件操作的唯一入口，
+//   transfer.js / state.js / session.js / 外部 bleOta.notifyFileChange 都汇聚到这里。
+//   isBleUploading()（state.js）= state.uploading || state.autoFlashing；
+//   window.isUploading = WiFi 通道 OTA 会话是否处于 UPLOADING（ota/session.js 维护）。
+//   两者任一为真即视为上传中，禁止重置进度条/阶段/清空文件，避免覆盖进行中的 OTA。
+import { state, els, bleLog, currentTarget, currentPayloadSize, setConnectionState, isBleUploading } from './state.js';
+import { setBleStage, setBleStageText, resetBleStages } from './stages.js';
+import { setProgress } from './transfer.js';
+import { hideBleVerifyInfo } from './verify.js';
+import { formatBytes } from '../common/utils.js';
+import { showToast } from '../common/toast.js';
+import { computeFileSha, checkGd32ImageFile } from '../ota/file-handle.js';
+
+/** 任一通道上传中（BLE 或 WiFi）。focus/change 等不分通道的事件用此判定。 */
+function isAnyChannelUploading() {
+  return isBleUploading() || (typeof window.isUploading !== 'undefined' && !!window.isUploading);
+}
+
+export function updateFileInfo(file) {
+  // ★ 上传进行中禁止重置进度/阶段
+  if (isBleUploading() && file && state.selectedFile) {
+    bleLog('FILE', '上传进行中，跳过 updateFileInfo 进度重置', 'D');
+    return Promise.resolve();
+  }
+
+  els.fileName.textContent = file ? file.name : '-';
+  els.fileType.textContent = file ? (file.name.toLowerCase().includes('.hex') ? 'Intel HEX' : 'Binary') : '-';
+  els.fileSize.textContent = file ? formatBytes(file.size) : '0 B';
+  const payloadSize = currentPayloadSize();
+  const packets = file ? Math.ceil(file.size / payloadSize) : 0;
+  els.packetCount.textContent = String(packets);
+  els.sentCount.textContent = '0';
+
+  state.selectedFile = file || null;
+  state.lastUploadStatus = 'idle';
+
+  if (els.fileInfo) {
+    if (file) els.fileInfo.classList.add('show');
+    else els.fileInfo.classList.remove('show');
+  }
+
+  // ★ HEX → BIN：必须用 window.convertHexFileToBin（本模块未 import，裸名会 ReferenceError）
+  if (file && file.name.toLowerCase().endsWith('.hex') && typeof window.convertHexFileToBin === 'function') {
+    return window.convertHexFileToBin(file).then(function(result) {
+      if (!result.converted) {
+        bleLog('FILE', file.name + ' 扩展名为 .hex 但内容不像 HEX 格式，按原始文件处理', 'W');
+        finalizeAndHash(file);
+        return;
+      }
+      state.selectedFile = result.file;
+      var baseHex = '0x' + result.baseAddr.toString(16).toUpperCase().padStart(8, '0');
+      bleLog('FILE', 'HEX → BIN 转换完成: ' + file.name + ' → ' + result.file.name + ' (基地址 ' + baseHex + ', ' + formatBytes(result.file.size) + ')');
+      showToast('HEX 已自动转换为 BIN', 'success');
+      els.fileName.textContent = result.file.name + ' (由 ' + file.name + ' 转换)';
+      els.fileType.textContent = 'Binary (HEX转换)';
+      els.fileSize.textContent = formatBytes(result.file.size);
+      var newPackets = Math.ceil(result.file.size / payloadSize);
+      els.packetCount.textContent = String(newPackets);
+      finalizeAndHash(result.file);
+    }).catch(function(err) {
+      bleLog('FILE', 'HEX 解析失败: ' + err.message, 'E');
+      showToast('HEX 文件解析失败: ' + err.message, 'error');
+      state.selectedFile = null;
+      state.fileSha256 = null;
+      if (els.fileInfo) els.fileInfo.classList.remove('show');
+      setConnectionState(!!state.server);
+    });
+  }
+
+  finalizeAndHash(file);
+  return Promise.resolve();
+}
+
+function finalizeAndHash(file) {
+  /* GD32 目标：选文件时即判定包身份，BOOT 包不进上传队列（设备端还有兜底）
+     file 为 null 表示"没有选文件"（清空 / focus 时 input 为空），不是身份不符，不得报错 */
+  var chip = (window.flashTarget === 'gd32') ? 'gd32' : 'esp32';
+  if (chip === 'gd32' && file) {
+    return checkGd32ImageFile(file).then(function (id) {
+      if (!id.ok) {
+        var msg = id.kind === 'bootloader'
+          ? '检测到 Bootloader 固件，不能刷入 APP 区，请选择 APP 固件'
+          : id.kind === 'none'
+            ? '未选择固件文件'
+            : '文件不是合法的 GD32 APP 固件（向量表非法），已拒绝';
+        bleLog('FILE', msg, 'E');
+        showToast(msg, 'error');
+        state.selectedFile = null;
+        state.fileSha256 = null;
+        els.fileName.textContent = '-';
+        if (els.fileInfo) els.fileInfo.classList.remove('show');
+        setConnectionState(!!state.server);
+        return;
+      }
+      finalizeFileInfo(file);
+      computeBleFileSha(file);
+    });
+  }
+  finalizeFileInfo(file);
+  computeBleFileSha(file);
+  return Promise.resolve();
+}
+
+function finalizeFileInfo(file) {
+  if (isBleUploading()) {
+    bleLog('FILE', '上传进行中，跳过 finalizeFileInfo 进度重置', 'D');
+    return;
+  }
+  setConnectionState(!!state.server);
+  if (file) {
+    setProgress(0, `已选择 ${file.name}`);
+    bleLog('FILE', `已选择: ${file.name} (${formatBytes(file.size)}), 目标=${currentTarget().label}`);
+  } else {
+    setProgress(0, '等待选择文件');
+    if (state.server) {
+      resetBleStages();
+      setBleStage(3, '', null);
+      setBleStageText('BLE 连接就绪，请选择固件文件');
+    }
+  }
+}
+
+/**
+ * BLE 侧：读对应芯片槽；槽里已有则直接用，没有才算一次。
+ * 不跨芯片、不互切。
+ */
+function computeBleFileSha(file) {
+  var shaElem = document.getElementById('fileSha256');
+  if (!file) {
+    if (shaElem) shaElem.textContent = '-';
+    state.fileSha256 = null;
+    return;
+  }
+  var chip = (window.flashTarget === 'gd32') ? 'gd32' : 'esp32';
+  var existing = chip === 'gd32' ? window._gd32FileSha256 : window._esp32FileSha256;
+  if (existing) {
+    state.fileSha256 = existing;
+    if (shaElem) shaElem.textContent = existing;
+    if (state.server) {
+      setBleStage(3, 'SHA-256 已计算', null);
+      setBleStage(4, '', null);
+      setBleStageText('文件就绪，可以开始刷写');
+    }
+    return;
+  }
+  if (state.server) {
+    setBleStage(3, '计算哈希...', 'active');
+    setBleStageText('正在计算文件 SHA-256...');
+  }
+  computeFileSha(file, chip).then(function(hashHex) {
+    if (!hashHex) {
+      state.fileSha256 = null;
+      return;
+    }
+    state.fileSha256 = hashHex;
+    if (state.server) {
+      setBleStage(3, 'SHA-256 已计算', null);
+      setBleStage(4, '', null);
+      setBleStageText('文件就绪，可以开始刷写');
+    }
+  });
+}
+
+export async function syncSelectedFileFromInput() {
+  // ★ 上传进行中禁止同步：window focus / file input change 事件会在上传期间
+  //   触发本函数，若不拦截会通过 updateFileInfo 把进度条重置为"等待选择文件 0%"。
+  //   ★ 必须同时拦截 WiFi 通道上传：focus 事件不分通道，WiFi 刷写时点击网页/切标签
+  //   回来会触发本函数 → finalizeFileInfo → setProgress(0)，把进度"闪一下"归零，
+  //   直到下一次 XHR progress 事件才恢复。
+  if (isAnyChannelUploading()) return;
+  // FSAPI 选择的文件以 selectedFileHandle 为准，不从 input 元素同步，避免切标签页回来误清空
+  if (state.selectedFileHandle) return;
+  const file = (els.firmwareFile && els.firmwareFile.files && els.firmwareFile.files[0]) || null;
+  // ★ 拖拽 / notifyFileChange 送进来的文件不在 input 元素里（handle 也为 null），
+  //   focus 时 input 为空不代表用户取消了选择，不能用 null 覆盖已有选择。
+  if (!file && state.selectedFile) return;
+  await updateFileInfo(file);
+}
+
+// 通过 File System Access API 选择文件（支持热重载）
+export async function pickFileViaFSAPI() {
+  if (!window.showOpenFilePicker) {
+    bleLog('FILE', '当前浏览器不支持 File System Access API', 'W');
+    return false;
+  }
+  try {
+    const pickerOpts = {
+      id: 'dcu-fw-ble',
+      types: [{ description: '固件文件', accept: { 'application/octet-stream': ['.bin', '.hex'] } }],
+      multiple: false
+    };
+    /* 再次选择时定位到刷新/上次已选文件所在目录 */
+    if (state.selectedFileHandle) {
+      pickerOpts.startIn = state.selectedFileHandle;
+    }
+    const handles = await window.showOpenFilePicker(pickerOpts);
+    if (handles && handles.length > 0) {
+      const handle = handles[0];
+      const file = await handle.getFile();
+      state.selectedFileHandle = handle;
+      await updateFileInfo(file);
+      bleLog('FILE', '已通过 FSAPI 选择文件（支持热重载）: ' + file.name);
+      return true;
+    }
+  } catch (e) {
+    if (e.name !== 'AbortError') {
+      bleLog('FILE', 'FSAPI 选择失败: ' + e.message, 'W');
+    }
+  }
+  return false;
+}
+
+export function clearSelectedFile() {
+  // ★ 上传进行中禁止清除文件：防止目标切换/模式切换在上传期间清空文件引用，
+  //   导致进度条被重置为"等待选择文件 0%"并中断上传数据源。
+  if (isBleUploading()) {
+    bleLog('FILE', '上传进行中，拒绝清除文件', 'W');
+    return;
+  }
+  state.selectedFile = null;
+  state.selectedFileHandle = null;
+  state.lastUploadStatus = 'idle';
+  state.fileSha256 = null;
+  state.deviceSha256 = null;
+  if (els.firmwareFile) els.firmwareFile.value = '';
+  updateFileInfo(null);  // 内部 finalizeFileInfo(null) 已重置进度条并恢复「连接就绪」stage
+  hideBleVerifyInfo();
+  bleLog('FILE', '文件已清除');
+}
+
+// 别名导出，与 window.bleOta.clearFile 对齐
+export { clearSelectedFile as clearFile };
+
+/**
+ * 外部文件变更通知（index.html 拖拽 / console-mode 切换等）。
+ * ★ 守卫集中在此：file.js 是 BLE 文件操作唯一入口，外部包装层（ble_ota.js）不再重复守卫。
+ */
+export async function notifyFileChange(file, handle) {
+  if (isAnyChannelUploading()) {
+    bleLog('FILE', '上传进行中，忽略外部 notifyFileChange', 'D');
+    return;
+  }
+  if (file) {
+    /* 始终更新 handle（含 null），避免切目标后仍热重载到上一芯片的文件 */
+    state.selectedFileHandle = handle || null;
+    await updateFileInfo(file);
+  } else {
+    state.selectedFileHandle = null;
+    await updateFileInfo(null);
+  }
+}