Zum Hauptinhalt springen

Fehlerbehebung

Wir haben dies nach Symptomen geordnet, damit Sie schnell die passende Lösung finden.

Container-Modus-Box

Wenn systemctl is-active plantpulse-edge.service aktiv ist, befinden Sie sich im Container-Modus – für einige Symptome bietet die Szenariomatrix (A–E) im Abschnitt „Störungsbehebung“ von Container-Modus-Betrieb eine schnellere Diagnose. Sammeln Sie alle Diagnoseinformationen:

sudo bash /opt/kopens/install/bin/doctor.sh
# → /tmp/pe-doctor-`<host>`-`<ts>`.tar.zst (support 전달)

Schnellindex​

SymptomWohin Sie gehen sollten
Die Gateway-Oberfläche lässt sich nicht öffnenDie Oberfläche lässt sich nicht öffnen
Anmeldung funktioniert nichtDie Anmeldung funktioniert nicht
Keine Verbindung (PLC)Keine Verbindung
Verbindung steht, aber es kommen keine Werte anEs kommen keine Werte an
Werte kommen an, aber sie sind falschDie Werte sind falsch
Werte kommen plötzlich nicht mehrDie Werte sind plötzlich abgebrochen
Die Oberfläche ist langsamDie Oberfläche ist langsam
Speicher/Datenträger ist rotRessourcen sind knapp
Datenübertragung zu Cloud / SCADA funktioniert nichtDie Übertragung funktioniert nicht
Tag-[Schreiben] funktioniert nichtWerte können nicht geschrieben werden

Die Oberfläche lässt sich nicht öffnen​

Wenn Sie die Gateway-IP im Browser eingeben, aber keine Seite angezeigt wird.

Schritt 1 – Prüfen, ob das Gateway vom PC aus sichtbar ist​

In der Eingabeaufforderung:

ping <gateway-ip>

Wenn keine Antwort kommt, liegt ein Netzwerk-/Kabel-/VPN-Problem vor. Informieren Sie den Systemadministrator: „Das Gateway ist nicht sichtbar“.

Schritt 2 – Anderen Browser / anderen Benutzer ausprobieren​

Wenn dasselbe Symptom auf einem anderen PC auftritt, ist das Gateway selbst möglicherweise ausgeschaltet oder hängt. Der Systemadministrator muss den Gateway-PC neu starten.

Schritt 3 – URL prüfen​

  • http://게이트웨이IP/ ist das übliche Format.
  • Manchmal ist auch eine Portnummer angehängt (z. B. http://게이트웨이IP:8080/).
  • Wenn Sie die interne Standard-URL nicht kennen, fragen Sie einen Kollegen.

Die Anmeldung funktioniert nicht​

Passwort vergessen​

Probieren Sie das Standardpasswort.

  • ID: admin
  • Passwort: admin123!

Wenn die Umgebung bereits geändert wurde, bitten Sie den Systemadministrator um eine Passwortzurücksetzung.

Nach der Anmeldung wird sofort abgemeldet​

Dies kann ein Sitzungs-/Cookie-Problem sein. Leeren Sie die Browser-Cookies und versuchen Sie es erneut.

Keine Verbindung​

Im Bildschirm [Verbindung] wird das Verbindungssymbol der Karte rot (durchgestrichenes WLAN-Symbol, Tooltip „Getrennt“) angezeigt.

Schritt 1 – Ist die PLC vom selben PC aus sichtbar?​

Bitten Sie den Systemadministrator zu prüfen, ob ein Ping an die PLC-IP vom Gateway-PC aus möglich ist.

Schritt 2 – Stimmt der Port?​

Standardports je nach PLC-Typ:

PLCPort
OPC-UA (Kepware)49320
Modbus TCP502
Mitsubishi (Q/L)5000 oder 1029 (PLC-Einstellung)
Mitsubishi (iQ-R)1500
Siemens S7102
LS2004
AB EtherNet/IP44818

Das Kommunikationsmodul auf der PLC-Seite muss aktiviert sein.

Schritt 3 – Sicherheitseinstellungen auf der PLC-Seite​

PLCZusätzliche Einstellungen erforderlich
Siemens S7In TIA Portal „PUT/GET-Kommunikation zulassen“ aktivieren + DB im „Optimierten“ Modus deaktivieren
MitsubishiIn GX Works „MC-Protokoll / TCP / Port“ aktivieren
OPC-UABenutzer/Passwort oder anonymen Zugriff erlauben
LSICMP (ping) darf nicht blockiert sein

Schritt 4 – Benutzer / Passwort​

Bei PLCs mit Authentifizierung (wie OPC-UA) müssen ID/Passwort korrekt sein. Tragen Sie sie im [Bearbeiten]-Formular der PLC erneut ein und versuchen Sie es noch einmal.

Es kommen keine Werte an​

Das Verbindungssymbol der Karte ist grün (verbunden) und das Erfassungs-Badge ist normal, aber das Feld [Aktueller Wert] des Tags ist leer.

Schritt 1 – PLC-Adressnotation prüfen​

Dies ist die häufigste Ursache. Die Notation unterscheidet sich je nach PLC-Typ.

  • Mitsubishi: D100, M50 (ohne vorangestelltes %)
  • Siemens: %DB1.DBW0 (mit % davor, DB-Nummer + DBW/DBD)
  • LS: D00309 (5-stellige Zahl)
  • OPC-UA: ns=2;s=경로-Format

Schlagen Sie im Abschnitt [PLC-Adressnotation] Ihrer PLC-Seite nach.

Schritt 2 – Datenformat / Format-Assistent prüfen​

Wenn ein Wert 32 Bit oder mehr hat und der [Format-Assistent] leer ist, wird er möglicherweise als 16 Bit gelesen und der Wert ist nicht sichtbar.

  • 32-Bit-Ganzzahl: Format-Assistent = DW
  • 32-Bit-Gleitkommazahl: Format-Assistent = REAL
  • 64-Bit-Gleitkommazahl: Format-Assistent = LREAL

Schritt 3 – Dieselbe Adresse mit einem anderen Tool verifizieren​

Prüfen Sie mit dem PLC-Programmiertool (GX Works / TIA Portal / XG5000 / UA Expert) im Monitor-/Watch-Fenster, ob dieselbe Adresse tatsächlich funktioniert.

Die Werte sind falsch​

Die Werte kommen an, sind aber zu groß, zu klein oder haben das falsche Vorzeichen.

32 Bit, wird aber als 16 Bit gelesen​

Muster: Werte sehen zufällig aus oder sind abgeschnitten. Geben Sie im [Format-Assistent] DW (Ganzzahl) oder REAL (Gleitkommazahl) an.

Vorzeichenlose Werte werden als vorzeichenbehaftete Werte gelesen​

Beispiel: 65535 wird als -1 angezeigt. Im [Format-Assistent] UI (16-Bit ohne Vorzeichen) oder UDW (32-Bit ohne Vorzeichen) angeben.

Byte-/Wortreihenfolge (Endian) ist umgekehrt​

Wenn bestimmte Slaves (häufig bei Modbus-Slaves) Werte im Little-Endian-Format senden, erscheinen 32-Bit-Gleitkommazahlen fehlerhaft.

  • Bei Modbus: Datenformat als Variante wie :UDINT_LSWORD_FIRST versuchen
  • Bei anderen PLCs: Nachbearbeitung mit Formelanwendung ist oft schwierig; wenden Sie sich an den Systemadministrator.

Andere Einheit​

Die PLC sendet einen ganzzahligen Rohwert (z. B. 1638), aber die tatsächliche Bedeutung ist 163.8. Verwenden Sie die Formelanwendung, um ${VALUE}*0.1 für die Einheitenumrechnung einzugeben.

Die Werte sind plötzlich abgebrochen​

Werte, die vorher korrekt ankamen, kommen plötzlich nicht mehr.

Schritt 1 – Verbindungsstatus prüfen​

Wie ist der Verbindungsstatus dieser PLC im Menü [Verbindung]?

Auf der Karte sichtbarBedeutung / nächste Schritte
Verbindungssymbol rot (Tooltip „Getrennt“)Problem auf der PLC-Seite. PLC neu starten oder Kabel/Netzwerk überprüfen
Erfassungs-Badge grau „Stopp“Jemand hat ◼ gedrückt oder automatischer Stopp. Mit ▶-Button fortsetzen
Erfassungs-Badge gelb „Störung“Erfassung läuft, aber das Lesen schlägt fehl. Prüfen Sie die [Letzte Fehlermeldung] in den Kartendetails
Symbol grün + Badge normal, aber keine WerteDie betreffende Adresse der PLC ist möglicherweise deaktiviert
Verbindungsstatus ist ein Symbol, kein Text

Suchen Sie auf der Karte nicht nach dem Text „Verbindung fehlgeschlagen“ – diesen gibt es nicht. Der Verbindungsstatus ist das WLAN-Symbol rechts; „Verbunden / Getrennt / Unbekannt“ erscheint nur als Tooltip, wenn Sie mit der Maus darüberfahren. Der Text „Normal verbunden / Verbindung fehlgeschlagen“ befindet sich im Netzwerkpanel des Startbildschirms und ist etwas anderes.

Schritt 2 – PLC selbst prüfen​

  • Läuft die PLC im RUN-Modus? (Wenn sie auf STOP steht, bleiben die Werte stehen)
  • Wurden die Speicherschutzeinstellungen für den Adressbereich geändert?
  • Wenn die PLC gerade aktualisiert oder neu gestartet wurde, warten Sie kurz; die Verbindung wird automatisch wiederhergestellt.

Schritt 3 – Gateway neu starten​

Starten Sie das Gateway selbst über [Einstellungen] → [Anwendung neu starten]. Die Wiederherstellung erfolgt innerhalb von 1 Minute.

Die Oberfläche ist langsam​

Bei vielen PLCs oder Tags kann das erste Laden 1–2 Sekunden dauern.

  • In der Regel kein großes Problem.
  • Wenn die CPU-Anzeige auf dem Hauptbildschirm rot ist, sind die Ressourcen des Gateway-PCs möglicherweise knapp. Wenden Sie sich an den Systemadministrator.

Ressourcen sind knapp​

Die CPU-/Speicher-/Datenträger-Anzeigen auf dem Hauptbildschirm werden rot angezeigt.

AnzeigeMaßnahme
CPUPrüfen, ob eine PLC mit zu kurzem Erfassungsintervall verwendet wird. Auf 1 Sekunde oder mehr erhöhen
SpeicherÜber [Einstellungen] → [Anwendung neu starten] vorübergehend behebbar. Bei Wiederholung Speichererweiterung beim Systemadministrator anfordern
Datenträger[Einstellungen] → [Temporäre Dateien bereinigen]. Möglicherweise ist die Aufbewahrungsdauer der Zeitreihe zu lang

Die Übertragung funktioniert nicht​

Die Werte werden korrekt erfasst, aber die Übertragung an Cloud / SCADA / MQTT schlägt fehl.

MQTT / Sparkplug wird nicht veröffentlicht​

  • Den Systemadministrator bitten, den „MQTT-Aktivierungsstatus“ zu prüfen
  • Prüfen, ob auf demselben Gateway-PC ein MQTT-Broker (z. B. HiveMQ) läuft

Keine Antwort von der Plattform-API​

  • Kein Zugriff auf die PlantPulse-Plattform selbst → bitte an die Zentrale/das Betriebsteam wenden
  • Das Gateway puffert in der Warteschlange; eine vorübergehende Unterbrechung wird automatisch behoben.

Detaillierte Log-Keywords/-orte für Systemadministratoren finden Sie in den erweiterten Entwicklerhinweisen.

Letzte Maßnahmen​

  • [Einstellungen] → [Logs herunterladen] zum Sammeln aller Diagnose-Logs
  • [Einstellungen] → [Anwendung neu starten] zum Neustart nur des Gateways (1 Minute)
  • [Einstellungen] → [System neu starten] zum Neustart des PCs (3–5 Minuten)

Wenn das Problem weiterhin besteht, laden Sie die Logs herunter und wenden Sie sich mit diesen an KOPENS oder das PlantPulse-Betriebsteam.

Werte können nicht geschrieben werden​

Wenn Sie das [Schreiben]-Symbol am Ende der Tag-Zeile anklicken und eine Meldung wie „Schreiben fehlgeschlagen“ / „driver returned false“ erscheint.

Schreibunterstützung je Protokoll​

Das Schreiben wird je nach PLC-Typ unterschiedlich unterstützt.

Ihre PLCSchreiben unterstütztHinweise
Mitsubishi (MELSEC)✅ JaQ/L/iQ-R alle unterstützt
Siemens (S7)✅ JaDB/M/I/Q-Bereiche
OPC-UA (Kepware usw.)✅ JaSchreibrechte für den Zielknoten erforderlich
Modbus TCP✅ JaHolding Register / Coil
HTTP-Push✅ Ja (Cache)—
LS ELECTRIC (XGI/XBC/XBM)✅ JaBit/Byte/Word/DWord/Float/Double
AB EtherNet/IP✅ JaJe nach PLC-Firmware/Patch können bestimmte Typen abgelehnt werden

Häufig auftretende Meldungen​

MeldungBedeutung / Maßnahme
쓰기 실패 (opc_type=...)Treiber gibt false zurück. Adressformat, Datentyp (format) und Schreibrechte der PLC prüfen
tag not found: ...Ungültige Tag-ID. Nach dem Aktualisieren erneut versuchen
scheduler not running for opc_id=...Die jeweilige PLC ist im Status [Stopp]. [Start]-Button drücken und erneut versuchen
OPC ... 가 PLC 와 연결되어 있지 않습니다Schreibversuch im Status DISCONNECTED – IP/Port/Firewall prüfen, dann neu starten

Wenn es immer noch nicht funktioniert​

  • Geben Sie dem Systemadministrator [PLC-Typ + Tag-ID + vollständige Meldung] an.
  • Das Gateway-Log enthält weitere Details zur Ursache.