OPEN-ACCESS is an open source framework extending containerized application orchestration and device management to hosts at the Edge. It is built upon NodeJS and provides core infrastructure support for application deployment and datastream synchronization between cloud and edge. It also supports multiple communation protocols (AMQP, MQTT, REST, OPCUA, OPCUA pub/Sub, S7-Online, LCOM, ModBus-TCP, Mindsphere-Conect, ROS Messages, etc...) and allows developers to author custom logic and enable resource constrained device communication at the Edge.
A more detailed description of the architecture of OPEN-ACCESS is provided in the corresponding paper.
Fig. 1: Architecture of a runtime engine.
As illustrated in Fig. 1, OPEN-ACESS is modularly implemented using NodeJs (Javascript) and is composed of the following components:
The southbound module is responsible for raw data acquisition from external systems including other instances of OPEN-ACCESS. It is a collection of submodules called southbound adapter. Each southbound adapter implements a communication protocol and thus ensures the integration of heterogeneous systems. An adapter can be configured as a client to actively read, poll or monitor a data point from any of the connected systems or as a server to receive published data. Presented like this, each adapter instance represents a data stream. All data streams are integrated by the input bus, which the runtime engine can access.
The runtime engine is responsible for the execution of the data analytics algorithms defined in containers. Each container is assigned a priority, a computation cycle time and a maximum execution time. A container represents a Digital Acyclic Graph (DAG), where the leaves of the graph define the raw data, the node of the graph the operations and the nodes with no parents the computation results. Each node can be modeled explicitly using a mathematical function or implicitly using a neuronal network for example. The runtime engine schedules, executes and monitors the different containers, suspending those containers, whose execution behavior differs from its definition (e. g. execution time longer than expected). Decoupling the containers also ensures that redundancy and replication mechanisms for critical algorithms can be implemented.
The northbound module is responsible for the communication of the computation results with an overlying system, e.g. the cloud and/or other instances of the runtime engine. It is also a collection of protocol adapters that can be configured as client or server.
The configurator implements an OPC UA server and plays the role of the knowledge aggregation server, which augments the computation results with contextual information, e.g. the multi-domain engineering information model representing the production system’s architecture. It also manages the configurations of the runtime engine and offers an interface to manipulate the configuration of the algorithms, allowing an online fine-tuning.
- NodeJs : The Backend requires NodeJs and a node global package npm.
- Git
- Dockers: For a container installation, Docker is required. Please refer to the docker documentation for docker installation.
Step 1: Clone this repo.
git clone https://github.com/jupiterbak/OPEN-ACCESS.git
cd OPEN-ACCESSStep 2: Install the dependencies.
npm installStep 2: Start the application. Run the following
npm startAfter a sucessfull startup the following output should be printed. Please notice the information that all modules have been sucessfully initialized and started.
C:\GitHub\OPEN-ACCESS>npm start
> open_access@0.0.1 start C:\GitHub\OPEN-ACCESS
> node open_access.js
4 Dec 18:40:24 - [info] Engine initialized successfully!
4 Dec 18:40:24 - [info] Config API initialized successfully.
4 Dec 18:40:24 - [info] Configurator initialized successfully.
OPEN_ACCESS initialized successfully.
4 Dec 18:40:24 - [info] Northbound[dummyNorthBound] started successfully!
4 Dec 18:40:24 - [info] Southbound[dummySouthbound] started successfully!
===============================
OPEN ACCESS engine.welcome
===============================
4 Dec 18:40:24 - [info] runtime.version OPEN ACCESS :0.0.1
4 Dec 18:40:24 - [info] runtime.version Node JSv8.11.1
4 Dec 18:40:24 - [info] Windows_NT 6.1.7601 x64 LE
4 Dec 18:40:24 - [info] Engine started successfully.
4 Dec 18:40:24 - [info] Config API started successfully.
4 Dec 18:40:24 - [info] Configurator started successfully.
OPEN_ACCESS start successfully.
4 Dec 18:40:24 - [info] Config API is listening on port 55554 (http://localhost:55554/api/v1)
4 Dec 18:40:24 - [info] Config API Swagger-Ui is available on http://localhost:55554/api-docs
The OPEN ACCESS Rest API is now accessible at http://localhost:55554. And the Documentation at http://localhost:55554/docs
You can also deploy OPEN-ACCESS as a microservice inside a Docker container:
Step 1: Clone the repo
git clone https://github.com/jupiterbak/OPEN-ACCESS.git
cd OPEN-ACCESSStep 2: Build the Docker image
docker build -t open_access .Step 3: Run the Docker container locally:
docker run -p 55554:55554 -d open_accessStep 3_a: Run the Docker container in the cluster:
sudo docker-compose builddocker stack deploy --compose-file swarm_deploy.yml OPEN_ACCESS_STACKIn order to configure OPEN-ACCESS, the file default_settings.js has to be configured appropriately. For example the following configuration instantiate a S7-Online Client on the southbound to read some variable values on a Siemens PLC.
example_config: {
id: "SNAP7ClientDemo", // Unique ID of the module in the global configuration
name: "SNAP7ClientDemo", // Name of the module instance.
type: "SNAP7Client", // Type of the module, should always be "SNAP7Client" in order to use this module
modulesetting: {
ip: '192.168.1.16', // Remote IP-Address of the PLC server module
rack: 0, // PLC Rack number
slot: 1, // PLC Slot number
interval: 1000, // Interval to pool the data
},
outputs_variables: [ // The output variables specify how to interpret and map the data received
{
name: "Portal_Spannung_L1_N", // Variable that will hold the serialized value comming from the PLC.
datatype: "real", // Type of the data to read: "real", "int", "byte"
si_unit: "V", // Unit of the data variable. It is optional
area: 0x81, // Area identifier (0x81 Process inputs, 0x82 Process outputs, 0x83 Merkers, 0x84 DB, 0x1C Counters,0x1D Timers)
dbNumber: 21, // DB number if area = 0x84, otherwise ignored
start: 0, // Offset to start
amount: 100, // Amount of words to read
wordLen: 0x08 // Word size (0x01 Bit (inside a word), 0x02 Byte (8 bit), 0x04 Word (16 bit), 0x06 Double Word (32 bit), 0x08 Real (32 bit float), 0x1C Counter (16 bit), 0x1D Timer (16 bit))
},
{
name: "Portal_Spannung_L3_N", // Variable that will hold the serialized value comming from the PLC.
datatype: "real", // Type of the data to read: "real", "int", "byte"
si_unit: "V", // Unit of the data variable. It is optional
area: 0x81, // Area identifier (0x81 Process inputs, 0x82 Process outputs, 0x83 Merkers, 0x84 DB, 0x1C Counters,0x1D Timers)
dbNumber: 21, // DB number if area = 0x84, otherwise ignored
start: 0, // Offset to start
amount: 100, // Amount of words to read
wordLen: 0x08 // Word size (0x01 Bit (inside a word), 0x02 Byte (8 bit), 0x04 Word (16 bit), 0x06 Double Word (32 bit), 0x08 Real (32 bit float), 0x1C Counter (16 bit), 0x1D Timer (16 bit))
}
]
}If you use this code for your research, please cite our paper
@INPROCEEDINGS{8607483,
author={J. {Bakakeu} and J. {Fuchs} and T. {Javied} and M. {Brossog} and J. {Franke} and H. {Klos} and W. {Eberlein} and S. {Tolksdorf} and J. {Peschke} and L. {Jahn}},
booktitle={2018 IEEE International Conference on Industrial Engineering and Engineering Management (IEEM)},
title={Multi-Objective Design Space Exploration for the Integration of Advanced Analytics in Cyber-Physical Production Systems},
year={2018},
volume={},
number={},
pages={1866-1873},
doi={10.1109/IEEM.2018.8607483},
ISSN={2157-3611},
month={Dec},
}
Any contributions you make are greatly appreciated.
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature) - Commit your Changes (
git commit -m 'Add some AmazingFeature') - Push to the Branch (
git push origin feature/AmazingFeature) - Open a Pull Request
Distributed under the MIT License. See LICENSE for more information.
Jupiter Bakakeu - @JBakakeu - jupiter.bakakeu@gmail.com
Project Link: https://github.com/jupiterbak/OPEN-ACCESS