Menu
Nákupní košík
0

BUZERKOSTKA - začínáme

KOSTKA - Chytrá RGB kostka

Popis zařízení

KOSTKA je chytré IoT zařízení založené na mikrokontroléru ESP32, které má integrovanou RGB LED diodu. Zařízení umožňuje ovládat barvu světla pomocí webového rozhraní, HTTP API, MQTT protokolu nebo přes Home Assistant. KOSTKA se připojuje k WiFi síti a může být ovládána lokálně z vaší domácí sítě nebo vzdáleně prostřednictvím MQTT brokeru.

Technická specifikace

  • Mikrokontrolér: ESP32
  • Osvětlení: RGB LED (WS2812)
  • Konektivita: WiFi 2.4 GHz
  • Podporované protokoly: HTTP, MQTT
  • Integrace: Home Assistant (MQTT discovery)
  • Napájení: USB 5V
  • Rozměry: Závisí na konkrétním modelu

První připojení a konfigurace

Uvedení do provozu

  1. Připojte KOSTKU k napájení pomocí USB kabelu
  2. Po zapnutí začne KOSTKA blikat modrou barvou, což indikuje, že je v režimu Access Point
  3. Ve vašem telefonu nebo počítači vyhledejte WiFi síť s názvem BUZERKOSTKA-XXXXXX (kde XXXXXX je unikátní identifikátor odvozený z MAC adresy zařízení)
  4. Připojte se k této WiFi síti
  5. Ve webovém prohlížeči se automaticky otevře konfigurační stránka, nebo ji můžete otevřít ručně zadáním adresy 192.168.4.1

Konfigurace WiFi

  1. Na konfigurační stránce vyberte záložku Základní nastavení
  2. Zadejte název (SSID) a heslo vaší WiFi sítě
  3. Volitelně můžete nastavit heslo zařízení pro zabezpečení přístupu k API
  4. Klikněte na tlačítko Uložit konfiguraci
  5. Zařízení se restartuje a pokusí se připojit k zadané WiFi síti
  6. Úspěšné připojení k WiFi je indikováno trojitým zablikáním zelené barvy

Ověření připojení

  1. Po úspěšném připojení k WiFi zůstává captive portál aktivní po dobu 5 minut
  2. Můžete se připojit zpět k WiFi síti BUZERKOSTKA-XXXXXX a ve webovém rozhraní zkontrolovat přidělenou IP adresu
  3. Alternativně můžete IP adresu zařízení zjistit ve vašem routeru
  4. Otevřete webový prohlížeč a zadejte zjištěnou IP adresu pro přístup ke konfigurační stránce zařízení

Aktualizace firmware

  1. Připojte zařízení k počítači pomocí USB a zajistěte stabilní napájení během celé aktualizace.
  2. Otevřete webový prohlížeč (ideálně Google Chrome) a přejděte na adresu https://pajenicko.cz/webflash/.
  3. Klikněte na tlačítko Připojit / Connect a v zobrazeném dialogu vyberte odpovídající sériový port zařízení. Potvrďte přístup.
  4. Po dokončení procesu se zařízení automaticky restartuje. Neodpojujte kabel ani neobnovujte stránku, dokud se aktualizace nedokončí.
  5. Po restartu můžete zařízení znovu nakonfigurovat nebo ověřit jeho provoz podle potřeby.

Ovládání zařízení

Webové rozhraní

KOSTKA má vestavěné webové rozhraní, které umožňuje:

  • Změnit barvu RGB LED pomocí posuvníků pro každou barevnou složku (R, G, B)
  • Konfigurovat WiFi připojení
  • Nastavit MQTT parametry
  • Konfigurovat propojení s Home Assistant
  • Nastavit HTTP fetch pro automatické načítání barev z URL
  • Nastavit heslo pro zabezpečení API

Pro přístup k webovému rozhraní zadejte IP adresu zařízení do webového prohlížeče.

HTTP API

KOSTKA má HTTP API, které umožňuje ovládat barvu LED pomocí HTTP požadavků.

Lokální API (na zařízení)

  • Nastavení barvy:

    http://[IP-adresa-zarizeni]/set-color?r=[0-255]&g=[0-255]&b=[0-255]

    Příklad: http://192.168.1.100/set-color?r=255&g=0&b=0 (nastaví červenou barvu)

    Pokud je nastaveno heslo zařízení, je třeba jej přidat do požadavku:

    http://[IP-adresa-zarizeni]/set-color?r=[0-255]&g=[0-255]&b=[0-255]&password=[heslo]

  • Získání stavu zařízení:

    http://[IP-adresa-zarizeni]/status

    Vrátí JSON se stavem zařízení, včetně aktuální barvy, připojení k WiFi a MQTT, atd.

Vzdálené API (server buzer.cz)

KOSTKA se automaticky registruje na serveru buzer.cz, který poskytuje následující API endpointy:

  • Nastavení barvy pomocí GET požadavku:

    http://buzer.cz/api/kostka/[device-id]/color?r=[0-255]&g=[0-255]&b=[0-255]

    Kde [device-id] je identifikátor zařízení (MAC adresa bez dvojteček)

    Příklad: http://buzer.cz/api/kostka/A1B2C3D4E5F6/color?r=0&g=255&b=0 (nastaví zelenou barvu)

  • Nastavení barvy pomocí POST požadavku:

    POST http://buzer.cz/api/kostka/[device-id]/color

    S tělem požadavku ve formátu JSON:

    {
  "r": 0,
  "g": 0,
  "b": 255,
  "password": "volitelne-heslo-zarizeni"
}

  • Získání historie příkazů:

    http://buzer.cz/api/kostka/[device-id]/history

Poznámka: Pro použití API na serveru buzer.cz musí být vaše zařízení autorizováno (jeho MAC adresa musí být na whitelist seznamu). Zařízení je při nákupu obvykle předem autorizováno.

MQTT

KOSTKA podporuje MQTT protokol, který umožňuje ovládat zařízení z jiných systémů nebo aplikací.

Konfigurace MQTT

  1. V webovém rozhraní zařízení přejděte na záložku MQTT
  2. Zaškrtněte možnost Povolit MQTT
  3. Zadejte adresu MQTT serveru (výchozí je buzer.cz)
  4. Zadejte port MQTT serveru (výchozí je 1883)
  5. Zadejte MQTT téma (výchozí je "devices/kostka/" + MAC adresa)
  6. Klikněte na tlačítko Uložit konfiguraci

MQTT témata

  • Ovládání barvy:

    Téma: devices/kostka/[device-id]

    Formát zprávy (JSON):

    {
  "r": 255,
  "g": 128,
  "b": 0,
  "password": "volitelne-heslo-zarizeni"
}

  • Registrace zařízení:

    Zařízení odesílá registrační zprávu na téma devices/register/kostka při připojení k MQTT serveru.

Home Assistant

KOSTKA podporuje automatické objevení v Home Assistant pomocí MQTT discovery.

Konfigurace Home Assistant

  1. V webovém rozhraní zařízení přejděte na záložku Home Assistant
  2. Zaškrtněte možnost Povolit Home Assistant
  3. Zadejte adresu Home Assistant MQTT brokeru
  4. Zadejte port MQTT brokeru (výchozí je 1883)
  5. Pokud váš MQTT broker vyžaduje autentizaci, zadejte uživatelské jméno a heslo
  6. V poli Discovery Prefix ponechte výchozí hodnotu "homeassistant"
  7. Klikněte na tlačítko Uložit konfiguraci

Po nakonfigurování se zařízení automaticky přihlásí do Home Assistant jako světlo s podporou RGB. Můžete ho pak ovládat přímo z uživatelského rozhraní Home Assistant nebo ho zahrnout do automatizací.

MQTT témata pro Home Assistant

  • Discovery téma: homeassistant/light/[device-id]/config
  • Stavové téma: homeassistant/light/[device-id]/state
  • Řídicí téma: homeassistant/light/[device-id]/set

Časté dotazy

Jak resetovat zařízení do továrního nastavení?

Otevřete webové rozhraní zařízení a v URL adrese zadejte http://[IP-adresa-zarizeni]/reset-config. Zařízení se restartuje a spustí se v režimu Access Point s výchozí konfigurací.

LED dioda bliká modře, co to znamená?

Modré blikání indikuje, že je zařízení v režimu Access Point a čeká na konfiguraci WiFi připojení.

LED dioda zablikala červeně, co to znamená?

Červené blikání indikuje chybu při připojování k WiFi síti. Zkontrolujte zadané přihlašovací údaje.

Jak mám zjistit MAC adresu zařízení?

MAC adresa je uvedena v názvu WiFi sítě v režimu Access Point (BUZERKOSTKA-XXXXXX) nebo ji můžete zjistit v webovém rozhraní zařízení v sekci "Stavové informace".

Jak nastavit automatické změny barvy?

Můžete využít HTTP fetch funkci, která pravidelně načítá data z URL adresy. Nastavíte ji v záložce "Základní nastavení". URL by měla vracet JSON ve formátu {"r":255,"g":0,"b":0}.

Jak mohu přidat více zařízení KOSTKA do Home Assistant?

Každé zařízení KOSTKA se v Home Assistant objeví automaticky pod jedinečným identifikátorem. Stačí na každém zařízení povolit a nakonfigurovat Home Assistant integraci.

Jak zabezpečit přístup k zařízení?

V záložce "Základní nastavení" můžete nastavit heslo zařízení, které pak bude vyžadováno pro ovládání pomocí API a MQTT.

Zařízení se po několika dnech odpojuje, jak to vyřešit?

Zkontrolujte dosah a kvalitu vašeho WiFi signálu. Zařízení má automatickou detekci odpojení a pokusí se znovu připojit. Pokud problémy přetrvávají, zvažte použití WiFi repeateru nebo umístění zařízení blíže k routeru.