Gyakran ismételt kérdések

A SUPLA egy nyílt okosotthon-platform, amely kompatibilis eszközöket, mobilalkalmazásokat, szerverprogramot, felhőszolgáltatásokat, webes felületet és integrációs mechanizmusokat foglal magában.

A SUPLA segítségével többek között világítást, redőnyöket, kapukat, kiskapukat, fűtést és más eszközöket vezérelhet, továbbá figyelheti a hőmérsékletet, a páratartalmat, valamint az energia-, víz- vagy gázfogyasztást. Az elérhető funkciók a használt eszközöktől és azok konfigurációjától függenek.

A SUPLA nem egyetlen központi egységre épül, és nem egyetlen termék. Olyan platform, amelyet különböző gyártók eszközei és a közösség által készített megoldások használnak.

Nem. Vásárolhat kész, SUPLA-kompatibilis eszközöket, telepítheti az alkalmazást, és a beállítási varázslóval konfigurálhatja a rendszert.

A saját eszközök építése, az API használata és a saját szerver futtatása azoknak szól, akik bővíteni vagy testre szabni szeretnék a rendszert. A SUPLA mindennapi használatához ezekre nincs szükség.

A hivatalos SUPLA alkalmazás és felhő ingyenesen használható. A fiók létrehozása nem jár díjjal, és nem igényel előfizetést.

Az eszközök, a telepítés, az elektromos energia és az internet-hozzáférés költsége azonban a felhasználót terheli. Saját szerver esetén hardverre, domainre, tanúsítványra, tárhelyszolgáltatásra és saját adminisztrációra is szükség lehet.

Az eszközgyártókkal való együttműködés feltételeit külön állapítjuk meg; azok nem következnek abból, hogy a végfelhasználók ingyenesen használhatják a felhőt.

A legtöbb SUPLA-eszköz nem igényel további központi egységet vagy átjárót. A Wi-Fi- és Ethernet-eszközök közvetlenül csatlakozhatnak egy SUPLA-szerverhez.

Egyes eszközök azonban használnak kiegészítő átjárót, például a rádiós technológia vagy más szabvánnyal való integráció miatt. Mindig ellenőrizze az adott termék leírásában és használati útmutatójában, hogy szükséges-e átjáró.

Igen. A SUPLA egyik alapvető jellemzője, hogy különböző gyártók kompatibilis eszközei egyetlen alkalmazásból kezelhetők.

Ez nem jelenti azt, hogy egy adott márka minden eszköze SUPLA-kompatibilis. A kompatibilitást mindig a konkrét modellnél kell ellenőrizni.

Kompatibilis eszközök megtekintése.

Nem. Önmagában a használt protokoll, rádiós modul vagy mikrokontroller nem határozza meg a SUPLA-kompatibilitást.

Az eszköznek megfelelő szoftverrel kell rendelkeznie, vagy olyan átjáróval, illetve integrációval kell működnie, amely támogatja a SUPLA-t. Vásárlás előtt ellenőrizze a pontos modellt az eszközkatalógusban és a gyártó dokumentációjában.

A hivatalosan kompatibilis eszközök az eszközkatalógusban találhatók. Hasonlítsa össze a pontos modellt a gyártó és az eladó által megadott információkkal.

Az interneten SUPLA-val való működésre átalakított eszközöket és DIY-projekteket is találhat. Ezek megfelelően működhetnek a platformmal, de nem hivatalos SUPLA-termékek, és általában nem szerepelnek a katalógusban. Képességeik, konfigurációjuk, szoftverük és támogatásuk leírásáért az eladó vagy a projekt szerzője felel.

Ilyen eszköz vásárlása előtt legalább az alábbiakról kérdezze meg az eladót:

• pontosan melyik modellt és szoftverprojektet használja;
• mely eszközfunkciók érhetők el a SUPLA-ban;
• szükséges-e kiegészítő átjáró;
• hogyan működik az első beállítás, a visszaállítás és a szoftverfrissítés;
• titkosított-e a szerverkapcsolat;
• ki biztosítja az útmutatót, a műszaki segítséget, a garanciát és a későbbi frissítéseket.

A SUPLA logó vagy az a kijelentés, hogy egy termék „működik a SUPLA-val”, önmagában nem jelenti azt, hogy az eszköz hivatalos SUPLA-támogatással rendelkezik.

Igen. Ez az egyik fontos különbség a SUPLA és a zárt okosotthon-rendszerek között.

A SUPLA-eszközök nincsenek véglegesen a jelenlegi hivatalos SUPLA-infrastruktúrához kötve. Nyílt protokollt használnak, és másik SUPLA-szerverrel való működésre is beállíthatók.

A hivatalos szerverek leállítása nincs tervben. Ha azonban a hivatalos felhőszolgáltatás a jövőben mégis megszűnne, bárki futtathat saját szervert, vagy igénybe vehet egy másik, kompatibilis SUPLA-infrastruktúrát biztosító szolgáltatót.

Zárt rendszereknél a gyártói felhő megszűnése az eszköz egyes vagy akár összes funkciójának elvesztésével járhat. A SUPLA nyílt forráskódja és a szerverváltás lehetősége csökkenti ezt a kockázatot.

Egy meglévő telepítés áthelyezése másik szerverre nem mindig automatikus. Szükség lehet az eszközök újbóli konfigurálására, az adatok átvitelére és az infrastruktúra saját üzemeltetésére. Egyes külső szolgáltatások, például a push értesítések vagy a hangasszisztensek további beállítást igényelhetnek, illetve nem feltétlenül működnek ugyanúgy egy privát példányon.

A legegyszerűbb kezdés három lépésből áll:

1. töltse le a SUPLA alkalmazást Androidra vagy iOS-re;
2. hozzon létre egy ingyenes fiókot;
3. válassza az alkalmazásban az eszköz hozzáadását, majd kövesse a beállítási varázslót.

A pontos beállítási folyamat gyártónként és eszközmodellenként eltérhet. Az elektromos hálózathoz csatlakozó eszközöket előbb az útmutatónak megfelelően, szakszerűen kell beszerelni.

A közvetlenül Wi-Fi-n csatlakozó SUPLA-eszközök szinte mindegyike kizárólag a 2,4 GHz-es sávban működik, és IEEE 802.11 b/g/n kompatibilis hálózatot igényel. A kizárólag 5 GHz-es hálózatot általában nem támogatják.

Ethernet-eszközök, valamint kiegészítő átjárón keresztül kommunikáló eszközök is elérhetők. Mindig ellenőrizze a konkrét modell útmutatójában szereplő pontos követelményeket.

A router ugyanazon hálózatnév alatt is biztosíthat 2,4 és 5 GHz-es sávot. A nevek szétválasztása nem mindig szükséges, de segíthet a konfigurációs hibák feltárásában.

Az eszköz alapvető működésének nem kell az internettől függenie. A fizikai nyomógombok, bemenetek és az eszközön helyben végrehajtott logika a szerverkapcsolattól függetlenül működnek. Az eszközök helyi heti programokat is végrehajthatnak, például termosztátok esetén.

A SUPLA Cloudban beállított jelenetek, időzítések, reakciók, értesítések és egyéb automatizálások szerveroldali funkciók. Végrehajtásukhoz az eszköznek kapcsolódnia kell a megfelelő SUPLA-szerverhez. A hivatalos felhő esetén ez internet-hozzáférést is jelent.

Az alkalmazásból, a hivatalos felhőn keresztül történő vezérléshez a telefonnak és az eszköznek is el kell érnie a szervert. Internetkimaradás alatt a helyi funkcióknak továbbra is működniük kell, a szerveroldali funkciók viszont várhatóan nem lesznek elérhetők.

Routercsere után a legegyszerűbb megoldás, ha az új routeren a korábbival azonos Wi-Fi-hálózatnevet, jelszót és kompatibilis biztonsági beállításokat ad meg. A SUPLA-eszközök a legtöbb esetben automatikusan újracsatlakoznak, és nem kell őket ismét konfigurálni.

Ha a hálózat neve vagy jelszava megváltozott, az eszközön meg kell adni az új hálózati adatokat. Ha nem csatlakozik újra automatikusan, ismét konfigurációs módba kell helyezni. Modelltől függően ehhez egy gomb nyomva tartása, külön CONFIG gomb használata vagy meghatározott műveletsor végrehajtása szükséges. A helyes eljárást az adott eszköz útmutatójában találja.

Ajánlott sorrend:

1. ellenőrizze az eszköz tápellátását és a helyi nyomógomb működését;
2. ellenőrizze a szükséges Wi-Fi-sávot és biztonsági típust;
3. indítsa el a konfigurációs módot a gyártó útmutatója szerint;
4. adja meg az új hálózatnevet és jelszót;
5. ellenőrizze az alkalmazásban, hogy az eszköz ismét online-e.

Ne gyári visszaállítással kezdje, ha az eszköz lehetővé teszi csak a hálózati konfiguráció módosítását. A visszaállítás további beállításokat, kalibrációt vagy a fiókhoz rendelést is törölheti.

Először állapítsa meg, hogy a probléma a tápellátást, a helyi hálózatot, az internetkapcsolatot, a szervert vagy magát az eszközt érinti-e.

Ellenőrizze sorrendben:

• kap-e tápellátást az eszköz;
• vezérelhető-e a helyi nyomógombbal;
• hogyan viselkedik az állapotjelző LED, és az útmutató szerint mit jelent a jelzése;
• van-e internetkapcsolata az ugyanazon hálózaton lévő más eszközöknek;
• megfelelő-e a Wi-Fi-jelerősség;
• megváltozott-e a router hálózatneve, jelszava, frekvenciasávja vagy biztonsági beállítása;
• egyetlen eszközt vagy a teljes telepítést érinti-e a probléma.

Ha az eszköz helyi konfigurációs portált biztosít, először kapcsolja konfigurációs vagy párosítási módba. Ezután csatlakoztasson egy telefont vagy számítógépet az eszköz által sugárzott Wi-Fi-hálózathoz, majd az eszköztől függően nyissa meg a böngészőben a http://192.168.4.1 vagy a https://192.168.4.1 címet. Ellenőrizze a Last state mezőt. A mentett állapot vagy hibaüzenet jelezheti, hogy a gond a Wi-Fi-, az internet- vagy a SUPLA-szerverkapcsolattal van-e.

Ha az eszköz továbbra is offline marad, kövesse a gyártó útmutatóját. A gyári visszaállítás az utolsó, ne az első diagnosztikai lépés legyen.

Ez az eszköztől függ. Egy elemes érzékelőt vagy konnektorba csatlakoztatható eszközt a felhasználó is telepíthet.

A 230 V-os hálózathoz, elosztótáblához, kapumozgatóhoz, fűtési rendszerhez vagy más műszaki rendszerhez csatlakozó eszközöket az adott munkára jogosult szakembernek kell az útmutató szerint telepítenie.

A SUPLA platform, nem pedig egyetlen hardvertípus. Mindig ellenőrizze az adott termék tápfeszültségét, kimeneti terhelését, szükséges védelmét, bekötési rajzát és garanciális feltételeit.

A legegyszerűbb megoldás, ha egy másik telefonon ugyanazzal az e-mail-címmel és jelszóval regisztrálja a SUPLA alkalmazást.

A regisztráció után az alkalmazás az első hozzáférési azonosító és az ahhoz rendelt helyszínek által biztosított hozzáférést kapja meg. Ez nem feltétlenül jelenti a fiók összes helyszínének és eszközének elérését.

A telefon regisztrálása után gyakran be kell jelentkezni a SUPLA Cloudba, és az alkalmazáshoz a megfelelő hozzáférési azonosítót kell rendelni. Külön hozzáférési azonosító is létrehozható, amelyhez csak kiválasztott helyszínek rendelhetők.

Így meghatározható, mely eszközök legyenek elérhetők az egyes telefonokon. Kapukat, kiskapukat vagy ajtókat nyitó eszközök megosztásakor különösen ügyeljen a megadott hozzáférés körére.

A telepítő ne adja hozzá az ügyfél eszközeit a saját fiókjához, és ne csak egy, a saját fiókjából megosztott helyszínhez adjon hozzáférést az ügyfélnek. Az eszközöket kezdettől a telepítés tulajdonosának fiókjához kell hozzáadni.

A SUPLA jelenleg nem támogatja a teljes telepítés fiókok közötti áthelyezését. Ha az eszközök a telepítő fiókjába kerültek, későbbi átadásukhoz minden eszközt újra hozzá kellhet adni az ügyfél fiókjához.

A SUPLA-fiókot kezdettől a ház, lakás vagy vállalkozás tulajdonosa hozza létre saját e-mail-címével. A SUPLA jelenleg nem biztosít külön szerviz-hozzáférést telepítőknek.

A konfigurálás során a telepítőnek szüksége lehet az ügyfél bejelentkezési adataira. A munka befejezése után a tulajdonos állítson be új, kizárólag általa ismert jelszót, és ellenőrizze az eszközök, helyszínek, hozzáférési azonosítók, kliensalkalmazások, tokenek és integrációk listáját.

Ingatlan eladásakor két lehetőség van:

• a teljes meglévő fiók átadása az új tulajdonosnak — figyelembe véve, hogy a bejelentkezési e-mail-cím jelenleg nem módosítható;
• új fiók létrehozása és minden eszköz újbóli hozzáadása.

A teljes fiók átadása csak akkor megfelelő, ha nem tartalmaz más helyszínt, eszközt vagy adatot, amelyhez az új tulajdonos nem kaphat hozzáférést.

Döntés előtt exportálja a szükséges mérési előzményeket, és ellenőrizze a kapcsolódó integrációkat, hozzáférési azonosítókat és API-tokeneket.

Az előzmények a méréseket rögzítő csatornáknál érhetők el, például hőmérséklet, páratartalom, villamos energia, víz vagy gáz esetén.

A SUPLA Cloudba való bejelentkezés után nyissa meg a megfelelő csatornát és annak előzményeit. Az adatok többek között CSV, ODS, XLSX és HTML formátumban tölthetők le. Az elérhető előzmény a csatorna típusától, a fióklimitektől és a szerver konfigurációjától függ.

Fióktörlés, eszköz-visszaállítás vagy másik szerverre költözés előtt exportálja az elemzéshez vagy elszámoláshoz szükséges adatokat.

Igen. A SUPLA-fiókra funkcionális korlátok, adatmegőrzési limitek, API-kéréskorlátok és más, a szolgáltatást hibáktól és visszaélésektől védő korlátozások vonatkoznak.

Az aktuális limitek és kihasználtságuk bejelentkezés után a SUPLA Cloud → Fiók → Saját limitek megjelenítése menüpontban ellenőrizhetők.

A panel többek között az alábbi limiteket mutatja:

• bemeneti/kimeneti eszközök;
• hozzáférési azonosítók;
• kliens- és OAuth-alkalmazások;
• helyszínek;
• csatornacsoportok;
• időzítések;
• jelenetek;
• közvetlen hivatkozások;
• reakciók;
• adatforrások;
• meghatározott és elküldött értesítések;
• API-kérések.

Ugyanitt láthatók az adatmegőrzési szabályok is. Egyes részletes mérési adatokat meghatározott idő elteltével rendszeresen törlünk. Ez például a villamosenergia-mérők feszültség-, áramerősség- és teljesítményelőzményeit érintheti. A panel a fiókra érvényes aktuális megőrzési időket mutatja.

Az egyes konfigurációs elemek méretére is vonatkoznak korlátok. Például:

• egy csatornacsoport legfeljebb 30 csatornát tartalmazhat;
• egy időzítés legfeljebb 20 műveletet tartalmazhat;
• egy jelenet legfeljebb 20 műveletet tartalmazhat.

A limitek elsősorban az infrastruktúra hibáktól és visszaélésektől való védelmét szolgálják, nem a SUPLA szokásos használatának korlátozását. Ha valamelyik limit túl alacsony az Ön telepítéséhez vagy integrációjához, írjon nekünk e-mailt. Nevezze meg a növelendő limitet, adja meg a kívánt értéket, és röviden ismertesse a felhasználási célt.

A fiók törlése a SUPLA Cloud fiókbeállításaiban indítható el. A művelethez meg kell adnia jelszavát, majd e-mailben meg kell erősítenie a törlést.

A fióktörlés visszafordíthatatlan, és eltávolítja a fiókhoz rendelt adatokat, köztük a csatlakoztatott eszközöket, konfigurált csatornákat, közvetlen hivatkozásokat és mérési előzményeket. Ha meg szeretné őrizni a mérési előzményeket vagy más adatokat, exportálja őket a fióktörlés megerősítése előtt.

A SUPLA alkalmazás és a SUPLA-szerver közötti kapcsolat, valamint minden hivatalos SUPLA-eszköz szerverkapcsolata titkosított. A teljes rendszer biztonsága azonban az eszköztől, annak szoftverétől, a Wi-Fi-hálózattól, a fiók jelszavától, a telefontól, valamint a hozzáférések és integrációk beállításától is függ.

A hivatalos SUPLA-infrastruktúrához való adminisztratív hozzáférés az arra jogosult személyekre korlátozódik. Az infrastruktúrát karbantartjuk, frissítjük és felügyeljük, az adatokról pedig biztonsági mentések készülnek. A mentések elsődleges célja a szolgáltatás helyreállítása súlyos meghibásodás után. Nem helyettesítik a felhasználói adatok exportját, és nem garantálják egyetlen törölt fiókelem visszaállítását.

Privát SUPLA-példány esetén annak rendszergazdája felel a szerver biztonságáért, az adminisztratív hozzáférés szabályozásáért, a frissítésekért, a tanúsítványokért, a biztonsági mentésekért és az adatok helyreállításáért.

A nem hivatalos DIY-eszközök és átalakítások eltérően működhetnek a hivatalos eszközöktől. Az Arduino Mega és más 8 bites AVR mikrokontrollerek tipikus SUPLA-megvalósításai nem támogatják a titkosított szerverkapcsolatot. Régebbi ESP8266-alapú DIY-projektekben a korlátozott RAM miatt a titkosítás néha alapértelmezetten ki volt kapcsolva.

A felhasználó:

• használjon egyedi és erős jelszót;
• védje a hozzáférés helyreállításához használt e-mail-fiókot;
• tartsa naprakészen az alkalmazást és az eszközszoftvert;
• rendszeresen ellenőrizze a hozzáférési azonosítókat és a regisztrált kliensalkalmazásokat;
• törölje a nem használt API-tokeneket és integrációkat;
• megfelelően védje saját szerverét;
• ne ossza meg a hozzáférési adatokat olyanokkal, akiknek nem szabad kezelniük a telepítést.

A közvetlen hivatkozást a hozzárendelt funkció hozzáférési kulcsaként kell kezelni. Nem javasoljuk műveletet végrehajtó, például kaput nyitó közvetlen hivatkozások e-mailben történő elküldését. Az e-mail-biztonsági rendszerek az üzenet ellenőrzése közben automatikusan megnyithatják a hivatkozásokat, és akaratlanul elindíthatják a hozzárendelt műveletet. Közvetlen hivatkozást kizárólag megbízható személyekkel osszon meg, és törölje, ha már nincs rá szükség.

Egyes SUPLA-eszközök HTTPS-en keresztül biztosítanak helyi konfigurációs portált, például a https://192.168.4.1 címen. A böngésző figyelmeztetést jeleníthet meg, ha az operációs rendszer vagy a böngésző nem tekinti megbízhatónak a SUPLA Root CA tanúsítványt.

A figyelmeztetések elkerüléséhez letöltheti és megbízható hitelesítésszolgáltatóként telepítheti a megfelelő SUPLA Root CA tanúsítványt.

Ezeket a CA-tanúsítványokat a SUPLA-eszközök titkosított kommunikációjához használt tanúsítványok ellenőrzésére is használjuk, többek között az eszköz regisztrálásakor és a SUPLA-szerverre való bejelentkezésekor.

A tanúsítványok innen tölthetők le:

• 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

CA-tanúsítványt kizárólag a SUPLA hivatalos domainjéről telepítsen.

A felelősség a probléma típusától függ:

Probléma	Első kapcsolattartó
Eszközhiba, garancia, útmutató vagy termékfirmware	az eszköz gyártója vagy eladója
Szolgáltatásként végzett telepítés, bekötés vagy konfigurálás	a telepítő
Fiók vagy a hivatalos SUPLA-felhő működése	SUPLA-támogatás
Privát SUPLA-példány	a szerver rendszergazdája
Saját DIY-projekt	dokumentáció, GitHub és a közösség
Feltételezett biztonsági sérülékenység	az adott projekt vagy gyártó privát biztonsági csatornája

A SUPLA számos vállalat termékeit integrálja, ezért nem helyettesítjük az eszközgyártó garanciális szervizét.

Kész eszköz esetén kezdje a gyártó vagy az eladó útmutatójával és támogatásával. A telepítési problémákat a telepítőnek, a fiókkal vagy a hivatalos felhővel kapcsolatos problémákat pedig a SUPLA támogatásának jelezze.

A hivatalos eszközökkel kapcsolatban közvetlenül is kérdezhet a SUPLA fórumon, ahol külön témakörök állnak rendelkezésre. Saját eszközökkel, integrációkkal és szokatlan konfigurációkkal kapcsolatos kérdéseit a fórumon vagy a SUPLA GitHub-szervezet megfelelő kódtárában teheti fel.

A probléma bejelentése előtt készítse elő az eszköz modelljét, a firmware és az alkalmazás verzióját, a hálózat leírását, a pontos hibaüzenetet és a már elvégzett lépések listáját.

Igen. A SUPLA forráskódot és konténereket biztosít saját példány futtatásához. A telepítés ajánlott alapja a supla-docker projekt.

A saját szerver nagyobb ellenőrzést biztosít az infrastruktúra és az adatok felett, de adminisztrációt igényel. A szerver tulajdonosa felel a frissítésekért, a biztonsági mentésekért, a TLS-tanúsítványokért, a domainért, a felügyeletért, a rendelkezésre állásért és a biztonságért.

Ne feltételezze, hogy minden szolgáltatás további beállítás nélkül teljesen megegyezik a nyilvános felhővel. A push értesítések, hangasszisztensek és egyes integrációk saját kulcsokat, tanúsítványokat vagy külső szolgáltatásokat igényelhetnek.

Igen. A SUPLA az MQTT-t ajánlja a Home Assistanttal való integráció elsődleges módjaként.

A SUPLA két MQTT-forgatókönyvet támogat: a SUPLA-szerver által a teljes fiókhoz biztosított MQTT-t, valamint a támogatott eszközökön elérhető közvetlen, helyi MQTT-t.

A teljes fiókra kiterjedő MQTT lehetővé teszi, hogy a Home Assistant az egyes eszközök külön konfigurálása nélkül fogadja állapotukat és műveleteket hajtson végre. Az MQTT Discovery támogatásával a Home Assistant automatikusan felismeri és létrehozza a legtöbb támogatott eszközfunkció entitásait.

Egyes SUPLA-eszközök közvetlenül is csatlakozhatnak a helyi hálózaton futó MQTT-brokerhez.

Létezhetnek más, SUPLA API-ra épülő integrációk is, ezeket azonban a SUPLA projekt nem fejleszti és nem támogatja.

Igen. A SUPLA együttműködik a Google Home és az Amazon Alexa szolgáltatással. Az elérhető parancsok az eszköz típusától, funkcióitól és az asszisztens képességeitől függenek.

A fiókok összekapcsolása után ellenőrizze, mely eszközök és műveletek váltak elérhetővé. Kapuk, kiskapuk és ajtók esetén ügyeljen az asszisztensplatform által biztosított parancshitelesítési módra.

Igen. A SUPLA alkalmazás támogatja az Android Auto és az Apple CarPlay használatát.

Az autós felület a vezetés közbeni biztonságos használathoz igazított, kiválasztott funkciókat biztosít. Nem érhető el rajta minden csatorna, beállítás és funkció, amely a teljes mobilalkalmazásban rendelkezésre áll.

Nem. Az autós felületeken jelenleg kiválasztott műveletek hajthatók végre, de nem jelenik meg, hogy a kapu nyitva vagy zárva van-e. A kapu állapota a teljes SUPLA mobilalkalmazásban ellenőrizhető, ehhez azonban megfelelő nyitásérzékelő szükséges.

Igen. A SUPLA Cloud REST API-t és hitelesítési mechanizmusokat biztosít integrációk létrehozásához. Az MQTT automatizálási rendszerekhez, alkalmazásokhoz és például a Home Assistanthoz is elérhető.

A tokeneknek és integrációknak csak a szükséges jogosultságokat adja meg. Törölje a nem használt tokeneket, és ne helyezzen hozzáférési adatokat nyilvános forráskódba.

Válassza ki a céljának megfelelő eszközt:

Cél	Ajánlott út
Saját érzékelő, relé vagy vezérlő firmware-e	supla-device
Alkalmazás- vagy rendszerintegráció	REST API és OAuth
Eseményvezérelt integráció vagy automatizálás	MQTT
Saját teljes SUPLA-példány	supla-docker
A webpanel és a felhőlogika fejlesztése	supla-cloud

A kész példák tanulási és hobbi projektekhez használhatók. Egy kereskedelmi projektnél emellett meg kell tervezni a frissítéseket, a diagnosztikát, a biztonságos adattárolást, a gyártási folyamatot, a jogszabályi megfelelést és az eszköz hosszú távú karbantartását.

Nem ajánlott. Minden telepítés fő fiókjának az adott telepítés tulajdonosához kell tartoznia.

Ha a telepítő több ügyfél eszközeit egyetlen fiókban kezeli, a különböző tulajdonosok eszközei, konfigurációi, előzményei és jogosultságai ugyanabba a fiókba kerülnek. Ez megnehezíti a hozzáférések szétválasztását, a telepítés átadását, az adatok törlését és a rendszerért való felelősség meghatározását. Növeli annak kockázatát is, hogy egy ügyfél más személy eszközeihez vagy adataihoz fér hozzá.

A SUPLA jelenleg nem biztosít külön szerviz-hozzáférést telepítőknek. A konfigurálás során ezért a telepítőnek szüksége lehet az ügyfél bejelentkezési adataira. A munka befejezése után az ügyfél állítson be új, kizárólag általa ismert jelszót.

Az ügyfélnek legalább az alábbiakat kell megkapnia:

• hozzáférést a saját fiókjához, valamint a bejelentkezéshez és hozzáférés-helyreállításhoz használt e-mail-cím megerősítését;
• a telepített eszközök és modellek listáját;
• a helyszínek, csatornák, jelenetek, időzítések és integrációk alapvető leírását;
• a gyártói útmutatókat és garanciális információkat;
• tájékoztatást arról, ki felel a telepítésért, az eszközökért, a firmware-ért és a felhőért;
• útmutatást a konfigurációs módba lépéshez és a router cseréje utáni teendőkhöz;
• információt a létrehozott hozzáférési azonosítókról, API-tokenekről és integrációkról.

Mivel a SUPLA jelenleg nem rendelkezik külön szerviz-hozzáféréssel, a telepítés átvétele után az ügyfél állítson be új, kizárólag általa ismert fiókjelszót. A telepítő ne őrizze meg a tulajdonos új jelszavát.

Nem. A nyílt forráskódú licenc a forráskód használatának szabályait határozza meg. Nem biztosít automatikus jogot a SUPLA hivatalos infrastruktúrájának kereskedelmi eszközökben való használatára, a hivatalos alkalmazásra, a termékkatalógusra, a támogatásra, a partneranyagokra, illetve a SUPLA név és védjegyek használatára.

Annak a gyártónak, aki a hivatalos szolgáltatásokkal és a SUPLA márkával működő eszközöket szeretne kínálni, meg kell állapodnia velünk. Az együttműködés kiterjedhet a szoftverre, a tesztelésre, az infrastruktúrára, az alkalmazásra, a márkamegjelenésre, a katalógusban való közzétételre, a frissítésekre és a támogatásra.

A folyamatot még a hardvertervezés véglegesítése előtt érdemes elkezdeni. A tipikus együttműködés részei:

1. a termékfunkciók és a célfelhasználók meghatározása;
2. a hardverarchitektúra és a kommunikációs mód egyeztetése;
3. az infrastruktúra és az alkalmazás használati modelljének kiválasztása;
4. a firmware és a frissítési mechanizmus elkészítése;
5. funkcionális, integrációs és biztonsági tesztelés;
6. az eszköz felkészítése a jogi követelményekre és a megfelelőségértékelésre;
7. a márkahasználat, a katalógusban való közzététel, a támogatás és a termékkarbantartás egyeztetése.

A korai kapcsolatfelvétel csökkenti annak kockázatát, hogy a kész hardveren költséges változtatásokat kelljen végezni az integráció előtt.

Információk gyártóknak.

Az eszközt forgalomba hozó gyártó felel a termék jogszabályi megfelelőségéért, dokumentációjáért, garanciájáért, valamint a biztonsággal és a termék életciklusával kapcsolatos kötelezettségekért.

A firmware elkészítéséért, a frissítésekért és az integráció karbantartásáért viselt felelősség az egyeztetett együttműködési modelltől függ. Ezt az értékesítés megkezdése előtt egyértelműen meg kell határozni.

Egy SUPLA-könyvtár vagy forráskód használata önmagában nem igazolja, hogy a termék megfelel a műszaki vagy jogi követelményeknek.

Igen, ha az eszköz teljes mértékben kompatibilis a SUPLA-infrastruktúrával, átesett az egyeztetett ellenőrzési folyamaton, egyértelműen azonosítható gyártóval vagy más felelős szervezettel rendelkezik, teljes dokumentáció tartozik hozzá, továbbá biztosított a megfelelő karbantartás és támogatás.

A gyártó felel az adott termékre vonatkozó jogi követelmények teljesítéséért és a szükséges CE-jelölésért is.

A nyílt forráskód vagy nem hivatalos firmware használata önmagában nem jogosítja fel az eszközt a katalógusba való bekerülésre.

Igen, az adott kódtár licencében meghatározott keretek között. Az egyes összetevők forráskódja a SUPLA GitHub-szervezetében érhető el.

A SUPLA nem akadályozza a saját DIY-eszközök használatát. Saját eszköz megépítéséhez és saját fiókhoz adásához nincs szükség a hozzájárulásunkra. Ösztönözzük a kísérletezést, a tanulást és az otthonautomatizálás kreatív fejlesztését — a hobbiprojektek és a DIY-közösség az ökoszisztéma fontos részei.

Egy megoldás kereskedelmi forgalomba hozatala más helyzet. Ha egy eszközt vagy szoftvert termékként vagy szolgáltatásként értékesítenek, alkotója gyártóvá vagy szolgáltatóvá válik, és át kell tekintenie az „Eszközgyártói kérdések” részt, különösen a hivatalos felhő, alkalmazás és SUPLA márka használatáról szóló választ.

A kód használata előtt az adott projekt licencét és az abból eredő kötelezettségeket is ellenőrizze.

A GUI Generic (GG) és a ZigBee2Supla a közösség tagjai által létrehozott és fejlesztett projektek. Nem hivatalos SUPLA-termékek. Működésükért, kompatibilitásukért, frissítéseikért és műszaki támogatásukért nem vállalunk felelősséget.

Az ezekkel a projektekkel kapcsolatos kérdéseket, problémákat és javaslatokat a szerzőiknek kell címezni, illetve a SUPLA fórum megfelelő témaköreiben kell közzétenni. Használat előtt tekintse át a projekt dokumentációját, és ellenőrizze, mely eszközöket és funkciókat támogatja.

Ösztönözzük a kísérletezést és a SUPLA kreatív használatát. A közösségi projektek, saját építésű eszközök és átalakítások kiváló lehetőséget kínálnak az elektronika, a programozás és az automatizálás elsajátítására.

Nem feltétlenül. A biztonság függ a hardver kialakításától, a keretrendszertől, a jelszavak és kulcsok tárolásától, a firmware-frissítésektől, a konfigurációs mód védelmétől és a fizikai hozzáféréssel szembeni ellenállástól.

Egy hobbiprojekt alkalmas lehet tanulásra vagy nem kritikus felhasználásra, de további elemzés nélkül nem tekinthető értékesítésre kész terméknek, illetve olyan telepítés részének, amely személyek vagy vagyontárgyak biztonságáért felel.

A szokásos hibákat a megfelelő GitHub-kódtárban jelentheti be, miután ellenőrizte, hogy nem létezik-e már hasonló bejelentés.

A biztonsági sérülékenységeket ne tegye közzé azonnal nyilvános hibajegyként. Használja az adott kódtár SECURITY.md fájljában leírt privát eljárást vagy az eszközgyártó biztonsági csatornáját.

A bejelentés tartalmazza a probléma leírását, az összetevő verzióját, a reprodukálás lépéseit, a lehetséges hatást és — ha biztonságosan megadható — a javasolt megoldást.