-
Notifications
You must be signed in to change notification settings - Fork 7
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
doc(GMS): Adds Geometrical Measuring Systems (GMS)
doc(GMS): Updates after 01/26/2022 JWG doc(GMS): Updates after 02/09/2022 JWG Results - Updated label "File" to "Files" (OPC UA variable is an array) - Display multiple files (maximum 3, the rest is hidden by default) - Display URLs as a link - Updated label "Format" to "Formats" (OPC UA variable is an array) - Display multiple formats (maximum 3, the rest is hidden by default) - Updated table header "Upper Thresh" to "Upper Limit" - Updated table header "Lower Thresh" to "Lower Limit" Calibration Information - Updated label "File" to "Files" (OPC UA variable is an array) - Display multiple files (maximum 3, the rest is hidden by default) - Display URLs as a link - The missing OPC UA variable "CalibationCertificate" was not yet in the NodeSet and will be added doc(GMS): Updated variables for results
- Loading branch information
1 parent
544bfe6
commit 309c811
Showing
12 changed files
with
131 additions
and
3 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,122 @@ | ||
# umati showcase information model for Geometrical Measuring Systems | ||
|
||
In the following the umati showcase describes the additional information on top of the [OPC 40210 UA for Geometrical Measuring Systems](https://) companion specification. | ||
|
||
Please refer to the provided xml-Nodesets or UaModeler-project for exemplary implementation. | ||
|
||
The following describes the umati showcase information model for Geometrical Measuring Systems. | ||
|
||
For participants that are familiar with the information model, we have included comments and descriptions about changes between the release candidate information model and the showcase information model. | ||
|
||
All participants not familiar with the release candidate information model do not need to review these changes in detail but rather follow the described model and refer to the provided xml Nodeset files and UA modeler project. | ||
|
||
## NodeSets for the showcase | ||
|
||
[Release Candidate NodeSet](https://github.com/umati/Sample-Server/tree/dev_gms/model/GMS) | ||
|
||
## 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 will need to browse Instances or translate BrowsePaths find the NodeID for accessing the address space and available instances. | | ||
| --- | --- | | ||
|
||
### Identification data | ||
|
||
The identification for machine tools 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**](https://reference.opcfoundation.org/Machinery/docs/8.6/) | ||
|
||
| **Attribute** | **Value** | | | | | | ||
| --- | --- | --- | --- | --- | --- | | ||
| BrowseName | MachineIdentificationType | | ||
| IsAbstract | False | | ||
| Description | Contains information about the identification and nameplate of a machine | | ||
| | | | | | | | ||
| **References** | **Node Class** | **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 | **M**, 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](../Dashboard.md#location-of-fair-machine-and-software-icons-on-the-dashboard) to place a map icon for the machine. | ||
|
||
#### FAIR Shortnames | ||
|
||
Fair shortnames are defined [here.](Fairs.md) | ||
|
||
### Adaption of the provided information models for your purpose | ||
|
||
- The provided NodeSet contains the address space with the ObjectTypes, VariableTypes and DataTypes of the Geometrical Measuring Systems companion specificaion 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](https://en.wikipedia.org/wiki/Uniform_Resource_Identifier). In the case of a website as a URI, it is not necessary that the website 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 NamespaceURI after being integrated to the datahub by addition of a suffix to ensure unique namespaces. | ||
|
||
## Value mapping between OPC UA companion specification and umati.app Geometrical Measuring Systems | ||
|
||
### Geometrical Measuring Systems - Overview | ||
|
||
![Overview](../img/GeometricalMeasuringSystems/GMS-Overview.png "GMS Overview") | ||
|
||
### Active Program Statusbar | ||
|
||
For the status overview in the dashboard, the *State* of the *ProductionActiveProgramType* 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 | Color | | ||
| --- | --- | | ||
| Initializing | ⚪ Gray | | ||
| Running | 🟢 Green | | ||
| Ended | 🔵 Cyan | | ||
| Interrupted | 🟠 Orange | | ||
| Aborted | 🔴 Red | | ||
| 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. | ||
|
||
### Geometrical Measuring Systems - Identification | ||
|
||
![Identification](../img/GeometricalMeasuringSystems/GMS-Identification.png "GMS Identification") | ||
|
||
### Geometrical Measuring Systems - Active Program | ||
|
||
![ActiveProgram](../img/GeometricalMeasuringSystems/GMS-ActiveProgram.png "GMS ActiveProgram") | ||
|
||
### Geometrical Measuring Systems - Monitoring (Machine Tool / Channel) | ||
|
||
![Monitoring](../img/GeometricalMeasuringSystems/GMS-Monitoring.png "GMS Monitoring Machine Tool / Channel") | ||
|
||
### Geometrical Measuring Systems - Monitoring (Working Units) | ||
|
||
![MonitoringWorkingUnits](../img/GeometricalMeasuringSystems/GMS-Monitoring-WorkingUnit.png "GMS Monitoring Working Units") | ||
|
||
### Geometrical Measuring Systems - Results | ||
|
||
![Results](../img/GeometricalMeasuringSystems/GMS-Results.png "GMS Results") | ||
|
||
### Geometrical Measuring Systems - Calibration Information | ||
|
||
![CalibrationInformation](../img/GeometricalMeasuringSystems/GMS-CalibrationInformation.png "GMS Calibration Information") |
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters