The HOMAG Connect Machine Data interface gives you direct access to the raw data of your machines via a cloud interface. This 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 evaluate the data with analysis tools such as Excel or Power BI and adapt and visualize it according to your requirements.
The interface provides additional data in addition to the data in the OPC UA Woodworking Companion Specification. OPC UA (Open Platform Communications Unified Architecture) is an interface standard that ensures the standardized transmission of machine data in the furniture industry and thus ensures interoperability between machines from different manufacturers. The official description of the specification can be found here.
The HOMAG Connect Machine Data interface can be used to provide general information such as e.g. Machine identification, machine status, error and warning messages of the machine can be retrieved. It also provides access to the unprocessed data from the HOMAG MMR, e.g. Provide information about machine health, condition and part counters, as well as maintenance and shift information. In principle, 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 of individual machine components, which can vary.
The interface is available as a paid add-on for MMR for new machines built from 2024 onwards. How to authenticate to use the interface is described in the Authentication section.
Access to machine list
The endpoint provides an overview of all machines that are assigned to your customer environment and have a license for the HOMAG Connect Machine Data interface.
The following parameters are returned:
Parameters | Description | Example |
|---|---|---|
MachineNumber | Machine number | 0-201-10-3645 |
MachineName | Machine Name | CENTATEQ E-310 | 0-201-10-3645 |
Accessing List of Parameters
The endpoint returns a list of characteristics that have occurred in the last 90 days for a given machine. These key terms are available for more detailed queries and include, for example: the current status, machine identification or part counter.
Therefore, for a selected machine, the nodes parameter is returned:
Parameters | 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 allow the retrieval of current and historical data based on the characteristics identified via the node list.
You can query values for the current time, for a specific period in the past, or for the entire last 90 days.
In addition to the information contained in the node list, these queries provide the following parameters:
Parameters | Description | Example |
|---|---|---|
node | Nodename | HOMAG. Machines.Applications.MMR_V1. CurrentState |
value | Value of the node | IdleTime_Unknown |
Timestamp | Timestamp of when the value was reported in UCT | 2025-02-05T14:06:29.7050781Z |
History of a machine from the last 90 days
Current machine condition
Access to alerts
The endpoint gives a summary of all alerts that occurred within a specified time period for a selected machine.
Parameters | Description | Example |
|---|---|---|
startTime | Date and time of alarm start | 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 damage 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 unlocked |
Category | Category of the event | Fault |
sourceClass | Technical origin of the event | 10_DL_MU_30X |
sourceInstance | Instance of the cause (can be several) | M1-C1-MU_301L |
sourceMessageId | Internal MessageId | 352 |
causality | Reason for the alarm | Unknown |
History of Alerts