AMPERE POINT Q Series and Home Assistant step-by-step guide banner with a dashboard of live charger data

Повна інтеграція Ampere Point Q Series зарядних пристроїв з Home Assistant — покроковий посібник

Jan Prószyński

Цей посібник допоможе підключити зарядний пристрій Ampere Point Q Series до Home Assistant і відкрити готову панель керування. Використовуємо офіційну інтеграцію Tuya та інтеграцію AmperePoint, установлену через HACS або Marketplace. Стандартне налаштування виконується в інтерфейсі, без редагування YAML і створення облікового запису Tuya Developer.

Оновлено: 4 листопада 2026 року · Q11, Q22, Q37, Q74 · базова версія інтеграції: 0.6.1. Доступні показники та команди залежать від покоління й прошивки зарядного пристрою.

1. Що потрібно

  • Зарядний пристрій Q Series, доданий до Tuya Smart або Smart Life, який працює в застосунку; для сполучення використовуйте Wi-Fi 2,4 ГГц.
  • Home Assistant 2025.2.0 або новіший на пристрої, який залишається ввімкненим.
  • Доступ до інтернету для HA та зарядного пристрою: цей спосіб підключення Q Series використовує хмару Tuya.
  • HACS або Marketplace та обліковий запис GitHub для авторизації додавання власного репозиторію.
  • Телефон із застосунком Tuya та другий екран для відображення QR-коду.

2. Установлення Home Assistant, якщо його ще немає

Установлення Home Assistant, якщо його ще немає

Якщо Home Assistant у вас уже запущений, переходьте одразу до розділу 3.

Варіант A: спеціалізований пристрій, рекомендовано для тривалого використання

На Raspberry Pi, міні-ПК або старому ноутбуці найпростіший шлях — Home Assistant OS. Це повна система, яка керує Home Assistant, оновленнями та резервними копіями. Офіційні інструкції для кожної платформи доступні тут: home-assistant.io/installation. Після встановлення панель керування зазвичай доступна в браузері за адресою http://homeassistant.local:8123.

Варіант B: комп’ютер Windows із Docker

Це хороший початок для тестування. Home Assistant працює в контейнері на вашому звичайному комп’ютері. Пам’ятайте, що автоматизації працюють лише коли комп’ютер увімкнено і Docker запущено.

  1. Встановіть WSL2, який потрібен Docker на Windows. Клацніть правою кнопкою на меню Пуск, відкрийте Термінал (адміністратор), введіть wsl --install, підтвердіть і перезавантажте комп’ютер після завершення. Інструкції Microsoft: learn.microsoft.com/pl-pl/windows/wsl/install.
  2. Встановіть Docker Desktop: docker.com/products/docker-desktop. Під час встановлення залиште ввімкненою опцію WSL 2. Після запуску Docker Desktop зачекайте, поки статус покаже, що він працює. Створення облікового запису Docker можна пропустити.
  3. Запустіть Home Assistant. Відкрийте Терминал без прав адміністратора та вставте: 
    mkdir C:\HomeAssistant\config
docker run -d --name homeassistant --restart=unless-stopped -e TZ=Europe/Warsaw -v "C:\HomeAssistant\config:/config" -p 8123:8123 ghcr.io/home-assistant/home-assistant:stable
    Перший запуск завантажує близько 1,5 ГБ і зазвичай займає кілька хвилин.
  4. Відкрити http://localhost:8123 у вашому браузері. Якщо сторінка не завантажується одразу, зачекайте одну-дві хвилини та оновіть.

Для варіанту з Docker перезапустіть Home Assistant у Docker Desktop: Containers → homeassistant → іконка перезапуску. Також можна використати docker restart homeassistant. Кнопка перезапуску може не з’являтися в меню Home Assistant у цій конфігурації, це нормально. Вам доведеться перезапустити кілька разів на наступних кроках.

Перший запуск для обох варіантів

Вітальний майстер попросить вас створити локальний обліковий запис, вибрати місцезнаходження та встановити одиниці виміру. Збережіть ім’я користувача та пароль у безпечному місці. На цьому етапі можна пропустити список автоматично виявлених пристроїв.

3. HACS або Marketplace

У HA 2026.11 і новішому відкрийте Налаштування → Marketplace. Згідно з документацією HA, Marketplace вбудований і перебирає функції HACS.

У HA 2026.10 і старішому відкрийте HACS на бічній панелі. Якщо його ще немає, виконайте офіційні інструкції для свого типу встановлення, перезапустіть HA, додайте інтеграцію HACS і авторизуйте її через GitHub.

Після цього відкрийте HACS або Marketplace для додавання репозиторію AmperePoint. Репозиторії застосунків/доповнень HA розташовані в іншому місці. Документація Marketplace.

4. Підключення офіційної інтеграції Tuya

  1. У HA відкрийте Налаштування → Пристрої та служби → Додати інтеграцію → Tuya.
  2. У Tuya Smart або Smart Life знайдіть Я → Налаштування → Обліковий запис і безпека → Код користувача / User Code. Введіть його в майстрі HA.
  3. Відскануйте QR-код тим самим застосунком і обліковим записом, до якого додано зарядний пристрій, та підтвердьте вхід.
  4. Перш ніж продовжити, перевірте, чи зарядний пристрій є серед пристроїв інтеграції Tuya. Офіційні інструкції Tuya.

5. Завантаження AmperePoint

  1. Відкрийте HACS → ⋮ → Власні репозиторії. У Marketplace скористайтеся додаванням власного репозиторію; кнопка нижче пропонує прямий перехід.
  2. Вставте повну адресу нижче, виберіть тип Інтеграція / Integration і натисніть Додати.
  3. Знайдіть TuyaExtend AmperePoint, відкрийте сторінку та завантажте поточний опублікований випуск.
  4. Перезапустіть Home Assistant, потім оновіть сторінку браузера. Для встановлення Container можна перезапустити контейнер.
  5. Завантаження файлів і додавання пристрою — окремі кроки. Після перезапуску виконайте наступний розділ.

Тип репозиторію: Integration

Відкрити репозиторій у моєму Home Assistant

Вставте адресу в поле репозиторію HACS/Marketplace без додаткового шляху до файлу чи папки. Назва в магазині — TuyaExtend AmperePoint; у налаштуваннях HA шукайте AmperePoint.

6. Додавання зарядного пристрою й відкриття панелі

  1. Відкрийте Налаштування → Пристрої та служби → Додати інтеграцію і знайдіть AmperePoint. Якщо HA вже автоматично додав запис зарядного пристрою, відкрийте його.
  2. Виберіть налаштування виявленого зарядного пристрою, зазначте правильний пристрій і надайте йому назву. Для цього способу Q Series використовується джерело Tuya.
  3. Установіть ціну електроенергії та валюту, перевірте інші параметри й завершіть майстер.
  4. Відкрийте Ampere Point - Tuya dashboard на бічній панелі. Спільна панель створюється автоматично; якщо зарядних пристроїв кілька, вибирайте потрібний у заголовку.

7. Показники та керування

Перевірте, чи панель показує правильний зарядний пристрій і актуальні дані. Доступні функції включають стан, потужність, енергію сеансу, ліміт струму, запуск/зупинку й діагностику.

Обсяг залежить від пристрою та даних, які передає Tuya. Вимірювання фаз, загальний лічильник і цільова енергія з’являються лише за підтримки джерелом.

Під час зміни ліміту струму панель показує вибране значення. Після команди дочекайтеся підтвердження від зарядного пристрою. Ліміт у HA має залишатися в межах, дозволених для пристрою та електромережі.

Приклад панелі зарядного пристрою Ampere Point у Home Assistant
Приклад панелі. Показники, вигляд і функції можуть відрізнятися залежно від версії та зарядного пристрою.

8. Додавання зарядного пристрою до Енергії

  1. Виберіть зарядний пристрій на панелі AmperePoint і розгорніть Енергія в Home Assistant / Energy in Home Assistant над нижньою частиною панелі. Там наведено точний ID сутності Енергія заряджання / Charging energy.
  2. У налаштуваннях Енергії додайте цю сутність як окремий пристрій. Кожен фізичний зарядний пристрій додавайте один раз. Енергія поточного чи останнього сеансу та діагностична енергія, обчислена з потужності, не є додатковими джерелами того самого споживання.
  3. Recorder має записувати цю сутність. Новий лічильник починає з нуля; попередня статистика не об’єднується автоматично. Для графіків потрібен час на збирання даних. Вартість сеансу є оцінкою за енергією й тарифом, а не розрахунком за історичними цінами. Вимірювання та перенесення даних.

9. Планувальник і сонячна енергія

Вбудований планувальник зберігає дні тижня, кілька часових вікон і ліміт струму для кожного вікна. Ручні перевизначення дозволяють заряджати протягом вибраного часу або до цільової енергії.

Команди планувальника виконує HA. Home Assistant і з’єднання із зарядним пристроєм мають бути доступні також у момент зупинки. Узгодьте розклад із застосунком Tuya та іншими автоматизаціями, щоб вони не надсилали суперечливих команд.

Від версії 0.6.1 режим PV може змінювати струм відповідно до надлишку сонячної енергії для джерела Tuya або зіставлених сутностей. У параметрах інтеграції вкажіть виробництво PV та потужність мережі зі знаком або окремий імпорт/експорт; перевірте одиниці й знак імпорту.

Записи AmperePoint Local (LAN) поки не мають параметрів PV. Режим типово вимкнений; регулятор цього випуску перевірявся на синтетичних даних, без тесту PV-заряджання на фізичному зарядному пристрої. Налаштування й обмеження PV.

10. Проблеми під час установлення

HACS не знаходить репозиторій або повідомляє про відсутню папку

Порівняйте введену адресу з полем вище та виберіть Integration. Відкрийте репозиторій у браузері. Якщо помилка залишається, збережіть її повний текст, адресу та версії HA і HACS/Marketplace. Саме повідомлення не визначає причину.

Після завантаження немає AmperePoint

Перезапустіть HA та оновіть браузер. Потім знайдіть AmperePoint у Пристрої та служби → Додати інтеграцію.

Майстер не виявляє зарядний пристрій

Перевірте, чи він онлайн у застосунку та видимий в офіційній інтеграції Tuya у HA. За потреби перезавантажте Tuya.

Панель повідомляє про неправильну конфігурацію або показує стару версію

Повністю оновіть сторінку та перевірте версію внизу панелі. Якщо проблема триває, надішліть помилку й список ресурсів Lovelace з їхніми типами. Видалення суфікса ?v= з адреси картки не є постійним виправленням.

Відсутні вимірювання фаз або інші значення

Доступність залежить від моделі, прошивки та джерела Tuya. Відсутнє значення саме по собі не означає помилку встановлення.

В Енергії ще немає графіка

Перевірте сутність Charging energy, її запис у Recorder і зачекайте накопичення статистики.

11. Оновлення та інші способи підключення

Перед оновленням створіть резервну копію HA. Завантажте новий випуск через HACS або Marketplace, перезапустіть HA й оновіть панель. Перевірте версію внизу. Під час переходу зберігайте робочі записи й перевіряйте залежні автоматизації перед видаленням.

Tuya Local і Xtend Tuya можуть бути додатковими джерелами для наявних або розширених конфігурацій. Для описаного налаштування Q Series достатньо офіційної Tuya та AmperePoint. Локальне керування пояснює окремий посібник Tuya Local. Wallbox PRIME використовує інший шлях LAN; дивіться інструкцію підключення.

Якщо потрібна допомога, напишіть на hello@amperepoint.com. Укажіть модель, прошивку, версії HA, інтеграції та HACS/Marketplace, крок і знімок повної помилки. Не надсилайте паролі, local key або токени.

Повернутися до блогу

Зарядні пристрої з лічильником енергії

Переглянути все