umati showcase specification
This provides the specification to connect to the umati showcase
umati showcase information model for Laser Systems
In the following the umati showcase describes the additional information on top of the OPC 40530 UA for LaserSystems companion specification.
NodeSets
Normative NodeSet hosted by the OPC Foundation
General information valid for the umati showcase demonstration
| DISCLAIMER | For all applications the OPC UA server is to be configured without predefined NodeIds for the instances. Clients need to utilize the Services Browse and TranslateBrowsePathsToNodeIds to access nodes of interest. |
Identification data
The identification for Laser Systems are inherited from the Machinery companion specification. To fill the demo dashboard machine page with the most content the variables marked with a strong mandatory should be provided if you like to look the machine identification nicely.
MachineIdentificationType Definition
| Attribute | Value | ||||
|---|---|---|---|---|---|
| BrowseName | MachineIdentificationType | ||||
| IsAbstract | False | ||||
| Description | Contains information about the identification and nameplate of a machine | ||||
| References | NodeClass | BrowseName | DataType | TypeDefinition | Other |
| Subtype of the 2:FunctionalGroupType defined in OPC 10000-100, i.e. inheriting the InstanceDeclarations of that Node. | |||||
| 0:HasProperty | Variable | 0:DefaultInstanceBrowseName | 0:QualifiedName | 0:PropertyType | |
| 0:HasInterface | ObjectType | IMachineVendorNameplateType | |||
| 0:HasInterface | ObjectType | IMachineTagNameplateType | |||
| Applied from IMachineVendorNameplateType | |||||
| 0:HasProperty | Variable | 2:ProductInstanceUri | 0:String | 0:PropertyType | M, RO |
| 0:HasProperty | Variable | 2:Manufacturer | 0:LocalizedText | 0:PropertyType | M, RO |
| 0:HasProperty | Variable | 2:ManufacturerUri | 0:String | 0:PropertyType | O, RO |
| 0:HasProperty | Variable | 2:Model | 0:LocalizedText | 0:PropertyType | M, RO |
| 0:HasProperty | Variable | 2:ProductCode | 0:String | 0:PropertyType | M, RO |
| 0:HasProperty | Variable | 2:HardwareRevision | 0:String | 0:PropertyType | O, RO |
| 0:HasProperty | Variable | 2:SoftwareRevision | 0:String | 0:PropertyType | M, RO |
| 0:HasProperty | Variable | 2:DeviceClass | 0:String | 0:PropertyType | O, RO |
| 0:HasProperty | Variable | 2:SerialNumber | 0:String | 0:PropertyType | M, RO |
| 0:HasProperty | Variable | YearOfConstruction | UInt16 | 0:PropertyType | M, RO |
| 0:HasProperty | Variable | MonthOfConstruction | Byte | 0:PropertyType | O, RO |
| 0:HasProperty | Variable | InitialOperationDate | DateTime | 0:PropertyType | O, RO |
| Applied from IMachineTagNameplateType | |||||
| 0:HasProperty | Variable | 2:AssetId | 0:String | 0:PropertyType | O, RW |
| 0:HasProperty | Variable | 2:ComponentName | 0:LocalizedText | 0:PropertyType | O, RW |
| 0:HasProperty | Variable | Location | 0:String | 0:PropertyType | M, RW |
Special requirements for correct location of the machine icon on the dashboard
The instance Location property is evaluated according to the special requirements detailed here to place a map icon for the machine.
Adaption of the provided information models for your purpose
- The provided NodeSet contains the address space with the ObjectTypes, VariableTypes and DataTypes of the Laser Systems companion specification and must not be changed.
-
Change the URI of the instance namespace (optional, but recommended)
http://www.<MANUFACTURERDOMAIN>/example -
The rules for creating a URI can be found online. Please follow this link. In the case of a URL as a URI, it is not necessary that the site actually exists, it only identifies the machine uniquely. In order to simplify debugging it is recommended to choose a URI which allows an identification of the machine also for third persons, e.g. by including the company name.
- The machine will get a unique identifier like
clientId%3Dvdw%7Csmplsrv1%3Bnsu%3Dhttp%3A_2F_2Fwww.wenzel-group.com_2FWenzel_20LH_2087_2F%3Bi%3D66382-<clientId><mqttusername><NamespaceUri><EntryNodeId>in the MQTT tree and in the Dashboard URL.
Value mapping between OPC UA companion specification and umati.app machine instance page
Laser System - Overview
Active Program Statusbar
For the status overview in the dashboard, the StateNumber of the 4:Monitoring.LasterSystemStatus.LaserSystemStateStateMachineType.CurrentState.Number is stored and plotted over time. The status bar does NOT relate to the stacklight status!
Each status is assigned to a color, the color scheme is here (subject to change):
| State | Number | Color |
|---|---|---|
| Off | 0 | ⚪ Grey |
| EnergySaving | 1 | ⚪ Grey |
| Idle | 2 | ⚪ Grey |
| SetUp | 3 | ⚪ Grey |
| LaserReady | 4 | ⚪ Grey |
| Maintenance | 5 | ⚪ Grey |
| Error | 6 | ⚪ Grey |
| LaserOn | 7 | 🟢 Green |
| Any other (unspecified) state | ⚫ Black |
A gap is left for periods of time in which no data was recorded (e.g. machine offline). An exemplary timeline is shown above.
Laser Systems - Identification
Laser Systems- Production
Laser Systems - Monitoring
