Get the measures from your NetAtmo thermostat and send it to your MQTT broker
I tried many other open source tools on github but I did not find a perfect fit for me.
The main reason is security : most of the tools I reviewed are still asking for client_id
, client_secret
(perfectly normal) but also for your username / password and that's not acceptable for me. It's also forbidden by NetAtmo guidelines.
The other reason is that the thermostat is synchronized only every hour so simply using getthermostatsdata was not enough for me (make a graph with a measure every hour is not very precise). So I finally used getmeasure in addition to provide all the missing detail with a measure every 10 minutes (like on the website).
So I build mine :(.
You simply need Python3 (never tested with Python2.7) and the only dependencies are requests
(to access the api) and paho-mqtt
(for MQTT broker interaction) so this line should be enough :
pip3 install paho-mqtt requests
First you'll have to create your app in the NetAtmo website and then you can use curl on a server you trust to get your refresh token :
curl -d 'grant_type=password&client_id=<CLIENT_ID>&client_secret=<CLIENT_SECRET>&username=<USERNAME>&password=<PASSWORD>&scope=read_thermostat' 'https://api.netatmo.net/oauth2/token'
Make sure to add a leading space to this command to avoid keeping this line in your shell history.
About the scope : for this program you only need to be allowed to read thermostat values, you can read the API documentation if you need anything else.
Easy, first try a dry-run command :
./netatmo2MQTT.py -c '<CLIENT_ID>' -a '<CLIENT_SECRET>' -r '<REFRESH_TOKEN>' -n -v
and then a real command to add to your crontab :
./netatmo2MQTT.py -c '<CLIENT_ID>' -a '<CLIENT_SECRET>' -r '<REFRESH_TOKEN>'
The secrets can also be set with environment variables, see the help for more detail.
seb@minus ~/src/netatmo2mqtt (git)-[master] # ./netatmo2MQTT.py --help
usage: netatmo2MQTT.py [-h] -a NACLIENTSECRET -c NACLIENTID -r NAREFRESHTOKEN
[-m HOST] [-n] [-o PREVIOUSFILENAME] [-s TOPIC]
[-t TOPIC] [-T TOPIC] [-v]
Read current temperature and setpoint from NetAtmo API and send them to a MQTT
broker.
optional arguments:
-h, --help show this help message and exit
-a NACLIENTSECRET, --client-secret NACLIENTSECRET
NetAtmo Client Secret / Can also be read from
NETATMO_CLIENT_SECRET env var. (default: None)
-c NACLIENTID, --client-id NACLIENTID
NetAtmo Client ID / Can also be read from
NETATMO_CLIENT_ID en var. (default: None)
-r NAREFRESHTOKEN, --refresh-token NAREFRESHTOKEN
NetAtmo Refresh Token / Can also be read from
NETATMO_REFRESH_TOKEN en var. (default: None)
-m HOST, --mqtt-host HOST
Specify the MQTT host to connect to. (default:
127.0.0.1)
-n, --dry-run No data will be sent to the MQTT broker. (default:
False)
-o PREVIOUSFILENAME, --last-time PREVIOUSFILENAME
The file where the last timestamp coming from NetAtmo
API will be saved (default: /tmp/netatmo_last)
-s TOPIC, --topic-setpoint TOPIC
The MQTT topic on which to publish the message with
the current setpoint temperature (if it was a success)
(default: sensor/setpoint)
-t TOPIC, --topic TOPIC
The MQTT topic on which to publish the message (if it
was a success). (default: sensor/mainroom)
-T TOPIC, --topic-error TOPIC
The MQTT topic on which to publish the message (if it
wasn't a success). (default: error/sensor/mainroom)
-v, --verbose Enable debug messages. (default: False)
I personaly use cron to start this program so as I want to keep the latest timestamp received from the API, I store it by default in /tmp/netatmo_last
(you can change it through a command line parameter.
I added a sample Dockerfile, I personaly use it with a docker-compose.yml
like this one :
version: '3'
services:
netatmo2mqtt:
build: https://github.com/seblucas/netatmo2mqtt.git
image: netatmo-python3-cron:latest
restart: always
environment:
NETATMO_CLIENT_SECRET: XXX
NETATMO_CLIENT_ID: XXX
NETATMO_REFRESH_TOKEN: XXX
CRON_STRINGS: "46 * * * * netatmo2MQTT.py -m mosquitto -t sensor/netatmo"
CRON_LOG_LEVEL: 8
- This program only handles Thermostat for now (PR welcome for other sensors)
- Won't work if you have more than one thermostat (again PR welcome)
This program is licenced with GNU GENERAL PUBLIC LICENSE version 3 by Free Software Foundation, Inc.