Intégration Hydro-Québec pour Home Assistant

Surveillez et automatisez votre consommation électrique directement dans Home Assistant.

Navigation rapide: Installation • Configuration • Blueprints • Capteurs • FAQ

---

⚠️ IMPORTANT - Support et problèmes

Cette intégration est développée de façon indépendante et n'est pas supportée par Hydro-Québec.

NE CONTACTEZ PAS le service client d'Hydro-Québec pour des problèmes avec cette intégration.

Pour toute question ou problème :

• 📝 Ouvrir un ticket sur GitHub
• 💬 Rejoindre notre Discord
• 📖 Consulter la documentation

---

Qu'est-ce que c'est ?

Intégration native pour Home Assistant qui vous permet de :

• Importez votre historique de consommation horaire et affichez le dans le tableau de bord Énergie d'Home-Assistant
• Suivre vos factures et coûts électriques
• Recevoir des alertes de périodes de pointe critiques
• Affichez vos crédits hivernaux (tarif DCPC)
• Automatiser vos appareils pendant les périodes de pointe
• Utiliser un calendrier intégré pour une fiabilité maximale

Pourquoi cette integration ?

Fiabilité avec l'approche "ceinture et bretelles"

L'intégration calendrier offre plusieurs niveaux de protection pour vos automatisations :

• Persistance - Les événements restent même si l'API est indisponible
• Déclencheurs natifs HA - Utilise le système éprouvé de Home Assistant
• Fallback manuel - Créez des événements manuellement en cas de problème

Fonctionnalités complètes

• Tous les tarifs supportés : D, DT, DPC (Flex-D), DCPC (Crédits hivernaux)
• Mode sans compte : Surveillez les pointes sans identifiants
• Multi-contrats : Gérez maison, chalet, etc.
• Blueprints prêt-à-l'emploi : Automatisations optimisées incluses

---

Installation rapide

Via HACS (Recommande)

Option 1 : Installation en un clic

Cliquez sur le badge ci-dessus, puis :

1. Cliquez sur "Télécharger"
2. Redémarrez Home Assistant
3. Ajoutez l'intégration dans Paramètres → Appareils et services

Option 2 : Installation manuelle dans HACS

Cliquez pour voir les étapes détaillées

1. Ouvrez HACS dans Home Assistant
2. Cliquez sur Intégrations
3. Cliquez sur les 3 points → "Dépôts personnalisés"
4. Ajoutez : https://github.com/hydroqc/hydroqc-ha (catégorie: Intégration)
5. Recherchez "Hydro-Québec" et cliquez sur "Télécharger"
6. Redémarrez Home Assistant

Installation manuelle

Pour les utilisateurs avancés

1. Téléchargez depuis GitHub Releases
2. Extrayez dans custom_components/hydroqc
3. Redémarrez Home Assistant

---

Configuration

Option 1 : Avec compte Hydro-Québec (Accès complet)

Accès à toutes les données : consommation, facturation, pointes, crédits hivernaux

1. Paramètres → Appareils et services → + Ajouter une intégration
2. Recherchez "Hydro-Québec"
3. Choisissez "Se connecter avec un compte"
4. Entrez vos identifiants Hydro-Québec
5. Sélectionnez le contrat à surveiller
6. Terminé ! Les capteurs apparaissent en ~60 secondes

Option 2 : Données publiques (Sans compte)

Uniquement les alertes de pointe sans identifiants

1. Suivez les étapes 1-2 ci-dessus
2. Choisissez "Données de pointe uniquement"
3. Sélectionnez votre tarif
4. Les alertes de pointe sont actives !

Configuration du calendrier (Obligatoire pour DPC/DCPC)

Le calendrier est obligatoire pour les tarifs DPC (Flex-D) et DCPC (Crédits hivernaux). Les capteurs de pointe dépendent du calendrier pour fonctionner.

Étape 1 : Créer un calendrier local

Ou manuellement :

1. Paramètres → Intégrations → + Ajouter
2. Recherchez "Calendrier local" (Local Calendar)
3. Créez un calendrier dédié (ex: "HQ Pointes")

⚠️ Important : Utilisez un calendrier dédié. Ne partagez pas avec d'autres intégrations.

Étape 2 : Configurer dans Hydro-Québec

1. Hydro-Québec → Options (⚙️) → Configurer
2. Sélectionnez votre calendrier dédié
3. Les événements de pointe sont synchronisés automatiquement !

---

Services disponibles

Service hydroqc.create_peak_event

Créez manuellement un événement de pointe critique dans le calendrier. Utile pour :

• Préparer vos automatisations avant l'annonce officielle (météo extrême prévue)
• Tester vos blueprints avec un événement réel
• Fallback si l'API est indisponible

Paramètres :

Paramètre	Description	Requis
device_id	L'appareil HydroQc (contrat)	Oui
date	Date de l'événement	Oui
time_slot	AM (6h-10h) ou PM (16h-20h)	Oui

Exemple d'appel :

action: hydroqc.create_peak_event
data:
  date: "2026-02-15"
  time_slot: "PM"
target:
  device_id: abc123def456

Note : L'événement utilise le même format d'UID que les événements OpenData. Si Hydro-Québec annonce ensuite la même pointe, l'événement existant sera conservé (pas de doublon).

---

Blueprints

Automatisations prêt-à-l'emploi pour gérer les périodes de pointe.

Blueprint Crédits hivernaux (DCPC)

Pour les utilisateurs du tarif D avec Crédits hivernaux (CPC).

Fonctionnalités :

• Déclencheurs calendrier pour pointes critiques + horaire fixe pour pointes régulières
• Pré-chauffage avant pointes critiques (par défaut 1h45 avant)
• Actions distinctes : pointes critiques vs régulières
• Gestion des périodes d'ancrage (matin et soir)
• Délai aléatoire intégré en fin de pointe (30s-5min)

Horaire quotidien (pointes régulières) :

Période	Horaire
Ancrage matin	01h-04h
Pointe matin	06h-10h
Ancrage soir	12h-14h
Pointe soir	16h-20h

Blueprint Flex-D (DPC)

Pour les utilisateurs du tarif Flex-D (DPC).

Fonctionnalités :

• Déclencheurs calendrier uniquement (pointes critiques)
• Pré-chauffage configurable (par défaut 2h avant)
• Actions de début et fin de pointe
• Délai aléatoire intégré en fin de pointe (30s-5min)

Tester vos blueprints

Après avoir importé un blueprint et créé votre automatisation, créez un événement de test dans votre calendrier pour valider que tout fonctionne :

1. Utilisez le service hydroqc.create_peak_event pour créer un événement
2. Vérifiez que vos actions se déclenchent correctement
3. Vous pouvez supprimez l'événement de test après validation

Comprendre les paramètres des blueprints

Délai de pré-chauffage

Configurez séparément le pré-chauffage pour les pointes du matin et du soir.

Format : -HH:MM:SS (négatif = avant l'événement)

Délai avant début pointe (Flex-D uniquement)

• Par défaut : -00:01:00 (1 minute avant)
• Utilité : Permet à vos appareils de se stabiliser avant la pointe
• Exemple : Pointe à 18:00 → actions à 17:59

Actions en parallèle

Les actions s'exécutent simultanément plutôt que séquentiellement.

Avantage : Si une action échoue, les autres continuent !

- parallel:
    - action: climate.set_temperature
      target:
        entity_id: climate.chambre
      data:
        temperature: 19
    - action: switch.turn_off
      target:
        entity_id: switch.chauffe_eau

Délai aléatoire en fin de pointe

Les blueprints incluent automatiquement un délai aléatoire (30 secondes à 5 minutes) à la fin des pointes.

• Raison : Évite une surcharge du réseau électrique
• Impact : Les appareils ne redémarrent pas tous simultanément
• Recommandation : Conservez ce délai dans vos actions personnalisées

---

Capteurs disponibles

Capteurs de compte (Mode authentifié uniquement)

Capteur	Description
Solde	Solde actuel du compte
Période de facturation	Jour actuel, durée, facture projetée
Consommation	Moyenne quotidienne, total, projection
Coût	Moyenne du coût par kWh, facture quotidienne
Température	Température moyenne pour la période
Panne	Panne prochaine/actuelle avec détails

Capteurs spécifiques aux tarifs

Tarif DCPC (Crédits hivernaux)

• Crédit hivernal cumulé
• Crédit hivernal projeté
• Heures de début/fin ancrage/pointe
• Performance de pointe d'hier
• Indicateurs de pointe critique
• Alertes de préchauffage

Tarif DPC (Flex-D)

• Détail de la période DPC actuelle
• Heures de début/fin prochaine pointe
• Heure de début du préchauffage
• Nombre d'heures critiques
• Nombre de jours hivernaux
• Alertes de pointe critique

Tarifs DT / DPC

• Consommation aux prix supérieur/inférieur
• Économie/perte nette vs Tarif D

---

FAQ

Échec de connexion

• Vérifiez vos identifiants sur Hydro-Québec
• Vérifiez les caractères spéciaux dans le mot de passe
• Assurez-vous que le compte a des contrats actifs

Aucune donnée n'apparaît

• Attendez 60 secondes pour la première mise à jour
• Vérifiez les journaux : Paramètres → Système → Journaux
• Vérifiez que le portail Hydro-Québec est en ligne

Capteurs indisponibles

• Certains capteurs sont saisonniers (crédits hivernaux : déc-mars)
• Vérifiez si votre tarif supporte le capteur
• Consultez les journaux du coordinateur

Calendrier ne se synchronise pas

• Vérifiez que le calendrier local est installé
• Vérifiez que le calendrier est sélectionné dans les options
• Redémarrez l'intégration après configuration
• Consultez les journaux pour erreurs de validation

---

Migration depuis hydroqc2mqtt

Vous utilisez déjà le Add-on ou hydroqc2mqtt ?

• Installation en parallèle possible - Testez en toute sécurité
• Noms de capteurs identiques - Seul le préfixe change
• Nouveaux blueprints calendrier - Plus fiables que les versions antérieures

Étapes de migration :

1. Installez l'intégration en parallèle
2. Testez vos automatisations avec les nouveaux capteurs
3. Remplacez vos anciens blueprints par les nouveaux blueprints calendrier de ce dépôt
   • Les blueprints hydroqc2mqtt utilisaient les capteurs binaires (approche moins fiable)
   • Les nouveaux blueprints utilisent le calendrier (approche "ceinture et bretelles")
   • Supprimez vos anciennes automatisations basées sur les anciens blueprints
   • Importez les nouveaux blueprints (liens d'import dans la section Blueprints)
4. Une fois satisfait, désactivez l'ancien système

---

Développement

Vous souhaitez contribuer ? Consultez CONTRIBUTING.md pour :

• Configuration de l'environnement de développement
• Directives de contribution
• Documentation des tests
• Conventions de code

---

Ressources

• Documentation : hydroqc.ca
• Problèmes : GitHub Issues
• Code source : Dépôt GitHub
• Changelog : CHANGELOG.md

Projets connexes

• hydroqc2mqtt : [https://gitlab.com/hydroqc/hydroqc2mqtt] Démon MQTT (prédécesseur de cette intégration)
• Hydro-Quebec-API-Wrapper : Bibliothèque Python sous-jacente

---

Licence

Ce projet est sous licence AGPL-3.0 - consultez le fichier LICENSE pour plus de détails.

Crédits

Développé avec passion par l'équipe Hydroqc

---

Avertissement

Cette intégration n'est pas approuvée, associée ou supportée par Hydro-Québec.

Le nom « Hydro-Québec », les logos et toutes les marques de commerce et marques déposées présents dans ce dépôt sont la propriété d'Hydro-Québec. L'utilisation de ces noms, marques de commerce et logos dans ce projet est uniquement à des fins d'identification et n'implique aucune approbation ou affiliation avec Hydro-Québec.

---

_{Si cette intégration vous aide à économiser sur vos factures d'électricité, pensez à mettre une étoile sur GitHub !}