Ambulance WoDT Digital Twin

This is the Ambulance WoDT Digital Twin layer that use Azure Digital Twins as a Twin Builder.

Usage

You need to specify the following environment variable:

• SIGNALR_NEGOTIATION_URL: Azure SignalR Negotiation url
• SIGNALR_TOPIC_NAME: the topic name used to publish events on SignalR
• DIGITAL_TWIN_URI: the uri of the exposed WoDT Digital Twin
• EXPOSED_PORT: the port where the Digital Twin expose its services
• AZURE_CLIENT_ID: ID of an Azure AD application
• AZURE_TENANT_ID: ID of the application's Azure AD tenant
• AZURE_CLIENT_SECRET: the application's client secrets
• AZURE_DT_ENDPOINT: the Azure Digital Twins instance endpoint
• AZURE_DT_ID: the id of the Digital Twin on Azure Digital Twins
• PHYSICAL_ASSET_ID: the ID of the Physical Asset

If you want to run it via docker container:

1. Provide a .env file with all the environment variable described above
2. Run the container with the command:

    docker run ghcr.io/webbased-wodt/adt-ambulance-dt:latest

   1. If you want to pass an environment file whose name is different from .env use the --env-file <name> parameter.

Usage notes

This Digital Twin runs on the Microsoft Azure Digital Twins cloud service. One main issue with Azure Digital Twins is the impossibility of modeling relationships with Digital Twins that live outside the Azure Digital Twins instance itself. The targets in Azure Digital Twins relationships must be valid IDs of Digital Twins that are managed under the same instance.

The strategy followed in this prototype consists of creating a new Digital Twin (DT B) inside the instance for each target WoDT Digital Twin with which the original one (DT A) has a relationship in the ecosystem. Hence, the Digital Twin created (DT B) is an internal representation of the external WoDT Digital Twin that can be linked to the original one.

Moreover, the URI of the interested WoDT Digital Twin (DT B) is set as a property due to the impossibility of setting a URI as the ID of a Digital Twin inside an Azure Digital Twins instance (creating an uri property in its model).

Documentation

• Check out the website here
• Direct link to the Code documentation here
• Direct link to the REST-API documentation here