Voici un plugin munin pour courber les températures remontés avec le thermostat Nest.
J’ai récemment changer de chaudière et j’ai eu la surprise d’avoir eu un Thermostat Nest avec.
Super thermostat domotique, par contre il manque à mon gout des graphiques avec les courbes de températures.
Heureusement Nest a eu la bonne idée de créer une API qui permet d’interroger le thermostat à distance.
Préparation Nest – API
Pour pouvoir utiliser l’API il y a plusieurs étapes à effectuer. ( Source )
Etape 1 – Créer un compte développeur et un produit
Rendez vous sur https://developer.nest.com, créer vous un compte puis un produit.
Donner lui un nom lambda ( le mien est « Nest plugin munin » ) et cochez les autorisations de lecture/écriture pour Thermostat et Away.
Quand le produit est crée, notez le Product ID ainsi que le Product Secret, nous en aurons besoin plus tard.
Ne fermez pas cette fenêtre.
Etape 2 – Obtenir votre PIN Code
Copier « Authorization URL » dans une nouvelle fenêtre de votre navigateur, il vous sera demandé d’accepter la demande.
Copier le PIN Code, nous en aurons besoin.
Etape 3 – Obtenir votre Access Code
Pour obtenir enfin votre Access Code, utilisez cette URL:
curl -X POST "https://api.home.nest.com/oauth2/access_token?client_id=YOUR_PRODUCT_ID&code=YOUR_PIN_CODE&client_secret=YOUR_PRODUCT_SECRET&grant_type=authorization_code"
Remplacer YOUR_PRODUCT_ID, YOUR_PIN_CODE et YOUR_PRODUCT_SECRET par les informations que vous avez obtenu avant.
Vous obtiendrez un une chaine de caractères assez longue commençant par c.. Ceci est votre Access Token et vous servira à interroger l’API De Nest.
Etape 4 – Obtenir votre device_id
Pour ça il faudra utiliser cette URL :
curl -L https://developer-api.nest.com/devices/thermostats\?auth\=YOUR_ACCESS_TOKEN
Les données qui nous intéressent votre devide_id et structure_id. Notez les.
Le plugin pour Munin
Les scripts sont disponibles sur mon dépôt Github : https://github.com/GeoHolz/nest_temp.
Ils sont à placer dans le répertoire plugins de munin ( /etc/munin/plugins )
A ce jour il y en a deux:
- nest_temp qui permet de faire un graphique avec la température demandé et la température de la pièce.
- nest_humidity qui permet de faire un graphique avec l’humidité de la pièce.
Dans chaque script il faut renseigner les DEVICEID et ACCESSTOKEN ( tout en haut des scripts )
#!/usr/bin/zsh
# plugin developed by GeoHolz
# https://blog.jolos.fr
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 2 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
###### CHANGE LOG #########
# 15/10/2016 : V0.1:Start
# 27/10/2016 : Away temperature target
# If run with the "autoconf"-parameter, give our opinion on wether we
# should be run on this system or not. This is optinal, and only used by
# munin-config. In the case of this plugin, we should most probably
# always be included.
if [ "$1" = "autoconf" ]; then
echo yes:
exit 0
fi
DEVICEID=
ACCESSTOKEN=
STRUCTUREID=
# If run with the "config"-parameter, give out information on how the
# graphs should look.
if [ "$1" = "config" ]; then
# The host name this plugin is for. (Can be overridden to have
# one machine answer for several)
# The title of the graph
echo 'graph_title Temperature of Nest Thermostat'
# Arguments to "rrdtool graph". In this case, tell it that the
# lower limit of the graph is '0', and that 1k=1000 (not 1024)
echo 'graph_args --base 1000'
# The Y-axis label
echo 'graph_vlabel Temperature'
# We want Cur/Min/Avg/Max unscaled (i.e. 0.42 load instead of
# 420 milliload)
echo 'graph_scale no'
# Graph category. Defaults to 'other'
echo 'graph_category Home'
# The fields. "label" is used in the legend. "label" is the only
# required subfield.
echo 'Target.label Target'
echo 'Ambient.label Ambient'
# Last, if run with the "config"-parameter, quit here (don't
# display any data)
exit 0
fi
HVAC_MODE=$(curl -s -L https://developer-api.nest.com/devices/thermostats/${DEVICEID}/hvac_mode\?auth\=${ACCESSTOKEN})
T_AMBIENT=$(curl -s -L https://developer-api.nest.com/devices/thermostats/${DEVICEID}/ambient_temperature_c\?auth\=${ACCESSTOKEN})
if [ $HVAC_MODE = "\"heat\"" ]
then
T_TARGET=$(curl -s -L https://developer-api.nest.com/devices/thermostats/${DEVICEID}/target_temperature_c\?auth\=${ACCESSTOKEN})
else
T_TARGET=$(curl -s -L https://developer-api.nest.com/devices/thermostats/${DEVICEID}/away_temperature_low_c\?auth\=${ACCESSTOKEN})
fi
echo -n "Ambient.value "
echo $T_AMBIENT
echo -n "Target.value "
echo $T_TARGET
