Et voilà je viens de publier mon premier plugin python pour Domoticz.

Plugin Python Domoticz pour accéder au services de l’API V4 de la Freebox

Fonctionnalités

  • Création du token d’authentification lors du premier lancement (une validation est nécessaire sur l’écran de la Freebox serveur)
  • Création d’un dispositif par partition de disque dur connecté à la Freebox (disques internes et externes)
  • Création de 3 dispositifs pour suivre les températures de la Freebox
  • Création d’un dispositif switch par adresse mac pour laquelle vérifier la présence ou non à proximité de la Freebox.
  • V1.1.1 : Création d’un dispositif switch de suivi et modification de l’état du wifi (Actif/Inactif)
  • V1.1.1 : Création d’un dispositif switch de reboot de la Freebox serveur
  • v1.1.2 : Compatibilité avec la Mini4K (en conservant l’usage des Disques durs)
  • v1.3 : Création d’un dispositif switch d’état de la connexion Internet (WAN)
  • v1.1.3 : Création de deux dispositifs pour les débits montants et descendants en Ko/s

Installation

Requis : Python version 3.4 or supérieur & Domoticz version 3.81xx ou supérieur.

    • En ligne de commande aller dans le répertoire plugin de Domoticz (domoticz/plugins)
    • Lancer la commande: git clone https://github.com/supermat/PluginDomoticzFreebox.git
    • Redémarrer le service Domoticz en lançant la commande sudo /etc/init.d/domoticz.sh restart

Updating

Pour mettre à jour le plugin :

  • En ligne de commande aller dans le répertoire plugin de Domoticz (domoticz/plugins/PluginDomoticzFreebox)
  • Lancer la commande: git pull
  • Redémarrer le service Domoticz en lançant la commande sudo /etc/init.d/domoticz.sh restart

Configuration

Field Information
Address L’adresse d’accès à la box avec le http(s) devant (http://mafreebox.free.fr sur réseau local, visiblement, depuis la dernière mise à jour de Free Aout 2020, cette adresse ne fonctionne plus, il faudrait utiliser http://mafreebox.freebox.fr Merci Kyrille et alranapa)
Port Le port pour accéder à la Freebox (80 sur réseau local)
Token Le Token de connexion à la Freebox qui vous sera donné lors de la première connexion du plugin (voir les log)
Liste mac adresse pour présence (séparé par ; ) Une liste d’adresse mac à vérifier sur les équipements enregistrés sur la Freebox comme étant présent à proximité de la box (reachable et active). Présent au domicile
Debug Si true plus de log apparaîtront dans la console de log

Dans la partie Matériel de Domoticz, chercher ‘Freebox Python Plugin’. Laissez les valeur par défaut sur un réseau local, ou configurez votre adresse et port. Ajoutez le Matériel et rendez vous dans les log. Lors de la première utilisation, laissez le token vide.

Au démarrage, si le token n’est pas défini, le plugin en demander un à la Freebox, il vous faut alors vous déplacer jusqu’à l’écran de la Freebox pour répondre oui, puis revenir sur votre Domoticz pour copier coller le token qui s’affiche dans la fenêtre de log, dans la partie Token de configuration du plugin.

Désactivez le plugin, autoriser l’ajout de nouveau dispositif pendant 5 minutes, puis réactivez le plugin pour le faire redémarrer. Les dispositifs vont se créer. A chaque démarrage du plugin, les dispositifs nouveaux ou maquant seront ajoutés. Vous pouvez supprimer ceux qui ne vous intéresse pas et inclure ceux qui vous intéresse.

Dispositifs Description
Système Températures de la Freebox et du switch interne
Disque Pourcentage d’espace utilisé de chaque partition connectées à la Freebox au moment du démarrage du Plugin avec autorisation d’ajout de dispositifs
Présence Pour chaque adresse mac renseignée, si elle est trouvée enregistrée sur la Freebox, un dispositif switch est créé, indiquant la présence (on) ou l’absence (off) du matériel à proximité de la box. Cela permet de tester la présence d’une personne au domicile en vérifiant la présence de sont smartphone par exemple. Cela fonctionne, même avec les Iphones
On/Off Wifi Switch permettant de voir l’état du wifi (actif/inactif) et de le modifier
Reboot Switch permettant de rebooter la Freebox

ATTENTION : Pour faire fonctionner le On/Off Wifi et le

reboot, il faut autoriser le plugin a faire ces deux actions sur la Freebox. Lors de la génération du token, le plugin a été autorisé à récupérer les infos, mais pas à les modifier. Il faut pour cela aller dans l’interface Freebox OS via le menu Paramètres de la Freebox > Gestion des accès > onglet Applications, sélectionner le plugin Domoticz et cocher Modifications des réglages de la Freebox ».

Note : Un fichier devicemapping.json est créé pour garder l’association des infos de la Freebox avec le bon device créé au moment du démarrage du Plugin.

Un fichier ReadMe est disponible ici :

https://github.com/supermat/PluginDomoticzFreebox