// ==================== 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); } }