Home.Pi

Simple Home Automation solution with MQTT

Facts

Home Automation with MQTT
Cloud-based Micro Service Architecture (only the bindings to control the devices are running locally)
Completely independent from the used technology (btw. most bindings are actually written in node.js)

Screenshot

System Architecture

Installation

Install and start a MQTT Broker with Websocket Support, e.g.
- HiveMQ
- Mosquitto with [https://github.com/stylpen/WSS]
- Mosca
Clone the repository and install the dependencies with NPM

    git clone https://github.com/denschu/homepi
    cd homepi
    sudo npm install -g cordova ionic gulp
    npm install
    gulp install

Publish your configuration to MQTT with the topic "username/home/config" (see publish-config.sh)

Example configuration:

{
    "id" : "ceiling_light",
    "type" : "on_off",
    "value" : false,
    "name" : "Ceiling Light",
    "topic" : "denschu/home/devices/livingroom/ceiling_light/value"
}

Run with local HTTP Server

cd www
python -m SimpleHTTPServer 8080
mosca --http-port 8000 --http-bundle --verbose | bunyan

Open http://localhost:8080 in a webbrowser and provide your credentials to connect to the MQTT Broker.

Run it as native app

sudo npm install -g cordova ionic
ionic platform add ios
ionic build ios
ionic emulate ios

Run the complete stack with Docker

docker run -p 1883:1883 -p 8000:8000 -v /var/db/mosca:/db denschu/mosca-secure
docker run -d -p 80:80 denschu/homepi

MQTT topic conventions

When you create the above device configuration for the GUI then you always define the topics it will subscribe to.

<username>/home/devices/<room>/<device-name>/value
denschu/home/devices/living_room/light1/value

The GUI application will always add a "/set" to the topicname from above when it publishes a message. The payload of the message contains the value to set on the device.

<username>/home/devices/<room>/<device-name>/value/set <value>
denschu/home/devices/living_room/light1/value/set true

Available MQTT Bindings (separate git-Repositories)

Take a look at my puppet manifests to setup the Raspberry Pi very easily with puppet. You also get some help for the manual setup.

At the moment the following "experimental" MQTT bindings are available:

mqtt-exec Execute shell commands like "sudo shutdown -h now"
mqtt-zway Connect to the Z-Wave RaZBerry Server Z-Way
mqtt-google-calendar Use Google Calendar as a scheduling engine
mqtt-rules Create rules and execute them on incoming MQTT messages
mqtt-temperature Log temperature to MQTT
mqtt-lirc Control infrared devices

Technologies/Frameworks

MQTT
Ionic Framework (with AngularJS)
node.js

For further informations please refer to my blog posts:

denschu / home.pi

readme