From ab7f02929bcb5c2fff89d65c7729c318effae2c0 Mon Sep 17 00:00:00 2001 From: Goetz Goerisch <47734341+GoetzGoerisch@users.noreply.github.com> Date: Fri, 21 May 2021 15:38:09 +0200 Subject: [PATCH] Release v1.03.0 --- CLIENT.md | 8 ++++---- DASHBOARD.md | 2 +- README.md | 6 ++++++ SERVER.md | 2 +- Specs/Machinetools.md | 2 +- index.md | 10 ++++++++-- 6 files changed, 21 insertions(+), 9 deletions(-) diff --git a/CLIENT.md b/CLIENT.md index 5ef42d9..4e1f15c 100644 --- a/CLIENT.md +++ b/CLIENT.md @@ -9,13 +9,13 @@ The OPC UA endpoint of the datahub is public accessible by its DNS name. Each cl The datahub server will have the data of all connected machines in its address space. See [Aggregating multiple umati OPC UA servers](SERVER.md) for details on the information model. -The datahub OPC UA Server will be available at `opc.tcp://datahub.umati.app:4840`. (Starting with the plugfest End of August) +The datahub OPC UA Server is be available at `opc.tcp://datahub.umati.app:4840`. The following username and password is required to access the OPC UA Server: **User**: umati-user -**Password**: Please request at [info@umati.org](mailto:info@umati.org) and [g.goerisch@vdw.de](mailto:g.goerisch@vdw.de) +**Password**: Please request at [info@umati.org](mailto:info@umati.org) and [g.goerisch@vdw.de](mailto:g.goerisch@vdw.de) ## OPC UA client functionalities @@ -24,7 +24,7 @@ As described in [OPC UA Server](SERVER.md), the client needs to support an encry - Standard UA Client 2017 Profile this includes: - Security Policy Required (encrypted connection required) - Security User Name Password Client -- Session Client Renew NodeIDs (namespace table might change over time, URI is necessary to detect the required namespace index) +- Session Client Renew NodeIds (namespace table might change over time, URI is necessary to detect the required namespace index) ## Getting started: OPC UA client for umati showcase @@ -32,7 +32,7 @@ This specification focuses on the points that are specific to the umati showcase - A test server is available for the development of OPC UA clients. This does not correspond to a real machine behavior, but provides changing values in the parameters for functionality testing. -- The start node of the Machines folder in the address space is described in chapter 9 of the [OPC 40001-1 UA for Machinery](https://opcua.vdma.org/catalog-detail/-/catalog/3803). There is no guarantee that the namespace index of a machine will remain the same permanently (e.g. if the datahub is restarted or the connection between the machine and the datahub is interrupted). Therefore, the URI should be used to identify the correct namespace. +- The start node of the Machines folder in the address space is described in chapter 9 of the [OPC 40001-1 UA for Machinery](https://reference.opcfoundation.org/Machinery/docs/). There is no guarantee that the namespace index of a machine will remain the same permanently (e.g. if the datahub is restarted or the connection between the machine and the datahub is interrupted). Therefore, the URI should be used to identify the correct namespace. - The other nodes can be identified by Browse/ TranslateBrowsePathsToNodeIds. The client must be able to ignore certain/unavailable objects because some instances are optional (e.g. spindles or lamps). - To get data continuously, use subscriptions and monitored items instead of repetitive read requests. diff --git a/DASHBOARD.md b/DASHBOARD.md index d324bef..92e0451 100644 --- a/DASHBOARD.md +++ b/DASHBOARD.md @@ -25,7 +25,7 @@ Location is set by fair organiser. The machine instance _Location_ property (according to OPC 40001-1) shall be provided in the format ` `, e.g, “METAV 1 A22” or format ` `, e.g. `N 51.257315 E 6.740885` for GPS coordinates. -**The machine only gets a map icon, if is provides at least the GPS location** +**The machine only gets a map icon, if it provides at least the GPS location** Machines can be referenced to more than one fair by providing a list of fair locations, deliminated by slash e.g. `METAV /EMO 12 D17/N 51.257315 E 6.740885` diff --git a/README.md b/README.md index 19f3a3c..a241819 100644 --- a/README.md +++ b/README.md @@ -2,6 +2,12 @@ This repository provides the specification to connect to the umati virtual demonstration showcase. +## What is umati - the universal machine technology interface + +To learn more please visit [https://umati.org](https://umati.org) + +--- + ## Structure of the specification - [Overview](index.md) diff --git a/SERVER.md b/SERVER.md index 8ef1f90..3425776 100644 --- a/SERVER.md +++ b/SERVER.md @@ -4,7 +4,7 @@ ### Datahub and the fairconnect-configuration -For this showcase we have a datahub provided off premise. This acts as an OPC UA aggregation server. The OPC UA servers (M) will connect via an OpenVPN tunnel to an VPN endpoint (one per participant). An OPC UA client will connect to the OPC UA server(s) of that participant through the VPN tunnel. The application providers (A) will connect to the datahub OPC UA server endpoint, as an [OPC UA Client](CLIENT.md). +For this showcase we have a datahub provided off premise. This acts as an OPC UA aggregation server. The OPC UA servers (M) will connect via an OpenVPN tunnel to an VPN endpoint (one per participant; multiple are possible in case of multiple machines But preaggregation of machines to a single OPC UA Server at the participant is also possible, [see below for details](SERVER.md#openvpn-configuration).). An OPC UA client will connect to the OPC UA server(s) of that participant through the VPN tunnel. The application providers (A) will connect to the datahub OPC UA server endpoint, as an [OPC UA Client](CLIENT.md). To connect to this datahub (M) need an OPC UA server and OpenVPN client to access one dedicated endpoint per partner. In order to ease the onboarding process onto the datahub, we provide the [fairconnect application](https://fairconnect.umati.app) and a specified process for connecting OPC UA servers to the showcase: diff --git a/Specs/Machinetools.md b/Specs/Machinetools.md index d542fd3..f767db9 100644 --- a/Specs/Machinetools.md +++ b/Specs/Machinetools.md @@ -23,7 +23,7 @@ All participants not familiar with the released information model do not need to ## 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 to find the NodeId for accessing the address space and available instances. | +| **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](https://reference.opcfoundation.org/Core/docs/Part4/5.8.2/) and [TranslateBrowsePathsToNodeIds](https://reference.opcfoundation.org/Core/docs/Part4/5.8.4/) to access nodes of interest. | --- diff --git a/index.md b/index.md index 36b339f..a8ae299 100644 --- a/index.md +++ b/index.md @@ -1,10 +1,16 @@ -# General Information +# General Information - This document provides **all information** to get connected to the umati showcase demonstrator scenario. - Participants who connect to the showcase, need to do so **on their own**, or with the help of their controls or software supplier. The umati project group **cannot** supply individual support on how to get [OPC UA Servers](SERVER.md) installed, online and deliver data. If questions arise regarding the information provided in **this documentation** or the connection to the datahub for the umati showcase demonstrator, please open an issue [here](https://github.com/umati/Showcase). - An FAQ is provided [here](FAQ.md) and will be updated as needed. +## What is umati - the universal machine technology interface + +To learn more please visit [https://umati.org](https://umati.org) + +--- + ## Structure of the specification - [OPC UA Server](SERVER.md) @@ -35,7 +41,7 @@ This documentation is versioned, as some content details will be delivered later | v1.02.1 | 02.10.2020 | Update on Machine Tools | | v1.02.2 | 23.11.2020 | Update License and activate CLA | | v1.02.3 | 18.02.2021 | Update on Machine Tools and Software Solutions | -| v1.03.0 | 19.05.2021 | Complete update to latest developments | +| v1.03.0 | 21.05.2021 | Complete update to latest developments | ### Changelog