Häufig gestellte Fragen

SUPLA ist eine offene Smart-Home-Plattform, die kompatible Geräte, mobile Apps, Serversoftware, Cloud-Dienste, eine Weboberfläche und Integrationsmechanismen umfasst.

Mit SUPLA können Sie unter anderem Beleuchtung, Rollläden, Tore, Fußgängertore, Heizung und andere Geräte steuern sowie Temperatur, Luftfeuchtigkeit und den Verbrauch von Energie, Wasser oder Gas überwachen. Die verfügbaren Funktionen hängen von den eingesetzten Geräten und deren Konfiguration ab.

SUPLA ist weder von einer einzigen Zentrale abhängig noch ein einzelnes Produkt. Es ist eine Plattform für Geräte verschiedener Hersteller und für Lösungen, die von der Community entwickelt werden.

Nein. Sie können fertige SUPLA-kompatible Geräte kaufen, die App installieren und das System mit dem Einrichtungsassistenten konfigurieren.

Eigene Geräte zu entwickeln, die API zu nutzen oder einen eigenen Server zu betreiben, sind Optionen für Menschen, die das System erweitern oder anpassen möchten. Für die alltägliche Nutzung von SUPLA sind sie nicht erforderlich.

Die Nutzung der offiziellen SUPLA-App und der offiziellen SUPLA Cloud ist kostenlos. Für die Erstellung eines Kontos fallen weder Gebühren noch ein Abonnement an.

Die Kosten für Geräte, Installation, Strom und Internetzugang tragen Sie selbst. Ein eigener Server kann außerdem Hardware, eine Domain, ein Zertifikat, Hosting-Dienste und eigene Administration erfordern.

Die Bedingungen der Zusammenarbeit mit Geräteherstellern werden gesondert vereinbart und ergeben sich nicht aus der kostenlosen Cloud-Nutzung durch Endnutzer.

Die meisten SUPLA-Geräte benötigen keine zusätzliche Zentrale und kein zusätzliches Gateway. WLAN- und Ethernet-Geräte können sich direkt mit einem SUPLA-Server verbinden.

Einige Geräte verwenden dennoch ein zusätzliches Gateway, etwa aufgrund ihrer Funktechnologie oder der Integration eines anderen Standards. Prüfen Sie stets in Produktbeschreibung und Anleitung des konkreten Geräts, ob ein Gateway erforderlich ist.

Ja. Eine der grundlegenden Eigenschaften von SUPLA ist die Möglichkeit, kompatible Geräte verschiedener Hersteller in einer App zu bedienen.

Das bedeutet nicht, dass jedes Gerät einer bestimmten Marke mit SUPLA kompatibel ist. Die Kompatibilität muss für das konkrete Modell geprüft werden.

Kompatible Geräte ansehen.

Nein. Das verwendete Protokoll, Funkmodul oder der Mikrocontroller allein entscheidet nicht über die Kompatibilität mit SUPLA.

Das Gerät muss über geeignete Software verfügen oder mit einem Gateway beziehungsweise einer Integration zusammenarbeiten, die SUPLA unterstützt. Prüfen Sie vor dem Kauf das genaue Modell im Gerätekatalog und in der Dokumentation des Herstellers.

Offiziell kompatible Geräte finden Sie im Gerätekatalog. Vergleichen Sie das genaue Modell mit den Angaben des Herstellers und Verkäufers.

Im Internet finden Sie auch Geräte, die für SUPLA modifiziert wurden, sowie DIY-Projekte. Sie können korrekt mit der Plattform funktionieren, sind aber keine offiziellen SUPLA-Produkte und erscheinen in der Regel nicht im Katalog. Für die Beschreibung ihrer Möglichkeiten, Konfiguration, Software und Unterstützung ist der Verkäufer oder Projektentwickler verantwortlich.

Fragen Sie den Verkäufer vor dem Kauf eines solchen Geräts mindestens:

• welches genaue Modell und Softwareprojekt verwendet werden;
• welche Gerätefunktionen in SUPLA verfügbar sind;
• ob das Gerät ein zusätzliches Gateway benötigt;
• wie Ersteinrichtung, Zurücksetzen und Softwareaktualisierungen funktionieren;
• ob die Verbindung zum Server verschlüsselt ist;
• wer Anleitung, technische Unterstützung, Garantie und künftige Aktualisierungen bereitstellt.

Das SUPLA-Logo oder die Angabe „funktioniert mit SUPLA“ in einem Angebot bedeutet nicht, dass das Gerät offiziell von SUPLA unterstützt wird.

Ja. Das ist einer der wichtigen Unterschiede zwischen SUPLA und geschlossenen Smart-Home-Systemen.

SUPLA-Geräte sind nicht dauerhaft an die derzeitige offizielle SUPLA-Infrastruktur gebunden. Sie verwenden ein offenes Protokoll und können für den Betrieb mit einem anderen SUPLA-Server konfiguriert werden.

Es gibt keine Pläne, die offiziellen Server abzuschalten. Sollte der offizielle Cloud-Dienst künftig dennoch eingestellt werden, kann jeder einen eigenen Server betreiben oder einen anderen Anbieter mit kompatibler SUPLA-Infrastruktur nutzen.

Bei geschlossenen Systemen kann die Einstellung des Cloud-Dienstes eines Herstellers zum Verlust einzelner oder aller Gerätefunktionen führen. Die Open-Source-Software von SUPLA und die Möglichkeit, den Server zu wechseln, verringern dieses Risiko.

Die Übertragung einer bestehenden Installation auf einen anderen Server erfolgt nicht immer automatisch. Sie kann die erneute Konfiguration von Geräten, die Übertragung von Daten und den eigenständigen Betrieb der Infrastruktur erfordern. Manche externen Dienste wie Push-Benachrichtigungen oder Sprachassistenten können zusätzliche Konfiguration benötigen oder auf einer privaten Instanz anders funktionieren.

Der einfachste Einstieg umfasst drei Schritte:

1. Laden Sie die SUPLA-App für Android oder iOS herunter;
2. erstellen Sie ein kostenloses Konto;
3. wählen Sie in der App die Option zum Hinzufügen eines Geräts und folgen Sie dem Einrichtungsassistenten.

Der genaue Einrichtungsprozess kann vom Hersteller und Gerätemodell abhängen. Bei Geräten, die an eine Elektroinstallation angeschlossen werden, muss zuerst die korrekte Installation gemäß Anleitung sichergestellt werden.

Fast alle SUPLA-Geräte, die sich direkt über WLAN verbinden, arbeiten ausschließlich im 2,4-GHz-Band und benötigen ein mit IEEE 802.11 b/g/n kompatibles Netz. Ein ausschließlich im 5-GHz-Band betriebenes Netz wird in der Regel nicht unterstützt.

Es gibt außerdem Ethernet-Geräte und Geräte, die über ein zusätzliches Gateway kommunizieren. Prüfen Sie die genauen Anforderungen immer in der Anleitung des jeweiligen Modells.

Ein Router kann das 2,4- und 5-GHz-Band unter demselben Netzwerknamen bereitstellen. Getrennte Namen sind nicht immer erforderlich, können aber bei der Diagnose von Konfigurationsproblemen helfen.

Der grundlegende Gerätebetrieb muss nicht vom Internet abhängen. Physische Taster, Eingänge und lokal im Gerät ausgeführte Logik funktionieren unabhängig von einer Serververbindung. Geräte können außerdem lokale Wochenprogramme ausführen, beispielsweise Thermostate.

Szenen, Zeitpläne, Reaktionen, Benachrichtigungen und andere in SUPLA Cloud konfigurierte Automatisierungen sind Serverfunktionen. Für ihre Ausführung muss das Gerät mit dem zuständigen SUPLA-Server verbunden sein. Bei der offiziellen Cloud bedeutet das auch Internetzugang.

Die Steuerung eines Geräts über die offizielle Cloud in der App erfordert ebenfalls, dass Smartphone und Gerät mit dem Server verbunden sind. Bei einem Internetausfall sollten lokal ausgeführte Funktionen weiterarbeiten; Serverfunktionen stehen dagegen nicht zur Verfügung.

Nach dem Austausch eines Routers ist es am einfachsten, denselben WLAN-Namen, dasselbe Passwort und kompatible Sicherheitseinstellungen wie beim vorherigen Router zu verwenden. In den meisten Fällen verbinden sich SUPLA-Geräte dann automatisch wieder und müssen nicht neu konfiguriert werden.

Wenn Netzwerkname oder Passwort geändert wurden, muss das Gerät die neuen Zugangsdaten erhalten. Verbindet es sich nicht automatisch, muss es erneut in den Konfigurationsmodus versetzt werden. Je nach Modell kann dafür eine Taste gehalten, eine eigene CONFIG-Taste verwendet oder eine bestimmte Abfolge von Schritten ausgeführt werden. Die richtige Vorgehensweise finden Sie in der Anleitung des jeweiligen Geräts.

Empfohlene Reihenfolge:

1. Prüfen Sie Stromversorgung und Bedienung über den lokalen Taster;
2. prüfen Sie das erforderliche WLAN-Band und den Sicherheitstyp;
3. starten Sie den Konfigurationsmodus gemäß Herstelleranleitung;
4. geben Sie den neuen Netzwerknamen und das Passwort ein;
5. prüfen Sie in der App, ob das Gerät wieder online ist.

Beginnen Sie nicht mit einem Zurücksetzen auf Werkseinstellungen, wenn sich am Gerät lediglich die Netzwerkkonfiguration ändern lässt. Ein Reset kann zusätzliche Einstellungen, Kalibrierung oder die Kontozuordnung löschen.

Stellen Sie zunächst fest, ob das Problem die Stromversorgung, das lokale Netzwerk, den Internetzugang, den Server oder das Gerät selbst betrifft.

Prüfen Sie der Reihe nach:

• ob das Gerät mit Strom versorgt wird;
• ob es sich über den lokalen Taster bedienen lässt;
• wie sich die Status-LED verhält und was ihr Leucht- oder Blinkmuster laut Geräteanleitung bedeutet;
• ob andere Geräte im selben Netzwerk Internetzugang haben;
• ob sich das Gerät in WLAN-Reichweite befindet;
• ob Netzwerkname, Passwort, Band oder Sicherheitseinstellungen am Router geändert wurden;
• ob das Problem ein einzelnes Gerät oder die gesamte Installation betrifft.

Wenn das Gerät ein lokales Konfigurationsportal bereitstellt, versetzen Sie es zunächst in den Konfigurations- oder Kopplungsmodus. Verbinden Sie anschließend ein Smartphone oder einen Computer mit dem vom Gerät ausgestrahlten WLAN und öffnen Sie je nach Gerät http://192.168.4.1 oder https://192.168.4.1 im Browser. Prüfen Sie dort das Feld Last state. Der gespeicherte Zustand oder eine Fehlermeldung kann zeigen, ob das Problem die WLAN-, Internet- oder SUPLA-Serververbindung betrifft.

Bleibt das Gerät offline, folgen Sie der Anleitung des Herstellers. Ein Zurücksetzen auf Werkseinstellungen sollte der letzte Schritt sein, nicht die erste Diagnosemaßnahme.

Das hängt vom Gerät ab. Ein batteriebetriebener Sensor oder ein Steckgerät kann für die Selbstinstallation vorgesehen sein.

Geräte, die an eine 230-V-Installation, einen Verteilerkasten, Torantrieb, eine Heizungsanlage oder andere technische Systeme angeschlossen werden, sollten gemäß Anleitung von einer Person mit den für die jeweiligen Arbeiten erforderlichen Qualifikationen installiert werden.

SUPLA ist eine Plattform und kein einzelner Hardwaretyp. Prüfen Sie bei jedem Produkt Versorgungsspannung, Ausgangsbelastbarkeit, erforderliche Schutzmaßnahmen, Anschlussplan und Garantiebedingungen.

Am einfachsten registrieren Sie die SUPLA-App auf einem weiteren Smartphone mit derselben E-Mail-Adresse und demselben Passwort.

Nach der Registrierung erhält die App die über den ersten Zugriffsidentifikator gewährten Zugriffsrechte für die diesem Identifikator zugewiesenen Standorte. Das bedeutet nicht zwingend Zugriff auf alle Standorte und Geräte des Kontos.

Nach der Registrierung des Smartphones müssen Sie sich häufig bei SUPLA Cloud anmelden und der App den passenden Zugriffsidentifikator zuweisen. Sie können auch einen separaten Identifikator erstellen und ihm nur ausgewählte Standorte zuordnen.

So bestimmen Sie, welche Geräte auf dem jeweiligen Smartphone verfügbar sind. Achten Sie beim Teilen von Geräten, die Tore, Fußgängertore oder Türen öffnen, besonders auf den Umfang des gewährten Zugriffs.

Der Installateur sollte die Geräte des Kunden weder seinem eigenen Konto hinzufügen noch dem Kunden lediglich einen Standort aus seinem Konto freigeben. Die Geräte sollten von Anfang an dem Konto des Eigentümers der Installation hinzugefügt werden.

SUPLA unterstützt derzeit keine Migration einer gesamten Installation zwischen Konten. Wurden die Geräte dem Konto des Installateurs hinzugefügt, kann die spätere Übergabe erfordern, jedes Gerät erneut dem Konto des Kunden hinzuzufügen.

Das SUPLA-Konto sollte von Anfang an vom Eigentümer des Hauses, der Wohnung oder des Unternehmens mit seiner E-Mail-Adresse eingerichtet werden. SUPLA bietet derzeit keinen separaten Servicezugang für Installateure.

Während der Konfiguration benötigt der Installateur möglicherweise die Anmeldedaten des Kunden. Nach Abschluss der Arbeiten sollte der Eigentümer ein neues, nur ihm bekanntes Passwort festlegen und die Liste der Geräte, Standorte, Zugriffskennungen, Client-Anwendungen, Tokens und Integrationen prüfen.

Die E-Mail-Adresse ist die Anmeldekennung des SUPLA-Kontos und kann derzeit nicht geändert werden.

Beim Verkauf einer Immobilie gibt es zwei Möglichkeiten:

• das gesamte bestehende Konto an den neuen Eigentümer übergeben – jedoch nur, wenn es ausschließlich für diese Immobilie verwendet wird und auch die Kontrolle über die zum Anmelden verwendete E-Mail-Adresse sicher übertragen werden kann;
• für den neuen Eigentümer ein neues Konto erstellen und alle Geräte erneut hinzufügen.

Wenn das Konto die private E-Mail-Adresse des Verkäufers verwendet oder andere Standorte, Geräte oder Daten enthält, auf die der Käufer keinen Zugriff erhalten sollte, sollte das gesamte Konto nicht übertragen werden. In diesem Fall ist ein neues Konto die sicherere Lösung.

Die bloße Übergabe des Kontopassworts reicht nicht aus, wenn der Verkäufer weiterhin die Kontrolle über die E-Mail-Adresse hat.

Vor der Übergabe oder Neukonfiguration sollten benötigte Messverläufe exportiert und verknüpfte Integrationen, Zugriffskennungen, Client-Anwendungen und API-Tokens überprüft werden. Nach der Kontoübergabe sollte der neue Eigentümer ein neues Passwort festlegen.

Ein Verlauf ist für Kanäle verfügbar, die Messwerte aufzeichnen, etwa Temperatur, Luftfeuchtigkeit, Strom, Wasser oder Gas.

Melden Sie sich bei SUPLA Cloud an und öffnen Sie den betreffenden Kanal und dessen Verlauf. Die verfügbaren Daten können unter anderem in den Formaten CSV, ODS, XLSX und HTML heruntergeladen werden. Der verfügbare Verlauf hängt vom Kanaltyp, den Kontolimits und der Serverkonfiguration ab.

Exportieren Sie vor dem Löschen eines Kontos, dem Zurücksetzen eines Geräts oder dem Wechsel auf einen anderen Server alle Daten, die für Analysen oder Abrechnungen benötigt werden könnten.

Ja. Ein SUPLA-Konto unterliegt Funktionslimits, Aufbewahrungsfristen für Daten, API-Anfragelimits und weiteren Einschränkungen, die den Dienst vor Fehlern und Missbrauch schützen.

Aktuelle Limits und deren Nutzung finden Sie nach der Anmeldung unter SUPLA Cloud → Konto → Meine Limits anzeigen.

Dort werden unter anderem Limits für Folgendes angezeigt:

• Ein-/Ausgabegeräte;
• Zugriffsidentifikatoren;
• Client- und OAuth-Anwendungen;
• Standorte;
• Kanalgruppen;
• Zeitpläne;
• Szenen;
• Direktlinks;
• Reaktionen;
• Datenquellen;
• definierte und gesendete Benachrichtigungen;
• API-Anfragen.

Auf derselben Seite werden auch die Regeln zur Datenaufbewahrung angezeigt. Manche detaillierten Messdaten werden nach einem festgelegten Zeitraum regelmäßig gelöscht. Dazu können beispielsweise Spannungs-, Strom- und Leistungsverläufe von Stromzählern gehören. Das Panel zeigt die aktuell für Ihr Konto geltenden Aufbewahrungsfristen.

Limits gelten außerdem für die Größe einzelner Konfigurationselemente. Beispielsweise:

• kann eine Kanalgruppe höchstens 30 Kanäle enthalten;
• kann ein Zeitplan höchstens 20 Aktionen enthalten;
• kann eine Szene höchstens 20 Operationen enthalten.

Die Limits dienen in erster Linie dem Schutz der Infrastruktur vor Fehlern und Missbrauch und nicht der Einschränkung der normalen SUPLA-Nutzung. Ist ein Limit für Ihre Installation oder Integration zu niedrig, kontaktieren Sie uns per E-Mail. Geben Sie an, welches Limit erhöht werden soll, welchen Wert Sie benötigen und wofür es verwendet wird.

Sie können die Kontolöschung in den Kontoeinstellungen von SUPLA Cloud beginnen. Dafür sind Ihr Passwort und eine Bestätigung per E-Mail erforderlich.

Die Kontolöschung ist endgültig und entfernt die dem Konto zugeordneten Daten, darunter verbundene Geräte, konfigurierte Kanäle, Direktlinks und Messverläufe. Möchten Sie Messverläufe oder andere Daten behalten, exportieren Sie diese vor der Bestätigung der Kontolöschung.

Die Verbindungen zwischen der SUPLA-App und dem SUPLA-Server sowie die Verbindungen aller offiziellen SUPLA-Geräte zum Server sind verschlüsselt. Die Sicherheit des gesamten Systems hängt jedoch auch vom Gerät, seiner Software, dem WLAN, dem Kontopasswort, dem Smartphone und der Konfiguration von Zugriffen und Integrationen ab.

Der administrative Zugriff auf die offizielle SUPLA-Infrastruktur ist auf autorisierte Personen beschränkt. Die Infrastruktur wird gewartet, aktualisiert und überwacht; die Daten sind durch Sicherungsmechanismen geschützt. Backups dienen in erster Linie dazu, den Dienst nach einem schwerwiegenden Ausfall wiederherzustellen. Sie sind weder ein Ersatz für den Export von Nutzerdaten noch eine Garantie dafür, dass ein einzelnes gelöschtes Kontoelement wiederhergestellt werden kann.

Bei einer privaten SUPLA-Instanz ist deren Administrator für Serversicherheit, Kontrolle des administrativen Zugriffs, Aktualisierungen, Zertifikate, Backups und Datenwiederherstellung verantwortlich.

Inoffizielle DIY-Geräte und Modifikationen können sich anders verhalten als offizielle Geräte. Typische SUPLA-Geräte auf Basis von Arduino Mega und anderen 8-Bit-AVR-Mikrocontrollern unterstützen keine verschlüsselte Serververbindung. In älteren ESP8266-basierten DIY-Projekten war die Verschlüsselung wegen des begrenzten Arbeitsspeichers teilweise standardmäßig deaktiviert.

Nutzer sollten:

• ein einzigartiges und starkes Passwort verwenden;
• das zur Wiederherstellung des Zugriffs verwendete E-Mail-Konto absichern;
• App und Gerätesoftware aktuell halten;
• Zugriffsidentifikatoren und registrierte Client-Anwendungen regelmäßig prüfen;
• ungenutzte API-Token und Integrationen entfernen;
• einen eigenen Server angemessen absichern;
• Zugangsdaten nicht an Personen weitergeben, die die Installation nicht verwalten sollen.

Ein Direktlink ist wie ein Zugriffsschlüssel zur zugewiesenen Funktion zu behandeln. Wir empfehlen nicht, Direktlinks, die eine Aktion ausführen – beispielsweise ein Tor öffnen –, per E-Mail zu versenden. Sicherheitssysteme von E-Mail-Diensten können Links beim Prüfen einer Nachricht automatisch öffnen und die zugewiesene Aktion unbeabsichtigt auslösen. Teilen Sie Direktlinks nur mit vertrauenswürdigen Personen und entfernen Sie sie, sobald sie nicht mehr benötigt werden.

Einige SUPLA-Geräte stellen ein lokales Konfigurationsportal über HTTPS bereit, beispielsweise unter https://192.168.4.1. Ihr Browser kann eine Warnung anzeigen, wenn das Zertifikat der SUPLA Root CA vom Betriebssystem oder Browser nicht als vertrauenswürdig eingestuft wird.

Um solche Warnungen zu vermeiden, können Sie das passende Zertifikat der SUPLA Root CA herunterladen und als vertrauenswürdige Zertifizierungsstelle installieren.

Diese CA-Zertifikate werden außerdem verwendet, um Zertifikate zu prüfen, die SUPLA-Geräte für verschlüsselte Kommunikation einsetzen, unter anderem bei der Registrierung und Anmeldung eines Geräts an einem SUPLA-Server.

Die Zertifikate stehen hier zur Verfügung:

• 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

Installieren Sie CA-Zertifikate ausschließlich von der offiziellen SUPLA-Domain.

Die Zuständigkeit hängt von der Art des Problems ab:

Problem	Erster Ansprechpartner
Geräteschaden, Garantie, Anleitung oder Produkt-Firmware	Gerätehersteller oder Verkäufer
Als Dienstleistung ausgeführte Installation, Verkabelung oder Konfiguration	Installateur
Konto oder Betrieb der offiziellen SUPLA Cloud	SUPLA-Support
Private SUPLA-Instanz	Serveradministrator
Eigenes DIY-Projekt	Dokumentation, GitHub und Community
Verdacht auf eine Sicherheitslücke	privater Sicherheitskanal des betreffenden Projekts oder Herstellers

SUPLA integriert Produkte vieler Unternehmen; deshalb ersetzen wir nicht den Garantieservice des Geräteherstellers.

Beginnen Sie bei einem fertigen Gerät mit der Anleitung und dem Support des Herstellers oder Verkäufers. Melden Sie Installationsprobleme dem Installateur und Probleme mit Konto oder offizieller Cloud dem SUPLA-Support.

Im SUPLA-Forum können Sie auch direkt Fragen zu offiziellen Geräten stellen; dafür gibt es eigene Themenbereiche. Fragen zu eigenen Geräten, Integrationen und ungewöhnlichen Konfigurationen können im Forum oder im passenden Repository der SUPLA-Organisation auf GitHub gestellt werden.

Halten Sie vor einer Meldung Gerätemodell, Firmware- und App-Version, Netzwerkbeschreibung, genaue Fehlermeldung und bereits ausgeführte Schritte bereit.

Ja. SUPLA stellt Quellcode und eine Reihe von Containern für den Betrieb einer eigenen Instanz bereit. Die empfohlene Grundlage für die Bereitstellung ist das Projekt supla-docker.

Ein eigener Server gibt Ihnen mehr Kontrolle über Infrastruktur und Daten, erfordert aber Administration. Der Serverbetreiber ist unter anderem für Aktualisierungen, Backups, TLS-Zertifikate, Domain, Monitoring, Verfügbarkeit und Sicherheit verantwortlich.

Gehen Sie nicht davon aus, dass alle Dienste ohne zusätzliche Konfiguration vollständig mit der öffentlichen Cloud kompatibel sind. Push-Benachrichtigungen, Sprachassistenten und manche Integrationen können eigene Schlüssel, Zertifikate oder externe Dienste erfordern.

Den aktuellen Status der wichtigsten SUPLA-Dienste und -Server können Sie unter status.supla.org überprüfen. Dort werden auch Informationen über aktuelle und behobene Störungen veröffentlicht. Außerdem können Sie Benachrichtigungen über Änderungen des Infrastrukturstatus abonnieren.

Ja. SUPLA empfiehlt MQTT als primären Weg zur Integration mit Home Assistant.

SUPLA unterstützt zwei MQTT-Szenarien: kontoweites MQTT über den SUPLA-Server und direktes lokales MQTT bei unterstützten Geräten.

Kontoweites MQTT ermöglicht Home Assistant, Gerätezustände zu empfangen und Aktionen auszuführen, ohne jedes Gerät einzeln zu konfigurieren. Es unterstützt außerdem MQTT Discovery, sodass Home Assistant für die meisten unterstützten Gerätefunktionen automatisch Entitäten erkennen und erstellen kann.

Einige SUPLA-Geräte können sich direkt mit einem MQTT-Broker im lokalen Netzwerk verbinden.

Es kann auch andere Integrationen auf Basis der SUPLA API geben; diese werden jedoch nicht vom SUPLA-Projekt gepflegt oder unterstützt.

Ja. SUPLA funktioniert mit Google Home und Amazon Alexa. Die verfügbaren Befehle hängen vom Gerätetyp, seinen Funktionen und den Möglichkeiten des jeweiligen Assistenten ab.

Prüfen Sie nach dem Verknüpfen der Konten, welche Geräte und Aktionen freigegeben wurden. Achten Sie bei Toren, Fußgängertoren und Türen auf die von der Assistentenplattform angebotene Methode zur Autorisierung von Befehlen.

Ja. Die SUPLA-App unterstützt Android Auto und Apple CarPlay.

Die Fahrzeugoberfläche stellt ausgewählte, für eine sichere Bedienung während der Fahrt angepasste Funktionen bereit. Sie bietet nicht den Zugriff auf jeden Kanal, jede Einstellung und jede Funktion der vollständigen mobilen App.

Nein. Die Fahrzeugoberflächen ermöglichen derzeit die Ausführung ausgewählter Aktionen, zeigen aber nicht an, ob das Tor geöffnet oder geschlossen ist. In der vollständigen mobilen SUPLA-App können Sie den Torzustand prüfen; dafür ist jedoch ein geeigneter Öffnungssensor erforderlich.

Ja. SUPLA Cloud stellt eine REST API und Autorisierungsmechanismen zur Entwicklung von Integrationen bereit. MQTT ist ebenfalls für Automationssysteme, Apps und Werkzeuge wie Home Assistant verfügbar.

Erteilen Sie Token und Integrationen nur die erforderlichen Berechtigungen. Entfernen Sie ungenutzte Token und speichern Sie keine Zugangsdaten in öffentlichem Quellcode.

Wählen Sie das zu Ihrem Ziel passende Werkzeug:

Ziel	Empfohlener Weg
Firmware für einen eigenen Sensor, ein Relais oder Steuergerät	supla-device
Integration einer Anwendung oder eines Systems	REST API und OAuth
Ereignisgesteuerte Integration oder Automation	MQTT
Eigene vollständige SUPLA-Instanz	supla-docker
Entwicklung von Webpanel und Cloud-Logik	supla-cloud

Für Lern- und Hobbyprojekte können fertige Beispiele verwendet werden. Ein kommerzielles Projekt erfordert zusätzlich die Planung von Aktualisierungen, Diagnose, sicherer Datenspeicherung, Produktionsprozess, Rechtskonformität und langfristiger Gerätepflege.

Das sollte er nicht. Das Hauptkonto sollte dem Eigentümer der jeweiligen Installation gehören.

Bei einem Installateurkonto für mehrere Kunden werden Geräte, Konfigurationen, Verläufe und Berechtigungen verschiedener Eigentümer innerhalb eines Kontos verwaltet. Das erschwert die Trennung von Zugriffsrechten, die Übergabe einer Installation, die Löschung von Daten und die Zuordnung der Verantwortung für das System. Außerdem steigt das Risiko, dass ein Kunde Zugriff auf Geräte oder Daten einer anderen Person erhält.

SUPLA bietet derzeit keinen separaten Servicezugang für Installateure. Während der Einrichtung kann ein Installateur daher Anmeldenamen und Passwort des Kunden benötigen. Nach Abschluss der Arbeiten sollte der Kunde ein neues, nur ihm bekanntes Passwort festlegen.

Der Kunde sollte mindestens Folgendes erhalten:

• Zugriff auf sein eigenes Konto und Bestätigung der E-Mail-Adresse, die als Anmeldename und zur Zugriffswiederherstellung verwendet wird;
• eine Liste der installierten Geräte und Modelle;
• eine grundlegende Beschreibung von Standorten, Kanälen, Szenen, Zeitplänen und Integrationen;
• Herstelleranleitungen und Garantieinformationen;
• Informationen darüber, wer für Installation, Geräte, Firmware und Cloud verantwortlich ist;
• eine Beschreibung des Konfigurationsmodus und des Vorgehens nach einem Routerwechsel;
• Informationen zu erstellten Zugriffsidentifikatoren, API-Token und Integrationen.

Da SUPLA derzeit keinen separaten Servicezugang bietet, sollte der Kunde nach Abnahme der Installation ein neues, nur ihm bekanntes Kontopasswort festlegen. Der Installateur sollte das neue Passwort des Eigentümers nicht aufbewahren.

Nein. Eine Open-Source-Lizenz regelt die Nutzung des Quellcodes. Sie gewährt nicht automatisch das Recht, die offizielle SUPLA-Infrastruktur in kommerziellen Geräten, die offizielle App, den Produktkatalog, Support, Partnermaterialien oder den Namen und die Zeichen von SUPLA zu verwenden.

Ein Hersteller, der Geräte mit offiziellen Diensten und der Marke SUPLA anbieten möchte, sollte entsprechende Vereinbarungen mit uns treffen. Die Zusammenarbeit kann Software, Tests, Infrastruktur, App, Branding, Veröffentlichung im Katalog, Aktualisierungen und Support umfassen.

Der Prozess sollte beginnen, bevor das Hardwaredesign abgeschlossen ist. Eine typische Zusammenarbeit umfasst:

1. Definition der Produktfunktionen und Zielnutzer;
2. Abstimmung von Hardwarearchitektur und Kommunikationsmethode;
3. Wahl des Modells zur Nutzung von Infrastruktur und App;
4. Vorbereitung von Firmware und Aktualisierungsmechanismus;
5. Funktions-, Integrations- und Sicherheitstests;
6. Vorbereitung des Geräts auf rechtliche Anforderungen und Konformitätsbewertung;
7. Vereinbarung über Markennutzung, Katalogveröffentlichung, Support und Produktpflege.

Ein früher Kontakt verringert das Risiko, dass fertige Hardware vor der Integration kostspielig geändert werden muss.

Informationen für Hersteller ansehen.

Der Hersteller, der ein Gerät in Verkehr bringt, ist für die Rechtskonformität des Produkts, Dokumentation, Garantie und Pflichten zu Sicherheit und Produktlebenszyklus verantwortlich.

Die Verantwortung für Firmware-Erstellung, Aktualisierungen und Pflege der Integration hängt vom vereinbarten Kooperationsmodell ab. Sie sollte vor Verkaufsbeginn eindeutig festgelegt werden.

Die bloße Nutzung einer SUPLA-Bibliothek oder des Quellcodes bestätigt nicht, dass ein Produkt technische oder rechtliche Anforderungen erfüllt.

Ja, sofern das Gerät vollständig mit der SUPLA-Infrastruktur kompatibel ist, den vereinbarten Prüfprozess durchlaufen hat, einen eindeutig benannten Hersteller oder eine andere verantwortliche Stelle besitzt, vollständig dokumentiert ist und angemessene Pflege und Unterstützung sichergestellt sind.

Der Hersteller ist außerdem dafür verantwortlich, die für das Produkt geltenden rechtlichen Anforderungen und die vorgeschriebene CE-Kennzeichnung zu erfüllen.

Allein die Nutzung von Open-Source-Code oder inoffizieller Firmware berechtigt ein Gerät nicht automatisch zur Aufnahme in den Katalog.

Ja, im Rahmen der Lizenz des jeweiligen Repositorys. Der Quellcode einzelner Komponenten ist in der SUPLA-Organisation auf GitHub verfügbar.

SUPLA hindert Nutzer nicht daran, eigene DIY-Geräte zu verwenden. Ein eigenes Gerät zu bauen und dem eigenen Konto hinzuzufügen, erfordert keine Zustimmung von uns. Wir ermutigen zum Experimentieren, Lernen und kreativen Weiterentwickeln der Hausautomation – Hobbyprojekte und die DIY-Community sind ein wichtiger Teil des Ökosystems.

Die Kommerzialisierung einer Lösung ist davon zu unterscheiden. Wird ein Gerät oder eine Software als Produkt oder Dienstleistung verkauft oder Kunden angeboten, wird der Entwickler zum Hersteller oder Anbieter und sollte den Abschnitt „Fragen von Geräteherstellern“ lesen, insbesondere die Antwort zur Nutzung der offiziellen Cloud, App und Marke SUPLA.

Prüfen Sie vor der Nutzung des Codes außerdem die Lizenz des betreffenden Projekts und die daraus entstehenden Pflichten.

GUI Generic (GG) und ZigBee2Supla sind Projekte, die von Community-Mitgliedern entwickelt und gepflegt werden. Sie sind keine offiziellen SUPLA-Produkte. Wir sind nicht für Betrieb, Kompatibilität, Aktualisierungen oder technischen Support verantwortlich.

Fragen, Probleme und Vorschläge zu diesen Projekten sollten an deren Entwickler gerichtet und in den entsprechenden Bereichen des SUPLA-Forums veröffentlicht werden. Lesen Sie vor der Verwendung die Dokumentation des jeweiligen Projekts und prüfen Sie, welche Geräte und Funktionen es unterstützt.

Wir ermutigen zum Experimentieren und zur kreativen Nutzung von SUPLA. Community-Projekte, selbst entwickelte Geräte und Modifikationen eignen sich gut, um Elektronik, Programmierung und Automation zu lernen.

Nicht unbedingt. Die Sicherheit hängt von Hardwaredesign, Framework, Speicherung von Passwörtern und Schlüsseln, Firmware-Aktualisierungen, Schutz des Konfigurationsmodus und Widerstandsfähigkeit gegen physischen Zugriff ab.

Ein Hobbyprojekt kann für Lernzwecke oder unkritische Anwendungen geeignet sein. Ohne zusätzliche Analyse sollte es jedoch weder als verkaufsfertiges Produkt noch als Teil einer Installation betrachtet werden, die für die Sicherheit von Menschen oder Eigentum verantwortlich ist.

Normale Fehler können im passenden GitHub-Repository gemeldet werden, nachdem geprüft wurde, ob bereits eine ähnliche Meldung existiert.

Sicherheitslücken dürfen nicht sofort als öffentliches Issue veröffentlicht werden. Nutzen Sie das im Dokument SECURITY.md des jeweiligen Repositorys beschriebene private Verfahren oder den Sicherheitskanal des Geräteherstellers.

Eine Meldung sollte eine Problembeschreibung, die Komponentenversion, Schritte zur Reproduktion, mögliche Auswirkungen und – sofern sicher – einen Lösungsvorschlag enthalten.