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

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

Імпортувати й перевірити профіль

Профіль пристрою — декларативний JSON без коду. Тут ви створите чернетку з прикладу або власного файлу, відредагуєте її, перевірите, зробите нову версію і прив’яжете її до джерела.

З чого почати

Усе це робиться на панелі «Студія профілів» у робочому просторі. Редагувати й запускати тести можуть власник, адміністратор і розробник.

КнопкаЩо робить
Створити референсну чернеткуГотова чернетка батареї (BESS) у межах референсної стелі. Найпростіший старт.
Створити чернетку навантаженняТе саме для керованого навантаження.
Імпорт профілю JSONВставте власне визначення розміром до 64 КіБ.

Найпростіше отримати правильний JSON так: створіть референсну чернетку, натисніть «Експортувати профіль JSON» і змініть файл під свій пристрій.

lab-device-profile-1 (скорочено / shortened)
{
  "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": []
}

Імпорт і редагування

  1. Вставте JSON

    Розгорніть «Імпорт профілю JSON», вставте визначення і натисніть «Імпортувати як чернетку». Байти йдуть на сервер як є, щоб він міг відхилити дубльовані ключі й нескінченні числа.

  2. Відкрийте чернетку

    Lab відкриє сторінку версії. Вгорі — стан DRAFT, хеш визначення і version_id.

  3. Відредагуйте

    У «Редакторі профілю» змініть виробника, модель, прошивку, конектор, межі, політику безпеки і гнучкість. Телеметрію, команди й тестові вектори редагуйте в полі «Повне визначення JSON».

  4. Збережіть

    Натисніть «Зберегти чернетку». Валідація і тести працюють лише зі збереженою версією; незбережені зміни не враховуються.

Редагувати можна лише версію в стані 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.

Прив’язка до джерела

  1. Відкрийте джерело

    На сторінці джерела знайдіть панель «Версія профілю пристрою».

  2. Оберіть версію

    У полі «Валідована версія» є лише версії VALIDATED. Тип активу і конектор профілю мають збігатися з джерелом.

  3. Прив’яжіть

    Натисніть «Прив’язати валідовану версію». Потрібні поточний звіт 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_INVALIDsoc_min_pct має бути меншим за soc_max_pct, а тривалість — не більшою за TTL. Для навантаження: floor ≤ baseline ≤ cap.
FLEXIBILITY_EXCEEDS_DEVICE_LIMITГнучкість більша, ніж дозволяють межі пристрою. Зменште available_up_kw чи available_down_kw.
HOME_ASSISTANT_MAPPING_CONNECTOR_MISMATCHhome_assistant_mapping є, але конектор не HOME_ASSISTANT. Приберіть мапу.
LOAD_BATTERY_TELEMETRY_FORBIDDENУ профілі навантаження є поля батареї (SOC, SOH, заряд/розряд). Приберіть їх.
UNSAFE_RECOVERY_POLICYrestore_power_kw має бути 0 для батареї або мінус baseline для навантаження; replay_completed — false; stale_policy і offline_policy — REJECT.
DISTINCT_EVIDENCE_REQUIREDevidence має містити всі п’ять: 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.