🔌 TUYA + CERBO GX - Kompletní návod s řešením problémů v2

1Příprava hardware a základních požadavků ✅

Co potřebuješ: Ověření:
  1. Přístup k Cerbo GX přes webové rozhraní
  2. Node-RED na Cerbo GX spuštěný a dostupný
  3. Tuya/SmartLife zařízení funguje v mobilní aplikaci
  4. Počítač připojen ke stejné síti

2Extrakce Local Keys z Tuya zařízení ✅

Metoda A: Homebridge (může selhat)

Instalace:
npm install -g homebridge
npm install -g homebridge-tuya-platform
Konfigurace config.json:
{
  "bridge": {
    "name": "Homebridge",
    "username": "CC:22:3D:E3:CE:30",
    "port": 51826
  },
  "accessories": [],
  "platforms": [
    {
      "platform": "TuyaPlatform",
      "name": "Tuya Platform",
      "options": {
        "username": "TVUJ-EMAIL-DO-SMARTLIFE",
        "password": "TVOJE-HESLO-DO-SMARTLIFE",
        "countryCode": "420",
        "debug": true
      }
    }
  ]
}
⚠️ PROBLÉM: Homebridge může nefungovat s novějšími verzemi pluginu

Metoda B: TinyTuya (doporučeno)

Instalace:
npm install -g @tuyapi/cli
Spuštění:
tuya-cli wizard
⚠️ POŽADUJE: API klíče z Tuya Cloud (viz KROK 3)

3Nastavení Tuya Cloud projektu ✅

  1. Registrace na: https://platform.tuya.com
  2. Vytvoření projektu:
    • Klikni "Create Cloud Project"
    • ⚠️ DŮLEŽITÉ: Vyber "Smart Home" (NE Industry!)
    • Název projektu: např. "Cerbo-GX"
    • ⚠️ KRITICKÉ: Data Center = "Western America" (ověřeno funkční pro ČR!)
  3. Získání API klíčů:
    • Access ID (Client ID): zkopíruj tvůj vlastní
    • Access Secret: zkopíruj tvůj vlastní
    • ⚠️ KRITICKÉ: Data Center MUSÍ být "Western America"!
    • Project Code: automaticky vygenerovaný
  4. Propojení SmartLife účtu:
    • "Link Tuya App Account"
    • Vyber: "Automatic Link (Recommended)"
    • Zadej SmartLife email a heslo
    • Potvrď propojení

🔧 ŘEŠENÍ PROBLÉMŮ

Problem 1: Homebridge TypeError

Chyba: Cannot read properties of undefined (reading 'debug')
Řešení: Oprav config.json - přesuň konfigurace do sekce "options"

Problem 2: Industry vs Smart Home projekt

Problém: Industry projekt nemá správné API pro Smart Home zařízení
Řešení: Vytvoř nový projekt typu "Smart Home"

Problem 3: TinyTuya požaduje API klíče

Řešení: Nejdřív vytvoř Tuya Cloud projekt a získej Access ID/Secret

Problem 4: TinyTuya wizard odmítá Virtual ID

Chyba: "There was an issue fetching that device"
Příčiny a řešení:
  1. ⚠️ NEJČASTĚJŠÍ CHYBA: Špatný datacenter
    • MUSÍ být "Western America" - ověřeno funkční pro ČR!
  2. Čas na propagaci - počkej 10-15 minut po propojení účtu
  3. Region v wizardu - použij "us" ne "eu"

Problem 5: Virtual ID vs Device ID

Řešení: Virtual ID = Device ID jednoho z tvých zařízení
  • Jdi do Tuya Cloud → Devices → All Devices
  • Zkopíruj Device ID libovolného zařízení
  • Tento Device ID použij jako Virtual ID ve wizardu

4Dokončení extrakce Local Keys ✅

TinyTuya wizard zadej:
  1. API Key: tvůj Access ID z Tuya Cloud
  2. API Secret: tvůj Access Secret z Tuya Cloud
  3. Email: tvůj SmartLife email
  4. Password: tvé SmartLife heslo
  5. Region: us (pro Western America datacenter)
  6. Virtual ID: Device ID libovolného tvého zařízení z Tuya Cloud → Devices
⚠️ DŮLEŽITÉ: Virtual ID = Device ID jednoho z tvých zařízení!
Úspěšný výstup - example formát:
[
  { name: 'Název tvého zařízení', id: 'device_id_12345', key: 'local_key_abcd' },
  { name: 'Další zařízení', id: 'device_id_67890', key: 'local_key_efgh' },
  // ... všechna tvá zařízení
]
Skutečný příklad získaných dat (reference):
EXAMPLE: { name: 'Bojler refugio', id: 'ebfd3eaeaa81a0397atskm', key: 'Q50/n[u&lV?>[fWR' }
EXAMPLE: { name: 'test_smart_switch', id: 'ebda6da8e556db04ce8bnv', key: 'ech(@jzmHe~2fhhm' }
... (celkem získáno 20 zařízení)
Zapiš si pro každé zařízení:

5Příprava Node-RED prostředí 🔄

Na Cerbo GX:
  1. Přihlas se do Node-RED (obvykle http://cerbo-gx-ip:1880)
  2. Nainstaluj crypto-wz balíček:
    • Menu (tři čárky) → "Manage palette"
    • "Install" tab
    • Hledej: "crypto-wz"
    • Klikni "Install"
  3. Restart Node-RED služby

6Získání Access Token

7Vytvoření ovládacího flow

💡 TIPS A DOPORUČENÍ

TUYA + CERBO GX Integration Guide v2
Aktualizováno s řešením všech známých problémů