diff --git a/Readme.md b/Readme.md index 64c7496..dc9093b 100644 --- a/Readme.md +++ b/Readme.md @@ -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) diff --git a/Specs.md b/Specs.md index 5931716..b1415d9 100644 --- a/Specs.md +++ b/Specs.md @@ -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) diff --git a/Specs/Fairs.md b/Specs/Fairs.md index a14171e..1df32ca 100644 --- a/Specs/Fairs.md +++ b/Specs/Fairs.md @@ -11,3 +11,4 @@ | GRIND | 2022 | GrindingHub Stuttgart 2022 | | | AMB | 2022 | AMB Stuttgart 2022 | | | METAV | 2022 | METAV 2022 | | +| CTRL | 2022 | Control Stuttgart 2022 | | diff --git a/Specs/GeometricalMeasuringSystems.md b/Specs/GeometricalMeasuringSystems.md new file mode 100644 index 0000000..59379be --- /dev/null +++ b/Specs/GeometricalMeasuringSystems.md @@ -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./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") diff --git a/img/GeometricalMeasuringSystems/GMS-ActiveProgram.png b/img/GeometricalMeasuringSystems/GMS-ActiveProgram.png new file mode 100644 index 0000000..abc7450 Binary files /dev/null and b/img/GeometricalMeasuringSystems/GMS-ActiveProgram.png differ diff --git a/img/GeometricalMeasuringSystems/GMS-CalibrationInformation.png b/img/GeometricalMeasuringSystems/GMS-CalibrationInformation.png new file mode 100644 index 0000000..ab0b1d9 Binary files /dev/null and b/img/GeometricalMeasuringSystems/GMS-CalibrationInformation.png differ diff --git a/img/GeometricalMeasuringSystems/GMS-Identification.png b/img/GeometricalMeasuringSystems/GMS-Identification.png new file mode 100644 index 0000000..a308e74 Binary files /dev/null and b/img/GeometricalMeasuringSystems/GMS-Identification.png differ diff --git a/img/GeometricalMeasuringSystems/GMS-Monitoring-WorkingUnit.png b/img/GeometricalMeasuringSystems/GMS-Monitoring-WorkingUnit.png new file mode 100644 index 0000000..76f74a6 Binary files /dev/null and b/img/GeometricalMeasuringSystems/GMS-Monitoring-WorkingUnit.png differ diff --git a/img/GeometricalMeasuringSystems/GMS-Monitoring.png b/img/GeometricalMeasuringSystems/GMS-Monitoring.png new file mode 100644 index 0000000..10e99ac Binary files /dev/null and b/img/GeometricalMeasuringSystems/GMS-Monitoring.png differ diff --git a/img/GeometricalMeasuringSystems/GMS-Overview.png b/img/GeometricalMeasuringSystems/GMS-Overview.png new file mode 100644 index 0000000..8da5de7 Binary files /dev/null and b/img/GeometricalMeasuringSystems/GMS-Overview.png differ diff --git a/img/GeometricalMeasuringSystems/GMS-Results.png b/img/GeometricalMeasuringSystems/GMS-Results.png new file mode 100644 index 0000000..9ae1dcf Binary files /dev/null and b/img/GeometricalMeasuringSystems/GMS-Results.png differ diff --git a/index.md b/index.md index 0556a47..a73333b 100644 --- a/index.md +++ b/index.md @@ -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) @@ -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 @@ -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