Як зробити · 8 хв
Модуль нормалізації телеметрії на WebAssembly
Модуль перетворення телеметрії — маленька програма WebAssembly, яка бере сирі поля виробника і повертає кандидатні канонічні поля Wesfin. Lab запускає її в ізоляції з жорсткими межами, перевіряє кожен результат сам і записує хеші входу й виходу.
Навіщо модуль, якщо є профіль
Декларативного профілю досить, коли поле лише перейменувати й помножити. Але деякі пристрої віддають масштабовані цілі, окремі регістри заряду й розряду або знак навпаки. Модуль описує таке перетворення кодом, а версія модуля і його SHA-256 роблять результат відтворюваним.
Контракт: одна функція
Модуль — компонент WebAssembly з рівно одним експортом transform і без жодного імпорту. Вхід і вихід — JSON у UTF-8. Контракт wesfin:lab-telemetry@1.0.0 версіонується окремо від рушія.
world telemetry-transform {
export transform: func(input: list<u8>) -> result<list<u8>, string>;
}// 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.
Спробувати
У Lab
Відкрийте робочий простір, розділ «Модулі». Оберіть еталонний модуль і тестові дані, натисніть «Запустити». У таблиці запусків видно стан, код помилки, паливо, час і хеш звіту.
Локально
Зберіть рушій і еталонний модуль з репозиторію (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Власний модуль
Почніть з еталонного модуля, зберіть під wasm32-unknown-unknown і перетворіть на компонент. Діліть масштабовані цілі (735 / 10.0), а не множте на 0.1.
Зараз у Lab запускаються лише еталонні модулі Wesfin, закріплені в репозиторії. Власні модулі виконуються локально; завантаження довільних модулів у Lab потребує окремого ізольованого середовища і ще не відкрите.