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.

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

Updated Getting Started to current version, adjusted OPC UA model #4

Merged
merged 26 commits into from
Nov 30, 2023
Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
26 commits
Select commit Hold shift + click to select a range
73be1cf
Merge pull request #3 from industrial-edge/main
j0hannesfr Aug 14, 2023
f66ac58
Updated architecture and description
j0hannesfr Aug 14, 2023
97e9cb5
Merge branch 'dev' of https://github.com/industrial-edge/industrial-i…
j0hannesfr Aug 14, 2023
c4a0c2a
update UA Expert description
j0hannesfr Aug 14, 2023
d30e75a
updated s7+ connector configuration
j0hannesfr Aug 15, 2023
89e557a
updated OPC UA configuration
j0hannesfr Aug 15, 2023
8e516ea
updated opc ua model and import description
j0hannesfr Aug 21, 2023
ac06d7a
Updated Installation.md
j0hannesfr Aug 23, 2023
9ef4992
updated screenshots
j0hannesfr Aug 24, 2023
521ff0a
smaller changes
j0hannesfr Aug 24, 2023
09626db
small changes
j0hannesfr Aug 24, 2023
1369af7
CLA changes, new versions
j0hannesfr Aug 30, 2023
de4b600
updated architecture
j0hannesfr Aug 30, 2023
298ba39
CLA changes
j0hannesfr Sep 4, 2023
baf20c1
general corrections
Boehmi-TB Sep 26, 2023
0d877d2
update OPC UA model
Boehmi-TB Nov 8, 2023
b9d24d0
updated docs
NicoSchoe Nov 22, 2023
7f10672
updated docs
NicoSchoe Nov 22, 2023
a581ad0
removed Logo
NicoSchoe Nov 22, 2023
d8084d0
updated links for configuration steps
NicoSchoe Nov 27, 2023
c5fd2dd
updated docs
NicoSchoe Nov 28, 2023
ea0b670
added borders, fixed indentation
NicoSchoe Nov 28, 2023
8870ad3
fixed indentation
NicoSchoe Nov 28, 2023
8af5471
added image borders
NicoSchoe Nov 28, 2023
ddb1d9a
fixed table of contents
NicoSchoe Nov 28, 2023
61e43d0
updated screenshots and wording
Boehmi-TB Nov 30, 2023
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
Prev Previous commit
Next Next commit
added borders, fixed indentation
  • Loading branch information
NicoSchoe committed Nov 28, 2023
commit ea0b670c98cf1e2cdc0fcb986f91bb2eb162a28c
6 changes: 3 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -82,13 +82,13 @@ Once the application is successfully deployed, data from the filling bottle mach

It is possible to check that using the UA Expert:

1. Connect to port `62520` of your IED to reach the IIH OPC UA Server.
1. Connect to port `62520` of your IED to reach the IIH OPC UA Server.
![UA Expert Server Configuration](docs/graphics/uaexpert_server.png)

2. Authenticate with default username `iihcore` and password `iihcore`.
2. Authenticate with default username `iihcore` and password `iihcore`.
![UA Expert Server Auth](docs/graphics/uaexpert_auth_settings.png)

3. Browse the OPC UA Server Model and display data.
3. Browse the OPC UA Server Model and display data.
![UA Expert Browse](docs/graphics/uaexpert_browse.png)

## Documentation
Expand Down
32 changes: 16 additions & 16 deletions docs/Installation.md
Original file line number Diff line number Diff line change
Expand Up @@ -95,7 +95,7 @@ This app needs to be installed on the IED. It allows service registration and se
#### Configure Databus
1. Go on you IEM and open the Databus Configurator in the **Data Connections** section.

2. Create a new user and assign the topic `ie/#`.
2. Create a new user and assign the topic `ie/#`.
![DatabusConfig](graphics/DatabusConfig.png)

3. **Deploy** the configuration.
Expand All @@ -104,12 +104,12 @@ This app needs to be installed on the IED. It allows service registration and se
1. In your IEM, go to **Data Connections** and launch the **OPC UA Connector configurator**.

2. Go to the settings menu, where you can fill in the Databus user you just created:
![OPCUAConfig1](graphics/OPCUAConfig1.png)
![OPCUAConfig1](graphics/OPCUAConfig1.png)

3. Add a new data source.
![OPCUA DataSource](graphics/opcua_datasource.png)

4. After adding the PLC, click on the browse symbol and add the following variables to your configuration:
4. After adding the PLC, click on the browse symbol and add the following variables to your configuration:
![OPCUA Tags](graphics/opcua_tags.png)

1. **Deploy** the configuration.
Expand All @@ -121,7 +121,7 @@ This apps allows the configuration of the IIH.

1. In your IED click on the Common Configurator to open it.

2. Go to the settings tab and add the Databus credentials for subscribing and publishing topics. Make sure that the default Databus Service name is also entered.
2. Go to the settings tab and add the Databus credentials for subscribing and publishing topics. Make sure that the default Databus Service name is also entered.
![IIH Databus_PubCred](graphics/iih_databus_pub_credentials.png)


Expand All @@ -142,25 +142,25 @@ From SiOME, two nodesets were exported, one for the companion specification and
### Import a Companion Specification
Open the IIH Semantics application on your IED.

1. In **Define Data -> OPCUA Model** select **Add Model**.
1. In **Define Data -> OPCUA Model** select **Add Model**.
![IIH_CreateModel](graphics/iih_create_model.png)

1. Select **Load companion specification**.
1. Select **Load companion specification**.
![IIH_LoadCompanionSpec](graphics/iih_load_comp_spec.png)

1. Load the TankNodeset.xml and select the namespace for the companion specification:
1. Load the TankNodeset.xml and select the namespace for the companion specification:
![IIH_CompSpec_Namespace](graphics/iih_namespace_comp_spec.png)

### Import the OPC UA model
The model is an instance of the standardized information that is defined in the companion specification.

1. Select **Add model** again.
1. Select **Add model** again.
![IIH_AddInstance](graphics/iih_addmodel_instance.png)

2. Select **Load instance model**.
2. Select **Load instance model**.
![IIH_LoadInstance](graphics/iih_load_instance.png)

3. Select the namespace for that model. If you want to use the GraphQL API, please also select the checkbox here.
3. Select the namespace for that model. If you want to use the GraphQL API, please also select the checkbox here.
![IIH_model_Namespace](graphics/iih_select_model_namespace.png)

You have successfully created a data model based on OPC UA. The next step is to map connector variables to it in order to fill the model with data.
Expand All @@ -173,18 +173,18 @@ To connect the OPCUA model with the actual values open the IIH Semantics app on

2. Select **OPC UA** and the namespace for the model in the respective dropdown menus on the right side of the window.

3. On the left side you should see the **Data Sources**. Select **SIMATIC S7+ Connector** from the dropdown menu.
3. On the left side you should see the **Data Sources**. Select **SIMATIC S7+ Connector** from the dropdown menu.
![IIH_s7mapping](graphics/iih_s7_mapping.png)

4. Drag and drop tags from the left window into the OPC UA model.

5. **Deploy** the changes.
5. **Deploy** the changes.
![IIH_s7mapping_deploy](graphics/iih_s7_mapping_deploy.png)

### Option 2: OPC UA Connector Mapping

1. Follow the same procedure as for [Option 1](#option-1-simatic-s7-connector-mapping), while selecting 'opcuac1' from the connector dropdown menu:
![IIH_opcuamapping](graphics/iih_opcua_mapping.png)
1. Follow the same procedure as for [Option 1](#option-1-simatic-s7-connector-mapping), while selecting 'opcuac1' from the connector dropdown menu:
![IIH_opcuamapping](graphics/iih_opcua_mapping.png)

2. **Deploy** the changes.

Expand All @@ -193,10 +193,10 @@ To make use of the full functionality of the IIH, your OPC UA model has to be ma

1. Go to **Define Data -> Organize**.

2. Select **Asset Model** in the right editor window and create a new asset.
2. Select **Asset Model** in the right editor window and create a new asset.
![AddParentAsset](graphics/AddParentAsset.png)

3. Map the OPC UA model by dragging and dropping the OPC UA hierarchy object to the created asset.
3. Map the OPC UA model by dragging and dropping the OPC UA hierarchy object to the created asset.
![MapOPCtoAsset](graphics/MapOPCtoAsset.png)

This model will be the central information layer for all your applications. If you have IIH Essentials installed, you are also able to activate the **Storage** and **Cloud Sync** feature for the tags in your asset model.
Binary file modified docs/graphics/iih_s7_conf6.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 modified docs/graphics/iih_s7_conf8.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 modified docs/graphics/iih_s7_conf8_2.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.