Die Menügruppe Erweitert (🧰) bündelt die technischen Werkzeuge eines Zuhauses: Netzwerk-Karte, Integrationen, Freigaben, Fernzugriff, Firmware, Developer-Übersicht, Embed und Gerätegruppen. Sie ist nur für den Besitzer und Co-Admins sichtbar; Mitglieder sehen ihr Zuhause, ändern aber nichts. In kleinen Tarifen (Free, Starter, Home) zeigt die Gruppe nur Netzwerk, Integrationen und Freigaben – darunter erscheint die Zeile Mehr mit Family ›.
Was in Erweitert steht, hängt von Tarif, Rolle und Arbeitsbereich ab:
| Menüpunkt | Route | Wer sieht ihn |
|---|---|---|
| 🗺️ Netzwerk | /app/network | Besitzer / Co-Admin in jedem Tarif |
| 🔌 Integrationen | /app/templates | Besitzer / Co-Admin in jedem Tarif |
| 🔗 Freigaben | /app/sharing | Besitzer / Co-Admin in jedem Tarif |
| 🖥️ Fernzugriff | /app/remote-access | ab Family (nicht in Free, Starter, Home) |
| ⚡ Firmware | /app/firmware | ab Family |
| 🔧 Developer (Badge „DEV“) | /app/developer | ab Family |
| 💻 Embed | /app/embed | ab Family im Menü; die Seite selbst ist für Business-Tarife und Unlimited frei |
| 📁 Gerätegruppen | /app/device-groups | nur, wenn das Feature „device-groups“ für das Konto freigeschaltet ist |
| ✨ Mehr mit Family › (Badge „Upgrade“) | /tarife | nur Free, Starter, Home im eigenen Zuhause |
Die Seite Netzwerk („Network Map“) zeigt, wie Ihre Daten fließen: Knoten → Gateway(s) → Cloud. Die Karte wird aus echten Daten gebaut – aus Ihren Geräten, den über Gateways angebundenen Kindern und der jeweils letzten Telemetrie.
Jeder Knoten hat oben einen geformten Stecker, jedes Gateway unten eine Buchse. Die Form steht für die Geräteklasse: ● Sensor, ■ Relais, ⬠ Schloss, ▲ Solar/Wechselrichter, ⬡ Batterie/BMS, ▦ Gateway. Ein Stecker passt nur in eine Buchse derselben Klasse, die das Gateway tatsächlich unterstützt (LAN, BLE oder LoRa).
Solange der Admin gesperrt ist, sind alle Eingaben schreibgeschützt: „Schreibgeschützt – Admin (oben rechts) entsperren zum Bearbeiten“.
Links oben auf der Karte liegt Konfig-Backups: benannte Schnappschüsse, welche Knoten jedes Gateway erfasst. Name in „Konfig-Name…“ eintragen, Speichern. Gleicher Name überschreibt kostenlos; ein neuer Name belegt einen Slot. ↩ stellt eine Konfig auf die Gateways zurück, 🗑 löscht sie (beides nur entsperrt). Slots je Tarif: Regular 1 · Geek 3 · Business 10 · Enterprise 50 (Details in Wer darf was). Ist das Limit erreicht, meldet die Karte „Slot-Limit erreicht ({used}/{limit}). Lösche eine, überschreibe einen Namen oder upgrade deinen Tarif.“
Die Seite Integrationen trägt das Badge „Erweitert“ und den Hinweis „Für fortgeschrittene Benutzer – Diese Integrationen sind für technische Spezialisten gedacht. Basis-Monitoring-Widgets sind bereits auf der Dashboard-Seite verfügbar.“
| Karte | Status | Was passiert bei Konfigurieren |
|---|---|---|
| 📊 Grafana | Verfügbare Integrationen | öffnet das Blatt „Grafana einbinden“ mit drei Schritten: „In Grafana das Dashboard öffnen → „Share“ → „Embed“ und die Einbettung (Anonymous / Public dashboard) erlauben.“ · „Die Server-Adresse (z. B. https://grafana.example.com), die Dashboard-UID und das Panel notieren.“ · „Im LinArt-Dashboard ein Grafana-Widget anlegen und diese Werte eintragen — das Widget zeigt das Panel per iFrame.“ Dazu 📖 Anleitung öffnen (dieser Abschnitt) und Schließen. Eine eigene Einrichtungsseite gibt es nicht – Grafana ist ein Widget-Typ des Dashboards. |
| 🌐 Custom URL / iFrame | Verfügbare Integrationen | öffnet das Blatt „Custom URL / iFrame“: „Eine https-Adresse wählen, die das Einbetten per iFrame erlaubt (keine X-Frame-Options: DENY).“ · „Im LinArt-Dashboard ein URL-Widget anlegen und die Adresse eintragen; Höhe und Aktualisierung lassen sich dort einstellen.“ · „Inhalte, die eine Anmeldung brauchen, zeigen im iFrame meist nur die Login-Seite — dafür einen öffentlichen Link verwenden.“ Mit 📖 Anleitung öffnen und Schließen. |
| 📡 MQTT Broker | Verfügbare Integrationen | öffnet MQTT Integration (/app/integrations/mqtt) |
| 💬 Telegram Bot | Verfügbare Integrationen | öffnet die Telegram-Seite (/app/integrations/telegram) |
| 🗄️ InfluxDB · 🔗 Webhooks | „Demnächst verfügbar“, Button Bald | noch nichts |
sensors/#, devices/+/telemetry.Das ist eine Verbindung zu einem fremden Broker, aus dem das Dashboard Daten liest. Wie Ihre eigenen LinArt-Geräte mit der Cloud sprechen, steht unter Developer und in Anbindung und Token.
Alarmregeln mit Kanal „Telegram“ richten Sie unter Alarme ein.
Die Seite Freigaben („Sharing – Manage your shared widgets and dashboards“) listet alle aktiven Links Ihres Kontos. Ein Link ist entweder ein Widget (ein Diagramm) oder ein Dashboard (mehrere Geräte). Jede Karte zeigt Titel, gekürzte ID, Badge Active oder Expired, „Created“, „Expires“ mit Restzeit („3d 4h left“), „PIN Protected 🔒 Yes“ falls ein PIN gesetzt ist und „Embed ✓ Enabled“ falls Einbetten erlaubt wurde.
Links entstehen dort, wo der Inhalt ist – nicht auf der Freigaben-Seite selbst:
Öffentliche Adressen: /share/<id> (Widget), /share/dashboard/<id> (Dashboard), /share/building/<id> (Gebäude). Wer den Link öffnet, braucht kein Konto; bei PIN-Schutz wird der PIN abgefragt („Invalid PIN code“ bei Fehleingabe). Abgelaufene Links antworten mit „Share link expired“ und werden vom Server automatisch gelöscht.
„Öffnen Sie eine sichere, zeitlich begrenzte Terminal-Sitzung zu einem Ihrer Gateways — der Besitzer muss sie direkt am Gerät bestätigen, sie endet automatisch.“ Berechtigt sind Gateways, die als LinArtBridge_… auf Ihrem Konto laufen. Oben zeigen drei Chips den Stand: Gateways (genutzt / Limit), Aktive Sitzungen und Max. Sitzungsdauer in Min.; „unbegrenzt“, wo der Tarif kein Limit setzt. Oben rechts liegt der Link 📖 Anleitung.
Unter den Karten steht Verlauf mit Spalten Gateway · Status · Stufe · Dauer · Zeitpunkt · Aktionen (bis zu 50 Einträge). Laufende Sitzungen lassen sich auch hier öffnen und beenden. Verlauf löschen fragt: „Alle beendeten Sitzungen aus dem Verlauf ausblenden? Wartende und aktive Sitzungen bleiben; das Audit-Protokoll ist nicht betroffen.“ Es wird nur ausgeblendet – das Protokoll bleibt vollständig. Eine Anfrage, die niemand am Gateway beantwortet hat und deren Zeitfenster vorbei ist, erscheint als „expired“.
Die Seite Firmware („Device Firmware – Flash and update devices over USB“) flasht LinArt-Geräte direkt aus dem Browser. Die ausführliche Anleitung steht in Flashen aus dem Browser; die Befehlsreferenz und Besonderheiten je Gerät in den Gerätehandbüchern. Hier nur, was die Seite im Kabinett zeigt:
LoRaGW_441BF67001D4). Fehler: „… this device is not claimed by your account. Claim it first.“ oder „… not found in the cloud — a brand-new unit self-provisions its own token.“„⚠️ Flashing will erase device settings. Reconfigure WiFi after installation.“ – WLAN danach neu einrichten (siehe Geräte, Bluetooth-Einrichtung).
Die Seite Developer („Developer Dashboard – System health, credentials, and quick access for developers“) ist eine Übersicht, keine Einstellung. Sie aktualisiert sich alle 15 Sekunden (Auto-refresh, ↻ Refresh).
mqtt. + Domain des Dashboards, also mqtt.crm-iot.com für host.crm-iot.com), Ports „1883 (TCP) / 8883 (TLS)“ und WebSocket-Adresse, jeweils mit Kopierknopf ⧉.📋 Code Snippets öffnet Einstellungen → „API & Device Integration“ (/app/settings/api). Dort wählen Sie unter „🎯 Generate code for:“ ein Gerät; dessen Zugangstoken wird in die Beispiele eingesetzt („Tokens auto-injected into snippets below“). „Quick Reference“ zeigt API Endpoint, Account ID und MQTT Broker; die Reiter HTTP API, MQTT und Code Examples enthalten fertige Aufrufe (curl, Arduino, Python, JavaScript) mit Copy. Für Geräte gilt: der Geräte-Token ist der MQTT-Benutzername, das Passwort bleibt leer. Persönliche API-Tokens für Ihr Konto gibt es noch nicht – die Liste „API tokens“ ist leer, bis diese Funktion kommt.
Die Seite Embed („Embed-Integration – Generieren Sie Code zum Einbetten von Widgets auf Ihrer Website“, Badge „Business“) erzeugt Einbettungscode für einen bestehenden Share. Voraussetzung ist ein Share, für den Einbetten aktiviert wurde (siehe Freigabe erstellen).
/embed/<id>. Das API-Beispiel zeigt die drei Schritte der öffentlichen Freigabe-API: 1) GET /api/share/<id>/config (Typ, ob eine PIN nötig ist, ob Einbetten erlaubt ist), 2) POST /api/share/<id>/access mit { "pin": "…" } (ohne PIN leer lassen) → Zugriffstoken, 3) die Seite /embed/<id>; mit dem Token als Authorization: Bearer liefern die Telemetrie-Endpunkte die Daten des freigegebenen Geräts. Der Hinweis unter dem Code: „Öffentliche API des Freigabe-Links: erst die Konfiguration lesen, dann (bei PIN-Schutz) mit der PIN ein Zugriffstoken holen. …“Ohne passenden Tarif zeigt die Seite die Karte „Business-Funktion – Mit der Embed-Integration können Sie IoT-Monitoring-Widgets auf jeder Website einbetten. Verfügbar im Business-Plan.“ mit den Punkten iFrame-Einbettung, JavaScript SDK, REST API, dem Knopf 🚀 Auf Business upgraden und „Ab 29€/Monat“. Der Knopf führt auf Tarif & Abrechnung; welche Tarife Embed enthalten, steht unter Was ist im Tarif.
Gruppen ordnen große Gerätebestände. Die Gruppenleiste steht auf der Seite Geräte oberhalb der Karten; der Menüpunkt Gerätegruppen unter Erweitert erscheint nur, wenn das Feature „device-groups“ für Ihr Konto freigeschaltet ist.
Gruppen werden auf dem Server gespeichert und gelten für alle Mitglieder; Mitglieder und Betrachter können nach Gruppen filtern, aber keine anlegen, umbenennen oder löschen.
In Free, Starter und Home zeigt das Menü unter Erweitert die Zeile ✨ Mehr mit Family › mit dem Badge „Upgrade“ statt gesperrter Einträge. Sie führt zu Tarif & Abrechnung. Family und höher schalten Fernzugriff, Firmware, Developer und Embed im Menü frei (Embed selbst erst ab Unlimited bzw. Business, siehe Tabelle). Den Wechsel erledigen Sie unter Tarif & Abrechnung.
Die Seite zeigt „Fernzugriff ist in Ihrem Tarif nicht enthalten.“ und den Knopf Tarife ansehen (führt auf Tarif & Abrechnung) – sobald der Tarif vom Server als „ohne Fernzugriff“ gemeldet wird, noch bevor eine Anfrage gestellt wurde. Welche Tarife ihn enthalten (Family, Power, Unlimited, Vermietung, Business), steht unter Was ist im Tarif.
„Auf Ihrem Konto sind noch keine berechtigten Gateways vorhanden.“ – nur Geräte mit Namen LinArtBridge_… zählen. Ein Gateway muss zuerst unter Geräte hinzugefügt (geclaimt) sein; sonst meldet die Anfrage „Dieses Gateway wurde auf Ihrem Konto nicht gefunden.“
Die Karte bleibt auf „Wartet auf Bestätigung am Gateway“, bis das gewählte Zeitfenster abläuft; danach wird die Anfrage als „expired“ geführt. Solange sie wartet, zählt sie zur Zahl der aktiven Sitzungen Ihres Tarifs – mit Beenden geben Sie den Platz frei.
Der Fernzugriff wird für das Konto widerrufen, auch wenn der Tarif selbst noch eingetragen ist. Nach Reaktivierung wird die Berechtigung neu berechnet.
Besucher sehen „Share link expired“. In Freigaben trägt der Eintrag das Badge Expired, bis der Server ihn aufräumt. Erstellen Sie den Link neu; Ablaufzeiten lassen sich nicht verlängern.
Lesen Sie den gelben Hinweis darunter: fehlendes Build, nicht erkanntes Board („Das Dashboard braucht das erkannte Board und die Chip-Familie, um das sichere Browser-Flash-Bundle auszuwählen.“) oder unvollständiges Bundle („Der Administrator muss für dieses Release das komplette Browser-Flash-Bundle hochladen oder synchronisieren: bootloader.bin, partitions.bin, boot_app0.bin und ein Dateisystem-Image …“). Im letzten Fall hilft nur ein neues Release oder das Flashen mit esptool/PlatformIO.
Ohne PIN bleibt die Karte schreibgeschützt (Ansehen und Konsole funktionieren weiter). Wenden Sie sich an den Support (Hilfe & Support).
| Rolle | Erweitert im Menü | Ändern |
|---|---|---|
| Besitzer, Co-Admin | ja | alles in diesem Abschnitt |
| Mitglied, Betrachter | nein | Gruppen nur filtern; keine Freigaben, keine Sitzungen |
| Gast (nur Türen) | nein | nichts |
| Funktion | Free · Starter · Home | Family | Power | Unlimited | Rental | Business / Enterprise / White Label |
|---|---|---|---|---|---|---|
| Netzwerk, Integrationen, Freigaben | ja | ja | ja | ja | ja | ja |
| Fernzugriff: Gateways · gleichzeitige Sitzungen · Tunnel-Minuten pro Monat | – | 1 · 1 · 120 | 3 · 2 · 300 | 10 · 3 · 600 | 3 · 2 · 300 | Business 10 · 3 · 600; B2B Cloud und White Label unbegrenzte Gateways, 5 Sitzungen; Enterprise ohne Limit |
| Firmware, Developer im Menü | nein („Mehr mit Family ›“) | ja | ja | ja | ja | ja |
| Embed-Seite nutzbar | nein | nein (Business-Hinweis) | nein | ja | nein | ja |
| Konfig-Backup-Slots (Netzwerk) | 1 | 3 | 10 | 50 | 3 | Business / B2B Cloud 10, Enterprise 50 |
Fernzugriff, Firmware und Developer sind im Menü tarifabhängig ausgeblendet; serverseitig prüft nur der Fernzugriff den Tarif. Bei B2B-Cloud-Verträgen können die Fernzugriffs-Kontingente individuell vereinbart sein.
Sie sind Mitglied oder Betrachter dieses Zuhauses, nicht Besitzer oder Co-Admin – oder Sie sind in der Vermieter-App. Wechseln Sie mit ← Zuhause oder bitten Sie den Besitzer um die Rolle Co-Admin (Familie). In Business-Tarifen gibt es die Gruppe nicht, die Punkte stehen einzeln im Menü.
Ihr Tarif ist Free, Starter oder Home. Statt gesperrter Einträge zeigt das Menü Mehr mit Family ›. Ab Family erscheinen die Punkte.
Sie wählen 15 Minuten bis 8 Stunden; der Tarif begrenzt die Maximaldauer (Chip Max. Sitzungsdauer) und die Tunnel-Minuten pro Monat. Der Gateway-Besitzer kann die Dauer bei der Bestätigung verkürzen. Nach Ablauf endet die Sitzung von selbst.
Protokolliert wird, wer wann welches Gateway wie lange und mit welcher Stufe genutzt hat. Die Eingaben selbst werden laut Hilfe-Text nicht aufgezeichnet.
Rot heißt: seit mehr als 15 Minuten keine Telemetrie in der Cloud. Prüfen Sie Strom, WLAN bzw. LoRa-Verbindung zum Gateway und ob der Knoten im Gateway unter Settings → Scan noch ausgewählt ist. Ein von einem entfernten Knoten gemeldetes „offline“ wird ebenfalls rot gezeigt.
Ja: beim Erstellen PIN Code (Optional) bzw. PIN-Code (4–6 Ziffern bei Gebäuden) setzen. In Freigaben steht dann „PIN Protected 🔒 Yes“. Den PIN geben Sie den Empfängern getrennt vom Link.
Freigaben → 🗑️ Delete → bestätigen. Der Link funktioniert sofort nicht mehr; Besucher sehen „Share link not found or expired“.
Alle, für die ein Release mit vollständigem Browser-Bundle vorliegt und deren Chip-Familie zum erkannten Board passt. Die Liste je Gerät steht in den Gerätehandbüchern, der Ablauf in Flashen aus dem Browser.
Developer → 📋 Code Snippets (oder Einstellungen → API): Gerät unter „Generate code for:“ wählen – der Token steht in den Beispielen. Geben Sie ihn nicht weiter; er authentifiziert das Gerät.
Share erstellen und Einbetten aktivieren, dann unter Embed den 📝 iFrame-Code kopieren und in einen HTML-Block der Zielseite einfügen. Beim Aktivieren legen Sie unter „Allowed Domains“ fest, welche Domains einbetten dürfen (* = alle).