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

Довідка · 6 хв

Знаки потужності: заряд, розряд, імпорт і експорт

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

Канонічна конвенція Wesfin

Знак описує напрямок енергії з погляду пристрою або точки приєднання. Ця конвенція однакова в Lab, у профілях пристроїв і в контракті телеметрії.

ПолеПлюс (> 0) означає
asset_active_power_kwПристрій віддає енергію: батарея розряджається. Мінус — пристрій споживає: батарея заряджається, бойлер гріє.
grid_active_power_kwОб’єкт імпортує енергію з мережі. Мінус — експорт в мережу.
target_active_power_kwКоманда розряджатися. Мінус — команда заряджатися.
canonical telemetry
{
  "asset_active_power_kw": -4.2,   // the battery charges at 4.2 kW
  "grid_active_power_kw": 1.3,     // the site imports 1.3 kW from the grid
  "soc_pct": 73.5
}

Запам’ятайте одне правило: знак пристрою — «віддає чи бере», знак мережі — «купуємо чи продаємо». Вони незалежні: батарея може заряджатися (мінус) і водночас об’єкт може експортувати (теж мінус), якщо сонячна станція виробляє більше.

Навантаження: бойлер, нагрівач, зарядна станція

Кероване навантаження лише споживає, тому його потужність у канонічній моделі від’ємна. Скоротити споживання означає наблизити значення до нуля.

Приклад із тестових векторів Lab: базове споживання -5 кВт, обмежена команда -3 кВт на 10 секунд, потім виміряне повернення до -5 кВт. Додатна ціль для навантаження відхиляється, як і ціль за межами заявлених floor і cap.

Типові пастки

Що показує виробникЩо зробити
Плюс при заряді батареїІнвертуйте знак в адаптері: asset_active_power_kw = -vendor_power.
Потужність у ватахПоділіть на 1000. У відповідності Home Assistant це unit W у полі active_power.
Масштабоване ціле: 735 означає 73,5 %Діліть (735 / 10.0), а не множте на 0.1, щоб значення було точним.
Окремі регістри заряду й розряду, обидва додатніЗведіть в одне поле: розряд мінус заряд.
Лічильник у точці приєднання з «експорт = плюс»Інвертуйте для grid_active_power_kw: імпорт має бути плюсом.
adapter conversion
// Vendor: power_w = +4200 while charging, battery_soc = 735 (tenths of a percent)
asset_active_power_kw = -(power_w / 1000.0)   // -4.2
soc_pct               = battery_soc / 10.0    // 73.5

Як Lab ловить переплутаний знак

  1. Профіль фіксує конвенцію

    У профілі кожне поле телеметрії має канонічну назву й одиницю. У відповідності Home Assistant знак читання задає sign у полі (наприклад active_power.sign: 1 або -1), а знак уставки, яку Lab записує, окремо задає write_sign.

  2. Команда має відомий напрямок

    Обмежена команда розряду +0,5 кВт має дати виміряне +0,5 кВт. Якщо вимір показує -0,5 кВт, знак переплутано.

  3. Вимір незалежний

    MEASURED у доказах посилається на канонічне спостереження, а не на підтвердження пристрою. Тому помилка знака не сховається за «команду виконано».

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