From 72ab48f67e9d67860a82f0a66a03a948326e673d Mon Sep 17 00:00:00 2001 From: Thomas Dietrich Date: Mon, 23 Jan 2017 02:38:58 +0100 Subject: [PATCH] [Configuration] Add overview 1st draft (#252) * Add motivational intro part to config Signed-off-by: Thomas Dietrich * Add overview table and other details Signed-off-by: Thomas Dietrich --- configuration/index.md | 151 ++++++++++++++++++++++++++++++++++++++++- css/styles.css | 4 +- 2 files changed, 151 insertions(+), 4 deletions(-) diff --git a/configuration/index.md b/configuration/index.md index cd68287ff..d4ae0473f 100644 --- a/configuration/index.md +++ b/configuration/index.md @@ -5,6 +5,153 @@ title: Configuration {% include base.html %} -# Configuration +# Configuration of your Smart Home -{% include contribution-wanted.html %} +openHAB is the center of your home automation. +Properties and capabilities of all your devices are available through openHAB to the user frontend, the rule engine and other parts and connected systems. + +openHAB is a system installed and executed by you, **running independently** from any online services or proprietary technologies. +You as the end-user have the **full control** over every aspect of your smart home. + +Every device connected to openHAB is functionally and logically different. +In order to represent all of these, openHAB defines the following few base components with the given meaning: + +* [Bindings]({{base}}/addons/bindings.html) - The numerous Add-ons to communicate with your devices +* [Things](things.html) - Your devices represented in openHAB +* [Items](items.html) - properties and capabilities of your Things +* [Groups](items.html#groups) - collections or categories containing Items +* [Sitemaps](sitemaps.html) - User-defined frontend interfaces to arrange Groups, Items and more +* [Transformations](transform.html) - Helper functions to transform your data +* [Persistence](persistence.html) - Services to store data over time +* [Rules](rules-dsl.html) - Automation logic, the heart of your SmartHome! + +The individual articles hold all details needed to understand the concepts behind these building bricks for your Smart Home. +For more details on the base concept behind openHAB, please visit the [Concepts Overview page]({{base}}/concepts/index.html). + +## Versatility + +openHAB provides different user interfaces to modify settings, manage your things and items, build rules and access the sitemap results. +Every interface has it's own strong points. + +## Comparison + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
TaskTextual ConfigurationPaper UIHABminother UIsKaraf Console
Auto-Discover Things and Items❌✔️✔️❌✔️
Define Things✔️✔️✔️❌✔️
Define Items✔️✔️✔️❌✔️
Define Groups✔️✔️✔️❌✔️
Define Sitemaps✔️❌❌(HABPanel)❌
Access Sitemaps❌✔️ (limited)❌✔️❌
Define Transformations✔️❌❌❌❌
Define Persistence✔️❌❌❌❌
Define Rules✔️✔️ (Experimental)✔️ (Graphical)❌❌
Manage Z-Wave Devices✔️ (not recommended)✔️ (limited)✔️❌❌
Modify openHAB Settings✔️✔️❌❌✔️
Install Add-ons✔️✔️❌❌✔️
+ +{: #text-vs-ui} +## Textual vs. Graphical Configuration + +With openHAB 1.x the smart home configuration was done via configuration files only. +One of the most visible additions to openHAB 2 was the adminstrative web interface Paper UI. + +Things and Items can either be defined and managed in configuration files or handled by Paper UI in a system-side database. +Both methodes can be used side-by-side or even mixed, e.g. a Thing is discovered by Paper UI and connected Items are defined in a Items configuration file. diff --git a/css/styles.css b/css/styles.css index 1bb70ddad..946fde982 100644 --- a/css/styles.css +++ b/css/styles.css @@ -615,10 +615,10 @@ section.text table { } -section.text table td { +/*section.text table td { padding: 5px; border: 1px solid #CCC; -} +}*/ table.striped tbody tr:nth-child(odd) { background-color: #f7f7f7;