Documentation Index

Fetch the complete documentation index at: https://docs.homag.cloud/llms.txt

Use this file to discover all available pages before exploring further.

HOMAG Connect Machine Data

Prev Next

Ü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

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

Historie einer Maschine der letzten 90 Tage

Aktueller Maschinenzustand

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

Historie der Warnungen