AmperePoint Q Series в tuya-local: локално управление с Home Assistant

Официалният профил на устройството AmperePoint Q Series е приет в основното хранилище tuya-local. Това дава на Home Assistant директна локална мрежова връзка с поддържаните зарядни устройства, така че рутинните четения и команди не трябва да преминават през облака на Tuya.

Наличност: профилът AmperePoint е обединен в основното хранилище на tuya-local, но не е включен в стабилното издание 2026.7.2. Преди инсталиране проверете HACS за по-нова версия, чиито бележки включват PR #5595.

Какво променя локалната интеграция?

След конфигуриране, Home Assistant комуникира с зарядното устройство през вашата LAN мрежа. 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 и зарядното устройство в една и съща LAN мрежа или в маршрутизирани мрежи, които позволяват комуникация между тях,
• достъп до вашия рутер, ако автоматичното откриване на IP не намери зарядното устройство.

Препоръчително: създайте DHCP резервация за зарядното устройство. Поддържа се автоматично откриване, но фиксираната лизингова връзка предотвратява проблеми след рестартиране на рутера.

Нужен ли ви е Tuya Developer акаунт?

Не е за препоръчителната конфигурация. Текущият tuya-local конфигурационен процес може да разреши достъп с потребителски код и QR код от приложението Smart Life или Tuya Smart. Той извлича Device ID и Local Key и се опитва да открие зарядното устройство в LAN мрежата. Документацията на tuya-local изрично посочва, че този метод не изисква собствен акаунт в Tuya IoT Developer Platform.

Настройката с помощта на облака използва 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. Изберете cloud-assisted SmartLife device setup. Процесът ще извлече 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 Developer Platform и отворете 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. Работата по електрическа инсталация трябва да се извършва от подходящо квалифицирано лице. Софтуерното ограничение на тока не замества правилно проектираната инсталация, защитата или инструкциите за безопасност на производителя.