Geräte

Überblick

Oben rechts: 📖 Anleitung (öffnet die Hilfe beim Abschnitt Geräte), 🔄 Aktualisieren (lädt die Liste neu) und — für Eigentümer und Mitverwalter — ➕ Gerät hinzufügen. Darunter kann ein gelber Hinweis zu pausierten Geräten stehen (siehe Pausierte Geräte), dann die Gruppenleiste und das Kartenraster („12 Geräte gefunden“; bei gewählter Gruppe „3 / 12“). Ganz unten der Tipp: „Klicken Sie oben auf „Gerät hinzufügen“, um ein neues Gerät über seine Seriennummer hinzuzufügen.“

Ohne Geräte steht „No devices yet — Add your first IoT device to get started“ mit Add Device (englisch). Eine leere Gruppe meldet „No devices in this group“.

Anschluss und Prozess auf dem Gerät selbst (Flashen, Token, Konsole) beschreiben die Geräte‑ und Firmware‑Handbücher; diese Seite behandelt nur das Dashboard.

Die Gerätekarte

• Name: Ihr vergebener Name (Sensor‑Einstellungen), darunter in Kleinschrift der technische Name; ohne eigenen Namen der technische Name. Dann das Label des Geräts, falls gesetzt.
• Status: grüner Punkt „Online“ (letzter Wert jünger als 10 Minuten), gelb „12m“ (jünger als 1 Stunde), grau „3h“ (jünger als 24 Stunden), rot „Offline“ (älter als 24 Stunden), grau „Keine Daten“ (nichts in den letzten 24 Stunden). Die Angabe wird jede Minute aus den Messwerten der letzten 24 Stunden neu berechnet.
• 🌐 GW: das Gerät hängt an einem LoRa‑Gateway (Abzeichen rechts oben).
• Zeilen: „Typ“, „Lokale IP“ (aus der Telemetrie, als Link http://…), „Gruppe“ (Auswahl mit „Keine Gruppe“), „Erstellt“, „ID“ (gekürzt). Meldet die Firmware ihre Netzadresse, folgt die IP mit 🌐 Weboberfläche öffnen ↗ — nur aus demselben Heimnetz erreichbar; „Port von der Firmware nicht angegeben“ heißt, dass http://<ip>/ versucht wird.
• Knöpfe nach Gerätetyp: 🔐 Schlösser bei einem Schloss‑Gateway (öffnet Schlösser, Assistent „Schloss hinzufügen“, Verlauf — siehe Türen & Codes); 🛡 Lokaler Zugriff (LAN‑Anmeldung) bei Geräten mit lokaler Anmeldung, orange mit „⚠ Werkspasswort, bitte ändern“, solange das Werkspasswort gilt; Relais‑ und Display‑Steuerung für Geräte mit diesen Fähigkeiten; 🛰 Verwalten beim Helios‑Gateway (eigene Verwaltungsseite), sonst Dashboard öffnen.
• Knöpfe unten: 💬 „Nachricht senden“ (Nachricht an das Gerät, bei LoRa‑Knoten über ihr Gateway), ⚙️ „Einstellungen“, 🔑 „Cloud‑Token wiederherstellen“ (nur Eigentümer), 🗑️ „Löschen“ — die letzten drei nur für Eigentümer / Mitverwalter.
• Kartenhintergrund: ein in den Sensor‑Einstellungen hochgeladenes Foto liegt blass hinter der Karte.

Die lokalen Adressen werden alle 5 Minuten neu abgefragt, ebenso der Werkspasswort‑Status.

Schritt‑für‑Schritt: ein Gerät hinzufügen

1. ➕ Gerät hinzufügen öffnet den Dialog „Gerät hinzufügen“ mit den Reitern ✏️ Manuell und 🔵 Bluetooth.
2. Kopplungscode (Reiter Manuell, Feld „Kopplungscode“, z. B. 5E79E4): „Geben Sie den auf dem Gerätedisplay angezeigten Code ein“, dann Suchen → „Gerät gefunden!“ und die Seriennummer wird übernommen. Ein Linux‑Gateway zeigt einen Code wie K7QX-9M2P; „er gilt 10 Minuten“. Nach Suchen steht „Code angenommen. Bestätigen Sie die Verknüpfung jetzt auf dem Display des Gateways:“ und „Das Gateway erscheint in Ihrer Geräteliste, sobald es bestätigt hat.“ → Fertig.
3. Seriennummer („— oder —“): Feld „Seriennummer des Geräts“ (z. B. SB001234, „Seriennummer befindet sich auf dem Geräteaufkleber“), optional „Geheimer Schlüssel (optional)“ („Einige Geräte erfordern einen geheimen Schlüssel zur Verbindung“). Das Kamerasymbol startet QR‑Scannen („Kamera auf QR‑Code richten oder 'Foto hochladen' tippen“, zurück mit 🔙 Manuelle Eingabe). Gerät hinzufügen → „Hinzufügen...“ → „Gerät erfolgreich hinzugefügt!“.
4. QR‑Link: ein gescannter LinArt‑QR‑Code öffnet die Geräteseite mit ?claim=CODE; der Dialog ist dann schon mit dem Code gefüllt und sucht von selbst.
5. Bluetooth (nur Chrome/Edge): Geräte in der Nähe suchen → „Gerät gefunden:“ → „Verbindung über Bluetooth...“ → WLAN‑Name („WLAN‑Netzwerk (SSID)“) und „WLAN‑Passwort“ eingeben → „WLAN‑Zugangsdaten werden gesendet...“ → Zum Konto hinzufügen. Ist das Gerät schon online: „Gerät ist online, wird zum Konto hinzugefügt...“.
6. Nach Erfolg schließt der Dialog und die Liste lädt neu. Platzieren Sie das Gerät anschließend in einem Raum: Zuhause › Gerät einem Raum zuordnen.

Hilfe im Dialog: „💡 Wie finde ich die Seriennummer?“ — „Überprüfen Sie den Aufkleber auf dem Gerät“, „Siehe Gerätedokumentation“, „Verwenden Sie 📷 QR für schnelle Eingabe“. Token‑Vergabe und Provisionierung aus Gerätesicht: Подключение и токены (Gerätehandbuch).

Schritt‑für‑Schritt: Name, Skin und angezeigte Werte (Sensor‑Einstellungen)

1. Auf der Gerätekarte ⚙️ → Dialog „⚙️ Sensor‑Einstellungen“ (zuerst „Lädt...“, der Dialog holt die Messwert‑Schlüssel des Geräts).
2. Gerätename („Name eingeben...“): der Anzeigename im ganzen Dashboard — Geräteliste, Zuhause, Räume, Analyse. Der technische Name bleibt darunter sichtbar.
3. Widget‑Skin: Default, Minimal, Gradient, Dark — das Aussehen der Kacheln dieses Geräts.
4. Kartenhintergrund: 📷 Foto hochladen (wird auf 480 px Breite verkleinert und als kleines JPEG gespeichert), Regler „Sichtbarkeit: 18 %“ (5–45 %), 🗑 Entfernen.
5. Angezeigte Daten: eine Zeile je Messwert mit Kontrollkästchen, Bezeichnung und technischem Schlüssel (z. B. „Temperature · temperature“). Abgewählte Werte verschwinden aus dem Reiter „Alle Geräte“ auf der Startseite. Meldet ein Gerät noch nichts, steht „Keine Telemetriedaten. Senden Sie Daten vom Gerät.“
6. Speichern („Speichern...“) oder Abbrechen.

Die Einstellungen liegen auf dem Server (eine Datei je Gerät und Konto) und werden im Browser nur zwischengespeichert; ohne Verbindung zeigt das Dashboard die zuletzt geladene Fassung. Dieselbe Sichtbarkeit bedienen Sie auch über ✏️ Bearbeiten im Reiter „Alle Geräte“ (Zuhause); die Ringe auf dem Grundriss werden in Räume & Pläne gewählt.

Schritt‑für‑Schritt: Gerätegruppen

Die Gruppenleiste über den Karten filtert die Liste: All Devices, Ungrouped, dann Ihre Gruppen mit Farbpunkt und Anzahl. Die Leiste ist auch in der deutschen Oberfläche englisch beschriftet.

1. + New Group → Dialog „Create Group“: „Group name“ (Platzhalter „Office, Warehouse, Lab...“), „Color“ (zehn Farben) → Create.
2. Auf der Gerätekarte in der Zeile „Gruppe“ die Gruppe wählen (oder „Keine Gruppe“). Ein Gerät ist in höchstens einer Gruppe; der Wechsel entfernt es aus der alten.
3. Rechtsklick auf eine Gruppe: Rename (Name in der Leiste bearbeiten, Enter bestätigt, Esc verwirft) oder Delete mit Rückfrage „Delete this group? Devices will become ungrouped.“

Gruppen sind reine Ordnung in der Geräteliste; sie ändern weder Räume noch Rechte. Familienmitglieder und Betrachter können nach Gruppen filtern, aber keine anlegen, umbenennen oder löschen. Der Menüpunkt Erweitert › Gerätegruppen erscheint nur, wenn das Feature „device-groups“ für Ihr Konto freigeschaltet ist; die Seite dahinter ist noch ein Platzhalter — die Gruppen selbst funktionieren auf der Geräteseite unabhängig davon.

Schritt‑für‑Schritt: ein Gerät entfernen

1. 🗑️ auf der Karte → Dialog „Gerät löschen“: „⚠️ This action cannot be undone!“, „Möchten Sie dieses Gerät wirklich löschen?“ mit Name, Label und ID.
2. Option wählen:
   • Vom Konto trennen — „Das Gerät kehrt in den Pool zurück. Verlauf und Cloud‑Token bleiben erhalten; es kann erneut beansprucht werden.“
   • Endgültig löschen — „Entfernt das Gerät samt Verlauf und Token aus der Cloud. Das physische Gerät meldet sich beim nächsten Verbinden fabrikneu an. Für Verkauf oder Stilllegung.“
3. Der rote Knopf trägt den Namen der gewählten Option; während des Löschens „Wird gelöscht...“. Abbrechen verwirft.

Platzierungen auf Grundrissen und Gruppen‑Zuordnungen verweisen danach ins Leere; entfernen Sie das Gerät auch dort (Räume & Pläne).

Schritt‑für‑Schritt: Cloud‑Token wiederherstellen

Wurde ein Gerät komplett neu geflasht (Speicher gelöscht), kennt es seinen Cloud‑Token nicht mehr. Der Eigentümer kann ihn im Dashboard einsehen:

1. 🔑 auf der Karte („Cloud‑Token wiederherstellen“; während des Ladens ⏳).
2. Dialog „🔑 Cloud‑Token des Geräts“ mit Name und Token; Token kopieren (danach „✓ Token kopieren“), Schließen.
3. Hinweis im Dialog: „Über die serielle Konsole ins Gerät schreiben (tb token <token>) oder den USB‑Ablauf auf der Firmware‑Seite nutzen. Geheim halten.“ Konsole: Консоль и команды.

Der Knopf erscheint nur für den Eigentümer des Zuhauses; Mitverwalter sehen ihn nicht. Gehört das Gerät einem anderen Konto, antwortet der Server „Dieses Gerät ist nicht mit Ihrem Konto verknüpft.“

Pausierte Geräte (über dem Gerätelimit des Tarifs)

Jeder Tarif erlaubt eine bestimmte Zahl Geräte in der Cloud (Tabelle unter Was ist im Tarif). Nach einem Wechsel in einen kleineren Tarif gilt:

• Der Eigentümer wählt unter Einstellungen › Tarif & Abrechnung, Abschnitt Geräte (/app/billing#devices), welche Geräte bleiben. Ohne Wahl bleiben zuerst Sicherheitsgeräte (Schlösser, Rauch‑, Leck‑, Gas‑, Alarm‑Melder), dann die zuletzt aktiven.
• Alle anderen werden am Tag des Wechsels pausiert: Verbindung und Zugangsdaten bleiben, aber gesendete Daten werden nicht mehr gespeichert, Cloud‑Alarme bleiben aus. Lokal arbeiten die Geräte weiter.
• Sicherheitsgeräte bekommen 30 Tage Frist mit wöchentlicher Erinnerung, dann pausieren auch sie.
• Der gespeicherte Verlauf eines pausierten Geräts wird 30 Tage nach der Pause gelöscht; 7 Tage vorher erinnert LinArt an den Export (CSV/ZIP auf der Abrechnungsseite oder unter Einstellungen › Sicherheit › Meine Daten).
• Ein größerer Tarif mit Platz nimmt alles sofort wieder in Betrieb. Schloss‑Gateways, die in den nächsten 30 Tagen bestätigte Buchungen bedienen, werden nicht pausiert.

Auf der Geräteseite steht dann der Hinweis „⏸ 3 Gerät(e) pausiert, 1 weitere laufen nur noch befristet — nicht im Tarif enthalten. Geräte wählen / Daten exportieren“. Benachrichtigungen (Push und E‑Mail) heißen „{n} Gerät(e) pausiert“, „Sicherheitsgeräte werden am {Datum} pausiert“, „Sicherheitsgeräte pausiert“ und „In 7 Tagen wird Gerätehistorie gelöscht“. Den Hinweis sieht nur der Eigentümer des Kontos; die Zählung läuft stündlich.

Wie oft die Werte aktualisiert werden

Wie lange der Verlauf aufbewahrt wird, hängt vom Tarif ab (7 bis 365 Tage, Tabelle unten). Auswertungen: Energie & Analyse.

Firmware über den Browser

Unter Erweitert › Firmware (/app/firmware, ab Tarif Family; Free, Starter und Home sehen den Punkt nicht) flashen Sie ESP32‑Geräte per USB direkt aus dem Browser — nur in Chrome oder Edge (Web Serial), nicht in Safari oder Firefox.

1. Gerät per USB anschließen, dann „Angeschlossenes Gerät erkennen — Wählen Sie einen seriellen Port, um das Board zu identifizieren und passende Firmware anzuzeigen.“ → Verbinden und erkennen („Erkennung läuft...“, bei bekanntem Port Gewählten Port prüfen).
2. Das erkannte Board wird mit Hardware‑Schlüssel, Chip‑Familie und Seriennummer angezeigt; die Liste rechts zeigt nur passende Firmware‑Releases.
3. Release wählen und den Installationsknopf drücken; der Ablauf (Bootloader, Partitionen, App) läuft im Browser.

Mögliche Hinweise: „Das angeschlossene Gerät konnte über die serielle Schnittstelle nicht erkannt werden.“, „Keine Firmware passt zur erkannten Hardware.“, „Erkennen Sie das angeschlossene Board, bevor Sie dieses Release im Browser flashen.“, „Browser‑Flash ist blockiert, weil dieses Firmware‑Bundle unvollständig ist.“ (dann hilft nur der Administrator oder esptool). Überschrift und Teile der Seite sind englisch beschriftet („Device Firmware — Flash and update devices over USB“). Ausführlich: Прошивка из браузера (Gerätehandbuch) und Erweitert.

Was passiert, wenn …

… „Das Gerätelimit Ihres Tarifs ist erreicht“ erscheint

Der Tarif hat keinen Platz für ein weiteres Gerät in der Cloud. „Wechseln Sie den Tarif, um weitere Geräte hinzuzufügen.“ — Tarif & Abrechnung. Ein Gerät zu trennen schafft ebenfalls Platz.

… „Dieses Gerät gehört zu einem anderen Konto“ erscheint

„Der aktuelle Besitzer muss es zuerst entkoppeln.“ — er wählt auf seiner Geräteseite 🗑️ › „Vom Konto trennen“. Danach können Sie es hinzufügen. Bei „Dieses Gerät ist bereits mit einem anderen Konto verbunden“ gilt dasselbe.

… ein zurückgesetztes Gateway noch dem Vorbesitzer gehört

„Dieses Gateway wurde zurückgesetzt und gehört noch dem vorherigen Besitzer. Wir haben ihn um Freigabe gebeten; ohne Antwort wird es am {Datum} freigegeben. Danach erneut hinzufügen. Wenn es eilt, wenden Sie sich an den Support.“ Der Vorbesitzer sieht die Anfrage als Hinweis auf seiner Geräteseite und kann sofort freigeben.

… der Kopplungscode nicht gefunden wird

„Gerät nicht gefunden. Überprüfen Sie den Code.“ oder beim Gateway „Code nicht gefunden oder abgelaufen. Fordern Sie am Gateway einen neuen Code an.“ (Codes gelten 10 Minuten). „Ungültiges Codeformat. Verwenden Sie 4‑8 Zeichen.“ bzw. „Ungültiger Gateway‑Code. Geben Sie den Code im Format XXXX‑XXXX vom Gateway‑Display ein.“ Nach zu vielen Fehlversuchen: „Zu viele falsche Codes. Bitte versuchen Sie es in einer Stunde erneut.“

… Kamera oder Bluetooth nicht verfügbar sind

„Kamerazugriff verweigert. Erlauben Sie den Zugriff in den Browsereinstellungen.“, „Keine Kamera auf dem Gerät gefunden.“ — dann Foto hochladen („QR‑Code nicht im Bild gefunden. Erneut versuchen.“) oder die Seriennummer tippen. „Web Bluetooth wird nicht unterstützt. Verwenden Sie Chrome oder Edge (nicht Firefox/Safari).“

… die Sensor‑Einstellungen „Keine Telemetriedaten“ zeigen

Das Gerät hat noch nie Werte gesendet. Prüfen Sie Stromversorgung, WLAN/LoRa und Token (Status auf der Karte: „Keine Daten“). Sobald Werte ankommen, erscheinen die Schlüssel beim nächsten Öffnen des Dialogs.

… Einstellungen oder Gruppen nicht gespeichert werden

Der Dialog schließt, die Änderung bleibt aber im Browser und wird beim nächsten Laden vom Server überschrieben. Ursache ist meist die Verbindung oder die Rolle (Familienmitglied/Betrachter dürfen nicht speichern). Ein Fehler beim Laden der Liste zeigt „Error: …“ in roter Karte; 🔄 Aktualisieren wiederholt.

… „Netzwerkfehler. Versuchen Sie es erneut“ erscheint

Der Server war nicht erreichbar. Verbindung prüfen und den Schritt wiederholen; nichts wurde halb angelegt.

Wer darf was (Rollen) · Was ist im Tarif

Die Oberfläche blendet Knöpfe aus, die die Rolle nicht erlaubt (für Familienmitglieder fehlen ➕, ⚙️, 🔑, 🗑️, die Gruppenauswahl ist gesperrt); der Server prüft jede Anfrage trotzdem. Rollen vergeben: Familie. Im Arbeitsbereich Vermietung stehen die Geräte unter Technik › Geräte (Vermietung).

Die Grenzen kann der Betreiber je Tarif anpassen; maßgeblich ist, was Einstellungen › Tarif & Abrechnung anzeigt.

Häufige Fragen

Warum steht mein Gerät auf „Offline“ oder „Keine Daten“?

„Offline“: der letzte Wert ist älter als 24 Stunden; „Keine Daten“: in den letzten 24 Stunden kam nichts. Strom, WLAN bzw. Gateway und Token prüfen; bei LoRa‑Knoten das Gateway (Abzeichen „🌐 GW“). Zwischenstufen „12m“ / „3h“ zeigen das Alter des letzten Werts.

Wie gebe ich einem Gerät einen verständlichen Namen?

⚙️ auf der Karte → „Gerätename“ → Speichern. Der Name gilt überall im Dashboard und in der iOS‑App; der technische Name bleibt zur Sicherheit darunter.

Wie blende ich einen Messwert aus, der mich nicht interessiert?

In den Sensor‑Einstellungen unter „Angezeigte Daten“ das Häkchen entfernen, oder auf der Startseite unter „Alle Geräte“ ✏️ Bearbeiten → 🙈 auf der Kachel. Beide Wege ändern dieselbe Einstellung.

Warum fehlt bei mir der Knopf „Gerät hinzufügen“?

Sie sind Familienmitglied oder Betrachter in einem fremden Zuhause. Geräte fügt der Eigentümer oder ein Mitverwalter hinzu; bitten Sie um die Rolle Mitverwalter (Familie).

Was bedeutet „pausiert — nicht im Tarif enthalten“?

Das Gerät liegt über dem Gerätelimit Ihres Tarifs: es bleibt verbunden, aber seine Daten werden nicht gespeichert und Cloud‑Alarme sind aus. Unter Tarif & Abrechnung wählen Sie andere Geräte zum Pausieren oder einen größeren Tarif; den Verlauf vorher exportieren (Löschung 30 Tage nach der Pause).

Trennen oder endgültig löschen — was ist richtig?

Trennen, wenn das Gerät später wieder (auch von jemand anderem) beansprucht werden soll — Verlauf und Token bleiben. Endgültig löschen vor Verkauf oder Stilllegung — Verlauf und Token verschwinden, das Gerät meldet sich wie neu.

Wo finde ich den Cloud‑Token nach einem Neuflash?

Als Eigentümer 🔑 auf der Karte → „Cloud‑Token des Geräts“ → Token kopieren, dann per Konsole tb token <token> oder über die Firmware‑Seite per USB eintragen.

Warum sind die Gruppen auf Englisch beschriftet?

Die Gruppenleiste hat derzeit nur englische und russische Texte („All Devices“, „Ungrouped“, „New Group“); die Funktion ist dieselbe.

Wie öffne ich die Weboberfläche eines Geräts?

Auf der Karte 🌐 Weboberfläche öffnen ↗ oder den Link bei „Lokale IP“ — nur aus demselben Heimnetz. Für die Anmeldung am Gerät gilt 🛡 Lokaler Zugriff (LAN‑Anmeldung); ändern Sie dort das Werkspasswort, wenn „⚠ Werkspasswort, bitte ändern“ steht.

Wo sehe ich, welche LoRa‑Knoten an welchem Gateway hängen?

Knoten tragen das Abzeichen „🌐 GW“; die Karte Knoten → Gateways → Cloud liegt unter Erweitert › Netzwerk (Erweitert).

Begriffe

Gerät / Sensor

Alles, was Werte an die Cloud sendet: Klimasensor, LoRa‑Knoten, Gateway, Relais, Helios‑Energie‑Gateway, Schloss‑Gateway, Server‑Agent.

Seriennummer, Kopplungscode, Geheimer Schlüssel

Die drei Wege, ein Gerät Ihrem Konto zuzuordnen: Aufkleber, Display‑Code (10 Minuten gültig) oder Schlüssel aus der Dokumentation.

Cloud‑Token

Das Zugangsgeheimnis des Geräts zur Cloud; wird bei der Kopplung vergeben und bei einem Neuflash neu eingetragen.

Sensor‑Einstellungen

Name, Skin, Kartenhintergrund und sichtbare Messwerte eines Geräts; gespeichert auf dem Server je Konto.

Messwert‑Schlüssel

Der technische Name eines Werts (z. B. temperature, co2, batt_soc_pct), wie ihn die Firmware sendet.

Gruppe

Ein farbiger Ordner zum Filtern der Geräteliste; ein Gerät gehört in höchstens eine Gruppe.

Trennen / Endgültig löschen

Trennen = Gerät zurück in den Pool, Verlauf bleibt. Endgültig = Gerät samt Verlauf und Token aus der Cloud entfernt.

Pausiert

Gerät über dem Tariflimit: verbunden, aber ohne Speicherung und Cloud‑Alarme; Verlauf wird nach 30 Tagen gelöscht.

Sicherheitsgerät

Schloss, Rauch‑, Leck‑, Wasser‑, Gas‑, Feuer‑ oder Alarmmelder; bekommt vor dem Pausieren 30 Tage Frist.

Werkspasswort

Das voreingestellte Passwort der lokalen Weboberfläche; sollte unter „Lokaler Zugriff“ geändert werden.

Siehe auch

• Zuhause — Gerät einem Raum zuordnen, Kacheln unter „Alle Geräte“
• Räume & Pläne — Sensoren auf dem Grundriss, Ringe wählen
• Türen & Codes — Schloss‑Gateway, Schlösser, Codes
• Familie — Rollen Mitverwalter, Familienmitglied, Betrachter
• Energie — Helios‑Gateway, „Verwalten“
• Alarme und Automationen — Regeln auf Messwerten und Relais
• Erweitert — Netzwerk, Firmware, Fernzugriff, Integrationen, Freigaben
• Tarif & Abrechnung — Gerätelimit, pausierte Geräte wählen, Verlauf exportieren
• Konto & Sicherheit — „Meine Daten“
• Vermietung — Geräte im Arbeitsbereich „Technik“; Gäste
• Hilfe · Gerätehandbücher: Übersicht, Kopplung & Token, Flashen im Browser, Konsole