Aller au contenu principal

Intégration domotique Sibelga, gratuite et open source

Intégration Sibelga pour Gladys Assistant

Consommations de gaz et d'électricité et pannes du réseau Sibelga (Bruxelles).

Suivez vos consommations de gaz et d'électricité et l'état du réseau Sibelga (Région de Bruxelles-Capitale) dans Gladys Assistant.

Cette intégration n'est pas publiée par Sibelga. Sibelga ne propose pas d'API publique : l'intégration lit les mêmes pages web que celles que vous ouvrez dans votre navigateur — le portail « Ma consommation » avec votre propre compte, et la page publique des pannes en cours. Si Sibelga les modifie, l'intégration peut cesser de fonctionner jusqu'à sa mise à jour.

Ce que vous obtenez​

  • Un appareil par compteur de votre compte Sibelga (électricité et gaz), avec sa consommation quotidienne, la consommation du dernier jour et du dernier mois, et les index du compteur.
  • Un appareil Sibelga grid (réseau Sibelga) qui compte les pannes en cours, à Bruxelles et dans vos communes.
  • Des déclencheurs et des actions de scène, et deux widgets de tableau de bord.

Avant de commencer​

Les données de consommation nécessitent :

  1. un compte de consommation Sibelga : créez-le sur conso.sibelga.be (c'est le compte de l'application My Sibelga, pas celui des demandes de travaux) ;
  2. vos compteurs ajoutés à ce compte avec leur code EAN ;
  3. un compteur intelligent dont la lecture à distance est autorisée : sans cela, Sibelga n'a pas de données quotidiennes à afficher, et le compteur ne reçoit que les valeurs que Sibelga connaît.

Connectez-vous une fois sur le portail et vérifiez que vous y voyez votre consommation : l'intégration affiche les mêmes données, rien de plus.

L'état du réseau ne nécessite aucun compte.

Configuration​

  1. Ouvrez l'onglet Configuration de l'intégration.
  2. Saisissez l'adresse e-mail et le mot de passe de votre compte de consommation Sibelga, puis enregistrez.
  3. Appuyez sur Tester le compte Sibelga : l'intégration se connecte et liste les compteurs trouvés.
  4. Ouvrez l'onglet Découverte et ajoutez les appareils.

Autres réglages :

  • Historique à importer — nombre de jours de consommation quotidienne envoyés à Gladys pour chaque compteur (30 par défaut). L'historique est envoyé lorsque vous ajoutez l'appareil.
  • Actualisation des consommations — fréquence de lecture du portail (toutes les 6 heures par défaut). Sibelga publie les relevés d'un jour le lendemain : un intervalle plus court n'apporte rien.
  • Suivre l'état du réseau — désactivez-le si seule la consommation vous intéresse.
  • Suivre la commune de mon domicile — activé par défaut. L'intégration lit la localisation des maisons définies dans Gladys et suit la commune bruxelloise de chacune. Une maison hors de Bruxelles, ou sans localisation, est ignorée.
  • Autres communes à suivre — communes suivies en plus de celle de votre domicile (votre lieu de travail, le domicile d'un proche). Si aucune commune n'est suivie, toute la Région l'est.
  • Actualisation de l'état du réseau — toutes les 15 minutes par défaut, toutes les 5 minutes au plus.

Appareils​

Chaque compteur porte le nom que vous lui avez donné sur le portail et son code EAN.

FonctionnalitéSignification
Daily consumptionUne valeur datée par jour, utilisée par les écrans énergie
Consumption of the last dayDernier jour publié par Sibelga (en général la veille)
Consumption of the last monthTelle qu'affichée sur le portail
Meter index (peak / off-peak)Derniers index (heures pleines / creuses) d'un compteur intelligent
Injection of the last day, index…Uniquement pour un compteur qui injecte aussi (panneaux solaires)

Toutes les valeurs sont en kWh, comme sur le portail. Les données d'un jour arrivent le lendemain : il n'y a pas de puissance en temps réel ici. Pour des relevés en direct, utilisez le port P1 de votre compteur intelligent avec une autre intégration.

L'appareil Sibelga grid a deux compteurs : les pannes en cours à Bruxelles, et celles dans vos communes.

Chaque appareil porte le badge cloud : les données viennent de Sibelga par Internet. Le badge passe à « injoignable » quand Sibelga ne peut pas être lu.

Actions​

Boutons de l'onglet Configuration :

  • Tester le compte Sibelga — se connecte et liste vos compteurs.
  • Tester l'état du réseau — lit la page des pannes et dit ce qu'elle montre.
  • Actualiser les données maintenant — lit les deux sans attendre.

Scènes​

L'intégration ajoute ses propres cartes à l'éditeur de scènes (Gladys 5.1 ou plus récent).

Déclencheurs :

  • Début d'une panne Sibelga — une nouvelle panne est apparue. Filtrez sur Dans mes communes ou Ailleurs à Bruxelles ; laissé vide, toute panne correspond. Variables : {{triggerEvent.data.title}}, municipalities, url, count (pannes en cours dans vos communes) et id.
  • Fin d'une panne Sibelga — une panne n'est plus signalée. Même filtre et mêmes variables.
  • Nouvelles données de consommation Sibelga — Sibelga a publié une nouvelle journée pour un compteur. Filtrez sur le compteur ou sur l'énergie. Variables : consumption et injection (kWh), date, name, ean.

Actions :

  • Actualiser les données Sibelga — lit Sibelga maintenant. Ne la placez pas dans une scène lancée par l'un des déclencheurs ci-dessus : une actualisation peut les déclencher.
  • Obtenir une consommation Sibelga — consommation d'un compteur sur le dernier jour, les 7 ou les 30 derniers jours, pour les actions suivantes (par exemple un message avec la consommation de la veille).
  • Obtenir l'état du réseau Sibelga — nombre de pannes en cours et si vos communes sont touchées, pour une condition ou un message.

Au démarrage de Gladys, les pannes déjà en cours et les relevés déjà publiés ne lancent pas les déclencheurs : seul ce qui change ensuite le fait.

Tableau de bord​

  • Consommation Sibelga — choisissez un compteur et un nombre de jours : dernier jour, dernier mois, moyenne par jour et un graphique en barres de la consommation quotidienne.
  • État du réseau Sibelga — pannes en cours (vos communes d'abord) avec un lien vers leur page sur sibelga.be, et un bouton d'actualisation.

Vie privée et limites​

  • Votre mot de passe est conservé par Gladys dans un champ secret et n'est envoyé qu'à la page de connexion de Sibelga. Il n'est jamais écrit dans les logs.
  • L'intégration ne fait que lire : elle ne modifie jamais rien sur votre compte Sibelga.
  • Les pannes sont lues sur une page web publique. Sibelga protège son site contre les robots : quand il refuse l'intégration, l'état affiche Inconnu, et l'intégration ne cherche pas à contourner la protection.
  • L'intégration demande à Gladys la localisation de vos maisons, uniquement pour trouver leur commune. Elle le fait elle-même, à partir des limites communales qu'elle embarque : les coordonnées ne sont jamais envoyées à Sibelga ni à un autre service, jamais écrites dans les logs et jamais enregistrées.
  • Les interruptions planifiées et les chantiers ne sont pas suivis.

Dépannage​

  • « Sibelga a refusé l'adresse e-mail ou le mot de passe » — connectez-vous sur conso.sibelga.be avec les mêmes identifiants. Le compte des demandes de travaux est un autre compte.
  • « Sibelga did not complete the sign-in » (dans les logs) — le portail vous attend : nouvelles conditions à accepter ou adresse à confirmer. Connectez-vous une fois dans un navigateur, puis appuyez sur Tester le compte Sibelga.
  • Aucun appareil, ou pas de consommation quotidienne — vérifiez sur le portail que le compteur est listé, qu'il est intelligent et que la lecture à distance est autorisée. Les données commencent le lendemain de l'autorisation.
  • État du réseau « Inconnu » — sibelga.be a refusé la requête ou a changé sa page. Les pannes restent visibles sur le site de Sibelga.
  • Pour plus de détails, consultez les logs de l'intégration depuis l'interface de Gladys, avec LOG_LEVEL=debug pour tout voir.

Paramètres de configuration​

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

ParamètreTypeObligatoireDescription
Compte SibelgasectionNonLes données de consommation proviennent du portail « Ma consommation » de Sibelga. Créez-y votre compte, ajoutez vos compteurs (code EAN) et autorisez la lecture à distance : l'intégration se connecte ensuite avec la même adresse e-mail et le même mot de passe. Sibelga publie les relevés d'un jour le lendemain, pour les compteurs intelligents uniquement.
Adresse e-mailstringNonAdresse e-mail de votre compte de consommation Sibelga.
Mot de passesecretNonConservé par Gladys et envoyé uniquement à Sibelga pour la connexion.
Historique à importer (jours)numberNonNombre de jours de consommation quotidienne envoyés à Gladys pour chaque compteur.
Actualisation des consommations (heures)numberNonFréquence de lecture du portail de consommation. Sibelga le met à jour une fois par jour.
État du réseausectionNonL'intégration lit la page publique des pannes en cours sur sibelga.be ; aucun compte n'est nécessaire. Sibelga ne propose pas de flux de données officiel : si le site refuse la lecture automatisée, l'état s'affiche comme inconnu.
Suivre l'état du réseaubooleanNon
Suivre la commune de mon domicilebooleanNonUtilise la localisation des maisons définies dans Gladys pour trouver leur commune bruxelloise. Les coordonnées restent dans l'intégration : elles ne sont jamais envoyées à Sibelga ni à qui que ce soit.
Autres communes à suivremulti_selectNonLes pannes sont comptées et annoncées pour ces communes, en plus de celle de votre domicile. Sans aucune commune, toute la Région bruxelloise est suivie.
Actualisation de l'état du réseau (minutes)numberNon

Comment installer Sibelga dans Gladys​

  1. Dans Gladys, ouvrez Intégrations : Sibelga 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/gboulvin/gladys-sibelga:1.1.0), 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/gboulvin/Gladys-Sibelga.

Sibelga 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​

Sibelga 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 gboulvin, 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 🙂