Domoticz – Monitorer votre Freebox V7 et Mini4K

Freebox OS possède une API qui permet de récupérer certaines infos afin de surveiller les températures et les espaces de stockage. Pratique, cela va permettre de tout centraliser avec le monitoring du NAS que nous avions vu dans un autre article ou comme le monitoring de son onduleur.
Supermat est l’auteur d’un script python que l’on va ajouter sur Domoticz. Pour cela, il faudra au minimum Python 3.4. Pour connaître votre version de Python vous pouvez faire la commande python -V. L’inconvénient de cette commande, c’est qu’elle va vous afficher la version par défaut si vous en avez plusieurs. Pour connaître la version de Python 3, tapez la commande python3 –version. Ensuite, il vous faudra au minimum Domoticz 3.81xx.

Domoticz et Freebox

Pour commencer, allez dans le dossier plug-ins de Domoticz. Personnellement, je passe en root pour faire mes commandes. Tapez ensuite la commande:  cd /home/sebr/domoticz/plugins/ (remplacer sebr par votre utilisateur). Une fois dans le dossier, lancez l’installation avec la commande : git clone https://github.com/supermat/PluginDomoticzFreebox.git .

Une fois l’installation faite, relancez Domoticz avec la commande service domoticz restart.

Activation et paramétrage

Allez maintenant sur Domoticz puis sur le menu Réglages et Matériels. Dans la liste, des plug-ins cherchez Freebox Python Plugin. Indiquez un nom à ce nouveau matériel, en dessous laissez le lien mafreebox.free.fr et le port 80 (le port local par défaut). Si vous ne l’avez pas changé, laissez-le par défaut. Ne remplissez pas le reste pour le moment, cliquez ensuite sur Ajouter.

Dans les logs de Domoticz, un message vous informe de la suite. Allez sur Réglages puis Logs pour voir ce message, mais attention vous avez que 30 secondes pour valider Oui sur l’écran de votre Freebox.

2020-03-11 21:19:53.960 (Freebox) C’est votre première connexion, le token n’est pas renseigné.
2020-03-11 21:19:53.960 (Freebox) Vous avez 30 secondes pour autoriser le plugin sur l’écran de la Freebox.
2020-03-11 21:19:53.960 (Freebox) Une fois autorisé sur la Freebox, le token s’affichera ici.

Une fois validé, toujours dans les logs de Domoticz, un nouveau message va s’afficher avec une clé.

2020-03-11 21:21:01.457 (Freebox) Veuillez copier ce token dans la configuration du plug-in Reglages > Matériel
2020-03-11 21:21:01.457 (Freebox) N/dVZhn4DDN66fDh1RcoPH8EJ7xjytTsNHjdvHbdQ+4FmyMl8E6jErowUtpWr

Avant d’ajouter la clé au matériel, assurez-vous que vous avez autorisé l’ajout de nouveaux dispositifs. Pour cela allez dans Réglages puis Paramètres, vérifiez que la case est cochée ou cliquez sur le bouton pour une autorisation de 5 min.

Retournez maintenant dans Réglages puis Matériels, sélectionnez le matériel que vous avez créé au début de l’article. Dans le champ Token copiez la clé, cliquez ensuite sur Modifier. Je vous recommande de relancer le plug-in. Pour cela, décochez la case Activer, cliquez de nouveau sur Modifier puis recochez la case Activer et de nouveau sur Modifier.

Pour contrôler que tout se passe bien, allez dans Réglages puis Logs. Vous devriez voir plusieurs lignes qui créent automatiquement les dispositifs.

Ajout des dispositifs

Nous allons ajouter les nouveaux dispositifs. Allez sur Réglages puis Dispositifs, tout en bas de votre liste vous devriez retrouver des modules de températures, des switchs … Cliquez sur la flèche verte pour ajouter ce dispositif, indiquez le nom que vous souhaitez et Valider.

Une fois que vous avez ajouté tous les dispositifs, votre Freebox est maintenant monitorée. On retrouve les 3 sondes de températures, un switch qui permet de rebooter la box, un switch pour activer / désactiver le Wi-Fi. Il y a aussi des dispositifs pour l’espace disque utilisé, il fonctionne aussi bien pour un disque dur intégré comme sur la V7… mais aussi si vous avez un disque dur externe, dans ce cas vous aurez plusieurs dispositifs.

Pour pourvoir contrôler l’activation du wifi il va falloir activer l’autorisation sur la freebox. Allez sur http://mafreebox.freebox.fr puis sur Paramètres de la Freebox, ensuite tout en bas sur Gestion des accès.

Dans cette nouvelle fenêtre allez sur l’onglet Applications, à la ligne Plug-in Freebox cliquez sur Editer, cochez ensuite Modification des réglages de la Freebox. Vous pourrez maintenant activer / désactiver le wifi sur Domoticz, de mon côté dans les logs de Domoticz lors de l’utilisation du switch j’ai des erreurs mais cela n’empêche pas le fonctionnement du bouton.

Vous pouvez aussi surveiller un équipement réseau afin de voir si celui-ci est allumé ou éteint. Allez dans Réglages puis Matériels, sélectionnez le matériel Freebox et dans le champ Liste mac adresse indiquez l’adresse mac de votre équipement, mais attention les lettres doivent être en minuscule.

Cliquez sur Modifier, allez ensuite sur Réglages puis Dispositifs vous devriez en avoir un nouveau portant le nom de votre équipement. Si ce n’est pas le cas, faites de nouveau l’étape pour désactiver et réactiver le plug-in.
Une fois ajouté le switch vous indique l’état de votre matériel, si vous souhaitez personnaliser l’icône il vous suffit de cliquer sur Modifier et choisissez l’icône qui convient le mieux.

Nous avons vu que cela fonctionne pour la Freebox V7 et Mini 4k. Je n’ai pas pu tester avec le Freebox Delta, fonctionnant aussi avec Freebox OS, il y a des chances que cela fonctionne. Si vous avez une Delta et Domoticz faites-nous part de votre test en commentaire.

  1. Merci pour le tuto clair.
    Pour info, la commande WIFI permet bien d’éteindre ou allumer le wifi, mais il faut l’autoriser via l’interface FreeboxOS, je sais plus où (plus de freebox suite à déménagement) mais tu vas trouver la liste des applications pour lesquelles tu as validé l’autorisation sur l’écran de la Freebox. Une fois sélectionné cette appli, il y a une liste de case à cocher, par défaut celle pour pouvoir autoriser cela n’est pas cocher, il suffit de la cocher.
    Attention, si votre box domoticz est en Wifi, vous pourrez éteindre, mais plus allumer puisse que plus connexion ;-).

    Supermat

    1. Salut, pour ton commentaire supermat.
      J’ai en effet trouvé ce que tu parler, mais si je clique pour activer le wifi j’ai une erreur dans les logs.
      Une reboot de la box est peut être nécessaire.
      2020-03-20 20:57:56.391 Error: (Freebox) ‘onCommand’ failed ‘KeyError’.
      2020-03-20 20:57:56.391 Error: (Freebox) —-> Line 282 in ‘/home/sebr/domoticz/plugins/PluginDomoticzFreebox/plugin.py’, function onCommand
      2020-03-20 20:57:56.391 Error: (Freebox) —-> Line 203 in ‘/home/sebr/domoticz/plugins/PluginDomoticzFreebox/plugin.py’, function onCommand
      2020-03-20 20:57:56.391 Error: (Freebox) —-> Line 222 in ‘/home/sebr/domoticz/plugins/PluginDomoticzFreebox/freebox.py’, function setOnOFFWifi

    2. En fait il y a une erreur mais cela fonctionne quand même, même la désactivation fonctionne malgré une erreur aussi dans les logs.
      Je vais mettre à jour l’article.

  2. Bonsoir,
    pi@raspberrypi:~ $ python -V
    Python 3.7.3

    Domoticz Version 4.10717

    (Freebox) Initialized version 1.1.2, author ‘supermat’
    (Freebox) C’est votre première connexion, le token n’est pas renseigné.
    (Freebox) Vous avez 30 secondes pour autoriser le plugin sur l’écran de la Freebox.
    (Freebox) Une fois autorisé sur la Freebox, le token s’affichera ici.
    (Freebox) ——————————————————————————
    (Freebox) Veuillez copier ce token dans la configuration du plugin Reglages > Matériel
    (Freebox) Erreur Reponse Freebox : Erreur interne
    (Freebox) ——————————————————————————
    (Freebox) Pas de token défini.
    Malgrès plusieurs essais et mise à jour, toujours le même message.
    Cordialement

    1. En effet tu as une erreur interne la freebox te renvoi pas le token. Tu as qu’elle freebox ? Tu as bien fait Oui sur l’écran ? Dans les applications freebox tu vois plugin freebox domoticz ?

  3. Salut Sebr,

    Merci pour le tuto.

    J’ai voulu essayer sur Freebox Delta.
    Je suis bien en python 3 :
    python –version
    Python 3.7.3

    j’ai des erreur lors de l’activation et je ne vois pas les dispositifs :
    2020-03-23 09:33:18.637 Status: (Freebox Delta) Started.
    2020-03-23 09:33:19.021 Status: (Freebox Delta) Entering work loop.
    2020-03-23 09:33:19.021 Status: (Freebox Delta) Initialized version 1.1.2, author ‘supermat’
    2020-03-23 09:33:24.028 (Freebox Delta) Token déjà présent. OK.
    2020-03-23 09:33:24.140 Error: (Freebox Delta) ‘onStart’ failed ‘ZeroDivisionError’.
    2020-03-23 09:33:24.140 Error: (Freebox Delta) —-> Line 266 in ‘/home/pi/domoticz/plugins/PluginDomoticzFreebox/plugin.py’
    2020-03-23 09:33:24.140 Error: (Freebox Delta) —-> Line 128 in ‘/home/pi/domoticz/plugins/PluginDomoticzFreebox/plugin.py’
    2020-03-23 09:33:24.140 Error: (Freebox Delta) —-> Line 122 in ‘/home/pi/domoticz/plugins/PluginDomoticzFreebox/freebox.py’
    2020-03-23 09:34:03.734 Error: (Freebox Delta) ‘onHeartbeat’ failed ‘ZeroDivisionError’.
    2020-03-23 09:34:03.734 Error: (Freebox Delta) —-> Line 294 in ‘/home/pi/domoticz/plugins/PluginDomoticzFreebox/plugin.py’
    2020-03-23 09:34:03.734 Error: (Freebox Delta) —-> Line 232 in ‘/home/pi/domoticz/plugins/PluginDomoticzFreebox/plugin.py’
    2020-03-23 09:34:03.734 Error: (Freebox Delta) —-> Line 122 in ‘/home/pi/domoticz/plugins/PluginDomoticzFreebox/freebox.py’

    une idée ?

    merci

    Pascal

    1. Salut,
      Merci pour ton test apparemment tu as réussi à aller jusqu’au token comme il indique Token déjà présent.
      Cela ne doit pas fonctionner avec la delta du coup les variables ne doivent pas être les mêmes.

  4. Mise à jour domoticz V2020.1

    Pas d’affichage « oui » pour validation sur la box free revolution.
    Dans Domoticz selection de: Freebox Python Plugin – OK
    message : Hardware created, devices can be found in the devices tab!

    2020-03-23 17:46:12.068 Status: (free) Stop directive received.
    2020-03-23 17:46:12.068 Status: (free) Exiting work loop.
    2020-03-23 17:46:12.169 Status: (free) Stopping threads.
    2020-03-23 17:46:12.169 Status: (free) Stopped.
    2020-03-23 17:46:21.370 Status: (free) Started.
    2020-03-23 17:46:21.788 Status: (free) Entering work loop.
    2020-03-23 17:46:21.788 Status: (free) Initialized version 1.1.2, author ‘supermat’
    2020-03-23 17:46:26.796 (free) C’est votre première connexion, le token n’est pas renseigné.
    2020-03-23 17:46:26.796 (free) Vous avez 30 secondes pour autoriser le plugin sur l’écran de la Freebox.
    2020-03-23 17:46:26.796 (free) Une fois autorisé sur la Freebox, le token s’affichera ici.
    2020-03-23 17:46:26.866 (free) ——————————————————————————
    2020-03-23 17:46:26.866 (free) Veuillez copier ce token dans la configuration du plugin Reglages > Matériel
    2020-03-23 17:46:26.866 (free) Erreur Reponse Freebox : Erreur interne
    2020-03-23 17:46:26.866 (free) ——————————————————————————
    2020-03-23 17:47:06.388 (free) Pas de token défini.

    2020-03-23 18:44:08.832 (Freebox) Pas de token défini.
    2020-03-23 18:44:18.868 Status: (Freebox) Started.
    2020-03-23 18:44:19.260 Status: (Freebox) Entering work loop.
    2020-03-23 18:44:19.260 Status: (Freebox) Initialized version 1.1.2, author ‘supermat’
    2020-03-23 18:44:24.268 (Freebox) C’est votre première connexion, le token n’est pas renseigné.
    2020-03-23 18:44:24.268 (Freebox) Vous avez 30 secondes pour autoriser le plugin sur l’écran de la Freebox.
    2020-03-23 18:44:24.268 (Freebox) Une fois autorisé sur la Freebox, le token s’affichera ici.
    2020-03-23 18:44:24.341 (Freebox) ——————————————————————————
    2020-03-23 18:44:24.341 (Freebox) Veuillez copier ce token dans la configuration du plugin Reglages > Matériel
    2020-03-23 18:44:24.341 (Freebox) Erreur Reponse Freebox : Erreur interne
    2020-03-23 18:44:24.341 (Freebox) ——————————————————————————
    2020-03-23 18:45:03.867 (Freebox) Pas de token défini.

    1. Salut,
      Quand tu indique d’affichage « Oui » sur l’écran il ne te propose pas de valider ? Tu n’as pas changé le port local de la freebox à tout hasard ?
      Ah tu essayé de redémarrer ta box ?

  5. Bonjour, je n’ai rien sur la freebox pour autoriser et donc obtenir le token…

    2021-04-21 14:37:57.913 F4F: (F4F) C’est votre première connexion, le token n’est pas renseigné.
    2021-04-21 14:37:57.913 F4F: (F4F) Vous avez 30 secondes pour autoriser le plugin sur l’écran de la Freebox.
    2021-04-21 14:37:57.913 F4F: (F4F) Une fois autorisé sur la Freebox, le token s’affichera ici.
    2021-04-21 14:37:57.926 F4F: (F4F) OnStart error: HTTP Error 404: Not Found
    2021-04-21 14:38:02.014 F4F: (F4F) Pushing ‘onHeartbeatCallback’ on to queue
    2021-04-21 14:38:02.064 (F4F) Processing ‘onHeartbeatCallback’ message
    2021-04-21 14:38:02.064 F4F: (F4F) Calling message handler ‘onHeartbeat’.
    2021-04-21 14:38:02.064 F4F: (F4F) onHeartbeat called
    2021-04-21 14:38:02.064 F4F: (F4F) Pas de token défini.
    2021-04-21 14:38:12.041 F4F: (F4F) Pushing ‘onHeartbeatCallback’ on to queue
    2021-04-21 14:38:12.091 (F4F) Processing ‘onHeartbeatCallback’ message
    2021-04-21 14:38:12.091 F4F: (F4F) Calling message handler ‘onHeartbeat’.
    2021-04-21 14:38:12.091 F4F: (F4F) onHeartbeat called
    2021-04-21 14:38:22.033 F4F: (F4F) Pushing ‘onHeartbeatCallback’ on to queue
    2021-04-21 14:38:22.083 (F4F) Processing ‘onHeartbeatCallback’ message
    2021-04-21 14:38:22.083 F4F: (F4F) Calling message handler ‘onHeartbeat’.
    2021-04-21 14:38:22.083 F4F: (F4F) onHeartbeat called
    2021-04-21 14:38:32.016 F4F: (F4F) Pushing ‘onHeartbeatCallback’ on to queue
    2021-04-21 14:38:32.066 (F4F) Processing ‘onHeartbeatCallback’ message
    2021-04-21 14:38:32.066 F4F: (F4F) Calling message handler ‘onHeartbeat’.
    2021-04-21 14:38:32.066 F4F: (F4F) onHeartbeat called

    Merci pour votre aide

Votre adresse e-mail ne sera pas publiée. Les champs obligatoires sont indiqués avec *

Ce site utilise Akismet pour réduire les indésirables. En savoir plus sur comment les données de vos commentaires sont utilisées.