| <!-- |
| ~ Copyright (c) 2021 Contributors to the Eclipse Foundation |
| ~ |
| ~ See the NOTICE file(s) distributed with this work for additional |
| ~ information regarding copyright ownership. |
| ~ |
| ~ This program and the accompanying materials are made available under the |
| ~ terms of the Eclipse Public License 2.0 which is available at |
| ~ http://www.eclipse.org/legal/epl-2.0 |
| ~ |
| ~ SPDX-License-Identifier: EPL-2.0 |
| --> |
| <!doctype html> |
| <html lang="en"> |
| |
| <head> |
| <meta charset="utf-8"> |
| |
| <title>Eclipse Ditto: an introduction</title> |
| |
| <meta name="description" content="Eclipse Ditto introduction"> |
| <meta name="author" content="Thomas Jäckle"> |
| <meta name="date" content="2021-06-28"> |
| <meta http-equiv="content-language" content="en"> |
| |
| <meta name="apple-mobile-web-app-capable" content="yes"> |
| <meta name="apple-mobile-web-app-status-bar-style" content="black-translucent"> |
| |
| <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no"> |
| |
| <link rel="icon" type="image/png" href="../../images/favicon-16x16.png" sizes="16x16"> |
| <link rel="icon" type="image/png" href="../../images/favicon-32x32.png" sizes="32x32"> |
| <link rel="icon" type="image/png" href="../../images/favicon-96x96.png" sizes="96x96"> |
| |
| <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=News+Cycle"> |
| <link rel="stylesheet" href="https://use.fontawesome.com/releases/v5.0.13/css/all.css" |
| integrity="sha384-DNOHZ68U8hZfKXOrtjWvjxusGo9WQnrNx2sqG0tfsghAvtVlRW3tvkXWZh58N9jp" crossorigin="anonymous"> |
| |
| |
| <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/reveal.js/3.6.0/css/reveal.min.css"> |
| <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/reveal.js/3.6.0/css/theme/simple.min.css" |
| id="theme"> |
| |
| <!-- Theme used for syntax highlighting of code --> |
| <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/reveal.js/3.6.0/lib/css/zenburn.min.css"> |
| |
| <style> |
| @font-face { |
| font-family: "News Cycle"; |
| } |
| |
| #header-left { |
| position: absolute; |
| top: 0%; |
| left: 0%; |
| opacity: 1 !important; |
| } |
| |
| #header-right { |
| position: absolute; |
| top: 0%; |
| right: 0%; |
| opacity: 1 !important; |
| } |
| |
| .reveal section img { |
| background: none; |
| border: none; |
| box-shadow: none; |
| } |
| |
| .dim-background .slide-background { |
| opacity: 0.3 !important; |
| /*background: none !important; for printing ! */ |
| /* print with: file:///C:/...../index.html?print-pdf */ |
| } |
| |
| .chapter-background .slide-background { |
| opacity: 0.7 !important; |
| /*background: none !important;*/ /* for printing ! */ |
| } |
| |
| .print-pdf .reveal .slide-background { |
| opacity: 0.7 !important; |
| } |
| |
| .dim-background .slide-background.past { |
| display: none !important; |
| } |
| |
| .dim-background .slide-background.future { |
| display: none !important; |
| } |
| |
| .chapter-background .slide-background.past { |
| display: none !important; |
| } |
| |
| .chapter-background .slide-background.future { |
| display: none !important; |
| } |
| |
| /*.new-chapter h3 { color: #586e75; }*/ |
| .introlink a:link { |
| font-weight: bold; |
| color: #000000 |
| } |
| |
| /* unvisited links */ |
| .introlink a:visited { |
| font-weight: bold; |
| color: #000000 |
| } |
| |
| /* visited links */ |
| .introlink a:hover { |
| font-weight: bold; |
| color: #000000 |
| } |
| |
| /* user hovers */ |
| .introlink a:active { |
| font-weight: bold; |
| color: #000000 |
| } |
| |
| ul { |
| list-style: none !important; |
| } |
| |
| ul li { |
| padding-left: 1.3em; |
| } |
| |
| ul li:before { |
| list-style: none; |
| content: "→"; |
| display: inline-block; |
| margin-left: -1.3em; /* same as padding-left set on li */ |
| width: 1.3em; /* same as padding-left set on li */ |
| } |
| |
| .footer { |
| font-size: 12px !Important; |
| font-family: "News Cycle", Impact, sans-serif; |
| color: #687175; |
| position: absolute; |
| bottom: 15px; |
| left: 15px; |
| margin-bottom: 10px |
| } |
| |
| .footer a { |
| color: #003b6a; |
| text-decoration: none; |
| } |
| |
| /* active links */ |
| </style> |
| |
| <!-- Printing and PDF exports --> |
| <script> |
| var link = document.createElement('link'); |
| link.rel = 'stylesheet'; |
| link.type = 'text/css'; |
| link.href = |
| window.location.search.match(/print-pdf/gi) |
| ? 'https://cdnjs.cloudflare.com/ajax/libs/reveal.js/3.6.0/css/print/pdf.min.css' |
| : 'https://cdnjs.cloudflare.com/ajax/libs/reveal.js/3.6.0/css/print/paper.min.css'; |
| document.getElementsByTagName('head')[0].appendChild(link); |
| </script> |
| |
| <!--[if lt IE 9]> |
| <script src="https://cdnjs.cloudflare.com/ajax/libs/reveal.js/3.6.0/lib/js/html5shiv.js"></script> |
| <![endif]--> |
| </head> |
| |
| <body> |
| |
| <div class="reveal"> |
| |
| <!-- 2. Create hidden header/footer <div> --> |
| <div id="hidden" style="display:none;"> |
| <div id="header"> |
| <div id="header-left"><img src="../../images/ditto.svg" style="width: 80px; padding-top: 10px; padding-left: 10px" alt="Ditto logo"></div> |
| <div id="header-right"><img src="../../images/iot_logo.svg" style="width: 120px; padding-top: 10px; padding-right: 10px" alt="Eclipse IoT logo"></div> |
| </div> |
| </div> |
| |
| <!-- Any section element inside of this container is displayed as a slide --> |
| <div class="slides"> |
| <!-- Section: Intro --> |
| <section> |
| <section id="title" class="new-chapter" data-background="../bg-images/background-twin-small.jpg" data-state="chapter-background"> |
| <!-- background source: https://unsplash.com/collections/425779/iot --> |
| <h1 style="line-height: 1em"> |
| <img src="../../images/iot_logo.svg" style="width: 15%;vertical-align: top; padding-right: 20px" alt="Eclipse IoT"> |
| <img src="../../images/ditto.svg" style="width: 15%;vertical-align: middle" alt="Eclipse Ditto"> |
| </h1> |
| <h1 style="margin-top: 0.6em; font-size: 2em;">Eclipse Ditto:<br/>an introduction</h1> |
| <h2 style="margin-top: 1.5em; font-size: 0.8em">06/2021</h2> |
| </section> |
| </section> |
| |
| <!-- Section: Digital Twins --> |
| <section style="clear: both;"> |
| <section id="twin" class="new-chapter" data-background="../bg-images/background-twin-small.jpg" |
| data-state="chapter-background"> |
| <!-- background source: https://unsplash.com/search/twin?photo=SmAiLn-nnJg --> |
| <h1>Digital Twins</h1> |
| <br/> |
| <ul> |
| <li class="fragment">digital representation of real physical devices</li> |
| <li class="fragment" style="margin-top: 1em;">act as broker for communicating with assets</li> |
| <li class="fragment" style="margin-top: 1em;">applicable for both industrial and consumer-centric IoT scenarios</li> |
| </ul> |
| </section> |
| <section id="twin-1" style="clear: both;"> |
| <h2>DT - our interpretation</h2> |
| <br/> |
| <ul> |
| <li class="fragment">a pattern for working with <b>things</b> in the IoT</li> |
| <li class="fragment" style="margin-top: 0.8em;">provide state <b>persistence</b> and <b>search</b> capabilities</li> |
| <li class="fragment" style="margin-top: 0.8em;">access twins always in an <b>authorized</b> way</li> |
| <li class="fragment" style="margin-top: 0.8em;">provide APIs - <b>Device as a Service</b></li> |
| <li class="fragment" style="margin-top: 0.8em;"><b>normalize</b> device payloads</li> |
| </ul> |
| </section> |
| </section> |
| |
| <!-- Section: Ditto --> |
| <section style="clear: both;"> |
| <section id="ditto-1" style="clear: both;"> |
| <h2>Eclipse Ditto in context</h2> |
| <div style="text-align: left; float: left; width: 65%"> |
| <img src="../images/ditto-in-action-2020.png" style="width: 90%;padding-top:0.5em" alt="Ditto in action"/> |
| </div> |
| <div style="text-align: left; float: right; width: 35%"> |
| <p style="padding-top:3.5em">Ditto as <br/>Digital Twin<br/> "middleware"</p> |
| </div> |
| </section> |
| <section id="ditto-2" style="clear: both;"> |
| <h2>turn device data into APIs</h2> |
| <div style="text-align: left; float: left; width: 38%"> |
| <pre style="width: 100%; font-size: 0.45em;"><code class="hljs json">{ |
| "thingId": "io.foo:car1", |
| "policyId": "io.foo:car1", |
| "attributes": { |
| "manufacturer": "Foo corp", |
| "productionData": { |
| "serialNo": 4711 |
| } |
| }, |
| "features": { |
| "temperature": { |
| "properties": { |
| "value": 23.42 |
| } |
| } |
| } |
| }</code></pre> |
| <p style="text-align: center">JSON repr. of a Thing</p> |
| </div> |
| <div style="text-align: left; float: right; width: 60%" class="fragment"> |
| <pre style="width: 105%; font-size: 0.45em;"><code class="hljs">GET/PUT/DELETE /api/2/things/io.foo:car1 |
| /api/2/things/io.foo:car1/thingId |
| /api/2/things/io.foo:car1/policyId |
| /api/2/things/io.foo:car1/attributes |
| /api/2/things/io.foo:car1/attributes/manufacturer |
| /api/2/things/io.foo:car1/attributes/productionData |
| /api/2/things/io.foo:car1/attributes/productionData/serialNo |
| |
| |
| /api/2/things/io.foo:car1/features |
| /api/2/things/io.foo:car1/features/temperature |
| /api/2/things/io.foo:car1/features/temperature/properties |
| /api/2/things/io.foo:car1/features/temperature/properties/value |
| |
| |
| |
| |
| </code></pre> |
| <a href="https://www.eclipse.org/ditto/httpapi-concepts.html#endpoints" style="float: right; font-size: 0.7em">→ docs</a> |
| </div> |
| </section> |
| <section id="ditto-3" style="clear: both;"> |
| <h2>modeling thing capabilities</h2> |
| <div style="text-align: left; float: left; width: 70%"> |
| <ul> |
| <li style="margin-top: 0.8em; font-size: 0.8em">by default, thing attributes and feature properties are "schemaless"</li> |
| <li class="fragment" data-fragment-index="1" style="margin-top: 0.8em; font-size: 0.8em">a feature may be aware of several "definitions" linking to a model</li> |
| </ul> |
| </div> |
| <div style="text-align: left; float: right; width: 25%"> |
| <img src="../../images/pages/basic/ditto-thing-feature-definition-model.png" style="width: 110%" alt="Ditto thing feature definition model"> |
| <a href="https://www.eclipse.org/ditto/basic-feature.html#feature-definition" style="float: right; font-size: 0.7em">→ docs</a> |
| </div> |
| |
| <ul style="clear: both"> |
| <li class="fragment" data-fragment-index="2" style="margin-top: 0.8em; font-size: 0.8em">a thing may be aware of one "definition" listing which features/aspects it provides |
| </li> |
| </ul> |
| </section> |
| <section id="ditto-4" style="clear: both;"> |
| <h2>persistence of device state</h2> |
| <br/> |
| <div style="text-align: left; float: left; width: 48%"> |
| <ul> |
| <li>devices are not always connected to the net</li> |
| <li class="fragment" data-fragment-index="1" style="margin-top: 1em;">applications always need to be able to access their data</li> |
| <li class="fragment" data-fragment-index="2" style="margin-top: 1em;"><b>twin</b> vs. <b>live</b> access on API level</li> |
| </ul> |
| </div> |
| <div class="fragment" data-fragment-index="2" style="text-align: left; float: right; width: 50%"> |
| <img src="../../images/pages/protocol/ditto-twin-channel.png" style="width: 110%" alt="Ditto twin channel"> |
| <img src="../../images/pages/protocol/ditto-live-channel.png" style="width: 80%;padding-left: 1em" alt="Ditto live channel"> |
| </div> |
| </section> |
| <section id="ditto-5" style="clear: both"> |
| <h2>authorization</h2> |
| <br/> |
| <div style="text-align: left; float: left; width: 58%"> |
| <br/> |
| <ul> |
| <li>Ditto contains a built-in authorization mechanism (<b>Policies</b>)</li> |
| <li class="fragment" style="margin-top: 1em;">every API call is authorized</li> |
| </ul> |
| </div> |
| <a href="https://www.eclipse.org/ditto/basic-auth.html#authorization" style="float: right; font-size: 0.7em">→ docs</a> |
| </section> |
| <section id="ditto-6" style="clear: both;"> |
| <h2>search</h2> |
| <br/> |
| <div style="text-align: left; float: left; width: 40%"> |
| <img src="../images/meme-dino.jpg" style="width: 80%;" alt="Meme Dino" /> |
| <ul style="font-size: 0.7em"> |
| <li>you must not</li> |
| <li>Ditto has you covered</li> |
| </ul> |
| </div> |
| <div style="text-align: left; float: right; width: 60%" class="fragment" data-fragment-index="1"> |
| <pre style="width: 100%; font-size: 0.45em;"><code class="hljs javascript">GET /api/2/search/things |
| ?filter=like(attributes/manufacturer,"Foo*")</code></pre> |
| <pre style="width: 100%; font-size: 0.45em;" class="fragment" data-fragment-index="2"><code class="hljs javascript">GET /api/2/search/things |
| ?filter=and( |
| exists(attributes/manufacturer), |
| gt(features/temperature/properties/value,23.0) |
| ) |
| &namespaces=io.foo |
| &option=sort(-_modified,-attributes/manufacturer) |
| &fields=thingId,attributes/manufacturer,_modified</code></pre> |
| </div> |
| <div class="fragment" data-fragment-index="2"> |
| <ul style="font-size: 0.7em"> |
| <li>search for arbitrary data with RQL query</li> |
| <li>Ditto again ensures authorization</li> |
| <li>apply field projection over the results</li> |
| <li>don't worry about indexing</li> |
| </ul> |
| <a href="https://www.eclipse.org/ditto/basic-search.html" style="float: right; font-size: 0.7em">→ docs</a> |
| </div> |
| </section> |
| <section id="ditto-7" style="clear: both;"> |
| <h2>get notified about changes</h2> |
| <br/> |
| <ul> |
| <li>notification via various channels: WebSocket, SSE, MQTT (3.1.1 | 5), AMQP (0.9.1 | 1.0), Apache Kafka, HTTP hook</li> |
| <li class="fragment" style="margin-top: 1em;">server side filtering via RQL (same as in search)</li> |
| </ul> |
| <div class="fragment"> |
| <a href="https://www.eclipse.org/ditto/basic-changenotifications.html" style="float: right; font-size: 0.7em">→ docs</a> |
| </div> |
| </section> |
| </section> |
| |
| <!-- Section: Ditto + WoT --> |
| <section style="clear: both;"> |
| <section id="ditto-wot" class="new-chapter" data-background="../bg-images/background-cloud-small.jpg" |
| data-state="chapter-background"> |
| <!-- background source: http://wallpapercave.com/wp/WkziiJQ.jpg --> |
| <h1>Eclipse Ditto +</h1> |
| <img src="../images/wot.png" alt="W3C Web of Things logo" style="width: 40%"/> |
| </section> |
| <section id="ditto-wot-1" style="clear: both;"> |
| <h2>could benefit from each other</h2> |
| <br/> |
| <ul> |
| <li>Eclipse Ditto bringing scalable "cloud-ready" digital twin framework to the table</li> |
| <li class="fragment" data-fragment-index="1" style="margin-top: 0.5em;">Ditto currently lacks modeling things</li> |
| <li class="fragment" data-fragment-index="2" style="margin-top: 0.5em;">WoT "Thing Models" could be a good fit for feature "definitions"</li> |
| <li class="fragment" data-fragment-index="3" style="margin-top: 0.5em;">later: WoT TD facade in Ditto?</li> |
| </ul> |
| </section> |
| </section> |
| |
| <!-- Section: Wrap up --> |
| <section style="clear: both;"> |
| <section id="wrap-up" style="clear: both;"> |
| <h1>Wrap up</h1> |
| <br/> |
| <ul> |
| <li>Digital Twins as pattern for simplifying IoT solution development</li> |
| <li style="margin-top: 1em;">Mission: provide Device-as-a-Service</li> |
| <li style="margin-top: 1em;">Eclipse Ditto as OpenSource framework for Digital Twins</li> |
| </ul> |
| </section> |
| </section> |
| |
| <!-- Section: Questions and Answers --> |
| <section style="clear: both;"> |
| <section id="q-a" class="new-chapter" data-background="../bg-images/background-conclusion-small.jpg" |
| data-state="chapter-background"> |
| <br/> |
| <p>Links:</p> |
| <ul> |
| <li><a target="_blank" href="https://eclipse.org/ditto">Ditto website and documentation</a></li> |
| <li><a target="_blank" href="https://github.org/eclipse/ditto">GitHub</a> - please give us a star ;)</li> |
| <li><a target="_blank" href="https://gitter.im/eclipse/ditto">Chatroom to ask more questions</a></li> |
| <li><a target="_blank" href="https://developer.bosch-iot-suite.com/service/things/">Commercial offering incl. free plan</a></li> |
| </ul> |
| </section> |
| </section> |
| </div> |
| |
| </div> |
| |
| <div class="footer"> |
| Copyright ©2021 |
| <a href="https://www.bosch.io" target="_blank">Bosch.IO GmbH</a> All rights reserved. | |
| <a href="https://www.eclipse.org/ditto/intro-overview.html" target="_blank">Documentation</a> | |
| <a href="https://github.com/eclipse/ditto" target="_blank">GitHub</a> | |
| <a href="https://ditto.eclipseprojects.io" target="_blank">Sandbox</a> |
| </div> |
| |
| <script src="https://cdnjs.cloudflare.com/ajax/libs/reveal.js/3.6.0/lib/js/head.min.js"></script> |
| <script src="https://cdnjs.cloudflare.com/ajax/libs/reveal.js/3.6.0/js/reveal.min.js"></script> |
| |
| <script> |
| function getParameterByName(name, url) { |
| if (!url) { |
| url = window.location.href; |
| } |
| name = name.replace(/[\[\]]/g, "\\$&"); |
| var regex = new RegExp("[?&]" + name + "(=([^&#]*)|&|#|$)"), |
| results = regex.exec(url); |
| if (!results) { |
| return null; |
| } |
| if (!results[2]) { |
| return ''; |
| } |
| return decodeURIComponent(results[2].replace(/\+/g, " ")); |
| } |
| |
| // More info https://github.com/hakimel/reveal.js#configuration |
| Reveal.initialize({ |
| controls: true, |
| progress: true, |
| history: true, |
| center: true, |
| fragments: getParameterByName('fragments') === '', // only use "fragments" feature if queryParam 'fragments' is present |
| slideNumber: 'h.v', |
| |
| transition: 'convex', // none/fade/cube/slide/convex/concave/zoom |
| |
| // More info https://github.com/hakimel/reveal.js#dependencies |
| dependencies: [ |
| { |
| src: 'https://cdnjs.cloudflare.com/ajax/libs/reveal.js/3.6.0/lib/js/classList.js', |
| condition: function () { |
| return !document.body.classList; |
| } |
| }, |
| { |
| src: 'https://cdnjs.cloudflare.com/ajax/libs/reveal.js/3.6.0/plugin/markdown/marked.js', |
| condition: function () { |
| return !!document.querySelector('[data-markdown]'); |
| } |
| }, |
| { |
| src: 'https://cdnjs.cloudflare.com/ajax/libs/reveal.js/3.6.0/plugin/markdown/markdown.min.js', |
| condition: function () { |
| return !!document.querySelector('[data-markdown]'); |
| } |
| }, |
| { |
| src: 'https://cdnjs.cloudflare.com/ajax/libs/reveal.js/3.6.0/plugin/highlight/highlight.min.js', |
| async: true, |
| callback: function () { |
| hljs.initHighlightingOnLoad(); |
| } |
| }, |
| { |
| src: 'https://cdnjs.cloudflare.com/ajax/libs/reveal.js/3.6.0/plugin/zoom-js/zoom.min.js', |
| async: true |
| }, |
| { |
| src: 'https://cdnjs.cloudflare.com/ajax/libs/reveal.js/3.6.0/plugin/notes/notes.min.js', |
| async: true |
| } |
| ], |
| keyboard: { // for hama remote presenter: |
| 38: 'next', |
| 40: 'prev' |
| } |
| }); |
| |
| </script> |
| |
| <script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/2.2.4/jquery.min.js"></script> |
| <script type="text/javascript"> |
| // 3. On Reveal.js ready event, copy header/footer <div> into each `.slide-background` <div> |
| var header = $('#header').html(); |
| if (window.location.search.match(/print-pdf/gi)) { |
| Reveal.addEventListener('ready', function (event) { |
| $('.slide-background').append(header); |
| }); |
| } |
| else { |
| $('div.reveal').append(header); |
| } |
| </script> |
| |
| </body> |
| </html> |