Integrace zařízení ovládaných aplikací Smart Life (Tuya) do Home Assistantu (HA) přes HACS a MQTT
Možnost 1: Integrace přes Tuya Cloud (bez MQTT)
Vhodné pro: jednoduché a rychlé napojení, bez nutnosti dalších služeb
Nevýhoda: pomalejší reakce, závislost na internetu
Postup:
- Jdi na https://iot.tuya.com a vytvoř si účet.
- Vytvoř nový Cloud Project:
- Zadej název (např. Home Assistant)
- Vyber region (např. Western Europe)
- V API přístupech zaškrtni:
- Smart Home Management
- Device Management
- Authorization Management
- User Management
- Device Control
- Po vytvoření projektu klikni na „Link Tuya App Account“.
- V aplikaci Smart Life → Profil → Tuya IoT Platform Service → naskenuj QR kód.
- V Home Assistant přejdi do Nastavení → Zařízení a služby → Přidat integraci → vyhledej Tuya.
- Přihlas se svým Tuya účtem a zadej:
- E-mail a heslo
- Access ID a Access Secret (z Tuya Cloud)
- Region: např. eu
- Po dokončení se zařízení ze Smart Life objeví jako entity v Home Assistantu.
Tabulka problémů, příčin a řešení:
| Problém | Možná příčina | Řešení |
|---|---|---|
| Zařízení se v HA nezobrazuje | Nespárovaný účet nebo chybný region | Zkontroluj, zda jsi spároval účet přes QR a zvolil správný region |
| Nelze přidat Tuya integraci | Špatné přihlašovací údaje nebo Access ID/Secret | Ověř údaje v Tuya Cloud projektu a zadej znovu |
| Změny stavu zařízení mají zpoždění | API reaguje pomalu, vše jde přes internet | Přejdi na variantu s MQTT, pokud potřebuješ rychlost |
| Některá zařízení nebo funkce chybí | Omezení oficiální Tuya integrace | Využij LocalTuya nebo tuya-mqtt |
| “Tuya config invalid” v HA logu | Chybná kombinace regionu, API klíčů nebo e-mailu | Ověř, že údaje sedí přesně s tím, co je v projektu Tuya IoT |
Možnost 2: Integrace přes MQTT pomocí tuya-mqtt
Vhodné pro: rychlou odezvu, lokální ovládání bez závislosti na cloudu
Nevýhoda: složitější nastavení
Postup:
- Vytvoř si Tuya Cloud projekt stejně jako v možnosti 1 (potřebuješ Access ID, Secret a napojená zařízení).
- Nainstaluj si MQTT broker:
- V HA: Supervisor → Add-on Store → Mosquitto broker
- Spusť ho a nastav uživatele (např. mqtt_user / mqtt_password)
- Přes HACS přidej integraci tuya-mqtt:
- V HACS → 3 tečky → Vlastní repozitář
- Přidej https://github.com/TradeFace/tuya-mqtt jako Integrace
- Po přidání nainstaluj
Vytvoř konfigurační soubor config.yaml:
tuya:
username: "tvůj@email.cz"
password: "tvéheslo"
access_id: "získané_access_id"
access_secret: "získané_secret"
country_code: "420"
platform: "tuya"
mqtt:
host: "localhost"
port: 1883
user: "mqtt_user"
password: "mqtt_password"
Vytvoř konfigurační soubor config.yaml:
Spusť tuya-mqtt (např. pomocí Dockeru):
docker run -d \
-v /cesta/k/config.yaml:/app/config.yaml \
–network host \
tradeface/tuya-mqtt
V Home Assistantu přidej MQTT zařízení ručně nebo použij MQTT Discovery.
Například zásuvka:
switch:
- platform: mqtt
name: „Zásuvka Tuya“
state_topic: „tuya/xxxxxxxxxx/status“
command_topic: „tuya/xxxxxxxxxx/command“
payload_on: ‚{„state“: „ON“}‘
payload_off: ‚{„state“: „OFF“}‘
value_template: „{{ value_json.state }}“
Tabulka problémů, příčin a řešení:
| Problém | Možná příčina | Řešení |
|---|---|---|
| tuya-mqtt se nespustí | Chybný config.yaml nebo špatné údaje | Zkontroluj formát YAML, mezery, a údaje z Tuya Cloud |
| MQTT zprávy nechodí do HA | MQTT broker neběží nebo není připojen | Ověř běh Mosquitto, restartuj HA nebo tuya-mqtt |
| tuya-mqtt hlásí chybu připojení k MQTT | Nesprávný user/password nebo host v config.yaml | Zkontroluj MQTT údaje a síťové nastavení |
| Ovládání nefunguje | Špatný command_topic nebo formát zpráv | Ověř device ID a payload (např. {„state“: „ON“}) |
| Změna stavu se neukáže v HA | MQTT Discovery není aktivní nebo chybí ruční konfigurace | Aktivuj MQTT Discovery nebo doplň entitu do configuration.yaml |
| MQTT port 1883 je obsazen | Jiná služba používá port nebo běží více brokerů | Změň port nebo ukonči jiný broker |
V případě přetrvávajících problémů se obraťte na:
Fórum podpory Richpear: forum.richpear.cz