This project is a fork of Rubustat (info below)

##Modifications

• Added work-in-progress api with Home Assistant component: https://github.com/groupwhere/homeassistant-thermopi

• Added on screen keyboard with code modified from http://stackoverflow.com/questions/24622719/tkinter-keyboard-on-screen. Modified to use place instead of grid and incorporated into the main gui code. Created numpad version of this code. These new functions allow you to create a new setting using a touch screen. Work in progress 20 May 2016.

• GUI should be working to configure the schedule via the schedule class. You should now be able to disable the schedule for as long as you want it to be. You can also now override the schedule with another setting. Work in progress 07 May 2016.

• Added support for heat pumps. This requires 4 devices to control cool, fan, reversing valve, and emergency heat

• Switched weather from Yahoo to Wunderground. You will need to apply for your own key, and there is a free key available at the time of writing. Code is designed not to exceed the limitations of that free key. But, this is a hazard with developmental code.

• Added GUI using tkinter, sized for a 4" LCD panel

• Uses sqlite for status and weather. Backend writes the data and the GUI or web interface simply read from that database.

• Added support for Adafruit DHT11 sensor for temperature and humidity. Original code uses an DS18B20 sensor, which should still be possible.

• Added configuration for active high or low GPIO output. I use a JBtek 4 Channel DC 5V Relay Module which has active low inputs. The relays are SPDT, but the goal was to ensure no power draw was required to keep them off, e.g. if the program or the Pi itself were to fail.

Relay board:

##Basic setup

1. Copy the config.txt.template to config.txt

2. Edit the above for your GPIO pins, ac type, etc.

3. To have the web interface and daemon automatically start on boot:

   sudo nano /etc/rc.local to include the following:

    modprobe w1-gpio
    modprobe w1-therm
    /bin/rm -rf /root/thermopi/rubustatDaemon.pid
    python /root/thermopi/rubustat_web_interface.py &
   

4. (Optional) After you get your LCD display working, you will probably want to dedicate its use to the thermostat GUI.

   sudo nano /etc/xdg/lxsession/LXDE-pi/autostart and modify to include only these lines:

    @openbox
    @sudo python /root/thermopi/thermogui.py
   

5. If using the DHT11 sensor, checkout/clone https://github.com/adafruit/Adafruit_Python_DHT.git

The daemon can be started with python rubustat_daemon.py start.

First run of, e.g., python thermogui.py will also start the daemon.

After the first run, two sqlite databases will be created:

status.db (temperature readings, weather, unit status)
temperatureLogs.db (history)

A thermostat controller for Raspberry Pi on Flask

Mostly based off: http://makeatronics.blogspot.com/2013/04/thermostat-software.html

but now with user-friendly web interface!

NOTE I am not a designer, and this UI was primarily for my dad / his phone. Small screens + aging eyes means BIG NUMBERS!

##Contact

I would LOVE if you threw me an email if you decide to use any of this code for your own RPi-based thermostat. It doesn't have to be long or involved, but knowing my work is used outside of my house would be great!

If you want to donate, you can send me BTC at 1Dz6YehDXZk2GBCYi9SfWRSPZAEndmQxk5, or donate to other, bigger open source projects that will actually use the funding to further development. On the topic of RPi, why not Raspbian?

##Forks!

@aneisch has forked this project, and is adding cool stuff like scheduling! You can find his fork either from the fork menu, or just click here. Thanks for doing cool stuff @aneisch!

While not strictly a fork, @madbrenner has created PyStat which features a much nicer UI. As an added bonus, the code appears to be WAY LESS of a hacky mess compared to mine. You should really check it out. It's probably what you should use instead.

##Pictures!

There's a picture of my hardware, and screenshots of the UI on desktop and mobile browsers over on my blog.

##Hardware

• Raspberry Pi (A, B, or B+ should work)
• Some way to hook up the GPIO pins to the thermostat hookups in your wall (I used this nice pre-made board explicitly for this purpose!)
• If using the board above, you should also get everything off the parts list(Google Docs, which now requires an account?)
• A temperature sensor. This was written with the DS18B20, but it should be pretty easy to code up your own function for your specific sensor your have on hand
• Some way to hook your RPi up to your network. This project is infinitely more helpful when you can access the web interface.

##Dependencies

• RPi.GPIO (you probably already have it installed on your Pi)
• Flask (sudo apt-get install python-flask on Ubuntu, Debian, Raspbian, and likely other apt based distros)
• kernel modules w1-gpio and w1-therm (unsure if these are default in Raspbian, but make sure you have them)

###Optional (required if enabled in config.txt)

• sqlite for less-sloppy logging (sudo apt-get install python-sqlite sqlite3)
• pywapi for weather info (sudo pip install pywapi)

##Installation

1. git clone https://github.com/wywin/Rubustat.git
2. copy config.txt.template to config.txt and edit with appropriate values
3. copy mailconf.txt.template to mailconf.txt and fill in values (if using error mails)
4. (optional) add web interface to startup. I added the lines

modprobe w1-gpio

modprobe w1-therm

/usr/bin/python /home/pi/src/Rubustat/rubustat_web_interface.py &

to /etc/rc.local, and it works without a hitch. Although the modprobes are also in getIndoorTemp, I added them before the web interface call because it was throwing fits without the pre-call modprobes... ¯\(ツ)/¯

###Code Map

#####The configs

• config.txt.template - the main config file, heavily commented to help you make sense of it. Enable optional features here!
• mailconf.txt.template - a template for the mail configuration. Fill in the values, enable mail in config.txt, and get helpful error email alerts! These are used to hopefully inform you of potential hardware issues. This is from when one of my alligator clips fell off, and it was really hot when I got home.
• status - target temperature (in degrees F, because I'm an awful American) and mode (cool or heat) - this can be edited by hand, or via the web UI

#####The code

• daemon.py - the underlying daemon class from here. I added on some stale-pid checking.
• rubustat_daemon.py - the proper daemon. Reads from status, controls the GPIO pins, and does email notifications, if enabled, and sqlite logging, if enabled
• rubustat_web_interface.py - the web interface. Auto launches rubustat_daemon.py, and writes to status. Optionally displays local weather conditions, dictated by the ZIP code in config.txt. You will have to adjust getWeather to strip off the annoying link from the bottom of the API result.
• static/ and templates/ - various html, css, and js to make the web interface fancy. NOT AT ALL standards compliant, but it works, so I'm happy with it.

####Credits In no particular order:

http://matthewjamestaylor.com/blog/equal-height-columns-2-column.htm

https://github.com/ftlabs/fastclick

http://proto.io/freebies/onoff/

http://blog.jacobean.net/?p=678

http://www.jejik.com/articles/2007/02/a_simple_unix_linux_daemon_in_python/

http://segfault.in/2010/12/sending-gmail-from-python/

http://tmpvar.com/markdown.html