{"id":2715,"date":"2020-07-24T09:04:47","date_gmt":"2020-07-24T01:04:47","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/iotdev\/?p=2715"},"modified":"2020-07-24T09:04:47","modified_gmt":"2020-07-24T01:04:47","slug":"advanced-authoring-for-digital-twins-models-now-in-visual-studio-and-vs-code","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/iotdev\/advanced-authoring-for-digital-twins-models-now-in-visual-studio-and-vs-code\/","title":{"rendered":"Advanced authoring for Digital Twins models now in Visual Studio and VS Code"},"content":{"rendered":"

Authoring Digital Twins models is no small business and can rapidly get complicated and prone to errors. There now is a Visual Studio Code extension that will save you time, reduce typos and make you a Digital Twins wizard. Let me introduce the DTDL editor for Visual Studio Code<\/a> and DTDL editor for Visual Studio 2019<\/a> (both in preview).<\/p>\n

The Digital Twin Definition Language<\/a> (DTDL) is a language for describing models for Plug and Play devices, device digital twins, and logical digital twins. Broadly, modeling enables IoT solutions to provision, use, and configure digital twins of all kinds from multiple sources in a single solution. Using DTDL to describe any digital twin’s abilities enables the IoT platform and IoT solutions to leverage the semantics of each digital twin.<\/p>\n

With this new extension, you can read and write documents using DTDL more efficiently taking full advantage of the following key features: Template, Intellisense and Validation.<\/p>\n

Let us take the classic IoT example – a thermostat – to look at how this extension helps you author a Digital Twin model in VS Code. Our thermostat is a specific model that comes with sensors and capabilities described in the model. Let us build this model together.<\/p>\n

Create Interfaces from a Template <\/strong><\/p>\n

In DTDL, a digital twin model is composed of one or more Interfaces. An interface is reusable and contains a set of behaviors in the form of objects of different metamodel classes (Telemetry, Properties, Commands, Relationships, Components).<\/p>\n

To create the thermostat interfaces, you can use the command palette in VS Code. \u00a0It includes a simple example with Telemetry reporting temperature as a double, a read only Property for the device status as a string and a Command to reboot the device.<\/p>\n

    \n
  1. In Visual Studio Code, select\u00a0View > Command Palette<\/strong>to open the VS Code command palette.<\/li>\n
  2. In the command palette, enter and run the command DTDL: Create Interface<\/strong> and follow the instructions to assign the interface name.<\/li>\n
  3. A JSON file will be created in the current folder. The file name is based on the input interface and part of the value of @id and displayName. You should replace the {company} <\/strong>field in @id with your own company\u2019s name. Note that @id is the <path> component of the Digital Twin Model Identifier<\/a> (DTMI) and should follow the DTMI rule to uniquely identify the device model.<\/li>\n<\/ol>\n

    \"(a<\/p>\n

    (a gif to demonstrate how to create interface from template and then modify the path)<\/p>\n

    We kept the initial template as simple as possible to help you get started. From there, you can extend the interface with new types defined in DTDL v2:<\/p>\n