Často kladené otázky

SUPLA je otvorená platforma inteligentnej domácnosti, ktorá zahŕňa kompatibilné zariadenia, mobilné aplikácie, serverový softvér, cloudové služby, webové rozhranie a integračné mechanizmy.

So SUPLA môžete okrem iného ovládať osvetlenie, rolety, brány, bránky, kúrenie a ďalšie zariadenia, ako aj sledovať teplotu, vlhkosť alebo spotrebu energie, vody či plynu. Dostupné funkcie závisia od použitých zariadení a ich konfigurácie.

SUPLA nie je závislá od jednej centrálnej jednotky a nie je jediným produktom. Je to platforma, s ktorou spolupracujú zariadenia rôznych výrobcov a riešenia vytvárané komunitou.

Nie. Môžete si kúpiť hotové zariadenia kompatibilné so SUPLA, nainštalovať aplikáciu a systém nastaviť pomocou sprievodcu.

Vytváranie vlastných zariadení, používanie API a prevádzka vlastného servera sú možnosti pre ľudí, ktorí chcú systém rozšíriť alebo prispôsobiť. Na bežné používanie SUPLA nie sú potrebné.

Používanie oficiálnej aplikácie a cloudu SUPLA je bezplatné. Založenie účtu nevyžaduje žiadny poplatok ani predplatné.

Hradíte však náklady na zariadenia, ich inštaláciu, elektrinu a pripojenie na internet. Vlastný server môže navyše vyžadovať nákup hardvéru, domény, certifikátu alebo hostingových služieb a vlastnú správu.

Podmienky spolupráce s výrobcami zariadení sa dohadujú samostatne a nevyplývajú z bezplatného používania cloudu koncovými používateľmi.

Väčšina zariadení SUPLA nevyžaduje ďalšiu centrálnu jednotku ani bránu. Zariadenia s Wi-Fi alebo Ethernetom sa môžu pripojiť priamo k serveru SUPLA.

Niektoré zariadenia však ďalšiu bránu používajú, napríklad pre použitú rádiovú technológiu alebo integráciu s iným štandardom. Informáciu o tom, či je brána potrebná, vždy overte v opise a návode konkrétneho produktu.

Áno. Jednou zo základných vlastností SUPLA je možnosť ovládať kompatibilné zariadenia rôznych výrobcov v jedinej aplikácii.

Neznamená to však, že je so SUPLA kompatibilné každé zariadenie danej značky. Kompatibilitu je potrebné overiť pri konkrétnom modeli.

Zobraziť kompatibilné zariadenia.

Nie. Samotný použitý protokol, rádiový modul alebo mikrokontrolér neurčuje kompatibilitu so SUPLA.

Zariadenie musí mať zodpovedajúci softvér alebo spolupracovať s bránou či integráciou podporujúcou SUPLA. Pred nákupom overte presný model v katalógu zariadení a v dokumentácii výrobcu.

Oficiálne kompatibilné zariadenia nájdete v katalógu zariadení. Porovnajte presný model s informáciami výrobcu a predajcu.

Na internete môžete nájsť aj zariadenia upravené pre SUPLA a projekty DIY. Môžu s platformou správne fungovať, ale nie sú oficiálnymi produktmi SUPLA a zvyčajne sa v katalógu nenachádzajú. Za opis ich možností, spôsob konfigurácie, použitý softvér a podporu zodpovedá predajca alebo autor projektu.

Pred nákupom takéhoto zariadenia si od predajcu vyžiadajte aspoň tieto informácie:

• aký presný model a softvérový projekt bol použitý;
• ktoré funkcie zariadenia sú v SUPLA dostupné;
• či zariadenie vyžaduje ďalšiu bránu;
• ako prebieha prvá konfigurácia, reset a aktualizácia softvéru;
• či je spojenie so serverom šifrované;
• kto poskytuje návod, technickú pomoc, záruku a budúce aktualizácie.

Samotné logo SUPLA alebo tvrdenie „funguje so SUPLA“ v ponuke neznamená, že je zariadenie oficiálne podporované projektom SUPLA.

Áno. Ide o jeden z dôležitých rozdielov medzi SUPLA a uzavretými systémami inteligentnej domácnosti.

Zariadenia SUPLA nie sú natrvalo viazané na súčasnú oficiálnu infraštruktúru SUPLA. Používajú otvorený protokol a možno ich nakonfigurovať na prácu s iným serverom SUPLA.

Vypnutie oficiálnych serverov nikto neplánuje. Ak by však oficiálna cloudová služba v budúcnosti prestala fungovať, ktokoľvek môže spustiť vlastný server alebo využiť iného poskytovateľa kompatibilnej infraštruktúry SUPLA.

Pri uzavretých systémoch môže ukončenie cloudovej služby výrobcu znamenať stratu niektorých alebo všetkých funkcií zariadenia. Otvorený zdrojový kód SUPLA a možnosť zmeniť server toto riziko znižujú.

Presun existujúcej inštalácie na iný server nemusí byť automatický. Môže vyžadovať opätovnú konfiguráciu zariadení, prenos údajov a vlastnú údržbu infraštruktúry. Niektoré externé služby, napríklad push upozornenia alebo hlasoví asistenti, môžu vyžadovať ďalšiu konfiguráciu alebo na súkromnej inštancii nemusia fungovať rovnako.

Najjednoduchší spôsob, ako začať, má tri kroky:

1. stiahnite si aplikáciu SUPLA pre Android alebo iOS;
2. vytvorte si bezplatný účet;
3. v aplikácii vyberte možnosť pridať zariadenie a postupujte podľa sprievodcu nastavením.

Presný postup uvedenia do prevádzky môže závisieť od výrobcu a modelu zariadenia. Pri zariadeniach pripájaných k elektroinštalácii je najprv potrebné zabezpečiť správnu montáž podľa návodu.

Takmer všetky zariadenia SUPLA pripájajúce sa priamo cez Wi-Fi pracujú iba v pásme 2,4 GHz a vyžadujú sieť kompatibilnú so štandardmi IEEE 802.11 b/g/n. Zvyčajne nepodporujú sieť fungujúcu výhradne v pásme 5 GHz.

K dispozícii sú aj zariadenia s Ethernetom a zariadenia komunikujúce prostredníctvom ďalšej brány. Presné požiadavky vždy overte v návode konkrétneho modelu.

Router môže poskytovať pásma 2,4 a 5 GHz pod rovnakým názvom siete. Oddelenie názvov nie je vždy potrebné, ale môže pomôcť pri diagnostike problémov s konfiguráciou.

Základné fungovanie zariadení nemusí závisieť od internetu. Fyzické tlačidlá, vstupy a logika vykonávaná lokálne v zariadení fungujú nezávisle od spojenia so serverom. Zariadenia môžu lokálne vykonávať aj týždenné programy, napríklad pri termostatoch.

Scény, časové plány, reakcie, upozornenia a ďalšie automatizácie nastavené v SUPLA Cloud sú funkciami servera. Aby sa vykonali, zariadenie musí byť pripojené k príslušnému serveru SUPLA. Pri oficiálnom cloude to znamená aj prístup na internet.

Ovládanie zariadenia v aplikácii prostredníctvom oficiálneho cloudu takisto vyžaduje spojenie telefónu aj zariadenia so serverom. Pri výpadku internetu by lokálne vykonávané funkcie mali fungovať ďalej, so serverovými funkciami však nemožno počítať.

Po výmene routera je najjednoduchšie nastaviť rovnaký názov siete Wi-Fi, heslo a kompatibilný spôsob zabezpečenia ako pri predchádzajúcom zariadení. Vo väčšine prípadov sa zariadenia SUPLA pripoja automaticky a nebude potrebné ich znova konfigurovať.

Ak sa názov siete alebo heslo zmenili, zariadenie musí získať nové sieťové údaje. Ak sa nepripojí automaticky, je potrebné ho znova uviesť do konfiguračného režimu. V závislosti od modelu môže byť potrebné podržať tlačidlo, použiť vyhradené tlačidlo CONFIG alebo vykonať určitú postupnosť krokov. Správny postup nájdete v návode konkrétneho zariadenia.

Odporúčané poradie je nasledujúce:

1. skontrolujte napájanie zariadenia a jeho ovládanie lokálnym tlačidlom;
2. overte požadované pásmo Wi-Fi a typ zabezpečenia;
3. spustite konfiguračný režim podľa návodu výrobcu;
4. zadajte nový názov siete a heslo;
5. v aplikácii skontrolujte, či je zariadenie opäť online.

Ak zariadenie umožňuje zmeniť iba konfiguráciu siete, nezačínajte obnovením výrobných nastavení. Reset môže odstrániť ďalšie nastavenia, kalibráciu alebo priradenie k účtu.

Najprv zistite, či sa problém týka napájania, lokálnej siete, prístupu na internet, servera alebo samotného zariadenia.

Postupne skontrolujte:

• či je zariadenie napájané;
• či ho možno ovládať lokálnym tlačidlom;
• ako sa správa stavová LED a čo podľa návodu zariadenia znamená jej svietenie alebo blikanie;
• či majú ostatné zariadenia v rovnakej sieti prístup na internet;
• či je zariadenie v dosahu Wi-Fi;
• či sa na routeri nezmenil názov siete, heslo, pásmo alebo nastavenie zabezpečenia;
• či sa problém týka jedného zariadenia alebo celej inštalácie.

Ak zariadenie poskytuje lokálny konfiguračný portál, najprv ho prepnite do režimu konfigurácie alebo párovania. Potom pripojte telefón alebo počítač k sieti Wi-Fi vysielanej zariadením a podľa zariadenia otvorte v prehliadači stránku http://192.168.4.1 alebo https://192.168.4.1. Skontrolujte na nej pole Last state. Uložený stav alebo chybová správa môžu ukázať, či sa problém týka pripojenia k Wi-Fi, internetu alebo serveru SUPLA.

Ak zariadenie zostáva offline, postupujte podľa návodu výrobcu. Obnovenie výrobných nastavení by malo byť posledným krokom, nie prvým diagnostickým úkonom.

Závisí to od zariadenia. Batériový snímač alebo zariadenie do zásuvky môže byť určené na samostatné uvedenie do prevádzky.

Zariadenia pripájané k inštalácii 230 V, rozvádzaču, pohonu brány, vykurovaciemu systému alebo iným technickým inštaláciám by mala montovať podľa návodu osoba s kvalifikáciou zodpovedajúcou danému rozsahu prác.

SUPLA je platforma, nie jeden typ hardvéru. Pri konkrétnom produkte vždy skontrolujte napájacie napätie, zaťažiteľnosť výstupov, požadované istenie, schému zapojenia a záručné podmienky.

Najjednoduchšie je zaregistrovať aplikáciu SUPLA na ďalšom telefóne pomocou rovnakej e-mailovej adresy a hesla.

Po registrácii získa aplikácia prístup vyplývajúci z prvého identifikátora prístupu a z umiestnení priradených k tomuto identifikátoru. Nemusí to znamenať prístup ku všetkým umiestneniam a zariadeniam v účte.

Po registrácii telefónu je často potrebné prihlásiť sa do SUPLA Cloud a priradiť aplikácii správny identifikátor prístupu. Môžete tiež vytvoriť samostatný identifikátor a priradiť mu iba vybrané umiestnenia.

Tým určíte, ktoré zariadenia budú na danom telefóne dostupné. Pri zdieľaní zariadení otvárajúcich brány, bránky alebo dvere venujte osobitnú pozornosť rozsahu udeleného prístupu.

Inštalatér by nemal pridávať zariadenia zákazníka do svojho vlastného účtu ani zákazníkovi sprístupniť iba polohu zo svojho účtu. Zariadenia by mali byť od začiatku pridané do účtu patriaceho vlastníkovi inštalácie.

SUPLA v súčasnosti neumožňuje migráciu celej inštalácie medzi účtami. Ak boli zariadenia pridané do účtu inštalatéra, ich neskoršie odovzdanie môže vyžadovať opätovné pridanie každého zariadenia do účtu zákazníka.

Účet SUPLA by mal od začiatku založiť vlastník domu, bytu alebo firmy pomocou svojej e-mailovej adresy. SUPLA v súčasnosti neposkytuje samostatný servisný prístup pre inštalatérov.

Počas konfigurácie môže inštalatér potrebovať prihlasovacie údaje zákazníka. Po dokončení prác by mal vlastník nastaviť nové heslo, ktoré pozná iba on, a skontrolovať zoznam zariadení, umiestnení, identifikátorov prístupu, klientskych aplikácií, tokenov a integrácií.

E-mailová adresa slúži ako prihlasovacie meno k účtu SUPLA a v súčasnosti ju nie je možné zmeniť.

Pri predaji nehnuteľnosti sú dve možnosti:

• odovzdať novému vlastníkovi celý existujúci účet – iba ak sa používa výhradne pre túto nehnuteľnosť a je možné bezpečne odovzdať aj kontrolu nad e-mailovou adresou používanou na prihlásenie;
• vytvoriť pre nového vlastníka nový účet a znova doň pridať všetky zariadenia.

Ak účet používa súkromnú e-mailovú adresu predávajúceho alebo obsahuje iné umiestnenia, zariadenia či údaje, ku ktorým by kupujúci nemal získať prístup, celý účet by sa nemal odovzdávať. V takom prípade je bezpečnejšie vytvoriť nový účet.

Samotné odovzdanie hesla k účtu nestačí, ak predávajúci naďalej kontroluje e-mailovú adresu.

Pred odovzdaním alebo novou konfiguráciou je vhodné exportovať potrebnú históriu meraní a skontrolovať prepojené integrácie, identifikátory prístupu, klientske aplikácie a API tokeny. Po odovzdaní účtu by mal nový vlastník nastaviť nové heslo.

História je dostupná pre kanály, ktoré zaznamenávajú merania, napríklad teplotu, vlhkosť, elektrinu, vodu alebo plyn.

Po prihlásení do SUPLA Cloud otvorte príslušný kanál a jeho históriu. Dostupné údaje možno stiahnuť okrem iného vo formátoch CSV, ODS, XLSX a HTML. Rozsah dostupnej histórie závisí od typu kanála, limitov účtu a konfigurácie servera.

Pred odstránením účtu, resetovaním zariadenia alebo prechodom na iný server exportujte údaje, ktoré môžete potrebovať na analýzu alebo vyúčtovanie.

Áno. Účet SUPLA má funkčné limity, limity uchovávania údajov, limit požiadaviek API a ďalšie obmedzenia, ktoré chránia službu pred chybami a zneužitím.

Aktuálne limity a ich využitie skontrolujete po prihlásení v ponuke SUPLA Cloud → Účet → Zobraziť moje limity.

Nájdete tam okrem iného limity pre:

• vstupné/výstupné zariadenia;
• identifikátory prístupu;
• klientske aplikácie a OAuth;
• umiestnenia;
• skupiny kanálov;
• časové plány;
• scény;
• priame odkazy;
• reakcie;
• zdroje údajov;
• definované a odoslané upozornenia;
• požiadavky API.

Na rovnakej stránke sú uvedené aj pravidlá uchovávania údajov. Niektoré podrobné údaje meraní sa po stanovenom čase pravidelne odstraňujú. Môže ísť napríklad o históriu napätia, prúdu a výkonu z elektromerov. Panel zobrazuje aktuálne obdobia uchovávania platné pre váš účet.

Limity sa vzťahujú aj na veľkosť jednotlivých prvkov konfigurácie. Napríklad:

• skupina kanálov môže obsahovať najviac 30 kanálov;
• časový plán môže obsahovať najviac 20 akcií;
• scéna môže obsahovať najviac 20 operácií.

Limity slúžia predovšetkým na ochranu infraštruktúry pred chybami a zneužitím, nie na obmedzovanie bežného používania SUPLA. Ak je niektorý limit pre vašu inštaláciu alebo integráciu príliš nízky, kontaktujte nás e-mailom. Uveďte, ktorý limit je potrebné zvýšiť, požadovanú hodnotu a stručne opíšte spôsob použitia.

Odstránenie účtu môžete začať v nastaveniach účtu v SUPLA Cloud. Operácia vyžaduje zadanie hesla a potvrdenie e-mailom.

Odstránenie účtu je nevratné a odstráni údaje priradené k účtu vrátane pripojených zariadení, nakonfigurovaných kanálov, priamych odkazov a histórie meraní. Ak si chcete históriu meraní alebo iné údaje ponechať, exportujte ich pred potvrdením odstránenia účtu.

Spojenie aplikácie SUPLA so serverom SUPLA aj spojenia všetkých oficiálnych zariadení SUPLA so serverom sú šifrované. Zabezpečenie celého systému však závisí aj od zariadenia, jeho softvéru, siete Wi-Fi, hesla k účtu, telefónu a spôsobu konfigurácie prístupov a integrácií.

Administratívny prístup k oficiálnej infraštruktúre SUPLA je obmedzený na oprávnené osoby. Infraštruktúra sa udržiava, aktualizuje a monitoruje a údaje sú chránené mechanizmami zálohovania. Zálohy slúžia predovšetkým na obnovenie prevádzky služby po závažnej poruche. Nemožno ich považovať za náhradu exportu používateľských údajov ani za záruku obnovenia jednotlivej odstránenej položky účtu.

Pri súkromnej inštancii SUPLA zodpovedá jej správca za zabezpečenie servera, kontrolu administratívneho prístupu, aktualizácie, certifikáty, zálohy a obnovu údajov.

Neoficiálne zariadenia DIY a úpravy môžu fungovať inak než oficiálne zariadenia. Typické zariadenia SUPLA založené na Arduino Mega a ďalších 8-bitových mikrokontroléroch AVR nepodporujú šifrované spojenie so serverom. V starších projektoch DIY založených na ESP8266 bolo šifrovanie niekedy v predvolenom nastavení vypnuté pre obmedzenú pamäť RAM.

Používatelia by mali:

• používať jedinečné a silné heslo;
• zabezpečiť e-mailový účet používaný na obnovenie prístupu;
• udržiavať aplikáciu a softvér zariadenia aktuálne;
• pravidelne kontrolovať identifikátory prístupu a registrované klientske aplikácie;
• odstraňovať nepoužívané tokeny API a integrácie;
• riadne zabezpečiť vlastný server;
• nezdieľať prístupové údaje s osobami, ktoré nemajú inštaláciu spravovať.

Priamy odkaz treba považovať za prístupový kľúč k priradenej funkcii. Neodporúčame e-mailom posielať priame odkazy, ktoré vykonávajú akciu, napríklad otvárajú bránu. Bezpečnostné systémy elektronickej pošty môžu pri kontrole správ odkazy automaticky otvoriť a neúmyselne spustiť priradenú akciu. Priame odkazy zdieľajte iba s dôveryhodnými osobami a odstráňte ich, keď ich prestanete potrebovať.

Niektoré zariadenia SUPLA poskytujú lokálny konfiguračný portál cez HTTPS, napríklad na adrese https://192.168.4.1. Prehliadač môže zobraziť upozornenie, ak operačný systém alebo prehliadač nedôveruje certifikátu SUPLA Root CA.

Ak chcete týmto upozorneniam predísť, môžete stiahnuť a nainštalovať príslušný certifikát SUPLA Root CA ako dôveryhodnú certifikačnú autoritu.

Tieto certifikáty CA sa používajú aj na overovanie certifikátov, ktoré zariadenia SUPLA využívajú pri šifrovanej komunikácii, okrem iného pri registrácii a prihlasovaní zariadenia k serveru SUPLA.

Certifikáty sú k dispozícii tu:

• supla_org_root_ca.crt

  SHA-256: 31:5D:CD:05:73:E9:02:B8:16:0F:34:01:74:FB:9E:EE:49:1C:B3:97:40:CA:0E:DA:18:BF:29:D0:64:FB:4C:25

• supla_org_private_cloud_root_ca.crt

  SHA-256: FD:6A:E5:DD:6C:08:BB:4D:51:BE:A2:76:6D:28:7F:44:C1:28:14:A6:2C:2B:85:C1:5C:5D:1F:26:21:BF:24:5B

Certifikáty CA inštalujte výhradne z oficiálnej domény SUPLA.

Zodpovednosť závisí od typu problému:

Problém	Prvý kontakt
Poškodenie zariadenia, záruka, návod alebo firmvér produktu	výrobca alebo predajca zariadenia
Montáž, kabeláž alebo konfigurácia vykonaná ako služba	inštalačný technik
Účet alebo fungovanie oficiálneho cloudu SUPLA	podpora SUPLA
Súkromná inštancia SUPLA	správca servera
Vlastný projekt DIY	dokumentácia, GitHub a komunita
Podozrenie na bezpečnostnú zraniteľnosť	súkromný bezpečnostný kanál príslušného projektu alebo výrobcu

SUPLA integruje produkty mnohých spoločností, preto nenahrádzame záručný servis výrobcu zariadenia.

Pri hotovom zariadení začnite návodom a podporou výrobcu alebo predajcu. Problémy s inštaláciou nahláste inštalačnému technikovi a problémy s účtom alebo oficiálnym cloudom podpore SUPLA.

Na fóre SUPLA môžete priamo klásť aj otázky týkajúce sa oficiálnych zariadení — sú pre ne pripravené príslušné tematické sekcie. Otázky k vlastným zariadeniam, integráciám a neobvyklým konfiguráciám môžete zverejniť na fóre alebo v príslušnom repozitári organizácie SUPLA na GitHube.

Pred nahlásením problému si pripravte model zariadenia, verziu firmvéru a aplikácie, opis siete, presné chybové hlásenie a informácie o už vykonaných krokoch.

Áno. SUPLA poskytuje zdrojový kód a súpravu kontajnerov na prevádzku vlastnej inštancie. Odporúčaným základom nasadenia je projekt supla-docker.

Vlastný server poskytuje väčšiu kontrolu nad infraštruktúrou a údajmi, ale vyžaduje správu. Vlastník servera zodpovedá okrem iného za aktualizácie, zálohy, certifikáty TLS, doménu, monitoring, dostupnosť a zabezpečenie.

Nemožno predpokladať úplnú kompatibilitu všetkých služieb s verejným cloudom bez ďalšej konfigurácie. Push upozornenia, hlasoví asistenti a niektoré integrácie môžu vyžadovať vlastné kľúče, certifikáty alebo externé služby.

Aktuálny stav kľúčových služieb a serverov SUPLA môžete skontrolovať na adrese status.supla.org. Zverejňujú sa tam aj informácie o prebiehajúcich a vyriešených incidentoch. Môžete sa tam tiež prihlásiť na odber upozornení o zmenách stavu infraštruktúry.

Áno. SUPLA odporúča MQTT ako hlavný spôsob integrácie s Home Assistant.

SUPLA podporuje dva scenáre MQTT: MQTT pre celý účet poskytované serverom SUPLA a priame lokálne MQTT dostupné v zariadeniach, ktoré ho podporujú.

MQTT pre celý účet umožňuje Home Assistant prijímať stavy zariadení a vykonávať akcie bez samostatnej konfigurácie každého zariadenia. Podporuje aj MQTT Discovery, vďaka ktorému môže Home Assistant automaticky rozpoznať a vytvoriť entity pre väčšinu podporovaných funkcií zariadení.

Vybrané zariadenia SUPLA sa môžu pripojiť priamo k MQTT brokeru v lokálnej sieti.

Môžu existovať aj iné integrácie využívajúce API SUPLA, projekt SUPLA ich však nevyvíja ani nepodporuje.

Áno. SUPLA spolupracuje s Google Home a Amazon Alexa. Dostupné príkazy závisia od typu zariadenia, jeho funkcií a možností daného asistenta.

Po prepojení účtov skontrolujte, ktoré zariadenia a akcie boli sprístupnené. Pri bránach, bránkach a dverách venujte pozornosť spôsobu autorizácie príkazov, ktorý daná platforma asistenta ponúka.

Áno. Aplikácia SUPLA podporuje Android Auto a Apple CarPlay.

Rozhranie vozidla ponúka vybrané funkcie prispôsobené bezpečnému ovládaniu počas jazdy. Nemožno v ňom očakávať prístup ku všetkým kanálom, nastaveniam a funkciám dostupným v plnej mobilnej aplikácii.

Nie. Rozhrania vozidla v súčasnosti umožňujú vykonávať vybrané akcie, ale nezobrazujú, či je brána otvorená alebo zatvorená. V plnej mobilnej aplikácii SUPLA možno stav brány overiť, vyžaduje to však vhodný snímač otvorenia.

Áno. SUPLA Cloud poskytuje REST API a autorizačné mechanizmy na vytváranie integrácií. K dispozícii je aj MQTT, ktoré môžu využívať automatizačné systémy, aplikácie a nástroje, ako je Home Assistant.

Tokenom a integráciám udeľujte iba nevyhnutné oprávnenia. Nepoužívané tokeny odstraňujte a prístupové údaje neukladajte do verejného zdrojového kódu.

Vyberte nástroj zodpovedajúci vášmu cieľu:

Cieľ	Odporúčaná cesta
Firmvér vlastného snímača, relé alebo ovládača	supla-device
Integrácia aplikácie alebo systému	REST API a OAuth
Integrácia riadená udalosťami alebo automatizácia	MQTT
Vlastná kompletná inštancia SUPLA	supla-docker
Vývoj webového panela a cloudovej logiky	supla-cloud

Na učenie a hobby projekty môžete využiť hotové príklady. Komerčný projekt navyše vyžaduje naplánovanie aktualizácií, diagnostiky, bezpečného ukladania údajov, výrobného procesu, súladu s právnymi predpismi a dlhodobej údržby zariadenia.

Nemal by. Hlavný účet má patriť vlastníkovi každej inštalácie.

Používanie jedného účtu inštalačného technika pre viacerých zákazníkov znamená, že zariadenia, konfigurácie, história a oprávnenia rôznych vlastníkov sa spravujú v rámci jedného účtu. To sťažuje oddelenie prístupov, odovzdanie inštalácie, odstránenie údajov a určenie zodpovednosti za systém. Zvyšuje sa aj riziko, že jeden zákazník získa prístup k zariadeniam alebo údajom inej osoby.

SUPLA teraz neposkytuje samostatný servisný prístup pre inštalačných technikov. Počas konfigurácie preto môže inštalačný technik potrebovať prihlasovacie meno a heslo zákazníka. Po dokončení práce by mal zákazník nastaviť nové heslo, ktoré pozná iba on.

Zákazník by mal dostať aspoň:

• prístup k vlastnému účtu a potvrdenie e-mailovej adresy používanej ako prihlasovacie meno a na obnovenie prístupu;
• zoznam nainštalovaných zariadení a ich modelov;
• základný opis umiestnení, kanálov, scén, časových plánov a integrácií;
• návody výrobcov a informácie o záruke;
• informáciu, kto zodpovedá za inštaláciu, zariadenia, firmvér a cloud;
• opis vstupu do konfiguračného režimu a postupu po zmene routera;
• informácie o vytvorených identifikátoroch prístupu, tokenoch API a integráciách.

Keďže SUPLA teraz nemá samostatný servisný prístup, zákazník by mal po prevzatí inštalácie nastaviť nové heslo k účtu, ktoré pozná iba on. Inštalačný technik by si nové heslo vlastníka nemal uchovávať.

Nie. Open-source licencia stanovuje pravidlá používania zdrojového kódu. Automaticky neoprávňuje na využívanie oficiálnej infraštruktúry SUPLA v komerčných zariadeniach, oficiálnej aplikácie, katalógu produktov, podpory, partnerských materiálov ani názvu a značiek SUPLA.

Výrobca, ktorý chce ponúkať zariadenia spolupracujúce s oficiálnymi službami a značkou SUPLA, by s nami mal uzavrieť príslušnú dohodu. Spolupráca môže zahŕňať softvér, testovanie, infraštruktúru, aplikáciu, branding, zverejnenie zariadenia v katalógu, aktualizácie a podporu.

Proces by sa mal začať ešte pred dokončením návrhu hardvéru. Typická spolupráca zahŕňa:

1. stanovenie funkcií produktu a cieľových používateľov;
2. dohodu na hardvérovej architektúre a spôsobe komunikácie;
3. voľbu modelu využívania infraštruktúry a aplikácie;
4. prípravu firmvéru a mechanizmu aktualizácií;
5. funkčné, integračné a bezpečnostné testovanie;
6. prípravu zariadenia na právne požiadavky a posúdenie zhody;
7. dohodu o používaní značky, zverejnení v katalógu, podpore a údržbe produktu.

Včasný kontakt znižuje riziko, že hotový hardvér bude pred integráciou vyžadovať nákladné zmeny.

Zobraziť informácie pre výrobcov.

Výrobca, ktorý uvádza zariadenie na trh, zodpovedá za súlad produktu s právnymi požiadavkami, dokumentáciu, záruku a povinnosti súvisiace so zabezpečením a životným cyklom produktu.

Zodpovednosť za prípravu firmvéru, aktualizácie a údržbu integrácie závisí od dohodnutého modelu spolupráce. Pred začatím predaja musí byť jednoznačne stanovená.

Samotné použitie knižnice alebo zdrojového kódu SUPLA nepotvrdzuje zhodu produktu s technickými a právnymi požiadavkami.

Áno, ak je zariadenie plne kompatibilné s infraštruktúrou SUPLA, prešlo dohodnutým overovacím procesom, má jednoznačne určeného výrobcu alebo iný zodpovedný subjekt, úplnú dokumentáciu a zabezpečenú zodpovedajúcu údržbu a podporu.

Výrobca zodpovedá aj za splnenie právnych požiadaviek platných pre daný produkt a za požadované označenie CE.

Samotné použitie open-source kódu alebo neoficiálneho firmvéru automaticky neznamená zaradenie zariadenia do katalógu.

Áno, v rozsahu povolenom licenciou konkrétneho repozitára. Zdrojový kód jednotlivých komponentov je k dispozícii v organizácii SUPLA na GitHube.

SUPLA používateľom nebráni v používaní vlastných zariadení DIY. Vytvorenie a pridanie vlastného zariadenia do vlastného účtu nevyžaduje náš súhlas. Podporujeme experimentovanie, učenie a tvorivý rozvoj domácej automatizácie — hobby projekty a komunita DIY sú dôležitou súčasťou ekosystému.

Komercializácia riešenia je odlišná. Ak sa zariadenie alebo softvér predáva či ponúka zákazníkom ako produkt alebo služba, jeho tvorca sa stáva výrobcom alebo poskytovateľom riešenia a mal by si preštudovať časť „Otázky výrobcov zariadení“, najmä odpoveď týkajúcu sa používania oficiálneho cloudu, aplikácie a značky SUPLA.

Pred použitím kódu tiež skontrolujte licenciu príslušného projektu a povinnosti, ktoré z nej vyplývajú.

GUI Generic (GG) a ZigBee2Supla sú projekty vytvárané a vyvíjané členmi komunity. Nie sú to oficiálne produkty SUPLA. Nezodpovedáme za ich fungovanie, kompatibilitu, aktualizácie ani technickú podporu.

Otázky, problémy a návrhy týkajúce sa týchto projektov smerujte ich autorom a zverejňujte ich v príslušných sekciách fóra SUPLA. Pred použitím projektu si preštudujte jeho dokumentáciu a overte, ktoré zariadenia a funkcie podporuje.

Podporujeme experimentovanie a tvorivé používanie SUPLA. Komunitné projekty, vlastné konštrukcie a úpravy sú dobrým spôsobom, ako sa učiť elektroniku, programovanie a automatizáciu.

Nemusí byť. Bezpečnosť závisí od návrhu hardvéru, použitého frameworku, spôsobu ukladania hesiel a kľúčov, aktualizácií firmvéru, zabezpečenia konfiguračného režimu a odolnosti voči fyzickému prístupu k zariadeniu.

Hobby projekt môže byť vhodný na učenie alebo nekritické použitie, ale bez ďalšej analýzy by sa nemal považovať za hotový produkt na predaj ani za súčasť inštalácie zodpovednej za bezpečnosť osôb alebo majetku.

Bežné chyby možno nahlásiť v príslušnom repozitári na GitHube po overení, či už podobné hlásenie neexistuje.

Bezpečnostné zraniteľnosti nezverejňujte ihneď ako verejné hlásenia. Použite súkromný postup opísaný v súbore SECURITY.md príslušného repozitára alebo bezpečnostný kanál výrobcu zariadenia.

Hlásenie by malo obsahovať opis problému, verziu komponentu, postup reprodukcie, možné dôsledky a — ak je to bezpečné — návrh riešenia.