A few days ago, one of my readers contacted me because he was having a hard time getting started with Openhab. He mentioned that it would be nice to publish some information for those users that have just installed the platform but don’t know what to do with it (Thanks for the suggestion! ). Today, I want to provide you some resources to help you with the first hours of struggle. Let’s start with the list of best resources for newbies to Openhab.
The idea is to grow this post over time including new resources that might be interesting for you.
Overview Of the OpenHab Platform
If you are completely new to the platform, your first stop should be the tutorial for beginners. It gives you just the right amount of information without getting too deep into the details. Check it out on beginner’s Guide to OpenHab.
Understanding the Basic concepts
OpenHab is extremely well documented but trying to read everything at first can be a bit overwhelming. For those of you just starting, I think it is crucial to familiarize yourself with the following five concepts.
Quoting the OpenHab documentation…
Things are entities that can be physically added to a system
In other words, Things are representations of physical objects, for example, a smart bulb or a temperature sensor… Things do not only represent physical objects in the traditional sense. They can also represent the connector to a service that provides you with the weather forecast, for example. Check all the information about Things on the OpenHab Documentation.
Every given Thing provides different types of services called Channels.
Let’s say that you are installing a thermostat for example. The Thing thermostat would represent the thermostat itself which may have different channels like Temperature to provide you with the temperature in the room or mode to allow you to set a given function on your thermostat. Check all the information about Channels on the OpenHab Documentation.
Items are linked to channels and represent a particular functionality or piece of information. You will need to create an item for each channel that you want to use on a sitemap. You definitely want to check the full documentation about OpenHab Items.
You can think of a Binding as a plugin that provides support for different smart home gadgets (Phillips Hue, Nest Thermostat…). Check the full list of OpenHab Bindings here.
A sitemap is basically a UI for the end users. You will configure the items that you want to appear in your BasicUI and how do you want to display them. This document is a must to get you up to speed on Sitemaps.
Not clear yet? Let’s go through an example.
Imagine that you just got back from the store with your brand new Smart Bulb and you want to control it using OpenHab. What do you do?
- Install the binding for your corresponding Smart Bulb from the PaperUI (Phillips Hue, Lifx, MiLight…)
- Go to the OpenHab Inbox and install the Thing or Things published by the Binding you just installed.
- Create items for the channels you want to use, like Color and Brightness for example.
- Create a Sitemap that allows you to turn ON your Smart Bulb and change its color.
The links above will get you started with OpenHab and should be sufficient for you to get by, however, you should eventually read the full documentation here to get the best out of the platform
If you don’t happen to be up for some reading today, don’t worry. Here you have 2 videos that were sent by one of my readers. They are great to walk you through the first steps and learn more about OpenHab.
I would love to hear from you in the comments…
What did you struggle with when you started to work with OpenHab?
Do you have any material that might be useful for other readers and you would like to share?