Creating a Hobson Hub Plugin

Any developer with knowledge of Java can create Hobson Hub plugins to add new features and device support.

Maven Archetype

The easiest way to start creating a Hobson plugin is to use the Maven archetype. Running the following command will give you a skeleton project directory that will compile and create a plugin bundle that can successfully be installed on a Hobson Hub.

mvn archetype:generate -DarchetypeGroupId=com.whizzosoftware.hobson -DarchetypeArtifactId=hobson-hub-plugin-archetype -DarchetypeRepository=http://dl.bintray.com/whizzosoftware/maven -DarchetypeVersion=<archetype_version> 

In order to determine what to use for <archetype_version>, go to the Hobson install directory and find the "bundle" folder. One of the files in that folder will be a "hobson-hub-core-x.y.z.jar". The corresponding archetype version will be x.y.0. For example, if the file is hobson-hub-core-0.8.1.jar, then the archetype version will be 0.8.0.


Plugin Naming Convention

The recommended naming convention for plugins is the form:

hobson-hub-<manufacturer>-<product>

for example:

hobson-hub-philips-hue or hobson-hub-lutron-radiora

SDK Documentation