Le projet que je vais te présenter a pour but de mettre en place un système de détection de fumée connecté. Une notification doit être envoyée sur Slack, notre système de communication interne, en cas d'événement important (fumée, batterie faible, perte du wifi, etc.).

Choisissons notre détecteur

La première étape est de choisir un détecteur de fumée pour notre projet. Mon choix s’est tourné vers un détecteur de la marque “Netatmo” qui a la particularité d’avoir une API ouverte disponible ici.

Préparons Slack

Une fois le détecteur correctement configuré, il nous faut configurer Slack afin qu’un channel puisse recevoir les événements de notre détecteur. Je crée donc un nouveau channel (fr-smoke-detector) et configure un bot (nom et avatar) qui affichera nos évènements. Slack me génère une URL WebHook où l’on enverra nos futurs évènements.
Pour tester ma configuration, j’ai utilisé Postman qui me permet d’envoyer des requêtes HTTP vers mon WebHook.

Faisons parler Slack et l’API Netatmo ensemble à l’aide d’une application

Slack étant correctement configuré, la prochaine étape est de lire la documentation de l’API Netatmo afin de comprendre comment accéder aux évènements du détecteur.
Je décide donc d’écrire mon application en Python en utilisant le framework Flask. Elle devra remplir ces deux fonctions : s’authentifier auprès de l’API Netatmo et gérer les différents évènements que l'on recevra.
Une première fonction permet de s’authentifier :

@app.route('/netatmoOAuth', methods=['GET'])
def netatmoOAuth():

   # GET USER CODE
   code_user = request.args.get('code')

   # CALL NETATMO TO RETRIEVE TOKEN
   host_url = 'https://api.netatmo.com/oauth2/token'
   request_datas = {
       'grant_type' : 'authorization_code',
       'client_id' : CLIENT_ID,
       'client_secret' : CLIENT_SECRET,
       'code' : code_user,
       'redirect_uri' : APP_URL + '/netatmoOAuth',
       'scope' : SCOPE
   }

   # GET ACCESS TOKEN
   json_return = requests.post(host_url, data = request_datas)
   access_token = json_return.json()['access_token']

   # ADD WEB HOOK
   add_web_hook_url = 'https://api.netatmo.com/api/addwebhook?url=' + APP_URL + '/webhook'
   json_return = requests.get(add_web_hook_url, headers = {'Authorization' : 'Bearer ' + access_token})
   web_hook_status = json_return.json()['status']

   # VERIFY WEB HOOK
   if web_hook_status == "ok":
       return render_template('success.html')

   return render_template('error.html')

Une deuxième fonction permet de gérer les évènements :

@app.route('/webhook', methods=['GET', 'POST'])
def webhook():

   # VERIFY JSON
   json_file = request.json
   if json_file == None:
       return "JSON is null."

   # SHOW JSON IN LOG
   app.logger.info('request json : %s', request.json)

   # GET JSON
   json_event_type = json_file['event_type']
   event_type = json.dumps(json_event_type).strip('"')
   sub_type = json_file['sub_type']

   # HUSHED
   if event_type == "hush":
       slackMessage("Alarm hushed for 15 min !")
       return "Alarm hushed for 15 min !"

   # WIFI
   if event_type == "wifi_status":
       if sub_type == 0:
           slackMessage("Wifi Error !")
           return "Wifi Error !"
       if sub_type == 1:
           slackMessage("Wifi Ok !")
           return "Wifi Ok !"

   # …

Déployons notre application sur Heroku

Notre application étant fonctionnelle, il est temps de la mettre sur un serveur afin que l’API Netatmo puisse y accéder à n’importe quel moment. Je vais utiliser Heroku qui est une plateforme permettant de déployer des applications.
Avant de mettre mon application sur Heroku, je mets mon projet sur un dépôt distant. Je vais utiliser GitHub (dépôt disponible ici). Il ne me reste plus qu’à déployer mon application sur Heroku.
Après un ultime test d’incendie fictif, le Device Lab de Fribourg est maintenant équipé d’un détecteur de fumée connecté.

Et après ça?

Cette solution étant fonctionnelle, il reste cependant des fonctionnalités à ajouter pour améliorer ce projet comme :

• Recevoir l’état du détecteur chaque jour
• Recevoir un appel lorsque la fumée est détectée à l'aide de Twilio