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

Пълна интеграция на Home Assistant за зарядни устройства Ampere Point Q Series — стъпка по стъпка ръководство

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 GHz при сдвояване.
  • Home Assistant 2025.2.0 или по-нов на устройство, което остава включено.
  • Достъп до интернет за HA и станцията: описаната настройка за Q Series използва облака Tuya.
  • HACS или Marketplace и профил в GitHub за разрешаване на добавянето на персонализирано хранилище.
  • Телефон с приложението Tuya и втори екран за показване на QR кода.

2. Инсталиране на Home Assistant, ако още го нямате

Инсталиране на Home Assistant, ако още го нямате

Ако вече използвате Home Assistant, преминете директно към секция 3.

Опция А: специализирано устройство, препоръчително за дългосрочно ползване

На Raspberry Pi, мини компютър или по-стар лаптоп, най-лесният начин е Home Assistant OS. Това е пълна система, която управлява Home Assistant, актуализации и архиви. Официални инструкции за всяка платформа са налични тук: home-assistant.io/installation. След инсталацията таблото обикновено е достъпно в браузър на адрес http://homeassistant.local:8123.

Опция Б: 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 GB и обикновено отнема няколко минути.
  4. Отвори http://localhost:8123 във вашия браузър. Ако не се зареди веднага, изчакайте една или две минути и обновете страницата.

При опцията Docker, рестартирайте Home Assistant в Docker Desktop: Контейнери → 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 над долната част. Там е точният идентификатор на обекта Енергия за зареждане / 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 или токени.

Обратно към блога

Зарядни устройства с измервател на енергия

Виж всички