Довідка · 6 хв
Знаки потужності: заряд, розряд, імпорт і експорт
Найчастіша помилка інтеграції батареї чи інвертора — переплутаний знак потужності. Плюс у одного виробника означає заряд, у іншого — розряд. Wesfin використовує одну канонічну конвенцію, а знаки виробника перекладаються на межі адаптера.
Канонічна конвенція Wesfin
Знак описує напрямок енергії з погляду пристрою або точки приєднання. Ця конвенція однакова в Lab, у профілях пристроїв і в контракті телеметрії.
| Поле | Плюс (> 0) означає |
|---|---|
| asset_active_power_kw | Пристрій віддає енергію: батарея розряджається. Мінус — пристрій споживає: батарея заряджається, бойлер гріє. |
| grid_active_power_kw | Об’єкт імпортує енергію з мережі. Мінус — експорт в мережу. |
| target_active_power_kw | Команда розряджатися. Мінус — команда заряджатися. |
{
"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: імпорт має бути плюсом. |
// 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 ловить переплутаний знак
Профіль фіксує конвенцію
У профілі кожне поле телеметрії має канонічну назву й одиницю. У відповідності Home Assistant знак читання задає sign у полі (наприклад active_power.sign: 1 або -1), а знак уставки, яку Lab записує, окремо задає write_sign.
Команда має відомий напрямок
Обмежена команда розряду +0,5 кВт має дати виміряне +0,5 кВт. Якщо вимір показує -0,5 кВт, знак переплутано.
Вимір незалежний
MEASURED у доказах посилається на канонічне спостереження, а не на підтвердження пристрою. Тому помилка знака не сховається за «команду виконано».
Модуль нормалізації телеметрії на WebAssembly робить те саме перетворення в коді, а Lab незалежно перевіряє кожен його результат.