Серія AmperePoint Q у tuya-local: локальне керування з Home Assistant

Офіційний профіль пристрою AmperePoint Q Series прийнято до основного репозиторію tuya-local. Це дає Home Assistant пряме підключення через локальну мережу до підтримуваних зарядних пристроїв, тож рутинні зчитування та команди не потрібно передавати через хмару Tuya.

Доступність: профіль AmperePoint було об’єднано з основним репозиторієм tuya-local, але він не включений у стабільний реліз 2026.7.2. Перед встановленням перевірте HACS на наявність пізнішої версії, у нотатках якої є PR #5595.

Що змінює локальна інтеграція?

Після налаштування Home Assistant спілкується із зарядним пристроєм через вашу локальну мережу. tuya-local розпізнає підтримувані варіанти Q Series за їхніми ідентифікаторами продуктів Tuya та фактичними точками даних, які пристрій надає. Залежно від прошивки зарядного пристрою та доступних точок даних, профіль може забезпечувати:

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

Профіль містить ідентифікатори продуктів з облікового запису виробника Tuya AmperePoint, включно зі старішими продуктами, які ми продовжуємо підтримувати. Це навмисно один профіль AmperePoint Q Series, а не набір профілів на основі комерційних суфіксів моделей. Фактичні точки даних визначають, які додаткові сутності з’являються.

Перед початком

• Home Assistant з встановленим HACS,
• версія tuya-local новіша за 2026.7.2, що включає PR #5595,
• зарядний пристрій AmperePoint Q Series, вже доданий до офіційного додатка Smart Life або Tuya Smart,
• Home Assistant і зарядний пристрій у тій самій локальній мережі або в маршрутизованих мережах, які дозволяють їм спілкуватися,
• доступ до вашого маршрутизатора, якщо автоматичне виявлення IP не знаходить зарядний пристрій.

Рекомендовано: створіть резервування DHCP для зарядного пристрою. Підтримується автоматичне виявлення, але фіксована оренда IP-адреси уникає проблем після перезавантаження маршрутизатора.

Чи потрібен вам обліковий запис розробника Tuya?

Не для рекомендованої конфігурації. Поточний процес налаштування tuya-local може авторизувати доступ за допомогою коду користувача та QR-коду з додатка Smart Life або Tuya Smart. Він отримує Device ID та Local Key і намагається виявити зарядний пристрій у локальній мережі. Документація tuya-local чітко зазначає, що цей метод не вимагає власного облікового запису на платформі Tuya IoT Developer.

Налаштування з підтримкою хмари використовує Tuya лише під час початкового підключення для отримання облікових даних пристрою. Після налаштування рутинні зчитування та команди обмінюються локально. Зарядний пристрій може все ще підтримувати власне з’єднання з Tuya; встановлення tuya-local не блокує доступ до Інтернету автоматично.

1. Встановіть або оновіть tuya-local

1. Відкрийте HACS → Integrations у Home Assistant.
2. Знайдіть Tuya Local від make-all/tuya-local.
3. Якщо його немає у списку, додайте https://github.com/make-all/tuya-local як власний репозиторій HACS у категорії Integration.
4. Встановіть tuya-local або оновіть його до версії, що містить профіль AmperePoint.
5. Перезапустіть Home Assistant. Завантаження файлів інтеграції Python у HACS не активує їх до перезапуску Home Assistant.

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

1. Перейдіть до Settings → Devices & services → Integrations.
2. Виберіть Add integration, знайдіть Tuya Local і почніть налаштування.
3. Виберіть налаштування пристрою SmartLife з підтримкою хмари. Процес отримає Device ID та Local Key і спробує знайти IP-адресу пристрою.
4. У Smart Life або Tuya Smart відкрийте Me → Settings → Account and Security → User Code. Позначки можуть трохи відрізнятися залежно від версії додатку та мови.
5. Введіть користувацький код у tuya-local. Home Assistant відобразить QR-код.
6. Відскануйте QR-код сканером у тому ж обліковому записі Smart Life або Tuya Smart, що містить зарядний пристрій, потім підтвердіть вхід.
7. Поверніться до Home Assistant і виберіть зарядний пристрій зі списку пристроїв вашого облікового запису.
8. Перевірте автоматично заповнені Device ID та Local Key. Якщо IP-адреса не знайдена, введіть адресу, показану у списку DHCP клієнтів вашого роутера.
9. Почніть з версії протоколу, встановленої на auto.
10. Виберіть профіль пристрою EV charger. Успішне співпадіння має показати виробника AmperePoint та модель Q Series.

Якщо ви додаєте кілька зарядних пристроїв з одного облікового запису Tuya, короткочасний токен авторизації зазвичай можна повторно використовувати до перезапуску Home Assistant. Кожен зарядний пристрій все одно отримує власний запис конфігурації та сутності.

Безпека: ніколи не публікуйте свій Device ID, Local Key, користувацький код або QR-код. Повторне сполучення зарядного пристрою в додатку виробника змінює його Local Key, тому запис tuya-local потрібно налаштувати знову.

Розширена альтернатива: платформа розробника Tuya та TinyTuya

Цей маршрут не потрібен для звичайної установки tuya-local. Він може бути корисним для ручного отримання облікових даних, діагностики точок даних або TinyTuya.

1. Створіть обліковий запис на Платформі розробника Tuya і відкрийте Cloud → Development.
2. Створіть хмарний проект, використовуючи метод розробки Smart Home.
3. Виберіть центр обробки даних, який обслуговує регіон, налаштований у вашому обліковому записі Smart Life або Tuya Smart. Невідповідність регіону є поширеною причиною порожнього списку пристроїв.
4. За потреби авторизуйте базові служби Smart Home API, необхідні для майстра проекту.
5. Відкрийте Devices → Link Tuya App Account → Add App Account, відскануйте QR-код за допомогою додатку, що містить зарядний пристрій, і підтвердіть зв’язок.
6. Знайдіть зарядний пристрій у списку пристроїв і збережіть його Device ID.
7. Використовуйте Cloud → API Explorer → Device Management → Query Device Details in Bulk для отримання local_key.
8. Прочитайте IP-адресу з вашого маршрутизатора і введіть хост, Device ID та Local Key у ручному налаштуванні tuya-local. Починайте з протоколу auto.

Безкоштовні права на хмарні проекти Tuya та їх тривалість можуть змінюватися. Якщо API не повертає Local Key, використовуйте рекомендований QR-потік. TinyTuya також може використовувати Access ID проекту, Access Secret, Device ID та правильний регіон для отримання пристроїв і сканування LAN. Всі ці значення слід розглядати як облікові дані.

3. Перевірте сутності та протестуйте з’єднання

Відкрийте сторінку пристрою в Home Assistant. Точний набір сутностей залежить від прошивки зарядного пристрою та точок даних. Додаткові вимірювання створюються лише тоді, коли зарядний пристрій їх фактично надає.

1. Переконайтеся, що пристрій доступний і основні показники оновлюються.
2. Без підключеного автомобіля протестуйте обмеження струму та керування запуском/зупинкою. Відповідна сутність має підтвердити нове значення через кілька секунд.
3. Перезапустіть Home Assistant і переконайтеся, що зарядний пристрій знову підключається без повторного налаштування.
4. Якщо щось не працює, перевірте Налаштування → Система → Журнали і пошукайте tuya_local перед видаленням запису інтеграції.

4. Використовуйте локальні сутності з панеллю керування AmperePoint

tuya-local та TuyaExtend AmperePoint виконують різні функції. tuya-local спілкується з зарядним пристроєм через LAN і створює сутності Home Assistant. Наша інтеграція AmperePoint організовує ці значення у інтерфейс, орієнтований на електромобілі, з панеллю керування, тижневим планувальником, ручним керуванням, попереднім переглядом наступної дії та підтвердженням команд.

Додайте або відредагуйте запис інтеграції AmperePoint і виберіть сутності tuya-local як джерело. Панель керування описана в нашому супровідному посібнику: Панель керування AmperePoint Q Series та планувальник зарядки в Home Assistant.

Вирішення проблем

Профіль AmperePoint відсутній

Перевірте встановлену версію tuya-local. Стабільний реліз 2026.7.2 ще не містить профілю; потрібен пізніший реліз із PR #5595. Профіль, присутній на GitHub main гілка не присутня автоматично у релізі, завантаженому через HACS.

Зарядний пристрій не відображається після авторизації QR

Скануйте QR-код тим самим офіційним обліковим записом Smart Life або Tuya Smart, що володіє зарядним пристроєм. OEM-додаток може не працювати з цим процесом. Для маршруту Developer Platform перевірте регіон додатку, центр обробки даних проєкту та зв’язок облікового запису додатку.

Автоматичне виявлення не може знайти IP-адресу

Введіть адресу зі списку DHCP вашого роутера. Виявлення може бути ускладнене VLAN, гостьовими мережами, ізоляцією Wi-Fi клієнтів, кількома підмережами, відкритим додатком Tuya або іншою локальною інтеграцією, підключеною до зарядного пристрою. Створіть резервування DHCP замість використання змінної адреси.

Зарядний пристрій недоступний

Перевірте маршрутизацію між Home Assistant і зарядним пристроєм, підтвердіть, що IP-адреса не змінилася, і переконайтеся, що інша локальна інтеграція не утримує паралельне з’єднання. Закрийте додаток Tuya, перезавантажте запис інтеграції та перевірте правила брандмауера LAN.

Зчитування працюють, але команди не виконуються

Перевірте Local Key і версію протоколу. Неправильний ключ іноді дозволяє обмежене виявлення, але заважає керуванню. Якщо auto нестабільний, протестуйте версію протоколу, визначену tuya-local, і зверніться до документації проєкту.

Після повторного сполучення зарядний пристрій перестав працювати

Це очікувано: Tuya генерує новий Local Key при повторному сполученні пристрою. Переналаштуйте запис tuya-local із поточним ключем.

Оновлення та підтримка

Профіль AmperePoint є частиною основного проєкту tuya-local, тому майбутні виправлення можуть надходити користувачам через звичайні оновлення HACS. Ми підтримуватимемо сумісність із підтримуваними варіантами серії Q. Якщо зарядний пристрій не розпізнається або відсутня сутність у додатку Tuya, повідомте про це в трекері проблем AmperePoint. Включіть версію tuya-local і прошивку зарядного пристрою, але ніколи не додавайте Device ID, Local Key або дані для входу.

Технічні посилання

• Профіль AmperePoint — tuya-local PR #5595
• Встановлення та налаштування tuya-local
• Ручне отримання Device ID та Local Key
• Документація хмарного проєкту Tuya Smart Home
• Зв’язування облікового запису додатку з проєктом Tuya
• TuyaExtend AmperePoint на GitHub

tuya-local і Home Assistant є проєктами спільноти і не належать AmperePoint. Роботи з електричною установкою повинні виконуватися кваліфікованою особою. Програмне обмеження струму не замінює правильно спроектовану проводку, захист або інструкції з безпеки виробника.