A nest heating system for Debian and Raspberry Pi
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
app
assets
bin
blog
daemons
debian
deployment
sql
.gitignore
LICENSE
README.rst
bower.json
gulpfile.js
package.json

README.rst

Ninho - a home heating system for Raspbian

This is Ninho - a free software home heating system for your nest.

The software runs on the Raspbian operating system for the Raspberry Pi, and the hardware requirements are either a plain Raspberry Pi (any model, as of January 2015), or - for a much simpler deployment - a Raspberry Pi B+ with the PiFace Digital 2 shield.

The core software consists of a Python daemon which controls the GPIO pins to switch on/off a heating system connected to the Pi, and a Flask web app as a user interface. The Flask app talks to the hardware-interfacing daemon via Pyro4.

Deployment

Ninho is designed to be deployed through apt-get as a Debian package.

The Debian packaging is not done yet - so at the moment it requires some manual configuration (on Raspbian Jessie):

$ apt-get install python2-pyro4 pyro4 gunicorn supervisor nginx-common nginx-extras
$ git clone git@github.com:getninho/ninho.git && cd ninho
$ cp deployment/gunicorn/ninho /etc/gunicorn.d/
$ cp deployment/supervisor/ninho.conf /etc/supervisor/conf.d/
$ cp deployment/supervisor/pyro4-ns.conf /etc/supervisor/conf.d/
$ service supervisor restart
$ service gunicorn restart
[... configuration of the virtualhost for nginx - to be written ...]
$ service nginx restart

The app should now be ready at http://ninho.local/ - or whatever is the URI configured in nginx.

Acknowledgements

Michael Saunby (Raspberry Pi and TI CC2541 SensorTag): http://mike.saunby.net/2013/04/raspberry-pi-and-ti-cc2541-sensortag.html

Author

Andrea Rota <a@xelera.eu>

License

GNU AGPLv3 or later.