Zum Hauptinhalt springen

HTTP-Push / Motor Sense

Zwei Modi, um Werte nicht von einer PLC, sondern von externen IT-Systemen / Messlösungen zu beziehen.

ModusWann wird er eingesetzt
HTTP-PushWenn ein externes System Werte an das Gateway „sendet". Beispiel: Ein internes MES pusht den Chargennamen, ein Barcodescanner pusht seinen Wert
Motor Sense (MOTOR_SENSE)Wenn Schwingungs-/Zustandsdaten der KOPENS Motor-Sense-Lösung per Polling abgeholt werden

HTTP-Push-Modus​

Hier holt das Gateway die Werte nicht aktiv von der PLC, sondern das externe System schiebt (push) die Werte hinein.

Eingabewerte im Registrierungsformular​

EingabefeldWas wird eingetragen
IP-Adresse(wird nicht tatsächlich verwendet, nur zur Identifikation) — z. B. 127.0.0.1
Port(wird nicht tatsächlich verwendet) — z. B. 0
ErfassungsintervallIntervall, in dem das Gateway die extern gepushten Werte aus dem Cache liest und verarbeitet — üblich 1000

PLC-Adressnotation des Tags​

Eine frei wählbare Schlüsselzeichenfolge. Sie dient als Identifikator, den das externe System beim Pushen der Werte verwendet.

BeispielBedeutung
temperatureFreier Name
line/A/rpmSchrägstriche zulässig
barcode.lastPunkte zulässig

Werte von außen senden​

Senden Sie eine HTTP-Anfrage im folgenden Format an das Gateway.

POST http://<gateway-ip>/api/v1/tag/<tag-id>/value
Content-Type: application/json

{ "value": "25.7" }

Alternativ siehe den Abschnitt „Werte schreiben" auf der Seite Erweitert — REST API.

Sobald ein Wert eingeht, wird er im nächsten Erfassungsintervall angezeigt und wie gewohnt bei einer PLC über MQTT / Sparkplug usw. übertragen.

Häufige Anwendungsfälle​

AnwendungsfallVorgehen
MES pusht den ChargennamenTag wie recipe.name anlegen, Datenformat String
Barcodescanner-Ergebnisse erfassenbarcode.last, String
Werte einer externen PLC (nicht anbindbar) weiterleitenBereits konvertierte Werte vom dortigen System senden lassen
Externe Analyseergebnisse übermittelnquality.score, Float

Motor Sense​

Ein spezieller Modus zum Abrufen der Daten aus der KOPENS Motor-Sense-Lösung.

Unterschiede zur normalen PLC​

PunktNormale PLCMotor Sense
BildschirmanzeigeTag-TabelleKarten pro Asset (HEALTH INDEX / SIGNAL)
Tag-RegistrierungManuelle Eingabe durch den BenutzerAutomatische Erzeugung (signals + health_index)
AktualisierungsintervallAnzeige 5 SekundenHintergrundaktualisierung im Sekundentakt
DatenformatFreiJSON-Array (Bündel mehrerer Assets)

Eingabewerte im Registrierungsformular​

EingabefeldWas wird eingetragen
API KEYVon KOPENS ausgestellter API-Schlüssel
Kunden-IDVon KOPENS ausgestellte Kundenkennung
Asset-Listen-URLURL zum Abruf der Asset-Liste
Asset-Signal-URLURL der Asset-Signaldaten
Asset-Zustandsindex-URLURL des Asset-Zustands (Health Index)
Kurvenform/Spektrum ladenOb die umfangreichen Kurvenformdaten mit abgerufen werden

Die URLs müssen mit http:// oder https:// beginnen.

Automatisch erzeugte Tags​

Das Gateway erzeugt automatisch zwei Tags.

Tag-NameBedeutung
signalsSignalbündel je Asset: Schwingung / Temperatur / Spannung usw. (JSON-Array)
health_indexZustandsindex je Asset (Unwucht / Ausrichtung / Lager usw., JSON-Array)

Die Daten jedes Assets werden als Karte aufgeklappt.

Häufige Probleme und Lösungen​

HTTP-Push-Modus​

SymptomUrsacheLösung
Es kommen keine Werte anDas externe System hat nicht gepusht, oder die Tag-ID ist falsch geschriebenLog des externen Systems prüfen. Prüfen, ob POST /api/v1/tag/.../value 200 OK liefert
Werte werden verzögert aktualisiertErfassungsintervall zu lang[Erfassungsintervall] in der PLC-Registrierung verkürzen (z. B. 500 ms)

Motor-Sense-Modus​

SymptomUrsacheLösung
„drive nicht im classpath"Motor-Sense-spezifische jar nicht installiertInstallation der Motor-Sense-jar beim Systemadministrator anfordern
401 UnauthorizedFehler bei API KEY / Kunden-IDVon KOPENS ausgestellten Schlüssel genau prüfen
URL abgelehntBeginnt nicht mit http:// oder https://URL-Format prüfen

Ausführlichere Beispiele / automatisierte Registrierung​

Siehe die HTTP-/Motor-Sense-Beispiele unter Erweitert — REST API.