Кнопка Open in HACS працює лише тоді, коли HACS уже встановлено. HACS не є обов’язковим — без нього скористайтеся ручним встановленням нижче.
Картка для панелі керування: EyeBond Local Card додає готову панель Home Assistant з потоками енергії та графіками.
Немає заводського колектора? ESP EyeBond Collector — спільнотна прошивка-міст для підключення підтримуваних інверторів напряму до EyeBond Local без заводського хмарного реєстратора.
EyeBond Local — це локальний моніторинг і керування в Home Assistant для гібридних сонячних інверторів, які використовують EyeBond-сумісні Wi-Fi-колектори та відображаються в застосунках SmartESS / SmartValue.
Використовуйте, якщо ваш інвертор уже працює в застосунку SmartESS або SmartValue, а ви хочете локальний доступ через LAN із Home Assistant, а не залежати лише від хмари виробника.
Вона читає дані інвертора через локальну мережу. Для підтримуваних моделей також доступне безпечне керування: ліміти заряду, режим виходу, звуковий сигнал та інші налаштування, які підтримує саме ваш інвертор.
Примітка: Інтеграція активно розвивається. Частина інверторів підтримується повністю, частина — лише для читання, а для частини потрібен архів підтримки.
Відома проблема: На деяких системах оновлення в хмарі виробника можуть зупинятися, хоча показання Home Assistant продовжують змінюватися. Ми досліджуємо це; подробиці — у розділі про хмарну телеметрію.
Імовірно так, якщо:
- ваш інвертор відображається в застосунку SmartESS або SmartValue;
- він підключений через зовнішній або вбудований EyeBond-сумісний Wi-Fi-колектор;
- ви хочете, щоб Home Assistant читав дані інвертора локально через вашу LAN;
- ви хочете сенсори PV, батареї, навантаження, мережі та енергії в Home Assistant;
- вам потрібне опційне локальне керування на підтримуваних, перевірених моделях.
Часто цей проєкт шукають як інтеграцію SmartESS для Home Assistant, інтеграцію SmartValue для Home Assistant, підключення EyeBond Wi-Fi-колектора, або за брендами на кшталт Anenji, PowMr і Sandisolar — а також як локальний моніторинг сонячного інвертора без хмари виробника. Повний, завжди актуальний список — у каталозі моделей інверторів.
- Знаходить колектори звичайним пошуком, через уже відкрите з’єднання, фонове виявлення або ручне/віддалене налаштування.
- Спочатку додає перевірений колектор, а потім безпечно визначає інвертор через належне цьому запису з’єднання.
- Читає дані інвертора, батареї, PV, навантаження та мережі локально.
- Створює звичайні сутності Home Assistant: сенсори, числа, списки вибору, перемикачі та кнопки.
- За замовчуванням залишає адресу хмари виробника для роботи разом із Home Assistant, або дозволяє спрямувати колектор лише на Home Assistant — це оборотна, явна дія, яка ніколи не виконується непомітно.
- Дає вибрати рівень керування:
- Лише читання — тільки моніторинг.
- Автоматично — перевірене керування вмикається саме.
- Повне керування — ручне відкриття доступних елементів керування для досвідчених користувачів.
- На підтримуваних колекторах дозволяє змінювати Wi-Fi, перезапускати колектор, налаштовувати UART і спосіб підключення.
- Може зібрати хмарні дані лише для читання або перевірити додаткове керування для частково підтримуваного пристрою.
- Створює архів підтримки, виконує надані розробником діагностичні команди та, за потреби, записує трафік колектора.
- Працює з додатковою карткою EyeBond Local Card.
EyeBond Local спілкується з підтримуваними колекторами через вашу локальну мережу, тож щоденний моніторинг не залежить від доступності хмари виробника. Оновлення надходять на локальній швидкості, а дані інвертора лишаються у вашій інсталяції Home Assistant.
На підтримуваних колекторах можна одночасно залишити застосунок SmartESS або SmartValue робочим, або явно спрямувати колектор лише на Home Assistant. Home Assistant ніколи не перенаправляє колектор непомітно — спрямування на Home Assistant і відновлення попереднього сервера є явними, оборотними діями.
EyeBond Local призначена для інверторів, які використовують EyeBond-сумісні Wi-Fi-колектори. Це може бути окремий колектор або вбудований Wi-Fi-модуль.
Серед протестованих моделей — пристрої, що продаються під брендами Anenji, PowMr, Sandisolar, LVYUAN, MUST і Yingfa, а також пристрої протокольних родин SMG, PI18, PI30 та SRNE. Рівень підтримки залежить від моделі, і інші бренди на тих самих колекторах теж можуть працювати.
Поточний список моделей:
Після додавання колектора визначення в рантаймі показує, який інвертор знайдено та який рівень підтримки доступний:
- Підтримується — нормальний моніторинг і підтверджене керування.
- Обмежена / часткова підтримка — моніторинг працює, але частина сенсорів або керування може бути відсутня.
- Лише читання — моніторинг працює, керування вимкнене.
- Невідомий пристрій — для перевірки потрібен архів підтримки.
Якщо вашої моделі немає у списку, вона все одно може працювати. Додайте пристрій, створіть архів підтримки й відкрийте звернення на GitHub.
Тестовий код, який ще не увійшов до релізу, також містить обмежений профіль EyeBond Short-ASCII family для протоколу деяких Anern і Maxinn. Він надає базові показання, а на пристроях із відповідними відповідями — також дані BMS та номінальні параметри. Це визначення протоколу, не комерційної моделі. Додаткові сутності вимкнені за замовчуванням. Дивіться доступні показання й обмеження.
Якщо у вашого інвертора немає заводського колектора, можна використати спільнотний ESP EyeBond Collector.
Це невеликий міст на ESP8266/ESP32, який підключається до інвертора і працює з цією інтеграцією локально. Оскільки він не використовує хмару виробника, доступні тільки локальні функції Home Assistant.
- Відкрийте HACS → Інтеграції.
- Натисніть меню → Користувацькі репозиторії.
- Додайте
https://github.com/groove-max/ha-eybond-localяк інтеграцію. - Знайдіть EyeBond Local і натисніть Завантажити.
- Перезапустіть Home Assistant.
- Перейдіть у Налаштування → Пристрої та служби → Додати інтеграцію і знайдіть EyeBond Local.
- Завантажте архів з останнього релізу EyeBond Local.
- Скопіюйте
custom_components/eybond_local/уconfig/custom_components/. - Перезапустіть Home Assistant.
- Додайте EyeBond Local через Налаштування → Пристрої та служби.
Зберігайте резервні копії поза config/custom_components/. Перейменування
старої папки на eybond_local_backup усередині цього каталогу не вимикає її:
Home Assistant може знайти незмінений manifest і завантажити старий код.
Залиште там лише потрібну папку eybond_local/ і повністю перезапустіть Home
Assistant; після заміни Python-файлів перезавантаження лише інтеграції недостатньо.
Використовуйте цей спосіб лише тоді, коли розробник просить перевірити виправлення, якого ще немає в релізі. Така збірка не оновлюється через HACS і може змінитися до наступного релізу.
- Створіть резервну копію конфігурації Home Assistant.
- Завантажте архів поточної гілки
main. - Видаліть наявну папку
config/custom_components/eybond_local/, а потім скопіюйте туди всю папку з архіву. Не змішуйте файли з різних збірок. - Перезапустіть Home Assistant і перевірте записи EyeBond Local.
- Разом із результатом вкажіть Git commit зі сторінки репозиторію та додайте новий архів підтримки.
Щоб повернутися до опублікованої версії, перевстановіть останній реліз через HACS або повністю замініть папку версією з архіву релізу.
Майстер налаштування ідентифікує та додає колектор. Після створення запису інтеграція визначає інвертор через належну цьому запису сесію та створює його сутності. Повний опис результатів пошуку, підтвердження адреси, фонового виявлення та ручного налаштування: Налаштування та пошук.
Якщо колектор уже в тій самій Wi-Fi/LAN-мережі, що й Home Assistant, продовжуйте.
Якщо ні — скористайтеся застосунком виробника, ручним налаштуванням Wi-Fi або Bluetooth-налаштуванням, якщо ваш колектор це підтримує.
Виберіть мережевий інтерфейс Home Assistant і запустіть пошук. Один обмежений
пошук поєднує широкомовні відповіді, уже підключені колектори та локальну
перевірку адрес у межах /24, якщо broadcast не спрацював. У більшій мережі
вкажіть правильну broadcast-адресу підмережі або відому адресу колектора через
розширене налаштування: усі адреси мережі /16 послідовно не перевіряються.
Якщо пошук нічого не знайшов, повторіть його, виберіть інший мережевий інтерфейс Home Assistant або введіть адресу колектора вручну через розширене налаштування.
Майстер може показати такі результати:
- Готово до налаштування — колектор ідентифіковано, його можна додати.
- Потребує уточнення — колектор ідентифіковано через вхідне з’єднання, але треба вказати доступну з Home Assistant адресу.
- Перевірити адресу — адреса відповіла, її можна перевірити безпосередньо.
Підтвердьте колектор і виберіть, як мають оновлюватися сенсори. Home Assistant створить запис, після чого визначення інвертора продовжиться в рантаймі. Пристрій інвертора може з’явитися трохи пізніше за пристрій колектора.
Профіль роботи колектора налаштовується пізніше в Підключення колектора та хмари, після того як інтеграція створить пристрій і прочитає можливості колектора.
Ручне налаштування доступне, коли автоматичний пошук не підходить.
Порада: Автопошук найкраще працює, коли Home Assistant і колектор у тій самій мережі.
EyeBond Local зазвичай створює два пристрої Home Assistant:
- Колектор — Wi-Fi, мережеві дії, параметри підключення, перезапуск, архів підтримки та дії для діагностики.
- Інвертор — сенсори, лічильники енергії, стани та підтримуване керування.
На пристрої інвертора можуть бути:
- сенсори PV, навантаження, батареї, інвертора та мережі;
- лічильники енергії для панелі енергії Home Assistant;
- аварії, помилки та режим роботи;
- безпечне керування, яке підтримує саме ваша модель;
- режим оновлення сенсорів: Автоматичний дозволяє інтеграції вибрати
безпечний інтервал за часом відповіді пристрою; Ручний використовує
фіксований інтервал від
2до3600секунд.
Профіль роботи колектора можна змінити пізніше в Підключення колектора та хмари. Вибір драйвера інвертора, режим керування й оновлення сенсорів знаходяться в Опитування та визначення інвертора.
В автоматичному режимі EyeBond Local залишає невелику паузу між циклами опитування та враховує обмеження конкретного протоколу. Наприклад, швидкі Modbus-пристрої можуть оновлюватися частіше, ніж повільніші ASCII-пристрої. У ручному режимі діагностичні сенсори Poll Utilization, Poll Duration і Recommended Poll Interval показують, чи реалістичний вибраний інтервал; якщо завантаження опитування стабільно високе, збільште інтервал або поверніться до автоматичного режиму. Poll Context показує, чи поточний цикл читає інвертор, шукає інвертор або лише перевіряє колектор, щоб довгі цикли пошуку не плуталися зі звичайним опитуванням під час роботи.
Вибір драйвера, швидкий і повний пошук протоколу, кілька знайдених протоколів, режими керування та різницю між недоступними й вимкненими сутностями пояснено в Визначення інвертора та сутності.
Деякі пристрої спочатку додаються в режимі лише читання або часткової підтримки. Розширити підтримку пристрою може зібрати додаткові дані або перевірити, які локальні сенсори й елементи керування підтримує саме ваш пристрій.
Використовуйте це, коли:
- інтеграція пропонує це для вашого пристрою;
- моніторинг працює, але керування відсутнє;
- розробник попросив запустити навчання для додавання моделі.
Що відбувається:
- Відкрийте Налаштувати → Розширити підтримку пристрою.
- Виберіть Аналізувати дані пристрою (рекомендовано) або розширену активну перевірку елементів керування.
- Якщо доступно кілька сумісних API, виберіть конкретне хмарне джерело для цього запуску.
- Для активної перевірки підтвердьте тимчасову зміну endpoint колектора, обмежені тестові команди через хмару та їх локальне перехоплення Home Assistant.
- Увійдіть у підтримуваний хмарний акаунт лише для цього сеансу, якщо це буде запропоновано.
- Перегляньте результат. Дані лише для читання не створюють сутності автоматично; застосувати можна тільки локально підтверджені активні результати.
Хмарний пароль не зберігається. Знайдені елементи застосовуються тільки до цього пристрою Home Assistant, доки їх не буде перевірено і додано до вбудованого каталогу.
Якщо щось виглядає небезпечно або незрозуміло, зупиніться і створіть архів підтримки.
Повний опис: Навчання пристрою.
Якщо щось не працює:
- Відкрийте інтеграцію в Налаштування → Пристрої та служби.
- Натисніть Налаштувати → Діагностика та сервісні інструменти.
- Натисніть Створити архів підтримки.
- Відкрийте звернення на GitHub і прикріпіть ZIP.
Архів підтримки — найкращий спосіб повідомити про непідтримуване обладнання, помилку налаштування, відсутні сенсори або відсутнє керування.
Детальніше: Архів підтримки.
Шаблони звернень:
- Повідомлення про помилку — щось зламалося на вже підтримуваному обладнанні.
- Архів підтримки / діагностика обладнання — нове обладнання, невдале налаштування, відсутні сенсори або керування.
- Дані про пристрій — поділіться результатом навчання частково підтримуваного або нерозпізнаного пристрою разом з архівом підтримки, щоб додати його до вбудованого каталогу.
- Запит функції — покращення інтерфейсу або нові можливості.
| Проблема | Що спробувати |
|---|---|
| Автопошук нічого не знаходить | Повторіть пошук або виберіть інший мережевий інтерфейс Home Assistant. За потреби відкрийте Налаштування та пошук і введіть відому адресу колектора. |
| Bluetooth Wi-Fi недоступний | Переконайтеся, що Home Assistant має Bluetooth поруч із колектором. Може допомогти ESPHome Bluetooth Proxy біля колектора. |
| Ручне налаштування не може підтвердити пристрій | Не закривайте майстер і повторіть спробу, коли пристрій доступний. Для вхідного підключення увімкніть фонове виявлення й продовжте, коли з’явиться ідентифікована сесія. |
| З’явився лише пристрій колектора | Визначення інвертора ще не завершилося. Перевірте Poll Context і відкрийте Визначення інвертора та сутності; якщо драйвер не визначиться, створіть архів підтримки. |
| Сенсори недоступні | Перевірте, що колектор і Home Assistant у тій самій мережі, а Wi-Fi колектора стабільний. |
| Застосунок виробника перестав показувати дані | Перевірте режим підключення: Лише Home Assistant навмисно відключає хмару. Якщо ви й далі використовуєте Хмара + Home Assistant, дивіться відому проблему хмарної телеметрії нижче. |
| Застосунок виробника працює, а Home Assistant показує недоступність | Колектор міг швидше відновити зв'язок із хмарою, ніж локально з Home Assistant. Зачекайте кілька хвилин і перевірте Wi-Fi. |
| Налаштування одразу повертається назад | Інвертор відхилив значення або не підтвердив зміну. Не змінюйте той самий параметр у застосунку виробника одночасно й повторіть після стабілізації колектора. |
| Потрібне віддалене підключення | Дивіться посібник з віддаленого підключення / NAT. За можливості використовуйте VPN замість відкриття порту в інтернет. |
| Немає керування | Для нормального використання залишайте Автоматично. Якщо моніторинг працює, але керування відсутнє, запустіть навчання пристрою, якщо воно доступне, або створіть архів підтримки. Повне керування використовуйте лише якщо розумієте ризик. |
| Неналаштований колектор підключиться пізніше | Увімкніть постійний запис EyeBond Local — Discovery. Він покаже ідентифіковану сесію колектора, не створюючи тимчасовий пристрій. |
Деякі користувачі повідомляють, що в режимі Хмара + Home Assistant застосунок виробника перестає оновлювати дані або показує колектор офлайн, хоча локальні показання Home Assistant продовжують змінюватися. Хмарні оновлення можуть відновитися самостійно. Проблема відома й досліджується. Її причину та універсальне виправлення ще не підтверджено.
Це відрізняється від режиму Лише Home Assistant, у якому відключення хмари навмисне. Ні збільшення інтервалу опитування, ні перезапуск не є підтвердженим універсальним вирішенням періодичних збоїв.
Якщо це сталося, створіть архів підтримки під час збою, за можливості до перезапуску чи перемикання режиму. Додайте його до issue #13 або вашого наявного звернення разом із такими відомостями:
- встановлена версія, а для ручної тестової збірки — також коміт;
- час початку проблеми, ваш часовий пояс і час останніх даних у хмарі;
- чи продовжують змінюватися показання Home Assistant і коли відновиться хмара.
Для повідомлення про цей збій не потрібно видаляти інтеграцію чи скидати колектор.
- Покажчик документації
- Налаштування та пошук
- Визначення інвертора та сутності
- Розширене керування Kevolt / Deye-сумісними моделями — експериментальні налаштування для документованої карти 80 кВт
- Керування колектором
- Навчання пристрою
- Діагностичні команди — розширені сценарії від розробника
- Архів підтримки
- Віддалене підключення / NAT
- Захоплення трафіку колектора — використовуйте лише коли просять під час підтримки
- Каталог моделей інверторів
- Приклади інтерфейсу за версіями — візуальні приклади з поясненням перенесених елементів
- Як допомогти проєкту
Ліцензовано під MPL-2.0.