小龙虾
33b41fd50a
添加了完整的前端架构约定文档 (frontend_architecture.md)， 包含以下主要内容： - 架构总览：Web资源本地托管方式和零构建方案 - 页面薄入口范式：HTML结构与ES Modules入口约定 - JS分层架构：common/ota/ble/can/motor等目录结构说明 - 缓存戳约定：版本管理强制要求 - 公共层API契约：baseUrl/toast/polling等接口规范 - motor页特殊性：独立主题和轮询链路处理 - 红线区域：不可动代码范围说明 - 回归清单：各页面功能验证checklist 同时移除了build相关的临时文件
351 lines
12 KiB
JavaScript
351 lines
12 KiB
JavaScript
/**
|
||
* dbc.js - DBC 解析器 + 共享状态/元素缓存/基础工具
|
||
*
|
||
* 包含：共享 state/el、基础工具、DBC 解析、cssEscape、readDbcText。
|
||
*
|
||
* 本模块是 can 子系统的基础层，不依赖其他 can 子模块；state/el 在此导出，
|
||
* 供 messages/signals/send 共享（ES Module 的 live binding 保证引用一致）。
|
||
*/
|
||
import {
|
||
DEFAULT_ESP_IP, getSavedDeviceIp, saveDeviceIp
|
||
} from '../common/base-url.js';
|
||
|
||
// ==================== 共享状态 ====================
|
||
export var state = {
|
||
/** @type {{ id: string, name: string, size: number, dbc: object }[]} */
|
||
dbcSources: [],
|
||
/** 合并视图 { messages, nodeNames, messageMap }；由 rebuildMergedDbc() 维护 */
|
||
dbc: null,
|
||
filteredMessages: [],
|
||
selectedMessageKey: '',
|
||
signalValues: {},
|
||
checkedKeys: {},
|
||
expandedKeys: {},
|
||
transmitterFilter: Object.create(null),
|
||
transmitterFilterEmpty: true,
|
||
generatedData: new Uint8Array(0),
|
||
history: [],
|
||
latestStatus: null,
|
||
batchInFlight: false
|
||
};
|
||
|
||
// ==================== 共享元素缓存 ====================
|
||
// 由入口文件（js/can.js）的 cacheElements() 填充，各子模块通过 import 引用同一对象。
|
||
export var el = {};
|
||
|
||
// ==================== 基础工具 ====================
|
||
// IP 存取通用实现在 common/base-url.js，此处包装 CAN 页特有的 el.toolIp 回退。
|
||
|
||
/** @description 设备 IP：优先 localStorage（与 OTA 页共用），其次页面输入框，否则默认。 */
|
||
export function getDeviceIp() {
|
||
var saved = getSavedDeviceIp();
|
||
if (saved) return saved;
|
||
if (el.toolIp && el.toolIp.value && el.toolIp.value.trim()) {
|
||
return el.toolIp.value.trim();
|
||
}
|
||
return DEFAULT_ESP_IP;
|
||
}
|
||
|
||
/** @description 记住设备 IP（status 回报或其它页写入）。 */
|
||
export function setDeviceIp(ip) {
|
||
if (!ip || !String(ip).trim()) return;
|
||
var v = String(ip).trim();
|
||
saveDeviceIp(v);
|
||
if (el.toolIp) el.toolIp.value = v;
|
||
}
|
||
|
||
/** @description 拼接设备基础 URL（http://<ip>）。 */
|
||
export function getBaseUrl() {
|
||
return 'http://' + getDeviceIp();
|
||
}
|
||
|
||
/** @description 解析手动输入的 CAN ID（支持 0x/hex/十进制）。 */
|
||
export function parseNumericId(input) {
|
||
var raw = String(input == null ? '' : input).trim();
|
||
if (!raw) return NaN;
|
||
if (/^0x/i.test(raw)) return parseInt(raw, 16);
|
||
if (/^[0-9]+$/.test(raw)) return parseInt(raw, 10);
|
||
if (/^[0-9a-fA-F]+h$/i.test(raw)) return parseInt(raw.slice(0, -1), 16);
|
||
if (/^[0-9a-fA-F]+$/.test(raw)) return parseInt(raw, 16);
|
||
return NaN;
|
||
}
|
||
|
||
/** @description 将数值格式化为指定宽度的十六进制大写字符串。 */
|
||
export function padHex(value, width) {
|
||
return value.toString(16).toUpperCase().padStart(width, '0');
|
||
}
|
||
|
||
/** @description 将字节数组转为连续的十六进制字符串。 */
|
||
export function bytesToHex(bytes) {
|
||
if (!bytes || !bytes.length) return '';
|
||
var parts = [];
|
||
for (var i = 0; i < bytes.length; i++) {
|
||
parts.push(padHex(bytes[i], 2));
|
||
}
|
||
return parts.join('');
|
||
}
|
||
|
||
/** @description 转义 CSS 选择器中的特殊字符。 */
|
||
export function cssEscape(value) {
|
||
if (window.CSS && CSS.escape) return CSS.escape(value);
|
||
/* fallback：每个非安全字符前加单个反斜杠（CSS 转义），双引号属性值内可安全使用 */
|
||
return String(value).replace(/[^a-zA-Z0-9_-]/g, function (ch) { return '\\' + ch; });
|
||
}
|
||
|
||
/** @description 去除回车并 trim，用于 DBC 搜索等输入归一化。 */
|
||
export function normalizeWhitespace(text) {
|
||
return String(text || '').replace(/\r/g, '').trim();
|
||
}
|
||
|
||
// ==================== DBC 文件读取 ====================
|
||
/** @description 读取 DBC 文件文本，优先 UTF-8，失败回退 GB18030，自动去 BOM。 */
|
||
export async function readDbcText(file) {
|
||
var buf = await file.arrayBuffer();
|
||
var bytes = new Uint8Array(buf);
|
||
var stripBom = function (s) {
|
||
return (s && s.charCodeAt(0) === 0xFEFF) ? s.slice(1) : s;
|
||
};
|
||
try {
|
||
var strictUtf8 = new TextDecoder('utf-8', { fatal: true });
|
||
return stripBom(strictUtf8.decode(bytes));
|
||
} catch (e) {
|
||
try {
|
||
var gb = new TextDecoder('gb18030');
|
||
return stripBom(gb.decode(bytes));
|
||
} catch (e2) {
|
||
return stripBom(new TextDecoder('utf-8').decode(bytes));
|
||
}
|
||
}
|
||
}
|
||
|
||
// ==================== DBC 解析 ====================
|
||
/** @description 解析 DBC 文本，返回 { messages, nodeNames, messageMap }。 */
|
||
export function parseDbc(text) {
|
||
var lines = String(text || '').replace(/\r/g, '').split('\n');
|
||
var messages = [];
|
||
var messageMap = {};
|
||
var comments = { messages: {}, signals: {} };
|
||
var valueTables = {};
|
||
var sigDefaults = {};
|
||
var nodeNames = [];
|
||
var current = null;
|
||
|
||
for (var i = 0; i < lines.length; i++) {
|
||
var line = lines[i].trim();
|
||
if (!line) continue;
|
||
|
||
var nodeMatch = line.match(/^BU_\s*:\s*(.*)$/);
|
||
if (nodeMatch) {
|
||
nodeNames = nodeMatch[1].trim() ? nodeMatch[1].trim().split(/\s+/) : [];
|
||
continue;
|
||
}
|
||
|
||
var messageMatch = line.match(/^BO_\s+(\d+)\s+([A-Za-z0-9_]+)\s*:\s*(\d+)\s+(.+)$/);
|
||
if (messageMatch) {
|
||
current = {
|
||
idRaw: parseInt(messageMatch[1], 10),
|
||
name: messageMatch[2],
|
||
dlc: parseInt(messageMatch[3], 10),
|
||
transmitter: messageMatch[4].trim(),
|
||
signals: [],
|
||
comment: ''
|
||
};
|
||
current.id = current.idRaw & 0x1FFFFFFF;
|
||
current.isExtended = current.idRaw > 0x7FF;
|
||
current.key = String(current.idRaw) + ':' + current.name;
|
||
messages.push(current);
|
||
messageMap[current.idRaw] = current;
|
||
continue;
|
||
}
|
||
|
||
var signalMatch = line.match(/^SG_\s+([A-Za-z0-9_]+)(?:\s+((?:M|m-?\d+)))?\s*:\s*(\d+)\|(\d+)@([01])([+-])\s+\(([^\),]+),([^\)]+)\)\s+\[([^\|]*)\|([^\]]*)\]\s+"([^"]*)"\s+(.+)$/);
|
||
if (signalMatch && current) {
|
||
var muxInfo = parseMultiplexToken(signalMatch[2]);
|
||
current.signals.push({
|
||
name: signalMatch[1],
|
||
startBit: parseInt(signalMatch[3], 10),
|
||
length: parseInt(signalMatch[4], 10),
|
||
byteOrder: signalMatch[5] === '1' ? 'little' : 'big',
|
||
isSigned: signalMatch[6] === '-',
|
||
factor: parseFloat(signalMatch[7]),
|
||
offset: parseFloat(signalMatch[8]),
|
||
min: signalMatch[9].trim() === '' ? null : parseFloat(signalMatch[9]),
|
||
max: signalMatch[10].trim() === '' ? null : parseFloat(signalMatch[10]),
|
||
unit: signalMatch[11],
|
||
receivers: signalMatch[12].split(/\s*,\s*/),
|
||
comment: '',
|
||
valueType: 'int',
|
||
enumMap: {},
|
||
defaultValue: null,
|
||
multiplexRole: muxInfo.role,
|
||
multiplexValue: muxInfo.value
|
||
});
|
||
continue;
|
||
}
|
||
|
||
var messageCommentMatch = line.match(/^CM_\s+BO_\s+(\d+)\s+"([\s\S]*)";$/);
|
||
if (messageCommentMatch) {
|
||
comments.messages[messageCommentMatch[1]] = messageCommentMatch[2];
|
||
continue;
|
||
}
|
||
|
||
var signalCommentMatch = line.match(/^CM_\s+SG_\s+(\d+)\s+([A-Za-z0-9_]+)\s+"([\s\S]*)";$/);
|
||
if (signalCommentMatch) {
|
||
comments.signals[signalCommentMatch[1] + ':' + signalCommentMatch[2]] = signalCommentMatch[3];
|
||
continue;
|
||
}
|
||
|
||
var valueMatch = line.match(/^VAL_\s+(\d+)\s+([A-Za-z0-9_]+)\s+(.+);$/);
|
||
if (valueMatch) {
|
||
var table = {};
|
||
var pairRe = /(-?\d+)\s+"([^"]*)"/g;
|
||
var m;
|
||
while ((m = pairRe.exec(valueMatch[3])) !== null) {
|
||
table[m[1]] = m[2];
|
||
}
|
||
valueTables[valueMatch[1] + ':' + valueMatch[2]] = table;
|
||
continue;
|
||
}
|
||
|
||
var valTypeMatch = line.match(/^SIG_VALTYPE_\s+(\d+)\s+([A-Za-z0-9_]+)\s*:\s*(\d+)\s*;$/);
|
||
if (valTypeMatch) {
|
||
var msg = messageMap[valTypeMatch[1]];
|
||
if (!msg) continue;
|
||
var signal = findSignal(msg, valTypeMatch[2]);
|
||
if (signal) {
|
||
signal.valueType = valTypeMatch[3] === '1' ? 'float' : valTypeMatch[3] === '2' ? 'double' : 'int';
|
||
}
|
||
continue;
|
||
}
|
||
|
||
/* BA_ "GenSigDefaultValue" SG_ <msgId> <signalName> <value>;
|
||
* 注意该值是物理值（已应用 factor/offset），与 GenSigStartValue（raw）不同 */
|
||
var sigDefaultMatch = line.match(/^BA_\s+"GenSigDefaultValue"\s+SG_\s+(\d+)\s+([A-Za-z0-9_]+)\s+(-?\d+(?:\.\d+)?(?:[eE][+-]?\d+)?)\s*;$/);
|
||
if (sigDefaultMatch) {
|
||
sigDefaults[sigDefaultMatch[1] + ':' + sigDefaultMatch[2]] = sigDefaultMatch[3];
|
||
continue;
|
||
}
|
||
}
|
||
|
||
messages.forEach(function (msg) {
|
||
msg.comment = comments.messages[String(msg.idRaw)] || '';
|
||
msg.signals.forEach(function (signal) {
|
||
signal.comment = comments.signals[String(msg.idRaw) + ':' + signal.name] || '';
|
||
signal.enumMap = valueTables[String(msg.idRaw) + ':' + signal.name] || {};
|
||
var dv = sigDefaults[String(msg.idRaw) + ':' + signal.name];
|
||
signal.defaultValue = (dv != null && Number.isFinite(Number(dv))) ? Number(dv) : null;
|
||
});
|
||
});
|
||
|
||
return {
|
||
messages: messages,
|
||
nodeNames: nodeNames,
|
||
messageMap: messageMap
|
||
};
|
||
}
|
||
|
||
/** @description 在报文的 signals 数组中按名称查找信号。 */
|
||
export function findSignal(message, signalName) {
|
||
for (var i = 0; i < message.signals.length; i++) {
|
||
if (message.signals[i].name === signalName) return message.signals[i];
|
||
}
|
||
return null;
|
||
}
|
||
|
||
/**
|
||
* @description 按 key 在当前合并 DBC 中查找报文（O(1)，走 messageMap）。
|
||
* messageMap 由 rebuildMergedDbc() 维护，key 格式与 message.key / state.selectedMessageKey 一致。
|
||
* 无 DBC 或 key 不存在时返回 null。
|
||
*/
|
||
export function findMessageByKey(key) {
|
||
if (!state.dbc || !state.dbc.messageMap || !key) return null;
|
||
return state.dbc.messageMap[key] || null;
|
||
}
|
||
|
||
/** @description 解析 SG_ 行的 multiplex token（M / mN / 空）。 */
|
||
export function parseMultiplexToken(token) {
|
||
if (!token) return { role: null, value: null };
|
||
if (token === 'M') return { role: 'mux', value: null };
|
||
var match = token.match(/^m(-?\d+)$/);
|
||
if (match) {
|
||
return { role: 'value', value: parseInt(match[1], 10) };
|
||
}
|
||
return { role: null, value: null };
|
||
}
|
||
|
||
/**
|
||
* 将多个 DBC 源合并为统一 messages 列表。
|
||
* 每条报文 key = sourceId:idRaw:name，避免不同文件同 ID/同名冲突。
|
||
*/
|
||
export function rebuildMergedDbc() {
|
||
if (!state.dbcSources.length) {
|
||
state.dbc = null;
|
||
return null;
|
||
}
|
||
var messages = [];
|
||
var nodeSet = Object.create(null);
|
||
var nodeNames = [];
|
||
var messageMap = {};
|
||
for (var s = 0; s < state.dbcSources.length; s++) {
|
||
var src = state.dbcSources[s];
|
||
var dbc = src.dbc;
|
||
if (!dbc || !dbc.messages) continue;
|
||
for (var n = 0; n < (dbc.nodeNames || []).length; n++) {
|
||
var nn = dbc.nodeNames[n];
|
||
if (nn && !nodeSet[nn]) {
|
||
nodeSet[nn] = 1;
|
||
nodeNames.push(nn);
|
||
}
|
||
}
|
||
for (var i = 0; i < dbc.messages.length; i++) {
|
||
var msg = dbc.messages[i];
|
||
var merged = {
|
||
idRaw: msg.idRaw,
|
||
name: msg.name,
|
||
dlc: msg.dlc,
|
||
transmitter: msg.transmitter,
|
||
signals: msg.signals,
|
||
comment: msg.comment,
|
||
id: msg.id,
|
||
isExtended: msg.isExtended,
|
||
sourceId: src.id,
|
||
sourceName: src.name,
|
||
key: src.id + ':' + msg.idRaw + ':' + msg.name
|
||
};
|
||
messages.push(merged);
|
||
messageMap[merged.key] = merged;
|
||
}
|
||
}
|
||
state.dbc = { messages: messages, nodeNames: nodeNames, messageMap: messageMap };
|
||
return state.dbc;
|
||
}
|
||
|
||
/** @description 生成唯一 source id（同名文件可多次添加时追加 #2） */
|
||
export function makeDbcSourceId(fileName) {
|
||
var base = String(fileName || 'dbc').replace(/[^\w.\-]+/g, '_');
|
||
var id = base;
|
||
var n = 2;
|
||
while (state.dbcSources.some(function (s) { return s.id === id; })) {
|
||
id = base + '#' + n;
|
||
n++;
|
||
}
|
||
return id;
|
||
}
|
||
|
||
/** @description 更新顶部 DBC / 报文数量摘要 pill。 */
|
||
export function buildSummary() {
|
||
if (!state.dbc || !state.dbcSources.length) {
|
||
if (el.dbcSummaryPill) el.dbcSummaryPill.textContent = '未导入 DBC';
|
||
if (el.messageSummaryPill) el.messageSummaryPill.textContent = '0 报文';
|
||
return;
|
||
}
|
||
var nFiles = state.dbcSources.length;
|
||
if (el.dbcSummaryPill) {
|
||
el.dbcSummaryPill.textContent =
|
||
nFiles + ' 文件 · ' + (state.dbc.nodeNames.length || 0) + ' 节点';
|
||
}
|
||
if (el.messageSummaryPill) {
|
||
el.messageSummaryPill.textContent = state.dbc.messages.length + ' 报文';
|
||
}
|
||
}
|