Bbox

Description

Plugin permettant de récupérer, d’afficher et d’exploiter les informations de certaines Box Bouygues Télécom.

Certaines informations et actions ne sont disponibles que si votre box propose l’API

Les informations récoltées sont les suivantes :
- Présence Box : Détecte la présence de la box
- Lumière : Indique si les voyants lumineux de la box sont activés ou non (API seulement)
- Internet : Indique la connexion au WAN
- Wifi : Indique l’état de la connexion Wifi
- TV : Indique si un périphérique de gestion de flux (décodeur) a été détecté sur le réseau LAN
- IP Wan : Indique l’adresse IP du routeur sur Internet
- VoIP : Indique l’état de l’activation du service de téléphonie IP
- Numéro : Indique le numéro de téléphone associé au service VoIP
- Temps de fonctionnement : Indique le nombre de jours, heures et minutes depuis le dernier démarrage
- Débit descendant : Indique en kb/s le débit sur l’entrée WAN de la box
- Débit ascendant : Indique en kb/s le débit sur la sortie WAN de la box
- Reçu : Nombre d’octets reçus par la box depuis la dernière remise à zéro
- Envoyé : Nombre d’octets envoyés par la box depuis la dernière remise à zéro
- Variation Reçu : Nombre d’octets reçus par la box depuis le dernier rafraîchissement
- Variation Envoyé : Nombre d’octets envoyés par la box depuis le dernier rafraîchissement
- Appels Manqués : Nombre d’appels reçus mais non répondus (ce nombre est remis à zéro à chaque utilisation du service VoIP)
- Messages vocaux : Nombre de messages vocaux non consultés
- Périphériques : Nombre de périphériques détectés par la box sur le LAN. Le décodeur TV est compris dans ce nombre
- Liste : Retourne un tableau JSON avec pour chaque périphérique détecté : adresse IP, Nom, adresse MAC
- Journal des appels : Liste des appels émis, reçus et manqués (API seulement et nécessite que votre box soit connectée à votre compte)
- Journal des messages : Liste des messages vocaux ainsi que le lien pour les télécharger (API seulement et nécessite que votre box soit connectée à votre compte)
- Chaîne : Retourne le nom de la chaîne actuellement diffusée sur le décodeur et vide si le décodeur est éteint ou le service désactivé.
Les actions possibles sont les suivantes :
- Redémarrer : Redémarre la box
- Lumière On : Allume les lumières de la box (API seulement)
- Lumière Off : Eteint les lumières de la box (API seulement)
- Wifi On : Active le Wifi
- Wifi Off : Désactive le Wifi
- Appeler : Fait sonner le numéro associé au service VoIP (pendant 20 secondes)
- Raccrocher : Arrête de faire sonner le numéro associé au service VoIP

Installation

Il n’y a pas de particularités dans l’installation de ce plugin.

Merci de vous reporter à la documentation Jeedom ici pour de plus amples informations.

Configuration

Le plugin Bbox_SagemCom permet de recevoir et d’exploiter certaines données de la box Bouygues Télécom

Une fois installé à partir du Market, commencez par activer le plugin.

Puis, accédez à la page de configuration du plugin via l’onglet Plugins.

Pour créer son équipement, il suffit de cliquer sur le bouton ajouter.

Le menu général permet de donner un nom, une place dans l’arborescence, activer et rendre visible votre équipement Bbox. Vous pouvez aussi ajouter votre équipement à l’une des catégories de Jeedom.

Vous devez ensuite configurer votre équipement :

Pour ce faire, entrez l’adresse de la box. Sauf cas particulier, renseignez "bbox" comme adresse pour votre box Bouygues Télécom.

le http:// est rajouté automatiquement

Voir la FAQ pour plus d’informations sur comment trouver votre adresse

Vous devez aussi choisir votre type de connexion. Si vous avez un doute, vous pouvez (via votre navigateur internet) vous rendre sur le menu "État des connexions" de l’interface de configuration de votre BBox. L’image suivante vous montre un exemple de connexion type FFTH/xDSL :

Si l’interface de votre BBox ressemble à l’image précédente, laissez le mode défaut, sinon, choisissez le mode API.

Si vous avez sélectionné le mode API, vous serez invités a entrer le mot de passe que vous utilisez pour vous connecter à votre BBox.

Vous pouvez enfin décider d’appliquer une vue (tuile) pré-configurée ou laisser l’affichage par défaut.

La vue par défaut ressemblera à ça :

Ceci reste complètement personnalisable via Jeedom

Voir le chapitre Exemple de personnalisation de la Tuile pour le résultat de la vue pré-configurée.

Une fois l’équipement sauvegardé, la liste des commandes disponibles apparaît:

Id : le nombre indique l’ID de la commande et la double-flèche permet de modifier l’ordre d’affichage des commandes dans la tuile (cliquer-déposer)
Nom : Nom de la commande
Type : Type de la commande : peut être une info ou une action
Sous-Type : Sous-type de la commande : peut être binaire, numérique, chaîne de caractères ou autres
Note : Informations spécifiques à la commande. Pour les actions, un champs supplémentaire permet de relier le résultat d’une commande info au retour de l’action. Ce paramètre peut être utile pour configurer l’affichage du plugin
Paramètres : Permet de gérer l’affichage et éventuellement l’historisation des résultats de la commande
Action : Permet de tester une commande ou de modifier finement sa configuration via l’icone avec les roues crantées

Si vous avez choisi la tuile pré-configurée, vous n’avez rien à faire. Sinon, à vous de jouer avec les paramètres de configuration offerts par Jeedom

N’oubliez pas de sauvegarder votre équipement après toute modification de la configuration

Exemples

Exemples d’utilisation

Ce plugin (éventuellement utilisé en conjonction avec d’autres plugins) peut vous permettre de :

Couper le Wifi la nuit ou en période d’absence
Vous envoyer un sms ou un e-mail los de la réception d’un nouveau message vocal
Faire sonner le téléphone en cas d’intrusion

Exemple de personnalisation de la Tuile

Si vous avez sélectionné la vue pré-configurée, vous devriez obtenir le rendu suivant :

Voici les éléments notables de cette Tuile :

Le Widget présence indique le résultat de la détection de la box (vert = détectée / rouge = absente). Cliquez sur ce dernier pour redémarrer votre box
Le Widget Internet (nuage) indique l’état de votre connexion internet (vert = synchronisé / rouge = désynchronisé).
Le Widget Wifi indique l’état de votre service wifi (vert = activé / rouge = désactivé). Cliquez sur ce dernier pour inverser son état
Le Widget TV indique la présence d’un équipement Video dans votre réseau (vert = détecté / rouge = absent)
Le Widget VoIP indique l’état de votre service Téléphonique (vert = activé / rouge = désactivé)
Le Widget avec un téléphone et une croix indique le nombre de nouveaux appels manqués. Cliquez dessus pour ouvrir une fenêtre affichant la liste complète des derniers appels (API seulement)
Le Widget avec un téléphone et un point d’exclamation indique le nombre de nouveaux messages vocaux. Cliquez dessus pour ouvrir une fenêtre affichant la liste des messages vocaux et permettant de les télécharger ou de les supprimer (API seulement)
Le Widget Périphériques indique le nombre de périphériques détectés sur votre réseau. Cliquez dessus pour ouvrir une fenêtre affichant le nom (si pas de nom l’adresse MAC) et l’adresse IP des différents périphériques. Merci à skyline-ch pour son aide (API seulement)

FAQ

Comment savoir si ma BBox est compatible ?

Rendez-vous sur la page d’administration de votre BBox depuis votre navigateur Internet. Cliquez sur "Etat des connections" puis sur l’onglet "Bbox".

Si dans "Informations sur la Bbox" vous voyez :

Sagemcom Fast3965b ou Fast5330b : Ce plugin est compatible avec votre Bbox
Samsung OB1-GTW-C ou Ubee TVW620.I : Ce plugin est aussi compatible avec votre Bbox
Thomson TG787 : Ce plugin est compatible si le firmware de votre box propose l’API
Une autre référence : Merci de me contacter via le sujet officiel du Forum Jeedom

Ce plugin n’est pas compatible avec la box Sagemcom Fast3784b

Comment connaître l’adresse de ma box ADSL ?

L’adresse de votre BBox sur votre réseau local est souvent bbox. Pour le vérifier, ouvrez votre navigateur internet et tapez bbox dans la barre d’adresse. Vous pouvez aussi éventuellement essayer gestionbbox.lan ou 192.168.1.254. N’oubliez pas http:// avant l’adresse quand vous testez dans votre navigateur mais pas dans le plugin (il est rajouté automatiquement).

Le plugin indique que le service VoIP est désactivé alors le téléphone fonctionne.

Votre mot de passe est erroné ! une fois corrigé, redémarrez votre BBox pour effacer son historique des connexions.

Le journal des appels ou des messages vocaux est vide alors que le nombre correspondant est non nul.

Votre box n’est pas connectée à votre compte. Rendez-vous sur la page d’administration de votre BBox.

xDSL/FFTH ou Cable ?

Si vous avez un doute, rendez-vous sur la page d’administration de votre BBox dans la catégorie "État des connexions". Le titre du deuxième onglet devrait répondre à la question.

Lorsque je teste une commande de type "info", j’obtiens : No result has been sent.

Attendez une minute : Les infos du Plugin sont actualisées via le cron de Jeedom qui est appelé chaque minute

Pourquoi des commandes Variation Reçu et Variation Envoyé alors que l’historique de Jeedom permet déjà ce traitement ?

Les informations de données reçues et envoyées fournis par la BBox sont periodiquement remises à zéro (dépassement de capacité). Or, l’historique de Jeedom ne peut pas l’interpréter ce qui aurait donné un résultat aberrant. Le plugin (connaissant la capacité max) ajuste automatique les données afin de ne pas tenir compte de ce dépassement de capacité.

Après réactivation du Wifi, certains périphériques n’ont plus accès à internet (ni à la Bbox) ?

C’est un problème connu chez Bouygues Telecom. Ce plugin n’en ai pas la cause. Malheureusement, malgré plusieurs mises à jour du firmware, ce problème n’est toujours pas réglé. Vous pouvez trouver plus d’information sur ce bug à l’adresse suivante : http://forum.bouyguestelecom.fr/questions/797052-reconnexion-wifi-2-4ghz-ko-5ghz-ok . Une solution de contournement serait de redémarrer la Bbox au lieu de réactiver le Wifi.

J’ai activé le plugin et maintenant je n’accède plus à l’interface de ma BBox depuis mon navigateur internet.

Attendez un moment ! La BBox n’autorise qu’un nombre très limité de connexions simultanées. Le plugin monopolise déjà une connexion. Il suffit d’avoir fait un rafraîchissement et le nombre maximal de connexions simultanées peut être atteint. Attendez quelques minutes pour qu’une connexion se libère.