Eclipse Ditto WoDT Integration

An integration for Eclipse Ditto that allows a Ditto Thing to be used as a WoDT Digital Twin in a WoDT Platform, implementing the Web of Digital Twins paradigm.

Requirements

In order to use this integration you will need:

• Ditto instance running locally
• Java

Note: some libraries such as "wot-servient" may have to be imported manually.

Configuration

The module is preconfigured to work with a local Eclipse Ditto running in Docker. Find more information on GitHub.

You can change the configuration to your liking by editing resources/config.properties.

You can also specify the URI and port where the module will be exposed.

To integrate a Ditto Thing:

There are two ways to integrate a Ditto Thing::

• by creating it with a modified Thing Model, which will contain some additional properties for ontology mapping (example)
• by creating it with a standard Thing Model, you will need to provide an ontology mapping in YAML format (example)

After creating the Ditto thing you can start the module.

If you need to provide ontology mapping, you will need to indicate the path where it is saved, specifying it among the parameters.

Module instantiation example:

WoDTAdapter woDTAdapter = WoDTAdapter.create(
  "io.eclipseprojects.ditto:ambulance",
  "AmbulanceDTOntology.yaml",
  "http://localhost:5000",
  "bulbHolderPhysicalAssetId"
);

Parameters:

• Ditto thing id: the id of your Ditto thing created in Eclipse Ditto.
• Mapping in YAML: path where the YAML ontology mapping is saved.
• WoDT platform URIs: URI of the WoDT platforms to register to.
• Physical asset id: ID of the physical asset associated with the Digital Twin.