Tuya Cloud Bridge: kompletní průvodce pro bateriové Wi-Fi senzory

Bateriové Wi-Fi senzory Tuya (kategorie wsdcg teplota/vlhkost, co2bj CO2, pm25 kvalita vzduchu, ldcg luxmetr) nikdy neotevřou TCP socket na LAN. Spí většinu času a probouzí se jen krátce, aby poslaly měření do Tuya cloudu. Protokol v3.3/v3.4/v3.5 se k nim přes LAN nedostane.

Cloud Bridge je cesta, jak je dostat do GrowVPD Pro: přes Tuya Pulsar message queue. Buď přes váš vlastní Tuya IoT účet (Path A) nebo přes Smart Life rich-login spravovaný naším Witness Workerem (Path B).

1. Proč Cloud Bridge

GrowVPD upřednostňuje lokální komunikaci. Pro síťově napájené Tuya (zásuvky, klima, lampy) funguje LAN protokol okamžitě (Tuya LAN kompletně).

Bateriové senzory ale fungují jinak. Aby vydržely několik měsíců na pár tužkových bateriích, většinu života tráví v hlubokém spánku. Probudí se přibližně každých 15–60 minut, změří hodnotu, pošlou výsledek na Tuya cloud přes krátké cloud spojení, hned usnou.

Cílové zařízení: wsdcg (TH), co2bj (CO2), pm25 (vzduch), ldcg (luxmetr). Pokud má vaše zařízení displej nebo se napájí ze sítě, vyzkoušejte nejdřív LAN.

Cloud Bridge je přemostění: GrowVPD se připojí k Tuya Pulsar (jejich real-time message queue) a poslouchá události. Data dorazí obvykle do 60 s od probuzení senzoru.

2. Tři Tuya cesty v GrowVPD Pro

Cesta	Pro jaká zařízení	Internet	Latence
Lokální LAN	Síťově napájené	Žádný po spárování	< 1 s
Zigbee přes hub	Bateriové Zigbee	Jen pro setup	1–5 s
Cloud Bridge	Bateriové Wi-Fi	Vyžaduje	15–90 s

Pro nové pěstování doporučujeme Zigbee senzory — jsou levnější, rychlejší a nezávislé na cloudu. Wi-Fi bateriové řešte přes Cloud Bridge, když je už vlastníte.

3. Path A vs Path B: kterou zvolit

Path A — vlastní Tuya IoT trial účet

Zaregistrujete si vlastní bezplatný účet na iot.tuya.com, vytvoříte „Cloud Project" a do GrowVPD vložíte vlastní Access ID + Access Secret.

Kvóta: 50 zařízení, 1M API volání/měsíc, 12 měsíců zdarma.
Setup: 15–30 minut poprvé.
Závislost na nás: žádná. Komunikace přímo telefon ↔ Tuya.

Path B — Smart Life rich-login přes Witness (default)

Přihlásíte se Smart Life účtem v GrowVPD. Aplikace stáhne seznam zařízení + local_key. LAN-schopná zařízení fungují plně lokálně. Pro bateriová zařízení Witness Worker drží Pulsar subscription, řeší obnovu tokenů a region routing.

Setup: 2–5 minut.
Závislost na našem backendu: Witness drží Pulsar.
Vhodné pro: nové uživatele, rychlé nastavení.

Proč ne všichni přes naše API? Tuya má tvrdý limit 50 zařízení na cloud projekt. Při 4 zařízeních/uživatele bychom narazili na strop už při ~13 uživatelích. Per-user trial účty škálují lineárně.

4. Path A: nastavení vlastního Tuya IoT účtu

Krok 1

V GrowVPD: Nastavení → Cloud Bridge → Začít

Krok 2

Otevřete iot.tuya.com

Doporučujeme přihlášení na počítači — kopírování řetězců jde snáz.

Krok 3

Registrace trial účtu

Krok 4

Cloud Project

Cloud → Development → Create Cloud Project. Industry = Smart Home. Development Method = Smart Home. Data Center: kritické — podle regionu Smart Life účtu (Evropa = Central Europe).

Krok 5

Povolení API služeb

Service API tab — zapněte IoT Core, Smart Home Devices Management, Smart Home Scenes. U každé Go to Authorize.

Krok 6

Zkopírujte Access ID + Access Secret

Overview záložka. Access ID ~20 znaků. Access Secret schovaný za „Show", ~32 znaků. Vložte do GrowVPD wizardu.

Krok 7

Propojení Smart Life účtu

Devices → Link Tuya App Account → Add App Account. Naskenujte QR ve Smart Life (Profile → QR ikona → Authorize). Všechna vaše zařízení se zviditelní v cloud projektu.

Krok 8

Dokončení v GrowVPD

Wizard otevře Pulsar websocket. Bateriová zařízení uvidíte ve stavu „Cloud bridge"; hodnoty se objeví po probuzení senzoru (až 60 min).

5. Path B: Smart Life rich-login

GrowVPD → Nastavení → Cloud Bridge → Smart Life login.
Vyberte zemi (Česko, Německo, USA…).
Zadejte e-mail a heslo Smart Life účtu.
Aplikace pošle požadavek na Witness, ten ověří proti Tuya a vrátí seznam zařízení + local_key.
LAN-schopná zařízení (zásuvky, klima, lampy) okamžitě v LAN módu.
Bateriová zařízení v Cloud Bridge módu. Witness drží Pulsar a posílá FCM push.

Witness umí region routing automaticky podle countryCode z vašeho Smart Life profilu.

6. Region routing — nejčastější chyba

Tuya má 5 regionů:

Central Europe (Frankfurt) — EU, UK, Skandinávie.
Western America (Oregon) — USA, Kanada, Latam.
Eastern America (Virginia) — primárně B2B.
China — vlastní jurisdikce, oddělené API.
India.

Smart Life automaticky podle země. Tuya IoT projekt si vybíráte ručně — špatná volba = Pulsar handshake tiše selže. Zařízení zobrazí „Connected", ale žádná data nepřijdou. Pro Path B Witness routuje automaticky; manuální override v Nastavení → Cloud Bridge → Pokročilé → Region.

7. Co Cloud Bridge dělá

Periodická měření — každých 15–60 min podle firmwaru senzoru.
FCM push wake — nový údaj → Witness pošle GrowVPD push.
Záložní recovery pro LAN — když LAN zařízení vypadne, zobrazí poslední známou cloud hodnotu.
Trvalá automatizace — AutomationWorker sahá na cloud-side senzory přes Witness.
Multi-tenant sync — více telefonů přes Hub Mode.

8. Omezení a kompromisy

Vyžaduje internet. LAN funguje offline. Cloud ne.
Latence 15–90 s — Pulsar má vlastní frontu, občas se zpozdí.
Bateriová zařízení podle vlastního ladění — typicky 15–60 min. Real-time sekundový monitoring nelze.
50-device cap per cloud projekt (Path A) nebo per sdílený pool (Path B).
Throttling — Tuya občas vrátí 429, exponential backoff řešíme.

9. Bezpečnost přihlašovacích údajů

Lokální úložiště: Access ID/Secret/Smart Life heslo v EncryptedSharedPreferences (AES-256, hardware-backed Keystore).
Logy: Credentials NEjsou v bug reportech (access_id=REDACTED).
Náš server: Witness drží session tokeny, ne heslo. Heslo nikdy neopustí telefon.
Pulsar: TLS 1.2 přímo telefon ↔ Tuya data center.
Revokace: Tuya IoT → Project → Authorize → Remove. Path B v GrowVPD → Odpojit účet.

10. Troubleshooting

„Authorization failed" během wizardu

Region mismatch. Tuya IoT dashboard → projekt → Data Center. Pokud nelze změnit, smažte projekt a vytvořte nový.

„Pulsar připojen, ale žádná zařízení"

Nepřesunuli jste Smart Life účet (krok 7). Nebo zařízení v dashboardu → Authorize.

„Hodnoty zastaralé > 24 h"

Vybíjená baterie. Tuya senzory při nízkém napětí prodlužují interval. Vyměňte baterie.

„Včera fungovalo, dnes ne"

Tuya rotuje session token. Nastavení → Cloud Bridge → Obnovit přihlašovací údaje.

„Pulsar handshake timeout"

Síť. Restartujte Wi-Fi. Některé corporate sítě a Avast Web Shield blokují WebSocket.

11. FAQ

Proč si musím vytvořit vlastní Tuya účet?

Tuya má limit 50 zařízení/projekt. Per-user účty škálují lineárně. Path B vám tento krok ušetří za cenu sdíleného poolu.

Smart Life i Tuya IoT současně?

Ano. Smart Life je „client mode", IoT je „developer mode". Zařízení žijí v obou.

Stojí Cloud Bridge něco?

Nic. Tuya trial 12 měsíců zdarma. Witness máme my.

Je můj Tuya účet v bezpečí?

Ano. Access ID/Secret v Keystore. Komunikace TLS přímo na Tuya. Revokace v Tuya dashboardu.

Co když GrowVPD skončí?

Smart Life funguje dál. Žádný vendor lock-in.

Proč je setup tak dlouhý?

Tuya IoT wizard nebyl navržen pro koncové uživatele. Pokud je 15–30 min moc, použijte Path B.

Více telefonů přes jeden Cloud Bridge?

Ano přes Hub Mode.

Co Čína a Indie?

Path A: Data Center podle země. Path B Witness: EU + US zatím. Pro Čínu/Indii nám napište.

Vrátit se k LAN po koupi Zigbee?

Ano: Cloud Bridge → Odpojit účet. Wi-Fi bateriová do „Offline", historie zůstane. Pak Zigbee hub setup.