HOMAG Connect Machine Data
Über die HOMAG Connect Machine Data Schnittstelle erhalten Sie direkten Zugang zu den Rohdaten Ihrer Maschinen über eine Cloud-Schnittstelle. Diese bietet Ihnen umfassende Informationen über den aktuellen Zustand Ihrer Maschinen sowie eine 90-tägige Historie. Dadurch können Sie Ihre Maschinendaten nahtlos in ERP-Systeme oder branchenspezifische Lösungen integrieren. Je nach Ihren Bedürfnissen können Sie die Daten auch mit Analysetools wie Excel oder Power BI auswerten und entsprechend Ihrer Anforderungen anpassen und visualisieren.
Die Schnittstelle bietet zusätzlich zu den Daten der OPC UA Woodworking Companion Specification noch weitere Daten. OPC UA (Open Platform Communications Unified Architecture) ist ein Schnittstellenstandard, der die standardisierte Übertragung von Maschinendaten in der Möbelindustrie gewährleistet und somit die Interoperabilität zwischen Maschinen unterschiedlicher Hersteller gewährleistet. Die offizielle Beschreibung der Spezifikation finden Sie hier.
Über die HOMAG Connect Machine Data Schnittstelle können allgemeine Informationen wie bspw. Maschinenidentifikation, Maschinenstatus, Fehler- und Warnmeldungen der Maschine abgerufen werden. Außerdem ermöglicht sie Zugriff auf die unverarbeiteten Daten aus dem HOMAG MMR, die bspw. Aufschluss über den Maschinenzustand, Zustands- und Teilezähler sowie Wartungs- und Schichtinformationen geben. Grundsätzlich sind die Rückgabewerte für alle HOMAG Maschinentypen identisch. Je nach Maschinentyp gibt es jedoch zusätzliche spezifische Zustände, wie z.B. Wartungsintervalle einzelner Maschinenkomponenten, die variieren können.
Die Schnittstelle ist als kostenpflichtiges Add-On für MMR für Neumaschinen ab dem Baujahr 2024 verfügbar. Wie Sie sich für die Nutzung der Schnittstelle authentifizieren ist unter dem Abschnitt Authentifizierung beschrieben.
Zugriff auf Maschinenliste
Der Endpunkt stellt eine Übersicht aller Maschinen bereit, die Ihrer Kundenumgebung zugeordnet sind und eine Lizenz für die HOMAG Connect Machine Data Schnittstelle besitzen.
Dabei werden die folgenden Parameter zurückgeliefert:
| Parameter | Beschreibung | Beispiel |
|---|---|---|
| MachineNumber | Maschinennummer | 0-201-10-3645 |
| MachineName | Maschinenname | CENTATEQ E-310 | 0-201-10-3645 |
Zugriff auf Liste der Parameter
Der Endpunkt gibt eine Liste der Merkmale zurück, die in den letzten 90 Tagen für eine bestimmte Maschine aufgetreten sind. Diese Schlüsselbegriffe stehen zur genaueren Abfrage bereit und umfassen bspw. den aktuellen Status, die Maschinenidentifikation oder Teilezähler.
Für eine ausgewählte Maschine, wird daher der Parameter nodes zurückgegeben:
| Parameter | Beschreibung | Beispiel |
|---|---|---|
| nodes | Liste der Node-Namen | HOMAG.Machines.Applications.MMR_V1.CurrentState Machines.State.Machine.Flags.Alarm |
Node-Liste
Zugriff auf aktuelle und historische Daten
Die Endpunkte ermöglichen den Abruf aktueller und historischer Daten auf der Grundlage der über die Node-Liste identifizierten Merkmale.
Sie haben die Möglichkeit, Werte für den aktuellen Zeitpunkt, für einen bestimmten Zeitraum in der Vergangenheit oder für die gesamten letzten 90 Tage abzufragen.
Neben den Informationen, die in der Node-List enthalten sind, werden bei diesen Abfragen die folgenden Parameter bereitgestellt:
| Parameter | Beschreibung | Beispiel |
|---|---|---|
| node | Nodename | HOMAG.Machines.Applications.MMR_V1.CurrentState |
| value | Wert des Node | IdleTime_Unknown |
| timestamp | Zeitstempel, wann der Wert gemeldet wurde in UCT | 2025-02-05T14:06:29.7050781Z |
Historie einer Maschine der letzten 90 Tage
Aktueller Maschinenzustand
Zugriff auf Warnungen
Der Endpunkt gibt für eine ausgewählte Maschine eine Übersicht aller Warnungen aus, die innerhalb eines festgelegten Zeitraums aufgetreten sind.
| Parameter | Beschreibung | Beispiel |
|---|---|---|
| startTime | Datum und Uhrzeit des Alarmstarts | 2025-03-17T09:07:24.3381216+01:00 |
| endTime | Datum und Uhrzeit des Alarmendes | 2025-04-04T14:47:03.1261478+02:00 |
| InstanceId | Maschineninstanz | a046d757-988e-42b5-a1d5-6519a841dc3c |
| machineNumber | Maschinennummer | t200695809 |
| severity | Schadensausmaß Nummer zwischen 1 (niedrig) und 1000 (hoch) | 1000 |
| localizedSource | Quelle des Events in mehreren Sprachen | Edge magazine 1 left (M1-C1-MU_301L) |
| localizedMessage | Beschreibung des Events in mehreren Sprachen | Laser entriegelt Laser unlocked |
| category | Kategorie des Events | Fault |
| sourceClass | Technischer Ursprung des Events | 10_DL_MU_30X |
| sourceInstance | Instanz der Ursache (können mehrere sein) | M1-C1-MU_301L |
| sourceMessageId | Interne MessageId | 352 |
| causality | Grund für den Alarm | Unknown |
Historie der Warnungen