poe-svelte-ui-lib 1.63.0 → 1.64.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/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/RS485 — своих копий протоколов в приложениях не держим.
 
 **Шапка смарт-виджета** (`WidgetHeader`): значок, заголовок и сворачивание слева, «?» в правом краю; правая часть (режимы, «Обновить» и т. п.) стоит в той же строке, а если не помещается — уходит второй строкой под заголовок и там переносится.
 

package/dist/protocols/crc.d.ts

@@ -1,2 +1,3 @@
 export declare const crc16Kermit: (crc: number, bytes: Uint8Array | number[]) => number;
 export declare const crc8Rohc: (crc: number, bytes: Uint8Array | number[]) => number;
+export declare const crc8RohcUtf8: (crc: number, bytes: Uint8Array) => number;

package/dist/protocols/crc.js

@@ -18,3 +18,27 @@ export const crc8Rohc = (crc, bytes) => {
     }
     return crc & 0xff;
 };
+/* Байт для CRC от позиции pos по правилу прошивки (common.c, utf8_seq_byte): целая UTF-8-последовательность даёт младший байт
+   своего code point, иначе байт как есть — так прошивка считает CRC и по тексту с эмодзи, и по сырому CBOR */
+const utf8SeqByte = (bytes, pos) => {
+    const first = bytes[pos];
+    const cont = (offset) => (bytes[pos + offset] & 0xc0) === 0x80;
+    if ((first & 0x80) === 0)
+        return { data: first, length: 1 };
+    if ((first & 0xe0) === 0xc0 && pos + 1 < bytes.length && cont(1))
+        return { data: (((first & 0x1f) << 6) | (bytes[pos + 1] & 0x3f)) & 0xff, length: 2 };
+    if ((first & 0xf0) === 0xe0 && pos + 2 < bytes.length && cont(1) && cont(2))
+        return { data: (((first & 0x0f) << 12) | ((bytes[pos + 1] & 0x3f) << 6) | (bytes[pos + 2] & 0x3f)) & 0xff, length: 3 };
+    if ((first & 0xf8) === 0xf0 && pos + 3 < bytes.length && cont(1) && cont(2) && cont(3))
+        return { data: (((bytes[pos + 1] & 0x3f) << 12) | ((bytes[pos + 2] & 0x3f) << 6) | (bytes[pos + 3] & 0x3f)) & 0xff, length: 4 };
+    return { data: first, length: 1 };
+};
+/* CRC-8/ROHC по правилу прошивки для UTF-8 (crc8_rohc в common.c) — рамка POESerial: HEADER, ARGUMENT, VALUE */
+export const crc8RohcUtf8 = (crc, bytes) => {
+    for (let pos = 0; pos < bytes.length;) {
+        const { data, length } = utf8SeqByte(bytes, pos);
+        crc = crc8Rohc(crc, [data]);
+        pos += length;
+    }
+    return crc;
+};

package/dist/protocols/index.d.ts

@@ -4,5 +4,6 @@ export { CborEncoder, encodeCbor } from "./cbor/encoder.js";
 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 } from "./crc.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 { encodePoeSerialFrame, createPoeSerialParser, type PoeSerialItem } from "./poeSerial.js";

package/dist/protocols/index.js

@@ -10,5 +10,7 @@ export { CborToValue, ValueToCbor, cborToValue, valueToCbor } from "./cbor/value
 /* JSON-текст ↔ CBOR: двоичные данные — base64, ключи с "BIN" кодируются байтами (поля ввода терминала и отладки) */
 export { CborToJson, JsonToCbor, cborToJson, jsonToCbor } from "./cbor/json.js";
 /* Контрольные суммы и пакет poe_cbor_pkt { TrgBusID : [RetBusID, HA_Code, Payload, CRC16] } (CAN, RS485) */
-export { crc16Kermit, crc8Rohc } from "./crc.js";
+export { crc16Kermit, crc8Rohc, crc8RohcUtf8 } from "./crc.js";
 export { BROADCAST_BUS_ID, makeHaCode, splitHaCode, packetObjectCrc, encodePacket, decodePacket, objectsFor, } from "./packet.js";
+/* Рамка POESerial (UART-консоль system_console): сборка команды и потоковый разбор кадров, строк Teleplot и текста */
+export { encodePoeSerialFrame, createPoeSerialParser } from "./poeSerial.js";

package/dist/protocols/poeSerial.d.ts

@@ -0,0 +1,27 @@
+export declare const SOH = 1;
+export declare const STX = 2;
+export declare const ETX = 3;
+export declare const EOT = 4;
+export declare const US = 31;
+export type PoeSerialItem = {
+    type: "frame";
+    header: string;
+    argument: string;
+    value: string;
+    valueBytes: Uint8Array;
+    crc: string;
+    crcOk: boolean;
+    freeHeap: string;
+} | {
+    type: "plot";
+    name: string;
+    value: string;
+} | {
+    type: "raw";
+    text: string;
+};
+export declare const encodePoeSerialFrame: (header: string, argument: string, value: Uint8Array) => Uint8Array;
+export declare const createPoeSerialParser: () => {
+    push(chunk: Uint8Array): PoeSerialItem[];
+    reset(): void;
+};

package/dist/protocols/poeSerial.js

@@ -0,0 +1,112 @@
+/* $lib/protocols/poeSerial.ts */
+/* Рамка POESerial (system_console прошивки): [SOH] HEADER [US] ARGUMENT [STX] VALUE [ETX] CRC8 [US] FHS [EOT] \n — CRC8 двумя hex-символами
+   по HEADER+ARGUMENT+VALUE (crc8RohcUtf8), FHS (свободная куча) только у кадров устройства. Устройство шлёт VALUE текстом (лог или hex-дамп CBOR),
+   устройству VALUE уходит сырыми байтами CBOR. Между кадрами — текст: строки Teleplot «>Имя:Значение» (PLOT) и прочий вывод (RAW) */
+import { crc8RohcUtf8 } from "./crc.js";
+export const SOH = 0x01;
+export const STX = 0x02;
+export const ETX = 0x03;
+export const EOT = 0x04;
+export const US = 0x1f;
+const LF = 0x0a;
+/* Предел текста без конца строки и незавершённого кадра — дальше отдаётся/сбрасывается, чтобы буфер не рос бесконечно */
+const MAX_TEXT_TAIL = 4096;
+const MAX_FRAME = 8192;
+const encoder = new TextEncoder();
+const decoder = new TextDecoder();
+const hex2 = (value) => value.toString(16).toUpperCase().padStart(2, "0");
+/* Кадр команды устройству — те же байты, что разбирает system_console (VALUE — сырой CBOR, FHS не передаётся) */
+export const encodePoeSerialFrame = (header, argument, value) => {
+    const headerBytes = encoder.encode(header);
+    const argumentBytes = encoder.encode(argument);
+    const crc = crc8RohcUtf8(crc8RohcUtf8(crc8RohcUtf8(0xff, headerBytes), argumentBytes), value);
+    return new Uint8Array([SOH, ...headerBytes, US, ...argumentBytes, STX, ...value, ETX, ...encoder.encode(hex2(crc)), EOT]);
+};
+/* Строки текста вне кадров: Teleplot «>Имя:Значение» → plot, остальное → raw; пустые и с управляющими символами пропускаются */
+const textItems = (bytes) => decoder
+    .decode(bytes)
+    .split("\n")
+    .map((line) => line.trim())
+    .filter((line) => line && ![...line].some((char) => char.charCodeAt(0) < 0x20 && char !== "\t"))
+    .map((line) => {
+    const colon = line.indexOf(":");
+    return line.startsWith(">") && colon > 1 ? { type: "plot", name: line.slice(1, colon), value: line.slice(colon + 1) } : { type: "raw", text: line };
+});
+/* Кадр от SOH до EOT включительно; без разделителей — null (пропускается, как в прошивке и Rust-терминале) */
+const frameItem = (frame) => {
+    const us = frame.indexOf(US);
+    const stx = us < 0 ? -1 : frame.indexOf(STX, us + 1);
+    const etx = stx < 0 ? -1 : frame.indexOf(ETX, stx + 1);
+    if (etx < 0)
+        return null;
+    const header = frame.subarray(1, us);
+    const argument = frame.subarray(us + 1, stx);
+    const valueBytes = frame.subarray(stx + 1, etx);
+    const tailUs = frame.indexOf(US, etx + 1);
+    const crc = decoder.decode(frame.subarray(etx + 1, tailUs < 0 ? frame.length - 1 : tailUs)).trim();
+    const freeHeap = tailUs < 0 ? "" : decoder.decode(frame.subarray(tailUs + 1, frame.length - 1)).trim();
+    const crcCalc = crc8RohcUtf8(crc8RohcUtf8(crc8RohcUtf8(0xff, header), argument), valueBytes);
+    return {
+        type: "frame",
+        header: decoder.decode(header),
+        argument: decoder.decode(argument),
+        value: decoder.decode(valueBytes),
+        valueBytes: valueBytes.slice(),
+        crc,
+        crcOk: /^[0-9A-Fa-f]{2}$/.test(crc) && parseInt(crc, 16) === crcCalc,
+        freeHeap,
+    };
+};
+const concat = (a, b) => {
+    const out = new Uint8Array(a.length + b.length);
+    out.set(a);
+    out.set(b, a.length);
+    return out;
+};
+/* Потоковый разбор: push(байты из порта) → готовые кадры и строки; незавершённое ждёт следующего чанка */
+export const createPoeSerialParser = () => {
+    let buffer = new Uint8Array();
+    return {
+        push(chunk) {
+            buffer = concat(buffer, chunk);
+            const items = [];
+            for (;;) {
+                const soh = buffer.indexOf(SOH);
+                if (soh < 0)
+                    break;
+                /* Текст перед кадром не теряем; обрывок прошлого кадра (до последнего EOT) отбрасываем */
+                if (soh > 0) {
+                    const prefix = buffer.subarray(0, soh);
+                    items.push(...textItems(prefix.subarray(prefix.lastIndexOf(EOT) + 1)));
+                    buffer = buffer.slice(soh);
+                    continue;
+                }
+                const eot = buffer.indexOf(EOT);
+                if (eot < 0) {
+                    /* Кадр без конца слишком длинный — потерян EOT: пропускаем его SOH и ищем следующий кадр, иначе ждём ещё байт */
+                    if (buffer.length <= MAX_FRAME)
+                        break;
+                    buffer = buffer.slice(1);
+                    continue;
+                }
+                const item = frameItem(buffer.subarray(0, eot + 1));
+                if (item)
+                    items.push(item);
+                buffer = buffer.slice(eot + 1);
+            }
+            /* Хвост без начала кадра: целые строки — наружу, незавершённая строка ждёт следующего чанка */
+            if (buffer.indexOf(SOH) < 0) {
+                const cut = buffer.length > MAX_TEXT_TAIL ? buffer.length : buffer.lastIndexOf(LF);
+                if (cut >= 0) {
+                    items.push(...textItems(buffer.subarray(0, cut)));
+                    buffer = buffer.slice(Math.min(cut + 1, buffer.length));
+                }
+            }
+            return items;
+        },
+        /* Сброс при переподключении порта */
+        reset() {
+            buffer = new Uint8Array();
+        },
+    };
+};

package/package.json

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