Aller au contenu principal

Intégration domotique Bbox, gratuite et open source

Intégration Bbox pour Gladys Assistant

État de la Bbox de Bouygues Telecom : ligne, Internet, Wi-Fi, appareils, appels manqués.

Voir sur GitHubToutes les intégrations externes

Suivez votre Bbox de Bouygues Telecom dans Gladys : état de la ligne et d'Internet, débits, Wi-Fi, appareils connectés et appels manqués. Tout passe par l'API locale de la box, sans cloud.

Développée sans le matériel : retours bienvenus. Cette intégration a été écrite à partir de la documentation de l'API Bbox et des bibliothèques libres qui l'utilisent, sans Bbox pour la tester. Si une valeur manque ou paraît fausse sur votre modèle, ouvrez une issue sur GitHub avec le modèle de votre Bbox et les logs de l'intégration.

Intégration indépendante, non affiliée à Bouygues Telecom.

Ce que vous obtenez​

Un appareil Bbox, avec :

  • Connexion Internet (connectée ou non) et Ligne synchronisée ;
  • Type de ligne (FTTH, VDSL2, ADSL) et débits synchronisés montant et descendant (débits de synchronisation en xDSL, débit maximal annoncé par la box en fibre) ;
  • Débit descendant et débit montant instantanés, en Mbit/s ;
  • Adresse IPv4 publique et adresse IPv6 ;
  • Modèle, micrologiciel, durée de fonctionnement (en jours) et, si le modèle la donne, température ;
  • Wi-Fi 2,4 GHz, Wi-Fi 5 GHz et, si le modèle l'a, Wi-Fi invité : des interrupteurs, pour les couper ou les rallumer depuis Gladys ;
  • Appels manqués de la ligne fixe, si la box a la téléphonie ;
  • Appareils connectés : leur nombre.

Et, si vous le souhaitez, un appareil de présence par appareil connu de la Bbox (téléphone, ordinateur…), repéré par son adresse MAC.

Prérequis​

  • Gladys 5.1 ou plus récent.
  • Gladys sur le réseau local de la Bbox.
  • Le mot de passe administrateur de la Bbox : celui de l'interface web mabbox.bytel.fr.

Modèles : l'intégration utilise l'API locale commune aux Bbox de Bouygues Telecom (/api/v1). Les réponses sur lesquelles elle a été testée viennent de la Bbox Fibre (F@st5330b) et de la génération Wi-Fi 6 (F@st5688b). Les Bbox Miami, Ultym, Must, Wi-Fi 6 et Wi-Fi 7 exposent la même API, mais aucune n'a été essayée en vrai : vos retours diront ce qui marche.

Configuration​

  1. Ouvrez l'onglet Configuration de l'intégration.
  2. Adresse de la Bbox : 192.168.1.254 convient à presque toutes les box. Si vous avez changé le réseau de votre box, mettez sa nouvelle adresse IP.
  3. Mot de passe administrateur : celui de l'interface web de la box. Attention, plusieurs mots de passe faux bloquent la connexion à la box pendant un moment : l'intégration n'essaie plus après un refus, tant que vous n'avez pas enregistré un nouveau mot de passe.
  4. Intervalle de relevé : toutes les 60 secondes par défaut, pas plus souvent.
  5. Langue des noms de fonctionnalités : Gladys garde le nom d'une fonctionnalité une fois l'appareil ajouté. Choisissez la langue avant d'ajouter la Bbox.
  6. Enregistrez, puis cliquez sur Tester la connexion : le modèle, le micrologiciel et l'état d'Internet s'affichent sous le bouton.
  7. Ajoutez la Bbox depuis l'onglet Découverte.

Présence des appareils connectés​

Avec l'option Proposer les appareils connectés, chaque appareil connu de la Bbox apparaît dans l'onglet Découverte. Ajoutez ceux dont vous voulez suivre la présence, vos téléphones par exemple.

Comme la présence Bluetooth de Gladys, c'est un capteur « vu à » : la Bbox le signale tant que l'appareil est connecté, toutes les 5 minutes, et dès qu'il revient. Dans une scène, l'action Vérifier la présence d'un utilisateur considère l'utilisateur parti quand aucun de ses appareils n'a été vu depuis le délai choisi : prenez 10 minutes ou plus.

Les téléphones récents changent d'adresse MAC d'un réseau Wi-Fi à l'autre (adresse « privée » ou « aléatoire ») ; sur le Wi-Fi de la maison, elle reste en général la même. Si un téléphone apparaît sous plusieurs noms, désactivez l'adresse privée pour le réseau de la Bbox dans ses réglages Wi-Fi.

Actions​

  • Tester la connexion : lit la Bbox et affiche son modèle, son micrologiciel et l'état d'Internet.
  • Redémarrer la Bbox : cochez « Je confirme le redémarrage » avant de cliquer. Internet, le Wi-Fi et le téléphone sont coupés environ deux minutes, Gladys compris s'il passe par le Wi-Fi.

Scènes​

Dans l'éditeur de scènes (catégorie Intégrations) :

  • Connexion Internet perdue : la Bbox a perdu sa connexion Internet.
  • Connexion Internet rétablie : elle est revenue. Les actions suivantes lisent la durée de la coupure en minutes ({{triggerEvent.data.downtime_minutes}}) et l'adresse IPv4 ({{triggerEvent.data.ipv4}}).
  • Appel manqué : un appel sur la ligne fixe est resté sans réponse. Le numéro de l'appelant est dans {{triggerEvent.data.number}} quand le journal d'appels de la box le donne.

Ces déclencheurs comparent deux relevés : une coupure plus courte que l'intervalle de relevé peut passer inaperçue. Une Bbox qui ne répond plus du tout (redémarrage, câble débranché) ne déclenche rien : Gladys ne peut pas savoir si Internet fonctionne.

Pendant une coupure, Gladys n'a plus Internet non plus : une notification qui passe par Internet (Telegram…) ne peut pas partir. Préférez une action locale (lumière, sirène), ou notifiez au rétablissement.

Tableau de bord​

Le widget Bbox affiche les débits et le nombre d'appareils connectés en direct, l'état d'Internet et de la ligne, l'adresse IPv4, le Wi-Fi et les appels manqués. Son bouton allume ou coupe le Wi-Fi invité.

Certificat​

La Bbox sert son API en HTTPS avec un certificat émis pour mabbox.bytel.fr. Ce nom n'est connu que du serveur DNS de la box : l'intégration se connecte donc à l'adresse IP configurée, mais vérifie le certificat pour mabbox.bytel.fr, comme le ferait votre navigateur.

Si l'état de connexion signale une erreur de certificat, la box sert sans doute une chaîne de certificats incomplète, que les navigateurs complètent seuls mais pas l'intégration. Dans ce cas seulement, réglez Vérification du certificat sur Ne pas vérifier. Le trafic reste sur votre réseau local, mais l'intégration ne peut plus garantir qu'elle parle à votre Bbox et non à un autre appareil du réseau. Signalez-le aussi en issue, avec le modèle de votre box.

Dépannage​

  • « La Bbox ne répond pas » : vérifiez l'adresse (192.168.1.254 par défaut) et que Gladys est bien sur le réseau de la box, pas derrière un autre routeur.
  • « La Bbox a refusé le mot de passe » : saisissez-le à nouveau et enregistrez. L'intégration ne réessaie pas d'elle-même, pour ne pas prolonger le blocage de la box.
  • « La Bbox bloque les connexions » : trop d'essais ratés, depuis Gladys ou ailleurs. L'intégration attend 15 minutes avant de réessayer.
  • Une valeur reste vide : votre modèle ne la donne peut-être pas. Ouvrez une issue avec le modèle de la box et les logs.
  • Couper le Wi-Fi depuis Gladys coupe aussi Gladys s'il est connecté par ce Wi-Fi : préférez une connexion filaire.

Paramètres de configuration​

Voici les paramètres demandés par Bbox dans son écran de configuration dans Gladys.

ParamètreTypeObligatoireDescription
Connecter votre BboxsectionNonGladys doit être sur le réseau de la Bbox. L'intégration lit l'API locale de la Bbox avec le mot de passe administrateur, celui de l'interface web (mabbox.bytel.fr). Non affiliée à Bouygues Telecom.
Adresse de la BboxstringOuiAdresse IP de la Bbox sur votre réseau, ou mabbox.bytel.fr. Le certificat est toujours vérifié pour mabbox.bytel.fr.
Mot de passe administrateursecretOuiLe mot de passe de l'interface web de la Bbox. Plusieurs erreurs bloquent la connexion un moment.
Intervalle de relevé (s)numberNonFréquence de lecture de la Bbox, en secondes : une minute minimum.
Langue des noms de fonctionnalitésselectNonGladys garde le nom d'une fonctionnalité une fois l'appareil ajouté : choisissez avant de l'ajouter.
Proposer les appareils connectés (présence)booleanNonChaque appareil connu de la Bbox apparaît dans l'onglet Découverte : ajoutez les téléphones dont vous voulez suivre la présence.
Vérification du certificatselectNonLaissez-la active. Ne la désactivez que si l'état de connexion signale une erreur de certificat (voir la documentation).

Comment installer Bbox dans Gladys​

  1. Dans Gladys, ouvrez Intégrations : Bbox apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
  2. Cliquez sur Installer. Gladys télécharge l'image Docker (ghcr.io/guim31/gladys-bbox:1.0.2), la démarre dans un bac à sable isolé du cœur, et génère l'interface de l'intégration (appareils, découverte et configuration).
  3. Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
  4. Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/guim31/gladys-bbox.

Bbox nécessite Gladys >=5.1.0. Le catalogue dans Gladys se rafraîchit toutes les heures : une nouvelle version est donc disponible au plus tard une heure après sa sortie.

Vous n'utilisez pas encore Gladys ? C'est gratuit et open source : suivez le guide d'installation pour démarrer.

À propos des intégrations externes​

Bbox est une intégration externe : une intégration communautaire empaquetée dans un conteneur Docker et publiée sur GitHub, que Gladys installe en un clic et exécute dans un bac à sable isolé de son cœur. Elle est publiée et maintenue par guim31, et non par l'équipe cœur de Gladys.

Inscrivez-vous à la newsletter Gladys Assistant

Quelques emails par mois sur les nouveautés et l'actualité du projet. Envoyés par Pierre-Gilles Leymarie, le fondateur du projet. Désinscription possible à tout moment 🙂
Dernière mise à jour le