Як зробити · 5 хв
Імпортувати й перевірити профіль
Профіль пристрою — декларативний JSON без коду. Тут ви створите чернетку з прикладу або власного файлу, відредагуєте її, перевірите, зробите нову версію і прив’яжете її до джерела.
З чого почати
Усе це робиться на панелі «Студія профілів» у робочому просторі. Редагувати й запускати тести можуть власник, адміністратор і розробник.
| Кнопка | Що робить |
|---|---|
| Створити референсну чернетку | Готова чернетка батареї (BESS) у межах референсної стелі. Найпростіший старт. |
| Створити чернетку навантаження | Те саме для керованого навантаження. |
| Імпорт профілю JSON | Вставте власне визначення розміром до 64 КіБ. |
Найпростіше отримати правильний JSON так: створіть референсну чернетку, натисніть «Експортувати профіль JSON» і змініть файл під свій пристрій.
{
"schema_version": "lab-device-profile-1",
"profile_id": "WF-PROFILE-LAB-BATTERY-001",
"profile_version": "0.1.0",
"status": "DRAFT",
"manufacturer": "Wesfin Lab",
"model": "Deterministic reference BESS",
"asset_type": "BATTERY",
"supported_firmware": "1.0.0",
"created_by": "...", "created_at": "...", "updated_at": "...",
"connection": "SIMULATOR",
"telemetry": [ ... ],
"commands": { ... },
"constraints": { ... },
"safety": { ... },
"flexibility": { ... },
"evidence": ["ACKNOWLEDGED", "EXECUTED", "MEASURED", "RESTORE_EXECUTED", "RESTORED"],
"tests": []
}Імпорт і редагування
Вставте JSON
Розгорніть «Імпорт профілю JSON», вставте визначення і натисніть «Імпортувати як чернетку». Байти йдуть на сервер як є, щоб він міг відхилити дубльовані ключі й нескінченні числа.
Відкрийте чернетку
Lab відкриє сторінку версії. Вгорі — стан DRAFT, хеш визначення і version_id.
Відредагуйте
У «Редакторі профілю» змініть виробника, модель, прошивку, конектор, межі, політику безпеки і гнучкість. Телеметрію, команди й тестові вектори редагуйте в полі «Повне визначення JSON».
Збережіть
Натисніть «Зберегти чернетку». Валідація і тести працюють лише зі збереженою версією; незбережені зміни не враховуються.
Редагувати можна лише версію в стані DRAFT або VALIDATION_FAILED. Тип активу задає вихідна чернетка, змінити його в редакторі не можна.
Валідація і тести
Панель «Валідація та детерміновані тести» показує етапи SCHEMA → SEMANTIC → SAFETY → EXECUTION і «Причини блокування» для кожного. Натисніть «Валідувати збережену версію та запустити тести». Lab відкриє сторінку тестового запуску; звіт з’явиться, коли запуск завершиться.
Якщо прогін пройшов, версія стає VALIDATED. Якщо ні — VALIDATION_FAILED, і її знову можна редагувати. Одночасно для версії може йти лише один прогін.
Тести виконуються на референсній моделі та ізольованих фікстурах конектора. Інші прошивки й фізичні пристрої лишаються UNKNOWN.
Нова версія
Валідовану версію змінити не можна. На панелі «Нова версія та порівняння» введіть «Нова версія (формат 1.2.3)», наприклад 0.2.0, і натисніть «Створити похідну чернетку». Нова чернетка пам’ятає, від якої версії походить.
У полі «Порівняти з версією» оберіть іншу версію. Таблиця змін позначає кожну зміну як LOW, CONTROL_RELEVANT або SAFETY_RELEVANT. Зміни в constraints і safety завжди SAFETY_RELEVANT.
Прив’язка до джерела
Відкрийте джерело
На сторінці джерела знайдіть панель «Версія профілю пристрою».
Оберіть версію
У полі «Валідована версія» є лише версії VALIDATED. Тип активу і конектор профілю мають збігатися з джерелом.
Прив’яжіть
Натисніть «Прив’язати валідовану версію». Потрібні поточний звіт PASS, відсутність активної чи невизначеної команди, спокійний стан у нових межах і відкликані облікові дані.
Межі профілю можуть лише звузити межі джерела. Прив’язка скидає дозволи на керування й локальний запис: власник чи адміністратор має знову явно дати згоду. Усе це діє лише в Lab.
Типові проблеми
| Причина | Що робити |
|---|---|
| profile schema invalid | Імпорт відхилено: JSON не відповідає схемі, має невідоме поле, дубльований ключ, NaN або більший за 64 KiB. Порівняйте з експортованою референсною чернеткою. |
| profile version identity already exists | Такі profile_id і profile_version уже є в робочому просторі. Змініть profile_version. |
| FIRMWARE_RANGE_EMPTY | Діапазон прошивок суперечливий і не містить жодної версії. |
| SAFETY_TELEMETRY_MISSING | Для батареї потрібні asset_active_power_kw, soc_pct, available_charge_power_kw, available_discharge_power_kw. Для навантаження — asset_active_power_kw, baseline_kw, power_floor_kw, power_cap_kw. |
| DUPLICATE_TELEMETRY_MAPPING | Одне поле або source_key трапляється двічі. |
| MAPPING_DIMENSION_MISMATCH | Відсоткове поле зіставлене з невідсотковим ключем або навпаки. |
| PERCENT_MAPPING_INVALID | Для полів _pct потрібні одиниця %, scale 1 і sign 1. |
| POWER_MAPPING_UNIT_INVALID | Для потужності дозволені лише W і кВт. |
| CONSTRAINT_ORDER_INVALID | soc_min_pct має бути меншим за soc_max_pct, а тривалість — не більшою за TTL. Для навантаження: floor ≤ baseline ≤ cap. |
| FLEXIBILITY_EXCEEDS_DEVICE_LIMIT | Гнучкість більша, ніж дозволяють межі пристрою. Зменште available_up_kw чи available_down_kw. |
| HOME_ASSISTANT_MAPPING_CONNECTOR_MISMATCH | home_assistant_mapping є, але конектор не HOME_ASSISTANT. Приберіть мапу. |
| LOAD_BATTERY_TELEMETRY_FORBIDDEN | У профілі навантаження є поля батареї (SOC, SOH, заряд/розряд). Приберіть їх. |
| UNSAFE_RECOVERY_POLICY | restore_power_kw має бути 0 для батареї або мінус baseline для навантаження; replay_completed — false; stale_policy і offline_policy — REJECT. |
| DISTINCT_EVIDENCE_REQUIRED | evidence має містити всі п’ять: ACKNOWLEDGED, EXECUTED, MEASURED, RESTORE_EXECUTED, RESTORED. |
| PROTECTED_CONFIGURATION_WRITE | Запис захищеної конфігурації заборонений. Вимкніть protected_configuration_writable. |
| ttl_required, fail_closed, abort_restores | Ці прапорці безпеки, а також restore_after_ttl і restore_on_disconnect, мають бути true. |