变更点: 1. esp32_server.py - /api/motor/ui-state、/api/lab/ui-state:配置原子落盘 data/*.json(WebView2 清存储仍在) - _GuiApi.ecat_api/bridge_info:桌面壳经 GUI 进程裸 socket 直连 ecat_native,不经浏览器 HTTP 2. js/common/desktop-bridge.js(新) - 探测 pywebview.api(含 iframe top/parent),transport-ecat 优先走原生桥 3. connection.js + responsive.css + components.css - setQuietMode:离线且无传输时 html[data-dcu-calm=1] 掐常驻动画 - 进度条斜纹仅 .live 挂载,空闲不再按刷新率空转重绘 4. device-link.js - 先查 native/health,已健康跳过 motor/start,避免 loop_stop 重进 OP 假超时 - 周期强制 0.25ms + DC SYNC0 对齐;轮询自愈被配错的 DC/周期 5. motor/main.js + transport-ecat.js - 配置双写 localStorage + 磁盘 ui-state;pagehide/sendBeacon 刷盘;导入导出 - 探测代际 probeGen;ECAT 失败阈值 12;跟踪 bootActive/slaveAl/slaveOp 6. lab/spi_test.html、ota/boot_ecat.js、can_monitor 等跟随桥/静默态 7. .gitignore - 排除 scripts/_* 与 anal/collect/measure/trace 等调试脚本、lab 产物、data/ 运行态
78 lines
3.0 KiB
JavaScript
78 lines
3.0 KiB
JavaScript
/**
|
||
* utils.js - 通用工具函数
|
||
*
|
||
* 格式化 / 转义工具函数,供各子模块和 can.js / can_monitor.js 共享。
|
||
*/
|
||
// ==================== 工具函数 ====================
|
||
/** @description 格式化字节大小为人类可读字符串(B/KB/MB)。 */
|
||
/** @description 字节格式化为 B / KB(不升到 MB,避免 1024KB 显示成 1.00MB)。 */
|
||
export function formatBytes(bytes) {
|
||
if (!Number.isFinite(bytes) || bytes < 0) return '--';
|
||
if (bytes < 1024) return bytes + ' B';
|
||
var kb = bytes / 1024;
|
||
if (Math.abs(kb - Math.round(kb)) < 1e-9) return Math.round(kb) + ' KB';
|
||
return kb.toFixed(1) + ' KB';
|
||
}
|
||
/** @description 格式化 Date 对象为 HH:MM:SS.mmm 时间字符串。 */
|
||
export function formatTime(date) {
|
||
var h = String(date.getHours()).padStart(2, '0');
|
||
var m = String(date.getMinutes()).padStart(2, '0');
|
||
var s = String(date.getSeconds()).padStart(2, '0');
|
||
var ms = String(date.getMilliseconds()).padStart(3, '0');
|
||
return h + ':' + m + ':' + s + '.' + ms;
|
||
}
|
||
/** @description 格式化秒数为人类可读运行时间(d/h/m/s)。 */
|
||
export function formatUptime(sec) {
|
||
if (!Number.isFinite(sec) || sec < 0) return '--';
|
||
const d = Math.floor(sec / 86400);
|
||
const h = Math.floor((sec % 86400) / 3600);
|
||
const m = Math.floor((sec % 3600) / 60);
|
||
const s = Math.floor(sec % 60);
|
||
if (d > 0) return d + 'd ' + h + 'h ' + m + 'm';
|
||
if (h > 0) return h + 'h ' + m + 'm ' + s + 's';
|
||
if (m > 0) return m + 'm ' + s + 's';
|
||
return s + 's';
|
||
}
|
||
/** @description 转义 HTML 特殊字符,防止 XSS 注入。 */
|
||
export function escapeHtml(text) {
|
||
return String(text == null ? '' : text)
|
||
.replace(/&/g, '&')
|
||
.replace(/</g, '<')
|
||
.replace(/>/g, '>')
|
||
.replace(/"/g, '"')
|
||
.replace(/'/g, ''');
|
||
}
|
||
/**
|
||
* @description 将字节数组(Uint8Array 或 ArrayBuffer)转为小写 hex 字符串。
|
||
* SHA-256 等哈希显示前需要 toUpperCase()。
|
||
* @param {Uint8Array|ArrayBuffer} bytes
|
||
* @returns {string}
|
||
*/
|
||
export function bytesToHex(bytes) {
|
||
var arr = bytes instanceof Uint8Array ? bytes : new Uint8Array(bytes);
|
||
var out = '';
|
||
for (var i = 0; i < arr.length; i++) {
|
||
var h = arr[i].toString(16);
|
||
if (h.length < 2) h = '0' + h;
|
||
out += h;
|
||
}
|
||
return out;
|
||
}
|
||
|
||
/**
|
||
* @description 当前是否有刷写/OTA 在跑(跨 iframe 共享)。
|
||
* 多 iframe 保活外壳下各功能页是**独立文档**,window 变量不通用(刷写页的
|
||
* window.bootEcatBusy 在 CAN 页里读不到),所以走 localStorage 这一条共享通道:
|
||
* 刷写方(js/ota/boot_ecat.js)写 dcu_flash_busy_until = 预计结束时刻(ms),
|
||
* 轮询方据此避让。带到期时间,页面中途关掉/异常也不会把标记永久挂住。
|
||
* @returns {boolean} 刷写窗口内为 true
|
||
*/
|
||
export function flashBusyNow() {
|
||
try {
|
||
var until = parseInt(localStorage.getItem('dcu_flash_busy_until'), 10);
|
||
return Number.isFinite(until) && until > Date.now();
|
||
} catch (_) {
|
||
return false;
|
||
}
|
||
}
|