Feature Overview - vpjuslin/openhab GitHub Wiki
openHAB has many features and we will try here to give you an overview of them. Please also check the issue tracker.
The main interface to communicate with openHAB is surely the web-based UI. It comes with the default runtime package and is pre-configured with a demo house. This UI is available at the url http://localhost:8080/openhab.app?sitemap=demo
There is a native iOS User Interface available on the !AppStore. Go and check it out!
There is a native Android User Interface. Go and check it out!
There is a SenchaTouch-based UI, which can be used with smartphones and tablets likewise. This UI is distributed as a separate package and needs to be unzipped to {$openhab.home}/webapps. Afterwards it is accessible at the url
http://localhost:8080/greent/
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
.
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 Jabber.org.
Configure the XMPP-section of your openhab.cfg file accordingly and define, which XMPP users are allowed to use the console.
Next time you start your openHAB runtime, you will see that your house automatically comes online - you can now chat with it 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
).
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 how to use it here.
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 details about the REST-API.
The openHAB Designer, which is the configuration tool for the openHAB Runtime, is an Eclipse RCP application with Xtext-based editors to offer a highly user-friendly way of editing configuration files, UI definitions and automation rules. For the automation rules, there are two implementations available. A self designed powerful Xbase/Xtext-based engine or the JBoss Drools engine.
openHAB comes with a highly integrated rule engine to allow users to write automation rules. Read about the details on this wiki page.
Optionally, you can also use JBoss Drools, see the details here.
Rules can make use of user-defined Scripts, but those scripts can also be called directly from consoles. They make it very easy to define macros.
openHAB defines a useful set of actions that can be used from within rules and scripts. They can be used to send e-mails and do other kinds of notifications as well as other common things.
There more features which aren't hardware/protocol bindings but also available as separate bundles.
- Dropbox Support
- Google Calendar Support
- Text to speech implementation