Skip to main content
Version: 2.7

HumanOS MDE Model

This chapter specifies the basic MDE interface. An extended MDE interface is conceivable in the future.

DataNodes

The following data nodes must always be present so that a device has a valid MDE interface. If the controller does not allow to read the data item, the state is BadNotActive.

AlarmState

General informations:

InformationDescription
Content of valueController specific alarm state id
Group in Device.jsonroot/Controller

Data Node settings:

SettingValue
NameAlarmState
Data classEvent
Data typeSystem.Int32
Unit
Mandatory data accessread, receive
Default history accessdisabled

Mandatory properties:

Property NameData TypeValueDescription
PortMatchIdSystem.StringAlarmStateTypeProcessing port match id.

Available

General informations:

InformationDescription
Content of value0 = unavailable, 1 = available
Group in Device.jsonroot

Data Node settings:

SettingValue
NameAvailable
Data classEvent
Data typeSystem.Int32
Unit
Mandatory data accessread, receive
Default history accessdisabled

Mandatory properties:

Property NameData TypeValueDescription
EnableAzureIoTSystem.BooleantrueEnables the datanode for azure IoT client data logger plugin
EnableInfluxSystem.BooleantrueEnables the datanode for influx database data logger plugin
EnableMqttSystem.BooleantrueEnables the datanode for mqtt data logger plugin
EnableRestSystem.BooleantrueEnables the datanode for rest data logger plugin
EnableRmqSystem.BooleantrueEnables the datanode for rabbit message queue data logger plugin
mtc:DataItemIdSystem.StringLavailMtConnect data item id availability
mtc:InformationTypeSystem.StringAVAILABILITYMtConnect information type availability
mtc:ValuesSystem.String1=AVAILABLE;*=NOT_AVAILABLEMtConnect value mapping for availability
PortMatchIdSystem.StringAvailableTypeProcessing port match id.

CurrentFeed

General informations:

InformationDescription
Content of valueCurrent feed
Group in Device.jsonroot/Controller/NCPath(x)

Data Node settings:

SettingValue
NameCurrentFeed
Data classStream
Data typeSystem.Double
Unitmm/min
Mandatory data accessread, receive
Default history accessdisabled

Mandatory properties:

Property NameData TypeValueDescription
mtc:DataItemIdSystem.StringcfMtConnect data item id current feed
mtc:InformationSubTypeSystem.StringACTUALMtConnect information sub type current feed
mtc:InformationTypeSystem.StringPATH_FEEDRATEMtConnect information type current feed

CurrentNcBlock

General informations:

InformationDescription
Content of valueCurrent NC Block line of the executing program
Group in Device.jsonroot/Controller/NCPath(x)

Data Node settings:

SettingValue
NameCurrentNcBlock
Data classEvent
Data typeSystem.String
Unit
Mandatory data accessread, receive
Default history accessdisabled

There are no mandatory properties for the data node CurrentNcBlock.

CurrentProgram

General informations:

InformationDescription
Content of valueName of the current program specified by controller
Group in Device.jsonroot/Controller/NCPath(x)

Data Node settings:

SettingValue
NameCurrentProgram
Data classEvent
Data typeSystem.String
Unit
Mandatory data accessread, receive
Default history accessdisabled

Mandatory properties:

Property NameData TypeValueDescription
mtc:DataItemIdSystem.StringLpprogramMtConnect data item id program
mtc:InformationSubTypeSystem.Stringx:ACTUALMtConnect information sub type actual program
mtc:InformationTypeSystem.StringPROGRAMMtConnect information type program
PortMatchIdSystem.StringCurrentProgramTypeProcessing port match id.

CurrentSequenceNr

General informations:

InformationDescription
Content of valueCurrent sequence number of the executing program
Group in Device.jsonroot/Controller/NCPath(x)

Data Node settings:

SettingValue
NameCurrentSequenceNr
Data classEvent
Data typeSystem.String
Unit
Mandatory data accessread, receive
Default history accessdisabled

Mandatory properties:

Property NameData TypeValueDescription
mtc:DataItemIdSystem.StringseqMtConnect data item id sequence number
mtc:InformationTypeSystem.StringSEQUENCE_NUMBERMtConnect information type sequence number

CurrentSpindleSpeed

General informations:

InformationDescription
Content of valueCurrent spindle speed
Group in Device.jsonroot/Controller/NCPath(x)

Data Node settings:

SettingValue
NameCurrentSpindleSpeed
Data classStream
Data typeSystem.Double
Unit1/min
Mandatory data accessread, receive
Default history accessdisabled

Mandatory properties:

Property NameData TypeValueDescription
mtc:DataItemIdSystem.StringSrpmMtConnect data item id current spindle speed
mtc:InformationSubTypeSystem.StringACTUALMtConnect information sub type current spindle speed
mtc:InformationTypeSystem.StringROTARY_VELOCITYMtConnect information type current spindle speed

CurrentToolId

General informations:

InformationDescription
Content of valueCurrent tool identifier
Group in Device.jsonroot/Controller/NCPath(x)

Data Node settings:

SettingValue
NameCurrentToolId
Data classEvent
Data typeSystem.String
Unit
Mandatory data accessread, receive
Default history accessdisabled

Mandatory properties:

Property NameData TypeValueDescription
mtc:DataItemIdSystem.StringtidMtConnect data item id current tool id
mtc:InformationTypeSystem.StringTOOL_NUMBERMtConnect information type current tool id

CuttingTime

General informations:

InformationDescription
Content of valuetotal time the machine was cutting
Group in Device.jsonroot/Controller

Data Node settings:

SettingValue
NameCuttingTime
Data classStream
Data typeSystem.Double
Unitmin
Mandatory data accessread, receive
Default history accessdisabled

Mandatory properties:

Property NameData TypeValueDescription
mtc:DataItemIdSystem.StringtcltimeMtConnect data item id cutting time
mtc:InformationSubTypeSystem.Stringx:TOTALCUTTIMEMtConnect information sub type cutting time
mtc:InformationTypeSystem.StringACCUMULATED_TIMEMtConnect information type cutting time

FeedrateOverride

General informations:

InformationDescription
Content of valueFeedrate override potentiometer percent
Group in Device.jsonroot/Controller

Data Node settings:

SettingValue
NameFeedrateOverride
Data classEvent
Data typeSystem.Double
Unit%
Mandatory data accessread, receive
Default history accessdisabled

Mandatory properties:

Property NameData TypeValueDescription
mtc:DataItemIdSystem.StringLpFovrMtConnect data item id feedrate override
mtc:InformationTypeSystem.StringPATH_FEEDRATE_OVERRIDEMtConnect information type feedrate override
PortMatchIdSystem.StringFeedrateOverrideTypeProcessing port match id.

MainProgram

General informations:

InformationDescription
Content of valueName of the main program specified by controller
Group in Device.jsonroot/Controller/NCPath(x)

Data Node settings:

SettingValue
NameMainProgram
Data classEvent
Data typeSystem.String
Unit
Mandatory data accessread, receive
Default history accessdisabled

Mandatory properties:

Property NameData TypeValueDescription
EnableAzureIoTSystem.BooleantrueEnables the datanode for azure IoT client data logger plugin
EnableInfluxSystem.BooleantrueEnables the datanode for influx database data logger plugin
EnableMqttSystem.BooleantrueEnables the datanode for mqtt data logger plugin
EnableRestSystem.BooleantrueEnables the datanode for rest data logger plugin
EnableRmqSystem.BooleantrueEnables the datanode for rabbit message queue data logger plugin
PortMatchIdSystem.StringMainProgramTypeProcessing port match id.

MainProgramHeader

General informations:

InformationDescription
Content of valueHeader of the main program
Group in Device.jsonroot/Controller/NCPath(x)

Data Node settings:

SettingValue
NameMainProgramHeader
Data classEvent
Data typeSystem.String
Unit
Mandatory data accessread, receive
Default history accessdisabled

Mandatory properties:

Property NameData TypeValueDescription
mtc:IgnoreSystem.BooleantrueDisables the node for MtConnect
PortMatchIdSystem.StringMainProgramHeaderTypeProcessing port match id.

OperationMode

General informations:

InformationDescription
Content of valueController specific operation mode id (mdi, manual, auto, ...)
Group in Device.jsonroot/Controller

Data Node settings:

SettingValue
NameOperationMode
Data classEvent
Data typeSystem.Int32
Unit
Mandatory data accessread, receive
Default history accessdisabled

Mandatory properties:

Property NameData TypeValueDescription
EnableAzureIoTSystem.BooleantrueEnables the datanode for azure IoT client data logger plugin
EnableInfluxSystem.BooleantrueEnables the datanode for influx database data logger plugin
EnableMqttSystem.BooleantrueEnables the datanode for mqtt data logger plugin
EnableRestSystem.BooleantrueEnables the datanode for rest data logger plugin
EnableRmqSystem.BooleantrueEnables the datanode for rabbit message queue data logger plugin
mtc:DataItemIdSystem.StringLpmodeMtConnect data item id controller mode
mtc:InformationTypeSystem.StringCONTROLLER_MODEMtConnect information type controller mode
mtc:ValuesSystem.String(x)=MANUAL_DATA_INPUT;(x)=AUTOMATIC;*=MANUALMtConnect value mapping for controller mode. CAUTION: (x) must equal the operation mode number of the controller
PortMatchIdSystem.StringOperationModeTypeProcessing port match id.

OperationTime

General informations:

InformationDescription
Content of valuetotal time a program was running
Group in Device.jsonroot/Controller

Data Node settings:

SettingValue
NameOperationTime
Data classStream
Data typeSystem.Double
Unitmin
Mandatory data accessread, receive
Default history accessdisabled

Mandatory properties:

Property NameData TypeValueDescription
mtc:DataItemIdSystem.StringatimeMtConnect data item id operation time
mtc:InformationSubTypeSystem.Stringx:AUTOMtConnect information sub type operation time
mtc:InformationTypeSystem.StringACCUMULATED_TIMEMtConnect information type operation time

PartCounter

General informations:

InformationDescription
Content of valuetotal number of machined parts
Group in Device.jsonroot/Controller

Data Node settings:

SettingValue
NamePartCounter
Data classEvent
Data typeSystem.Int32
Unit
Mandatory data accessread, receive
Default history accessdisabled

Mandatory properties:

Property NameData TypeValueDescription
EnableAzureIoTSystem.BooleantrueEnables the datanode for azure IoT client data logger plugin
EnableInfluxSystem.BooleantrueEnables the datanode for influx database data logger plugin
EnableMqttSystem.BooleantrueEnables the datanode for mqtt data logger plugin
EnableRestSystem.BooleantrueEnables the datanode for rest data logger plugin
EnableRmqSystem.BooleantrueEnables the datanode for rabbit message queue data logger plugin
mtc:DataItemIdSystem.StringpcMtConnect data item id part counter
mtc:InformationTypeSystem.StringPART_COUNTMtConnect information type part counter
PortMatchIdSystem.StringPartCounterTypeProcessing port match id.

PowerOnTime

General informations:

InformationDescription
Content of valuetotal time the controller was switched on
Group in Device.jsonroot/Controller

Data Node settings:

SettingValue
NamePowerOnTime
Data classStream
Data typeSystem.Double
Unitmin
Mandatory data accessread, receive
Default history accessdisabled

Mandatory properties:

Property NameData TypeValueDescription
mtc:DataItemIdSystem.StringyltimeMtConnect data item id power on time
mtc:InformationSubTypeSystem.Stringx:TOTALMtConnect information sub type power on time
mtc:InformationTypeSystem.StringACCUMULATED_TIMEMtConnect information type power on time

ProgrammedFeed

General informations:

InformationDescription
Content of valueProgrammed feed
Group in Device.jsonroot/Controller/NCPath(x)

Data Node settings:

SettingValue
NameProgrammedFeed
Data classEvent
Data typeSystem.Double
Unitmm/min
Mandatory data accessread, receive
Default history accessdisabled

Mandatory properties:

Property NameData TypeValueDescription
mtc:DataItemIdSystem.StringpfMtConnect data item id programmed feedrate
mtc:InformationSubTypeSystem.StringCOMMANDEDMtConnect information sub type programmed feedrate
mtc:InformationTypeSystem.StringPATH_FEEDRATEMtConnect information type programmed feedrate

ProgrammedSpindleSpeed

General informations:

InformationDescription
Content of valueProgrammed spindle speed
Group in Device.jsonroot/Controller/NCPath(x)

Data Node settings:

SettingValue
NameProgrammedSpindleSpeed
Data classEvent
Data typeSystem.Double
Unit1/min
Mandatory data accessread, receive
Default history accessdisabled

Mandatory properties:

Property NameData TypeValueDescription
mtc:DataItemIdSystem.StringpsrpmMtConnect data item id programmed spindle speed
mtc:InformationSubTypeSystem.StringCOMMANDEDMtConnect information sub type programmed spindle speed
mtc:InformationTypeSystem.StringROTARY_VELOCITYMtConnect information type programmed spindle speed

RunningState

General informations:

InformationDescription
Content of valueController specific running state id of cnc program (stopped, running, hold)
Group in Device.jsonroot/Controller

Data Node settings:

SettingValue
NameRunningState
Data classEvent
Data typeSystem.Int32
Unit
Mandatory data accessread, receive
Default history accessdisabled

Mandatory properties:

Property NameData TypeValueDescription
EnableAzureIoTSystem.BooleantrueEnables the datanode for azure IoT client data logger plugin
EnableInfluxSystem.BooleantrueEnables the datanode for influx database data logger plugin
EnableMqttSystem.BooleantrueEnables the datanode for mqtt data logger plugin
EnableRestSystem.BooleantrueEnables the datanode for rest data logger plugin
EnableRmqSystem.BooleantrueEnables the datanode for rabbit message queue data logger plugin
mtc:DataItemIdSystem.StringLpexecutionMtConnect data item id execution
mtc:InformationTypeSystem.StringEXECUTIONMtConnect information type execution
mtc:ValuesSystem.String(x)=FEED_HOLD;x=ACTIVE;*=PROGRAM_STOPPEDMtConnect value mapping for running state. CAUTION: (x) must equal the running state number of the controller
PortMatchIdSystem.StringTypeProcessing port match id.

SignOfLife

General informations:

InformationDescription
Content of value0 or 1, alternately in 1Hz cycle
Group in Device.jsonroot

Data Node settings:

SettingValue
NameSignOfLife
Data classEvent
Data typeSystem.Int32
Unit
Mandatory data accessread, receive
Default history accessdisabled

Mandatory properties:

Property NameData TypeValueDescription
EnableAzureIoTSystem.BooleantrueEnables the datanode for azure IoT client data logger plugin
EnableInfluxSystem.BooleantrueEnables the datanode for influx database data logger plugin
EnableMqttSystem.BooleantrueEnables the datanode for mqtt data logger plugin
EnableRestSystem.BooleantrueEnables the datanode for rest data logger plugin
EnableRmqSystem.BooleantrueEnables the datanode for rabbit message queue data logger plugin

SpindleOverride

General informations:

InformationDescription
Content of valueSpindle rotational speed override potentiometer percent
Group in Device.jsonroot/Controller

Data Node settings:

SettingValue
NameSpindleOverride
Data classEvent
Data typeSystem.Double
Unit%
Mandatory data accessread, receive
Default history accessdisabled

Mandatory properties:

Property NameData TypeValueDescription
mtc:InformationTypeSystem.StringROTARY_VELOCITY_OVERRIDEMtConnect information type spindle override
mtc:DataItemIdSystem.StringLpSovrMtConnect data item id spindle override
PortMatchIdSystem.StringSpindleOverrideTypeProcessing port match id.

Other Node types

The following group nodes must always be present so that a device has a valid MDE interface.

DeviceNode

General informations:

InformationDescription
Node typeGroupNode
Group contentThis is the device node itself. Contains all nodes of the device
Group in Device.json

Data Node settings:

SettingValue
NameMust equal the name of the plugin without HumanOS.UHAL.
Default history accessdisabled

Mandatory properties:

Property NameData TypeValueDescription
DescriptionSystem.StringOEE correlation for (x) machinesDescription for the device plugin. CAUTION: (x) must be a suitable name for the controller

Controller

General informations:

InformationDescription
Node typeGroupNode
Group contentContains all datanodes of the cnc controller.
Group in Device.jsonroot

Data Node settings:

SettingValue
NameController
Default history accessdisabled

Mandatory properties:

Property NameData TypeValueDescription
mtc:ComponentIdSystem.StringLct1MtConnect component id of controller
mtc:ComponentNameSystem.StringControllerMtConnect component name of controller

NCPath(x)

General informations:

InformationDescription
Node typeGroupNode
Group contentContains all datanodes of the nc channel.
Group in Device.jsonroot

Data Node settings:

SettingValue
NameNCPath(x)
Default history accessdisabled

Mandatory properties:

Property NameData TypeValueDescription
mtc:ComponentIdSystem.StringLp(x)MtConnect component id of nc channel. CAUTION: (x) must equal the nc path index.
mtc:ComponentNameSystem.StringPathMtConnect component name of nc path

MachineAlarming

General informations:

InformationDescription
Node typeAlarmingNode
Group contentContains all alarm and event tasks.
Group in Device.jsonroot

Data Node settings:

SettingValue
NameMachineAlarming
Default history accessSamplingRate = 2000, Retention = 720

Mandatory properties:

Property NameData TypeValueDescription
EnableAzureIoTSystem.BooleantrueEnables the datanode for azure IoT client data logger plugin
EnableInfluxSystem.BooleantrueEnables the datanode for influx database data logger plugin
EnableMqttSystem.BooleantrueEnables the datanode for mqtt data logger plugin
EnableRestSystem.BooleantrueEnables the datanode for rest data logger plugin
EnableRmqSystem.BooleantrueEnables the datanode for rabbit message queue data logger plugin
mtc:DataItemIdSystem.StringLsystemMtConnect data item id system
mtc:InformationTypeSystem.StringSYSTEMMtConnect information type system
PortMatchIdSystem.StringMachineAlarmingTypeProcessing port match id.