Усі посібники

Як зробити · 8 хв

Модуль нормалізації телеметрії на WebAssembly

Модуль перетворення телеметрії — маленька програма WebAssembly, яка бере сирі поля виробника і повертає кандидатні канонічні поля Wesfin. Lab запускає її в ізоляції з жорсткими межами, перевіряє кожен результат сам і записує хеші входу й виходу.

Навіщо модуль, якщо є профіль

Декларативного профілю досить, коли поле лише перейменувати й помножити. Але деякі пристрої віддають масштабовані цілі, окремі регістри заряду й розряду або знак навпаки. Модуль описує таке перетворення кодом, а версія модуля і його SHA-256 роблять результат відтворюваним.

Контракт: одна функція

Модуль — компонент WebAssembly з рівно одним експортом transform і без жодного імпорту. Вхід і вихід — JSON у UTF-8. Контракт wesfin:lab-telemetry@1.0.0 версіонується окремо від рушія.

WIT
world telemetry-transform {
  export transform: func(input: list<u8>) -> result<list<u8>, string>;
}
spec example
// payload (vendor-shaped sample)
{ "battery_soc": 735, "power_w": -4200 }

// transform-output-1
{ "sample_id": "<echo>",
  "candidate_fields": { "soc_pct": 73.5, "asset_active_power_kw": -4.2 },
  "diagnostics": [] }

Знаки — за канонічною конвенцією Wesfin: asset_active_power_kw плюс означає розряд, мінус — заряд. Перетворити конвенцію виробника — робота модуля; хост перевіряє результат.

Що модуль не може

Модуль не має імпортів, тому в нього немає файлів, мережі, змінних середовища, секретів, годинника, випадковості, бази даних, MQTT чи інтерфейсів пристроїв (Modbus, CAN). Модуль, що щось імпортує, зокрема звичайна збірка wasm32-wasip2, відхиляється ще до запуску з кодом FORBIDDEN_IMPORT.

МежаЗначення і код відмови
Розмір модуля2 МіБ · MODULE_TOO_LARGE
Хеш модулямає збігтися з SHA-256 · MODULE_HASH_MISMATCH
Вхід і вихідпо 64 КіБ · INPUT_TOO_LARGE, OUTPUT_TOO_LARGE
Пам’ять32 МіБ · MEMORY_LIMIT
Обчислення10 млн одиниць палива Wasmtime · FUEL_EXHAUSTED
Час250 мс · TIMEOUT

Кожен запуск — новий екземпляр в окремому процесі, тож модуль не може зберегти стан між запусками.

Як читати результат

Шар результатуЩо перевіряє
executionМодуль запустився і повернув відповідь у межах лімітів.
schemaКонверт відповіді і зв’язок із зразком (sample_id).
semanticЛише відомі канонічні поля вимірів із допустимими значеннями.
fixture_matchЗбіг з очікуваними значеннями тестових даних, якщо вони є.

Результат завжди несе environment LAB і production_eligible false. Кандидатні поля нікуди не публікуються: ні в цифровий двійник, ні в MQTT.

Спробувати

  1. У Lab

    Відкрийте робочий простір, розділ «Модулі». Оберіть еталонний модуль і тестові дані, натисніть «Запустити». У таблиці запусків видно стан, код помилки, паливо, час і хеш звіту.

  2. Локально

    Зберіть рушій і еталонний модуль з репозиторію (Rust і Wasmtime), потім запустіть приклад зі специфікації. Код виходу 0 — PASSED, 1 — FAILED, 2 — ERROR.

    shell
    wesfin-lab-runtime run \
      --module telemetry-normalizer.wasm \
      --sha256 "$(cut -d' ' -f1 MODULE.sha256)" \
      --fixture contracts/lab-wasm/fixtures/spec-example.json --workspace-id ws-local
  3. Власний модуль

    Почніть з еталонного модуля, зберіть під wasm32-unknown-unknown і перетворіть на компонент. Діліть масштабовані цілі (735 / 10.0), а не множте на 0.1.

Зараз у Lab запускаються лише еталонні модулі Wesfin, закріплені в репозиторії. Власні модулі виконуються локально; завантаження довільних модулів у Lab потребує окремого ізольованого середовища і ще не відкрите.