| Ein Gerät reagiert nicht über die App | Verbindungsstatus (siehe „Verbindungen“); nicht verknüpfte Objekte; Seite Status (siehe „Wertetransformationen & Status“) | Fehlende Objekte verknüpfen, Verbindung reparieren, Transformationsfehler beheben. |
| Ein Gerät ignoriert „Alles Aus“- / Raumbefehle | Ist es von globalen Befehlen ausgenommen (siehe „Alarm-PIN & Ausschlüsse für globale Befehle“)? | Dieser Ausschluss ist beabsichtigt – der Administrator hat ihn eingerichtet. Bei Bedarf im Administrationsbereich entfernen. |
| Kein Verlauf, leere Diagramme | Ist der Verlaufsdienst aktiviert (siehe „Dienste & Protokolle“)? Ist Verlaufswerte protokollieren für dieses Objekt aktiviert (siehe „Objekteinstellungen, Protokollierung & Benachrichtigungen“)? | Verlaufsdatenbank aktivieren und Verlaufswerte protokollieren pro Objekt einschalten. Der Verlauf startet ab dem Zeitpunkt der Aktivierung – eine rückwirkende Erfassung erfolgt nicht. |
| Wetter zeigt nichts an | API-Schlüssel eingegeben? Standort festgelegt (siehe „Netzwerk- & Zeiteinstellungen“, „Wetterdienst“)? Dienst aktiviert? | Gültigen Anbieterschlüssel eingeben und Stadt/Koordinaten festlegen; mit dem Live-Wert auf der Wetterseite testen. |
| Energiepreise sind leer | ENTSO-E-Schlüssel? Gebotszone ausgewählt (siehe „Energiepreis-Dienst“)? | Schlüssel eingeben, Gebotszone wählen, Konfiguration speichern klicken und dann den Dienst aktivieren; der Schalter springt zurück auf Aus, wenn der Abruf fehlschlägt. |
| Eine MQTT-Verbindung zeigt Getrennt | Verbindung testen (siehe „Verbindungen“): Meldet der Broker Nicht autorisiert oder wird die Verbindung verweigert? | Benutzername/Passwort oder Port korrigieren; bei mqtts:// das Zertifikat prüfen (CA-Zertifikat oder Selbstsignierte Zertifikate akzeptieren für Broker mit eigenem Zertifikat). Der Server wiederholt den Verbindungsaufbau automatisch, sobald die Angaben stimmen. |
| Ein MQTT-Widget wird nie aktualisiert | Entspricht das Topic des Objekts exakt dem, was das Gerät veröffentlicht? Verweist ein JSON-Pfad auf ein existierendes Feld? | Im Objekteditor auf Broker scannen klicken (siehe „MQTT-Integration“) und Topic sowie Feld aus den tatsächlichen Broker-Nachrichten auswählen – ein falscher Pfad verwirft jede Nachricht unbemerkt. Ein ausgehendes Topic darf weder + noch # enthalten. Verweigert ein Broker Topic-Filter (Zugriffskontrollliste), wird dies im Server-Log gemeldet. |
| Der integrierte Broker zeigt nichts auf der Seite MQTT-Broker | Ist der Dienst MQTT-Broker aktiviert und wurde der Server danach neu gestartet (siehe „Dienste & Protokolle“)? | Dienst aktivieren, neu starten und anschließend Konfigurieren erneut öffnen. Das Statusfeld meldet, wenn der Broker nicht läuft (siehe „Der integrierte MQTT-Broker“). |
| Ein Gerät kann sich nicht mit dem integrierten Broker verbinden | Verfügt es über ein eigenes Konto? Entspricht die Adresse im Gerät exakt der Angabe unter Im Gerät einzugebende Adresse? | Ein Konto pro Gerät anlegen; anonyme Verbindungen sind standardmäßig deaktiviert, sodass Geräte ohne Zugangsdaten abgewiesen werden. Prüfen, ob die Listener-Karte Aktiv und nicht Aus anzeigt. |
| Ein Gerät stoppt direkt nach Aktivierung der Topic-Regeln | Verfügt dieses Konto über eine Regel für die genutzten Topics? | Bei aktivem Topics pro Konto einschränken wird ein Konto ohne passende Regel überall abgewiesen. Eine Regel pro Gerät hinzufügen; HyperVisus eigenes Konto benötigt keine – es behält immer vollen Zugriff. |
| Retained-Werte sind nach einem Neustart verschwunden | Ist Retained-Nachrichten über Neustarts hinweg beibehalten aktiv? Ist Retained-Nachrichten zulassen aktiv? | Beides aktivieren. Ohne Persistenz startet der Broker leer und jedes Widget wartet auf die nächste Veröffentlichung des Geräts. |
| Auf den veröffentlichten Status-Topics erscheint nichts | Ist Widget-Status an MQTT senden aktiv? Zeigt das Panel an, dass es aktiviert ist, aber nicht sendet? | Das Senden erfordert das aktivierte MQTT-Protokoll sowie eine Verbindung zu einem Broker. Prüfen, ob die Topic-Vorschau mit dem Abonnement übereinstimmt – Seriennummer und Topic-Stil gehören dazu. |
Befehle auf einem …/set-Topic bewirken nichts | Ist Befehle über MQTT akzeptieren aktiv? Ist der anonyme Zugriff deaktiviert? Handelt es sich um ein reines Eingangsobjekt? | Befehle werden vollständig abgewiesen, solange der Broker anonyme Clients zulässt, sowie nach Nachricht bei schreibgeschützten Objekten oder Nutzdaten, die nicht dem Objekttyp entsprechen. |
| Ein BACnet Netzwerk-Scan findet nichts | Läuft der BACnet/IP-Dienst (siehe „Dienste & Protokolle“)? Befindet sich das Gerät im selben Subnetz am Standard-Port? | Dienst aktivieren; dann Adresse scannen (siehe „BACnet/IP-Integration“) mit dem Subnetz-Broadcast (192.168.1.255) nutzen, falls Broadcasts zwischen VLANs gefiltert werden, oder direkt die Geräteadresse (192.168.1.70:47808) eingeben – Geräte an Nicht-Standard-Ports werden über Broadcasts nie gefunden. |
| Ein BACnet-Gerät ignoriert das Widget | Schreibt ein anderes System (die Gebäudeleittechnik) auf dasselbe Objekt? Multi-State um eins verschoben? | Eine Schreibpriorität mit niedrigerer Nummer als der andere Sender festlegen (siehe „BACnet/IP-Integration“); bei Multi-State-Verknüpfungen den Offset -1 verwenden. |
| Ein TCP/UDP-Test schlägt fehl oder die Verbindung bleibt Getrennt | Verbindung nicht möglich … Zeitüberschreitung oder ECONNREFUSED | Adresse und Port prüfen sowie sicherstellen, dass keine andere Anwendung die Einzelverbindung des Geräts belegt (Herstellersoftware). Ein Test auf einer bereits belegten Verbindung meldet den aktuellen Zustand statt erneut zu prüfen – dies ist das reguläre Verhalten. |
| Ein Sonos Netzwerk-Scan findet keine Zonen | Befinden sich die Lautsprecher im selben Netzwerksegment wie der Server? Ist das Sonos-Protokoll aktiviert? | Die Erkennung nutzt einen Netzwerk-Broadcast, der von Routern und VLANs häufig blockiert wird. Die IP-Adresse des Start-Lautsprechers manuell eingeben – eine Adresse genügt für das gesamte System (siehe „Sonos-Integration“). |
| Sonos-Quellentasten zeigen falsche Namen | Wurden die Favoriten in der Sonos-App nach der Erstellung des Widgets geändert? | Auf dem Widget Sonos-Favoriten synchronisieren drücken (siehe „Gerätebibliothek & Sonos-Verknüpfung“). Die Namen werden auf dem Widget gespeichert und passen sich nicht automatisch an Änderungen in der Sonos-App an. |
| Ein aus der Bibliothek erstelltes Gerät reagiert nicht | Wurde nach dem Erstellen Änderungen anwenden ausgeführt? Erfordert das Gerät eine aktivierte Option (seine Einrichtungsvoraussetzungen)? | Ausstehende Änderungen anwenden; anschließend die Anforderungen der Vorlage prüfen – die meisten Wechselrichter werden mit deaktiviertem Modbus TCP ausgeliefert und erfordern teils ein Installateurkonto zur Aktivierung (siehe „Gerätebibliothek & Sonos-Verknüpfung“). |
| Ein TCP/UDP-Gerät ignoriert Befehle oder sendet keine Werte | Endet die Vorlage mit dem Trennzeichen? Werden Befehle direkt hintereinander gesendet? Ist ein Abgleichsmuster vorhanden? | Die Vorschau Gesendeter Frame prüfen (siehe „TCP/UDP-Integration“); Verzögerung zwischen Befehlen erhöhen; ein Eingangsobjekt ohne Abgleichsmuster empfängt nie einen Wert, und der Schlüssel muss im Rückmelde-Frame des Geräts vorkommen. |
