Skip to content

Commit

Permalink
doc(GMS): Adds Geometrical Measuring Systems (GMS)
Browse files Browse the repository at this point in the history
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
karstenroethig authored and GoetzGoerisch committed Mar 3, 2022
1 parent 544bfe6 commit 309c811
Show file tree
Hide file tree
Showing 12 changed files with 131 additions and 3 deletions.
3 changes: 2 additions & 1 deletion Readme.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,8 @@ To learn more please visit [https://umati.org](https://umati.org)
- [Implemented Specifications](Specs.md)
- [MachineTool](Specs/MachineTool.md)
- [Software Solutions](Specs/Software.md)
- [Woodworking](Specs/Woodworking.md)
- [WoodWorking](Specs/Woodworking.md)
- [Geometrical Measuring Systems](Specs/GeometricalMeasuringSystems.md)
- Upcoming Specifications
- [Robotics](Specs/WIP.md)
- [PlasticsRubber](Specs/WIP.md)
Expand Down
1 change: 1 addition & 0 deletions Specs.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,4 +2,5 @@

- [OPC 40501-1 UA for MachineTool](Specs/MachineTool.md)
- [OPC 40550 UA for Woodworking](Specs/Woodworking.md)
- [OPC 40210 UA for Geometrical Measuring Systems](Specs/GeometricalMeasuringSystems.md)
- [Software Solutions](Specs/Software.md)
1 change: 1 addition & 0 deletions Specs/Fairs.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,3 +11,4 @@
| GRIND | 2022 | GrindingHub Stuttgart 2022 | <https://www.grindinghub.de/> |
| AMB | 2022 | AMB Stuttgart 2022 | <https://www.messe-stuttgart.de/amb/> |
| METAV | 2022 | METAV 2022 | <https://metav.de> |
| CTRL | 2022 | Control Stuttgart 2022 | <https://www.control-messe.de/> |
122 changes: 122 additions & 0 deletions Specs/GeometricalMeasuringSystems.md
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 | &#9898; Gray |
| Running | &#128994; Green |
| Ended | &#128309; Cyan |
| Interrupted | &#128992; Orange |
| Aborted | &#128308; Red |
| Any other (unspecified) state | &#9899; 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.
Binary file added img/GeometricalMeasuringSystems/GMS-Overview.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added img/GeometricalMeasuringSystems/GMS-Results.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
7 changes: 5 additions & 2 deletions index.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,8 @@ To learn more please visit [https://umati.org](https://umati.org)
- [Implemented Specifications](Specs.md)
- [MachineTool](Specs/MachineTool.md)
- [Software Solutions](Specs/Software.md)
- [Woodworking](Specs/Woodworking.md)
- [WoodWorking](Specs/Woodworking.md)
- [Geometrical Measuring Systems](Specs/GeometricalMeasuringSystems.md)
- Upcoming Specifications
- [Robotics](Specs/WIP.md)
- [PlasticsRubber](Specs/WIP.md)
Expand All @@ -44,7 +45,8 @@ This documentation is versioned, as some content details will be delivered later
| v1.02.3 | 18.02.2021 | Update on Machine Tools and Software Solutions |
| v1.03.0 | 21.05.2021 | Complete update to latest developments |
| v1.04.0 | 03.09.2021 | Addition of Woodworking companion specification |
| v1.04.1 | 08.02.2022 | Updates to Machine Tools, Woodworking|
| v1.04.1 | 08.02.2022 | Updates to Machine Tools, Woodworking |
| v1.05.0 | 03.03.2022 | Integrates Geomentrical Measuring Systems |

### Changelog

Expand All @@ -64,6 +66,7 @@ This documentation is versioned, as some content details will be delivered later
| [Organizational Information](Organization.md) | Timeline | Removed the obsolete timeline for a 2020 showcase | [2416d15](https://github.com/umati/Showcase/commit/2416d1569cc43267d86530a934dcab267833d7fb) |
| [MachineTool](Specs/MachineTool.md) | Links | Updates broken links | [5e1af5c](https://github.com/umati/Showcase/commit/5e1af5ce1649addc68d87b87dd1323806a9194e3) |
| [Woodworking](Specs/Woodworking.md) | Links | Updates broken links | [5e1af5c](https://github.com/umati/Showcase/commit/5e1af5ce1649addc68d87b87dd1323806a9194e3) |
| [Geometrical Measuring Systems](Specs/GeometricalMeasuringSystems.md) | GMS | Adds specification page | |

## Demonstrator story umati showcase

Expand Down

0 comments on commit 309c811

Please sign in to comment.