Skip to content
No description, website, or topics provided.
Branch: master
Clone or download
Latest commit 95bd807 Oct 31, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.gitignore Initial commit Mar 25, 2018
README.md
freebox.py 1.1.2 : Prise en compte de la Freebox Mini 4K Oct 31, 2018
plugin.py 1.1.2 : Prise en compte de la Freebox Mini 4K Oct 31, 2018

README.md

Domoticz Freebox Plugin

Plugin Python Domoticz pour accéder au services de l'API V4 de la Freebox https://matdomotique.wordpress.com/2018/03/25/plugin-freebox-pour-domoticz/

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.
  • Création d'un dispositif switch de suivi et modification de l'état du wifi (Actif/Inactif)
  • Création d'un dispositif switch de reboot de la Freebox serveur

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
  • Redemmarrer le service Domoticz en lancant la commande sudo service domoticz.sh restart

Updating

Pour mettre à jour le plugin :

  • En ligne de commande aller dans le répertoire plugin de Domoticz (domoticz/plugins)
  • Lancer la commande: git pull
  • Redemmarrer le service Domoticz en lancant la commande sudo service 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)
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 apparaitront dans la console de log

Dans la partie Matériel de Domoticz, chercher 'Freebox Python Plugin'. Laissez les valeur par defaut 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 fenetre de log, dans la partie Token de configuration du plugin.

Desactivez le plugin, autoriser l'ajout de nouveau dispositif pendant 5 minutes, puis réacivez le plugin pour le faire redemarrer. 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 interresse pas et inclure ceux qui vous interresse.

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 presence (on) ou l'absence (off) du matériel à proximité de la box. Cela permet de tester la presence d'une personne au domicile en vérifiant la presence de sont smartphone par exemple. Cela fonctionne, même avec les Iphones
On/Off Wifi Switch permettant de voir l'état du wifi (actif/Desactivé) et de le modifier
Reboot Switch permettant de rebooter 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.

Change log

Version Information
1.0 Version initial : connexion (token), températures système, espace disque, présence
1.1 Ajout des switch WIFI et Reboot. Ajout d'une pause au démarrage du plugin pour corriger certains pb
1.1.1 Prise en compte de l'adresse MAC en Majuscule ou minuscule pour la présence
1.1.2 Prise en compte de la Freebox mini 4K (qui n'a pas de disque interne) en conservant l'usage des disques externes
You can’t perform that action at this time.