Wikipedia Artikel

[staehler]

Hallo zusammen,

ich bin so begeistert von openHAB, dass ich zumindest einen kleinen Beitrag dazu beitragen möchte (bin leider kein Entwickler, zumindest in Java). Ich habe begonnen einen Wikipedia Artikel einzustellen (FHEM ist immerhin auch in Wikipedia).
Jeder ist natürlich herzlich dazu eingeladen, den Artikel zu verbessern. Ich denke, damit kann man vielleicht weitere Heimautomatierer hinzugewinnen oder zumindest darauf aufmerksam machen.

Eine Frage hätte ich noch: darf ich das "openHAB - empowering the smart home"-Logo in Wikipedia hochladen. Die Frage stelle ich wegen der Urheberschaft und dafür ist eine Genehmigung nötig.

Der Wikipedia Artikel ist noch sehr rudimentär, aber ein Anfang ist gemacht.

Viele Grüße
Michael

[kkreuzer]

Super Initiative!
Thomas hatte vor einer Weile das ganze übrigens auch schonmal versucht - allerdings auf dem englischen Wikipedia. Da wurde seine lange Seite abgelehnt, weil es nicht "relevant genug" sei
Toll, dass es zumindest auf der deutschen Seite geklappt hat! Ich hoffe, dass Thomas evtl. Teile seiner englischen Version übersetzen und dort ebenfalls einpflegen kann. Und vielleicht ist ein neuer Versuch der englischen Version nun auch erfolgreich...?
Bzgl. Logo werde ich mal eine schriftliche Einwilligung von Mihail besorgen, der dieses erstellt hat.

Grüße,
Kai

[staehler]

Hallo Kai,

ich würde mich anbieten, Thomas Artikel in Wikipedia einzuarbeiten (zumindest könnte ich damit anfangen). Hast Du den Text und Bilder dazu?
Ich nehem an, dass die Freigabe von Mihail noch nicht vorliegt für das openHAP Logo.

Gruß Michael

[kkreuzer]

Hi Michael,

habe bei Thomas angefragt. Richtig, von Mihail habe ich leider noch nichts gehört, habe ihn gerade nochmal erneut angepingt...

Grüße,
Kai

[teichsta]

Hi Michael,

vielen Dank für Deine Initiative!

"Meine" Wikipedia-Seite wurde inzwischen aus dem temporären Bereich gelöscht, weil ich daran nicht weitergearbeitet habe *hmpf*. Hatte sie mir damals aber sicherheitshalber in einer lokalen Textdatei gespeichert ;-)

{{AFC submission|d|nn|declinets=20130505223711|decliner=Rinkle gorge|ts=20130429231424|u=Teichsta|ns=2}}
*{{afc comment|1=Interesting project, but the author needs to provide some reliable sources to prove notability. [[User:Rinkle gorge|Rinkle gorge]] ([[User talk:Rinkle gorge|talk]]) 22:37, 5 May 2013 (UTC)}}
----

{{lead too short|date=April 2013}}
{{infobox software
| name                   = openHAB - open Home Automation Bus
| logo                   = [[File:openHAB Horizontal LightBackground.png|200px|openHAB Logo]]
| screenshot             =
| caption                =
| founder                 = Kai Kreuzer
| developer              = [http://code.google.com/p/openhab/people/list openHAB Developers]
| released               = 2003 <!-- {{Start date|YYYY|MM|DD|df=yes/no}} -->
| operating system       = [[Mac OS X]], [[Linux]], [[Solaris (operating system)|Solaris]], [[FreeBSD]], [[OpenBSD]], [[Windows]]
| status                 = Active
| released               =
| latest release version = 1.2.0
| latest release date    = {{release date|2013|04|14}}

| latest preview version = 1.3.0-SNAPSHOT
| programming language   = [[Java]]
| genre                  = [[homeautomation]]
| license                = [[GPL License]]
| website                = {{URL|http://openHAB.org/}}
}}

The '''open Home Automation Bus''' ('''openHAB''') is a is a [[free software|free]] and [[open source]] software project which  aims at providing a universal integration platform for all things around home automation. It is a pure [[Java]] solution, fully based on [[OSGi]]. The Equinox [[OSGi]] runtime and [[Jetty]] as a web server build the core foundation of the runtime.

It is designed to be absolutely vendor-neutral as well as hardware/protocol-agnostic. openHAB brings together different bus systems, hardware devices and interface protocols by dedicated bindings. These bindings send and receive commands and status updates on the openHAB event bus. This concept allows designing user interfaces with a unique look&feel, but with the possibility to operate devices based on a big number of different technologies. Besides the user interfaces, it also brings the power of automation logics across different system boundaries.

== Architecture ==

The openHAB project is split into two parts
# openhab-runtime: This is the package, which you will actually run on your server and which does the "real" work.
# openhab-designer: This is more or less a configuration tool for the openhab-runtime. It comes with user-friendly editors to configure your runtime, to define your UIs and to implement your rules.

=== openHAB Runtime ===

The openHAB runtime is a set of OSGi bundles deployed on an OSGi framework (Equinox). It is therefore a pure Java solution and needs a JVM to run. Being based on OSGi, it provides a highly modular architecture, which even allows adding and removing functionality during runtime without stopping the service. Here is an overview over the main bundles and how they depend on each other:

http://wiki.openhab.googlecode.com/hg/images/architecture.png

==== Communication ====

openHAB has two different internal communication channels:
# an asynchronous event b us
# a stateful repository, which can be queried

==== The Event Bus ====

The event bus is THE base service of openHAB. All bundles that do not require stateful behaviour should use it to inform other bundles about events and to be updated by other bundles on external events.

There are mainly two types of events: 
# Commands which trigger an action or a state change of some item/device.
# Status updates which inform about a status change of some item/device (often as a response to a command)

All protocol bindings (which provide the link to the real hardware devices) should be communicating via the Event Bus. This makes sure that there is a very low coupling between the bundles, which facilitates the dynamic nature of openHAB.

As a technical foundation, the OSGi !EventAdmin service is used by openHAB. This is a light-weight and ready-to-use pub-sub implementation, which perfectly meets the requirements.

It is important to note that openHAB is not meant to reside on (or near) actual hardware devices and as thus to remotely communicate with many other distributed openHAB instances. Instead, openHAB rather serves as an integration hub between such devices and as a mediator between different protocols that are spoken between these devices.
In a typical installation there will therefore be usually just one instance of openHAB running on some central server. Nonetheless, as the OSGi !EventAdmin service can also be used as a remote service, it is possible to connect several distributed openHAB instances via the Event Bus.

==== Item Repository ====

Not all functionality can be covered purely by stateless services. Out of this reason openHAB also offers the Item Repository, which is connected to the Event Bus and keeps track of the current status of all items.
The Item Repository can be used whenever it is necessary to be able to access the current state of items. E.g. a user interface needs to display the current state of items in the moment of the user access. Also the automation logic execution engine needs always needs to be informed about the current states.
The Item Repository avoids each bundle to cache states themselves for there internal use. It also makes sure that the state is in sync for all those bundles and it provides the possibility to persist states to the file system or a database, so that they are even kept throughout a system restart.

The following diagram shows how these communication channels are used:

http://wiki.openhab.googlecode.com/hg/images/events.png

==== Sitemap ====

openHAB comes with a generic textual configuration for its user interfaces: The so-called Sitemap. The sitemap is a tree structure of widgets, which define the different pages of a UI and their content. Widgets can be associated to items, for which they should show the status and/or control elements.

The definition of the Sitemap is quite abstract by design; it is supposed to be a suitable UI model for different kinds of user interfaces, so that the user does not have to configure each of them in case he sets up multiple UIs. If a UI has further requirements on top of the sitemap, it is still possible to introduce additional configuration options which are then specific for the UI in question.

==== Item UI Providers ====

Item UI providers offer a dynamic way to configure the UI, so that not everything must be stored statically in the Sitemap. An item UI provider can for example define, what widget should be used for an item, if none is specified and can dynamically define icons and labels (which might depend on the current state of the item) for the widgets.

An important use case for this feature is the dynamic display of item groups - all that there is stored in the Sitemap is the information that a certain group should be displayed; the page is then dynamically assembled at runtime with whatever items are available at that time.

=== openHAB Designer ===

The openHAB Designer is an Eclipse RCP application for configuring the openHAB runtime.
It comes with editors for configuration files like the sitemap. Its big advantage over simple text editors is the full IDE support like syntax checking, auto completion, highlighting and content assist. It is also meant to implement and deploy rules for automatic actions.

== Bindings ==

As the OSGi platform allows a highly modular architecture, the bindings are realized as different bundles, which can be dynamically plugged to openHAB, so that every user can decide on the bindings he is interested in.

There are many different hardware/protocol bindings:

* [[Asterisk (PBX)|Asterisk]]
* [[Bluetooth]]
* [[CUPS]]
* [[DMX512|DMX 512]]
* [[Fritzbox|AVM Fritzbox]]
* [[Homematic]]
* [[Http]]
* [[IHC/Elco]]
* [[KNX (standard)|KNX]]
* [[Koubachi]]
* [[Modbus]]
* [[Music Player Daemon|Music Player Daemon(MPD)]]
* [[Novelan]]
* [[Network Time Protocol|Network Time Protocol (NTP)]]
* [[1-Wire]]
* [[Philips Hue]]
* [[Plugwise]]
* [[PLCBUS|PLCBus]]
* [[Pulseaudio|PulseAudio]]
* [[RFXCom]]
* [[Samsung Electronics|Samsung TV]]
* [[RS-232|Serial]]
* [[Snmp|Simple Network Management Protocol (SNMP)]]
* [[Sonos]]
* [[Transmission Control Protocol|TCP]]/[[/User Datagram Protocol|UDP]]
* [[Video Disk Recorder|Video Disc Recorder (VDR)]]
* [[Wake on lan|Wake on LAN (WoL)]]
* and [http://code.google.com/p/openhab/wiki/Features more]

There more features which aren't hardware/protocol bindings but also available as separate bundles.

* [[Dropbox]] Support
* [http://code.google.com/p/openhab/wiki/GCalBinding Google Calendar Support]
* Text to speech implementation

== Graphical User Interfaces ==



===== Touch-optimized Web-UI for Smartphones =====

The main interface to communicate with openHAB is surely the [http://code.google.com/p/openhab/wiki/WebAppUI web-based UI]. It comes with the default runtime package and is pre-configured with a demo house. A demo of this UI is available at http://demo.openhab.org:8080/openhab.app?sitemap=demo

===== Native iOS Client =====

There is [http://code.google.com/p/openhab/wiki/iOS_UI iOS_UI] a native iOS User Interface available on the [https://itunes.apple.com/en/app/openhab/id492054521?mt=8 AppStore]. Go and check it out!

===== HABDroid a native Android Client =====

There is [http://code.google.com/p/openhab/wiki/HABDroid HABDroid] a native Android User Interface available on the [https://play.google.com/store/apps/details?id=org.openhab.habdroid Google !Play]. Go and check it out!

===== GreenT Web-UI for Smartphones and Tablets =====

There is a [http://code.google.com/p/openhab/wiki/TouchUI SenchaTouch-based UI], which can be used with smartphones and tablets likewise. This UI is [http://code.google.com/p/openhab/downloads/detail?name=openhab-greent-1.0.0.zip distributed as a separate package] and needs to be unzipped to {$openhab.home}/webapps. A demo of this UI is available at the url http://demo.openhab.org:8080/greent/

== Textual User Interfaces ==



===== OSGi Console =====

openHAB adds commands to the OSGi console. If you type "help" on the console, you will see a section like

   ---openHAB commands---
   	openhab send <item> <command> - sends a command for an item
   	openhab update <item> <state> - sends a status update for an item
   	openhab status <item> - shows the current status of an item
   	openhab items [<pattern>] - lists names and types of all items matching the pattern
   	openhab say <sentence to say> - Says a message through TTS on the host machine

With these you can manually send commands and status updates to the event bus, ask for the current status of items and browse the item registry.

The "say" command also supports to include item states in the sentence to say through TTS. If the item ''Weather_Temperature'' has the current value 15, you can use the command 

   openhab say The temperature outside is %Weather_Temperature% degrees celsius.

where ''%Weather_Temperature%'' is automatically replaced by ''15''.

===== XMPP (Jabber) Instant Messaging Console =====

openHAB supports remote console access through XMPP. For this, you require an XMPP account for your house - you can easily create on for example at [https://register.jabber.org/ Jabber.org]. You can chat with your house just like on the local console (the only difference is that you do not need the "openhab" prefix of the commands, e.g. simply type ''status Weather_Temperature'').

http://wiki.openhab.googlecode.com/hg/images/screenshots/xmpp.jpg

===== Google Calendar Console =====

The third console is using Google calendar entries - with this cool feature, you can schedule console commands by entering them in your calendar. See more details about [http://code.google.com/p/openhab/wiki/GCalBinding how to use it] here.

===== REST-API =====

The RESTful interface opens up openHAB to any other system that might want to tightly interact with openHAB. Not only gives it direct access to items, but also to sitemaps.This API can hence be used as a communication channel for user interfaces. Read all the [http://code.google.com/p/openhab/wiki/REST details about the REST-API].

== External links ==

* [http://www.openHAB.org/ openHAB website]

[[:Category:Home automation]]
[[:Category:Free software programmed in Java]]

== Request review at WP:AFC ==

Ist zwar englisch, kann aber vielleicht als Anhalt dienen, was ich damals reinpacken wollte.

Gruß,

Thomas E.-E.

[teichsta]

Hi Michael,

wie Du vielleicht weißt, werden am kommenden Wochenende (02. Februar) das 1.4 Release veröffentlichen.

Schön wäre natürlich zeitlich passend die Wikipedia-Seite zu announcen. Könnte das zeitlich passen?

Gruß,

Thomas E.-E.

[staehler]

Hi Thomas,

in Deinem englischen Artikel referenzierst Du auf Bilder, die ich in Wikipedia eingefügt habe. Nun soll noch eine Freigabe des Urhebers nachgereicht werden nach folgender Anleitung (https://de.wikipedia.org/wiki/Wikipe...en_und_Bildern). Kannst Du das liefern?
Es geht um die drei Bilder auf der Wiki Seite: https://de.wikipedia.org/wiki/OpenHAB
Leider werden sonst die Bilder wieder in 2 Wochen gelöscht.

Auf der openhab.org Seite wird noch Version 1.3 zum Download angeboten. Sobald V1.4 zum Download bereitsteht kann ich das bei Wikipedia anpassen.

Viele Grüße
Michael

[kkreuzer]

Ich nehem an, dass die Freigabe von Mihail noch nicht vorliegt für das openHAP Logo.

Liegt inzwischen vor - Du kannst das Logo also gerne einbinden! Brauchst du dabei auch noch einen formellen Nachweis?

Grüße,
Kai

[staehler]

Hallo Kai,

ja, leider besteht Wikipedia auf einen Nachweis des Urhebers. Beschrieben ist das unter https://de.wikipedia.org/wiki/Wikipe...en_und_Bildern

Wenn mir die Freigabe vorliegt, werde ich das Logo gerne in Wikipeadia einbinden.
Ebenso ist es mit den anderen Bildern, die ich dort eingebunden habe. Mir liegen deren Freigaben nicht vor, weshalb innerhalb von 2 Wochen diese Bilder von Wikipedia wieder gelöscht werden. Daher hoffe ich noch auf Freigaben von Thomas oder Dir.

Gruß Michael

[kkreuzer]

Hi Michael,

die eingebundenen Bilder stammen alle von mir und für das Logo hat mir Mihail die vollumfänglichen Nutzungsrechte eingeräumt. Die Freigabe durch mich sollte also möglich sein.

Als erster Schritt in der Beschreibung steht "Der anfragende Wikipedianer schreibt dem Autor/Fotograf/Rechteinhaber eine E-Mail." - könntest Du das machen? Wäre super, denn mir ist es nicht so ganz offensichtlich, was da in diesem Template wie genau ausgefüllt werden soll...

Vielen Dank!
Kai

[staehler]

Hi Michael,
könntest Du das machen? Wäre super, denn mir ist es nicht so ganz offensichtlich, was da in diesem Template wie genau ausgefüllt werden soll...

Hallo Kai,

hab Dir eine persönlichen Nachricht geschickt. Du und Mihail müssten eine entsprechende Urheberrechterklärung schicken. Anleitung siehe meine Email.

Viele Grüße
Michael

[Gagunger]

Wann kommt die 1.4er überhaupt?

Auf der openhab.org Seite wird noch Version 1.3 zum Download angeboten. Sobald V1.4 zum Download bereitsteht kann ich das bei Wikipedia anpassen.

Ich habe nun schon öfter von der 1.4er gelesen, aber auch nach dem 02.02. scheint es die nirgends zu geben. Wann kommt die nun oder übersehe da was? Auf Google-Code jedenfalls steht die nicht.

[teichsta]

der 2.2 hat sich auf den 9.2. verschoben. Ein paar Stunden Geduld noch :-)

Gruß, Thomas E.-E.

[kkreuzer]

Hallo zusammen,

es gibt jetzt auch eine (recht kurze) englische Version: https://en.wikipedia.org/wiki/OpenHAB

Da wir als openHAB-Team selbst nicht als Autoren für den Artikel gewünscht sind (seitens der Wikipedia-Foundation), möchte ich Euch bitten, hier mitzuhelfen! Wer Lust hat, Teile der deutschen Seite auf Englisch zu übersetzen, ist herzlich eingeladen - wir würden uns sehr freuen, wenn der Artikel schnell wachsen würde!

Viele Grüße,
Kai

[staehler]

Hallo Kai,

im engl. Artikel ist das openHAB Logo eingebunden. Ist das Logo jetzt wohl freigegeben? Du hattest mir damals noch davon abgeraten.

Viele Grüße
Michael