openhab-docs/v2.2/tutorials/advanced/configuring.html

223 lines
8.5 KiB
HTML
Raw Permalink Blame History

This file contains invisible Unicode characters!

This file contains invisible Unicode characters that may be processed differently from what appears below. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to reveal hidden characters.

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

<!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/configuring.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="configuring-a-thing">Configuring a Thing</h1>
<p>You can access to the Thing configuration by clicking on <em>Configuration</em>, <em>Thing Configuration</em> in the right menu.</p>
<p>The Thing configuration display has 6 panels.</p>
<h2 id="configuration-panel-overview">Configuration panel overview</h2>
<p><img src="images/add-node-25.png" alt="" /></p>
<p>This panel contains the following information:</p>
<ul>
<li>The label giving you the model name of the <em>Thing</em>, read-only,</li>
<li>The overview, giving a description of the <em>Thing</em>, coming from the ZWave database, read-only,</li>
<li>A set of controls, one per actionable <em>item</em> that has been created. You can play with the control in order to check that your device is correctly working. The name and the identifier of the <em>item</em> are read-only.</li>
</ul>
<blockquote>
<p>The name of the item can be modified in the channels panel.</p>
</blockquote>
<h2 id="the-properties-panel">The properties panel</h2>
<p><img src="images/add-node-20.png" alt="" /></p>
<p>The properties panel presents the Label of the Thing.</p>
<p>You can change the label making it more informative.</p>
<p>The change is saved as soon as you select the <em>Save</em> button at the top of the windows.</p>
<h2 id="configuration-parameters-panel">Configuration parameters panel</h2>
<p>This panel presents the configuration parameters of the device</p>
<p>The content of this panel depends on the device model.</p>
<p>The use of these parameters are described in the users manual of the device itself.</p>
<p><img src="images/add-node-26.png" alt="" /></p>
<p>When a parameter value is changed, HABmin send it to the device. A <em>pending</em> message is displayed at this time.</p>
<p><img src="images/add-node-27.png" alt="" /></p>
<h2 id="association-group-panel">Association group panel</h2>
<p>«« TO BE COMPLETED »»</p>
<h2 id="device-configuration-panel">Device configuration panel</h2>
<p>«« TO BE COMPLETED »»</p>
<h2 id="channels-panel">Channels panel</h2>
<p>This panel is the key panel to configure the <em>Items</em>, as the channels are the link between <em>Things</em> and <em>Items</em>.</p>
<p><img src="images/add-node-35.png" alt="" /></p>
<p>Basically, HABmin will create one <em>Item</em> per channel.</p>
<p>Each channel follows the same following structure:</p>
<p><img src="images/thing-channels-1.png" alt="" /></p>
<p>Five buttons allow different actions:</p>
<p><img src="images/thing-channels-2.png" alt="" /></p>
<p>HABmin 2 creates and link automatically the needed <em>items</em> when a <em>thing</em> is created, so creating, deleting and linking action are not often used.</p>
<p>To personalise item information, the <em>edit linked data</em> button opens the following window:</p>
<p><img src="images/add-node-40.png" alt="" /></p>
<p>This window allows to:</p>
<ul>
<li>change the label, making it more informative,</li>
<li>modify the item type if needed,</li>
<li>modify the category if needed.</li>
</ul>
<p>The modification are saved as soon as you select the <em>Save</em> button.</p>
</div>
</div>
</section>
<footer>
<div class="container">
<div class="row">
<div class="col s12 m7">
Copyright &copy; 2017 by the <a href="https://github.com/openhab">openHAB Community</a> and the <a href="http://www.openhabfoundation.org/">openHAB&nbsp;Foundation&nbsp;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>