How azure/opendigitaltwins-dtdl works
This repository publishes the Digital Twins Definition Language (DTDL), a versioned language for describing IoT digital-twin models and interfaces—not a model-processing runtime. The principal workflow is for a model author to describe a twin’s capabilities in DTDL so IoT services and tools can use its semantics. The README identifies JSON-LD and RDF as foundations and names supported versions and services. No source excerpts were available, so relationships beyond those documented in the README are omitted; v3 and v4 are represented only by their listed directories.
Main entry points: DTDL.v2.md V2 language
Components 17
Language versions
- V1 preview
DTDL/v1-preview/dtdlv1.md - V2 language
DTDL/v2/DTDL.v2.md - V3 language
DTDL/v3 - V4 language
DTDL/v4
V2 semantics
- V2 contexts
DTDL/v2/context/DTDL.v2.context.json - V2 elements
DTDL/v2/metamodel/DTDL.v2.ModelElements.json - V2 RDF constraints
DTDL/v2/metamodel/DTDL.v2.ModelRDF-SHACL.json - V2 conformance cases
DTDL/v2/spec
Extensions
- IoT Central extension spec
DTDL/v2/DTDL.iotcentral.v2.md - IoT Central context
DTDL/v2/context/DTDL.v2.iotcentral.context.json - IoT Central elements
DTDL/v2/metamodel/DTDL.v2.PartnerExtension.iotcentral.Elements.json - IoT Central constraints
DTDL/v2/metamodel/DTDL.v2.PartnerExtension.iotcentral.RDF-SHACL.json
Model examples
- Thermostat model
DTDL/v2/samples/Thermostat.json - Temperature controller
DTDL/v2/samples/TemperatureController.json
Other components
- Model author
- IoT services
- JSON-LD and RDF
Connections 3
- Model author → V2 language: describes models
- V2 language → IoT services: enables semantics
- V2 language → JSON-LD and RDF: is based on