The LiDiTE framework

This framework allows the realization of Digital Twins. Here it is configured for implementing the use case of the Savona Polygeneration Microgrid (SPM) expressed in the paper LiDiTE: a Full-Fledged and Featherweight DigitalTwin Framework.

Quickstart

make build
make up

Prerequisites

• Docker engine
• Docker compose
• GNU Make

Components of the repository

This repository is comprised of multiple components, some of which belong to the framework and some of which belong to the SPM use case.

In this root directory multiple module YAML files are defined, which can be added to the environment by modifying the modules variable inside of the Makefile.

These modules combine and configure the framework-provided or their own container images to implement the SPM use case, storing the configuration files inside of the config directory.

Modules belonging to the framework

• DNS Server implemented via BIND9
• An Eclipse Ditto instance (authenticated via a reverse proxy) which is either:
  • The upstream Eclipse Ditto implementation
  • Our own lightweight Eclipse Ditto repackaging via a custom container image
• Eclipse Ditto database server
• Eclipse Ditto custom provisioner using our custom container image
• Docker API proxy
• A multi-tier network implemented with:
  • The Dovesnap Docker network plugin
  • Multiple networks
  • Multiple routers implemented via OpenWRT
  • A VPN for external access leveraging OpenVPN
• SCADA server using the ScadaLTS project
• Workflow automation platform using the Camunda workflow automation platform, configured automatically via our custom provisioner, managing scheduled tasks via our custom scheduler
• Workflow visualizer implemented via a custom web application
• Performance sampling environment for gathering metrics on the framework resource usage
• Test services for inspecting the network endpoints
• PLC execution environment using OpenPLC
• Virtual machines execution environment using QEMU KVM
• Dummy containers for simulating network devices
• A simulator for physical devices

Modules belonging to the SPM use case implementation

• ModBus managed power cabinets with associated controller PLCs for six buildings 1,2,3,4,5,6
• Use case specific settings for the framework-provided Ditto instance
• An operator workstation running Windows
• Use case specific settings for the framework-provided SCADA server and workflow automation software
• Physical components of the SPM implemented via the simulator including:
  • Energy storage
  • Gas turbine
  • Solar panel
• Environmental factors of the SPM implemented via the simulator including:
  • Building occupancy
  • Solar radiance
• A proxy for the real website implemented via NGINX
• Use case specific settings for the framework-provided workflow visualizer software