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

Стъпка по стъпка ръководство: от инсталиране на Home Assistant, през HACS и xtend_tuya, до пълни данни за зарядното, таблото за енергия и полезни автоматизации. Написано така, че дори човек, който никога не е използвал Home Assistant, да може да го следва.

Модели: Q11, Q22, Q37, Q74  ·  обновено: юли 2026

Зарядните устройства Ampere Point Q Series са Wi-Fi зарядни, базирани на платформата Tuya. Това означава, че могат да се свържат с Home Assistant, най-популярната безплатна система за умен дом, и да се използват за много повече от основен контрол в мобилно приложение:

• жив мониторинг: мощност, ток и напрежение за всяка фаза, енергия за сесията, обща енергия и статус на зареждането,
• контрол: стартиране и спиране на зареждането, промяна на лимита на тока,
• автоматизации: зареждане само през извънпикови тарифи, от излишна слънчева енергия или според динамичните цени на тока,
• история и статистика за потреблението в таблото за енергия, полезни за отчитане и проследяване на разходите.

Интеграцията работи чрез облака на Tuya, затова и зарядното, и Home Assistant трябва да имат достъп до интернет.

Съдържание

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

1. Какво ви е необходимо

• Зарядно устройство Ampere Point Q Series, добавено в приложението Smart Life за Android или приложението Smart Life за iPhone и работещо правилно там.
• Wi-Fi мрежа на 2.4 GHz. Tuya модулите не се свързват с 5 GHz мрежи. Ако вашият рутер излъчва 2.4 GHz и 5 GHz под едно име на мрежата, струва си временно да отделите 2.4 GHz мрежата по време на сдвояването.
• Компютър или малък сървър за Home Assistant. Той трябва да работи непрекъснато, ако искате автоматизациите да функционират постоянно. Често използвани варианти са Raspberry Pi, мини компютър или обикновен Windows компютър.
• Безплатен GitHub акаунт, необходим веднъж за авторизация в HACS.
• Телефонът ви с приложението Smart Life наблизо, защото ще сканирате QR кодове по време на настройката.
• Около 1 до 2 часа. Повечето стъпки са прости и водени с кликвания.

2. Инсталиране на 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

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 рестартирай homeassistant

След рестартиране добавете интеграцията: Настройки → Устройства и услуги → Добавяне на интеграция, потърсете HACS и приемете условията. Home Assistant ще покаже код, който трябва да въведете на github.com/login/device след влизане в GitHub. Потвърдете с Авторизирай. След малко 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 developer cloud, които ще получим в раздел 6:

1. отметнете Don't ask for OpenAPI credentials,
2. също изберете държава Poland и крайна точка Europe. Формата все още изисква тези полета и без тях може да покаже неясна грешка при валидиране,
3. потвърдете, след което кликнете Finish на следващия екран с имена и зони.

Прозорецът за OpenAPI креденшъли, показан като справка. Отметнете полето, изберете държава и крайна точка, след което потвърдете. Не затваряйте прозореца с бутона X.

След като съветникът приключи, списъкът с интеграции ще покаже Xtend Tuya. Зарядното ви устройство трябва да получи от няколко до повече от двадесет нови обекта, включително сензори за напрежение, ток, мощност, енергия и статус. Ако записът Xtend Tuya липсва, съветникът е бил прекъснат. Повторете раздел 5.2.

6. Пълен набор от данни с ключове за Tuya developer cloud

Този етап е по избор, но препоръчителен. Без него някои обекти може да не са налични или да се обновяват по-бавно. Ще създадем безплатен проект в платформата за разработчици на Tuya и ще добавим ключовете му в xtend_tuya. Документацията на добавката също описва процедурата тук: cloud credentials guide.

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. Намерете ключовете на проекта си в таба Overview в секцията за ключове за упълномощаване: Access ID / Client ID и Access Secret / Client Secret. Използвайте иконата с око, за да разкриете тайната.

Client Secret работи като парола за вашия проект. Не го споделяйте и не го поставяйте на публични места. Ако е необходимо, можете да го нулирате в таба Overview. След нулиране актуализирайте ключа в 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 от таба Overview на проекта Tuya. Потвърдете.
3. Рестартирайте Home Assistant и изчакайте една или две минути. Броят на обектите на зарядното трябва отново да се увеличи. Ако не се случи, използвайте Презареждане от менюто с три точки до интеграцията Xtend Tuya.

7. Какво получавате след интеграцията и таблото за енергия

Точният списък с обекти зависи от модела на зарядното, но обикновено включва:

Измервания	Управление
статус на зареждане, моментна мощност, ток и напрежение за фазите L1 до L3, енергия за текущата сесия, обща енергия и кодове за грешки	стартиране и спиране на зареждането, ограничение на тока за зареждане, например намаляване от 16 A на 10 A, и налични режими на устройството

Струва си да дадете ясни имена на обектите в Настройки → Устройства и услуги → Обекти. Ако един елемент, като превключвател, се появи два пъти, веднъж от Tuya и веднъж от xtend_tuya, това е нормално. Просто можете да деактивирате дублиращия се обект, който не искате да използвате.

Табло за енергия: отидете на Settings → Dashboards → Energy. В секцията Individual devices добавете ентитито за обща енергия на зарядното. След един-два часа Home Assistant трябва да започне да чертае дневни и месечни графики на потреблението. Повече за таблото за енергия: home-assistant.io/docs/energy.

8. Примерни автоматизации

Автоматизациите се създават под Settings → Automations & scenes → Create automation. Примерите по-долу могат да се поставят в YAML режим на редактиране. Заменете ID-тата на ентититата, като sensor.… и switch.…, с вашите собствени ID-та от раздела Entities. Известията за телефон изискват безплатното приложение Home Assistant Companion.

Зареждайте само по време на прозорец с ниска тарифа, от 22:00 до 06:00:

alias: Зареждане по време на ниска тарифа
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: Зареждането приключи
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: Зареждане от излишна слънчева енергия
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... е отметнато, все още трябва да изберете държава и крайна точка. Изберете Полша и Europe, след което потвърдете.
В логовете се показва sign invalid.	Access ID или Secret са поставени с печатна грешка или допълнително пространство, или е избран грешен крайна точка. Копирайте ключовете отново от раздела Overview на проекта. За Полша крайната точка е 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 GHz е активирана и сдвоете зарядното отново в 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 Series става пълна част от вашия умен дом. Можете да виждате всяка сесия на зареждане, да следите разходите в таблото за енергия и да зареждате колата си, когато електричеството е най-евтино или когато вашата соларна инсталация произвежда излишна енергия.

Екраните на Home Assistant и платформата Tuya се променят от време на време, така че някои бутони може да се преместят или преименуват. Общият ред на стъпките остава същият.

Забили сте се на някоя от стъпките? Пишете ни на имейл hello@amperepoint.com или се обадете на +48 666 612 044, от понеделник до петък, 10:00-17:00. Ще се радваме да помогнем.

Търсите зарядно, готово да работи с Home Assistant? Вижте нашите зарядни устройства от серия Q с енергийни метри.