poe-svelte-ui-lib 1.64.0 → 1.65.0

package/README.md

@@ -59,7 +59,7 @@ npm install poe-svelte-ui-lib
 
 **Названия смарт-виджетов** — в словаре библиотеки на всех языках (WiFi, «Об устройстве», «Файловая система», «Стек и задачи», «RGB лента», «Пилотажный дисплей», «Карта»); пустой `label.name` показывает название на языке пользователя, `widgetTitle(type)` отдаёт его сразу на всех языках `{ ru, en, zh }` — так конструктор заполняет заголовок нового виджета.
 
-**Ядро протоколов** — `poe-svelte-ui-lib/protocols` (без Svelte, работает и под Node без Vite): общий для DevCloud, WebApp и SYP-DevTerminal CBOR-кодек (RFC 8949) — `encodeCbor`/`decodeCbor`, `CborEncoder`/`CborDecoder`; `valueToCbor`/`cborToValue` — обычные значения, двоичные данные как `Uint8Array` (WebSocket, хранилище, телеметрия); `jsonToCbor`/`cborToJson` — JSON-совместимые значения, двоичные данные в base64, строки под ключами с `BIN` — байты (поля ввода терминала и отладки). Пакет `poe_cbor_pkt` `{ TrgBusID : [RetBusID, HA_Code, Payload, CRC16] }` (CAN, RS485): `encodePacket`/`decodePacket` (разбор с начала буфера — `complete` с длиной, `incomplete` для потока или `garbage`; объекты с одинаковым `TrgBusID` не склеиваются, неверный CRC — флаг `crcOk`), `objectsFor` (свой адрес и broadcast `0xFFFF`), `makeHaCode`/`splitHaCode`, `packetObjectCrc`; контрольные суммы `crc16Kermit` и `crc8Rohc`. Байты совпадают с `poe_cbor_pkt.c` прошивки — проверка `npm run TestProtocols` (`tests/protocols.test.mjs`, эталонные пакеты собраны прошивочным кодом). Рамка POESerial (UART-консоль `system_console`, `[SOH] HDR [US] ARG [STX] VAL [ETX] CRC8 [US] FHS [EOT]`): `encodePoeSerialFrame` — команда устройству, `createPoeSerialParser().push(байты)` — потоковый разбор кадров, строк Teleplot (`plot`) и прочего текста (`raw`), с проверкой CRC `crc8RohcUtf8` по правилу прошивки (`crc8_rohc` в `common.c`). Дальше сюда переезжает разбор CAN/RS485 — своих копий протоколов в приложениях не держим.
+**Ядро протоколов** — `poe-svelte-ui-lib/protocols` (без Svelte, работает и под Node без Vite): общий для DevCloud, WebApp и SYP-DevTerminal CBOR-кодек (RFC 8949) — `encodeCbor`/`decodeCbor`, `CborEncoder`/`CborDecoder`; `valueToCbor`/`cborToValue` — обычные значения, двоичные данные как `Uint8Array` (WebSocket, хранилище, телеметрия); `jsonToCbor`/`cborToJson` — JSON-совместимые значения, двоичные данные в base64, строки под ключами с `BIN` — байты (поля ввода терминала и отладки). Пакет `poe_cbor_pkt` `{ TrgBusID : [RetBusID, HA_Code, Payload, CRC16] }` (CAN, RS485): `encodePacket`/`decodePacket` (разбор с начала буфера — `complete` с длиной, `incomplete` для потока или `garbage`; объекты с одинаковым `TrgBusID` не склеиваются, неверный CRC — флаг `crcOk`), `objectsFor` (свой адрес и broadcast `0xFFFF`), `makeHaCode`/`splitHaCode`, `packetObjectCrc`; контрольные суммы `crc16Kermit` и `crc8Rohc`. Байты совпадают с `poe_cbor_pkt.c` прошивки — проверка `npm run TestProtocols` (`tests/protocols.test.mjs`, эталонные пакеты собраны прошивочным кодом). Рамка POESerial (UART-консоль `system_console`, `[SOH] HDR [US] ARG [STX] VAL [ETX] CRC8 [US] FHS [EOT]`): `encodePoeSerialFrame` — команда устройству, `createPoeSerialParser().push(байты)` — потоковый разбор кадров, строк Teleplot (`plot`) и прочего текста (`raw`), с проверкой CRC `crc8RohcUtf8` по правилу прошивки (`crc8_rohc` в `common.c`). CAN/CAN FD через slcan-адаптер (`can_service` прошивки): `canFragments`/`encodeCanPacket` — нарезка пакета на кадры как `CAN_Send` (бит 10 ID — «последний», биты 0..9 — `packetId`, по 8 / 64 байта), `encodeSlcanFrame`, `createCanParser().push(байты)` — разбор кадров slcan со сборкой фрагментов и обрезкой паддинга CAN FD. RS485 — сырой поток пакетов: `createPacketStreamParser().push(байты)` (пауза обрывает недособранное, мусор пропускается по байту). Своих копий протоколов в приложениях не держим: терминал читает и пишет порт сырыми байтами, разбор и сборка — здесь.
 
 **Шапка смарт-виджета** (`WidgetHeader`): значок, заголовок и сворачивание слева, «?» в правом краю; правая часть (режимы, «Обновить» и т. п.) стоит в той же строке, а если не помещается — уходит второй строкой под заголовок и там переносится.
 

package/dist/protocols/can.d.ts

@@ -0,0 +1,23 @@
+export declare const CAN_FINAL_BIT = 1024;
+export declare const CAN_PACKET_ID_MASK = 1023;
+export interface CanFrame {
+    canId: number;
+    data: Uint8Array;
+}
+export declare const canFragments: (payload: Uint8Array, fd: boolean, packetId?: number) => CanFrame[];
+export declare const encodeSlcanFrame: ({ canId, data }: CanFrame, fd: boolean) => string;
+export declare const encodeCanPacket: (payload: Uint8Array, fd: boolean, packetId?: number) => string;
+export interface CanMessage {
+    canId: number;
+    packetId: number;
+    data: Uint8Array;
+    remote: boolean;
+    timestamp: number;
+}
+export declare const createCanParser: ({ sessionTimeoutMs, maxPacketBytes }?: {
+    sessionTimeoutMs?: number | undefined;
+    maxPacketBytes?: number | undefined;
+}) => {
+    push(chunk: Uint8Array, now?: number): CanMessage[];
+    reset(): void;
+};

package/dist/protocols/can.js

@@ -0,0 +1,104 @@
+/* $lib/protocols/can.ts */
+/* Пакеты по CAN/CAN FD через slcan-адаптер (can_service прошивки): стандартный 11-битный ID — бит 10 «последний/единственный фрагмент»,
+   биты 0..9 — packet_id, одинаковый у всех фрагментов пакета; DATA — чистый payload без служебных байт. Адаптер говорит ASCII-кадрами slcan:
+   [t|d|b|r]III L DD..DD\r (стандартный ID, 3 hex), [T|D|B|R]IIIIIIII L DD..\r (расширенный, 8 hex); t/T — CAN, d/D, b/B — CAN FD (b — с BRS) */
+import { decodePacket } from "./packet.js";
+export const CAN_FINAL_BIT = 0x400;
+export const CAN_PACKET_ID_MASK = 0x3ff;
+const CAN_CLASSIC_PAYLOAD = 8;
+const CAN_FD_PAYLOAD = 64;
+/* Длины данных CAN FD по коду DLC 9..15 */
+const FD_SIZES = [12, 16, 20, 24, 32, 48, 64];
+/* Нарезка пакета на кадры — как CAN_Send прошивки: один кадр с битом «последний», иначе куски по 8 (CAN FD — 64) байт, бит только у последнего */
+export const canFragments = (payload, fd, packetId = 1 + Math.floor(Math.random() * CAN_PACKET_ID_MASK)) => {
+    const max = fd ? CAN_FD_PAYLOAD : CAN_CLASSIC_PAYLOAD;
+    const id = packetId & CAN_PACKET_ID_MASK;
+    if (payload.length <= max)
+        return [{ canId: CAN_FINAL_BIT | id, data: payload }];
+    const frames = [];
+    for (let offset = 0; offset < payload.length; offset += max) {
+        const isLast = offset + max >= payload.length;
+        frames.push({ canId: isLast ? CAN_FINAL_BIT | id : id, data: payload.subarray(offset, offset + max) });
+    }
+    return frames;
+};
+const hex = (bytes) => Array.from(bytes, (byte) => byte.toString(16).toUpperCase().padStart(2, "0")).join("");
+/* Кадр данных slcan (стандартный ID): CAN — «t», CAN FD — «b» (с BRS); данные CAN FD дополняются нулями до ближайшей допустимой длины */
+export const encodeSlcanFrame = ({ canId, data }, fd) => {
+    const id = (canId & 0x7ff).toString(16).toUpperCase().padStart(3, "0");
+    if (!fd)
+        return `t${id}${Math.min(data.length, 8).toString(16).toUpperCase()}${hex(data.subarray(0, 8))}\r`;
+    const code = data.length <= 8 ? data.length : 9 + FD_SIZES.findIndex((size) => size >= data.length);
+    const size = code <= 8 ? code : FD_SIZES[code - 9];
+    const padded = new Uint8Array(size);
+    padded.set(data.subarray(0, size));
+    return `b${id}${code.toString(16).toUpperCase()}${hex(padded)}\r`;
+};
+/* Пакет целиком в строку кадров slcan для отправки в адаптер */
+export const encodeCanPacket = (payload, fd, packetId) => canFragments(payload, fd, packetId)
+    .map((frame) => encodeSlcanFrame(frame, fd))
+    .join("");
+const SLCAN_FRAME = /([tdbr])([0-9A-Fa-f]{3})([0-9A-Fa-f])([0-9A-Fa-f]*)\r|([TDBR])([0-9A-Fa-f]{8})([0-9A-Fa-f])([0-9A-Fa-f]*)\r/g;
+const fdLength = (code) => (code <= 8 ? code : (FD_SIZES[code - 9] ?? 0));
+/* CAN FD добивает последний кадр до допустимой длины — лишние байты после пакета poe_cbor_pkt (или нулевой хвост) отрезаем */
+const trimFdPadding = (data) => {
+    const parsed = decodePacket(data);
+    if (parsed.status === "complete")
+        return data.subarray(0, parsed.length);
+    let end = data.length;
+    while (end > 0 && data[end - 1] === 0)
+        end--;
+    return data.subarray(0, end);
+};
+const decoder = new TextDecoder();
+/* Потоковый разбор ответа slcan-адаптера: push(байты порта, время) → собранные пакеты; незавершённые сессии живут sessionTimeoutMs */
+export const createCanParser = ({ sessionTimeoutMs = 2000, maxPacketBytes = 8192 } = {}) => {
+    let text = "";
+    const sessions = new Map();
+    return {
+        push(chunk, now = Date.now()) {
+            text += decoder.decode(chunk, { stream: true });
+            for (const [id, session] of sessions)
+                if (now - session.timestamp > sessionTimeoutMs)
+                    sessions.delete(id);
+            const messages = [];
+            let consumed = 0;
+            for (const match of text.matchAll(SLCAN_FRAME)) {
+                consumed = (match.index ?? 0) + match[0].length;
+                const [type, idHex, dlcHex, dataHex] = match[1] ? match.slice(1, 5) : match.slice(5, 9);
+                const lower = type.toLowerCase();
+                const canId = parseInt(idHex, 16);
+                const dlc = parseInt(dlcHex, 16);
+                const size = lower === "t" || lower === "r" ? Math.min(dlc, 8) : fdLength(dlc);
+                const bytes = lower === "r" ? [] : Array.from({ length: Math.min(size, dataHex.length >> 1) }, (_, i) => parseInt(dataHex.slice(i * 2, i * 2 + 2), 16));
+                const packetId = canId & CAN_PACKET_ID_MASK;
+                if (lower === "r") {
+                    messages.push({ canId, packetId, data: new Uint8Array(), remote: true, timestamp: now });
+                    continue;
+                }
+                const session = sessions.get(packetId);
+                if (!(canId & CAN_FINAL_BIT)) {
+                    /* Промежуточный фрагмент: копим; потерян последний и пакет разросся — сбрасываем */
+                    const data = [...(session?.data ?? []), ...bytes];
+                    if (data.length > maxPacketBytes)
+                        sessions.delete(packetId);
+                    else
+                        sessions.set(packetId, { data, timestamp: session?.timestamp ?? now });
+                    continue;
+                }
+                sessions.delete(packetId);
+                const data = Uint8Array.from([...(session?.data ?? []), ...bytes]);
+                messages.push({ canId, packetId, data: lower === "t" ? data : trimFdPadding(data), remote: false, timestamp: session?.timestamp ?? now });
+            }
+            /* Разобранное убираем; хвост без конца кадра ждёт следующего чанка, мусор без \r не копится бесконечно */
+            text = text.slice(consumed);
+            if (text.length > 4 * maxPacketBytes)
+                text = text.slice(text.lastIndexOf("\r") + 1);
+            return messages;
+        },
+        reset() {
+            text = "";
+            sessions.clear();
+        },
+    };
+};

package/dist/protocols/index.d.ts

@@ -5,5 +5,6 @@ export { bytesToBase64, base64ToBytes } from "./cbor/base64.js";
 export { CborToValue, ValueToCbor, cborToValue, valueToCbor } from "./cbor/value.js";
 export { CborToJson, JsonToCbor, cborToJson, jsonToCbor } from "./cbor/json.js";
 export { crc16Kermit, crc8Rohc, crc8RohcUtf8 } from "./crc.js";
-export { BROADCAST_BUS_ID, makeHaCode, splitHaCode, packetObjectCrc, encodePacket, decodePacket, objectsFor, type PacketObject, type DecodedPacketObject, type PacketParse, } from "./packet.js";
+export { BROADCAST_BUS_ID, makeHaCode, splitHaCode, packetObjectCrc, encodePacket, decodePacket, objectsFor, createPacketStreamParser, type PacketObject, type DecodedPacketObject, type PacketParse, } from "./packet.js";
 export { encodePoeSerialFrame, createPoeSerialParser, type PoeSerialItem } from "./poeSerial.js";
+export { CAN_FINAL_BIT, CAN_PACKET_ID_MASK, canFragments, encodeSlcanFrame, encodeCanPacket, createCanParser, type CanFrame, type CanMessage } from "./can.js";

package/dist/protocols/index.js

@@ -11,6 +11,8 @@ export { CborToValue, ValueToCbor, cborToValue, valueToCbor } from "./cbor/value
 export { CborToJson, JsonToCbor, cborToJson, jsonToCbor } from "./cbor/json.js";
 /* Контрольные суммы и пакет poe_cbor_pkt { TrgBusID : [RetBusID, HA_Code, Payload, CRC16] } (CAN, RS485) */
 export { crc16Kermit, crc8Rohc, crc8RohcUtf8 } from "./crc.js";
-export { BROADCAST_BUS_ID, makeHaCode, splitHaCode, packetObjectCrc, encodePacket, decodePacket, objectsFor, } from "./packet.js";
+export { BROADCAST_BUS_ID, makeHaCode, splitHaCode, packetObjectCrc, encodePacket, decodePacket, objectsFor, createPacketStreamParser, } from "./packet.js";
 /* Рамка POESerial (UART-консоль system_console): сборка команды и потоковый разбор кадров, строк Teleplot и текста */
 export { encodePoeSerialFrame, createPoeSerialParser } from "./poeSerial.js";
+/* CAN/CAN FD через slcan-адаптер: нарезка пакета на кадры как в can_service прошивки, кадры slcan, потоковый разбор со сборкой фрагментов */
+export { CAN_FINAL_BIT, CAN_PACKET_ID_MASK, canFragments, encodeSlcanFrame, encodeCanPacket, createCanParser } from "./can.js";

package/dist/protocols/packet.d.ts

@@ -29,3 +29,13 @@ export type PacketParse = {
 };
 export declare const decodePacket: (bytes: Uint8Array) => PacketParse;
 export declare const objectsFor: (objects: DecodedPacketObject[], busID: number) => DecodedPacketObject[];
+export declare const createPacketStreamParser: ({ gapMs, maxBytes }?: {
+    gapMs?: number | undefined;
+    maxBytes?: number | undefined;
+}) => {
+    push(chunk: Uint8Array, now?: number): {
+        bytes: Uint8Array;
+        objects: DecodedPacketObject[];
+    }[];
+    reset(): void;
+};

package/dist/protocols/packet.js

@@ -103,3 +103,38 @@ export const decodePacket = (bytes) => {
 };
 /* Объекты пакета для своего адреса (и broadcast) с верным CRC — как CBOR_PktDecGet прошивки, только все, а не первый */
 export const objectsFor = (objects, busID) => objects.filter((object) => object.crcOk && (object.trgBusID === busID || object.trgBusID === BROADCAST_BUS_ID));
+/* Потоковый разбор пакетов из сырого потока (RS485): пауза дольше gapMs обрывает недособранный пакет, мусор сдвигается по байту,
+   без единого целого пакета буфер не растёт дальше maxBytes */
+export const createPacketStreamParser = ({ gapMs = 100, maxBytes = 4096 } = {}) => {
+    let buffer = new Uint8Array();
+    let last = 0;
+    return {
+        push(chunk, now = Date.now()) {
+            if (buffer.length && now - last > gapMs)
+                buffer = new Uint8Array();
+            last = now;
+            const merged = new Uint8Array(buffer.length + chunk.length);
+            merged.set(buffer);
+            merged.set(chunk, buffer.length);
+            buffer = merged;
+            const packets = [];
+            while (buffer.length) {
+                const parsed = decodePacket(buffer);
+                if (parsed.status === "incomplete")
+                    break;
+                if (parsed.status === "garbage") {
+                    buffer = buffer.slice(1);
+                    continue;
+                }
+                packets.push({ bytes: buffer.slice(0, parsed.length), objects: parsed.objects });
+                buffer = buffer.slice(parsed.length);
+            }
+            if (buffer.length > maxBytes)
+                buffer = new Uint8Array();
+            return packets;
+        },
+        reset() {
+            buffer = new Uint8Array();
+        },
+    };
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "poe-svelte-ui-lib",
-  "version": "1.64.0",
+  "version": "1.65.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/Oleg-Perevyshin/ElementsUI.git"