poe-svelte-ui-lib 1.65.0 → 1.66.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/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(байты)` (пауза обрывает недособранное, мусор пропускается по байту). Своих копий протоколов в приложениях не держим: терминал читает и пишет порт сырыми байтами, разбор и сборка — здесь.
+**Ядро протоколов** — `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(байты)` (пауза обрывает недособранное, мусор пропускается по байту). Открытие slcan-адаптера — `slcanOpenCommands(скорость, скоростьДанных?)`. Поле Value команды POESerial из ввода — `poeSerialValueFromText` (hex как есть, JSON → CBOR). Словарь протокола — `HEADER_CODES`, `DEFAULT_ARGUMENT_CODES` (из `.framework/Dictionary.yaml` прошивок), `parseArgumentDictionary` (строки `- [Строка, Enum, Число]`), `nameByCode`. Своих копий протоколов и словаря в приложениях не держим: терминал и отладка облака читают и пишут порт сырыми байтами, разбор и сборка — здесь.
 
 **Шапка смарт-виджета** (`WidgetHeader`): значок, заголовок и сворачивание слева, «?» в правом краю; правая часть (режимы, «Обновить» и т. п.) стоит в той же строке, а если не помещается — уходит второй строкой под заголовок и там переносится.
 

package/dist/protocols/can.d.ts

@@ -21,3 +21,4 @@ export declare const createCanParser: ({ sessionTimeoutMs, maxPacketBytes }?: {
     push(chunk: Uint8Array, now?: number): CanMessage[];
     reset(): void;
 };
+export declare const slcanOpenCommands: (bitrate: string, dataBitrate?: string) => string[];

package/dist/protocols/can.js

@@ -102,3 +102,6 @@ export const createCanParser = ({ sessionTimeoutMs = 2000, maxPacketBytes = 8192
         },
     };
 };
+/* Команды открытия slcan-адаптера (CANable и совместимые): закрыть канал, скорость арбитража (S0..S8, SA..SD), для CAN FD — скорость данных
+   (Y1..Y5), нормальный режим, без автоповтора, открыть канал — каждая строка заканчивается \r */
+export const slcanOpenCommands = (bitrate, dataBitrate) => ["C", bitrate, ...(dataBitrate ? [dataBitrate] : []), "M0", "A0", "O"].map((command) => `${command}\r`);

package/dist/protocols/dictionary.d.ts

@@ -0,0 +1,4 @@
+export declare const HEADER_CODES: Record<string, number>;
+export declare const DEFAULT_ARGUMENT_CODES: Record<string, number>;
+export declare const parseArgumentDictionary: (text: string) => Record<string, number>;
+export declare const nameByCode: (codes: Record<string, number>, code: number) => string;

package/dist/protocols/dictionary.js

@@ -0,0 +1,68 @@
+/* $lib/protocols/dictionary.ts */
+/* Словарь заголовков и аргументов протокола HA_Code — заголовок в 2 старших битах, аргумент в 14 младших (makeHaCode). Аргументы по умолчанию —
+   из .framework/Dictionary.yaml прошивок (ProdFactory-ESP и ProdFactory-STM, одинаковые); у устройства словарь может быть свой — его загружают
+   из файла (parseArgumentDictionary), своих копий словаря в приложениях не держим */
+export const HEADER_CODES = {
+    GET: 0,
+    SET: 1,
+    "OK!": 2,
+    "ER!": 3,
+};
+export const DEFAULT_ARGUMENT_CODES = {
+    Unknown: 0,
+    Restart: 1,
+    DefCfg: 2,
+    DlFW: 3,
+    RstNVS: 5,
+    LocTime: 6,
+    Update: 7,
+    StackInfo: 8,
+    BackUp: 9,
+    BindMKey: 10,
+    DataStream: 15,
+    APsList: 21,
+    FS: 22,
+    JoinDev: 23,
+    JoinUser: 24,
+    LeaveUser: 25,
+    ModFind: 31,
+    ModList: 32,
+    ModCap: 33,
+    ModInfo: 34,
+    ModMode: 35,
+    ModCfg: 36,
+    ModT1: 37,
+    ModT2: 38,
+    ModT3: 39,
+    ModT4: 40,
+    ModT5: 41,
+    ModS1: 42,
+    ModS2: 43,
+    ModS3: 44,
+    ModS4: 45,
+    ModS5: 46,
+    FwUpgS: 51,
+    FwUpgP: 52,
+    FwUpgD: 53,
+    FwUpgE: 54,
+    FDwS: 65,
+    FDwP: 66,
+    FDwD: 67,
+    FDwE: 68,
+    TestReq: 91,
+    MotInit: 111,
+    MotMode: 112,
+    MotPos: 113,
+    MotPID: 114,
+    MotInfo: 115,
+    MotCfg: 116,
+    MotCal: 117,
+    OrData: 141,
+    OrOfs: 142,
+    OrAccCal: 143,
+    OrMagCal: 144,
+};
+/* Аргументы из текста Dictionary.yaml (или его фрагмента): строки «- [Строка, Enum, Число]», комментарии и прочее пропускаются */
+export const parseArgumentDictionary = (text) => Object.fromEntries([...text.matchAll(/^\s*-\s*\[\s*([^,\]]+?)\s*,\s*[^,\]]+?\s*,\s*(\d+)\s*\]/gm)].map(([, name, code]) => [name, Number(code)]));
+/* Имя по коду (обратный поиск) — для показа принятых пакетов; неизвестный код — числом */
+export const nameByCode = (codes, code) => Object.entries(codes).find(([, value]) => value === code)?.[0] ?? String(code);

package/dist/protocols/index.d.ts

@@ -6,5 +6,6 @@ export { CborToValue, ValueToCbor, cborToValue, valueToCbor } from "./cbor/value
 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, 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";
+export { encodePoeSerialFrame, createPoeSerialParser, poeSerialValueFromText, type PoeSerialItem } from "./poeSerial.js";
+export { CAN_FINAL_BIT, CAN_PACKET_ID_MASK, canFragments, encodeSlcanFrame, encodeCanPacket, createCanParser, slcanOpenCommands, type CanFrame, type CanMessage, } from "./can.js";
+export { HEADER_CODES, DEFAULT_ARGUMENT_CODES, parseArgumentDictionary, nameByCode } from "./dictionary.js";

package/dist/protocols/index.js

@@ -13,6 +13,8 @@ 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, createPacketStreamParser, } from "./packet.js";
 /* Рамка POESerial (UART-консоль system_console): сборка команды и потоковый разбор кадров, строк Teleplot и текста */
-export { encodePoeSerialFrame, createPoeSerialParser } from "./poeSerial.js";
+export { encodePoeSerialFrame, createPoeSerialParser, poeSerialValueFromText } 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";
+export { CAN_FINAL_BIT, CAN_PACKET_ID_MASK, canFragments, encodeSlcanFrame, encodeCanPacket, createCanParser, slcanOpenCommands, } from "./can.js";
+/* Словарь заголовков и аргументов HA_Code — по умолчанию из Dictionary.yaml прошивок, разбор файла словаря */
+export { HEADER_CODES, DEFAULT_ARGUMENT_CODES, parseArgumentDictionary, nameByCode } from "./dictionary.js";

package/dist/protocols/poeSerial.d.ts

@@ -25,3 +25,4 @@ export declare const createPoeSerialParser: () => {
     push(chunk: Uint8Array): PoeSerialItem[];
     reset(): void;
 };
+export declare const poeSerialValueFromText: (text: string | undefined) => Uint8Array;

package/dist/protocols/poeSerial.js

@@ -3,6 +3,7 @@
    по HEADER+ARGUMENT+VALUE (crc8RohcUtf8), FHS (свободная куча) только у кадров устройства. Устройство шлёт VALUE текстом (лог или hex-дамп CBOR),
    устройству VALUE уходит сырыми байтами CBOR. Между кадрами — текст: строки Teleplot «>Имя:Значение» (PLOT) и прочий вывод (RAW) */
 import { crc8RohcUtf8 } from "./crc.js";
+import { jsonToCbor } from "./cbor/json.js";
 export const SOH = 0x01;
 export const STX = 0x02;
 export const ETX = 0x03;
@@ -110,3 +111,20 @@ export const createPoeSerialParser = () => {
         },
     };
 };
+/* Поле Value команды из ввода пользователя: пусто — без тела, hex-строка (с пробелами или без) — готовые байты как есть, иначе JSON → CBOR
+   (двоичные данные — base64, ключи с BIN — байты, см. jsonToCbor); не hex и не JSON — ошибка */
+export const poeSerialValueFromText = (text) => {
+    const trimmed = (text ?? "").trim();
+    if (!trimmed)
+        return new Uint8Array();
+    if (/^([0-9A-Fa-f]{2}\s?)+$/.test(trimmed))
+        return Uint8Array.from(trimmed.replace(/\s/g, "").match(/../g) ?? [], (pair) => parseInt(pair, 16));
+    let parsed;
+    try {
+        parsed = JSON.parse(trimmed);
+    }
+    catch {
+        throw new Error(`Value не является ни hex, ни JSON: ${trimmed}`);
+    }
+    return jsonToCbor(parsed);
+};

package/package.json

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