Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Update specification w.r.t. OPC UA and AutomationML #429

Merged
merged 4 commits into from
Jun 20, 2024
Merged

Update specification w.r.t. OPC UA and AutomationML #429

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
274f8fd
#397 remove mapping chapters for OPC UA and AutomationML
BirgitBoss May 6, 2024
0744e16
#397 remove also figure and do not mention
BirgitBoss Jun 14, 2024
91db6df
remove figure since not contained in documentation any longer
BirgitBoss Jun 14, 2024
7236e6e
add JSON for file exchange as well
BirgitBoss Jun 20, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
36 changes: 1 addition & 35 deletions documentation/IDTA-01001/modules/ROOT/pages/IDTA-01001_Mappings.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,7 @@ image::image58.jpeg[]


====
Note: the mapping specifications and schemata themselves are not part of the specification any longer but maintained open source. This eases usage of the specification and the different formats in open-source code projects.
Note: the mapping specifications and schemata for XML, JSON and RDF are part of https://github.com/admin-shell-io/aas-specs. Handling of Asset Administration Shell and OPC UA and AutomationML is handled in separate joint working groups of the assocations and IDTA.
====


Expand Down Expand Up @@ -186,37 +186,3 @@ Note 2: the mapping rules of how to derive the RDF schema from the technology-ne
Note 3: example files can be found n the repository "aas-specs" of the github project admin-shell-io [xref:IDTA-01xxx_Bibliography.adoc#bib51[[51\] in folder `schemas\rdf\examples`
====


== Formats in AutomationML

AutomationML (IEC 62714) is especially suited for serializing the import and export scenarios of the metamodel of an Asset Administration Shell in the engineering phase.

In general, the serialization approach is to map each object of the Asset Administration Shell metamodel to an AutomationML Role Class or to an AutomationML Role Class accompanied by an AutomationML Interface Class. This role class and (if applied) interface class also define the required attributes in AutomationML.

Asset Administration Shells themselves shall be modelled as AutomationML System Unit Classes or as Internal Elements within an Instance Hierarchy depending of the kind information of type and instance.

For the role classes and interface classes that are required for serialization, an AutomationML Role Class Library resp. an Interface Class Library are defined and provided to the public.

One of the goals is to ensure that the AutomationML model of the Asset Administration Shell can be used as a stand-alone AutomationML model, as well as in combination with existing AutomationML models such as the upcoming AutomationML Component Description. Therefore, the definition of the serialization approach defined in this clause is incorporated with the AutomationML definitions and applies the AutomationML technology definitions available on https://www.automationml.org/o.red.c/dateien.html.

xref:IDTA-01xxx_Bibliography.adoc#bib28[[28\]] is the AutomationML application recommendation for the Asset Administration Shell (AR AAS).


====
Note 1: the mapping of the Asset Administration Shell to AutomationML is carried out in a joint working group between AutomationML e.V. and Plattform Industrie 4.0.
====



====
Note 2: the resulting application recommendation (AR 004E) "Asset Administration Shell (AAS) Representation" xref:IDTA-01xxx_Bibliography.adoc#bib28[[28\]] can be found here: https://www.automationml.org/download-archive/, together with .aml files
====


== Formats in OPC UA

OPC UA is suited for the operating phase of Asset Administration Shells and especially applicable in case of machine-to-machine communication. The information model xref:IDTA-01xxx_Bibliography.adoc#bib42[[42\]] is the basis for the definition of so-called OPC UA Information Models, or OPC UA Companion Specifications xref:IDTA-01xxx_Bibliography.adoc#bib43[[43\]].

The joint Working Group of the https://opcfoundation.org/[OPC Foundation] and https://industrialdigitaltwin.org/[IDTA]
https://profiles.opcfoundation.org/workinggroup/40[Industry 4.0 Asset Administration Shell - AAS (I4AAS)] (xref:IDTA-01xxx_Bibliography.adoc#bib52[[41\]])
"will develop new companion specifications and / or Submodel Templates related to OPC UA for Asset Administration Shell V3.0 and compatible."
2 changes: 1 addition & 1 deletion documentation/IDTA-01001/modules/ROOT/pages/IDTA-01001_Preamble.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ This part of the document focuses on how such information needs to be processed
This document focuses on:

* a metamodel for specifying information of an Asset Administration Shell and its submodels,
* an introduction to the need of mappings to suitable technologies used in different life cycle phases of a product: XML, JSON, RDF, AutomationML, and OPC UA.
* an introduction to the need of mappings to suitable technologies used in different life cycle phases of a product, providing mappings for XML, JSON, and RDF.

This document presumes some familiarity with the concept of the Asset Administration Shell. Some of the concepts are described in Annex A for convenience sake. The concepts are being standardized as IEC standard IEC 63278 series xref:IDTA-01xxx_Bibliography.adoc#bib44[[44\]]. The main stakeholders addressed in this document are architects and software developers aiming to implement a digital twin using the Asset Administration Shell in an interoperable way. Additionally, the content can also be used as input for discussions with international standardization organizations and further initiatives. Please consult the continuously updated reading guide xref:IDTA-01xxx_Bibliography.adoc#bib38[[38\]] for an overview of documents on the Asset Administration Shell. The reading guide gives advice on which documents should be read depending on the role of the reader.

Expand Down
7 changes: 3 additions & 4 deletions documentation/IDTA-01001/modules/ROOT/pages/IDTA-01001_SummaryOutlook.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,10 +6,9 @@ This document has defined the metamodel for the structural viewpoint of the Asse

Several serializations and mappings are offered for the Asset Administration Shell based on this specification:

* XML and JSON for Exchange between partners via the exchange format _.aasx,_
* RDF for reasoning,
* AutomationML for the engineering phase,
* OPC UA for the operation phase.
* XML, mainly used for file exchange between partners via the exchange format _.aasx,_
BirgitBoss marked this conversation as resolved.
Show resolved Hide resolved
* JSON, mainly used for API definition, and
BirgitBoss marked this conversation as resolved.
Show resolved Hide resolved
* RDF for reasoning.

Additional parts of the document series cover (see xref:IDTA-01xxx_Bibliography.adoc#bib37[[37\]]):

Expand Down
13 changes: 9 additions & 4 deletions documentation/IDTA-01001/modules/ROOT/pages/IDTA-01xxx_Bibliography.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -93,8 +93,10 @@ SPDX-License-Identifier: CC-BY-4.0
[#bib27]
[27] A. Bayha, J. Bock, B. Boss, C. Diedrich, S. Malakuti "Describing Capabilities of Industrie 4.0 Components". Nov. 2020. Plattform Industrie 4.0. [Online] Available: https://www.plattform-i40.de/PI40/Redaktion/EN/Downloads/Publikation/Capabilities_Industrie40_Components.html

////
[#bib28]
[28] AutomationML Association: "Application Recommendations: Asset Administration Shell Representation (AR 004E)", Version 1.0.0, 20.11.2019, [Online]. Available: https://www.automationml.org/o.red.c/dateien.html
////

[#bib29]
[29] H. Knublauch, D. Knotokostas "Shapes Constraint Language (SHACL)" W3C Recommendation, 2017, [Online]. Available: https://www.w3.org/TR/shacl/
Expand Down Expand Up @@ -139,16 +141,19 @@ SPDX-License-Identifier: CC-BY-4.0
[#bib41]
[41] OPC 30270: OPC UA for Asset Administration Shell (AAS). 2021-06-04. [Online]. Available: https://reference.opcfoundation.org/v104/I4AAS/v100/docs/
////

[#bib52]
////
[#bib41]
[41] Joint Working Group of the https://opcfoundation.org/[OPC Foundation] and https://industrialdigitaltwin.org/[IDTA]
https://profiles.opcfoundation.org/workinggroup/40[Industry 4.0 Asset Administration Shell - AAS (I4AAS)]

////
////
[#bib42]
[42] OPC Unified Architecture Specification. Part 5 Information Model. [Online]. Available: https://opcfoundation.org/developer-tools/specifications-unified-architecture

////
////
[#bib43]
[43] OPC UA Information Models. [Online]. Available: https://opcfoundation.org/developer-tools/specifications-opc-ua-information-models
////

[#bib44]
[44] IEC 63278-1:2023 "Asset Administration Shell for industrial applications – Part 1: Asset Administration Shell structure".
Expand Down
Loading