HOMAG Connect Machine Data
Through the HOMAG Connect Machine Data interface, you gain direct access to the raw data of your machines via a cloud interface. It provides you with comprehensive information about the current condition of your machines as well as a 90-day history. This allows you to seamlessly integrate your machine data into ERP systems or industry specific solutions. Depending on your needs, you can also analyze the data using tools such as Excel or Power BI and customize and visualize it according to your requirements.
In addition to the data from the OPC UA Woodworking Companion Specification, the interface provides additional data. OPC UA (Open Platform Communications Unified Architecture) is an interface standard that ensures the standardized transmission of machine data in the furniture industry, thereby guaranteeing interoperability between machines from different manufacturers. You can find the official description of the specification here.
Through the HOMAG Connect Machine Data interface, you can retrieve general information such as machine identification, machine state, errors and warning messages from the machine. Additionally, it provides access to the raw data from HOMAG MMR, which can provide insights into the machine's condition, status and part counters, as well as maintenance and shift information. Generally, the return values are identical for all HOMAG machine types. However, depending on the machine type, there are additional specific states, such as maintenance intervals for individual machine components, which may vary.
The interface is available as a chargeable add on for MMR for all new machines built from 2024 onwards. How to authenticate yourself for the use of the interface is described in the authentication section.
Access to machine list
The endpoint provides an overview of all machines assigned to your customer environment which have a licence for the HOMAG Connect Machine Data interface.
The following parameters are returned:
| Parameter | Description | Example |
|---|---|---|
| MachineNumber | Machine number | 0-201-10-3645 |
| MachineName | Machine name | CENTATEQ E-310 | 0-201-10-3645 |
Access to parameter list
The endpoint returns a list of all features which have occured for a selected machine within the last 90 days. These key words are available for more detailed enquiry and include, for example, the current status, machine identification or parts counters.
Therefore the parameter nodes is returned for the selected machine:
| Parameter | Description | Example |
|---|---|---|
| nodes | List of node names | HOMAG.Machines.Applications.MMR_V1.CurrentState Machines.State.Machine.Flags.Alarm |
Node list
Access to current and historical data
The endpoints enable the retrieval of current and historical data based on the features identified through the node list.
You may query values for the current time, for a specific time period or for the entire last 90 days.
In addition to the information contained in the node list, the following parameters are provided:
| Parameter | Description | Example |
|---|---|---|
| node | Node name | HOMAG.Machines.Applications.MMR_V1.CurrentState |
| value | Value of the node | IdleTime_Unknown |
| timestamp | Timestamp when the value has ben reported in UCT | 2025-02-05T14:06:29.7050781Z |
History of a machine for the last 90 days
Current state of the machine
Access to warnings
The endpoint provides an overview of all warnings which have occured for a selected machine during a specific time period.
| Parameter | Description | Example |
|---|---|---|
| startTime | Date and time of the start of the alarm | 2025-03-17T09:07:24.3381216+01:00 |
| endTime | Date and time of the end of the alarm | 2025-04-04T14:47:03.1261478+02:00 |
| InstanceId | Machine instance | a046d757-988e-42b5-a1d5-6519a841dc3c |
| machineNumber | Machine number | t200695809 |
| severity | Extent of the damage measured in a number between 1 (low) and 1000 (high) | 1000 |
| localizedSource | Source of the event in several languages | Edge magazine 1 left (M1-C1-MU_301L) |
| localizedMessage | Description of the event in several languages | Laser entriegelt Laser unlocked |
| category | Category of the event | Fault |
| sourceClass | Technical source of the event | 10_DL_MU_30X |
| sourceInstance | Istance of the source (can be several) | M1-C1-MU_301L |
| sourceMessageId | Internal MessageId | 352 |
| causality | Reason for the alarm | Unknown |
History of warnings