Intégration Home Assistant pour surveiller les pannes d'électricité d'Hydro-Québec.

Suivez en temps réel l'état du service électrique pour un ou plusieurs lieux de consommation : pannes en cours, interventions planifiées et estimation du rétablissement.

⚠️ Cette intégration n'est pas affiliée à Hydro-Québec. En cas de problème, ouvrez une issue sur GitHub. Ne contactez pas le service à la clientèle d'Hydro-Québec.

• 🔌 État du service : Détection des pannes en temps réel
• 📅 Interventions planifiées : Travaux annoncés à l'avance
• ⏱️ Durée de la panne : Temps écoulé depuis le début
• 🕐 Estimation de rétablissement : Compte à rebours avant le retour du courant
• 👥 Adresses touchées : Nombre de clients affectés
• 🔧 Statut d'intervention : Évaluation, équipe en route, travaux en cours, etc.
• 📍 Multi-lieux : Surveillance de plusieurs adresses indépendantes
• ⚡ Polling adaptatif : Mise à jour toutes les 60 s pendant une panne, 3 min sinon
• 📊 Données post-panne : Informations conservées après le rétablissement
• 🔍 Historique API : Les 5 derniers changements de données conservés pour le diagnostic

Ou manuellement :

1. Ouvrir HACS dans Home Assistant
2. Cliquer sur les 3 points en haut à droite → Dépôts personnalisés
3. Ajouter l'URL https://github.com/johnjohn-11/hydropannes avec la catégorie Intégration
4. Rechercher « Hydro-Pannes » et installer
5. Redémarrer Home Assistant

1. Télécharger la dernière release
2. Copier le dossier custom_components/hydropannes dans votre dossier config/custom_components/
3. Redémarrer Home Assistant

Ou manuellement :

1. Paramètres → Appareils et services → + Ajouter une intégration
2. Rechercher « Hydro-Pannes »
3. Entrer votre numéro de lieu de consommation (10 chiffres, visible sur votre facture Hydro-Québec)
4. Donner un nom à ce lieu (ex. : « Maison », « Chalet »)

Répétez l'opération pour chaque lieu à surveiller. Chaque lieu crée un appareil indépendant avec ses propres entités.

📖 Trouver votre numéro de lieu de consommation : Guide domo-quebec

1. Paramètres → Appareils et services → Hydro-Pannes
2. Cliquer sur Configurer (icône engrenage) à côté du lieu
3. Modifier le nom et sauvegarder

Chaque lieu de consommation configuré crée un appareil avec les entités suivantes.

💡 Les entités de catégorie Diagnostic sont masquées par défaut dans l'interface. Elles sont accessibles via Paramètres → Appareils et services → appareil → Entités de diagnostic.

Lorsqu'une panne et une intervention planifiée coexistent, l'intégration sélectionne l'interruption à afficher selon cet ordre de priorité :

1. Panne active (non planifiée, courant coupé): priorité absolue
2. Panne terminée (courant rétabli), sauf si une interruption planifiée non annulée est également présente
3. Intervention planifiée (active, à venir, ou terminée)
4. Première interruption de la liste: dernier recours

En cas d'erreur réseau ou d'API indisponible, les sensors conservent leur dernière valeur connue et une nouvelle tentative est effectuée lors du prochain cycle.

automation:
  - alias: "Notification panne électrique"
    trigger:
      - platform: state
        entity_id: binary_sensor.hydropannes_maison_etat_service
        to: "on"
    action:
      - service: notify.mobile_app
        data:
          title: "⚡ Panne électrique"
          message: >
            Panne détectée à {{ now().strftime('%H:%M') }}.
            Cause : {{ states('sensor.hydropannes_maison_cause') }}.
            Rétablissement estimé : {{ states('sensor.hydropannes_maison_date_fin') }}.

automation:
  - alias: "Notification courant rétabli"
    trigger:
      - platform: state
        entity_id: binary_sensor.hydropannes_maison_etat_service
        from: "on"
        to: "off"
    action:
      - service: notify.mobile_app
        data:
          title: "✅ Courant rétabli"
          message: >
            Le courant est rétabli après
            {{ (states('sensor.hydropannes_maison_duree') | int / 3600) | round(1) }} h.

Pour obtenir les données de diagnostic (utile pour signaler un problème) :

1. Paramètres → Appareils et services → Hydro-Pannes
2. Cliquer sur les 3 points → Télécharger les diagnostics

Le rapport inclut :

• L'état actuel des données API (numéro de lieu masqué automatiquement)
• L'historique des 5 derniers changements de payload détectés
• L'intervalle de polling actuel
• L'horodatage de la dernière mise à jour réussie
• L'état de compatibilité de l'API

L'intégration refuse mon numéro de lieu Vérifiez que le numéro comporte exactement 10 chiffres.

Les sensors affichent « Indisponible » Le coordinator n'a pas encore reçu de données valides. Vérifiez votre connexion internet et consultez les logs Home Assistant (Paramètres → Système → Journaux).

Les sensors restent sur leur ancienne valeur Comportement normal en cas d'erreur réseau transitoire. Les données sont conservées jusqu'au prochain cycle réussi.

Le sensor api_compatibility est on L'API Hydro-Québec a probablement modifié sa structure. Vérifiez si une mise à jour de l'intégration est disponible dans HACS et ouvrez une issue si le problème persiste.

Les données sont fournies par Hydro-Québec via leur API publique Info-pannes.

Merci à @nxor et @MivraMe pour leur travail sur une solution basée sur des templates sensor, qui a inspiré cette intégration.

Ce projet est sous licence MIT. Voir le fichier LICENSE pour plus de détails.

Les contributions sont les bienvenues ! Ouvrez une issue ou une pull request sur GitHub.