ZipaNetatmoGW

A Python module for synchronizing a Zipabox Home Automation Controller to a Netatmo Weather Station

Dependencies

This module requires lnetatmo.py from https://github.com/philippelt/netatmo-api-python

Installation

Zipabox

1. Add one Virtual Meter device and one Virtual Sensor device to the Zipabox
2. Name the devices and set their types properly
   -- for the Sensor, set type to CO sensor
   -- for Meter values set units to Temperature (ºC), Humidity (%), CO2 Level (ppm), Pressure (mb), Sound level (dB)
3. Check and note the URL for the Sensor's STATE attribute
4. Check and note the URL for the Meter's VALUE attributes

Gateway device (python host)

1. Put the gw.py and lnetatmo.py in a folder - preferably somewhere in user's home folder tree
2. Make gw.py executable
   $ chmod +x gw.py
3. Edit gw.py to set user specific information with help of URL's above
4. Edit lnetatmo.py to set your Netatmo Developer OAUTH credentials and User my.netatmo.com credentials
5. Run the module
   $ <module location>/gw.py
6. If you do not see a message with a smiling face, check these instructions again
7. If still no joy, create an issue at https://github.com/innodron/ZipaNetatmoGW/issues

Running periodically

To run the module periodically, make it executable and add it to cron in your favorite *nix environment

e.g. To run this module in 15 min. intervals with a RaspberryPI:

1. Open cron editor
   $ crontab -e
2. Add the following line (assuming your RaspberryPI user is pi, and script is at ~/scripts/ZipaNetatmoGW)
   */15 * * * * /home/pi/scripts/ZipaNetatmoGW/gw.py 2>&1 | logger -t [ZipatoNetatmoGW]
3. Save and exit cron editor