186 lines
8.1 KiB
HTML
186 lines
8.1 KiB
HTML
<!DOCTYPE html>
|
|
<html lang="en">
|
|
<head>
|
|
<meta charset="utf-8">
|
|
<meta http-equiv="X-UA-Compatible" content="IE=edge">
|
|
<meta name="viewport" content="width=device-width, initial-scale=1">
|
|
|
|
|
|
|
|
|
|
<!--<link rel="shortcut icon" href="https://www.openhab.org/favicon.png"></link>-->
|
|
<title>openHAB 2 - Empowering the Smart Home</title>
|
|
|
|
<!-- CSS -->
|
|
<link type="text/css" rel="stylesheet" href="/v2.2/css/materialize.css" media="screen,projection" />
|
|
<link type="text/css" rel="stylesheet" href="/v2.2/css/pygments-jekyll-style.css" />
|
|
<link type="text/css" rel="stylesheet" href="/v2.2/css/styles.css" />
|
|
<link type="text/css" rel="stylesheet" href="/v2.2/css/openhab.css" />
|
|
<link type="text/css" rel="stylesheet" href="/v2.2/css/collapsible.css" />
|
|
|
|
<!-- Font -->
|
|
<link type="text/css" rel="stylesheet" href="https://fonts.googleapis.com/icon?family=Material+Icons" />
|
|
<link type="text/css" rel="stylesheet" href="https://fonts.googleapis.com/css?family=Lato:300,400,700" />
|
|
<link rel="canonical" href="https://docs.openhab.org/tutorials/advanced/adding.html" />
|
|
<script type="text/javascript">var gaProperty = 'UA-47717934-3';var disableStr = 'ga-disable-' + gaProperty;if (document.cookie.indexOf(disableStr + '=true') > -1) {window[disableStr] = true;}</script>
|
|
<script>
|
|
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
|
|
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
|
|
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
|
|
})(window,document,'script','https://www.google-analytics.com/analytics.js','ga');
|
|
ga('create', 'UA-47717934-3', 'auto');
|
|
ga('set', 'anonymizeIp', true);
|
|
ga('send', 'pageview');
|
|
</script>
|
|
</head>
|
|
|
|
|
|
<body class="documentation">
|
|
<div id="header" class="navbar-fixed">
|
|
<nav role="navigation">
|
|
<div class="container">
|
|
<div class="nav-wrapper">
|
|
<a href="/v2.2/index.html"><img id="logo" src="/images/logo.png" /></a>
|
|
<a href="#" data-activates="nav-mobile" class="button-collapse"><i class="material-icons">menu</i></a>
|
|
<ul class="right hide-on-med-and-down">
|
|
<li><a href="/tutorials/index.html">Tutorials</a></li>
|
|
<li><a href="/v2.2/introduction.html">User Manual</a></li>
|
|
<li><a href="/developers/index.html">Developer Guide</a></li>
|
|
<li><a target="_blank" href="https://community.openhab.org">Community Forum</a></li>
|
|
<li><a target="_blank" href="https://github.com/openhab">GitHub</a></li>
|
|
<li class="search"><i class="material-icons">search</i></li>
|
|
<li class="search">
|
|
<form method="GET" id="searchform" class="search-form" action="/search">
|
|
<input id="query" name="q" type="text" class="search-form-input" placeholder="search" />
|
|
</form>
|
|
</li>
|
|
</ul>
|
|
<ul id="nav-mobile" class="side-nav">
|
|
<li><a href="/v2.2/index.html">Home</a></li>
|
|
<li><a href="/tutorials/index.html">Tutorials</a></li>
|
|
<li><a href="/v2.2/introduction.html">User Manual</a></li>
|
|
<li><a href="/developers/index.html">Developer Guide</a></li>
|
|
<li><a target="_blank" href="https://community.openhab.org">Community Forum</a></li>
|
|
<li><a target="_blank" href="https://github.com/openhab">GitHub</a></li>
|
|
<li class="search">
|
|
<form method="GET" id="searchformmob" class="search-form" action="/search">
|
|
<input id="querymob" name="q" type="text" class="search-form-input" placeholder="search" />
|
|
</form>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</nav>
|
|
</div>
|
|
|
|
|
|
<section id="documentation" class="text content-wrapper">
|
|
<div class="container">
|
|
<div class="side-nav-wrapper">
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<ul class="nav">
|
|
<li>Tutorial (Advanced)</li>
|
|
<ul>
|
|
<li><a href="/v2.2/tutorials/advanced/index.html">Overview</a></li>
|
|
<li><a href="/v2.2/tutorials/advanced/installing.html">Installing the extension</a></li>
|
|
<li><a href="/v2.2/tutorials/advanced/connecting.html">Connecting to the Z-Wave controller</a></li>
|
|
<li><a href="/v2.2/tutorials/advanced/adding.html">Adding a new thing</a></li>
|
|
<li><a href="/v2.2/tutorials/advanced/configuring.html">Configuring a thing</a></li>
|
|
<li><a href="/v2.2/tutorials/advanced/tools.html">Other tools of HABmin</a></li>
|
|
</ul>
|
|
</ul>
|
|
|
|
</div>
|
|
<div class="content">
|
|
|
|
<h1 id="adding-a-new-thing">Adding a new Thing</h1>
|
|
|
|
<h2 id="inserting-the-device-in-the-z-wave-network">Inserting the device in the z-wave network</h2>
|
|
<p>The first action is to insert the new device in the z-wave netowrk. This is to be done using the controller.</p>
|
|
|
|
<p>openHAB has nothing to do at this stage. All the operations are managed from the controller itself.</p>
|
|
|
|
<h2 id="adding-the-new-thing">Adding the new Thing</h2>
|
|
|
|
<p>A few seconds after your device has been inserted inside the network using the controller, a new Thing appears in the inbox.</p>
|
|
|
|
<p>As you can see in the following picture, a small green label with the number of new things appears at the top right of the HABmin 2 screen.</p>
|
|
|
|
<p><img src="images/add-node-10.png" alt="" /></p>
|
|
|
|
<p>If you click on it, the inbox pops up with the list of the newly detected Things.</p>
|
|
|
|
<p><img src="images/add-node-15.png" alt="" /></p>
|
|
|
|
<p>As you can see in the previous screenshot, HABmin is able to find out the model of the device that the Things represents. This allows HABmin to automatically setup the corresponding Items.</p>
|
|
|
|
<p>The “Z-Wave Node 2” mention gives the openHAB internal number of the ZWave node, in our case 2.</p>
|
|
|
|
<blockquote>
|
|
<p>HABmin is using an internal database to fetch configuration data corresponding to the device.</p>
|
|
|
|
<p>If this device is not in the database, then no device model will be displayed but a code identifying the device.</p>
|
|
|
|
<p><img src="images/zwave-node-badnode.png" alt="" /></p>
|
|
|
|
<p>In this example, the Thing “Z-wave Node 3” has not been found in the ZWave database and the Thing “Z-wave Node 4” has been successfully identified.</p>
|
|
|
|
<p>The section <em>The ZWave Database</em> details more the database and how you can send information about a new device.</p>
|
|
|
|
<p>If there is no device model nor code displayed, this means that HABmin is still waiting for information about the device. This occurs with battery powered devices, as HABmin has to wait for the next wakeup time of the device to obtain the needed information.</p>
|
|
</blockquote>
|
|
|
|
<p>To be able to finalize configuration of the <em>Thing</em> and the linked <em>Items</em>, you have to click on “add” just below the name of the <em>Thing</em>.</p>
|
|
|
|
<p>You can then find the Thing in the list of Things, by clicking on <em>Configuration</em>, <em>Thing Configuration</em> in the right menu.</p>
|
|
|
|
<p><img src="images/add-node-20.png" alt="" /></p>
|
|
|
|
<h2 id="configuring-the-thing">Configuring the Thing</h2>
|
|
|
|
<p>Configuring a newly imported Thing or changing the configuration of an older one is made through the <em>Configuration, Thing Configuration</em> menu.</p>
|
|
|
|
<p>This is described in the next chapter.</p>
|
|
|
|
|
|
</div>
|
|
</div>
|
|
</section>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<footer>
|
|
<div class="container">
|
|
<div class="row">
|
|
<div class="col s12 m7">
|
|
Copyright © 2017 by the <a href="https://github.com/openhab">openHAB Community</a> and the <a href="http://www.openhabfoundation.org/">openHAB Foundation e.V.</a>
|
|
</div>
|
|
<div class="col s12 m5">
|
|
<ul class="list-inline right-align">
|
|
<li><a href="/imprint.html">Imprint</a></li>
|
|
<li><a href="/privacy.html">Privacy Policy</a></li>
|
|
<li><a href="http://www.openhab.org">openHAB Website</a></li>
|
|
<li><a href=# onclick="printPage()">Print This Page</a></li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</footer>
|
|
<script src="/v2.2/js/jquery.min.js"></script>
|
|
<script src="/v2.2/js/jquery.scrollme.min.js"></script>
|
|
<script src="/v2.2/js/jquery.sticky.js"></script>
|
|
<script src="/v2.2/js/materialize.min.js"></script>
|
|
<script src="/v2.2/js/init.js"></script>
|
|
<script src="/v2.2/js/functions.js"></script>
|
|
</body>
|
|
</html>
|
|
|