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

Покроковий посібник: від встановлення Home Assistant, через HACS і xtend_tuya, до повних даних зарядного пристрою, панелі Energy та корисних автоматизацій. Написано так, щоб навіть той, хто ніколи раніше не користувався Home Assistant, міг легко слідувати інструкції.

Моделі: Q11, Q22, Q37, Q74  ·  оновлено: липень 2026

Зарядні пристрої Ampere Point Q Series — це Wi-Fi зарядки на платформі Tuya. Це означає, що їх можна підключити до Home Assistant, найпопулярнішої безкоштовної системи розумного дому, і використовувати не лише для базового керування у мобільному додатку:

• Моніторинг у реальному часі: потужність, струм і напруга по кожній фазі, енергія сесії, загальна енергія та статус заряджання,
• Керування: запуск і зупинка заряджання, зміна ліміту струму,
• Автоматизації: заряджання лише у години зниженої тарифікації, з надлишку сонячної енергії або за динамічними тарифами на електроенергію,
• Історія та статистика споживання на панелі Energy, корисні для звітності та відстеження витрат.

Інтеграція працює через хмару Tuya, тому і зарядний пристрій, і Home Assistant мають мати доступ до інтернету.

Зміст

1. Що вам потрібно
2. Встановлення Home Assistant, якщо у вас його ще немає
3. Встановлення HACS
4. Офіційна інтеграція Tuya
5. Додаток xtend_tuya для розширених даних зарядного пристрою
6. Повний набір даних із ключами Tuya developer cloud
7. Що ви отримуєте після інтеграції та на панелі Energy
8. Приклади автоматизацій
9. Поширені проблеми та їх вирішення
10. Альтернатива: локальне керування через tuya-local
11. Всі посилання в одному місці

1. Що вам потрібно

• Зарядний пристрій Ampere Point Q Series доданий у додаток Smart Life для Android або Smart Life для iPhone і коректно працює там.
• Wi-Fi мережа 2,4 ГГц. Модулі Tuya не підключаються до мереж 5 ГГц. Якщо ваш роутер транслює 2,4 ГГц і 5 ГГц під однією назвою мережі, варто тимчасово розділити мережу 2,4 ГГц під час сполучення.
• Комп’ютер або невеликий сервер для Home Assistant. Він має працювати безперервно, якщо ви хочете, щоб автоматика працювала постійно. Зазвичай використовують Raspberry Pi, міні-ПК або звичайний комп’ютер на Windows.
• Безкоштовний акаунт на GitHub, потрібен один раз для авторизації HACS.
• Ваш телефон із додатком Smart Life поруч, бо під час налаштування потрібно сканувати QR-коди.
• Приблизно 1-2 години. Більшість кроків — прості налаштування з підказками.

2. Встановлення 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

HACS, магазин спільноти Home Assistant, є спільнотним магазином додатків. Ми використаємо його для встановлення xtend_tuya. Офіційні інструкції тут: hacs.xyz/docs/use/download/download. Виберіть вкладку, що відповідає вашій установці.

• Home Assistant OS: додайте репозиторій доповнень https://github.com/hacs/addons відповідно до офіційних інструкцій, встановіть і запустіть доповнення Get HACS, потім перезавантажте Home Assistant.
• Опція Docker: виконайте це в Терминалі:

  docker exec homeassistant bash -c "wget -O - https://get.hacs.xyz | bash -"
  docker restart homeassistant

Після перезавантаження додайте інтеграцію: Налаштування → Пристрої та сервіси → Додати інтеграцію, знайдіть HACS і прийміть умови. Home Assistant покаже код, який потрібно ввести на github.com/login/device після входу в GitHub. Підтвердіть натисканням Authorize. Через деякий час HACS з’явиться в бічному меню.

4. Офіційна інтеграція Tuya

Цей крок підключає Home Assistant до вашого облікового запису Smart Life.

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

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

5. Доповнення xtend_tuya для розширених даних зарядного пристрою

xtend_tuya працює разом з офіційною інтеграцією Tuya і додає відсутні сутності до тих самих пристроїв. Сторінка проєкту: github.com/azerty9971/xtend_tuya.

5.1. Завантаження в HACS

1. Відкрийте HACS у бічному меню та знайдіть Xtend Tuya. Ви також можете скористатися цим прямим посиланням: відкрити Xtend Tuya в моєму Home Assistant.
2. На сторінці доповнення натисніть Завантажити і підтвердіть.
3. Перезапустіть Home Assistant.

Завантаження в HACS — це лише перша половина процесу. Воно копіює файли на диск, але ще не додає інтеграцію. Сутності з’являються лише після додавання інтеграції в розділі 5.2. Це найпоширеніше непорозуміння у всій налаштуванні: після завантаження кнопка Завантажити зникає, на сторінці доповнення показується лише опис, а кількість сутностей не зростає навіть після перезавантажень. Якщо ви бачите саме це, все гаразд. Продовжуйте до наступного кроку.

5.2. Додати інтеграцію

1. Перейдіть до Settings → Devices & services → Add integration і знайдіть Xtend Tuya.
2. Введіть той самий User Code, що в розділі 4, і знову відскануйте QR-код за допомогою додатку Smart Life.
3. Після підтвердження QR-коду з’явиться нове вікно під назвою Add Tuya OpenAPI credentials. Прочитайте примітку нижче перед натисканням будь-яких кнопок.

Найважливіша порада в цьому посібнику. Не закривайте вікно Add Tuya OpenAPI credentials кнопкою X. Закриття скасовує весь майстер без чіткого повідомлення. Інтеграція не буде додана, навіть якщо здається, що налаштування завершено. Якщо у вас ще немає ключів хмари розробника Tuya, які ми отримаємо в розділі 6:

1. позначте Don't ask for OpenAPI credentials,
2. також оберіть країну Польща та кінцеву точку Європа. Форма все ще вимагає ці поля, і без них може з’явитися незрозуміла помилка валідації,
3. підтвердіть, потім натисніть Finish на наступному екрані з назвами та зонами.

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

Після завершення майстра у списку інтеграцій з’явиться Xtend Tuya. Ваш зарядний пристрій отримає від кількох до понад двадцяти нових сутностей, включно з датчиками напруги, струму, потужності, енергії та стану. Якщо запис Xtend Tuya відсутній, майстер було перервано. Повторіть розділ 5.2.

6. Повний набір даних із ключами хмари розробника Tuya

Цей етап необов’язковий, але рекомендований. Без нього деякі сутності можуть бути недоступні або оновлюватися повільніше. Ми створимо безкоштовний проект на платформі розробника Tuya і додамо його ключі до xtend_tuya. Документація доповнення також описує цю процедуру тут: керівництво з облікових даних хмари.

6.1. Створення проекту на платформі Tuya

1. Перейдіть до platform.tuya.com і створіть безкоштовний акаунт. Ви можете використовувати ту ж електронну адресу, що й у Smart Life.
2. Перейдіть до Cloud → Development → Create Cloud Project. Введіть будь-яку назву проекту. Для Industry та Development Method оберіть Smart Home. Для Data Center оберіть Central Europe Data Center. Центр обробки даних має відповідати регіону вашого облікового запису Smart Life. Для Польщі це Центральна Європа. Безкоштовний план дозволяє один центр обробки даних.
3. У вікні Authorize API Services прийміть запропоновані сервіси.
4. Прив’яжіть обліковий запис додатку: Пристрої → Прив’язати обліковий запис додатку → Додати обліковий запис додатку, відскануйте QR-код за допомогою Smart Life і підтвердіть. Виберіть Автоматичне підключення, щоб нові пристрої могли підключатися автоматично. Через деякий час ваш зарядний пристрій має з’явитися у списку пристроїв.
5. Знайдіть ключі вашого проекту на вкладці Огляд у розділі Авторизаційний ключ: Access ID / Client ID та Access Secret / Client Secret. Використайте іконку ока, щоб показати секрет.

Client Secret працює як пароль для вашого проекту. Не діліться ним і не вставляйте у публічні місця. За потреби ви можете скинути його на вкладці Огляд. Після скидання оновіть ключ у Home Assistant.

6.2. Увімкнення повних точок даних за допомогою DP Instruction

За замовчуванням хмара Tuya може показувати пристрої в спрощеному режимі, який приховує деякі точки даних. Щоб відкрити повний набір, переключіть продукт у режим DP Instruction: Пристрої → Всі пристрої → кнопка з трьома крапками поруч із Переглянути пристрої за продуктом → наведіть курсор на картку продукту → іконка олівця → поставте прапорець DP Instruction → Зберегти налаштування. Попередження, яке показує платформа, стосується лише цього API-проекту. Додаток Smart Life і сам зарядний пристрій працюють як раніше. Ілюстровані інструкції доступні в документації xtend_tuya.

6.3. Введіть ключі в Home Assistant

1. Перейдіть до Налаштування → Пристрої та сервіси → Xtend Tuya → Налаштувати. Відкриється те саме вікно облікових даних OpenAPI.
2. Цього разу зніміть прапорець Не запитувати облікові дані OpenAPI. Виберіть країну Польща та кінцеву точку Європа, потім вставте Access ID та Access Secret із вкладки Огляд проекту Tuya. Підтвердіть.
3. Перезапустіть Home Assistant і зачекайте одну-дві хвилини. Кількість сутностей зарядного пристрою має знову збільшитися. Якщо ні, скористайтеся Перезавантажити у меню з трьома крапками поруч із інтеграцією Xtend Tuya.

7. Що ви отримуєте після інтеграції та на панелі енергоспоживання

Точний список сутностей залежить від моделі зарядного пристрою, але зазвичай включає:

Показники	Керування
стан заряджання, миттєва потужність, струм і напруга для фаз L1 до L3, енергія поточної сесії, загальна енергія та коди помилок	початок і зупинка заряджання, обмеження струму заряджання, наприклад зменшення з 16 А до 10 А, та доступні режими пристрою

Варто давати сутностям зрозумілі назви в розділі Налаштування → Пристрої та сервіси → Сутності. Якщо один елемент, наприклад вимикач, з’являється двічі — один раз від Tuya, а інший від xtend_tuya, це нормально. Ви можете просто вимкнути дубліковану сутність, яку не хочете використовувати.

Панель енергоспоживання: перейдіть у Settings → Dashboards → Energy. У розділі Individual devices додайте сутність загальної енергії зарядного пристрою. Через одну-дві години Home Assistant почне будувати щоденні та місячні графіки споживання. Детальніше про панель енергоспоживання: home-assistant.io/docs/energy.

8. Приклади автоматизацій

Автоматизації створюються в розділі Settings → Automations & scenes → Create automation. Наведені нижче приклади можна вставити в режимі редагування YAML. Замініть ідентифікатори сутностей, такі як sensor.… і switch.…, на свої власні з вкладки Entities. Сповіщення на телефон вимагають безкоштовного додатка Home Assistant Companion.

Заряджання лише в період пільгового тарифу, з 22:00 до 06:00:

alias: Charge during off-peak tariff
trigger:
  - platform: time
    at: "22:00:00"
    id: start
  - platform: time
    at: "06:00:00"
    id: stop
action:
  - choose:
      - conditions: [{ condition: trigger, id: start }]
        sequence:
          - service: switch.turn_on
            target: { entity_id: switch.charger_switch }
      - conditions: [{ condition: trigger, id: stop }]
        sequence:
          - service: switch.turn_off
            target: { entity_id: switch.charger_switch }

Сповіщення про завершення заряджання:

alias: Charging finished
trigger:
  - platform: state
    entity_id: sensor.charger_status
    from: "charging"
    to: "charger_free"
action:
  - service: notify.mobile_app_your_phone
    data:
      title: "Зарядний пристрій"
      message: "Заряджання завершено."

Заряджання від надлишку сонячної енергії, якщо в Home Assistant є датчик потужності, що експортується в мережу:

alias: Charge from excess solar
trigger:
  - platform: numeric_state
    entity_id: sensor.grid_export_power
    above: 3000
    for: "00:05:00"
    id: start
  - platform: numeric_state
    entity_id: sensor.grid_export_power
    below: 500
    for: "00:05:00"
    id: stop
action:
  - choose:
      - conditions: [{ condition: trigger, id: start }]
        sequence:
          - service: switch.turn_on
            target: { entity_id: switch.charger_switch }
      - conditions: [{ condition: trigger, id: stop }]
        sequence:
          - service: switch.turn_off
            target: { entity_id: switch.charger_switch }

9. Загальні проблеми та їх вирішення

Симптом	Що робити
Після завантаження xtend_tuya в HACS кількість сутностей не збільшується, а перезавантаження не допомагають.	Завантаження файлів — це не те саме, що додавання інтеграції. Перевірте, чи з’являється Xtend Tuya у розділі Settings → Devices & services. Якщо ні, завершіть майстер із розділу 5.2.
Вікно облікових даних OpenAPI було закрите кнопкою X, і інтеграція зникла.	Майстер було скасовано. Запустіть його знову та обробіть вікно, як описано в розділі 5.2: прапорець, країна, кінцевий пункт, потім підтвердіть.
У формі OpenAPI відображається помилка, наприклад value must be one of [...].	Навіть якщо встановлено прапорець Don't ask..., все одно потрібно вибрати країну та кінцевий пункт. Виберіть Poland і Europe, потім підтвердіть.
У журналах відображається sign invalid.	Ідентифікатор доступу або секрет було вставлено з помилкою або зайвим пробілом, або вибрано неправильний кінцевий пункт. Скопіюйте ключі ще раз із вкладки Огляд проекту. Для Польщі кінцевий пункт — Europe.
У журналах відображається permission deny або код 1106.	У вашому проекті на платформі Tuya перевірте вкладку Service API. Сервіси IoT Core та Authorization мають бути активними. Використовуйте Authorize або Renew за потреби.
Інтеграція працювала, але через кілька місяців дані перестали оновлюватися.	Безкоштовний пробний період IoT Core міг закінчитися. На платформі Tuya перейдіть у Cloud → project → IoT Core → Extend Trial. Продовження безкоштовне. Варто встановити нагадування в календарі.
QR-код з платформи Tuya не працює або не вдається зв’язати обліковий запис у додатку.	Обліковий запис Smart Life і проект, ймовірно, знаходяться в різних дата-центрах. Створіть проект у Центральноєвропейському дата-центрі для облікових записів, що використовуються в Польщі.
Всі сутності зарядного пристрою недоступні.	Інтеграція працює через хмару. Перевірте доступ до інтернету та підтвердіть, що зарядний пристрій онлайн у Smart Life. Коли з’єднання відновиться, сутності мають автоматично відновитися.
Зарядний пристрій не підключається до Wi-Fi після зміни роутера або пароля.	Переконайтеся, що мережа Wi-Fi 2,4 ГГц увімкнена, і повторно спаруйте зарядний пристрій у Smart Life. Він повинен автоматично з’явитися в Home Assistant.
Після оновлення Home Assistant Xtend Tuya не запускається.	Перевірте HACS на наявність новішої версії додатку та оновіть його. Користувацькі інтеграції можуть бути чутливими до великих релізів Home Assistant. Перед оновленням Home Assistant часто варто почекати кілька днів і перевірити сторінку проблем проекту.
Один і той самий вимикач з’являється двічі.	Це нормально, коли xtend_tuya працює разом з офіційною інтеграцією Tuya. Вимкніть дубліковану сутність, яка вам не потрібна. Не видаляйте інтеграцію.
Навіть після всіх кроків у пристрою залишається лише одна сутність.	Іноді визначення продукту Tuya надає лише обмежений набір даних. Зв’яжіться з нами за адресою hello@amperepoint.com з вашою моделлю та коротким описом проблеми. Ми перевіримо конфігурацію продукту на стороні хмари.

10. Альтернатива: локальне керування з tuya-local

Якщо ви хочете незалежність від хмари, щоб керування працювало навіть без доступу до інтернету, ви можете замість цього використовувати tuya-local. Він також встановлюється через HACS. Налаштування вимагає локального ключа пристрою та ручного відображення точок даних, тому це більш технічно складно і найкраще підходить для користувачів, які вже впевнено працюють з Home Assistant. Корисним інструментом для зчитування даних пристрою є TinyTuya.

11. Всі посилання в одному місці

Підсумок

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

Екрани Home Assistant і платформи Tuya час від часу змінюються, тому деякі кнопки можуть переміщуватися або перейменовуватися. Загальний порядок кроків залишається незмінним.

Застрягли на одному з кроків? Напишіть нам на електронну пошту hello@amperepoint.com або зателефонуйте за номером +48 666 612 044, з понеділка по п’ятницю, з 10:00 до 17:00. Ми будемо раді допомогти.

Шукаєте зарядний пристрій, готовий до роботи з Home Assistant? Перегляньте наші зарядні пристрої серії Q з лічильниками енергії.