纯前端上位机界面 + 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 换行原样)
254 lines
10 KiB
JavaScript
254 lines
10 KiB
JavaScript
// ==================== 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);
|
||
}
|
||
}
|