umati showcase specification


This provides the specification to connect to the umati showcase

View the Project on GitHub umati/Showcase

umati showcase information model for Plastics and Rubber machines OPC 40082-3

1. General

The namespace for the instances is manufacturer specific, e.g.

Table 2 shows the complete structure of the instance needed for the umati demonstrator. The demonstrator requires, that all mandatory elements of the LDD_InterfaceType are existent, even if there are not displayed in the dashboard. If the value of a variable a not displayed, is can be filled with a static dummy value (e.g. empty string). All displayed values are marked in bold.

Important: In OPC 40082-2 it is defined, that the instance of the LDD_InterfaceType is located under the Object DeviceSet. For umati it is necessary to add it under the Machines folder defined by OPC UA for machinery. In practice it is not necessary to create a new instance. It is sufficient to have an Organizes Reference from the Machines folder to the instance located under DeviceSet.

OPC 40082-3 Overview

In addition, OPC 40082-3 uses the MachineInformationType defined in OPC 40083. For participation in the umati demonstrator it is necessary to create in parallel an instance of the MachineIdentificationType defined in OPC UA for Machinery.

Download: Compleate documentation umati showcase information model Plastics and Rubber

Table 1 – Namespaces used in this document

NamespaceURI Namespace Index Example 0 0:NodeVersion 1 Default namespace of OPC 40082-3 –> no prefix used, e.g. LDS_InterfaceType 2 2:DeviceClass 3 3:MachineInformationType 4 4:MachineIdentificationType

Table 2 – Sample instance of LDS_InterfaceType

BrowseName Type Example Value Remarks
   LDS_<Manufacturer>_<SerialNumber> LDS_InterfaceType    
    2:Identification 4:MachineIdentificationType   1)
     2:ProductInstanceUri 2)
     2:Manufacturer 0:LocalizedText “Sample Manufacturer”  
     2:Model 0:LocalizedText “LDS 3000” 3)
     2:SerialNumber 0:String “1234”  
     2:DeviceClass 0:String “LSR Dosing System”  
     4:Location 0:String “K 14 F42/N 51.260407 E 6.744588” 3), 4)
    Identification 3:IdentificationType   2)
     2:DeviceClass 0:String “LSR Dosing System” 2)
     2:Manufacturer 0:LocalizedText “Sample Manufacturer” 2)
     2:Model 0:LocalizedText “LDS 3000” 2)
     2:SerialNumber 0:String “1234” 2)
    MachineConfiguration 3:MachineConfigurationType   2)
     3:UserMachineName 0:String “My LDS” 2)
     3:LocationName 0:String “K 14 F42/N 51.260407 E 6.744588” 2)
     3:TimeZoneOffset 0:TimeZoneDataType <p>offset: 0</p><p>daylightSavingInOffset: true</p> 2)
    Operation OperationType    
     ActivateRemoteControl 0:MultiStateValueDiscreteType 1 (= SEPARATE_INTERFACE) 2)
     ActiveErrors 3:ClassifiedActiveErrorDataType empty array / NULL 2)
     DeliveryPressure 3:ControlledParameterType    
      ActualValue 0:AnalogItemType à 0:Double 2.4  
       EURange 0:Range <p>Low: 0</p><p>High: 40</p>  
       EngineeringUnits 0:EUInformation <p>namespaceUri: “”</p><p>unitId: 4342098</p><p>displayName: “bar”</p><p>description: “bar [unit of pressure]”</p>  
     DeliveryType 0:MultiStateValueDiscreteType 0 (= PRESSURE) 2)
     DeviceMappingNumber 0:UInt32 1 2)
     HighestAlarmSeverity 0:UInt16 0 2)
     MaterialBalanceSystemType MaterialBalanceSystemType
     RemoteControlActivated 0:MultiStateValueDiscreteType 1 (= SEPARATE_INTERFACE) 2)
     Component_A ComponentType    
      Status ComponentStatusEnumeration 0 (= GOOD)  
     Component_B ComponentType    
      Status ComponentStatusEnumeration 0 (= GOOD)  

1) Not included in OPC 40084-3 LDS_InterfaceType. To be added in the instance 2) This variable is mandatory in the model but will not be displayed in the demonstrator 3) Not mandatory in OPC UA for Machinery but for this model and will be displayed in the demonstrator 4) See for rules for filling the location.