openHAB 2 Home Builder: Grundstruktur erstellen – Schritt für Schritt

22. Oktober 2019 Aktualisiert: 11. Mai 2026 3 Min. Lesezeit
Teilen:
openHAB 2 Home Builder: Grundstruktur erstellen – Schritt für Schritt

In diesem Beitrag sehen wir uns an, wie wir mit dem openHAB Home Builder Tool die Grundstruktur unseres Hauses bzw. unserer Wohnung in openHAB 2 anlegen.

Tutorial

openHAB 2: Visual Studio Code einrichten – Schritt für Schritt

Grundriss

Folgenden Grundriss werden wir in openHAB 2 anlegen. Ihr werdet sehen, dass sich die gezeigte Vorgehensweise ganz einfach auf euren eigenen Grundriss anpassen lässt.

openHAB 2 Home Builder – Grundriss der Beispielwohnung

Home Builder installieren

Bevor wir starten, sollte openHAB bereits auf dem Raspberry Pi oder einem anderen System installiert sein. Damit der Home Builder verfügbar ist, muss mindestens das Standard Paket bei der Installation ausgewählt worden sein:

openHAB 2 Home Builder – Standard Paket bei Installation auswählen

Den Home Builder findet ihr auf der openHAB Startseite:

openHAB 2 Home Builder – Home Builder auf der Startseite auswählen

Sollte der Home Builder dort nicht erscheinen, kann er unter Paper UI → Add-ons → USER INTERFACES nachträglich installiert werden:

openHAB 2 Home Builder – Home Builder über Paper UI installieren

Der Home Builder ist danach über die openHAB Startseite erreichbar — bei Installation auf einem Raspberry Pi auch direkt unter openHABianPi:8080/homebuilder/index.html:

openHAB 2 Home Builder – Home Builder Startseite

Tipp

openHAB 2 Home Builder – UIs als Lesezeichen speichern

Grundstruktur erstellen

Sprache und Setup-Name

Als erstes die Sprache auf German umstellen:

openHAB 2 Home Builder – Sprache auf Deutsch einstellen

Dann einen Setup-Namen vergeben. Ich nenne mein Setup wohnung_admin — warum das _admin sinnvoll ist, erklärt der nächste Teil dieser Reihe:

openHAB 2 Home Builder – Home Setup Name vergeben

Stockwerke (Floors)

Unter Floor die Stockwerke eures Hauses oder eurer Wohnung angeben. Für dieses Beispiel verwende ich den oben gezeigten Grundriss — eine klassische Drei-Zimmer-Wohnung. Ich wähle Draußen und Erdgeschoss:

openHAB 2 Home Builder – Floors / Stockwerke auswählen

Räume (Rooms)

Für jedes Stockwerk können nun die Räume hinzugefügt werden. Für Draußen füge ich einen Lagerraum hinzu:

openHAB 2 Home Builder – Rooms für Draußen festlegen

Für das Erdgeschoss: Gang, Schlafzimmer, Wohn-Esszimmer, Büro, Abstellraum, Badezimmer und Toilette:

openHAB 2 Home Builder – Rooms für die Wohnung festlegen

Hinweis

Die Objektzuteilung lassen wir vorerst frei. Ganz unten Include Tags deaktivieren und den Rest so belassen:

openHAB 2 Home Builder – Include Tags deaktivieren

Items und Sitemap kopieren

Rechts erscheinen zwei blaue Buttons: Items und Sitemap:

openHAB 2 Home Builder – ITEMS und SITEMAP Buttons

Items in Visual Studio Code einfügen

Items öffnen — der Code wurde automatisch generiert. Rechts oben auf Copy klicken:

openHAB 2 Home Builder – Copy ITEMS

In Visual Studio Code im openHAB-conf Ordner unter items eine neue Datei anlegen:

openHAB 2 Home Builder – items Datei in Visual Studio Code erstellen

Die Datei muss die Endung .items haben — in diesem Beispiel wohnung.items. Den kopierten Code einfügen und speichern:

openHAB 2 Home Builder – wohnung.items Datei mit Code

Sitemap in Visual Studio Code einfügen

Zurück im Home Builder die Sitemap kopieren:

openHAB 2 Home Builder – Copy SITEMAP

In Visual Studio Code im Ordner sitemaps eine neue Datei erstellen. Wichtig: Der Dateiname muss dem zuvor vergebenen Setup-Namen entsprechen, mit der Endung .sitemap — also wohnung_admin.sitemap. Code einfügen und speichern:

openHAB 2 Home Builder – wohnung_admin.sitemap Datei mit Code

Ergebnis im Basic UI

Jetzt das Basic UI im Editor öffnen (oder im Browser aufrufen). Wir sehen die zwei Gruppen Draußen und Erdgeschoss, und darin die einzelnen Räume:

openHAB 2 Home Builder – Basic UI mit Grundstruktur openHAB 2 Home Builder – Basic UI Räume im Detail

Die Grundstruktur steht — im nächsten Teil der Reihe erweitern und passen wir sie an.

Video zum Beitrag

Häufige Fragen zum openHAB 2 Home Builder

Was ist der openHAB Home Builder?
Der Home Builder ist ein in openHAB integriertes Tool, das automatisch Items und Sitemaps auf Basis der eingetragenen Räume und Stockwerke generiert.
Wo finde ich den Home Builder in openHAB?
Auf der openHAB Startseite, oder bei Raspberry Pi direkt unter openHABianPi:8080/homebuilder/index.html. Falls er nicht erscheint, kann er unter Paper UI → Add-ons → USER INTERFACES installiert werden.
Warum soll ich _admin an den Setup-Namen hängen?
Das hat mit der Trennung zwischen Benutzer- und Admin-Sitemaps zu tun und wird im nächsten Teil der Reihe erklärt.
Wie viele Räume kann ich pro Stockwerk anlegen?
Den Home Builder-Standardtypen nach ist jeder Raumtyp pro Stockwerk nur einmal wählbar. Fehlende Zimmer können aber nachträglich manuell in der .items und .sitemap Datei ergänzt werden.

Hat dir der Artikel gefallen? Teile ihn!