Skip to content

Commit 56c9ef8

Browse files
authored
Merge pull request #4 from FlorianDue/main
Fix Typos and add link to docu
2 parents d6e72eb + c25b114 commit 56c9ef8

File tree

2 files changed

+30
-30
lines changed

2 files changed

+30
-30
lines changed

README.md

+29-29
Original file line numberDiff line numberDiff line change
@@ -1,26 +1,41 @@
11
# SWAP-IT Registry Module
22
The SWAP-IT Registry Module is a base module of the SWAP-IT Architecture (https://github.com/swap-it/demo-scenario). The module is supposed to map server of SWAP-Assets and thus,
3-
make them available for process execution steps. Doing so, the Registry Module provides three main functionalities,
3+
make them available for process execution steps. Doing so, the Registry Module provides three main functionalities,
44
which can be accessed through OPC UA Method calls:
55

6-
1. **Register Asset:** The addition of an Asset to the Registry Module. The Data Values are mapped to the registry module and the
7-
asset can be considered for process execution steps within the SWAP-IT Architecture.
8-
9-
2. **Unregister Asset:** The removal of an Asset from the Registry Module. The Data Values are no longer mapped to the registry module and the
10-
asset cannot be considered for process execution steps within the SWAP-IT Architecture anymore.
6+
1. **Register Asset:** The addition of an Asset to the Registry Module. The Data Values are mapped to the registry module and the
7+
asset can be considered for process execution steps within the SWAP-IT Architecture.
8+
9+
2. **Unregister Asset:** The removal of an Asset from the Registry Module. The Data Values are no longer mapped to the registry module and the
10+
asset cannot be considered for process execution steps within the SWAP-IT Architecture anymore.
11+
12+
3. **Filter Asset:** Provision of assets to the swap-it-execution-engine from a set of registered assets. The Filter Asset Method can
13+
evaluate product capabilities and match them against asset capabilities.
14+
15+
16+
<img src="documentation/source/images/registry_overview.png" alt="">
17+
18+
19+
An extensive documentation or the SWAP-IT Registry Module can be found here: https://fraunhoferiosb.github.io/swap-it-registry-module
20+
or build from the repository. Here, sphinx and the sphinx rtd theme are required. Both can be installed with:
21+
22+
pip install sphinx
23+
pip install sphinx-rtd-theme
1124

12-
3. **Filter Asset:** Provision of assets to the swap-it-execution-engine from a set of registered assets. The Filter Asset Method can
13-
evaluate product capabilities and match them against asset capabilities.
1425

15-
<p align="center">
16-
<img src="documentation/source/images/registry_overview.png" alt="">
17-
</p>
26+
Build the documentation:
27+
28+
cd swap-it-registry-module
29+
#html
30+
sphinx-build -M html documentation/source/ documentation/build/html
31+
#pdf
32+
sphinx-build -b pdf documentation/source/ documentation/build/pdf/
33+
1834

1935
## Dependencies
20-
The SWAP-IT Regitry Module requires a locally installed version of the C-based OPC UA SDK open62541 (https://github.com/open62541/open62541) version 1.4.6,
36+
The SWAP-IT Registry Module requires a locally installed version of the C-based OPC UA SDK open62541 (https://github.com/open62541/open62541) version 1.4.6,
2137
as well as a locally installed version of the swap-it-open62541-server-template (https://github.com/FraunhoferIOSB/swap-it-open62541-server-template).
2238

23-
For the installation of the dependencies, see section Build the Registry-Module
2439

2540
## Build the Registry-Module:
2641

@@ -58,7 +73,7 @@ The default URL of the registry module is: **opc.tcp://localhost:8000**
5873
./swap-it-registry-module
5974

6075
## Related Projects
61-
Since the SWAP-IT Regitry Module is part of the SWAP-IT Architecture, its application is linked to other SWAP-IT projects. Here are some other relevant repositories:
76+
Since the SWAP-IT Registry Module is part of the SWAP-IT Architecture, its application is linked to other SWAP-IT projects. Here are some other relevant repositories:
6277

6378
- SWAP-IT Demo Scenario: https://github.com/swap-it/demo-scenario
6479
- SWAP-IT open62541 server-template: https://github.com/FraunhoferIOSB/swap-it-open62541-server-template
@@ -67,18 +82,3 @@ Since the SWAP-IT Regitry Module is part of the SWAP-IT Architecture, its applic
6782
- SWAP-IT Dashboard: https://github.com/iml130/swap-it-dashboard
6883
- Common Information Model: https://github.com/FraunhoferIOSB/swap-it-common-information-model
6984

70-
## Build Documentation
71-
72-
To build the documentation, sphinx and the sphinx rtd theme are required. Both can be installed with:
73-
74-
pip install sphinx
75-
pip install sphinx-rtd-theme
76-
77-
78-
Build the documentation:
79-
80-
cd swap-it-registry-module
81-
#html
82-
sphinx-build -M html documentation/source/ documentation/build/html
83-
#pdf
84-
sphinx-build -b pdf documentation/source/ documentation/build/pdf/

documentation/source/unregister.rst

+1-1
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ Unregister SWAP Assets
1212
There are several ways to unregister SWAP Assets within the Registry Module:
1313
- Remove Agent Method within the Registry Module
1414
- Unregister Method from the `Common Information Model <https://github.com/FraunhoferIOSB/swap-it-common-information-model>`_ (the method callback is provided within the `open62541-server-template <https://github.com/FraunhoferIOSB/swap-it-open62541-server-template>`_)
15-
- Json Configuration of the `open62541-server-template <https://github.com/FraunhoferIOSB/swap-it-open62541-server-template>`_. However, this approach automatically unregisters the agent when shutting down the server, so that no code example will be provided. The code example is availabe at `Registration`. The server must just be shut down for the un-registration.
15+
- Json Configuration of the `open62541-server-template <https://github.com/FraunhoferIOSB/swap-it-open62541-server-template>`_. However, this approach automatically unregisters the agent when shutting down the server, so that no code example will be provided. The code example is available at `Registration`. The server must just be shut down for the un-registration.
1616

1717
First, the Registry Module must be started:
1818

0 commit comments

Comments
 (0)