Update website
diff --git a/concepts/index.html b/concepts/index.html
index 1290b28..1372ec4 100644
--- a/concepts/index.html
+++ b/concepts/index.html
@@ -10,7 +10,7 @@
<meta name="viewport" content="width=device-width,user-scalable=no,initial-scale=1,maximum-scale=1">
<meta http-equiv="X-UA-Compatible" content="IE=10" />
<title>Concepts - Eclipse Mita</title>
- <meta name="generator" content="Hugo 0.42.1" />
+ <meta name="generator" content="Hugo 0.40.1" />
<meta name="description" content="The documentation of Eclipse Mita.">
@@ -347,6 +347,19 @@
+<a title="Arduino Uno" href="../platforms/arduinouno/">
+
+ Arduino Uno
+</a>
+
+
+
+
+
+
+
+
+
<a title="XDK110" href="../platforms/xdk110/">
XDK110
diff --git a/download/index.html b/download/index.html
index c20e281..60e2b1f 100644
--- a/download/index.html
+++ b/download/index.html
@@ -10,7 +10,7 @@
<meta name="viewport" content="width=device-width,user-scalable=no,initial-scale=1,maximum-scale=1">
<meta http-equiv="X-UA-Compatible" content="IE=10" />
<title>Download - Eclipse Mita</title>
- <meta name="generator" content="Hugo 0.42.1" />
+ <meta name="generator" content="Hugo 0.40.1" />
<meta name="description" content="The documentation of Eclipse Mita.">
@@ -344,6 +344,19 @@
+<a title="Arduino Uno" href="../platforms/arduinouno/">
+
+ Arduino Uno
+</a>
+
+
+
+
+
+
+
+
+
<a title="XDK110" href="../platforms/xdk110/">
XDK110
diff --git a/faq/index.html b/faq/index.html
index 5043e39..370cff0 100644
--- a/faq/index.html
+++ b/faq/index.html
@@ -10,7 +10,7 @@
<meta name="viewport" content="width=device-width,user-scalable=no,initial-scale=1,maximum-scale=1">
<meta http-equiv="X-UA-Compatible" content="IE=10" />
<title>Frequently Asked Questions - Eclipse Mita</title>
- <meta name="generator" content="Hugo 0.42.1" />
+ <meta name="generator" content="Hugo 0.40.1" />
<meta name="description" content="The documentation of Eclipse Mita.">
@@ -344,6 +344,19 @@
+<a title="Arduino Uno" href="../platforms/arduinouno/">
+
+ Arduino Uno
+</a>
+
+
+
+
+
+
+
+
+
<a title="XDK110" href="../platforms/xdk110/">
XDK110
diff --git a/index.html b/index.html
index afc7251..37ad00f 100644
--- a/index.html
+++ b/index.html
@@ -10,7 +10,7 @@
<meta name="viewport" content="width=device-width,user-scalable=no,initial-scale=1,maximum-scale=1">
<meta http-equiv="X-UA-Compatible" content="IE=10" />
<title>Eclipse Mita</title>
- <meta name="generator" content="Hugo 0.42.1" />
+ <meta name="generator" content="Hugo 0.40.1" />
<meta name="description" content="The documentation of Eclipse Mita.">
@@ -347,6 +347,19 @@
+<a title="Arduino Uno" href="./platforms/arduinouno/">
+
+ Arduino Uno
+</a>
+
+
+
+
+
+
+
+
+
<a title="XDK110" href="./platforms/xdk110/">
XDK110
@@ -387,7 +400,7 @@
<span class="kd">var</span> <span class="nx">shockDetected</span> <span class="o">=</span> <span class="nx">bool_characteristic</span><span class="p">(</span><span class="nx">UUID</span><span class="o">=</span><span class="mh">0xCAFE</span><span class="p">);</span>
<span class="p">}</span>
-<span class="nx">every</span> <span class="nx">accelerometer</span><span class="p">.</span><span class="nx">activity</span> <span class="p">{</span>
+<span class="nx">every</span> <span class="nx">accelerometer</span><span class="p">.</span><span class="nx">any_motion</span> <span class="p">{</span>
<span class="k">if</span><span class="p">(</span><span class="nx">accelerometer</span><span class="p">.</span><span class="nx">magnitude</span><span class="p">.</span><span class="nx">read</span><span class="p">()</span> <span class="o">></span> <span class="mi">5000</span><span class="p">)</span> <span class="p">{</span>
<span class="nx">smartphone</span><span class="p">.</span><span class="nx">shockDetected</span><span class="p">.</span><span class="nx">write</span><span class="p">(</span><span class="kc">true</span><span class="p">);</span>
<span class="p">}</span>
diff --git a/index.xml b/index.xml
index d096a65..988c80e 100644
--- a/index.xml
+++ b/index.xml
@@ -122,6 +122,16 @@
</item>
<item>
+ <title>Arduino Uno</title>
+ <link>/platforms/arduinouno/</link>
+ <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+
+ <guid>/platforms/arduinouno/</guid>
+ <description>The Arduino Uno is a popular platform for &ldquo;physical computing&rdquo; and first steps in embedded computing. It is based on an 8-bit Atmega microcontroller and ships with a powerful hardware abstraction library. Currently, the Mita Arduino Uno platform supports basic functionality, namely working with buttons and GPIO pins.
+Sensor: button_one (Button) Modalities Name Description is_pressed : bool True if the button is pressed in this very right moment.</description>
+ </item>
+
+ <item>
<title>Exceptions</title>
<link>/language/exceptions/</link>
<pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
diff --git a/language/arrays/index.html b/language/arrays/index.html
index 426d5cf..d1b9592 100644
--- a/language/arrays/index.html
+++ b/language/arrays/index.html
@@ -10,7 +10,7 @@
<meta name="viewport" content="width=device-width,user-scalable=no,initial-scale=1,maximum-scale=1">
<meta http-equiv="X-UA-Compatible" content="IE=10" />
<title>Arrays - Eclipse Mita</title>
- <meta name="generator" content="Hugo 0.42.1" />
+ <meta name="generator" content="Hugo 0.40.1" />
<meta name="description" content="The documentation of Eclipse Mita.">
@@ -347,6 +347,19 @@
+<a title="Arduino Uno" href="../../platforms/arduinouno/">
+
+ Arduino Uno
+</a>
+
+
+
+
+
+
+
+
+
<a title="XDK110" href="../../platforms/xdk110/">
XDK110
diff --git a/language/basics/index.html b/language/basics/index.html
index 107de4f..f4f1233 100644
--- a/language/basics/index.html
+++ b/language/basics/index.html
@@ -10,7 +10,7 @@
<meta name="viewport" content="width=device-width,user-scalable=no,initial-scale=1,maximum-scale=1">
<meta http-equiv="X-UA-Compatible" content="IE=10" />
<title>Basics - Eclipse Mita</title>
- <meta name="generator" content="Hugo 0.42.1" />
+ <meta name="generator" content="Hugo 0.40.1" />
<meta name="description" content="The documentation of Eclipse Mita.">
@@ -347,6 +347,19 @@
+<a title="Arduino Uno" href="../../platforms/arduinouno/">
+
+ Arduino Uno
+</a>
+
+
+
+
+
+
+
+
+
<a title="XDK110" href="../../platforms/xdk110/">
XDK110
diff --git a/language/events/index.html b/language/events/index.html
index e0610de..51dc57a 100644
--- a/language/events/index.html
+++ b/language/events/index.html
@@ -10,7 +10,7 @@
<meta name="viewport" content="width=device-width,user-scalable=no,initial-scale=1,maximum-scale=1">
<meta http-equiv="X-UA-Compatible" content="IE=10" />
<title>Events - Eclipse Mita</title>
- <meta name="generator" content="Hugo 0.42.1" />
+ <meta name="generator" content="Hugo 0.40.1" />
<meta name="description" content="The documentation of Eclipse Mita.">
@@ -347,6 +347,19 @@
+<a title="Arduino Uno" href="../../platforms/arduinouno/">
+
+ Arduino Uno
+</a>
+
+
+
+
+
+
+
+
+
<a title="XDK110" href="../../platforms/xdk110/">
XDK110
@@ -434,14 +447,14 @@
<div class="next">
- <a href="../../language/exceptions/" title="Exceptions">
+ <a href="../../platforms/arduinouno/" title="Arduino Uno">
<span class="direction">
Next
</span>
<div class="page">
<div class="stretch">
<div class="title">
- Exceptions
+ Arduino Uno
</div>
</div>
<div class="button button-next" role="button" aria-label="Next">
diff --git a/language/exceptions/index.html b/language/exceptions/index.html
index 9210215..cbc9f48 100644
--- a/language/exceptions/index.html
+++ b/language/exceptions/index.html
@@ -10,7 +10,7 @@
<meta name="viewport" content="width=device-width,user-scalable=no,initial-scale=1,maximum-scale=1">
<meta http-equiv="X-UA-Compatible" content="IE=10" />
<title>Exceptions - Eclipse Mita</title>
- <meta name="generator" content="Hugo 0.42.1" />
+ <meta name="generator" content="Hugo 0.40.1" />
<meta name="description" content="The documentation of Eclipse Mita.">
@@ -347,6 +347,19 @@
+<a title="Arduino Uno" href="../../platforms/arduinouno/">
+
+ Arduino Uno
+</a>
+
+
+
+
+
+
+
+
+
<a title="XDK110" href="../../platforms/xdk110/">
XDK110
@@ -434,7 +447,7 @@
<nav class="pagination" aria-label="Footer">
<div class="previous">
- <a href="../../language/events/" title="Events">
+ <a href="../../platforms/arduinouno/" title="Arduino Uno">
<span class="direction">
Previous
</span>
@@ -444,7 +457,7 @@
</div>
<div class="stretch">
<div class="title">
- Events
+ Arduino Uno
</div>
</div>
</div>
diff --git a/language/foreignfunctioninterface/index.html b/language/foreignfunctioninterface/index.html
index 2809a28..f881feb 100644
--- a/language/foreignfunctioninterface/index.html
+++ b/language/foreignfunctioninterface/index.html
@@ -10,7 +10,7 @@
<meta name="viewport" content="width=device-width,user-scalable=no,initial-scale=1,maximum-scale=1">
<meta http-equiv="X-UA-Compatible" content="IE=10" />
<title>Foreign Function Interface - Eclipse Mita</title>
- <meta name="generator" content="Hugo 0.42.1" />
+ <meta name="generator" content="Hugo 0.40.1" />
<meta name="description" content="The documentation of Eclipse Mita.">
@@ -347,6 +347,19 @@
+<a title="Arduino Uno" href="../../platforms/arduinouno/">
+
+ Arduino Uno
+</a>
+
+
+
+
+
+
+
+
+
<a title="XDK110" href="../../platforms/xdk110/">
XDK110
diff --git a/language/functions/index.html b/language/functions/index.html
index 1a92aa5..b4ac9d2 100644
--- a/language/functions/index.html
+++ b/language/functions/index.html
@@ -10,7 +10,7 @@
<meta name="viewport" content="width=device-width,user-scalable=no,initial-scale=1,maximum-scale=1">
<meta http-equiv="X-UA-Compatible" content="IE=10" />
<title>Functions - Eclipse Mita</title>
- <meta name="generator" content="Hugo 0.42.1" />
+ <meta name="generator" content="Hugo 0.40.1" />
<meta name="description" content="The documentation of Eclipse Mita.">
@@ -347,6 +347,19 @@
+<a title="Arduino Uno" href="../../platforms/arduinouno/">
+
+ Arduino Uno
+</a>
+
+
+
+
+
+
+
+
+
<a title="XDK110" href="../../platforms/xdk110/">
XDK110
diff --git a/language/introduction/index.html b/language/introduction/index.html
index 37ad590..d6a97f8 100644
--- a/language/introduction/index.html
+++ b/language/introduction/index.html
@@ -10,7 +10,7 @@
<meta name="viewport" content="width=device-width,user-scalable=no,initial-scale=1,maximum-scale=1">
<meta http-equiv="X-UA-Compatible" content="IE=10" />
<title>Introduction - Eclipse Mita</title>
- <meta name="generator" content="Hugo 0.42.1" />
+ <meta name="generator" content="Hugo 0.40.1" />
<meta name="description" content="The documentation of Eclipse Mita.">
@@ -347,6 +347,19 @@
+<a title="Arduino Uno" href="../../platforms/arduinouno/">
+
+ Arduino Uno
+</a>
+
+
+
+
+
+
+
+
+
<a title="XDK110" href="../../platforms/xdk110/">
XDK110
diff --git a/language/packages/index.html b/language/packages/index.html
index 4e1eaca..d5ecca5 100644
--- a/language/packages/index.html
+++ b/language/packages/index.html
@@ -10,7 +10,7 @@
<meta name="viewport" content="width=device-width,user-scalable=no,initial-scale=1,maximum-scale=1">
<meta http-equiv="X-UA-Compatible" content="IE=10" />
<title>Packages - Eclipse Mita</title>
- <meta name="generator" content="Hugo 0.42.1" />
+ <meta name="generator" content="Hugo 0.40.1" />
<meta name="description" content="The documentation of Eclipse Mita.">
@@ -347,6 +347,19 @@
+<a title="Arduino Uno" href="../../platforms/arduinouno/">
+
+ Arduino Uno
+</a>
+
+
+
+
+
+
+
+
+
<a title="XDK110" href="../../platforms/xdk110/">
XDK110
diff --git a/language/setup/index.html b/language/setup/index.html
index c51187a..fd8c89f 100644
--- a/language/setup/index.html
+++ b/language/setup/index.html
@@ -10,7 +10,7 @@
<meta name="viewport" content="width=device-width,user-scalable=no,initial-scale=1,maximum-scale=1">
<meta http-equiv="X-UA-Compatible" content="IE=10" />
<title>System Setup - Eclipse Mita</title>
- <meta name="generator" content="Hugo 0.42.1" />
+ <meta name="generator" content="Hugo 0.40.1" />
<meta name="description" content="The documentation of Eclipse Mita.">
@@ -347,6 +347,19 @@
+<a title="Arduino Uno" href="../../platforms/arduinouno/">
+
+ Arduino Uno
+</a>
+
+
+
+
+
+
+
+
+
<a title="XDK110" href="../../platforms/xdk110/">
XDK110
diff --git a/language/types/index.html b/language/types/index.html
index 75de4e1..3532740 100644
--- a/language/types/index.html
+++ b/language/types/index.html
@@ -10,7 +10,7 @@
<meta name="viewport" content="width=device-width,user-scalable=no,initial-scale=1,maximum-scale=1">
<meta http-equiv="X-UA-Compatible" content="IE=10" />
<title>Types - Eclipse Mita</title>
- <meta name="generator" content="Hugo 0.42.1" />
+ <meta name="generator" content="Hugo 0.40.1" />
<meta name="description" content="The documentation of Eclipse Mita.">
@@ -347,6 +347,19 @@
+<a title="Arduino Uno" href="../../platforms/arduinouno/">
+
+ Arduino Uno
+</a>
+
+
+
+
+
+
+
+
+
<a title="XDK110" href="../../platforms/xdk110/">
XDK110
diff --git a/platforms/arduinouno/index.html b/platforms/arduinouno/index.html
new file mode 100644
index 0000000..393ca74
--- /dev/null
+++ b/platforms/arduinouno/index.html
@@ -0,0 +1,709 @@
+<!DOCTYPE html>
+
+
+
+
+ <html class="no-js">
+
+ <head lang="en-us">
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width,user-scalable=no,initial-scale=1,maximum-scale=1">
+ <meta http-equiv="X-UA-Compatible" content="IE=10" />
+ <title>Arduino Uno - Eclipse Mita</title>
+ <meta name="generator" content="Hugo 0.40.1" />
+
+
+ <meta name="description" content="The documentation of Eclipse Mita.">
+
+ <link rel="canonical" href="../../platforms/arduinouno/">
+
+
+ <meta property="og:url" content="/platforms/arduinouno/">
+ <meta property="og:title" content="Eclipse Mita">
+ <meta property="og:image" content="/images/mita.svg">
+ <meta name="apple-mobile-web-app-title" content="Eclipse Mita">
+ <meta name="apple-mobile-web-app-capable" content="yes">
+ <meta name="apple-mobile-web-app-status-bar-style" content="black-translucent">
+
+ <link rel="shortcut icon" type="image/x-icon" href="../../images/favicon.ico">
+ <link rel="icon" type="image/x-icon" href="../../images/favicon.ico">
+
+ <style>
+ @font-face {
+ font-family: 'Icon';
+ src: url('/fonts/icon.eot');
+ src: url('/fonts/icon.eot')
+ format('embedded-opentype'),
+ url('/fonts/icon.woff')
+ format('woff'),
+ url('/fonts/icon.ttf')
+ format('truetype'),
+ url('/fonts/icon.svg')
+ format('svg');
+ font-weight: normal;
+ font-style: normal;
+ }
+ </style>
+
+ <link rel="stylesheet" href="../../stylesheets/application.css">
+ <link rel="stylesheet" href="../../stylesheets/temporary.css">
+ <link rel="stylesheet" href="../../stylesheets/palettes.css">
+ <link rel="stylesheet" href="../../stylesheets/highlight/highlight.css">
+
+
+
+
+ <link rel="stylesheet" href="//fonts.googleapis.com/css?family=Ubuntu:400,700|Ubuntu+Mono">
+ <style>
+ body, input {
+ font-family: 'Ubuntu', Helvetica, Arial, sans-serif;
+ }
+ pre, code {
+ font-family: 'Ubuntu Mono', 'Courier New', 'Courier', monospace;
+ }
+ </style>
+
+
+ <link rel="stylesheet" href="../../css/custom.css">
+
+ <script src="../../javascripts/modernizr.js"></script>
+
+
+
+ </head>
+ <body class="palette-primary-blue-grey palette-accent-light-blue">
+
+
+
+
+<div class="backdrop">
+ <div class="backdrop-paper"></div>
+</div>
+
+<input class="toggle" type="checkbox" id="toggle-drawer">
+<input class="toggle" type="checkbox" id="toggle-search">
+<label class="toggle-button overlay" for="toggle-drawer"></label>
+
+<header class="header">
+ <nav aria-label="Header">
+ <div class="bar default">
+ <div class="button button-menu" role="button" aria-label="Menu">
+ <label class="toggle-button icon icon-menu" for="toggle-drawer">
+ <span></span>
+ </label>
+ </div>
+ <div class="stretch">
+ <div class="title">
+ Arduino Uno
+ </div>
+ </div>
+
+
+ <div class="button button-twitter" role="button" aria-label="Twitter">
+ <a href="https://twitter.com/eclipse_mita" title="@eclipse_mita on Twitter" target="_blank" class="toggle-button icon icon-twitter"></a>
+ </div>
+
+
+
+ <div class="button button-github" role="button" aria-label="GitHub">
+ <a href="https://github.com/eclipse/mita" title="@eclipse/mita on GitHub" target="_blank" class="toggle-button icon icon-github"></a>
+ </div>
+
+
+
+ </div>
+ <div class="bar search">
+ <div class="button button-close" role="button" aria-label="Close">
+ <label class="toggle-button icon icon-back" for="toggle-search"></label>
+ </div>
+ <div class="stretch">
+ <div class="field">
+ <input class="query" type="text" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck>
+ </div>
+ </div>
+ <div class="button button-reset" role="button" aria-label="Search">
+ <button class="toggle-button icon icon-close" id="reset-search"></button>
+ </div>
+ </div>
+</nav>
+</header>
+
+<main class="main">
+ <div class="drawer">
+ <nav aria-label="Navigation">
+ <a href="../../" class="project">
+ <div class="banner">
+
+ <div class="logo">
+ <img src="../../images/mita.svg">
+ </div>
+
+ <div class="name">
+ <strong>Eclipse Mita </strong>
+
+ </div>
+ </div>
+ </a>
+
+ <div class="scrollable">
+ <div class="wrapper">
+
+
+ <div class="toc">
+
+ <ul>
+
+
+
+
+
+<li>
+
+
+
+
+
+<a title="Download" href="http://github.com/eclipse/mita">
+
+ Download
+</a>
+
+
+
+
+</li>
+
+
+
+<li>
+
+
+
+
+
+<a title="Concepts" href="../../concepts/">
+
+ Concepts
+</a>
+
+
+
+
+</li>
+
+
+
+<li>
+
+ <span class="section">Language</span>
+ <ul>
+
+
+
+
+
+
+<a title="Introduction" href="../../language/introduction/">
+
+ Introduction
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Basics" href="../../language/basics/">
+
+ Basics
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Packages" href="../../language/packages/">
+
+ Packages
+</a>
+
+
+
+
+
+
+
+
+
+<a title="System Setup" href="../../language/setup/">
+
+ System Setup
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Types" href="../../language/types/">
+
+ Types
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Arrays" href="../../language/arrays/">
+
+ Arrays
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Functions" href="../../language/functions/">
+
+ Functions
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Foreign Function Interface" href="../../language/foreignfunctioninterface/">
+
+ Foreign Function Interface
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Events" href="../../language/events/">
+
+ Events
+</a>
+
+
+
+
+
+
+
+
+
+<a title="Exceptions" href="../../language/exceptions/">
+
+ Exceptions
+</a>
+
+
+
+
+ </ul>
+
+</li>
+
+
+
+<li>
+
+ <span class="section">Platforms</span>
+ <ul>
+
+
+
+
+
+
+<a class="current" title="Arduino Uno" href="../../platforms/arduinouno/">
+
+ Arduino Uno
+</a>
+
+
+<ul id="scrollspy">
+</ul>
+
+
+
+
+
+
+
+
+<a title="XDK110" href="../../platforms/xdk110/">
+
+ XDK110
+</a>
+
+
+
+
+ </ul>
+
+</li>
+
+
+ </ul>
+
+
+
+ </div>
+ </div>
+ </div>
+</nav>
+
+ </div>
+
+ <article class="article">
+ <div class="wrapper">
+ <h1>Arduino Uno </h1>
+
+
+
+<p>The <a href="https://www.arduino.cc/en/Main/ArduinoBoardUno?setlang=en">Arduino Uno</a> is a popular platform for “physical computing” and first steps in embedded computing.
+It is based on an 8-bit Atmega microcontroller and ships with a powerful hardware abstraction library.
+Currently, the Mita Arduino Uno platform supports basic functionality, namely working with buttons and GPIO pins.</p>
+
+<h2 id="sensor-button-one-button">Sensor: button_one (Button)</h2>
+
+<h4 id="modalities">Modalities</h4>
+
+<table>
+ <thead>
+ <tr>
+ <td>Name</td>
+ <td>Description</td>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><div class="highlight"><pre><b>is_pressed</b> : <span class="kt">bool</span></pre></div></td>
+ <td>True if the button is pressed in this very right moment. False otherwise.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h4 id="events">Events</h4>
+
+<table>
+ <thead>
+ <tr>
+ <td>Name</td>
+ <td>Description</td>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><div class="highlight"><pre><b>pressed</b></pre></div></td>
+ <td>Fires after the button was pressed.</td>
+ </tr>
+ <tr>
+ <td><div class="highlight"><pre><b>released</b></pre></div></td>
+ <td>Fires after the button was released.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h2 id="sensor-button-two-button">Sensor: button_two (Button)</h2>
+
+<h4 id="modalities-1">Modalities</h4>
+
+<table>
+ <thead>
+ <tr>
+ <td>Name</td>
+ <td>Description</td>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><div class="highlight"><pre><b>is_pressed</b> : <span class="kt">bool</span></pre></div></td>
+ <td>True if the button is pressed in this very right moment. False otherwise.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h4 id="events-1">Events</h4>
+
+<table>
+ <thead>
+ <tr>
+ <td>Name</td>
+ <td>Description</td>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><div class="highlight"><pre><b>pressed</b></pre></div></td>
+ <td>Fires after the button was pressed.</td>
+ </tr>
+ <tr>
+ <td><div class="highlight"><pre><b>released</b></pre></div></td>
+ <td>Fires after the button was released.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h2 id="buses-gpio">Buses: GPIO</h2>
+
+<p>Can be used to write and read digital ports, as known from the Arduino Uno</p>
+
+<h3 id="signals">Signals</h3>
+
+<table>
+ <thead>
+ <tr>
+ <td>Name</td>
+ <td>Description</td>
+ <td>Parameters</td>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><div class="highlight"><pre><b>pinMode</b> : <span class="kt">bool</span></pre></div></td>
+ <td></td>
+ <td>
+ <ul>
+ <li>
+ <div class="highlight"><pre> <b>pin</b> : <span class="kt">LedColor</span></pre></div>
+ </li>
+ </ul>
+ </td>
+ </tr>
+ </tbody>
+</table>
+
+<p>##Example</p>
+
+<p>This example uses the first button connected to the hardware Pin 1 and two leds connected to pin 12 and 13.
+The yellow led can get turned off by pressing the button one and turned off again by pressing the button again.
+The red led will get turned on for one second and then turned off for one second.</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="kr">package</span> <span class="nx">main</span><span class="p">;</span>
+<span class="kr">import</span> <span class="nx">platforms</span><span class="p">.</span><span class="nx">arduino</span><span class="p">.</span><span class="nx">uno</span><span class="p">;</span>
+
+<span class="nx">setup</span> <span class="nx">hmi</span> : <span class="kt">GPIO</span> <span class="p">{</span>
+ <span class="kd">var</span> <span class="nx">yellow</span> <span class="o">=</span> <span class="nx">pinMode</span><span class="p">(</span><span class="nx">p13</span><span class="p">,</span> <span class="nx">OUTPUT</span><span class="p">);</span>
+ <span class="kd">var</span> <span class="nx">red</span> <span class="o">=</span> <span class="nx">pinMode</span><span class="p">(</span><span class="nx">p12</span><span class="p">,</span> <span class="nx">OUTPUT</span><span class="p">);</span>
+<span class="p">}</span>
+
+<span class="nx">every</span> <span class="nx">button_one</span><span class="p">.</span><span class="nx">pressed</span> <span class="p">{</span>
+ <span class="k">if</span><span class="p">(</span><span class="nx">hmi</span><span class="p">.</span><span class="nx">yellow</span><span class="p">.</span><span class="nx">read</span><span class="p">()</span> <span class="o">==</span> <span class="kc">false</span><span class="p">)</span> <span class="p">{</span>
+ <span class="nx">hmi</span><span class="p">.</span><span class="nx">yellow</span><span class="p">.</span><span class="nx">write</span><span class="p">(</span><span class="kc">true</span><span class="p">);</span>
+ <span class="p">}</span> <span class="k">else</span> <span class="p">{</span>
+ <span class="nx">hmi</span><span class="p">.</span><span class="nx">yellow</span><span class="p">.</span><span class="nx">write</span><span class="p">(</span><span class="kc">false</span><span class="p">);</span>
+ <span class="p">}</span>
+<span class="p">}</span>
+
+<span class="nx">every</span> <span class="mi">1</span> <span class="nx">second</span> <span class="p">{</span>
+ <span class="k">if</span><span class="p">(</span><span class="nx">hmi</span><span class="p">.</span><span class="nx">red</span><span class="p">.</span><span class="nx">read</span><span class="p">()</span> <span class="o">==</span> <span class="kc">false</span><span class="p">)</span> <span class="p">{</span>
+ <span class="nx">hmi</span><span class="p">.</span><span class="nx">red</span><span class="p">.</span><span class="nx">write</span><span class="p">(</span><span class="kc">true</span><span class="p">);</span>
+ <span class="p">}</span> <span class="k">else</span> <span class="p">{</span>
+ <span class="nx">hmi</span><span class="p">.</span><span class="nx">red</span><span class="p">.</span><span class="nx">write</span><span class="p">(</span><span class="kc">false</span><span class="p">);</span>
+ <span class="p">}</span>
+<span class="p">}</span></code></pre></div>
+<p>##Interrupt controlled event loop</p>
+
+<p>Instead of using an event queue, as the XDK 110 does, we have implemented a control with boolean flags.
+Each event, such as timed events or the pressed and released event, are captured in their own ISR.
+Within the context of the ISR single flags will be set for each occurred event.
+The flags will be handled in an endless loop, after the initialization of the Arduino Uno.</p>
+
+<p>In the example a flag will be used for the event of 1 second and the pressed event of the button_one.</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="k">while</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span> <span class="p">{</span>
+ <span class="k">if</span> <span class="p">(</span><span class="nx">getHandleEvery1Second1_flag</span><span class="p">()</span> <span class="o">==</span> <span class="kc">true</span><span class="p">){</span>
+ <span class="nx">setHandleEvery1Second1_flag</span><span class="p">(</span><span class="kc">false</span><span class="p">);</span>
+ <span class="nx">HandleEvery1Second1</span><span class="p">();</span>
+ <span class="p">}</span>
+ <span class="k">if</span> <span class="p">(</span><span class="nx">getHandleEveryButton_onePressed1_flag</span><span class="p">()</span> <span class="o">==</span> <span class="kc">true</span><span class="p">){</span>
+ <span class="nx">setHandleEveryButton_onePressed1_flag</span><span class="p">(</span><span class="kc">false</span><span class="p">);</span>
+ <span class="nx">HandleEveryButton_onePressed1</span><span class="p">();</span>
+ <span class="p">}</span>
+<span class="p">}</span></code></pre></div>
+<p>As mentioned before, the flags are set in the ISR:</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="nx">ISR</span><span class="p">(</span><span class="nx">INT1_vect</span><span class="p">){</span>
+ <span class="kr">volatile</span> <span class="kr">int</span> <span class="nx">oldState</span> <span class="o">=</span> <span class="mi">0</span><span class="p">;</span>
+ <span class="kr">volatile</span> <span class="kr">int</span> <span class="nx">currentState</span> <span class="o">=</span> <span class="mi">0</span><span class="p">;</span>
+ <span class="nx">oldState</span> <span class="o">=</span> <span class="p">(</span><span class="nx">PIND</span> <span class="o">&</span> <span class="nx">_BV</span><span class="p">(</span><span class="nx">PIND3</span><span class="p">))</span> <span class="o">></span> <span class="mi">0</span> <span class="o">?</span> <span class="nx">HIGH</span> : <span class="kt">LOW</span><span class="p">;</span>
+ <span class="c1">// delay for debounce could be placed here
+</span><span class="c1"></span> <span class="nx">currentState</span> <span class="o">=</span> <span class="p">(</span><span class="nx">PIND</span> <span class="o">&</span> <span class="nx">_BV</span><span class="p">(</span><span class="nx">PIND3</span><span class="p">))</span> <span class="o">></span> <span class="mi">0</span> <span class="o">?</span> <span class="nx">HIGH</span> : <span class="kt">LOW</span><span class="p">;</span>
+ <span class="k">if</span> <span class="p">(</span><span class="nx">LOW</span> <span class="o">==</span> <span class="nx">oldState</span> <span class="o">&&</span> <span class="nx">LOW</span> <span class="o">==</span> <span class="nx">currentState</span><span class="p">)</span> <span class="p">{</span>
+ <span class="nx">ButtonTwoPressed</span><span class="p">(</span><span class="kc">true</span><span class="p">);</span>
+ <span class="p">}</span> <span class="k">else</span> <span class="k">if</span> <span class="p">(</span><span class="nx">HIGH</span> <span class="o">==</span> <span class="nx">oldState</span> <span class="o">&&</span> <span class="nx">HIGH</span> <span class="o">==</span> <span class="nx">currentState</span><span class="p">){</span>
+ <span class="nx">ButtonTwoReleased</span><span class="p">(</span><span class="kc">true</span><span class="p">);</span>
+ <span class="p">}</span>
+<span class="p">}</span></code></pre></div>
+<p>##How to use the Arduino Uno platform</p>
+
+<p>Mita-generated code for the Arduino platform requires a small runtime library which is located in the Arduino platform package /org.eclipse.mita.platform.arduino.uno/ArduinoMitaRuntime. To use this runtime, and to compile/flash the generated code, we have found the <a href="https://marketplace.eclipse.org/content/avr-eclipse-plugin">AVR Plugin</a> handy. We have listed the steps we use below:</p>
+
+<ul>
+<li>Create a new C Project</li>
+<li>Choose an AVR project</li>
+<li>Set up the atmega 328p (Arduino Uno)</li>
+<li>Add a new file with .mita extension</li>
+<li>After creating a .mita file, a wizard will be opened to convert as the project as a Xtext project. Click on Yes. You also can edit the nature in the .project file.</li>
+<li>Add Paths & Symbols (src-gen, base and folder, which contains the ArduinoMitaRuntime files). Therefore, right click the project and open the Properties. Open C/C++ Build and open Paths & Symbols.</li>
+<li>Set up Programmer - can be found in the project properties under AVR</li>
+<li>Create your application</li>
+<li>Compile & flash</li>
+</ul>
+
+
+ <aside class="copyright" role="note">
+
+ © 2018 The Eclipse Mita Project –
+
+ Documentation built with
+ <a href="https://www.gohugo.io" target="_blank">Hugo</a>
+ using the
+ <a href="http://github.com/digitalcraftsman/hugo-material-docs" target="_blank">Material</a> theme.
+ </aside>
+
+ <footer class="footer">
+
+
+<nav class="pagination" aria-label="Footer">
+ <div class="previous">
+
+ <a href="../../language/events/" title="Events">
+ <span class="direction">
+ Previous
+ </span>
+ <div class="page">
+ <div class="button button-previous" role="button" aria-label="Previous">
+ <i class="icon icon-back"></i>
+ </div>
+ <div class="stretch">
+ <div class="title">
+ Events
+ </div>
+ </div>
+ </div>
+ </a>
+
+ </div>
+
+ <div class="next">
+
+ <a href="../../language/exceptions/" title="Exceptions">
+ <span class="direction">
+ Next
+ </span>
+ <div class="page">
+ <div class="stretch">
+ <div class="title">
+ Exceptions
+ </div>
+ </div>
+ <div class="button button-next" role="button" aria-label="Next">
+ <i class="icon icon-forward"></i>
+ </div>
+ </div>
+ </a>
+
+ </div>
+</nav>
+
+
+
+
+
+ </footer>
+ </div>
+ </article>
+
+ <div class="results" role="status" aria-live="polite">
+ <div class="scrollable">
+ <div class="wrapper">
+ <div class="meta"></div>
+ <div class="list"></div>
+ </div>
+ </div>
+ </div>
+</main>
+
+ <script>
+
+ var base_url = '';
+ var repo_id = '';
+
+ </script>
+
+ <script src="../../javascripts/application.js"></script>
+
+
+ <script>
+ /* Add headers to scrollspy */
+ var headers = document.getElementsByTagName("h2");
+ var scrollspy = document.getElementById('scrollspy');
+
+ if(scrollspy) {
+ if(headers.length > 0) {
+ for(var i = 0; i < headers.length; i++) {
+ var li = document.createElement("li");
+ li.setAttribute("class", "anchor");
+
+ var a = document.createElement("a");
+ a.setAttribute("href", "#" + headers[i].id);
+ a.setAttribute("title", headers[i].innerHTML);
+ a.innerHTML = headers[i].innerHTML;
+
+ li.appendChild(a)
+ scrollspy.appendChild(li);
+ }
+ } else {
+ scrollspy.parentElement.removeChild(scrollspy)
+ }
+
+
+ /* Add permanent link next to the headers */
+ var headers = document.querySelectorAll("h1, h2, h3, h4, h5, h6");
+
+ for(var i = 0; i < headers.length; i++) {
+ var a = document.createElement("a");
+ a.setAttribute("class", "headerlink");
+ a.setAttribute("href", "#" + headers[i].id);
+ a.setAttribute("title", "Permanent link")
+ a.innerHTML = "#";
+ headers[i].appendChild(a);
+ }
+ }
+ </script>
+
+
+
+ <script src="//cdnjs.cloudflare.com/ajax/libs/highlight.js/9.8.0/highlight.min.js"></script>
+ <script>hljs.initHighlightingOnLoad();</script>
+ </body>
+</html>
+
diff --git a/platforms/index.xml b/platforms/index.xml
index 7be7222..55dd8b9 100644
--- a/platforms/index.xml
+++ b/platforms/index.xml
@@ -21,5 +21,15 @@
Implemented System Resources Currently implemented sensors, connectivities and buses in the XDK110 platform:</description>
</item>
+ <item>
+ <title>Arduino Uno</title>
+ <link>/platforms/arduinouno/</link>
+ <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+
+ <guid>/platforms/arduinouno/</guid>
+ <description>The Arduino Uno is a popular platform for &ldquo;physical computing&rdquo; and first steps in embedded computing. It is based on an 8-bit Atmega microcontroller and ships with a powerful hardware abstraction library. Currently, the Mita Arduino Uno platform supports basic functionality, namely working with buttons and GPIO pins.
+Sensor: button_one (Button) Modalities Name Description is_pressed : bool True if the button is pressed in this very right moment.</description>
+ </item>
+
</channel>
</rss>
\ No newline at end of file
diff --git a/platforms/xdk110/index.html b/platforms/xdk110/index.html
index 91c3558..9640eba 100644
--- a/platforms/xdk110/index.html
+++ b/platforms/xdk110/index.html
@@ -10,7 +10,7 @@
<meta name="viewport" content="width=device-width,user-scalable=no,initial-scale=1,maximum-scale=1">
<meta http-equiv="X-UA-Compatible" content="IE=10" />
<title>XDK110 - Eclipse Mita</title>
- <meta name="generator" content="Hugo 0.42.1" />
+ <meta name="generator" content="Hugo 0.40.1" />
<meta name="description" content="The documentation of Eclipse Mita.">
@@ -344,6 +344,19 @@
+<a title="Arduino Uno" href="../../platforms/arduinouno/">
+
+ Arduino Uno
+</a>
+
+
+
+
+
+
+
+
+
<a class="current" title="XDK110" href="../../platforms/xdk110/">
XDK110
@@ -407,11 +420,17 @@
<tr>
<td><a href="#gyroscope-calibrated-sensor-fusion">Gyroscope</a></td>
-<td><a href="#ble">BLE</a></td>
+<td><a href="#adc">ADC</a></td>
<td><a href="#I2C">I2C</a></td>
</tr>
<tr>
+<td><a href="#magnetometer-bmm150">Magnetometer</a></td>
+<td><a href="#ble">BLE</a></td>
+<td></td>
+</tr>
+
+<tr>
<td><a href="#environment-bme280">Humidity</a></td>
<td><a href="#wlan">WLAN</a></td>
<td></td>
@@ -431,6 +450,12 @@
<tr>
<td><a href="#environment-bme280">Temperature</a></td>
+<td><a href="#eclipse-hono">Eclipse Hono over MQTT</a></td>
+<td></td>
+</tr>
+
+<tr>
+<td><a href="#noise-sensor">Noise sensor</a></td>
<td><a href="#rest-over-http">REST over HTTP</a></td>
<td></td>
</tr>
@@ -455,10 +480,22 @@
<h3 id="binary-name">Binary Name</h3>
-<p>To customize the produced binary name configure <code>XDK110.applicationName : string</code>. The default name is <code>MitaApplication</code>:</p>
+<p>To customize the produced binary name configure <code>XDK110.applicationName: string</code> . The default name is <code>MitaApplication</code>:</p>
<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="nx">setup</span> <span class="nx">XDK110</span> <span class="p">{</span>
<span class="nx">applicationName</span> <span class="o">=</span> <span class="s2">"ShockDetector"</span><span class="p">;</span>
<span class="p">}</span></code></pre></div>
+<h3 id="startup-delay">Startup Delay</h3>
+
+<p>To debug the startup process you can configure a startup delay so the XDK can connect via USB before setting up devices, connectivity, etc.:</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="nx">setup</span> <span class="nx">XDK110</span> <span class="p">{</span>
+ <span class="nx">startupDelay</span> <span class="o">=</span> <span class="mi">5000</span><span class="p">;</span> <span class="cm">/* wait 5 seconds before initialization */</span>
+<span class="p">}</span></code></pre></div>
+<h3 id="extension-bus-power">Extension Bus Power</h3>
+
+<p>Per default the XDK doesn’t power the 2.5V and 3.3V lines on its extension bus. Some system resources like I2C or GPIO already change this, however in some cases you need to do this manually for example when using the ADC with a microphone:</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="nx">setup</span> <span class="nx">XDK110</span> <span class="p">{</span>
+ <span class="nx">powerExternalDevices</span> <span class="o">=</span> <span class="kc">true</span><span class="p">;</span>
+<span class="p">}</span></code></pre></div>
<h3 id="sensors">Sensors</h3>
<p>Any sensor can be used without configuring it. It will be initialized with sensible defaults. If you want to change a sensor’s default hardware parameters just set it up, e.g. the accelerometer:</p>
@@ -524,25 +561,25 @@
<tbody>
<tr>
<td></td>
-<td><code>range : BMA280_Range</code></td>
+<td><code>range: BMA280_Range</code></td>
<td>The range of acceleration we want to measure. Default: <code>2G</code></td>
</tr>
<tr>
<td></td>
-<td><code>bandwidth : BMA280_Bandwidth</code></td>
+<td><code>bandwidth: BMA280_Bandwidth</code></td>
<td>The low-pass filter bandwidth used by the BMA. Default: <code>500Hz</code></td>
</tr>
<tr>
<td></td>
-<td><code>any_motion_threshold : uint32</code></td>
+<td><code>any_motion_threshold: uint32</code></td>
<td>The threshold of acceleration that has to be crossed before an any motion event is triggered. Default: <code>20</code></td>
</tr>
<tr>
<td></td>
-<td><code>no_motion_threshold : uint32</code></td>
+<td><code>no_motion_threshold: uint32</code></td>
<td>The threshold of acceleration that must not be exceeded for a no motion event to be triggered. Default: <code>20</code></td>
</tr>
</tbody>
@@ -562,25 +599,25 @@
<tbody>
<tr>
<td></td>
-<td><code>x_axis : int32</code></td>
+<td><code>x_axis: int32</code></td>
<td>The X axis of the BMA280.</td>
</tr>
<tr>
<td></td>
-<td><code>y_axis : int32</code></td>
+<td><code>y_axis: int32</code></td>
<td>The Y axis of the BMA280.</td>
</tr>
<tr>
<td></td>
-<td><code>z_axis : int32</code></td>
+<td><code>z_axis: int32</code></td>
<td>The Z axis of the BMA280.</td>
</tr>
<tr>
<td></td>
-<td><code>magnitude : int32</code></td>
+<td><code>magnitude: int32</code></td>
<td>The L2 norm of the acceleration vector: <code>sqrt(x^2 + y^2 + z^2)</code></td>
</tr>
</tbody>
@@ -674,17 +711,17 @@
<tbody>
<tr>
-<td><code>x_axis : int32</code></td>
+<td><code>x_axis: int32</code></td>
<td>The X axis of the gyroscope</td>
</tr>
<tr>
-<td><code>y_axis : int32</code></td>
+<td><code>y_axis: int32</code></td>
<td>The Y axis of the gyroscope</td>
</tr>
<tr>
-<td><code>z_axis : int32</code></td>
+<td><code>z_axis: int32</code></td>
<td>The Z axis of the gyroscope</td>
</tr>
</tbody>
@@ -708,13 +745,13 @@
<tbody>
<tr>
<td></td>
-<td><code>bandwidth : BMI160_Bandwidth</code></td>
+<td><code>bandwidth: BMI160_Bandwidth</code></td>
<td>The low-pass filter bandwidth used by the BMI160. Default: 39.9Hz.</td>
</tr>
<tr>
<td></td>
-<td><code>range : BMI160_Range</code></td>
+<td><code>range: BMI160_Range</code></td>
<td>The range the BMI160 should measure in. Default: 2000 deg/s.</td>
</tr>
</tbody>
@@ -732,17 +769,17 @@
<tbody>
<tr>
-<td><code>x_axis : int32</code></td>
+<td><code>x_axis: int32</code></td>
<td>The X axis of the BMI160</td>
</tr>
<tr>
-<td><code>y_axis : int32</code></td>
+<td><code>y_axis: int32</code></td>
<td>The Y axis of the BMI160</td>
</tr>
<tr>
-<td><code>z_axis : int32</code></td>
+<td><code>z_axis: int32</code></td>
<td>The Z axis of the BMI160</td>
</tr>
</tbody>
@@ -766,13 +803,13 @@
<tbody>
<tr>
<td></td>
-<td><code>bandwidth : BMI160_Bandwidth</code></td>
+<td><code>bandwidth: BMI160_Bandwidth</code></td>
<td>The low-pass filter bandwidth used by the BMG160. Default: 523Hz.</td>
</tr>
<tr>
<td></td>
-<td><code>range : BMI160_Range</code></td>
+<td><code>range: BMI160_Range</code></td>
<td>The measurement range of the BMG160. Default: 2000 deg/s.</td>
</tr>
</tbody>
@@ -790,25 +827,25 @@
<tbody>
<tr>
-<td><code>x_axis : int32</code></td>
+<td><code>x_axis: int32</code></td>
<td>The X axis of the BMG160</td>
</tr>
<tr>
-<td><code>y_axis : int32</code></td>
+<td><code>y_axis: int32</code></td>
<td>The Y axis of the BMG160</td>
</tr>
<tr>
-<td><code>z_axis : int32</code></td>
+<td><code>z_axis: int32</code></td>
<td>The Z axis of the BMG160</td>
</tr>
</tbody>
</table>
-<h3 id="environment-bme280">Environment (BME280)</h3>
+<h3 id="magnetometer-bmm150">Magnetometer (BMM150)</h3>
-<p>The BME280 is a combined digital <strong>humidity</strong>, <strong>pressure</strong> and <strong>temperature</strong> sensor based on proven sensing principles.</p>
+<p>The BMM150 is a low power and low noise 3-axis digital geomagnetic sensor to be used in compass applications.</p>
<h4 id="configuration-4">Configuration</h4>
@@ -824,32 +861,8 @@
<tbody>
<tr>
<td></td>
-<td><code>power_mode : BME280_PowerMode</code></td>
-<td>The BME280 power mode. Default: <code>Normal</code>.</td>
-</tr>
-
-<tr>
-<td></td>
-<td><code>standby_time : uint32</code></td>
-<td>The standby time used in normal mode in milliseconds. Beware that the value supplied here will be clipped to the nearest valid value.</td>
-</tr>
-
-<tr>
-<td></td>
-<td><code>temperature_oversampling : BME280_Oversampling</code></td>
-<td>Reduces noise in the temperature measurement by over sampling. Higher oversampling settings reduce noise but increase measurement time and power consumption.</td>
-</tr>
-
-<tr>
-<td></td>
-<td><code>pressure_oversampling : BME280_Oversampling</code></td>
-<td>Reduces noise in the pressure measurement by over sampling. Higher oversampling settings reduce noise but increase measurement time and power consumption.</td>
-</tr>
-
-<tr>
-<td></td>
-<td><code>humidity_oversampling : BME280_Oversampling</code></td>
-<td>Reduces noise in the humidity measurement by over sampling. Higher oversampling settings reduce noise but increase measurement time and power consumption.</td>
+<td><code>mode: BMM150_Preset</code></td>
+<td>One of four preset modes. Default: <code>Regular</code>.</td>
</tr>
</tbody>
</table>
@@ -866,30 +879,30 @@
<tbody>
<tr>
-<td><code>temperature : int32</code></td>
-<td>The temperature reported by the BME280.</td>
+<td><code>x_axis: int32</code></td>
+<td>The X axis of the BMM150</td>
</tr>
<tr>
-<td><code>pressure : uint32</code></td>
-<td>The pressure reported by the BME280.</td>
+<td><code>y_axis: int32</code></td>
+<td>The Y axis of the BMM150</td>
</tr>
<tr>
-<td><code>humidity : float</code></td>
-<td>The humidity reported by the BME280.</td>
+<td><code>z_axis: int32</code></td>
+<td>The Z axis of the BMM150</td>
</tr>
<tr>
-<td><code>humidity_fixed_point : uint32</code></td>
-<td>The humidity reported by the BME280 in fixed-point representation: divide by 1024 to get the percentage.</td>
+<td><code>resistance: uint16</code></td>
+<td>The resistance of the BMM150</td>
</tr>
</tbody>
</table>
-<h3 id="light-max44009">Light(MAX44009)</h3>
+<h3 id="environment-bme280">Environment (BME280)</h3>
-<p>The XDK light sensor.</p>
+<p>The BME280 is a combined digital <strong>humidity</strong>, <strong>pressure</strong> and <strong>temperature</strong> sensor based on proven sensing principles.</p>
<h4 id="configuration-5">Configuration</h4>
@@ -905,26 +918,32 @@
<tbody>
<tr>
<td></td>
-<td><code>manual_mode : bool</code></td>
-<td>Enables the manual configuration of integration time and high brightness mode. If set to <code>false</code> (default) the chip automatically selects those values. Default: <code>false</code>.</td>
+<td><code>power_mode: BME280_PowerMode</code></td>
+<td>The BME280 power mode. Default: <code>Normal</code>.</td>
</tr>
<tr>
<td></td>
-<td><code>integration_time : MAX44009_IntegrationTime</code></td>
-<td>The integration time is the time the sensor collects light for. In automatic mode (manual mode set to <code>false</code>) the chip automatically selects the integration time. Default: 800ms.</td>
+<td><code>standby_time: uint32</code></td>
+<td>The standby time used in normal mode in milliseconds. Beware that the value supplied here will be clipped to the nearest valid value.</td>
</tr>
<tr>
<td></td>
-<td><code>high_brightness : bool</code></td>
-<td>Set to <code>true</code> so that only <sup>1</sup>⁄<sub>8</sub> of the photo diode current goes to the ADC. This mode is used in high-brightness situations to avoid saturation/clipping effects of the ADC. Default: <code>false</code>.</td>
+<td><code>temperature_oversampling: BME280_Oversampling</code></td>
+<td>Reduces noise in the temperature measurement by over sampling. Higher oversampling settings reduce noise but increase measurement time and power consumption.</td>
</tr>
<tr>
<td></td>
-<td><code>continuous_mode : bool</code></td>
-<td>In default mode (<code>false</code>) the IC measures lux intensity only once every 800ms regardless of integration time. This mode allows the part to operate at its lowest possible supply current. <br><br> In continuous mode (<code>true</code>) the IC continuously measures lux intensity. That is, as soon as one reading is finished, a new one begins. If integration time is 6.25ms, readings are taken every 6.25ms. If integration time is 800ms, readings are taken every 800ms. In this mode, the part consumes slightly higher power than in the default mode. Default: <code>false</code>.</td>
+<td><code>pressure_oversampling: BME280_Oversampling</code></td>
+<td>Reduces noise in the pressure measurement by over sampling. Higher oversampling settings reduce noise but increase measurement time and power consumption.</td>
+</tr>
+
+<tr>
+<td></td>
+<td><code>humidity_oversampling: BME280_Oversampling</code></td>
+<td>Reduces noise in the humidity measurement by over sampling. Higher oversampling settings reduce noise but increase measurement time and power consumption.</td>
</tr>
</tbody>
</table>
@@ -941,15 +960,68 @@
<tbody>
<tr>
-<td><code>intensity : uint32</code></td>
-<td>The light intensity of the MAX44009.</td>
+<td><code>temperature: int32</code></td>
+<td>The temperature reported by the BME280.</td>
+</tr>
+
+<tr>
+<td><code>pressure: uint32</code></td>
+<td>The pressure reported by the BME280.</td>
+</tr>
+
+<tr>
+<td><code>humidity: float</code></td>
+<td>The humidity reported by the BME280.</td>
+</tr>
+
+<tr>
+<td><code>humidity_fixed_point: uint32</code></td>
+<td>The humidity reported by the BME280 in fixed-point representation: divide by 1024 to get the percentage.</td>
</tr>
</tbody>
</table>
-<h3 id="buttons">Buttons</h3>
+<h3 id="light-max44009">Light(MAX44009)</h3>
-<p>The XDK features two buttons. Pressed and released are encoded by <code>true</code> and <code>false</code> in Mita. Button presses can be detected using event handlers, i.e. <code>every button_one.pressed</code>.</p>
+<p>The XDK light sensor.</p>
+
+<h4 id="configuration-6">Configuration</h4>
+
+<table>
+<thead>
+<tr>
+<th></th>
+<th>Name</th>
+<th>Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td></td>
+<td><code>manual_mode: bool</code></td>
+<td>Enables the manual configuration of integration time and high brightness mode. If set to <code>false</code> (default) the chip automatically selects those values. Default: <code>false</code>.</td>
+</tr>
+
+<tr>
+<td></td>
+<td><code>integration_time: MAX44009_IntegrationTime</code></td>
+<td>The integration time is the time the sensor collects light for. In automatic mode (manual mode set to <code>false</code>) the chip automatically selects the integration time. Default: 800ms.</td>
+</tr>
+
+<tr>
+<td></td>
+<td><code>high_brightness: bool</code></td>
+<td>Set to <code>true</code> so that only <sup>1</sup>⁄<sub>8</sub> of the photo diode current goes to the ADC. This mode is used in high-brightness situations to avoid saturation/clipping effects of the ADC. Default: <code>false</code>.</td>
+</tr>
+
+<tr>
+<td></td>
+<td><code>continuous_mode: bool</code></td>
+<td>In default mode (<code>false</code>) the IC measures lux intensity only once every 800ms regardless of integration time. This mode allows the part to operate at its lowest possible supply current. <br><br> In continuous mode (<code>true</code>) the IC continuously measures lux intensity. That is, as soon as one reading is finished, a new one begins. If integration time is 6.25ms, readings are taken every 6.25ms. If integration time is 800ms, readings are taken every 800ms. In this mode, the part consumes slightly higher power than in the default mode. Default: <code>false</code>.</td>
+</tr>
+</tbody>
+</table>
<h4 id="modalities-6">Modalities</h4>
@@ -963,7 +1035,77 @@
<tbody>
<tr>
-<td><code>is_pressed : bool</code></td>
+<td><code>intensity: uint32</code></td>
+<td>The light intensity of the MAX44009.</td>
+</tr>
+</tbody>
+</table>
+
+<h3 id="noise-sensor">Noise Sensor</h3>
+
+<p>The noise sensor uses the XDK’s microphone to detect noise around it. The noise is calculated over 256 microphone samples. Note that this value is without unit and needs to be calibrated/converted by your application if you require absolute noise level measurements.</p>
+
+<h4 id="configuration-7">Configuration</h4>
+
+<table>
+<thead>
+<tr>
+<th></th>
+<th>Name</th>
+<th>Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td></td>
+<td><code>samplingFrequency: uint32</code></td>
+<td>How often the microphone is sampled in Hertz. Default: <code>2560Hz</code>.</td>
+</tr>
+
+<tr>
+<td></td>
+<td><code>timeout: uint32</code></td>
+<td>If not enough samples are ready how long to wait for additional samples in milliseconds. Default: <code>100ms</code>.</td>
+</tr>
+</tbody>
+</table>
+
+<h4 id="modalities-7">Modalities</h4>
+
+<table>
+<thead>
+<tr>
+<th>Name</th>
+<th>Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td><code>noise: float</code></td>
+<td>An uncalibrated noise level. Should not enough samples be ready when getting this modality even after waiting <code>timeout</code> milliseconds this will throw an exception.</td>
+</tr>
+</tbody>
+</table>
+
+<h3 id="buttons">Buttons</h3>
+
+<p>The XDK features two buttons. Pressed and released are encoded by <code>true</code> and <code>false</code> in Mita. Button presses can be detected using event handlers, i.e. <code>every button_one.pressed</code>.</p>
+
+<h4 id="modalities-8">Modalities</h4>
+
+<table>
+<thead>
+<tr>
+<th>Name</th>
+<th>Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td><code>is_pressed: bool</code></td>
<td>True if the button is pressed in this very right moment. False otherwise.</td>
</tr>
</tbody>
@@ -998,7 +1140,7 @@
<p>The XDK features three custom usable LEDs in red, orange and yellow. On and off are encoded using <code>true</code> and <code>false</code> in Mita.</p>
-<h4 id="modalities-7">Modalities</h4>
+<h4 id="modalities-9">Modalities</h4>
<table>
<thead>
@@ -1012,19 +1154,19 @@
<tbody>
<tr>
-<td><code>light_up : bool</code></td>
+<td><code>light_up: bool</code></td>
<td>Represents one of the three LEDs.</td>
-<td><code>color : LedColor</code></td>
+<td><code>color: LedColor</code></td>
<td>One of <code>Yellow</code>, <code>Orange</code> or <code>Red</code>.</td>
</tr>
</tbody>
</table>
-<h3 id="ble">BLE</h3>
+<h3 id="adc">ADC</h3>
-<p>BLE (Bluetooth Low Energy) allows the XDK to communicate over short range, up to 50m, with various devices like smartphones. In BLE a server continuously advertises all characteristics and clients can connect without requiring further interaction or authentification.</p>
+<p>The XDK’s ADC (Analog Digital Converter) can measure voltages against internal or external potentials.</p>
-<h4 id="configuration-6">Configuration</h4>
+<h4 id="configuration-8">Configuration</h4>
<table>
<thead>
@@ -1038,26 +1180,8 @@
<tbody>
<tr>
<td></td>
-<td><code>deviceName : string</code></td>
-<td>The name of the device as advertised via GAP.</td>
-</tr>
-
-<tr>
-<td></td>
-<td><code>macAddress : string</code></td>
-<td>MAC address of the device. Must start with <code>FC-D6-BD</code>. You may use either colon <code>:</code> or dash <code>-</code> as byte separators.</td>
-</tr>
-
-<tr>
-<td></td>
-<td><code>serviceUID : uint32</code></td>
-<td>The last four bytes of the UUID of the GATT service we’ll create.</td>
-</tr>
-
-<tr>
-<td></td>
-<td><code>advertisingInterval : int16</code></td>
-<td>The GAP advertisement interval. Default: <code>1000</code>.</td>
+<td><code>externalReferenceVoltage: uint16</code></td>
+<td>The reference voltage to measure against when you use an external reference voltage in a signal in [mV].</td>
</tr>
</tbody>
</table>
@@ -1076,41 +1200,40 @@
<tbody>
<tr>
-<td><code>bool_characteristic() : bool</code></td>
-<td>A boolean GATT characteristic.</td>
-<td><code>UUID : uint32</code></td>
-<td>The last four bytes of the characteristic UUID. Defaults to the hash code of the VCI name.</td>
+<td><code>channel: uint16</code></td>
+<td>An ADC channel, read only. [mV]</td>
+<td><code>channel: ADC_Channel</code></td>
+<td>Which channel to measure.</td>
</tr>
<tr>
-<td><code>uint32_characteristic() : uint32</code></td>
-<td>An unsigned integer GATT characteristic.</td>
-<td><code>UUID : uint32</code></td>
-<td>The last four bytes of the characteristic UUID. Defaults to the hash code of the VCI name.</td>
+<td></td>
+<td></td>
+<td><code>referenceVoltage: ADC_Reference_Voltage</code></td>
+<td>Which voltage to measure against. Default: <code>2.5V</code> internal voltage reference.</td>
</tr>
<tr>
-<td><code>int32_characteristic() : int32</code></td>
-<td>A signed integer GATT characteristic.</td>
-<td><code>UUID : uint32</code></td>
-<td>The last four bytes of the characteristic UUID. Defaults to the hash code of the VCI name.</td>
+<td></td>
+<td></td>
+<td><code>resolution: ADC_Resolution</code></td>
+<td>Default: <code>12 bit</code></td>
+</tr>
+
+<tr>
+<td></td>
+<td></td>
+<td><code>sampleTime: ADC_SampleTime</code></td>
+<td>Over how many <em>clock</em> cycles the ADC samples its input. Default: <code>16</code> cycles.</td>
</tr>
</tbody>
</table>
-<h3 id="wlan">WLAN</h3>
+<h3 id="ble">BLE</h3>
-<p>WLAN is one of the hardware connectivities available on the XDK. Configuration is done using <a href="../../language/types/#sum-types">sum types</a>. Even though the concept of sum types may be daunting they are actually very easy to use.
-Say you want to configure <code>authentification</code>. Content assist (<code>CTRL+Space</code>) offers you three different choices: <code>None</code>, <code>Enterprise</code> and <code>Personal</code>. Each accepts a different number of parameters. For example to configure a WLAN with WPA2 Personal you would write this:</p>
-<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="nx">setup</span> <span class="nx">WLAN</span> <span class="p">{</span>
- <span class="nx">authentification</span> <span class="o">=</span> <span class="nx">Personal</span><span class="p">(</span><span class="nx">psk</span> <span class="o">=</span> <span class="s2">"mySecretKey"</span><span class="p">);</span>
- <span class="cm">/* ... */</span>
-<span class="p">}</span></code></pre></div>
-<p>Configuring IP address works the same: you can choose from either <code>Dhcp</code> or <code>Static</code>.</p>
+<p>BLE (Bluetooth Low Energy) allows the XDK to communicate over short range, up to 50m, with various devices like smartphones. In BLE a server continuously advertises all characteristics and clients can connect without requiring further interaction or authentication.</p>
-<p>Content assist will help you fill in all parameters.</p>
-
-<h4 id="configuration-7">Configuration</h4>
+<h4 id="configuration-9">Configuration</h4>
<table>
<thead>
@@ -1123,75 +1246,27 @@
<tbody>
<tr>
-<td><strong>Required</strong></td>
-<td><code>authentification : Authentification</code></td>
-<td>How to authenticate to the WLAN network.</td>
-</tr>
-
-<tr>
-<td><strong>Required</strong></td>
-<td><code>ssid : string</code></td>
-<td>The SSID of the WLAN network we want to connect to.</td>
+<td></td>
+<td><code>deviceName: string</code></td>
+<td>The name of the device as advertised via GAP.</td>
</tr>
<tr>
<td></td>
-<td><code>isHostPgmEnabled : bool</code></td>
-<td>If true, server certificate will be uploaded to the WLAN chip CC3100. Make sure to update service pack of the WLAN and then upload the certificate. Certificate must placed under <code>XDK110/common/certs/XDKDummy</code>. Default: <code>false</code>.</td>
+<td><code>macAddress: string</code></td>
+<td>MAC address of the device. Must start with <code>FC-D6-BD</code>. You may use either colon <code>:</code> or dash <code>-</code> as byte separators.</td>
</tr>
<tr>
<td></td>
-<td><code>ipConfiguration : IpConfiguration</code></td>
-<td>How to configure IP address. Default: <code>Dhcp()</code>.</td>
-</tr>
-</tbody>
-</table>
-
-<h3 id="mqtt">MQTT</h3>
-
-<p>MQTT is a messaging protocol for low bandwidth networks. Current implementation is based on the serval stack.</p>
-
-<h4 id="configuration-8">Configuration</h4>
-
-<table>
-<thead>
-<tr>
-<th></th>
-<th>Name</th>
-<th>Description</th>
-</tr>
-</thead>
-
-<tbody>
-<tr>
-<td><strong>Required</strong></td>
-<td><code>transport : WLAN</code></td>
-<td>The transport layer used for communication.</td>
-</tr>
-
-<tr>
-<td><strong>Required</strong></td>
-<td><code>url : string</code></td>
-<td>The URL pointing to the MQTT broker, for example: <code>mqtt://does-not.exist:1883</code>.</td>
-</tr>
-
-<tr>
-<td><strong>Required</strong></td>
-<td><code>clientId : string</code></td>
-<td>A unique name the broker can use to identify devices. No two clients may have the same name per broker.</td>
+<td><code>serviceUID: uint32</code></td>
+<td>The last four bytes of the UUID of the GATT service we’ll create.</td>
</tr>
<tr>
<td></td>
-<td><code>cleanSession : bool</code></td>
-<td>The clean session flag indicates to the broker whether the client wants to establish a clean session or a persistent session where all subscriptions and messages (QoS 1 & 2) are stored for the client. Default: <code>false</code>.</td>
-</tr>
-
-<tr>
-<td></td>
-<td><code>keepAliveInterval : uint32</code></td>
-<td>The keep alive interval (in seconds) is the time the client commits to for when sending regular pings to the broker. The broker responds to the pings enabling both sides to determine if the other one is still alive and reachable. Default: <code>60</code>.</td>
+<td><code>advertisingInterval: int16</code></td>
+<td>The GAP advertisement interval. Default: <code>1000</code>.</td>
</tr>
</tbody>
</table>
@@ -1210,28 +1285,42 @@
<tbody>
<tr>
-<td><code>topic : string</code></td>
-<td>Publishes a message to a particular topic.</td>
-<td><code>name : string</code></td>
-<td>The topic’s name.</td>
+<td><code>bool_characteristic(): bool</code></td>
+<td>A boolean GATT characteristic.</td>
+<td><code>UUID: uint32</code></td>
+<td>The last four bytes of the characteristic UUID. Defaults to the hash code of the VCI name.</td>
</tr>
<tr>
-<td></td>
-<td></td>
-<td><code>qos : uint32</code></td>
-<td>Default: <code>0</code></td>
+<td><code>uint32_characteristic(): uint32</code></td>
+<td>An unsigned integer GATT characteristic.</td>
+<td><code>UUID: uint32</code></td>
+<td>The last four bytes of the characteristic UUID. Defaults to the hash code of the VCI name.</td>
+</tr>
+
+<tr>
+<td><code>int32_characteristic(): int32</code></td>
+<td>A signed integer GATT characteristic.</td>
+<td><code>UUID: uint32</code></td>
+<td>The last four bytes of the characteristic UUID. Defaults to the hash code of the VCI name.</td>
</tr>
</tbody>
</table>
-<h3 id="rest-over-http">REST over HTTP</h3>
+<h3 id="wlan">WLAN</h3>
-<p>Using REST you can easily talk to servers over HTTP. REST defines a stateless interface with a simple URL scheme. Normally a REST server consists of a versioned endpoint like <code>http://api.github.com/v3</code> which then provides different resources, for example <code>api.github.com/v3/repos/eclipse/mita/branches</code> and <code>/repos/eclipse/mita/issues</code>.</p>
+<p>WLAN is one of the hardware connectivities available on the XDK. Configuration is done using <a href="../../language/types/#sum-types">sum types</a>. Even though the concept of sum types may be daunting they are actually very easy to use.
+Say you want to configure <code>authentication</code>. Content assist (<code>CTRL+Space</code>) offers you three different choices: <code>None</code>, <code>Enterprise</code> and <code>Personal</code>. Each accepts a different number of parameters. For example to configure a WLAN with WPA2 Personal you would write this:</p>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="nx">setup</span> <span class="nx">net</span>: <span class="kt">WLAN</span> <span class="p">{</span>
+ <span class="nx">ssid</span> <span class="o">=</span> <span class="s2">"MyWlan"</span><span class="p">;</span>
+ <span class="nx">authentication</span> <span class="o">=</span> <span class="nx">Personal</span><span class="p">(</span><span class="nx">psk</span> <span class="o">=</span> <span class="s2">"mySecretKey"</span><span class="p">);</span>
+ <span class="cm">/* ... */</span>
+<span class="p">}</span></code></pre></div>
+<p>Configuring IP address works the same: you can choose from either <code>Dhcp</code> or <code>Static</code>.</p>
-<p>Currently only writing is supported.</p>
+<p>Content assist will help you fill in all parameters.</p>
-<h4 id="configuration-9">Configuration</h4>
+<h4 id="configuration-10">Configuration</h4>
<table>
<thead>
@@ -1245,19 +1334,259 @@
<tbody>
<tr>
<td><strong>Required</strong></td>
-<td><code>transport : WLAN</code></td>
+<td><code>authentication: Authentication</code></td>
+<td>How to authenticate to the WLAN network.</td>
+</tr>
+
+<tr>
+<td><strong>Required</strong></td>
+<td><code>ssid: string</code></td>
+<td>The SSID of the WLAN network we want to connect to.</td>
+</tr>
+
+<tr>
+<td></td>
+<td><code>isHostPgmEnabled: bool</code></td>
+<td>If true, server certificate will be uploaded to the WLAN chip CC3100. Make sure to update service pack of the WLAN and then upload the certificate. Certificate must placed under <code>XDK110/common/certs/XDKDummy</code>. Default: <code>false</code>.</td>
+</tr>
+
+<tr>
+<td></td>
+<td><code>ipConfiguration: IpConfiguration</code></td>
+<td>How to configure IP address. Default: <code>Dhcp()</code>.</td>
+</tr>
+</tbody>
+</table>
+
+<h3 id="mqtt">MQTT</h3>
+
+<p>MQTT is a messaging protocol for low bandwidth networks. The current implementation is based on the serval stack. MQTT requires a setup WLAN resource.</p>
+
+<h4 id="example">Example</h4>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="nx">setup</span> <span class="nx">net</span>: <span class="kt">WLAN</span> <span class="p">{</span> <span class="cm">/* ... */</span> <span class="p">}</span>
+
+<span class="nx">setup</span> <span class="nx">backend</span>: <span class="kt">MQTT</span> <span class="p">{</span>
+ <span class="nx">transport</span> <span class="o">=</span> <span class="nx">net</span><span class="p">;</span>
+ <span class="nx">url</span> <span class="o">=</span> <span class="s2">"mqtt://iot.eclipse.org"</span><span class="p">;</span>
+ <span class="nx">clientId</span> <span class="o">=</span> <span class="s2">"XDK42"</span><span class="p">;</span>
+
+ <span class="kd">var</span> <span class="nx">telemetry</span> <span class="o">=</span> <span class="nx">topic</span><span class="p">(</span><span class="s2">"telemetry"</span><span class="p">);</span>
+<span class="p">}</span>
+
+<span class="nx">every</span> <span class="mi">100</span> <span class="nx">milliseconds</span> <span class="p">{</span>
+ <span class="nx">backend</span><span class="p">.</span><span class="nx">telemetry</span><span class="p">.</span><span class="nx">write</span><span class="p">(</span><span class="sb">`</span><span class="si">${</span><span class="nx">accelerometer</span><span class="p">.</span><span class="nx">magnitude</span><span class="p">.</span><span class="nx">read</span><span class="p">()</span><span class="si">}</span><span class="sb">`</span><span class="p">);</span>
+<span class="p">}</span></code></pre></div>
+<h4 id="configuration-11">Configuration</h4>
+
+<table>
+<thead>
+<tr>
+<th></th>
+<th>Name</th>
+<th>Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td><strong>Required</strong></td>
+<td><code>transport: WLAN</code></td>
<td>The transport layer used for communication.</td>
</tr>
<tr>
<td><strong>Required</strong></td>
-<td><code>endpointBase : string</code></td>
+<td><code>url: string</code></td>
+<td>The URL pointing to the MQTT broker, for example: <code>mqtt://does-not.exist:1883</code>.</td>
+</tr>
+
+<tr>
+<td><strong>Required</strong></td>
+<td><code>clientId: string</code></td>
+<td>A unique name the broker can use to identify devices. No two clients may have the same name per broker.</td>
+</tr>
+
+<tr>
+<td></td>
+<td><code>authentication: MqttAuthentication</code></td>
+<td>Username/Password authentication or unauthenticated, for example <code>authentication = Login("user", "pass")</code>. Default: <code>None()</code>.</td>
+</tr>
+
+<tr>
+<td></td>
+<td><code>cleanSession: bool</code></td>
+<td>The clean session flag indicates to the broker whether the client wants to establish a clean session or a persistent session where all subscriptions and messages (QoS 1 & 2) are stored for the client. Default: <code>false</code>.</td>
+</tr>
+
+<tr>
+<td></td>
+<td><code>keepAliveInterval: uint32</code></td>
+<td>The keep alive interval (in seconds) is the time the client commits to for when sending regular pings to the broker. The broker responds to the pings enabling both sides to determine if the other one is still alive and reachable. Default: <code>60</code>.</td>
+</tr>
+</tbody>
+</table>
+
+<h4 id="signals-2">Signals</h4>
+
+<table>
+<thead>
+<tr>
+<th>Name</th>
+<th>Description</th>
+<th>Parameters</th>
+<th></th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td><code>topic: string</code></td>
+<td>Publishes a message to a particular topic.</td>
+<td><code>name: string</code></td>
+<td>The topic’s name.</td>
+</tr>
+
+<tr>
+<td></td>
+<td></td>
+<td><code>qos: uint32</code></td>
+<td>Default: <code>0</code></td>
+</tr>
+</tbody>
+</table>
+
+<h3 id="eclipse-hono">Eclipse Hono</h3>
+
+<p>Mita implements a <code>HonoMqtt</code> resource you can use to easily connect to an <a href="https://www.eclipse.org/hono/">Eclipse Hono</a> service via MQTT.</p>
+
+<h4 id="example-1">Example</h4>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="nx">setup</span> <span class="nx">net</span>: <span class="kt">WLAN</span> <span class="p">{</span> <span class="cm">/* ... */</span> <span class="p">}</span>
+
+<span class="nx">setup</span> <span class="nx">backend</span>: <span class="kt">HonoMqtt</span> <span class="p">{</span>
+ <span class="nx">transport</span> <span class="o">=</span> <span class="nx">net</span><span class="p">;</span>
+ <span class="nx">url</span> <span class="o">=</span> <span class="s2">"mqtt://iot.eclipse.org"</span><span class="p">;</span>
+ <span class="nx">clientId</span> <span class="o">=</span> <span class="s2">"XDK42"</span><span class="p">;</span>
+ <span class="nx">authentication</span> <span class="o">=</span> <span class="nx">Authenticated</span><span class="p">(</span><span class="nx">username</span><span class="o">=</span><span class="s2">"consumer@HONO"</span><span class="p">,</span> <span class="nx">password</span><span class="o">=</span><span class="s2">"verysecret"</span><span class="p">);</span>
+
+ <span class="kd">var</span> <span class="nx">telemetry</span> <span class="o">=</span> <span class="nx">telemetry</span><span class="p">(</span><span class="nx">qos</span><span class="o">=</span><span class="mi">0</span><span class="p">);</span>
+<span class="p">}</span>
+
+<span class="nx">every</span> <span class="mi">100</span> <span class="nx">milliseconds</span> <span class="p">{</span>
+ <span class="nx">backend</span><span class="p">.</span><span class="nx">telemetry</span><span class="p">.</span><span class="nx">write</span><span class="p">(</span><span class="sb">`</span><span class="si">${</span><span class="nx">accelerometer</span><span class="p">.</span><span class="nx">magnitude</span><span class="p">.</span><span class="nx">read</span><span class="p">()</span><span class="si">}</span><span class="sb">`</span><span class="p">);</span>
+<span class="p">}</span></code></pre></div>
+<h4 id="configuration-12">Configuration</h4>
+
+<table>
+<thead>
+<tr>
+<th></th>
+<th>Name</th>
+<th>Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td><strong>Required</strong></td>
+<td><code>transport: WLAN</code></td>
+<td>The transport layer used for communication.</td>
+</tr>
+
+<tr>
+<td><strong>Required</strong></td>
+<td><code>url: string</code></td>
+<td>The URL pointing to the MQTT broker, for example: <code>mqtt://does-not.exist:1883</code>.</td>
+</tr>
+
+<tr>
+<td><strong>Required</strong></td>
+<td><code>clientId: string</code></td>
+<td>A unique name the broker can use to identify devices. No two clients may have the same name per broker.</td>
+</tr>
+
+<tr>
+<td><strong>Required</strong></td>
+<td><code>authentication: HonoAuthentication</code></td>
+<td>Credentials or identification for authentication to the Hono network.</td>
+</tr>
+</tbody>
+</table>
+
+<h4 id="signals-3">Signals</h4>
+
+<table>
+<thead>
+<tr>
+<th>Name</th>
+<th>Description</th>
+<th>Parameters</th>
+<th></th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td><code>telemetry: string</code></td>
+<td>Publishes a message to a particular topic.</td>
+<td><code>qos: uint32</code></td>
+<td>Default: <code>0</code></td>
+</tr>
+
+<tr>
+<td><code>event: string</code></td>
+<td>Publishes a message to a particular topic.</td>
+<td><code>qos: uint32</code></td>
+<td>Default: <code>0</code></td>
+</tr>
+</tbody>
+</table>
+
+<h3 id="rest-over-http">REST over HTTP</h3>
+
+<p>Using REST you can easily talk to servers over HTTP. REST defines a stateless interface with a simple URL scheme. Normally a REST server consists of a versioned endpoint like <code>http://api.github.com/v3</code> which then provides different resources, for example <code>api.github.com/v3/repos/eclipse/mita/branches</code> and <code>/repos/eclipse/mita/issues</code>.</p>
+
+<p>Currently only writing is supported.</p>
+
+<h4 id="example-2">Example</h4>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="nx">setup</span> <span class="nx">net</span>: <span class="kt">WLAN</span> <span class="p">{</span> <span class="cm">/* ... */</span> <span class="p">}</span>
+
+<span class="nx">setup</span> <span class="nx">backend</span>: <span class="kt">HttpRestClient</span> <span class="p">{</span>
+ <span class="nx">transport</span> <span class="o">=</span> <span class="nx">net</span><span class="p">;</span>
+ <span class="nx">endpointBase</span> <span class="o">=</span> <span class="s2">"http://jsonplaceholder.typicode.com"</span><span class="p">;</span>
+
+ <span class="kd">var</span> <span class="nx">posts</span> <span class="o">=</span> <span class="nx">resource</span><span class="p">(</span><span class="s2">"/posts"</span><span class="p">);</span>
+<span class="p">}</span>
+
+<span class="nx">every</span> <span class="mi">100</span> <span class="nx">milliseconds</span> <span class="p">{</span>
+ <span class="nx">backend</span><span class="p">.</span><span class="nx">branches</span><span class="p">.</span><span class="nx">write</span><span class="p">(</span><span class="sb">`</span><span class="si">${</span><span class="nx">accelerometer</span><span class="p">.</span><span class="nx">magnitude</span><span class="p">.</span><span class="nx">read</span><span class="p">()</span><span class="si">}</span><span class="sb">`</span><span class="p">);</span>
+<span class="p">}</span></code></pre></div>
+<h4 id="configuration-13">Configuration</h4>
+
+<table>
+<thead>
+<tr>
+<th></th>
+<th>Name</th>
+<th>Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td><strong>Required</strong></td>
+<td><code>transport: WLAN</code></td>
+<td>The transport layer used for communication.</td>
+</tr>
+
+<tr>
+<td><strong>Required</strong></td>
+<td><code>endpointBase: string</code></td>
<td>The server URL base to which REST requests are made.</td>
</tr>
<tr>
<td></td>
-<td><code>headerContent : string</code></td>
+<td><code>headerContent: string</code></td>
<td>A custom header which is added to each HTTP request. Example: <code>"X-Auth: MySecretToken\nX-Version: 1.0"</code>.</td>
</tr>
</tbody>
@@ -1277,23 +1606,23 @@
<tbody>
<tr>
-<td><code>resource : string</code></td>
+<td><code>resource: string</code></td>
<td>A REST resource on the server.</td>
-<td><code>endpoint : string</code></td>
+<td><code>endpoint: string</code></td>
<td>The REST path to the resource.</td>
</tr>
<tr>
<td></td>
<td></td>
-<td><code>writeMethod : HttpMethod</code></td>
+<td><code>writeMethod: HttpMethod</code></td>
<td>Which method to use when writing. Default: <code>POST</code></td>
</tr>
<tr>
<td></td>
<td></td>
-<td><code>readMethod : HttpMethod</code></td>
+<td><code>readMethod: HttpMethod</code></td>
<td>Which method to use when reading. Default: <code>GET</code></td>
</tr>
</tbody>
@@ -1305,7 +1634,17 @@
<p>GPIO provides bit-wise communication with the environment. Low (0V) and high (3.3V) are represented by <code>false</code> and <code>true</code>.</p>
-<h4 id="signals-2">Signals</h4>
+<h4 id="example-3">Example</h4>
+<div class="highlight"><pre class="chroma"><code class="language-TypeScript" data-lang="TypeScript"><span class="nx">setup</span> <span class="nx">test</span>: <span class="kt">GPIO</span> <span class="p">{</span>
+ <span class="kd">var</span> <span class="nx">out</span> <span class="o">=</span> <span class="nx">digitalOut</span><span class="p">(</span><span class="nx">pin</span> <span class="o">=</span> <span class="nx">PA1</span><span class="p">,</span> <span class="nx">initialValue</span> <span class="o">=</span> <span class="kc">false</span><span class="p">);</span>
+ <span class="kd">var</span> <span class="nx">inp</span> <span class="o">=</span> <span class="nx">digitalIn</span><span class="p">(</span><span class="nx">pin</span> <span class="o">=</span> <span class="nx">PB2</span><span class="p">,</span> <span class="nx">mode</span> <span class="o">=</span> <span class="nx">PullDown</span><span class="p">);</span>
+<span class="p">}</span>
+
+<span class="nx">every</span> <span class="mi">100</span> <span class="nx">milliseconds</span> <span class="p">{</span>
+ <span class="nx">test</span><span class="p">.</span><span class="nx">out</span><span class="p">.</span><span class="nx">write</span><span class="p">(</span><span class="kc">true</span><span class="p">);</span>
+ <span class="kd">let</span> <span class="nx">x</span> <span class="o">=</span> <span class="nx">test</span><span class="p">.</span><span class="nx">inp</span><span class="p">.</span><span class="nx">read</span><span class="p">();</span>
+<span class="p">}</span></code></pre></div>
+<h4 id="signals-4">Signals</h4>
<table>
<thead>
@@ -1319,30 +1658,30 @@
<tbody>
<tr>
-<td><code>digitalIn : bool</code></td>
+<td><code>digitalIn: bool</code></td>
<td>A GPIO-pin configured in input mode.</td>
-<td><code>pin : GPIOPin</code></td>
+<td><code>pin: GPIOPin</code></td>
<td>which pin to configure.</td>
</tr>
<tr>
<td></td>
<td></td>
-<td><code>mode : GPIOMode</code></td>
+<td><code>mode: GPIOMode</code></td>
<td>whether this pin is pull up, pull down or floating.</td>
</tr>
<tr>
-<td><code>digitalOut : bool</code></td>
+<td><code>digitalOut: bool</code></td>
<td>A GPIO-pin configured in output mode.</td>
-<td><code>pin : GPIOPin</code></td>
+<td><code>pin: GPIOPin</code></td>
<td>which pin to configure.</td>
</tr>
<tr>
<td></td>
<td></td>
-<td><code>initialValue : bool</code></td>
+<td><code>initialValue: bool</code></td>
<td>The pin’s initial value after startup. Default is low (<code>false</code>).</td>
</tr>
</tbody>
@@ -1352,7 +1691,7 @@
<p>The I2C bus provides access to interfaced devices via I2C.</p>
-<h4 id="configuration-10">Configuration</h4>
+<h4 id="configuration-14">Configuration</h4>
<table>
<thead>
@@ -1372,13 +1711,13 @@
<tr>
<td></td>
-<td><code>byteOrder : ByteOrder</code></td>
+<td><code>byteOrder: ByteOrder</code></td>
<td>Byte ordering for multi-byte words. Default is little endian, the XDK’s internal order.</td>
</tr>
</tbody>
</table>
-<h4 id="signals-3">Signals</h4>
+<h4 id="signals-5">Signals</h4>
<table>
<thead>
@@ -1394,35 +1733,35 @@
<tr>
<td><code>register_</code><em>intType</em><code>:</code><em>intType</em></td>
<td>A device register of size and sign specified by <em>intType</em>.</td>
-<td><code>address : uint8</code></td>
+<td><code>address: uint8</code></td>
<td>the register’s address.</td>
</tr>
<tr>
<td></td>
<td></td>
-<td><code>I2CMode : I2CMode</code></td>
+<td><code>I2CMode: I2CMode</code></td>
<td>whether this register is read, write, both or none. This only has an effect on validation, not on initialization.</td>
</tr>
<tr>
<td><code>array_register_</code> <em>intType</em> <code>: array<</code><em>intType</em><code>></code></td>
<td>A device register consisting of multiple words of size and sign specified by <em>intType</em>.</td>
-<td><code>address : uint8</code></td>
+<td><code>address: uint8</code></td>
<td>the register’s starting address.</td>
</tr>
<tr>
<td></td>
<td></td>
-<td><code>I2CMode : I2CMode</code></td>
+<td><code>I2CMode: I2CMode</code></td>
<td>whether this register is read, write, both or none. This only has an effect on validation, not on initialization.</td>
</tr>
<tr>
<td></td>
<td></td>
-<td><code>length : uint8</code></td>
+<td><code>length: uint8</code></td>
<td>how many words this register consists of.</td>
</tr>
</tbody>
diff --git a/sitemap.xml b/sitemap.xml
index 5ae6bcf..4a1ba57 100644
--- a/sitemap.xml
+++ b/sitemap.xml
@@ -51,6 +51,10 @@
</url>
<url>
+ <loc>/platforms/arduinouno/</loc>
+ </url>
+
+ <url>
<loc>/language/exceptions/</loc>
</url>
