Skip to content
This repository was archived by the owner on May 17, 2021. It is now read-only.

SiteWhere Persistence

Derek Adams edited this page Nov 21, 2015 · 7 revisions

Overview

The SiteWhere persistence provider allows openHAB data to be forwarded to a SiteWhere server instance running locally or in the cloud. Selected events from an openHAB instance can be stored in SiteWhere under a virtual device with hardware id specified in the persistence provider implementation. Events are delivered via the SiteWhere agent which uses the MQTT protocol. The SiteWhere administrative application may be used to view data for the virtual device. It can also be used to issue commands to items in openHAB based on the SiteWhere command framework. See this tutorial for a step-by-step walkthrough.

Configuring SiteWhere

Both SiteWhere and openHAB by default run on port 8080, so the port will need to be changed if both are running on the same machine. To change the port for SiteWhere, open the conf/server.xml file and look for the following:

... ...

Change the port to another value such as 9090.

No configuration is necessary for SiteWhere to listen for events on the MQTT transport if using the default tenant configuration. The SiteWhere agent used by the persistence plugin is configured to send MQTT messages on the topic SiteWhere listens on.

Configuring openHAB

The default values configured in the openHAB SiteWhere persistence plugin will work with no changes if using the default SiteWhere tenant configuration. The following configuration values may be specified to change the default behavior:

  • defaultHardwareId - provides an association between the openHAB instance and a SiteWhere device. Once connected, if no device exists in SiteWhere with the given hardware id, a new openHAB virtual device will be registered under that id. All data sent from the openHAB instance will be recorded under the virtual device. If more than one openHAB instance is connecting to SiteWhere, different hardware ids should be used for each instance. SiteWhere can scale to support thousands or even millions of openHAB instances running concurrently.

Installation


User Interfaces


Community

(link to openHAB forum)

Development



Misc


Samples

A good source of inspiration and tips from users gathered over the years. Be aware that things may have changed since they were written and some examples might not work correctly.

Please update the wiki if you do come across any out of date information.

Use case examples

Collections of Rules on a single page

Single Rules

Scripts


Release Notes

Clone this wiki locally